merge-queue

name	merge-queue
description	Process open PRs — merge when CI passes, handle rebases, file issues for failures. Run in a dedicated window.

Merge Queue

Process all open PRs. Merge what's ready, rebase what's behind, file issues for failures.

Run this in a dedicated terminal window. Invoke periodically with /merge while other windows do /work.

Step 1: Scan

# Check CI status on main — failing main blocks the entire queue
gh run list --branch main --limit 1 --json status,conclusion

# List open PRs
gh pr list --json number,title,headRefName,statusCheckRollup,mergeable,body,reviewRequests,reviews,labels

If main CI is failing: file a P0 beads issue (if one doesn't already exist), report prominently, and stop. Nothing can merge until main is green.

bd create "CI failing on main: <summary>" -t bug -p 0 --json

Step 2: Categorize

For each PR, determine its state:

State	Action
CI passing, mergeable, no pending review, no needs-human-review label	Merge
CI passing, mergeable, needs-human-review label, not approved	Skip, report "awaiting human review"
CI passing, mergeable, review requested but not approved	Skip, report
CI passing, mergeable, review approved	Merge
CI pending	Skip, report status