document the auto-merge arming window in the README - #9
Merged
ben-s-pull-request-reviewer[bot] merged 1 commit intoAug 19, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
{
"verdict": "approve",
"summary": "PR adds a new 'Auto-merge arming window' section to the README explaining the GraphQL-only nature of GitHub's auto-merge, the UNPROCESSABLE rejection for already-mergeable PRs, and the cursor-based polling behavior that gives roughly one arming attempt per PR update. All factual claims were cross-checked against pkg/githubclient.go and found to be accurate. CHANGELOG.md entry correctly reflects the change. No issues found.",
"comments": [],
"concerns_addressed": [
"correctness: README states no REST endpoint exists, confirmed by pkg/githubclient.go:203-205 which explicitly documents that PUT /repos/{owner}/{repo}/pulls/{number}/auto-merge returns 404 Not Found",
"correctness: README states the exact UNPROCESSABLE error message, confirmed by pkg/githubclient.go:213 and the error construction at lines 253-259",
"correctness: README describes cursor-based polling with one arming attempt per PR update, matching the search-based architecture in pkg/githubclient.go:121-169"
]
}Uh oh!
There was an error while loading. Please reload this page.
ben-s-pull-request-reviewerBot
deleted the
docs/auto-merge-arming-window
branch
August 19, 2026 13:33
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a README section explaining that auto-merge arming uses the GraphQL
enablePullRequestAutoMergemutation (no REST endpoint exists — the plausible-looking PUT returns 404), that it is rejected withUNPROCESSABLE: Pull request is in clean statuson an already-mergeable PR, and why a fast-turnaround PR can therefore go unarmed without anything being broken.Docs only.
This PR also serves as the live end-to-end test of the v0.5.2 arming path: it carries the
auto-mergelabel and is deliberately left without a review trigger, so it stays blocked long enough for the watcher's poll to arm it.