merge-ready

Merge Ready

Take an open PR from wherever it is to "ready to merge", and report exactly what still needs a human when automation can't finish the job.

Steps

1. Detect the forge and pick the CLI: Read the remote (git remote get-url origin) and choose the matching CLI, verifying it is installed and authenticated before proceeding:

   Host in remote URL	CLI	PR concept	Auth check
   github.com / GHE	gh	pull request	gh auth status
   gitlab.com / self-hosted GitLab	glab	merge request (MR)	glab auth status
   Gitea / Forgejo / Codeberg	tea	pull request	tea login list

   The steps below are written with gh; on another forge, translate each operation to the equivalent verb (gh pr view -> glab mr view --output json / tea pr <n>, gh pr comment -> glab mr note, gh run view -> glab ci view, gh pr update-branch -> glab mr rebase, review threads -> glab api projects/:id/merge_requests/:iid/discussions). Confirm exact flags with --help rather than guessing. If the forge has no CLI (e.g. Bitbucket), fall back to git plus the forge's REST API via curl, and list anything you cannot automate as a blocker in the report.

2. Identify the PR: Resolve the argument (number or URL) or the current branch's PR via gh pr view. If no PR exists, stop and suggest the pr skill. If it is a draft, continue fixing but only mark it ready (gh pr ready) at the end, once everything else passes.

3. Assess: Take one snapshot of the PR state:

   gh pr view <n> --json number,title,body,url,state,isDraft,mergeable,mergeStateStatus,reviewDecision,reviewRequests,latestReviews,statusCheckRollup,baseRefName,headRefName,maintainerCanModify,closingIssuesReferences
   

   Then fetch unresolved review threads (only GraphQL exposes resolution):

   gh api graphql -f owner=<owner> -f repo=<repo> -F pr=<n> -f query='
     query($owner:String!,$repo:String!,$pr:Int!){
       repository(owner:$owner,name:$repo){ pullRequest(number:$pr){
         reviewThreads(first:100){ nodes{
           id isResolved isOutdated path line
           comments(first:20){ nodes{ author{login} body } }
         }}
       }}
     }'