Task: Add compass pr checks: CI status for a PR
This page documents a task in the Add PR management support to compass story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Add the PR pillar's first verb: compass pr checks [<pr>] wrapping
gh pr checks (default: the current branch's PR), with --watch,
--fail-fast, --required, and --interval passed through. Output
streams live and the exit code follows gh (0 green, non-zero on
failing/pending) so runbooks can gate on it. Retire the raw gh pr
checks invocations from the review-round runbook and the monitor,
fix-CI, create-PR, and merge recipes.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | Add PR management support to compass |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-06-05 |
Acceptance
compass pr checks [<pr>] [--watch] [--fail-fast] [--required] [--interval N]streams CI status with gh's exit semantics.- No
gh pr checksreferences remain in recipes or runbooks. compass --helpdocuments the PR pillar.
Plan
(Transient implementation strategy. Written when work starts;
distilled into the parent story's * Decisions and cleared when the
task closes. Plans do not outlive their task.)
Notes
PRs
| PR | Title |
|---|---|
| #1084 | [ores.compass] Add pr pillar with checks verb |
Review
| # | Comment summary | File | Decision | Notes |
|---|---|---|---|---|
| 1 | if args.interval: drops explicit 0 | compass_pr.py | Accepted | is not None; d0f3c6708 |
| 2 | –interval default should be None | compass_pr.py | Accepted | d0f3c6708 |
| 3 | Validate –interval: non-negative, only with –watch | compass_pr.py | Accepted | ap.error; d0f3c6708 |
Result
Shipped in PR #1084 (merged 2026-06-05): compass pr checks (gh
exit semantics, –watch/–fail-fast/–required/–interval with clean
validation) and, riding along, compass pr record (the pr-create
task's first slice). Raw gh pr checks retired from the runbook and
four recipes.