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
+14 -7
View File
@@ -608,14 +608,15 @@ patch-id кандидата слияния: вердикт к работе за
| ТЗ | строка «что меняется и чем проверить» в теле issue под `## ТЗ` | «Оценка» (§7.2) и до трёх AC в теле issue под `## ТЗ` | полное ТЗ по §7.1 |
| Ревью ТЗ | нет | нет | да, лимит 4 цикла |
| Локальный гейт | `npm run gate:small` | `npm run gate:small` плюс смоуки `smoke-select` и AC | §8 |
| Код-ревью | до слияния нет; пакетное ревью диапазона перед бетой | модель: корректность и AC | документ ревью, как в §2.7 |
| Код-ревью | до слияния нет; пакетное ревью ночью, перед бетой — проверка покрытия и непрочитанная дельта (§11.7) | модель: корректность и AC | документ ревью, как в §2.7 |
| Лимит циклов код-ревью | — | 2 | 4 |
**Рамки `track:ship`** механические: дифф `src/**` не больше 30 строк, без новых
файлов в `src/**`, без ключей i18n, без полей конфига и без Python. Выход за
рамки переводит задачу в `track:show`. Рамки и слияние `ship` без ревью модели
проверяет и исполняет конвейер (§10.4, #696); код `ship` читает пакетное ревью
диапазона перед бетой (§11.7).
ночью заранее; перед бетой проверяется покрытие и читается непрочитанная дельта
(§11.7).
**Проверка риска по изменённым участкам** (#707). Рамки считают строки и файлы,
но не видят, что именно тронуто: обработчик `pointerdown` в двенадцать строк
@@ -675,7 +676,8 @@ patch-id кандидата слияния: вердикт к работе за
`ux-contract`, `perf-touch`, `undocumented`. Шаг решения по вердикту ставит
`track:ask`, снимает `track:show` и переводит задачу в `S3-spec` комментарием:
критерий словами, документы код-ревью, бюджет. Код остаётся в ветке, полное ТЗ
пишется в теле issue, код класса A не пушится до `S5`; бюджет код-ревью не
пишется в теле issue; до `S5` запрещён push всей ветки, включая тесты и документы
(§11.8), а не только кода класса A; бюджет код-ревью не
обнуляется (§4). Подтверждённый владельцем `show` конвейер не повышает: задача
получает `blocked` и вопрос владельцу с вариантом по умолчанию «повысить до
`ask`». `reclassify` без критерия из списка, на `ask` или на ревью ТЗ —
@@ -1411,7 +1413,7 @@ limit`) и своей логики трека не держит; ответ comp
|---|---|---|---|
| Validate на материале | лёгкий; годится завершённый push-прогон на этом SHA | лёгкий, как у `ship` | лёгкий, как у `ship` (#709) |
| Ребейз до ревью | нет, если `git merge-tree` с `dev` чистый | нет, если чистый | да (#257) |
| Ревью модели | нет — пакетное ревью перед бетой (§11.7) | корректность и AC; окружение — по нужде | полное |
| Ревью модели | нет — пакетное ревью ночью; перед бетой проверка покрытия и непрочитанная дельта (§11.7) | корректность и AC; окружение — по нужде | полное |
| Проверка кандидата слияния | ждёт push-прогон кандидата; dispatch — только если его нет | как у `ship` | как у `ship` (#709) |
Мутантов по диффу нет ни на одном треке (#709, §2.7). Рамки `ship`
@@ -1715,7 +1717,8 @@ Golden, браузерные смоки, performance и полный HA-харн
Это исключение из правила «каждое изменение проходит код-ревью» (§5, §7.1).
Второе такое место — трек `ship` (§5): его ревью не отменяется, а переносится
на пакетное ревью диапазона перед бетой. Здесь же исключение относится только к
на пакетное ревью ночью и проверку покрытия с чтением непрочитанной дельты перед
бетой (§11.7). Здесь же исключение относится только к
окну между `S8-merged` и выпуском.
### 11.5 Независимое ревью линии перед стабильным релизом
@@ -1784,7 +1787,9 @@ action ревью пускает ровно этого бота (`allowed_bots`,
выпуск после такого отказа, исправляют причину и получают новый совместимый
полный зелёный прогон на том же финальном SHA либо на новом SHA кандидата.
### 11.7 Пакетное ревью `ship` перед бетой
<a id="117-пакетное-ревью-ship-перед-бетой"></a>
### 11.7 Пакетное ревью `ship`: ночью и перед бетой
Решение владельца 2026-09-28, issue #696.
@@ -1793,7 +1798,9 @@ action ревью пускает ровно этого бота (`allowed_bots`,
до того, как она уйдёт пользователям беты. Одна сессия на все ship-задачи
диапазона дешевле ревью на каждую, а рамки ship держат объём малым.
**Шаг.** Перед публикацией беты — `ship-review.yml`
**Шаг.** Ночью код читается заранее (режим ниже). Перед публикацией беты
проверяется покрытие; непрочитанные или изменённые после ревью задачи читает
`ship-review.yml`
(`gh workflow run ship-review.yml --ref dev -f tag=vX.Y.Z-beta.N` или кнопка
«Run workflow» в Actions). Это тонкий вызывающий файл, он лежит и в `main`:
без этого GitHub запуск не даёт. Тело `_ship-review.yml` читается из `dev` при