docs(agents): mergeable=true is not the merge gate #15

Merged
jlxq0 merged 1 commit from docs/mergeable-is-not-a-gate into main 2026-08-27 02:12:16 +00:00
Owner

Measured while arming branch protection. On PR #13, with CI / cargo still pending:

POST /pulls/13/merge  ->  405
{"message":"not allowed to merge [reason: Not all required status checks successful]"}

GET  /pulls/13        ->  state=open merged=false mergeable=true

Both at the same moment. mergeable answers whether the branches merge without conflict; branch protection is a separate gate and the API reports it only when you attempt the merge. A session that pre-checks mergeable concludes the way is clear when it is not.

Docs only. Related: #14.

Measured while arming branch protection. On PR #13, with `CI / cargo` still pending: ``` POST /pulls/13/merge -> 405 {"message":"not allowed to merge [reason: Not all required status checks successful]"} GET /pulls/13 -> state=open merged=false mergeable=true ``` Both at the same moment. `mergeable` answers whether the branches merge without conflict; branch protection is a separate gate and the API reports it only when you attempt the merge. A session that pre-checks `mergeable` concludes the way is clear when it is not. Docs only. Related: #14.
docs(agents): mergeable=true is not the merge gate
All checks were successful
CI / cargo (pull_request) Successful in 1m8s
CI / docker (pull_request) Successful in 16s
2ed0f515ed
Measured on PR #13: the merge API returned 405 'Not all required status
checks successful' while the PR object reported mergeable=true at the same
moment. mergeable answers whether the branches merge cleanly, not whether
branch protection permits it, and it is the field read before merging.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jlxq0 merged commit 0e73d2f1ff into main 2026-08-27 02:12:16 +00:00
jlxq0 deleted branch docs/mergeable-is-not-a-gate 2026-08-27 02:12:17 +00:00
Sign in to join this conversation.
No reviewers
No labels
waiting-on-julian
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jlxq0/jmap-mcp!15
No description provided.