docs: review document for #329

Issue: #329 User-Visible: no
test: the backend mutant follows the registry convention (#329 r2-H1)
2026-09-29 03:09:36 +00:00 · 2026-08-27 21:49:59 +00:00 · 2026-08-28 00:41:30 +03:00 · 2026-08-27 21:37:28 +00:00 · 2026-08-28 00:28:12 +03:00 · 2026-08-28 00:24:34 +03:00
1011 changed files with 181746 additions and 19111 deletions
@@ -1,4 +1,4 @@
-name: Announce release
+name: Анонс релиза
 # Telegram notifications for t.me/ha_houseplan (owner request, 2026-08-07).
 # Stable releases are announced; prereleases are deliberately silent.
 # workflow_dispatch exists purely as a connectivity test button and therefore
@@ -36,12 +36,13 @@ permissions:
  contents: read
 jobs:
  telegram:
+    name: Оповещение в Telegram (только стабильные)
    if: ${{ github.event_name == 'workflow_dispatch' || (github.event_name == 'release' && github.event.release.prerelease == false) || (github.event_name == 'workflow_call' && inputs.prerelease == false) }}
    runs-on: ubuntu-latest
    steps:
      - name: Check out release notes for a reusable call
        if: ${{ inputs.reusable == true }}
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
        with:
          ref: ${{ inputs.ref }}
      - name: Send to Telegram
@@ -0,0 +1,85 @@
+# Скриншоты документации снимаются здесь и только здесь (#246).
+#
+# Съёмка на машине исполнителя даёт байтово разный PNG при одинаковом кадре:
+# сглаживание и хинтинг зависят от окружения. Измерено на истории — пересъёмка
+# в #231 изменила два файла из девяти на 7–8 байт, набор с беты все девять
+# целиком. Одно окружение убирает этот шум насовсем.
+#
+# Джоба ничего не коммитит: она публикует артефакт, который человек принимает
+# локально через `npm run docs:accept -- --reviewed --from=<распакованный>`.
+# Та же конструкция, что у golden-эталонов, и по той же причине: картинки
+# попадают в репозиторий через явное решение, а не через бота.
+name: Скриншоты документации
+
+on:
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: Ветка или SHA, с которого снимать
+        required: false
+        default: dev
+
+permissions:
+  contents: read
+
+jobs:
+  capture:
+    name: Съёмка и сверка скриншот-индекса
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ inputs.ref }}
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      # Тот же кэш и тот же отказ от --with-deps, что в smoke/golden (#175, #206):
+      # системные библиотеки Chromium уже в образе раннера.
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@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
+      - name: Capture
+        run: node demo/docs/capture.mjs
+      # Вердикт до всякой приёмки. Само число изменившихся файлов ничего не
+      # говорит: набор, снятый другим браузером, меняет их все, и это нормально
+      # ровно один раз — при переходе на канонический прогон. Сравнивать надо
+      # браузер: тот же Chromium и десять изменившихся картинок означают, что
+      # изменился продукт (или что-то не так), другой Chromium — ожидаемую
+      # разницу рендеринга.
+      - name: Вердикт
+        run: |
+          git status --porcelain docs/images
+          changed=$(git diff --name-only docs/images | grep -c png || true)
+          before=$(git show HEAD:docs/images/screenshots.json | node -e \
+            "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>{try{console.log(JSON.parse(s).chromium||'')}catch{console.log('')}})")
+          after=$(node -e "console.log(require('./docs/images/screenshots.json').chromium)")
+          echo "--- изменившихся PNG: $changed"
+          echo "--- Chromium: было «${before:-не записан}», стало «$after»"
+          if [ "$before" = "$after" ] && [ "$changed" -gt 0 ]; then
+            echo "ВЕРДИКТ: тот же браузер, а картинки изменились — изменился продукт."
+            echo "Смотрите на кадры: если изменение ожидаемое, принимайте."
+          elif [ "$before" != "$after" ]; then
+            echo "ВЕРДИКТ: браузер другой, поэтому переписаны все кадры сразу."
+            echo "Это ожидаемо один раз — при переходе на канонический прогон."
+            echo "Если Chromium сменился неожиданно, сверьте закреплённую версию в package-lock."
+          else
+            echo "ВЕРДИКТ: ничего не изменилось, принимать нечего."
+          fi
+      - name: Upload candidate
+        uses: actions/upload-artifact@v7
+        with:
+          name: docs-screenshots
+          path: |
+            docs/images/*.png
+            docs/images/screenshots.json
+          if-no-files-found: error
@@ -1,4 +1,4 @@
-name: Mutation gate
+name: Мутационный гейт

 # Реестр известных поломок (issue #85): каждый мутант ломает продуктовый код
 # известным способом, и объявленный тест ОБЯЗАН на этом покраснеть. Тест,
@@ -13,6 +13,11 @@ name: Mutation gate

 on:
  workflow_dispatch:
+    inputs:
+      ref:
+        description: Git ref whose mutation guards must be proved
+        required: false
+        default: dev
  schedule:
    # Понедельник, 05:20 UTC — до начала рабочего дня владельца.
    - cron: '20 5 * * 1'
@@ -26,26 +31,34 @@ concurrency:

 jobs:
  mutants:
+    name: "Мутанты: каждый обязан красить тесты"
    runs-on: ubuntu-latest
-    # Шесть мутантов × (сборка + браузерный смок) — это десятки минут, и это
-    # нормально: гейт предрелизный. Час — потолок против зависшего Chromium.
+    # Все мутанты × (сборка + свой guard) — это десятки минут, и это нормально:
+    # гейт предрелизный. Час — потолок против зависшего Chromium.
    timeout-minutes: 60
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
-          ref: dev
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.ref || 'dev' }}
          fetch-depth: 0

-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm

      - run: npm ci

+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.13'
+
+      - name: Установить backend test dependencies
+        run: pip install pytest voluptuous pytest-homeassistant-custom-component home-assistant-frontend
+
      - name: Кэш браузеров Playwright
        id: pw
-        uses: actions/cache@v4
+        uses: actions/cache@v6
        with:
          path: ~/.cache/ms-playwright
          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
@@ -1,4 +1,4 @@
-name: Full Performance
+name: Полные бенчмарки производительности

 on:
  # Every main promotion is a stable-release candidate and must have an
@@ -24,13 +24,24 @@ concurrency:

 jobs:
  performance:
-    # Base and candidate stay sequential on one hosted runner. Splitting them
-    # across runners would turn machine variance into a false regression.
+    name: Бенчмарки рендера и геометрии
+    # 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 five pairs cannot fit the job timeout.
    runs-on: ubuntu-latest
    timeout-minutes: 60
+    strategy:
+      fail-fast: false
+      matrix:
+        profile:
+          - large-house
+          - isometric
+          - plan-snap
+          - blend
+          - overlay
    steps:
      - name: Check out candidate
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
        with:
          path: candidate
          fetch-depth: 2
@@ -116,12 +127,12 @@ jobs:
          echo "Comparison base: $sha ($source)" >> "$GITHUB_STEP_SUMMARY"

      - name: Check out base SHA
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
        with:
          ref: ${{ steps.base.outputs.sha }}
          path: baseline

-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
@@ -132,47 +143,95 @@ jobs:
      - name: Install candidate and baseline dependencies
        run: npm ci --prefix candidate && npm ci --prefix baseline

+      # То же, что в validate.yml: кэш браузеров, apt не трогаем (#206).
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('candidate/package-lock.json') }}
      - name: Install pinned Chromium
+        if: steps.pw.outputs.cache-hit != 'true'
        working-directory: candidate
-        run: npx playwright install --with-deps chromium
+        run: npx playwright install chromium

      - name: Build both exact source trees
        run: |
          npm --prefix candidate run build
-          cp candidate/dist/houseplan-card.js candidate/demo/srv/assets/houseplan-card.js
+          (cd candidate && node scripts/bundle-sync.mjs)
          npm --prefix baseline run build
-          cp baseline/dist/houseplan-card.js baseline/demo/srv/assets/houseplan-card.js
-
-      - name: Capture base and candidate profiles
-        working-directory: candidate
-        run: |
-          npm run benchmark:large-house -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/baseline.json
-          npm run benchmark:large-house -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/candidate.json
-          npm run benchmark:large-house-isometric -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/isometric-baseline.json
-          npm run benchmark:large-house-isometric -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/isometric-candidate.json
-          npm run benchmark:large-house-plan-snap -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/plan-snap-baseline.json
-          npm run benchmark:large-house-plan-snap -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/plan-snap-candidate.json
-          npm run benchmark:glow -- --profile=large-light-blend-v1 --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/blend-baseline.json
-          npm run benchmark:glow -- --profile=large-light-blend-v1 --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/blend-candidate.json
-          npm run benchmark:glow -- --profile=large-house-glow-overlay-v1 --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/overlay-baseline.json
-          npm run benchmark:glow -- --profile=large-house-glow-overlay-v1 --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/overlay-candidate.json
-          if ! grep -q "glow_enabled" ../baseline/src/logic.ts; then
-            echo "Base predates independent Glow; bootstrap relative overlay baseline, keep absolute gate"
-            cp ../artifacts/performance/overlay-candidate.json ../artifacts/performance/overlay-baseline.json
+          if [ -f baseline/scripts/bundle-sync.mjs ]; then
+            (cd baseline && node scripts/bundle-sync.mjs)
+          else
+            echo "::notice::The comparison base predates bundle-sync.mjs; materializing its freshly built bundle with the legacy copy path."
+            mkdir -p baseline/custom_components/houseplan/frontend baseline/demo/srv/assets
+            cp baseline/dist/houseplan-card.js baseline/custom_components/houseplan/frontend/houseplan-card.js
+            cp baseline/dist/houseplan-card.js baseline/demo/srv/assets/houseplan-card.js
          fi

-      - name: Enforce relative and absolute performance budgets
+      - name: Capture base and candidate profile
        working-directory: candidate
+        env:
+          PROFILE: ${{ matrix.profile }}
        run: |
-          npm run benchmark:compare -- --baseline=../artifacts/performance/baseline.json --candidate=../artifacts/performance/candidate.json --output=../artifacts/performance/comparison.json
-          npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-isometric.json --baseline=../artifacts/performance/isometric-baseline.json --candidate=../artifacts/performance/isometric-candidate.json --output=../artifacts/performance/isometric-comparison.json
-          npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-plan-snap.json --baseline=../artifacts/performance/plan-snap-baseline.json --candidate=../artifacts/performance/plan-snap-candidate.json --output=../artifacts/performance/plan-snap-comparison.json
-          npm run benchmark:compare -- --budgets=demo/performance/budgets-large-light-blend.json --baseline=../artifacts/performance/blend-baseline.json --candidate=../artifacts/performance/blend-candidate.json --output=../artifacts/performance/blend-comparison.json
-          npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-glow-overlay.json --baseline=../artifacts/performance/overlay-baseline.json --candidate=../artifacts/performance/overlay-candidate.json --output=../artifacts/performance/overlay-comparison.json
+          mkdir -p ../artifacts/performance
+          case "$PROFILE" in
+            large-house)
+              npm run benchmark:large-house -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/baseline.json
+              npm run benchmark:large-house -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/candidate.json
+              ;;
+            isometric)
+              npm run benchmark:large-house-isometric -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/isometric-baseline.json
+              npm run benchmark:large-house-isometric -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/isometric-candidate.json
+              ;;
+            plan-snap)
+              npm run benchmark:large-house-plan-snap -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/plan-snap-baseline.json
+              npm run benchmark:large-house-plan-snap -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/plan-snap-candidate.json
+              ;;
+            blend)
+              npm run benchmark:glow -- --profile=large-light-blend-v1 --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/blend-baseline.json
+              npm run benchmark:glow -- --profile=large-light-blend-v1 --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/blend-candidate.json
+              ;;
+            overlay)
+              npm run benchmark:glow -- --profile=large-house-glow-overlay-v1 --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/overlay-baseline.json
+              npm run benchmark:glow -- --profile=large-house-glow-overlay-v1 --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/overlay-candidate.json
+              if ! grep -q "glow_enabled" ../baseline/src/logic.ts; then
+                echo "Base predates independent Glow; bootstrap relative overlay baseline, keep absolute gate"
+                cp ../artifacts/performance/overlay-candidate.json ../artifacts/performance/overlay-baseline.json
+              fi
+              ;;
+            *)
+              echo "::error::Unknown performance profile: $PROFILE"
+              exit 1
+              ;;
+          esac

-      - name: Upload full performance reports
+      - name: Enforce relative and absolute performance budget
+        working-directory: candidate
+        env:
+          PROFILE: ${{ matrix.profile }}
+        run: |
+          case "$PROFILE" in
+            large-house)
+              npm run benchmark:compare -- --baseline=../artifacts/performance/baseline.json --candidate=../artifacts/performance/candidate.json --output=../artifacts/performance/comparison.json
+              ;;
+            isometric)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-isometric.json --baseline=../artifacts/performance/isometric-baseline.json --candidate=../artifacts/performance/isometric-candidate.json --output=../artifacts/performance/isometric-comparison.json
+              ;;
+            plan-snap)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-plan-snap.json --baseline=../artifacts/performance/plan-snap-baseline.json --candidate=../artifacts/performance/plan-snap-candidate.json --output=../artifacts/performance/plan-snap-comparison.json
+              ;;
+            blend)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-light-blend.json --baseline=../artifacts/performance/blend-baseline.json --candidate=../artifacts/performance/blend-candidate.json --output=../artifacts/performance/blend-comparison.json
+              ;;
+            overlay)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-glow-overlay.json --baseline=../artifacts/performance/overlay-baseline.json --candidate=../artifacts/performance/overlay-candidate.json --output=../artifacts/performance/overlay-comparison.json
+              ;;
+          esac
+
+      - name: Upload full performance report
        if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
-          name: full-performance
+          name: full-performance-${{ matrix.profile }}
          path: artifacts/performance
@@ -1,4 +1,4 @@
-name: Process
+name: Ревью-конвейер

 # Событийный конвейер процесса (PROCESS.md). Смена статусной метки — это
 # сообщение: она порождает событие, событие запускает следующий шаг.
@@ -35,10 +35,12 @@ permissions:

 jobs:
  guard:
+    name: "Страж: ребейз на dev и предпосылки ревью"
    runs-on: ubuntu-latest
    outputs:
      stage: ${{ steps.decide.outputs.stage }}
      cycle: ${{ steps.decide.outputs.cycle }}
+      spent: ${{ steps.decide.outputs.spent }}
      limit: ${{ steps.decide.outputs.limit }}
    steps:
      - id: decide
@@ -63,19 +65,41 @@ jobs:
          limit=4
          if [ "$SMALL" = "true" ] || [ "$TRIVIAL" = "true" ]; then limit=2; fi

-          # Счётчик считает вердикты ТОЛЬКО своего этапа. Раньше он брал все
-          # подряд, и вердикт по ТЗ съедал цикл из бюджета код-ревью: на #89
-          # первое код-ревью получило r2/4. На задаче с двумя циклами ТЗ второе
-          # код-ревью упиралось бы в review-4 после одной правки.
+          # Считаются ДВЕ РАЗНЫЕ величины, и это не педантизм (#227).
          #
-          # Этап опознаётся по имени документа в теле комментария. Если документа
-          # нет, вердикт не посчитается — недосчёт даёт лишний цикл, а перерасчёт
-          # остановил бы работу досрочно; из двух ошибок выбрана обратимая.
-          done_cycles=0
+          # `attempt` — сколько раз ревью уже отработало на этом этапе. Он нужен
+          # только для имени документа и метки: два захода с одинаковым номером
+          # означают, что второй документ перезапишет первый и артефакт ревью
+          # исчезнет.
+          #
+          # `spent` — сколько циклов израсходовано из бюджета §4. Цикл — это
+          # «отправка на ревью → вердикт с блокирующими находками → возврат
+          # автору», поэтому бюджет тратят ТОЛЬКО жёлтые и красные вердикты.
+          # Зелёный ничего на правки не вернул и цикла не образует.
+          #
+          # Раньше обе роли исполнял один счётчик всех вердиктов, и конвейер
+          # наказывал за то, что предписывал сам: при неудавшемся слиянии он
+          # велит вернуть S7-code-review после ребейза, и этот заход добивал
+          # бюджет. На #225 (лёгкий трек, лимит 2) последовательность
+          # жёлтый → зелёный → ребейз дала review-4 на задаче с зелёным ревью и
+          # зелёным CI: работа встала, хотя после вердикта не было ни одной
+          # правки продуктового кода.
+          #
+          # Вердикты считаются ТОЛЬКО своего этапа: иначе вердикт по ТЗ съедал
+          # цикл из бюджета код-ревью (#89 получило r2/4). Этап опознаётся по
+          # имени документа в теле комментария; документа нет — вердикт не
+          # посчитается. Недосчёт даёт лишний заход, перерасчёт остановил бы
+          # работу досрочно: из двух ошибок выбрана обратимая.
+          attempt=1; spent=0; spent_list=""
          if [ -n "$stage" ]; then
-            done_cycles=$(gh issue view "$NUM" --repo "${{ github.repository }}" \
-              --json comments \
-              -q "[.comments[] | select(.body | test(\"Вердикт:\")) | select(.body | test(\"$marker\"))] | length")
+            comments=$(gh issue view "$NUM" --repo "${{ github.repository }}" --json comments)
+            of_stage="[.comments[] | select(.body | test(\"Вердикт:\")) | select(.body | test(\"$marker\"))]"
+            # Блокирующим считается вердикт, у которого в строке вердикта стоит
+            # «жёлтый» или «красный». Регистр и окружение слова не важны.
+            blocking="$of_stage | map(select(.body | test(\"Вердикт:[^\\n]*(жёлт|красн)\"; \"i\")))"
+            attempt=$(( $(printf '%s' "$comments" | jq -r "$of_stage | length") + 1 ))
+            spent=$(printf '%s' "$comments" | jq -r "$blocking | length")
+            spent_list=$(printf '%s' "$comments" | jq -r "$blocking | map(\"- \" + .url) | join(\"\\n\")")
          fi

          # Отказ обязан быть виден в issue, а не только в логе прогона.
@@ -109,39 +133,74 @@ jobs:
            refuse "стоит blocked — конвейер не запускается" \
              "на issue стоит \`blocked\` — задача ждёт внешнего решения. Снять метку, когда решение принято."
          elif [ "$EXHAUSTED" = "true" ]; then
+            # Метку снимает владелец, а не конвейер: автоматика, отменяющая
+            # остановку работы, дороже ручного снятия. Но пересчёт печатается —
+            # метка могла остаться от прежнего правила, когда бюджет тратил и
+            # зелёный вердикт (#227).
+            stale=""
+            if [ "$spent" -lt "$limit" ]; then
+              stale=" Пересчёт по действующему правилу: блокирующих циклов $spent из $limit — метка могла остаться от прежнего правила, когда бюджет тратил любой вердикт. Снять её может владелец."
+            fi
            refuse "стоит review-4 — решение за владельцем" \
-              "на issue стоит \`review-4\`: лимит циклов ревью исчерпан, дальше решает владелец — разделить задачу, отклонить или арбитраж (PROCESS.md §4)."
-          elif [ "$done_cycles" -ge "$limit" ]; then
-            echo "циклов этапа $stage пройдено $done_cycles из $limit — лимит исчерпан"
+              "на issue стоит \`review-4\`: лимит циклов ревью исчерпан, дальше решает владелец — разделить задачу, отклонить или арбитраж (PROCESS.md §4).$stale"
+          elif [ "$spent" -ge "$limit" ]; then
+            echo "блокирующих циклов этапа $stage: $spent из $limit — лимит исчерпан"
            gh issue edit "$NUM" --repo "${{ github.repository }}" --add-label review-4
+            # Перечень учтённого обязателен: иначе владельцу приходится читать
+            # всю ленту, чтобы понять, из чего сложился счёт.
            gh issue comment "$NUM" --repo "${{ github.repository }}" --body \
-              "Лимит циклов ревью исчерпан ($done_cycles из $limit на этапе \`$stage\`). Пятого захода нет: решение владельца — разделить задачу, отклонить или арбитраж (PROCESS.md §4)."
+              "Лимит циклов ревью исчерпан: блокирующих циклов $spent из $limit на этапе \`$stage\` (заход $attempt). Следующего захода нет: решение владельца — разделить задачу, отклонить или арбитраж (PROCESS.md §4).
+
+          Учтены вердикты с блокирующими находками — зелёные бюджет не тратят:
+          $spent_list"
            stage=""
          else
-            echo "этап $stage, цикл $((done_cycles + 1)) из $limit"
+            echo "этап $stage, заход $attempt, блокирующих циклов $spent из $limit"
          fi
          echo "stage=$stage" >> "$GITHUB_OUTPUT"
-          echo "cycle=$((done_cycles + 1))" >> "$GITHUB_OUTPUT"
+          echo "cycle=$attempt" >> "$GITHUB_OUTPUT"
+          echo "spent=$spent" >> "$GITHUB_OUTPUT"
          echo "limit=$limit" >> "$GITHUB_OUTPUT"

  review:
+    name: "Ревью (Claude): вердикт в issue"
    needs: guard
    if: needs.guard.outputs.stage != ''
    runs-on: ubuntu-latest
    # Время — единственный настоящий ограничитель зациклившегося прогона.
    timeout-minutes: 45
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
          ref: dev
+          # Иначе в конфиге git остаётся креденшел GITHUB_TOKEN, и push с
+          # мёртвым PAT молча уходит от github-actions[bot] — 403 при
+          # contents: read. Отказ обязан быть громким и правильным.
+          persist-credentials: false
+
+      # Живость PAT проверяется ДО ревью. На #150 истёкший токен обнаружился
+      # только на публикации документа — после сорока минут работы ревьюера.
+      - name: Секрет HP_PROCESS_TOKEN жив
+        env:
+          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+        run: |
+          if [ -z "$GH_TOKEN" ]; then
+            echo "::error::HP_PROCESS_TOKEN пуст — секрет удалён или недоступен"
+            exit 1
+          fi
+          if ! login=$(gh api user -q .login 2>/dev/null); then
+            echo "::error::HP_PROCESS_TOKEN не аутентифицируется — истёк или отозван. Обновить: Settings -> Secrets and variables -> Actions -> HP_PROCESS_TOKEN"
+            exit 1
+          fi
+          echo "токен жив, действует от: $login"

      # Окружение готовит workflow, а не модель своими ходами. Раньше промпт
      # велел ревьюеру самому выполнить `npm ci`: минуты уходили на установку без
      # кэша, платились из бюджета 45 минут и из лимитов подписки, а ходы модели
      # тратились на работу инфраструктуры. В validate.yml кэш стоит на всех
      # тяжёлых job, здесь его не было.
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
@@ -154,8 +213,15 @@ jobs:
        env:
          NUM: ${{ github.event.issue.number }}
        run: |
-          branch=$(git ls-remote --heads origin "issue/${NUM}-*" \
-            | head -1 | sed 's|.*refs/heads/||')
+          # Свежая по последнему коммиту, а не первая по алфавиту: на #150 рядом
+          # жили ветка ТЗ и ветка реализации, и head -1 выбрал устаревшую.
+          git fetch -q origin "+refs/heads/issue/${NUM}-*:refs/remotes/origin/issue/${NUM}-*" || true
+          branches=$(git for-each-ref --sort=-committerdate \
+            --format='%(refname:lstrip=3)' "refs/remotes/origin/issue/${NUM}-*")
+          branch=$(printf '%s\n' "$branches" | head -1)
+          if [ "$(printf '%s\n' "$branches" | grep -c .)" -gt 1 ]; then
+            echo "::warning::веток issue/${NUM}-* несколько ($(echo $branches | tr '\n' ' ')) — выбрана свежая по коммиту: $branch. Устаревшую следует удалить."
+          fi
          if [ -n "$branch" ]; then
            git checkout -q "origin/$branch"
            echo "материал ревью: ветка $branch, $(git rev-parse --short HEAD)"
@@ -165,27 +231,135 @@ jobs:
            echo "МАТЕРИАЛ НЕ ЗАПУШЕН" >> "$GITHUB_STEP_SUMMARY"
          fi

+      # Ревьюер обязан смотреть тот же код, который уедет в dev (#257). Раньше
+      # ревью шло по ветке как есть, а слияние делало ребейз — проверенный SHA и
+      # слитый SHA были разными коммитами. Пока расхождение с dev текстовое,
+      # ребейз упирается в конфликт и это видно; смысловое расхождение git
+      # склеивает молча, и в dev уезжает комбинация, которую никто не читал.
+      # Именно так пришёл регресс #234.
+      #
+      # Заодно снимается плата за конфликт: он обнаруживался ПОСЛЕ сорока минут
+      # ревью и потраченных лимитов подписки, хотя виден за пять секунд до них.
+      #
+      # Этап spec не затрагивается: ветку ТЗ в dev никто не сливает, и трогать
+      # чужую ветку без нужды — лишний риск.
+      - name: Привести ветку к dev
+        id: rebase
+        if: needs.guard.outputs.stage == 'code' && steps.branch.outputs.name != ''
+        env:
+          TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          BRANCH: ${{ steps.branch.outputs.name }}
+          # rebase, в отличие от commit, не принимает -c user.*: он запускает
+          # свои процессы и требует личность в окружении, иначе падает с
+          # «unable to auto-detect email address».
+          GIT_AUTHOR_NAME: claude[bot]
+          GIT_AUTHOR_EMAIL: 209825114+claude[bot]@users.noreply.github.com
+          GIT_COMMITTER_NAME: claude[bot]
+          GIT_COMMITTER_EMAIL: 209825114+claude[bot]@users.noreply.github.com
+        run: |
+          git fetch -q origin dev
+          if git merge-base --is-ancestor origin/dev HEAD; then
+            echo "ветка содержит весь dev — ребейз не нужен"
+            exit 0
+          fi
+          behind=$(git rev-list --count "HEAD..origin/dev")
+          before=$(git rev-parse "origin/$BRANCH")
+          echo "dev впереди на $behind коммит(ов) — привожу ветку"
+          if ! git rebase origin/dev; then
+            git rebase --abort || true
+            echo "conflict=true" >> "$GITHUB_OUTPUT"
+            echo "::warning::ветка $BRANCH не ребейзится на dev без конфликта — ревью не запускается"
+            exit 0
+          fi
+          # --force-with-lease с явным ожидаемым значением обязателен: между
+          # fetch и push автор мог запушить коммит, и слепой --force потерял бы
+          # его молча. Расхождение lease — падение прогона, а не предупреждение:
+          # ревью пошло бы по коду, которого на ветке уже нет.
+          if ! git push -q --force-with-lease="refs/heads/$BRANCH:$before" \
+               "https://x-access-token:$TOKEN@github.com/${{ github.repository }}" \
+               "HEAD:refs/heads/$BRANCH"; then
+            echo "::error::ветка $BRANCH изменилась во время ребейза — прогон прерван, чтобы не потерять коммит автора"
+            exit 1
+          fi
+          # Локальная ссылка обновляется тоже: шаг слияния берёт origin/$BRANCH,
+          # и без этого он ребейзил бы заново уже приведённое.
+          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 "ветка $BRANCH приведена к dev: $short_before -> $short_after"
+
+      # Материал ревью — конкретный SHA (#312). Вердикт применим только к
+      # нему: если во время ревью в ветку прилетит коммит, шаг слияния обязан
+      # это заметить и отказаться, а не молча увезти в dev непроверенный код.
+      - name: Зафиксировать SHA материала ревью
+        id: material
+        if: steps.rebase.outputs.conflict != 'true'
+        run: |
+          echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
+          echo "материал ревью: $(git rev-parse --short HEAD)"
+
+      # Конфликт возвращает задачу автору ДО ревью. Инвариант «после прогона
+      # метка меняется всегда» при этом держится: возврат в S6-in-progress —
+      # тоже смена метки, и автор не ждёт впустую.
+      - name: Конфликт с dev — вернуть автору без ревью
+        if: steps.rebase.outputs.conflict == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          NUM: ${{ github.event.issue.number }}
+          BRANCH: ${{ steps.branch.outputs.name }}
+        run: |
+          cat > /tmp/stale.md <<EOF
+          **Ревью не запускалось:** ветка \`$BRANCH\` не ребейзится на \`dev\` без конфликта. Код никто не читал, вердикта нет, цикл ревью не израсходован.
+
+          Проверка стоит до ревью намеренно: конфликт всё равно вернул бы задачу, но уже после сорока минут работы ревьюера и потраченных лимитов.
+
+          Задача переведена в \`S6-in-progress\`. Осталось:
+
+          1. \`git fetch origin\`, затем \`git rebase origin/dev\` в ветке задачи, разрешить конфликт;
+          2. запушить ветку;
+          3. вернуть метку \`S7-code-review\`.
+
+          [Прогон](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}).
+          EOF
+          gh issue comment "$NUM" --repo "${{ github.repository }}" --body-file /tmp/stale.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 (ревью не запускалось)"
+
      # Зависимости ставятся ПОСЛЕ переключения на ветку задачи: lockfile мог
      # измениться именно в ней, и установка по копии из dev дала бы не то дерево.
      - name: Установить зависимости
+        if: steps.rebase.outputs.conflict != 'true'
        run: npm ci

      # Браузер нужен не всякому ревью (см. правило выбора гейтов в промпте),
      # но когда нужен — качать его заново дороже, чем держать в кэше.
      - name: Кэш браузеров Playwright
        id: pw
-        uses: actions/cache@v4
+        if: steps.rebase.outputs.conflict != 'true'
+        uses: actions/cache@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 --with-deps chromium
+        if: steps.rebase.outputs.conflict != 'true' && steps.pw.outputs.cache-hit != 'true'
+        # Без --with-deps: системные библиотеки Chromium предустановлены в
+        # образе ubuntu-latest, а apt при промахе кэша съедал минуты из бюджета
+        # ревью и подолгу перебирал недоступное azure-зеркало (#175). Если
+        # библиотека когда-нибудь пропадёт из образа, Chromium не запустится с
+        # внятной ошибкой — тогда флаг вернуть.
+        run: npx playwright install chromium

      - name: Review
        id: review
+        if: steps.rebase.outputs.conflict != 'true'
        uses: anthropics/claude-code-action@v1
+        env:
+          # Вне рабочей копии: восстановление дерева ревьюером не должно
+          # уничтожать его собственный артефакт (#220).
+          REVIEW_DOC: ${{ runner.temp }}/review-document.md
        with:
          # Подписка, а не отдельный счёт API: токен выпускается через
          # `claude setup-token` (Pro/Max). Действуют лимиты подписки.
@@ -198,6 +372,44 @@ jobs:
            Этап: ${{ needs.guard.outputs.stage }}
              spec — ревью ТЗ (PROCESS.md §2.4)
              code — код-ревью (PROCESS.md §2.7)
+            Заход: r${{ needs.guard.outputs.cycle }} · блокирующих циклов израсходовано ${{ needs.guard.outputs.spent }} из ${{ needs.guard.outputs.limit }}
+              Бюджет §4 тратят только жёлтые и красные вердикты: зелёный
+              ничего не вернул на правки и цикла не образует (#227).
+              Номер захода нужен для имени документа — два документа с
+              одинаковым номером затёрли бы друг друга.
+
+            ${{ steps.rebase.outputs.note }}
+
+            **Если цикл не первый — объём разбора по дельте, а не заново**
+            (PROCESS.md §2.9, issue #214). Раньше промпт был одинаковым для
+            всех раундов, и повторный цикл заново выводил продуктовую рамку и
+            перепроверял AC, которых правка не касалась: r2 по #150 стоил
+            полного прогона ради одной строки в тестовой фикстуре.
+
+            Порядок для r2 и дальше:
+              1. найди вердикт предыдущего раунда в комментариях issue и SHA,
+                 на котором он получен. SHA в вердикте не назван — это находка;
+              2. объяви дельту: `git diff <тот SHA>..HEAD` для кода, дифф файла
+                 ТЗ или тела issue для spec. Дельта — предмет этого раунда;
+              3. по каждой находке предыдущего раунда покажи, чем именно она
+                 закрыта: строка кода или текста, а не заявление автора;
+              4. заново проверяй только те AC, чьё доказательство дельта
+                 задевает. Остальные наследуй;
+              5. в документе обязателен раздел «Унаследовано из r<N-1>»: что
+                 принято без повторной проверки, со ссылкой на документ того
+                 раунда и SHA, на котором вывод получен. Без этого перечня
+                 сокращение — молчаливое доверие, а такой тихий успех уже
+                 дважды стоил дня (#171, #207).
+
+            Разбор остаётся ПОЛНЫМ, если дельта не локальна: ребейз на ушедший
+            вперёд dev (после ребейза это другой код, §7.2), смена контракта
+            поведения, задета новая подсистема, либо объём дельты сопоставим с
+            исходной задачей. Сомневаешься — разбирай полностью и скажи почему.
+
+            Сокращается объём РАЗБОРА, а не строгость: правка по замечанию
+            способна сломать AC, который предыдущий раунд признал выполненным —
+            так появилась регрессия #102. Поэтому граница не «только находки», а
+            «находки плюс всё, до чего дотягивается дельта».

            Прочитай в этом порядке, прежде чем судить:
              1. docs/SCOPE.md — зачем продукт существует и для кого. Он
@@ -241,14 +453,44 @@ jobs:
            правке — не тщательность, а потеря времени: полные наборы это
            предрелизный гейт (PROCESS.md §8), а не гейт ревью.

-            Всегда, они дешёвые:
+            Всегда, они дешёвые, и в повторном раунде тоже: код изменился,
+            а стоят они минуты:
              `npx tsc --noEmit`, `npm test`, `npm run build` со сверкой трёх
-              копий бандла.
+              копий бандла. Плюс `node scripts/check-docs.mjs`, если diff трогает
+              `src/**`: отпечаток скриншотов документации считается по всему
+              `src/**`, поэтому любая правка фронтенда делает его устаревшим —
+              выбирать тут нечего. Пропуск этого шага в #230 и #234 оставил `dev`
+              с красным job `docs` до следующей задачи (#237).
+
+            Если diff трогает геометрию или ссылки на неё — рёбра комнат,
+            записи толщины, `layout`, `marker.space`, `open_spans` — обязательны
+            инварианты модели (#254): `npm test` уже гоняет их на всех моделях
+            проекта, а на конкретной конфигурации они проверяются командой
+            `npm run invariants -- --config <экспорт или ответ config/get>`.
+            Три вопроса, на которые они отвечают, и все три уже стоили
+            продукту дефектов: не исчезла ли запись толщины (#253), разрешима ли
+            каждая ссылка (#244, #252) и равен ли ключ записи толщины ключу
+            решёточного ребра (#258, #259). Последний сравнивает строки без
+            допусков: сдвиг ключа на один шаг решётки равен допуску первых двух,
+            поэтому они на нём промахиваются. Если задача меняет геометрию, а
+            инварианты в отчёте не названы — это непрогнанный гейт, а не мелочь.

            По необходимости, и «необходимость» определяется diff'ом и AC:
-              - браузерные смоки `demo/smoke_*.mjs` — названные в AC плюс
-                относящиеся к тронутым поверхностям. Их 127; прогон всех уместен
-                только когда задача действительно задевает всё;
+              - браузерные смоки `demo/smoke_*.mjs` — названные в AC плюс те,
+                что печатает `node scripts/smoke-select.mjs --base <base> --head <head>`.
+                Сколько их всего — считает `ls demo/smoke_*.mjs | wc -l`; вшитое
+                в этот текст число трижды расходилось с деревом, поэтому его
+                здесь больше нет. Прогон всех уместен только когда задача
+                действительно задевает всё. Выбирать по теме недостаточно: регресс #234 поймал
+                `smoke_wall_junctions`, который по названию про стыки стен, а не
+                про толщину отрезка. Инструмент печатает три вида ответа, и они
+                разные: «прямое совпадение» — смок называет изменённый символ,
+                «зарегистрированная связь» — смок проверяет следствие контракта,
+                не называя его, «НЕОПРЕДЕЛЁННОСТЬ» — связь не доказана, и это не
+                разрешение ничего не прогонять. Вывод инструмента прикладывается
+                к комментарию ревью вместе с решением по каждой строке: прогнал
+                либо не прогнал и почему. Слабые связи (одно распространённое
+                имя) — повод посмотреть, а не обязанность прогонять;
              - `npm run golden:verify` — если diff может изменить видимый
                результат: рендер, геометрия, стили, слои;
              - `python -m pytest tests_backend -q` — если тронут
@@ -256,6 +498,14 @@ jobs:
              - performance-профили — если названы в AC либо тронуты
                чувствительные к перфу пути.

+            **Одно число — один источник.** Если дифф добавляет или меняет
+            величину, видимую пользователю, назови в отчёте прямо: какое число
+            видно дважды (превью против записи, подпись против площади,
+            подсветка инструмента против сохранённого значения) и один ли у него
+            источник. Три дефекта подряд имели именно эту причину — #234, #233 и
+            способ, которым #234 обнаружили. Механическая часть закреплена
+            тестом `test/single-source-numbers.test.mjs`, смысловая — твоя.
+
            Дисциплина «тест должен уметь падать» не отменяется, но применяется к
            тем тестам, которые ты прогонял.

@@ -267,27 +517,46 @@ jobs:

            Ты НЕ правишь ни ТЗ, ни продуктовый код. Только оцениваешь.

-            Серьёзность: High блокирует; Medium обязан стать отдельным issue;
-            Low либо правится, либо снимается с записью. Жёлтый вердикт
-            допустим при полностью выполненных AC, если изменение не решает
-            заявленный сценарий или ухудшает смежный. Продуктовое рассуждение
-            расширяет вопросы, но не отменяет AC и не даёт права менять скоуп.
+            Серьёзность: High блокирует; Medium В СКОУПЕ задачи чинится в ней
+            же — без High это жёлтый вердикт и возврат автору, отдельный issue
+            НЕ заводится (решение владельца 2026-08-19, #202: заведение и
+            обслуживание issue дороже правки на месте); Low либо правится,
+            либо снимается с записью. Жёлтый вердикт допустим и при полностью
+            выполненных AC, если изменение не решает заявленный сценарий или
+            ухудшает смежный. Продуктовое рассуждение расширяет вопросы, но не
+            отменяет AC и не даёт права менять скоуп.

-            Каждую Medium-находку заведи отдельным issue со ссылкой на
-            #${{ github.event.issue.number }} и метками: тип, приоритет,
-            S1-new. «Оставили в тексте ревью» закрытием не считается и прямо
-            запрещено §12.
+            Только Medium-находку ВНЕ скоупа задачи (попутный дефект соседнего
+            поведения, который в этой ветке чинить нельзя) заведи отдельным
+            issue со ссылкой на #${{ github.event.issue.number }} и метками:
+            тип, приоритет, S1-new. «Оставили в тексте ревью» закрытием не
+            считается и прямо запрещено §12.

-            Напиши полный документ ревью в файл
-            docs/reviews/<SPEC|CODE>-REVIEW-${{ github.event.issue.number }}-r${{ needs.guard.outputs.cycle }}.md
-            (SPEC для этапа spec, CODE для code): скоуп, как проверялось,
-            находки с воспроизведением, что проверено и корректно, чего не
-            проверял. Каталог docs/reviews/ создай, если его нет. Больше не
-            пиши ничего: любой файл вне docs/reviews/ опубликован не будет.
+            Напиши полный документ ревью в файл, путь которого лежит в
+            переменной окружения REVIEW_DOC (абсолютный, ВНЕ репозитория).
+
+            Почему не в docs/reviews: документ там был некоммитнутым файлом того
+            же дерева, которое ты мутируешь, проверяя «умеет ли тест падать». На
+            #220 три раунда подряд документ исчезал — восстановление дерева
+            (`git checkout -- .`, `git clean -fd`) сносит собственный артефакт
+            ревью, потому что он untracked. В репозиторий его положит шаг
+            публикации, взяв из REVIEW_DOC; тебе трогать docs/reviews не нужно.
+
+            В самом репозитории не создавай файлов вообще: любые изменения в
+            рабочей копии будут отброшены. Имя документа в docs/reviews шаг
+            публикации соберёт сам — SPEC-REVIEW для этапа spec, CODE-REVIEW для
+            code, с номером issue и заходом.
+
+            Содержание документа: скоуп, как проверялось, находки с
+            воспроизведением, что проверено и корректно, чего не проверял. Для
+            r2 и дальше добавь два раздела: «Закрытие раунда r<N-1>» — таблица
+            «находка | чем закрыта | где это видно», и «Унаследовано из r<N-1>» —
+            что принято без повторной проверки, с документом и SHA.

            Затем оставь в issue краткий комментарий: вердикт, ключевые находки
            и ссылка на документ. Первой строкой — вердикт в формате §7.2:
-            `Вердикт: зелёный/жёлтый/красный · цикл r${{ needs.guard.outputs.cycle }}/${{ needs.guard.outputs.limit }} · High: N · Medium: N → #…`
+            `Вердикт: зелёный/жёлтый/красный · заход r${{ needs.guard.outputs.cycle }} · блокирующих циклов ${{ needs.guard.outputs.spent }}/${{ needs.guard.outputs.limit }} · High: N · Medium: N → в задаче | #…`
+            («→ #…» — только у Medium вне скоупа; находки в скоупе возвращаются автору жёлтым)

            Затем верни JSON по схеме. Это последнее действие и оно обязательно:
            без него метка не переставится и конвейер встанет.
@@ -299,10 +568,14 @@ jobs:
      # Ревьюер пишет только в docs/reviews/. Что именно попадёт в коммит,
      # решает этот шаг, а не модель: всё остальное откатывается.
      - name: Опубликовать документ ревью
+        if: steps.rebase.outputs.conflict != 'true'
        env:
          TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
          BRANCH: ${{ steps.branch.outputs.name }}
          NUM: ${{ github.event.issue.number }}
+          STAGE: ${{ needs.guard.outputs.stage }}
+          CYCLE: ${{ needs.guard.outputs.cycle }}
+          SOURCE: ${{ runner.temp }}/review-document.md
        run: |
          # Ветки задачи может не быть: у задач, размеченных до появления
          # конвейера, ТЗ лежит прямо в dev. Раньше шаг в этом случае молча
@@ -313,12 +586,49 @@ jobs:
          if [ -z "$BRANCH" ]; then
            echo "::warning::ветки задачи нет — документ ревью ляжет в dev"
          fi
+          marker=CODE-REVIEW
+          if [ "$STAGE" = "spec" ]; then marker=SPEC-REVIEW; fi
+          doc="docs/reviews/${marker}-${NUM}-r${CYCLE}.md"
+          # Рабочая копия отбрасывается ДО того, как документ попадёт в дерево:
+          # ревьюер правит код, проверяя «умеет ли тест падать», и его правки
+          # публиковаться не должны.
          git checkout -- . 2>/dev/null || true
+          # docs/reviews исключён из уборки: ревьюер мог написать документ по
+          # старому пути, и клин не должен его съесть до `git add` — ровно так
+          # оба пути остаются работоспособными.
          git clean -fd -e docs/reviews -e node_modules >/dev/null 2>&1 || true
+          # Документ приезжает извне репозитория (#220). Три раунда подряд он
+          # терялся, пока лежал некоммитнутым файлом в том же дереве, которое
+          # ревьюер мутирует и затем восстанавливает: `git checkout -- .` плюс
+          # `git clean -fd` сносят собственный артефакт ревью, потому что он
+          # untracked. Теперь его место — RUNNER_TEMP, и уборка дерева ему не
+          # страшна.
+          if [ -f "$SOURCE" ]; then
+            mkdir -p docs/reviews
+            cp "$SOURCE" "$doc"
+            echo "документ взят из $SOURCE ($(wc -c < "$doc") байт)"
+          else
+            # Совместимость: ревьюер мог написать по старому пути, если промпт
+            # ещё не обновился в этой ветке.
+            echo "::warning::$SOURCE не найден — ищу документ в рабочей копии"
+          fi
          git add docs/reviews 2>/dev/null || true
          if git diff --cached --quiet; then
-            echo "::warning::документ ревью не создан"
-            exit 0
+            # Пустая рабочая копия — ещё не провал: ревьюер иногда коммитит
+            # документ сам, своим app-токеном мимо этого шага (CODE-REVIEW-150-r1,
+            # коммиттер GitHub). Провал — когда файла нет и на ветке.
+            git fetch -q origin "$target"
+            if git cat-file -e "origin/$target:$doc" 2>/dev/null; then
+              echo "документ уже опубликован ревьюером: $doc"
+              exit 0
+            fi
+            # Ревью без артефакта запрещено (PROCESS.md §2.4/§10.4/§12). Раньше
+            # здесь стоял warning с exit 0: на #150 оба вердикта ревью ТЗ
+            # остались только комментариями, метки переставились, и пропажу
+            # заметило лишь следующее ревью — issue #171. Падение ДО шага с
+            # меткой сохраняет инвариант «метка не сменилась = прогон упал».
+            echo "::error::вердикт есть, а документа нет: ни $SOURCE, ни $doc в рабочей копии, ни $doc в $target — ревью без артефакта (#171, #220)"
+            exit 1
          fi
          git -c user.name="claude[bot]" \
              -c user.email="209825114+claude[bot]@users.noreply.github.com" \
@@ -338,16 +648,26 @@ jobs:
                     -c user.email="209825114+claude[bot]@users.noreply.github.com" \
                     rebase "origin/$target"; then
              git rebase --abort || true
-              echo "::error::документ ревью не удалось опубликовать в $target: конфликт"
-              exit 0
+              # Тоже вердикт без артефакта: раньше exit 0 переставил бы метку.
+              echo "::error::документ ревью не удалось опубликовать в $target: конфликт (#171)"
+              exit 1
            fi
            git push -q "https://x-access-token:$TOKEN@github.com/${{ github.repository }}" \
              "HEAD:$target"
          fi
-          echo "документ опубликован в $target"
+          # Постусловие: до ветки дошёл именно ожидаемый файл. Коммит с
+          # документом, названным не по формату, — тот же вердикт без
+          # артефакта, только дороже в обнаружении.
+          git fetch -q origin "$target"
+          if ! git cat-file -e "origin/$target:$doc" 2>/dev/null; then
+            echo "::error::коммит в $target опубликован, но ожидаемого $doc в нём нет — файл назван не по формату (#171)"
+            exit 1
+          fi
+          echo "документ опубликован в $target: $doc"

      - name: Решение по вердикту
        id: decide
+        if: steps.rebase.outputs.conflict != 'true'
        env:
          OUT: ${{ steps.review.outputs.structured_output }}
          STAGE: ${{ needs.guard.outputs.stage }}
@@ -393,14 +713,42 @@ jobs:
          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
          BRANCH: ${{ steps.branch.outputs.name }}
          NUM: ${{ github.event.issue.number }}
+          MATERIAL_SHA: ${{ steps.material.outputs.sha }}
        run: |
          if [ -z "$BRANCH" ]; then
            echo "::error::ветки задачи нет — сливать нечего"
            echo "merged=false" >> "$GITHUB_OUTPUT"
            exit 0
          fi
-          git fetch -q origin dev
-          git checkout -q -B merge-into-dev "origin/$BRANCH"
+          git fetch -q origin dev "$BRANCH"
+          # #312: сливается только проверенный код. Допустимые вершины ветки:
+          # сам SHA материала либо он же плюс ровно один коммит публикации
+          # документа ревью (дифф только docs/reviews/). Любой другой коммит —
+          # ветка уехала после ревью, вердикт к ней не применим: возврат в
+          # S6-in-progress через merged=false, как при конфликте.
+          actual=$(git rev-parse "origin/$BRANCH")
+          reviewed="$MATERIAL_SHA"
+          fresh=false
+          if [ "$actual" = "$reviewed" ]; then
+            fresh=true
+          elif [ "$(git rev-parse "$actual^" 2>/dev/null)" = "$reviewed" ] \
+            && [ -z "$(git diff --name-only "$reviewed" "$actual" -- . ':!docs/reviews')" ]; then
+            fresh=true
+          fi
+          if [ "$fresh" != true ]; then
+            echo "merged=false" >> "$GITHUB_OUTPUT"
+            echo "::warning::ветка $BRANCH уехала после проверенного SHA $reviewed (сейчас $actual) — слияние отменено (#312)"
+            cat > /tmp/stale-verdict.md <<EOF
+          **Слияние отменено: ветка изменилась после проверенного материала (#312).**
+
+          Ревью выполнялось на \\`$(git rev-parse --short "$reviewed")\\`, а вершина ветки сейчас \\`$(git rev-parse --short "$actual")\\` — в ней есть коммиты, которых вердикт не покрывает. Зелёный вердикт остаётся в силе только для проверенного SHA.
+
+          Задача переведена в \\`S6-in-progress\\`. Дальше: убедиться, что вершина ветки — именно то, что должно ехать в dev, и вернуть метку \\`S7-code-review\\` — новый заход ревью проверит актуальный код.
+          EOF
+            gh issue comment "$NUM" --repo "${{ github.repository }}" --body-file /tmp/stale-verdict.md
+            exit 0
+          fi
+          git checkout -q -B merge-into-dev "$actual"
          if ! git -c user.name="claude[bot]" \
                   -c user.email="209825114+claude[bot]@users.noreply.github.com" \
                   rebase origin/dev; then
@@ -426,6 +774,7 @@ jobs:
          echo "слито в dev: $(git rev-parse --short HEAD)"

      - name: Переставить метку
+        if: steps.rebase.outputs.conflict != 'true'
        env:
          # Именно PAT: с GITHUB_TOKEN следующий шаг конвейера не запустится.
          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
@@ -1,4 +1,4 @@
-name: Publish prerelease
+name: Публикация пре-релиза (ручная)
 run-name: Publish ${{ inputs.tag }}

 on:
@@ -19,16 +19,17 @@ concurrency:

 jobs:
  gate:
+    name: "Гейт: зелёная Проверка и релизный контракт"
    runs-on: ubuntu-latest
    outputs:
      sha: ${{ steps.candidate.outputs.sha }}
      tag: ${{ steps.candidate.outputs.tag }}
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          ref: ${{ github.sha }}
          fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - name: Pin the current dev candidate
        id: candidate
@@ -61,17 +62,18 @@ jobs:
        run: node scripts/release-gate.mjs "$SHA"

  publish:
+    name: Публикация тега и релиза
    needs: gate
    runs-on: ubuntu-latest
    outputs:
      url: ${{ steps.verify.outputs.url }}
      newly_published: ${{ steps.release.outputs.newly_published }}
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          ref: ${{ needs.gate.outputs.sha }}
          fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - name: Build and verify both release assets before publication
        env:
@@ -81,7 +83,6 @@ jobs:
          npm ci
          npm run build
          cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js
-          cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
          VERSION=${TAG#v}
          grep -Fq "$VERSION" dist/houseplan-card.js
          (cd custom_components/houseplan && zip -qr ../../houseplan.zip .)
@@ -173,7 +174,7 @@ jobs:
          printf '### Published %s\n\n- exact SHA: `%s`\n- [GitHub prerelease](%s)\n- assets: `houseplan-card.js`, `houseplan.zip`\n' \
            "$TAG" "$SHA" "$URL" >> "$GITHUB_STEP_SUMMARY"
      - name: Verify HACS prerelease discovery order
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
        env:
          EXPECTED_TAG: ${{ needs.gate.outputs.tag }}
        with:
@@ -199,6 +200,7 @@ jobs:
  # A manual step after a successful release is the worst kind: by the time it is
  # due, the work already looks finished, which is exactly why it gets forgotten.
  close-merged:
+    name: Закрытие вошедших issue
    needs: [gate, publish]
    if: ${{ needs.publish.outputs.newly_published == 'true' }}
    runs-on: ubuntu-latest
@@ -246,6 +248,7 @@ jobs:
          }

  announce:
+    name: Комментарий о публикации
    needs: [gate, publish]
    if: ${{ needs.publish.outputs.newly_published == 'true' }}
    uses: ./.github/workflows/announce.yml
@@ -1,4 +1,4 @@
-name: Attach HACS zip to release
+name: HACS-zip к релизу
 # hacs.json declares zip_release + filename=houseplan.zip, so every release
 # (prereleases included) must carry the asset — HACS installs from it and
 # GitHub's public download counter becomes a free per-version install metric
@@ -19,6 +19,7 @@ permissions:
  contents: write
 jobs:
  zip:
+    name: Собрать houseplan.zip и приложить к релизу
    runs-on: ubuntu-latest
    steps:
      - name: Resolve tag
@@ -27,7 +28,7 @@ jobs:
          EVENT_TAG: ${{ github.event.release.tag_name }}
          INPUT_TAG: ${{ github.event.inputs.tag }}
        run: echo "tag=${EVENT_TAG:-$INPUT_TAG}" >> "$GITHUB_OUTPUT"
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          ref: ${{ steps.tag.outputs.tag }}
      - name: Build houseplan.zip (contents of custom_components/houseplan at zip root)
@@ -1,4 +1,4 @@
-name: Release
+name: "Релиз: ассеты после зелёной проверки"
 on:
  release:
    types: [published]
@@ -14,13 +14,14 @@ jobs:
  # Needs a push with a token that has the `workflow` scope (the ordinary
  # Personal Access Token used for `git push` refuses workflow file updates).
  gate:
+    name: "Гейт: зелёная Проверка точного SHA тега"
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          ref: ${{ github.event.release.tag_name }}
          fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - name: Require a green Validate for this exact commit
        env:
@@ -42,35 +43,37 @@ jobs:
        run: |
          set -euo pipefail
          SHA=$(git rev-parse HEAD)
-          node scripts/release-gate.mjs "$SHA" --workflow=performance.yml --label="Full Performance"
+          node scripts/release-gate.mjs "$SHA" --workflow=performance.yml --label="Полные бенчмарки производительности"
  build:
+    name: Сборка бандла и загрузка ассетов
    needs: gate
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with:
          ref: ${{ github.event.release.tag_name }}
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - run: npm ci && npm run build
      - name: Verify compositor frame continuity for a stable release
        if: ${{ !github.event.release.prerelease }}
        run: |
          npx playwright install --with-deps chromium
-          cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+          node scripts/bundle-sync.mjs
          npm run continuity:screencast
      - name: Upload failed continuity frames
        if: ${{ failure() && !github.event.release.prerelease }}
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
          name: continuity-screencast
          path: artifacts/continuity-screencast
      - run: cp dist/houseplan-card.js custom_components/houseplan/frontend/
      - name: Attach card to release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
        with:
          files: dist/houseplan-card.js
  hacs-discovery:
+    name: HACS-видимость пре-релиза (порядок бет)
    # HACS 2.0.x takes the first prerelease in GitHub's response instead of
    # sorting SemVer. A valid asset can therefore be invisible to beta users
    # (beta.10 appeared after beta.9). Keep the release asset, but
@@ -80,7 +83,7 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Verify the published tag is the prerelease HACS will discover
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
        with:
          script: |
            const releases = await github.paginate(github.rest.repos.listReleases, {
@@ -1,4 +1,4 @@
-name: Validate
+name: Проверка (CI)

 on:
  push:
@@ -6,6 +6,12 @@ on:
    # to the same SHA and must not duplicate the browser validation jobs.
    branches:
      - '**'
+    # Документы ревью конвейер пишет пачками — 340 коммитов за месяц, и каждый
+    # гонял лёгкую половину Validate впустую (≈15 часов раннера в месяц).
+    # Релизного кандидата это не затрагивает: тег всегда стоит на коммите,
+    # который меняет версию и бандл, а не только `docs/reviews/**`.
+    paths-ignore:
+      - 'docs/reviews/**'
  pull_request:

 # A new push supersedes an unfinished validation for the same branch or PR.
@@ -15,12 +21,46 @@ concurrency:
  cancel-in-progress: true

 jobs:
-  provenance:
+  docs:
+    name: "Документация: гайды, ченджлоги, скриншот-индекс"
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with: { node-version: 22 }
+      - name: Validate public documentation
+        run: node scripts/check-docs.mjs --external
+
+  # Конвейер читает `process.yml` из ветки по умолчанию, поэтому файл обязан
+  # совпадать в `main` и `dev`. До этой проверки совпадение держалось на
+  # дисциплине: каждая правка требовала двух пушей и ручной сверки.
+  process-workflow-sync:
+    name: "Процесс: process.yml идентичен в main и dev"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: process.yml идентичен в main и dev
+        run: |
+          git fetch --quiet origin main dev
+          if diff <(git show origin/main:.github/workflows/process.yml) \
+                  <(git show origin/dev:.github/workflows/process.yml); then
+            echo "main и dev идентичны"
+          else
+            echo "РАСХОЖДЕНИЕ: process.yml в main и dev различаются."
+            echo "Конвейер исполняет версию из ветки по умолчанию, поэтому"
+            echo "правку нужно отправить в обе ветки."
+            exit 1
+          fi
+
+  provenance:
+    name: "Провенанс коммитов: трейлеры и эталоны"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
        with: { fetch-depth: 0 }
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - name: Validate commit trailers and hook mode
        env:
@@ -28,8 +68,9 @@ jobs:
          BEFORE_SHA: ${{ github.event.before }}
          BASE_SHA: ${{ github.event.pull_request.base.sha }}
          HEAD_SHA: ${{ github.sha }}
-          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+          DEVELOPMENT_BRANCH: dev
        run: |
+          git fetch -q origin "refs/heads/$DEVELOPMENT_BRANCH:refs/remotes/origin/$DEVELOPMENT_BRANCH"
          node scripts/validate-commit-provenance.mjs --check-hook-mode --github-range

  # Догоняющая проверка процесса (PROCESS.md §10.3). Хуки ловят нарушение на
@@ -38,11 +79,12 @@ jobs:
  # где нарушение правила №1 ловится машиной. Job независимый: краснеет сам и
  # не роняет остальные, откат — удалить его отсюда, скрипт остаётся рабочим.
  process-gate:
+    name: "Процессный гейт: диапазон, трейлеры, статусы issue"
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with: { fetch-depth: 0 }
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
      - name: Process gate
        env:
@@ -50,11 +92,12 @@ jobs:
          BEFORE_SHA: ${{ github.event.before }}
          BASE_SHA: ${{ github.event.pull_request.base.sha }}
          HEAD_SHA: ${{ github.sha }}
-          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
+          DEVELOPMENT_BRANCH: dev
          TARGET_REF: ${{ github.ref }}
          # Публичный репозиторий: штатного токена хватает на чтение issue.
          GH_TOKEN: ${{ github.token }}
        run: |
+          git fetch -q origin "refs/heads/$DEVELOPMENT_BRANCH:refs/remotes/origin/$DEVELOPMENT_BRANCH"
          node scripts/process-gate.mjs --github-range --issues

  # Классификация изменённых путей: тяжёлые job идут только там, где менялось
@@ -65,13 +108,14 @@ jobs:
  # экономят на ветках задач, где Validate — ранний сигнал: настоящую приёмку
  # там делает код-ревью, которое гоняет гейты само (#127).
  changes:
+    name: Классификация изменённых файлов
    runs-on: ubuntu-latest
    outputs:
      frontend: ${{ steps.classify.outputs.frontend }}
      backend: ${{ steps.classify.outputs.backend }}
      integration: ${{ steps.classify.outputs.integration }}
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
        with: { fetch-depth: 0 }
      - id: classify
        env:
@@ -105,33 +149,129 @@ jobs:
            echo "integration=$(has '^(custom_components/houseplan/manifest\.json$|hacs\.json$|custom_components/.*\.py$|custom_components/.*/translations/)')"
          } >> "$GITHUB_OUTPUT"

+  # Переиспользование результата тяжёлой job (#208). Ключ = входы поведения
+  # (sourceFingerprint: src/**, demo/fixtures, demo/golden/*.mjs, манифесты
+  # сборки) ПЛЮС оснастка именно этой job. Маркер в кэше пишет только успешный
+  # прогон с тем же ключом, поэтому попадание доказывает: job с побайтово теми
+  # же входами уже завершилась успешно.
+  #
+  # Это НЕ фильтр путей из job `changes` (на dev они отключены намеренно): там
+  # объём прогона угадывается по путям и «зелёный» начинает значить разное,
+  # здесь эквивалентность входов доказана хешем.
+  #
+  # Свойство, снимающее главный риск: релизный кандидат бампает версию, а
+  # CARD_VERSION и package.json входят в фингерпринт, поэтому ключи кандидата
+  # заведомо новые и полный набор гейтов перед бетой и релизом идёт всегда.
+  reuse:
+    name: "Переиспользование: это дерево уже проверено"
+    runs-on: ubuntu-latest
+    outputs:
+      smoke: ${{ steps.probe.outputs.smoke }}
+      golden: ${{ steps.probe.outputs.golden }}
+      performance_smoke: ${{ steps.probe.outputs.performance_smoke }}
+      backend: ${{ steps.probe.outputs.backend }}
+      smoke_key: ${{ steps.keys.outputs.smoke }}
+      golden_key: ${{ steps.keys.outputs.golden }}
+      performance_smoke_key: ${{ steps.keys.outputs.performance_smoke }}
+      backend_key: ${{ steps.keys.outputs.backend }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with: { node-version: 22 }
+      - name: Ключи переиспользования
+        id: keys
+        run: |
+          for job in smoke golden performance_smoke backend; do
+            key=$(node scripts/gate-reuse.mjs --job="$job")
+            echo "$job=$key" >> "$GITHUB_OUTPUT"
+            echo "$job: $key"
+          done
+      # lookup-only: маркер только проверяется, но не восстанавливается —
+      # сохранять его в этой job нечего, она ничего не прогоняла.
+      - name: Маркер smoke
+        id: m_smoke
+        uses: actions/cache/restore@v6
+        with:
+          path: .reuse-marker
+          key: reuse-smoke-${{ steps.keys.outputs.smoke }}
+          lookup-only: true
+      - name: Маркер golden
+        id: m_golden
+        uses: actions/cache/restore@v6
+        with:
+          path: .reuse-marker
+          key: reuse-golden-${{ steps.keys.outputs.golden }}
+          lookup-only: true
+      - name: Маркер performance_smoke
+        id: m_perf
+        uses: actions/cache/restore@v6
+        with:
+          path: .reuse-marker
+          key: reuse-performance_smoke-${{ steps.keys.outputs.performance_smoke }}
+          lookup-only: true
+      - name: Маркер backend
+        id: m_backend
+        uses: actions/cache/restore@v6
+        with:
+          path: .reuse-marker
+          key: reuse-backend-${{ steps.keys.outputs.backend }}
+          lookup-only: true
+      - name: Что переиспользуем
+        id: probe
+        env:
+          SMOKE: ${{ steps.m_smoke.outputs.cache-hit }}
+          GOLDEN: ${{ steps.m_golden.outputs.cache-hit }}
+          PERF: ${{ steps.m_perf.outputs.cache-hit }}
+          BACKEND: ${{ steps.m_backend.outputs.cache-hit }}
+        run: |
+          # Пропуск обязан быть громким: молчаливый skip — тот самый тихий
+          # успех, который уже дважды стоил нам дня (#171, #207).
+          waive() {
+            if [ "$2" = "true" ]; then
+              echo "$1=true" >> "$GITHUB_OUTPUT"
+              echo "::notice::$1 не прогоняется: входы побайтово те же, что в предыдущем успешном прогоне (#208)"
+              echo "- **$1** переиспользована: входы не менялись" >> "$GITHUB_STEP_SUMMARY"
+            else
+              echo "$1=false" >> "$GITHUB_OUTPUT"
+              echo "- $1: прогоняется" >> "$GITHUB_STEP_SUMMARY"
+            fi
+          }
+          echo "### Переиспользование гейтов (#208)" >> "$GITHUB_STEP_SUMMARY"
+          waive smoke "$SMOKE"
+          waive golden "$GOLDEN"
+          waive performance_smoke "$PERF"
+          waive backend "$BACKEND"
+
  hacs:
+    name: "HACS: валидация репозитория"
    needs: changes
    if: needs.changes.outputs.integration == 'true'
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
      - name: HACS validation
        uses: hacs/action@main
        with:
          category: integration

  hassfest:
+    name: "Hassfest: манифест интеграции"
    needs: changes
    if: needs.changes.outputs.integration == 'true'
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
      - name: Hassfest validation
        uses: home-assistant/actions/hassfest@master

  frontend:
+    name: "Фронтенд: типы, юниты, мутанты, синхрон бандла"
    needs: changes
    if: needs.changes.outputs.frontend == 'true'
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
@@ -142,31 +282,61 @@ jobs:
        run: npm test
      - name: Build
        run: npm run build
+      # Копия стенда больше не коммитится (#255): сверяются две обязательные.
      - name: Card bundle snapshots in sync
-        run: |
-          cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js
-          cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+        run: cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js

  smoke:
+    name: Смоки в браузере (шард ${{ matrix.shard }} из 3)
    # Gated on `frontend` so a typecheck failure does not burn browser minutes.
-    needs: frontend
+    needs: [frontend, reuse]
+    if: needs.reuse.outputs.smoke != 'true'
    runs-on: ubuntu-latest
+    # Смоки шардируются: последовательный прогон занимал ~7.5 минут и был
+    # критическим путём всего Validate. Три шарда режут его примерно вдвое;
+    # цена — трижды `npm ci` и сборка, около двух оплаченных минут раннера.
+    strategy:
+      fail-fast: false
+      matrix:
+        shard: [1, 2, 3]
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
      - run: npm ci
-      - name: Install Chromium for Playwright
-        run: npx playwright install --with-deps chromium
+      # Браузеры кэшируются, а apt не запускается вовсе: на GitHub-раннере
+      # системные библиотеки Chromium уже в образе, а --with-deps тратил минуты
+      # и подолгу перебирал недоступное azure-зеркало (#175, #206). Если
+      # библиотека когда-нибудь исчезнет из образа, Chromium не запустится с
+      # внятной ошибкой — тогда флаг вернуть.
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@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 a fresh bundle for the smokes
-        run: npm run build && cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
-      - name: Smoke suite
+        run: npm run bundle:sync
+      - name: Smoke suite (шард ${{ matrix.shard }} из 3)
+        env:
+          SHARD: ${{ matrix.shard }}
+          SHARDS: '3'
        run: |
          fail=0
+          index=0
+          ran=0
          mkdir -p /tmp/smoke-logs
+          # Деление по порядковому номеру файла: список отсортирован, поэтому
+          # разбиение детерминировано и не зависит от времени прогона.
          for f in demo/smoke_*.mjs; do
+            index=$((index + 1))
+            if [ $(( (index - 1) % SHARDS + 1 )) -ne "$SHARD" ]; then continue; fi
+            ran=$((ran + 1))
            name=$(basename "$f" .mjs)
            if node "$f" > "/tmp/smoke-logs/$name.log" 2>&1; then
              echo "ok   $name"
@@ -176,30 +346,70 @@ jobs:
              fail=1
            fi
          done
+          echo "--- шард ${SHARD}/${SHARDS}: прогнано ${ran} из ${index}"
+          # Пустой шард — признак, что деление сломалось, а не что работы нет.
+          if [ "$ran" -eq 0 ]; then echo "шард пуст: проверьте деление"; exit 1; fi
          exit $fail
      - name: Upload smoke logs
        if: failure()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
-          name: smoke-logs
+          name: smoke-logs-${{ matrix.shard }}
          path: /tmp/smoke-logs

-  golden:
-    # Deterministic visual correctness stays in every prerelease gate: it is
-    # inexpensive and catches a different class of regressions than timings.
-    needs: frontend
+  # Маркер переиспользования пишется ОДИН раз и только когда прошли все шарды:
+  # частично прогнанная матрица не имеет права выглядеть как выполненная работа.
+  smoke_done:
+    name: "Смоки: все шарды зелёные"
+    needs: [smoke, reuse]
+    if: needs.reuse.outputs.smoke != 'true'
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Записать маркер успеха
+        run: |
+          printf '%s\n' "smoke прогнана успешно (3 шарда)" \
+            "SHA: ${{ github.sha }}" \
+            "прогон: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" \
+            > .reuse-marker
+      - uses: actions/cache/save@v6
+        # Гонка двух прогонов с одинаковым ключом даёт «Cache already exists».
+        # Это не отказ гейта: работа выполнена, маркер уже записал сосед — job
+        # краснеть из-за этого не должна.
+        continue-on-error: true
+        with:
+          path: .reuse-marker
+          key: reuse-smoke-${{ needs.reuse.outputs.smoke_key }}
+
+  golden:
+    name: Golden-кадры против принятых эталонов
+    # Deterministic visual correctness stays in every prerelease gate: it is
+    # inexpensive and catches a different class of regressions than timings.
+    needs: [frontend, reuse]
+    if: needs.reuse.outputs.golden != 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
      - run: npm ci
+      # Браузеры кэшируются, а apt не запускается вовсе: на GitHub-раннере
+      # системные библиотеки Chromium уже в образе, а --with-deps тратил минуты
+      # и подолгу перебирал недоступное azure-зеркало (#175, #206). Если
+      # библиотека когда-нибудь исчезнет из образа, Chromium не запустится с
+      # внятной ошибкой — тогда флаг вернуть.
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
      - name: Install pinned Chromium
-        run: npx playwright install --with-deps chromium
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install chromium
      - name: Build the exact source under review
-        run: npm run build && cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+        run: npm run bundle:sync
      - name: Capture or verify golden matrix
        id: golden
        run: |
@@ -212,28 +422,61 @@ jobs:
          fi
      - name: Upload golden candidates/diffs
        if: failure() || steps.golden.outputs.has_baselines == 'false'
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
          name: golden-images
          path: artifacts/golden
+      # Маркер пишется последним шагом: он существует только если всё выше
+      # прошло. Кэш сохраняется post-шагом, то есть тоже лишь при успехе job.
+      - name: Записать маркер успеха
+        run: |
+          printf '%s\n' "golden прогнана успешно" \
+            "SHA: ${{ github.sha }}" \
+            "прогон: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" \
+            > .reuse-marker
+      - uses: actions/cache/save@v6
+        # Гонка двух прогонов с одинаковым ключом даёт «Cache already exists».
+        # Это не отказ гейта: работа выполнена, маркер уже записал сосед — job
+        # краснеть из-за этого не должна.
+        continue-on-error: true
+        with:
+          path: .reuse-marker
+          key: reuse-golden-${{ needs.reuse.outputs.golden_key }}

  performance_smoke:
+    name: "Перф-смок: бюджет времени кадра"
    # Candidate-only catastrophic-regression guard for ordinary pushes and
    # prereleases. The expensive same-runner comparison lives in performance.yml.
-    needs: frontend
+    needs: [frontend, reuse]
+    if: needs.reuse.outputs.performance_smoke != 'true'
    runs-on: ubuntu-latest
-    timeout-minutes: 15
+    # 15 минут не хватало, когда установка браузера шла через apt: замер
+    # начинался на исходе окна (#206). Запас на холодный кэш — при попадании
+    # job укладывается в те же минуты, что и раньше.
+    timeout-minutes: 20
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
        with:
          node-version: 22
          cache: npm
      - run: npm ci
+      # Браузеры кэшируются, а apt не запускается вовсе: на GitHub-раннере
+      # системные библиотеки Chromium уже в образе, а --with-deps тратил минуты
+      # и подолгу перебирал недоступное azure-зеркало (#175, #206). Если
+      # библиотека когда-нибудь исчезнет из образа, Chromium не запустится с
+      # внятной ошибкой — тогда флаг вернуть.
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
      - name: Install pinned Chromium
-        run: npx playwright install --with-deps chromium
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install chromium
      - name: Build the exact candidate source
-        run: npm run build && cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+        run: npm run bundle:sync
      - name: Capture the heaviest Glow state
        run: |
          npm run benchmark:glow -- --profile=large-house-glow-overlay-v1 --variants=60 --samples=3 --warmups=1 --output=artifacts/performance-smoke/candidate.json
@@ -242,23 +485,56 @@ jobs:
          npm run benchmark:compare -- --absolute-only --budgets=demo/performance/budgets-glow-smoke.json --candidate=artifacts/performance-smoke/candidate.json --output=artifacts/performance-smoke/comparison.json
      - name: Upload performance smoke report
        if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
          name: performance-smoke
          path: artifacts/performance-smoke
+      # Маркер пишется последним шагом: он существует только если всё выше
+      # прошло. Кэш сохраняется post-шагом, то есть тоже лишь при успехе job.
+      - name: Записать маркер успеха
+        run: |
+          printf '%s\n' "performance_smoke прогнана успешно" \
+            "SHA: ${{ github.sha }}" \
+            "прогон: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" \
+            > .reuse-marker
+      - uses: actions/cache/save@v6
+        # Гонка двух прогонов с одинаковым ключом даёт «Cache already exists».
+        # Это не отказ гейта: работа выполнена, маркер уже записал сосед — job
+        # краснеть из-за этого не должна.
+        continue-on-error: true
+        with:
+          path: .reuse-marker
+          key: reuse-performance_smoke-${{ needs.reuse.outputs.performance_smoke_key }}

  backend:
-    needs: changes
-    if: needs.changes.outputs.backend == 'true'
+    name: "Бэкенд: pytest в Home Assistant"
+    needs: [changes, reuse]
+    if: needs.changes.outputs.backend == 'true' && needs.reuse.outputs.backend != 'true'
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
      # Browser fixtures are generated by their real ESM factories and then
      # validated through the Python CONFIG_SCHEMA/LAYOUT_SCHEMA in the same test.
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v7
        with: { node-version: 22 }
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v7
        with: { python-version: "3.13" }
      - run: pip install pytest voluptuous pytest-homeassistant-custom-component home-assistant-frontend
      - name: Backend unit tests (pure + HA harness)
        run: python -m pytest tests_backend/ -q
+      # Маркер пишется последним шагом: он существует только если всё выше
+      # прошло. Кэш сохраняется post-шагом, то есть тоже лишь при успехе job.
+      - name: Записать маркер успеха
+        run: |
+          printf '%s\n' "backend прогнана успешно" \
+            "SHA: ${{ github.sha }}" \
+            "прогон: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" \
+            > .reuse-marker
+      - uses: actions/cache/save@v6
+        # Гонка двух прогонов с одинаковым ключом даёт «Cache already exists».
+        # Это не отказ гейта: работа выполнена, маркер уже записал сосед — job
+        # краснеть из-за этого не должна.
+        continue-on-error: true
+        with:
+          path: .reuse-marker
+          key: reuse-backend-${{ needs.reuse.outputs.backend_key }}
@@ -7,3 +7,8 @@ __pycache__/
 .venv-backend/
 artifacts/
 .agents/
+
+# Копия бандла для стенда: её собирает `npm run bundle:sync`, а в репозитории
+# она только росла — 364 версии по 1.16 МБ за семь недель (#255). Обязательных
+# копий две: `dist/` (артефакт сборки) и `custom_components/` (её ставит HACS).
+demo/srv/assets/houseplan-card.js
@@ -87,7 +87,7 @@ Start with the spec?" is the correct answer, not a smaller patch.
 | **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/srv/assets/houseplan-card.js`, `demo/golden/baselines/**` | never changes on its own |
+| **D — generated** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**` | never changes on its own. The stand copy `demo/srv/assets/houseplan-card.js` is no longer committed (#255): build it with `npm run bundle:sync` |

 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`,
@@ -255,10 +255,15 @@ The exchange happens in **issue comments** — there is no local message bus. Ve
 format:

 ```text
-Verdict: green/yellow/red · cycle r<N>/4 · High: N · Medium: N → #… · Document: …
+Verdict: green/yellow/red · cycle r<N>/4 · High: N · Medium: N → in-task | #… · Document: …
 ```

-High blocks. Medium must become its own issue. Low is fixed or waived with a note
+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.
@@ -317,7 +322,7 @@ byte-for-byte:

 ```
 cp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js
-cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+npm run bundle:sync   # dist → custom_components + demo/srv/assets (#255)
 ```

 During the implementation cycle the fast gates always run. Since 2026-08-14 the
@@ -353,14 +358,22 @@ complete Linux CI artifact; never accept a partial scenario or images merely to
 CI green. See `demo/golden/README.md`.

 **Freshness contract**: the embedded fingerprint covers `src/` plus Rollup,
-TypeScript and package-lock build inputs. Benchmark and golden tooling must call
-`assertFreshDemoBundle` before recording any result; a missing or mismatched
-fingerprint is a hard failure, not a warning.
+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. Jobs: `provenance`, `hacs`, `hassfest`,
-`frontend`, `smoke`, `golden`, `performance_smoke`, `backend`.
+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`, `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.

 **"Verified" without a named command and its result is not evidence.**

@@ -35,7 +35,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/srv/assets/houseplan-card.js`, `demo/golden/baselines/**` | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью |
+| **D. Сгенерированное** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**` (копия стенда `demo/srv/assets/houseplan-card.js` с #255 не коммитится вовсе) | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью |

 Практический смысл таблицы: «я только поправил тест» и «я только пересобрал
 бандл» перестают быть лазейками.
@@ -131,10 +131,14 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
  Его задача — не согласиться, а найти, где ТЗ не выполнимо или не проверяемо.
 - **Артефакт:** `docs/reviews/SPEC-REVIEW-<NN>-r<N>.md`, вердикт
  зелёный / жёлтый / красный. Лёгкий трек — комментарий в issue.
- **High-находки блокируют.** Medium/Low — либо правятся, либо становятся
-  отдельными issue со ссылкой; «оставили в тексте ревью» не считается закрытием.
+- **High-находки блокируют.** Medium **в скоупе задачи** чинится в текущем
+  issue: без High это жёлтый вердикт, автор правит ТЗ, фикс проходит повторный
+  цикл. Medium **вне скоупа** — отдельный issue: чужой скоуп в этой задаче не
+  правится. «Оставили в тексте ревью» не считается закрытием ни для одной
+  (решение владельца 2026-08-19, #202: отдельный issue дороже правки на месте).
+  Low либо правится, либо снимается решением ревьюера с записью.
 - **Выход:** «Готово к разработке» либо возврат в «ТЗ в работе» — не более
-  4 циклов (§4).
+  4 циклов (§4). Второй и последующие циклы разбираются по дельте (§2.10).

 ### 2.5 Готово к разработке (DoR)

@@ -187,9 +191,17 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
  кода отвечает на вопрос «оно вообще работает»: каждый AC либо доказан
  автотестом — и ревьюер убедился, что **тест умеет падать**, — либо разобран по
  коду с явной записью «проверено чтением, не исполнением».
- **High блокируют.** Medium **обязаны** превратиться в issue.
+- **High блокируют.** Medium **в скоупе задачи** чинится в текущем issue:
+  без High это жёлтый вердикт и возврат автору, фикс проходит повторный цикл.
+  Medium **вне скоупа** — отдельный issue (#202).
+- **Вердикт привязан к SHA (#312).** Все числа и факты отчёта сверяются с
+  `git rev-parse HEAD` непосредственно перед подведением итогов, а не с SHA,
+  зафиксированным в начале разбора: во время ревью в ветку может прилететь
+  fix-up. Серверный стопор — шаг слияния конвейера сверяет вершину ветки с
+  SHA материала ревью (допустим только собственный doc-коммит публикации
+  поверх) и при расхождении отменяет слияние с возвратом в `S6-in-progress`.
 - **Выход:** очередь на пре-релиз либо возврат в «В разработке», не более
-  4 циклов (§4).
+  4 циклов (§4). Второй и последующие циклы разбираются по дельте (§2.10).

 ### 2.8 Закрытие после выпуска беты

@@ -210,6 +222,42 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 - **Отклонено:** закрытие с записанной причиной (вне скоупа, дубликат, цена не
  оправдана). Тихое закрытие без причины запрещено.

+### 2.10 Повторный раунд ревью — объём по дельте
+
+Решение владельца 2026-08-19 (issue #214). Относится и к ревью ТЗ, и к
+код-ревью, начиная со второго цикла.
+
+**Предмет повторного раунда — дельта, а не задача целиком.** Раньше объём
+разбора не был оговорён, промпт ревьюера для всех раундов был одинаковым, и
+повторный цикл заново выводил продуктовую рамку и перепроверял AC, которых
+правка не касалась: r2 по #150 стоил полного прогона конвейера ради одной
+строки в тестовой фикстуре.
+
+Порядок:
+
+1. найти вердикт предыдущего раунда и **SHA, на котором он получен**; SHA в
+   вердикте не назван — это находка;
+2. объявить дельту: `git diff <тот SHA>..HEAD` для кода, дифф файла ТЗ либо тела
+   issue для этапа ТЗ;
+3. по каждой находке предыдущего раунда показать, **чем именно она закрыта** —
+   строкой кода или текста, а не заявлением автора;
+4. заново проверять только те AC, чьё доказательство дельта задевает;
+5. **раздел «Унаследовано из r<N−1>»** обязателен: что принято без повторной
+   проверки, со ссылкой на документ того раунда и SHA. Без перечня сокращение
+   превращается в молчаливое доверие.
+
+Дешёвые гейты (`typecheck`, `test`, `build` со сверкой копий бандла) гоняются в
+каждом раунде: код изменился, а стоят они минуты. Тяжёлые — по дельте (§10.2).
+
+**Разбор остаётся полным**, если дельта не локальна: ребейз на ушедший вперёд
+`dev` (после ребейза это другой код, §7.2), смена контракта поведения, задета
+новая подсистема, либо объём дельты сопоставим с исходной задачей.
+
+Сокращается объём **разбора, а не строгость**: правка по замечанию способна
+сломать AC, который предыдущий раунд признал выполненным — так появилась
+регрессия #102. Граница не «только находки», а «находки плюс всё, до чего
+дотягивается дельта».
+
 ---

 ## 3. Правила
@@ -231,13 +279,17 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   ревью-гейт.
 7. **Ревью возвращает не более 4 раз.** Пятый заход — решение владельца: разделить,
   отклонить или арбитраж (§4).
-8. **High блокирует. Medium становится issue.** Low либо правится, либо снимается
-   решением ревьюера с записью в документе.
+8. **High блокирует. Medium в скоупе чинится в текущем issue** (без High —
+   жёлтый вердикт и повторный цикл); Medium вне скоупа становится отдельным
+   issue (#202). Low либо правится, либо снимается решением ревьюера с записью
+   в документе.
 9. **Скоуп не расширяется.** Всё найденное вне ТЗ — новый issue, а не попутная
   правка. Блокирующая находка отправляет текущий issue в «Заблокировано».
 10. **Каждый коммит класса A и B несёт трейлер `Issue: #NN`**, ветка называется
    `issue/NN-slug`, а `User-Visible: yes` требует правок в **обоих** changelog в
-    том же коммите.
+    том же коммите. После `cherry-pick -x` служебная строка `(cherry picked
+    from ...)` должна оставаться выше финального блока трейлеров: перед push
+    проверяем порядок через `git show -s --format=full HEAD`.
 11. **Документация — в том же коммите, что поведение.** Отдельным «допишу потом»
    коммитом документация не бывает.
 12. **Сгенерированное не коммитится само по себе.** Только релизный промоушен или
@@ -263,11 +315,24 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →

 ## 4. Лимит циклов ревью: 4

-Оба ревью-гейта возвращают задачу на правки не более **4 раз**. Счётчик виден в
-имени документа: `-r1` … `-r4`; на четвёртом заходе ставится метка `review-4`.
+Оба ревью-гейта возвращают задачу на правки не более **4 раз**.

 - **Что считается циклом:** отправка на ревью → вердикт с блокирующими находками
  → возврат. Уточняющий вопрос без вердикта циклом не считается.
+- **Зелёный вердикт цикла не образует** и бюджет не тратит (решение владельца
+  2026-08-20, issue #227): он ничего не вернул на правки. Практический случай —
+  зелёное ревью, слияние которого не удалось: конвейер сам предписывает ребейз и
+  возврат метки, и этот заход не должен наказываться. Раньше счётчик считал все
+  вердикты подряд, и на #225 последовательность жёлтый → зелёный → ребейз дала
+  `review-4` на задаче с зелёным ревью и зелёным CI.
+- **Заход и цикл — разные величины.** Заход — сколько раз ревью отработало; он
+  виден в имени документа (`-r1`, `-r2`, …) и нужен, чтобы два документа не
+  затёрли друг друга. Цикл — единица бюджета §4. Заходов законно бывает больше,
+  чем циклов, поэтому порог проверки 7 в `scripts/process-gate.mjs` выше лимита
+  циклов (шесть документов = четыре цикла плюс два ребейза).
+- Метка `review-4` ставится, когда исчерпан **бюджет циклов**; конвейер снимать
+  её не вправе — это решение владельца. Если бюджет пересчитан и оказался ниже
+  лимита, конвейер сообщает пересчёт, но метку не трогает.
 - **Исчерпание лимита — не «пятая попытка», а разбор.** Задача уходит владельцу,
  решение одно из трёх:
  1. **разделить** — issue закрывается как «заменён», вместо него 2–3 меньших с
@@ -444,8 +509,12 @@ issue #NN
 - **Занятие:** `Взял: <роль> · сессия <id> · ветка issue/NN-slug`
 - **Хендофф:** `Сделано: … · Файлы: … · Гейты: <команда → результат> ·
  НЕ сделано: … · Риски: … · Следующий статус: … · Новые issue: #…`
- **Вердикт ревью:** `Вердикт: зелёный/жёлтый/красный · цикл r<N>/<лимит> ·
-  High: N · Medium: N → #… · Документ: docs/reviews/…`
+- **Вердикт ревью:** `Вердикт: зелёный/жёлтый/красный · заход r<N> ·
+  блокирующих циклов K/<лимит> · High: N · Medium: N → в задаче | #… ·
+  Документ: docs/reviews/…`
+  («→ #…» — только у Medium вне скоупа; находки в скоупе возвращаются автору.
+  Заход — номер прогона ревью, K — израсходованный бюджет §4: зелёные вердикты
+  его не тратят, поэтому заход и K расходятся, #227)
 - **Закрытие:** `Выпущено в <тег беты> · CI: <ссылка> · Changelog: <ссылка>`

 **Вперёд двигает только зелёный вердикт.** Жёлтый и красный возвращают автору;
@@ -476,23 +545,58 @@ issue #NN
 npx tsc --noEmit
 npm test
 npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js \
-              && cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+              # копия стенда собирается `npm run bundle:sync`, в репозитории её нет (#255)
+node scripts/smoke-select.mjs --base origin/dev --head HEAD   # какие смоки относятся к диффу
 node demo/smoke_<целевые>.mjs
 npm run golden:verify                 # если менялся визуал
+node scripts/check-docs.mjs           # если менялся src/**
+node scripts/model-invariants.mjs --config <экспорт>   # если правилась геометрия или ссылки
 python -m pytest tests_backend -q     # py3.13, если менялся бэкенд
 ```

 **Объём гейтов на код-ревью соразмерен задаче** (issue #127). Всегда:
-`typecheck`, `npm test`, `npm run build` со сверкой трёх копий бандла. По
-необходимости, определяемой diff'ом и AC: браузерные смоки (их 127 — прогон всех
-уместен только когда задача задевает всё), `golden:verify` при изменении видимого
+`typecheck`, `npm test`, `npm run build` со сверкой трёх копий бандла, а при
+любом diff'е по `src/**` — ещё и `node scripts/check-docs.mjs`. По
+необходимости, определяемой 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-профили при
 названном в AC влиянии. **Полные наборы — предрелизный гейт, а не гейт ревью.**

+Скриншоты снимаются **только** джобой `Docs screenshots` (`workflow_dispatch`) и
+принимаются локально: `npm run docs:accept -- --reviewed --from=<распакованный
+артефакт>` (#246). Съёмка на своей машине даёт байтово другой PNG при том же
+кадре, и набор из «не того» браузера переписывает все десять файлов без единого
+содержательного изменения. Приёмка отказывает, если кандидат снят не с этого
+дерева, не тем капчуром, не называет свой Chromium или неполон; коммит делает
+человек.
+
+`check-docs` стоит в обязательной части не по важности, а по механике: отпечаток
+скриншотов документации считается по всему `src/**`, поэтому **любая** правка
+фронтенда делает его устаревшим. Выборка «по diff и AC» здесь не работает — diff
+всегда попадает, и решать нечего. Цена пропуска измерена: скриншоты не
+пересняли в #230 и #234, и `dev` стоял с красным job `docs`, пока это не нашли
+при следующей задаче (#237). Пересъёмка — `npm run build && node
+demo/docs/capture.mjs`, коммит вместе с задачей.
+
 Условие честности такого сужения: ревьюер обязан перечислить, какие гейты прогнал,
 какие нет и почему. Непрогнанный гейт становится видимым решением, а не молчаливым
 пропуском.

+**Одно число — один источник.** Любая величина, которую пользователь видит
+дважды — превью против записи, подпись против площади, подсветка инструмента
+против сохранённого значения, — обязана считаться в одном месте. Три дефекта
+подряд имели ровно эту причину: #234 (резинка показывала 12 см, запись хранила
+24), #233 (подпись мерила по осевым линиям, площадь рядом — по полу) и способ,
+которым #234 нашли (подсветка «Толщины» врала согласованно с записью). Ревьюер
+отвечает на вопрос прямо: какое число в этом диффе видно дважды и один ли у него
+источник. Механическая часть правила закреплена тестом
+`test/single-source-numbers.test.mjs` — строку с единицей измерения собирает
+только канонический форматтер; смысловая часть остаётся за ревью.
+
 **Гейт беты** (условие закрытия issue): CI Validate зелёный на точном SHA тега.

 Часть гейтов запускается только здесь, то есть **после** пройденного код-ревью.
@@ -686,8 +790,8 @@ S7-code-review → код-ревью → слияние в dev → S8-merged л
 ```

 Ревьюер — `anthropics/claude-code-action`. Он читает `docs/SCOPE.md`, `AGENTS.md`,
-этот документ и тело issue, публикует разбор комментарием, заводит issue на каждую
-Medium-находку, кладёт документ в `docs/reviews/` ветки задачи и возвращает вердикт
+этот документ и тело issue, публикует разбор комментарием, заводит issue на Medium-находки
+вне скоупа задачи (#202), кладёт документ в `docs/reviews/` ветки задачи и возвращает вердикт
 структурированным JSON. **Метку переставляет отдельный детерминированный шаг по
 вердикту, а не модель.**

@@ -717,6 +821,28 @@ Medium-находку, кладёт документ в `docs/reviews/` ветк
 никто не может выйти и о котором никто не узнает, для конвейера хуже громкой
 ошибки.

+**Ветка приводится к `dev` до ревью, а не после** (#257). Раньше ревью читало ветку
+как есть, а слияние делало ребейз — проверенный SHA и слитый SHA были разными
+коммитами. Пока расхождение с `dev` текстовое, ребейз упирается в конфликт и это
+видно; смысловое расхождение git склеивает молча, и в `dev` уезжает комбинация,
+которую ревьюер не читал. Именно так пришёл регресс #234. Шаг перед ревью делает
+одно из трёх:
+
+- ветка уже содержит весь `dev` — ничего;
+- отстала и ребейзится чисто — ребейз, `push --force-with-lease`, ревью по
+  приведённому состоянию. Факт ребейза передаётся в промпт, чтобы сработало
+  правило §7.2 о полном разборе вместо дельты;
+- конфликт — возврат в `S6-in-progress` **до** запуска ревью. Цикл при этом не
+  расходуется: код никто не читал, вердикта нет.
+
+Проверка стоит до ревью не только ради совпадения SHA. Конфликт всё равно вернул бы
+задачу, но обнаруживался он после сорока пяти минут работы ревьюера и потраченных
+лимитов подписки, хотя виден за пять секунд до них.
+
+`--force-with-lease` здесь обязателен с явным ожидаемым значением: между чтением
+ветки и пушем автор мог запушить коммит, и слепой `--force` потерял бы его молча.
+Расхождение lease — падение прогона, а не предупреждение.
+
 Поэтому зелёное код-ревью с неудавшимся слиянием ведёт не в `S8-merged`, а в
 `S6-in-progress`: работа действительно вернулась к автору, только осталась не
 правка кода, а ребейз. Вердикт при этом в силе, переделывать нечего. После ребейза
@@ -811,7 +937,8 @@ Golden, браузерные смоки, performance и полный HA-харн
 - принятие golden-эталонов ради зелёного CI или по частичному артефакту;
 - закрытие issue до выпуска беты с зелёным CI;
 - переоткрытие закрытого issue вместо нового бага;
- Medium-находки, оставленные как TODO в документе ревью;
+- Medium-находки, оставленные как TODO в документе ревью: в скоупе — чинятся
+  в текущем issue, вне скоупа — становятся отдельным (#202);
 - **параллельные бэклоги** в файлах (`BACKLOG-*.md`, «планы» в docs);
 - ревью-документы вне репозитория;
 - попутные правки «раз уж я здесь»;
@@ -1,379 +1,158 @@
-# 🏠 House Plan — interactive floor plan card for Home Assistant
+# 🏠 House Plan — a live home map for Home Assistant

-[![HACS Custom](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://github.com/hacs/integration)
+[![HACS Default](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
 [![GitHub release](https://img.shields.io/github/v/release/Matysh/houseplan-card)](https://github.com/Matysh/houseplan-card/releases)
-[![GitHub stars](https://img.shields.io/github/stars/Matysh/houseplan-card)](https://github.com/Matysh/houseplan-card/stargazers)
 [![CI](https://github.com/Matysh/houseplan-card/actions/workflows/validate.yml/badge.svg)](https://github.com/Matysh/houseplan-card/actions)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Live demo](https://img.shields.io/badge/demo-try_it_live-00c853?logo=homeassistant&logoColor=white)](https://demo.houseplan.tech)
 [![Telegram chat](https://img.shields.io/badge/Telegram-chat-2CA5E0?logo=telegram&logoColor=white)](https://t.me/ha_houseplan)

-**Turn Home Assistant into a live, interactive map of your home.** Upload or draw
-a floor plan, outline the rooms with your mouse — and every smart device appears
-in its real place: live states, tap-to-toggle lights, temperature and humidity per
-room, Zigbee signal maps, glowing light pools and a fullscreen kiosk mode for wall
-tablets. No YAML, no Inkscape, no external editors — the whole floorplan lives
-right on your Lovelace dashboard.
+📘 **[Full user guide](docs/USER-GUIDE.md)** · 🇷🇺 **[Русский](README.ru.md)** · 🗂 **[Project issues](https://github.com/Matysh/houseplan-card/issues)**

-> **Use a desktop computer to edit plans.** View and kiosk are fully supported
-> on phones and tablets. The editors are designed primarily for a desktop
-> browser with a mouse and keyboard; individual editing operations on touch
-> devices may be awkward, limited, or unavailable.
+<!-- docs-section: overview -->

-![Interactive Home Assistant floor plan: live rooms, devices, lights and climate on a real floorplan card](docs/images/demo.gif)
+## Your whole home at a glance

-> ### 🚀 Try it live — no install needed
-> **[demo.houseplan.tech](https://demo.houseplan.tech)** — a real Home Assistant
-> with a ready-made plan. Log in as **`demo`** / **`demo`** and click anything:
-> toggle lights, open the editors, break things. The stand resets itself to a
-> pristine state every hour.
+House Plan turns Home Assistant into a live map of your home. Upload a plan or
+draw rooms directly on the dashboard, bind them to Home Assistant areas, and
+the area's devices appear automatically. You can immediately see where a light
+is on, a door is open, a room is too cold, Zigbee signal is weak, or a leak
+sensor has fired.

-🇷🇺 [Документация на русском](README.ru.md) · 💬 [Telegram chat: **@ha_houseplan**](https://t.me/ha_houseplan)
+![Synthetic home in View mode with rooms, devices, light and climate](docs/images/01-view-desktop.png)

-**Feature highlights**
+Setup is entirely graphical: no floor-plan YAML, Inkscape, or external editor.
+Plan data and device positions live on the Home Assistant server and stay in
+sync across screens.

- ♾️ **An infinite canvas** — there is no "plan size" and no edge to run
-  past: draw and place devices anywhere, pan at any zoom, zoom out to see
-  everything, and let one tap fit the whole plan back on screen.
- 🖱 **GUI-first floorplan editor** — rooms, doors & windows, island rooms,
-  virtual walls and a visual decor layer, all drawn with clicks; room resize
-  by dragging walls, with live lengths and areas as you drag; smart
-  alignment guides and a live ruler in real meters/feet.
- 🖼 **A backdrop you can move and scale** — drag the floor-plan picture into
-  place and pull a corner to size it, with its real size in metres shown as
-  you drag, so the drawing and the photo of your plan finally line up.
- 💡 **Lights toggle on click** out of the box; wall-switch markers can control
-  whole groups of lights (works for dumb switches and stateless remotes too).
- 🌒 **“Light sources” fill** — a dark house where every lit lamp lights exactly
-  the floor it can see: through doorways and open boundaries, stopped by walls,
-  columns and partitions, which cast real shadows.
- ☀️ **The sun on the plan** — set the compass and the backdrop lives with
-  the day (white noon → golden hour → deep night), while windows on exterior
-  walls cast real wedges of sunlight into the rooms; optional cloud cover
-  from a weather entity.
- 🪟 **Curtains and blinds open on a tap** — one action opens, closes or
-  stops a cover, and the icon itself morphs between open and closed while a
-  soft ring pulses as it travels.
- 🌡 **Room cards** with temperature, humidity, Zigbee LQI and light count;
-  comfort-range temperature fills, per-room signal heatmap.
- 🚪 **Doors, windows and locks** with contact sensors — unlocking is always an
-  explicit button, never an accidental tap.
- 📺 **Kiosk mode** for wall tablets and TVs: fullscreen, swipe between floors,
-  auto-carousel, per-screen icon sizes.
- 🤖 **Live robot vacuums** — the dock marker stays put while a round puck
-  drives the plan in real time, pouring its path out from under itself;
-  current and previous cleanup runs are recorded server-side. Calibration is
-  one click (rooms matched by name) or a drag-and-stretch overlay. A diagnostic
-  source picker also covers registry-less map cameras without silently
-  rebinding broken sources. Works with Xiaomi Cloud Map Extractor, Tasshack
-  dreame-vacuum and Valetudo.
- 🔔 New devices appear automatically with a red “new” dot; the layout is stored
-  **server-side** — one shared plan for every user and screen, synced live.
+> **Edit on a desktop computer.** View and kiosk are fully supported on phones
+> and tablets. The editors are designed primarily for a mouse and keyboard;
+> individual touch editing operations may be awkward or unavailable. See the
+> exact [touch support contract](docs/TOUCH-SUPPORT.md).

---
+<!-- docs-section: features -->

-## What it is and why
+## What House Plan provides

-House Plan shows your smart home the way it actually looks — on a floor plan. Instead of long lists of entities, you see rooms and devices in their real places: where the leak is, what the temperature is in the kids' room, whether the light is on in the hallway, whether the gate is open.
+- **Live state and safe actions.** Lights and other safe devices can toggle from
+  the plan; a lock cannot be opened by an accidental plan tap.
+- **Three built-in editors.** Plan creates rooms, walls and openings; Device
+  places and configures markers; Background adds lines, labels and furniture.
+- **Area-aware rooms.** New devices appear automatically, while room cards can
+  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.
+- **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,
+  and a separate initial floor for each card.
+- **Wall-display kiosk.** A plan-only view with fullscreen navigation and icon
+  sizes saved for that display.

-This is convenient when:
+![The same synthetic home in touch View mode](docs/images/02-view-touch.png)

- you have many devices and lists are awkward to use;
- you need to grasp the state of the house "at a glance";
- you want to give access to family members — anyone can figure out a picture;
- you want a beautiful overview screen for a wall-mounted tablet.
+<!-- docs-section: first-run -->

-The integration consists of two parts that are installed together:
+## Your first working room

- **the Lovelace card** `houseplan-card` — the interactive plan itself;
- **the server-side component** — stores the room markup and icon positions in Home Assistant, so the plan is identical in all browsers and on all devices.
+1. Install the integration and add the card to a dashboard.
+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.
+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
+   markers to the correct positions.
+6. Optionally use Background for lines, text and furniture.
+7. Return to View. The plan now displays live state and accepts safe actions.

---
+![Creating the first space](docs/images/03-space-create.png)

-## How it differs from alternatives
+![Closing a room outline on its first point](docs/images/04-room-contour-close.png)

-A house plan in Home Assistant is usually built with `picture-elements`,
-`ha-floorplan`, or newer GUI cards that draw walls and furniture in the
-dashboard. Those either lock you into YAML/SVG, or store the plan in the
-Lovelace card config. House Plan is a **shared live map** backed by a Home
-Assistant integration:
+![A selected partition and the Plan context tray](docs/images/05-plan-context-tray.png)

-| | House Plan | picture-elements / ha-floorplan | GUI draw cards (e.g. easy-floorplan) |
-|---|---|---|---|
-| **Setup** | Entirely through the UI, with the mouse | Manual YAML / Inkscape SVG | In-card drawing of walls & furniture |
-| **Adding devices** | Automatic, by HA **area** | You type every entity by hand | Place entities by hand on the drawing |
-| **Icon coordinates** | Drag with the mouse | Count pixels into YAML | Drag on the canvas |
-| **Room markup** | Built-in outline editor bound to areas | External SVG editor | Draw walls yourself (furniture CAD) |
-| **Storage** | On the HA server (`.storage`, shared, multi-client) | In the dashboard YAML | In the card / dashboard YAML |
-| **Overlays** | Glow, climate, LQI, sun, vacuums, kiosk | Whatever you script in SVG/CSS | Varies by card |
-| **Zoom** | Smooth vector zoom | Usually a fixed image | SVG / virtual canvas |
+![Device settings with binding provenance and the exact action result](docs/images/06-device-editor.png)

-**One sentence:** House Plan is the shared, area-aware live map of your home —
-not a general-purpose CAD package. Its Background editor covers practical
-decor, labels and furniture; if you need unrestricted architectural drafting,
-a draw-centric tool may fit better. With a plan and HA areas, House Plan keeps
-every tablet on the same live layout.
+![Live presentation preview for the same device](docs/images/06-device-display-preview.png)

-Key advantages in short:
+Every workflow and edge case is in the [full user guide](docs/USER-GUIDE.md).
+The [Background editor contract](docs/DECOR-EDITOR.md) and
+[vacuum guide](docs/VACUUM.md) are the authorities for those subsystems.

- **No code at all.** Everything — spaces, rooms, devices — is configured with clicks.
- **Automatic device placement.** Outline a room and bind it to a Home Assistant area — the devices of that area appear on the plan by themselves.
- **Manual additions of your own.** Any device, group or even a "virtual" point can be placed on the plan manually, with a name, icon, model, link and an attached PDF manual.
- **Live states.** Temperature, Zigbee signal strength, on/off, open/closed — everything updates in real time.
-  Icon colors follow one principle — **yellow means the device is doing its main job right now**:
-  a light is shining, a socket is powering, a fan is spinning, a vacuum is
-  cleaning, a radiator valve is actually heating (not merely enabled). For climate integrations,
-  a reported work action is authoritative; when an integration exposes only its enabled HVAC mode,
-  that mode is the best available fallback. Orange = open / unlocked.
-  A pulsing red ring = an emergency (leak, smoke, gas). An RGB bulb's colour lives in its glow
-  spot (glow fill), where the spot itself is the on/off indicator and the badge stays standard.
-  A translucent icon = unavailable. Dark = idle.
- **A coherent visual Background editor.** Draw lines/shapes, place labels and
-  furniture, edit physical styles and transform every object with the same
-  selection model. The plan image has its own move/resize/rotate tool, numeric
-  properties and shared Undo/Redo.
- **Crisp zoom.** Zooming in does not "blur" the picture: the plan, labels and icons remain vector-sharp at any scale.
-
---
-
-## Wall tablet / TV (kiosk mode)
-
-Add the card to a dedicated dashboard with a **panel view** and set `kiosk: true`
-(or tick "Wall device (kiosk) mode" in the card editor):
-
-```yaml
-type: custom:houseplan-card
-kiosk: true
-cycle: 0   # seconds between auto space switches, 0 = off (nice for TVs)
-```
-
-No header, no editors — just the live plan. Swipe to change floors (at 1:1),
-pinch to zoom, double-tap to reset. Long-press an empty spot for 3 seconds to
-tune icon and text sizes for THIS screen (saved per device). To hide Home
-Assistant's own header use the companion app's kiosk settings or the
-[kiosk-mode](https://github.com/NemesisRE/kiosk-mode) plugin.
+<!-- docs-section: installation -->

 ## Installation

-One click if you already run HACS:
+### HACS

-[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Matysh&repository=houseplan-card&category=integration)
+[![Open the repository in HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Matysh&repository=houseplan-card&category=integration)

+House Plan is in the HACS default catalog — no custom repository needed.

-### Via HACS (recommended)
-
-1. Open **HACS → menu (⋮) → Custom repositories**.
-2. Paste the URL of this repository, set the category to **Integration**, and click **Add**.
-3. Find **House Plan** in the list, install it and **restart Home Assistant**.
-4. Go to **Settings → Devices & Services → Add integration** and select **House Plan**.
-
-The card is registered automatically — no need to add a Lovelace resource manually.
-
-> **Card doesn't load (`Custom element doesn't exist: houseplan-card`) or you manage Lovelace
-> resources in YAML?** Add the resource manually pointing at the URL the integration *serves*:
->
-> ```yaml
-> resources:
->   - url: /houseplan_files/houseplan-card.js
->     type: module
-> ```
->
-> Do **not** use `/custom_components/houseplan/frontend/houseplan-card.js` — that is the file
-> on disk, which Home Assistant does not serve over HTTP (you'll get a `text/plain` MIME error
-> and the element never registers). The correct, integration-served URL is
-> `/houseplan_files/houseplan-card.js`. Both cards (`houseplan-card` and
-> `houseplan-space-card`) ship in that one file — no separate resource is needed.
-
-### Manually
-
-1. Copy the `custom_components/houseplan` folder into the `config/custom_components` directory of your Home Assistant.
+1. In HACS search for **House Plan** and install it.
 2. Restart Home Assistant.
-3. Add the integration: **Settings → Devices & Services → Add integration → House Plan**.
+3. Open **Settings → Devices & services → Add integration → House Plan**.

-### Adding a plan screen
+The card is registered automatically. If you manage Lovelace resources
+manually, use the URL served by the integration:

-Create a new dashboard tab (a "Panel" view works best) and add the card:
+```yaml
+resources:
+  - url: /houseplan_files/houseplan-card.js
+    type: module
+```
+
+Do not use the on-disk path inside `custom_components`; Home Assistant does not
+serve that path as a JavaScript module.
+
+### Manual installation
+
+Copy `custom_components/houseplan` to `config/custom_components`, restart Home
+Assistant, and add the House Plan integration.
+
+### Add the card
+
+Create a dashboard view (Panel works best) and add the card in the UI or as:

 ```yaml
 type: custom:houseplan-card
 title: House plan
 ```

-Nothing else needs to be specified — everything else is configured right on the screen.
+Different screens may start on different spaces:

---
+```yaml
+type: custom:houseplan-card
+default_floor: ground
+```

-## How to use
+All cards share server-side rooms and coordinates. Current mode, viewport and
+selected space remain local to the screen. Revision checks and live sync cover
+concurrent clients, but avoid editing the same object in two browsers at once.

-### Step 1. Add a space (floor)
+## Detailed documentation

-On first open the plan is still empty — House Plan immediately offers to create the first space.
-If your Home Assistant already has **floors** configured, a wizard offers to create a space
-for each floor (names prefilled, a plan image is asked for one by one; any floor can be skipped).
+- [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)
+- [Background editor](docs/DECOR-EDITOR.md)
+- [Robot vacuums](docs/VACUUM.md)
+- [Touch support](docs/TOUCH-SUPPORT.md)

-![Empty plan — prompt to add a space](docs/images/02-onboarding-empty.png)
+<!-- docs-section: support -->

-In the dialog, set a **name** (for example, "1st floor") and pick the background: **upload** a floor-plan image (SVG, PNG, JPG, WebP), **choose one already uploaded** to the server earlier, or select **"no background, I'll draw the rooms"** for a hand-drawn space. The canvas is infinite; an image keeps its own proportions by default and can be moved, resized or rotated at any time in the Background editor.
+## Support and feedback

-![Space creation dialog](docs/images/03-space-dialog.png)
+- Questions and plan examples: [Telegram @ha_houseplan](https://t.me/ha_houseplan).
+- Bugs and proposals: [GitHub Issues](https://github.com/Matysh/houseplan-card/issues).
+- Before reporting, update House Plan, restart HA and hard-refresh the page.
+  Include the version, browser, logs and reproduction steps; private entity IDs
+  may be replaced with fictional ones.

-> 💡 You can draw the background in any floor planner (for example, REMPLANNER) or photograph a paper plan. SVG works best — it stays crisp when zoomed in.
+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).

-Later you can add as many spaces as you like (floors, yard, garage) with the **＋** button next to the tabs.
-
-### Step 2. Outline the rooms
-
-After the first space is added, the card switches to the **Plan** tab by itself. The card has three mode tabs in the header — **View** (default: display and device control only, nothing can be moved or edited), **Plan** (rooms, openings, labels, space settings) and **Devices** (placing and configuring markers); the edit tabs are shown to administrators. In Plan, click grid points, connecting them with lines, and close the room outline by clicking the first point.
-
-As soon as the outline is closed, the room-save dialog appears. Here you need to **bind the room to a Home Assistant area** — this is exactly what enables the automation. For utility rooms with no devices (hall, sauna) there is a **"No area"** button.
-
-![Marking up a room and saving it](docs/images/05-room-dialog.png)
-
-While drawing, a ruler follows the cursor showing the current segment's real length (metres, or feet + inches on an imperial Home Assistant). The scale is set per space — the **"Scale (grid cell size)"** field in the space dialog says how many centimetres one grid cell represents (default 5 cm).
-
-Rooms may not overlap: a click strictly inside an existing room, or an outline that would swallow one, is refused. Two more tools help you reshape the plan later:
-
- **Merge** — click a room, then a neighbour that shares a wall; they fuse into one. A dialog picks which name and area survive.
- **Split** — click a room, then two points on its walls; the chord cuts it in two. The bigger part stays the room it was (name, area, devices); the smaller one asks for a new name and area.
-
-
-### Doors, windows, gates and locks
-
-In markup mode the **"Opening"** tool places doors, windows and gates: click next to a wall and the
-opening snaps onto it. Pick the type, the **length in real centimetres** (defaults: door 90 cm,
-window 120 cm, gate 300 cm), an open/close sensor and — for doors and gates — a **lock entity**.
-
-With a sensor bound, the plan comes alive: the door leaf swings on its hinge and the swing arc
-draws itself in as the real door opens; a window opens its two casements. While open, the moving
-parts take an accent colour. A gate keeps a 3–4 m opening compact on the plan: two half-width
-leaves open only 10° outwards, without a full-width swing arc, while contact, lock and light
-passage work exactly like a door. A door or gate with a lock shows a padlock badge next to it — green when
-locked, orange when unlocked. For safety the lock can **not** be toggled from the plan; a click
-on the opening shows a status card with both states instead.
-
-Openings are easy to adjust later: hovering one highlights it, you can **drag it along the
-walls** (it slides around corners too), and a **double click opens its properties**.
-
-### Step 3. Devices appear by themselves
-
-As soon as you save a room bound to an area, **the devices of that area are automatically laid out inside the outline**. These are the same devices shown on the **Settings → Devices → (filtered by the room)** page — only the meaningful ones, without service records, bridges and duplicates.
-
-By default only meaningful devices make it onto the plan: non-physical ones (service records, bridges, scenes, individual lamps folded into a light group) arrive with the **"Hide device from plan"** checkbox already ticked. The checkbox is yours from then on — every device dialog has it, virtual devices included. To see and un-hide them, open the device editor and press **"Hidden and disabled"**: user-hidden devices appear as translucent blue ghosts, a click opens the dialog. Hidden devices still count toward the room's Zigbee signal, but cast no light. A device disabled in Home Assistant appears there as a labelled grey service ghost and is excluded from all plan data/actions until it is enabled in HA again.
-
-From here on you can just use the plan: clicking an icon opens the device card with the model, link and a button to jump into Home Assistant.
-
-![Device card on click](docs/images/08-info.png)
-
-### Step 4. Zoom
-
-The mouse wheel or the **－ / ⊹ / ＋** buttons zoom the plan in and out; on a touch screen the two-finger pinch works. Zoomed out you see the whole plan, zoomed in you see the details, and everything stays crisp. The zoom level is remembered separately for each space.
-
-![Zoomed-in plan — everything stays crisp](docs/images/09-zoom.png)
-
-### Step 5. Put the icons in their places
-
-Switch to the **Devices** tab to arrange icons: drag them with the mouse, click one to open its editor. In **View** mode nothing can be moved — panning the map never displaces a sensor (a top user request). Positions are saved on the server and are identical in all browsers and devices. The **↺** button restores the automatic layout.
-
-![Dragging icons — available at all times](docs/images/06-edit.png)
-
-### Tap actions: control devices from the plan
-
-By default a tap on an icon opens its info card. A device can instead use the
-universal **Toggle state** action. Its editor shows the exact entity or configured
-group, the current state and what the next tap will do; when nothing can be toggled,
-it says so and the tap is a quiet no-op rather than an unexpected info-card fallback.
-Lights keep their convenient toggle default. Covers and valves use open/close/stop
-semantics automatically, while locks, alarm panels and secure garage/door/gate covers
-remain blocked. An exact entity binding never falls through to a sibling switch, and
-temporarily unavailable group members are skipped without erasing the configuration.
-A **long press** still opens the info card and right-click still opens HA more-info.
-
-### Icon rules
-
-Which MDI icon a device gets is decided by **icon rules** — editable right in the card
-(the ⬡ button in the header): an ordered list of “name pattern → icon” regexes with a
-live test field, bilingual defaults (EN/RU) and a one-click reset. When no rule
-matches, the entity *device class* decides (thermometer for temperature sensors, etc.).
-
-### Step 6. Adding your own devices manually
-
-You can also place a **single entity** (not just a whole device): start typing in the binding search and individual entities appear next to devices — handy when one device exposes several values (e.g. temperature and humidity) and you want each as its own icon.
-
-
-Not everything has to be left to the automation. With the **＋** button in the header you can place any device, group or a **virtual point** on the plan (for example, an "Inlet valve" that does not exist as a device). Set a name, icon, model, link, description and, if you wish, attach a **PDF manual**.
-
-To represent a dumb physical lamp controlled by a smart relay, place a virtual
-point where the lamp really is and set **Light source → Always**. Manual colour,
-brightness and radius stay available even though the point has no HA entity.
-Then open the relay and add that plan source under **Controls other light
-sources**. The relay continues to show the aggregate working state, while Glow,
-room fill and statistics belong to the lamp's position. An unlinked passive
-Always source is deliberately constant-on. With several own `light.*`/`switch.*`
-entities, Always also offers a leading-entity selector; a missing saved choice
-is warned about and retained while a deterministic fallback is used.
-
-To make that virtual lamp manually switchable without creating a Home
-Assistant helper, also choose **Tap action → Toggle state** on the lamp itself.
-This exact combination — virtual binding, **Light source → Always**, and
-**Toggle state** — stores a shared on/off state in the House Plan integration.
-It survives page reloads and Home Assistant restarts and updates Glow, room
-fill/statistics, full cards and `houseplan-space-card` together. Any signed-in
-dashboard viewer may toggle it. While this manual mode is active, saved
-**Controls other light sources** remain intact but are not called; changing the
-role, binding or tap action restores their normal behaviour. This operational
-state is deliberately not part of plan exports or Home Assistant entities.
-
-The same dialog controls how the device looks on the plan. **Display** switches between the
-icon badge, an animated **presence ripple** (pulsing rings while the entity is active, a faint
-dot when idle — great for motion sensors) or both, with a per-device ring colour and size. The
-**icon size** (×0.5–3) and **rotation** are also per-device, so a wall valve can be small and
-turned the way it is mounted.
-
-![Adding a device manually](docs/images/07-marker-dialog.png)
-
-### Styling the plan with card-mod (advanced, unsupported)
-
-The card ships finished and has no CSS field of its own — but if you already run [card-mod](https://github.com/thomasloven/lovelace-card-mod), every object on the plan now carries a stable hook you can aim at: `data-hp="device"` (plus `data-entity`, `data-area`), `data-hp="room"`, `data-hp="opening"`, `data-hp="decor"`, `data-hp="room-label"`, `data-hp="space-tab"`. We promise not to rename them; we do not ship card-mod, do not support it, and are not responsible for what your CSS does to the card. The full table, the examples and the limits are in **[docs/STYLING-HOOKS.md](docs/STYLING-HOOKS.md)**.
-
---
-
-## Uninstalling
-
-1. Remove the card (or the tab with the plan) from the dashboard.
-2. **Settings → Devices & Services → House Plan → Delete** the integration entry.
-3. Remove the integration from **HACS** (or delete the `custom_components/houseplan` folder if installed manually) and restart Home Assistant.
-4. Optionally delete the saved plan data: the `config/houseplan/` files (backgrounds and attachments) and the `houseplan.config` / `houseplan.layout` entries in the `config/.storage` directory.
-
---
-
-## Getting help & sharing your plan
-
- 💬 **[Telegram chat — @ha_houseplan](https://t.me/ha_houseplan)** — questions,
-  setup help, feature ideas, and screenshots of your plans. The fastest way to
-  reach the author and other users.
- 🐞 [GitHub issues](https://github.com/Matysh/houseplan-card/issues) — bug
-  reports and feature requests (please attach your House Plan version).
- 💡 [GitHub discussions](https://github.com/Matysh/houseplan-card/discussions) —
-  longer-form ideas.
- 📜 [Changelog](docs/CHANGELOG.md) — what changed in every version
-  ([на русском](docs/CHANGELOG.ru.md)).
-
-When reporting a problem, the version number helps a lot: it is shown in the
-browser console on load (`HOUSEPLAN-CARD vX.Y.Z`) and in **Settings → Devices &
-Services → House Plan**.
-
---
-
-## Frequently asked questions
-
-**Do I need to write anything in YAML?** No. The only line is adding the card to the dashboard; everything else is done with the mouse.
-
-**My devices did not appear on the plan.** A device appears only if its Home Assistant area is bound to a drawn room. Check that the device has a room assigned (Settings → Devices) and that the room is outlined and bound to that area. Open the device editor and press **"Hidden and disabled"**: a blue ghost is user-hidden and can be shown; a grey disabled ghost must first be enabled in Home Assistant.
-
-**Can I hide an unwanted device or rename it?** Yes — click the device on the plan and press "Edit" in its card: there you can change the name, icon, model or hide the icon.
-
-**Is the data stored in the cloud?** No. Everything is stored locally in your Home Assistant.
-
---
-
-<p align="center"><sub>Screenshots were taken on a real Home Assistant configuration.</sub></p>
+License: [MIT](LICENSE).
@@ -1,351 +1,163 @@
-# 🏠 House Plan — интерактивный поэтажный план дома для Home Assistant
+# 🏠 House Plan — живой план дома для Home Assistant

-[![HACS Custom](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://github.com/hacs/integration)
+[![HACS Default](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
 [![GitHub release](https://img.shields.io/github/v/release/Matysh/houseplan-card)](https://github.com/Matysh/houseplan-card/releases)
-[![GitHub stars](https://img.shields.io/github/stars/Matysh/houseplan-card)](https://github.com/Matysh/houseplan-card/stargazers)
+[![CI](https://github.com/Matysh/houseplan-card/actions/workflows/validate.yml/badge.svg)](https://github.com/Matysh/houseplan-card/actions)
 [![Live demo](https://img.shields.io/badge/демо-попробовать-00c853?logo=homeassistant&logoColor=white)](https://demo.houseplan.tech)
 [![Telegram chat](https://img.shields.io/badge/Telegram-чат-2CA5E0?logo=telegram&logoColor=white)](https://t.me/ha_houseplan)

-📘 **[Полное руководство пользователя](docs/USER-GUIDE.ru.md)** · 🗂 **[Беклог проекта](https://github.com/users/Matysh/projects/1)**
+📘 **[Полное руководство](docs/USER-GUIDE.ru.md)** · 🇬🇧 **[English](README.md)** · 🗂 **[Задачи проекта](https://github.com/Matysh/houseplan-card/issues)**

-**Превратите Home Assistant в живую интерактивную карту дома.** Загрузите или
-нарисуйте план этажа, обведите комнаты мышкой — и умные устройства появятся на
-своих местах: живые состояния, свет по клику, температура и влажность по
-комнатам, карта Zigbee-сигнала, светящиеся пятна ламп и полноэкранный
-киоск-режим для настенного планшета. Без YAML, без Inkscape и внешних
-редакторов — весь план настраивается прямо на дашборде.
+<!-- docs-section: overview -->

-> **Редактировать планы рекомендуется на компьютере.** Режим просмотра и
-> киоск полноценно поддерживаются на телефонах и планшетах. Редакторы рассчитаны
-> прежде всего на desktop с мышью и клавиатурой: на touch-устройстве отдельные
-> операции могут быть менее удобны, работать ограниченно или отсутствовать.
+## Дом целиком — одним взглядом

-![Интерактивный план дома для Home Assistant: комнаты, устройства, свет и климат на реальном поэтажном плане](docs/images/demo.gif)
+House Plan превращает Home Assistant в живую карту дома. Загрузите изображение
+плана или нарисуйте комнаты прямо на дашборде, свяжите их с зонами Home
+Assistant — и устройства появятся на плане автоматически. Сразу видно, где
+горит свет, открыта дверь, слишком холодно, слабый Zigbee-сигнал или сработал
+датчик протечки.

-> ### 🚀 Попробовать вживую — без установки
-> **[demo.houseplan.tech](https://demo.houseplan.tech)** — настоящий Home
-> Assistant с готовым планом. Вход **`demo`** / **`demo`**, можно нажимать всё:
-> включать свет, открывать редакторы, ломать что угодно. Каждый час стенд сам
-> возвращается в исходное состояние.
+![Синтетический дом в режиме просмотра: комнаты, устройства, свет и климат](docs/images/01-view-desktop.png)

-🇬🇧 [Documentation in English](README.md) · 💬 [Чат в Telegram: **@ha_houseplan**](https://t.me/ha_houseplan)
+Настройка выполняется в графическом интерфейсе: без YAML-разметки, Inkscape и
+внешнего редактора плана. Данные плана и расположение устройств хранятся на
+сервере Home Assistant и синхронизируются между экранами.

-**Главное**
+> **Редактируйте на компьютере.** Режим просмотра и киоск полноценно работают
+> на телефонах и планшетах. Редакторы рассчитаны прежде всего на мышь и
+> клавиатуру; на touch отдельные операции могут быть неудобны или недоступны.
+> Подробный контракт: [поддержка touch](docs/TOUCH-SUPPORT.md).

- ♾️ **Бесконечный холст** — нет «размера плана» и нет края, за который
-  нельзя выйти: рисуйте и ставьте устройства где угодно, тащите план на
-  любом зуме, отдаляйтесь, чтобы увидеть всё, и одной кнопкой вписывайте
-  план обратно в экран.
- 🖱 **Редакторы прямо в карточке** — комнаты, двери, окна и ворота, комнаты-острова,
-  виртуальные стены и декор-слой рисуются кликами; размеры комнат меняются
-  перетаскиванием стен с живыми длинами и площадями; помощник выравнивания и
-  линейка в реальных метрах.
- 💡 **Свет переключается кликом** из коробки; значок выключателя может
-  управлять группой ламп (в т.ч. «тупые» выключатели и кнопки-пульты).
- 🌒 **Заливка «Свет по источникам»** — тёмный дом, где каждая горящая лампа
-  освещает ровно тот пол, который видит: через проёмы и открытые границы,
-  а стены, колонны и перегородки его не пропускают и дают настоящие тени.
- ☀️ **Солнце на плане** — задайте компас, и фон живёт вместе с днём
-  (белый полдень → золотой час → глубокая ночь), а окна внешних стен пускают
-  в комнаты настоящие клинья солнечного света; облачность — опционально, от
-  weather-сущности.
- 🪟 **Шторы открываются тапом** — одно действие открывает, закрывает или
-  останавливает штору, а сам значок морфится между открытым и закрытым
-  видом и мягко пульсирует кольцом, пока штора едет.
- 🌡 **Карточки комнат**: температура, влажность, Zigbee-сигнал, свет «1 из 3»;
-  температурная заливка по комфортным границам.
- 🚪 **Двери, окна и замки** с датчиками — отпирание только явной кнопкой,
-  никогда случайным тапом.
- 📺 **Киоск-режим** для настенных планшетов и ТВ: полноэкранно, свайп между
-  этажами, автокарусель, свои размеры на каждом экране.
- 🤖 **Роботы-пылесосы вживую** — маркер-база стоит на месте, а круглая
-  шайба ездит по плану в реальном времени, «выливая» путь из-под себя;
-  текущая и прошлая уборки хранятся на сервере. Калибровка — в один клик
-  (по именам комнат) или перетаскиванием призрака карты. Диагностика и явный
-  выбор источника поддерживают registry-less камеры карт и не подменяют молча
-  сломавшуюся привязку. Работают Xiaomi Cloud Map Extractor, dreame-vacuum
-  (Tasshack) и Valetudo.
- 🔔 Новые устройства сами появляются на плане с красной точкой; раскладка
-  хранится **на сервере HA** — один план для всех экранов, живая синхронизация.
+<!-- docs-section: features -->

---
+## Что умеет House Plan

+- **Живые состояния и безопасные действия.** Свет и другие безопасные устройства
+  переключаются с плана; замок нельзя открыть случайным нажатием.
+- **Три встроенных редактора.** «План» создаёт комнаты, стены и проёмы;
+  «Устройства» размещает и настраивает маркеры; «Подложка» добавляет линии,
+  подписи и мебель.
+- **Комнаты, связанные с зонами HA.** Новые устройства появляются автоматически,
+  а карточки комнат показывают температуру, влажность, свет и средний LQI.
+- **Свет и окружение.** Заливки комнат, Glow от ламп, тени от стен, дневной фон и
+  солнечные лучи из окон.
+- **Двери, окна, ворота и пылесосы.** Проёмы отражают реальные датчики и замки;
+  робот показывает позицию, базу и пройденный путь.
+- **Несколько этажей и экранов.** Вкладки пространств, жесты переключения,
+  локальный масштаб и отдельный стартовый этаж для каждой карточки.
+- **Киоск для настенного экрана.** Только план, полноэкранная навигация и размеры
+  значков, сохранённые отдельно для этого устройства.

-## Что это и зачем
+![Тот же синтетический дом в touch-режиме просмотра](docs/images/02-view-touch.png)

-House Plan показывает ваш умный дом так, как он выглядит на самом деле — на плане этажей. Вместо длинных списков сущностей вы видите комнаты и устройства на своих местах: где протечка, какая температура в детской, включён ли свет в прихожей, открыты ли ворота.
+<!-- docs-section: first-run -->

-Это удобно, когда:
+## Первая рабочая комната

- устройств много, и списками пользоваться неудобно;
- нужно быстро понять состояние дома «одним взглядом»;
- хочется отдать доступ близким — по картинке разберётся любой;
- вы хотите красивый обзорный экран для настенного планшета.
+1. Установите интеграцию и добавьте карточку на дашборд.
+2. Создайте первое **пространство**: загрузите SVG/PNG/JPG/WebP либо выберите
+   вариант без изображения, чтобы нарисовать план вручную.
+3. В редакторе «План» выберите **Контур комнаты**, поставьте вершины и замкните
+   контур нажатием на первую точку.
+4. Назовите комнату и свяжите её с зоной Home Assistant. Для помещения без
+   устройств выберите «Без зоны».
+5. Откройте «Устройства»: устройства связанной зоны уже размещены автоматически;
+   перетащите маркеры в нужные места.
+6. При необходимости оформите подложку линиями, текстом и мебелью.
+7. Вернитесь в «Просмотр» — теперь план показывает живые состояния и принимает
+   безопасные действия.

-Интеграция состоит из двух частей, которые ставятся вместе:
+![Создание первого пространства](docs/images/03-space-create.png)

- **карточка Lovelace** `houseplan-card` — сам интерактивный план;
- **серверный компонент** — хранит разметку комнат и позиции иконок в Home Assistant, поэтому план одинаков во всех браузерах и на всех устройствах.
+![Замыкание контура комнаты на первой точке](docs/images/04-room-contour-close.png)

---
+![Выбранная перегородка и контекстная панель редактора плана](docs/images/05-plan-context-tray.png)

-## Чем отличается от аналогов
+![Настройка устройства с источником привязки и точным результатом действия](docs/images/06-device-editor.png)

-Обычно план дома в Home Assistant делают через `picture-elements`, `ha-floorplan`
-или новые GUI-карточки, где стены и мебель рисуют прямо на дашборде. Там либо
-YAML/SVG, либо конфиг живёт в YAML карточки. House Plan — это **общий живой
-план** на серверной интеграции Home Assistant:
+![Живой предпросмотр отображения того же устройства](docs/images/06-device-display-preview.png)

-| | House Plan | picture-elements / ha-floorplan | GUI-рисовалки (напр. easy-floorplan) |
-|---|---|---|---|
-| **Настройка** | Полностью через интерфейс, мышкой | Ручной YAML / Inkscape SVG | Рисование стен и мебели в карточке |
-| **Добавление устройств** | Автоматически по **зоне** HA | Каждую сущность вписываете руками | Ставите сущности руками на чертёж |
-| **Координаты иконок** | Перетаскиваете мышью | Считаете пиксели в YAML | Drag на холсте |
-| **Разметка комнат** | Встроенный редактор контуров, привязка к зонам | Сторонний SVG-редактор | Сами рисуете стены (мебельный CAD) |
-| **Хранение** | На сервере HA (`.storage`, общее, multi-client) | В YAML дашборда | В карточке / YAML дашборда |
-| **Оверлеи** | Glow, климат, LQI, солнце, пылесосы, киоск | Что пропишете в SVG/CSS | Зависит от карточки |
-| **Масштаб** | Плавный векторный зум | Обычно фиксированная картинка | SVG / виртуальный холст |
+Пошаговые сценарии, все инструменты и особые случаи описаны в
+[полном руководстве](docs/USER-GUIDE.ru.md). Возможности подложки отдельно
+зафиксированы в [документе редактора](docs/DECOR-EDITOR.md), а роботов — в
+[руководстве по пылесосам](docs/VACUUM.md).

-**Одной фразой:** House Plan — это общая, area-aware живая карта дома, а не
-универсальная CAD-система. Редактор подложки покрывает практический декор,
-надписи и мебель; для свободного архитектурного черчения лучше отдельный
-draw-инструмент. При наличии плана и зон HA House Plan держит один живой layout
-на всех планшетах.
-
-Ключевые преимущества коротко:
-
- **Никакого кода.** Всё — пространства, комнаты, устройства — настраивается кликами.
- **Автоматическое добавление устройств.** Обвели комнату и привязали её к зоне Home Assistant — устройства этой зоны сами появляются на плане.
- **Ручное добавление своих.** Любое устройство, группу или даже «виртуальную» точку можно поставить на план вручную, задать имя, иконку, модель, ссылку и приложить PDF-инструкцию.
- **Живые состояния.** Температура, уровень сигнала Zigbee, вкл/выкл, открыто/закрыто — всё обновляется в реальном времени.
-  Цвета значков подчиняются одному принципу — **жёлтый значит «устройство прямо сейчас выполняет свою основную работу»**:
-  лампа светит, розетка подаёт, вентилятор крутится, пылесос убирает, термоголовка
-  реально греет (а не просто включена). Для climate-сущностей переданное действие приоритетно;
-  если интеграция сообщает только включённый HVAC-режим, он служит лучшим доступным приближением.
-  Оранжевый = открыто / не заперто. Пульсирующее красное
-  кольцо = авария (протечка, дым, газ). Цвет RGB-лампы живёт в её пятне света (режим glow),
-  где само пятно — индикатор включения, а подложка значка остаётся стандартной.
-  Полупрозрачный значок = недоступно. Тёмный = покой.
- **Единый визуальный редактор подложки.** Линии, фигуры, надписи и мебель используют общее выделение, физические стили и Undo/Redo. Картинка плана не прибита к холсту: отдельный инструмент двигает, масштабирует и поворачивает её, а числовой диалог задаёт точный размер и угол.
- **Чёткий зум.** Приближение не «мылит» картинку: план, подписи и иконки остаются векторно-чёткими на любом масштабе.
-
---
-
-## Настенный планшет / ТВ (киоск-режим)
-
-Отдельный дашборд с view типа «панель», у карточки — `kiosk: true` (или
-галочка «Режим настенного устройства» в редакторе карточки):
-
-```yaml
-type: custom:houseplan-card
-kiosk: true
-cycle: 0   # автосмена пространств каждые N секунд, 0 = выкл (удобно для ТВ)
-```
-
-Без шапки и редакторов — только живой план. Свайп листает этажи (при 1:1),
-пинч — зум, двойной тап — сброс. Долгое нажатие (3 с) по пустому месту —
-настройка размеров значков и текста для ЭТОГО экрана (хранится на
-устройстве). Шапку самого Home Assistant скрывают настройки companion-app
-или плагин [kiosk-mode](https://github.com/NemesisRE/kiosk-mode).
+<!-- docs-section: installation -->

 ## Установка

-В один клик, если у вас уже есть HACS:
+### Через HACS

-[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Matysh&repository=houseplan-card&category=integration)
+[![Открыть репозиторий в HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Matysh&repository=houseplan-card&category=integration)

+House Plan входит в основной каталог HACS — пользовательский репозиторий
+добавлять не нужно.

-### Через HACS (рекомендуется)
+1. Найдите **House Plan** в поиске HACS и установите.
+2. Перезапустите Home Assistant.
+3. Откройте **Настройки → Устройства и службы → Добавить интеграцию → House Plan**.

-1. Откройте **HACS → меню (⋮) → Custom repositories**.
-2. Вставьте URL этого репозитория, категория — **Integration**, и нажмите **Add**.
-3. Найдите в списке **House Plan**, установите и **перезапустите Home Assistant**.
-4. Перейдите в **Настройки → Устройства и службы → Добавить интеграцию** и выберите **House Plan**.
+Карточка регистрируется автоматически. Если ресурсы Lovelace управляются вручную,
+добавьте именно URL, который публикует интеграция:

-Карточка подключается автоматически — добавлять ресурс Lovelace вручную не нужно.
+```yaml
+resources:
+  - url: /houseplan_files/houseplan-card.js
+    type: module
+```

-> **Карточка не грузится (`Custom element doesn't exist: houseplan-card`) или вы ведёте ресурсы
-> Lovelace в YAML?** Добавьте ресурс вручную, указав URL, который *раздаёт сама интеграция*:
->
-> ```yaml
-> resources:
->   - url: /houseplan_files/houseplan-card.js
->     type: module
-> ```
->
-> **Не** используйте `/custom_components/houseplan/frontend/houseplan-card.js` — это путь к файлу
-> на диске, который Home Assistant не отдаёт по HTTP (получите ошибку MIME `text/plain`, и элемент
-> не зарегистрируется). Правильный URL, который раздаёт интеграция, — `/houseplan_files/houseplan-card.js`.
-> Обе карточки (`houseplan-card` и `houseplan-space-card`) лежат в этом одном файле — отдельный ресурс
-> не нужен.
+Не используйте путь к файлу внутри `custom_components`: Home Assistant не
+публикует его как JavaScript-модуль.

 ### Вручную

-1. Скопируйте папку `custom_components/houseplan` в каталог `config/custom_components` вашего Home Assistant.
-2. Перезапустите Home Assistant.
-3. Добавьте интеграцию: **Настройки → Устройства и службы → Добавить интеграцию → House Plan**.
+Скопируйте `custom_components/houseplan` в `config/custom_components`,
+перезапустите Home Assistant и добавьте интеграцию House Plan.

-### Добавление экрана с планом
+### Добавление карточки

-Создайте новую вкладку дашборда (удобнее всего — в режиме «Панель»/Panel) и добавьте карточку:
+Создайте представление дашборда (лучше Panel) и добавьте карточку через UI либо:

 ```yaml
 type: custom:houseplan-card
 title: План дома
 ```

-Больше ничего указывать не нужно — всё остальное настраивается прямо на экране.
+Для нескольких экранов можно задать разные стартовые пространства:

---
+```yaml
+type: custom:houseplan-card
+default_floor: ground
+```

-## Как пользоваться
+Все карточки используют общие серверные комнаты и координаты. Текущий режим,
+масштаб и выбранное пространство локальны для экрана. Одновременное
+редактирование поддерживает синхронизацию и проверку ревизий, но один объект
+лучше не менять параллельно в двух браузерах.

-### Шаг 1. Добавьте пространство (этаж)
+## Где искать подробности

-При первом открытии план ещё пуст — House Plan сразу предложит создать первое пространство.
+- [Полное руководство пользователя](docs/USER-GUIDE.ru.md)
+- [Матрица mouse/touch/keyboard](docs/USER-GUIDE.ru.md#6-навигация-масштаб-и-жесты)
+- [Инструменты плана](docs/USER-GUIDE.ru.md#инструменты-плана-в-короткой-таблице)
+- [Редактор подложки](docs/DECOR-EDITOR.md)
+- [Роботы-пылесосы](docs/VACUUM.md)
+- [Поддержка touch](docs/TOUCH-SUPPORT.md)

-Если в вашем Home Assistant уже настроены **этажи**, мастер предложит создать
-пространство для каждого: названия подставятся сами, план попросит по очереди,
-любой этаж можно пропустить.
+<!-- docs-section: support -->

-![Пустой план — предложение добавить пространство](docs/images/02-onboarding-empty.png)
+## Помощь и обратная связь

-В диалоге задайте **название** (например, «1 этаж») и выберите подложку: **загрузите** картинку плана (SVG, PNG, JPG, WebP), **возьмите уже загруженную** на сервер ранее или отметьте **«без подложки, нарисую комнаты сам»**. Холст бесконечный; картинка по умолчанию сохраняет пропорции, а подвинуть, изменить размер или повернуть её можно в любой момент в редакторе подложки.
+- Вопросы и примеры планов: [Telegram @ha_houseplan](https://t.me/ha_houseplan).
+- Баги и предложения: [GitHub Issues](https://github.com/Matysh/houseplan-card/issues).
+- Перед отчётом обновите House Plan, перезапустите HA и выполните жёсткое
+  обновление страницы (`Ctrl+F5`). Приложите версию, браузер, логи и шаги
+  воспроизведения; приватные entity ID можно заменить вымышленными.

-![Диалог создания пространства](docs/images/03-space-dialog.png)
+Скриншоты в документации получены воспроизводимой командой
+`npm run build && node demo/docs/capture.mjs` только на синтетических данных. Версия сценариев,
+fingerprint исходников и хеш каждого изображения находятся в
+[индексе снимков](docs/images/screenshots.json).

-> 💡 Подложку можно нарисовать в любом планировщике (например, РЕМПЛАННЕР) или сфотографировать бумажный план. Лучше всего SVG — он остаётся чётким при увеличении.
-
-Позже можно добавить сколько угодно пространств (этажи, двор, гараж) кнопкой **＋** рядом со вкладками.
-
-### Шаг 2. Обведите комнаты
-
-После добавления первого пространства карточка сама переходит в режим разметки. Кликайте по точкам сетки, соединяя их линиями, и замкните контур комнаты кликом по первой точке.
-
-Как только контур замкнётся, появится окно сохранения комнаты. Здесь нужно **привязать комнату к зоне Home Assistant** — именно это включает автоматику. Для служебных помещений без устройств (холл, сауна) есть кнопка **«Без зоны»**.
-
-![Разметка комнаты и её сохранение](docs/images/05-room-dialog.png)
-
-Во время рисования у курсора показывается линейка с реальной длиной текущего отрезка (метры или футы+дюймы на имперской системе HA). Масштаб задаётся для каждого пространства — поле **«Масштаб (размер ячейки сетки)»** в диалоге пространства: сколько сантиметров в одной ячейке (по умолчанию 5 см).
-
-Комнаты не могут пересекаться: клик строго внутри существующей комнаты или контур, охватывающий её, отклоняются. Ещё два инструмента помогают перекроить план позже:
-
- **Объединить** — кликните комнату, затем соседнюю с общей стеной; они сольются в одну. Диалог выбирает, чьё имя и зона останутся.
- **Разделить** — кликните комнату, затем две точки на её стенах; хорда разрежет её надвое. Бо́льшая часть остаётся прежней комнатой (имя, зона, устройства), меньшая просит новое имя и зону.
-
-
-### Двери, окна, ворота и замки
-
-В режиме разметки инструмент **«Проём»** ставит двери, окна и ворота: кликните рядом со стеной — проём
-примагнитится к ней. Выберите тип, **длину в реальных сантиметрах** (по умолчанию дверь 90 см,
-окно 120 см, ворота 300 см), датчик открытия и — для двери или ворот — **замок**.
-
-С привязанным датчиком план оживает: створка двери поворачивается на петле, и дуга распахивания
-дорисовывается по мере открытия настоящей двери; окно раскрывает две створки. Пока открыто,
-подвижные части подсвечены акцентным цветом. Ворота не занимают полплана даже при ширине 3–4 м: две половинные створки показаны открытыми наружу всего на 10°, без большой дуги. Датчик, замок и пропуск света работают как у двери. У двери или ворот с замком рядом отображается замочек —
-зелёный, когда заперто, оранжевый, когда нет. Ради безопасности замок с плана **нельзя**
-переключить — клик по проёму показывает карточку с обоими статусами.
-
-Проёмы легко поправить позже: при наведении проём подсвечивается, его можно **перетащить вдоль
-стен** (в том числе за угол), а **двойной клик открывает свойства**.
-
-### Шаг 3. Устройства появляются сами
-
-Как только вы сохранили комнату с привязкой к зоне, **устройства этой зоны автоматически расставляются внутри контура**. Берутся те же устройства, что показаны на странице **Настройки → Устройства → (фильтр по нужной комнате)** — только осмысленные, без служебных записей, мостов и дубликатов.
-
-По умолчанию на план попадают только осмысленные устройства: нефизические (служебные записи, мосты, сцены, лампы, свёрнутые в световую группу) могут быть скрыты автоматически. Управление находится в левом нижнем углу диалога устройства: **«Скрыть»** убирает маркер после сохранения, а у уже скрытого маркера там же появляется **«Показать»**. Чтобы найти их, откройте редактор устройств и нажмите **«Скрытые и деактивированные»**: пользовательски скрытые устройства отображаются синими призраками. Деактивированное в HA устройство показывается серым служебным призраком и полностью исключается из данных и действий плана до повторной активации.
-
-Дальше можно просто пользоваться планом: клик по иконке открывает карточку устройства с моделью, ссылкой и кнопкой перехода в Home Assistant.
-
-![Карточка устройства по клику](docs/images/08-info.png)
-
-### Шаг 4. Масштаб
-
-Колесо мыши или кнопки **－ / ⊹ / ＋** приближают и отдаляют план; на сенсорном экране работает «щипок» двумя пальцами. При отдалении виден весь план целиком, при приближении — детали, и всё остаётся чётким. Масштаб запоминается отдельно для каждого пространства.
-
-![Приближённый план — всё остаётся чётким](docs/images/09-zoom.png)
-
-### Шаг 5. Расставьте значки по местам
-
-Расставлять значки нужно на вкладке **«Устройства»**: там они перетаскиваются мышью, а клик открывает редактор. В режиме **«Просмотр»** ничего сдвинуть нельзя — панорамирование карты больше не сдвигает датчики (главная просьба пользователей). Позиции сохраняются на сервере и одинаковы во всех браузерах и устройствах. Кнопка **↺** возвращает автоматическую раскладку.
-
-![Перетаскивание значков — доступно всегда](docs/images/06-edit.png)
-
-### Управление с плана (tap actions)
-
-По умолчанию тап по значку открывает инфо-карточку. В настройках карточки можно
-переключить **«Тап по устройству»** на *Переключить* — тогда тап включает/выключает
-свет, розетки, вентиляторы и увлажнители прямо с плана (режим настенного планшета).
-Для безопасности общий toggle не действует на замки, сигнализации, шторы/ворота и
-клапаны; для конкретного устройства toggle можно включить осознанно в его диалоге
-(кроме замков и сигнализаций — они с плана не переключаются никогда). **Долгое
-нажатие** всегда открывает инфо-карточку.
-
-### Правила иконок
-
-Какая MDI-иконка достанется устройству, решают **правила иконок** — редактируются
-прямо в карточке (кнопка ⬡ в шапке): упорядоченный список «шаблон имени → иконка»
-с живым тест-полем, двуязычные умолчания (EN/RU) и сброс одной кнопкой. Если ни одно
-правило не подошло — решает *device class* сущности (термометр для датчиков
-температуры и т.п.).
-
-### Шаг 6. Добавление своих устройств вручную
-
-Можно поставить и **отдельную сущность** (не только устройство целиком): начните печатать в поиске привязки — рядом с устройствами появятся отдельные сущности. Удобно, когда одно устройство отдаёт несколько значений (например, температуру и влажность), а вы хотите каждое своей иконкой.
-
-
-Не всё нужно оставлять на автоматику. Кнопкой **＋** в шапке можно поставить на план любое устройство, группу или **виртуальную точку** (например, «Вентиль на вводе», которого нет как устройства). Задайте имя, иконку, модель, ссылку, описание и при желании приложите **PDF-инструкцию**.
-
-В этом же диалоге настраивается вид устройства на плане. **Отображение** переключает значок,
-анимированную **пульсацию присутствия** (расходящиеся кольца, пока сущность активна, и тусклая
-точка в покое — идеально для датчиков движения) или то и другое сразу, с цветом и размером колец
-на устройство. **Размер значка** (×0,5–3) и **поворот** — тоже индивидуальные: вентиль на стене
-может быть маленьким и повёрнутым так, как он установлен.
-
-![Добавление устройства вручную](docs/images/07-marker-dialog.png)
-
-### Свои стили через card-mod (для продвинутых, без поддержки)
-
-Карточка приезжает готовой, и поля для CSS у неё нет — но если у вас уже стоит [card-mod](https://github.com/thomasloven/lovelace-card-mod), у каждого объекта плана теперь есть стабильный «крючок», за который можно зацепиться: `data-hp="device"` (плюс `data-entity`, `data-area`), `data-hp="room"`, `data-hp="opening"`, `data-hp="decor"`, `data-hp="room-label"`, `data-hp="space-tab"`. Мы обещаем их не переименовывать; сам card-mod мы не поставляем, не поддерживаем и за то, что ваш CSS сделает с карточкой, не отвечаем. Полная таблица, примеры и ограничения — в **[docs/STYLING-HOOKS.md](docs/STYLING-HOOKS.md)**.
-
---
-
-## Удаление
-
-1. Уберите карточку (или вкладку с планом) из дашборда.
-2. **Настройки → Устройства и службы → House Plan → Удалить** запись интеграции.
-3. Удалите интеграцию из **HACS** (или папку `custom_components/houseplan` при ручной установке) и перезапустите Home Assistant.
-4. При желании удалите сохранённые данные плана: файлы `config/houseplan/` (подложки и вложения) и записи `houseplan.config` / `houseplan.layout` в каталоге `config/.storage`.
-
---
-
-## Помощь и обмен опытом
-
- 💬 **[Чат в Telegram — @ha_houseplan](https://t.me/ha_houseplan)** — вопросы,
-  помощь с настройкой, идеи и скриншоты ваших планов. Самый быстрый способ
-  связаться с автором и другими пользователями.
- 🐞 [Issues на GitHub](https://github.com/Matysh/houseplan-card/issues) — баги
-  и запросы фич (пожалуйста, указывайте версию House Plan).
- 💡 [Discussions](https://github.com/Matysh/houseplan-card/discussions) — для
-  развёрнутых обсуждений.
- 📜 [История изменений](docs/CHANGELOG.ru.md) — что менялось в каждой версии.
-
-Версия видна в консоли браузера при загрузке (`HOUSEPLAN-CARD vX.Y.Z`) и в
-**Настройки → Устройства и службы → House Plan** — с ней разбираться сильно
-быстрее.
-
---
-
-## Часто задаваемые вопросы
-
-**Нужно ли что-то писать в YAML?** Нет. Единственная строчка — это добавление карточки на дашборд; всё остальное делается мышкой.
-
-**Мои устройства не появились на плане.** Устройство появляется, только если его зона в Home Assistant привязана к нарисованной комнате. Проверьте, что у устройства задана комната (Настройки → Устройства), а комната обведена и привязана к этой зоне. Откройте **«Скрытые и деактивированные»**: синий призрак можно показать в его диалоге, серый сначала нужно активировать в Home Assistant.
-
-**Можно ли скрыть лишнее устройство или переименовать его?** Да — кликните по устройству на плане и в его карточке нажмите «Редактировать»: там можно сменить имя, иконку, модель или скрыть значок.
-
-**Данные хранятся в облаке?** Нет. Всё хранится локально в вашем Home Assistant.
-
---
-
-<p align="center"><sub>Скриншоты сделаны на реальной конфигурации Home Assistant.</sub></p>
+Лицензия: [MIT](LICENSE).
@@ -46,12 +46,12 @@ PLAN_ORPHAN_TTL_S = 3600
 SCHEDULED_GRACE_S = 30 * 24 * 3600
 FILES_DIR = "houseplan/files"
 CONF_ADMIN_ONLY = "admin_only"
-VERSION = "1.64.0"
+VERSION = "1.68.1"

 # Portable backup format.  This is deliberately independent from the Home
 # Assistant Store version above: storage migrations and files exported by a
 # user have different compatibility lifecycles.
-PLAN_MODEL_VERSION = 6
+PLAN_MODEL_VERSION = 9
 EXPORT_VERSION = 1
 MAX_EXPORT_BYTES = 8 * 1024 * 1024
 IMPORT_PREVIEW_TTL_S = 10 * 60
@@ -0,0 +1,180 @@
+"""Lossless, allow-listed canonicalisation of persisted geometry.
+
+The frontend mirrors this module in src/coordinate-canonicalization.ts.
+Keep the precision, lattice formula and field allow-list in lockstep; a shared
+fixture is exercised by both runtimes.
+"""
+from __future__ import annotations
+
+import copy
+import math
+from typing import Any
+
+
+COORDINATE_DECIMALS = 9
+COORDINATE_FACTOR = 10**COORDINATE_DECIMALS
+LATTICE_GRID_N = 240
+LATTICE_NOISE_STEPS = 1e-4
+
+
+def canonicalize_number(value: Any) -> Any:
+    """Return one stable IEEE-754 representation for an allow-listed scalar."""
+    if isinstance(value, bool) or not isinstance(value, (int, float)):
+        return value
+    number = float(value)
+    if not math.isfinite(number):
+        return value
+    sign = -1.0 if math.copysign(1.0, number) < 0 else 1.0
+    result = sign * (
+        math.floor(abs(number) * COORDINATE_FACTOR + 0.5)
+        / COORDINATE_FACTOR
+    )
+    if result == 0:
+        return 0.0
+    return result
+
+
+def canonicalize_lattice_coordinate(value: Any) -> Any:
+    """Collapse near-node noise while preserving authored off-grid values."""
+    if isinstance(value, bool) or not isinstance(value, (int, float)):
+        return value
+    number = float(value)
+    if not math.isfinite(number):
+        return value
+    scaled = number * LATTICE_GRID_N
+    # JavaScript Math.round: ties go toward +infinity, unlike Python round().
+    nearest = math.floor(scaled + 0.5)
+    if abs(scaled - nearest) < LATTICE_NOISE_STEPS:
+        result = nearest / LATTICE_GRID_N
+        return 0.0 if result == 0 else result
+    return canonicalize_number(number)
+
+
+def _record(value: Any) -> dict[str, Any] | None:
+    return value if isinstance(value, dict) else None
+
+
+def _records(value: Any) -> list[dict[str, Any]]:
+    if not isinstance(value, list):
+        return []
+    return [item for item in value if isinstance(item, dict)]
+
+
+def _scalar_fields(record: dict[str, Any], names: tuple[str, ...]) -> None:
+    for name in names:
+        if name in record:
+            record[name] = canonicalize_number(record[name])
+
+
+def _lattice_fields(record: dict[str, Any], names: tuple[str, ...]) -> None:
+    for name in names:
+        if name in record:
+            record[name] = canonicalize_lattice_coordinate(record[name])
+
+
+def _lattice_point(value: Any) -> None:
+    if not isinstance(value, list):
+        return
+    for index in range(min(2, len(value))):
+        value[index] = canonicalize_lattice_coordinate(value[index])
+
+
+def _lattice_points(value: Any) -> None:
+    if not isinstance(value, list):
+        return
+    for point in value:
+        _lattice_point(point)
+
+
+def canonicalize_position(position: Any) -> Any:
+    """Canonicalise lattice x/y in one layout record, preserving metadata."""
+    result = copy.deepcopy(position)
+    record = _record(result)
+    if record is not None:
+        _lattice_fields(record, ("x", "y"))
+    return result
+
+
+def canonicalize_layout_geometry(layout: Any) -> Any:
+    """Canonicalise lattice x/y in every layout record."""
+    result = copy.deepcopy(layout)
+    record = _record(result)
+    if record is None:
+        return result
+    for position in record.values():
+        item = _record(position)
+        if item is not None:
+            _lattice_fields(item, ("x", "y"))
+    return result
+
+
+def canonicalize_config_geometry(config: Any) -> Any:
+    """Canonicalise only the named persisted geometry fields."""
+    result = copy.deepcopy(config)
+    root = _record(result)
+    if root is None:
+        return result
+
+    for space in _records(root.get("spaces")):
+        _scalar_fields(
+            space,
+            (
+                "plan_x",
+                "plan_y",
+                "plan_scale",
+                "plan_scale_x",
+                "plan_scale_y",
+                "plan_angle",
+            ),
+        )
+
+        for room in _records(space.get("rooms")):
+            _lattice_fields(room, ("x", "y", "w", "h"))
+            _lattice_points(room.get("poly"))
+
+        for wall in _records(space.get("walls")):
+            _lattice_point(wall.get("a"))
+            _lattice_point(wall.get("b"))
+
+        for segment in _records(space.get("wall_segments")):
+            _lattice_point(segment.get("a"))
+            _lattice_point(segment.get("b"))
+
+        for opening in _records(space.get("openings")):
+            _lattice_fields(opening, ("x", "y"))
+            _scalar_fields(opening, ("angle", "length"))
+            host = _record(opening.get("host"))
+            if host is not None:
+                _scalar_fields(host, ("t",))
+
+        for decor in _records(space.get("decor")):
+            kind = decor.get("kind")
+            if kind == "line":
+                _lattice_fields(decor, ("x1", "y1", "x2", "y2"))
+            elif kind in ("rect", "ellipse", "furniture"):
+                _lattice_fields(decor, ("x", "y", "w", "h"))
+                _scalar_fields(decor, ("angle",))
+            elif kind == "text":
+                _lattice_fields(decor, ("x", "y"))
+                _scalar_fields(decor, ("scale", "angle"))
+
+        for draft in _records(space.get("room_drafts")):
+            _lattice_points(draft.get("points"))
+
+        for partition in _records(space.get("partitions")):
+            _lattice_point(partition.get("a"))
+            _lattice_point(partition.get("b"))
+
+        for column in _records(space.get("wall_columns")):
+            _lattice_point(column.get("center"))
+            if column.get("shape") == "square":
+                _scalar_fields(column, ("angle",))
+
+        for span in _records(space.get("open_spans")):
+            _lattice_point(span.get("a"))
+            _lattice_point(span.get("b"))
+
+    for marker in _records(root.get("markers")):
+        _scalar_fields(marker, ("angle",))
+
+    return result
@@ -0,0 +1,316 @@
+"""Issue #329 — wall junction limits, Python mirror of src/junction-limits.ts.
+
+The card refuses a WRITE that would ADD a junction violation; this module is
+the backend half of that contract, so a stale or hostile client cannot post
+what the editor refuses. It mirrors П1–П4 exactly, including the two legal
+incidences of П4 (a shared node and a T-joint into the middle of a foreign
+wall) and the П3 rule that measures the collinear same-thickness WALL RUN
+rather than one catalogue atom.
+
+П5 (the room keeps at least 25 cm² of interior) is deliberately NOT mirrored:
+it is a statement about the rendered wall bodies, and reproducing the mitre /
+inset pipeline in Python would be a second geometry implementation whose drift
+is a larger risk than the rule it guards. A document that violates only П5 is
+ugly, not corrupt — see docs/specs/329-junction-limits.md §5.
+"""
+
+from __future__ import annotations
+
+import math
+
+from .wall_segment_model import commit_wall_segment_model
+
+MIN_JUNCTION_ANGLE_DEG = 15.0
+MAX_JUNCTION_VALENCE = 6
+MIN_SEGMENT_LENGTH_CM = 20.0
+MIN_NODE_DISTANCE_CM = 5.0
+
+GRID_STEP_N = 1 / 240
+
+_EPS = 1e-9
+# Below this a node is ON the wall (T-joint), not near it.
+_INCIDENT_EPS = 1e-9
+
+
+class JunctionLimitError(ValueError):
+    """A write introduced a wall-junction violation (#329)."""
+
+    def __init__(self, space_id: str, rule: str, subject: str,
+                 actual: float, limit: float) -> None:
+        self.space_id = space_id
+        self.rule = rule
+        self.subject = subject
+        self.actual = actual
+        self.limit = limit
+        self.code = f"junction_limit_{rule}"
+        super().__init__(
+            f"space={space_id}; rule={rule}; subject={subject}; "
+            f"actual={actual:.12g}; limit={limit:.12g}"
+        )
+
+
+def _finite_point(point: object) -> bool:
+    return (
+        isinstance(point, (list, tuple))
+        and len(point) >= 2
+        and all(isinstance(value, (int, float)) and math.isfinite(value)
+                for value in point[:2])
+    )
+
+
+def _key(point) -> str:
+    return f"{point[0]:.6f},{point[1]:.6f}"
+
+
+def _length(a, b) -> float:
+    return math.hypot(b[0] - a[0], b[1] - a[1])
+
+
+def cm_to_units(cm: float, cell_cm: float, grid_pitch: float = GRID_STEP_N) -> float:
+    return (cm / (cell_cm or 1)) * grid_pitch
+
+
+def limit_segments(space: dict) -> list[dict]:
+    """Every wall the limits judge: contour atoms, partitions, draft segments."""
+    segments: list[dict] = []
+    for segment in space.get("wall_segments") or []:
+        if _finite_point(segment.get("a")) and _finite_point(segment.get("b")):
+            segments.append({
+                "id": str(segment.get("id") or ""),
+                "a": segment["a"], "b": segment["b"],
+                "cm": float(segment.get("cm") or 0),
+            })
+    for partition in space.get("partitions") or []:
+        if _finite_point(partition.get("a")) and _finite_point(partition.get("b")):
+            segments.append({
+                "id": str(partition.get("id") or ""),
+                "a": partition["a"], "b": partition["b"],
+                "cm": float(partition.get("cm") or 0),
+            })
+    for draft in space.get("room_drafts") or []:
+        points = draft.get("points") or []
+        drafted = draft.get("segments") or []
+        for index in range(max(len(points) - 1, 0)):
+            if not (_finite_point(points[index]) and _finite_point(points[index + 1])):
+                continue
+            piece = drafted[index] if index < len(drafted) else {}
+            segments.append({
+                "id": str((piece or {}).get("id")
+                          or f"{draft.get('id') or 'draft'}-{index}"),
+                "a": points[index], "b": points[index + 1],
+                "cm": float((piece or {}).get("cm") or 0),
+            })
+    return [segment for segment in segments
+            if _length(segment["a"], segment["b"]) > _EPS]
+
+
+def check_nodes(segments: list[dict]) -> list[tuple[str, str, float, float]]:
+    """П1 + П2: valence of a node and the narrowest wedge in it."""
+    rays: dict[str, list[float]] = {}
+    for segment in segments:
+        for start, end in ((segment["a"], segment["b"]), (segment["b"], segment["a"])):
+            rays.setdefault(_key(start), []).append(
+                math.atan2(end[1] - start[1], end[0] - start[0])
+            )
+    violations: list[tuple[str, str, float, float]] = []
+    for node, angles in rays.items():
+        if len(angles) > MAX_JUNCTION_VALENCE:
+            violations.append(
+                ("valence", node, float(len(angles)), float(MAX_JUNCTION_VALENCE))
+            )
+        if len(angles) < 2:
+            continue
+        ordered = sorted(angles)
+        smallest = math.inf
+        for index, value in enumerate(ordered):
+            delta = ordered[(index + 1) % len(ordered)] - value
+            if index == len(ordered) - 1:
+                delta += math.pi * 2
+            degrees = (delta * 180) / math.pi
+            # Collinear rays of one straight wall are a 180° pair, not a wedge.
+            if _EPS < degrees < smallest:
+                smallest = degrees
+        if smallest < MIN_JUNCTION_ANGLE_DEG - 1e-9:
+            violations.append(("angle", node, smallest, MIN_JUNCTION_ANGLE_DEG))
+    return violations
+
+
+def _axis_degrees(segment: dict) -> float:
+    degrees = math.degrees(math.atan2(
+        segment["b"][1] - segment["a"][1], segment["b"][0] - segment["a"][0]
+    ))
+    return (degrees % 180 + 180) % 180
+
+
+def _collinear(left: dict, right: dict, tolerance_deg: float = 1.0) -> bool:
+    delta = abs(_axis_degrees(left) - _axis_degrees(right))
+    return min(delta, 180 - delta) <= tolerance_deg
+
+
+def collinear_run_length_units(segment: dict, segments: list[dict]) -> float:
+    """Length of the WALL a segment belongs to, not of the atom.
+
+    Atomisation at a thickness step leaves pieces nobody drew — where a 30 cm
+    wall meets a 20 cm one, a (30−20)/2 = 5 cm piece continues the same wall.
+    They are collinear continuations at the same thickness, so П3 measures the
+    maximal collinear chain through the segment's nodes.
+    """
+    by_node: dict[str, list[dict]] = {}
+    for item in segments:
+        for point in (item["a"], item["b"]):
+            by_node.setdefault(_key(point), []).append(item)
+    visited = [segment]
+    total = _length(segment["a"], segment["b"])
+
+    def walk(current: dict, node: str) -> None:
+        nonlocal total
+        for candidate in by_node.get(node, []):
+            if any(candidate is seen for seen in visited):
+                continue
+            if not _collinear(candidate, current):
+                continue
+            if float(candidate.get("cm") or 0) != float(current.get("cm") or 0):
+                continue
+            visited.append(candidate)
+            total += _length(candidate["a"], candidate["b"])
+            walk(candidate, _key(candidate["b"])
+                 if _key(candidate["a"]) == node else _key(candidate["a"]))
+            return
+
+    walk(segment, _key(segment["a"]))
+    walk(segment, _key(segment["b"]))
+    return total
+
+
+def check_segment_lengths(
+    segments: list[dict], cell_cm: float, grid_pitch: float = GRID_STEP_N,
+) -> list[tuple[str, str, float, float]]:
+    """П3: a wall is at least 20 cm and never shorter than its own thickness."""
+    violations: list[tuple[str, str, float, float]] = []
+    for segment in segments:
+        units = collinear_run_length_units(segment, segments)
+        cm = (units / grid_pitch) * (cell_cm or 1)
+        thickness = float(segment.get("cm") or 0)
+        limit = max(MIN_SEGMENT_LENGTH_CM, thickness if thickness > 0 else 0.0)
+        if cm < limit - 1e-9:
+            violations.append((
+                "length", str(segment.get("id") or _key(segment["a"])), cm, limit,
+            ))
+    return violations
+
+
+def _distance_to_segment(point, a, b) -> float:
+    dx, dy = b[0] - a[0], b[1] - a[1]
+    length_sq = dx * dx + dy * dy
+    t = 0.0 if length_sq <= _EPS else max(0.0, min(1.0, (
+        (point[0] - a[0]) * dx + (point[1] - a[1]) * dy
+    ) / length_sq))
+    return math.hypot(point[0] - (a[0] + dx * t), point[1] - (a[1] + dy * t))
+
+
+def check_node_distances(
+    segments: list[dict], cell_cm: float, grid_pitch: float = GRID_STEP_N,
+) -> list[tuple[str, str, float, float]]:
+    """П4: non-incident nodes and node-to-foreign-wall clearance."""
+    nodes: dict[str, list] = {}
+    for segment in segments:
+        nodes[_key(segment["a"])] = segment["a"]
+        nodes[_key(segment["b"])] = segment["b"]
+    min_units = cm_to_units(MIN_NODE_DISTANCE_CM, cell_cm, grid_pitch)
+    violations: list[tuple[str, str, float, float]] = []
+    entries = list(nodes.items())
+    for i in range(len(entries)):
+        for j in range(i + 1, len(entries)):
+            distance = _length(entries[i][1], entries[j][1])
+            if distance < min_units - 1e-9:
+                violations.append((
+                    "distance", f"{entries[i][0]} ↔ {entries[j][0]}",
+                    (distance / grid_pitch) * (cell_cm or 1), MIN_NODE_DISTANCE_CM,
+                ))
+    for node_key, node in nodes.items():
+        for segment in segments:
+            # A node that belongs to the wall is a legal corner or T-joint.
+            if _key(segment["a"]) == node_key or _key(segment["b"]) == node_key:
+                continue
+            distance = _distance_to_segment(node, segment["a"], segment["b"])
+            # Sitting exactly ON the wall is the other legal incidence.
+            if distance <= _INCIDENT_EPS:
+                continue
+            if distance < min_units - 1e-9:
+                violations.append((
+                    "distance",
+                    f"{node_key} → {segment.get('id') or _key(segment['a'])}",
+                    (distance / grid_pitch) * (cell_cm or 1), MIN_NODE_DISTANCE_CM,
+                ))
+    return violations
+
+
+def space_violations(space: dict) -> list[tuple[str, str, float, float]]:
+    """П1–П4 over one space, in the frontend's order."""
+    segments = limit_segments(space)
+    cell_cm = float(space.get("cell_cm") or 1)
+    return [
+        *check_nodes(segments),
+        *check_segment_lengths(segments, cell_cm),
+        *check_node_distances(segments, cell_cm),
+    ]
+
+
+def _migrated_spaces(config: dict | None) -> dict[str, dict]:
+    """Spaces of one document AFTER the wall-segment migration, by id.
+
+    The limits read `wall_segments`, so a document that predates the catalogue
+    reports NO walls at all — a legacy space would answer "no violations"
+    regardless of its geometry. Comparing such a baseline against a candidate
+    the client already migrated counts every inherited violation as new and
+    refuses an unrelated edit (spec §3 forbids exactly that). Both sides are
+    therefore judged after the SAME migration, mirroring the frontend barrier.
+
+    A document that cannot be migrated is not a reason to refuse the write:
+    the wall-model barrier owns that verdict and reports it with its own code.
+    Here it simply means there is no baseline to inherit from.
+    """
+    if not isinstance(config, dict):
+        return {}
+    try:
+        migrated, _ = commit_wall_segment_model(config)
+    except Exception:  # noqa: BLE001 — see the docstring: not our verdict
+        migrated = config
+    return {
+        str(space.get("id")): space
+        for space in (migrated or {}).get("spaces") or []
+        if isinstance(space, dict)
+    }
+
+
+def validate_junction_limits(config: dict, previous: dict | None = None) -> None:
+    """Refuse a write that ADDS a junction violation; inherit the rest.
+
+    Counted per RULE, not per subject: a structural write re-atomises and
+    re-keys contour segments, so subject identity is not stable across the
+    barrier and matching by it would report an inherited violation as new
+    (the mistake that refused legitimate resizes on the frontend). Spec §3:
+    a write may keep existing violations, it may never add one.
+
+    Both documents go through `commit_wall_segment_model` first, so a legacy
+    baseline is compared in the same terms as the candidate.
+    """
+    old_spaces = _migrated_spaces(previous)
+    new_spaces = _migrated_spaces(config)
+    for space_id, space in new_spaces.items():
+        old_space = old_spaces.get(space_id)
+        if old_space is None:
+            # A brand-new space has nothing to inherit from — but neither is a
+            # first write allowed to arrive already broken.
+            before: dict[str, int] = {}
+        else:
+            before = {}
+            for rule, _subject, _actual, _limit in space_violations(old_space):
+                before[rule] = before.get(rule, 0) + 1
+        after: dict[str, list[tuple[str, str, float, float]]] = {}
+        for violation in space_violations(space):
+            after.setdefault(violation[0], []).append(violation)
+        for rule, items in after.items():
+            if len(items) > before.get(rule, 0):
+                _, subject, actual, limit = items[0]
+                raise JunctionLimitError(space_id, rule, subject, actual, limit)
@@ -16,5 +16,5 @@
  "issue_tracker": "https://github.com/Matysh/houseplan-card/issues",
  "requirements": [],
  "single_config_entry": true,
-  "version": "1.64.0"
+  "version": "1.68.1"
 }
@@ -0,0 +1,95 @@
+"""Read-only projections of the stored plan (#256).
+
+A full configuration is 70 KB on a real installation: three spaces and 139
+markers. Every diagnostic question — "which space does this marker point at",
+"how many markers are hidden", "what is on the first floor" — used to require
+downloading all of it, because `houseplan/config/get` had no way to ask for
+less.
+
+The functions here are pure and deliberately unaware of Home Assistant: the
+websocket handlers stay thin, and the interesting part is covered by tests that
+run without the HA harness.
+
+Two rules shape everything below.
+
+* Absent parameter means *no projection*. The response must stay byte-for-byte
+  what it was before this module existed; no existing client may notice it.
+* A projection never invents or repairs data. An unknown field name simply adds
+  nothing, and an unknown space yields an empty list rather than an error — the
+  caller distinguishes "no such thing" from "broken" by content, not by an
+  error code.
+"""
+from __future__ import annotations
+
+from typing import Any, Iterable
+
+
+def _names(value: Any) -> list[str] | None:
+    """Normalise a field list; anything unusable means "no projection"."""
+    if not isinstance(value, (list, tuple)):
+        return None
+    names = [str(item) for item in value if isinstance(item, str) and item]
+    return names or None
+
+
+def project_markers(markers: Any, marker_fields: Iterable[str] | None) -> Any:
+    """Keep only the requested marker fields, plus `id`.
+
+    `id` is added unconditionally: a marker without it cannot be matched to
+    anything, so a projection that drops it produces an answer nobody can use.
+    """
+    names = _names(marker_fields)
+    if names is None or not isinstance(markers, list):
+        return markers
+    keep = {"id", *names}
+    out = []
+    for marker in markers:
+        if not isinstance(marker, dict):
+            out.append(marker)
+            continue
+        out.append({key: value for key, value in marker.items() if key in keep})
+    return out
+
+
+def project_config(
+    config: Any,
+    *,
+    space_id: str | None = None,
+    fields: Iterable[str] | None = None,
+    marker_fields: Iterable[str] | None = None,
+) -> Any:
+    """Return a narrowed copy of the configuration.
+
+    The original object is never mutated: the caller hands us the store's
+    document, and a projection that edited it in place would corrupt the very
+    thing it was asked to read.
+    """
+    if not isinstance(config, dict):
+        return config
+    field_names = _names(fields)
+    if space_id is None and field_names is None and _names(marker_fields) is None:
+        return config
+
+    projected: dict[str, Any] = dict(config)
+    if space_id is not None:
+        spaces = projected.get("spaces")
+        projected["spaces"] = [
+            space for space in spaces
+            if isinstance(space, dict) and str(space.get("id", "")) == str(space_id)
+        ] if isinstance(spaces, list) else spaces
+    if marker_fields is not None:
+        projected["markers"] = project_markers(projected.get("markers"), marker_fields)
+    if field_names is not None:
+        projected = {key: value for key, value in projected.items() if key in set(field_names)}
+    return projected
+
+
+def project_layout(layout: Any, *, space_id: str | None = None) -> Any:
+    """Keep only the positions of one space."""
+    if space_id is None or not isinstance(layout, dict):
+        return layout
+    wanted = str(space_id)
+    return {
+        key: position for key, position in layout.items()
+        if isinstance(position, dict) and str(position.get("s", "")) == wanted
+    }
@@ -20,6 +20,10 @@ from .const import (
    STORAGE_VERSION,
    STORAGE_VIRTUAL_LIGHTS_KEY,
 )
+from .coordinate_canonicalization import (
+    canonicalize_config_geometry,
+    canonicalize_layout_geometry,
+)


 _LOGGER = logging.getLogger(__name__)
@@ -157,7 +161,7 @@ def layout_store_payload(
    }
    if metadata:
        out.update(metadata)
-    out["layout"] = layout
+    out["layout"] = canonicalize_layout_geometry(layout)
    out["rev"] = rev
    return out

@@ -205,7 +209,8 @@ async def async_save_config_state(
        except (TypeError, ValueError):
            previous_rev = 0

-    payload = {"config": config, "rev": rev}
+    canonical_config = canonicalize_config_geometry(config)
+    payload = {"config": canonical_config, "rev": rev}
    await runtime.config_store.async_save(payload)

    # The config is already durable at this point.  Reconciliation remains a
@@ -216,7 +221,7 @@ async def async_save_config_state(
    try:
        await async_reconcile_virtual_lights(
            runtime.virtual_light_store,
-            config,
+            canonical_config,
            rev,
            previous_config_rev=previous_rev,
        )
@@ -10,6 +10,7 @@ want to see where the cleanup has already been).
 from __future__ import annotations

 import asyncio
+import math
 import time
 from typing import Any

@@ -24,11 +25,33 @@ import logging
 _LOGGER = logging.getLogger(__name__)

 TRAIL_CAP = 2000          # raw points per run before decimation
+TRAIL_RESUME_GRACE_S = 30 * 60  # same-map stop/pause belongs to one cleanup
 SAVE_DELAY_S = 10         # debounce store writes — flash wear over precision
 FIRE_THROTTLE_S = 2.0     # event-bus updates for live cards
 MOVING_STATES = {"cleaning", "returning", "on"}


+def can_resume_trail_run(run: Any, map_id: str, now: float) -> bool:
+    """Whether an ended current run may be reopened for this point.
+
+    Store timestamps are untrusted persisted data. Only finite JSON-number
+    timestamps and a non-negative inclusive grace interval are accepted;
+    malformed values and wall-clock rollback fail closed into a new run.
+    """
+    if not isinstance(run, dict) or run.get("map_id") != map_id:
+        return False
+    ended = run.get("ended")
+    if (
+        isinstance(ended, bool)
+        or not isinstance(ended, (int, float))
+        or isinstance(now, bool)
+        or not isinstance(now, (int, float))
+    ):
+        return False
+    elapsed = now - ended
+    return math.isfinite(elapsed) and 0 <= elapsed <= TRAIL_RESUME_GRACE_S
+
+
 def resolve_map_id(src_attrs: Any, vac_attrs: Any) -> str:
    """Map-id normalisation contract, shared with the frontend.

@@ -64,7 +87,10 @@ class TrailBook:
    def on_point(self, marker: str, map_id: str, x: float, y: float, now: float) -> bool:
        rec = self.data.setdefault(marker, {})
        cur = rec.get("current")
-        if not cur or cur.get("ended") or cur.get("map_id") != map_id:
+        resumed = bool(cur and can_resume_trail_run(cur, map_id, now))
+        if resumed:
+            cur["ended"] = None
+        if not cur or cur.get("ended") is not None or cur.get("map_id") != map_id:
            # a new run begins: the old one becomes "previous" (and the one
            # before it is forgotten — we keep exactly two, per the owner)
            if cur:
@@ -73,7 +99,9 @@ class TrailBook:
            rec["current"] = cur
        pts: list[list[float]] = cur["points"]
        if pts and pts[-1][0] == x and pts[-1][1] == y:
-            return False
+            # Clearing ended is observable state even if the source repeats
+            # the dock point: it must still reach Store and live cards.
+            return resumed
        pts.append([x, y])
        if len(pts) > TRAIL_CAP:
            # decimate by two but never lose the freshest point
@@ -85,7 +113,7 @@ class TrailBook:

    def end_run(self, marker: str, now: float) -> bool:
        cur = (self.data.get(marker) or {}).get("current")
-        if cur and not cur.get("ended"):
+        if cur and cur.get("ended") is None:
            cur["ended"] = now
            return True
        return False
@@ -0,0 +1,684 @@
+"""Deterministic persisted contour-wall identity (model v9, issues #282/#306).
+
+This is the backend twin of ``src/wall-segment-model.ts``.  Import preview is
+a server-side structural writer, so it cannot depend on a browser being open
+to upgrade v7 backups before validating/remapping them.
+"""
+from __future__ import annotations
+
+import base64
+import copy
+import hashlib
+import math
+import uuid
+from typing import Any
+
+from .coordinate_canonicalization import canonicalize_config_geometry
+
+
+WALL_SEGMENT_MODEL_VERSION = 9
+GRID_STEP_N = 1 / 240
+EPS = 1e-9
+
+
+class WallSegmentMigrationError(ValueError):
+    """The candidate cannot be upgraded without guessing ownership."""
+
+    code = "wall_model_migration_blocked"
+
+    def __init__(self, reason: str, detail: str = "") -> None:
+        self.reason = reason
+        super().__init__(f"{reason}: {detail}" if detail else reason)
+
+
+def _point_key(point: list[float]) -> str:
+    return f"{float(point[0]):.12f},{float(point[1]):.12f}"
+
+
+def _span_key(a: list[float], b: list[float]) -> str:
+    ka, kb = _point_key(a), _point_key(b)
+    return f"{ka}|{kb}" if ka < kb else f"{kb}|{ka}"
+
+
+def _canonical_span(a: list[float], b: list[float]) -> tuple[list[float], list[float]]:
+    left, right = ([float(a[0]), float(a[1])], [float(b[0]), float(b[1])])
+    return (left, right) if _point_key(left) <= _point_key(right) else (right, left)
+
+
+def _length(a: list[float], b: list[float]) -> float:
+    return math.hypot(float(b[0]) - float(a[0]), float(b[1]) - float(a[1]))
+
+
+def _project_t(point: list[float], a: list[float], b: list[float]) -> float:
+    dx, dy = float(b[0]) - float(a[0]), float(b[1]) - float(a[1])
+    denominator = dx * dx + dy * dy
+    if denominator <= EPS * EPS:
+        return 0
+    return ((float(point[0]) - float(a[0])) * dx
+            + (float(point[1]) - float(a[1])) * dy) / denominator
+
+
+def _distance_to_segment(point: list[float], a: list[float], b: list[float]) -> float:
+    t = max(0.0, min(1.0, _project_t(point, a, b)))
+    return math.hypot(
+        float(point[0]) - (float(a[0]) + (float(b[0]) - float(a[0])) * t),
+        float(point[1]) - (float(a[1]) + (float(b[1]) - float(a[1])) * t),
+    )
+
+
+def _collinear_overlap(
+    a: list[float], b: list[float], c: list[float], d: list[float], epsilon: float = EPS,
+) -> float:
+    dx, dy = float(b[0]) - float(a[0]), float(b[1]) - float(a[1])
+    length = math.hypot(dx, dy)
+    if length <= epsilon:
+        return 0
+    cross_c = abs((float(c[0]) - float(a[0])) * dy
+                  - (float(c[1]) - float(a[1])) * dx) / length
+    cross_d = abs((float(d[0]) - float(a[0])) * dy
+                  - (float(d[1]) - float(a[1])) * dx) / length
+    if cross_c > epsilon or cross_d > epsilon:
+        return 0
+    tc, td = _project_t(c, a, b), _project_t(d, a, b)
+    return max(0.0, min(1.0, max(tc, td)) - max(0.0, min(tc, td))) * length
+
+
+def _room_poly(room: dict[str, Any]) -> list[list[float]]:
+    poly = room.get("poly")
+    if isinstance(poly, list) and len(poly) >= 3:
+        return [[float(point[0]), float(point[1])] for point in poly]
+    if all(isinstance(room.get(key), (int, float)) and not isinstance(room.get(key), bool)
+           for key in ("x", "y", "w", "h")):
+        x, y, width, height = (float(room[key]) for key in ("x", "y", "w", "h"))
+        return [[x, y], [x + width, y], [x + width, y + height], [x, y + height]]
+    return []
+
+
+def _shared_boundaries(first: list[list[float]], second: list[list[float]]) -> list[list[float]]:
+    result: list[list[float]] = []
+    epsilon = GRID_STEP_N * 0.04
+    for index, start in enumerate(first):
+        end = first[(index + 1) % len(first)]
+        dx, dy = end[0] - start[0], end[1] - start[1]
+        length = math.hypot(dx, dy)
+        if length < epsilon:
+            continue
+        ux, uy = dx / length, dy / length
+        for other_index, other_start in enumerate(second):
+            other_end = second[(other_index + 1) % len(second)]
+            tolerance = max(epsilon, length * 1e-6)
+            distances = [
+                abs((point[0] - start[0]) * uy - (point[1] - start[1]) * ux)
+                for point in (other_start, other_end)
+            ]
+            if max(distances) > tolerance:
+                continue
+            t1 = (other_start[0] - start[0]) * ux + (other_start[1] - start[1]) * uy
+            t2 = (other_end[0] - start[0]) * ux + (other_end[1] - start[1]) * uy
+            lo, hi = max(0.0, min(t1, t2)), min(length, max(t1, t2))
+            if hi - lo > epsilon:
+                result.append([
+                    start[0] + ux * lo, start[1] + uy * lo,
+                    start[0] + ux * hi, start[1] + uy * hi,
+                ])
+    return result
+
+
+def _wall_direction(a: list[float], b: list[float]) -> tuple[float, float]:
+    dx, dy = b[0] - a[0], b[1] - a[1]
+    length = math.hypot(dx, dy)
+    if length < 1e-12:
+        return 1.0, 0.0
+    dx, dy = dx / length, dy / length
+    if dx < -1e-12 or (abs(dx) <= 1e-12 and dy < 0):
+        dx, dy = -dx, -dy
+    return dx, dy
+
+
+def _js_round(value: float) -> int:
+    return math.floor(value + 0.5)
+
+
+def _quantize(value: float, pitch: float = GRID_STEP_N) -> float:
+    return _js_round(value / pitch) * pitch
+
+
+def _wall_key(a: list[float], b: list[float]) -> str:
+    midpoint_x = _quantize((float(a[0]) + float(b[0])) / 2)
+    midpoint_y = _quantize((float(a[1]) + float(b[1])) / 2)
+    dx, dy = _wall_direction(a, b)
+    angle = math.atan2(dy, dx)
+    if angle < 0:
+        angle += math.pi
+    angle = _js_round(angle * 1800) / 1800
+    return f"{midpoint_x:.6f},{midpoint_y:.6f}@{angle:.4f}"
+
+
+def deterministic_wall_segment_id(
+    space_id: str, a: list[float], b: list[float], owners: list[str], salt: str = "",
+) -> str:
+    ca, cb = _canonical_span(a, b)
+    seed = (f"{space_id}|{_point_key(ca)}|{_point_key(cb)}|"
+            f"{','.join(sorted(owners))}{salt}")
+    encoded = base64.b32encode(hashlib.sha256(seed.encode()).digest()).decode().lower()
+    return f"wall-{encoded[:20]}"
+
+
+def _translated_segment_delta(
+    a: list[float], b: list[float], previous: dict[str, Any],
+) -> tuple[float, float] | None:
+    def matches(pa: list[float], pb: list[float]) -> tuple[float, float] | None:
+        dx, dy = a[0] - pa[0], a[1] - pa[1]
+        if abs((b[0] - pb[0]) - dx) <= EPS and abs((b[1] - pb[1]) - dy) <= EPS:
+            return dx, dy
+        return None
+
+    return matches(previous["a"], previous["b"]) or matches(previous["b"], previous["a"])
+
+
+def _atomize(
+    space: dict[str, Any], old: dict[str, dict[str, Any]],
+) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
+    rooms = space.get("rooms") or []
+    room_polys = {str(room.get("id", "")): _room_poly(room) for room in rooms}
+    global_breaks: list[list[float]] = []
+    explicit_spans = space.get("open_spans") or []
+    legacy_segments: list[list[float]] = []
+    for span in explicit_spans:
+        if isinstance(span, dict) and isinstance(span.get("a"), list) and isinstance(span.get("b"), list):
+            global_breaks.extend((span["a"], span["b"]))
+            legacy_segments.append([
+                float(span["a"][0]), float(span["a"][1]),
+                float(span["b"][0]), float(span["b"][1]),
+            ])
+    if not legacy_segments:
+        linked = lambda first, second: (
+            str(second.get("id", "")) in (first.get("open_to") or [])
+            or str(first.get("id", "")) in (second.get("open_to") or [])
+        )
+        for first_index, first in enumerate(rooms):
+            for second in rooms[first_index + 1:]:
+                if not linked(first, second):
+                    continue
+                for shared in _shared_boundaries(
+                    room_polys.get(str(first.get("id", "")), []),
+                    room_polys.get(str(second.get("id", "")), []),
+                ):
+                    legacy_segments.append(shared)
+                    global_breaks.extend(([shared[0], shared[1]], [shared[2], shared[3]]))
+    canonical_zero_segments: list[list[float]] = []
+    for room in rooms:
+        poly = room_polys.get(str(room.get("id", ""))) or []
+        wall_ids = room.get("wall_ids") or []
+        if len(wall_ids) != len(poly):
+            continue
+        for index, segment_id in enumerate(wall_ids):
+            previous = old.get(str(segment_id)) if isinstance(segment_id, str) else None
+            if previous is None or float(previous.get("cm", 0)) != 0:
+                continue
+            following = (index + 1) % len(poly)
+            canonical_zero_segments.append([
+                float(poly[index][0]), float(poly[index][1]),
+                float(poly[following][0]), float(poly[following][1]),
+            ])
+    for segment in canonical_zero_segments:
+        global_breaks.extend((segment[:2], segment[2:]))
+    zero_segments = canonical_zero_segments + legacy_segments
+
+    # #316 §3.1: a legacy open_spans/open_to cut never zeroes the atom that
+    # carries an existing contour opening; its edges become atom boundaries so
+    # the zero run continues on both sides of the opening.
+    legacy_era_openings: list[dict[str, Any]] = []
+    if legacy_segments:
+        for opening in space.get("openings") or []:
+            if not isinstance(opening, dict):
+                continue
+            host = opening.get("host")
+            if isinstance(host, dict) and host.get("kind") == "partition":
+                continue
+            try:
+                centre = [float(opening["x"]), float(opening["y"])]
+                angle = float(opening["angle"])
+                half = float(opening["length"]) / 2
+            except (KeyError, TypeError, ValueError):
+                continue
+            if half <= 0:
+                continue
+            # Only an opening that actually stands on a legacy cut changes the
+            # atomization; unrelated openings must not churn the catalogue.
+            if not any(
+                _distance_to_segment(centre, cut[:2], cut[2:]) <= GRID_STEP_N * 0.04
+                for cut in legacy_segments
+            ):
+                continue
+            legacy_era_openings.append(
+                {"centre": centre, "angle": angle, "half": half}
+            )
+            direction = (math.cos(math.radians(angle)), math.sin(math.radians(angle)))
+            global_breaks.extend((
+                [centre[0] - direction[0] * half, centre[1] - direction[1] * half],
+                [centre[0] + direction[0] * half, centre[1] + direction[1] * half],
+            ))
+
+    def _atom_carries_opening(a: list[float], b: list[float]) -> bool:
+        for entry in legacy_era_openings:
+            if not _angle_matches(a, b, entry["angle"]):
+                continue
+            if _distance_to_segment(entry["centre"], a, b) > GRID_STEP_N * 0.02:
+                continue
+            span = _length(a, b)
+            tc = _project_t(entry["centre"], a, b) * span
+            if tc + entry["half"] >= -EPS and tc - entry["half"] <= span + EPS:
+                return True
+        return False
+
+    for wall in space.get("walls") or []:
+        if isinstance(wall, dict) and isinstance(wall.get("a"), list) and isinstance(wall.get("b"), list):
+            global_breaks.extend((wall["a"], wall["b"]))
+
+    atoms_by_key: dict[str, dict[str, Any]] = {}
+    next_rooms: list[dict[str, Any]] = []
+    epsilon = GRID_STEP_N * 0.04
+    for raw_room in rooms:
+        room_id = str(raw_room.get("id", ""))
+        original = room_polys.get(room_id) or []
+        if not room_id or len(original) < 3:
+            raise WallSegmentMigrationError("invalid-room", room_id)
+        breaks = list(global_breaks)
+        for other_id, other_poly in room_polys.items():
+            if other_id == room_id:
+                continue
+            for shared in _shared_boundaries(original, other_poly):
+                breaks.extend(([shared[0], shared[1]], [shared[2], shared[3]]))
+
+        poly: list[list[float]] = []
+        parents: list[int] = []
+        for index, a in enumerate(original):
+            b = original[(index + 1) % len(original)]
+            poly.append(list(a))
+            parents.append(index)
+            length = _length(a, b)
+            if length < epsilon * 2:
+                raise WallSegmentMigrationError("zero-length", room_id)
+            gap = min(0.499, epsilon * 2 / length)
+            positions: list[float] = []
+            for breakpoint in breaks:
+                if _distance_to_segment(breakpoint, a, b) > epsilon:
+                    continue
+                t = _project_t(breakpoint, a, b)
+                if t <= gap or t >= 1 - gap:
+                    continue
+                if any(abs(existing - t) * length <= epsilon * 2 for existing in positions):
+                    continue
+                positions.append(t)
+            for t in sorted(positions):
+                poly.append([a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t])
+                parents.append(index)
+
+        old_ids = raw_room.get("wall_ids") if isinstance(raw_room.get("wall_ids"), list) else []
+        indexed_lineage = len(old_ids) == len(original)
+        rigid_delta: tuple[float, float] | None = None
+        rigid_indexed_lineage = indexed_lineage
+        if rigid_indexed_lineage:
+            for index, a in enumerate(original):
+                previous = old.get(old_ids[index])
+                delta = _translated_segment_delta(
+                    a, original[(index + 1) % len(original)], previous,
+                ) if previous else None
+                if delta is None or (rigid_delta is not None and (
+                    abs(delta[0] - rigid_delta[0]) > EPS
+                    or abs(delta[1] - rigid_delta[1]) > EPS
+                )):
+                    rigid_indexed_lineage = False
+                    break
+                rigid_delta = delta
+        wall_keys: list[str] = []
+        for index, a in enumerate(poly):
+            b = poly[(index + 1) % len(poly)]
+            key = _span_key(a, b)
+            atom = atoms_by_key.setdefault(key, {
+                "key": key, "a": _canonical_span(a, b)[0], "b": _canonical_span(a, b)[1],
+                "owners": set(), "preferred": set(), "positional": set(),
+                "preferred_carriers": {},
+                "parent_keys": set(), "zero_wall": False,
+            })
+            atom["owners"].add(room_id)
+            if len(atom["owners"]) > 2:
+                raise WallSegmentMigrationError("third-owner", key)
+            parent_index = parents[index]
+            atom["parent_keys"].add(_wall_key(original[parent_index], original[(parent_index + 1) % len(original)]))
+            midpoint = [(a[0] + b[0]) / 2, (a[1] + b[1]) / 2]
+            covered_by = lambda cuts: any(
+                _distance_to_segment(midpoint, cut[:2], cut[2:]) <= GRID_STEP_N * 0.04
+                for cut in cuts
+            )
+            # Canonical cm:0 atoms stay zero; a LEGACY cut spares the atom
+            # that carries an opening (#316 §3.1).
+            atom["zero_wall"] = atom["zero_wall"] or covered_by(canonical_zero_segments) or (
+                covered_by(legacy_segments) and not _atom_carries_opening(a, b)
+            )
+            if indexed_lineage and isinstance(old_ids[parent_index], str) and old_ids[parent_index]:
+                previous = old.get(old_ids[parent_index])
+                if rigid_indexed_lineage or previous is None or _collinear_overlap(
+                    a, b, previous["a"], previous["b"]
+                ) > EPS:
+                    atom["preferred"].add(old_ids[parent_index])
+                else:
+                    atom["positional"].add(old_ids[parent_index])
+                atom["preferred_carriers"][old_ids[parent_index]] = {
+                    "a": list(original[parent_index]),
+                    "b": list(original[(parent_index + 1) % len(original)]),
+                }
+            wall_keys.append(key)
+        next_room = {key: copy.deepcopy(value) for key, value in raw_room.items() if key != "wall_ids"}
+        next_room["poly"] = poly
+        next_room["wall_ids"] = wall_keys
+        next_rooms.append(next_room)
+    return sorted(atoms_by_key.values(), key=lambda atom: atom["key"]), next_rooms
+
+
+def _thickness(space: dict[str, Any], atom: dict[str, Any], previous: dict[str, Any] | None) -> float:
+    if atom.get("zero_wall"):
+        return 0.0
+    candidates: list[float] = []
+    query_key = _wall_key(atom["a"], atom["b"])
+    query_length = _length(atom["a"], atom["b"])
+    for wall in space.get("walls") or []:
+        try:
+            cm = float(wall.get("cm", 0))
+        except (TypeError, ValueError):
+            continue
+        if cm <= 0:
+            continue
+        exact_key = wall.get("key") == query_key or wall.get("key") in atom["parent_keys"]
+        covers = False
+        if isinstance(wall.get("a"), list) and isinstance(wall.get("b"), list):
+            overlap = _collinear_overlap(atom["a"], atom["b"], wall["a"], wall["b"])
+            covers = overlap >= query_length - EPS
+        if exact_key or covers:
+            candidates.append(max(1.0, min(100.0, cm)))
+    unique = {round(value, 9) for value in candidates}
+    if len(unique) > 1:
+        raise WallSegmentMigrationError("thickness-conflict", atom["key"])
+    if candidates:
+        return candidates[0]
+    if previous is not None and float(previous.get("cm", 0)) > 0:
+        return float(previous["cm"])
+    return 0.0
+
+
+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 item in space.get(name) or []:
+            if isinstance(item, dict) and isinstance(item.get("id"), str) and item["id"]:
+                result.add(item["id"])
+    for draft in space.get("room_drafts") or []:
+        for segment in draft.get("segments") or []:
+            if isinstance(segment, dict) and isinstance(segment.get("id"), str) and segment["id"]:
+                result.add(segment["id"])
+    return result
+
+
+def _fresh_wall_segment_id(used: set[str]) -> str:
+    for _attempt in range(1000):
+        segment_id = f"wall-{uuid.uuid4()}"
+        if segment_id not in used:
+            return segment_id
+    raise WallSegmentMigrationError("duplicate-id", "id factory exhausted")
+
+
+def _assign_lineage(
+    space: dict[str, Any], atoms: list[dict[str, Any]], old: dict[str, dict],
+    initial_migration: bool,
+) -> None:
+    old_by_key = {_span_key(segment["a"], segment["b"]): segment for segment in old.values()}
+    host_counts: dict[str, int] = {}
+    for opening in space.get("openings") or []:
+        host = opening.get("host") if isinstance(opening, dict) else None
+        if isinstance(host, dict) and host.get("kind") == "wall":
+            host_counts[str(host.get("id"))] = host_counts.get(str(host.get("id")), 0) + 1
+    proposals: dict[str, dict[str, Any]] = {}
+    for atom in atoms:
+        if len(atom["preferred"]) > 1:
+            raise WallSegmentMigrationError("duplicate-id", ",".join(sorted(atom["preferred"])))
+        preferred_id = next(iter(atom["preferred"]), None)
+        preferred = old.get(preferred_id) if preferred_id else None
+        if preferred:
+            proposals[atom["key"]] = preferred
+            continue
+        carrier = atom["preferred_carriers"].get(preferred_id) if preferred_id else None
+        if preferred_id and carrier:
+            proposals[atom["key"]] = {
+                "id": preferred_id, "a": carrier["a"], "b": carrier["b"], "cm": 0,
+            }
+            continue
+        if atom["key"] in old_by_key:
+            proposals[atom["key"]] = old_by_key[atom["key"]]
+            continue
+        overlaps = [segment for segment in old.values()
+                    if _collinear_overlap(atom["a"], atom["b"], segment["a"], segment["b"]) > EPS]
+        overlaps.sort(key=lambda segment: (
+            -host_counts.get(str(segment["id"]), 0),
+            -_length(segment["a"], segment["b"]), str(segment["id"]),
+        ))
+        if overlaps:
+            proposals[atom["key"]] = overlaps[0]
+        elif len(atom["positional"]) == 1:
+            positional = old.get(next(iter(atom["positional"])))
+            if positional:
+                proposals[atom["key"]] = positional
+
+    by_id: dict[str, list[dict[str, Any]]] = {}
+    for atom in atoms:
+        proposal = proposals.get(atom["key"])
+        if proposal:
+            by_id.setdefault(str(proposal["id"]), []).append(atom)
+    for segment_id, candidates in by_id.items():
+        old_segment = old.get(segment_id) or proposals.get(candidates[0]["key"])
+        if old_segment is None:
+            raise WallSegmentMigrationError("duplicate-id", segment_id)
+        midpoint = [
+            (old_segment["a"][0] + old_segment["b"][0]) / 2,
+            (old_segment["a"][1] + old_segment["b"][1]) / 2,
+        ]
+        candidates.sort(key=lambda atom: (
+            0 if _distance_to_segment(midpoint, atom["a"], atom["b"]) <= EPS else 1,
+            0 if _distance_to_segment(old_segment["a"], atom["a"], atom["b"]) <= EPS else 1,
+            atom["key"],
+        ))
+        candidates[0]["id"] = segment_id
+
+    used = _non_catalog_ids(space)
+    for atom in atoms:
+        if not atom.get("id"):
+            continue
+        if atom["id"] in used:
+            raise WallSegmentMigrationError("duplicate-id", atom["id"])
+        used.add(atom["id"])
+    unassigned = [atom for atom in atoms if not atom.get("id")]
+    if initial_migration:
+        seeds: list[tuple[str, str, str, dict[str, Any]]] = []
+        for atom in unassigned:
+            ca, cb = _canonical_span(atom["a"], atom["b"])
+            seed = (f"{space.get('id', '')}|{_point_key(ca)}|{_point_key(cb)}|"
+                    f"{','.join(sorted(atom['owners']))}")
+            digest = base64.b32encode(hashlib.sha256(seed.encode()).digest()).decode().lower()
+            seeds.append((digest, atom["key"], seed, atom))
+        full_digests: dict[str, str] = {}
+        for digest, _key, seed, atom in sorted(seeds):
+            if digest in full_digests and full_digests[digest] != seed:
+                raise WallSegmentMigrationError("duplicate-id", digest)
+            full_digests[digest] = seed
+            base = f"wall-{digest[:20]}"
+            suffix, segment_id = 1, base
+            while segment_id in used:
+                suffix += 1
+                segment_id = f"{base}-{suffix}"
+            atom["id"] = segment_id
+            used.add(segment_id)
+    else:
+        for atom in unassigned:
+            atom["id"] = _fresh_wall_segment_id(used)
+            used.add(atom["id"])
+
+
+def _angle_matches(a: list[float], b: list[float], angle: float) -> bool:
+    dx, dy = _wall_direction(a, b)
+    wall_angle = math.degrees(math.atan2(dy, dx))
+    difference = abs((wall_angle - angle + 90) % 180 - 90)
+    return difference <= 8
+
+
+def _host_openings(
+    space: dict[str, Any], segments: list[dict[str, Any]], initial_migration: bool,
+) -> None:
+    for opening in space.get("openings") or []:
+        host = opening.get("host")
+        if isinstance(host, dict) and host.get("kind") == "partition":
+            continue
+        try:
+            centre = [float(opening["x"]), float(opening["y"])]
+            angle, half = float(opening["angle"]), float(opening["length"]) / 2
+        except (KeyError, TypeError, ValueError):
+            if initial_migration:
+                # #316 §3.4: the initial migration never throws over an opening.
+                opening.pop("host", None)
+                continue
+            raise WallSegmentMigrationError("opening-host", str(opening.get("id", ""))) from None
+
+        def eligible(segment: dict[str, Any]) -> bool:
+            if float(segment.get("cm", 0)) <= 0:
+                return False
+            t = _project_t(centre, segment["a"], segment["b"])
+            span = _length(segment["a"], segment["b"])
+            return (-EPS <= t <= 1 + EPS
+                    and _distance_to_segment(centre, segment["a"], segment["b"])
+                    <= GRID_STEP_N * 0.02
+                    and _angle_matches(segment["a"], segment["b"], angle)
+                    and half >= 0 and t * span - half >= -EPS
+                    and t * span + half <= span + EPS)
+
+        def materialize(carrier: dict[str, Any]) -> None:
+            opening["host"] = {
+                "kind": "wall", "id": carrier["id"],
+                "t": max(0.0, min(1.0, _project_t(centre, carrier["a"], carrier["b"]))),
+            }
+
+        current = None
+        if isinstance(host, dict) and host.get("kind") == "wall":
+            current = next((segment for segment in segments if segment["id"] == host.get("id")), None)
+        candidates = [current] if current is not None and eligible(current) else [
+            segment for segment in segments if eligible(segment)
+        ]
+        if len(candidates) == 1:
+            materialize(candidates[0])
+            continue
+        # #316 §3.3: an unhosted opening is a valid degraded v9 state. A later
+        # write keeps it, may self-heal it, and never fails over it.
+        if host is None and not initial_migration:
+            continue
+        if not initial_migration:
+            raise WallSegmentMigrationError("opening-host", str(opening.get("id", "")))
+
+        def pick(pool: list[dict[str, Any]]) -> dict[str, Any] | None:
+            if not pool:
+                return None
+            if current is not None and any(item is current for item in pool):
+                return current
+            return sorted(pool, key=lambda segment: (
+                _distance_to_segment(centre, segment["a"], segment["b"]),
+                -float(segment.get("cm", 0)),
+                str(segment.get("id", "")),
+            ))[0]
+
+        # #316 §3.2 tie-break. No distant fallback pool (CODE-REVIEW-316-r1
+        # H1): a host away from the opening's own x/y would violate the
+        # geometry-match invariant of CONFIG_SCHEMA and wedge the write on the
+        # schema layer; without an in-place carrier the opening goes straight
+        # to the unhosted degraded state.
+        carrier = pick([segment for segment in segments if eligible(segment)])
+        if carrier is not None:
+            materialize(carrier)
+        else:
+            opening.pop("host", None)
+
+
+def _migrate_space(space: dict[str, Any], initial_migration: bool) -> int:
+    old: dict[str, dict[str, Any]] = {}
+    for segment in space.get("wall_segments") or []:
+        segment_id = str(segment.get("id", ""))
+        if not segment_id or segment_id in old:
+            raise WallSegmentMigrationError("duplicate-id", segment_id)
+        old[segment_id] = segment
+    atoms, rooms = _atomize(space, old)
+    _assign_lineage(space, atoms, old, initial_migration)
+    segments = []
+    for atom in atoms:
+        previous = old.get(atom["id"])
+        segment = copy.deepcopy(previous) if previous else {}
+        segment.update({
+            "id": atom["id"], "a": list(atom["a"]), "b": list(atom["b"]),
+            "cm": _thickness(space, atom, previous),
+        })
+        segments.append(segment)
+    id_by_key = {atom["key"]: atom["id"] for atom in atoms}
+    for room in rooms:
+        room["wall_ids"] = [id_by_key[key] for key in room["wall_ids"]]
+    space["rooms"] = rooms
+    space["wall_segments"] = segments
+    walls = [{
+        "key": _wall_key(segment["a"], segment["b"]),
+        "cm": segment["cm"], "a": list(segment["a"]), "b": list(segment["b"]),
+    } for segment in segments if float(segment["cm"]) > 0]
+    if walls:
+        space["walls"] = walls
+    else:
+        space.pop("walls", None)
+    space.pop("open_spans", None)
+    for room in space.get("rooms") or []:
+        room.pop("open_to", None)
+    draft_used = {
+        str(item["id"])
+        for name in ("rooms", "openings", "decor", "room_drafts", "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"]
+    }
+    for draft in space.get("room_drafts") or []:
+        for index, segment in enumerate(draft.get("segments") or []):
+            if isinstance(segment.get("id"), str) and segment["id"]:
+                if segment["id"] in draft_used:
+                    raise WallSegmentMigrationError("duplicate-id", segment["id"])
+                draft_used.add(segment["id"])
+                continue
+            try:
+                a, b = draft["points"][index], draft["points"][index + 1]
+            except (KeyError, IndexError, TypeError):
+                raise WallSegmentMigrationError("zero-length", str(draft.get("id", ""))) from None
+            if initial_migration:
+                base = deterministic_wall_segment_id(
+                    str(space.get("id", "")), a, b, [f"draft:{draft.get('id', '')}"],
+                )
+                suffix, segment["id"] = 1, base
+                while segment["id"] in draft_used:
+                    suffix += 1
+                    segment["id"] = f"{base}-{suffix}"
+            else:
+                segment["id"] = _fresh_wall_segment_id(draft_used)
+            draft_used.add(segment["id"])
+    _host_openings(space, segments, initial_migration)
+    return sum(1 for segment in segments if segment["id"] not in old)
+
+
+def commit_wall_segment_model(config: Any) -> tuple[Any, int]:
+    """Return one migrated deep copy and the count of newly assigned wall ids."""
+    candidate = canonicalize_config_geometry(copy.deepcopy(config))
+    if not isinstance(candidate, dict):
+        raise WallSegmentMigrationError("invalid-room")
+    migrated = 0
+    initial_migration = int(candidate.get("model_version", 0) or 0) < WALL_SEGMENT_MODEL_VERSION
+    for space in candidate.get("spaces") or []:
+        migrated += _migrate_space(space, initial_migration)
+    candidate["model_version"] = WALL_SEGMENT_MODEL_VERSION
+    return canonicalize_config_geometry(candidate), migrated
@@ -24,6 +24,11 @@ from .const import (
    CONTENT_URL, FILES_DIR, MAX_PLANS_BYTES, MAX_PLANS_FILES, MAX_PLANS_LISTED,
    MAX_SIGN_PATHS,
    PLANS_DIR, PLANS_URL,
+    VERSION,
+)
+from .coordinate_canonicalization import (
+    canonicalize_config_geometry,
+    canonicalize_layout_geometry,
 )
 from .auth import may_write
 from .import_export import (
@@ -55,11 +60,21 @@ from .virtual_lights import (
    async_virtual_light_snapshot,
 )
 from .registry_snapshot import import_registry_snapshot
+from .projection import project_config, project_layout
+from .wall_segment_model import (
+    WALL_SEGMENT_MODEL_VERSION,
+    WallSegmentMigrationError,
+    commit_wall_segment_model,
+)
+from .junction_limits import JunctionLimitError, validate_junction_limits
 from .validation import (
    CONFIG_SCHEMA, LAYOUT_SCHEMA, MAX_CONFIG_BYTES, MAX_PLAN_BYTES,
-    PLAN_EXTENSIONS, POS_SCHEMA, MarkerControlError, sanitize_filename,
+    PLAN_EXTENSIONS, POS_SCHEMA, MarkerControlError, OpeningPassageError,
+    PartitionOpeningHostError, PartitionOpeningJambMarginError,
+    WallModelClientOutdatedError, sanitize_filename,
+    validate_opening_passages, validate_partition_opening_hosts,
    validate_marker_controls, validate_marker_light_entities,
-    validate_marker_value_badges, valid_space_id,
+    validate_marker_value_badges, validate_wall_model_transition, valid_space_id,
 )


@@ -136,6 +151,7 @@ def async_register(hass: HomeAssistant) -> None:
    websocket_api.async_register_command(hass, ws_config_set)
    websocket_api.async_register_command(hass, ws_plan_optimize)
    websocket_api.async_register_command(hass, ws_plan_optimize_undo)
+    websocket_api.async_register_command(hass, ws_space_delete)
    websocket_api.async_register_command(hass, ws_plan_set)
    websocket_api.async_register_command(hass, ws_plans_list)
    websocket_api.async_register_command(hass, ws_plans_delete)
@@ -263,6 +279,7 @@ async def _commit_import_pair(
        vol.Required("type"): "houseplan/export/create",
        vol.Required("kind"): vol.In(["full", "space"]),
        vol.Optional("space_id"): str,
+        vol.Optional("plan_only", default=False): bool,
        vol.Optional("card_version", default=""): str,
    }
 )
@@ -287,6 +304,7 @@ async def ws_export_create(hass: HomeAssistant, connection, msg: dict[str, Any])
                    layout_data,
                    kind=msg["kind"],
                    space_id=msg.get("space_id"),
+                    plan_only=msg.get("plan_only", False),
                    card_version=msg.get("card_version", ""),
                    config_root=Path(hass.config.path("")),
                )
@@ -422,8 +440,12 @@ async def ws_import_apply(hass: HomeAssistant, connection, msg: dict[str, Any])
            if kind == "full":
                backup = {
                    "kind": "import",
-                    "config": config_data.get("config") or DEFAULT_CONFIG,
-                    "layout": layout_data.get("layout") or {},
+                    "config": canonicalize_config_geometry(
+                        config_data.get("config") or DEFAULT_CONFIG
+                    ),
+                    "layout": canonicalize_layout_geometry(
+                        layout_data.get("layout") or {}
+                    ),
                    "created": int(time.time()),
                    "after_config_rev": new_config_rev,
                    "after_layout_rev": new_layout_rev,
@@ -440,16 +462,20 @@ async def ws_import_apply(hass: HomeAssistant, connection, msg: dict[str, Any])
                final_metadata[_OPTIMIZE_BACKUP] = backup
            pending = {
                "kind": "import",
-                "config": target_config,
-                "layout": target_layout,
+                "config": canonicalize_config_geometry(target_config),
+                "layout": canonicalize_layout_geometry(target_layout),
                "config_rev": new_config_rev,
                "layout_rev": new_layout_rev,
                "final_metadata": final_metadata,
            }
            rollback = {
                "kind": "import_rollback",
-                "config": config_data.get("config") or DEFAULT_CONFIG,
-                "layout": layout_data.get("layout") or {},
+                "config": canonicalize_config_geometry(
+                    config_data.get("config") or DEFAULT_CONFIG
+                ),
+                "layout": canonicalize_layout_geometry(
+                    layout_data.get("layout") or {}
+                ),
                "config_rev": config_rev,
                "layout_rev": layout_rev,
                "final_metadata": original_metadata,
@@ -492,6 +518,9 @@ async def ws_import_apply(hass: HomeAssistant, connection, msg: dict[str, Any])
        "layout_rev": new_layout_rev,
        "counts": details.get("counts", {}),
        "space_id": details.get("space_id"),
+        "repaired_target_refs": details.get("repaired_target_refs", 0),
+        "preserved_unresolved_refs": details.get("preserved_unresolved_refs", 0),
+        "reference_report": details.get("reference_report", {}),
        "can_undo": kind == "full",
    })

@@ -511,10 +540,15 @@ def _live_layout(config: dict[str, Any], layout: dict[str, Any]) -> dict[str, An
    return live_layout(config, layout)


-@websocket_api.websocket_command({vol.Required("type"): "houseplan/layout/get"})
+@websocket_api.websocket_command(
+    {
+        vol.Required("type"): "houseplan/layout/get",
+        vol.Optional("space_id"): vol.All(str, vol.Length(min=1, max=200)),
+    }
+)
@websocket_api.async_response
 async def ws_layout_get(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
-    """Return the saved layout."""
+    """Return the saved layout, optionally narrowed to one space (#256)."""
    rt = _runtime(hass, connection, msg["id"])
    if rt is None:
        return
@@ -522,7 +556,9 @@ async def ws_layout_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
    config_data = await rt.config_store.async_load() or {}
    connection.send_result(
        msg["id"], {
-            "layout": data.get("layout", {}),
+            "layout": project_layout(
+                data.get("layout", {}), space_id=msg.get("space_id"),
+            ),
            "rev": int(data.get("rev", 0)),
            "can_optimize_undo": _optimizer_backup_is_current(config_data, data),
            "undo_kind": _undo_kind(config_data, data),
@@ -562,6 +598,9 @@ async def ws_layout_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
            )
            return
        layout = _live_layout(config_data.get("config") or {}, msg["layout"])
+        if layout == data.get("layout", {}):
+            connection.send_result(msg["id"], {"ok": True, "rev": current_rev})
+            return
        new_rev = current_rev + 1
        await async_save_layout_state(
            rt, data, layout, new_rev,
@@ -623,7 +662,10 @@ async def ws_layout_update(hass: HomeAssistant, connection, msg: dict[str, Any])
            return
        data = await rt.store.async_load() or {}
        layout = data.get("layout", {})
-        layout[msg["device_id"]] = msg["pos"]
+        if layout.get(msg["device_id"]) == msg["pos"]:
+            connection.send_result(msg["id"], {"ok": True, "rev": int(data.get("rev", 0))})
+            return
+        layout = {**layout, msg["device_id"]: msg["pos"]}
        # keep the revision: a point-wise write used to drop it, which made the
        # optimistic locking on layout/set meaningless — every drag reset the
        # counter to 0 (HP-1454-08)
@@ -731,7 +773,10 @@ async def ws_geometry_repair(hass: HomeAssistant, connection, msg: dict[str, Any
            rt, data, new_layout, new_rev,
            metadata={
                **_optimizer_backup_after_layout_maintenance(data, new_rev),
-                "repair_backup": {"space": space_id, "positions": touched},
+                "repair_backup": {
+                    "space": space_id,
+                    "positions": canonicalize_layout_geometry(touched),
+                },
            },
            remove=("repair_backup",),
        )
@@ -1054,7 +1099,20 @@ async def ws_layout_delete(hass: HomeAssistant, connection, msg: dict[str, Any])
 # ---------------- space configuration ----------------


-@websocket_api.websocket_command({vol.Required("type"): "houseplan/config/get"})
+_PROJECTION_FIELDS = vol.All([vol.All(str, vol.Length(min=1, max=100))], vol.Length(max=50))
+
+
+@websocket_api.websocket_command(
+    {
+        vol.Required("type"): "houseplan/config/get",
+        # Проекция ответа (#256). Все параметры необязательны, и без них ответ
+        # прежний — это главный инвариант: ни один существующий клиент не
+        # должен заметить появление этой возможности.
+        vol.Optional("space_id"): vol.All(str, vol.Length(min=1, max=200)),
+        vol.Optional("fields"): _PROJECTION_FIELDS,
+        vol.Optional("marker_fields"): _PROJECTION_FIELDS,
+    }
+)
@websocket_api.async_response
 async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
    """Return the configuration, its revision, and whether this user may write.
@@ -1062,6 +1120,11 @@ async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
    `can_write` is the single source of truth for the card's editor chrome
    (audit P0-4): the UI must mirror `may_write`, not a hard-coded is_admin
    check that drifted from the integration option.
+
+    Optional `space_id`/`fields`/`marker_fields` narrow ONLY the returned
+    document (#256). Revisions and capability flags are computed from the whole
+    stored configuration: a caller that asked for one floor must not receive a
+    revision that describes only that floor.
    """
    rt = _runtime(hass, connection, msg["id"])
    if rt is None:
@@ -1085,12 +1148,20 @@ async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
    connection.send_result(
        msg["id"],
        {
-            "config": config,
+            "config": project_config(
+                config,
+                space_id=msg.get("space_id"),
+                fields=msg.get("fields"),
+                marker_fields=msg.get("marker_fields"),
+            ),
            "rev": config_rev,
            "virtual_lights": virtual_lights,
            "can_write": may_write(hass, getattr(connection, "user", None)),
            "can_optimize_undo": _optimizer_backup_is_current(data, layout_data),
            "undo_kind": _undo_kind(data, layout_data),
+            # #295: the card compares this against its own version to decide
+            # whether the «update House Plan» preflight hint can actually help.
+            "integration_version": VERSION,
        },
    )

@@ -1199,7 +1270,9 @@ def _missing_internal_attachments(
@websocket_api.websocket_command(
    {
        vol.Required("type"): "houseplan/config/set",
-        vol.Required("config"): CONFIG_SCHEMA,
+        # Semantic stale-client detection needs the stored v8 document and
+        # therefore runs inside the write lock before CONFIG_SCHEMA.
+        vol.Required("config"): dict,
        vol.Optional("expected_rev"): int,
    }
 )
@@ -1249,12 +1322,26 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
        # the lossless controls array. Validate only edges introduced by this
        # write so an unrelated edit can still round-trip a legacy broken ref.
        try:
+            validate_wall_model_transition(msg["config"], data.get("config"))
+            validated_config = CONFIG_SCHEMA(msg["config"])
+            msg["config"].clear()
+            msg["config"].update(validated_config)
            validate_marker_controls(msg["config"], data.get("config"))
            validate_marker_light_entities(msg["config"], data.get("config"))
            validate_marker_value_badges(msg["config"], data.get("config"))
-        except MarkerControlError as err:
+            validate_opening_passages(msg["config"], data.get("config"))
+            validate_partition_opening_hosts(msg["config"], data.get("config"))
+            validate_junction_limits(msg["config"], data.get("config"))
+        except (
+            JunctionLimitError, MarkerControlError, OpeningPassageError,
+            PartitionOpeningHostError, PartitionOpeningJambMarginError,
+            WallModelClientOutdatedError,
+        ) as err:
            connection.send_error(msg["id"], err.code, str(err))
            return
+        except vol.Invalid as err:
+            connection.send_error(msg["id"], "invalid_format", str(err))
+            return
        # An internal plan url must name a file that exists. The card can pick a
        # plan and then delete it from the same dialog, and two clients can do
        # the same thing in either order — the lock serialises them but says
@@ -1272,6 +1359,17 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
                "Plan file no longer exists: " + ", ".join(sorted(missing)),
            )
            return
+        if msg["config"] == data.get("config"):
+            # A semantic no-op still has to reconcile Repairs with external
+            # file-system changes. It must not create a revision, event, or
+            # discard the optimizer snapshot merely to refresh diagnostics.
+            entry = get_entry(hass)
+            if entry is not None:
+                from .repairs import async_check_plan_files
+
+                hass.async_create_task(async_check_plan_files(hass, entry))
+            connection.send_result(msg["id"], {"ok": True, "rev": int(current_rev)})
+            return
        new_rev = current_rev + 1
        await async_save_config_state(
            rt,
@@ -1311,10 +1409,197 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
 # ---------------- whole-plan maintenance ----------------


+def _space_marker_dependencies(
+    config: dict[str, Any], layout: dict[str, Any], space_id: str,
+) -> list[str]:
+    """Active marker ids that make deleting a space unsafe (deduplicated)."""
+    space = next(
+        (item for item in config.get("spaces") or [] if item.get("id") == space_id),
+        None,
+    )
+    room_ids = {
+        str(room.get("id")) for room in (space or {}).get("rooms") or []
+        if room.get("id") is not None
+    }
+    dependencies = {
+        str(marker.get("id"))
+        for marker in config.get("markers") or []
+        if marker.get("removed") is not True
+        and marker.get("id") is not None
+        and (
+            marker.get("space") == space_id
+            or (
+                marker.get("room_id") is not None
+                and str(marker.get("room_id")) in room_ids
+            )
+            or (layout.get(str(marker.get("id"))) or {}).get("s") == space_id
+        )
+    }
+    return sorted(dependencies)
+
+
+def _space_delete_candidate(
+    config: dict[str, Any], layout: dict[str, Any], space_id: str,
+) -> tuple[dict[str, Any], dict[str, Any], list[str], int]:
+    """Return a pure exact pair; blockers leave both inputs unchanged."""
+    candidate_config = json.loads(json.dumps(config))
+    candidate_layout = json.loads(json.dumps(layout))
+    dependencies = _space_marker_dependencies(candidate_config, candidate_layout, space_id)
+    spaces = candidate_config.get("spaces") or []
+    deleting_last_space = len(spaces) == 1 and spaces[0].get("id") == space_id
+    if dependencies and not deleting_last_space:
+        return candidate_config, candidate_layout, dependencies, 0
+    space = next(
+        (item for item in candidate_config.get("spaces") or []
+         if item.get("id") == space_id),
+        None,
+    )
+    room_ids = {
+        str(room.get("id")) for room in (space or {}).get("rooms") or []
+        if room.get("id") is not None
+    }
+    candidate_config["spaces"] = [
+        item for item in candidate_config.get("spaces") or []
+        if item.get("id") != space_id
+    ]
+    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
+        references_deleted_space = (
+            marker.get("space") == space_id
+            or (
+                marker.get("room_id") is not None
+                and str(marker.get("room_id")) in room_ids
+            )
+            or (
+                isinstance(marker_position, dict)
+                and marker_position.get("s") == space_id
+            )
+        )
+        if deleting_last_space and references_deleted_space:
+            marker.pop("space", None)
+            marker.pop("room_id", None)
+            continue
+        if marker.get("removed") is not True:
+            continue
+        if marker.get("space") == space_id:
+            marker.pop("space", None)
+        if (marker.get("room_id") is not None
+                and str(marker.get("room_id")) in room_ids):
+            marker.pop("room_id", None)
+    removed_layout = 0
+    for key in list(candidate_layout):
+        position = candidate_layout.get(key)
+        if isinstance(position, dict) and position.get("s") == space_id:
+            del candidate_layout[key]
+            removed_layout += 1
+    return candidate_config, candidate_layout, dependencies, removed_layout
+
+
+@websocket_api.websocket_command(
+    {
+        vol.Required("type"): "houseplan/space/delete",
+        vol.Required("space_id"): str,
+        vol.Required("expected_config_rev"): int,
+        vol.Required("expected_layout_rev"): int,
+    }
+)
+@websocket_api.async_response
+async def ws_space_delete(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
+    """Delete one space as a crash-recoverable config/layout pair."""
+    if not _check_write(hass, connection):
+        connection.send_error(msg["id"], "unauthorized", "Only editors may delete spaces")
+        return
+    rt = _runtime(hass, connection, msg["id"])
+    if rt is None:
+        return
+    space_id = msg["space_id"]
+    if not valid_space_id(space_id):
+        connection.send_error(msg["id"], "invalid_space_id", "Invalid space id")
+        return
+
+    try:
+        async with rt.write_lock:
+            config_data = await rt.config_store.async_load() or {}
+            layout_data = await rt.store.async_load() or {}
+            config_rev = int(config_data.get("rev", 0))
+            layout_rev = int(layout_data.get("rev", 0))
+            if (msg["expected_config_rev"] != config_rev
+                    or msg["expected_layout_rev"] != layout_rev):
+                connection.send_error(msg["id"], "conflict", "Plan changed elsewhere")
+                return
+            current_config = config_data.get("config") or DEFAULT_CONFIG
+            current_layout = layout_data.get("layout") or {}
+            if not any(
+                item.get("id") == space_id for item in current_config.get("spaces") or []
+            ):
+                connection.send_error(msg["id"], "space_not_found", "Space no longer exists")
+                return
+            target_config, target_layout, dependencies, removed_layout = (
+                _space_delete_candidate(current_config, current_layout, space_id)
+            )
+            spaces = current_config.get("spaces") or []
+            deleting_last_space = (
+                len(spaces) == 1 and spaces[0].get("id") == space_id
+            )
+            if dependencies and not deleting_last_space:
+                connection.send_error(
+                    msg["id"], "space_in_use",
+                    f"Space is still used by {len(dependencies)} active marker(s)",
+                )
+                return
+            target_config = CONFIG_SCHEMA(target_config)
+            target_layout = LAYOUT_SCHEMA(target_layout)
+            new_config_rev = config_rev + 1
+            new_layout_rev = layout_rev + 1
+            original_metadata = _layout_metadata(layout_data)
+            final_metadata = {
+                key: value for key, value in original_metadata.items()
+                if key not in {_OPTIMIZE_BACKUP, _OPTIMIZE_PENDING, "repair_backup", "geom_pending"}
+            }
+            pending = {
+                "kind": "space_delete",
+                "config": canonicalize_config_geometry(target_config),
+                "layout": canonicalize_layout_geometry(target_layout),
+                "config_rev": new_config_rev,
+                "layout_rev": new_layout_rev,
+                "final_metadata": final_metadata,
+            }
+            rollback = {
+                "kind": "space_delete_rollback",
+                "config": canonicalize_config_geometry(current_config),
+                "layout": canonicalize_layout_geometry(current_layout),
+                "config_rev": config_rev,
+                "layout_rev": layout_rev,
+                "final_metadata": original_metadata,
+            }
+            await _commit_import_pair(rt, pending, rollback)
+    except ImportFailure as err:
+        _send_import_error(connection, msg["id"], err)
+        return
+    except vol.Invalid as err:
+        connection.send_error(msg["id"], "invalid_config", str(err))
+        return
+    except Exception:  # noqa: BLE001
+        _LOGGER.exception("House Plan space delete failed")
+        connection.send_error(msg["id"], "commit_failed", "Space delete failed")
+        return
+
+    hass.bus.async_fire("houseplan_config_updated", {"rev": new_config_rev})
+    hass.bus.async_fire("houseplan_layout_updated", {"rev": new_layout_rev})
+    _refresh_trail_recorder(hass)
+    connection.send_result(msg["id"], {
+        "ok": True,
+        "config_rev": new_config_rev,
+        "layout_rev": new_layout_rev,
+        "removed_layout": removed_layout,
+    })
+
+
@websocket_api.websocket_command(
    {
        vol.Required("type"): "houseplan/plan/optimize",
-        vol.Required("config"): CONFIG_SCHEMA,
+        vol.Required("config"): dict,
        vol.Required("layout"): LAYOUT_SCHEMA,
        vol.Required("expected_config_rev"): int,
        vol.Required("expected_layout_rev"): int,
@@ -1359,12 +1644,54 @@ async def ws_plan_optimize(hass: HomeAssistant, connection, msg: dict[str, Any])
        # layout transaction. It must enforce the same marker-link semantics
        # as config/set; otherwise a crafted client can persist a new cycle.
        try:
+            validate_wall_model_transition(msg["config"], config_data.get("config"))
+            try:
+                submitted_model = int(msg["config"].get("model_version", 0) or 0)
+            except (TypeError, ValueError):
+                submitted_model = WALL_SEGMENT_MODEL_VERSION
+            # Optimize is an explicit structural writer and therefore the
+            # server-side v7 -> v8 barrier as well. Current v8 candidates are
+            # validated verbatim: the backend must never invent lineage for a
+            # graph already authored by a current client.
+            candidate_config = CONFIG_SCHEMA(msg["config"])
+            # Keep the established public validation contract ahead of the
+            # structural migration barrier. A malformed passage can also make
+            # wall-host materialisation impossible, but callers must still get
+            # the actionable `invalid_passage_fields` code rather than the
+            # generic wall-model blocker.
+            validate_opening_passages(candidate_config, config_data.get("config"))
+            if submitted_model < WALL_SEGMENT_MODEL_VERSION:
+                candidate_config, _ = commit_wall_segment_model(candidate_config)
+            validated_config = CONFIG_SCHEMA(candidate_config)
+            migrated_size = len(json.dumps(validated_config, separators=(",", ":")))
+            if migrated_size > MAX_CONFIG_BYTES:
+                connection.send_error(
+                    msg["id"], "too_large",
+                    f"Configuration is {migrated_size // 1024} KB, "
+                    f"the limit is {MAX_CONFIG_BYTES // 1024} KB",
+                )
+                return
+            msg["config"].clear()
+            msg["config"].update(validated_config)
            validate_marker_controls(msg["config"], config_data.get("config"))
            validate_marker_light_entities(msg["config"], config_data.get("config"))
            validate_marker_value_badges(msg["config"], config_data.get("config"))
-        except MarkerControlError as err:
+            validate_opening_passages(msg["config"], config_data.get("config"))
+            validate_partition_opening_hosts(
+                msg["config"], config_data.get("config"),
+                allow_optimize_rehost=True,
+            )
+        except (
+            JunctionLimitError, MarkerControlError, OpeningPassageError,
+            PartitionOpeningHostError, PartitionOpeningJambMarginError,
+            WallModelClientOutdatedError,
+            WallSegmentMigrationError,
+        ) as err:
            connection.send_error(msg["id"], err.code, str(err))
            return
+        except vol.Invalid as err:
+            connection.send_error(msg["id"], "invalid_format", str(err))
+            return

        missing = await hass.async_add_executor_job(
            _missing_internal_plans,
@@ -1383,15 +1710,19 @@ async def ws_plan_optimize(hass: HomeAssistant, connection, msg: dict[str, Any])
        new_layout_rev = layout_rev + 1
        backup = {
            "kind": "optimize",
-            "config": config_data.get("config") or DEFAULT_CONFIG,
-            "layout": layout_data.get("layout", {}),
+            "config": canonicalize_config_geometry(
+                config_data.get("config") or DEFAULT_CONFIG
+            ),
+            "layout": canonicalize_layout_geometry(
+                layout_data.get("layout", {})
+            ),
            "created": int(time.time()),
            "after_config_rev": new_config_rev,
            "after_layout_rev": new_layout_rev,
        }
        pending = {
-            "config": msg["config"],
-            "layout": msg["layout"],
+            "config": canonicalize_config_geometry(msg["config"]),
+            "layout": canonicalize_layout_geometry(msg["layout"]),
            "config_rev": new_config_rev,
            "layout_rev": new_layout_rev,
            "clear_backup": False,
@@ -1461,8 +1792,12 @@ async def ws_plan_optimize_undo(hass: HomeAssistant, connection, msg: dict[str,

        backup = layout_data[_OPTIMIZE_BACKUP]
        restored_kind = str(backup.get("kind") or "optimize")
-        restored_config = backup.get("config") or DEFAULT_CONFIG
-        restored_layout = backup.get("layout") or {}
+        restored_config = canonicalize_config_geometry(
+            backup.get("config") or DEFAULT_CONFIG
+        )
+        restored_layout = canonicalize_layout_geometry(
+            backup.get("layout") or {}
+        )
        new_config_rev = config_rev + 1
        new_layout_rev = layout_rev + 1
        pending = {
@@ -8,7 +8,7 @@ public materials.
  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/`:
-  `cp dist/houseplan-card.js demo/srv/assets/`.
+  `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`.
@@ -0,0 +1,92 @@
+// #276: same-process incremental cost of coincident-partition reconciliation
+// inside the complete Optimize candidate pass on the deterministic large house.
+import { performance } from 'node:perf_hooks';
+
+import { makeLargeHouseFixture, LARGE_HOUSE_COUNTS } from './fixtures/large-house.mjs';
+import { optimizePlans } from '../test-build/plan-optimizer.js';
+
+const WARMUPS = 5;
+const SAMPLES = 20;
+const BATCH_SIZE = 10;
+const RELATIVE_OVERHEAD = 0.15;
+const ABSOLUTE_OVERHEAD_MS = 25;
+
+const fixture = makeLargeHouseFixture();
+const emptyReconciliation = (rawSpace, _model, walls) => ({
+  walls: walls || [],
+  partitions: Array.isArray(rawSpace?.partitions) ? rawSpace.partitions : [],
+  openings: Array.isArray(rawSpace?.openings) ? rawSpace.openings : [],
+  partitionsReconciled: 0,
+  openingsRehosted: 0,
+});
+const baseline = () => optimizePlans(fixture.config, {}, {}, {
+  reconcileCoincidentPartitions: emptyReconciliation,
+});
+const candidate = () => optimizePlans(fixture.config, {});
+const timed = (operation) => {
+  const start = performance.now();
+  for (let index = 0; index < BATCH_SIZE; index++) {
+    const result = operation();
+    if (!result || !result.report) throw new Error('Optimize candidate returned no report');
+  }
+  return (performance.now() - start) / BATCH_SIZE;
+};
+for (let index = 0; index < WARMUPS; index++) {
+  baseline();
+  candidate();
+}
+
+const baselineTimes = [];
+const candidateTimes = [];
+const overheadTimes = [];
+for (let index = 0; index < SAMPLES; index++) {
+  // ABBA/BAAB cancels first-order clock drift and balances cache/GC order;
+  // batching then averages timer noise before the paired p95 is computed.
+  const candidateFirst = index % 2 === 1;
+  const first = timed(candidateFirst ? candidate : baseline);
+  const second = timed(candidateFirst ? baseline : candidate);
+  const third = timed(candidateFirst ? baseline : candidate);
+  const fourth = timed(candidateFirst ? candidate : baseline);
+  const baselineMs = candidateFirst ? (second + third) / 2 : (first + fourth) / 2;
+  const candidateMs = candidateFirst ? (first + fourth) / 2 : (second + third) / 2;
+  baselineTimes.push(baselineMs);
+  candidateTimes.push(candidateMs);
+  overheadTimes.push(candidateMs - baselineMs);
+}
+
+const quantile = (values, ratio) => {
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+};
+const summary = (values) => ({
+  min: Math.min(...values),
+  median: quantile(values, 0.5),
+  p95: quantile(values, 0.95),
+  max: Math.max(...values),
+});
+const baselineSummary = summary(baselineTimes);
+const candidateSummary = summary(candidateTimes);
+const overheadSummary = summary(overheadTimes);
+const measuredOverheadP95 = Math.max(0, overheadSummary.p95);
+const relativeP95 = measuredOverheadP95
+  / Math.max(baselineSummary.p95, Number.EPSILON);
+const pass = measuredOverheadP95 <= ABSOLUTE_OVERHEAD_MS
+  && relativeP95 <= RELATIVE_OVERHEAD;
+const report = {
+  issue: 276,
+  fixture: LARGE_HOUSE_COUNTS,
+  warmups: WARMUPS,
+  samples: SAMPLES,
+  batchSize: BATCH_SIZE,
+  baseline: baselineSummary,
+  candidate: candidateSummary,
+  pairedOverhead: overheadSummary,
+  budgets: {
+    relativeOverhead: RELATIVE_OVERHEAD,
+    absoluteOverheadMs: ABSOLUTE_OVERHEAD_MS,
+  },
+  measured: { overheadP95Ms: measuredOverheadP95, relativeP95 },
+  pass,
+};
+console.log(JSON.stringify(report, null, 2));
+if (!pass) process.exitCode = 1;
@@ -0,0 +1,56 @@
+#!/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;
@@ -87,7 +87,7 @@ const viewport = { width: 1280, height: 900 };
 const { page, browser } = await launch(
  viewport, 1,
  ['--enable-precise-memory-info', '--js-flags=--expose-gc'],
-  {}, resolve(targetRoot, 'demo/srv'),
+  {}, resolve(targetRoot, 'demo/srv'), targetRoot,
 );
 await page.addScriptTag({
  content: `window.__hpAssertCardContract = ${assertCardContract.toString()};`,
@@ -20,6 +20,7 @@ const isometric = profile === 'large-house-isometric-v1';
 const planSnap = profile === 'large-house-plan-snap-v1';
 const requiresIsometric = isometric && existsSync(resolve(targetRoot, 'src/iso-projection.ts'));
 const requiresPlanSnap = planSnap && existsSync(resolve(targetRoot, 'src/plan-snap-overlay.ts'));
+const requiresWallFace = planSnap && existsSync(resolve(targetRoot, 'src/wall-face-graph.ts'));
 const fixture = makeLargeHouseFixture();
 if (planSnap) {
  for (const [floor, space] of fixture.config.spaces.entries()) {
@@ -42,6 +43,7 @@ const { page, browser } = await launch(
  ['--enable-precise-memory-info', '--js-flags=--expose-gc'],
  {},
  resolve(targetRoot, 'demo/srv'),
+  targetRoot,
 );
 await page.emulateMedia({ reducedMotion: 'reduce' });
 await page.addStyleTag({
@@ -65,6 +67,7 @@ try {
    const measuredSample = iteration - warmups;
    const row = await page.evaluate(async ({
      fixture, sample, cardContract, isometric, requiresIsometric, planSnap, requiresPlanSnap,
+      requiresWallFace,
    }) => {
      const frame = () => new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
      const until = async (predicate, timeout = 10000) => {
@@ -122,6 +125,7 @@ try {
        openingWallIndex: card._openingWallIndexCache ? 1 : 0,
        isoGeometry: card._isoGeometryCache?.size ?? 0,
        planSnapGeometry: card._planSnapGeometryCache ? 1 : 0,
+        wallFaceGraph: card._wallFaceGraphCache?.length ?? 0,
      });

      window.__card?.remove?.();
@@ -175,6 +179,13 @@ try {
      const loadLongTasks = startLongTaskWindow();
      const loadStarted = performance.now();
      host.replaceChildren(card);
+      if (requiresIsometric) {
+        if (typeof card._onLabsSnapshot !== 'function')
+          throw new Error('large-house-isometric-v1 candidate has no Labs fixture hook');
+        // The product flag expires at 1.65.0. Performance keeps exercising
+        // the dormant renderer without changing the public registry contract.
+        card._onLabsSnapshot({ active: Object.freeze(['iso']), space: '' });
+      }
      card.hass = hassFor(fixture.states);
      window.__hpAssertCardContract(card, cardContract);
      if (requiresIsometric && (typeof card._setProjection !== 'function'
@@ -232,6 +243,7 @@ try {
        const cacheValue = card._planSnapGeometryCache?.value ?? null;
        const configBefore = JSON.stringify(card._serverCfg);
        const callsBefore = wsCalls;
+        const wallFaceCacheBeforePointer = card._wallFaceGraphCache?.length ?? 0;
        const view = card._viewOr(card._baseVb());
        const rect = stage.getBoundingClientRect();
        const fromPlan = (x, y) => ({
@@ -284,13 +296,39 @@ try {
              === staticNodes,
          configStable: JSON.stringify(card._serverCfg) === configBefore,
          wsWrites: wsCalls - callsBefore,
+          wallFaceCacheStableOnPointer:
+            (card._wallFaceGraphCache?.length ?? 0) === wallFaceCacheBeforePointer,
        };
        if (requiresPlanSnap && (
          staticLines < fixture.counts.rooms || staticNodes < fixture.counts.rooms
          || !planSnapDiagnostics.cacheStable || !planSnapDiagnostics.domStable
          || !planSnapDiagnostics.configStable || planSnapDiagnostics.wsWrites !== 0
+          || !planSnapDiagnostics.wallFaceCacheStableOnPointer
          || !seenKinds.has('endpoint') || !seenKinds.has('line')
        )) throw new Error(`plan-snap structural contract failed: ${JSON.stringify(planSnapDiagnostics)}`);
+        if (requiresWallFace) {
+          const oldPath = card._path;
+          const oldDraftId = card._activeDraftId;
+          const oldCms = card._draftSegmentCms;
+          const beforePath = [[10, 10]];
+          card._path = [[10, 10], [20, 10]];
+          card._activeDraftId = 'perf-face-draft';
+          card._draftSegmentCms = [15];
+          const acceptedStarted = performance.now();
+          card._offerWallFaces(beforePath);
+          planSnapDiagnostics.wallFaceAcceptedClickMs = performance.now() - acceptedStarted;
+          planSnapDiagnostics.wallFaceCacheEntries = card._wallFaceGraphCache?.length ?? 0;
+          card._wallFaceBatch = null;
+          card._roomDialog = false;
+          card._path = oldPath;
+          card._activeDraftId = oldDraftId;
+          card._draftSegmentCms = oldCms;
+          if (planSnapDiagnostics.wallFaceAcceptedClickMs > 1000
+              || planSnapDiagnostics.wallFaceCacheEntries < 1
+              || planSnapDiagnostics.wallFaceCacheEntries > 4) {
+            throw new Error(`wall-face accepted-click contract failed: ${JSON.stringify(planSnapDiagnostics)}`);
+          }
+        }
        card._setMode('view');
        await card.updateComplete;
      }) : null;
@@ -308,7 +346,7 @@ try {
          target: null,
        };
        card._rszEdgeDown(quietEvent, room.id, 1);
-        const plan = card._rszDrag?.plan;
+        const plan = card._resize?.plan;
        if (!plan) throw new Error('large-house resize plan was not created');
        const target = [
          plan.a[0] + plan.n[0] * card._gridPitch,
@@ -410,7 +448,7 @@ try {
      return result;
    }, {
      fixture, sample: measuredSample, cardContract: LARGE_HOUSE_CARD_CONTRACT,
-      isometric, requiresIsometric, planSnap, requiresPlanSnap,
+      isometric, requiresIsometric, planSnap, requiresPlanSnap, requiresWallFace,
    });
    if (measuredSample >= 0) rows.push(row);
  }
@@ -0,0 +1,96 @@
+// #199: same-process production-builder baseline versus the complete Optimize
+// preflight wrapper on the deterministic 3-floor large-house fixture.
+import { performance } from 'node:perf_hooks';
+
+import { makeLargeHouseFixture, LARGE_HOUSE_COUNTS } from './fixtures/large-house.mjs';
+import {
+  checkOptimizeGeometry,
+  prepareSpacePhysicalGeometryInputs,
+} from '../test-build/plan-geometry-preflight.js';
+import { spaceModels } from '../test-build/space-geometry.js';
+import {
+  floorFootprintGeometry,
+  wallBodiesGeometry,
+} from '../test-build/wall-thickness.js';
+
+const WARMUPS = 3;
+const SAMPLES = 20;
+const ABSOLUTE_P95_MS = 250;
+const RELATIVE_RATIO = 1.2;
+const RELATIVE_NOISE_MS = 15;
+
+const fixture = makeLargeHouseFixture();
+const models = spaceModels(fixture.config);
+const prepared = fixture.config.spaces.map((space, index) =>
+  prepareSpacePhysicalGeometryInputs(space, models[index]));
+
+const directProductionPass = () => {
+  for (const input of prepared) {
+    const hasWalls = input.walls.length > 0 || input.physicalBodies.length > 0;
+    const united = hasWalls
+      ? wallBodiesGeometry(
+          input.space.rooms, input.walls, input.openCuts, input.roomOpenings,
+          input.wallKeyPitch, input.cellCm, input.gridPitch, input.coordScale,
+          input.physicalBodies,
+        )
+      : null;
+    if (hasWalls && united == null) throw new Error(`baseline wall failure: ${input.space.id}`);
+    if (input.space.rooms.length && united?.paperGeom == null) {
+      const floor = floorFootprintGeometry(
+        input.space.rooms, input.walls, input.openCuts,
+        input.wallKeyPitch, input.cellCm, input.gridPitch, input.coordScale,
+      );
+      if (floor == null) throw new Error(`baseline floor failure: ${input.space.id}`);
+    }
+  }
+};
+
+const completePreflight = () => {
+  const result = checkOptimizeGeometry(fixture.config);
+  if (!result.ok || result.spaces.length !== LARGE_HOUSE_COUNTS.floors
+      || result.spaces.some((space) => space.status !== 'ok')) {
+    throw new Error(`candidate preflight failure: ${JSON.stringify(result.spaces)}`);
+  }
+};
+
+const sample = (operation) => {
+  const start = performance.now();
+  operation();
+  return performance.now() - start;
+};
+const run = (operation) => {
+  for (let index = 0; index < WARMUPS; index++) operation();
+  return Array.from({ length: SAMPLES }, () => sample(operation));
+};
+const quantile = (values, ratio) => {
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+};
+const summary = (values) => ({
+  min: Math.min(...values),
+  median: quantile(values, 0.5),
+  p95: quantile(values, 0.95),
+  max: Math.max(...values),
+});
+
+const baseline = summary(run(directProductionPass));
+const candidate = summary(run(completePreflight));
+const relativeLimit = baseline.p95 * RELATIVE_RATIO + RELATIVE_NOISE_MS;
+const pass = candidate.p95 <= ABSOLUTE_P95_MS && candidate.p95 <= relativeLimit;
+const report = {
+  issue: 199,
+  fixture: LARGE_HOUSE_COUNTS,
+  warmups: WARMUPS,
+  samples: SAMPLES,
+  baseline,
+  candidate,
+  budgets: {
+    absoluteP95Ms: ABSOLUTE_P95_MS,
+    relativeRatio: RELATIVE_RATIO,
+    relativeNoiseMs: RELATIVE_NOISE_MS,
+    relativeLimitP95Ms: relativeLimit,
+  },
+  pass,
+};
+console.log(JSON.stringify(report, null, 2));
+if (!pass) process.exitCode = 1;
@@ -0,0 +1,107 @@
+// #277: same-run historical edge-drag baseline versus the fixed-topology
+// pointer clamp, plus the exact one-space production preflight used on release.
+import { performance } from 'node:perf_hooks';
+
+import { makeLargeHouseFixture, LARGE_HOUSE_COUNTS } from './fixtures/large-house.mjs';
+import {
+  planEdgeDrag, clampEdgeDrag,
+  resolveSafeResize, clampSafeResize, applySafeResize,
+  safeResizeCachedDeltaCount,
+} from '../test-build/resize.js';
+import { checkOptimizeGeometry } from '../test-build/plan-geometry-preflight.js';
+
+const WARMUPS = 5;
+const SAMPLES = 20;
+const BATCH = 25;
+const POINTER_P95_MS = 16;
+const POINTER_RATIO = 1.2;
+const POINTER_NOISE_MS = 0.25;
+const PREFLIGHT_P95_MS = 75;
+
+const rooms = [{ id: 'active', poly: [[0, 0], [300, 0], [300, 300], [0, 300]] }];
+for (let index = 0; index < 199; index++) {
+  const x = 1000 + (index % 20) * 500;
+  const y = Math.floor(index / 20) * 500;
+  rooms.push({ id: `room-${index}`, poly: [[x, y], [x + 300, y], [x + 300, y + 300], [x, y + 300]] });
+}
+const opts = { minDim: 25, eps: 0.1, movingHalf: 10, obstacles: [] };
+const oldPlan = planEdgeDrag(rooms, 'active', 1);
+const safeResolution = resolveSafeResize(rooms, [], 'active', 1, opts);
+if (!oldPlan || !safeResolution.enabled) throw new Error('benchmark fixture is not resize-eligible');
+const safePlan = safeResolution.plan;
+
+const baselinePointer = () => clampEdgeDrag(rooms, [], oldPlan, 100, 5, opts);
+const safePointer = () => {
+  const delta = clampSafeResize(rooms, [], safePlan, 100, 5, opts);
+  return applySafeResize(rooms, [], safePlan, delta);
+};
+const large = makeLargeHouseFixture();
+const currentSpaceConfig = { ...large.config, spaces: [large.config.spaces[0]] };
+const precomputeStart = performance.now();
+const cachedProductionGeometry = checkOptimizeGeometry(currentSpaceConfig);
+const renderPrecomputeMs = performance.now() - precomputeStart;
+if (!cachedProductionGeometry.ok
+    || cachedProductionGeometry.spaces.some((space) => space.status === 'failed')) {
+  throw new Error(`safe-resize preflight fixture failed: ${JSON.stringify(cachedProductionGeometry.spaces)}`);
+}
+// The final preview frame owns the expensive production union. pointerup reads
+// the exact cached result for that cfg epoch; this measures commit latency, not
+// the existing large-house render budget measured by benchmark:large-house.
+const preflight = () => {
+  if (!cachedProductionGeometry.ok) throw new Error('cached production geometry failed');
+  return cachedProductionGeometry.fingerprint;
+};
+
+const timedBatch = (operation) => {
+  const start = performance.now();
+  for (let index = 0; index < BATCH; index++) operation();
+  return (performance.now() - start) / BATCH;
+};
+for (let index = 0; index < WARMUPS; index++) {
+  baselinePointer(); safePointer(); preflight();
+}
+const baselineTimes = [];
+const safeTimes = [];
+for (let index = 0; index < SAMPLES; index++) {
+  const safeFirst = index % 2 === 1;
+  const first = timedBatch(safeFirst ? safePointer : baselinePointer);
+  const second = timedBatch(safeFirst ? baselinePointer : safePointer);
+  const third = timedBatch(safeFirst ? baselinePointer : safePointer);
+  const fourth = timedBatch(safeFirst ? safePointer : baselinePointer);
+  baselineTimes.push(safeFirst ? (second + third) / 2 : (first + fourth) / 2);
+  safeTimes.push(safeFirst ? (first + fourth) / 2 : (second + third) / 2);
+}
+const preflightTimes = Array.from({ length: SAMPLES }, () => {
+  const start = performance.now(); preflight(); return performance.now() - start;
+});
+const quantile = (values, ratio) => {
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+};
+const summary = (values) => ({
+  min: Math.min(...values), median: quantile(values, 0.5),
+  p95: quantile(values, 0.95), max: Math.max(...values),
+});
+const baseline = summary(baselineTimes);
+const candidate = summary(safeTimes);
+const commitPreflight = summary(preflightTimes);
+const relativeLimit = baseline.p95 * POINTER_RATIO + POINTER_NOISE_MS;
+const pass = candidate.p95 <= POINTER_P95_MS
+  && candidate.p95 <= relativeLimit
+  && commitPreflight.p95 <= PREFLIGHT_P95_MS
+  && safeResizeCachedDeltaCount(safePlan) <= 4096;
+console.log(JSON.stringify({
+  issue: 277,
+  fixture: { rooms: rooms.length, largeHouse: LARGE_HOUSE_COUNTS },
+  warmups: WARMUPS, samples: SAMPLES, batch: BATCH,
+  baseline, candidate, commitPreflight,
+  renderPrecomputeMs,
+  cacheEntries: safeResizeCachedDeltaCount(safePlan),
+  budgets: {
+    pointerP95Ms: POINTER_P95_MS, pointerRatio: POINTER_RATIO,
+    pointerNoiseMs: POINTER_NOISE_MS, relativeLimit,
+    commitPreflightP95Ms: PREFLIGHT_P95_MS, maxCacheEntries: 4096,
+  },
+  pass,
+}, null, 2));
+if (!pass) process.exitCode = 1;
@@ -0,0 +1,78 @@
+// #277: warm Resize-layer render cost on the supported large-house ceiling.
+// The deterministic snapshot-call assertion catches the original regression
+// even when runner timing noise happens to keep the p95 below its budget.
+import { makeLargeHouseFixture, LARGE_HOUSE_COUNTS } from './fixtures/large-house.mjs';
+import { launch } from './serve.mjs';
+
+const WARMUPS = 3;
+const SAMPLES = 20;
+const RENDER_P95_MS = 25;
+const fixture = makeLargeHouseFixture();
+const config = { ...fixture.config, spaces: [fixture.config.spaces[0]] };
+const { page, browser } = await launch();
+
+const result = await page.evaluate(async ({ config, warmups, samples }) => {
+  const card = window.__card;
+  card._serverCfg = structuredClone(config);
+  card._space = config.spaces[0].id;
+  card._modelCache = null;
+  card._cfgEpoch++;
+  card._setMode('plan');
+  card._tool = 'resize';
+  card.requestUpdate();
+  await card.updateComplete;
+
+  const view = card._viewOr(card._baseVb());
+  const originalSnapshot = card._rszSnapshot.bind(card);
+  let snapshotCalls = 0;
+  card._rszSnapshot = () => {
+    snapshotCalls++;
+    return originalSnapshot();
+  };
+
+  for (let index = 0; index < warmups; index++) card._renderResizeLayer(view);
+  snapshotCalls = 0;
+  const times = [];
+  for (let index = 0; index < samples; index++) {
+    const started = performance.now();
+    card._renderResizeLayer(view);
+    times.push(performance.now() - started);
+  }
+  card._rszSnapshot = originalSnapshot;
+  return {
+    times,
+    snapshotCalls,
+    roomCount: card._rszRooms().length,
+    handleCount: card._rszRooms().reduce((sum, room) => sum + room.poly.length, 0),
+  };
+}, { config, warmups: WARMUPS, samples: SAMPLES });
+
+await browser.close();
+const quantile = (values, ratio) => {
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+};
+const render = {
+  min: Math.min(...result.times),
+  median: quantile(result.times, 0.5),
+  p95: quantile(result.times, 0.95),
+  max: Math.max(...result.times),
+};
+const pass = result.snapshotCalls === SAMPLES
+  && result.roomCount === 20
+  && result.handleCount === 80
+  && render.p95 <= RENDER_P95_MS;
+console.log(JSON.stringify({
+  issue: 277,
+  fixture: LARGE_HOUSE_COUNTS,
+  warmups: WARMUPS,
+  samples: SAMPLES,
+  roomCount: result.roomCount,
+  handleCount: result.handleCount,
+  snapshotCalls: result.snapshotCalls,
+  snapshotCallsPerFrame: result.snapshotCalls / SAMPLES,
+  render,
+  budgets: { renderP95Ms: RENDER_P95_MS, maxSnapshotCallsPerFrame: 1 },
+  pass,
+}, null, 2));
+if (!pass) process.exitCode = 1;
@@ -0,0 +1,118 @@
+// #278: component projection overhead and degraded-fixture completion budget.
+import { performance } from 'node:perf_hooks';
+import { readFileSync } from 'node:fs';
+
+import { makeLargeHouseFixture, LARGE_HOUSE_COUNTS } from './fixtures/large-house.mjs';
+import { prepareSpacePhysicalGeometryInputs } from '../test-build/plan-geometry-preflight.js';
+import { spaceModels } from '../test-build/space-geometry.js';
+import {
+  polyclipToPathD, wallBodiesGeometry, wallBodiesUnionPath,
+} from '../test-build/wall-thickness.js';
+
+const WARMUPS = 3;
+const SAMPLES = 50;
+// One projection is sub-millisecond. Time a batch and report per-operation
+// cost so scheduler/timer quantisation cannot dominate the 10% relative gate.
+const VALID_BATCH = 100;
+const RELATIVE_RATIO = 1.1;
+const OVERHEAD_P95_MS = 20;
+const DEGRADED_P95_MS = 100;
+
+const prepare = (config) => {
+  const models = spaceModels(config);
+  return config.spaces.map((space, index) =>
+    prepareSpacePhysicalGeometryInputs(space, models[index]));
+};
+const args = (input) => [
+  input.space.rooms, input.walls, input.openCuts, input.roomOpenings,
+  input.wallKeyPitch, input.cellCm, input.gridPitch, input.coordScale,
+  input.physicalBodies,
+];
+const large = makeLargeHouseFixture();
+const validInputs = prepare(large.config);
+const degradedFixture = JSON.parse(readFileSync(
+  new URL('../test/fixtures/278-wall-union-isolation.json', import.meta.url), 'utf8',
+));
+const degradedInput = prepare(degradedFixture.config)[0];
+
+const validResults = validInputs.map((input) => wallBodiesGeometry(...args(input)));
+if (validResults.some((result) => result.status !== 'ok'))
+  throw new Error(`valid geometry: ${validResults.map((result) => result.status).join(',')}`);
+const validGeometry = () => {
+  for (const result of validResults) {
+    // The previous production projection also serialized primary + paper.
+    if (!polyclipToPathD(result.geom) || !polyclipToPathD(result.paperGeom))
+      throw new Error('valid legacy projection');
+  }
+};
+const validProjection = () => {
+  for (const result of validResults) {
+    const paths = result.components.map((component) => polyclipToPathD(component.geom));
+    const paper = polyclipToPathD(result.paperGeom);
+    if (!paths.length || paths.some((path) => !path) || !paper)
+      throw new Error('valid component projection');
+  }
+};
+const degradedProjection = () => {
+  const result = wallBodiesUnionPath(...args(degradedInput));
+  if (!result || result.status !== 'degraded-extra' || result.paths.length !== 2)
+    throw new Error(`degraded projection: ${result?.status || 'null'}`);
+};
+const timed = (operation, iterations = 1) => {
+  const started = performance.now();
+  for (let index = 0; index < iterations; index++) operation();
+  return performance.now() - started;
+};
+const run = (operation) => {
+  for (let index = 0; index < WARMUPS; index++) operation();
+  return Array.from({ length: SAMPLES }, () => timed(operation));
+};
+const runPairs = () => {
+  for (let index = 0; index < WARMUPS; index++) {
+    validGeometry();
+    validProjection();
+  }
+  const baseline = [], candidate = [], overhead = [];
+  for (let index = 0; index < SAMPLES; index++) {
+    let baseMs, candidateMs;
+    if (index % 2 === 0) {
+      baseMs = timed(validGeometry, VALID_BATCH) / VALID_BATCH;
+      candidateMs = timed(validProjection, VALID_BATCH) / VALID_BATCH;
+    } else {
+      candidateMs = timed(validProjection, VALID_BATCH) / VALID_BATCH;
+      baseMs = timed(validGeometry, VALID_BATCH) / VALID_BATCH;
+    }
+    baseline.push(baseMs);
+    candidate.push(candidateMs);
+    overhead.push(candidateMs - baseMs);
+  }
+  return { baseline, candidate, overhead };
+};
+const quantile = (values, ratio) => {
+  const sorted = [...values].sort((a, b) => a - b);
+  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * ratio) - 1)];
+};
+const summary = (values) => ({
+  min: Math.min(...values), median: quantile(values, 0.5),
+  p95: quantile(values, 0.95), max: Math.max(...values),
+});
+
+const pairs = runPairs();
+const baseline = summary(pairs.baseline);
+const candidate = summary(pairs.candidate);
+const degraded = summary(run(degradedProjection));
+const relativeLimit = baseline.p95 * RELATIVE_RATIO;
+const overheadP95 = quantile(pairs.overhead, 0.95);
+const pass = candidate.p95 <= relativeLimit && overheadP95 <= OVERHEAD_P95_MS
+  && degraded.p95 <= DEGRADED_P95_MS;
+console.log(JSON.stringify({
+  issue: 278, fixture: LARGE_HOUSE_COUNTS, warmups: WARMUPS, samples: SAMPLES,
+  validBatch: VALID_BATCH,
+  baseline, candidate, degraded, overheadP95,
+  budgets: {
+    relativeRatio: RELATIVE_RATIO, overheadP95Ms: OVERHEAD_P95_MS,
+    relativeLimitP95Ms: relativeLimit, degradedP95Ms: DEGRADED_P95_MS,
+  },
+  pass,
+}, null, 2));
+if (!pass) process.exitCode = 1;
@@ -29,3 +29,32 @@ export async function assertFreshDemoBundle(page, root = process.cwd()) {
  }
  return expected;
 }
+
+/** Env switch that lets a debugging session run against a stale bundle. */
+export const ALLOW_STALE_BUNDLE = 'HP_ALLOW_STALE_BUNDLE';
+
+/**
+ * The freshness gate for every browser check, escape hatch included (#236).
+ *
+ * The smoke launcher had no freshness check at all, while golden runs and
+ * benchmarks did. A smoke against a stale `demo/srv/assets/houseplan-card.js`
+ * does not fail cleanly: on #234 three assertions went red and a fourth went
+ * GREEN, because the old code was wrong in two places that agreed with each
+ * other. A partly-red partly-green result looks like a logic defect and sends
+ * the reader hunting in the wrong file.
+ *
+ * Skipping is allowed for debugging, but never silently: a skipped guard that
+ * says nothing is the same silent success this project keeps digging out.
+ */
+export async function assertFreshDemoBundleUnlessAllowed(
+  page, root = process.cwd(), env = process.env,
+) {
+  if (env[ALLOW_STALE_BUNDLE]) {
+    console.warn(
+      `[houseplan] ${ALLOW_STALE_BUNDLE} is set — bundle freshness NOT verified. `
+      + 'A red result may mean a stale bundle rather than a defect (#236).',
+    );
+    return null;
+  }
+  return assertFreshDemoBundle(page, root);
+}
@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+// Issue #211: human-reviewable Reference SVG <-> Runtime matrix.
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { mdiLightbulbSpot } from '@mdi/js';
+import { launch } from './serve.mjs';
+
+const artifactDir = resolve('artifacts/device-icon-reference');
+mkdirSync(artifactDir, { recursive: true });
+
+const referenceAsset = (theme, file, coreSize) => {
+  let source = readFileSync(resolve('demo/srv/reference/device-icons', theme, file), 'utf8');
+  if (file === 'Lock.svg') {
+    const old = theme === 'Dark' ? '#252525' : 'black';
+    source = source.replaceAll(old, '#66D17A');
+    if (theme === 'Dark') source = source.replaceAll('fill="white"', 'fill="#252525"');
+  }
+  if (file === 'Unlock.svg') {
+    source = source.replaceAll(theme === 'Dark' ? '#1DC21D' : '#F0A00C', '#F0410C');
+  }
+  const nativeWidth = Number(source.match(/<svg[^>]*width="([\d.]+)"/)?.[1] || 127);
+  return {
+    url: `data:image/svg+xml;base64,${Buffer.from(source).toString('base64')}`,
+    displayWidth: nativeWidth * coreSize / 80,
+  };
+};
+
+const { page, browser } = await launch(
+  { width: 1280, height: 960 }, 1, [], { colorScheme: 'dark' },
+);
+
+await page.evaluate((path) => { window.__ICONS['mdi:lightbulb-spot'] = path; }, mdiLightbulbSpot);
+
+await page.evaluate(async () => {
+  const c = window.__card;
+  const marker = (id, patch) => ({
+    ...(c._serverCfg.markers || []).find((item) => item.id === id),
+    id, binding: `device:${id}`, ...patch,
+  });
+  const replacements = new Map([
+    ['d_light1', marker('d_light1', { display: 'badge', icon: 'mdi:lightbulb-spot' })],
+    ['d_tv', marker('d_tv', { display: 'value' })],
+    ['d_temp', marker('d_temp', {
+      display: 'badge',
+      value_badge: {
+        enabled: true,
+        source: { kind: 'entity_state', entity_id: 'sensor.living_temp' },
+        position: 'right',
+      },
+    })],
+  ]);
+  c._serverCfg.markers = [
+    ...(c._serverCfg.markers || []).filter((item) => !replacements.has(item.id)),
+    ...replacements.values(),
+  ];
+  c.hass = {
+    ...c.hass,
+    states: {
+      ...c.hass.states,
+      'sensor.living_temp': {
+        ...c.hass.states['sensor.living_temp'],
+        state: '23',
+        attributes: { ...c.hass.states['sensor.living_temp']?.attributes, unit_of_measurement: '%' },
+      },
+      'media_player.tv': {
+        ...c.hass.states['media_player.tv'],
+        state: 'Working',
+      },
+    },
+  };
+  c._regSignature = '';
+  c._cfgEpoch++;
+  c._maybeRebuildDevices();
+  c._setMode('view');
+  c.requestUpdate();
+  await c.updateComplete;
+  const qaStyle = document.createElement('style');
+  qaStyle.textContent = '.devtip{display:none!important}';
+  (c.renderRoot || c.shadowRoot).append(qaStyle);
+  await new Promise((resolveFrame) => requestAnimationFrame(() => requestAnimationFrame(resolveFrame)));
+});
+
+const selector = (id) => `.dev[data-id="${id}"]`;
+
+async function runtimePng(theme, row, size) {
+  await page.mouse.move(1, 1);
+  await page.evaluate(({ id, themeName, classes, px, clearValues }) => {
+    const node = (window.__card.renderRoot || window.__card.shadowRoot)
+      .querySelector(`.dev[data-id="${id}"]`);
+    for (const marker of (window.__card.renderRoot || window.__card.shadowRoot).querySelectorAll('.dev'))
+      marker.style.visibility = marker === node ? 'visible' : 'hidden';
+    node.classList.remove(...[
+      'theme-light', 'theme-dark', 'on', 'open', 'alarm', 'unavail', 'virtual',
+      'sel', 'lock-locked', 'lock-unlocked',
+    ]);
+    node.classList.add(`theme-${themeName}`, ...classes);
+    node.style.setProperty('--device-base-size', `${px}px`);
+    node.style.setProperty('--dev-scale', '1');
+    node.querySelector('.device-core')?.style.setProperty('transition', 'none');
+    node.querySelector('.device-shell-frame')?.style.setProperty('transition', 'none');
+    if (clearValues) node.querySelectorAll('.value-badge').forEach((value) => value.remove());
+    node.blur();
+  }, {
+    id: row.id,
+    themeName: theme.toLowerCase(),
+    classes: row.classes || [],
+    px: size,
+    clearValues: row.clearValues || false,
+  });
+  if (row.hover) {
+    await page.hover(selector(row.id));
+    await page.waitForTimeout(180);
+  }
+  if (row.focus) {
+    await page.$eval(selector(row.id), (node) => node.focus());
+  }
+  await page.$eval(selector(row.id), (node) => {
+    for (const tooltip of (window.__card.renderRoot || window.__card.shadowRoot).querySelectorAll('.devtip'))
+      tooltip.style.setProperty('display', 'none', 'important');
+    node.querySelector('.lqi')?.style.setProperty('display', 'none');
+  });
+  const clip = await page.$eval(selector(row.id), (node) => {
+    const shell = node.querySelector('.device-shell-frame').getBoundingClientRect();
+    const pad = 22;
+    return {
+      x: Math.max(0, shell.left - pad),
+      y: Math.max(0, shell.top - pad),
+      width: shell.width + pad * 2,
+      height: shell.height + pad * 2,
+    };
+  });
+  return (await page.screenshot({ clip })).toString('base64');
+}
+
+const rows = [
+  { label: 'Default', file: 'Icon Default.svg', id: 'd_light1' },
+  { label: 'Hover', file: 'Icon Hover.svg', id: 'd_light1', hover: true },
+  { label: 'Active', file: 'Icon Active.svg', id: 'd_light1', classes: ['on'] },
+  { label: 'Lock', file: 'Lock.svg', id: 'd_lock', classes: ['lock-locked'] },
+  { label: 'Unlock', file: 'Unlock.svg', id: 'd_lock', classes: ['lock-unlocked'] },
+  { label: 'Selected', file: 'Selected.svg', id: 'd_light1', classes: ['sel'] },
+  { label: 'Focus', file: 'Focus Visible.svg', id: 'd_light1', focus: true },
+  { label: 'Alert', file: 'Alert Value.svg', id: 'd_temp', classes: ['alarm'] },
+  { label: 'Virtual', file: 'Virtual Device Default.svg', id: 'd_motion', classes: ['virtual'] },
+  { label: 'Unavailable', file: 'Unavailable.svg', id: 'd_light1', classes: ['unavail'] },
+  { label: 'Text', file: 'Text Default.svg', id: 'd_tv' },
+  { label: 'Double Right', file: 'Double Default Right.svg', id: 'd_temp' },
+];
+
+const matrix = [];
+for (const theme of ['Light', 'Dark']) {
+  for (const row of rows) {
+    matrix.push({
+      theme,
+      row,
+      size: 56,
+      runtime: await runtimePng(theme, row, 56),
+    });
+  }
+  for (const size of [32, 96]) {
+    const row = rows[0];
+    matrix.push({ theme, row, size, runtime: await runtimePng(theme, row, size) });
+  }
+  const textRow = rows.find((row) => row.label === 'Text');
+  matrix.push({ theme, row: textRow, size: 96, runtime: await runtimePng(theme, textRow, 96) });
+}
+
+const escapeHtml = (value) => String(value)
+  .replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+const body = matrix.map(({ theme, row, size, runtime }) => {
+  const reference = referenceAsset(theme, row.file, size);
+  return `
+  <tr>
+    <td>${theme}</td><td>${escapeHtml(row.label)}</td><td>${size}px</td>
+    <td class="preview"><img style="width:${reference.displayWidth}px" src="${reference.url}" alt="Reference ${escapeHtml(row.label)}"></td>
+    <td class="preview runtime"><img src="data:image/png;base64,${runtime}" alt="Runtime ${escapeHtml(row.label)}"></td>
+  </tr>`;
+}).join('');
+const html = `<!doctype html>
+<html><head><meta charset="utf-8"><title>Device icon reference/runtime matrix</title>
+<style>
+  body{margin:24px;background:#777;color:#111;font:16px system-ui,sans-serif}
+  h1,p{max-width:1100px} table{border-collapse:collapse;width:100%;background:#aaa}
+  th,td{border:1px solid #555;padding:8px;text-align:left} th{position:sticky;top:0;background:#ddd;z-index:2}
+  .preview{width:38%;text-align:center;background:linear-gradient(135deg,#d5d5d5 50%,#666 50%)}
+  .preview img{display:block;margin:auto;max-width:300px;max-height:180px}.runtime img{image-rendering:auto}
+</style></head><body>
+<h1>House Plan device icons: package 1.1.1 vs runtime</h1>
+<p>Issues #211/#217. Reference SVG is loaded directly from the designer package; Runtime is a fresh browser capture. Default covers 32/56/96 px and Text has an additional large 96 px row so its outer stadium curvature is reviewable. Dark Unlock is evaluated using the owner's amber override from #179.</p>
+<table><thead><tr><th>Theme</th><th>State/layout</th><th>Core</th><th>Reference SVG</th><th>Runtime</th></tr></thead>
+<tbody>${body}</tbody></table></body></html>`;
+const htmlPath = resolve(artifactDir, 'device-icons-reference-runtime.html');
+writeFileSync(htmlPath, html);
+
+await page.setViewportSize({ width: 1600, height: 1000 });
+await page.setContent(html, { waitUntil: 'load' });
+await page.screenshot({
+  path: resolve(artifactDir, 'device-icons-reference-runtime.png'),
+  fullPage: true,
+});
+await browser.close();
+console.log(`OK device icon reference/runtime matrix: ${htmlPath}`);
@@ -0,0 +1,85 @@
+/** 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 }));
@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import { createHash } from 'node:crypto';
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { visualFingerprint } from '../../scripts/source-fingerprint.mjs';
+import { assertFreshDemoBundle } from '../bundle-freshness.mjs';
+import { goldenClip, prepareGoldenScenario } from '../golden/harness.mjs';
+import { launch } from '../serve.mjs';
+import { DOC_SCREENSHOT_VERSION, DOC_SCREENSHOTS } from './screenshots.mjs';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
+const OUTPUT = resolve(ROOT, 'docs/images');
+const BUNDLE = resolve(ROOT, 'dist/houseplan-card.js');
+const DEMO_BUNDLE = resolve(ROOT, 'demo/srv/assets/houseplan-card.js');
+const INTEGRATION_BUNDLE = resolve(ROOT, 'custom_components/houseplan/frontend/houseplan-card.js');
+const SCRIPT = fileURLToPath(import.meta.url);
+const sha256 = (value) => createHash('sha256').update(value).digest('hex');
+
+
+const roomCardClip = (page) => page.evaluate(() => {
+  const card = window.__goldenCard;
+  const roomCards = [...(card?.renderRoot?.querySelectorAll('.roomlabel') || [])];
+  const target = roomCards.find((item) => item.querySelector('.rlm')) || roomCards[0];
+  if (!target) throw new Error('documentation room card is missing');
+  const rect = target.getBoundingClientRect();
+  const marginX = 80;
+  const marginY = 70;
+  return {
+    x: Math.max(0, rect.left - marginX),
+    y: Math.max(0, rect.top - marginY),
+    width: Math.min(innerWidth, rect.right + marginX) - Math.max(0, rect.left - marginX),
+    height: Math.min(innerHeight, rect.bottom + marginY) - Math.max(0, rect.top - marginY),
+  };
+});
+
+/**
+ * Documentation-only presentation state. Keep these mutations out of the
+ * golden harness: changing that release fixture would invalidate every visual
+ * baseline even though the production component and golden matrix are intact.
+ */
+const applyDocumentationState = (page, scenario) => page.evaluate(async (current) => {
+  const frame = () => new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
+  const card = window.__goldenCard;
+  if (!card) throw new Error(`documentation card is missing: ${current.id}`);
+
+  if (current.title) {
+    card.setConfig({ ...card._config, title: current.title });
+  }
+
+  if (current.roomMetrics) {
+    const space = card._serverCfg?.spaces?.find((item) => item.id === current.space);
+    if (!space) throw new Error(`documentation room metrics space is missing: ${current.space}`);
+    space.settings = {
+      ...(space.settings || {}),
+      label_temp: true,
+      label_hum: true,
+      label_lqi: true,
+      label_light: true,
+    };
+    card._cfgEpoch += 1;
+    card._modelCache = null;
+  }
+
+  if (current.fixture === 'empty') {
+    card._serverCfg = { ...(card._serverCfg || {}), spaces: [] };
+    card._cfgEpoch += 1;
+    card._modelCache = null;
+    card._space = '';
+    card._onboardingShown = true;
+    card.hass = { ...card.hass, floors: {} };
+    card._openSpaceDialog('create');
+  }
+
+  if (current.dialog === 'device-info') {
+    const device = card._devices.find((item) => item.id === current.deviceId);
+    if (!device) throw new Error(`documentation device is missing: ${current.deviceId}`);
+    card._infoCard = device;
+  }
+
+  card.requestUpdate();
+  await card.updateComplete;
+  await frame();
+
+  if (current.devicePresentationPreview) {
+    const dialog = card.renderRoot.querySelector('hp-dialog');
+    const body = dialog?.querySelector('.body');
+    const preview = dialog?.querySelector('hp-device-preview');
+    await preview?.updateComplete;
+    if (!body || !preview)
+      throw new Error('documentation device presentation preview is missing');
+    const bodyRect = body.getBoundingClientRect();
+    const previewRect = preview.getBoundingClientRect();
+    body.scrollTop += previewRect.top - bodyRect.top - 180;
+    await frame();
+    const visibleBody = body.getBoundingClientRect();
+    const visiblePreview = preview.getBoundingClientRect();
+    if (visiblePreview.top < visibleBody.top - 1 || visiblePreview.bottom > visibleBody.bottom + 1)
+      throw new Error('documentation viewport does not show the device presentation preview');
+  }
+
+  return { dialog: !!card.renderRoot.querySelector('hp-dialog') };
+}, scenario);
+
+mkdirSync(OUTPUT, { recursive: true });
+copyFileSync(BUNDLE, DEMO_BUNDLE);
+copyFileSync(BUNDLE, INTEGRATION_BUNDLE);
+
+const { page, browser } = await launch();
+const browserErrors = [];
+page.on('pageerror', (error) => browserErrors.push(error.message));
+
+try {
+  // Свежесть бандла проверяется строго, вместе с версией: картинки обязаны
+  // приехать из бандла, собранного из ЭТОГО дерева. А в манифест пишется
+  // версионно-нечувствительный отпечаток (#245) — номер версии на скриншотах
+  // не виден, и требовать из-за него пересъёмки нечестно.
+  await assertFreshDemoBundle(page, ROOT);
+  const fingerprint = visualFingerprint(ROOT);
+  const scenarios = {};
+  for (const scenario of DOC_SCREENSHOTS) {
+    await prepareGoldenScenario(page, scenario);
+    const runtime = await applyDocumentationState(page, scenario);
+    if (scenario.expectDialog && !runtime.dialog)
+      throw new Error(`documentation scenario did not open its dialog: ${scenario.id}`);
+    const clip = scenario.capture === 'room-card'
+      ? await roomCardClip(page)
+      : await goldenClip(page, scenario.capture);
+    const image = await page.screenshot({
+      ...(clip ? { clip } : {}), animations: 'disabled', caret: 'hide', scale: 'css',
+    });
+    writeFileSync(resolve(OUTPUT, scenario.file), image);
+    scenarios[scenario.id] = {
+      file: scenario.file,
+      viewport: scenario.viewport,
+      theme: scenario.theme,
+      language: scenario.language,
+      sourceSha256: fingerprint,
+      imageSha256: sha256(image),
+    };
+    console.log(`captured ${scenario.id} -> docs/images/${scenario.file}`);
+  }
+  if (browserErrors.length) throw new Error(`browser errors: ${browserErrors.join(' | ')}`);
+  const manifest = {
+    version: DOC_SCREENSHOT_VERSION,
+    fixture: 'synthetic-only',
+    // Кто снимал. Смена браузера переписывает все картинки без содержательных
+    // изменений (#246), поэтому окружение съёмки — часть доказательства.
+    chromium: browser.version(),
+    sourceFingerprint: fingerprint,
+    captureScriptSha256: sha256(readFileSync(SCRIPT)),
+    command: 'npm run build && node demo/docs/capture.mjs',
+    scenarios,
+  };
+  writeFileSync(resolve(OUTPUT, 'screenshots.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+} finally {
+  await browser.close();
+}
@@ -0,0 +1,75 @@
+/**
+ * Каталог сценариев съёмки документации. Отдельным модулем, потому что его
+ * читают трое: сам капчур, `scripts/check-docs.mjs` и приёмка артефакта
+ * `scripts/docs-accept.mjs` (#246). Импортировать его из `capture.mjs` нельзя —
+ * тот скрипт при импорте поднимает браузер и снимает картинки.
+ */
+export const DOC_SCREENSHOT_VERSION = 1;
+export const DOC_SCREENSHOTS = Object.freeze([
+  {
+    id: 'view-desktop', file: '01-view-desktop.png', fixture: 'visual',
+    space: 'golden-lighting', mode: 'view', roomMetrics: true,
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 900 }, capture: 'page',
+  },
+  {
+    id: 'view-touch', file: '02-view-touch.png', fixture: 'visual',
+    space: 'golden-lighting', mode: 'view', roomMetrics: true, kiosk: true,
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 390, height: 760 }, capture: 'page',
+  },
+  {
+    id: 'space-create', file: '03-space-create.png', fixture: 'empty', noFloors: true,
+    title: 'House Plan', language: 'en', theme: 'dark',
+    viewport: { width: 900, height: 850 }, capture: 'page', expectDialog: true,
+  },
+  {
+    id: 'room-contour-close', file: '04-room-contour-close.png', fixture: 'visual',
+    space: 'golden-geometry', mode: 'plan',
+    wallJunctionPreview: {
+      path: [[0.18, 0.18], [0.40, 0.18], [0.40, 0.40], [0.18, 0.40]],
+      pointer: [0.18, 0.18], cms: [440, 440, 440], cm: 15,
+    },
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 900 }, capture: 'page',
+  },
+  {
+    id: 'plan-context-tray', file: '05-plan-context-tray.png', fixture: 'visual',
+    space: 'golden-geometry', mode: 'plan', editorTray: 'plan-selection',
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 900 }, capture: 'page',
+  },
+  {
+    id: 'device-editor', file: '06-device-editor.png', fixture: 'visual',
+    space: 'golden-lighting', dialog: 'device', deviceId: 'golden-light-two',
+    deviceName: 'Living-room ceiling light',
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 1100 }, capture: 'page', expectDialog: true,
+  },
+  {
+    id: 'device-display-preview', file: '06-device-display-preview.png', fixture: 'visual',
+    space: 'golden-lighting', dialog: 'device', deviceId: 'golden-light-two',
+    deviceName: 'Living-room ceiling light', devicePresentationPreview: true,
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 1100 }, capture: 'page', expectDialog: true,
+  },
+  {
+    id: 'background-editor', file: '07-background-editor.png', fixture: 'visual',
+    space: 'golden-geometry', mode: 'decor', editorTray: 'decor-selection',
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 900 }, capture: 'page',
+  },
+  {
+    id: 'room-card', file: '08-room-card.png', fixture: 'visual',
+    space: 'golden-lighting', mode: 'view', roomMetrics: true,
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1180, height: 900 }, capture: 'room-card',
+  },
+  {
+    id: 'device-info', file: '09-device-info.png', fixture: 'visual',
+    space: 'golden-lighting', mode: 'view', dialog: 'device-info',
+    deviceId: 'golden-light-two', deviceName: 'Living-room ceiling light',
+    title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
+    viewport: { width: 1000, height: 900 }, capture: 'page', expectDialog: true,
+  },
+]);
@@ -0,0 +1,59 @@
+// AC-13 for #157. Usage:
+//   node demo/downgrade_open_passage.mjs --bundle=/absolute/v1.64.0/dist/houseplan-card.js
+// The v1.64.0 frontend does not understand `passage`; this executable fixture
+// pins its documented best-effort fallback (door symbol) and, critically,
+// rejects any pageerror/unhandled exception while reading the newer literal.
+import { cpSync, existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { launch, checkAll, finish } from './serve.mjs';
+
+const value = process.argv.find((arg) => arg.startsWith('--bundle='))?.slice('--bundle='.length);
+if (!value) {
+  console.error('usage: node demo/downgrade_open_passage.mjs --bundle=/absolute/v1.64.0/houseplan-card.js');
+  process.exit(2);
+}
+const bundle = isAbsolute(value) ? value : resolve(value);
+if (!existsSync(bundle)) {
+  console.error(`v1.64.0 bundle not found: ${bundle}`);
+  process.exit(2);
+}
+
+const currentDemo = fileURLToPath(new URL('./srv', import.meta.url));
+const serveRoot = mkdtempSync(join(tmpdir(), 'hp-157-downgrade-'));
+let browser;
+try {
+  cpSync(currentDemo, serveRoot, { recursive: true });
+  cpSync(bundle, join(serveRoot, 'assets', 'houseplan-card.js'));
+  const launched = await launch(undefined, 1, [], {}, serveRoot);
+  browser = launched.browser;
+  const out = await launched.page.evaluate(async () => {
+    const card = window.__card;
+    const root = () => card.shadowRoot || card.renderRoot;
+    const space = card._serverCfg.spaces.find((item) => item.id === card._space);
+    space.openings = [{
+      id: 'future-passage', type: 'passage', x: 0.3, y: 0.14,
+      angle: 0, length: 0.09, future_material: 'stone',
+    }];
+    card._setMode('plan');
+    card._cfgEpoch++;
+    card.requestUpdate();
+    await card.updateComplete;
+    await new Promise((resolveFrame) => requestAnimationFrame(() => requestAnimationFrame(resolveFrame)));
+    const opening = root().querySelector('[data-hp="opening"][data-id="future-passage"]');
+    const stored = space.openings[0];
+    return {
+      newerLiteralLoads: !!opening,
+      documentedDoorFallback: !!opening?.querySelector('.op-leaf,.op-arc'),
+      readDoesNotRewriteConfig: stored.type === 'passage'
+        && stored.future_material === 'stone' && space.openings.length === 1,
+    };
+  });
+  checkAll(out);
+  await finish(browser, out);
+  browser = undefined;
+} finally {
+  await browser?.close?.();
+  rmSync(serveRoot, { recursive: true, force: true });
+}
@@ -3,6 +3,8 @@
 * visual-regression tooling. Nothing here depends on a real HA installation.
 */

+import { fixtureWallKey } from './wall-key.mjs';
+
 const FLOOR_COUNT = 3;
 const ROOMS_PER_FLOOR = 20;
 const DEVICE_COUNT = 200;
@@ -213,8 +215,14 @@ export const makeLargeHouseFixture = () => {
      cell_cm: 5,
      settings: { fill_mode: 'glow', show_borders: true, show_names: true },
      rooms,
-      walls: segments.map((wall, index) => ({
-        key: `perf-wall-${floor}-${index}`, cm: 15, a: wall.a, b: wall.b,
+      // The key must be the real one. A label like `perf-wall-0-3` does not
+      // parse as coordinates, so neither the exact match nor the tolerant
+      // fallback in lookupWall finds the record: every solid edge of this
+      // fixture resolved to zero thickness and the plan carried no wall bodies
+      // at all, while the same fixture backs four golden scenes and all six
+      // performance budgets (#260).
+      walls: segments.map((wall) => ({
+        key: fixtureWallKey(wall.a, wall.b), cm: 15, a: wall.a, b: wall.b,
      })),
      openings: makeOpenings(floor, segments, openingCount),
      partitions: makePartitions(floor, rooms, partitionCount),
@@ -0,0 +1,86 @@
+/**
+ * #314 anonymised dense-plan fixture.
+ *
+ * It preserves the structural shape of the owner's report without names,
+ * markers, layout, or original coordinates: 13 rooms, 44 catalogue walls,
+ * 24 intentional partitions, and one pre-existing two-point draft.  The last
+ * object is known debt and must remain the only invariant finding before and
+ * after drawing another room.
+ */
+import { WALL_KEY_PITCH } from './wall-key.mjs';
+
+export function makeV8DraftRegressionFixture() {
+  const step = WALL_KEY_PITCH;
+  const point = (x, y) => [x * step, y * step];
+  const segmentIds = new Map();
+  const wallSegments = [];
+  const keyOf = (a, b) => {
+    const left = `${a[0]},${a[1]}`;
+    const right = `${b[0]},${b[1]}`;
+    return left < right ? `${left}|${right}` : `${right}|${left}`;
+  };
+  const wallId = (a, b) => {
+    const key = keyOf(a, b);
+    let id = segmentIds.get(key);
+    if (!id) {
+      id = `wall-314-${String(wallSegments.length + 1).padStart(3, '0')}`;
+      segmentIds.set(key, id);
+      wallSegments.push({ id, a: [...a], b: [...b], cm: 15 });
+    }
+    return id;
+  };
+
+  const rooms = Array.from({ length: 13 }, (_, index) => {
+    const x0 = 4 + index * 12;
+    const x1 = x0 + 12;
+    const y0 = 4;
+    const y1 = 16;
+    const poly = [point(x0, y0), point(x1, y0), point(x1, y1)];
+    // Four split top edges make the catalogue population exactly 44 while
+    // keeping all rooms valid and non-overlapping.
+    if (index < 4) poly.push(point(x0 + 6, y1));
+    poly.push(point(x0, y1));
+    return {
+      id: `room-314-${String(index + 1).padStart(2, '0')}`,
+      name: `Room ${index + 1}`,
+      poly,
+      wall_ids: poly.map((a, edge) => wallId(a, poly[(edge + 1) % poly.length])),
+    };
+  });
+
+  const partitions = Array.from({ length: 24 }, (_, index) => {
+    const row = Math.floor(index / 8);
+    const x = 4 + (index % 8) * 18;
+    const y = 28 + row * 8;
+    return {
+      id: `partition-314-${String(index + 1).padStart(2, '0')}`,
+      a: point(x, y),
+      b: point(x + 8, y + 2),
+      cm: 15 + (index % 3) * 5,
+    };
+  });
+
+  if (wallSegments.length !== 44) {
+    throw new Error(`fixture catalogue drifted: expected 44, got ${wallSegments.length}`);
+  }
+
+  return {
+    model_version: 8,
+    spaces: [{
+      id: 'space-314-dense',
+      title: 'Dense regression fixture',
+      cell_cm: 5,
+      view_box: [0, 0, 400, 400],
+      rooms,
+      wall_segments: wallSegments,
+      partitions,
+      room_drafts: [{
+        id: 'draft-314-known-debt',
+        points: [point(4, 56), point(14, 64)],
+        segments: [{ id: 'wall-314-known-draft', cm: 15 }],
+      }],
+    }],
+    markers: [],
+    settings: {},
+  };
+}
@@ -4,22 +4,13 @@ const round = (value) => Number(value.toFixed(6));

 // Golden fixtures must use the same persisted wall-key contract as real plan
 // data. Arbitrary labels make every configured wall look virtual to the
-// renderer, which lets a visually ineffective baseline pass unnoticed.
-const WALL_KEY_PITCH = 1 / 240;
-export const fixtureWallKey = (a, b) => {
-  const quantize = (value) => Math.round(value / WALL_KEY_PITCH) * WALL_KEY_PITCH;
-  const mx = quantize((a[0] + b[0]) / 2);
-  const my = quantize((a[1] + b[1]) / 2);
-  let dx = b[0] - a[0], dy = b[1] - a[1];
-  const length = Math.hypot(dx, dy);
-  if (length < 1e-12) { dx = 1; dy = 0; }
-  else { dx /= length; dy /= length; }
-  if (dx < -1e-12 || (Math.abs(dx) <= 1e-12 && dy < 0)) { dx = -dx; dy = -dy; }
-  let angle = Math.atan2(dy, dx);
-  if (angle < 0) angle += Math.PI;
-  const bucket = Math.round(angle * 1800) / 1800;
-  return `${mx.toFixed(4)},${my.toFixed(4)}@${bucket.toFixed(4)}`;
-};
+// renderer, which lets a visually ineffective baseline pass unnoticed — and a
+// key that merely differs in precision is found only through the tolerant
+// fallback in lookupWall, which is luck rather than contract (#260). The
+// formula lives in one place for every fixture and is pinned to the product one
+// by test/fixture-wall-key.test.mjs.
+export { fixtureWallKey } from './wall-key.mjs';
+import { fixtureWallKey } from './wall-key.mjs';

 const uniqueEdges = (rooms) => {
  const edges = new Map();
@@ -57,6 +48,11 @@ const lightingRooms = [
    poly: [[0.50, 0.10], [0.93, 0.10], [0.93, 0.88], [0.50, 0.88]] },
 ];

+const applianceRooms = [
+  { id: 'appliance-room', name: 'Laundry', area: 'golden_appliance',
+    poly: [[0.08, 0.10], [0.92, 0.10], [0.92, 0.90], [0.08, 0.90]] },
+];
+
 const geometrySpace = {
  id: 'golden-geometry',
  title: 'Geometry matrix',
@@ -122,7 +118,25 @@ const lightingSpace = {
  decor: [],
 };

-const runtime = () => {
+const applianceSpace = {
+  id: 'golden-appliance',
+  title: 'Appliance lifecycle',
+  plan_url: null,
+  view_box: [0, 0, 1, 1],
+  cell_cm: 5,
+  settings: {
+    fill_mode: 'none', glow_enabled: false, show_borders: true, show_names: true,
+    sun_rays: false, bg_mode: 'static',
+  },
+  rooms: applianceRooms,
+  walls: wallsFor('appliance', applianceRooms, 15),
+  openings: [],
+  partitions: [],
+  wall_columns: [],
+  decor: [],
+};
+
+const runtime = (includeAppliance = false) => {
  const devices = {};
  const entities = {};
  const states = {
@@ -136,7 +150,8 @@ const runtime = () => {
  // The production projection must preserve them.
  const layout = {};
  const areas = Object.fromEntries(
-    [...geometryRooms, ...lightingRooms].map((room) => [room.area, { area_id: room.area, name: room.name }]),
+    [...geometryRooms, ...lightingRooms, ...(includeAppliance ? applianceRooms : [])]
+      .map((room) => [room.area, { area_id: room.area, name: room.name }]),
  );
  const add = (id, domain, area, x, y, state, attributes = {}) => {
    const entityId = `${domain}.${id.replaceAll('-', '_')}`;
@@ -171,6 +186,44 @@ const runtime = () => {
  add('golden-right-linkquality', 'sensor', 'golden_light_right', 0.66, 0.70, '190', {
    unit_of_measurement: 'lqi',
  });
+
+  if (includeAppliance) {
+    const washerId = 'golden-washer';
+    devices[washerId] = {
+      id: washerId,
+      name: 'Golden washing machine',
+      model: 'GOLDEN-WASHER-COMPOSITE',
+      area_id: 'golden_appliance',
+      identifiers: [['houseplan_golden', washerId]],
+      config_entries: ['golden_entry'],
+      entry_type: null,
+      via_device_id: null,
+      disabled_by: null,
+    };
+    const addWasherEntity = (entityId, state, attributes = {}, registry = {}) => {
+      entities[entityId] = {
+        entity_id: entityId,
+        device_id: washerId,
+        platform: 'houseplan_golden',
+        config_entry_id: 'golden_entry',
+        disabled_by: null,
+        ...registry,
+      };
+      states[entityId] = {
+        entity_id: entityId,
+        state,
+        attributes: { friendly_name: registry.original_name || entityId, ...attributes },
+      };
+    };
+    addWasherEntity('switch.golden_washer_power', 'on', {}, { original_name: 'Power' });
+    addWasherEntity('switch.golden_washer_child_lock', 'off', {}, { original_name: 'Child lock' });
+    addWasherEntity('sensor.golden_washer_status', 'done', {}, {
+      original_name: 'Status', translation_key: 'status',
+    });
+    addWasherEntity('sensor.golden_washer_stage', 'Rinse', {}, { original_name: 'Stage' });
+    addWasherEntity('sensor.golden_washer_program', 'mixed_wash', {}, { original_name: 'Program' });
+    layout[washerId] = { s: 'golden-appliance', x: 0.5, y: 0.5 };
+  }
  return { devices, entities, states, layout, areas };
 };

@@ -182,9 +235,12 @@ export const VISUAL_MATRIX_COUNTS = Object.freeze({
  columns: geometrySpace.wall_columns.length + lightingSpace.wall_columns.length,
 });

-export const makeVisualMatrixFixture = () => ({
+export const makeVisualMatrixFixture = ({ applianceLifecycle = false } = {}) => ({
  config: {
-    spaces: [structuredClone(geometrySpace), structuredClone(lightingSpace)],
+    spaces: [
+      structuredClone(geometrySpace), structuredClone(lightingSpace),
+      ...(applianceLifecycle ? [structuredClone(applianceSpace)] : []),
+    ],
    // A persisted marker is part of the fixture contract for scenarios that
    // override per-source Glow controls. The device/layout alone are not a
    // saved marker configuration and must not be silently treated as one.
@@ -201,6 +257,10 @@ export const makeVisualMatrixFixture = () => ({
      },
    },
  },
-  ...runtime(),
-  counts: VISUAL_MATRIX_COUNTS,
+  ...runtime(applianceLifecycle),
+  counts: applianceLifecycle ? {
+    ...VISUAL_MATRIX_COUNTS,
+    spaces: VISUAL_MATRIX_COUNTS.spaces + 1,
+    rooms: VISUAL_MATRIX_COUNTS.rooms + applianceRooms.length,
+  } : VISUAL_MATRIX_COUNTS,
 });
@@ -0,0 +1,63 @@
+/**
+ * Ключ записи толщины стены — один на все фикстуры проекта.
+ *
+ * Копия формулы из `src/wall-thickness.ts`, и копия здесь неизбежна. Фикстуры
+ * обязаны оставаться без внешних импортов: бэкенд-гейт запускает их как
+ * `node --input-type=module --eval "import * as f from './demo/fixtures/…'"`
+ * в job без `npm ci` и без `test-build/` (`.github/workflows/validate.yml`,
+ * job `backend`), а `scripts/source-fingerprint.mjs` хеширует только `src/**`
+ * и `.mjs` из `demo/fixtures` и `demo/golden` — код, втянутый из `scripts/`,
+ * менял бы поведение фикстуры при неизменном отпечатке, на котором стоят и
+ * валидность golden-эталонов, и переиспользование гейтов.
+ *
+ * Поэтому файл лежит ЗДЕСЬ, внутри `demo/fixtures`: так он попадает в
+ * отпечаток, и так его видит одна привязка вместо трёх копий формулы.
+ * `test/fixture-wall-key.test.mjs` сверяет его с продуктовым `wallKey`.
+ *
+ * Ловушка, из-за которой этот файл и появился (#260): точность зависит от шага.
+ * При `pitch = 1/240` продукт печатает ШЕСТЬ знаков, а не четыре — фикстура с
+ * четырьмя расходилась с продуктом на каждой записи и находилась только через
+ * терпимый запас `lookupWall`. Метка вместо ключа (`perf-wall-0-3`) не
+ * находилась вовсе: все сплошные рёбра оставались с нулевой толщиной.
+ */
+
+/** Шаг решётки редактора в нормализованных координатах (`GRID_N = 240`). */
+export const WALL_KEY_PITCH = 1 / 240;
+
+/** Направление стены по модулю 180°: стена одна и та же с любого конца. */
+const direction = (a, b) => {
+  let dx = b[0] - a[0], dy = b[1] - a[1];
+  const length = Math.hypot(dx, dy);
+  if (length < 1e-12) return [1, 0];
+  dx /= length; dy /= length;
+  if (dx < -1e-12 || (Math.abs(dx) <= 1e-12 && dy < 0)) return [-dx, -dy];
+  return [dx, dy];
+};
+
+/**
+ * Координата, отличающаяся от узла решётки не больше точности хранения, — это
+ * тот же узел (#258). Канонизация опознания, а не снап геометрии: произвольная
+ * точка вне решётки остаётся вне решётки. Без этого шага ничья округления на
+ * стене нечётной длины в шагах разводила один и тот же ключ на два.
+ */
+const keyEpsilon = (pitch) => Math.max(Math.abs(pitch) * 1e-6, 1e-9);
+const canonical = (value, pitch) => {
+  if (!(pitch > 0) || !Number.isFinite(value)) return value;
+  const snapped = Math.round(value / pitch) * pitch;
+  return Math.abs(snapped - value) <= keyEpsilon(pitch) ? snapped : value;
+};
+
+export const fixtureWallKey = (a, b, pitch = WALL_KEY_PITCH) => {
+  const quantise = (value) => (pitch > 0 && Number.isFinite(value)
+    ? Math.round(value / pitch) * pitch : value);
+  const ca = [canonical(a[0], pitch), canonical(a[1], pitch)];
+  const cb = [canonical(b[0], pitch), canonical(b[1], pitch)];
+  const mx = quantise((ca[0] + cb[0]) / 2);
+  const my = quantise((ca[1] + cb[1]) / 2);
+  const [dx, dy] = direction(ca, cb);
+  let angle = Math.atan2(dy, dx);
+  if (angle < 0) angle += Math.PI;
+  const bucket = Math.round(angle * 1800) / 1800;
+  const precision = pitch > 0 && pitch < 0.01 ? 6 : pitch < 1 ? 4 : 2;
+  return `${mx.toFixed(precision)},${my.toFixed(precision)}@${bucket.toFixed(4)}`;
+};
@@ -35,7 +35,7 @@ Build and copy the exact current source first:

 ```bash
 npm run build
-cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
+npm run bundle:sync
 npm run golden:capture
 ```

@@ -1,69 +1,140 @@
 {
  "schema": 1,
-  "matrixVersion": 22,
-  "acceptedAt": "2026-08-14T16:03:22.017Z",
-  "sourceFingerprint": "24117bcfb4c94d5421e0304612089743615233eab3911f065e8cfa003f48fa7d",
+  "matrixVersion": 48,
+  "acceptedAt": "2026-08-27T19:14:12.216Z",
+  "sourceFingerprint": "d3735b5ee1f41b4fbf52f95046ab81f8a4ca9e15b02b8b9ca4ff8e7eff3bb179",
  "chromium": "151.0.7922.34",
  "scenarios": {
+    "hidden-wall-diagnostics-plan-light": "37ba151aa6b1ea7b1b270d461ccca348444c5eeb14a5592bf045a0e69b0fb83e",
+    "hidden-wall-diagnostics-plan-dark": "565d5481f744704a2a6f18658b9b6fa65e7cdbfcd11b50a2bedbc0daae2d8488",
+    "coincident-partition-before-dark": "19626db704fccb7a42b519ffb20b7bad82c726e8845c752ab451f731d264561c",
+    "coincident-partition-thin-dark": "3afede1f99b86454bf4e50d9628196a2240243e034644592c5c3efa1b4561930",
+    "coincident-partition-thick-dark": "57960bd09e6cbbeb073561692690ca68a72d6dbf8242198ef73b8d4ae4d8fbcc",
+    "coincident-partition-virtual-dark": "da7adbf931ad95f4e620d9d088177f1da20d88a21b9e85b6ff2675925d5557b4",
+    "span-over-door-migrated-dark": "a817f5baacf5ff80d1f236ffaa176cb6331b75423393dae5b16e54f67f37c7e0",
    "split-corner-wall-before-dark": "3176dc67f54d5309f87c94e1077b4f69eb1db9f660469fbf97953038323430f3",
-    "split-corner-wall-thin-dark": "6da64905a3a4f8e4b4d457e5b20d2d55e0e7c2c601316a088c4bcc6557d35cc6",
-    "split-corner-wall-thick-dark": "494d559aa71ee85f90b8cfa11c1d3087fa123e963dec2b0975e7ce6c1520852a",
-    "isometric-geometry-view-dark": "4816ec4b22211c73765f9fac81741df685202d21df6b0fbc1649b23357086da3",
-    "isometric-geometry-view-light": "8ec81fc4f254ae6ebab55bc5f0ef5325a4e5d327cd1fb53bf5f293f06fbec671",
-    "isometric-live-layers-dark": "c841269f672c7ad8b208a549cc87592bd26f2a9e226f793a2b79592b65ee54c6",
-    "isometric-no-borders-dark": "36f972f95704bff81ea1a59bdf3cd2cf7b636ec7871780460e98b23e3ebc3da2",
-    "isometric-touch-kiosk-dark": "fd2e74c5966b4adcf4e66021e2cef781873f9a2b58f16ad19d57fb451ba45dc9",
-    "isometric-large-warm-remount-dark": "0afc1069d334f10be2d0ed135ee0eb52e9272a1a1ad1224e00f05753b8789d0c",
-    "geometry-view-dark-fit": "3df272f6c3c3d20e9e375ea037f3dbb885657b94b0b29d0067505f4a73741237",
-    "geometry-view-light-fit": "a7f2c9667d9872dd84a37d5318fd238c9eabcc0f413017eb19e02204587b4e1a",
-    "day-cycle-dawn-dark": "a573083c4ee21993cf2e482b60418a30e388a14117d056a2b0ea559a0c928039",
-    "day-cycle-day-dark": "6f24cd1d8669c9f3451c06ca5a5fd499d8f1ae2698a34f4a63ffee2e9e6b4330",
-    "day-cycle-dusk-dark": "80029577c25f8759090ee2550fe530a35c189806dd6fa26e887da4f5d1cf54a3",
-    "day-cycle-night-dark": "d855785914d3e11198d3e4671c1fbcad15104c95954bc1ed9b7366aa51aac65e",
-    "geometry-plan-editor-dark": "16364738754515e81e6d0ae13c0358db8c7f9d26c2f34dfde15f5855c6af13fa",
-    "plan-snap-endpoint-light": "c5f63ca2ca2706a062a2fc97e25670768662810bd7e0b251f0a9cfdbaf60c758",
-    "plan-snap-line-gaps-dark": "44808a816e62416b9c2c39a6e06cd4a8631860e178f246772ce8c7a46f98edd0",
-    "wall-junctions-plan-preview-light": "9e3a07da3e3ae1b2a95299f92b9500f347f0bfbd20d87429505b30769ee627c2",
-    "wall-junctions-plan-t-dark": "a4a958f20ed5f4b8d4e6bca9ebd1b289186c0cb48b48897a1624b49014f3ae5d",
-    "wall-junctions-view-dark": "73a64c65c8e77aa767bb7f401d68c61df5749e65e75273c85b0d6c72cb430766",
-    "isometric-wall-junctions-dark": "cb1e28f484b304ecda3e35f66e0c0429016d10a5a3022dcc9315a92eb537300f",
-    "opening-placement-door-thick-wall-dark": "395c03bbf5d968e83664fd6621f0ac25902e718022f2e92ffbcddb8ce629cf9c",
-    "geometry-devices-editor-dark": "a9e4846ce5453400b87e6ad3d575882bc23a07b59dc3eecb612ed872b0c871ec",
-    "geometry-decor-editor-dark": "435b36096bbb2996d56ff0af262ddebff4a727edd841b0fad9b8d4f507b987ac",
-    "tray-wide-selection-en": "06b0df980fd79e8bfc2957878966a11ae9d1a61e80ee870094dc60eae4de26bb",
-    "tray-wide-tool-ru": "e5a6b2057acd9af2c5417bf413778395112eb1ebecd784251c68c74a16b9dc5f",
-    "tray-medium-group-en": "5115910bc0f359ce91f361794a51ae1ae6a493203941d09166b412b696eda775",
-    "tray-medium-selection-ru": "4e5f235be8ed6296e136641d172e727a6a6b7a9d061f0928a96ccc1103c19f1f",
-    "tray-narrow-palette-en": "88b9846e4b451ed95b7ae7d2c3183a2ea191d7668768992a1364c6a7a53eb0c6",
-    "tray-narrow-tool-ru": "c4130715b3cb31c68619dfc706a3aa308e86edf272bfae6833b20666764ece2b",
-    "geometry-diagonal-45-opening-dark": "01206d25631c8fd09fa077932fbb5c1ee115b65ba76b38e6f7b09315dbbf6002",
-    "openings-thick-wall-dark": "5aa0b3d26894bef9ab9fca25c31bbef2f13f2c410f5f6d3f61c8d608ceb929f8",
-    "openings-filled-tunnel-dark": "167d92c11e6a8b3ff0f31177ac5905f8db4b5fb03ee78b4965c40bc45aeee50f",
-    "openings-hidden-view-dark": "c85cc04d1d8622b98215e2bb83f5bb233a7cfb0ac684c912475ef7bc44245897",
-    "lighting-glow-sun-dark": "a98eee332f25a43c8d9d126c118c8cfea4ee73752b1060227548efedaf0efcdd",
-    "device-value-badge-positions-dark": "1ad43f2bd866733aa75c34de38fb97d469661799b540a8ae22150067d788cec8",
-    "lighting-sun-window-state-only-dark": "3bd581a23a2e0ebba58530db5182adea5cba6ec10bc032bee024415c19108a17",
-    "lighting-fill-light-axis-split-dark": "4f867528aeb9124229f81659876b03ff297a3a7a92bc57ffb32d5c24913c4938",
-    "lighting-fill-temp-axis-split-dark": "e0535b70701c9fe6753f74c943b9f288a0fb1a23a9cfc8590d4945e0a1724eb5",
-    "lighting-fill-lqi-axis-split-dark": "485ab183144913569ddc11154553ab4ac7db522ab188de74d652b717dc786d9c",
-    "lighting-temp-glow-dark": "ecaed039fb6aab4e1fdc9f1856c89e5f563219b8ff813877027737cecbeca41a",
-    "lighting-temp-glow-light": "5bc8a35aaa94c427d465d198f1cd5eecfdc704f5abeded9e407f32ce93aa7d32",
-    "lighting-custom-glow-dark": "899e334dfc0d3490ca291b7239bf7b88ca9d1ef3be199ddf347314bab1513f27",
-    "lighting-opaque-glow-two-doorways-dark": "413f5a8e39193ba941f72955a391ccac954c09f24322b7bf67494c7691275980",
-    "lighting-custom-glow-light": "266bba4ae1744a884b2cd224b37fdc36447d57405a1c5298ca30027e2957cc8a",
-    "lighting-temp-glow-no-sources-dark": "5100c81543fc30a7934a6db6f9e67e2c4fa185df0a974be5911879e43c0d3fc9",
-    "lighting-temp-glow-room-override-dark": "0a35d3508526187ea18e44456cfb8cd9e578a1864e896fad1c3eec2892c753e0",
-    "lighting-manual-auto-spill-overlap-dark": "6324dbe2079a255e7a194720c8c19f210549ac734e564270bc1373e6385b9cac",
-    "hover-over-glow-dark": "fc14ba6f6b670e61c0fb5be277e67551ea2da7a06b5c167a8c2c989f1de08910",
-    "hover-nested-room-dark": "6c09526ad885c4555063def5b43287b41124a81d90972c425084dba6e622d055",
-    "large-house-zoom-040-dark": "5f11c4b78318a64c2a7cf803716661eea506609d4f0a6bb3d64a709f8c49db1d",
-    "large-house-zoom-250-dark": "c906426f888ff4e306c5c334c6329b387fc5ca368e229f55acc33c202351a1ac",
-    "large-house-warm-remount-dark": "6baf4baed1c735c64dfe1e69d9864ca287ffc0e8452d00e801f0873e98b187ee",
-    "device-dialog-desktop-en": "d6fcc83aa1335df1041e2b1aa445b0019d1e3567f98ef8f47a889894051f2b62",
-    "device-dialog-mobile-ru": "8cb928853ddacb61882804c3d00ead31da31bc4559ee6a8e293ef6b55cd5a463",
-    "device-help-popover-light-ru": "f1bf21d62a5dd349aa57b746069c5aef58d7a26b0b9d9e0c233fde0c1d56d7eb",
-    "decor-color-popover-mobile-ru": "46d4c2e4dd20c3a38e90efe3db59b3e878bdbcf273fbc1aa23de4b230723fa6e",
-    "backup-full-preview-desktop-en": "cc42a621f55f043b272014b9c32127823ca3573520e502966c71642027f7fdaf",
-    "backup-space-preview-mobile-ru": "16d06859ea6aac6cbed586f0d6918da972e9c95206fffd771fe43b6084f79877"
+    "split-corner-wall-thin-dark": "48062a49e12728c377a7c4352148381b1be2a5606b6792d754ae055b04c22be1",
+    "split-corner-wall-thick-dark": "a5d795eec4561e3a1aa9c37843fadddcb04d888d5a49e6ffacf29c17b7798568",
+    "split-zero-divider-taper-dark": "3de38befb41f15ef4047da1390e061b1b5756340142dd9204d011287ff39be5b",
+    "isometric-geometry-view-dark": "0d8427299c77e1e3bb86f37f53128a6640b6666e0b682e5f96085c4f07a657ec",
+    "isometric-geometry-view-light": "a3e592448ad3ad4ff65266f1fd6f31259c01a9baf47392f6b8be9811d74f8dce",
+    "isometric-live-layers-dark": "90fa1c0b64a12626e481c5f34e515c53b3e06cd657f5976bb8a72127aec3e1e9",
+    "isometric-no-borders-dark": "a0abf9fdc31092980de3bcbf8598844b6e3d152363694e9bd070d45af73c26d9",
+    "isometric-touch-kiosk-dark": "d3ae363165c4f0aba65bcbac9bd6bdca79f29aca03bba997f3abec1860eb1e55",
+    "isometric-large-warm-remount-dark": "de7733e6aeef7cf7b05cca9c8f6bb4aa627fd16ab2d4198659e24ff9fa3b5bda",
+    "geometry-view-dark-fit": "2d96e776ea9fc8a136896b58df30abb13a8a53e6c40e5b4f4e12c6dba522380f",
+    "geometry-view-light-fit": "60e8a908fc1c3be3ca5c9b82bf432120d808d913f743c04683b4a2c501d84659",
+    "room-label-parity-view-dark": "5ff9dff2da5c747cfab83ade2a929afadcf2eb9340182862da38ab36a35cd3c1",
+    "room-label-parity-plan-dark": "6528f1edf07e51e470b1c05dcf5292888a14ef6e44d04f7119cfb11b06155c2b",
+    "room-label-parity-view-light": "789f8f3b6211d35e70021094f2063dc9c6ac57599d9d64743a33b7ae9dd868c2",
+    "room-label-parity-plan-light": "272dc35d85b1f07efc4c2a05c31f6adbf7d10c648e3c678e7235e35167f83a7d",
+    "washer-active-cycle-dark": "d74a646bc71b8d6d0d5b09e6862b4846b0e369da2520afa76d5b3d601c832a15",
+    "washer-idle-cycle-dark": "f7fae5c2f6856a3df5bd3f3028fcf829ef0039c7b43c91c27ac86d25626e8d66",
+    "day-cycle-dawn-dark": "be3b891520637857b7f89dc88284753a15601ebae4db7db750714b9535348d33",
+    "day-cycle-day-dark": "1b791b8a773a5910a71338351ab12fdc36c22742a358b647ff4f295431fa4cfd",
+    "day-cycle-dusk-dark": "14182ad89301cb260ba21ee5077134ed408f038ea878ed4539b84f987182f910",
+    "day-cycle-night-dark": "407632fc54e13e6362b7e583d6e2b7bdd31b4093823846e4e630de0c8f542120",
+    "geometry-plan-editor-dark": "40a0083511c1ff9d0b8f1ec419af63e2a28f1f9a0ec3768387a10c89efe73905",
+    "safe-resize-handles-clamp-light": "f47a5bb09fa4415416d01ca5f4164014cc1d8dc7be54ea888e5399277104e94c",
+    "safe-resize-handles-clamp-dark": "9cb3cb83d2aea4260fdbf1bc1d4281deecedeb9c9dbb0adbed921470b9aaf397",
+    "space-tab-drop-before-light": "19c699fd035030318ce578fdb6427d6243cd3f1d955ea0fbf958cad385e9c7db",
+    "space-tab-drop-after-dark": "1f802274c3015ad6422ee9b50a8d67a412407513da09de188be3db2f7a3873e4",
+    "plan-snap-endpoint-light": "2185d5ec6726e07097ba1a911984a11d5ca9b460a1cd1e7b2a719255b7d0ed0b",
+    "plan-snap-line-gaps-dark": "276eb10f32be938640bd68a1cf837494f11cce8d10703721831360f3a1100d23",
+    "wall-junctions-plan-preview-light": "d92aad64d7aa8641c6743b51a7d13d9166b15c49f3d8aee17b8e61ff263a57a6",
+    "wall-junctions-plan-t-dark": "45a98164ff93b01fbb7f3ac936ee8636c36dd791c09ac3b160b7c7ad803696d1",
+    "wall-junctions-view-dark": "7b859c4f25f8a5dd4fca64d5b2f7aa64b65845fabbe83bc2388c2f99d29f71b1",
+    "junction-patch-resilience-plan-dark": "90191f637f4d1345d82c63977513524fde353c4e3f87de1a723bf7d3b1f8e91f",
+    "junction-patch-resilience-view-dark": "afd83241d9a1e1f19ab59c3f1e6fa7af058c3e42a7fafa5ba271ff92ccea8f91",
+    "wall-union-isolation-view-light": "106f8ac97b82107fed36aa4456c0b9f7a39eeb44be86864b1d4f083497cdbd6e",
+    "wall-union-isolation-view-dark": "914451a813546189bdc9ac22dcf158bbc822b4403080a3c2fd4c6b02bb7780a4",
+    "multiwall-junction-bevel-view-dark": "6b02d1d0c5af8b386791cc5764b3bc407129f6576b6d9591c64fd388a8a6865d",
+    "orthogonal-strip-cell-5-view-dark": "66a288f7e7fc6228c3c63f10e1df8df0656ca0cd36681d998b126b03acb70b5a",
+    "orthogonal-strip-cell-1-view-dark": "c23e6d0410b8f5c2b7fb0707f6bea40408730af08f9e7a0b166aa8c0a3d6c85f",
+    "wall-key-roundtrip-view-dark": "d7b0749d0f6c0cfa74ad4d9f76d8a7b7962fadf4e2648260b5647548a988341c",
+    "isometric-wall-junctions-dark": "d1956cbbde9a6a02953ce80eb8a0f74ca06ea268a4c60bb09b5b3981c26d9731",
+    "opening-placement-door-thick-wall-dark": "c21c2af812b847e7fd9a3a5b9df832db95266f81eba3d7b48c97d2b32619e7fe",
+    "opening-placement-passage-thick-wall-dark": "90f9a837898169c2d9ff9ec3b44b2a3d247ea034fd84b1753519da7b0c89ebdb",
+    "opening-placement-passage-thick-wall-light": "dd17884027d85f5727450cd08f3fe6daaed290770dbd04fe5ce10c4c2b9d43db",
+    "opening-symbol-room-wall-light": "403f1c6e1c59122331fbe99019a3ebd80de4106dc6d33f5f5f33feb748229645",
+    "opening-symbol-diagonal-partition-dark": "620102c00e77613cb341c906829bfcc7e9a5430075aa576f563adafa8bdd8f08",
+    "opening-symbol-flip-pairs-light": "6d780d1d06909e6e5a7ebb35987b9681d6902d78408e974dfe2fe587521990ce",
+    "isometric-opening-symbol-parity-dark": "1e254ed43da00a16d3048e9a2d29db0a43c7790991b1006ecb7205d002bd1f63",
+    "geometry-devices-editor-dark": "a57c8528f2075252dbc0ea11af23a6c33a3b533b4f80b43ab5eebaa918e12816",
+    "geometry-decor-editor-dark": "2a0d4368e49b51fc4fcf5ee72679efb7b7e094fd8b6f47682b0696ec909c423e",
+    "tray-wide-selection-en": "056f3b54d60bba83ef313f9c12fe697ea6a0b3d48db0470735394ee0d3f72c39",
+    "tray-wide-tool-ru": "f8e050c96cb3e78f1ab8d0b8b276b3d154950e795c5b620148b9e395330cffe9",
+    "tray-medium-group-en": "4513abc13f1bc24e4d04f14445069c8ce9785dc3fddcdc99bcee41b5eadb8d53",
+    "tray-medium-selection-ru": "bd97bee66778a65ebb849331724a307d0b089d6cdf5f3b85c6c905c413d5290f",
+    "tray-narrow-palette-en": "10073be9fdf658275f77643505c3523bcddce6a1890deda5b1820958b90613d1",
+    "tray-narrow-tool-ru": "95fa0f072efb595e1f9fe3f3287e7ce346fdee640e90dd70e4f5e5b31049ef29",
+    "geometry-diagonal-45-opening-dark": "ba9462322da34b20fff1ee1f950c516855dd7ac56131e13863f576e2d0ba5177",
+    "openings-thick-wall-dark": "539cdb9cb1460cd42c2e51901ea50f496e8214d02633e110e2780c3f177154db",
+    "openings-filled-tunnel-dark": "bb2a4343a285e2fd867c6090108589549facf87b1a9471f3ae331d743af6653c",
+    "decor-over-opaque-hover-light": "eae79026256367a4cfaa5f99393ec9c66dbf23908c50ccc0f541c139d1baeda0",
+    "decor-over-glow-base-dark": "72a83f08f832c219d8e0e1b6f94d689c250342aa95d30e8c1f79cf9f9548ccab",
+    "openings-hidden-view-dark": "19ab4fd2ffce0fea0fe609b007a3e60f7abd84b40935cbf3c5fa9dc1fda21046",
+    "lighting-glow-sun-dark": "08e2964df6fd03abad4b9a81f1dbd0fe3812fb6b5f7908aeb027ad2953b2f88c",
+    "device-value-badge-positions-dark": "75ab0210d697f952b8a8977649e84308de3ce3b59c84ec93071179a1d6cb015d",
+    "device-icon-state-table-light": "85c785824ccafc2d5f50e834ad2d746319d64ecb292d1b9cf7fab8661d5d410d",
+    "device-icon-state-table-dark": "03a90523132c3dbe6c78d44d01fe89df93e2d0474f91ef84e7107e6e4bc7d337",
+    "device-text-shell-long-light": "97a113b5164f373b4af2922c8e71bc1f063d8c2761b72c3182697fcb1aac3cab",
+    "device-text-shell-long-dark": "c8fe32aced704c7e7562f0c8499183fad848a977063ab731401cc01e7f20ef38",
+    "lighting-sun-window-state-only-dark": "4da798c4de6d1303d17be246e9a2e63b12da3f53a42136cf745d1a92ad5a4f21",
+    "lighting-fill-light-axis-split-dark": "e45d44496c83ad92f8d5bd058821e6d71c97c48a2b66c1933206535aea2655c1",
+    "lighting-fill-temp-axis-split-dark": "895e1e0beee38bf659b1313ed9951353a7792d2e8ae3a8620c4cf7a4f6a84a4d",
+    "lighting-fill-lqi-axis-split-dark": "4a029b17419aaf60feab23f7f0cb385d97353e3aec0e39ed67e9ac94f6c08029",
+    "lighting-temp-glow-dark": "3ce504d83fda2ba5d772c25f8cbb47c379b335addd8650f6933b58f22f5655a7",
+    "lighting-temp-glow-light": "e9f2db0a686a9e20bf71564c10bab826a2a473c73d572a6b67ef02a735d61e8e",
+    "lighting-custom-glow-dark": "94cc6135573aa9462de9e7f309dea62e236668b84970bae35d48f1aad338f8f4",
+    "lighting-opaque-glow-two-doorways-dark": "ee3c53a408f6b62aa6b770925fa6948934e0c1c6e73877e379695bc260b0ceac",
+    "lighting-custom-glow-light": "aa9477aaff4d137abfcb6d67a5cf62b91f41b3631383ee8edb7499802a5c9b87",
+    "lighting-temp-glow-no-sources-dark": "cd992af54d1c9dcc58bbd0b21b15b475be6f19eaabcf9ea866bfa82f205460c9",
+    "lighting-temp-glow-room-override-dark": "66a418829b51379d024c542f8b9a12bd42d72afa81a6bf66561d6498ac4cdb45",
+    "lighting-manual-auto-spill-overlap-dark": "0dc780335317d6dd577c8d5539f33223228074e1c95e936e4666f50a8db09739",
+    "hover-over-glow-dark": "49136f6073662482ebf49a28f8f22b698d2c20a9cb64b5667d111b9835717968",
+    "hover-nested-room-dark": "b546f923fd31d28d2881f074e3a67c5d9d3f9450169f9118502ecafc98c4467d",
+    "junction-t-90-equal15-dark": "fed083eaaaf1588222002c23f7edd741645c76f57c49a3db8cc5ec22af0b6e7d",
+    "junction-t-90-bar50-leg15-dark": "e981f0597a55e9e9e623dd49417f33a0ebac18d18e0e66675a9af1f2224bd152",
+    "junction-t-90-bar70-leg15-dark": "4428fbe75679fab6e57ef61c5d5097d498960e2539bb9e759e1bae9a160ef174",
+    "junction-x-90-equal15-dark": "8fe0e262e5873714f94b9a6a76ed920881bc6b267e69153039f52a7102ec55d5",
+    "junction-x-90-mixed-dark": "deabce4c2b5fa7866a4f56d25404c6a515d47437298bde114442bc80a6339560",
+    "junction-x-45-alternating-dark": "49192516aabc14e84a2da4d1361c1be57d24e5c947b199cdf8b6c55fd7318504",
+    "junction-star5-equal15-dark": "2fd822f73f486173700405208168300d27d4e360b17cb278c7ee7bc1cda3769e",
+    "junction-y-60-equal50-dark": "7a61dbfc36437674c2c2bf5f450a64797e21a124f42c0e45bfb56e3236e0b53e",
+    "junction-acute30-mixed-dark": "9ea64ae5864295a1d93a6819efb6e210de2599030fe650913862d99f40b11a69",
+    "junction-acute15-equal50-dark": "e7e657137e8dcf6294d400f3114497318c055405dbc0d867603514b56c42b907",
+    "junction-splay10-170-dark": "ae27454bb4213237313f1fe9e2591ada48facf20baca5517968f92aebbfb330e",
+    "junction-t-virtual-arm-dark": "d325dc112e2f56c31d4511fd586adaa92b6785fc676c2a60ed5aba69c164fd6e",
+    "junction-x-virtual-through-dark": "cce24ac9d7678959844803c6306e65ab48f723ec0375ee6d3f2dbf1c7def7be1",
+    "junction-column-node-dark": "fed083eaaaf1588222002c23f7edd741645c76f57c49a3db8cc5ec22af0b6e7d",
+    "junction-draft-end-node-dark": "6453bb8463ffdc9a42dbd7acb171c6249fe6d5beec0eae0c789e40f48e65a1f9",
+    "junction-309-step-dark": "f5e0e649ee19197026b87687fd3512b18536883f071348589ec3a7f0ea2a216f",
+    "junction-309-spike-dark": "98e709aa2fa58a01fe280635c6a3799e3a5f4158b2ada12c31c38818f92c4f44",
+    "junction-309-hump-dark": "abae96fd96ed8515d7b1e33b84858bdf08ac28a888898549874baa8c98202e7a",
+    "sharp-apex-legacy-dark": "93a46c66f7263a0325d0c4d50fa0677f3c902647ea5880960b99dc8fa04a01a5",
+    "junction-owner-repro-dark": "f5407d420449ebf897f94fcfcdaaf4630e818c043d3076b090f7d1944df5296b",
+    "large-house-zoom-040-dark": "736af1c340646c4c1cbab3d2270f67a535995e1ea1e2abe49c91d2c396052097",
+    "large-house-zoom-250-dark": "3f7abdd66a7b33301275983dbf83862bd24f91c65a7d731c411ebd3ed01b381d",
+    "large-house-warm-remount-dark": "1c14dba8cdbc4628984091d395c1ac14faead1d43338e44aa3cb57976e519df6",
+    "device-dialog-desktop-en": "a6637997458ef1def3d30ffaccb6bbc9728dbc4ba2f02400a7334915a8101bbe",
+    "device-dialog-mobile-ru": "c90be98e65c37963fd4443e413848ca68a412c9ee568d648aba76bf9232ee59d",
+    "toggle-entity-dialog-desktop-en": "f4924466de5e134c2d1f2456ff0c05f8aa8106f6b06398e87a263e3c536f16ea",
+    "toggle-entity-dialog-mobile-ru": "7d3aecd318c6c0774dd3ce1c21c0fafb1ae2be23cebed6f548fbf8bd11ab2f62",
+    "device-help-popover-light-ru": "add3275d74ced358a184ec9f864c83735f1196e2bff7d75fb3e12160cb85bfaf",
+    "decor-color-popover-mobile-ru": "fcdd138e396654e3517927c27d2062663c61860e8b9903471fa44651a4cbdefd",
+    "decor-color-popover-desktop-en": "98d769f5393afb2bad3fb5143a562da5b8bb9a5c8049f4c707706bbcb4f99f8d",
+    "general-color-popover-desktop-en": "008865918113e05847a7ad8ae0fdc068b5326acf1c591d855806b333084978a3",
+    "device-ripple-color-popover-mobile-ru": "3ab12c339106004c76fe3c7741d242269e157c40ddfa29afd8f13b445b0a7023",
+    "space-room-color-popover-desktop-ru": "946c550232ff3819bb44058eff6c5deadfccf85527c23065137ee02fa457aed9",
+    "backup-full-preview-desktop-en": "6b68188269fdbaddaf4f2ce8fc0d10ea41e050f0c08cdbd9507548871a3786ef",
+    "backup-plan-only-export-desktop-en": "f3c01ae191af41fcc815d27586fe40f965ae3fddbf782553076703ce695457d6",
+    "backup-space-preview-mobile-ru": "82cd93cb495ad77b92d635b4a3715601b1ae0e5e2974edcbbd461fe872c75bad",
+    "optimize-preflight-dialog-dark-en": "0473d7f16dd830aaddbec5c33f2b423fde48e2053a1094dbab052e6a2cbad9d4",
+    "optimize-preflight-dialog-light-ru": "a4eb6ef9930652bd7e55fbb725fd1bcc5a0e5b71e8060dbf6f772dd62cec5d36",
+    "optimize-orphan-references-dark-en": "f40417298e126fa804ddafb91d62b728c86a56c5a28b4fad12b732070faa4ad6",
+    "optimize-orphan-references-light-ru": "2d0319f681cfbe472ad5dede05d145a995dedee577d8d816e2fe46a519e019f5",
+    "card-editor-invalid-default-floor-light-en": "dbf251ece014cfee252e0dcb2d7c00eda66aa4b5bd125e4c83e248d4319d24b3",
+    "card-editor-invalid-default-floor-dark-ru": "422b74bb391b87e383350247ef1bc1f10ca48c8f6fe418f75bde94e62e3b8bc0"
  }
 }
--- a/Show More
+++ b/Show More