ci(review): two automatic reviews per pull request, on Sonnet

[bowenforsoup]

Why

Each Louise review is a Claude session that costs about $1.55 to $1.93 in API-equivalent usage, billed against the Claude subscription because CI signs in with CLAUDE_CODE_OAUTH_TOKEN. Every push started a new one: coracle.coffee ran 247 reviews on 100 pull requests in the first four days of October. About 60% of them re-reviewed a pull request that already had one. The review bots made about 8,300 of the roughly 9,600 Louise MCP calls in the last 30 days. Each review also bills 5 to 6 Actions minutes, and private repositories have nearly used the Team plan's 3,000 included minutes for October.

What changes

• Two automatic reviews, then on request. A new gate job counts the earlier reviews before the review job starts. A push starts a review only while there have been fewer than two. Opening, reopening, marking ready for review, and the new louise:review label always start one.
  • The post job writes the count on the review comment's second line, <!-- louise-review-count: N -->, so the count survives the comment being replaced. A review posted before this change counts as one. The gate reads only bot comments.
  • The post job removes the louise:review label after posting, so adding it again asks for the next review.
• Sonnet in CI. The session runs with --model sonnet. CLAUDE_CODE_SUBAGENT_MODEL=sonnet with CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 puts the louise:reviewer subagent on Sonnet over its model: opus. A local session keeps Opus. _FORCE needs Claude Code 2.1.257 or later; the action installed 2.1.289 on today's runs.
• The README and the workflow's header describe both, and the caller example adds labeled to the event types.

Rollout

Merge this before any caller adds labeled. With the current main, a labeled event would start a review for any label. A caller without labeled still works: a push past the cap is skipped, and marking the pull request as a draft and then ready for review asks for another. Each repository that wants the label path adds labeled to its caller's types and runs gh label create louise:review once.

Testing

• Ran the gate's jq on sample comments. An old review without a count reads as 1. A review with count 2 reads as 2. A human comment claiming count 99 is ignored. No comments gives 0.
• Ran the post job's sed on review files with the marker line and without it.
• actionlint 1.7.12, with shellcheck on the run: scripts: clean.
• pnpm run lint:docs: 0 errors.
• Not yet run end to end in Actions. The first pull request after merging will exercise it.

Generated with Claude Code