loop-gh-pr

loop-gh-pr

Compose a /loop that periodically lists open GitHub PRs via gh, detects what is new since the last tick (new PR / new commits / new comments), auto-runs a READ-ONLY /lets:review <N> --json draft for each code change, fires a lets cmux notify, and reschedules - WITHOUT ever posting to a PR.

The skill never invokes /loop itself - Claude Code's /loop is a UI command. It composes the prompt and presents it for paste; once active, the autonomous run uses ScheduleWakeup per tick.

Autonomy boundary (the whole point): /lets:review --json is read-only - it computes findings and posts NOTHING. So the loop safely auto-runs review. Posting (inline / general / approve / merge) is ALWAYS the human's call, out-of-band. The loop stops at a ready draft in .lets/reviews/ + a notification and keeps watching. Never saw -> reviewed -> posted.

IMPORTANT: If the spec below invokes any deferred tool (e.g. AskUserQuestion), you MUST load and call it as specified.

Step 1: Pre-flight (always run)

Confirm github flow + gh auth + that listing PRs works, before composing a long-lived loop.

LETS_PROJECT_ROOT=$(git rev-parse --show-toplevel)

# 1. github flow only (v1). LETS_PR_FLOW is substituted by the orchestrator from LETS Config.
#    If LETS_PR_FLOW != github -> surface "loop-gh-pr is github-only in v1 (LETS_PR_FLOW={value});
#    bitbucket waits on lets-6pxvm" and exit.

# 2. gh present + authed
gh auth status 2>&1 | head -5 || { echo "gh not authed - run: gh auth login"; exit 1; }

# 3. smoke: list open PRs (the watch set). If `comments` is rejected as a list field,
#    drop it here and have the loop fall back to per-PR `gh pr view <N> --json comments`.
gh pr list --state open --json number,title,headRefOid,isDraft,url,updatedAt,comments --limit 30 2>&1 | head -40

Surface a short summary of the current open non-draft PRs (number, title, head SHA short, comment count) so the user sees exactly what the loop will watch. If gh auth status fails -> surface and exit. If gh pr list errors (e.g. not a GitHub remote) -> surface verbatim and exit. Never compose a loop the autonomous run cannot execute.