GitHub PR automerge and high-value gh parity commands

[kolatts]

Current behavior:

• pncli 1.20.0 exposes  github merge-pr , but it performs an immediate merge only.
• There is no command or flag to enable GitHub auto-merge while preserving required checks, approvals, branch protection, and merge-queue behavior.
• Several workflow-oriented operations available in  gh pr  are also missing.

Requested P0:

1. Add  pncli github merge-pr --auto , or a dedicated  enable-auto-merge  command, using GitHub’s supported auto-merge operation.
2. Add  --disable-auto  and optional  --match-head-commit   safety protection.
3. Clearly report whether auto-merge was enabled, already enabled, disallowed by repository policy, or rejected because requirements are unmet.
4. Never silently fall back to an immediate merge when  --auto  is requested.
5. Support merge-queue behavior by enqueueing PRs when required. Keep administrator or bypass behavior as a separately named, explicitly warned operation.

Requested P1 parity:

• PR status aggregation showing review decision, required checks, mergeability, draft state, and auto-merge state, with JSON output.
• Checks filtering and watch mode, including required-only checks and meaningful pending/failure exit codes.
• Ready/draft toggling.
• PR metadata editing for labels, reviewers, assignees, milestones, and projects.
• Reopen PR.
• Revert PR by creating a new revert PR, optionally as draft.

Service: GitHub

---

Submitted via kolatts.github.io/pncli

[imagile-bot]

Claude finished @kolatts's task in 8m 25s —— View job • claude/issue-358-20260821-2115 • Create PR ➔

---

Implementation complete

No duplicates found. All checks pass (typecheck ✓, lint ✓, 509 tests ✓).

• Read CLAUDE.md and existing GitHub service code
• Search for duplicate issues
• Assess feasibility
• Add types: node_id on GitHubPR, auto-merge types, PR status type
• Client: enableAutoMerge, disableAutoMerge, enqueuePR (P0)
• Client: getPRStatus, convertToDraft, markReadyForReview, reopenPR (P1)
• Client: addLabels, removeLabel, addReviewers, removeReviewers, addAssignees, removeAssignees (P1)
• Commands: wire up all new client methods
• Tests: 22 new unit tests covering all new methods
• npm run typecheck && npm run lint && npm test — all pass
• Commit and push

New commands

P0 — auto-merge:

Command	Notes
github enable-auto-merge --number <n> [--method MERGE|SQUASH|REBASE] [--match-head-commit <sha>]	GraphQL enablePullRequestAutoMerge. --match-head-commit maps to expectedHeadOid — mutation is rejected if another commit lands before it fires. Never falls back to immediate merge.
github disable-auto-merge --number <n>	GraphQL disablePullRequestAutoMerge.
github enqueue-pr --number <n> [--method] [--match-head-commit <sha>]	GraphQL addPullRequestToMergeQueue for repos with a merge queue enabled.

P1 — parity:

Command	Notes
github pr-status --number <n>	Single GraphQL call aggregating review decision, mergeable state, draft flag, auto-merge request, and all check statuses.
github convert-to-draft --number <n>	GraphQL convertPullRequestToDraft.
github ready-for-review --number <n>	GraphQL markPullRequestReadyForReview.
github reopen-pr --number <n>	REST PATCH state: open.
github add-labels / remove-label	REST label management.
github add-reviewers / remove-reviewers	User and team reviewer requests.
github add-assignees / remove-assignees	Assignee management.

Deferred (separate issues if needed): revert-pr (requires Git Data API commit creation), watch mode (polling loop doesn't fit single-shot JSON model), required-only checks filtering (needs branch protection admin), Projects v2.

[imagile-bot]

Implemented in PR: #359