How do I find PRs with unattended reviews?

Table of Contents

This is the entry point to a review round: it finds the PRs whose review feedback has not been attended to, before How do I address PR review comments? handles each one.

Question

Which PRs have review comments that nobody has attended to — and of those, which need action here, which are being worked elsewhere, and which were merged or closed with the feedback never addressed?

Answer

./compass.sh review pending                  # last 24h, all PR states
./compass.sh review pending --since 7d       # wider look-back window
./compass.sh review pending --state open     # restrict to open PRs
./compass.sh review pending -f json          # machine-readable

--since accepts 30m, 2h, 24h, 7d style windows over the PR's last-update time.

Results are triaged by severity, carried by the row icon:

  • 🛑 critical — merged or closed PRs with unresolved review threads: the feedback was never addressed. Recover it via a review round on the merged PR (reply, fix forward if needed, resolve).
  • ⚠️ needs a round — open PRs whose branch belongs to this checkout (or has no local worktree). Run Handle a PR review round.
  • fine — open PRs whose branch is checked out in another worktree; the round belongs to that environment, never this one.

Each row carries command hints: compass review list <pr> for the comments, and compass show <uuid> for the story and task the PR is recorded against (omitted when the PR has no agile record — which is itself a traceability smell worth fixing).

Script

projects/ores.compass/src/compass_review.py — the Review pillar module; compass review --help for the full verb set.

Tested by

Manual. First production run (2026-06-05) surfaced six merged PRs with unattended feedback; the sweep is recorded in the review task's notes.

See also

Emacs 29.1 (Org mode 9.6.6)