Monitor PR CI & Reviews

Input

$ARGUMENTS

Workflow

Step 1: Resolve PR number

• If

  $ARGUMENTS

  is a number, use it directly
• If

  $ARGUMENTS

  is a GitHub URL, extract the PR number
• If

  $ARGUMENTS

  is empty, detect from current branch:
  bash

  gh pr list --head "$(git branch --show-current)" --json number --jq '.[0].number'

• If no PR found, stop and inform the user

Step 2: Poll loop

[Check N/30]

1. Fetch CI status:
   bash

   gh pr checks <PR_NUMBER>

2. Fetch review comments (every iteration):
   bash

   gh pr view <PR_NUMBER> --json reviews,comments,reviewDecision
   gh api repos/{owner}/{repo}/pulls/<PR_NUMBER>/comments --jq '.[] | {user: .user.login, body: .body, path: .path, line: .original_line, created_at: .created_at}'

3. Display status summary:

   [Check 3/30]
   
   CI Status:
   | Check            | Status  | Duration |
   |------------------|---------|----------|
   | lint (24.x)      | pass    | 5m34s    |
   | unittest (24.x)  | pending | -        |
   
   Reviews: 1 new comment from @reviewer

4. Decide next action based on priority:

   CI Status	Reviews	Action
   Any fail	-	Auto-fix CI failure (Step 3)
   Any pending	New comments	Show comments to user, keep waiting
   Any pending	No new comments	Wait 60s, re-check
   All pass	New comments	Show comments to user (Step 4)
   All pass	No new comments	Done (Step 5)

Step 3: Auto-fix CI failures

1. Get failure log:
   bash

   gh run view <RUN_ID> --log-failed 2>&1 | tail -100

   Extract the run ID from the check URL.
2. Analyze the failure and determine the cause.
3. Fixable (lint error, type error, test failure from our changes):
   • Fix the code
   • Commit:

     fix: resolve CI <check-name> failure

   • Push to PR branch
   • Wait 30s, return to Step 2
4. Not fixable (infra issue, flaky test, unrelated failure):
   • Report failure details to user
   • Suggest actions (re-run, skip, manual fix)
   • Ask user how to proceed

Step 4: Handle review comments

1. Display each comment clearly:

   New review comment from @reviewer:
   File: src/views/Example.tsx:42
   > Consider using useCallback here to prevent re-renders
   
   Review decision: CHANGES_REQUESTED

2. Prompt the user:
   • Show all unresolved comments
   • Ask: "Do you want me to address these review comments?"
   • If user says yes: fix the code, commit, push, return to Step 2
   • If user says no/later: continue monitoring CI only
3. Track comment state: Remember which comments have been shown to avoid repeating them in subsequent iterations.

Step 5: Final report

All CI checks passed!

| Check            | Status | Duration |
|------------------|--------|----------|
| lint (24.x)      | pass   | 5m34s    |
| unittest (24.x)  | pass   | 4m42s    |
| CodeQL           | pass   | 2m7s     |

Review status: approved / no reviews / changes requested
PR: <URL>

• All CI passed + approved → ready to merge
• All CI passed + no review → waiting for review
• All CI passed + changes requested → needs to address comments

Polling Rules

• 60 seconds between checks when pending
• 30 seconds after fix+push to allow CI restart
• Maximum 30 iterations (~30 min), then ask user to continue or stop
• Always show

  [Check N/30]

Important Notes

• CI failures: auto-fix without asking
• Review comments: always show to user, ask before fixing
• Never force-push or amend commits
• Each fix is a new commit
• Fix multiple CI failures in one commit when possible
• Do NOT re-run checks automatically (only if user requests

  gh run rerun

  )