merge-queue

merge-queue

Repos with a GitHub merge queue enabled reject normal pushes to queued PR branches, and gh pr merge --auto refuses to touch a PR that's already in the queue. The dance to fix a small issue on a queued PR is:

1. Dequeue the PR (GraphQL mutation — no gh shortcut exists).
2. Push your fix (force-with-lease is safe).
3. Re-enable automerge (gh pr merge --squash --auto).

If you try to git push without dequeueing first, you get:

remote:   ... cannot be updated. To modify this branch, dequeue the
remote:   associated pull request.
remote: error: ... protected branch hook declined

Dequeue + force-push + re-enable (copy-paste)

PR=4197
OWNER=Jack-and-Jill-AI
REPO=ai-recruiter

# 1. Look up the PR node id and confirm it's queued
gh api graphql -f query="query{
  repository(owner:\"$OWNER\",name:\"$REPO\"){
    pullRequest(number:$PR){
      id state isInMergeQueue mergeQueueEntry{id}
    }
  }
}"

# 2. Dequeue (pass the pullRequest node id, not the queue entry id)
PR_NODE_ID=$(gh api graphql -f query="query{
  repository(owner:\"$OWNER\",name:\"$REPO\"){
    pullRequest(number:$PR){id}
  }
}" --jq '.data.repository.pullRequest.id')
gh api graphql \
  -f query='mutation($id:ID!){dequeuePullRequest(input:{id:$id}){mergeQueueEntry{id}}}' \
  -F id="$PR_NODE_ID"

# 3. Push the fix (commit locally first)
git push --force-with-lease

# 4. Re-enable automerge
gh pr merge "$PR" --squash --auto

gh pr merge --disable-auto does NOT work while a PR is queued — the API returns "already queued to merge" and leaves the queue entry in place. You have to use the GraphQL dequeuePullRequest mutation.

Vercel preview failures — the commit-email trap

If CI shows Vercel – <project>: FAILURE on every preview, click through to the error. If it looks like:

"Setting your commit email address" (link to a GitHub docs page)

…it's not a git config issue. Vercel is rejecting the deploy because the HEAD commit's author email isn't on a GitHub account linked to the Vercel team. Usually happens when: