fix(review-depth): gate-class Step 11 voices run before any cap stop; --grant runs the owner's fix-check (GST-967)

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This commit is contained in:
garrytanandcapy-ai[bot] committed 2026-11-02 14:03:43 +00:00
1 parent 1022f4fc51
commit 4cfa424c58
15 files changed
+173 -18

No files matched your search

+16 -2
View File
@@ -98,9 +98,16 @@ incomplete coverage, which blocks until the reviewer is rerun.
finishes with its open notes listed in the PR body and receipt, or stops for
the owner when a blocking finding is open, or was fixed in round 2 and is
unverified, or a round-2 fix edited a gate-class path, naming it (path,
severity, problem). A third round is the owner's
severity, problem). The cap limits fix rounds, not Step 11's voices: on gate
class a stop waits for Step 11's adversarial, outside and targeted voices
(`NEXT: voices`), so gate code never reaches the owner's "ship with open
notes" without them (GST-967). A third round is the owner's
grant of one scoped fix-check (recorded in `review_loop_exception`), never the
loop's. The cap approves nothing.
loop's: once `gstack-approvals add` records the grant,
`gstack-review-plan --grant <approval id>` plans that fix-check in place of a
round-2 stop for a fixed blocking finding or a gate-class edit (with
`--fix-checks <n>` after a fix-check), and refuses an id the branch's record
does not hold approved. The cap approves nothing.
<a id="transitions"></a>
### Transitions
@@ -122,12 +129,19 @@ incomplete coverage, which blocks until the reviewer is rerun.
| a full pass that leaves a blocking finding open (fixed or not) | stop: name it for the owner |
| a fix-check that found nothing blocking | done |
| a fix-check that found a blocking finding | stop: name it for the owner |
| a stop (any row above) on gate class before Step 11's voices ran | Step 11's voices (adversarial, outside, targeted), then ask again with `--adversarial-ran` |
| a round-2 stop for a fixed blocking finding or a gate-class edit, with the owner's recorded grant (`--grant <approval id>`) | one scoped fix-check (round 3), after Step 11 on gate class |
A **fix-check** is one reviewer reading the touched hunks, the fix list, the
test results and the callers of every changed symbol, at full effort. It is
logged as a `review-fix-check` row, so it never counts as a pass. No army, no
Red Team and no outside voice run on it.
`NEXT: voices` runs Step 11 as `done` does, from the last full pass's
manifest; /ship then asks the plan again with `--adversarial-ran` (plus the
flags of any fixes the voices queued), and the stop or the granted fix-check it
names stands.
<a id="scoped-pass"></a>
A **scoped pass** is pass 2 after a blocking fix when pass 1 and the diff both
ran below full depth (no gate class, no depth error, no `--depth-floor full`).