chore(process): align ship review guidance and guard inventory counts (#767)

Clarify nightly review and beta coverage without changing gates or schedules.
Cover the real night/beta publication summaries and reject stale category
counts, totals and membership in the browser-guard documentation.

Issue: #767
User-Visible: no
This commit is contained in:
Matysh
2026-10-05 08:33:38 +03:00
parent 7fb20c658b
commit cf1c90fb5b
13 changed files with 170 additions and 29 deletions
+4 -3
View File
@@ -64,8 +64,9 @@
([§5](../../PROCESS.md#5-треки-ship-show-ask--метка-владельца)).
- Вердикт код-ревью `show` с `route: reclassify` конвейер исполняет сам:
`track:ask`, `S3-spec` и комментарий с критерием §5 (#726). Дальше — полное ТЗ
по §7.1 в теле issue под `## ТЗ` и ревью ТЗ; код остаётся в ветке, код класса A
не пушить до `S5`. Бюджет код-ревью не обнуляется, лимит — 4. Подтверждённый
по §7.1 в теле issue под `## ТЗ` и ревью ТЗ; код остаётся в ветке, до `S5`
запрещён push всей ветки, включая тесты и документы. Бюджет код-ревью не
обнуляется, лимит — 4. Подтверждённый
владельцем `show` получает `blocked` и вопрос владельцу
([§5](../../PROCESS.md#5-треки-ship-show-ask--метка-владельца)).
- `track:show`: `S2-analysis` → `S5-ready`, до трёх AC автор пишет в теле
@@ -248,7 +249,7 @@
переводит в `track:show`. Код `ship` читает пакетное ревью: ночью
(`SHIP-REVIEW-<база>-dev-<sha12>.md`) и перед бетой — то, что ночь не прочла
(`SHIP-REVIEW-<тег>.md`) ([§10.4](../../PROCESS.md#104-событийный-конвейер-метка-как-триггер),
[§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой)).
[§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой)).
- Автор обязан дождаться вердикта, а не заканчивать сессию:
`node scripts/wait-verdict.mjs --issue NN`, смотреть на метку, а не на
комментарий; при `blocked` не ждать. После прогона ревью метка меняется
+5 -5
View File
@@ -182,21 +182,21 @@
- Задачи `track:ship` слиты без ревью модели; их код одной сессией читает
`ship-review.yml` — ночью (`SHIP-REVIEW-<база>-dev-<sha12>.md`) и перед бетой
то, что ночь не прочла (`SHIP-REVIEW-<тег>.md`): по строке ТЗ каждой задачи и
её коммитам ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой)).
её коммитам ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой)).
- Вопросы к задаче: делает ли код заявленное и только его, не ломает ли
соседнее, не вышла ли правка из ship по смыслу
([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой),
([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой),
[§5](../../PROCESS.md#5-треки-ship-show-ask--метка-владельца)).
- Строка «Риск по участкам» под задачей — рискованные участки ship,
подтверждённого владельцем: конвейер их не повышал, пакетное ревью читает их
первыми ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой)).
первыми ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой)).
- Документ `docs/reviews/SHIP-REVIEW-<тег>.md` публикует детерминированный
шаг; High не пускает бету, Medium и Low решает владелец
([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой)).
([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой)).
- Ночной документ `docs/reviews/SHIP-REVIEW-<база>-dev-<sha12>.md` читает только
непокрытые задачи — без документа или изменившиеся после ревью; бета читает
только то, что ночь не прочла: гейт беты принимает ночной документ при том же
патч-наборе ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-перед-бетой)).
патч-наборе ([§11.7](../../PROCESS.md#117-пакетное-ревью-ship-ночью-и-перед-бетой)).
## Независимое ревью линии
@@ -6,6 +6,11 @@ The guideline is `200` (#699: a guideline, not a wall); `mutation-gate --check`,
must be added deliberately under one reason below, and its mutant `because` must explain
the concrete browser-only invariant.
`test/mutation-gate.test.mjs` checks each category count against its listed IDs,
the total against the browser guards in `MUTANTS`, and both guideline numbers
against `BROWSER_GUARD_LIMIT` (#767). Category names must agree between the table
and inventory; each current browser guard ID must occur exactly once.
Converted witnesses are not listed here: their registry guard names an explicit `node --test`
suite. The original #659 conversions also use `test/mutation-browser-offload.test.mjs`;
new behavioral witnesses execute the consumer directly where possible. Catching the mutant