process: the review pipeline prices each round by track (#696)

show/ship stop paying for diff mutants and for every move of dev: - scripts/process-track.mjs resolves the track from the current labels and the diff (show for unlabelled infra, ask for unlabelled product work) and checks the mechanical ship limits; outside them the pipeline comments and relabels track:ship -> track:show in the same round. - Validate on the review material is light on show/ship: a completed push run on the exact SHA is proof, a dispatch asks mutants=false. ask and the ci:mutants label keep the mutant dispatch. - show/ship skip the pre-review rebase when git merge-tree with dev is clean; the candidate is rebased once at merge and still passes Validate before the push to dev. The light merge waits for the push run of the candidate and dispatches only when none appears. - ship inside the limits merges after the light Validate without a model review; the issue gets a machine marker hp:ship-merge. - ship-review.yml + scripts/ship-review.mjs read the code of all ship tasks of a beta range in one model session and publish docs/reviews/SHIP-REVIEW-<tag>.md; both beta publication paths refuse a range with ship tasks the document does not cover or that carries a High. - show reviews judge correctness and AC; the spec review installs neither npm ci nor Chromium, the show review installs Chromium only when the issue names a smoke. Canon: PROCESS.md §5, §5.1, §10.4, new §11.7; REVIEWER.md, AUTHOR.md and AGENTS.md digests. Issue: #696 User-Visible: no Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018qZfe7YS4rqEMKoVeS3GKd
2026-10-02 04:38:55 +00:00 · 2026-09-28 23:09:46 +03:00
parent 9e4bfb4379
commit e1ae8f4ac7
22 changed files with 1585 additions and 94 deletions
@@ -58,6 +58,8 @@ jobs:
      cycle: ${{ steps.decide.outputs.cycle }}
      spent: ${{ steps.decide.outputs.spent }}
      limit: ${{ steps.decide.outputs.limit }}
+      # #696: текущие метки — prepare выводит из них трек захода.
+      labels: ${{ steps.decide.outputs.labels }}
    steps:
      # Мелкий checkout: guard остаётся лёгким, но ему нужен
      # scripts/review-doc-guard.mjs — счёт раундов вынесен туда, потому что
@@ -85,8 +87,8 @@ jobs:
          has blocked && BLOCKED=true
          has review-4 && EXHAUSTED=true
          # Треки #695 (PROCESS §5): `track:show` и `track:ship` — лимит 2, как у
-          # прежних `small`/`trivial`; `track:ask` — 4. Пока #696 не влит, `ship`
-          # проходит конвейер как `show`.
+          # прежних `small`/`trivial`; `track:ask` — 4. Цену захода по треку
+          # (мутанты, ребейз, модель) решает prepare (#696).
          has small && SMALL=true
          has trivial && TRIVIAL=true
          has track:show && SMALL=true
@@ -301,6 +303,7 @@ jobs:
          echo "cycle=$attempt" >> "$GITHUB_OUTPUT"
          echo "spent=$spent" >> "$GITHUB_OUTPUT"
          echo "limit=$limit" >> "$GITHUB_OUTPUT"
+          echo "labels=$(printf '%s\n' "$current" | paste -sd, -)" >> "$GITHUB_OUTPUT"

  prepare:
    name: "Ревью: материал и deterministic gates"
@@ -336,6 +339,9 @@ jobs:
      spec_body_doc: ${{ steps.spec_body.outputs.doc }}
      spec_body_recorded: ${{ steps.spec_body.outputs.recorded }}
      duration_seconds: ${{ steps.duration.outputs.seconds }}
+      track: ${{ steps.track.outputs.track }}
+      mutants: ${{ steps.track.outputs.mutants }}
+      ship: ${{ steps.track.outputs.ship }}
    steps:
      - name: Начать измерение стадии
        id: clock
@@ -406,6 +412,58 @@ jobs:
            echo "МАТЕРИАЛ НЕ ЗАПУШЕН" >> "$GITHUB_STEP_SUMMARY"
          fi

+      # Трек решает цену захода (PROCESS.md §5, §10.4, #696): мутанты по диффу —
+      # только `track:ask` и метка `ci:mutants`; `ship` сливается без модели,
+      # если правка укладывается в механические рамки. Рамки судят дифф от
+      # merge-base с dev — работу задачи, а не то, что принёс dev, — поэтому шаг
+      # стоит до ребейза. Выход за рамки повышает трек до `show` здесь же:
+      # повысить трек вправе любой, понизить — только владелец (§5). Скрипт
+      # берётся из dev, как помощник ребейза: show/ship до ревью не ребейзятся,
+      # и ветка, отставшая от dev, его может ещё не нести.
+      - name: "Трек задачи и рамки ship (#696)"
+        id: track
+        env:
+          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          NUM: ${{ github.event.issue.number }}
+          STAGE: ${{ needs.guard.outputs.stage }}
+          LABELS: ${{ needs.guard.outputs.labels }}
+          BRANCH: ${{ steps.branch.outputs.name }}
+        run: |
+          git fetch -q origin dev
+          tools="$RUNNER_TEMP/track-tools"
+          rm -rf "$tools" && mkdir -p "$tools"
+          git archive origin/dev scripts | tar -x -C "$tools"
+          head=HEAD
+          if [ -z "$BRANCH" ]; then head=origin/dev; fi
+          out=$(node "$tools/scripts/process-track.mjs" resolve --labels="$LABELS" --base=origin/dev --head="$head")
+          printf '%s\n' "$out"
+          track=$(printf '%s\n' "$out" | sed -n 's/^track=//p')
+          mutants=$(printf '%s\n' "$out" | sed -n 's/^mutants=//p')
+          ship=false
+          if [ "$track" = "ship" ] && [ "$STAGE" = "code" ] && [ -n "$BRANCH" ]; then
+            limits=$(node "$tools/scripts/process-track.mjs" ship-limits --base=origin/dev --head=HEAD)
+            printf '%s\n' "$limits"
+            if printf '%s\n' "$limits" | grep -qx 'ship=true'; then
+              ship=true
+            else
+              violations=$(printf '%s\n' "$limits" | sed -n 's/^violations=//p')
+              track=show
+              cat > /tmp/ship.md <<EOF
+          **Трек повышен: \`track:ship\` → \`track:show\`.** Правка выходит за механические рамки ship (PROCESS.md §5): $violations.
+
+          Слияние без ревью модели для неё закрыто. Этот заход идёт по треку show: лёгкий Validate и ревью модели «корректность и AC». Понизить трек обратно может только владелец.
+
+          [Прогон](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).
+          EOF
+              gh issue comment "$NUM" --repo "${{ github.repository }}" --body-file /tmp/ship.md
+              gh issue edit "$NUM" --repo "${{ github.repository }}" \
+                --add-label track:show --remove-label track:ship
+              echo "track:ship -> track:show: $violations"
+            fi
+          fi
+          { echo "track=$track"; echo "mutants=$mutants"; echo "ship=$ship"; } >> "$GITHUB_OUTPUT"
+          echo "- трек **$track** · мутанты по диффу: $mutants · слияние без модели: $ship" >> "$GITHUB_STEP_SUMMARY"
+
      # Ревьюер обязан смотреть тот же код, который уедет в dev (#257). Раньше
      # ревью шло по ветке как есть, а слияние делало ребейз — проверенный SHA и
      # слитый SHA были разными коммитами. Пока расхождение с dev текстовое,
@@ -427,6 +485,7 @@ jobs:
          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
          BRANCH: ${{ steps.branch.outputs.name }}
          NUM: ${{ github.event.issue.number }}
+          TRACK: ${{ steps.track.outputs.track }}
          # rebase, в отличие от commit, не принимает -c user.*: он запускает
          # свои процессы и требует личность в окружении, иначе падает с
          # «unable to auto-detect email address».
@@ -441,6 +500,21 @@ jobs:
            exit 0
          fi
          behind=$(git rev-list --count "HEAD..origin/dev")
+          # #696: на show/ship ветка до ревью к dev не приводится, если
+          # сливается с ним без конфликта. Ребейз — один раз, при слиянии, и
+          # кандидат проходит Validate до push в dev (merge-candidate.mjs, #492):
+          # в dev по-прежнему уезжает только проверенный CI SHA. Каждый сдвиг dev
+          # больше не оплачивается force-push, новым SHA и новым прогоном до
+          # ревью. На ask ребейз остаётся (#257): ревьюер читает то дерево,
+          # которое уедет в dev.
+          if [ "$TRACK" = "show" ] || [ "$TRACK" = "ship" ]; then
+            if git merge-tree --write-tree origin/dev HEAD >/dev/null 2>&1; then
+              echo "note=Ветка не приводилась к dev (трек $TRACK, #696): dev впереди на $behind коммит(ов), слияние без конфликта. Материал — ветка как есть; ребейз будет один раз, при слиянии, и кандидат пройдёт Validate до push в dev." >> "$GITHUB_OUTPUT"
+              echo "трек $TRACK: dev впереди на $behind коммит(ов), слияние чистое — ребейз отложен до слияния"
+              exit 0
+            fi
+            echo "трек $TRACK: слияние с dev не чистое — ветка приводится к dev до ревью"
+          fi
          before=$(git rev-parse "origin/$BRANCH")
          echo "dev впереди на $behind коммит(ов) — привожу ветку"
          # #643: doc-коммит ветки конфликтует с документами других задач в dev
@@ -627,13 +701,15 @@ jobs:
          echo "S7-code-review -> S6-in-progress (ревью не запускалось)"

      # Мутанты по диффу бегут только по запросу (#510): до ревью конвейер
-      # запускает Validate с мутантами на материале и ждёт его. Красный или
+      # запускает Validate на материале и ждёт его — с мутантами на `ask` и по
+      # метке `ci:mutants`, лёгкий на `show`/`ship` (#696). Лёгкому годится и
+      # завершённый push-прогон на том же SHA: dispatch повторил бы его. Красный или
      # пропавший прогон возвращает задачу автору без ревью — цикл не
      # тратится на код, который CI уже отверг (08.09: #437 дважды ушёл в S6
      # после запущенного 15-минутного ревью). Этап spec кода не несёт и
      # гейт не проходит; повторное применение вердикта (#499) — тоже: там
      # слияние само дожидается Validate на кандидате.
-      - name: Validate с мутантами на материале
+      - name: Validate на материале
        id: gate
        if: steps.rebase.outputs.conflict != 'true'
        env:
@@ -642,6 +718,7 @@ jobs:
          REUSE: ${{ steps.reuse.outputs.reuse }}
          BRANCH: ${{ steps.branch.outputs.name }}
          SHA: ${{ steps.material.outputs.sha }}
+          MUTANTS: ${{ steps.track.outputs.mutants }}
        run: |
          if [ "$STAGE" != "code" ] || [ "$REUSE" = "true" ] || [ -z "$BRANCH" ]; then
            echo "гейт не применяется: этап $STAGE, reuse=${REUSE:-false}, ветка ${BRANCH:-dev}"
@@ -655,7 +732,8 @@ jobs:
          # S7), страховка — process-reconcile. Зелёный или красный завершённый
          # прогон гейт и без ожидания возвращает сразу.
          set +e
-          node scripts/validate-gate.mjs --repo="${{ github.repository }}" --ref="$BRANCH" --sha="$SHA" --no-wait
+          node scripts/validate-gate.mjs --repo="${{ github.repository }}" --ref="$BRANCH" --sha="$SHA" --no-wait \
+            --mutants="${MUTANTS:-true}"
          code=$?
          set -e
          case "$code" in
@@ -680,6 +758,7 @@ jobs:
          SHA: ${{ steps.material.outputs.sha }}
          VALIDATE_RUN_ID: ${{ steps.gate.outputs.run_id }}
          VALIDATE_URL: ${{ steps.gate.outputs.url }}
+          MUTANTS: ${{ steps.track.outputs.mutants }}
        run: |
          dir="$RUNNER_TEMP/review-pending"
          mkdir -p "$dir"
@@ -693,7 +772,9 @@ jobs:
          (cd "$dir" && sha256sum pending.json > manifest.sha256)
          echo "artifact=review-pending-${NUM}-${GITHUB_RUN_ID}-${GITHUB_RUN_ATTEMPT}" >> "$GITHUB_OUTPUT"
          short=$(git rev-parse --short "$SHA")
-          echo "Validate с мутантами на \`$short\` идёт — раннер освобождён, раунд продолжится по завершении прогона${VALIDATE_URL:+ ($VALIDATE_URL)}." >> "$GITHUB_STEP_SUMMARY"
+          kind="Validate с мутантами"
+          if [ "$MUTANTS" = "false" ]; then kind="Лёгкий Validate"; fi
+          echo "$kind на \`$short\` идёт — раннер освобождён, раунд продолжится по завершении прогона${VALIDATE_URL:+ ($VALIDATE_URL)}." >> "$GITHUB_STEP_SUMMARY"

      - name: Сохранить маркер ожидания
        if: steps.gate.outputs.proceed == 'pending'
@@ -714,10 +795,13 @@ jobs:
          RESULT: ${{ steps.gate.outputs.result }}
          NOTE: ${{ steps.gate.outputs.note }}
          URL: ${{ steps.gate.outputs.url }}
+          MUTANTS: ${{ steps.track.outputs.mutants }}
        run: |
          short=$(git rev-parse --short "$SHA")
+          kind="Validate с мутантами"
+          if [ "$MUTANTS" = "false" ]; then kind="Validate"; fi
          cat > /tmp/gate.md <<EOF
-          **Ревью не запускалось:** Validate с мутантами на материале \`$short\` (ветка \`$BRANCH\`) — **$RESULT**: $NOTE.${URL:+ [Прогон]($URL).} Код никто не читал, вердикта нет, цикл ревью не израсходован.
+          **Ревью не запускалось:** $kind на материале \`$short\` (ветка \`$BRANCH\`) — **$RESULT**: $NOTE.${URL:+ [Прогон]($URL).} Код никто не читал, вердикта нет, цикл ревью не израсходован.

          Гейт стоит до ревью намеренно (#510): красный CI всё равно вернул бы задачу, но уже после потраченного ревью.

@@ -725,14 +809,14 @@ jobs:

          1. починить то, что назвал прогон, и запушить ветку **одним** коммитом-заходом;
          2. дождаться зелёного дешёвого Validate на пуше;
-          3. вернуть метку \`S7-code-review\` — конвейер сам запустит Validate с мутантами и ревью.
+          3. вернуть метку \`S7-code-review\` — конвейер сам запустит $kind и ревью.

          [Прогон конвейера](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).
          EOF
          gh issue comment "$NUM" --repo "${{ github.repository }}" --body-file /tmp/gate.md
          gh issue edit "$NUM" --repo "${{ github.repository }}" \
            --add-label S6-in-progress --remove-label S7-code-review
-          echo "S7-code-review -> S6-in-progress (Validate с мутантами: $RESULT)"
+          echo "S7-code-review -> S6-in-progress ($kind: $RESULT)"

      # Ревьюер перегонял tsc, юниты и сборку заново в каждом раунде, хотя
      # Validate на том же SHA уже зелёный (#343). Это не тщательность: бюджет
@@ -800,7 +884,7 @@ jobs:

      - name: Собрать контракт материала между стадиями
        id: prepared
-        if: steps.gate.outputs.proceed == 'true' && steps.reuse.outputs.reuse != 'true'
+        if: steps.gate.outputs.proceed == 'true' && steps.reuse.outputs.reuse != 'true' && steps.track.outputs.ship != 'true'
        env:
          NUM: ${{ github.event.issue.number }}
          STAGE: ${{ needs.guard.outputs.stage }}
@@ -836,7 +920,7 @@ jobs:
          echo "artifact=review-prepared-${NUM}-${GITHUB_RUN_ID}-${GITHUB_RUN_ATTEMPT}" >> "$GITHUB_OUTPUT"

      - name: Передать подтверждённый материал модели
-        if: steps.gate.outputs.proceed == 'true' && steps.reuse.outputs.reuse != 'true'
+        if: steps.gate.outputs.proceed == 'true' && steps.reuse.outputs.reuse != 'true' && steps.track.outputs.ship != 'true'
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
        with:
          name: ${{ steps.prepared.outputs.artifact }}
@@ -879,7 +963,9 @@ jobs:
      contents: read
      issues: write
    needs: [guard, prepare]
-    if: needs.prepare.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
+    # #696: `ship` в рамках сливается без модели — пакетное ревью диапазона
+    # перед бетой (PROCESS.md §11.7, ship-review.yml).
+    if: needs.prepare.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true' && needs.prepare.outputs.ship != 'true'
    runs-on: ubuntu-24.04
    concurrency:
      group: process-issue-${{ github.event.issue.number }}
@@ -945,22 +1031,46 @@ jobs:
          test "$(git rev-parse HEAD)" = "$MATERIAL_SHA"
          test "$(git rev-parse 'HEAD^{tree}')" = "$MATERIAL_TREE"

+      # #696: окружение ставится по нужде. Ревью ТЗ кода не исполняет — ни
+      # `npm ci`, ни браузера. Ревью `show` ставит Chromium, только если тело
+      # issue называет смоук или браузер; `ask` — как прежде, всегда. Тело не
+      # прочитано — браузер ставится: лишняя минута дешевле непрогнанного смоука.
+      - name: Что ревьюеру нужно из окружения
+        id: env_needs
+        env:
+          GH_TOKEN: ${{ github.token }}
+          NUM: ${{ github.event.issue.number }}
+          STAGE: ${{ needs.guard.outputs.stage }}
+          TRACK: ${{ needs.prepare.outputs.track }}
+        run: |
+          deps=true; browser=true
+          if [ "$STAGE" = "spec" ]; then deps=false; browser=false; fi
+          if [ "$STAGE" = "code" ] && [ "$TRACK" = "show" ]; then
+            if body=$(gh issue view "$NUM" --repo "${{ github.repository }}" --json body --jq .body 2>/dev/null); then
+              if ! printf '%s' "$body" | grep -qiE 'smoke|смоук|смок|playwright|браузер|demo/'; then browser=false; fi
+            fi
+          fi
+          { echo "deps=$deps"; echo "browser=$browser"; } >> "$GITHUB_OUTPUT"
+          echo "- окружение ревьюера: npm ci $deps · Chromium $browser" >> "$GITHUB_STEP_SUMMARY"
+
      # Зависимости ставятся ПОСЛЕ переключения на ветку задачи: lockfile мог
      # измениться именно в ней, и установка по копии из dev дала бы не то дерево.
      - name: Установить зависимости
+        if: steps.env_needs.outputs.deps == 'true'
        run: npm ci

      # Браузер нужен не всякому ревью (см. правило выбора гейтов в промпте),
      # но когда нужен — качать его заново дороже, чем держать в кэше.
      - name: Кэш браузеров Playwright
        id: pw
+        if: steps.env_needs.outputs.browser == 'true'
        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
        with:
          path: ~/.cache/ms-playwright
          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}

      - name: Установить Chromium
-        if: steps.pw.outputs.cache-hit != 'true'
+        if: steps.env_needs.outputs.browser == 'true' && steps.pw.outputs.cache-hit != 'true'
        # Без --with-deps: системные библиотеки Chromium предустановлены в
        # образе раннера, а apt при промахе кэша съедал минуты из бюджета
        # ревью и подолгу перебирал недоступное azure-зеркало (#175). Если
@@ -1020,6 +1130,9 @@ jobs:
              ничего не вернул на правки и цикла не образует (#227).
              Номер захода нужен для имени документа — два документа с
              одинаковым номером затёрли бы друг друга.
+            Трек: ${{ needs.prepare.outputs.track || 'ask' }} (PROCESS.md §5) · мутанты по диффу на материале: ${{ needs.prepare.outputs.mutants == 'false' && 'не запрашивались' || 'прогнаны Validate' }}
+
+            ${{ needs.prepare.outputs.track == 'show' && needs.guard.outputs.stage == 'code' && 'Трек show: объём и серьёзность находок — docs/process/REVIEWER.md, «Трек show» (#696). Отсутствие мутантов по диффу — не находка.' || '' }}

            ${{ needs.prepare.outputs.rebase_note }}

@@ -1107,8 +1220,8 @@ jobs:
            и в повторном раунде тоже: `npx tsc --noEmit`, `npm test`,
            `npm run build` со сверкой трёх копий бандла, плюс
            `node scripts/check-docs.mjs`, если diff трогает `src/**`.
-            Зависимости уже установлены workflow, Chromium тоже — `npm ci`
-            выполнять не нужно. По диффу и AC: браузерные смоки — названные в AC
+            ${{ needs.guard.outputs.stage == 'spec' && 'Зависимости и Chromium на этапе spec не ставились (#696).' || (needs.prepare.outputs.track == 'show' && 'Зависимости установлены (`npm ci` не нужен); Chromium — только если тело issue называет смоук (#696).' || 'Зависимости уже установлены workflow, Chromium тоже — `npm ci` выполнять не нужно.') }}
+            По диффу и AC: браузерные смоки — названные в AC
            плюс вывод `node scripts/smoke-select.mjs --base <base> --head <head>`,
            приложенный к комментарию с решением по каждой строке: прогнал либо
            не прогнал и почему. Три вида ответа инструмента разные: «прямое
@@ -1248,6 +1361,7 @@ jobs:
          MODEL_RESULT: ${{ needs.model_review.result }}
          PROCEED: ${{ needs.prepare.outputs.proceed }}
          REUSE: ${{ needs.prepare.outputs.reuse }}
+          SHIP: ${{ needs.prepare.outputs.ship }}
        run: |
          if [ "$PREPARE_RESULT" != "success" ]; then
            echo "::error::стадия deterministic prerequisites завершилась: $PREPARE_RESULT"
@@ -1263,7 +1377,8 @@ jobs:
            echo "proceed=false" >> "$GITHUB_OUTPUT"
            exit 0
          fi
-          if [ "$REUSE" != "true" ] && [ "$MODEL_RESULT" != "success" ]; then
+          # #696: `ship` в рамках модель не вызывает — её результата не ждём.
+          if [ "$REUSE" != "true" ] && [ "$SHIP" != "true" ] && [ "$MODEL_RESULT" != "success" ]; then
            echo "::error::стадия model review завершилась: $MODEL_RESULT"
            exit 1
          fi
@@ -1282,7 +1397,7 @@ jobs:
          node-version: 22

      - name: Получить результат модели
-        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
+        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true' && needs.prepare.outputs.ship != 'true'
        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
        with:
          name: review-result-${{ github.event.issue.number }}-${{ github.run_id }}-${{ github.run_attempt }}
@@ -1290,7 +1405,7 @@ jobs:

      - name: Проверить полноту и происхождение результата
        id: result
-        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
+        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true' && needs.prepare.outputs.ship != 'true'
        # #556: единственное, что недоверенная стадия модели может передать
        # дальше, — этот artifact, и принимается он как ввод противника: полный
        # набор файлов, сходящиеся суммы, совпадение КАЖДОГО поля паспорта с
@@ -1326,7 +1441,7 @@ jobs:
      # Ревьюер пишет только в docs/reviews/. Что именно попадёт в коммит,
      # решает этот шаг, а не модель: всё остальное откатывается.
      - name: Опубликовать документ ревью
-        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
+        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true' && needs.prepare.outputs.ship != 'true'
        env:
          TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
          BRANCH: ${{ needs.prepare.outputs.branch }}
@@ -1499,7 +1614,7 @@ jobs:
      # достижим там из необновлённой локальной ветки. Читателю отчёта от этого
      # пользы нет — он достанет только то, что есть на origin.
      - name: "Материал раунда воспроизводим (#413)"
-        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
+        if: steps.ready.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true' && needs.prepare.outputs.ship != 'true'
        env:
          NUM: ${{ github.event.issue.number }}
          STAGE: ${{ needs.guard.outputs.stage }}
@@ -1524,10 +1639,28 @@ jobs:
          REUSE_DOC: ${{ needs.prepare.outputs.reuse_doc }}
          REUSE_ROUND: ${{ needs.prepare.outputs.reuse_round }}
          REUSE_TREE: ${{ needs.prepare.outputs.reuse_tree }}
+          SHIP: ${{ needs.prepare.outputs.ship }}
+          MATERIAL: ${{ needs.prepare.outputs.material_sha }}
+          VALIDATE_URL: ${{ needs.prepare.outputs.validate_url }}
          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
          NUM: ${{ github.event.issue.number }}
        run: |
-          if [ "$REUSE" = "true" ]; then
+          # Повторно применимый зелёный вердикт (#499) главнее ship: код уже
+          # прочитан моделью, и пакетному ревью перечитывать его незачем.
+          if [ "$SHIP" = "true" ] && [ "$REUSE" != "true" ]; then
+            # #696: `ship` в рамках (PROCESS.md §5) сливается без ревью модели
+            # после зелёного лёгкого Validate. Комментарий — не вердикт ревью и
+            # так себя не называет: ревью не было. Машинный маркер находит
+            # пакетное ревью диапазона перед бетой (ship-review.mjs, §11.7).
+            verdict=green; high=0
+            short=$(printf '%s' "$MATERIAL" | cut -c1-8)
+            cat > /tmp/ship-merge.md <<EOF
+          **Слияние без ревью модели: трек ship (PROCESS.md §5, #696).** Правка укладывается в механические рамки ship, лёгкий Validate на \`$short\` зелёный${VALIDATE_URL:+ ([прогон]($VALIDATE_URL))}. Код до слияния не читал никто: его прочтёт пакетное ревью диапазона перед бетой (PROCESS.md §11.7), документ \`docs/reviews/SHIP-REVIEW-<тег>.md\`.
+
+          <!-- hp:ship-merge material=$MATERIAL -->
+          EOF
+            gh issue comment "$NUM" --repo "${{ github.repository }}" --body-file /tmp/ship-merge.md
+          elif [ "$REUSE" = "true" ]; then
            # Модель не вызывалась: вердикт — записанный конвейером зелёный
            # прошлого захода, дерево вне docs/reviews с тех пор не менялось (#499).
            verdict=green; high=0
@@ -1607,6 +1740,8 @@ jobs:
          BRANCH: ${{ needs.prepare.outputs.branch }}
          NUM: ${{ github.event.issue.number }}
          MATERIAL_SHA: ${{ needs.prepare.outputs.material_sha }}
+          # #696: show/ship сливаются по лёгкому Validate на кандидате.
+          MUTANTS: ${{ needs.prepare.outputs.mutants }}
        run: |
          if [ -z "$BRANCH" ]; then
            echo "::error::ветки задачи нет — сливать нечего"
@@ -1614,7 +1749,7 @@ jobs:
            exit 0
          fi
          node scripts/merge-candidate.mjs --branch="$BRANCH" --material="$MATERIAL_SHA" \
-            --issue="$NUM" --repo="${{ github.repository }}"
+            --issue="$NUM" --repo="${{ github.repository }}" --mutants="${MUTANTS:-true}"

      - name: Переставить метку
        if: steps.ready.outputs.proceed == 'true'
@@ -1661,13 +1796,14 @@ jobs:
          MODEL_RESULT: ${{ needs.model_review.result }}
          PROCEED: ${{ needs.prepare.outputs.proceed }}
          REUSE: ${{ needs.prepare.outputs.reuse }}
+          SHIP: ${{ needs.prepare.outputs.ship }}
        run: |
          stage="публикация/интеграция"
          detail="Модель уже завершила работу; её запечатанный результат сохранён artifact-ом этого run, но не был применён."
          if [ "$PREPARE_RESULT" != "success" ]; then
            stage="deterministic prerequisites"
            detail="Модель не запускалась, цикл ревью не израсходован."
-          elif [ "$PROCEED" = "true" ] && [ "$REUSE" != "true" ] && [ "$MODEL_RESULT" != "success" ]; then
+          elif [ "$PROCEED" = "true" ] && [ "$REUSE" != "true" ] && [ "$SHIP" != "true" ] && [ "$MODEL_RESULT" != "success" ]; then
            stage="model review"
            detail="Полного валидного результата модели нет; метка не менялась."
          fi
@@ -91,6 +91,14 @@ jobs:
          REPO: ${{ github.repository }}
          SHA: ${{ steps.candidate.outputs.sha }}
        run: node scripts/release-gate.mjs "$SHA"
+      # #696, PROCESS.md §11.7: задачи track:ship слиты без ревью модели — бета
+      # публикуется, только когда их код прочитало пакетное ревью диапазона.
+      - name: Ship tasks of the range are batch-reviewed
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ steps.candidate.outputs.tag }}
+          SHA: ${{ steps.candidate.outputs.sha }}
+        run: node scripts/ship-review.mjs check --tag="$TAG" --candidate="$SHA" --repo="$GITHUB_REPOSITORY"
      - name: Bind issue membership to the exact candidate
        env:
          GH_TOKEN: ${{ github.token }}
@@ -0,0 +1,334 @@
+name: "Бета: пакетное ревью ship"
+run-name: "Ship review ${{ inputs.tag }}"
+
+# #696, PROCESS.md §11.7: задачи `track:ship` сливаются без ревью модели —
+# правка в механических рамках и зелёный лёгкий Validate. Их код читает одна
+# сессия модели перед бетой: все ship-задачи диапазона «прошлый тег..кандидат».
+# Гейт публикации беты (`ship-review.mjs check`) требует этот документ, если в
+# диапазоне есть ship-задачи.
+#
+# Только `workflow_dispatch`: файл исполняется с ветки прогона (`--ref dev`),
+# зеркало в `main` не нужно. Три job, как у release-review.yml (#551, #556):
+# детерминированный вход, модель без права записи, детерминированная
+# публикация документа в `dev`.
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Beta tag the review is for, for example v1.79.0-beta.1"
+        required: true
+        type: string
+      candidate:
+        description: "Exact candidate SHA; empty = the dev tip"
+        required: false
+        type: string
+        default: ""
+      force:
+        description: "Review again even when the document already exists in dev"
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ship-review-${{ inputs.tag }}
+  cancel-in-progress: false
+
+jobs:
+  prepare:
+    name: "Ship-ревью: задачи диапазона"
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      issues: read
+    outputs:
+      proceed: ${{ steps.range.outputs.proceed }}
+      candidate: ${{ steps.range.outputs.candidate }}
+      base: ${{ steps.range.outputs.base }}
+      doc: ${{ steps.range.outputs.doc }}
+      issues: ${{ steps.range.outputs.issues }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+          ref: dev
+          persist-credentials: false
+
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+
+      - name: Кандидат, база и ship-задачи
+        id: range
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ inputs.tag }}
+          CANDIDATE: ${{ inputs.candidate }}
+          FORCE: ${{ inputs.force }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          doc=$(node scripts/ship-review.mjs doc --tag="$TAG")
+          git fetch -q --tags origin
+          if [ -z "$CANDIDATE" ]; then CANDIDATE=$(git rev-parse origin/dev); fi
+          git cat-file -e "$CANDIDATE^{commit}"
+          CANDIDATE=$(git rev-parse "$CANDIDATE^{commit}")
+          if [ "$FORCE" != "true" ] && git cat-file -e "origin/dev:$doc" 2>/dev/null; then
+            echo "::notice::$doc уже есть в dev — повторное ревью не запускается (force=true, чтобы переснять)"
+            echo "proceed=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          out="$RUNNER_TEMP/ship-review-input"
+          node scripts/ship-review.mjs prepare --tag="$TAG" --candidate="$CANDIDATE" \
+            --out="$out" --repo="${{ github.repository }}" --run-url="$RUN_URL" | tee "$RUNNER_TEMP/range.txt"
+          cat "$RUNNER_TEMP/range.txt" >> "$GITHUB_OUTPUT"
+          echo "candidate=$CANDIDATE" >> "$GITHUB_OUTPUT"
+          issues=$(sed -n 's/^issues=//p' "$RUNNER_TEMP/range.txt")
+          if [ -z "$issues" ]; then
+            echo "::notice::ship-задач в диапазоне нет — ревью не нужно"
+            echo "proceed=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "proceed=true" >> "$GITHUB_OUTPUT"
+          (cd "$out" && sha256sum brief.md ship-issues.json > manifest.sha256)
+          cat "$out/brief.md" >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Передать вход модели
+        if: steps.range.outputs.proceed == 'true'
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: ship-review-input-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/ship-review-input
+          if-no-files-found: error
+          retention-days: 3
+
+  model_review:
+    name: "Ship-ревью: работа модели"
+    needs: prepare
+    if: needs.prepare.outputs.proceed == 'true'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
+    # Недоверенная стадия без права записи (#556): документ публикует
+    # `publish`. `github_token` у шага Review обязателен — без него action
+    # меняет OIDC на собственный App-токен с правом записи.
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+          ref: ${{ needs.prepare.outputs.candidate }}
+          persist-credentials: false
+
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Получить вход
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: ship-review-input-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/ship-review-input
+
+      - name: Проверить вход и кандидата
+        env:
+          CANDIDATE: ${{ needs.prepare.outputs.candidate }}
+        run: |
+          (cd "$RUNNER_TEMP/ship-review-input" && sha256sum -c manifest.sha256)
+          test "$(git rev-parse HEAD)" = "$CANDIDATE"
+
+      - name: Установить зависимости
+        run: npm ci
+
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
+
+      - name: Установить Chromium
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install chromium
+
+      # Тот же обход, что у конвейера (_process.yml, anthropics issue 1817).
+      - name: Установить Claude Code детерминированно
+        id: claude_bin
+        run: |
+          src=$(ls "$RUNNER_WORKSPACE"/../_actions/anthropics/claude-code-*/v1/src/entrypoints/run.ts 2>/dev/null | head -1)
+          ver=$(grep -oE 'claudeCodeVersion = "[0-9]+\.[0-9]+\.[0-9]+"' "$src" 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || true)
+          ver="${ver:-2.1.265}"
+          base=https://downloads.claude.ai/claude-code-releases
+          bin="$HOME/.local/bin/claude"
+          mkdir -p "$(dirname "$bin")"
+          curl -fsSL --retry 3 "$base/$ver/linux-x64/claude" -o "$bin"
+          sum=$(curl -fsSL --retry 3 "$base/$ver/manifest.json" | jq -r '.platforms["linux-x64"].checksum')
+          echo "$sum  $bin" | sha256sum -c -
+          chmod +x "$bin"
+          "$bin" --version
+          echo "path=$bin" >> "$GITHUB_OUTPUT"
+
+      - name: Review
+        id: review
+        uses: anthropics/claude-code-action@9cdae7f0d995e3ba7c33f226087fdf82a59cd520 # v1
+        env:
+          REVIEW_DOC: ${{ runner.temp }}/ship-review.md
+          REVIEW_INPUT: ${{ runner.temp }}/ship-review-input
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          path_to_claude_code_executable: ${{ steps.claude_bin.outputs.path }}
+          prompt: |
+            Ты ревьюер кода проекта House Plan. Язык ответа — русский.
+
+            Бета: ${{ inputs.tag }} · кандидат ${{ needs.prepare.outputs.candidate }}
+            (рабочая копия уже на нём) · база диапазона: ${{ needs.prepare.outputs.base || 'нет' }}.
+            Задачи: ${{ needs.prepare.outputs.issues }} — вход в $REVIEW_INPUT/brief.md
+            (строка ТЗ каждой задачи и её коммиты) и $REVIEW_INPUT/ship-issues.json.
+
+            Эти задачи шли по треку ship и слиты в dev без ревью модели: правка
+            в механических рамках и зелёный лёгкий Validate. Ты — первый, кто
+            читает их код. Правила — docs/process/REVIEWER.md, раздел
+            «Пакетное ревью ship», канон — PROCESS.md §5 и §11.7. Прочитай их
+            первыми.
+
+            По каждой задаче: `git show <sha>` каждого коммита; делает ли код
+            то, что сказано в строке ТЗ, и только это; не ломает ли соседнее
+            поведение; не вышла ли правка из трека ship по смыслу (новый
+            UX-контракт, геометрия, конфиг, перф) — это находка Medium с
+            предложением трека. Исполняй, где дёшево: `npm test`, смоук,
+            который называет строка ТЗ или выбирает
+            `node scripts/smoke-select.mjs --base <sha>^ --head <sha>`.
+
+            Серьёзность: High — дефект, который увидит пользователь беты, или
+            правка не делает заявленного; High блокирует публикацию беты.
+            Medium — поведение вне заявленного или вне рамок трека; Low —
+            остальное. Находка чинится отдельной задачей, ты ничего не правишь.
+
+            Ты ничего не правишь и не публикуешь: ни код, ни issue, ни
+            комментарии. Права на запись у тебя нет. Любые изменения рабочей
+            копии будут отброшены — после проверок восстанови её сам
+            (`git checkout -- . && git clean -fd`), если что-то менял.
+
+            Напиши документ в файл по пути из переменной REVIEW_DOC (абсолютный,
+            вне репозитория). Первой строкой после заголовка —
+            `Итог: High N · Medium N · Low N`. Затем по задаче на раздел
+            `## #NN — заголовок`: что проверил (команда → результат), находки с
+            воспроизведением, чего не проверял.
+
+            Затем верни JSON по схеме — последнее обязательное действие.
+          claude_args: |
+            --max-turns 150
+            --allowedTools Read,Write,Grep,Glob,Bash
+            --json-schema '{"type":"object","properties":{"high":{"type":"integer"},"medium":{"type":"integer"},"low":{"type":"integer"},"summary":{"type":"string"}},"required":["high","medium","low","summary"]}'
+
+      - name: Запечатать результат модели
+        env:
+          SOURCE: ${{ runner.temp }}/ship-review.md
+          OUT: ${{ steps.review.outputs.structured_output }}
+        run: |
+          test -s "$SOURCE" || { echo "::error::модель не оставила документ ревью"; exit 1; }
+          dir="$RUNNER_TEMP/ship-review-result"
+          mkdir -p "$dir"
+          printf '%s' "$OUT" > "$dir/result.json"
+          jq -e '(.high|type=="number") and (.medium|type=="number") and (.low|type=="number") and (.summary|type=="string")' \
+            "$dir/result.json" >/dev/null
+          cp "$SOURCE" "$dir/ship-review.md"
+          (cd "$dir" && sha256sum ship-review.md result.json > manifest.sha256)
+
+      - name: Передать результат публикации
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: ship-review-result-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/ship-review-result
+          if-no-files-found: error
+          retention-days: 3
+
+  publish:
+    name: "Ship-ревью: документ в dev"
+    needs: [prepare, model_review]
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
+          ref: dev
+          persist-credentials: false
+
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+
+      - name: Получить результат модели
+        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: ship-review-result-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/ship-review-result
+
+      # Модель пишет только текст. Путь, машинный блок (его читает гейт беты),
+      # индекс и коммит решает этот шаг.
+      - name: Опубликовать документ
+        env:
+          TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          TAG: ${{ inputs.tag }}
+          DOC: ${{ needs.prepare.outputs.doc }}
+          CANDIDATE: ${{ needs.prepare.outputs.candidate }}
+          BASE: ${{ needs.prepare.outputs.base }}
+          ISSUES: ${{ needs.prepare.outputs.issues }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          dir="$RUNNER_TEMP/ship-review-result"
+          (cd "$dir" && sha256sum -c manifest.sha256)
+          test "$DOC" = "$(node scripts/ship-review.mjs doc --tag="$TAG")"
+          high=$(jq -r '.high' "$dir/result.json")
+          medium=$(jq -r '.medium' "$dir/result.json")
+          low=$(jq -r '.low' "$dir/result.json")
+          for attempt in 1 2 3; do
+            git fetch -q origin dev
+            git reset -q --hard origin/dev
+            git clean -fdq
+            mkdir -p docs/reviews
+            {
+              cat "$dir/ship-review.md"
+              printf '\n\n'
+              node -e '
+                import("./scripts/ship-review.mjs").then((m) => process.stdout.write(m.anchorBlock({
+                  tag: process.env.TAG, candidate: process.env.CANDIDATE, base: process.env.BASE || null,
+                  issues: String(process.env.ISSUES || "").split(",").filter(Boolean).map(Number),
+                  high: Number(process.argv[1]), medium: Number(process.argv[2]), low: Number(process.argv[3]),
+                  runUrl: process.env.RUN_URL,
+                })));
+              ' "$high" "$medium" "$low"
+            } > "$DOC"
+            node scripts/reviews-index.mjs --dir=docs/reviews --strict
+            git add -- "$DOC" docs/reviews/INDEX.md
+            git diff --cached --name-only | node scripts/review-doc-guard.mjs
+            git -c user.name="claude[bot]" \
+                -c user.email="209825114+claude[bot]@users.noreply.github.com" \
+                commit -q -F - <<MSG
+          docs: ship review for $TAG
+
+          Пакетное ревью задач track:ship перед бетой (PROCESS.md §11.7).
+          Задачи: $ISSUES. Итог: High $high · Medium $medium · Low $low.
+
+          Issue: #696
+          User-Visible: no
+          MSG
+            git diff --name-only "origin/dev...HEAD" | node scripts/review-doc-guard.mjs
+            if git push -q "https://x-access-token:$TOKEN@github.com/${{ github.repository }}" HEAD:dev; then
+              echo "### Пакетное ревью ship $TAG" >> "$GITHUB_STEP_SUMMARY"
+              echo "Задачи $ISSUES · High $high · Medium $medium · Low $low — \`$DOC\` в dev." >> "$GITHUB_STEP_SUMMARY"
+              echo "::notice::$DOC опубликован: High $high · Medium $medium · Low $low"
+              exit 0
+            fi
+            echo "::warning::dev ушёл вперёд — попытка $attempt из 3, документ собирается заново"
+            sleep $((attempt * 10))
+          done
+          echo "::error::документ ревью не опубликован в dev за три попытки"
+          exit 1