babysit-pr

Source excerpt starting at line 1.

1# GitHub CLI / API Notes For `babysit-pr`2 3## Primary commands used4 5### PR metadata6 7- `gh pr view --json number,url,state,mergedAt,closedAt,headRefName,headRefOid,headRepository,headRepositoryOwner`8 9Used to resolve PR number, URL, branch, head SHA, and closed/merged state.10 11### PR checks summary12 13- `gh pr checks --json name,state,bucket,link,workflow,event,startedAt,completedAt`14 15Used to compute pending/failed/passed counts and whether the current CI round is terminal.16 17### Workflow runs for head SHA18 19- `gh api repos/{owner}/{repo}/actions/runs -X GET -f head_sha=<sha> -f per_page=100`20 21Used to discover failed workflow runs and rerunnable run IDs.22 23### Failed log inspection24 25- `gh run view <run-id> --json jobs,name,workflowName,conclusion,status,url,headSha`26- `gh api repos/{owner}/{repo}/actions/runs/{run_id}/jobs -X GET -f per_page=100`27- `gh api repos/{owner}/{repo}/actions/jobs/{job_id}/logs > /tmp/codex-gh-job-{job_id}-logs.zip`28- `gh run view <run-id> --log-failed`29 30Used by Codex to classify branch-related vs flaky/unrelated failures. Prefer the direct job log endpoint as soon as a job has failed because `gh run view --log-failed` may not produce failed-job logs until the overall workflow run completes.31 32### Retry failed jobs only33 34- `gh run rerun <run-id> --failed`35 36Reruns only failed jobs (and dependencies) for a workflow run.37 38## Review-related endpoints39 40- Issue comments on PR:41  - `gh api repos/{owner}/{repo}/issues/<pr_number>/comments?per_page=100`42- Inline PR review comments:43  - `gh api repos/{owner}/{repo}/pulls/<pr_number>/comments?per_page=100`44- Review submissions:45  - `gh api repos/{owner}/{repo}/pulls/<pr_number>/reviews?per_page=100`46 47Use each inline comment's `pull_request_review_id` to find its parent review. Ignore parent reviews48whose `state` is `PENDING`, along with their inline comments, until the review is submitted.49 50## JSON fields consumed by the watcher51 52### `gh pr view`53 54- `number`55- `url`56- `state`57- `mergedAt`58- `closedAt`59- `headRefName`60- `headRefOid`61 62### `gh pr checks`63 64- `bucket` (`pass`, `fail`, `pending`, `skipping`)65- `state`66- `name`67- `workflow`68- `link`69 70### Actions runs API (`workflow_runs[]`)71 72- `id`73- `name`74- `status`75- `conclusion`76- `html_url`77- `head_sha`78 79### Actions run jobs API (`jobs[]`)80 81- `id`82- `name`83- `status`84- `conclusion`85- `html_url`86