pr-fix

PR Fix

Drive a PR to a mergeable state: a green CI, every review comment fixed-and-resolved or replied-and-flagged, and no merge conflicts with the base. Work the three fronts — CI, comments, conflicts — and loop until all are clear. Fix root causes, never silence failures or guess an author's intent. Use review's shared severity vocabulary (Critical / Important / Suggestion). Run independent investigations as sub-agents when available; otherwise do them inline.

Two modes — check your input first

Delegated mode — a caller supplied a watcher worklist. pr-monitor hands you items taken from a relay pr watch digest: each carries reason, source, id, answers, updatedAt, body, thread_id, path, line, and for checks the check_name and check_run_id. That worklist is complete and authoritative:

• Skip step 1's broad assessment. Do not re-run the PR/comment/thread/check sweep and do not build a full context bundle — the watcher already observed all of it. Bind REPO and PR and go straight to the work.
• Fetch only what the specific item needs: the failed run's log for a check_run_id, git log/git blame for a conflicting hunk, the file under an inline comment.
• Fix once, then return — no reassessment loop. The watcher re-observes after your push, and the next attention event carries whatever is left.
• Return a structured result, one entry per supplied item: the item id, what you did, fixed, replied, escalated, or failed, and the reason when it is not fixed. Report pushed commits and the new head SHA.
• Never run relay pr watch tick or status, and never schedule anything. The caller owns the watcher record.

Direct mode — no worklist was supplied. Assess the PR yourself and loop until clear, exactly as described below. This is the manual path and it is unchanged.

Quick commands

Task	Command
PR + check status	gh pr view --json number,title,state,statusCheckRollup,mergeable
CI checks	gh pr checks
Failed run logs	gh run view <RUN_ID> --log-failed
Inline review comments	gh api "repos/$REPO/pulls/$PR/comments" --jq '.[] | {id,user:.user.login,path,line,body}'
Reply to an inline comment	gh api "repos/$REPO/pulls/comments/<ID>/replies" -f body="$BODY"
Reply to a conversation comment	gh pr comment "$PR" --body "$BODY"
Reply to a review body	gh pr review "$PR" --comment --body "$BODY"
Resolve a thread (after fixing)	gh api graphql -f query='mutation($t:ID!){resolveReviewThread(input:{threadId:$t}){thread{isResolved}}}' -F t=<THREAD_ID>