docs(reviews): индекс после сдвига каталога (#699)

Issue: #699
User-Visible: no

.gitattributes

@@ -12,3 +12,9 @@
 *.zip binary
 *.woff binary
 *.woff2 binary
+
+# #698: записи двух задач в `## Unreleased` друг другу не противоречат — при
+# слиянии и ребейзе git объединяет обе стороны сам (встроенный драйвер union),
+# и параллельные задачи не возвращаются в S6 из-за соседней строки ченджлога.
+docs/CHANGELOG.md merge=union
+docs/CHANGELOG.ru.md merge=union

.github/workflows/_mutation-gate.yml

@@ -52,7 +52,8 @@ jobs:
   # commit/tree, а не самостоятельно читают dev в разное время.
   material:
     name: "Зафиксировать неизменяемый материал"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     outputs:
       sha: ${{ steps.identity.outputs.sha }}
       tree: ${{ steps.identity.outputs.tree }}
@@ -112,7 +113,7 @@ jobs:
     name: "Мутанты: каждый обязан красить тесты (шард ${{ matrix.shard }} из 6)"
     needs: material
     if: needs.material.outputs.reuse != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:
@@ -208,7 +209,8 @@ jobs:
     name: "Доказать единый material всех шардов"
     needs: [material, mutants]
     if: always() && needs.material.outputs.reuse != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
@@ -239,7 +241,8 @@ jobs:
     name: "Записать маркер зелёного прогона"
     needs: [material, mutants, evidence]
     if: needs.material.outputs.reuse != 'true' && needs.mutants.result == 'success' && needs.evidence.result == 'success'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
@@ -275,7 +278,8 @@ jobs:
     # является — её шарды пропущены намеренно. Любой другой пропуск шардов
     # (упал material) по-прежнему заводит issue.
     if: always() && github.event_name == 'schedule' && needs.material.outputs.reuse != 'true' && (needs.mutants.result != 'success' || needs.evidence.result != 'success')
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     permissions:
       contents: read
       actions: read

.github/workflows/_nightly.yml

@@ -32,9 +32,29 @@ permissions:
 jobs:
   dispatch:
     name: "Запустить Validate на dev с полным набором и дождаться результата"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 90
     steps:
+      # #658: при плане 02:30 UTC ночь фактически стартовала в 07:42–08:05 и
+      # кончалась в рабочее время владельца. Сдвиг старта больше часа — видимое
+      # предупреждение, а не молча съеденная ночь. `github.event.schedule` —
+      # строка cron вызывающего `nightly.yml`; NOW_EPOCH подставляет только тест.
+      - name: "Сдвиг старта ночи против расписания"
+        if: github.event_name == 'schedule'
+        env:
+          SCHEDULE: ${{ github.event.schedule }}
+        run: |
+          set -euo pipefail
+          read -r minute hour _ <<< "$SCHEDULE"
+          now=${NOW_EPOCH:-$(date -u +%s)}
+          planned=$(date -u -d "@$now" +%F)
+          planned=$(date -u -d "$planned $hour:$minute" +%s)
+          [ "$planned" -le "$now" ] || planned=$((planned - 86400))
+          lag=$(( (now - planned) / 60 ))
+          echo "- Старт по расписанию \`$SCHEDULE\` (UTC): сдвиг $lag мин" >> "$GITHUB_STEP_SUMMARY"
+          if [ "$lag" -gt 60 ]; then
+            echo "::warning::ночной прогон стартовал на $lag мин позже расписания ($SCHEDULE UTC) — очередь расписаний GitHub (#658)"
+          fi
       - env:
           GH_TOKEN: ${{ github.token }}
           REPO: ${{ github.repository }}

.github/workflows/_process-metrics.yml

@@ -25,7 +25,7 @@ permissions:
 jobs:
   metrics:
     name: "Снимок недели: issue, раунды, прогоны"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 15
     steps:
       # Код — из dev, как у reconcile: расписание читается из main, а исполняется

.github/workflows/_process-reconcile.yml

@@ -19,7 +19,7 @@ permissions:
 jobs:
   reconcile:
     name: "Один снимок S4/S7 без polling модели"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 10
     concurrency:
       group: process-reconcile

.github/workflows/_process-resume.yml

@@ -28,7 +28,7 @@ jobs:
   resume:
     name: "Разбудить раунд, ждавший этот Validate"
     if: github.event.workflow_run.event == 'workflow_dispatch' && startsWith(github.event.workflow_run.head_branch, 'issue/')
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 10
     concurrency:
       group: process-resume-${{ github.event.workflow_run.head_branch }}

.github/workflows/_process.yml

@@ -48,7 +48,8 @@ jobs:
     # Только статусные метки этапов ревью запускают конвейер (#499). Остальные
     # события помечаются skipped и не занимают место в группе concurrency.
     if: github.event.label.name == 'S4-spec-review' || github.event.label.name == 'S7-code-review'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     concurrency:
       group: process-issue-${{ github.event.issue.number }}
       cancel-in-progress: false
@@ -57,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 — счёт раундов вынесен туда, потому что
@@ -83,8 +86,15 @@ jobs:
           BLOCKED=false; EXHAUSTED=false; SMALL=false; TRIVIAL=false
           has blocked && BLOCKED=true
           has review-4 && EXHAUSTED=true
+          # Треки #695 (PROCESS §5): `track:show` и `track:ship` — лимит 2, как у
+          # прежних `small`/`trivial`; `track:ask` — 4. Цену захода по треку
+          # (мутанты, ребейз, модель) решает prepare (#696).
           has small && SMALL=true
           has trivial && TRIVIAL=true
+          has track:show && SMALL=true
+          has track:ship && SMALL=true
+          # Явный `track:ask` главнее прежних меток: метка владельца окончательна.
+          if has track:ask; then SMALL=false; TRIVIAL=false; fi
 
           # Этап определяется первым: от него зависит, какие вердикты считать.
           stage=""; marker=""
@@ -101,7 +111,7 @@ jobs:
             stage=""
           fi
 
-          # Лимит циклов: 4 обычный, 2 на лёгком и коротком треке (PROCESS.md §4).
+          # Лимит циклов: 4 на `track:ask`, 2 на `track:show`/`track:ship` (PROCESS.md §4, §5).
           limit=4
           if [ "$SMALL" = "true" ] || [ "$TRIVIAL" = "true" ]; then limit=2; fi
 
@@ -212,6 +222,26 @@ jobs:
           - документы: $new_blocking"
             fi
             echo "ветка материала: ${branch:-нет, читался dev}"
+
+            # §5.1 (r1 #695): инфраструктурная задача (§1) без трековой метки
+            # идёт как `track:show` — лимит 2. Признак механический, как в §1:
+            # в диффе ветки против dev ни одного файла класса A. Guard историю
+            # не клонирует, поэтому пути — из compare API; 300 файлов — потолок
+            # ответа, и полный список тогда не доказан: остаётся лимит 4.
+            if [ -n "$branch" ] && ! has track:ship && ! has track:show && ! has track:ask \
+               && ! has small && ! has trivial; then
+              changed=$(mktemp)
+              if gh api "repos/$REPO/compare/dev...$branch" --jq '.files[].filename' > "$changed" 2>/dev/null \
+                 && node --input-type=module -e '
+                   import { readFileSync } from "node:fs";
+                   import { classify } from "./scripts/process-gate.mjs";
+                   const files = readFileSync(process.argv[1], "utf8").split("\n").filter(Boolean);
+                   process.exit(files.length > 0 && files.length < 300 && files.every((f) => classify(f) !== "A") ? 0 : 1);
+                 ' "$changed"; then
+                limit=2
+                echo "инфраструктурная задача без трековой метки — трек show (§5.1), лимит 2"
+              fi
+            fi
           fi
 
           # Отказ обязан быть виден в issue, а не только в логе прогона.
@@ -273,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"
@@ -282,7 +313,7 @@ jobs:
       issues: write
     needs: guard
     if: needs.guard.outputs.stage != ''
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     concurrency:
       group: process-issue-${{ github.event.issue.number }}
       cancel-in-progress: false
@@ -308,6 +339,10 @@ 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 }}
+      full: ${{ steps.track.outputs.full }}
+      ship: ${{ steps.track.outputs.ship }}
     steps:
       - name: Начать измерение стадии
         id: clock
@@ -378,6 +413,59 @@ 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')
+          full=$(printf '%s\n' "$out" | sed -n 's/^full=//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 "full=${full:-false}"; echo "ship=$ship"; } >> "$GITHUB_OUTPUT"
+          echo "- трек **$track** · мутанты по диффу: $mutants · полный набор: ${full:-false} · слияние без модели: $ship" >> "$GITHUB_STEP_SUMMARY"
+
       # Ревьюер обязан смотреть тот же код, который уедет в dev (#257). Раньше
       # ревью шло по ветке как есть, а слияние делало ребейз — проверенный SHA и
       # слитый SHA были разными коммитами. Пока расхождение с dev текстовое,
@@ -399,6 +487,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».
@@ -413,6 +502,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
@@ -446,11 +550,12 @@ jobs:
             printf 'конфликтуют:\n%s\n' "${files:-(git не назвал файлы)}"
             exit 0
           fi
-          # #635 r2: ребейз мог принести в docs/reviews документы других задач,
-          # а закоммиченный INDEX.md — снимок каталога — их не знает. Свежесть
-          # держит тест «индекс свеж» в Validate, поэтому индекс пересобирается
-          # здесь же, коммитом конвейера (класс C), до фиксации материала.
-          node scripts/reviews-index.mjs --dir=docs/reviews --commit-if-stale --issue="$NUM"
+          # #657 (1б): индекс ревью в ветке задачи не пересобирается — ни здесь,
+          # ни при публикации документа. Он пересобирается только коммитами,
+          # которые идут прямо в dev: слиянием кандидата (merge-candidate.mjs)
+          # и публикацией документа ревью ТЗ. Коммит индекса в ветке конфликтовал
+          # с документами соседей по построению (#643) и возвращал зелёные
+          # задачи на повторное ревью; гейт «индекс свеж» судит только dev.
           # --force-with-lease с явным ожидаемым значением обязателен: между
           # fetch и push автор мог запушить коммит, и слепой --force потерял бы
           # его молча. Расхождение lease — падение прогона, а не предупреждение:
@@ -485,7 +590,7 @@ jobs:
           git fetch -q origin "+refs/heads/$BRANCH:refs/remotes/origin/$BRANCH"
           short_before=$(git rev-parse --short "$before")
           short_after=$(git rev-parse --short HEAD)
-          echo "note=Ветка приведена к dev конвейером до ревью: поверх легло $behind коммит(ов) dev, $short_before -> $short_after. После ребейза это другой код (§7.2) — разбор полный, а не по дельте." >> "$GITHUB_OUTPUT"
+          echo "note=Ветка приведена к dev конвейером до ревью: поверх легло $behind коммит(ов) dev, $short_before -> $short_after. После ребейза это другой код (§2.10) — разбор полный, а не по дельте." >> "$GITHUB_OUTPUT"
           echo "ветка $BRANCH приведена к dev: $short_before -> $short_after"
 
       # Материал ревью — конкретный SHA (#312). Вердикт применим только к
@@ -598,13 +703,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:
@@ -613,6 +720,9 @@ jobs:
           REUSE: ${{ steps.reuse.outputs.reuse }}
           BRANCH: ${{ steps.branch.outputs.name }}
           SHA: ${{ steps.material.outputs.sha }}
+          MUTANTS: ${{ steps.track.outputs.mutants }}
+          # #697: `ci:full`/`ci:golden` — полный набор на материале.
+          FULL: ${{ steps.track.outputs.full }}
         run: |
           if [ "$STAGE" != "code" ] || [ "$REUSE" = "true" ] || [ -z "$BRANCH" ]; then
             echo "гейт не применяется: этап $STAGE, reuse=${REUSE:-false}, ветка ${BRANCH:-dev}"
@@ -626,7 +736,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}" --full="${FULL:-false}"
           code=$?
           set -e
           case "$code" in
@@ -651,6 +762,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"
@@ -664,7 +776,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'
@@ -685,10 +799,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 всё равно вернул бы задачу, но уже после потраченного ревью.
 
@@ -696,14 +813,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). Это не тщательность: бюджет
@@ -771,7 +888,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 }}
@@ -807,7 +924,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 }}
@@ -850,8 +967,10 @@ jobs:
       contents: read
       issues: write
     needs: [guard, prepare]
-    if: needs.prepare.outputs.proceed == 'true' && needs.prepare.outputs.reuse != 'true'
-    runs-on: ubuntu-latest
+    # #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 }}
       cancel-in-progress: false
@@ -916,24 +1035,48 @@ 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 предустановлены в
-        # образе ubuntu-latest, а apt при промахе кэша съедал минуты из бюджета
+        # образе раннера, а apt при промахе кэша съедал минуты из бюджета
         # ревью и подолгу перебирал недоступное azure-зеркало (#175). Если
         # библиотека когда-нибудь пропадёт из образа, Chromium не запустится с
         # внятной ошибкой — тогда флаг вернуть.
@@ -991,6 +1134,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 }}
 
@@ -1006,20 +1152,25 @@ jobs:
                  ограничитель: «features are built, improved and accepted only
                  if they serve a job listed here». Первый вопрос к задаче —
                  какую строку Core user jobs она закрывает.
-              2. docs/process/REVIEWER.md — обязанности ревьюера: позиция,
+              2. AGENTS.md — карта пакета, правило №1, классы изменений, треки,
+                 трейлеры и ожидание вердикта; сами правила — по его ссылкам.
+              3. docs/process/REVIEWER.md — обязанности ревьюера: позиция,
                  ревью ТЗ, код-ревью, объём гейтов, повторный раунд, находки и
                  вердикт. Раздел PROCESS.md по ссылке открывай, когда пункт
                  касается твоего решения; при расхождении прав PROCESS.md. Если
                  файла в материале нет — читай PROCESS.md §2.4, §2.7, §2.10,
                  §4, §7.2, §8, §12. Задача правит сам конвейер, гейты или
                  процесс — PROCESS.md целиком, §10 в первую очередь.
-              3. AGENTS.md — классы изменений, трейлеры, гейты, формат вердикта.
               4. Тело issue #${{ github.event.issue.number }} и все комментарии.
               5. Если меняется видимое поведение — docs/USER-GUIDE.ru.md:
                  терминология интерфейса берётся оттуда, а не изобретается.
-              6. Канонический документ затронутой подсистемы: docs/SUN.md,
-                 LIGHT.md, CANVAS.md, WALL-THICKNESS.md, UX-MODES.md,
-                 CONFIG-COMPATIBILITY.md, TOUCH-SUPPORT.md.
+              6. Канонический документ затронутой подсистемы (тот же список,
+                 что в AGENTS.md «Read this first»): docs/SUN.md, LIGHT.md,
+                 CANVAS.md, WALL-THICKNESS.md, UX-MODES.md,
+                 CONFIG-COMPATIBILITY.md, TOUCH-SUPPORT.md, ISOMETRIC.md,
+                 VACUUM.md, DECOR-EDITOR.md, DEVICE-PRESENTATION.md,
+                 FILTERING.md, STAIRS.md, RADAR.md, PDF-EXPORT.md,
+                 STYLING-HOOKS.md.
 
             **Если цикл не первый — объём разбора по дельте, а не заново**
             (PROCESS.md §2.10, issue #214): найди вердикт и материал
@@ -1071,17 +1222,17 @@ jobs:
 
             Если зелёного прогона на этом SHA нет — прогоняешь сам, они дешёвые,
             и в повторном раунде тоже: `npx tsc --noEmit`, `npm test`,
-            `npm run build` со сверкой трёх копий бандла, плюс
-            `node scripts/check-docs.mjs`, если diff трогает `src/**`.
-            Зависимости уже установлены workflow, Chromium тоже — `npm ci`
-            выполнять не нужно. По диффу и AC: браузерные смоки — названные в AC
+            `npm run build` со сверкой трёх копий бандла. Свежесть скриншотов
+            документации — не гейт задачи (#697): её обновляет бот на dev.
+            ${{ 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>`,
             приложенный к комментарию с решением по каждой строке: прогнал либо
             не прогнал и почему. Три вида ответа инструмента разные: «прямое
             совпадение», «зарегистрированная связь», «НЕОПРЕДЕЛЁННОСТЬ» — связь
             не доказана, и это не разрешение ничего не прогонять; слабые связи —
             повод посмотреть, а не обязанность прогонять;
-            `npm run golden:verify` при видимом изменении;
+            `npm run golden:verify` при метке `ci:golden`;
             `python -m pytest tests_backend -q` при правке
             `custom_components/**/*.py`; инварианты модели
             `npm run invariants -- --config <экспорт>` при правке геометрии или
@@ -1195,7 +1346,7 @@ jobs:
       issues: write
     needs: [guard, prepare, model_review]
     if: always() && needs.guard.outputs.stage != ''
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     concurrency:
       group: process-issue-${{ github.event.issue.number }}
       cancel-in-progress: false
@@ -1214,6 +1365,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"
@@ -1229,7 +1381,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
@@ -1248,7 +1401,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 }}
@@ -1256,7 +1409,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, и принимается он как ввод противника: полный
         # набор файлов, сходящиеся суммы, совпадение КАЖДОГО поля паспорта с
@@ -1292,7 +1445,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 }}
@@ -1375,9 +1528,11 @@ jobs:
           # забрал бы всё, что там окажется, а после reset там не должно быть
           # ничего постороннего — но полагаться на «не должно» здесь нельзя.
           git add -- "$doc" 2>/dev/null || true
-          # #635: индекс ревью пересобирается тем же коммитом, что и документ —
-          # иначе он устаревает на первом же раунде. Генерируемый файл, класс C.
-          if [ -f "$doc" ]; then
+          # #635/#657 (1б): индекс пересобирается тем же коммитом, что и
+          # документ, только когда документ идёт прямо в dev (ревью ТЗ). В ветку
+          # задачи — один документ: индекс там конфликтовал бы с документами
+          # соседей в dev по построению; его пересоберёт слияние кандидата.
+          if [ -f "$doc" ] && [ "$target" = "dev" ]; then
             node scripts/reviews-index.mjs --dir=docs/reviews
             git add -- docs/reviews/INDEX.md
           fi
@@ -1463,7 +1618,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 }}
@@ -1488,10 +1643,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
@@ -1530,7 +1703,7 @@ jobs:
       # Ревью идёт десятки минут, а dev за это время двигается (28 августа —
       # четыре раза за день). Вердикт при этом вынесен по дереву, которое уже не
       # совпадает с вершиной линии, и слияние приведёт ветку к dev — то есть в
-      # dev уедет код, отличный от прочитанного (§7.2). Молчать об этом нельзя,
+      # dev уедет код, отличный от прочитанного (§2.10). Молчать об этом нельзя,
       # но и шуметь на каждом прогоне ни к чему: строка появляется только когда
       # dev действительно ушёл и вердикт зелёный, то есть слияние вот-вот
       # случится (#364).
@@ -1549,7 +1722,7 @@ jobs:
           if [ "$moved" -eq 0 ] || [ "$GREEN" != "true" ]; then exit 0; fi
           short=$(git rev-parse --short "$MATERIAL")
           gh issue comment "$NUM" --repo "${{ github.repository }}" --body \
-            "Пока шло ревью, \`dev\` продвинулся на $moved коммит(ов). Материал ревью — \`$short\`. Вердикт вынесен по дереву, которое уже не совпадает с вершиной линии: слияние приведёт ветку к dev, и это другой код (§7.2)."
+            "Пока шло ревью, \`dev\` продвинулся на $moved коммит(ов). Материал ревью — \`$short\`. Вердикт вынесен по дереву, которое уже не совпадает с вершиной линии: слияние приведёт ветку к dev, и это другой код (§2.10)."
 
       # S8-merged утверждает, что код в dev. Значит слияние обязано произойти
       # ДО метки, иначе она врёт в промежутке.
@@ -1571,6 +1744,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::ветки задачи нет — сливать нечего"
@@ -1578,7 +1753,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'
@@ -1625,13 +1800,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

.github/workflows/announce.yml

@@ -43,7 +43,8 @@ jobs:
   telegram:
     name: Оповещение в Telegram (только стабильные)
     if: ${{ github.event_name == 'workflow_dispatch' || (github.event_name == 'workflow_call' && inputs.prerelease == false) }}
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - name: Check out release notes for a reusable call
         if: ${{ inputs.reusable == true }}

.github/workflows/beta-derived.yml

@@ -0,0 +1,214 @@
+name: "Бета: производные артефакты на dev"
+run-name: "Derived artifacts ${{ inputs.tag }}"
+
+# #697, PROCESS.md §8 и §11.4: ветки задач не коммитят ни отпечаток и кадры
+# скриншотов документации, ни эталоны golden. Их обновляет один коммит бота на
+# `dev` перед кандидатом беты; коммит проверяет релиз-менеджер.
+#
+# - Скриншоты: съёмка на `dev` тем же каноническим способом, что
+#   `docs-screenshots.yml`, и приёмка `docs:accept --reviewed`. Кадры, которые
+#   менять не собирались, обязаны совпасть байт-в-байт (свидетели среды);
+#   изменившийся кадр принимается, только если назван в `docs_expect_change`.
+#   Ничего не изменилось — обновляется один отпечаток исходников.
+# - Golden: артефакт `golden-images` полного Validate на `dev`
+#   (`golden_run`) и `golden:accept --reviewed` с объявленными сценами. Коммит
+#   несёт `Release:` и `Baseline-Reviewed:` — провенанс, который требует
+#   validate-commit-provenance.mjs.
+#
+# Необъявленная разница — отказ с перечнем кадров, артефакт съёмки остаётся
+# для просмотра: решение, какие кадры сдвинулись законно, принимает человек.
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Beta tag these artifacts are for, for example v1.79.0-beta.1"
+        required: true
+        type: string
+      docs_expect_change:
+        description: "Doc scenario ids expected to change, comma-separated (empty = none)"
+        required: false
+        type: string
+        default: ""
+      golden_run:
+        description: "Validate run id on dev whose golden-images artifact holds the shifted frames (empty = skip golden)"
+        required: false
+        type: string
+        default: ""
+      golden_expect_change:
+        description: "Golden scenes expected to change, comma-separated"
+        required: false
+        type: string
+        default: ""
+      golden_expect_new:
+        description: "New golden scenes, comma-separated"
+        required: false
+        type: string
+        default: ""
+
+permissions:
+  contents: read
+
+concurrency:
+  group: beta-derived
+  cancel-in-progress: false
+
+jobs:
+  accept:
+    name: "Отпечаток, кадры и эталоны — одним коммитом в dev"
+    runs-on: ubuntu-24.04
+    timeout-minutes: 40
+    permissions:
+      contents: read
+      actions: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: dev
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+          cache: npm
+      - 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: Install pinned Chromium
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install chromium
+      - name: Build the bundle the screenshots must come from
+        run: npm run build
+      # Тот же закреплённый упаковщик, что у docs-screenshots.yml: другой
+      # переписал бы все кадры без единого изменённого пикселя.
+      - name: Установить oxipng
+        env:
+          OXIPNG_VERSION: 10.2.0
+          OXIPNG_SHA256: b33f84c73d42cb592bea5d84c431030b1e97784817693380dfcec7d9575f871e
+        run: |
+          set -euo pipefail
+          asset="oxipng-${OXIPNG_VERSION}-x86_64-unknown-linux-gnu.tar.gz"
+          curl -fsSL -o "$asset" \
+            "https://github.com/oxipng/oxipng/releases/download/v${OXIPNG_VERSION}/${asset}"
+          echo "${OXIPNG_SHA256}  ${asset}" | sha256sum -c -
+          mkdir -p "$HOME/.local/bin"
+          tar -xzf "$asset" --strip-components=1 -C "$HOME/.local/bin" \
+            "oxipng-${OXIPNG_VERSION}-x86_64-unknown-linux-gnu/oxipng"
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+          "$HOME/.local/bin/oxipng" --version
+      - name: "Съёмка воспроизводима между прогонами (#410, #422)"
+        run: node scripts/capture-determinism.mjs
+      - name: Кадры документации — съёмка и приёмка
+        id: docs
+        env:
+          EXPECT: ${{ inputs.docs_expect_change }}
+        run: |
+          set -euo pipefail
+          node demo/docs/capture.mjs --stability=3
+          cand="$RUNNER_TEMP/docs-candidate"
+          rm -rf "$cand" && mkdir -p "$cand"
+          cp docs/images/*.png docs/images/screenshots.json "$cand/"
+          # Приёмка сравнивает кандидата с ЗАКОММИЧЕННЫМИ кадрами: рабочая
+          # копия возвращается к dev, и заменить файлы может только она.
+          git checkout -- docs/images
+          git clean -fdq -- docs/images
+          args=(--reviewed "--from=$cand")
+          if [ -n "$EXPECT" ]; then args+=("--expect-change=$EXPECT"); fi
+          node scripts/docs-accept.mjs "${args[@]}"
+          if git diff --quiet -- docs/images; then changed=false; else changed=true; fi
+          echo "changed=$changed" >> "$GITHUB_OUTPUT"
+          git diff --stat -- docs/images
+      - name: Сохранить кандидата скриншотов для просмотра
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: docs-candidate-${{ github.run_id }}
+          path: ${{ runner.temp }}/docs-candidate
+          if-no-files-found: ignore
+          retention-days: 7
+      - name: Эталоны golden из прогона Validate
+        id: golden
+        if: inputs.golden_run != ''
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RUN: ${{ inputs.golden_run }}
+          EXPECT_CHANGE: ${{ inputs.golden_expect_change }}
+          EXPECT_NEW: ${{ inputs.golden_expect_new }}
+        run: |
+          set -euo pipefail
+          case "$RUN" in ''|*[!0-9]*) echo "::error::golden_run — числовой id прогона Validate"; exit 1 ;; esac
+          meta=$(gh api "repos/${{ github.repository }}/actions/runs/$RUN" \
+            --jq '[.path, .head_branch, .status, .html_url] | @tsv')
+          IFS=$'\t' read -r path branch status url <<< "$meta"
+          # Провенанс эталонов — завершённый Validate на dev: другой workflow
+          # или ветка задачи доказательством для кандидата беты не являются.
+          if [ "$path" != ".github/workflows/validate.yml" ] || [ "$branch" != "dev" ] || [ "$status" != "completed" ]; then
+            echo "::error::прогон $RUN — не завершённый Validate на dev ($path, $branch, $status)"
+            exit 1
+          fi
+          from="$RUNNER_TEMP/golden-candidate"
+          rm -rf "$from" && mkdir -p "$from"
+          gh run download "$RUN" --repo "${{ github.repository }}" -n golden-images -D "$from"
+          # Отчёт обязан быть снят с этого же дерева: accept.mjs сверяет его
+          # отпечаток с исходниками и откажет, если dev ушёл вперёд.
+          args=(--reviewed "--from=$from")
+          if [ -n "$EXPECT_CHANGE" ]; then args+=("--expect-change=$EXPECT_CHANGE"); fi
+          if [ -n "$EXPECT_NEW" ]; then args+=("--expect-new=$EXPECT_NEW"); fi
+          node scripts/golden-accept.mjs "${args[@]}"
+          if git diff --quiet -- demo/golden/baselines; then changed=false; else changed=true; fi
+          { echo "changed=$changed"; echo "url=$url"; } >> "$GITHUB_OUTPUT"
+          git diff --stat -- demo/golden/baselines
+      - name: Коммит в dev
+        env:
+          TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          TAG: ${{ inputs.tag }}
+          DOCS_CHANGED: ${{ steps.docs.outputs.changed }}
+          DOCS_EXPECT: ${{ inputs.docs_expect_change }}
+          GOLDEN_CHANGED: ${{ steps.golden.outputs.changed }}
+          GOLDEN_URL: ${{ steps.golden.outputs.url }}
+          GOLDEN_EXPECT_CHANGE: ${{ inputs.golden_expect_change }}
+          GOLDEN_EXPECT_NEW: ${{ inputs.golden_expect_new }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          # Хук pre-push гоняет process-gate; gate:small здесь не нужен —
+          # продуктового кода коммит не несёт.
+          HP_PREPUSH_GATE: "0"
+        run: |
+          set -euo pipefail
+          git add -- docs/images demo/golden/baselines
+          if git diff --cached --quiet; then
+            echo "::notice::отпечаток, кадры и эталоны на dev уже свежие — коммитить нечего"
+            exit 0
+          fi
+          msg="$RUNNER_TEMP/message.txt"
+          {
+            echo "docs: accept derived artifacts on dev for $TAG"
+            echo ""
+            echo "Производные артефакты беты — одним коммитом на dev (PROCESS.md §8, §11.4, #697)."
+            echo "Прогон: $RUN_URL"
+            if [ "$DOCS_CHANGED" = "true" ]; then
+              echo "Скриншоты документации: отпечаток исходников; изменённые кадры: ${DOCS_EXPECT:-нет}."
+            fi
+            if [ "$GOLDEN_CHANGED" = "true" ]; then
+              echo "Golden: изменённые сцены: ${GOLDEN_EXPECT_CHANGE:-нет}; новые: ${GOLDEN_EXPECT_NEW:-нет}."
+            fi
+            echo ""
+            if [ "$GOLDEN_CHANGED" = "true" ]; then
+              echo "Release: $TAG"
+              echo "Baseline-Reviewed: $GOLDEN_URL"
+            fi
+            echo "Issue: #697"
+            echo "User-Visible: no"
+          } > "$msg"
+          git -c user.name="claude[bot]" \
+              -c user.email="209825114+claude[bot]@users.noreply.github.com" \
+              commit -q -F "$msg"
+          git show --stat --format='%H %s' HEAD | head -40
+          if ! git push -q "https://x-access-token:$TOKEN@github.com/${{ github.repository }}" HEAD:dev; then
+            echo "::error::dev ушёл вперёд за время съёмки — запустить workflow заново: отпечаток судит дерево, а оно уже другое"
+            exit 1
+          fi
+          echo "### Производные артефакты $TAG" >> "$GITHUB_STEP_SUMMARY"
+          echo "Коммит \`$(git rev-parse --short HEAD)\` в dev — проверить перед кандидатом беты." >> "$GITHUB_STEP_SUMMARY"

.github/workflows/docs-screenshots.yml

@@ -31,7 +31,8 @@ permissions:
 jobs:
   capture:
     name: Съёмка и сверка скриншот-индекса
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:

.github/workflows/mutation-gate.yml

@@ -16,9 +16,10 @@ on:
         required: false
         default: dev
   schedule:
-    # Каждую ночь, 01:00 UTC (04:00 MSK) — после суток правок и до ночного
-    # полного Validate (nightly.yml, 02:30 UTC), чтобы не делить раннеры (#513).
-    - cron: '0 1 * * *'
+    # Каждую ночь, 00:43 UTC (03:43 MSK) — после суток правок и до ночного
+    # полного Validate (nightly.yml, 02:17 UTC), чтобы не делить раннеры (#513).
+    # Минута не круглая: такие старты GitHub сдвигает меньше (#658).
+    - cron: '43 0 * * *'
 
 permissions:
   contents: read

.github/workflows/nightly.yml

@@ -9,8 +9,10 @@ name: Ночной полный прогон dev
 # держит копии равными.
 
 on:
+  # 02:17 UTC, не на круглой минуте: старты «ровно в час/полчаса» GitHub
+  # откладывает на часы (факт — 07:42–08:05 при плане 02:30, #658).
   schedule:
-    - cron: '30 2 * * *'
+    - cron: '17 2 * * *'
   workflow_dispatch: {}
 
 permissions:

.github/workflows/performance.yml

@@ -6,8 +6,12 @@ on:
   push:
     branches:
       - main
+    paths-ignore:
+      - ".github/workflows/**"
+      - "docs/**"
   schedule:
-    - cron: "0 4 * * 1"
+    # Минута не круглая (#658): доходит до main вместе со стабильным релизом.
+    - cron: "11 4 * * 1"
   workflow_dispatch:
     inputs:
       comparison_ref:
@@ -28,7 +32,7 @@ jobs:
     # Every profile keeps base and candidate sequential on one hosted runner.
     # Independent profile pairs run in parallel: cross-profile timing is never
     # compared, while serialising all profile pairs cannot fit the job timeout.
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 60
     strategy:
       fail-fast: false

.github/workflows/process-metrics.yml

@@ -10,8 +10,9 @@ name: Метрики процесса
 
 on:
   schedule:
-    # Понедельник 05:00 UTC — после ночных прогонов, до рабочего дня.
-    - cron: '0 5 * * 1'
+    # Понедельник 05:23 UTC — после ночных прогонов, до рабочего дня; минута
+    # не круглая, чтобы не стоять в очереди «ровных» расписаний (#658).
+    - cron: '23 5 * * 1'
   workflow_dispatch:
     inputs:
       days:

.github/workflows/publish-prerelease.yml

@@ -21,7 +21,9 @@ concurrency:
 jobs:
   gate:
     name: "Гейт: зелёная Проверка и релизный контракт"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    # Больше ожидания зелёного Validate в release-gate.mjs (до 60 мин) (#658).
+    timeout-minutes: 75
     outputs:
       sha: ${{ steps.candidate.outputs.sha }}
       tag: ${{ steps.candidate.outputs.tag }}
@@ -89,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 }}
@@ -122,7 +132,8 @@ jobs:
   publish:
     name: Публикация тега и релиза
     needs: gate
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
     outputs:
       url: ${{ steps.verify.outputs.url }}
       newly_published: ${{ steps.release.outputs.newly_published }}
@@ -289,7 +300,8 @@ jobs:
   close-merged:
     name: Закрытие вошедших issue
     needs: [gate, publish]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
     permissions:
       contents: read
       actions: read

.github/workflows/release-review.yml

@@ -0,0 +1,335 @@
+name: "Релиз: независимое ревью линии"
+run-name: "Release review ${{ inputs.tag }}"
+
+# #638, PROCESS.md §11.5: перед стабильным релизом — одно независимое ревью
+# поверхностей, изменённых всей линией бет, «с нуля»: без ТЗ и документов
+# раундов, по SCOPE и USER-GUIDE. Инкрементальное ревью судит дифф задачи
+# против её ТЗ; четыре дефекта линии 1.77 (#607, #608, #611, #619) не входили
+# ни в один AC и нашлись только так.
+#
+# Решение владельца 2026-09-25: ревью НЕ блокирует выпуск. `release.yml`
+# запускает этот workflow параллельно гейтам из job, от которого не зависит ни
+# один job выпуска; документ — рекомендация, в работу его берёт владелец.
+#
+# Только `workflow_dispatch`: GitHub исполняет файл с той ветки, на которой
+# запущен прогон (`release.yml` зовёт `--ref dev`), поэтому зеркало в `main`
+# не нужно, а правка — один коммит в `dev`.
+#
+# Три job, как у конвейера (#551, #556): детерминированная подготовка,
+# недоверенная модель без единого права на запись, детерминированная
+# публикация документа в `dev`.
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Stable release tag, for example v1.78.0"
+        required: true
+        type: string
+      candidate:
+        description: "Exact candidate SHA; empty = the commit of the tag"
+        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: release-review-${{ inputs.tag }}
+  cancel-in-progress: false
+
+jobs:
+  prepare:
+    name: "Ревью релиза: вход линии"
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    outputs:
+      proceed: ${{ steps.line.outputs.proceed }}
+      candidate: ${{ steps.line.outputs.candidate }}
+      base: ${{ steps.line.outputs.base }}
+      doc: ${{ steps.line.outputs.doc }}
+      issues: ${{ steps.line.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: Кандидат, база и issue линии
+        id: line
+        env:
+          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/release-review.mjs doc --tag="$TAG")
+          git fetch -q --tags origin
+          if [ -z "$CANDIDATE" ]; then
+            CANDIDATE=$(git rev-parse --verify -q "refs/tags/$TAG^{commit}") || {
+              echo "::error::тега $TAG нет, а кандидат не передан"; exit 1; }
+          fi
+          git cat-file -e "$CANDIDATE^{commit}"
+          CANDIDATE=$(git rev-parse "$CANDIDATE^{commit}")
+          # Повтор на тот же тег не тратит модель: документ уже есть (§11.5).
+          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/release-review-input"
+          node scripts/release-review.mjs prepare --tag="$TAG" --candidate="$CANDIDATE" \
+            --out="$out" --run-url="$RUN_URL" | tee -a "$GITHUB_OUTPUT"
+          echo "candidate=$CANDIDATE" >> "$GITHUB_OUTPUT"
+          echo "proceed=true" >> "$GITHUB_OUTPUT"
+          (cd "$out" && sha256sum brief.md line-membership.json > manifest.sha256)
+          cat "$out/brief.md" >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Передать вход модели
+        if: steps.line.outputs.proceed == 'true'
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: release-review-input-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/release-review-input
+          if-no-files-found: error
+          retention-days: 3
+
+  model_review:
+    name: "Ревью релиза: работа модели"
+    needs: prepare
+    if: needs.prepare.outputs.proceed == 'true'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 60
+    # Недоверенная стадия. Прав на запись нет никаких: ни в репозиторий, ни в
+    # issue. Документ публикует `publish`; находки в issue превращает владелец.
+    # `github_token` у шага Review обязателен (#556): без него 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: release-review-input-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/release-review-input
+
+      - name: Проверить вход и кандидата
+        env:
+          CANDIDATE: ${{ needs.prepare.outputs.candidate }}
+        run: |
+          (cd "$RUNNER_TEMP/release-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 }}/release-review.md
+          REVIEW_INPUT: ${{ runner.temp }}/release-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 || 'нет' }}.
+            Вход линии — файл $REVIEW_INPUT/brief.md (issue линии, доказанные
+            трейлерами, и изменённые продуктовые файлы) и
+            $REVIEW_INPUT/line-membership.json.
+
+            Правила этого ревью — docs/process/REVIEWER.md, раздел «Независимое
+            ревью линии», канон — PROCESS.md §11.5. Прочитай их первыми.
+
+            Главное, что нельзя пропустить:
+            - Ты судишь ПОВЕРХНОСТИ, изменённые линией, против ПОЛЬЗОВАТЕЛЯ, а
+              не дифф против ТЗ. Не читай ТЗ задач (раздел «## ТЗ» в issue,
+              docs/specs/**) и документы раундов (docs/reviews/**): независимость
+              и есть смысл шага. Основа суждения — docs/SCOPE.md (персоны и
+              работы) и docs/USER-GUIDE.ru.md (что обещано пользователю).
+            - Проверяй исполнением, а не чтением: собери бандл
+              (`npm run bundle:sync`), открой затронутые поверхности в браузере
+              (стенд `demo/`, смоки `demo/smoke_*.mjs`), вводи текст
+              посимвольно, закрывай диалоги настоящим Escape и крестиком. Где
+              есть диалоги HA — пиннутая фикстура `ha-dialog` (#505,
+              demo/helpers/README-ha-dialog.md,
+              `node demo/verify_ha_dialog_discard_recovery.mjs`).
+            - Для каждой поверхности: обычный сценарий и самый рискованный
+              соседний, шесть классов риска (async, данные/права, геометрия,
+              визуал, объём/perf, host/input) — PROCESS.md §2.6.
+            - Ты ничего не правишь и не публикуешь: ни код, ни issue, ни
+              комментарии. Права на запись у тебя нет. Любые изменения рабочей
+              копии будут отброшены — после проверок восстанови её сам
+              (`git checkout -- . && git clean -fd`), если что-то менял.
+
+            Находки: High / Medium / Low, у каждой — поверхность, воспроизведение
+            (команда или шаги), что увидит пользователь, какая персона задета.
+            Выпуск это ревью не останавливает: документ — рекомендация владельцу.
+
+            Напиши полный документ в файл по пути из переменной REVIEW_DOC
+            (абсолютный, вне репозитория). Разделы: что входило в линию,
+            поверхности и как каждая проверялась (команда → результат),
+            находки, что проверено и корректно, чего не проверял и почему.
+            Первой строкой после заголовка — `Итог: High N · Medium N · Low N`.
+
+            Затем верни JSON по схеме — последнее обязательное действие.
+          claude_args: |
+            --max-turns 200
+            --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 }}/release-review.md
+          OUT: ${{ steps.review.outputs.structured_output }}
+        run: |
+          test -s "$SOURCE" || { echo "::error::модель не оставила документ ревью"; exit 1; }
+          dir="$RUNNER_TEMP/release-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/release-review.md"
+          (cd "$dir" && sha256sum release-review.md result.json > manifest.sha256)
+
+      - name: Передать результат публикации
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: release-review-result-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/release-review-result
+          if-no-files-found: error
+          retention-days: 3
+
+  publish:
+    name: "Ревью релиза: документ в 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: release-review-result-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/release-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/release-review-result"
+          (cd "$dir" && sha256sum -c manifest.sha256)
+          test "$DOC" = "$(node scripts/release-review.mjs doc --tag="$TAG")"
+          counts=$(jq -r '"High \(.high) · Medium \(.medium) · Low \(.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/release-review.md"
+              printf '\n\n<!-- hp-release-review-anchors -->\n### Материал ревью\n\n```\n'
+              printf 'tag %s\ncandidate %s\nbase %s\nissues %s\nrun %s\n' \
+                "$TAG" "$CANDIDATE" "${BASE:-—}" "${ISSUES:-—}" "$RUN_URL"
+              printf '```\n'
+            } > "$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: release review for $TAG
+
+          Независимое ревью линии перед стабильным релизом (PROCESS.md §11.5).
+          Итог: $counts. Выпуск не блокирует; решение по находкам — за владельцем.
+
+          Issue: #638
+          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 "### Независимое ревью $TAG" >> "$GITHUB_STEP_SUMMARY"
+              echo "Итог: $counts — \`$DOC\` в dev. Выпуск не блокируется." >> "$GITHUB_STEP_SUMMARY"
+              echo "::notice::$DOC опубликован: $counts"
+              exit 0
+            fi
+            echo "::warning::dev ушёл вперёд — попытка $attempt из 3, документ собирается заново"
+            sleep $((attempt * 10))
+          done
+          echo "::error::документ ревью не опубликован в dev за три попытки"
+          exit 1

.github/workflows/release.yml

@@ -48,7 +48,8 @@ jobs:
     name: "Кандидат: точный SHA, режим и черновик"
     # Публикация беты руками — не наш случай: у бет свой staged-путь.
     if: ${{ github.event_name == 'workflow_dispatch' || !github.event.release.prerelease }}
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     outputs:
       sha: ${{ steps.resolve.outputs.sha }}
       tag: ${{ steps.resolve.outputs.tag }}
@@ -131,10 +132,43 @@ jobs:
             echo "release $TAG is public: repair mode — only missing assets may be added"
           fi
 
+  independent-review:
+    name: "Независимое ревью линии (не блокирует выпуск)"
+    # #638, PROCESS.md §11.5. Решение владельца 2026-09-25: ревью идёт
+    # параллельно гейтам и выпуск не ждёт и не останавливает. Поэтому этот job
+    # только ставит в очередь `release-review.yml` на `dev` и ни один job
+    # выпуска от него не зависит (`needs` на него запрещён тестом
+    # release-workflow); его отказ — предупреждение, а не красный релиз.
+    # Беты пропускаются: ревью линии — перед стабильным.
+    needs: candidate
+    if: ${{ needs.candidate.outputs.prerelease != 'true' }}
+    continue-on-error: true
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    permissions:
+      actions: write
+    steps:
+      - name: Поставить в очередь ревью линии
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ needs.candidate.outputs.tag }}
+          SHA: ${{ needs.candidate.outputs.sha }}
+        run: |
+          if gh workflow run release-review.yml --repo "${{ github.repository }}" --ref dev \
+               -f tag="$TAG" -f candidate="$SHA"; then
+            echo "Независимое ревью $TAG поставлено в очередь: release-review.yml на dev" >> "$GITHUB_STEP_SUMMARY"
+          else
+            echo "::warning::ревью линии $TAG не запущено — выпуск продолжается; запустить руками: gh workflow run release-review.yml --ref dev -f tag=$TAG -f candidate=$SHA"
+            exit 1
+          fi
+
   gate:
     name: "Гейт: контракт, Validate, Full Performance и E2E на точном SHA"
     needs: candidate
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    # Больше суммы собственных ожиданий job: Validate и Full Performance ждутся
+    # до 60 мин каждый (release-gate.mjs), E2E — до 45 (e2e-gate.mjs): 165 < 180 (#658).
+    timeout-minutes: 180
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
@@ -204,7 +238,8 @@ jobs:
   stage:
     name: "Сборка: ассеты, SHA256SUMS и загрузка в черновик"
     needs: [candidate, gate]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
@@ -344,7 +379,8 @@ jobs:
   publish:
     name: "Публикация и сверка публичных байтов"
     needs: [candidate, gate, stage]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
     outputs:
       url: ${{ steps.verify.outputs.url }}
       name: ${{ steps.verify.outputs.name }}
@@ -444,7 +480,8 @@ jobs:
     # make that distribution failure impossible to miss in the release run.
     if: ${{ needs.candidate.outputs.prerelease == 'true' }}
     needs: [candidate, publish]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - name: Verify the published tag is the prerelease HACS will discover
         uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9

.github/workflows/ship-review.yml

@@ -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

.github/workflows/validate.yml

@@ -50,14 +50,16 @@ jobs:
   # действовать — на уровне шагов, с той же гранулярностью в логе.
   preflight:
     name: "Предполёт: документация, провенанс, процесс"
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
     # `actions: read` — чтение списка прогонов Validate (#388), `issues: read` —
-    # проверка 8 процессного гейта. Права перечислены явно, потому что job
-    # обращается к API сверх содержимого репозитория.
+    # проверка 8 процессного гейта, `issues: write` — одно issue о расхождении
+    # зеркала workflow на push в dev (#700). Права перечислены явно, потому что
+    # job обращается к API сверх содержимого репозитория.
     permissions:
       contents: read
       actions: read
-      issues: read
+      issues: write
     steps:
       # `blob:none` при полной истории (#345): этой job нужны сообщения
       # коммитов, трейлеры и ИМЕНА изменённых файлов, а не содержимое старых
@@ -80,17 +82,24 @@ jobs:
         id: docs
         continue-on-error: true
         env:
+          REF: ${{ github.ref }}
           EVENT_NAME: ${{ github.event_name }}
           HEAD_MESSAGE: ${{ github.event.head_commit.message }}
           FULL_INPUT: ${{ inputs.full }}
+          # #697: на ветке задачи `Release:` строгий режим не включает.
+          REF_NAME: ${{ github.ref_name }}
         run: |
+          # #700: на ветке задачи упавший чужой сайт — предупреждение, а не
+          # красный preflight; push в dev, кандидат и релиз судят ссылки строго.
+          external=--external
+          case "$REF" in refs/heads/issue/*) external=--external=warn ;; esac
           # #586: CLI отдаёт ОДИН ответ. Прежде здесь сравнивался со строкой
           # `heavy=true` весь вывод `--heavy`, а он двухстрочный: в `$(…)`
           # строки схлопываются через пробел, сравнение не совпадало никогда,
           # и строгий режим не включился ни на одном кандидате.
           mode=$(node scripts/classify-changes.mjs --screenshots-mode)
           echo "скриншоты документации: режим $mode"
-          node scripts/check-docs.mjs --external --screenshots=$mode
+          node scripts/check-docs.mjs "$external" --screenshots=$mode
 
       # #635: `docs/reviews/INDEX.md` — снимок каталога ревью; расхождение с
       # каталогом — невидимые через индекс документы (r2 #635 H1). Гейт стоит
@@ -137,6 +146,39 @@ jobs:
           done
           exit $status
 
+      # #700: расхождение зеркала на dev — одно открытое issue владельцу, как у
+      # ночного мутационного гейта (#472): чинит его тот, кто зеркалит в main, а
+      # не автор задачи, чья ветка ни при чём. Сбой API — предупреждение: шаг
+      # сообщает, а не судит.
+      - name: "Расхождение зеркала на dev — issue владельцу"
+        if: github.event_name == 'push' && github.ref == 'refs/heads/dev' && steps.workflow_sync.outcome == 'failure'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          marker="[workflow-sync]"
+          # Список не прочитан — нового issue нет: иначе сбой сети или
+          # рейт-лимит плодил бы дубликат к уже открытому (r1 #700).
+          if ! existing=$(gh issue list --repo "$REPO" --state open --search "\"$marker\" in:title" \
+            --json number,title --jq '[.[] | select(.title | startswith("[workflow-sync]"))][0].number // empty'); then
+            echo "::warning::открытые issue не прочитаны — новое не заводится, чтобы не завести дубликат"
+            exit 0
+          fi
+          if [ -n "$existing" ]; then
+            gh issue comment "$existing" --repo "$REPO" --body "Расхождение повторилось: $RUN_URL" \
+              || echo "::warning::комментарий в #$existing не оставлен"
+            exit 0
+          fi
+          cat > /tmp/workflow-sync.md <<EOF
+          Тонкие вызывающие workflow в \`main\` и \`dev\` различаются. Прогон: $RUN_URL
+
+          Тонкий файл исполняется из ветки по умолчанию, поэтому правку триггеров, входов или прав нужно зеркалить в \`main\` (PROCESS.md §10.4, #623). На ветках задач это предупреждение (#700), на push в \`dev\` — красный preflight, пока зеркало не выровнено.
+          EOF
+          gh issue create --repo "$REPO" --title "$marker тонкие workflow в main и dev различаются" \
+            --label infra --label process --body-file /tmp/workflow-sync.md \
+            || echo "::warning::issue о расхождении зеркала не заведено"
+
       # Оба гейта ниже судят САМ диапазон коммитов, а не объём проверок, и до
       # #388 брали его от головы предыдущего пуша. Прогон предыдущего пуша
       # штатно отменяется следующим (concurrency), и тогда его коммиты не судит
@@ -217,6 +259,7 @@ jobs:
           PROCESS_GATE: ${{ steps.process_gate.outcome }}
           ACTION_PINS: ${{ steps.action_pins.outcome }}
           REVIEWS_INDEX: ${{ steps.reviews_index.outcome }}
+          REF: ${{ github.ref }}
         run: |
           fail=0
           check() {
@@ -228,9 +271,25 @@ jobs:
               fail=1
             fi
           }
+          # #700: причина, к которой ветка задачи отношения не имеет, — в сводку
+          # предупреждением; на dev, кандидате и релизе она красит как прежде.
+          advise() {
+            if [ "$2" = "success" ]; then
+              echo "ok   $1"
+            else
+              echo "::warning::$1 ($2) — на ветке задачи предупреждение (#700)"
+              echo "- $1: $2 — предупреждение, чинит релиз-менеджер (#700)" >> "$GITHUB_STEP_SUMMARY"
+            fi
+          }
+          task_branch=false
+          case "$REF" in refs/heads/issue/*) task_branch=true ;; esac
           echo "### Предполётные проверки" >> "$GITHUB_STEP_SUMMARY"
           check "документация" "$DOCS"
-          check "тонкие вызывающие workflow в main и dev" "$WORKFLOW_SYNC"
+          if [ "$task_branch" = "true" ]; then
+            advise "тонкие вызывающие workflow в main и dev" "$WORKFLOW_SYNC"
+          else
+            check "тонкие вызывающие workflow в main и dev" "$WORKFLOW_SYNC"
+          fi
           check "провенанс коммитов" "$PROVENANCE"
           check "процессный гейт" "$PROCESS_GATE"
           check "пины сторонних Actions" "$ACTION_PINS"
@@ -247,7 +306,8 @@ jobs:
   # там делает код-ревью, которое гоняет гейты само (#127).
   changes:
     name: Классификация изменённых файлов
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     # Чтение списка прогонов Validate — единственное, что этой job нужно сверх
     # содержимого репозитория (#387).
     permissions:
@@ -280,7 +340,8 @@ jobs:
       # предыдущего пуша штатно, и на #86 (r5) это дало зелёный статус ветки
       # без единого исполненного тяжёлого гейта.
       # Смоки, golden, performance_smoke — на кандидате беты (трейлер
-      # `Release:`), по `workflow_dispatch full=true`, на PR (#479). Логика и
+      # `Release:` вне веток задач, #697), по `workflow_dispatch full=true`, на
+      # PR (#479). Логика и
       # её тест — scripts/classify-changes.mjs.
       - id: heavy
         env:
@@ -288,6 +349,7 @@ jobs:
           HEAD_MESSAGE: ${{ github.event.head_commit.message }}
           FULL_INPUT: ${{ inputs.full }}
           MUTANTS_INPUT: ${{ inputs.mutants }}
+          REF_NAME: ${{ github.ref_name }}
         run: node scripts/classify-changes.mjs --heavy | tee -a "$GITHUB_OUTPUT"
       - id: base
         if: github.event_name != 'pull_request'
@@ -406,7 +468,8 @@ jobs:
     # performance_smoke включает набор, иначе glow-only результат засчитался бы
     # прогону, которому нужен изометрический профиль.
     needs: changes
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     outputs:
       smoke: ${{ steps.probe.outputs.smoke }}
       golden: ${{ steps.probe.outputs.golden }}
@@ -555,7 +618,8 @@ jobs:
     name: "HACS: валидация репозитория"
     needs: changes
     if: needs.changes.outputs.integration == 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - name: HACS validation
@@ -567,7 +631,8 @@ jobs:
     name: "Hassfest: манифест интеграции"
     needs: changes
     if: needs.changes.outputs.integration == 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - name: Hassfest validation
@@ -598,7 +663,7 @@ jobs:
       fail-fast: false
       matrix:
         shard: [1, 2, 3, 4, 5, 6]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 30
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -727,7 +792,8 @@ jobs:
     name: "Фронтенд: типы, юниты, мутанты, синхрон бандла"
     needs: changes
     if: needs.changes.outputs.frontend == 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 40
     steps:
       # Полная история без блобов (#342): гейт «новый код не добавляет any»
       # diff-aware, ему нужен диапазон, а содержимое старых ревизий — нет.
@@ -742,8 +808,10 @@ jobs:
         run: npm run typecheck
       # Долг типизации снимается при извлечении подсистем (#34), а не разовой
       # заменой: в src/** его 1034 вхождения в 49 файлах. Гейт держит приращение
-      # на нуле — судит только добавленные строки (#342).
-      - name: "Новый код не добавляет any"
+      # на нуле — судит только добавленные строки (#342). Тем же диапазоном
+      # судится и приращение записей смоков в приватное состояние карточки
+      # (#629): больше двух тысяч старых не трогаем, новых не добавляем.
+      - name: "Новый код не добавляет any и приватных записей в смоках"
         env:
           EVENT_NAME: ${{ github.event_name }}
           BEFORE_SHA: ${{ github.event.before }}
@@ -774,15 +842,25 @@ jobs:
             echo "не нашёл базу диапазона — гейт пропущен, это увидит следующий пуш"
             exit 0
           fi
-          node scripts/no-new-any.mjs --base "$base" --head "$HEAD_SHA"
-      - name: Unit tests
-        run: npm test
+          status=0
+          node scripts/no-new-any.mjs --base "$base" --head "$HEAD_SHA" || status=1
+          node scripts/no-new-private-writes.mjs --base "$base" --head "$HEAD_SHA" || status=1
+          exit "$status"
       - name: Build
         run: npm run build
+      # Часть unit-контрактов проверяет размеры реально поставляемых графов в
+      # dist/ (#438, #593, #627). В issue-ветке закоммиченный dist законно
+      # отстаёт от исходников (#657), поэтому юниты обязаны читать свежую
+      # сборку — тот же порядок закреплён локальным gate:small.
+      - name: Unit tests
+        run: npm test
       # Entry, manifest and every content-hashed chunk are one artifact (#337).
+      # #657: the committed bundle changes only in a release candidate, so the
+      # fresh build must equal it only there; elsewhere the committed copy
+      # legitimately lags and only the fresh dist is verified.
       - name: Card bundle trees in sync
         run: |
-          node scripts/bundle-tree.mjs dist custom_components/houseplan/frontend
+          node scripts/bundle-policy.mjs --verify HEAD
           npm run bundle:budget
       # #624: `tsc --noUnusedLocals` чист вне порта/харнесса, шесть чисел
       # связности монолита не выше scripts/monolith-baseline.json. После
@@ -814,12 +892,48 @@ jobs:
           retention-days: 1
           if-no-files-found: error
 
+  # #657 (2б): бандл в дереве dev меняет только кандидат беты, поэтому стенд
+  # dev.houseplan.tech берёт его не из дерева, а из этого артефакта: после
+  # зелёного фронтенда на push в dev собранный `dist/` публикуется в служебную
+  # ветку `dev-build` одним коммитом без истории (scripts/dev-build.mjs), хост
+  # забирает его demo/stand/update-dev-bundle.sh. Опубликуется только голова:
+  # если dev ушёл вперёд, пушит следующий прогон. Не вход доказательства:
+  # стенд — не гейт, и сбой публикации не красит проверку кода.
+  dev_build:
+    name: "Бандл головы dev для стенда"
+    needs: frontend
+    if: github.event_name == 'push' && github.ref == 'refs/heads/dev' && needs.frontend.result == 'success'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    continue-on-error: true
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
+        with:
+          node-version: 22
+      # download-artifact распаковывает поверх checkout и не удаляет старые
+      # content-hashed чанки закоммиченного release-бандла (#657). Свежий
+      # артефакт должен быть единственным содержимым dist, иначе bundle-tree
+      # справедливо видит оставшиеся файлы как orphan assets.
+      - name: Очистить закоммиченный dist перед артефактом
+        run: |
+          node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"
+      - name: Забрать собранный бандл
+        uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
+        with:
+          name: card-bundle
+          path: dist
+      - name: Опубликовать в dev-build
+        run: node scripts/dev-build.mjs --sha "$GITHUB_SHA" --dist dist
+
   smoke:
     name: Смоки в браузере (шард ${{ matrix.shard }} из 3)
     # Gated on `frontend` so a typecheck failure does not burn browser minutes.
     needs: [changes, frontend, reuse]
     if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.smoke != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     timeout-minutes: 20
     # Смоки шардируются: последовательный прогон занимал ~7.5 минут и был
     # критическим путём всего Validate. Три шарда режут его примерно вдвое;
@@ -852,6 +966,9 @@ jobs:
       # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
       # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
       # сверяет вшитый отпечаток с исходниками этого дерева.
+      - name: Очистить закоммиченный dist перед артефактом
+        run: |
+          node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"
       - name: Забрать собранный бандл
         uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
         with:
@@ -923,7 +1040,8 @@ jobs:
     name: "Смоки: все шарды зелёные"
     needs: [changes, smoke, reuse]
     if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.smoke != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - name: Записать маркер успеха
         run: |
@@ -947,7 +1065,8 @@ jobs:
     # inexpensive and catches a different class of regressions than timings.
     needs: [changes, frontend, reuse]
     if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.golden != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
@@ -972,6 +1091,9 @@ jobs:
       # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
       # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
       # сверяет вшитый отпечаток с исходниками этого дерева.
+      - name: Очистить закоммиченный dist перед артефактом
+        run: |
+          node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"
       - name: Забрать собранный бандл
         uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
         with:
@@ -1046,7 +1168,7 @@ jobs:
     # prereleases. The expensive same-runner comparison lives in performance.yml.
     needs: [changes, frontend, reuse]
     if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.performance_smoke != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     # 15 минут не хватало, когда установка браузера шла через apt: замер
     # начинался на исходе окна (#206). Запас на холодный кэш — при попадании
     # job укладывается в те же минуты, что и раньше. Диффозависимые профили
@@ -1076,6 +1198,9 @@ jobs:
       # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
       # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
       # сверяет вшитый отпечаток с исходниками этого дерева.
+      - name: Очистить закоммиченный dist перед артефактом
+        run: |
+          node -e "require('node:fs').rmSync('dist', { recursive: true, force: true })"
       - name: Забрать собранный бандл
         uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7
         with:
@@ -1139,7 +1264,8 @@ jobs:
     name: "Геометрия: TS/Python parity исполнена"
     needs: [changes, reuse]
     if: needs.changes.outputs.geometry_parity == 'true' && needs.reuse.outputs.geometry_parity != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
@@ -1173,7 +1299,8 @@ jobs:
     name: "Бэкенд: pytest в Home Assistant"
     needs: [changes, reuse]
     if: needs.changes.outputs.backend == 'true' && needs.reuse.outputs.backend != 'true'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       # Browser fixtures are generated by their real ESM factories and then
@@ -1259,7 +1386,8 @@ jobs:
     name: "Доказательство выполненных проверок"
     if: always()
     needs: [preflight, changes, reuse, hacs, hassfest, changed_mutants, frontend, smoke, smoke_done, golden, performance_smoke, geometry_parity, backend]
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:

AGENTS.md

@@ -4,89 +4,51 @@ House Plan is one HACS package with two parts plus a demo harness:
 
 - **Lovelace card** (`src/`, TypeScript + Lit) — the primary product, bundled to
   the entry, manifest and hashed chunks under `dist/`.
-- **Storage integration** (`custom_components/houseplan/`, Python) — the Home Assistant backend.
-- **Demo harness** (`demo/`) — a self-contained Playwright page (`demo/srv/demo.html`) that renders the card against a fake `hass`, used for screenshots and the `smoke_*.mjs` end-to-end suite.
+- **Storage integration** (`custom_components/houseplan/`, Python) — the Home
+  Assistant backend.
+- **Demo harness** (`demo/`) — a Playwright page (`demo/srv/demo.html`) that
+  renders the card against a fake `hass` for screenshots and the `smoke_*.mjs`
+  suite. The home is fully synthetic. Launcher `demo/serve.mjs`; golden scenes
+  `demo/golden/`, performance `demo/performance/`, guard suite `demo/guard/`,
+  live stand seed `demo/stand/` — each with its own README.
+
+This file is the map and the few rules every session needs before its first
+command. `PROCESS.md` is the only complete canon and wins any disagreement;
+the sections below link to it instead of retelling it.
 
 ## Read this first
 
 **`docs/SCOPE.md` before anything else.** It was fixed with the owner and states
 its own authority: features are built, improved and accepted **only** if they
-serve a job listed there. It carries the mission, the three personas, the core
-user jobs and the out-of-scope list.
-
-Its central consequence: **View mode is the product for two of the three
-personas.** Editors are admin-only tools and must never leak interactions into
-View.
-
-For work that changes visible behaviour, also read `docs/USER-GUIDE.ru.md` —
-interface wording comes from there and is not invented, or the UI starts speaking
-developer.
+serve a job listed there. Its central consequence: **View mode is the product
+for two of the three personas.** Editors are admin-only tools and must never
+leak interactions into View. For work that changes visible behaviour, also read
+`docs/USER-GUIDE.ru.md` — interface wording comes from there and is not invented.
 
 **Reading order by role** (#634). `node scripts/entry-cost.mjs` measures each
 route and `test/entry-cost.test.mjs` keeps this list equal to its routes:
 
 - author (analysis, spec, implementation, infrastructure): `docs/SCOPE.md` →
-  `AGENTS.md` → `docs/process/AUTHOR.md` → `docs/STATUS.md`;
+  `AGENTS.md` → `docs/process/AUTHOR.md`, then the task packet
+  (`node scripts/task-packet.mjs --issue NN`); the status snapshot
+  (docs/STATUS.md) only when resuming a session or preparing a release;
 - reviewer (spec or code): `docs/SCOPE.md` → `AGENTS.md` →
   `docs/process/REVIEWER.md`, then the issue body and its comments;
 - changing the pipeline, the gates or the process itself: `docs/SCOPE.md` →
   `AGENTS.md` → `PROCESS.md` → `docs/STATUS.md`.
 
-The two digests quote and link `PROCESS.md` section by section; it stays the
-only complete canon and wins any disagreement, so open the linked section
-whenever a digest line governs your current step. For non-trivial changes add
-`docs/ARCHITECTURE.md` plus the canonical document of the subsystem you touch:
+The two digests quote and link `PROCESS.md` section by section; open the linked
+section whenever a digest line governs your current step. For non-trivial
+changes add `docs/ARCHITECTURE.md` plus the canonical document of the subsystem
+you touch (one list, the same one the reviewer prompt in `_process.yml` reads):
 `SUN.md`, `LIGHT.md`, `CANVAS.md`, `WALL-THICKNESS.md`, `UX-MODES.md`,
-`CONFIG-COMPATIBILITY.md`, `TOUCH-SUPPORT.md`.
+`CONFIG-COMPATIBILITY.md`, `TOUCH-SUPPORT.md`, `ISOMETRIC.md`, `VACUUM.md`,
+`DECOR-EDITOR.md`, `DEVICE-PRESENTATION.md`, `FILTERING.md`, `STAIRS.md`,
+`RADAR.md`, `PDF-EXPORT.md`, `STYLING-HOOKS.md`.
 
-Standard commands live in `package.json` scripts, `CONTRIBUTING.md` and
-`docs/DEVELOPMENT.md`.
-
-## Canonical backlog and status
-
-[GitHub Issues](https://github.com/Matysh/houseplan-card/issues) are the canonical
-task records: problem, scope, acceptance criteria and discussion.
-
-**Status lives in labels:** `S1-new`, `S2-analysis`, `S3-spec`, `S4-spec-review`,
-`S5-ready`, `S6-in-progress`, `S7-code-review`, `S8-merged`, plus `blocked` on top
-of a status and `rejected` on a closed issue. A product issue in flight carries
-exactly one `S*` label. An infrastructure-only issue is the deliberate exception:
-it may carry no `S*` label while being implemented, enters the common flow at
-`S7-code-review`, and from then on carries exactly one. Labels are the whole of
-it: GitHub Projects is no longer used.
-
-**The light track is the default, not a shortcut** (owner's decision 2026-08-27,
-issue #338). `small` — the spec lives in the issue body and its review is a
-comment. Analysis names the `small` criterion the task *fails* when it takes the
-full track; "ordinary track" without a named criterion is not a justification.
-The threshold itself did not move — only which side carries the proof. The full
-track stays what it was for geometry, config migrations and public contracts,
-where a criterion is broken plainly and saying which one is easy.
-
-`trivial` — the short track: no spec stage at all, `S2-analysis` straight to
-`S5-ready`, with the AC written into the issue body first. `trivial` requires a bug confined to one surface with no new UX
-contract, no migration, no i18n, no perf or touch impact, at most three checkable
-AC, **and expected behaviour already on record** — nothing left to decide. Code
-review is never skipped on either track: it checks scope, risks and the evidence
-from executed tests, but does not stand in for executing them.
-`PROCESS.md` §5 and §5.1 hold the criteria.
-
-An issue filed by an outsider is worked exactly like one of the owner's own, once
-the owner has decided to take it. For product work the check sits **at the
-entrance**, not on every step: the first status label admits it to the flow. For
-infrastructure work an explicit assignment by the owner is the entrance, and the
-issue may remain without an `S*` label until its first `S7-code-review`. In either
-case, **who filed it stops mattering** once the owner has admitted it.
-
-Applying that first label *is* the owner's explicit decision, and the platform
-already guarantees it — only someone with write access can label. The earlier rule
-made outside reports be refiled as the owner's own issues, which turned out to be
-work for nothing: on #123 the spec was already written by the time the guard
-refused.
-
-Specs, audits and ADRs may live under `docs/`, but must link to their issue and
-must not become a parallel task list. When repository documentation disagrees with
-Issues, the issue wins.
+Where the rest lives: commands — `package.json` scripts, `CONTRIBUTING.md`,
+`docs/DEVELOPMENT.md` (toolchain, build, release — its Release section is the
+only home of release mechanics); tests and gates — `docs/TESTING.md`.
 
 ## Rule #1
 
@@ -103,183 +65,107 @@ The label must be one of `S5-ready`, `S6-in-progress`, `S7-code-review`. Anythin
 else — refuse and say why. "Issue #83 is in `S2-analysis`, code is off limits.
 Start with the spec?" is the correct answer, not a smaller patch.
 
-## Change classes
+GitHub Issues are the canonical task records and the **labels** are the status
+(`PROCESS.md` §9); when repository documentation disagrees with an issue, the
+issue wins. Change classes (`PROCESS.md` §1): **A** product (`src/**`,
+integration Python, manifests, i18n), **B** gates and tooling (tests, `demo/**`,
+`scripts/**`, `.github/**`, build and package configuration), **C**
+documentation, **D** generated (bundle, golden baselines) — D beats A where paths
+overlap. The committed bundle changes only in a commit with a `Release:` trailer
+(#657); an ordinary task restores it with `npm run bundle:clean` before
+committing.
 
-| Class | Paths | Issue required |
-|---|---|---|
-| **A — product** | `src/**`, `custom_components/houseplan/**/*.py`, `manifest.json`, `hacs.json`, i18n, `custom_components/**/translations/**` | yes |
-| **B — gates and tooling** | `test/**`, `tests_backend/**`, `demo/**`, `scripts/**`, `.github/workflows/**`, `rollup.config.mjs`, `tsconfig*.json` | yes; may reuse the issue it covers |
-| **C — documentation** | `docs/**`, `README*`, `CHANGELOG*`, `AGENTS.md` | not if it is part of its issue's DoD |
-| **D — generated** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**` | never changes on its own. The stand copy `demo/srv/assets/**` is no longer committed (#255): build the complete tree with `npm run bundle:sync` |
+**Tracks** (`PROCESS.md` §5, §5.1): the label `track:ship`, `track:show` or
+`track:ask` sets the route, and the owner's label beats the criteria. `show` is the
+default: up to three AC in the issue body, no spec review, `S2` → `S5`. `ship` is a
+one-sentence change within fixed limits, `S1` → `S5`. `ask` is the full route with
+a spec review. Any agent may raise a track with a reason; only the owner lowers it.
+`small` and `trivial` read as `show`. An **infrastructure** task — not a single
+class A file — skips analysis and spec and enters at `S7-code-review`
+(`PROCESS.md` §1). Every change is code-reviewed; on `ship` the review moves to a
+batch review of the beta range before the tag (`ship-review.yml`, `PROCESS.md`
+§11.7). The review pipeline prices each round by track (§10.4): diff mutants
+only on `ask` or with `ci:mutants`; a rebase before review only on `ask` or when
+the branch does not merge cleanly into `dev`. Review checks scope, risks and the
+evidence from executed tests, but does not replace executing them.
 
-The table above is a summary; `PROCESS.md` §1 is the authority and now covers the
-configuration files this one omits — `package.json`, `package-lock.json`,
-`pytest.ini`, `.gitignore`, `.gitattributes`, `.githooks/**` and the rest of
-`.github/**` are class B. Where paths overlap, **D beats A**: the built bundle
-lives inside `custom_components/houseplan/frontend/` and would otherwise read as
-product source.
+## Specs
 
-## Commits
+The spec lives in the **issue body**, under a `## ТЗ` heading (owner decision
+2026-09-10, #517); `docs/specs/` is an archive of specs written before that date
+and takes no new files. Required sections and the rule for questions are
+`PROCESS.md` §7.1: only **product** ambiguity goes to the owner — what a person
+sees or does, and how much user-visible change belongs in this issue — in one
+batched comment with a proposed default for each question and `blocked` on top of
+`S3-spec`. Everything a user cannot observe is yours to decide and record.
 
-Hooks install themselves: `package.json` runs `"prepare": "node
-scripts/install-hooks.mjs"`, so `npm ci` sets `core.hooksPath` in every fresh
-clone. Verify with `git config core.hooksPath` — expect `.githooks`.
+## Commits and branches
 
-Every non-merge commit carries **terminal** trailers:
+Hooks install themselves on `npm ci` (`prepare` → `scripts/install-hooks.mjs`);
+`git config core.hooksPath` must print `.githooks`. Every non-merge commit that
+touches anything outside class C (docs) carries **terminal** trailers; a
+docs-only commit needs none (`PROCESS.md` §3 п.10, #701):
 
 ```text
 Issue: #123
 User-Visible: yes
 ```
 
-One `Issue:` line per issue if a commit closes several. `User-Visible: no` for
-tests, refactors, tooling and documentation that does not change the product.
-`User-Visible: yes` requires edits to **both** changelogs — `docs/CHANGELOG.md`
-and `docs/CHANGELOG.ru.md` — in the same commit.
+One `Issue:` line per issue. `User-Visible: yes` requires edits to **both**
+`docs/CHANGELOG.md` and `docs/CHANGELOG.ru.md` in the same commit. A commit
+touching `demo/golden/baselines/**` also needs `Release:` plus exactly one of
+`Baseline-Reviewed: <GitHub run URL>` or `Baseline-Reviewed-Local: sha256:<WSL
+attestation>` (`PROCESS.md` §10.1). Never invent a review link and never rewrite
+published history to satisfy trailers.
 
-A commit touching `demo/golden/baselines/**` additionally requires:
+Branch `issue/<NN>-slug`; direct commits to `dev`, no PR (owner's decision); a
+violation is fixed with a follow-up commit, never a force-push.
 
-```text
-Release: v1.62.0-beta.9
-Baseline-Reviewed: https://github.com/Matysh/houseplan-card/actions/runs/<run-id>
-```
-
-or, for a complete attested capture made in the repository's WSL/ext4 clone:
-
-```text
-Release: v1.62.0-beta.9
-Baseline-Reviewed-Local: sha256:<wsl-attestation hash>
-```
-
-Exactly one of the two `Baseline-Reviewed*` trailers is allowed. The local hash
-must equal `localAttestation.sha256` in the committed baseline index; it does not
-replace the mandatory full GitHub Validate on the final exact SHA.
-
-Never invent a review link and never rewrite published history to satisfy
-trailers. `.githooks/commit-msg` and the `provenance` CI job both run
-`scripts/validate-commit-provenance.mjs`.
-
-Branch: `issue/<NN>-slug`. Direct commits to `dev`, no PR — the owner's decision;
-CI checks after the fact, and a violation is fixed with a follow-up commit, never
-a force-push.
-
-**Push after every task, not before a beta.** While work sits unpushed there is
-nothing to review, and reviewing twenty tasks at once is not review. `dev` may hold
-unreviewed code while a task is in flight; what matters is its state when the
-reviewer says it is accepted.
-
-**Standing permission: push `issue/<NN>-slug` without asking.** The reviewer runs
-in CI and can only read what is on the remote — an unpushed spec or commit means
-the review either stalls or judges the wrong tree. Pushing a task branch publishes
-nothing to users and does not touch the integration branch, so it needs no command.
-
-**Do not merge into `dev` by hand.** On a green code review the pipeline rebases
-the task branch onto `dev`, pushes it, and only then sets `S8-merged` — the label
-asserts the code is in `dev`, so the merge has to happen first or the label lies
-in between.
-
-If the rebase conflicts the pipeline says so in the issue and sends the task back
-to `S6-in-progress`. The verdict still stands: nothing needs reviewing again, the
-remaining work is the rebase. When the conflict is only in the committed bundle
-(`dist/**`, `custom_components/houseplan/frontend/**` — the usual case when two
-tasks built it in parallel), run `node scripts/rebase-on-dev.mjs` (#479): it takes
-`dev`'s copy through the rebase, rebuilds with `npm run bundle:sync` and amends
-the result into your last commit; a conflict in `docs/reviews/INDEX.md` is
-rebuilt from the directory (#643, the same helper the pipeline uses, so the
-pipeline no longer bounces a task on it); a conflict anywhere else aborts and
-leaves the tree as it was. Then push the branch and re-apply `S7-code-review`. When the
-only difference from the reviewed material is the pipeline's own review-document
-commit, the next run re-applies the green verdict without calling the model
-(#499); any other change to the tree — a rebase included — gets a full review.
-
-The pipeline is an idempotent controller (#499): only `S4-spec-review` and
-`S7-code-review` start it, it reads the issue's *current* labels rather than the
-event snapshot, and a label removed before the run starts is treated as a
-withdrawn request. Push the material **before** applying the label — the reviewer
-is pinned to the SHA the pipeline captured and must not fetch newer commits. The second review run is not a formality — after a rebase onto a
-moved `dev` this is different code, and accepting it unchecked is how regressions
-arrive. Cycles are counted per stage, so a code review spends its own budget.
-
-Everything else still requires the owner's explicit command: pushing `main`,
-creating tags, publishing betas and releases, closing issues.
+- **Push after every task, not before a beta** — while work sits unpushed there
+  is nothing to review.
+- **Standing permission: push `issue/<NN>-slug` without asking.** The reviewer
+  runs in CI and reads only the remote; a task branch publishes nothing to users.
+  Push the material **before** applying the review label.
+- **Do not merge into `dev` by hand.** On a green review the pipeline rebases,
+  pushes and only then sets `S8-merged`. A conflicting rebase returns the task to
+  `S6-in-progress` with the verdict intact; `node scripts/rebase-on-dev.mjs`
+  resolves conflicts in generated files only (`PROCESS.md` §2.10), then push and
+  re-apply `S7-code-review`.
+- Everything else needs the owner's explicit command: pushing `main`, tags,
+  publishing betas and releases, closing issues.
 
 ## Working trees (#115)
 
 One checkout, one `HEAD`: two agents sharing a directory inherit each other's
-branch, and twice in one hour a commit landed on someone else's task branch that
-way. The layout is therefore fixed:
+branch. `houseplan-card-src/houseplan-card` is the author's tree — task branches
+live there, and unfamiliar local changes belong to the author or the owner,
+never reset or clean them away. `houseplan-card-src/hp-dev` is the owner's
+worktree, permanently on `dev`. The reviewer owns no tree: it runs in CI on a
+fresh checkout. A worktree works only on the machine that created it — its
+`.git` file records an absolute path in that machine's format.
 
-- **`houseplan-card-src/houseplan-card`** — the author's tree. Task branches live
-  here; nobody else commits in it. Unfamiliar local changes belong to the author
-  or the owner — never reset or clean them away.
-- **`houseplan-card-src/hp-dev`** — the owner's worktree, permanently on `dev`. For owner-side operations that must not disturb the
-  author's tree: pushing `dev`, restoring a hook's executable bit, emergencies.
-- **The reviewer owns no author tree.** It runs in CI on a fresh checkout. The
-  agent implementing an infrastructure task is an ordinary task author and uses
-  the same author-tree rules as product work; task branches must not share a
-  mutable checkout concurrently.
+## Handoff and the verdict
 
-A worktree is only usable on the machine that created it: the `.git` file records
-an absolute path in that machine's format. One created from a Linux sandbox is
-dead on Windows and vice versa — create worktrees on the machine that will use
-them, which for `hp-dev` means the owner's.
+Start a task from its packet: `node scripts/task-packet.mjs --issue NN` (status,
+track, what the status permits, the branch against `dev`, the previous verdict
+and the unwitnessed AC; it writes nothing). The local gate is
+`npm run gate:small` (`docs/TESTING.md` › Локальный набор перед пушем); run the
+smokes named in the AC before `S7-code-review`. **"Verified" without a named
+command and its result is not evidence.** Comment formats — claim, handoff,
+verdict — are `PROCESS.md` §7.2.
 
-## Agent-neutral workflow
+**One handoff, one push** (`PROCESS.md` §10.4). Run
+`node scripts/process-gate.mjs --issues` before pushing; after
+`S7-code-review` do not push to the branch until the verdict or the return
+arrives — a push on top of a running review cancels it.
 
-No task type is reserved for Codex, Claude or any other named model. **Any agent
-may take any task**: analysis, spec, product implementation, infrastructure or a
-release explicitly commanded by the owner. Roles describe the current artifact,
-not the agent brand. The owner rules on product disputes, closes issues and
-commands releases.
-
-Author and reviewer are independent agents/sessions. They need not use different
-model families, but the reviewer must start without implementation context and
-must not be the author grading their own work. The reviewer does not edit the
-material under review.
-
-**Infrastructure-only work uses an accelerated entry into the common flow.** It
-is implemented immediately by any agent, without analysis, spec, spec review or
-the statuses `S1`…`S6`. Once the branch is ready and pushed, apply
-`S7-code-review`. From there the ordinary controller applies: green review rebases
-and merges the checked material into `dev` and then sets `S8-merged`; findings or
-a failed merge return the issue to `S6-in-progress`, and after correction it is
-submitted to `S7-code-review` again.
-
-The test for "infrastructure only" is mechanical: **not a single class A file** —
-nothing under `src/**`, no `custom_components/**/*.py`, no manifests, no i18n. A
-task that touches class A even once is not infrastructure and takes the full flow;
-there is no such thing as "mostly infrastructure". The strictness is deliberate:
-a loose reading would turn this into the route by which product changes skip
-review.
-
-What stays mandatory either way: an issue exists, both trailers are on every
-commit, proportionate local gates are green (normally `typecheck`, `test` and
-`build`), and any non-obvious decision is written down in the code or the issue
-rather than kept in someone's head. Infrastructure work skips specification, not
-code review.
-
-**Review starts by itself.** Applying `S4-spec-review` or `S7-code-review` fires the
-pipeline. Deterministic gates, model review and integration have independent
-55/45/55-minute budgets (#551); typical runs finish well before those ceilings.
-
-**Having applied one of those labels, wait for the result instead of ending the
-session.** Reporting "handed over for review" stops a conveyor that could have kept
-moving on its own. An agent has no clock — it exists only during its own turn — so
-waiting means polling: every 90 seconds, at most 110 times. A single long sleep hits
-the command timeout. Do the polling with `node scripts/wait-verdict.mjs --issue NN
-[--sha <tip>]` (#496): it watches the label, the pipeline's own comments (conflict,
-cancelled merge, failed run) and optionally Validate on the SHA, prints only when
-the state changes and exits 0 on a new label, 3 on an event that needs a hand,
-4 on timeout — the same 90 s × 110 without a model turn per tick. It writes
-nothing. Pipeline comments older than the latest application of `S4`/`S7` are
-the baseline, not an outcome of the new round; an outcome from the current round
-which already exists when the waiter starts is still delivered immediately (#546).
-Watch the **label**, not the comment: the label is the state,
-the comment only explains it. Do not wait at all while `blocked` is set — the task
-is waiting on the owner, not on the reviewer. On exhausting the attempts, stop and
-tell the owner: a failed run leaves the label where it was, forever.
-
-What the new label means:
+**Having applied `S4-spec-review` or `S7-code-review`, wait for the result
+instead of ending the session.** The label starts the pipeline by itself. Poll
+with `node scripts/wait-verdict.mjs --issue NN [--sha <tip>]` (#496): it watches
+the label and the pipeline's comments every 90 s, at most 110 times, prints only
+on a change and exits 0 on a new label, 3 on an event that needs a hand, 4 on
+timeout. Watch the **label**, not the comment. Do not wait while `blocked` is
+set.
 
 | Now reads | What happened | What you do |
 |---|---|---|
@@ -290,340 +176,21 @@ What the new label means:
 | `review-4` | the cycle limit is spent | stop, the owner decides |
 
 **After a review run the label always changes.** If it did not, the run itself
-failed rather than the work — say so to the owner instead of polling on.
+failed rather than the work — say so to the owner instead of polling on. The
+bounded queue reconciler (#555) re-wakes a review whose event was lost; it is a
+safety net, not permission to stop waiting for the review you started.
 
-The repository also has a bounded queue reconciler (#555). It takes one S4/S7
-snapshot every thirty minutes and exits. It may re-apply the same review label
-only when the matching event was lost or its run ended with a transient
-cancellation/timeout before a sealed result existed. It never applies verdicts or
-merges. Running work, `blocked`, `review-4`, a foreign material/stage/attempt, a
-guard failure, or an unintegrated sealed model result is left untouched and gets
-at most one machine-keyed diagnostic. This is a safety net, not permission for an
-agent to stop waiting for the result of the review it started.
-
-**A failed pre-release gate does not send the issue back to review.** The
-implementation loop runs only typecheck, unit and build; golden, browser smokes,
-performance and the full HA harness run before a beta, which is after the code
-review has passed and the issue sits in `S8-merged`. Some defects cannot surface
-any earlier.
-
-Fix it, re-run what failed, and a green run is enough for the release to continue.
-The issue stays in `S8-merged`. Record the **exact command and its result** in the
-issue — "verified" without a command proves nothing. Trailers as usual, and
-`User-Visible: yes` still means both changelogs in the same commit.
-
-The exception covers repairing the defect the gate named, not carrying on
-development under the name of a repair. It goes through the normal flow — a new
-issue, or back to `S6-in-progress` — if the fix changes a behaviour contract, gives
-the user something new, reaches a subsystem the task never touched, or is
-comparable in size to the task itself. And editing the gate so it stops failing is
-concealment, not repair; the exception is a defect proven to be **in the fixture**,
-as on #89, where the sun sat at azimuth 180° and the only window faced north, so no
-ray was ever built.
-
-Baselines are still accepted only via `npm run golden:accept -- --reviewed` from
-either a complete Linux CI artefact or a complete attested WSL artefact produced
-by `npm run golden:wsl:capture`. "So the gate goes green" is not a reason, and
-the WSL route never replaces the independent full GitHub Validate on the final
-exact SHA.
-
-The exchange happens in **issue comments** — there is no local message bus. Verdict
-format:
-
-```text
-Verdict: green/yellow/red · cycle r<N>/4 · High: N · Medium: N → in-task | #… · Document: …
-```
-
-High blocks. A Medium finding INSIDE the task's scope is fixed within the task:
-with no High findings the verdict is yellow, the author fixes it and the fix
-passes another review cycle — no separate issue (owner's decision 2026-08-19,
-#202: filing and servicing an issue costs far more than fixing in place). Only
-a Medium finding OUTSIDE the scope becomes its own issue — foreign scope is
-never patched from this branch. Low is fixed or waived with a note
-in the review document. A yellow verdict is legitimate even when every acceptance
-criterion passes, if the change does not solve the stated scenario or degrades a
-neighbouring one.
-
-**Four review cycles** (two on the light track). The counter lives in the document
-name, `-r1`…`-r4`; the fourth adds the `review-4` label. There is no fifth attempt:
-the owner splits the task, rejects it, or arbitrates.
-
-On the light track (`small`: complexity ≤3, one surface, no config migration, no
-new UX contract, no perf or touch impact — all at once) the spec lives in the issue
-body and the spec review is a comment. Code review is never skipped. This track is
-the default: taking the full one means naming the criterion above that the task
-does not meet.
-
-## Specs
-
-The spec lives in the **issue body**, under a `## ТЗ` heading (owner decision
-2026-09-10, #517); `docs/specs/` is an archive of specs written before that date
-and takes no new files. Required sections are in `PROCESS.md` §7.1, plus two
-product ones: which persona meets this, on which surface, at what moment; and what
-the person sees before and after, in one sentence without implementation terms.
-Proof that a verdict was passed on a given text is the pipeline's job: it writes
-the `sha256` of the normalised body into the review document's anchor block, and
-an edit made after a green spec review reaches the code reviewer as a finding.
-
-**Ambiguity is asked, not guessed — but only product ambiguity.** A guess written as
-fact is the worst kind of defect: it passes review because it looks like a decision.
-
-The owner answers exactly two kinds of question: **what a person sees or does**, and
-**how much user-visible change belongs in this issue**. Behaviour in a boundary case,
-which persona wins when two conflict, what counts as acceptable degradation, whether
-a neighbouring behaviour is in scope here or becomes its own issue.
-
-Everything a user cannot observe is yours to settle: where state is stored, which
-module carries the guard, naming, file layout, test strategy, migration mechanics,
-development policy. Decide it, record it in an explicit "assumed, change freely"
-block, and let the reviewer challenge it. A technical disagreement between author and
-reviewer is settled by the verdict, not by the owner; it reaches him only when the
-cycle limit is exhausted.
-
-Split a mixed question instead of escalating all of it. "Where does this state live"
-is technical. "Does it survive a page reload and follow the plan across screens" is
-product. Ask the second, decide the first.
-
-Ask in one batched issue comment, each question carrying a proposed default, and put
-`blocked` on top of `S3-spec` while waiting. A question with a default costs the
-owner seconds; one without costs him minutes.
-
-## Gates
-
-```
-npm run typecheck
-npm test
-npm run build
-npm run inventory        # the only correct way to get test counts
-```
-
-Never copy test counts into documents by hand; they go stale in days.
-
-After building, keep the complete manifest-driven bundle trees in sync — CI
-verifies every listed file byte-for-byte:
-
-```
-npm run bundle:sync   # dist → custom_components + demo/srv/assets (#255)
-npm run bundle:budget # initial View graph <= 256000 B gzip (#337)
-```
-
-`npm run gate:small` runs the mandatory part of PROCESS §8 in one go (#479,
-#576): build with typecheck, `no-new-any` and `smoke-select` start in parallel;
-unit tests follow the completed build because their bundle-contract witnesses
-read the freshly produced `dist`, then the bundle-tree comparison and the
-bundle budget run. It prints the smokes the
-diff selects but does not run them by default — `npm run gate:small -- --smokes`
-(#496) adds the browser phase after the artefact preparation: `bundle-sync`, then
-the directly matched and registered smokes two at a time; "broad" matches stay
-the reviewer's call. `golden`, `pytest` and `check-docs --screenshots=strict`
-remain the author's call by diff and AC.
-
-**Start a task from its packet** (#496): `node scripts/task-packet.mjs --issue NN`
-prints one derived view — status and track, what the status permits, the owner's
-recent decisions, the branch against `dev` and Validate on its tip, the previous
-verdict with its recorded tree, AC → evidence from the last review document and
-what is still unwitnessed. It reads GitHub and git and writes nothing; the labels
-remain the only source of status.
-
-**Heavy CI gates run on the beta candidate, nightly and on demand — not on every
-push (#479).** `smoke`, `golden` and `performance_smoke` in Validate are gated
-on the `heavy` output: true for a head commit carrying a `Release:` trailer, for
-`workflow_dispatch full=true` (which `nightly.yml` issues on `dev` every night)
-and for pull requests. A plain push to `dev` runs preflight, frontend (types,
-units, build, bundle sync, no-new-any), the narrow TS/Python geometry parity
-guard when its inputs changed, backend, hacs and hassfest. Screenshot
-freshness in `check-docs` is likewise a warning on a plain push and an error on
-the candidate; `publish-prerelease.yml` and `release.yml` refuse a candidate
-without the `Release:` trailer, so a green Validate without the heavy jobs can
-never pass for a release.
-
-During the implementation cycle the fast gates always run. Since 2026-08-14 the
-owner's machine also carries Playwright with Chromium (Windows) and a full WSL
-environment, which changes one thing (#151): **before moving an issue to
-`S7-code-review`, run the smokes named in its AC locally** — `node
-demo/smoke_<name>.mjs`. A red smoke that reaches the review costs a cycle; run
-locally it costs a minute. Precedent: on #89 a fixture error lived through a
-whole review round that a local run would have caught immediately.
-
-**One handoff, one push (#510).** Run `node scripts/process-gate.mjs --issues`
-locally with `gh` available before pushing (without `gh` the hook cannot check the
-issue status and stays silent). After `S7-code-review` do not push to the branch
-until the verdict or the return arrives: a push on top of a running review cancels
-it (10–20 runner minutes) and, after the material is fixed, also the merge (#312).
-Set `S7` once per round, not after every CI fix: the pipeline now runs Validate
-with the diff mutants on the material itself and returns a red one to `S6` without
-spending a review cycle; since #636 it does not sleep while Validate runs — the
-prepare stage leaves a sealed `review-pending` marker and exits, and the
-completion of Validate (`process-resume.yml`, `workflow_run`) re-applies `S7`
-so a fresh run finds the finished dispatch; `process-reconcile.yml` is the
-fallback for a lost event. A second `S7` from the pipeline itself is therefore
-normal and is not a new round. Mutants by diff run only where they are explicitly
-requested — the review candidate, the merge candidate (both dispatch Validate
-with `mutants=true`) and PRs (#510, #601). Ordinary pushes, the beta candidate
-(`Release:` trailer) and `full=true` do not request them: a routine push costs
-~3 minutes (08–09.09 mutants cost 48 of 56 Validate job-hours and were mostly
-cancelled by the next push), and by the beta every issue has already been
-mutated twice — on review and on the rebased merge candidate; the night runs
-the full registry (`mutation-gate.yml`), not a diff subset.
-
-**Workflows run from the default branch are thin callers (#623).** For
-`issues`, `schedule` and `workflow_run` GitHub executes the file from `main`.
-The six such files (`process.yml`, `process-resume.yml`,
-`process-reconcile.yml`, `mutation-gate.yml`, `nightly.yml`,
-`process-metrics.yml`) carry only triggers, run-name, permissions and
-concurrency and call their body `_<name>.yml` at `@dev` with
-`secrets: inherit`. A pipeline change is one commit to `dev` — edit the
-`_<name>.yml` body; no mirror into `main`, no merge-back before promotion.
-Only a change of triggers, dispatch inputs or the permission ceiling touches the
-thin file, and then it is mirrored into `main` (preflight `workflow_sync`
-compares exactly these six; `PROCESS.md` §10.4).
-
-The full smoke set, `golden` and `performance_smoke` still belong to the
-pre-beta run — which is then mandatory and complete. WSL runs of the full HA
-harness (`~/houseplan-card`, venv) are advisory; **the canon does not move**:
-the beta gate is CI at the exact SHA.
-
-**Verifying and capturing are different things (#455).** `golden:verify` is
-advisory and legal anywhere, Windows included: it reports differences and
-accepts nothing. **Capturing** frames is refused outside Linux
-before the browser even starts — `golden:capture` through
-`demo/golden/policy.mjs`, documentation screenshots through
-`npm run docs:capture` (use that script, not a bare `node
-demo/docs/capture.mjs`: the gate sits one step earlier because editing the
-capture script invalidates the committed screenshot index). The refusal prints
-the WSL command. The reason is not policy but physics: Windows
-rasterizes text through DirectWrite with different subpixel and DPI behaviour,
-so no frame ever matches an accepted baseline byte for byte, no environment
-witness can exist, and acceptance would refuse anyway (#401 accepts any
-environment that proves itself with byte-identical undeclared frames — Linux is
-simply the only one we have). The deliberate override is
-  `HP_ALLOW_FOREIGN_CAPTURE="reason"`; the reason travels into the output and the
-  manifest. Baselines are still accepted only via
-  `npm run golden:accept -- --reviewed` on a complete artefact. A local Linux
-  capture additionally requires the self-hashed WSL passport produced by
-  `npm run golden:wsl:capture`; plain `golden:capture` remains diagnostic. The
-  passport proves a clean published branch SHA, WSL/ext4, pinned toolchain,
-  current fingerprint, complete matrix, PNG hashes and witness floor. The
-  accepted index records that local provenance separately from a GitHub run,
-  and a final full GitHub Validate on the accepted exact SHA remains mandatory.
-  The one local
-shortcut is `npm run docs:accept -- --identical` (#512): it re-captures on this
-machine, compares decoded pixels with the committed frames and, only when every
-frame is identical, refreshes the manifest fingerprints — frames that differ go
-through the artefact as before. The displayed card version reaches the DOM
-through `displayVersion()` (`src/card-version.ts`); the global
-`__HP_VERSION_OVERRIDE__` behind it is for harnesses only and the product never
-sets it.
-
-**Backend.** A full Home Assistant harness cannot run on native Windows at all:
-Home Assistant imports the Unix-only `fcntl` module. Its canon is Linux CI or WSL.
-Locally only the pure subset runs; `python -m pytest tests_backend/ -q` without
-Home Assistant **does not collect** `test_ha_*.py` at all (`conftest.py`
-`collect_ignore_glob` when `homeassistant` is not importable — not a skip) and, since
-#630, prints `HA harness NOT collected: N files (M tests)` with the canon to run
-them. A green result there proves nothing about the harness. Say so in the report
-instead of claiming the backend was verified. Cloud agents have the harness
-at `.venv-backend/bin/python`.
-
-**Running the app / smoke suite**: build a fresh bundle and copy it into the demo
-assets first, then run `node demo/smoke_*.mjs`. No real Home Assistant server is
-required: `demo/srv/demo.html` stubs `hass`, registries and `callService`.
-
-**Golden images**: `npm run golden:capture` and `npm run golden:verify` refuse a
-stale demo bundle. Build and copy first, then review `artifacts/golden/actual/` and
-`diff/`. Update baselines only with `npm run golden:accept -- --reviewed`, using a
-complete Linux CI artifact or the attested artefact made in the WSL/ext4 clone by
-`npm run golden:wsl:capture`; never accept a partial scenario or images merely to
-make CI green. The local route saves the first expected-red CI round trip only:
-the accepted commit still needs a full GitHub Validate on its exact SHA. See
-`demo/golden/README.md`.
-
-**Freshness contract**: the embedded fingerprint covers `src/` plus Rollup,
-TypeScript and package-lock build inputs. Every browser check must verify it
-before trusting a result — benchmarks, golden runs and documentation captures
-call `assertFreshDemoBundle` themselves, and smokes get it from `launch()` in
-`demo/serve.mjs` (#236). A missing or mismatched fingerprint is a hard failure,
-not a warning; `HP_ALLOW_STALE_BUNDLE=1` skips the check for debugging and says
-so out loud. A smoke against a stale bundle does not fail cleanly: part of its
-assertions go red and part stay green, which reads as a logic defect.
-
-**CI is pinned to an exact SHA.** The release gate accepts only a `completed
-success` run for the candidate's SHA, not "the last green one"; a new push cancels
-an unfinished Validate for the same branch. Gate jobs, matching the actual
-`validate.yml` (#191): `docs`, `provenance`, `process-gate`, `hacs`, `hassfest`,
-`frontend`, `smoke`, `golden`, `performance_smoke`, `geometry_parity`, `backend`.
-The `changes` job
-is a service path-filter, not a gate. `docs` is a real blocker: it checks the
-screenshots `sourceFingerprint` against current `src/**`, which is exactly what
-went red after the #113 merge. A stable release additionally waits for Full
-Performance and for a green E2E run on a real Home Assistant (`houseplan-e2e`,
-dispatched on the candidate SHA by `release.yml`, #514/#540); betas and the
-development cycle never run E2E. Stable installable assets (`houseplan.zip`,
-`houseplan-card.js` and their `SHA256SUMS`) reach the public stable release only
-from `release.yml` after those gates; a release published by hand is turned back
-into a draft first (#540). The prerelease publisher additionally ships a
-candidate-bound `RELEASE-MEMBERSHIP.json` covered by the same passport (#547).
-
-**"Verified" without a named command and its result is not evidence.**
+A failed pre-release gate (golden, full smokes, performance, HA harness) does not
+send the issue back to review: fix, re-run what failed, record the exact command
+and result in the issue (`PROCESS.md` §11.4 — and its limits).
 
 ## Environments
 
-**Local Windows checkout** is the day-to-day environment: repository-pinned Node
-and Python as in CI (`npm run toolchain:check` compares the machine with the pins
-CI actually uses — `.nvmrc` and `.python-version` are derived from the same
-sources, #496),
-`gh` authenticated. On the owner's machine do not trust the ambient PATH:
-`.\scripts\windows-toolchain.ps1 setup|check` owns a verified portable Node and
-dedicated `.venv-ci`, and its `npm`/`node`/`python`/`playwright` actions are the
-explicit pinned entrypoints (#557). It changes no persistent PATH and never
-deletes a mismatched venv. In WSL, work from an ext4 clone and use
-`bash scripts/wsl-setup.sh --verify` for the real HA subset plus one Linux visual
-capture; exact-SHA Linux CI remains authoritative. `.venv-backend` does **not**
-exist there — it is provisioned only by cloud agent startup scripts, which also
-run `npm ci` and install Playwright Chromium.
-
-Known environment-sensitive smoke: `demo/smoke_opening_measure.mjs` fails two
-sub-checks (`place_dialog_x_magnetised`, `place_committed_x_center`) under the pinned
-Chromium — a `1e-6`-tolerance magnet-snap on the opening-*placement* path. It
-reproduces against the pristine committed bundle, so treat it as
-pre-existing/pixel-precision, not a regression you introduced.
-
-## Alpha experiments
-
-`src/labs.ts` is the single registry and resolver for hidden presentation
-experiments. One browser-local switch controls the complete set known to the
-installed build: `hp_alpha=1` in query or the shared hash grammar enables and
-persists it, while `hp_alpha=0` disables and persists it. Do not add per-feature
-URL/storage keys or a YAML/config switch. The legacy `hp-labs` grammar and
-`houseplan_card_labs_v1` storage are ignored and never migrated.
-
-A new registry entry needs a unique lowercase id, issue, summary and
-unit/browser coverage; it does not get `since` or `expires`. Invalid or duplicate
-entries fail closed. Alpha capabilities may alter presentation only and must not
-gate data, migrations, stores, HA actions or network calls. Current renderer
-details are in `docs/ISOMETRIC.md`.
-
-Demo harness render quirk: the fake `hass` in `demo.html` is set once, so opening the
-page directly in a browser renders the floor plan but **device icons only appear
-after a re-render** (an F5 refresh, or nudging `card.hass = {...card.hass}`). The
-smoke launcher `demo/serve.mjs` already does this nudge; a plain browser session does
-not. This is a harness limitation, not a card bug.
-
-## Promotion rule
-
-Every new feature or material behaviour change must be published as a beta/RC
-before it can enter a stable release, even when its local audit is clean. The
-stable release commit is promotion-only: version fields, generated bundle
-snapshots and changelog/release metadata. Do not add feature source code in
-that commit. An explicit owner-requested emergency hotfix is the only exception
-and must be called out in the release handoff.
-
-A `Release vX.Y.Z-beta.N candidate` commit is **not** promotion-only: it carries
-the work itself and follows the ordinary rules, trailers included.
-
-Issues are closed in a batch when a beta ships, not when implementation ends: that
-way a bug found in the beta returns to the same task, and the beta announcement can
-list what went in. The batch is immutable candidate membership proven by Git
-trailers, never the mutable S8 queue at close time; authorship does not change
-membership. Status labels are stripped as the issues close, and retries resume the
-same manifest without duplicating the release comment (#547).
+The owner's Windows machine: `.\scripts\windows-toolchain.ps1 setup|check` owns
+the pinned Node and Python; WSL works from an ext4 clone with
+`bash scripts/wsl-setup.sh --verify` (`docs/DEVELOPMENT.md` › Local Windows
+workstation). `npm run toolchain:check` compares any machine with the pins CI
+uses. The full Home Assistant harness cannot run on native Windows; without an
+importable `homeassistant` pytest does not collect `test_ha_*.py` at all, so a
+green pure run proves nothing about the harness (`docs/TESTING.md`). Cloud
+agents have the harness at `.venv-backend/bin/python`.

CONTRIBUTING.md

@@ -58,6 +58,22 @@ set; maintain the existing English and Russian documentation according to the
 project's normal rules. Right-to-left layout is a separate product project,
 because the plan canvas and editors cannot be mirrored by translations alone.
 
+## Documentation screenshots
+
+The images under `docs/images/` are produced only from synthetic data on the
+pinned Chromium in CI. A task branch does not commit them, nor the golden
+baselines: once per beta the `beta-derived.yml` workflow refreshes the
+fingerprint, the frames and the golden baselines on `dev` in one bot commit,
+accepting only the frames it was told to expect (`PROCESS.md` §8, #697). A task
+that changes visuals on purpose sets the `ci:golden` label. The manual path —
+the `Docs screenshots` workflow and `npm run docs:accept -- --reviewed
+--from=<unpacked artifact>`, or `--identical` when no pixel can move — stays
+for the release manager. Scenario version, source fingerprint and every image hash
+are recorded in the [screenshot index](docs/images/screenshots.json), and
+`node scripts/check-docs.mjs` reports a stale fingerprint: a warning on an
+ordinary push, an error on a beta candidate (a commit with a `Release:`
+trailer). The full rule is in `PROCESS.md` §8.
+
 ## Where to ask
 
 Not sure whether something is a bug, or just want to discuss an idea before
@@ -78,44 +94,47 @@ issue, but they do not replace it or maintain a separate checklist.
 
 ```bash
 git clone --filter=blob:none https://github.com/Matysh/houseplan-card && cd houseplan-card
-npm ci                    # frontend toolchain
+npm ci                    # frontend toolchain; `prepare` installs .githooks
 npm run typecheck         # tsc --noEmit (strict)
 npm test                  # node:test — pure logic, i18n parity, tap-action security
 npm run build             # tsc + rollup → dist/houseplan-card.js
-pip install pytest voluptuous && python -m pytest tests_backend -q   # pure backend tests
-npm install                # also installs .githooks through the prepare script
+pip install -r tests_backend/requirements.txt && python -m pytest tests_backend -q   # CI pins, HA harness included
 ```
 
 ### Why `--filter=blob:none` (#345)
 
-A full clone is **215 MB of `.git`**; a blobless one is **26 MB** — measured, not
-estimated. Both carry all 1611 commits and all 182 tags, so ranges, `merge-base`
-and `git diff` across history work identically; `git diff origin/dev~3..origin/dev`
-in a blobless clone takes about a second and grows `.git` by one megabyte.
-
-The difference is that historical *file contents* are fetched only if something
-actually asks for them. That matters here because 32% of the pack is documentation
-screenshots — ten PNGs re-captured 196 times — and another sizeable share is the
-committed bundle, one 1.16 MB file per product change. Almost nobody ever reads an
-old revision of either.
+A blobless clone keeps every commit and tag, so ranges, `merge-base` and
+`git diff` across history work exactly as in a full clone; only historical *file
+contents* are fetched on demand. Most of the pack is exactly such content that
+almost nobody reads again — documentation screenshots re-captured with the UI and
+the committed bundle rewritten by every release candidate — so a blobless clone
+is several times smaller. To see the numbers for your own clone, compare
+`git count-objects -vH` in a blobless and in a full one.
 
 Drop the flag if you work offline with history, or need `git log -p` over the whole
 tree repeatedly. Do **not** replace it with `--depth=1`: a shallow clone is about
 the same size but has no `merge-base`, so the process gate, `smoke-select` and
 every `origin/dev..HEAD` range stop working.
 
-The HA-harness backend tests (`tests_backend/test_ha_*.py`) need Python ≥3.13 and
-`pytest-homeassistant-custom-component home-assistant-frontend`; CI runs them on
-every push — locally they are skipped when `homeassistant` is not importable.
+The HA-harness backend tests (`tests_backend/test_ha_*.py`) need the
+repository-pinned Python (`.python-version`) and
+`pytest-homeassistant-custom-component home-assistant-frontend`; their canon is
+Linux CI or WSL (`bash scripts/wsl-setup.sh --verify`). Without an importable
+`homeassistant` they are not collected at all — not skipped — and pytest prints
+`HA harness NOT collected: …` (#630).
 
 ## Ground rules
 
 - **Docs in the same commit**: CHANGELOG entry for user-visible changes;
-  `docs/STATUS.md` for state changes; `docs/DEVELOPMENT.md` for new gotchas.
+  `docs/ARCHITECTURE.md` for changes to the data model, WS API or coordinate
+  system; `docs/STATUS.md` for state changes; `docs/DEVELOPMENT.md` for new
+  gotchas. A docs-only commit needs no trailers (`PROCESS.md` §3 п.10).
 - Every UI string goes through `src/i18n/<lang>.json`; follow the
   [Translations](#translations) flow for registry and backend parity.
-- The built card must be committed in sync: `cp dist/houseplan-card.js
-  custom_components/houseplan/frontend/` (CI compares them byte-for-byte).
+- The committed bundle changes only in a release candidate: `npm run
+  bundle:release` in a commit with a `Release:` trailer (#657). An ordinary task
+  restores it with `npm run bundle:clean` before committing — the `commit-msg`
+  hook refuses a bundle change otherwise.
 - Tap actions have a security model (locks/alarms never toggle from the plan) —
   see `resolveToggleIntent` in `src/device-toggle.ts`; don't weaken it.
 - Every commit follows the issue and trailer contract in `PROCESS.md`.
@@ -125,6 +144,5 @@ every push — locally they are skipped when `homeassistant` is not importable.
 ## Architecture
 
 Start with `docs/ARCHITECTURE.md` (data model, WS API, coordinate system) and
-`docs/STATUS.md` (current state). Release: bump the version in `package.json`,
-`manifest.json`, `const.py`, `CARD_VERSION`, tag `vX.Y.Z`, publish a GitHub release —
-the workflow attaches the card bundle.
+`docs/STATUS.md` (current state). Release mechanics live in one place:
+`docs/DEVELOPMENT.md` › Release.

PROCESS.md

@@ -3,12 +3,14 @@
 > **Статус документа: канон** (редакция 2026-08-13, ролевое уточнение
 > 2026-09-13). Решения владельца, на
 > которых он стоит: прямые коммиты в `dev` **без PR** · канон статуса — **метки**,
-> имена английские · лёгкий трек **включён** · автор и ревьюер — независимые
+> имена английские · треки `ship`/`show`/`ask` задаёт метка владельца (#695) · автор и ревьюер — независимые
 > агенты/сессии · любой агент может взять любую роль · инфраструктурные задачи
 > входят в общий флоу сразу на `S7-code-review`.
 >
-> **Область действия:** обязателен для владельца и для любого агента. Читается
-> сразу после `docs/SCOPE.md` и `AGENTS.md`, до `docs/STATUS.md`. Живёт в
+> **Область действия:** обязателен для владельца и для любого агента. Целиком
+> его читает тот, кто правит конвейер, гейты или сам процесс, — сразу после
+> `docs/SCOPE.md` и `AGENTS.md`, до `docs/STATUS.md`; автор и ревьюер входят через
+> ролевые конспекты ниже и открывают раздел канона по ссылке (#634, #701). Живёт в
 > репозитории: до августа 2026 канон лежал только в папке владельца, и свежий клон
 > его не содержал вовсе.
 >
@@ -24,8 +26,9 @@
 > метках и больше нигде: Project v2 не используется. При расхождении
 > документации с GitHub побеждает GitHub. Этот файл — единственный полный канон
 > процесса в репозитории; `AGENTS.md` — его короткое обязательное резюме, а
-> внешний `CODEX-RUNBOOK.md` — только маршрутизатор к канону и историческим
-> инструкциям. Текущие версии, состояние конкретных issue, runtime pins и списки
+> внешние `CODEX-RUNBOOK.md` и `CLAUDE.md` папки владельца — только маршрутизаторы
+> к канону и историческим инструкциям: правил в них нет, и в замер цены входа
+> (`scripts/entry-cost.mjs`) они не входят — CI их не видит (#701). Текущие версии, состояние конкретных issue, runtime pins и списки
 > jobs не копируются в производную прозу: они читаются из своих исполняемых
 > источников.
 > При расхождении этого документа с `.github/workflows/*.yml` и `scripts/*`
@@ -50,7 +53,7 @@
 | **A. Продукт** | `src/**`, `custom_components/houseplan/**/*.py`, `manifest.json`, `hacs.json`, `src/i18n/*.json`, `custom_components/**/translations/*` | **Да, обязательно.** Только из «Готово к разработке» или дальше |
 | **B. Гейты и инструменты** | `test/**`, `tests_backend/**`, `demo/**`, `scripts/**`, весь `.github/**`, `.githooks/**`, `rollup.config.mjs`, `tsconfig*.json`, `package.json`, `package-lock.json`, `pytest.ini`, `.gitignore`, `.gitattributes` | **Да.** Может использовать issue того изменения, которое покрывает; самостоятельная работа над гейтом получает свой issue (тип `tech-debt`) |
 | **C. Документация** | `docs/**`, `README*`, `CHANGELOG*`, `AGENTS.md`, `CONTRIBUTING.md`, `PROCESS*.md`, `LICENSE`, `(CODE\|SPEC)-REVIEW-*.md` | Документирование A/B в том же коммите — часть DoD своего issue. Самостоятельная работа над документацией — свой issue |
-| **D. Сгенерированное** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**` (копия стенда `demo/srv/assets/houseplan-card.js` с #255 не коммитится вовсе) | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью |
+| **D. Сгенерированное** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**` (копия стенда `demo/srv/assets/houseplan-card.js` с #255 не коммитится вовсе) | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью. **Бандл** (`dist/**`, `custom_components/houseplan/frontend/**`) с #657 меняет только коммит с трейлером `Release:` — кандидат беты или релиза (`npm run bundle:release`); в обычной задаче закоммиченный бандл законно отстаёт от исходников, сборка в коммит не идёт (`npm run bundle:clean`). Судит `validate-commit-provenance.mjs` — хук `commit-msg` и история в CI |
 
 Практический смысл таблицы: «я только поправил тест» и «я только пересобрал
 бандл» перестают быть лазейками.
@@ -93,8 +96,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
        → S6-in-progress → S7-code-review ⟲ → S8-merged → закрыт при выпуске беты
 
 служебные:  blocked (поверх статуса)   rejected (закрыт)
-⟲ — возврат на правки, не более 4 циклов (§4), на лёгком и коротком треке 2
-короткий трек (`trivial`, §5.1) идёт S2-analysis → S5-ready, минуя S3 и S4
+⟲ — возврат на правки, не более 4 циклов (§4), на треке `show` 2
+трек `show` (§5) идёт S2-analysis → S5-ready, минуя S3 и S4
+трек `ship` (§5) идёт S1-new → S5-ready, минуя S2, S3 и S4
 инфраструктурный трек (§1): без S → S7-code-review ⟲ S6-in-progress → S8-merged
 ```
 
@@ -125,9 +129,10 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   5. приоритет **P1/P2/P3**;
   6. тип: баг / фича / техдолг;
   7. затронутые поверхности (модули, диалоги, бэкенд, i18n);
-  8. трек — **по умолчанию `small`** (§5). Если задача идёт полным треком,
-     называется критерий §5, который она не проходит: «обычный трек» без
-     названного критерия обоснованием не является.
+  8. трек — метка `track:ship`, `track:show` или `track:ask` (§5), **по
+     умолчанию `track:show`**. Для `track:ask` называется критерий §5, которого
+     задача не проходит; `track:ship` предлагается, когда правка описывается
+     одним предложением. Метка владельца главнее предложения аналитика.
 - **Оценки и приоритет ставятся метками сразу, согласие не запрашивается.**
   Комментарий аналитики — уведомление, а не запрос: **молчание владельца —
   согласие**, несогласие он выражает правкой меток или комментарием, и это не
@@ -139,7 +144,8 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   умолчанию и `blocked`. Вопрос, который можно отложить до ТЗ, не задаётся в
   аналитике; вопрос, не блокирующий написание ТЗ, не задаётся вовсе — вместо
   него в ТЗ пишется блок принятых предположений.
-- **Выход:** `S3-spec` — переход выполняет сам аналитик, не дожидаясь ответа.
+- **Выход:** на `track:ask` — `S3-spec`, на `track:show` — `S5-ready` после AC в
+  теле issue (§5); переход выполняет сам аналитик, не дожидаясь ответа.
   Либо, при явном конфликте со `SCOPE.md`, — предложение отклонить с причиной:
   это единственный случай, когда аналитика останавливается и ждёт владельца.
 
@@ -159,7 +165,7 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 - **Ревьюер ≠ автор.** Ревьюер получает issue и ТЗ, без устных пояснений автора.
   Его задача — не согласиться, а найти, где ТЗ не выполнимо или не проверяемо.
 - **Артефакт:** `docs/reviews/SPEC-REVIEW-<NN>-r<N>.md`, вердикт
-  зелёный / жёлтый / красный. Лёгкий трек — комментарий в issue.
+  зелёный / жёлтый / красный. Ревью ТЗ проходит только трек `ask` (§5).
 - **High-находки блокируют.** Medium **в скоупе задачи** чинится в текущем
   issue: без High это жёлтый вердикт, автор правит ТЗ, фикс проходит повторный
   цикл. Medium **вне скоупа** — отдельный issue: чужой скоуп в этой задаче не
@@ -174,7 +180,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 Не работа, а **очередь**: единственный статус, из которого можно трогать код.
 Все пункты обязательны:
 
-- ТЗ существует, ревью ТЗ зелёное, ссылки issue ↔ ТЗ на месте;
+- ТЗ существует, на `track:ask` ревью ТЗ зелёное, ссылки issue ↔ ТЗ на месте.
+  На `ship` и `show` ТЗ — в объёме §5, а пункты ниже закрываются одним словом
+  «нет»: критерии трека их исключают, иначе это `track:ask`;
 - **AC1…ACn** — пронумерованные проверяемые критерии приёмки; у каждого указано,
   чем он доказывается: `unit` / `backend` / `smoke` / `golden` / «ревью кода»;
 - перечислены затронутые файлы и модули;
@@ -196,8 +204,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   «Взял: <роль> · сессия <id> · ветка `issue/<NN>-<slug>`».
 - **WIP-лимиты:** не более **1** issue в «В разработке» на исполнителя, не более
   **3** одновременно на цикл релиза, не более **2** в «Код-ревью».
-- **Трассируемость:** ветка `issue/<NN>-<slug>`; каждый коммит несёт трейлеры
-  `Issue: #<NN>` и `User-Visible: yes|no`.
+- **Трассируемость:** ветка `issue/<NN>-<slug>`; каждый коммит с файлами классов A, B или D несёт трейлеры
+  `Issue: #<NN>` и `User-Visible: yes|no`; коммит только из документации — без
+  трейлеров (§3 п.10, #701).
 - **Автотесты — часть реализации, а не отдельная фаза.** Каждый AC, помеченный
   `unit`/`backend`/`smoke`/`golden`, получает свою проверку здесь же.
   «Тестирование вне жизненного цикла» означает отсутствие фазы ручного
@@ -215,9 +224,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 - **Скоуп не расширяется.** Найденное по пути становится новым issue в «Новое».
   Если находка блокирует — текущий issue уходит в «Заблокировано» со ссылкой.
   Попутных правок «раз уж я здесь» не бывает.
-- **Документация — в том же коммите,** что и поведение (действующая политика
-  `docs/STATUS.md`): changelog RU+EN для пользовательского, `STATUS.md` для
-  состояния, `DEVELOPMENT.md` для новых грабель, `ARCHITECTURE.md` для дизайна.
+- **Документация — в том же коммите,** что и поведение: changelog RU+EN для
+  пользовательского, `STATUS.md` для состояния, `DEVELOPMENT.md` для новых
+  грабель, `ARCHITECTURE.md` для дизайна.
 - **Выход:** локальный гейт зелёный (§8), хендофф-комментарий (§7.2).
 
 ### 2.7 Код-ревью
@@ -246,11 +255,21 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   а два теста были записаны в закрытие coverage-ratchet под именами, обещавшими
   то, чего они не проверяли (#430).
 
-  Мутант в `scripts/mutation-gate.mjs` обязателен, когда защита живёт в
+  Мутант в реестре `scripts/mutation-registry.mjs` обязателен, когда защита живёт в
   продуктовом коде и проверяется дорогим гейтом (смок, бэкенд, golden): там
   ревьюер не воспроизведёт отрицательный прогон второй раз. Для чистых юнитов
   достаточно прогона со снятой защитой, приведённого в документе.
 
+  Новый мутант с browser-smoke guard допустим только когда инвариант нельзя
+  доказать без браузера: `because` обязан назвать конкретную зависимость от
+  DOM/CSS paint, измеренной геометрии, trusted pointer/lifecycle или browser
+  wall-time, а id — попасть в размеченный реестр
+  `docs/testing-notes/mutation-browser-guards.md`. `mutation-gate --check`
+  показывает число browser guards против ориентира 200 и предупреждает — не
+  краснеет (#699) — при росте выше него и о любом id без browser-обоснования;
+  удалять чужой мутант ради числа не нужно; ревьюер проверяет
+  не только наличие строки, но и невозможность более дешёвого `node --test`.
+
   Считаются **защитные AC без названного свидетеля**, а не мутанты на
   подсистему: у #421 мутанты были, и дыра всё равно проехала. «Сколько мутантов
   принесла задача» остаётся признаком — у #423 их ноль, и именно у #423 нашёлся
@@ -264,7 +283,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   видит разницу.
 - **High блокируют.** Medium **в скоупе задачи** чинится в текущем issue:
   без High это жёлтый вердикт и возврат автору, фикс проходит повторный цикл.
-  Medium **вне скоупа** — отдельный issue (#202).
+  Medium **вне скоупа** — отдельный issue (#202). Жёлтый вердикт законен и
+  тогда, когда все AC выполнены, если изменение не решает заявленный сценарий
+  или ухудшает соседний.
 - **Вердикт привязан к SHA (#312).** Все числа и факты отчёта сверяются с
   `git rev-parse HEAD` непосредственно перед подведением итогов, а не с SHA,
   зафиксированным в начале разбора: во время ревью в ветку может прилететь
@@ -277,16 +298,24 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   вызовом в `test-build`, а не поиском строки в исходнике: текстовый якорь
   краснеет на переносе метода без единой регрессии, и это делает вынос дороже,
   чем оставить монолит как есть. Список тестов, читающих монолит как текст,
-  заморожен (`test/monolith-text-anchors.test.mjs`, 54 файла на 23.09.2026) и
-  может только уменьшаться; новое имя в нём — находка ревью, а не запись в
+  заморожен (`FROZEN_TEXT_ANCHOR_TESTS` в `test/monolith-text-anchors.test.mjs`)
+  и может только уменьшаться; новое имя в нём — находка ревью, а не запись в
   список. Связность монолита измеряется шестью числами
   (`scripts/monolith-metrics.mjs`: делегаты, члены порта, `host.`, приватные
   члены порта и харнесса, байты `dist/`), база — `scripts/monolith-baseline.json`;
   гейт `npm run lint:unused` (в `gate:small` и Validate после сборки) красит
-  рост любого из них и любой мёртвый код по `noUnusedLocals` вне порта и
-  харнесса. Снижение фиксируется тем же коммитом
-  (`node scripts/unused-locals-gate.mjs --update`); рост — только с записью в
+  рост любого из них сверх полосы (#699: делегаты, члены и приватные порта и
+  харнесса — 5, `host.` — 25, байты `dist/` — 2 000) и любой мёртвый код по
+  `noUnusedLocals` вне порта и харнесса. Снижение ветку не красит — базу до
+  факта опускает бета (§8, «Храповики»); рост сверх полосы — только с записью в
   issue задачи и правкой базы в том же коммите.
+- **Смок входит в сценарий через публичную поверхность (#629).** DOM с
+  контрактными хуками, события HA и фикстуры, тестовый фасад `window.__hpTest`
+  (`docs/TESTING.md`, «Тестовый фасад и приватное состояние»). Приватное поле
+  карточки — только для чтения в ассертах. Новая запись в него без
+  `// private-ok: <конкретная причина>` — находка ревью, даже если гейт
+  `no-new-private-writes` её не увидел (мутация через вызов, запись через
+  псевдоним).
 - **Выход:** очередь на пре-релиз либо возврат в «В разработке», не более
   4 циклов (§4). Второй и последующие циклы разбираются по дельте (§2.10).
 
@@ -342,10 +371,10 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 
    Находкой остаётся другое: **SHA, мёртвый уже в момент публикации отчёта** —
    он означает, что значение сняли до `amend` или `rebase` и не сверили перед
-   выводом, как требует §7.2. Это отличие не теоретическое: на #403 оба
-   источника, автор и ревьюер, независимо назвали один и тот же осиротевший
-   SHA, и следующий раунд восстанавливал коммит по содержимому диффа руками
-   (issue #413). Конвейер теперь такую публикацию останавливает сам;
+   выводом, как требует §2.7 («Вердикт привязан к SHA»). Это отличие не
+   теоретическое: на #403 оба источника, автор и ревьюер, независимо назвали один
+   и тот же осиротевший SHA, и следующий раунд восстанавливал коммит по
+   содержимому диффа руками (issue #413). Конвейер теперь такую публикацию останавливает сам;
 3. по каждой находке предыдущего раунда показать, **чем именно она закрыта** —
    строкой кода или текста, а не заявлением автора;
 4. заново проверять только те AC, чьё доказательство дельта задевает;
@@ -356,19 +385,32 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 **Индекс документов ревью** — `docs/reviews/INDEX.md` (#635): одна строка на
 документ — issue, этап, раунд, вердикт, число High/Medium, заголовки находок,
 файлы из находок (искать по имени файла: `grep form-kit docs/reviews/INDEX.md`).
-Файл генерируется `node scripts/reviews-index.mjs` и пересобирается конвейером
-тем же коммитом, что публикует документ, а также после каждого его ребейза
-(приведение к dev перед ревью, слияние кандидата — `--commit-if-stale`, коммит
-класса C); руками не правится. Конфликт ребейза, в котором **все** пути —
+Файл генерируется `node scripts/reviews-index.mjs` и пересобирается **только
+коммитами, идущими в `dev`** (#657, решение 1б): слиянием кандидата —
+после ребейза, а если `dev` не двигался, то поверх материала перед
+fast-forward (`--commit-if-stale`, коммит класса C) — и публикацией документа ревью ТЗ
+прямо в `dev`. В ветке задачи индекс не пересобирается — ни при приведении к
+dev, ни при публикации документа код-ревью: иначе две параллельные задачи
+конфликтуют на нём по построению. Сам `INDEX.md` руками не правится никогда. Конфликт ребейза, в котором **все** пути —
 `INDEX.md`, отказом не считается (#643): `scripts/rebase-generated.mjs`
 пересобирает индекс по каталогу на остановке и продолжает ребейз — так делают
 приведение к dev, слияние кандидата и авторский `rebase-on-dev.mjs`; индекс
-вместе с любым другим путём — прежний отказ с перечнем файлов. Шаг Validate
+вместе с любым другим путём — прежний отказ с перечнем файлов. Ещё два общих
+файла не конфликтуют по смыслу (#698): записи ченджлогов в `## Unreleased`
+объединяет встроенный драйвер `merge=union` (`.gitattributes`), а на конфликте в
+`scripts/monolith-baseline.json` ребейз берёт сторону `dev` — числа
+объединённого дерева судит гейт связности монолита (`npm run lint:unused`) на
+Validate кандидата. Сегодня пять чисел исходника он судит точно, байты `dist/` —
+с полосой 2 000 Б; поэтому сторона `dev` в базе краснеет, если задача сама
+меняла эти числа, — это прежний возврат автору, только после Validate, а не до
+ревью. Полоса у всех шести чисел — #699. Ни ченджлоги, ни база не входят в
+patch-id кандидата слияния: вердикт к работе задачи остаётся в силе. Шаг Validate
 «индекс ревью совпадает с каталогом» красит push в `dev`, где `INDEX.md`
 расходится с каталогом (на issue-ветках не судится: их переписывает конвейер).
-Правка `docs/reviews/`
-руками — перенос в `legacy/`, удаление — сопровождается
-`node scripts/reviews-index.mjs` в том же коммите. Прежде чем брать
+Ручная правка каталога
+`docs/reviews/` — перенос документов в `legacy/`, удаление — сопровождается
+пересборкой индекса `node scripts/reviews-index.mjs` в том же коммите: индекс
+меняет генератор, а не рука. Прежде чем брать
 задачу по подсистеме, стоит прочитать её строки в индексе: что находили и чем
 закрывали — там, а не в тысяче файлов. Уроки, пережившие свою задачу,
 собираются в `docs/LESSONS.md` с датой и ссылкой на источник.
@@ -376,16 +418,28 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 **Хранение документов** (решение владельца 23.09, #635): в `docs/reviews/`
 лежат все раунды всех задач текущей линии — предыдущие раунды нужны ссылкам
 «Унаследовано из r<N−1>» и якорям материала. При стабильном релизе документы
-задач, вошедших в него (`RELEASE-MEMBERSHIP.json` линии), переносятся в
-`legacy/reviews/<vX.Y.Z>/` одним коммитом класса C; индекс пересобирается и
-перечисляет только живые. Перенос — часть чеклиста стабильного релиза, не
-отдельная задача.
+задач, вошедших в него, переносятся в `legacy/reviews/<vX.Y.Z>/` одним
+коммитом класса C; индекс пересобирается и перечисляет только живые. Перенос —
+часть чеклиста стабильного релиза, не отдельная задача, и делает его
+`node scripts/reviews-archive.mjs --through=vX.Y.Z` (без `--apply` — только
+план, #682). Членство — трейлеры `Issue: #NN` в диапазоне линии, как у
+манифеста беты и ревью линии (§11.5); метка не доказательство. Уточнения:
+задача с трейлером и после тега остаётся в `docs/reviews/` целиком — её раунды
+ещё продолжаются; задача с трейлерами в двух выпущенных линиях уезжает целиком
+в последнюю; закрытая без выпуска (как #522) уезжает с линией, где лёг её
+документ — коммит документа несёт трейлер; `RELEASE-REVIEW-vX.Y.Z.md` уходит в
+каталог своего тега, поэтому перенос делается после публикации ревью линии.
+Относительные ссылки в перенесённых документах и в соседях, которые на них
+ссылаются, инструмент переписывает сам; `--check-links` печатает оставшиеся
+битые.
+Перенос идёт при пустой очереди `S7-code-review`: ребейз чужой ветки иначе
+упрётся в перемещённый каталог.
 
-Дешёвые гейты (`typecheck`, `test`, `build` со сверкой копий бандла) гоняются в
+Дешёвые гейты (`typecheck`, `test`, `build` с проверкой целостности сборки, `bundle-policy --verify`) гоняются в
 каждом раунде: код изменился, а стоят они минуты. Тяжёлые — по дельте (§10.2).
 
 **Разбор остаётся полным**, если дельта не локальна: ребейз на ушедший вперёд
-`dev` (после ребейза это другой код, §7.2), смена контракта поведения, задета
+`dev` (после ребейза это другой код, §10.4), смена контракта поведения, задета
 новая подсистема, либо объём дельты сопоставим с исходной задачей.
 
 Сокращается объём **разбора, а не строгость**: правка по замечанию способна
@@ -401,8 +455,10 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 
 1. **Никаких изменений в код, если нет issue** и он не помечен «Готово к
    разработке» или дальше.
-2. **Issue не может быть взят в разработку**, пока у него нет ТЗ с зелёным ревью,
-   пронумерованных AC с указанием доказательства и назначенного исполнителя.
+2. **Issue не может быть взят в разработку**, пока у него нет ТЗ в объёме трека
+   (§5: на `track:ask` — с зелёным ревью ТЗ; на `show` — до трёх AC; на `ship` —
+   строка «что меняется и чем проверить»), доказательства для каждого AC и
+   назначенного исполнителя. Инфраструктурная задача ТЗ не пишет (§1).
 3. **Issue не может быть взят дважды.** Занятие фиксируется назначением, меткой и
    комментарием с именем ветки. У одного исполнителя одновременно не более одного
    issue в разработке.
@@ -422,20 +478,24 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
    правка. Блокирующая находка отправляет текущий issue в «Заблокировано».
 10. **Каждый коммит класса A и B несёт трейлер `Issue: #NN`**, ветка называется
     `issue/NN-slug`, а `User-Visible: yes` требует правок в **обоих** changelog в
-    том же коммите. После `cherry-pick -x` служебная строка `(cherry picked
+    том же коммите. Документационный коммит — только файлы класса C — трейлеров
+    не требует (#701, как `skip issue` у CPython); хук `commit-msg`, CI и
+    `process-gate` судят одинаково. Коммит класса D несёт `Release:` (п.12). После `cherry-pick -x` служебная строка `(cherry picked
     from ...)` должна оставаться выше финального блока трейлеров: перед push
     проверяем порядок через `git show -s --format=full HEAD`.
 11. **Документация — в том же коммите, что поведение.** Отдельным «допишу потом»
     коммитом документация не бывает.
 12. **Сгенерированное не коммитится само по себе.** Только релизный промоушен или
-    принятие эталонов с доказательством ревью: URL Linux CI run либо хеш
-    аттестованного WSL-артефакта.
+    принятие эталонов с доказательством ревью: трейлер `Release:` и ровно один
+    источник — URL Linux CI run (`Baseline-Reviewed:`) либо хеш аттестованного
+    WSL-артефакта (`Baseline-Reviewed-Local:`), §10.1.
 13. **Golden-эталоны принимаются только** `npm run golden:accept -- --reviewed` по
     полному Linux-артефакту: либо GitHub CI, либо `npm run golden:wsl:capture` в
     WSL/ext4 с clean опубликованным SHA и машинно-проверяемым паспортом. Второй
     путь убирает только первый ожидаемо красный CI-прогон; полный GitHub Validate
     на точном SHA коммита с эталонами остаётся обязательным. Принятие ради
-    зелёного CI — нарушение процесса.
+    зелёного CI — нарушение процесса. Где принимаются эталоны — §8: на `dev`
+    одним коммитом на бету, в задаче — только с меткой `ci:golden` (#697).
 14. **Issue закрывается после выпуска беты** с зелёным CI на точном SHA. Не
     раньше, не «по факту наличия кода», не исполнителем.
 15. **Закрытый issue не переоткрывается.** Новый дефект — новый issue со ссылкой.
@@ -468,8 +528,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 - **Заход и цикл — разные величины.** Заход — сколько раз ревью отработало; он
   виден в имени документа (`-r1`, `-r2`, …) и нужен, чтобы два документа не
   затёрли друг друга. Цикл — единица бюджета §4. Заходов законно бывает больше,
-  чем циклов, поэтому порог проверки 7 в `scripts/process-gate.mjs` выше лимита
-  циклов (шесть документов = четыре цикла плюс два ребейза).
+  чем циклов, поэтому порог проверки №7 в `scripts/process-gate.mjs`
+  (`REVIEW_DOC_LIMIT` — шесть документов одного вида на issue) выше лимита
+  циклов: четыре цикла плюс два ребейза.
 - Метка `review-4` ставится, когда исчерпан **бюджет циклов**; конвейер снимать
   её не вправе — это решение владельца. Если бюджет пересчитан и оказался ниже
   лимита, конвейер сообщает пересчёт, но метку не трогает.
@@ -483,90 +544,90 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 - **Граница между «циклом» и «новым багом»:** до закрытия беты находка ревьюера —
   возврат на правки; после закрытия — новый issue. Иначе лимит 4 обходится
   заведением issue вместо возврата.
-- Для лёгкого трека лимит ревью ТЗ — **2** цикла: задача на три часа, которую
-  переписывают трижды, лёгкой не была.
+- На треке `show` лимит код-ревью — **2** цикла, ревью ТЗ на нём нет (§5):
+  задача на три часа, которую переписывают трижды, лёгкой не была.
 
 ---
 
-## 5. Лёгкий трек (метка `small`) — путь по умолчанию
+## 5. Треки `ship`, `show`, `ask` — метка владельца
 
-Умолчание изменено решением владельца 2026-08-27, issue #338. Прежде полный трек
-был бесплатен, а выбор лёгкого требовал обоснования. Фактическая цена: **2.9
-ревью-документа на задачу** в среднем и до шести на одну issue (#329, #316,
-#290) — при том что Medium-находки всё равно чинятся в той же задаче, без
-отдельного цикла.
+Решение владельца 2026-09-28, issue #695. Разбор 85 закрытых задач #600–#691
+показал, что прежний лёгкий трек (`small`) стоил почти столько же, сколько
+полный: медиана 115 мин и 12 событий против 102 мин и 13. Дешевле был только
+короткий (`trivial`) — 41 мин и 5 событий. Трек определялся формальными
+критериями, и у владельца не было метки, чтобы задать его самому.
 
-**Порог не изменился.** Критерии ниже те же и по-прежнему обязательны все
-одновременно. Изменилась сторона доказательства: теперь обосновывается не выбор
-лёгкого трека, а отказ от него — в `S2-analysis` называется критерий, который
-задача не проходит. Полный трек остаётся тем, чем был, для геометрии, миграций
-конфига и публичных контрактов: там критерии нарушаются сами, и назвать
-нарушенный несложно.
+**Трек задаёт метка `track:ship`, `track:show` или `track:ask`. Метка владельца
+главнее критериев:** критерии ниже — подсказка аналитика, а не приговор.
 
-Инверсия умолчания не отменяет ничего из §5 ниже и ничего из §4: бюджет четырёх
-циклов, арбитраж владельца, обязательность ТЗ на полном треке и правило «ревью
-до мержа» остаются как были. Меняется только стоимость пути по умолчанию.
+- Аналитик предлагает трек в «Оценке» (§7.2) и ставит метку. По умолчанию —
+  `track:show`.
+- Владелец ставит или меняет любую из трёх меток в любой момент; его метка
+  окончательна.
+- Повысить трек (`ship` → `show` → `ask`) вправе любой агент, с причиной в
+  комментарии. Понизить — только владелец.
+- Трек пересматривается, когда владелец снял усложнявший пункт (#688):
+  аналитик предлагает понижение, решает владелец.
 
-**Критерии — все одновременно; нарушенный называется явно:**
+| | `track:ship` | `track:show` | `track:ask` |
+|---|---|---|---|
+| Для чего | документация, текст, очевидная правка в несколько строк, CSS-мелочь | баг и полировка в рамках описанного поведения; инфраструктура (§1) по умолчанию | геометрия, миграции конфига, публичные контракты, перф и touch, новый UX-контракт |
+| Маршрут | `S1-new` → `S5-ready` → `S6` → `S7` → `S8` | `S1-new` → `S2-analysis` → `S5-ready` → `S6` → `S7` → `S8` | полный, §2 |
+| ТЗ | строка «что меняется и чем проверить» в теле issue под `## ТЗ` | «Оценка» (§7.2) и до трёх AC в теле issue под `## ТЗ` | полное ТЗ по §7.1 |
+| Ревью ТЗ | нет | нет | да, лимит 4 цикла |
+| Локальный гейт | `npm run gate:small` | `npm run gate:small` плюс смоуки `smoke-select` и AC | §8 |
+| Код-ревью | до слияния нет; пакетное ревью диапазона перед бетой | модель: корректность и AC | документ ревью, как в §2.7 |
+| Лимит циклов код-ревью | — | 2 | 4 |
+
+**Рамки `track:ship`** механические: дифф `src/**` не больше 30 строк, без новых
+файлов в `src/**`, без ключей i18n, без полей конфига и без Python. Выход за
+рамки переводит задачу в `track:show`. Рамки и слияние `ship` без ревью модели
+проверяет и исполняет конвейер (§10.4, #696); код `ship` читает пакетное ревью
+диапазона перед бетой (§11.7).
+
+**Подсказка аналитику.** `track:show` уместен, когда выполнено всё сразу:
 
 - сложность и риск ≤ 3;
 - одна поверхность (один диалог, один модуль, один эндпоинт);
 - нет миграции конфига и новых compatibility-полей;
 - нет нового UX-контракта — меняется поведение в рамках уже описанного;
-- нет влияния на производительность и на touch-контракт.
-
-**Что упрощается:**
-
-- ТЗ короче: проблема · контракт · AC1…ACn с доказательством · откат
-  (в теле issue, как и на полном треке с 2026-09-10);
-- ревью ТЗ — комментарий второго агента, отдельный документ не нужен;
-- лимит ревью ТЗ — 2 цикла.
-
-**Что не упрощается:** issue, оценка, статусы, трейлеры коммитов, changelog,
-**код-ревью и его документ**, закрытие после беты. Код-ревью не пропускается:
-оно проверяет скоуп, риски и качество доказательств, но не заменяет исполнение
-тестов. Единственное исключение из повторного ревью — починка упавшего
-предрелизного гейта, §11.4.
-
-Если по ходу выясняется, что критерий нарушен (появилась миграция, задело второй
-модуль) — метка `small` снимается, issue возвращается в `S3-spec` и получает
-полное ТЗ в теле issue по §7.1. Это не провал, это ранняя диагностика.
-
-### 5.1 Короткий трек (метка `trivial`)
-
-Решение владельца 2026-08-13, issue #128. Лёгкий трек делает ТЗ дешёвым; короткий
-обходится без него совсем.
-
-**Маршрут:** `S1-new` → `S2-analysis` → `S5-ready` → `S6-in-progress` →
-`S7-code-review` → `S8-merged`. Стадии `S3-spec` и `S4-spec-review` пропускаются.
-
-`S2-analysis` остаётся: это комментарий, а не прогон CI, и именно там владелец
-решает приоритет и ценность. AC пишет автор в теле issue при переводе в
-`S5-ready` — до перехода, иначе ревьюеру нечего будет сверять.
-
-**Критерии, все обязательны:**
-
-- тип `bug`;
-- правка ограничена одной поверхностью, нового UX-контракта нет;
-- нет миграции конфига, новых ключей i18n, влияния на перф и touch;
-- AC выражаются тремя проверяемыми утверждениями или меньше;
+- нет влияния на производительность и на touch-контракт;
 - **ожидаемое поведение уже зафиксировано** — в `docs/USER-GUIDE.ru.md`, в
   каноническом документе подсистемы либо однозначно в самом отчёте. Решать нечего.
-  Если есть что решать, это `S3-spec`, и никакая экономия этого не отменяет.
 
-Метка ставится в `S2-analysis` вместе с остальными оценками, одним комментарием,
-где владелец утверждает и приоритет.
+Невыполненный пункт — повод предложить `track:ask` с названным критерием.
+`track:ship` — когда правку можно описать одним предложением и она укладывается
+в рамки выше.
 
-**Что не упрощается:** issue, оценка, статусы, трейлеры, changelog и **код-ревью**.
-Лимит циклов код-ревью — 2, как на лёгком треке.
-
-Если по ходу выясняется, что критерий нарушен, метка снимается и issue уходит в
-`S3-spec` за нормальным ТЗ. Как и на лёгком треке, это не провал, а ранняя
+**Чем опасны `show` и `ship`.** Они убирают место, где решение проверялось до
+написания кода. Признак «решать нечего» держит всю конструкцию, и его нельзя
+подтверждать ощущением — только ссылкой на уже зафиксированное поведение. Если по
+ходу выясняется, что решать есть что, трек повышается до `ask`: issue уходит в
+`S3-spec` и получает полное ТЗ в теле issue по §7.1. Это не провал, а ранняя
 диагностика.
 
-**Чем этот трек опасен.** Он убирает единственное место, где решение проверялось
-до написания кода. Признак «решать нечего» держит всю конструкцию, и его нельзя
-подтверждать ощущением — только ссылкой на уже зафиксированное поведение.
+**Что не меняется ни на одном треке:** issue и правило №1 (§1), трейлеры
+коммитов, changelog для видимого изменения, зелёный Validate на точном SHA тега
+беты (§8), гейты стабильного релиза. Качество держится на `dev` и на кандидате
+беты, а не на каждой ветке.
+
+### 5.1 Метки тяжёлых проверок и прежние метки
+
+Тяжёлые проверки заказываются метками на любом треке — ставит владелец или
+автор с причиной в комментарии:
+
+| Метка | Что включает |
+|---|---|
+| `ci:full` | полный Validate на ветке задачи |
+| `ci:golden` | golden на ветке и приёмку сдвинутых кадров в самой задаче |
+| `ci:mutants` | мутанты по диффу на кандидате ревью и слияния |
+
+Как конвейер читает метки, описывает §10.4: `ci:mutants` (#696), `ci:full` и
+`ci:golden` — dispatch Validate с `full=true` на материале ревью (#697).
+
+**Прежние метки.** `trivial` и `small` читаются как `track:show`; продуктовая
+задача без трековой метки — как `track:ask`; инфраструктурная задача (§1) без
+трековой метки — как `track:show`. Новые задачи получают только `track:*`.
 
 ---
 
@@ -580,7 +641,7 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 | Аналитик | разбор, оценки, поверхности | окончательно ставить приоритет |
 | Автор ТЗ | раздел `## ТЗ` в теле issue | ревьюить своё ТЗ |
 | Ревьюер ТЗ | `docs/reviews/SPEC-REVIEW-NN-rN.md` | править ТЗ вместо автора |
-| Разработчик | код, автотесты, документация, changelog | ревьюить свой код, принимать golden |
+| Разработчик | код, автотесты, документация, changelog | ревьюить свой код; принимать golden — кроме сдвига своей задачи с меткой `ci:golden` по §3 п.13 (§8, #697) |
 | Ревьюер кода | `docs/reviews/CODE-REVIEW-*-rN.md`, проверка AC | править продуктовый код |
 | Релиз-менеджер | пре-релиз, стабильный релиз, закрытие issue | добавлять код в релизный коммит |
 | Владелец | приоритет, ценность, скоуп, отклонение, арбитраж, хотфикс | — |
@@ -610,7 +671,7 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 ```
 issue #NN
   ↔ ТЗ            тело issue, раздел `## ТЗ`         (хеш тела — в якорях ревью)
-  ↔ ревью ТЗ      docs/reviews/SPEC-REVIEW-NN-rN.md  (или комментарий при `small`)
+  ↔ ревью ТЗ      docs/reviews/SPEC-REVIEW-NN-rN.md  (только `track:ask`)
   ↔ ветка         issue/NN-slug
   ↔ коммиты       трейлеры  Issue: #NN · User-Visible: yes|no
   ↔ ревью кода    docs/reviews/CODE-REVIEW-<tag|NN>-rN.md
@@ -662,7 +723,7 @@ issue #NN
 Короткие и однообразные, чтобы читались и человеком, и машиной.
 
 - **Аналитика:** `Оценка: ценность N/10 · сложность N/10 · P<1-3> · тип ·
-  поверхности: … · дубликаты: … · лёгкий трек: да/нет`
+  поверхности: … · дубликаты: … · трек: ship/show/ask (причина)`
 - **Занятие:** `Взял: <роль> · сессия <id> · ветка issue/NN-slug`
 - **Хендофф:** `Сделано: … · Файлы: … · Гейты: <команда → результат> ·
   НЕ сделано: … · Риски: … · Следующий статус: … · Новые issue: #…`
@@ -680,33 +741,30 @@ issue #NN
 прогон показал, почему это неверно: жёлтый там означал, что AC описывает неверное
 изменение контракта — реализовать такое ТЗ значило бы сделать ошибку по инструкции.
 
-### 7.3 Расхождения с текущим состоянием, которые надо закрыть
-
-1. ✅ **Статус ТЗ дублировал статус issue.** Закрыто 2026-09-10 (#517): ТЗ живёт
-   в теле issue, `docs/specs/` — архив, индекс с колонкой «Статус ТЗ» удалён
-   вместе с самой таблицей. Статус задачи — только метка `S*`.
-2. **Ревью до релиза 1.62 живут вне репозитория.** Документы `CODE-REVIEW-*.md` и
-   `SPEC-REVIEW-*.md` за прежний период лежат в папке владельца, и переносить их
-   задним числом смысла нет: они описывают код, которого уже нет. Новые документы
-   ревью кладёт в `docs/reviews/` сам конвейер, в ветку задачи.
-
 ---
 
 ## 8. Гейты
 
 **Локальный гейт перед выходом из «В разработке»** — минимальный набор,
-покрывающий изменённые поверхности (действующее правило владельца):
+покрывающий изменённые поверхности (действующее правило владельца).
+Обязательную часть исполняет одна команда, `npm run gate:small`
+(`scripts/gate-small.mjs` — единственный источник её состава, #701): сборка с
+typecheck, юниты, целостность и бюджет бандла, `no-new-any`, запрет синхронного
+чтения layout в render, запрет записи смоков в приватное состояние,
+`lint:unused` и вывод `smoke-select`. Команды ниже — то же самое по отдельности
+плюс то, что по диффу и AC:
 
 ```
+npm run gate:small                    # обязательная часть одной командой
 npx tsc --noEmit
 npm test
-npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js \
-              # копия стенда собирается `npm run bundle:sync`, в репозитории её нет (#255)
+npm run build && node scripts/bundle-policy.mjs --verify HEAD
+              # сборка цела; копии сверяются только на кандидате (#657).
+              # Копия стенда — `npm run bundle:sync` (#255); перед коммитом `npm run bundle:clean`
 node scripts/smoke-select.mjs --base origin/dev --head HEAD   # какие смоки относятся к диффу
 node demo/smoke_<целевые>.mjs
 node scripts/no-new-any.mjs --base origin/dev --head HEAD     # новый код не добавляет any
-npm run golden:verify                 # если менялся визуал
-node scripts/check-docs.mjs           # если менялся src/**
+npm run golden:verify                 # только с меткой ci:golden (#697)
 node scripts/model-invariants.mjs --config <экспорт>   # если правилась геометрия или ссылки
 python -m pytest tests_backend -q     # py3.14 как в CI (npm run toolchain:check), если менялся бэкенд
 npx tsc -p tsconfig.junction-parity.json && node scripts/fix-test-build.mjs \
@@ -714,10 +772,11 @@ npx tsc -p tsconfig.junction-parity.json && node scripts/fix-test-build.mjs \
                                       # если менялось одно из зеркал junction limits
 ```
 
-**Новый код не добавляет `any`** (#342). В `src/**` уже 1034 вхождения явного
-`any` в 49 файлах; перетипизировать это одним заходом — месяц риска ради нуля
-пользовательской ценности, поэтому долг снимается при плановом извлечении
-подсистем (#425, прежний #34), а не разовой заменой. Гейт `scripts/no-new-any.mjs` судит
+**Новый код не добавляет `any`** (#342). Явного `any` в `src/**` — сотни
+вхождений (`node scripts/no-new-any.mjs --total`); перетипизировать это одним
+заходом — месяц риска ради нуля пользовательской ценности, поэтому долг
+снимается при плановом извлечении подсистем (#425, прежний #34), а не разовой
+заменой. Гейт `scripts/no-new-any.mjs` судит
 **только добавленные строки**: существующий долг на нетронутой строке законен,
 правка строки со старым `any` — новая ответственность. Исключение объявляется на
 той же строке, `// any-ok: <конкретная причина>`; голый маркер и причины вида
@@ -725,24 +784,26 @@ npx tsc -p tsconfig.junction-parity.json && node scripts/fix-test-build.mjs \
 комментарии, строке или идентификаторе ложных срабатываний не даёт.
 
 **Объём гейтов на код-ревью соразмерен задаче** (issue #127). Всегда:
-`typecheck`, `npm test`, `npm run build` со сверкой трёх копий бандла, а при
-любом diff'е по `src/**` — ещё и `node scripts/check-docs.mjs`. По
+`typecheck`, `npm test`, `npm run build` с `bundle-policy --verify` (копии сверяются на кандидате, #657).
+Свежесть скриншотов документации — не гейт задачи (#697, ниже). По
 необходимости, определяемой diff'ом и AC: браузерные смоки (сколько их —
 считает `ls demo/smoke_*.mjs | wc -l`, вшитое число здесь трижды отставало от
 дерева; прогон всех уместен только когда задача задевает всё; какие относятся к
 диффу, печатает
 `node scripts/smoke-select.mjs --base origin/dev --head HEAD`, и его вывод
-прикладывается к ревью вместе с решением по каждой строке), `golden:verify` при изменении видимого
-результата, `pytest tests_backend` при правках в Python, performance-профили при
+прикладывается к ревью вместе с решением по каждой строке), `golden:verify` при метке `ci:golden`, `pytest tests_backend` при правках в Python, performance-профили при
 названном в AC влиянии. **Полные наборы — предрелизный гейт, а не гейт ревью.**
 
-Скриншоты снимаются **только** джобой `Docs screenshots` (`workflow_dispatch`) и
-принимаются локально: `npm run docs:accept -- --reviewed --from=<распакованный
-артефакт>` (#246). Съёмка на своей машине даёт байтово другой PNG при том же
-кадре, и набор из «не того» браузера переписывает все десять файлов без единого
+Скриншоты снимаются **только** каноническим прогоном в CI — `beta-derived.yml`
+(съёмка и приёмка одним коммитом бота на `dev`, #697) или `Docs screenshots`
+(`workflow_dispatch`, только артефакт) с приёмкой вручную: `npm run docs:accept --
+--reviewed --from=<распакованный артефакт>` (#246). Ручной путь остаётся
+релиз-менеджеру, если бот недоступен. Съёмка на своей машине даёт байтово другой PNG при том же
+кадре, и набор из «не того» браузера переписывает все кадры (их число — в
+`demo/docs/screenshots.mjs`) без единого
 содержательного изменения. Приёмка отказывает, если кандидат снят не с этого
-дерева, не тем капчуром, не называет свой Chromium или неполон; коммит делает
-человек.
+дерева, не тем капчуром, не называет свой Chromium или неполон; коммит бота
+проверяет релиз-менеджер, коммит ручной приёмки делает человек.
 
 Когда правка `src/**` кадров не меняет — а это большинство правок — CI-цикл не
 нужен (#512): `npm run docs:accept -- --identical` снимает кадры локально,
@@ -751,13 +812,48 @@ npx tsc -p tsconfig.junction-parity.json && node scripts/fix-test-build.mjs \
 закоммиченных PNG, их sha, браузер и упаковщик съёмки остаются прежними. Хотя бы
 один отличающийся пиксель — отказ с перечнем кадров и штатный путь через артефакт.
 
-`check-docs` стоит в обязательной части не по важности, а по механике: отпечаток
-скриншотов документации считается по всему `src/**`, поэтому **любая** правка
-фронтенда делает его устаревшим. Выборка «по diff и AC» здесь не работает — diff
-всегда попадает, и решать нечего. Цена пропуска измерена: скриншоты не
-пересняли в #230 и #234, и `dev` стоял с красным job `docs`, пока это не нашли
-при следующей задаче (#237). Пересъёмка — `npm run build && node
-demo/docs/capture.mjs`, коммит вместе с задачей.
+**Производные артефакты — на `dev`, один коммит на бету** (#697, решение
+владельца 2026-09-28). Отпечаток скриншотов документации считается по всему
+`src/**`, поэтому любая правка фронтенда делает его устаревшим. Пока его
+коммитила каждая задача, `docs/images/screenshots.json` правили 70 раз за 14 дней,
+и две параллельные задачи конфликтовали на нём гарантированно. Golden
+оплачивала следующая задача: сдвиг, влитый одной, всплывал у другой (#687 →
+#685, #688 → #689). Теперь:
+
+- **ветки задач не коммитят** `docs/images/**` и `demo/golden/baselines/**`. На
+  ветке свежесть скриншотов — предупреждение preflight, а golden не идёт;
+- **перед кандидатом беты** `beta-derived.yml` одним коммитом бота обновляет на
+  `dev` отпечаток и кадры (съёмка тем же каноном, приёмка `docs:accept
+  --reviewed`) и эталоны golden из артефакта полного Validate на `dev`
+  (`golden:accept --reviewed`, `Release:` и `Baseline-Reviewed:` в коммите).
+  Изменившийся кадр или сцена принимается, только если назван во входах
+  workflow; необъявленная разница — отказ с перечнем. Коммит проверяет
+  релиз-менеджер;
+- **задача, которая меняет визуал намеренно**, ставит `ci:golden`: конвейер
+  прогоняет полный набор на материале ревью, и сдвинутые кадры задача
+  принимает сама — по §3 п.13;
+- **`Release:` на ветке задачи тяжёлый набор не включает** (`classify-changes.mjs`):
+  тяжёлое запускают `ci:full` и `ci:golden`, трейлер `Release:` на `dev` и ночной
+  прогон.
+
+Строгая свежесть скриншотов по-прежнему обязательна на кандидате беты
+(`publish-prerelease.yml`, `check-docs --screenshots=strict`).
+
+**Храповики — полоса над потолком беты** (#699, решение владельца 2026-09-28).
+Строки двух ядер (`test/core-file-budget.test.mjs`), gzip стартового и ленивых
+графов (`scripts/bundle-budget.mjs`) и числа связности монолита
+(`scripts/monolith-baseline.json`) судятся одним правилом: потолок — факт
+последней беты; ветка задачи краснеет, только если вышла выше потолка больше
+чем на полосу (ядро — 50 строк, графы и `dist/` — 2 000 Б, числа монолита — по
+`METRIC_BANDS`), а снижение её не красит. Прежде храповики были двусторонними с
+нулевым запасом: параллельные задачи конфликтовали на общих числах, пересчитывали
+их после ребейза и упирались в потолок, потому что перед ними влили чужую (#689
+после #691). Вторая сторона храповика живёт на бете: релиз-менеджер на
+кандидате выполняет `node scripts/ratchets.mjs tighten` — потолки опускаются
+(и поднимаются на принятый линией рост) до факта одним коммитом вместе с
+кандидатом; `npm run release:prerelease` печатает рыхлые потолки
+предупреждением. Абсолютный бюджет стартового графа
+(`INITIAL_VIEW_GZIP_BUDGET`) остаётся стеной.
 
 **Перф-смок в Validate зависит от диффа** (#473). Два glow-профиля
 гоняются всегда; при правке `src/iso-*` добавляется `large-house-isometric-v1`,
@@ -825,8 +921,10 @@ Performance зелёные на точном SHA, плюс зелёный E2E н
 | `blocked` | Ждём внешнего или владельца, **поверх** статусной метки |
 | `rejected` | Отклонено, issue закрыт |
 
-Модификаторы: `small` (лёгкий трек, сложность ≤3), `trivial` (короткий трек,
-§5.1), `hotfix`, `process`, `review-4`; приоритет `P1`/`P2`/`P3`; тип `bug`/`feature`/`tech-debt`.
+Модификаторы: трек `track:ship`/`track:show`/`track:ask` (§5), тяжёлые проверки
+`ci:full`/`ci:golden`/`ci:mutants` (§5.1), `hotfix`, `process`, `review-4`;
+приоритет `P1`/`P2`/`P3`; тип `bug`/`feature`/`tech-debt`. Прежние `small` и
+`trivial` читаются как `track:show` (§5.1).
 Тематические метки (`polish`, `infra`, `tests`, `docs`, `security`, `vacuum`)
 ортогональны процессу.
 
@@ -877,7 +975,8 @@ Performance зелёные на точном SHA, плюс зелёный E2E н
 включая свежий контейнер облачного агента, без отдельного шага в инструкции.
 
 - **`commit-msg`** — есть, работает. Отклоняет коммит без терминального
-  `Issue: #NN`, требует ровно один `User-Visible: yes|no`, а для коммитов,
+  `Issue: #NN`, требует ровно один `User-Visible: yes|no` (коммит только из
+  файлов класса C — без трейлеров, §3 п.10, #701), а для коммитов,
   трогающих `demo/golden/baselines/**`, — `Release:` плюс ровно один источник:
   `Baseline-Reviewed: <URL GitHub run>` либо
   `Baseline-Reviewed-Local: sha256:<хеш аттестации>`. Локальный хеш обязан
@@ -930,7 +1029,9 @@ Performance зелёные на точном SHA, плюс зелёный E2E н
    `Baseline-Reviewed: <ссылка на прогон CI>` либо
    `Baseline-Reviewed-Local: sha256:<хеш аттестации>`;
 6. релизный коммит не содержит изменений в `src/` и `custom_components/**/*.py`;
-7. документов ревью на один issue не больше четырёх (`-r1`…`-r4`).
+7. документов ревью одного вида (`SPEC-REVIEW`, `CODE-REVIEW`) на один issue
+   не больше шести (`-r1`…`-r6`, `REVIEW_DOC_LIMIT`): четыре цикла плюс два
+   ребейза (§4).
 
 С токеном GitHub:
 
@@ -951,6 +1052,11 @@ Validate стартует от этого push и успевает прочит
 документ ревью: он ложится в ветку задачи, пока та в `S4-spec-review` или
 `S7-code-review`, то есть заведомо вне рабочего множества.
 
+**Инфраструктурный диапазон статуса не требует** (#562, §1): если в диапазоне нет
+ни одного файла класса A, задача ещё не вошла в поток — она войдёт в него сразу на
+`S7-code-review`, — и отсутствие S-метки не отказ. Признак механический, по
+диффу, а не по метке `infra`.
+
 **При продвижении в `main` не перепроверяются коммиты, уже достижимые из
 prerelease-тега.** После выпуска беты их issue по §2.8 должны быть закрыты, а
 stable fast-forward снова включает эти коммиты в диапазон `old-main..candidate`.
@@ -1037,9 +1143,46 @@ Matysh/houseplan-card/.github/workflows/_<имя>.yml@dev` с `secrets: inherit`
 триггеры, входы ручного запуска или потолок прав; тогда он зеркалится в
 `main`, и preflight `workflow_sync` в `validate.yml` держит копии равными —
 сверяются ровно эти шесть файлов, список держит
-`test/default-branch-workflows.test.mjs`. `performance.yml` в список не входит:
+`test/default-branch-workflows.test.mjs`. Расхождение красит push в `dev` и
+заводит одно issue владельцу (`[workflow-sync]`), а на ветке задачи —
+предупреждение в сводке (#700): к её изменению оно отношения не имеет, и чинит
+его тот, кто зеркалит в `main`. Так же судятся внешние ссылки документации
+(`check-docs --external=warn` на ветках `issue/*`): упавший чужой сайт не
+возвращает задачу. `performance.yml` в список не входит:
 по расписанию он судит `main` собственным телом из `main`.
 
+**Цена захода зависит от трека** (#696, решение владельца 2026-09-28). Трек
+снимает `scripts/process-track.mjs` в стадии подготовки — по текущим меткам и
+диффу от merge-base с `dev`, до ребейза. Прежние метки читаются по §5.1:
+инфраструктурная задача без трековой метки — `show`, продуктовая — `ask`.
+
+| | `ship` | `show` | `ask` |
+|---|---|---|---|
+| Validate на материале | лёгкий; годится завершённый push-прогон на этом SHA | лёгкий, как у `ship` | с мутантами по диффу, dispatch |
+| Ребейз до ревью | нет, если `git merge-tree` с `dev` чистый | нет, если чистый | да (#257) |
+| Ревью модели | нет — пакетное ревью перед бетой (§11.7) | корректность и AC; окружение — по нужде | полное |
+| Проверка кандидата слияния | ждёт push-прогон кандидата; dispatch — только если его нет | как у `ship` | dispatch с мутантами |
+
+Метка `ci:mutants` возвращает мутанты по диффу на любом треке. Рамки `ship`
+(§5) проверяет тот же шаг; выход за них — комментарий в issue и замена
+`track:ship` на `track:show` в этом же заходе. Слияние `ship` оставляет в issue
+комментарий с машинным маркером `hp:ship-merge`. Это не вердикт ревью и так себя
+не называет; по маркеру пакетное ревью находит задачи диапазона. Повторно
+применимый зелёный вердикт (#499) главнее `ship`: код уже прочитан.
+
+В `dev` по-прежнему уезжает только SHA с зелёным Validate. Без ребейза до ревью
+кандидат собирается один раз, при слиянии, и лёгкий Validate проходит там.
+Ориентир — данные #695: `small` стоил медиану 115 минут и 12 событий, `trivial` —
+41 минуту и 5 событий; `show` целится в уровень `trivial`.
+
+**Ревью `show` судит корректность и AC.** Medium — дефект поведения, который
+увидит пользователь, или невыполненный AC. Бухгалтерия — нет мутанта или записи
+в реестре, нечувствительный тест на побочный вызов, формулировка в документе —
+Low и цикла не открывает. Отсутствие мутантов по диффу на `show` не находка:
+полный реестр гоняется ночью. Ревью `show` не ставит Chromium, если тело issue
+не называет смоук или браузер. Ревью ТЗ не ставит ни `npm ci`, ни браузер: кода
+оно не исполняет.
+
 **Ревью не начинается на красном коде** (#510). После фиксации материала конвейер
 запускает Validate с мутантами по диффу на этом SHA (`scripts/validate-gate.mjs`:
 `workflow_dispatch validate.yml -f mutants=true`). **Ждёт его не раннер, а событие**
@@ -1060,7 +1203,7 @@ Matysh/houseplan-card/.github/workflows/_<имя>.yml@dev` с `secrets: inherit`
 мутантов не запрашивают** (#601, решение владельца 20.09): мутационный гейт
 проверяет тесты, а не продукт (#513), к бете каждая задача прогнана им дважды —
 на ревью и на слитом после ребейза кандидате, — а ночью идёт полный реестр
-(`mutation-gate.yml`, 01:00 UTC). Релизный гейт (#541) требует полного Validate,
+(`mutation-gate.yml`, 00:43 UTC). Релизный гейт (#541) требует полного Validate,
 но не mutant-jobs; для ревью и слияния шесть исполненных mutant-jobs остаются
 обязательными.
 
@@ -1113,7 +1256,8 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 никто не может выйти и о котором никто не узнает, для конвейера хуже громкой
 ошибки.
 
-**Ветка приводится к `dev` до ревью, а не после** (#257). Раньше ревью читало ветку
+**Ветка приводится к `dev` до ревью, а не после** (#257) — на треке `ask`. `show`
+и `ship` с чистым слиянием ребейзятся один раз, при слиянии (#696, выше). Раньше ревью читало ветку
 как есть, а слияние делало ребейз — проверенный SHA и слитый SHA были разными
 коммитами. Пока расхождение с `dev` текстовое, ребейз упирается в конфликт и это
 видно; смысловое расхождение git склеивает молча, и в `dev` уезжает комбинация,
@@ -1123,7 +1267,7 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 - ветка уже содержит весь `dev` — ничего;
 - отстала и ребейзится чисто — ребейз, `push --force-with-lease`, ревью по
   приведённому состоянию. Факт ребейза передаётся в промпт, чтобы сработало
-  правило §7.2 о полном разборе вместо дельты;
+  правило §2.10 о полном разборе вместо дельты;
 - конфликт — возврат в `S6-in-progress` **до** запуска ревью. Цикл при этом не
   расходуется: код никто не читал, вердикта нет.
 
@@ -1145,13 +1289,19 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 - если `dev` не двигался — push с `--force-with-lease` на текущую вершину;
 - если двигался — ребейз (конфликт — `S6-in-progress`, как раньше), сравнение
   patch-id проверенного и получившегося диффа (различие — `S7-code-review`: вердикт
-  к другому диффу не применим, §7.2), публикация кандидата в ветку задачи, запуск
+  к другому диффу не применим, §2.10), публикация кандидата в ветку задачи, запуск
   Validate с мутантами на ней (#510) и ожидание зелёного dispatch-прогона **на этом
   SHA** — push-прогон мутантов не несёт — и только затем push в `dev` с lease на ту
-  вершину, поверх которой кандидат собран. Отклонённый lease — `dev` двинулся снова
+  вершину, поверх которой кандидат собран. На `show`/`ship` мутантов нет, и
+  лёгкий Validate кандидата уже запустил сам push в ветку: слияние ждёт этот
+  push-прогон, а dispatch шлёт, только если его нет за три минуты (#696). Отклонённый lease — `dev` двинулся снова
   — новая попытка; после третьей — `S6-in-progress` с комментарием;
 - красный Validate на кандидате или прогон, не появившийся за три минуты, —
-  `S6-in-progress` с ссылкой; `S8-merged` ставится только после push.
+  `S6-in-progress` с ссылкой; `S8-merged` ставится только после push;
+- после push ветка задачи удаляется с lease на влитую вершину (#702): коммит,
+  прилетевший после слияния, её сохраняет, и комментарий об этом говорит.
+  Влитая ветка никому не нужна, а агент, ищущий ветку по номеру, иначе может
+  взять устаревшую.
 
 Проверка кандидата — обычный Validate ветки: лёгкий набор плюс диффозависимые
 гейты. Тяжёлые гейты остаются за кандидатом релиза (#479): слияние не превращает
@@ -1195,7 +1345,7 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 повторно **без вызова модели**, если последний документ этапа несёт записанный
 конвейером вердикт `green` с High 0 и дерево материала не изменилось ни в одном
 файле вне `docs/reviews/**` (сравнивает `git diff` по содержимому). Ребейз, правка
-теста, фикстуры или ТЗ дают отличие дерева и полный разбор — правило §7.2 не
+теста, фикстуры или ТЗ дают отличие дерева и полный разбор — правило §2.10 не
 ослабляется, оно просто не касается дерева, которое уже читали.
 
 Цикл считается **по этапу**: вердикт по ТЗ не расходует бюджет код-ревью. Раньше
@@ -1205,9 +1355,10 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 
 ## 11. Исключения
 
-### 11.1 Лёгкий трек
+### 11.1 Треки
 
-См. §5 — это не исключение из правила №1, а более дешёвый путь по тем же статусам.
+См. §5 — треки `ship` и `show` не исключения из правила №1, а более дешёвые пути
+по тем же статусам.
 
 ### 11.2 Аварийный хотфикс (метка `hotfix`, решение владельца)
 
@@ -1216,7 +1367,7 @@ npm ci, Python и Chromium, оставаясь исполненной job: до
 - issue создан в **той же сессии до коммита**, метка `hotfix`;
 - ТЗ «как сделано» + раздел «почему нельзя было ждать»;
 - в течение 24 часов задача ретроспективно проходит код-ревью;
-- аварийность названа явно в релизном хендоффе (действующее правило `AGENTS.md`).
+- аварийность названа явно в релизном хендоффе.
 
 ### 11.3 Гигиена репозитория
 
@@ -1250,7 +1401,10 @@ Golden, браузерные смоки, performance и полный HA-харн
 - эталоны golden принимаются только через `npm run golden:accept -- --reviewed`
   на полном Linux-артефакте GitHub CI либо полном аттестованном WSL-артефакте;
   после локальной приёмки полный GitHub Validate на точном финальном SHA всё
-  равно обязателен. «Чтобы гейт позеленел» основанием не является.
+  равно обязателен. «Чтобы гейт позеленел» основанием не является. Сдвиг, который
+  влили задачи линии, принимается на `dev` одним коммитом на бету —
+  `beta-derived.yml` с объявленными сценами (§8, #697), а не задачей, которая
+  наткнулась на него следующей.
 
 **Границы, за которыми исключение не действует.** Оно про починку названного
 гейтом дефекта, а не про продолжение разработки под видом починки. Правка идёт
@@ -1270,8 +1424,102 @@ Golden, браузерные смоки, performance и полный HA-харн
 запись в issue публична и релиз-менеджер видит, что именно было сделано перед
 выпуском.
 
-Это исключение из правила «код-ревью не пропускается никогда» (§5, §7.1) —
-единственное, и относится только к окну между `S8-merged` и выпуском.
+Это исключение из правила «каждое изменение проходит код-ревью» (§5, §7.1).
+Второе такое место — трек `ship` (§5): его ревью не отменяется, а переносится
+на пакетное ревью диапазона перед бетой. Здесь же исключение относится только к
+окну между `S8-merged` и выпуском.
+
+### 11.5 Независимое ревью линии перед стабильным релизом
+
+Решение владельца 2026-09-25, issue #638.
+
+**Зачем.** Инкрементальное ревью судит дифф задачи против её ТЗ, а не
+поверхность против пользователя. Пять раундов по эпику #591 не нашли того, что
+нашли четыре независимых ревью перед аудитом 22.09: невидимый после крестика HA
+диалог (#607), кламп по символу (#608), маршруты робота при импорте (#611),
+детерминированный отказ релизного гейта (#619). Ни ветка `ha-dialog`, ни
+посимвольный ввод не входили ни в один AC.
+
+**Шаг.** Перед каждым стабильным релизом — одно ревью поверхностей, изменённых
+всей линией бет, «с нуля»:
+
+- **вход** — issue линии, доказанные трейлерами `Issue: #NN` в диапазоне
+  «прошлый стабильный тег..кандидат» (тот же построитель и та же схема, что
+  `RELEASE-MEMBERSHIP.json` беты, #547; метка S8 доказательством не является),
+  и изменённые продуктовые файлы. Собирает их
+  `scripts/release-review.mjs prepare`;
+- **без ТЗ и без документов раундов**: основа суждения — `docs/SCOPE.md` и
+  `docs/USER-GUIDE.ru.md`. Проверка исполнением: бандл, стенд и смоки, пиннутая
+  фикстура `ha-dialog` (#505) там, где есть диалоги, посимвольный ввод,
+  настоящие Escape и крестик; для каждой поверхности — обычный сценарий и самый
+  рискованный соседний (§2.6, шесть классов риска);
+- **выход** — `docs/reviews/RELEASE-REVIEW-vX.Y.Z.md` в `dev`, находки
+  High/Medium/Low с воспроизведением.
+
+**Исполнитель** — модель в CI, `.github/workflows/release-review.yml`: три job
+(вход, модель, публикация), модель без единого права на запись, документ, его
+машинный блок, индекс и коммит — детерминированный шаг. Независимость
+обеспечена построением: сессия свежая, ТЗ и раунды ей не даются.
+
+**Выпуск не блокирует.** `release.yml` ставит ревью в очередь job
+`independent-review` сразу после закрепления SHA кандидата — параллельно
+гейтам; ни один job выпуска от него не зависит, его отказ — предупреждение.
+Документ — рекомендация: владелец берёт находки в работу (issue в очередь
+следующей беты) либо оставляет без действий. Автоматически находки в issue
+не превращаются.
+
+Повторный запуск на тот же тег модель не тратит, если документ уже в `dev`
+(`force=true` — переснять). Ручной запуск:
+`gh workflow run release-review.yml --ref dev -f tag=vX.Y.Z [-f candidate=<sha>]`.
+Беты шаг пропускают. Первый прогон — линия v1.78.0.
+
+### 11.6 Повторные Validate на одном SHA перед релизом
+
+Решение владельца 2026-09-26, issue #656.
+
+Релизный гейт рассматривает прогоны одного SHA от нового к старому. Отменённый
+прогон и proof, который не соответствует запрошенной политике (например,
+лёгкий вместо полного), вердиктом не являются: гейт проходит мимо них к
+следующему совместимому proof. **Среди совместимых полных прогонов решает
+новейший.** Поэтому поздний полный `failed`, `missing` или `pending` блокирует
+более ранний зелёный proof; новый полный зелёный прогон может обновить старый
+красный.
+
+Это fail-closed правило. Content-addressed proof доказывает, что конкретный
+прогон относится к кандидату, но не даёт старому зелёному прогону права скрыть
+более позднюю проверку той же политики, которая нашла отказ. Чтобы продолжить
+выпуск после такого отказа, исправляют причину и получают новый совместимый
+полный зелёный прогон на том же финальном SHA либо на новом SHA кандидата.
+
+### 11.7 Пакетное ревью `ship` перед бетой
+
+Решение владельца 2026-09-28, issue #696.
+
+**Зачем.** `track:ship` сливается без ревью модели (§5, §10.4): правка в
+механических рамках и зелёный лёгкий Validate. Прочитать её код обязан кто-то
+до того, как она уйдёт пользователям беты. Одна сессия на все ship-задачи
+диапазона дешевле ревью на каждую, а рамки ship держат объём малым.
+
+**Шаг.** Перед публикацией беты — `ship-review.yml`
+(`gh workflow run ship-review.yml --ref dev -f tag=vX.Y.Z-beta.N`):
+
+- **вход** — issue из трейлеров `Issue: #NN` в диапазоне «прошлый тег..кандидат»
+  (тот же построитель, что `RELEASE-MEMBERSHIP.json`, #547), из них — ship: с
+  маркером `hp:ship-merge` в комментариях или с меткой `track:ship`. Собирает
+  `scripts/ship-review.mjs prepare`; ship-задач нет — модель не запускается;
+- **суждение** — по строке ТЗ каждой задачи и её коммитам: делает ли код
+  заявленное и только его, не ломает ли соседнее, не вышла ли правка из ship по
+  смыслу. Правила ревьюера — `docs/process/REVIEWER.md`, «Пакетное ревью ship»;
+- **выход** — `docs/reviews/SHIP-REVIEW-<тег>.md` в `dev` с машинным блоком:
+  задачи и счёт High/Medium/Low. У модели нет прав записи, документ публикует
+  детерминированный шаг.
+
+**Гейт беты.** `ship-review.mjs check` стоит в обоих путях публикации —
+`publish-prerelease.yml` и `npm run release:prerelease` (включая `--check`).
+Если в диапазоне есть ship-задачи, документ обязан лежать в кандидате или в
+`dev`, покрывать их все и не нести High. Задача, слитая после ревью, требует
+пересъёмки (`-f force=true`). High чинится отдельной задачей, затем ревью
+переснимается. Medium и Low решает владелец, как в §11.5.
 
 ---
 
@@ -1296,70 +1544,3 @@ Golden, браузерные смоки, performance и полный HA-харн
 
 **Нарушение процесса — тоже issue** (метка `process`): если правило удалось
 нарушить незаметно, виновата проверка.
-
----
-
-## 13. Внедрение
-
-Состояние на 2026-08-13.
-
-1. ✅ **Метки созданы, бэклог размечен.** У всех открытых issue владельца ровно
-   одна `S*`-метка, инварианты чистые.
-2. ✅ **Колонка «Статус ТЗ» убрана** — вместе со всем индексом: `docs/specs/`
-   стал архивом, ТЗ переехало в тело issue (#517, 2026-09-10). Перенос старых
-   документов ревью в `docs/reviews/` отменён: они описывают код, которого уже нет.
-3. ✅ **Гейт написан** — `scripts/process-gate.mjs` плюс job в `validate.yml`,
-   issue #105. Прошёл **вне** флоу как инфраструктурная задача (§1, issue #118), а
-   не через ТЗ и ревью, как предполагала прежняя редакция этого пункта.
-4. ✅ **Долг ревью списан решением владельца.** Беты `beta.2`…`beta.10` сделаны по
-   прежнему процессу и не пересматриваются. Точка отсчёта — релиз 1.62.0; отсчёт
-   начинается с первой беты следующей линии.
-5. ⏳ Завести issue на находку «смок `visual_continuity` не умеет падать» — это
-   ровно тот класс дефектов, который в процессе без ручного тестирования стоит
-   дороже всего.
-6. ✅ `BACKLOG-2026-08-11.md` — разовый отчёт, решения живут в issue.
-7. ✅ `AGENTS.md` переписан целиком, шире блока §14.
-8. ✅ **Канон перенесён в репозиторий** (issue #112). До этого полный процесс жил
-   только в папке владельца, а в репозитории лежал файл на 51 строку про трейлеры
-   коммитов — из свежего клона канон не был виден вообще.
-9. ✅ **`pre-push` написан** (§10.1, issue #121). Блокирующая проверка на клиенте
-   есть; обойти её можно только `--no-verify`, и тогда то же найдёт CI.
-
----
-
-## 14. Блок для AGENTS.md
-
-```markdown
-## Процесс: код только через issue
-
-Изменение продуктового кода без issue запрещено. Код меняется только из статуса
-«Готово к разработке» или дальше. Полные правила, критерии статусов и гейты —
-`docs/PROCESS.md`, читать до начала работы.
-
-Жизненный цикл (статус = метка issue): `S1-new` → `S2-analysis` → `S3-spec` →
-`S4-spec-review` → `S5-ready` → `S6-in-progress` → `S7-code-review` → `S8-merged`
-→ закрытие пачкой при выпуске беты. Оба ревью возвращают на правки не более 4
-циклов; пятый заход — разбор у владельца (разделить / отклонить / арбитраж).
-
-Инфраструктурная задача (ни одного файла класса A) делается сразу любым агентом:
-без `S*` → `S7-code-review` ↔ `S6-in-progress` → `S8-merged`. ТЗ и ревью ТЗ нет,
-код-ревью обязательно.
-
-Ревью запускается **само** от меток `S4-spec-review` и `S7-code-review`.
-Deterministic prerequisites, модель и интеграция имеют отдельные пределы 55/45/55
-минут; обычно стадии заканчиваются существенно раньше. Поставив такую метку, автор
-не заканчивает работу, а ждёт смены метки опросом и продолжает по тому, чем она
-стала.
-
-- ветка `issue/<NN>-<slug>`, коммиты с трейлерами `Issue: #NN` и `User-Visible: yes|no`;
-- работаем прямыми коммитами в `dev`, без PR: блокирующий гейт — локальный
-  `pre-push` (ставится автоматически через `npm ci`), CI — страховка. Force-push
-  в `dev` запрещён;
-- автор ≠ ревьюер, ни для ТЗ, ни для кода;
-- фазы ручного тестирования нет: автотесты пишутся в реализации, AC проверяет
-  код-ревью, найденные позже дефекты — новые issue типа «баг»;
-- мелкие задачи (метка `small`, сложность ≤3): ТЗ в теле issue, ревью ТЗ
-  комментарием, код-ревью — как обычно;
-- найденное вне скоупа — новый issue, а не попутная правка;
-- issue закрывает релиз-менеджер после выпуска беты, не исполнитель.
-```

README.md

@@ -42,6 +42,9 @@ sync across screens.
   show temperature, humidity, light state and average LQI.
 - **Light and environment.** Room fills, lamp Glow, wall shadows, a day-cycle
   backdrop and sunlight through windows.
+- **Flat or 2.5D.** One switch in General settings › Display shows the plan
+  with depth everywhere: raised device tiles with soft floor shadows and a soft
+  wash of sunlight; decor and wall colours stay as you set them.
 - **Doors, windows, gates and vacuums.** Openings follow real contacts and locks;
   a robot can show its position, dock and travelled path.
 - **Several floors and screens.** Space tabs, swipe navigation, local viewport,
@@ -58,8 +61,8 @@ sync across screens.
 1. Install the integration and open **House Plan** in the Home Assistant sidebar.
 2. Create the first **space**: upload SVG/PNG/JPG/WebP, reuse an uploaded image,
    or choose no image and draw the plan by hand.
-3. In Plan, select **Room outline**, place vertices, and click the first point to
-   close the outline.
+3. In Plan, select **Walls** and draw one continuous chain around the room: when
+   it closes an area, the room dialog opens.
 4. Name the room and bind it to a Home Assistant area. Use “No area” for a room
    that has no devices.
 5. Open Device: devices from the bound area are already placed; drag their
@@ -183,8 +186,11 @@ concurrent clients, but avoid editing the same object in two browsers at once.
 - [Full user guide](docs/USER-GUIDE.md)
 - [Mouse/touch/keyboard matrix](docs/USER-GUIDE.md#6-navigation-zoom-and-input)
 - [Plan tools](docs/USER-GUIDE.md#plan-tools-at-a-glance)
+- [Stairs and floor links](docs/STAIRS.md)
 - [Background editor](docs/DECOR-EDITOR.md)
 - [Robot vacuums](docs/VACUUM.md)
+- [Presence radars](docs/RADAR.md)
+- [PDF export](docs/PDF-EXPORT.md)
 - [Touch support](docs/TOUCH-SUPPORT.md)
 
 <!-- docs-section: support -->
@@ -197,9 +203,4 @@ concurrent clients, but avoid editing the same object in two browsers at once.
   Include the version, browser, logs and reproduction steps; private entity IDs
   may be replaced with fictional ones.
 
-Documentation screenshots are produced by the reproducible
-`npm run build && node demo/docs/capture.mjs` command using synthetic data only. Scenario version,
-source fingerprint and every image hash are recorded in the
-[screenshot index](docs/images/screenshots.json).
-
 License: [MIT](LICENSE).

README.ru.md

@@ -43,6 +43,9 @@ Assistant — и устройства появятся на плане авто
   а карточки комнат показывают температуру, влажность, свет и средний LQI.
 - **Свет и окружение.** Заливки комнат, Glow от ламп, тени от стен, дневной фон и
   солнечные лучи из окон.
+- **Плоский план или 2.5D.** Один переключатель в «Общие настройки ›
+  Отображение › Объёмный вид плана (2.5D)» показывает план с глубиной везде: приподнятые плитки устройств с мягкими
+  тенями и мягкая засветка солнцем; декор и цвета стен остаются вашими.
 - **Двери, окна, ворота и пылесосы.** Проёмы отражают реальные датчики и замки;
   робот показывает позицию, базу и пройденный путь.
 - **Несколько этажей и экранов.** Вкладки пространств, жесты переключения,
@@ -57,10 +60,11 @@ Assistant — и устройства появятся на плане авто
 ## Первая рабочая комната
 
 1. Установите интеграцию и откройте **House Plan** в боковом меню Home Assistant.
-2. Создайте первое **пространство**: загрузите SVG/PNG/JPG/WebP либо выберите
-   вариант без изображения, чтобы нарисовать план вручную.
-3. В редакторе «План» выберите **Контур комнаты**, поставьте вершины и замкните
-   контур нажатием на первую точку.
+2. Создайте первое **пространство**: загрузите SVG/PNG/JPG/WebP, возьмите уже
+   загруженное изображение либо выберите вариант без изображения, чтобы
+   нарисовать план вручную.
+3. В редакторе «План» выберите **Стены** и нарисуйте непрерывную цепочку по
+   периметру комнаты: когда она замкнёт область, откроется диалог комнаты.
 4. Назовите комнату и свяжите её с зоной Home Assistant. Для помещения без
    устройств выберите «Без зоны».
 5. Откройте «Устройства»: устройства связанной зоны уже размещены автоматически;
@@ -188,8 +192,11 @@ default_floor: ground
 - [Полное руководство пользователя](docs/USER-GUIDE.ru.md)
 - [Матрица mouse/touch/keyboard](docs/USER-GUIDE.ru.md#6-навигация-масштаб-и-жесты)
 - [Инструменты плана](docs/USER-GUIDE.ru.md#инструменты-плана-в-короткой-таблице)
+- [Лестницы и переходы между этажами](docs/STAIRS.md)
 - [Редактор подложки](docs/DECOR-EDITOR.md)
 - [Роботы-пылесосы](docs/VACUUM.md)
+- [Радары присутствия](docs/RADAR.md)
+- [Экспорт в PDF](docs/PDF-EXPORT.md)
 - [Поддержка touch](docs/TOUCH-SUPPORT.md)
 
 <!-- docs-section: support -->
@@ -202,9 +209,4 @@ default_floor: ground
   обновление страницы (`Ctrl+F5`). Приложите версию, браузер, логи и шаги
   воспроизведения; приватные entity ID можно заменить вымышленными.
 
-Скриншоты в документации получены воспроизводимой командой
-`npm run build && node demo/docs/capture.mjs` только на синтетических данных. Версия сценариев,
-fingerprint исходников и хеш каждого изображения находятся в
-[индексе снимков](docs/images/screenshots.json).
-
 Лицензия: [MIT](LICENSE).

custom_components/houseplan/__init__.py

@@ -6,6 +6,7 @@ import logging
 from datetime import timedelta
 from pathlib import Path
 
+from homeassistant.const import EVENT_HOMEASSISTANT_STOP
 from homeassistant.core import HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady
 from homeassistant.helpers.event import async_track_time_interval
@@ -39,6 +40,30 @@ from .store import (
 _LOGGER = logging.getLogger(__name__)
 
 
+async def _async_flush_runtime(
+    hass: HomeAssistant, entry: HouseplanConfigEntry,
+) -> None:
+    """Stop deferred writers and persist their latest state once.
+
+    Home Assistant stop and config-entry unload share this exact path.  Both
+    writers are independently guarded so one failed store cannot prevent the
+    other from reaching disk during shutdown.
+    """
+    recorder = hass.data.get(DOMAIN, {}).get("trail_recorder")
+    if recorder is not None:
+        try:
+            await recorder.async_teardown()
+        except Exception:  # noqa: BLE001 - shutdown must continue with other stores
+            _LOGGER.exception("House Plan: flushing vacuum trails failed")
+
+    virtual_lights = getattr(entry.runtime_data, "virtual_lights", None)
+    if virtual_lights is not None:
+        try:
+            await virtual_lights.async_flush()
+        except Exception:  # noqa: BLE001 - shutdown must continue with other stores
+            _LOGGER.exception("House Plan: flushing virtual-light state failed")
+
+
 async def async_setup(hass: HomeAssistant, config) -> bool:
     """Register global handlers (survive config-entry reloads): WS commands, HTTP view."""
     hass.data.setdefault(DOMAIN, {})
@@ -252,6 +277,19 @@ async def async_setup_entry(hass: HomeAssistant, entry: HouseplanConfigEntry) ->
     # sidebar entry after a migration, repair or initial housekeeping failure.
     panel_path = Path(__file__).parent / "frontend" / "houseplan-panel.js"
     await async_setup_panel_registration(hass, entry, panel_path)
+
+    async def _flush_on_stop(_event) -> None:
+        stop_listener[0] = None
+        await _async_flush_runtime(hass, entry)
+
+    stop_listener = [hass.bus.async_listen_once(EVENT_HOMEASSISTANT_STOP, _flush_on_stop)]
+
+    def _remove_stop_listener() -> None:
+        if stop_listener[0] is not None:
+            stop_listener[0]()
+            stop_listener[0] = None
+
+    entry.async_on_unload(_remove_stop_listener)
     return True
 
 
@@ -263,12 +301,8 @@ async def async_unload_entry(hass: HomeAssistant, entry: HouseplanConfigEntry) -
     entry is loaded. Static paths cannot be unregistered by design.
     """
     remove_panel_registration(hass)
-    rec = hass.data.get(DOMAIN, {}).pop("trail_recorder", None)
-    if rec:
-        await rec.async_teardown()
-    virtual_lights = getattr(entry.runtime_data, "virtual_lights", None)
-    if virtual_lights is not None:
-        await virtual_lights.async_flush()
+    await _async_flush_runtime(hass, entry)
+    hass.data.get(DOMAIN, {}).pop("trail_recorder", None)
     if entry.runtime_data.radar_coordinator:
         entry.runtime_data.radar_coordinator.teardown()
         entry.runtime_data.radar_coordinator = None

custom_components/houseplan/auth.py

@@ -7,6 +7,7 @@ one behaviour.
 """
 from __future__ import annotations
 
+from homeassistant.auth.const import GROUP_ID_READ_ONLY
 from homeassistant.core import HomeAssistant
 
 from .const import CONF_ADMIN_ONLY
@@ -28,4 +29,27 @@ def may_write(hass: HomeAssistant, user) -> bool:
     # UI has always been admin-gated, and an unset option must not open every
     # write WS/HTTP path to every authenticated household user.
     admin_only = bool(entry.options.get(CONF_ADMIN_ONLY, True))
-    return is_admin if admin_only else True
+    if admin_only:
+        return is_admin
+
+    # Administrators retain write access regardless of their group payload.
+    # HA normally exposes admin groups too, but authorization must be based on
+    # the explicit admin flag rather than incidental group serialization.
+    if is_admin:
+        return True
+
+    # Turning off ``admin_only`` grants editing to ordinary household users,
+    # not to HA's explicitly read-only role (#626).  ``groups`` is part of the
+    # supported HA User model; if a non-admin connection cannot provide a
+    # complete group list, the safe interpretation is that write permission
+    # has not been established.
+    groups = getattr(user, "groups", None)
+    if not isinstance(groups, list) or not groups:
+        return False
+    group_ids: list[str] = []
+    for group in groups:
+        group_id = getattr(group, "id", None)
+        if not isinstance(group_id, str):
+            return False
+        group_ids.append(group_id)
+    return GROUP_ID_READ_ONLY not in group_ids

custom_components/houseplan/const.py

@@ -57,7 +57,7 @@ SCHEDULED_GRACE_S = 30 * 24 * 3600
 FILES_DIR = "houseplan/files"
 ASSETS_DIR = "houseplan/assets"
 CONF_ADMIN_ONLY = "admin_only"
-VERSION = "1.78.0-beta.1"
+VERSION = "1.78.0"
 DECOR_ASSETS_API_VERSION = 1
 SUMMARY_PANEL_API_VERSION = 1
 

custom_components/houseplan/coordinate_canonicalization.py

@@ -158,6 +158,12 @@ def canonicalize_config_geometry(config: Any) -> Any:
                 _lattice_fields(decor, ("x", "y"))
                 _scalar_fields(decor, ("scale", "angle"))
 
+        for stair in _records(space.get("stairs")):
+            # #663: wall/stair magnet placement is continuous like furniture.
+            # Scalar cleanup removes JSON tails without moving an authored
+            # physical-face contact onto the plan grid.
+            _scalar_fields(stair, ("x", "y", "length", "width", "radius", "angle"))
+
         # Legacy-only read boundary: v9 drafts are canonicalized before the
         # wall-model migration turns their edges into current partitions.
         for draft in _records(space.get("room_drafts")):

custom_components/houseplan/diagnostics.py

@@ -33,6 +33,7 @@ async def async_get_config_entry_diagnostics(
                 "rooms_with_area": sum(1 for r in s.get("rooms", []) if r.get("area")),
                 "partitions": len(s.get("partitions", [])),
                 "wall_columns": len(s.get("wall_columns", [])),
+                "stairs": len(s.get("stairs", [])),
             }
             for s in config.get("spaces", [])
         ],

custom_components/houseplan/frontend/houseplan-assets.json

@@ -1,129 +1,129 @@
 {
   "schema": 1,
-  "fingerprint": "71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9",
+  "fingerprint": "a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e",
   "entry": "houseplan-card.js",
   "panelEntry": "houseplan-panel.js",
   "initialViewFiles": [
-    "houseplan-assets/houseplan-card-wgloKGAN.js",
+    "houseplan-assets/houseplan-card-BYwTiVnu.js",
     "houseplan-card.js"
   ],
-  "initialViewGzipBytes": 289884,
+  "initialViewGzipBytes": 300323,
   "initialPanelFiles": [
-    "houseplan-assets/houseplan-card-wgloKGAN.js",
+    "houseplan-assets/houseplan-card-BYwTiVnu.js",
     "houseplan-panel.js"
   ],
-  "initialPanelGzipBytes": 291407,
+  "initialPanelGzipBytes": 301845,
   "initialPanelOnlyFiles": [
     "houseplan-panel.js"
   ],
-  "initialPanelOnlyGzipBytes": 2326,
+  "initialPanelOnlyGzipBytes": 2325,
   "lazyFiles": [
-    "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-    "houseplan-assets/de-C5SyyS-g.js",
-    "houseplan-assets/editor-UBk_opR1.js",
-    "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-    "houseplan-assets/fr-DICKr1LR.js",
-    "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-    "houseplan-assets/houseplan-editor-runtime-B1wV3IoM.js",
-    "houseplan-assets/houseplan-onboarding-runtime-C5p4K-n3.js",
-    "houseplan-assets/hp-zigbee-topology-overlay-agIMleco.js",
-    "houseplan-assets/iso-scene-render-CgNVmdT-.js",
-    "houseplan-assets/live-interaction-runtime-DP9k0uiO.js",
-    "houseplan-assets/namespace-language-B_8Js-Qz.js",
-    "houseplan-assets/pdf-export-Chx6-v9j.js",
-    "houseplan-assets/summary-panel-runtime-loaded-Dn4v1Be3.js",
-    "houseplan-assets/zigbee-topology-CeUn5Rc9.js",
-    "houseplan-assets/zigbee-topology-runtime-Bvh9GPnT.js"
+    "houseplan-assets/backdrop-pick-WDIF6iao.js",
+    "houseplan-assets/de-E17v3gXt.js",
+    "houseplan-assets/editor-CbeYCXUv.js",
+    "houseplan-assets/form-kit.styles-v5DlO12L.js",
+    "houseplan-assets/fr-CpDKyK4Z.js",
+    "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+    "houseplan-assets/houseplan-editor-runtime-DZnn4pgB.js",
+    "houseplan-assets/houseplan-onboarding-runtime-B6AiP0fG.js",
+    "houseplan-assets/hp-zigbee-topology-overlay-8lnIEMWk.js",
+    "houseplan-assets/iso-scene-render-BxXtKC5L.js",
+    "houseplan-assets/live-interaction-runtime-CJ95X8vv.js",
+    "houseplan-assets/namespace-language-zIuNvgGV.js",
+    "houseplan-assets/pdf-export-DL7VmwpB.js",
+    "houseplan-assets/summary-panel-runtime-loaded-B0Dq0vzN.js",
+    "houseplan-assets/zigbee-topology-DOAnbvlu.js",
+    "houseplan-assets/zigbee-topology-runtime-CKlry6R8.js"
   ],
-  "lazyGzipBytes": 447274,
+  "lazyGzipBytes": 456389,
   "lazyEditorFiles": [
-    "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-    "houseplan-assets/editor-UBk_opR1.js",
-    "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-    "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-    "houseplan-assets/houseplan-editor-runtime-B1wV3IoM.js",
-    "houseplan-assets/namespace-language-B_8Js-Qz.js",
-    "houseplan-assets/zigbee-topology-CeUn5Rc9.js"
+    "houseplan-assets/backdrop-pick-WDIF6iao.js",
+    "houseplan-assets/editor-CbeYCXUv.js",
+    "houseplan-assets/form-kit.styles-v5DlO12L.js",
+    "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+    "houseplan-assets/houseplan-editor-runtime-DZnn4pgB.js",
+    "houseplan-assets/namespace-language-zIuNvgGV.js",
+    "houseplan-assets/zigbee-topology-DOAnbvlu.js"
   ],
-  "lazyEditorGzipBytes": 230208,
+  "lazyEditorGzipBytes": 238192,
   "lazyOnboardingFiles": [
-    "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-    "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-    "houseplan-assets/houseplan-onboarding-runtime-C5p4K-n3.js",
-    "houseplan-assets/namespace-language-B_8Js-Qz.js"
+    "houseplan-assets/backdrop-pick-WDIF6iao.js",
+    "houseplan-assets/form-kit.styles-v5DlO12L.js",
+    "houseplan-assets/houseplan-onboarding-runtime-B6AiP0fG.js",
+    "houseplan-assets/namespace-language-zIuNvgGV.js"
   ],
-  "lazyOnboardingGzipBytes": 27838,
+  "lazyOnboardingGzipBytes": 27950,
   "lazyLocaleFiles": [
-    "houseplan-assets/de-C5SyyS-g.js",
-    "houseplan-assets/fr-DICKr1LR.js"
+    "houseplan-assets/de-E17v3gXt.js",
+    "houseplan-assets/fr-CpDKyK4Z.js"
   ],
-  "lazyLocaleGzipBytes": 55700,
+  "lazyLocaleGzipBytes": 56330,
   "lazyIsometricFiles": [
-    "houseplan-assets/iso-scene-render-CgNVmdT-.js"
+    "houseplan-assets/iso-scene-render-BxXtKC5L.js"
   ],
-  "lazyIsometricGzipBytes": 17643,
+  "lazyIsometricGzipBytes": 17885,
   "lazyFurnitureArtFiles": [
-    "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js"
+    "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js"
   ],
-  "lazyFurnitureArtGzipBytes": 16939,
+  "lazyFurnitureArtGzipBytes": 16940,
   "lazyPdfFiles": [
-    "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-    "houseplan-assets/pdf-export-Chx6-v9j.js"
+    "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+    "houseplan-assets/pdf-export-DL7VmwpB.js"
   ],
-  "lazyPdfGzipBytes": 126826,
+  "lazyPdfGzipBytes": 126938,
   "lazyNamespaceLocaleFiles": [
-    "houseplan-assets/settings-de-Cin2ABDD.js",
-    "houseplan-assets/settings-fr-BJvZ83Lv.js",
-    "houseplan-assets/settings-ru-8Z8TbBU8.js",
-    "houseplan-assets/support-de-DjEcTGDl.js",
-    "houseplan-assets/support-fr-Cv3_5U35.js",
-    "houseplan-assets/support-ru-1gCA-7I4.js",
-    "houseplan-assets/topology-de-DIRlNRIt.js",
-    "houseplan-assets/topology-fr-DKHD0XtF.js",
-    "houseplan-assets/topology-ru-3tAB4nhw.js"
+    "houseplan-assets/settings-de-DfJ7EKF9.js",
+    "houseplan-assets/settings-fr-Bl79E-6s.js",
+    "houseplan-assets/settings-ru-CkNFmChi.js",
+    "houseplan-assets/support-de-DZoi-fxk.js",
+    "houseplan-assets/support-fr-Daosy89Q.js",
+    "houseplan-assets/support-ru-e8-BrqtH.js",
+    "houseplan-assets/topology-de-Cs36ouVE.js",
+    "houseplan-assets/topology-fr-B8yoJGvc.js",
+    "houseplan-assets/topology-ru-BRKShmrQ.js"
   ],
-  "lazyNamespaceLocaleGzipBytes": 20894,
+  "lazyNamespaceLocaleGzipBytes": 21057,
   "files": [
     {
-      "path": "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-      "sha256": "371de5d4dae4b8574dbf6f51208c8c7587cd3410f0d0acb9aa1c92909bfef375",
-      "rawBytes": 53726,
-      "gzipBytes": 17464,
+      "path": "houseplan-assets/backdrop-pick-WDIF6iao.js",
+      "sha256": "5f6dcedf274594075d8acd31295d8c23f6d1408c890c086825db6bcbaa6c9b21",
+      "rawBytes": 54017,
+      "gzipBytes": 17576,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js"
+        "houseplan-assets/form-kit.styles-v5DlO12L.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js"
       ],
       "dynamicImports": [
-        "houseplan-assets/settings-de-Cin2ABDD.js",
-        "houseplan-assets/settings-fr-BJvZ83Lv.js",
-        "houseplan-assets/settings-ru-8Z8TbBU8.js"
+        "houseplan-assets/settings-de-DfJ7EKF9.js",
+        "houseplan-assets/settings-fr-Bl79E-6s.js",
+        "houseplan-assets/settings-ru-CkNFmChi.js"
       ]
     },
     {
-      "path": "houseplan-assets/de-C5SyyS-g.js",
-      "sha256": "ef9516ac6e96d228cdc51364897ade1b27ab18db8b3df955a439edacdcc1755c",
-      "rawBytes": 93068,
-      "gzipBytes": 28077,
+      "path": "houseplan-assets/de-E17v3gXt.js",
+      "sha256": "ed10d6c5e7a82b275c9422be67c2213219a75dba9aab0ddb3e98813249cbd1d0",
+      "rawBytes": 94196,
+      "gzipBytes": 28393,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/editor-UBk_opR1.js",
-      "sha256": "a6c4ec64b62623ffd5d890e378dd7f2477e5e9c1055c4e668df121dbe408de31",
+      "path": "houseplan-assets/editor-CbeYCXUv.js",
+      "sha256": "75887638c4d76040651a3cf52c56de10dc19e0cbc7583ee169d9b20cc5987788",
       "rawBytes": 3833,
       "gzipBytes": 1584,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-      "sha256": "e9fbb9d3de7353ff5fcd310358e3e1344ca841e0754f372d13e05de1c24d03f3",
+      "path": "houseplan-assets/form-kit.styles-v5DlO12L.js",
+      "sha256": "cdab9e5e612be9b98c49193a2a6287080c13f62aaefa9a28b69bac94dd934012",
       "rawBytes": 25600,
       "gzipBytes": 5056,
       "isEntry": false,
@@ -131,207 +131,207 @@
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/fr-DICKr1LR.js",
-      "sha256": "c11d2e7ea5d93f7036726de0c73efbc779a11a685829b2086726e25392fb8236",
-      "rawBytes": 95408,
-      "gzipBytes": 27623,
+      "path": "houseplan-assets/fr-CpDKyK4Z.js",
+      "sha256": "ee9fe5934eea69e549ff48d2e3fdabd7c20e0d9906a6f4623314f6eea48bf269",
+      "rawBytes": 96627,
+      "gzipBytes": 27937,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-      "sha256": "5b31912a3fb7833ef0c76c4c3c42a59207f820ba716b7d642a5f6ed9983581fd",
+      "path": "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+      "sha256": "f668d3c0a47a53e096f26728187b1666fbb6b421c1baa2ff1a649fa1ba5340d5",
       "rawBytes": 52035,
-      "gzipBytes": 16939,
+      "gzipBytes": 16940,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/houseplan-card-wgloKGAN.js",
-      "sha256": "90c434604c9242e8619d6b3118b6c4a440ac5fe2a6f720ae46a03314199a1ab2",
-      "rawBytes": 1024046,
-      "gzipBytes": 289081,
+      "path": "houseplan-assets/houseplan-card-BYwTiVnu.js",
+      "sha256": "055b6f8ba3a472be163a15ef6e2348727b5b03e3660b9362f3aed21d7be90426",
+      "rawBytes": 1059790,
+      "gzipBytes": 299520,
       "isEntry": false,
       "imports": [],
       "dynamicImports": [
-        "houseplan-assets/de-C5SyyS-g.js",
-        "houseplan-assets/editor-UBk_opR1.js",
-        "houseplan-assets/fr-DICKr1LR.js",
-        "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-        "houseplan-assets/houseplan-editor-runtime-B1wV3IoM.js",
-        "houseplan-assets/houseplan-onboarding-runtime-C5p4K-n3.js",
-        "houseplan-assets/hp-zigbee-topology-overlay-agIMleco.js",
-        "houseplan-assets/iso-scene-render-CgNVmdT-.js",
-        "houseplan-assets/live-interaction-runtime-DP9k0uiO.js",
-        "houseplan-assets/pdf-export-Chx6-v9j.js",
-        "houseplan-assets/summary-panel-runtime-loaded-Dn4v1Be3.js"
+        "houseplan-assets/de-E17v3gXt.js",
+        "houseplan-assets/editor-CbeYCXUv.js",
+        "houseplan-assets/fr-CpDKyK4Z.js",
+        "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+        "houseplan-assets/houseplan-editor-runtime-DZnn4pgB.js",
+        "houseplan-assets/houseplan-onboarding-runtime-B6AiP0fG.js",
+        "houseplan-assets/hp-zigbee-topology-overlay-8lnIEMWk.js",
+        "houseplan-assets/iso-scene-render-BxXtKC5L.js",
+        "houseplan-assets/live-interaction-runtime-CJ95X8vv.js",
+        "houseplan-assets/pdf-export-DL7VmwpB.js",
+        "houseplan-assets/summary-panel-runtime-loaded-B0Dq0vzN.js"
       ]
     },
     {
-      "path": "houseplan-assets/houseplan-editor-runtime-B1wV3IoM.js",
-      "sha256": "53b599b2b2199928f5422fea7d1e0f8b59baed159fca31b31ee71f28b300ab4e",
-      "rawBytes": 661747,
-      "gzipBytes": 184456,
+      "path": "houseplan-assets/houseplan-editor-runtime-DZnn4pgB.js",
+      "sha256": "f25cbcb0453279e3ac64eda67df52af100d96c54bb93cb657bc08c355e0484ed",
+      "rawBytes": 688848,
+      "gzipBytes": 192327,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-        "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-        "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js",
-        "houseplan-assets/zigbee-topology-CeUn5Rc9.js"
+        "houseplan-assets/backdrop-pick-WDIF6iao.js",
+        "houseplan-assets/form-kit.styles-v5DlO12L.js",
+        "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js",
+        "houseplan-assets/zigbee-topology-DOAnbvlu.js"
       ],
       "dynamicImports": [
-        "houseplan-assets/support-de-DjEcTGDl.js",
-        "houseplan-assets/support-fr-Cv3_5U35.js",
-        "houseplan-assets/support-ru-1gCA-7I4.js",
-        "houseplan-assets/zigbee-topology-runtime-Bvh9GPnT.js"
+        "houseplan-assets/support-de-DZoi-fxk.js",
+        "houseplan-assets/support-fr-Daosy89Q.js",
+        "houseplan-assets/support-ru-e8-BrqtH.js",
+        "houseplan-assets/zigbee-topology-runtime-CKlry6R8.js"
       ]
     },
     {
-      "path": "houseplan-assets/houseplan-onboarding-runtime-C5p4K-n3.js",
-      "sha256": "080e3fcbf9e5cf33022ead07b4a7af3a6bf515fcdd9c8b3b6f413f73e26b0a5d",
+      "path": "houseplan-assets/houseplan-onboarding-runtime-B6AiP0fG.js",
+      "sha256": "4ea3584c8b2bfc86f96c587549ddce49eaf0b918923df2df8e98c9c0a548f835",
       "rawBytes": 15886,
       "gzipBytes": 4908,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/backdrop-pick-D9PAJzU1.js",
-        "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js"
+        "houseplan-assets/backdrop-pick-WDIF6iao.js",
+        "houseplan-assets/form-kit.styles-v5DlO12L.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/hp-zigbee-topology-overlay-agIMleco.js",
-      "sha256": "e714d2820be641947ac777ddf38af1da0ae64eea03d2ed8db886bfa961ec69b6",
+      "path": "houseplan-assets/hp-zigbee-topology-overlay-8lnIEMWk.js",
+      "sha256": "2a0f9af108b8a39889f90d7119d8e7789716c9960ea8e28af38ada07cdc91a8c",
       "rawBytes": 10958,
-      "gzipBytes": 3766,
+      "gzipBytes": 3765,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js",
-        "houseplan-assets/zigbee-topology-CeUn5Rc9.js",
-        "houseplan-assets/zigbee-topology-runtime-Bvh9GPnT.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js",
+        "houseplan-assets/zigbee-topology-DOAnbvlu.js",
+        "houseplan-assets/zigbee-topology-runtime-CKlry6R8.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/iso-scene-render-CgNVmdT-.js",
-      "sha256": "182c8ac56aff0cd3dc8fe7269e3210af24ee1b088a390647c14ed0774cdb2991",
-      "rawBytes": 51983,
-      "gzipBytes": 17643,
+      "path": "houseplan-assets/iso-scene-render-BxXtKC5L.js",
+      "sha256": "4150eb9120fdaafa745761242ff3285056ceaccd7b016a16364574b90e3e2cfe",
+      "rawBytes": 52970,
+      "gzipBytes": 17885,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/live-interaction-runtime-DP9k0uiO.js",
-      "sha256": "4b412ce5be9be9c524e047bc3ac7e055b8434c749e4660b055a319ee62815c77",
-      "rawBytes": 8216,
-      "gzipBytes": 3209,
+      "path": "houseplan-assets/live-interaction-runtime-CJ95X8vv.js",
+      "sha256": "66e70baa00f4c9470ac9a37a229652cf5c5585caa2364de4d467a1c2ebe24358",
+      "rawBytes": 8370,
+      "gzipBytes": 3280,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/namespace-language-B_8Js-Qz.js",
-      "sha256": "2ffca62a99038ed053358910d7ac60d6059a5b9eccb0c87f524a214a4305b2fa",
+      "path": "houseplan-assets/namespace-language-zIuNvgGV.js",
+      "sha256": "244bce2d5211106846215be6a9d3dacda4c910d06020144f9ffd5e432c5e8c00",
       "rawBytes": 675,
       "gzipBytes": 410,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/pdf-export-Chx6-v9j.js",
-      "sha256": "56098fb990d71a0ef025c7f4f0a9b719eadf71b6508b8620c383eee0b6758d88",
-      "rawBytes": 236264,
-      "gzipBytes": 109887,
+      "path": "houseplan-assets/pdf-export-DL7VmwpB.js",
+      "sha256": "548dced1a8a54f860dbe57e61019d50f058d3ca13abb738d750a3c107c88de8b",
+      "rawBytes": 236714,
+      "gzipBytes": 109998,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/furniture-plan-art.generated-BSc-kiBt.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/furniture-plan-art.generated-B9UMtPsh.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/settings-de-Cin2ABDD.js",
-      "sha256": "d821bb3c8ee1104d7342e3ea1adbc2864e810883132964c71a9b45976e1350f1",
-      "rawBytes": 7248,
-      "gzipBytes": 2826,
+      "path": "houseplan-assets/settings-de-DfJ7EKF9.js",
+      "sha256": "0580b9f6191edb664c21dee21e5263489eaf22876bcad67ef12e440abc03e28a",
+      "rawBytes": 7378,
+      "gzipBytes": 2879,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/settings-fr-BJvZ83Lv.js",
-      "sha256": "9d8f5602afafd88a642549f946524eb2331585e2811409ccf27add29a2c2964b",
-      "rawBytes": 7483,
-      "gzipBytes": 2787,
+      "path": "houseplan-assets/settings-fr-Bl79E-6s.js",
+      "sha256": "f1bde9db7fe884aabd25130f783a84d8fe27bc9553923c17bcb9b82ee3976475",
+      "rawBytes": 7620,
+      "gzipBytes": 2842,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/settings-ru-8Z8TbBU8.js",
-      "sha256": "a52ca78b6101400fae4ea7daa9fcf40b7fd03a366b375179bed0379477f83565",
-      "rawBytes": 10128,
-      "gzipBytes": 3272,
+      "path": "houseplan-assets/settings-ru-CkNFmChi.js",
+      "sha256": "94f96c4a15a3a82ca8be3066629734379dd14eb2ff9e8f6acf369da2378676cb",
+      "rawBytes": 10304,
+      "gzipBytes": 3325,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/summary-panel-editor-KAuMIzz0.js",
-      "sha256": "d0e96460f0e7e77c2b4ad1b772d0e82cf59f0f230a4583efc47f25a0488af53b",
+      "path": "houseplan-assets/summary-panel-editor-C_vpFucN.js",
+      "sha256": "d45dbdfa17a1da9f45bfbca6d6c3cc98849fd5ebcc06c8f72fd6310b04b93aad",
       "rawBytes": 14862,
-      "gzipBytes": 3422,
+      "gzipBytes": 3425,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/summary-panel-runtime-loaded-Dn4v1Be3.js"
+        "houseplan-assets/form-kit.styles-v5DlO12L.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/summary-panel-runtime-loaded-B0Dq0vzN.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/summary-panel-metrics-DQ7R-pgx.js",
-      "sha256": "903bf4dcfb58f0795be1ea4ff0d9a8dc8fc206cdb30033468854ae14200b8d27",
-      "rawBytes": 2611,
-      "gzipBytes": 1305,
+      "path": "houseplan-assets/summary-panel-metrics-D47J-OjO.js",
+      "sha256": "909d2195fcfca30c2f1279e07e2d7506d470c3daec6fe864c97f7ecc4101e33d",
+      "rawBytes": 2701,
+      "gzipBytes": 1344,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/summary-panel-runtime-loaded-Dn4v1Be3.js",
-      "sha256": "13b2137a459d64d1c747412a9ba20107721bca23b80b54726c7f6cf11409182e",
-      "rawBytes": 72637,
-      "gzipBytes": 20164,
+      "path": "houseplan-assets/summary-panel-runtime-loaded-B0Dq0vzN.js",
+      "sha256": "e44860a1af9ec7ffc7ac289c8c76ed1d0dcf0177bd91bbfe1981fdd0d4a62c46",
+      "rawBytes": 72959,
+      "gzipBytes": 20242,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/form-kit.styles-DsvoJy1B.js",
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/form-kit.styles-v5DlO12L.js",
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": [
-        "houseplan-assets/summary-panel-editor-KAuMIzz0.js",
-        "houseplan-assets/summary-panel-metrics-DQ7R-pgx.js"
+        "houseplan-assets/summary-panel-editor-C_vpFucN.js",
+        "houseplan-assets/summary-panel-metrics-D47J-OjO.js"
       ]
     },
     {
-      "path": "houseplan-assets/support-de-DjEcTGDl.js",
-      "sha256": "134607110e599996586ac05e4e30589974b476e453f5dd349d6a046e7a53f051",
+      "path": "houseplan-assets/support-de-DZoi-fxk.js",
+      "sha256": "f01d2d00a169519f5f402e99e9c85c9f21a23aeee2a9605d4444910f3250d6de",
       "rawBytes": 6167,
       "gzipBytes": 2396,
       "isEntry": false,
@@ -339,17 +339,17 @@
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/support-fr-Cv3_5U35.js",
-      "sha256": "c68c241ec56465d6bc18dc99fd80347890e2bf0efbe14d376777611089112d95",
+      "path": "houseplan-assets/support-fr-Daosy89Q.js",
+      "sha256": "e503a1b4e1b1ed31d8fa09bfe0cdc069a82c1d1627d40407472b336fbc98ccf5",
       "rawBytes": 6333,
-      "gzipBytes": 2431,
+      "gzipBytes": 2432,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/support-ru-1gCA-7I4.js",
-      "sha256": "a4502dbcdc677749b1d6dca3030b6722c80effaac2ff1202e429b40b7fed4813",
+      "path": "houseplan-assets/support-ru-e8-BrqtH.js",
+      "sha256": "76742313c4b510163c380f8fd9c7fcaf1cc7f8bde6a41bcb0da48621a7c3a3b3",
       "rawBytes": 8376,
       "gzipBytes": 2876,
       "isEntry": false,
@@ -357,8 +357,8 @@
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/topology-de-DIRlNRIt.js",
-      "sha256": "5fe141bdf29abf6198cff5582a7f507b1def5943747904782078c2fa1ba57db5",
+      "path": "houseplan-assets/topology-de-Cs36ouVE.js",
+      "sha256": "7c808f1139bb1c232627bfe884a579177ec653d16147d6b96066851893b312a4",
       "rawBytes": 2698,
       "gzipBytes": 1337,
       "isEntry": false,
@@ -366,8 +366,8 @@
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/topology-fr-DKHD0XtF.js",
-      "sha256": "9be24d7f25bee0addb5eed667016550d10510bd05b4cc27d9c3947f559e8e05a",
+      "path": "houseplan-assets/topology-fr-B8yoJGvc.js",
+      "sha256": "6ee1530fd0bd7a8c476c79b83404c7d8a5b98cd0b86ee8a73048be75a70cc2c4",
       "rawBytes": 2718,
       "gzipBytes": 1354,
       "isEntry": false,
@@ -375,62 +375,62 @@
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/topology-ru-3tAB4nhw.js",
-      "sha256": "ff8146d2424196ace5d60c408c63e797118f3f0cce051eee95c1bc588a6870a8",
+      "path": "houseplan-assets/topology-ru-BRKShmrQ.js",
+      "sha256": "7fc89542fa860318d459ce1467a5a8931f3214a9d17f57c177ba01f2cfbbd3e8",
       "rawBytes": 3669,
-      "gzipBytes": 1615,
+      "gzipBytes": 1616,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/zigbee-topology-CeUn5Rc9.js",
-      "sha256": "9cfec64fc8c76128959185a12e5cab8e776424b5093c0a9c5593aa207a6802a4",
+      "path": "houseplan-assets/zigbee-topology-DOAnbvlu.js",
+      "sha256": "313f71677ba0739d9c978185c2136e73e8037b770eb3f9ef8561f692d654406f",
       "rawBytes": 10958,
       "gzipBytes": 4299,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js"
       ],
       "dynamicImports": [
-        "houseplan-assets/topology-de-DIRlNRIt.js",
-        "houseplan-assets/topology-fr-DKHD0XtF.js",
-        "houseplan-assets/topology-ru-3tAB4nhw.js"
+        "houseplan-assets/topology-de-Cs36ouVE.js",
+        "houseplan-assets/topology-fr-B8yoJGvc.js",
+        "houseplan-assets/topology-ru-BRKShmrQ.js"
       ]
     },
     {
-      "path": "houseplan-assets/zigbee-topology-runtime-Bvh9GPnT.js",
-      "sha256": "8a7ed7c8868e8dec1dbd535c69eed0b3f847eb092fa5de0a36013b4b4f99dc8e",
+      "path": "houseplan-assets/zigbee-topology-runtime-CKlry6R8.js",
+      "sha256": "39e4a250de0e67e80d8afc02c39c1a79e42d4b3e113107bb3817f4fa90cab1e2",
       "rawBytes": 3983,
       "gzipBytes": 1789,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js",
-        "houseplan-assets/namespace-language-B_8Js-Qz.js",
-        "houseplan-assets/zigbee-topology-CeUn5Rc9.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js",
+        "houseplan-assets/namespace-language-zIuNvgGV.js",
+        "houseplan-assets/zigbee-topology-DOAnbvlu.js"
       ],
       "dynamicImports": []
     },
     {
       "path": "houseplan-card.js",
-      "sha256": "2363f980f0597b50bbbc791f21c968f5754c0c773379ecb071a792a9f5f72168",
+      "sha256": "d4b480db1327152db7b1459c45692ea6b72fb7ac3bccb525bc06adfe1aab3b8d",
       "rawBytes": 1205,
       "gzipBytes": 803,
       "isEntry": true,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     },
     {
       "path": "houseplan-panel.js",
-      "sha256": "7d016435f0163a48ed79d8b9f115180fffc17dc0a2a1420b9e938da783ea34a9",
+      "sha256": "5aaa677a9c85f4df0f176be31a91ebb5022f5ce129774919269bb0409c310233",
       "rawBytes": 6165,
-      "gzipBytes": 2326,
+      "gzipBytes": 2325,
       "isEntry": true,
       "imports": [
-        "houseplan-assets/houseplan-card-wgloKGAN.js"
+        "houseplan-assets/houseplan-card-BYwTiVnu.js"
       ],
       "dynamicImports": []
     }

custom_components/houseplan/frontend/houseplan-assets/editor-CbeYCXUv.js

@@ -1,14 +1,14 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";import{aD as e,l as o,aG as t,ee as s,A as a,ef as i,eg as l,eh as n,E as r,c}from"./houseplan-card-wgloKGAN.js";class h extends e{constructor(){super(...arguments),this._spaces=null,this._spacesLoading=!1,this._spacesAuthoritative=!1}setConfig(e){this._config=e}async _loadSpaces(){if(!this._spaces&&!this._spacesLoading&&this.hass){this._spacesLoading=!0;try{const e=await this.hass.callWS({type:"houseplan/config/get"});this._spaces=(e?.config?.spaces||[]).map(e=>({value:e.id,label:e.title||e.id})),this._spacesAuthoritative=!0}catch{this._spaces=[],this._spacesAuthoritative=!1}finally{this._spacesLoading=!1}}}get _lang(){return o(this.hass,this._config?.language)}get _floorToken(){const e=this._config?.floor;return"number"==typeof e?`__houseplan_yaml_floor_index__:${String(e)}`:null}get _formData(){const e={...this._config},o=this._floorToken;return o?e.floor=o:Object.prototype.hasOwnProperty.call(e,"floor")||(e.floor=""),e}get _schema(){const e=this._spaces||[],o=this._lang,a=[{value:"",label:t(o,"editor.floor_none")}],i=this._floorToken;i&&a.push({value:i,label:t(o,"editor.floor_index",{index:String(this._config?.floor)})});const l="string"==typeof this._config?.floor?this._config.floor:"";l&&!e.some(e=>e.value===l)&&a.push({value:l,label:l}),a.push(...e);const n="string"==typeof this._config?.default_floor?this._config.default_floor:"",r=[...e];return n&&!e.some(e=>e.value===n)&&r.unshift({value:n,label:n}),[{name:"title",selector:{text:{}}},{name:"floor",selector:{select:{mode:"dropdown",options:a}}},e.length?{name:"default_floor",selector:{select:{mode:"dropdown",options:r}}}:{name:"default_floor",selector:{text:{}}},{name:"language",selector:{select:{mode:"dropdown",options:s(t(o,"editor.lang_auto"),this._config?.language)}}},{name:"icon_size",selector:{number:{min:1,max:6,step:.1,mode:"box"}}},{name:"show_temperature",selector:{boolean:{}}},{name:"live_states",selector:{boolean:{}}},{name:"show_signal",selector:{boolean:{}}},{name:"kiosk",selector:{boolean:{}}},{name:"cycle",selector:{number:{min:0,max:3600,step:5,mode:"box"}}}]}render(){if(!this.hass||!this._config)return a;const e=i(this,l,o(this.hass,this._config.language));if("cold"===e)return n();if("warm"===e)return r;this._loadSpaces();const s=this._lang,h={title:t(s,"editor.title"),floor:t(s,"editor.floor"),default_floor:t(s,"editor.default_floor"),language:t(s,"editor.language"),icon_size:t(s,"editor.icon_size"),show_temperature:t(s,"editor.show_temperature"),live_states:t(s,"editor.live_states"),show_signal:t(s,"editor.show_signal"),kiosk:t(s,"editor.kiosk"),cycle:t(s,"editor.cycle")},f=this._schema,_=function(e,o,t){if(!t||null===o)return null;const s="string"==typeof e?.default_floor?e.default_floor:"";return!s||o.some(e=>e.value===s)?null:s}(this._config,this._spaces,this._spacesAuthoritative),d=e=>c`<ha-form
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";import{aD as e,l as o,aG as t,ez as s,A as a,eA as i,eB as l,eC as n,E as r,c}from"./houseplan-card-BYwTiVnu.js";class f extends e{constructor(){super(...arguments),this._spaces=null,this._spacesLoading=!1,this._spacesAuthoritative=!1}setConfig(e){this._config=e}async _loadSpaces(){if(!this._spaces&&!this._spacesLoading&&this.hass){this._spacesLoading=!0;try{const e=await this.hass.callWS({type:"houseplan/config/get"});this._spaces=(e?.config?.spaces||[]).map(e=>({value:e.id,label:e.title||e.id})),this._spacesAuthoritative=!0}catch{this._spaces=[],this._spacesAuthoritative=!1}finally{this._spacesLoading=!1}}}get _lang(){return o(this.hass,this._config?.language)}get _floorToken(){const e=this._config?.floor;return"number"==typeof e?`__houseplan_yaml_floor_index__:${String(e)}`:null}get _formData(){const e={...this._config},o=this._floorToken;return o?e.floor=o:Object.prototype.hasOwnProperty.call(e,"floor")||(e.floor=""),e}get _schema(){const e=this._spaces||[],o=this._lang,a=[{value:"",label:t(o,"editor.floor_none")}],i=this._floorToken;i&&a.push({value:i,label:t(o,"editor.floor_index",{index:String(this._config?.floor)})});const l="string"==typeof this._config?.floor?this._config.floor:"";l&&!e.some(e=>e.value===l)&&a.push({value:l,label:l}),a.push(...e);const n="string"==typeof this._config?.default_floor?this._config.default_floor:"",r=[...e];return n&&!e.some(e=>e.value===n)&&r.unshift({value:n,label:n}),[{name:"title",selector:{text:{}}},{name:"floor",selector:{select:{mode:"dropdown",options:a}}},e.length?{name:"default_floor",selector:{select:{mode:"dropdown",options:r}}}:{name:"default_floor",selector:{text:{}}},{name:"language",selector:{select:{mode:"dropdown",options:s(t(o,"editor.lang_auto"),this._config?.language)}}},{name:"icon_size",selector:{number:{min:1,max:6,step:.1,mode:"box"}}},{name:"show_temperature",selector:{boolean:{}}},{name:"live_states",selector:{boolean:{}}},{name:"show_signal",selector:{boolean:{}}},{name:"kiosk",selector:{boolean:{}}},{name:"cycle",selector:{number:{min:0,max:3600,step:5,mode:"box"}}}]}render(){if(!this.hass||!this._config)return a;const e=i(this,l,o(this.hass,this._config.language));if("cold"===e)return n();if("warm"===e)return r;this._loadSpaces();const s=this._lang,f={title:t(s,"editor.title"),floor:t(s,"editor.floor"),default_floor:t(s,"editor.default_floor"),language:t(s,"editor.language"),icon_size:t(s,"editor.icon_size"),show_temperature:t(s,"editor.show_temperature"),live_states:t(s,"editor.live_states"),show_signal:t(s,"editor.show_signal"),kiosk:t(s,"editor.kiosk"),cycle:t(s,"editor.cycle")},h=this._schema,_=function(e,o,t){if(!t||null===o)return null;const s="string"==typeof e?.default_floor?e.default_floor:"";return!s||o.some(e=>e.value===s)?null:s}(this._config,this._spaces,this._spacesAuthoritative),d=e=>c`<ha-form
         .hass=${this.hass}
         .data=${this._formData}
         .schema=${e}
-        .computeLabel=${e=>h[e.name]||e.name}
+        .computeLabel=${e=>f[e.name]||e.name}
         @value-changed=${this._valueChanged}
       ></ha-form>`;return c`
-      ${d(f.slice(0,3))}
+      ${d(h.slice(0,3))}
       ${_?c`<div class="default-floor-error" role="alert"
         style="color:var(--error-color,#db4437);margin:-4px 0 12px;overflow-wrap:anywhere">
         ${t(s,"editor.default_floor_missing",{id:_})}
       </div>`:a}
-      ${d(f.slice(3))}
-    `}_valueChanged(e){const o={...this._config,...e.detail.value};""===o.floor?delete o.floor:o.floor===this._floorToken&&(o.floor=this._config?.floor);const t=new Event("config-changed",{bubbles:!0,composed:!0});t.detail={config:o},this.dispatchEvent(t)}}h.properties={hass:{attribute:!1},_config:{state:!0},_spaces:{state:!0}},customElements.get("houseplan-card-editor")||customElements.define("houseplan-card-editor",h);
+      ${d(h.slice(3))}
+    `}_valueChanged(e){const o={...this._config,...e.detail.value};""===o.floor?delete o.floor:o.floor===this._floorToken&&(o.floor=this._config?.floor);const t=new Event("config-changed",{bubbles:!0,composed:!0});t.detail={config:o},this.dispatchEvent(t)}}f.properties={hass:{attribute:!1},_config:{state:!0},_spaces:{state:!0}},customElements.get("houseplan-card-editor")||customElements.define("houseplan-card-editor",f);

custom_components/houseplan/frontend/houseplan-assets/namespace-language-B_8Js-Qz.js

@@ -1 +0,0 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";import{ej as e,ek as a,eg as n}from"./houseplan-card-wgloKGAN.js";function o(n,o){return new e([{code:"en",dictionary:n},{code:"ru",loadDictionary:o.ru},{code:"de",loadDictionary:o.de},{code:"fr",loadDictionary:o.fr}],"71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9",console.warn,a)}function r(e){return function(e,a){return{state:n=>{const o=e.state(n);return"pending"!==o&&a.some(e=>"pending"===e.state(n))?"pending":o},dictionary:a=>e.dictionary(a),ensure:n=>Promise.all([e,...a].map(e=>e.ensure(n))).then(()=>{})}}(n,e)}export{o as n,r as s};

custom_components/houseplan/frontend/houseplan-assets/namespace-language-zIuNvgGV.js

@@ -0,0 +1 @@
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";import{eE as e,eF as n,eB as a}from"./houseplan-card-BYwTiVnu.js";function c(a,c){return new e([{code:"en",dictionary:a},{code:"ru",loadDictionary:c.ru},{code:"de",loadDictionary:c.de},{code:"fr",loadDictionary:c.fr}],"a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e",console.warn,n)}function o(e){return function(e,n){return{state:a=>{const c=e.state(a);return"pending"!==c&&n.some(e=>"pending"===e.state(a))?"pending":c},dictionary:n=>e.dictionary(n),ensure:a=>Promise.all([e,...n].map(e=>e.ensure(a))).then(()=>{})}}(a,e)}export{c as n,o as s};

custom_components/houseplan/frontend/houseplan-assets/summary-panel-editor-C_vpFucN.js

@@ -1,4 +1,4 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";import{c as a,A as e}from"./houseplan-card-wgloKGAN.js";import{s,n as t,a as l,m as r,b as o,c as i,d as u}from"./summary-panel-runtime-loaded-Dn4v1Be3.js";import"./form-kit.styles-DsvoJy1B.js";const m=m=>{const{host:c,dialog:d,problems:n,t:b}=m,y=n.find(a=>"error"===a.kind),$=d.localShow!==d.baseLocalShow||!d.localOnly&&!s(t(d.draft),d.base),p=$&&!d.busy&&!y,v=a=>n.find(e=>e.path===a),h=a=>a?b(`summary.problem.${a.code}`):"",k=()=>m.close(),g=a`<label class="summary-switch" for="summary-local-show">
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";import{c as a,A as e}from"./houseplan-card-BYwTiVnu.js";import{s,n as t,a as l,m as r,b as o,c as i,d as u}from"./summary-panel-runtime-loaded-B0Dq0vzN.js";import"./form-kit.styles-v5DlO12L.js";const m=m=>{const{host:c,dialog:d,problems:n,t:b}=m,y=n.find(a=>"error"===a.kind),$=d.localShow!==d.baseLocalShow||!d.localOnly&&!s(t(d.draft),d.base),p=$&&!d.busy&&!y,v=a=>n.find(e=>e.path===a),h=a=>a?b(`summary.problem.${a.code}`):"",k=()=>m.close(),g=a`<label class="summary-switch" for="summary-local-show">
     <span class="summary-switch-caption"><strong>${b("summary.show_local")}</strong>
       <small id="summary-local-show-hint">${b("summary.show_local_hint")}</small></span>
     <input id="summary-local-show" data-summary-local-show type="checkbox"

custom_components/houseplan/frontend/houseplan-assets/summary-panel-metrics-D47J-OjO.js

@@ -0,0 +1 @@
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";import{eH as e,N as t,b2 as n,L as i,ae as o,ac as r,c9 as s,eI as a,c8 as c,b1 as l,b0 as d,b3 as u,eJ as f,eK as m,cb as g,eL as v}from"./houseplan-card-BYwTiVnu.js";function y(e){if(!e.registry.authoritative)return null;const t=new Set,n=u(e.markers);for(const i of Object.values(e.registry.devices||{}))i?.id&&"service"!==i.entry_type&&!n.devices.has(i.id)&&i.area_id&&e.areaToSpace[i.area_id]&&t.add(i.id);for(const i of e.markers||[]){if(i.removed||"virtual"===i.binding)continue;const o=String(i.binding||"").indexOf(":");if(o<1)continue;const r=i.binding.slice(0,o),s=i.binding.slice(o+1),a="device"===r?e.registry.devices?.[s]:null,c="entity"===r?e.registry.entities?.[s]:null,l="device"===r?s:c?.device_id,d="device"===r?a?.area_id:c?.area_id||l&&e.registry.devices?.[l]?.area_id,u="string"==typeof i.room_id&&i.room_id.length>0&&null===i.area?"":i.area||d||"",f=u&&e.areaToSpace[u]||i.space||e.firstSpaceId;l&&e.registry.devices?.[l]&&e.spaceIds.has(f)&&(!n.devices.has(l)||"entity"===r&&n.liveEntities.has(s))&&t.add(l)}return t}function _(e,t){return e?.length?t?.length?v(e,t):e:t}function h(e,t){const n=l(e.rooms,t.walls,t.openCuts,[],i,t.cellCm,o,r);return{roomGeom:"ok"===n.status||"degraded-extra"===n.status?n.roomGeom:void 0,multiWallNodes:d(e.rooms,t.walls,t.openCuts,i,t.cellCm,o,r)}}function*p(l,d,u=h){try{let f=0;for(const m of d){const d=l.spaces.find(e=>String(e?.id)===m.id);if(!d)continue;const g=e(d,m),v=u(m,g);let y=null;for(const e of m.rooms){if(!e.id)continue;const a=t(e);if(!a)continue;const c=n(m.rooms,e.id,g.walls,g.openCuts,i,g.cellCm,o,r,v.roomGeom,v.multiWallNodes)||a;y=_(y,s(c,g.physicalBodies)),yield}const h=a(y||[],m.stairs);let p=h.next();for(;!p.done;)yield,p=h.next();y=p.value;const b=g.cellCm/o;f+=c(y)*b*b/1e4}return f}catch{return null}}function b(e,t,n=h){const i=p(e,t,n);let o=i.next();for(;!o.done;)o=i.next();return o.value}function S(e,t,n,i){if("system"!==e.type)return null;if("device_count"===e.key)return null===t.deviceCount?null:String(t.deviceCount);if("total_area"===e.key)return null===t.areaM2?null:g(t.areaM2,"mi"===n?.config?.unit_system?.length);try{return new Intl.DateTimeFormat(i||void 0,{dateStyle:"short",timeStyle:"short",timeZone:n?.config?.time_zone||void 0}).format(t.now)}catch{return t.now.toLocaleString()}}function C(e,t){const n=e?.states?.[t];if(!n)return null;const i=f(e,t);return i?m(i,String(n.attributes?.unit_of_measurement||"")):null}export{p as cleanFloorAreaSteps,y as representedHaDeviceIds,h as spaceWallGeometry,C as summaryEntityValue,S as summarySystemValue,b as totalCleanFloorAreaM2};

custom_components/houseplan/frontend/houseplan-assets/summary-panel-metrics-DQ7R-pgx.js

@@ -1 +0,0 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";import{em as e,N as t,a$ as n,L as i,ae as o,ac as r,bW as s,bV as a,a_ as c,aZ as l,b0 as u,en as d,eo as f,bY as m,ep as g}from"./houseplan-card-wgloKGAN.js";function v(e){if(!e.registry.authoritative)return null;const t=new Set,n=u(e.markers);for(const i of Object.values(e.registry.devices||{}))i?.id&&"service"!==i.entry_type&&!n.devices.has(i.id)&&i.area_id&&e.areaToSpace[i.area_id]&&t.add(i.id);for(const i of e.markers||[]){if(i.removed||"virtual"===i.binding)continue;const o=String(i.binding||"").indexOf(":");if(o<1)continue;const r=i.binding.slice(0,o),s=i.binding.slice(o+1),a="device"===r?e.registry.devices?.[s]:null,c="entity"===r?e.registry.entities?.[s]:null,l="device"===r?s:c?.device_id,u="device"===r?a?.area_id:c?.area_id||l&&e.registry.devices?.[l]?.area_id,d="string"==typeof i.room_id&&i.room_id.length>0&&null===i.area?"":i.area||u||"",f=d&&e.areaToSpace[d]||i.space||e.firstSpaceId;l&&e.registry.devices?.[l]&&e.spaceIds.has(f)&&(!n.devices.has(l)||"entity"===r&&n.liveEntities.has(s))&&t.add(l)}return t}function y(e,t){return e?.length?t?.length?g(e,t):e:t}function _(e,t){const n=c(e.rooms,t.walls,t.openCuts,[],i,t.cellCm,o,r);return{roomGeom:"ok"===n.status||"degraded-extra"===n.status?n.roomGeom:void 0,multiWallNodes:l(e.rooms,t.walls,t.openCuts,i,t.cellCm,o,r)}}function*p(c,l,u=_){try{let d=0;for(const f of l){const l=c.spaces.find(e=>String(e?.id)===f.id);if(!l)continue;const m=e(l,f),g=u(f,m);let v=null;for(const e of f.rooms){if(!e.id)continue;const a=t(e);if(!a)continue;const c=n(f.rooms,e.id,m.walls,m.openCuts,i,m.cellCm,o,r,g.roomGeom,g.multiWallNodes)||a;v=y(v,s(c,m.physicalBodies)),yield}const _=m.cellCm/o;d+=a(v)*_*_/1e4}return d}catch{return null}}function h(e,t,n=_){const i=p(e,t,n);let o=i.next();for(;!o.done;)o=i.next();return o.value}function b(e,t,n,i){if("system"!==e.type)return null;if("device_count"===e.key)return null===t.deviceCount?null:String(t.deviceCount);if("total_area"===e.key)return null===t.areaM2?null:m(t.areaM2,"mi"===n?.config?.unit_system?.length);try{return new Intl.DateTimeFormat(i||void 0,{dateStyle:"short",timeStyle:"short",timeZone:n?.config?.time_zone||void 0}).format(t.now)}catch{return t.now.toLocaleString()}}function S(e,t){const n=e?.states?.[t];if(!n)return null;const i=d(e,t);return i?f(i,String(n.attributes?.unit_of_measurement||"")):null}export{p as cleanFloorAreaSteps,v as representedHaDeviceIds,_ as spaceWallGeometry,S as summaryEntityValue,b as summarySystemValue,h as totalCleanFloorAreaM2};

custom_components/houseplan/frontend/houseplan-assets/topology-de-Cs36ouVE.js

@@ -1 +1 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";var e={title:"Zigbee-Verbindungen",toggle:"Zigbee-Verbindungen beim Darüberfahren über ein Gerät anzeigen",hint:"Es werden nur beobachtete direkte Nachbarn angezeigt. Beim Darüberfahren werden keine Daten abgerufen.",help:"Zeigt, mit welchen Zigbee-Geräten jedes Gerät direkt verbunden ist. Die Linienfarbe ist die Verbindungsqualität (LQI) auf derselben Skala wie der LQI-Wert des Geräts: rot bei 40 und darunter, grün bei 180 und darüber. Eine gestrichelte Linie bedeutet, dass die Qualität nicht gemeldet wurde. Ein Pfeil zeigt auf das nächste Gerät auf dem Weg zum Koordinator: ein Pfeil führt hinaus, eingehende Pfeile sind die Geräte, die über dieses Gerät routen. Eine Linie ohne Pfeil ist ein Ersatznachbar. Das ist der Routenbaum, den House Plan bildet, nicht der Weg eines Pakets in diesem Moment: eine Beschriftung am Pfeilende bedeutet, dass das Ziel nicht auf diesem Plan liegt, und ein fehlender Pfeil, dass die Route unbekannt ist. Die Daten stammen aus dem letzten Laden und veralten; Verbindungen sind nur mit der Maus sichtbar.",help_aria:"Hilfe: Zigbee-Verbindungen",admin_only:"Topologiedaten sind nur für Home-Assistant-Administratoren verfügbar.",save_first:"Speichere diese Einstellung, bevor Topologiedaten geladen werden.",zha:"ZHA",zha_read:"ZHA-Daten lesen",zha_hint:"Liest den ZHA-Topologiecache; es wird kein Funkscan gestartet.",z2m:"Zigbee2MQTT",z2m_topics:"Basistopics (eines pro Zeile)",z2m_update:"Karte aktualisieren",z2m_warning:"Ein Netzwerkscan kann 10 Sekunden bis 2 Minuten dauern und Zigbee vorübergehend verlangsamen.",status_idle:"Daten nicht geladen",status_loading:"Wird geladen…",status_ready:"Empfangen: {time}",status_stale:"Empfangen: {time} · veraltet",status_partial:"Empfangen: {time} · einige Knoten fehlen",status_no_links:"Empfangen: {time} · keine beobachteten Verbindungen gefunden",error_permission:"Administratorrechte sind erforderlich.",error_unsupported:"Dieser Anbieter oder die Home-Assistant-API ist nicht verfügbar.",error_timeout:"Der Anbieter hat nicht rechtzeitig geantwortet.",error_invalid_topic:"Prüfe das Zigbee2MQTT-Basistopic.",error_invalid_payload:"Der Anbieter hat nicht unterstützte Topologiedaten geliefert.",error_provider:"Topologiedaten konnten nicht geladen werden.",remote_count:"+{n} in anderen Bereichen",route_device_not_on_plan:"Gerät ist nicht im Plan",route_coordinator_not_on_plan:"Koordinator ist nicht im Plan",route_other_space:"anderer Bereich"};const n="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";export{e as dictionary,n as fingerprint};
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";var e={title:"Zigbee-Verbindungen",toggle:"Zigbee-Verbindungen beim Darüberfahren über ein Gerät anzeigen",hint:"Es werden nur beobachtete direkte Nachbarn angezeigt. Beim Darüberfahren werden keine Daten abgerufen.",help:"Zeigt, mit welchen Zigbee-Geräten jedes Gerät direkt verbunden ist. Die Linienfarbe ist die Verbindungsqualität (LQI) auf derselben Skala wie der LQI-Wert des Geräts: rot bei 40 und darunter, grün bei 180 und darüber. Eine gestrichelte Linie bedeutet, dass die Qualität nicht gemeldet wurde. Ein Pfeil zeigt auf das nächste Gerät auf dem Weg zum Koordinator: ein Pfeil führt hinaus, eingehende Pfeile sind die Geräte, die über dieses Gerät routen. Eine Linie ohne Pfeil ist ein Ersatznachbar. Das ist der Routenbaum, den House Plan bildet, nicht der Weg eines Pakets in diesem Moment: eine Beschriftung am Pfeilende bedeutet, dass das Ziel nicht auf diesem Plan liegt, und ein fehlender Pfeil, dass die Route unbekannt ist. Die Daten stammen aus dem letzten Laden und veralten; Verbindungen sind nur mit der Maus sichtbar.",help_aria:"Hilfe: Zigbee-Verbindungen",admin_only:"Topologiedaten sind nur für Home-Assistant-Administratoren verfügbar.",save_first:"Speichere diese Einstellung, bevor Topologiedaten geladen werden.",zha:"ZHA",zha_read:"ZHA-Daten lesen",zha_hint:"Liest den ZHA-Topologiecache; es wird kein Funkscan gestartet.",z2m:"Zigbee2MQTT",z2m_topics:"Basistopics (eines pro Zeile)",z2m_update:"Karte aktualisieren",z2m_warning:"Ein Netzwerkscan kann 10 Sekunden bis 2 Minuten dauern und Zigbee vorübergehend verlangsamen.",status_idle:"Daten nicht geladen",status_loading:"Wird geladen…",status_ready:"Empfangen: {time}",status_stale:"Empfangen: {time} · veraltet",status_partial:"Empfangen: {time} · einige Knoten fehlen",status_no_links:"Empfangen: {time} · keine beobachteten Verbindungen gefunden",error_permission:"Administratorrechte sind erforderlich.",error_unsupported:"Dieser Anbieter oder die Home-Assistant-API ist nicht verfügbar.",error_timeout:"Der Anbieter hat nicht rechtzeitig geantwortet.",error_invalid_topic:"Prüfe das Zigbee2MQTT-Basistopic.",error_invalid_payload:"Der Anbieter hat nicht unterstützte Topologiedaten geliefert.",error_provider:"Topologiedaten konnten nicht geladen werden.",remote_count:"+{n} in anderen Bereichen",route_device_not_on_plan:"Gerät ist nicht im Plan",route_coordinator_not_on_plan:"Koordinator ist nicht im Plan",route_other_space:"anderer Bereich"};const n="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";export{e as dictionary,n as fingerprint};

custom_components/houseplan/frontend/houseplan-assets/topology-fr-B8yoJGvc.js

@@ -1 +1 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";var e={title:"Liens Zigbee",toggle:"Afficher les liens Zigbee au survol d’un appareil",hint:"Seuls les voisins directs observés sont affichés. Le survol ne lance aucune requête.",help:"Montre avec quels appareils Zigbee chaque appareil communique directement. La couleur de la ligne est la qualité du lien (LQI) sur la même échelle que l'indicateur LQI de l'appareil : rouge à 40 et en dessous, vert à 180 et au-dessus. Une ligne pointillée signifie que la qualité n'a pas été communiquée. Une flèche pointe vers l'appareil suivant sur le chemin du coordinateur : une flèche part, les flèches entrantes sont les appareils qui passent par celui-ci. Une ligne sans flèche est un voisin de secours. C'est l'arbre de routes que construit House Plan, pas le trajet d'un paquet à cet instant : une étiquette au bout d'une flèche signifie que sa cible n'est pas sur ce plan, et l'absence de flèche que la route est inconnue. Les données proviennent du dernier chargement et vieillissent ; les liens ne sont visibles qu'à la souris.",help_aria:"Aide : liens Zigbee",admin_only:"Les données de topologie sont réservées aux administrateurs Home Assistant.",save_first:"Enregistrez ce réglage avant de charger les données de topologie.",zha:"ZHA",zha_read:"Lire les données ZHA",zha_hint:"Lit la topologie en cache de ZHA sans lancer d’analyse radio.",z2m:"Zigbee2MQTT",z2m_topics:"Topics de base (un par ligne)",z2m_update:"Actualiser la carte",z2m_warning:"L’analyse de la carte réseau peut durer de 10 secondes à 2 minutes et réduire temporairement la réactivité de Zigbee.",status_idle:"Données non chargées",status_loading:"Chargement…",status_ready:"Reçu : {time}",status_stale:"Reçu : {time} · obsolète",status_partial:"Reçu : {time} · certains nœuds sont omis",status_no_links:"Reçu : {time} · aucun lien observé trouvé",error_permission:"Les droits administrateur sont requis.",error_unsupported:"Ce fournisseur ou l’API Home Assistant n’est pas disponible.",error_timeout:"Le fournisseur n’a pas répondu à temps.",error_invalid_topic:"Vérifiez le topic de base Zigbee2MQTT.",error_invalid_payload:"Le fournisseur a renvoyé des données de topologie non prises en charge.",error_provider:"Impossible de charger les données de topologie.",remote_count:"+{n} dans d’autres espaces",route_device_not_on_plan:"appareil absent du plan",route_coordinator_not_on_plan:"coordinateur absent du plan",route_other_space:"autre espace"};const s="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";export{e as dictionary,s as fingerprint};
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";var e={title:"Liens Zigbee",toggle:"Afficher les liens Zigbee au survol d’un appareil",hint:"Seuls les voisins directs observés sont affichés. Le survol ne lance aucune requête.",help:"Montre avec quels appareils Zigbee chaque appareil communique directement. La couleur de la ligne est la qualité du lien (LQI) sur la même échelle que l'indicateur LQI de l'appareil : rouge à 40 et en dessous, vert à 180 et au-dessus. Une ligne pointillée signifie que la qualité n'a pas été communiquée. Une flèche pointe vers l'appareil suivant sur le chemin du coordinateur : une flèche part, les flèches entrantes sont les appareils qui passent par celui-ci. Une ligne sans flèche est un voisin de secours. C'est l'arbre de routes que construit House Plan, pas le trajet d'un paquet à cet instant : une étiquette au bout d'une flèche signifie que sa cible n'est pas sur ce plan, et l'absence de flèche que la route est inconnue. Les données proviennent du dernier chargement et vieillissent ; les liens ne sont visibles qu'à la souris.",help_aria:"Aide : liens Zigbee",admin_only:"Les données de topologie sont réservées aux administrateurs Home Assistant.",save_first:"Enregistrez ce réglage avant de charger les données de topologie.",zha:"ZHA",zha_read:"Lire les données ZHA",zha_hint:"Lit la topologie en cache de ZHA sans lancer d’analyse radio.",z2m:"Zigbee2MQTT",z2m_topics:"Topics de base (un par ligne)",z2m_update:"Actualiser la carte",z2m_warning:"L’analyse de la carte réseau peut durer de 10 secondes à 2 minutes et réduire temporairement la réactivité de Zigbee.",status_idle:"Données non chargées",status_loading:"Chargement…",status_ready:"Reçu : {time}",status_stale:"Reçu : {time} · obsolète",status_partial:"Reçu : {time} · certains nœuds sont omis",status_no_links:"Reçu : {time} · aucun lien observé trouvé",error_permission:"Les droits administrateur sont requis.",error_unsupported:"Ce fournisseur ou l’API Home Assistant n’est pas disponible.",error_timeout:"Le fournisseur n’a pas répondu à temps.",error_invalid_topic:"Vérifiez le topic de base Zigbee2MQTT.",error_invalid_payload:"Le fournisseur a renvoyé des données de topologie non prises en charge.",error_provider:"Impossible de charger les données de topologie.",remote_count:"+{n} dans d’autres espaces",route_device_not_on_plan:"appareil absent du plan",route_coordinator_not_on_plan:"coordinateur absent du plan",route_other_space:"autre espace"};const s="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";export{e as dictionary,s as fingerprint};

custom_components/houseplan/frontend/houseplan-assets/topology-ru-BRKShmrQ.js

@@ -1 +1 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";var e={title:"Связи Zigbee",toggle:"Показывать связи Zigbee при наведении на устройство",hint:"Показываются только наблюдаемые прямые соседи. Наведение ничего не запрашивает.",help:"Показывает, с какими устройствами Zigbee каждое связано напрямую. Цвет линии — качество связи (LQI) по той же шкале, что у показателя LQI устройства: красный при 40 и ниже, зелёный при 180 и выше. Пунктир — качество не сообщено. Стрелка ведёт к следующему устройству по пути к координатору: исходящая одна, входящие — те, кто ходит через это устройство. Линия без стрелки — запасной сосед. Это дерево маршрутов, которое строит House Plan, а не путь пакета в эту секунду: подпись на конце стрелки значит, что цель не на этом плане, а отсутствие стрелки — что путь неизвестен. Данные из последней загрузки и устаревают, связи видны только при работе мышью.",help_aria:"Справка: связи Zigbee",admin_only:"Данные топологии доступны только администраторам Home Assistant.",save_first:"Сохраните настройку перед загрузкой данных топологии.",zha:"ZHA",zha_read:"Прочитать данные ZHA",zha_hint:"Читает сохранённую топологию ZHA и не запускает радио-сканирование.",z2m:"Zigbee2MQTT",z2m_topics:"Базовые топики (по одному в строке)",z2m_update:"Обновить карту",z2m_warning:"Сканирование карты сети занимает от 10 секунд до 2 минут и временно может снизить отзывчивость Zigbee.",status_idle:"Данные не загружены",status_loading:"Загрузка…",status_ready:"Получено: {time}",status_stale:"Получено: {time} · данные устарели",status_partial:"Получено: {time} · часть узлов не показана",status_no_links:"Получено: {time} · наблюдаемые связи не найдены",error_permission:"Нужны права администратора.",error_unsupported:"Провайдер или API Home Assistant недоступен.",error_timeout:"Провайдер не ответил вовремя.",error_invalid_topic:"Проверьте базовый топик Zigbee2MQTT.",error_invalid_payload:"Провайдер вернул неподдерживаемые данные топологии.",error_provider:"Не удалось загрузить данные топологии.",remote_count:"+{n} в других пространствах",route_device_not_on_plan:"устройства нет на плане",route_coordinator_not_on_plan:"координатора нет на плане",route_other_space:"другое пространство"};const a="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";export{e as dictionary,a as fingerprint};
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";var e={title:"Связи Zigbee",toggle:"Показывать связи Zigbee при наведении на устройство",hint:"Показываются только наблюдаемые прямые соседи. Наведение ничего не запрашивает.",help:"Показывает, с какими устройствами Zigbee каждое связано напрямую. Цвет линии — качество связи (LQI) по той же шкале, что у показателя LQI устройства: красный при 40 и ниже, зелёный при 180 и выше. Пунктир — качество не сообщено. Стрелка ведёт к следующему устройству по пути к координатору: исходящая одна, входящие — те, кто ходит через это устройство. Линия без стрелки — запасной сосед. Это дерево маршрутов, которое строит House Plan, а не путь пакета в эту секунду: подпись на конце стрелки значит, что цель не на этом плане, а отсутствие стрелки — что путь неизвестен. Данные из последней загрузки и устаревают, связи видны только при работе мышью.",help_aria:"Справка: связи Zigbee",admin_only:"Данные топологии доступны только администраторам Home Assistant.",save_first:"Сохраните настройку перед загрузкой данных топологии.",zha:"ZHA",zha_read:"Прочитать данные ZHA",zha_hint:"Читает сохранённую топологию ZHA и не запускает радио-сканирование.",z2m:"Zigbee2MQTT",z2m_topics:"Базовые топики (по одному в строке)",z2m_update:"Обновить карту",z2m_warning:"Сканирование карты сети занимает от 10 секунд до 2 минут и временно может снизить отзывчивость Zigbee.",status_idle:"Данные не загружены",status_loading:"Загрузка…",status_ready:"Получено: {time}",status_stale:"Получено: {time} · данные устарели",status_partial:"Получено: {time} · часть узлов не показана",status_no_links:"Получено: {time} · наблюдаемые связи не найдены",error_permission:"Нужны права администратора.",error_unsupported:"Провайдер или API Home Assistant недоступен.",error_timeout:"Провайдер не ответил вовремя.",error_invalid_topic:"Проверьте базовый топик Zigbee2MQTT.",error_invalid_payload:"Провайдер вернул неподдерживаемые данные топологии.",error_provider:"Не удалось загрузить данные топологии.",remote_count:"+{n} в других пространствах",route_device_not_on_plan:"устройства нет на плане",route_coordinator_not_on_plan:"координатора нет на плане",route_other_space:"другое пространство"};const t="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";export{e as dictionary,t as fingerprint};

custom_components/houseplan/frontend/houseplan-assets/zigbee-topology-runtime-CKlry6R8.js

@@ -1 +1 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";import{n as t,c as n}from"./zigbee-topology-CeUn5Rc9.js";import{aM as e}from"./houseplan-card-wgloKGAN.js";import"./namespace-language-B_8Js-Qz.js";const o=new WeakMap;function i(t){const n=function(t){const n=t?.connection||t;return!n||"object"!=typeof n&&"function"!=typeof n?null:n}(t);if(!n)return null;let e=o.get(n);return e||(e={revision:0,topologies:[],states:{},listeners:new Set,inflight:new Map},o.set(n,e)),e}function r(t,n,e){t.states={...t.states,[n]:e},function(t){t.revision++;for(const n of t.listeners)n()}(t)}function s(t){const n=t?.code;if("permission"===n||"unsupported"===n||"timeout"===n||"invalid_topic"===n||"invalid_payload"===n)return n;const e=String(t?.message||"").toLowerCase();return e.includes("unauthor")||e.includes("permission")?"permission":e.includes("unknown_command")||e.includes("not found")?"unsupported":"provider"}function a(t){return Object.assign(new Error(t),{code:t})}function c(t,n,e){const o=t.inflight.get(n);if(o)return o;r(t,n,{phase:"loading"});const i=e().then(n=>{if(!n.nodes.length&&n.warnings.some(t=>"invalid_payload"===t.code))throw a("invalid_payload");!function(t,n){t.topologies=[...t.topologies.filter(t=>!(t.provider===n.provider&&t.instanceId===n.instanceId)),n],r(t,"zha"===n.provider?"zha":`z2m:${n.instanceId}`,{phase:"ready",obtainedAt:n.obtainedAt,partial:n.warnings.length>0})}(t,n)}).catch(e=>{r(t,n,{phase:"error",error:s(e)})}).finally(()=>t.inflight.delete(n));return t.inflight.set(n,i),i}function l(t){const n=i(t);return n?{revision:n.revision,topologies:n.topologies,states:n.states}:{revision:0,topologies:[],states:{}}}function u(t,n){const e=i(t);return e?(e.listeners.add(n),()=>e.listeners.delete(n)):()=>{}}function p(t){if(!0!==t?.user?.is_admin)throw a("permission")}function f(n){const e=i(n);return e?c(e,"zha",async()=>{if(p(n),"function"!=typeof n?.callWS)throw a("unsupported");return t(await n.callWS({type:"zha/devices"}))}):Promise.resolve()}function d(t){return null!==t&&"object"==typeof t?t:null}function h(t){const n=d(t),e=n?.payload??t;if("string"!=typeof e)return e;try{return JSON.parse(e)}catch{return null}}async function m(t,n){let e;try{return await Promise.race([t,new Promise((t,o)=>{e=globalThis.setTimeout(()=>o(a("timeout")),Math.max(1,n))})])}finally{void 0!==e&&globalThis.clearTimeout(e)}}function g(t,o,r=15e4){const s=i(t);if(!s)return Promise.resolve();const l=e(o);return c(s,`z2m:${l||String(o)}`,async()=>{if(p(t),!l)throw a("invalid_topic");const e=t.connection,o=e?.subscribeMessage;if("function"!=typeof o||"function"!=typeof t?.callService)throw a("unsupported");const i=function(){const t=globalThis.crypto;return"function"==typeof t?.randomUUID?`houseplan-${t.randomUUID()}`:`houseplan-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}(),s=Date.now()+Math.max(1,r);let c=!1,u=null,f=null,g=null;const y=new Promise(t=>{u=t}),w=new Promise((t,n)=>{f=t,g=n}),b=[];try{const r=await o.call(e,t=>{!0===d(t)?.retain&&h(t)&&u?.()},{type:"mqtt/subscribe",topic:`${l}/bridge/info`});"function"==typeof r&&b.push(r);const p=await o.call(e,t=>{if(!0===d(t)?.retain)return;const n=h(t);null!==n?n&&function(t){const n=d(t),e=n?.transaction??d(n?.data)?.transaction;return"string"==typeof e||"number"==typeof e?String(e):null}(n)===i&&f?.(n):c&&g?.(a("invalid_payload"))},{type:"mqtt/subscribe",topic:`${l}/bridge/response/networkmap`});"function"==typeof p&&b.push(p),await m(y,Math.min(4e3,Math.max(1,s-Date.now()))),c=!0,await t.callService("mqtt","publish",{topic:`${l}/bridge/request/networkmap`,payload:JSON.stringify({type:"raw",routes:!1,transaction:i}),qos:0,retain:!1});const v=await m(w,s-Date.now()),_=d(v)?.status;if(_&&"ok"!==_)throw a("provider");return n(v,l)}finally{for(const t of b)try{t()}catch{}}})}export{f as readZhaTopology,g as refreshZ2mTopology,u as subscribeZigbeeTopology,l as zigbeeTopologyRuntimeSnapshot};
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";import{n as t,c as n}from"./zigbee-topology-DOAnbvlu.js";import{aM as e}from"./houseplan-card-BYwTiVnu.js";import"./namespace-language-zIuNvgGV.js";const o=new WeakMap;function i(t){const n=function(t){const n=t?.connection||t;return!n||"object"!=typeof n&&"function"!=typeof n?null:n}(t);if(!n)return null;let e=o.get(n);return e||(e={revision:0,topologies:[],states:{},listeners:new Set,inflight:new Map},o.set(n,e)),e}function r(t,n,e){t.states={...t.states,[n]:e},function(t){t.revision++;for(const n of t.listeners)n()}(t)}function s(t){const n=t?.code;if("permission"===n||"unsupported"===n||"timeout"===n||"invalid_topic"===n||"invalid_payload"===n)return n;const e=String(t?.message||"").toLowerCase();return e.includes("unauthor")||e.includes("permission")?"permission":e.includes("unknown_command")||e.includes("not found")?"unsupported":"provider"}function a(t){return Object.assign(new Error(t),{code:t})}function c(t,n,e){const o=t.inflight.get(n);if(o)return o;r(t,n,{phase:"loading"});const i=e().then(n=>{if(!n.nodes.length&&n.warnings.some(t=>"invalid_payload"===t.code))throw a("invalid_payload");!function(t,n){t.topologies=[...t.topologies.filter(t=>!(t.provider===n.provider&&t.instanceId===n.instanceId)),n],r(t,"zha"===n.provider?"zha":`z2m:${n.instanceId}`,{phase:"ready",obtainedAt:n.obtainedAt,partial:n.warnings.length>0})}(t,n)}).catch(e=>{r(t,n,{phase:"error",error:s(e)})}).finally(()=>t.inflight.delete(n));return t.inflight.set(n,i),i}function l(t){const n=i(t);return n?{revision:n.revision,topologies:n.topologies,states:n.states}:{revision:0,topologies:[],states:{}}}function u(t,n){const e=i(t);return e?(e.listeners.add(n),()=>e.listeners.delete(n)):()=>{}}function f(t){if(!0!==t?.user?.is_admin)throw a("permission")}function p(n){const e=i(n);return e?c(e,"zha",async()=>{if(f(n),"function"!=typeof n?.callWS)throw a("unsupported");return t(await n.callWS({type:"zha/devices"}))}):Promise.resolve()}function d(t){return null!==t&&"object"==typeof t?t:null}function h(t){const n=d(t),e=n?.payload??t;if("string"!=typeof e)return e;try{return JSON.parse(e)}catch{return null}}async function m(t,n){let e;try{return await Promise.race([t,new Promise((t,o)=>{e=globalThis.setTimeout(()=>o(a("timeout")),Math.max(1,n))})])}finally{void 0!==e&&globalThis.clearTimeout(e)}}function g(t,o,r=15e4){const s=i(t);if(!s)return Promise.resolve();const l=e(o);return c(s,`z2m:${l||String(o)}`,async()=>{if(f(t),!l)throw a("invalid_topic");const e=t.connection,o=e?.subscribeMessage;if("function"!=typeof o||"function"!=typeof t?.callService)throw a("unsupported");const i=function(){const t=globalThis.crypto;return"function"==typeof t?.randomUUID?`houseplan-${t.randomUUID()}`:`houseplan-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}(),s=Date.now()+Math.max(1,r);let c=!1,u=null,p=null,g=null;const y=new Promise(t=>{u=t}),w=new Promise((t,n)=>{p=t,g=n}),b=[];try{const r=await o.call(e,t=>{!0===d(t)?.retain&&h(t)&&u?.()},{type:"mqtt/subscribe",topic:`${l}/bridge/info`});"function"==typeof r&&b.push(r);const f=await o.call(e,t=>{if(!0===d(t)?.retain)return;const n=h(t);null!==n?n&&function(t){const n=d(t),e=n?.transaction??d(n?.data)?.transaction;return"string"==typeof e||"number"==typeof e?String(e):null}(n)===i&&p?.(n):c&&g?.(a("invalid_payload"))},{type:"mqtt/subscribe",topic:`${l}/bridge/response/networkmap`});"function"==typeof f&&b.push(f),await m(y,Math.min(4e3,Math.max(1,s-Date.now()))),c=!0,await t.callService("mqtt","publish",{topic:`${l}/bridge/request/networkmap`,payload:JSON.stringify({type:"raw",routes:!1,transaction:i}),qos:0,retain:!1});const v=await m(w,s-Date.now()),_=d(v)?.status;if(_&&"ok"!==_)throw a("provider");return n(v,l)}finally{for(const t of b)try{t()}catch{}}})}export{p as readZhaTopology,g as refreshZ2mTopology,u as subscribeZigbeeTopology,l as zigbeeTopologyRuntimeSnapshot};

custom_components/houseplan/frontend/houseplan-card.js

@@ -1 +1 @@
-globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="71a86a6b5399ea3cfbdb50a82885a66b4287e17f6ec4df6c49e8693359d2e5e9";try{await import("./houseplan-assets/houseplan-card-wgloKGAN.js")}catch(e){if(!customElements.get("houseplan-card")){const l=String(navigator.language||"en").toLowerCase();const m=l.startsWith("ru")?"House Plan обновился — перезагрузите страницу (Ctrl+F5).":l.startsWith("de")?"House Plan wurde aktualisiert — bitte laden Sie die Seite neu (Strg+F5).":l.startsWith("fr")?"House Plan a été mis à jour — veuillez recharger la page (Ctrl+F5).":"House Plan was updated — please reload the page (Ctrl+F5).";customElements.define("houseplan-card",class extends HTMLElement{setConfig(){}getCardSize(){return 1}connectedCallback(){this.style.cssText="display:block;box-sizing:border-box;padding:16px;border:1px solid var(--divider-color,#e0e0e0);border-radius:var(--ha-card-border-radius,12px);background:var(--card-background-color,#fff);color:var(--primary-text-color,#212121);font:14px/1.4 var(--paper-font-body1_-_font-family,sans-serif)";this.textContent=m}})}console.error("[houseplan] stale houseplan-card.js: the implementation chunk is unavailable",e)}
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="a7aa4b718d3f5657591f9cf866d227c415e1f5f46fbc0b11ddce80a6845cf34e";try{await import("./houseplan-assets/houseplan-card-BYwTiVnu.js")}catch(e){if(!customElements.get("houseplan-card")){const l=String(navigator.language||"en").toLowerCase();const m=l.startsWith("ru")?"House Plan обновился — перезагрузите страницу (Ctrl+F5).":l.startsWith("de")?"House Plan wurde aktualisiert — bitte laden Sie die Seite neu (Strg+F5).":l.startsWith("fr")?"House Plan a été mis à jour — veuillez recharger la page (Ctrl+F5).":"House Plan was updated — please reload the page (Ctrl+F5).";customElements.define("houseplan-card",class extends HTMLElement{setConfig(){}getCardSize(){return 1}connectedCallback(){this.style.cssText="display:block;box-sizing:border-box;padding:16px;border:1px solid var(--divider-color,#e0e0e0);border-radius:var(--ha-card-border-radius,12px);background:var(--card-background-color,#fff);color:var(--primary-text-color,#212121);font:14px/1.4 var(--paper-font-body1_-_font-family,sans-serif)";this.textContent=m}})}console.error("[houseplan] stale houseplan-card.js: the implementation chunk is unavailable",e)}

custom_components/houseplan/import_export.py

@@ -73,7 +73,7 @@ _LIVE_TEXT_ENTITY = re.compile(r"^[a-z0-9_]+\.[a-z0-9_]+$")
 _LIVE_TEXT_ATTRIBUTE = re.compile(r"^[a-zA-Z0-9_.-]+$")
 _PLAN_ONLY_DASH = "—"
 _IMPORT_ID_NAMESPACES = {
-    "space", "room", "marker", "partition", "wall", "opening", "decor", "column",
+    "space", "room", "marker", "partition", "wall", "opening", "decor", "column", "stair",
 }
 _MAX_IMPORT_LINEAGE_DEPTH = 16
 _REPORT_EXAMPLE_LIMIT = 24
@@ -294,6 +294,15 @@ def _project_plan_only_space(space: dict[str, Any]) -> dict[str, Any]:
         projected["decor"] = [
             _project_plan_only_decor(shape) for shape in space.get("decor") or []
         ]
+    if "stairs" in space:
+        projected["stairs"] = [
+            _pick_fields(stair, (
+                "id", "kind", "x", "y", "angle", "direction",
+                "target_space_id", "length", "width", "radius",
+                "color", "opacity", "fill_color", "fill_opacity",
+            ))
+            for stair in space.get("stairs") or []
+        ]
     return projected
 
 
@@ -742,6 +751,7 @@ def _counts(config: dict[str, Any], layout: dict[str, Any]) -> dict[str, int]:
         "markers": len(config.get("markers") or []),
         "openings": sum(len(sp.get("openings") or []) for sp in spaces),
         "decor": sum(len(sp.get("decor") or []) for sp in spaces),
+        "stairs": sum(len(sp.get("stairs") or []) for sp in spaces),
         "layout": len(layout),
     }
 
@@ -1132,6 +1142,14 @@ def _repair_target_space_refs(
 
     for space in spaces:
         space_id = str(space.get("id", "?"))
+        for stair in space.get("stairs") or []:
+            target = stair.get("target_space_id") if isinstance(stair, dict) else None
+            mapped = replace(
+                f"{space_id}:{stair.get('id', '?')}", "stair.target_space_id",
+                target, resolve_space,
+            )
+            if mapped is not None:
+                stair["target_space_id"] = mapped
         for room in space.get("rooms") or []:
             room_id = str(room.get("id", "?"))
             values = room.get("open_to")
@@ -1322,7 +1340,7 @@ def build_space_merge(
             (sp,), sp.get("rooms") or [],
             sp.get("partitions") or [], sp.get("wall_segments") or [],
             sp.get("wall_columns") or [],
-            sp.get("openings") or [], sp.get("decor") or [],
+            sp.get("openings") or [], sp.get("decor") or [], sp.get("stairs") or [],
         )
         for item in collection
         if isinstance(item, dict)
@@ -1338,7 +1356,7 @@ def build_space_merge(
             (incoming_space,), incoming_space.get("rooms") or [],
             incoming_space.get("partitions") or [], incoming_space.get("wall_segments") or [],
             incoming_space.get("wall_columns") or [],
-            incoming_space.get("openings") or [], incoming_space.get("decor") or [],
+            incoming_space.get("openings") or [], incoming_space.get("decor") or [], incoming_space.get("stairs") or [],
         )
         for item in collection
         if isinstance(item, dict)
@@ -1362,6 +1380,7 @@ def build_space_merge(
         ("rooms", "room"), ("partitions", "partition"),
         ("wall_segments", "wall"),
         ("wall_columns", "column"), ("openings", "opening"), ("decor", "decor"),
+        ("stairs", "stair"),
     ):
         for item in space.get(collection) or []:
             if isinstance(item, dict) and item.get("id") is not None:
@@ -1405,6 +1424,16 @@ def build_space_merge(
                     reference_report, "incoming", "opening.host",
                     str(opening.get("id", "?")), old_host_id,
                 )
+    # A one-space export cannot carry a trustworthy external floor target.
+    # Self-links are invalid too because the imported source gets a new id.
+    for stair in space.get("stairs") or []:
+        target = stair.get("target_space_id") if isinstance(stair, dict) else None
+        if target is not None:
+            stair["target_space_id"] = None
+            _report_remap(
+                reference_report, "incoming", "stair.target_space_id",
+                str(stair.get("id", "?")), str(target),
+            )
     space["id"] = new_space_id
     space["title"] = _unique_title(
         str(space.get("title") or old_space_id), current_config.get("spaces") or []

custom_components/houseplan/manifest.json

@@ -20,5 +20,5 @@
   "issue_tracker": "https://github.com/Matysh/houseplan-card/issues",
   "requirements": [],
   "single_config_entry": true,
-  "version": "1.78.0-beta.1"
+  "version": "1.78.0"
 }

custom_components/houseplan/store.py

@@ -133,7 +133,7 @@ def create_data(hass: HomeAssistant) -> HouseplanData:
     )
     from .virtual_lights import VirtualLightController
 
-    data.virtual_lights = VirtualLightController(data.virtual_light_store)
+    data.virtual_lights = VirtualLightController(hass, data.virtual_light_store)
     return data
 
 

custom_components/houseplan/support_package.py

@@ -155,6 +155,9 @@ def _global_settings(value: object) -> dict[str, Any]:
     show_room_tooltip = value.get("show_room_tooltip")
     if isinstance(show_room_tooltip, bool):
         out["show_room_tooltip"] = show_room_tooltip
+    volumetric_view = value.get("volumetric_view")
+    if isinstance(volumetric_view, bool):
+        out["volumetric_view"] = volumetric_view
     fill_colors = value.get("fill_colors")
     if isinstance(fill_colors, dict):
         palette = {
@@ -371,6 +374,18 @@ def _project_space(ids: _Pseudonyms, space: dict[str, Any], index: int) -> dict[
     out["decor"] = [
         _project_decor(ids, item) for item in space.get("decor") or [] if isinstance(item, dict)
     ]
+    out["stairs"] = []
+    for item in space.get("stairs") or []:
+        if not isinstance(item, dict):
+            continue
+        projected = {"id": ids.get("stair", item.get("id"))}
+        projected.update(_copy_keys(item, (
+            "kind", "x", "y", "angle", "direction", "length", "width", "radius",
+            "color", "opacity", "fill_color", "fill_opacity",
+        )))
+        if item.get("target_space_id"):
+            projected["target_space_id"] = ids.get("space", item.get("target_space_id"))
+        out["stairs"].append(projected)
     out["open_spans"] = [
         {"a": _point(item.get("a")), "b": _point(item.get("b"))}
         for item in space.get("open_spans") or [] if isinstance(item, dict)
@@ -433,6 +448,7 @@ def _summary(config: object, layout: object) -> dict[str, Any]:
         "columns": sum(len(space.get("wall_columns") or []) for space in spaces if isinstance(space, dict)),
         "openings": dict(sorted(kinds.items())),
         "decor": dict(sorted(decor_kinds.items())),
+        "stairs": sum(len(space.get("stairs") or []) for space in spaces if isinstance(space, dict)),
         "markers": {
             "total": len(markers),
             "lifecycle": dict(sorted(lifecycles.items())),

custom_components/houseplan/system_health.py

@@ -31,6 +31,7 @@ async def system_health_info(hass: HomeAssistant) -> dict[str, Any]:
         "rooms": sum(len(s.get("rooms", [])) for s in config.get("spaces", [])),
         "partitions": sum(len(s.get("partitions", [])) for s in config.get("spaces", [])),
         "wall_columns": sum(len(s.get("wall_columns", [])) for s in config.get("spaces", [])),
+        "stairs": sum(len(s.get("stairs", [])) for s in config.get("spaces", [])),
         "markers": len(config.get("markers", [])),
         "layout_entries": len(layout_raw.get("layout", {})),
     }

custom_components/houseplan/validation.py

@@ -1198,6 +1198,7 @@ MAX_ROOMS = 400
 MAX_MARKERS = 2000
 MAX_OPENINGS = 500
 MAX_DECOR = 1000
+MAX_STAIRS = 250
 # v8 atomises room boundaries. The 2 MiB wire cap is the practical bound; this
 # structural cap mirrors MAX_ROOMS * MAX_POLY_POINTS without depending on the
 # later constant declaration.
@@ -1207,7 +1208,7 @@ _LEGACY_MAX_ROOM_DRAFTS = 200
 _LEGACY_MAX_DRAFT_SEGMENTS = 2000
 MAX_PARTITIONS = 2000
 MAX_WALL_COLUMNS = 500
-# Open (virtual) wall stretches, docs/superpowers/specs/2026-08-05-open-spans-delete-design.md.
+# Open (virtual) wall stretches, legacy/docs/superpowers/specs/2026-08-05-open-spans-delete-design.md.
 # Every span is a piece of a shared boundary, so there can never be more of
 # them than there are wall segments — the cap is the walls' one (AUD-159B6-03).
 MAX_OPEN_SPANS = 500
@@ -1279,7 +1280,7 @@ _GEOM = vol.All(_finite, vol.Range(min=-CANVAS_LIMIT, max=CANVAS_LIMIT))
 # than the old unit square — while staying strictly positive.
 _EXTENT = vol.All(_finite, vol.Range(min=0.001, max=CANVAS_LIMIT))
 
-# The backdrop's uniform scale (docs/BACKDROP.md). A MULTIPLIER, not a
+# The backdrop's uniform scale (docs/DECOR-EDITOR.md §3). A MULTIPLIER, not a
 # coordinate: strictly positive, and bounded by what a person could mean —
 # a hundredth of the canvas is already a thumbnail, a hundred canvases is
 # already absurd. Mirrored by PLAN_SCALE_MIN/MAX in src/space-geometry.ts.
@@ -1427,7 +1428,7 @@ SPACE_DISPLAY_SCHEMA = vol.Schema(
     extra=vol.ALLOW_EXTRA,
 )
 
-# Live text on a decor label (docs/LIVE-TEXT.md). An entity id is
+# Live text on a decor label (docs/DECOR-EDITOR.md §5). An entity id is
 # `<domain>.<object_id>`; HA itself allows only lowercase letters, digits and
 # underscores in both halves. The bound is a sanity limit, not a policy.
 MAX_ENTITY_ID = 255
@@ -1489,7 +1490,7 @@ DECOR_SCHEMA = vol.Any(
     vol.Schema({**_DECOR_COMMON, vol.Required("kind"): "text",
                 vol.Required("x"): _NORM, vol.Required("y"): _NORM,
                 # the template: newlines are the user's own line breaks and are
-                # kept verbatim (docs/LIVE-TEXT.md); the label never wraps itself
+                # kept verbatim (docs/DECOR-EDITOR.md §5); the label never wraps itself
                 vol.Required("text"): vol.All(str, vol.Length(min=1, max=MAX_DECOR_TEXT)),
                 # legacy font size ('s'|'m'|'l'). The dialog no longer offers it
                 # — the block is scaled by its corner handles — but a plan
@@ -1532,6 +1533,61 @@ DECOR_SCHEMA = vol.Any(
 )
 
 
+def _strict_stair(value: dict) -> dict:
+    """A discriminated stair record carries dimensions for exactly one kind."""
+    if value["kind"] == "straight":
+        if "radius" in value:
+            raise vol.Invalid("radius is allowed only for spiral stairs")
+        if value["direction"] not in ("forward", "backward"):
+            raise vol.Invalid("straight stair direction must be forward or backward")
+    else:
+        if "length" in value or "width" in value:
+            raise vol.Invalid("length and width are allowed only for straight stairs")
+        if value["direction"] not in ("clockwise", "counterclockwise"):
+            raise vol.Invalid("spiral stair direction must be clockwise or counterclockwise")
+    return value
+
+
+def _stair_dimensions(value: dict) -> dict:
+    """Require the dimension fields owned by the selected stair kind."""
+    complete = (
+        value["kind"] == "straight" and "length" in value and "width" in value
+        or value["kind"] == "spiral" and "radius" in value
+    )
+    if not complete:
+        raise vol.Invalid("stair kind requires its dimensions")
+    return value
+
+
+STAIR_SCHEMA = vol.All(
+    vol.Schema(
+        {
+            vol.Required("id"): vol.All(str, vol.Length(min=1, max=64)),
+            vol.Required("kind"): vol.In(["straight", "spiral"]),
+            vol.Required("x"): _NORM,
+            vol.Required("y"): _NORM,
+            vol.Required("angle"): vol.All(_finite, vol.Range(min=-360.0, max=360.0)),
+            vol.Required("direction"): vol.In([
+                "forward", "backward", "clockwise", "counterclockwise",
+            ]),
+            vol.Optional("target_space_id"): vol.Any(
+                None, vol.All(str, vol.Match(SPACE_ID_RE.pattern))
+            ),
+            vol.Optional("length"): _FURN_SIZE,
+            vol.Optional("width"): _FURN_SIZE,
+            vol.Optional("radius"): _FURN_SIZE,
+            vol.Optional("color"): _COLOR,
+            vol.Optional("opacity"): vol.All(_finite, vol.Range(min=0.0, max=1.0)),
+            vol.Optional("fill_color"): _COLOR,
+            vol.Optional("fill_opacity"): vol.All(_finite, vol.Range(min=0.0, max=1.0)),
+        },
+        extra=vol.ALLOW_EXTRA,
+    ),
+    _stair_dimensions,
+    _strict_stair,
+)
+
+
 def _wall_endpoints_pair(entry: dict) -> dict:
     """Exact wall endpoints are useful only as a complete a/b pair."""
     if ("a" in entry) != ("b" in entry):
@@ -1673,7 +1729,7 @@ OPENING_HOST_SCHEMA = vol.Any(PARTITION_OPENING_HOST_SCHEMA, WALL_OPENING_HOST_S
 def _space_geometry_invariants(value: dict) -> dict:
     """All stored geometry shares ids; draft segments also have a space cap."""
     seen: set[str] = set()
-    for key in ("rooms", "openings", "decor", "room_drafts", "partitions", "wall_columns", "wall_segments"):
+    for key in ("rooms", "openings", "decor", "stairs", "room_drafts", "partitions", "wall_columns", "wall_segments"):
         for item in value.get(key, []):
             item_id = item.get("id")
             if not item_id:
@@ -1743,7 +1799,7 @@ SPACE_SCHEMA = vol.All(vol.Schema(
         vol.Optional("plan_aspect"): vol.Any(
             None, vol.All(vol.Coerce(float), vol.Range(min=0.05, max=20))
         ),
-        # Backdrop placement (docs/BACKDROP.md): the picture may be moved,
+        # Backdrop placement (docs/DECOR-EDITOR.md §3): the picture may be moved,
         # resized per axis and rotated. Every transform field is optional; its
         # complete absence is the pre-v1.58.0 behaviour exactly, and an old
         # config validates unchanged. The offset is a normalised
@@ -1768,6 +1824,7 @@ SPACE_SCHEMA = vol.All(vol.Schema(
         vol.Required("view_box"): _view_box,
         vol.Required("rooms"): vol.All([ROOM_SCHEMA], vol.Length(max=MAX_ROOMS)),
         vol.Optional("decor"): vol.All([DECOR_SCHEMA], vol.Length(max=MAX_DECOR)),
+        vol.Optional("stairs"): vol.All([STAIR_SCHEMA], vol.Length(max=MAX_STAIRS)),
         vol.Optional("openings"): vol.All([
             vol.Schema(
                 {
@@ -2254,6 +2311,8 @@ CONFIG_SCHEMA = vol.All(
                     vol.Optional("sun_rays"): bool,
                     vol.Optional("sun_ray_origin"): _SUN_RAY_ORIGIN,
                     vol.Optional("show_room_tooltip"): bool,
+                    # #649: installation-wide 2.5D View; absent/false keeps Flat.
+                    vol.Optional("volumetric_view"): bool,
                     vol.Optional("summary_panel"): SUMMARY_PANEL_WIRE_SCHEMA,
                     vol.Optional("radar"): vol.Schema({}, extra=vol.ALLOW_EXTRA),
                     # Removed from the UI/runtime in 2026-08-08. Keep accepting the

custom_components/houseplan/virtual_lights.py

@@ -7,6 +7,8 @@ import logging
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
+    from homeassistant.core import HomeAssistant
+
     from .store import HouseplanStore
 
 
@@ -81,12 +83,14 @@ def _snapshot_payload(
 class VirtualLightController:
     """Runtime cache with coalesced durable writes for rapid toggles."""
 
-    def __init__(self, store: HouseplanStore) -> None:
+    def __init__(self, hass: HomeAssistant, store: HouseplanStore) -> None:
+        self.hass = hass
         self.store = store
         self._state: dict[str, Any] | None = None
         self._dirty = False
         self._save_task: asyncio.Task[None] | None = None
         self._flush_event = asyncio.Event()
+        self._flush_lock = asyncio.Lock()
 
     async def async_snapshot(
         self, config: dict[str, Any], config_rev: int,
@@ -127,7 +131,7 @@ class VirtualLightController:
 
     def _schedule_save(self) -> None:
         if self._save_task is None or self._save_task.done():
-            self._save_task = asyncio.create_task(self._delayed_save())
+            self._save_task = self.hass.async_create_task(self._delayed_save())
 
     async def _delayed_save(self) -> None:
         try:
@@ -156,16 +160,17 @@ class VirtualLightController:
 
     async def async_flush(self) -> None:
         """Persist the latest state before config transitions or unload."""
-        task = self._save_task
-        if task is not None:
-            self._flush_event.set()
-            await task
-        if self._dirty and self._state is not None:
-            payload = copy.deepcopy(self._state)
-            await self.store.async_save(payload)
-            self._dirty = False
-        if not self._dirty:
-            self._flush_event.clear()
+        async with self._flush_lock:
+            task = self._save_task
+            if task is not None:
+                self._flush_event.set()
+                await task
+            if self._dirty and self._state is not None:
+                payload = copy.deepcopy(self._state)
+                await self.store.async_save(payload)
+                self._dirty = False
+            if not self._dirty:
+                self._flush_event.clear()
 
     def reset(self) -> None:
         """Forget cache after an external reconciliation wrote the store."""

custom_components/houseplan/wall_segment_model.py

@@ -439,7 +439,7 @@ def _thickness(space: dict[str, Any], atom: dict[str, Any], previous: dict[str,
 
 def _non_catalog_ids(space: dict[str, Any]) -> set[str]:
     result: set[str] = set()
-    for name in ("rooms", "openings", "decor", "room_drafts", "partitions", "wall_columns"):
+    for name in ("rooms", "openings", "decor", "stairs", "room_drafts", "partitions", "wall_columns"):
         for item in space.get(name) or []:
             if isinstance(item, dict) and isinstance(item.get("id"), str) and item["id"]:
                 result.add(item["id"])
@@ -661,7 +661,7 @@ def _migrate_room_drafts_to_partitions(space: dict[str, Any]) -> tuple[int, int]
         return 0, 0
     used = {
         str(item["id"])
-        for name in ("rooms", "openings", "decor", "partitions",
+        for name in ("rooms", "openings", "decor", "stairs", "partitions",
                      "wall_columns", "wall_segments")
         for item in space.get(name) or []
         if isinstance(item, dict) and isinstance(item.get("id"), str) and item["id"]

custom_components/houseplan/websocket_api.py

@@ -1056,6 +1056,9 @@ async def ws_plans_list(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
     works as a policy if the user can see them: detaching a plan keeps the
     image, and this is how it gets picked up again — or deleted on purpose.
     """
+    if not _check_write(hass, connection):
+        connection.send_error(msg["id"], "unauthorized", "Only writers may list plans")
+        return
     rt = _runtime(hass, connection, msg["id"])
     if rt is None:
         return
@@ -1845,6 +1848,10 @@ def _space_delete_candidate(
         item for item in candidate_config.get("spaces") or []
         if item.get("id") != space_id
     ]
+    for remaining_space in candidate_config["spaces"]:
+        for stair in remaining_space.get("stairs") or []:
+            if isinstance(stair, dict) and stair.get("target_space_id") == space_id:
+                stair["target_space_id"] = None
     for marker in candidate_config.get("markers") or []:
         marker_id = str(marker.get("id")) if marker.get("id") is not None else None
         marker_position = candidate_layout.get(marker_id) if marker_id is not None else None
@@ -2386,12 +2393,27 @@ async def _purge_trail_recorder(hass: HomeAssistant, config: dict[str, Any]) ->
     return await rec.async_purge_orphans(config) if rec else 0
 
 
+def _public_trails(value: Any) -> Any:
+    """Copy the trail book for View without exposing source entity ids (#626)."""
+    if isinstance(value, dict):
+        return {
+            key: _public_trails(item)
+            for key, item in value.items()
+            if key != "source"
+        }
+    if isinstance(value, list):
+        return [_public_trails(item) for item in value]
+    return value
+
+
 @websocket_api.websocket_command({vol.Required("type"): "houseplan/trail/get"})
 @websocket_api.async_response
 async def ws_trail_get(hass: HomeAssistant, connection: websocket_api.ActiveConnection, msg: dict) -> None:
-    """Current + previous cleanup runs per marker, raw robot coordinates."""
+    """Current + previous runs and raw coordinates, without source entity ids."""
     rec = hass.data.get(DOMAIN, {}).get("trail_recorder")
-    connection.send_result(msg["id"], {"trails": rec.book.data if rec else {}})
+    connection.send_result(
+        msg["id"], {"trails": _public_trails(rec.book.data) if rec else {}}
+    )
 
 
 @websocket_api.websocket_command(

demo/README.md

@@ -1,17 +0,0 @@
-# Synthetic demo home
-
-A fully fictional house (plans, devices, states) used for README screenshots,
-the demo GIF and headless smoke tests — so no real home data ever appears in
-public materials.
-
-- `srv/demo.html` — self-contained host page: `<ha-icon>`/`<ha-card>` stubs and a
-  fake `hass` (registries, states, `callWS`, `callService`, floors).
-- `srv/assets/` — generated plan SVGs and `icons.js` (`node demo/gen_icons.mjs`,
-  needs the repo's devDependencies). The card bundle is copied from `dist/`:
-  `npm run bundle:sync` (копия стенда не коммитится, #255).
-- `serve.mjs` — playwright launcher (route interception, no web server).
-- `smoke_*.mjs` — feature smoke tests; run with a Chromium installed via
-  `PLAYWRIGHT_BROWSERS_PATH=<dir> npx playwright install chromium-headless-shell`.
-
-Note for sandboxed sessions: `/tmp` does not survive; this directory is the
-persistent home of the harness (docs/DEVELOPMENT.md has the LD_LIBRARY_PATH recipe).

demo/benchmark_coordinate_write_barrier.mjs

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-// #291: same-process p95 of the complete config+layout boundary versus the
-// pre-existing full-candidate clone contract. Batching makes the strict 20%
-// ratio meaningful even on coarse/loaded CI timers.
-import { performance } from 'node:perf_hooks';
-
-import { makeLargeHouseFixture } from './fixtures/large-house.mjs';
-import {
-  canonicalizeConfigGeometry, canonicalizeLayoutGeometry,
-} from '../test-build/coordinate-canonicalization.js';
-
-const WARMUPS = 30;
-const SAMPLES = 120;
-const BATCH = 10;
-const MAX_RATIO = 1.2;
-const fixture = makeLargeHouseFixture();
-
-const baseline = () => {
-  JSON.parse(JSON.stringify(fixture.config));
-  JSON.parse(JSON.stringify(fixture.layout || {}));
-};
-const candidate = () => {
-  canonicalizeConfigGeometry(fixture.config);
-  canonicalizeLayoutGeometry(fixture.layout || {});
-};
-const measure = (operation) => {
-  const started = performance.now();
-  for (let index = 0; index < BATCH; index++) operation();
-  return (performance.now() - started) / BATCH;
-};
-for (let index = 0; index < WARMUPS; index++) {
-  baseline();
-  candidate();
-}
-const baselineSamples = [];
-const candidateSamples = [];
-for (let index = 0; index < SAMPLES; index++) {
-  if (index % 2) {
-    candidateSamples.push(measure(candidate));
-    baselineSamples.push(measure(baseline));
-  } else {
-    baselineSamples.push(measure(baseline));
-    candidateSamples.push(measure(candidate));
-  }
-}
-const p95 = (values) => [...values].sort((a, b) => a - b)[Math.ceil(values.length * 0.95) - 1];
-const baselineP95 = p95(baselineSamples);
-const candidateP95 = p95(candidateSamples);
-const ratio = candidateP95 / baselineP95;
-const report = {
-  fixture: 'large-house-v1', samples: SAMPLES, batch: BATCH,
-  baselineP95Ms: baselineP95, candidateP95Ms: candidateP95,
-  ratio, limit: MAX_RATIO, pass: ratio <= MAX_RATIO,
-};
-console.log(JSON.stringify(report, null, 2));
-if (!report.pass) process.exitCode = 1;

demo/benchmark_large_house.mjs

@@ -40,6 +40,7 @@ const requiresIsoStructuralBuildCounter = requiresIsometric
 const requiresPlanSnap = planSnap && existsSync(resolve(targetRoot, 'src/plan-snap-overlay.ts'));
 const requiresWallFace = planSnap && existsSync(resolve(targetRoot, 'src/wall-face-graph.ts'));
 const requiresInteraction = interaction && existsSync(resolve(targetRoot, 'src/live-viewport.ts'));
+const requiresStairs = existsSync(resolve(targetRoot, 'src/stairs.ts'));
 const fixture = stage3Dense ? makeIsometricStage3DenseFixture() : makeLargeHouseFixture();
 const fixtureCounts = stage3Dense ? fixture.counts : LARGE_HOUSE_COUNTS;
 const sourceSha = (() => {
@@ -100,7 +101,7 @@ try {
     const row = await page.evaluate(async ({
       fixture, sample, cardContract, isometric, requiresIsometric, planSnap, requiresPlanSnap,
       requiresWallFace, interaction, requiresInteraction, stage3Dense, requireStage3,
-      requiresIsoStructuralBuildCounter, profile,
+      requiresIsoStructuralBuildCounter, requiresStairs, profile,
     }) => {
       const frame = () => new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
       const until = async (predicate, timeout = 10000) => {
@@ -142,7 +143,7 @@ try {
           longTasks: await longTasks.stop(),
         };
       };
-      // Current candidates split the experimental Iso runtime out of the initial graph. Comparison
+      // Current candidates split the lazy 2.5D runtime out of the initial graph. Comparison
       // bundles remain valid: their older monolithic renderer has no preload
       // hook and is already available synchronously.
       const ensureIsoRuntime = async (card) => {
@@ -181,7 +182,7 @@ try {
         const overlaySelectors = {
           device: '[data-hp="device"]',
           'room-label': '[data-hp="room-label"]',
-          'opening-lock': '.oplock',
+          'opening-lock': '.oplock:not(.iso-tile-shadow)',
         };
         const totalRootsByKind = Object.fromEntries(Object.entries(overlaySelectors)
           .map(([kind, selector]) => [kind, card.renderRoot.querySelectorAll(selector).length]));
@@ -291,6 +292,9 @@ try {
           fixture.config.spaces.map((space) => [space.id, 'iso']),
         )));
         history.replaceState(null, '', '?hp_alpha=1');
+        // #649: current bundles read the installation setting; the alpha
+        // storage above stays for comparison bundles before it.
+        fixture.config.settings = { ...(fixture.config.settings || {}), volumetric_view: true };
       } else history.replaceState(null, '', location.pathname);
       const host = document.getElementById('host');
       const card = document.createElement('houseplan-card');
@@ -386,7 +390,7 @@ try {
         throw new Error('large-house editor runtime did not preload');
       if (isometric) await ensureIsoRuntime(card);
       window.__hpAssertCardContract(card, cardContract);
-      if (requiresIsometric && (typeof card._setProjection !== 'function'
+      if (requiresIsometric && (typeof card._effectiveProjection !== 'function'
           || !(card._isoGeometryCache instanceof Map))) {
         throw new Error('large-house-isometric-v1 candidate has no renderer contract');
       }
@@ -397,6 +401,10 @@ try {
       await until(() => card._booting === false);
       if (interaction && '_bootSoft' in card) await until(() => card._bootSoft === false);
       await frame();
+      if (requiresStairs
+          && card.renderRoot.querySelectorAll('[data-hp="stair"]').length !== fixture.counts.stairs) {
+        throw new Error(`${profile} did not render the bounded maximum stair collection`);
+      }
       const firstStableRenderMs = Number((performance.now() - loadStarted).toFixed(2));
       const bootDiag = {
         updates: card.__diag.updates,
@@ -445,11 +453,20 @@ try {
       }
       const viewToggle = isometric ? await duration(async () => {
         if (typeof card._setProjection === 'function') {
+          // Comparison bundles before #649: the per-device alpha preference.
           card._setProjection('flat');
           await card.updateComplete;
           card._setProjection('iso');
           await ensureIsoRuntime(card);
           await card.updateComplete;
+        } else if (typeof card._syncVolumetricSetting === 'function') {
+          // #649: the installation-wide General settings switch, as a save applies it.
+          const cfg = card._serverCfg;
+          card._serverCfg = { ...cfg, settings: { ...(cfg.settings || {}), volumetric_view: false } };
+          await card.updateComplete;
+          card._serverCfg = { ...cfg, settings: { ...(cfg.settings || {}), volumetric_view: true } };
+          await ensureIsoRuntime(card);
+          await card.updateComplete;
         } else {
           // Comparison SHAs before #89 intentionally ignore the Labs operation.
           card.requestUpdate();
@@ -1207,7 +1224,7 @@ try {
       fixture, sample: measuredSample, cardContract: LARGE_HOUSE_CARD_CONTRACT,
       isometric, requiresIsometric, planSnap, requiresPlanSnap, requiresWallFace,
       interaction, requiresInteraction, stage3Dense, requireStage3,
-      requiresIsoStructuralBuildCounter, profile,
+      requiresIsoStructuralBuildCounter, requiresStairs, profile,
     });
     // #520: диагностика печатается в лог прогона и в запись не попадает.
     const { bootDiag, ...measured } = row;

demo/capture_design_pairs_600.mjs

@@ -1,8 +1,9 @@
 // #600 AC1: парные кадры продукта для сравнения с референсом
 // docs/design/600-settings-dialogs/ (ACCEPTANCE.md). Диагностическая съёмка, не
 // golden: кадры не принимаются golden:accept и не участвуют в golden:verify.
+// Кадры — артефакт проверки, в репозиторий не коммитятся (#681).
 //
-//   node demo/capture_design_pairs_600.mjs [--out=docs/design/600-settings-dialogs/pairs]
+//   node demo/capture_design_pairs_600.mjs [--out=artifacts/design-pairs-600]
 //
 // Четыре диалога × две темы, ширина поверхности 560, скроллер раскрыт на всю
 // высоту, чтобы кадр показывал форму целиком, как макет референса. Состояния —
@@ -14,7 +15,7 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { launch } from './serve.mjs';
 
-const out = resolve(process.argv.find((a) => a.startsWith('--out='))?.slice(6) || 'docs/design/600-settings-dialogs/pairs');
+const out = resolve(process.argv.find((a) => a.startsWith('--out='))?.slice(6) || 'artifacts/design-pairs-600');
 mkdirSync(out, { recursive: true });
 
 const THEMES = {

demo/capture_stage6_acceptance_649.mjs

@@ -0,0 +1,22 @@
+// #649 AC12: product frames for docs/design/649-25d-stage6/ACCEPTANCE.md.
+// These scenarios are canonical golden entries (#673). This focused command
+// remains a diagnostic helper for rebuilding the side-by-side design document;
+// baseline capture and acceptance still use the complete golden matrix (#455).
+//
+//   npm run build && npm run bundle:sync
+//   node demo/capture_stage6_acceptance_649.mjs [out-dir]
+import { mkdirSync } from 'node:fs';
+import { launch } from './serve.mjs';
+import { goldenClip, prepareGoldenScenario } from './golden/harness.mjs';
+import { STAGE6_ACCEPTANCE_SCENARIOS } from './golden/matrix.mjs';
+
+const out = process.argv[2] || 'artifacts/stage6-acceptance';
+mkdirSync(out, { recursive: true });
+const { page, browser } = await launch({ width: 1000, height: 900 }, 1);
+for (const scenario of STAGE6_ACCEPTANCE_SCENARIOS) {
+  await prepareGoldenScenario(page, scenario);
+  await page.waitForTimeout(2600); // the sun wash fades in over 2 s
+  await page.screenshot({ path: `${out}/${scenario.id}.png`, clip: await goldenClip(page, scenario.capture) });
+  console.log('captured', scenario.id);
+}
+await browser.close();

demo/capture_summary_panel_505.mjs

@@ -1,317 +0,0 @@
-/** Explicit #505 diagnostic evidence, not a golden-baseline producer or smoke. */
-import assert from 'node:assert/strict';
-import { execFileSync } from 'node:child_process';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { sourceFingerprint } from '../scripts/source-fingerprint.mjs';
-import { assertFreshDemoBundle } from './bundle-freshness.mjs';
-import { HA_DIALOG_PIN, prepareHaDialogAssets } from './helpers/ha-dialog-assets.mjs';
-import { launchHaDialogFixture } from './helpers/ha-dialog-fixture.mjs';
-
-const repo = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const options = { output: join(repo, 'artifacts/summary-panel-505') };
-for (let index = 2; index < process.argv.length; index++) {
-  const arg = process.argv[index];
-  if (arg === '--probe-only') options.probeOnly = true;
-  else if (['--output', '--ha-cache', '--ha-wheel', '--only'].includes(arg)) {
-    const value = process.argv[++index];
-    if (!value || value.startsWith('--')) throw new Error(`Missing value for ${arg}`);
-    if (arg === '--only') options.only = value.split(',');
-    else options[{ '--output': 'output', '--ha-cache': 'cacheDir', '--ha-wheel': 'wheelPath' }[arg]] = resolve(value);
-  } else throw new Error(`Unknown option ${arg}`);
-}
-// Fail before the optional 124 MB download. Captures never bypass freshness.
-const fingerprint = sourceFingerprint(repo);
-if (!options.probeOnly) {
-  const manifest = JSON.parse(readFileSync(join(repo, 'demo/srv/assets/houseplan-assets.json')));
-  assert.equal(manifest.fingerprint, fingerprint, 'Stale demo bundle: run npm run bundle:sync before capturing');
-}
-mkdirSync(options.output, { recursive: true });
-const report = {
-  issue: 505, diagnosticOnly: true, platform: process.platform,
-  sourceSha: execFileSync('git', ['rev-parse', 'HEAD'], { cwd: repo, encoding: 'utf8' }).trim(),
-  sourceFingerprint: fingerprint, probeOnly: Boolean(options.probeOnly),
-  selectedCases: options.only || 'full matrix',
-  haFrontend: HA_DIALOG_PIN.version, wheelSha256: HA_DIALOG_PIN.sha256,
-  boundaries: 'Loopback synthetic demo only. No core/auth/HA server. Official app loader exposed at runtime; component factories/CSS unmodified.',
-  comparison: 'Equivalent one block, three default system rows and one entity row. Reference row text is normalized to observed product values; reference CSS/files are unchanged. Floor-plan/fake HA chrome pixels are not parity targets.',
-  captures: [],
-};
-const saveReport = () => writeFileSync(join(options.output, 'report.json'), JSON.stringify(report, null, 2));
-const assets = await prepareHaDialogAssets(options);
-
-async function probe() {
-  const fixture = await launchHaDialogFixture({ assets });
-  try {
-    const { page } = fixture;
-    report.chromium = fixture.browser.version();
-    await page.goto(`${fixture.url}/ha505-probe.html`);
-    await page.waitForFunction(() => document.querySelector('ha-dialog')?.shadowRoot?.querySelector('wa-dialog')?.shadowRoot?.querySelector('dialog')?.matches(':modal'));
-    await page.waitForTimeout(300);
-    const read = () => page.evaluate(() => {
-      const ha = document.querySelector('ha-dialog');
-      const wa = ha.shadowRoot.querySelector('wa-dialog');
-      const surface = wa.shadowRoot.querySelector('dialog');
-      return { width: surface.getBoundingClientRect().width, modal: surface.matches(':modal'),
-        radius: getComputedStyle(surface).borderRadius, preset: ha.width,
-        inheritedMd: getComputedStyle(ha).getPropertyValue('--ha-dialog-width-md') };
-    });
-    const small = await read();
-    await page.evaluate(async () => { const ha = document.querySelector('ha-dialog'); ha.width = 'medium'; await ha.updateComplete; });
-    await page.waitForTimeout(50);
-    const medium = await read();
-    await page.evaluate(() => document.querySelector('#parent').style.setProperty('--ha-dialog-width-md', '920px'));
-    await page.waitForTimeout(50);
-    const inherited = await read();
-    await page.screenshot({ path: join(options.output, 'authentic-ha-width-920.png') });
-    await page.setViewportSize({ width: 390, height: 844 });
-    await page.waitForTimeout(100);
-    const mobile = await read();
-    await page.screenshot({ path: join(options.output, 'authentic-ha-mobile-390.png') });
-    assert.equal(small.width, 320); assert.equal(medium.width, 580);
-    assert.equal(inherited.width, 920); assert.equal(mobile.width, 390);
-    await fixture.assertClean();
-    report.probe = { small, medium, inherited, mobile, provenance: fixture.provenance,
-      pageErrors: fixture.errors, externalRequests: fixture.externalRequests, websocketAttempts: fixture.websocketAttempts };
-    saveReport();
-  } finally { await fixture.close(); }
-}
-
-const rowLabels = ['Количество устройств', 'Общая площадь комнат', 'Текущие дата и время', 'Температура кухни'];
-const productConfig = {
-  version: 1, title: 'Сводная информация', show_on_mobile: true,
-  blocks: [{ id: 'block-1', title: 'Общее', visible: true, scope: { type: 'all' },
-    values: rowLabels.map((label, index) => ({ id: `value-${index + 1}`, label,
-      source: index < 3 ? { type: 'system', key: ['device_count', 'total_area', 'datetime'][index] }
-        : { type: 'entity', entity_id: 'sensor.kitchen_temperature' } })) }],
-};
-const referenceConfig = { title: productConfig.title, showOnMobile: true, blocks: [{
-  ...productConfig.blocks[0], scope: { type: 'all', spaceId: null },
-  values: rowLabels.map((label, index) => ({ id: `value-${index + 1}`, label,
-    source: index < 3 ? { type: 'system', key: ['device_count', 'room_area', 'date_time'][index], name: label }
-      : { type: 'entity', entityId: 'sensor.kitchen_temperature' } })),
-}] };
-const panelCases = [
-  { name: 'desktop-light', width: 1600, height: 1000, theme: 'light' },
-  { name: 'desktop-dark', width: 1600, height: 1000, theme: 'dark' },
-  { name: 'bottom-portrait', width: 800, height: 1100, theme: 'light' },
-  { name: 'kiosk', width: 1600, height: 1000, theme: 'light', kiosk: true },
-  { name: 'mobile-view', width: 390, height: 844, theme: 'light' },
-];
-const settingCases = ['native', 'real-ha'].flatMap((shell) => [
-  { name: 'desktop', width: 1600, height: 1000 },
-  { name: 'narrow-320', width: 320, height: 844 },
-  { name: 'narrow-390', width: 390, height: 844 },
-].flatMap((size) => ['light', 'dark'].map((theme) => ({ ...size,
-  name: `settings-${shell}-${size.name}-${theme}`, theme, shell, settings: true }))));
-const edgeCases = ['native', 'real-ha'].flatMap((shell) => [
-  { name: `edge-${shell}-effective-zoom-200`, width: 800, height: 500,
-    adaptation: '800×500 effective viewport proxy for 1600×1000 at 200%; not actual browser zoom' },
-  { name: `edge-${shell}-text-200-long-de`, width: 1600, height: 1000, textSize: 32, language: 'de',
-    adaptation: 'Root font-size 32px enlarged-text stress, long German entity name/id; not browser zoom' },
-  { name: `edge-${shell}-text-200-long-de-390`, width: 390, height: 844, textSize: 32, language: 'de',
-    adaptation: '390px plus root font-size32px and long German source' },
-].map((scenario) => ({ ...scenario, shell, settings: true, theme: 'light' })));
-
-function scenarioConfig(scenario, reference = false) {
-  const config = structuredClone(reference ? referenceConfig : productConfig);
-  if (scenario.language === 'de') {
-    config.title = 'Zusammenfassung'; config.blocks[0].title = 'Allgemein';
-    const row = config.blocks[0].values[3];
-    row.label = 'Küchentemperatur und langfristiger Messwert';
-    row.source = { type: 'entity', [reference ? 'entityId' : 'entity_id']:
-      'sensor.kueche_erdgeschoss_langfristige_temperaturmessung_mit_besonders_langer_quellenkennung_505' };
-  }
-  return config;
-}
-
-async function configureProduct(page, scenario) {
-  await page.waitForFunction(() => window.__card?._summary && window.__card?._model?.length > 0);
-  await assertFreshDemoBundle(page, repo);
-  await page.waitForFunction(() => window.__card._booting === false && !window.__card._bootFading);
-  await page.evaluate(async ({ scenario, config }) => {
-    const card = window.__card;
-    Object.assign(document.querySelector('#host').style, { width: '100%', height: '100vh', padding: '0', margin: '0', maxWidth: 'none' });
-    Object.assign(document.body.style, { margin: '0', padding: '0' });
-    card.panelHost = true;
-    card.setAttribute('panel-host', '');
-    Object.assign(card.style, { width: '100%', height: '100%' });
-    card.setConfig({ ...card._config, language: scenario.language || 'ru', kiosk: Boolean(scenario.kiosk) });
-    card._serverCfg = { ...card._serverCfg, settings: { ...card._serverCfg.settings, summary_panel: config } };
-    card._cfgEpoch++;
-    card._haSummaryPanelApi = 1;
-    card._serverCanWrite = true;
-    card.narrow = scenario.width <= 450;
-    const dark = scenario.theme === 'dark';
-    const colors = dark ? ['#3ea6ff', '#e6e7eb', '#9aa4ad', '#202126', '#3a3d45', '#11151b', '#2b2d33']
-      : ['#0b73b8', '#202124', '#5f6368', '#ffffff', '#d7d9de', '#eef1f4', '#e7eaee'];
-    ['primary-color', 'primary-text-color', 'secondary-text-color', 'card-background-color', 'divider-color', 'primary-background-color', 'secondary-background-color']
-      .forEach((key, index) => document.documentElement.style.setProperty(`--${key}`, colors[index]));
-    document.documentElement.style.setProperty('--ha-card-background', colors[3]);
-    document.documentElement.style.setProperty('--app-header-background-color', colors[3]);
-    document.documentElement.style.setProperty('--app-header-text-color', colors[1]);
-    document.documentElement.style.setProperty('--text-primary-color', '#ffffff');
-    document.documentElement.style.colorScheme = scenario.theme;
-    if (scenario.textSize) document.documentElement.style.fontSize = `${scenario.textSize}px`;
-    document.body.style.background = colors[5];
-    const entityId = config.blocks[0].values[3].source.entity_id;
-    card.hass = { ...card.hass, language: scenario.language || 'ru', locale: { ...card.hass.locale, language: scenario.language || 'ru' },
-      config: { ...card.hass.config, time_zone: 'Europe/Moscow', unit_system: { ...card.hass.config?.unit_system, length: 'm' } },
-      themes: { ...card.hass.themes, darkMode: dark },
-      states: { ...card.hass.states, [entityId]: { entity_id: entityId, state: '20.6', attributes: {
-        friendly_name: scenario.language === 'de' ? 'Küchentemperatur im Erdgeschoss mit langfristiger Messwertüberwachung und besonders langer Quellenbezeichnung' : 'Kitchen temperature', unit_of_measurement: '°C' } } },
-    };
-    card._summary.updated();
-    card._summary.saveLocal({ show: true });
-    card.requestUpdate();
-    await card.updateComplete;
-    card._summary.resized();
-  }, { scenario, config: scenarioConfig(scenario) });
-  await page.waitForFunction(() => window.__card._booting === false && !window.__card._bootFading && window.__card._devices.length > 0);
-  if (!scenario.settings) await page.locator('.summary-overlay').waitFor({ state: 'visible' });
-  await page.waitForTimeout(350);
-  if (scenario.settings) {
-    await page.evaluate(async () => {
-      const card = window.__card;
-      if (card._ensureEditorRuntime) assertRuntime(await card._ensureEditorRuntime());
-      function assertRuntime(ready) { if (!ready) throw new Error('Editor runtime failed to load'); }
-      await card._summary.openDialog();
-      await card.updateComplete;
-    });
-    await page.locator('hp-dialog[data-kind="summary"] .summary-editor').waitFor({ state: 'visible' });
-    await page.waitForTimeout(300);
-  }
-}
-
-async function capture(scenario) {
-  console.log(`Capturing ${scenario.name}`);
-  const fixture = await launchHaDialogFixture({ assets, authentic: scenario.shell === 'real-ha',
-    viewport: { width: scenario.width, height: scenario.height }, colorScheme: scenario.theme });
-  const record = { ...scenario, files: {} };
-  try {
-    const { page } = fixture;
-    // Let Date.now advance: the real card boot-veil quiescence uses it.
-    await page.clock.setSystemTime(new Date('2026-09-09T09:00:00Z'));
-    await page.goto(`${fixture.url}/product.html`);
-    await configureProduct(page, scenario);
-    const values = await page.evaluate((config) => config.blocks[0].values.map((value) => window.__card._summary.value(value)), scenarioConfig(scenario));
-    assert.equal(values.length, 4, 'Equivalent four-row product fixture');
-    record.product = await page.evaluate((settings) => {
-      const root = window.__card.shadowRoot;
-      const box = (node) => node ? { ...node.getBoundingClientRect().toJSON(), scrollWidth: node.scrollWidth, clientWidth: node.clientWidth } : null;
-      const panel = root.querySelector('.summary-overlay');
-      const hp = root.querySelector('hp-dialog[data-kind="summary"]');
-      const ha = hp?.shadowRoot.querySelector('ha-dialog');
-      const wa = ha?.shadowRoot.querySelector('wa-dialog');
-      const surface = wa?.shadowRoot.querySelector('dialog') || hp?.shadowRoot.querySelector('.surface');
-      const footer = hp?.querySelector('[slot="footer"]');
-      const editor = hp?.querySelector('.summary-editor');
-      const insideViewport = (node) => { const r = node?.getBoundingClientRect(); return !!r && r.left >= -1 && r.right <= innerWidth + 1 && r.top >= -1 && r.bottom <= innerHeight + 1; };
-      return { panel: box(panel), control: box(root.querySelector('.summary-control')), stage: box(root.querySelector('.stage')),
-        side: panel?.classList.contains('bottom') ? 'bottom' : 'right', rows: panel?.querySelectorAll('.summary-value').length,
-        settings: settings ? { surface: box(surface), editor: box(editor), footer: box(footer),
-          actualHA: Boolean(wa), modal: surface?.matches(':modal'), radius: getComputedStyle(surface).borderRadius,
-          border: getComputedStyle(surface).border, shadow: getComputedStyle(surface).boxShadow,
-          rootFont: getComputedStyle(document.documentElement).fontSize,
-          titleFont: getComputedStyle(hp.shadowRoot.querySelector('.title')).fontSize,
-          sourceRows: [...editor.querySelectorAll('.summary-source')].map((node) => ({ box: box(node), text: node.textContent.trim() })),
-          checks: { surfaceInsideViewport: insideViewport(surface), footerVisible: insideViewport(footer),
-            editorNoHorizontalOverflow: editor.scrollWidth <= editor.clientWidth + 1,
-            surfaceNoHorizontalOverflow: surface.scrollWidth <= surface.clientWidth + 1,
-            footerNoHorizontalOverflow: footer.scrollWidth <= footer.clientWidth + 1 },
-          close: box(ha?.shadowRoot.querySelector('ha-icon-button') || hp.shadowRoot.querySelector('.close')) } : null };
-    }, Boolean(scenario.settings));
-    const shot = async (side, area, locator) => {
-      const name = `${scenario.name}-${side}-${area}.png`;
-      if (locator) await locator.screenshot({ path: join(options.output, name) });
-      else await page.screenshot({ path: join(options.output, name) });
-      record.files[`${side}-${area}`] = name;
-    };
-    await shot('product', 'viewport');
-    if (scenario.settings) await shot('product', 'dialog', page.locator(scenario.shell === 'real-ha'
-      ? 'hp-dialog[data-kind="summary"] ha-dialog wa-dialog dialog' : 'hp-dialog[data-kind="summary"] .surface'));
-    else {
-      await shot('product', 'panel', page.locator('.summary-overlay'));
-      await shot('product', 'control', page.locator('.summary-control'));
-    }
-    if (scenario.language === 'de') {
-      // The genuine HA owns scrolling in its shadow .body; the native wrapper
-      // owns it in the editor. Follow the composed tree instead of assuming.
-      const measureSource = async (align) => page.locator('.summary-source').last().evaluate((source, align) => {
-        const label = source.querySelector('strong');
-        (align === 'start' ? label : source).scrollIntoView({ block: align, inline: 'nearest', behavior: 'instant' });
-        const hp = source.closest('hp-dialog');
-        const ha = hp.shadowRoot.querySelector('ha-dialog');
-        const header = ha?.shadowRoot.querySelector('ha-dialog-header') || hp.shadowRoot.querySelector('.header');
-        const footer = hp.querySelector('[slot="footer"]');
-        let bandTop = Math.max(0, header?.getBoundingClientRect().bottom || 0);
-        let bandBottom = Math.min(innerHeight, footer.getBoundingClientRect().top);
-        const visible = (node) => { const box = node.getBoundingClientRect().toJSON();
-          const visibleHeight = Math.max(0, Math.min(box.bottom, bandBottom) - Math.max(box.top, bandTop));
-          return { box, visibleHeight, visibleFraction: visibleHeight / box.height }; };
-        const scrollOwners = [];
-        for (let node = source; node; node = node.assignedSlot || node.parentElement || node.getRootNode()?.host) {
-          if (node.scrollHeight > node.clientHeight + 1 && /auto|scroll/.test(getComputedStyle(node).overflowY)) {
-            const clip = node.getBoundingClientRect();
-            bandTop = Math.max(bandTop, clip.top); bandBottom = Math.min(bandBottom, clip.bottom);
-            scrollOwners.push({ tag: node.localName, class: node.className, scrollTop: node.scrollTop,
-              scrollHeight: node.scrollHeight, clientHeight: node.clientHeight });
-          }
-        }
-        return { align, bandTop, bandBottom, label: visible(label), source: visible(source), scrollOwners };
-      }, align);
-      record.product.longSourceStart = await measureSource('start');
-      assert.ok(record.product.longSourceStart.label.visibleHeight > 0, 'Long source label must actually appear between header and footer');
-      await shot('product', 'long-source-scrolled');
-      record.product.longSourceEnd = await measureSource('end');
-      assert.ok(record.product.longSourceEnd.source.visibleHeight > 0, 'Long source end must actually be visible');
-      await shot('product', 'long-source-end');
-    }
-    await fixture.assertClean();
-    await page.addInitScript(({ config, theme, kiosk, textSize }) => {
-      localStorage.setItem('houseplan-dashboard5-config', JSON.stringify(config));
-      localStorage.setItem('houseplan-dashboard5-enabled', 'true');
-      localStorage.setItem('houseplan-dashboard5-theme', theme);
-      localStorage.setItem('houseplan-dashboard5-kiosk', String(Boolean(kiosk)));
-      if (textSize) document.addEventListener('DOMContentLoaded', () => { document.documentElement.style.fontSize = `${textSize}px`; });
-    }, { config: scenarioConfig(scenario, true), theme: scenario.theme, kiosk: scenario.kiosk, textSize: scenario.textSize });
-    await page.goto(`${fixture.url}/reference/index.html`);
-    await page.locator('#dashboard3-panel').waitFor({ state: 'visible' });
-    await page.waitForTimeout(350);
-    await page.locator('.dashboard3-value dd').evaluateAll((nodes, text) => {
-      if (nodes.length !== text.length) throw new Error('Equivalent reference row count mismatch');
-      nodes.forEach((node, index) => { node.textContent = text[index]; });
-    }, values);
-    if (scenario.settings) {
-      await page.locator('.dashboard3-settings-toggle').click();
-      await page.locator('.dashboard3-settings-dialog__window').waitFor({ state: 'visible' });
-    }
-    record.reference = await page.evaluate(() => {
-      const box = (selector) => document.querySelector(selector)?.getBoundingClientRect().toJSON();
-      return { panel: box('#dashboard3-panel'), control: box('.dashboard5-summary-control'),
-        dialog: box('.dashboard3-settings-dialog__window'), normalizedValueText: [...document.querySelectorAll('.dashboard3-value dd')].map((node) => node.textContent) };
-    });
-    await shot('reference', 'viewport');
-    if (scenario.settings) await shot('reference', 'dialog', page.locator('.dashboard3-settings-dialog__window'));
-    else {
-      await shot('reference', 'panel', page.locator('#dashboard3-panel'));
-      await shot('reference', 'control', page.locator('.dashboard5-summary-control'));
-    }
-    await fixture.assertClean();
-    record.pageErrors = fixture.errors; record.externalRequests = fixture.externalRequests;
-    record.websocketAttempts = fixture.websocketAttempts;
-    report.captures.push(record); saveReport();
-  } finally { await fixture.close(); }
-}
-
-try {
-  await probe();
-  const cases = [...panelCases, ...settingCases, ...edgeCases];
-  if (options.only) for (const name of options.only) assert.ok(cases.some((scenario) => scenario.name === name), `Unknown case ${name}`);
-  if (!options.probeOnly) for (const scenario of cases.filter((scenario) => !options.only || options.only.includes(scenario.name))) await capture(scenario);
-  report.status = 'complete'; saveReport();
-  console.log(`Diagnostic evidence: ${join(options.output, 'report.json')}`);
-} catch (error) {
-  report.status = 'failed'; report.error = error.stack || String(error); saveReport(); throw error;
-}

demo/capture_wall_strip_backup.mjs

@@ -1,85 +0,0 @@
-/** Local-only visual proof for #275; external backup contents are never printed. */
-import { mkdirSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-import { optimizePlans } from '../test-build/plan-optimizer.js';
-import { launch } from './serve.mjs';
-
-const input = process.argv[2];
-const outputDir = resolve(process.argv[3] || '.');
-const mode = process.argv.includes('--optimized') ? 'optimized' : 'raw';
-const nodesArg = process.argv.find((value) => value.startsWith('--nodes='))?.slice(8) || '';
-const nodes = nodesArg.split(';').filter(Boolean).map((pair) => pair.split(',').map(Number));
-if (!input) {
-  console.error('usage: node demo/capture_wall_strip_backup.mjs <backup> <outdir> '
-    + '[--optimized] [--nodes=x,y;x,y]');
-  process.exit(2);
-}
-
-const backup = JSON.parse(readFileSync(input, 'utf8'));
-const payload = backup?.payload && typeof backup.payload === 'object' ? backup.payload : backup;
-const source = {
-  config: payload?.config && typeof payload.config === 'object' ? payload.config : payload,
-  layout: payload?.layout && typeof payload.layout === 'object' ? payload.layout : {},
-};
-const rendered = mode === 'optimized'
-  ? optimizePlans(source.config, source.layout)
-  : source;
-const config = rendered.config;
-const layout = rendered.layout;
-if (!Array.isArray(config?.spaces) || !config.spaces.length) {
-  throw new Error('backup has no spaces');
-}
-
-mkdirSync(outputDir, { recursive: true });
-const { page, browser } = await launch({ width: 1800, height: 1250 }, 1);
-await page.emulateMedia({ reducedMotion: 'reduce' });
-await page.evaluate(async ({ cfg, lay }) => {
-  const card = window.__card;
-  card._serverCfg = structuredClone(cfg);
-  card._layout = structuredClone(lay);
-  card._space = cfg.spaces[0].id;
-  card._setMode('plan');
-  card._tool = 'select';
-  card._cfgEpoch++;
-  card._modelCache = null;
-  card._frame = null;
-  card._wallUnionCache = null;
-  card._physicalBodiesCache = null;
-  card._lightBarrierCache = null;
-  card._isoGeometryCache.clear();
-  card.requestUpdate();
-  await card.updateComplete;
-  card._fitAll();
-  card.requestUpdate();
-  await card.updateComplete;
-  await new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
-}, { cfg: config, lay: layout });
-
-const fullPath = resolve(outputDir, `${mode}-full.png`);
-await page.screenshot({ path: fullPath, animations: 'disabled' });
-for (let index = 0; index < nodes.length; index++) {
-  const center = await page.evaluate(([x, y]) => {
-    const card = window.__card;
-    const svg = (card.shadowRoot || card.renderRoot).querySelector('.stage svg');
-    const matrix = svg?.getScreenCTM?.();
-    if (!matrix) return null;
-    const point = new DOMPoint(x * 1000, y * 1000).matrixTransform(matrix);
-    return { x: point.x, y: point.y };
-  }, nodes[index]);
-  if (!center) continue;
-  const width = 420, height = 360;
-  const clip = {
-    x: Math.max(0, Math.min(1800 - width, center.x - width / 2)),
-    y: Math.max(0, Math.min(1250 - height, center.y - height / 2)),
-    width,
-    height,
-  };
-  await page.screenshot({
-    path: resolve(outputDir, `${mode}-node-${index + 1}.png`),
-    clip,
-    animations: 'disabled',
-  });
-}
-await browser.close();
-console.log(JSON.stringify({ mode, full: fullPath, crops: nodes.length }));

demo/fixtures/large-house.mjs

@@ -12,6 +12,7 @@ const OPENING_COUNT = 100;
 const PARTITION_COUNT = 60;
 const COLUMN_COUNT = 40;
 const DECOR_COUNT = 500;
+const STAIR_COUNT = 250;
 
 const round = (value) => Number(value.toFixed(6));
 
@@ -119,6 +120,23 @@ const makeDecor = (floor, count) => Array.from({ length: count }, (_, index) =>
   };
 });
 
+const makeStairs = (floor, count) => Array.from({ length: count }, (_, index) => {
+  const column = index % 25;
+  const row = Math.floor(index / 25);
+  const common = {
+    id: `perf-stair-${floor}-${index}`,
+    x: round(0.025 + column * 0.039),
+    y: round(0.03 + row * 0.1),
+    angle: (index % 8) * 45,
+    target_space_id: 'perf-floor-2',
+  };
+  return index % 2 === 0
+    ? { ...common, kind: 'straight', direction: index % 4 ? 'forward' : 'backward',
+      length: 0.12, width: 0.045 }
+    : { ...common, kind: 'spiral', direction: index % 4 ? 'clockwise' : 'counterclockwise',
+      radius: 0.05 };
+});
+
 const entityKinds = [
   ['light', 'on'],
   ['switch', 'off'],
@@ -188,9 +206,10 @@ export const LARGE_HOUSE_COUNTS = Object.freeze({
   partitions: PARTITION_COUNT,
   columns: COLUMN_COUNT,
   decor: DECOR_COUNT,
+  stairs: STAIR_COUNT,
 });
 
-export const makeLargeHouseFixture = () => {
+export const makeLargeHouseFixture = ({ includeStairs = true } = {}) => {
   let openingsLeft = OPENING_COUNT;
   let partitionsLeft = PARTITION_COUNT;
   let columnsLeft = COLUMN_COUNT;
@@ -228,6 +247,7 @@ export const makeLargeHouseFixture = () => {
       partitions: makePartitions(floor, rooms, partitionCount),
       wall_columns: makeColumns(floor, rooms, columnCount),
       decor: makeDecor(floor, decorCount),
+      ...(includeStairs && floor === 0 ? { stairs: makeStairs(floor, STAIR_COUNT) } : {}),
     };
   });
   const runtime = makeRuntime(spaces);

demo/golden/baselines/baselines-index.json

@@ -1,39 +1,47 @@
 {
-  "schema": 2,
-  "matrixVersion": 64,
-  "acceptedAt": "2026-09-23T14:08:24.123Z",
-  "sourceFingerprint": "2b04d2889e0a5948d73c9e38fc89660ac8a2c64b91e0f4914849c235294f7787",
+  "schema": 3,
+  "matrixVersion": 67,
+  "acceptedAt": "2026-09-28T13:36:48.059Z",
+  "sourceFingerprint": "baa0806921c7f72959047c7d2bda343ef5e378c4e8d2a8e612f74b6af2e2c5b1",
   "chromium": "151.0.7922.34",
   "capturedOn": "linux",
-  "acceptedOn": "win32",
+  "acceptedOn": "linux",
   "capture": {
     "platform": "linux",
     "arch": "x64",
     "chromium": "151.0.7922.34",
-    "buildFingerprint": "2b04d2889e0a5948d73c9e38fc89660ac8a2c64b91e0f4914849c235294f7787",
+    "buildFingerprint": "baa0806921c7f72959047c7d2bda343ef5e378c4e8d2a8e612f74b6af2e2c5b1",
     "ci": {
       "repository": "Matysh/houseplan-card",
-      "run": 35870750208,
+      "run": 36427848424,
       "attempt": 1,
-      "sha": "5585bfb730db615831d6f794d56cbb978521d83c"
+      "sha": "c1289886175e165c5be09e4bd700a572529da234"
     }
   },
-  "foreignCapture": {
-    "reason": "acceptance of Linux CI artifact 35870750208 on Windows owner machine (#455, #640, #610)"
-  },
+  "localAttestation": null,
+  "foreignCapture": null,
   "witnesses": {
-    "count": 111,
+    "count": 107,
     "floor": 10
   },
   "scenarios": {
-    "panel-wide-view-light-en": "2c93497871bc40f6401f6cb7e65e73bf98d0064bd2755ca2026135975bd2d9f3",
-    "panel-wide-plan-editor-dark-en": "9404d7e3aa84b4b40a8cfeed27eea8831e55e9e6236abbb7cb092c709ca0dfcd",
+    "isometric-stage6-light-lightfloor": "80ac5d4ed1535fbaa1420b5da1a35599cc8ef9a35e4fa723c89e25ef235f792e",
+    "isometric-stage6-light-darkfloor": "46e25d32a4e4f156586a327cdfbc6f59e79178733b6301c89843b8a8535a738a",
+    "isometric-stage6-dark-darkfloor": "5b76746846c13c2dbca9ade31d4e6cb891a9a486029ebcf4008539a4a92b47fc",
+    "isometric-stage6-dark-lightfloor": "157e0aaf68396b8ed5acc0d2caed935dc0d17c014c265cb2aaeda66944bba8c2",
+    "isometric-stage6-hover-light": "3f8dc5052e883a30e3cf89c1a0fdea0af3bae3c763b6ebaa50e41cba9cdb3bfd",
+    "stairs-flat-normal-light": "abd698576bb726bc70226deb72c12c3b7ebf36dd3007186e5d9444d630075bef",
+    "stairs-flat-hover-dark": "2502c9526ce73017e465bd35a8609afa0dbcac8dfa34ef37cfad8b3f39ebcd52",
+    "stairs-flat-selected-light": "c395ae3969521f6a157ff6e9460971db26287f9a5ca73f6ecbba6e8d35c3424f",
+    "stairs-isometric-dark": "038bb2752cb98b652541fdc6307f89e85ddd46212014e1991f7086cb42911ab3",
+    "panel-wide-view-light-en": "275d09b3730361bb491a832fbb76723d90a7327086f042cbf0fdd79f4a002800",
+    "panel-wide-plan-editor-dark-en": "093a3fd1022755f5128261796e009383d7e7a23e9e50f193ab1987d30f9313b2",
     "panel-narrow-read-only-empty-light-en": "99b8f1af82b1ad13f237125aab8f7e7da0563c138e9da2ddf06e54c2d56138c4",
-    "version-mismatch-desktop-dark-en": "b8059b768284208f605329618799d13491655e488e9d739a40b85cdc0eba5888",
-    "version-mismatch-touch-light-ru": "df42d0158025371b82eabd522e0dd7d0b9121a9ba685970db3d7839d97fce50f",
+    "version-mismatch-desktop-dark-en": "8981a02083caa27a163e9c59319bfdb3f55adf70ee319c9ac9a80739e08dd84e",
+    "version-mismatch-touch-light-ru": "855bb817ffd5628e8bdcc4e5e48367b140ff16e5040e674555fbb52c43d7867c",
     "version-mismatch-kiosk-attempted-dark-de": "2e3eaf2fb13d1cca77abe97938374b3e25235fc7db87bb6f7a2e72f1cafe4a7e",
-    "hidden-wall-diagnostics-plan-light": "4113474796ccb1b7b8c876fcb463e97eb77bb1ec96129195a0dafdcc7ccca334",
-    "hidden-wall-diagnostics-plan-dark": "40c48868f0251aec3b1a14c0eef77a78cc7965420fb9b41f46f8190d1fdfd11a",
+    "hidden-wall-diagnostics-plan-light": "7bcb8a821b8e0712b1a6c9ad6f36965448db75575ffb02f5d5af0cd328d3c27f",
+    "hidden-wall-diagnostics-plan-dark": "a89b83c64cc7bf0fb4989eceaa4cd24297309221085603f676dc0398da344ecb",
     "coincident-partition-before-dark": "32d6d7e32db1bb579b33c783833ce986d10a81589e0783c5e7fae4b8c1e2755e",
     "coincident-partition-thin-dark": "a5bd00dfd6a085b81cf5e213b34669d60edf5c03451ec2943ce31c735497cf8c",
     "coincident-partition-thick-dark": "848021570e9cdf98bbfa3e9035ac09fe70695ab6b48964f8f947e30ae5695141",
@@ -43,44 +51,44 @@
     "split-corner-wall-thin-dark": "0a8da611ecb6061852cc26ee53c00d12433cf8539681bd91dac3adad1d7e9e67",
     "split-corner-wall-thick-dark": "2efc65ddaa8777ebffe63205e2a961fa7053c91d3cd8c0af59810bef01ecd498",
     "split-zero-divider-taper-dark": "f7f9ee435da00dcae043c693127561a5e050675ca4d6f6f0d916ac5dbe24a594",
-    "isometric-geometry-view-dark": "d02f39b803370d0b5b1ffe5c675591b0faf0797f0a34fcd9fee6e04bcc2f87c5",
-    "isometric-geometry-view-light": "aae5bb78d2d49be627d8cbc2ecd960ebeea7d35fe06f36eeef4674c49f136c4e",
-    "isometric-live-layers-dark": "17f41e1d18f7b16d824c437ec85c31e85300a97fc01a8a4200052f394e013d89",
-    "isometric-no-borders-dark": "ec8952f4bbd4011aed80cf66c9fa8345fe4f91fecfe0c4d9f33c5ae3e210805d",
-    "isometric-touch-kiosk-dark": "f478ac634e2367e2753fe2d44b516113425812e5724fd37c2b2ecb89b47c384b",
-    "isometric-large-warm-remount-dark": "354fc12ca28a58866d7ee58794485a87dcdc5887a6c0faa6afe36aaf4a4dd824",
-    "isometric-stage3-overlays-light": "a119a02a7e8755cb398f367a6fefeb6b4dceadd42d60453d11c5d3e83acae829",
-    "isometric-stage3-overlays-dark": "40355196c8578159e13aaa6b0086f6175a473f8f24ceefbde3e67791ffd26135",
-    "isometric-stage3-openings-dark": "702d1c159333a13483405f19bea5b0c580c717ac1c04428fdbaef6d97929c96c",
-    "isometric-stage3-forced-colors-dark": "79e0a916a3bec26c700a8eb280f161e6179685ea05ddf988b04bcb9e9c035747",
-    "isometric-stage3-no-filter-dark": "b0a9336db629283a61666e449cb1d70e537a6a3b85f4faf0a4da24e5877c8fe6",
+    "isometric-geometry-view-dark": "877cde0e1037071a23b3356141c1ddd1a74bcd33da5367ada2809ca6c3ee989b",
+    "isometric-geometry-view-light": "50164a84574bb81b860db94fd07cc5173eb676d4371deb90f3d2e16f5d252398",
+    "isometric-live-layers-dark": "1c3a54350b3bb07b4aa34bf853d22f12622616e1c8208f9d64c5e478c7d92bb2",
+    "isometric-no-borders-dark": "406fa7c7597724cba00df6451a1b81d5c306af0259cc9198e1985b6f325d619d",
+    "isometric-touch-kiosk-dark": "e88e95124300b723e6a3b4563961f7d178a2517f41f7b4a2c9fac3534a57c24f",
+    "isometric-large-warm-remount-dark": "d7932b8baea6b5689480a123698d562bcea2eb0d8536c3516272f5ebef4a4cc8",
+    "isometric-stage3-overlays-light": "3824e3c9901a53a19d2a5e069922e982bc2c8bdf21fc5ba6e8e6477bc2bb1f6d",
+    "isometric-stage3-overlays-dark": "adb042cf55b0c0e75412eea9167aec1df03e24cadb72e8e67d259927d687009b",
+    "isometric-stage3-openings-dark": "33c7c657229b44a3a52bbefe0197302d909b69dc0f1127352410d13f6d0d93f7",
+    "isometric-stage3-forced-colors-dark": "06675a2bf71d405c34dc430e1761f5cb78168d5b52207bb2ca7923f6dd8ce50b",
+    "isometric-stage3-no-filter-dark": "bdec8fce7628934e00a29b2c489226c8b0ca33b3e315fdd34c1f89a804dc125e",
     "geometry-view-dark-fit": "454da1248f1fe13b8f60c589ae9ebee5e852995e9bc5175d3c5692c445f7cb94",
     "geometry-view-light-fit": "de5f6a41552447ca909d20471ed6665f558fb6e111c1f333eeba55866517d5a5",
     "pdf-export-geometry-light": "c403a141cefb73e4653f2ffb9c346b4cfaa3de339b6c39c227ef1552ebde0048",
     "pdf-export-polish-light": "ed6685900355e20a4618e931d42d2e45a39ad44e4a2ab044fa5ee64ff56f12f4",
     "pdf-export-stepped-dimensions-light": "b9732b8b9c38153c564d0c93fbfbf44a8dd348c8667d2f8c2d14492e08e04f3e",
     "vacuum-trail-smoothing-dark": "f8eecc726a3e8bdaba414584ad6afd48908ee9d96ea969a1e37758f4e76843e2",
-    "room-label-parity-view-dark": "a188d4db84533d605cb6fe822d20c34d164e3bfc8458a55beaad564854eef169",
-    "room-label-parity-plan-dark": "07e896d4f6dad384bd52dc60f786f042e1cfcd26ddb1f7b12b72d40bb4824324",
-    "room-label-parity-view-light": "dd96a224c4d951720031ff1ba793a1ba560951e0441cb4f61ee82215aff1d8cc",
-    "room-label-parity-plan-light": "91b7aed42c3a677e387b26c405a04dcc327957f9368625c7c3ad3cca758f1fb1",
+    "room-label-parity-view-dark": "4c00ee3119d3886a5906d5880769558083eb06547a2e2c56e91ae84498416bc9",
+    "room-label-parity-plan-dark": "88374fbca15362da485ff32a0c5dce21bd07ee752087a863e10484537b18a930",
+    "room-label-parity-view-light": "ec2a1294b0f08019f49a392cdc94970c1545673ebe0d7f22652f602adf00d4e8",
+    "room-label-parity-plan-light": "1ee88b46a711e9116fefbeb8205618d68ddaa99fa3f290f0881e696afd1d1e57",
     "washer-active-cycle-dark": "0d683619c27747b3dd6a1e6c7cdc5e15dd886f4f2db4b85b7ca5a5c529e9ec52",
     "washer-idle-cycle-dark": "0138902daa8dabb0588904507ef5a44f5257f7859b4f1198191bfca3dd4130b7",
     "day-cycle-dawn-dark": "96bd5ef84345976bb83d35d418e7d247503629eceb732b6e926f2217f3b9faa4",
     "day-cycle-day-dark": "605849bbada8d3c3a02a2c88c7b21c81c675a7a89b72c4c560df635d63005e67",
     "day-cycle-dusk-dark": "d19cc97b75014d9f0661705df50d5f30a3a574661957c04c5dab96e26c5e3364",
     "day-cycle-night-dark": "39a6a959676295eb4ead02703533641f57901ad0ce1359933e1d47f48867196a",
-    "geometry-plan-editor-dark": "6fa29c51ac37449e53ff76afe17760a86325e160f53040c737619aae1095599d",
-    "safe-resize-handles-clamp-light": "4c2856edc3c2c8be740b052d747f144dd6f02e6737ef2df06880eb1a5ec634d4",
-    "safe-resize-handles-clamp-dark": "581f85ca93197ba796e72daa67402eebb7c64f13d4722b5d33943577837c8980",
-    "space-tab-drop-before-light": "2678c840a33ade95f8a038213a696132612cb9bae8290e467ae9c4ac2ee265e3",
-    "space-tab-drop-after-dark": "f4f3ab1bb986426f281753a101b4055fae1f5f1ed0c04c8d41071dfa260978f1",
-    "plan-snap-endpoint-light": "40f761e1a7a12e5113ec6e736c6d7176908d8a1585281c2c2f438bc1fee36e1d",
-    "plan-snap-line-gaps-dark": "e4e5e15a98e35ac26a5b0fe7ef674341fb55d8445587ccc25a81603e1ef92774",
-    "wall-junctions-plan-preview-light": "f6f450768912f37b3d91730cc38f43b399eab781e585bdbe6c9bb29458b56f4c",
-    "wall-junctions-plan-t-dark": "6c3748e931407079e3aad3ade77c46069ef75444c27405549d1610670a33ad95",
+    "geometry-plan-editor-dark": "5e7365ef5820a9c2ea51abd3be0c56900de7932e3da4f78fc8103f307a5fcf65",
+    "safe-resize-handles-clamp-light": "80b3cf9c755dbb77deceaf6deb4569bd1570093509b37e96beb32dd2a07d40da",
+    "safe-resize-handles-clamp-dark": "dd32a1034f349b27717a89516b91a85b916e70080cfeffb127b0b51a24683bff",
+    "space-tab-drop-before-light": "325225df7961482e81931989d1094ab232ca1afac8843febece2d2f124cff04b",
+    "space-tab-drop-after-dark": "c5b2e4089da3f1ddf22f8eb7cd224ddd12ca23680b3800d496f1d218706ed666",
+    "plan-snap-endpoint-light": "3b62f84beade690df3bf957cac80e7e1c66f2d30b2587d3c81419f617f23d31a",
+    "plan-snap-line-gaps-dark": "652277b925c0e4931094e323b14498ff0d44ed19abdde4e26f1e7a28256c5443",
+    "wall-junctions-plan-preview-light": "3d4b493e86ea3b702b326d2dd9db146170faf4ed3810eeb5f02dda8d50b2fd3e",
+    "wall-junctions-plan-t-dark": "395155d3ea4a432b05e81372dd0a039cb47cfe9355ff0fad7a7ab7b9c613bce8",
     "wall-junctions-view-dark": "b3385dd544e87aeacbc85020621de96ea20feecccf907bc5de3d2c045860a1cd",
-    "junction-patch-resilience-plan-dark": "8ad87deb245097cd090f301d259710323cf4ea577cd8edaf16607d6ad8a3d29d",
+    "junction-patch-resilience-plan-dark": "e35fca8310d84fa0b4b5fb87641d0c3b550270a7fd8b735080d4d08d79801d1d",
     "junction-patch-resilience-view-dark": "db72b14098dd26132521b71adc87cf5798e5d48faa1f449c294ca2df81077849",
     "wall-union-isolation-view-light": "2fffbcef2001b24b4ce7d104f0457231044be7ee0718e7f31b6fc13b024f2bc9",
     "wall-union-isolation-view-dark": "7dce51897ce87e96b7f43d62d68ac859aa662a2aa1227cc853bc86e5bbf321e4",
@@ -88,34 +96,38 @@
     "orthogonal-strip-cell-5-view-dark": "267a3eab1f4ad7d8d484eb2a58b3e38031b0516ca8c46c93e272bfaf9ac409b8",
     "orthogonal-strip-cell-1-view-dark": "7c9bab0789f9ec9019edf3c49176415af83e8a325e833f98a0e6324e7f06fe4c",
     "wall-key-roundtrip-view-dark": "74fd46cffefd32d805296d844c162dbe6f15b13e86c4d6c7f6974293b253e1b4",
-    "isometric-wall-junctions-dark": "fe69b10e313298b9cffdd5bc6266e6e9314c4c3b4da85a22af277f31314cca1b",
-    "opening-placement-door-thick-wall-dark": "9d587eff0c2561ef5f84e9280cd812fa6e9af7cf6ff00c922d275796774ba513",
-    "opening-placement-passage-thick-wall-dark": "6ed48b39c0e11fbf4b0df7d3e4dad8078e5b17694f1a780936a864bebd0c1c57",
-    "opening-placement-passage-thick-wall-light": "3d4e3a5d9b67f2450fab9ccc0f5dc91f4485080582377de904f16ea1d62fbafa",
+    "isometric-wall-junctions-dark": "e6bf156d2afb70a631ceade26d6431caf92721a28a661fffd1654f49711fcb3e",
+    "opening-placement-door-thick-wall-dark": "cef2c75a6c60197c24a848fab7e47919437c751aae79ec4d88d744eb70abed43",
+    "opening-placement-passage-thick-wall-dark": "8d089364f6f9aace8a0cccad952731e6d295440b9eb1c8cb75b6e2264b8fa5c5",
+    "opening-placement-passage-thick-wall-light": "14c06cd119a476f8a4edb63db37d55c6d4000f6fbb3ed412cb88e225574896a6",
     "opening-symbol-room-wall-light": "dc3f6513a08b809a77df6822f59fdb30c912f320e55d47d749963678fbb8f417",
+    "static-hatch-openings-132-dpr1-light": "4d9f858e7d88113a3d65ed5ce96d7da3a60d0a9bb4a520d4522c59c6b1cadd1c",
+    "static-hatch-openings-140-dpr1-dark": "6e1571b0e49771d2e657dddc4fdd53ad64f0234ca0bd127c34a72f23e076319a",
+    "static-hatch-openings-132-dpr2-dark": "ea27355d19b6a4142a67dd37dab8498315047c01d517251b23059521659f6165",
+    "static-hatch-openings-140-dpr2-light": "482795eb2186c1cf4b914568a0c3349a864fce6b69c3c05d40a780e75f61e148",
     "opening-symbol-diagonal-partition-dark": "fe264aa0a5926d904ea0a2d15e5f0567a536c9251a72bf96a287d7bf9c480aa1",
     "opening-symbol-flip-pairs-light": "693fe97bae8375c6a16244fbb4ddaa1ed447732382a45d4629e1711e0aa0d45a",
-    "isometric-opening-symbol-parity-dark": "cad79850e1477f4a014cd2cf42c4d8d29e96e3cf3190afc6f3336841eff26bfb",
-    "geometry-devices-editor-dark": "e273c4fe49619a5856a9212ff6261803640e5afa79b841edfccf5a4056e0264d",
-    "device-inbox-desktop-en-light": "2556b2ca3916c016bec58767acc3eab445e32ef29ae59e8ef3580f27cdee9f21",
-    "device-inbox-desktop-ru-dark": "f6da7aca353c904e37f2aae9bda9ef79b0c102926f9b9dbab5f6d9b7a14bbfb3",
-    "device-inbox-narrow-ru-dark": "48336c685b2c6a25cae422912973b1e0876e38c2d2ddc92a643e6d121410af35",
-    "geometry-decor-editor-dark": "2f8a3742166c10c0a5aa1239c9b6b7d908e7e578dc43229274b17d015c47503c",
-    "tray-wide-selection-en": "5a535b457b8b274ff25085ee992aebd95d756415afe1321d0aadee70610d5801",
-    "tray-wide-tool-ru": "99abefe9c5b0f21356e87b46fc6d6d615cf9b799614c14bf8fffa0261fd9059a",
-    "tray-medium-group-en": "afdb651c687cabda48e62d426b9ef4926a23caa86904fe6fa2c163930070b2bd",
-    "tray-medium-selection-ru": "5d78f5d818514ab80a4fb2949274edffd372e0d2e41bc3ccf39a22fd7c993f6b",
-    "tray-narrow-palette-en": "100d7a87eebf6665bf67cdd53b7f23ade885827af8dc6cc7ae27cebc971b8fb9",
-    "furniture-categories-light": "36676ada243391e7b3b27974df5db1fd33da45508bdcb879b01be239521b830d",
-    "furniture-variants-dark": "7988bb13215657886a1e08ada67317f030c7f99d6d1f483b5d61cebc492cb46b",
-    "furniture-variants-light": "d025401492c808b11fc84e862d3154cd7ccd57095436488575d4b23f7b2debff",
-    "furniture-placement-preview-light": "eeaea99b86807fcf61960ce7c688d929721a3a3ee47867d564079d86d089f7e5",
+    "isometric-opening-symbol-parity-dark": "5dfcd219d9cdc41c382d6e436f15665c0a265ba2b7138b2856e1a50f0e252062",
+    "geometry-devices-editor-dark": "1cc18ac3250a0cc20981b090ef7f964555b237e085e3ddbe10cc7b6081342c8c",
+    "device-inbox-desktop-en-light": "3a1229f1f5134c329ee457a62e555896ffd664d1d6cbd217e4e8248dc0c07dc7",
+    "device-inbox-desktop-ru-dark": "2b0981e7cc134a8f2cfe107c58833e33b862a00a89cadc5033f3b633562f9379",
+    "device-inbox-narrow-ru-dark": "7694119b368baf49fe8c0aeeec46a75bd77c0987266e4a64f5d13a2099e5f098",
+    "geometry-decor-editor-dark": "0fddb5ba477ecad15827215d04d22e9ba1adfacbbfc853712b1e76832182fa5f",
+    "tray-wide-selection-en": "e544ee6b4cde64aae188bac9be9e52c1232a3de8e98e1f68af42d8c7064f0a38",
+    "tray-wide-tool-ru": "d3c49be18142f280c21062612cf06dc8df6e5a076c53aeb2d62da8e3975c8003",
+    "tray-medium-group-en": "6ba416e0ca3cb2fba4a420703318e62d8651053d76ae1936a37537ab486af4a8",
+    "tray-medium-selection-ru": "d5a82d474f75f438c06a340897a9e009e7df0c95c5ef07edd3952f0fe43a0f40",
+    "tray-narrow-palette-en": "d2147c10ec130bead031db16090b0638188a548163ca8dfbfa86e68e71865051",
+    "furniture-categories-light": "8ffc0d18edc76dad428190f7c041ce9fdf9c5cc71a8329116bc1c7ae040a7fd8",
+    "furniture-variants-dark": "368f863d070b8f2f02cf657731aab0e7d80bdf5a817193709bb2838d429ac4e1",
+    "furniture-variants-light": "a702b38b8bd42919a5ed8753b87489545eb6d6538726e5cc3cb856a586834974",
+    "furniture-placement-preview-light": "8a78103d7cdd2808496f6d73b8a65859c4e6b57ee53a0c18f4d90580945673ba",
     "furniture-plan-art-dark": "e8d3ab381dd33e28c3c05271afeb66b110483e7fcf6e9c660d578c9ae3b4072f",
     "furniture-new-symbols-light": "51535124c8a68cae621c4fbfc4398edd5bf820caaf6be9a5d2b5fdf962e0b628",
     "furniture-corrected-art-light": "e7b62ae426c12fa4850429af9d92ca1dd03eedd583d7412112dd30bddf21a7d8",
-    "furniture-transform-light": "ca1db454c8ffe5eb9558bb08f29615b804a4f7b002d90bf51f010b2189d450af",
+    "furniture-transform-light": "ae0772d4a450646f24460a20016f42ea9dda78e7d696c27aee5387d23089f314",
     "furniture-transform-dark": "04ccddce94dbd35bd3da7e5a40dc5f80adb189e3b5ed6e5e99142258558c207f",
-    "tray-narrow-tool-ru": "fa8f7125ea9f5c43f47ad090cf78ab970950a03dc5a9fa1c348c880ced7c0c4c",
+    "tray-narrow-tool-ru": "62765f588d404e3889f1bbc58e40446535e8b4f322fec3b5dae856c076273511",
     "geometry-diagonal-45-opening-dark": "a083c9a5b39124f8f6fa8123562f1a5e24c884fa47c54c99786b24164e8bfa78",
     "openings-thick-wall-dark": "10b672a9965a994928111911760c987b45c7166c60e6bb0cbe02b2c11c59c211",
     "openings-filled-tunnel-dark": "87edc3afb2720f8b75deb02c2b2817bee9534b7908e4dab8e8fee26cc6daf99d",
@@ -152,7 +164,7 @@
     "junction-x-90-equal15-dark": "f01ecc2b28d457fbff0581681dc8c1a1555558baf4c0ac8e2bd4bdd3637f51b4",
     "junction-x-90-mixed-dark": "1218a50ad968eae651e61637eeaed8238d0598d77749d3c9cdb7bdd7c0d6a063",
     "junction-x-45-alternating-dark": "08de6b9d3a0e6d0164efc014fb1845cdd70cccb95b05b0d55175f2bca89c378b",
-    "junction-star5-equal15-dark": "4bc9337b4bd2ac4bcb8d168166330faad20184c8b3e51b153ef91d0ad76124c1",
+    "junction-star5-equal15-dark": "08a2410949b60cad38885004c01821935fd04dd1aed15880593069fab6db7e06",
     "junction-y-60-equal50-dark": "89994b12fd168b3e35ee47520fafa502f904391f98cec909fccac19b7b0a90e5",
     "junction-acute30-mixed-dark": "bc4f61f377711df71950ea6a8bea7d185c94b5e03bfc2e8fc4930fa9adc9ca02",
     "junction-acute15-equal50-dark": "3883df35644df7cc169cacb96a5ee8391d64878930c69a0d511cd0cca0f2a04e",
@@ -169,36 +181,36 @@
     "large-house-zoom-040-dark": "84f9e93b5fd25caaf031dc7758553c29459d4dda31e086b7d79e904c9b3d6230",
     "large-house-zoom-250-dark": "fa901d097023320a599c1c80be9f9c65a0ce6245bb7182bc0f3d90d679668c17",
     "large-house-warm-remount-dark": "6ed51a1c76cd7c62875eadafc169f7c6fc25604e64edabd9594a3664c886987d",
-    "device-dialog-desktop-en": "8e85d6f89bb3665e1588d3382f66c6c063d16a40a19472beec03f571899bf1ac",
+    "device-dialog-desktop-en": "f5d660f9244712f016c02c560a4bd301f3729edd4ca1e63b3d2cf0fab9c71802",
     "device-dialog-mobile-ru": "2486302565fb8dadb7758384e592b059df45f6f8b92195738e5a0bf62758c713",
-    "device-dialog-desktop-de": "d743bf734ad12f2282e262048eeed97f90c3ca5de2af84bd4d7304794f143351",
-    "room-temperature-dialog-desktop-en": "dd42f01dec3f5c69bae9777c39abed5b8e9e3c076f0046779f9b8a65fec4a90c",
+    "device-dialog-desktop-de": "972d56b0a0307ad7a061175aa0f6147c3170fc64eadb88bafd038835fd2ce331",
+    "room-temperature-dialog-desktop-en": "cea714dbe38185ea3d936fdb7cb71a0205feb74687d3ade517aed28407abd4a9",
     "room-temperature-dialog-mobile-ru": "5ca1c4f18eab3fb4c0667f76b0d0340df94f24e0457baca89234e0ef159f62d6",
     "room-discard-dialog-mobile-ru": "9c85af0cdbd2842808ef5ac8fdb306f621a726b0ac77c1449722c85399b4cb3f",
-    "german-view-mobile-light": "8c079d1574a6fbec478eacc872a46800f4348a9ce6d4dc1b1a11f88df8688e19",
-    "toggle-entity-dialog-desktop-en": "d2bc74705c9687d11bd55d22140635c2fb55de6496c7e85dfbb67ac049483f55",
+    "german-view-mobile-light": "1c14ef6e97f0f7c616fe61ad72f4dfa7d94c605efc3d8b26931016c8c13a4282",
+    "toggle-entity-dialog-desktop-en": "075a714a4f013c99614c4941b1202d9ae411e6382f72cb0d0a98e0f669b3388b",
     "toggle-entity-dialog-mobile-ru": "c5bf5077a33c1acfa5f744e0ab1c15ce6c2147bc3622a7e8754d972aeedb555b",
-    "device-help-popover-light-ru": "0c2f92e0da2546222e8f870cbdadc90775016f9b5f77ae5b5159b790b706b65e",
-    "decor-color-popover-mobile-ru": "de167d5a363758b26108f08f7e3f0ba7a44c8daf7461d1e54d719698d20ab208",
-    "decor-color-popover-desktop-en": "ce6e85df6417dc8912ff7119c9851a7e15c4f28ed4097aa21e973e9da8d1ca0e",
-    "general-color-popover-desktop-en": "0844739f83194c57eb06d7684764ddf96f681690a58e0e4879c1d7771fe3d6e8",
-    "settings-help-zoom-200-en-light": "e18e1f3d74b7dcdf51391a99e354f812167af99fe22425a3fe8bb5e52f04f973",
+    "device-help-popover-light-ru": "7645a419f8214dacc6b97be894643d12b2a0486342e568b0b3ee42d74b8cf878",
+    "decor-color-popover-mobile-ru": "bdf90e0e265d41d032db948a737eeedd6e60cdacc9f85c9356aa809894654960",
+    "decor-color-popover-desktop-en": "46b38745da10d4467b510c5a257102395a797e0d3229e7ce8c89e4bbf3b937e7",
+    "general-color-popover-desktop-en": "b54ef50909c2e7b667d321457b17205d5de38dd39b219eef05bee5ef8fb6bef2",
+    "settings-help-zoom-200-en-light": "9d9cdc0d849afc821efdf4451be40a1d32ecdff06a91b1d517b46c3f45cbcff0",
     "settings-help-zoom-200-ru-dark": "cb2a9f210b19057e26d42ca8975c3a888fb95de3f6cbd03515d1eccff39de387",
-    "support-desktop-empty-light-en": "ec60104cb98b646db22089c93f70f78c3a13cdb7001782b2981ce19800ce3cee",
-    "support-desktop-preview-dark-en": "37707b251c117eb381f7ddd6ad13a235be82c139a4d92dc07789a76cc425e946",
-    "support-phone-validation-light-ru": "1699dde634aa583ce6aaa30252f6cc01c9d822ff2718d0d77b179c7c38216ea2",
-    "support-phone-success-dark-en": "21146b3a221010cdc45e1a83c299395772a9f214550a296b78c5ecb72ddab332",
-    "support-relay-error-light-en": "e63e4e3aec111aa8044f6c99a8d3331801505a0024399293d8d5d53776346b76",
-    "support-tablet-preview-dark-ru": "969398341e722f54d56a14084d18c4943f644a98b7772222ee7b601d46ddd866",
+    "support-desktop-empty-light-en": "55ffd7a63b8e4d65b8cb695a7b166e0c4bb2e719ce925b8d28b8e8595897750d",
+    "support-desktop-preview-dark-en": "326c1b1ecbe71e0bdaed6445137ee4145418317bf5d5faf10faa297707fdb924",
+    "support-phone-validation-light-ru": "acc540f9459c9dc38981ccb70e75a5415f17c849d3840340648448884bd2ab31",
+    "support-phone-success-dark-en": "b2edd4415043d673d22dfe89ee16b9c190e7f3f9537371f01665e8e41444a00e",
+    "support-relay-error-light-en": "adf30f96a926a1730c9ad34d18b4234d9b19140f11d56c8fb7508976f366c11d",
+    "support-tablet-preview-dark-ru": "a69ba86bf069d9beba94eedf6cc3b385b026caeee66348e4ef42c1a072b6df6a",
     "device-ripple-color-popover-mobile-ru": "8fc31025d32d87e5d3d3df896937d182577cd5169d520e7cf5fc267e7d080776",
-    "space-room-color-popover-desktop-ru": "031dcd90ca0f66e41876f87b76fc5241d1b1fd99135605b26ab8ce88dfb12111",
-    "backup-full-preview-desktop-en": "935adb062c28385a89d34716616406e2434d8cdf3daf9cb7abead13df3c6cb81",
-    "backup-plan-only-export-desktop-en": "b017b78e75968123011777c27550bf82da6e50267086339b963d8571e8dca679",
-    "backup-space-preview-mobile-ru": "5ee8c2651d9814be9d7c76b7692fcf65f4ce341fb4cde1fc3e854df4568994dc",
-    "optimize-preflight-dialog-dark-en": "be8c9ddaf4eb07d83594d836ea20f5fb0c142d3c0f53a5a5b32e69814df27ae8",
-    "optimize-preflight-dialog-light-ru": "75a42a6dfb8134d7030466a730bd32ed08b7f50a72d2e9e081f9a3d853898856",
-    "optimize-orphan-references-dark-en": "d8a33ed94935d3b09fd9317729dc014c38c9baf4ef425947365d8aab186c45c2",
-    "optimize-orphan-references-light-ru": "d68e22a3cd9b2f047dc017217593a9e1a9df79fb9014070890d4f2df52f38cc2",
+    "space-room-color-popover-desktop-ru": "0e4654978e004cb9242ccf4add8022b57459b6a8524f141160ae49aa46787fe9",
+    "backup-full-preview-desktop-en": "2a71dd52bce193a5ddca1ee0404f91754787206cbe01af0b0bfb3871016ed289",
+    "backup-plan-only-export-desktop-en": "d7ae8031e1147ee8d3d15f35d8cd5bc65aa24fc880ad2feafdd7c8713b76c0c5",
+    "backup-space-preview-mobile-ru": "363aaa313d4b1f6f0b2de66b497390ca876b69cb36dc022b135d33299482465f",
+    "optimize-preflight-dialog-dark-en": "09e2d582f6e9591ac7dc7f11520eed51127c06bf97221a1b5340b04227302a87",
+    "optimize-preflight-dialog-light-ru": "5b679e352bcdbef8437e6098aadd69b27ff8564fd4bb6d04050bd468f60a20f6",
+    "optimize-orphan-references-dark-en": "6a9ab05787bc789af6181e6f2abca19d3cf92ac166aac661ad8deb7c7a3c88bb",
+    "optimize-orphan-references-light-ru": "332e56edb151a5a820fc307d69ffd4060348978572e48704b0a2c14ba9802720",
     "card-editor-invalid-default-floor-light-en": "dbf251ece014cfee252e0dcb2d7c00eda66aa4b5bd125e4c83e248d4319d24b3",
     "card-editor-invalid-default-floor-dark-ru": "422b74bb391b87e383350247ef1bc1f10ca48c8f6fe418f75bde94e62e3b8bc0"
   }