Files
AirCoding/reference/openai-codex/.codex/skills/babysit-pr/references/github-api-notes.md
AirCoding 82f3140847 Initial commit: AirCoding V1.0.0 Alpha architecture baseline
Complete architecture document set with multi-model review remediation:
- Frozen interface contracts, runtime semantics, DB schemas
- Event/tool/error/provider registries
- Scheduler and main agent state machines
- C4 module/code views, solution architecture, baseline V1
- Multi-model review reports and joint assessment
- Phase-gate remediation complete (P0/P1/P2/UX resolved)
- Implementation plan with T-000A through T-045
- Reference folders kept as placeholders only
2026-05-28 18:45:01 +08:00

2.1 KiB

GitHub CLI / API Notes For babysit-pr

Primary commands used

PR metadata

  • gh pr view --json number,url,state,mergedAt,closedAt,headRefName,headRefOid,headRepository,headRepositoryOwner

Used to resolve PR number, URL, branch, head SHA, and closed/merged state.

PR checks summary

  • gh pr checks --json name,state,bucket,link,workflow,event,startedAt,completedAt

Used to compute pending/failed/passed counts and whether the current CI round is terminal.

Workflow runs for head SHA

  • gh api repos/{owner}/{repo}/actions/runs -X GET -f head_sha=<sha> -f per_page=100

Used to discover failed workflow runs and rerunnable run IDs.

Failed log inspection

  • gh run view <run-id> --json jobs,name,workflowName,conclusion,status,url,headSha
  • gh api repos/{owner}/{repo}/actions/runs/{run_id}/jobs -X GET -f per_page=100
  • gh api repos/{owner}/{repo}/actions/jobs/{job_id}/logs > /tmp/codex-gh-job-{job_id}-logs.zip
  • gh run view <run-id> --log-failed

Used 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.

Retry failed jobs only

  • gh run rerun <run-id> --failed

Reruns only failed jobs (and dependencies) for a workflow run.

  • Issue comments on PR:
    • gh api repos/{owner}/{repo}/issues/<pr_number>/comments?per_page=100
  • Inline PR review comments:
    • gh api repos/{owner}/{repo}/pulls/<pr_number>/comments?per_page=100
  • Review submissions:
    • gh api repos/{owner}/{repo}/pulls/<pr_number>/reviews?per_page=100

JSON fields consumed by the watcher

gh pr view

  • number
  • url
  • state
  • mergedAt
  • closedAt
  • headRefName
  • headRefOid

gh pr checks

  • bucket (pass, fail, pending, skipping)
  • state
  • name
  • workflow
  • link

Actions runs API (workflow_runs[])

  • id
  • name
  • status
  • conclusion
  • html_url
  • head_sha

Actions run jobs API (jobs[])

  • id
  • name
  • status
  • conclusion
  • html_url