Review Fetch Phase

Run only the state acquisition phase of the review-framework loop:

fetch canonical review state JSON (v2), validate it, and render all derived artifacts via scripts.

Run commands from this skill directory. All script paths below are relative to it.

Inputs

• Required:
  • PR URL (for example: https://github.com/OWNER/REPO/pull/123)
• Optional:
  • output directory

If output directory is omitted, derive:

wip/reviews/<owner>_<repo>_pr-<number>/

Behavior

1. Validate and parse PR URL, then compute deterministic paths:
   • <output-dir>/review-state.json
   • <output-dir>/review-state.md
   • <output-dir>/summary.txt
   • <output-dir>/review-targets.json
2. Ensure <output-dir> exists.
3. Enforce artifact safety before generation (the artifacts must stay untracked). In a git checkout the guard asks git directly; in a Jujutsu workspace with no git directory it accepts a directory under the workspace root's ignored wip/ tree:

node ./scripts/guard-review-artifacts-ignored.mjs --dir <output-dir>

4. Run fetch script to produce canonical JSON:

node ./scripts/fetch-review-state.mjs --pr <PR_URL> --out-json <output-dir>/review-state.json

5. Validate canonical JSON before deriving additional files:

node ./scripts/validate-review-state.mjs --in <output-dir>/review-state.json

6. Render markdown from canonical JSON:

node ./scripts/render-review-state.mjs --in <output-dir>/review-state.json --out <output-dir>/review-state.md

7. Generate text summary from canonical JSON:

node ./scripts/summarize-review-state.mjs --in <output-dir>/review-state.json --format text --out <output-dir>/summary.txt

8. Extract deterministic triage targets for downstream bootstrap:

node ./scripts/extract-review-targets.mjs --in <output-dir>/review-state.json --out <output-dir>/review-targets.json