gh pr merge blocked: base branch policy prohibits the merge when author is sole code owner
Symptom: gh pr merge N --merge fails with "the base branch policy prohibits the merge" and mergeStateStatus=BLOCKED, even with no CI checks and no conflicts.
Diagnose: gh api repos/OWNER/REPO/branches/main/protection --jq "{reviews:.required_pull_request_reviews, enforce_admins:.enforce_admins.enabled}". Typical cause: required_approving_review_count=1 plus require_code_owner_reviews=true, and the PR author is the only code owner. GitHub never lets an author approve their own PR, so it can never be approved.
Options: (1) if enforce_admins is false, an admin can merge with gh pr merge N --merge --admin (one-off bypass); (2) add another code owner who approves; (3) relax the protection rule. As an agent, do not use --admin without explicit user consent: it bypasses a policy the owner set.
Tip: when merging several PRs that touch the same file, merge one, then re-check gh pr view M --json mergeable before the next.