docs: review document for #107

Issue: #107
User-Visible: no

.githooks/pre-push

@@ -31,16 +31,6 @@ fi
 
 status=0
 
-# Локальный набор гейтов (#343). Выключен по умолчанию намеренно: 20-45 секунд на
-# каждый пуш, включая пуши одной строки документации, — цена, которую стоит
-# платить осознанно. Документация: docs/TESTING.md.
-if [ "${HP_PREPUSH_GATE:-}" = "1" ] && [ -f "$repo_root/scripts/pre-push-gate.mjs" ]; then
-  echo "pre-push-gate: HP_PREPUSH_GATE=1, прогоняю локальный набор" >&2
-  if ! node "$repo_root/scripts/pre-push-gate.mjs" >&2; then
-    status=1
-  fi
-fi
-
 while read -r local_ref local_sha remote_ref remote_sha; do
   # Deleting a remote branch pushes nothing to examine.
   if [ "$local_sha" = "$zero" ]; then

.github/workflows/announce.yml

@@ -1,4 +1,4 @@
-name: Анонс релиза
+name: Announce release
 # 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,13 +36,12 @@ 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@v7
+        uses: actions/checkout@v4
         with:
           ref: ${{ inputs.ref }}
       - name: Send to Telegram

.github/workflows/docs-screenshots.yml

@@ -1,85 +0,0 @@
-# Скриншоты документации снимаются здесь и только здесь (#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

.github/workflows/mutation-gate.yml

@@ -1,29 +1,18 @@
-name: Мутационный гейт
+name: Mutation gate
 
 # Реестр известных поломок (issue #85): каждый мутант ломает продуктовый код
 # известным способом, и объявленный тест ОБЯЗАН на этом покраснеть. Тест,
 # оставшийся зелёным на сломанном коде, ничего не защищает — он лишь выглядит
 # защитой, и это хуже его отсутствия.
 #
-# Прогон дорогой, поэтому он не входит в Validate и не идёт на каждый push.
-# Его место — перед стабильным релизом (PROCESS.md §8) и раз в неделю по
-# расписанию, чтобы дрейф тестов не копился до релиза. Дешёвая половина —
-# «якоря патчей живы, guard-файлы существуют» — идёт с обычными юнитами:
-# test/mutation-gate.test.mjs.
-#
-# #332: бандл собирается только мутантам с браузерным гвардом (guardNeedsBundle),
-# компиляция тестов в worktree стартует с тёплого test-build (инкрементальный
-# tsc), а реестр режется на четыре чересполосных шарда — полный прогон
-# укладывается в десятки минут вместо часов. Локальный дифф-режим:
-# node scripts/mutation-gate.mjs --changed origin/dev..HEAD
+# Прогон дорогой: пересборка бандла на каждого мутанта. Поэтому он не входит в
+# Validate и не идёт на каждый push. Его место — перед стабильным релизом
+# (PROCESS.md §8) и раз в неделю по расписанию, чтобы дрейф тестов не копился
+# до релиза. Дешёвая половина — «якоря патчей живы, guard-файлы существуют» —
+# идёт с обычными юнитами: test/mutation-gate.test.mjs.
 
 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'
@@ -37,38 +26,26 @@ concurrency:
 
 jobs:
   mutants:
-    name: "Мутанты: каждый обязан красить тесты (шард ${{ matrix.shard }} из 4)"
     runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        shard: [1, 2, 3, 4]
-    # Шард ~64 мутантов × свой guard; бандл собирают только браузерные гварды.
-    # Час — потолок против зависшего Chromium.
+    # Шесть мутантов × (сборка + браузерный смок) — это десятки минут, и это
+    # нормально: гейт предрелизный. Час — потолок против зависшего Chromium.
     timeout-minutes: 60
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v4
         with:
-          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.ref || 'dev' }}
+          ref: dev
           fetch-depth: 0
 
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         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@v6
+        uses: actions/cache@v4
         with:
           path: ~/.cache/ms-playwright
           key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
@@ -80,8 +57,5 @@ jobs:
       - name: Реестр применим к текущему коду
         run: node scripts/mutation-gate.mjs --check
 
-      - name: Тёплый test-build для инкрементальной компиляции мутантов
-        run: npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs
-
       - name: Каждый тест ловит свою поломку
-        run: node scripts/mutation-gate.mjs --shard=${{ matrix.shard }}/4
+        run: node scripts/mutation-gate.mjs

.github/workflows/performance.yml

@@ -1,4 +1,4 @@
-name: Полные бенчмарки производительности
+name: Full Performance
 
 on:
   # Every main promotion is a stable-release candidate and must have an
@@ -24,24 +24,13 @@ concurrency:
 
 jobs:
   performance:
-    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.
+    # Base and candidate stay sequential on one hosted runner. Splitting them
+    # across runners would turn machine variance into a false regression.
     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@v7
+        uses: actions/checkout@v4
         with:
           path: candidate
           fetch-depth: 2
@@ -127,12 +116,12 @@ jobs:
           echo "Comparison base: $sha ($source)" >> "$GITHUB_STEP_SUMMARY"
 
       - name: Check out base SHA
-        uses: actions/checkout@v7
+        uses: actions/checkout@v4
         with:
           ref: ${{ steps.base.outputs.sha }}
           path: baseline
 
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: npm
@@ -143,95 +132,44 @@ 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 chromium
+        run: npx playwright install --with-deps chromium
 
       - name: Build both exact source trees
         run: |
           npm --prefix candidate run build
-          (cd candidate && node scripts/bundle-sync.mjs)
+          cp candidate/dist/houseplan-card.js candidate/demo/srv/assets/houseplan-card.js
           npm --prefix baseline run build
-          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
+          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: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
           fi
 
-      - name: Capture base and candidate profile
+      - name: Enforce relative and absolute performance budgets
         working-directory: candidate
-        env:
-          PROFILE: ${{ matrix.profile }}
         run: |
-          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
+          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-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
 
-      - 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
+      - name: Upload full performance reports
         if: always()
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@v4
         with:
-          name: full-performance-${{ matrix.profile }}
+          name: full-performance
           path: artifacts/performance

.github/workflows/process.yml

@@ -1,4 +1,4 @@
-name: Ревью-конвейер
+name: Process
 
 # Событийный конвейер процесса (PROCESS.md). Смена статусной метки — это
 # сообщение: она порождает событие, событие запускает следующий шаг.
@@ -35,12 +35,10 @@ 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
@@ -65,41 +63,19 @@ jobs:
           limit=4
           if [ "$SMALL" = "true" ] || [ "$TRIVIAL" = "true" ]; then limit=2; fi
 
-          # Считаются ДВЕ РАЗНЫЕ величины, и это не педантизм (#227).
+          # Счётчик считает вердикты ТОЛЬКО своего этапа. Раньше он брал все
+          # подряд, и вердикт по ТЗ съедал цикл из бюджета код-ревью: на #89
+          # первое код-ревью получило r2/4. На задаче с двумя циклами ТЗ второе
+          # код-ревью упиралось бы в review-4 после одной правки.
           #
-          # `attempt` — сколько раз ревью уже отработало на этом этапе. Он нужен
-          # только для имени документа и метки: два захода с одинаковым номером
-          # означают, что второй документ перезапишет первый и артефакт ревью
-          # исчезнет.
-          #
-          # `spent` — сколько циклов израсходовано из бюджета §4. Цикл — это
-          # «отправка на ревью → вердикт с блокирующими находками → возврат
-          # автору», поэтому бюджет тратят ТОЛЬКО жёлтые и красные вердикты.
-          # Зелёный ничего на правки не вернул и цикла не образует.
-          #
-          # Раньше обе роли исполнял один счётчик всех вердиктов, и конвейер
-          # наказывал за то, что предписывал сам: при неудавшемся слиянии он
-          # велит вернуть S7-code-review после ребейза, и этот заход добивал
-          # бюджет. На #225 (лёгкий трек, лимит 2) последовательность
-          # жёлтый → зелёный → ребейз дала review-4 на задаче с зелёным ревью и
-          # зелёным CI: работа встала, хотя после вердикта не было ни одной
-          # правки продуктового кода.
-          #
-          # Вердикты считаются ТОЛЬКО своего этапа: иначе вердикт по ТЗ съедал
-          # цикл из бюджета код-ревью (#89 получило r2/4). Этап опознаётся по
-          # имени документа в теле комментария; документа нет — вердикт не
-          # посчитается. Недосчёт даёт лишний заход, перерасчёт остановил бы
-          # работу досрочно: из двух ошибок выбрана обратимая.
-          attempt=1; spent=0; spent_list=""
+          # Этап опознаётся по имени документа в теле комментария. Если документа
+          # нет, вердикт не посчитается — недосчёт даёт лишний цикл, а перерасчёт
+          # остановил бы работу досрочно; из двух ошибок выбрана обратимая.
+          done_cycles=0
           if [ -n "$stage" ]; then
-            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\")")
+            done_cycles=$(gh issue view "$NUM" --repo "${{ github.repository }}" \
+              --json comments \
+              -q "[.comments[] | select(.body | test(\"Вердикт:\")) | select(.body | test(\"$marker\"))] | length")
           fi
 
           # Отказ обязан быть виден в issue, а не только в логе прогона.
@@ -133,74 +109,39 @@ 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).$stale"
-          elif [ "$spent" -ge "$limit" ]; then
-            echo "блокирующих циклов этапа $stage: $spent из $limit — лимит исчерпан"
+              "на issue стоит \`review-4\`: лимит циклов ревью исчерпан, дальше решает владелец — разделить задачу, отклонить или арбитраж (PROCESS.md §4)."
+          elif [ "$done_cycles" -ge "$limit" ]; then
+            echo "циклов этапа $stage пройдено $done_cycles из $limit — лимит исчерпан"
             gh issue edit "$NUM" --repo "${{ github.repository }}" --add-label review-4
-            # Перечень учтённого обязателен: иначе владельцу приходится читать
-            # всю ленту, чтобы понять, из чего сложился счёт.
             gh issue comment "$NUM" --repo "${{ github.repository }}" --body \
-              "Лимит циклов ревью исчерпан: блокирующих циклов $spent из $limit на этапе \`$stage\` (заход $attempt). Следующего захода нет: решение владельца — разделить задачу, отклонить или арбитраж (PROCESS.md §4).
-
-          Учтены вердикты с блокирующими находками — зелёные бюджет не тратят:
-          $spent_list"
+              "Лимит циклов ревью исчерпан ($done_cycles из $limit на этапе \`$stage\`). Пятого захода нет: решение владельца — разделить задачу, отклонить или арбитраж (PROCESS.md §4)."
             stage=""
           else
-            echo "этап $stage, заход $attempt, блокирующих циклов $spent из $limit"
+            echo "этап $stage, цикл $((done_cycles + 1)) из $limit"
           fi
           echo "stage=$stage" >> "$GITHUB_OUTPUT"
-          echo "cycle=$attempt" >> "$GITHUB_OUTPUT"
-          echo "spent=$spent" >> "$GITHUB_OUTPUT"
+          echo "cycle=$((done_cycles + 1))" >> "$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@v7
+      - uses: actions/checkout@v4
         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@v7
+      - uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: npm
@@ -213,15 +154,8 @@ jobs:
         env:
           NUM: ${{ github.event.issue.number }}
         run: |
-          # Свежая по последнему коммиту, а не первая по алфавиту: на #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
+          branch=$(git ls-remote --heads origin "issue/${NUM}-*" \
+            | head -1 | sed 's|.*refs/heads/||')
           if [ -n "$branch" ]; then
             git checkout -q "origin/$branch"
             echo "материал ревью: ветка $branch, $(git rev-parse --short HEAD)"
@@ -231,170 +165,27 @@ 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 (ревью не запускалось)"
-
-      # Ревьюер перегонял tsc, юниты и сборку заново в каждом раунде, хотя
-      # Validate на том же SHA уже зелёный (#343). Это не тщательность: бюджет
-      # ревью тратится на повторение CI вместо чтения кода.
-      #
-      # Доказательство здесь такое же строгое, как у reuse-маркеров (#208): не
-      # «недавно было зелено», а «completed success ровно на этом SHA». После
-      # ребейза SHA другой, прогона для него нет — и ревьюер честно гоняет сам.
-      - name: Зелёные гейты на этом SHA
-        id: validated
-        if: steps.rebase.outputs.conflict != 'true'
-        env:
-          GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
-        run: |
-          sha=$(git rev-parse HEAD)
-          short=$(git rev-parse --short HEAD)
-          row=$(gh run list --repo "${{ github.repository }}" --workflow validate.yml \
-            --commit "$sha" --limit 5 \
-            --json status,conclusion,url \
-            --jq '[.[] | select(.status=="completed" and .conclusion=="success")][0] // empty')
-          {
-            echo 'note<<EOF_NOTE'
-            if [ -n "$row" ]; then
-              url=$(printf '%s' "$row" | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>process.stdout.write(JSON.parse(s).url||""))')
-              echo "**Дешёвые гейты на этом SHA уже подтверждены** (#343). Validate на \`$short\` завершился success: $url"
-              echo ""
-              echo "Значит \`npx tsc --noEmit\`, \`npm test\` и \`npm run build\` со сверкой копий бандла перегонять не нужно — сошлись на этом прогоне, назвав его ссылкой. Бюджет раунда тратится на чтение кода."
-              echo ""
-              echo "Что Validate НЕ покрывает и остаётся за тобой: смоки, выбранные по диффу; golden, если diff трогает рендер; инварианты модели на конкретной конфигурации; и любой гейт, который требуют AC задачи."
-            else
-              echo "**Зелёного Validate на этом SHA (\`$short\`) нет** — прогон не найден, не завершён либо не success. Дешёвые гейты прогоняешь сам и называешь результат."
-            fi
-            echo 'EOF_NOTE'
-          } >> "$GITHUB_OUTPUT"
-          if [ -n "$row" ]; then echo "Validate на $short: зелёный"; else echo "Validate на $short: зелёного нет"; fi
-
       # Зависимости ставятся ПОСЛЕ переключения на ветку задачи: lockfile мог
       # измениться именно в ней, и установка по копии из dev дала бы не то дерево.
       - name: Установить зависимости
-        if: steps.rebase.outputs.conflict != 'true'
         run: npm ci
 
       # Браузер нужен не всякому ревью (см. правило выбора гейтов в промпте),
       # но когда нужен — качать его заново дороже, чем держать в кэше.
       - name: Кэш браузеров Playwright
         id: pw
-        if: steps.rebase.outputs.conflict != 'true'
-        uses: actions/cache@v6
+        uses: actions/cache@v4
         with:
           path: ~/.cache/ms-playwright
           key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
 
       - name: Установить 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
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install --with-deps 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). Действуют лимиты подписки.
@@ -407,44 +198,6 @@ 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 — зачем продукт существует и для кого. Он
@@ -488,46 +241,14 @@ jobs:
             правке — не тщательность, а потеря времени: полные наборы это
             предрелизный гейт (PROCESS.md §8), а не гейт ревью.
 
-            ${{ steps.validated.outputs.note }}
-
-            Если зелёного прогона на этом SHA нет — прогоняешь сам, они дешёвые,
-            и в повторном раунде тоже: код изменился, а стоят они минуты:
+            Всегда, они дешёвые:
               `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 плюс те,
-                что печатает `node scripts/smoke-select.mjs --base <base> --head <head>`.
-                Сколько их всего — считает `ls demo/smoke_*.mjs | wc -l`; вшитое
-                в этот текст число трижды расходилось с деревом, поэтому его
-                здесь больше нет. Прогон всех уместен только когда задача
-                действительно задевает всё. Выбирать по теме недостаточно: регресс #234 поймал
-                `smoke_wall_junctions`, который по названию про стыки стен, а не
-                про толщину отрезка. Инструмент печатает три вида ответа, и они
-                разные: «прямое совпадение» — смок называет изменённый символ,
-                «зарегистрированная связь» — смок проверяет следствие контракта,
-                не называя его, «НЕОПРЕДЕЛЁННОСТЬ» — связь не доказана, и это не
-                разрешение ничего не прогонять. Вывод инструмента прикладывается
-                к комментарию ревью вместе с решением по каждой строке: прогнал
-                либо не прогнал и почему. Слабые связи (одно распространённое
-                имя) — повод посмотреть, а не обязанность прогонять;
+              - браузерные смоки `demo/smoke_*.mjs` — названные в AC плюс
+                относящиеся к тронутым поверхностям. Их 127; прогон всех уместен
+                только когда задача действительно задевает всё;
               - `npm run golden:verify` — если diff может изменить видимый
                 результат: рендер, геометрия, стили, слои;
               - `python -m pytest tests_backend -q` — если тронут
@@ -535,14 +256,6 @@ jobs:
               - performance-профили — если названы в AC либо тронуты
                 чувствительные к перфу пути.
 
-            **Одно число — один источник.** Если дифф добавляет или меняет
-            величину, видимую пользователю, назови в отчёте прямо: какое число
-            видно дважды (превью против записи, подпись против площади,
-            подсветка инструмента против сохранённого значения) и один ли у него
-            источник. Три дефекта подряд имели именно эту причину — #234, #233 и
-            способ, которым #234 обнаружили. Механическая часть закреплена
-            тестом `test/single-source-numbers.test.mjs`, смысловая — твоя.
-
             Дисциплина «тест должен уметь падать» не отменяется, но применяется к
             тем тестам, которые ты прогонял.
 
@@ -554,46 +267,27 @@ jobs:
 
             Ты НЕ правишь ни ТЗ, ни продуктовый код. Только оцениваешь.
 
-            Серьёзность: High блокирует; Medium В СКОУПЕ задачи чинится в ней
-            же — без High это жёлтый вердикт и возврат автору, отдельный issue
-            НЕ заводится (решение владельца 2026-08-19, #202: заведение и
-            обслуживание issue дороже правки на месте); Low либо правится,
-            либо снимается с записью. Жёлтый вердикт допустим и при полностью
-            выполненных AC, если изменение не решает заявленный сценарий или
-            ухудшает смежный. Продуктовое рассуждение расширяет вопросы, но не
-            отменяет AC и не даёт права менять скоуп.
+            Серьёзность: High блокирует; Medium обязан стать отдельным issue;
+            Low либо правится, либо снимается с записью. Жёлтый вердикт
+            допустим при полностью выполненных AC, если изменение не решает
+            заявленный сценарий или ухудшает смежный. Продуктовое рассуждение
+            расширяет вопросы, но не отменяет AC и не даёт права менять скоуп.
 
-            Только Medium-находку ВНЕ скоупа задачи (попутный дефект соседнего
-            поведения, который в этой ветке чинить нельзя) заведи отдельным
-            issue со ссылкой на #${{ github.event.issue.number }} и метками:
-            тип, приоритет, S1-new. «Оставили в тексте ревью» закрытием не
-            считается и прямо запрещено §12.
+            Каждую Medium-находку заведи отдельным issue со ссылкой на
+            #${{ github.event.issue.number }} и метками: тип, приоритет,
+            S1-new. «Оставили в тексте ревью» закрытием не считается и прямо
+            запрещено §12.
 
-            Напиши полный документ ревью в файл, путь которого лежит в
-            переменной окружения 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.
+            Напиши полный документ ревью в файл
+            docs/reviews/<SPEC|CODE>-REVIEW-${{ github.event.issue.number }}-r${{ needs.guard.outputs.cycle }}.md
+            (SPEC для этапа spec, CODE для code): скоуп, как проверялось,
+            находки с воспроизведением, что проверено и корректно, чего не
+            проверял. Каталог docs/reviews/ создай, если его нет. Больше не
+            пиши ничего: любой файл вне docs/reviews/ опубликован не будет.
 
             Затем оставь в issue краткий комментарий: вердикт, ключевые находки
             и ссылка на документ. Первой строкой — вердикт в формате §7.2:
-            `Вердикт: зелёный/жёлтый/красный · заход r${{ needs.guard.outputs.cycle }} · блокирующих циклов ${{ needs.guard.outputs.spent }}/${{ needs.guard.outputs.limit }} · High: N · Medium: N → в задаче | #…`
-            («→ #…» — только у Medium вне скоупа; находки в скоупе возвращаются автору жёлтым)
+            `Вердикт: зелёный/жёлтый/красный · цикл r${{ needs.guard.outputs.cycle }}/${{ needs.guard.outputs.limit }} · High: N · Medium: N → #…`
 
             Затем верни JSON по схеме. Это последнее действие и оно обязательно:
             без него метка не переставится и конвейер встанет.
@@ -605,14 +299,10 @@ 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. Раньше шаг в этом случае молча
@@ -623,49 +313,12 @@ 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
-            # Пустая рабочая копия — ещё не провал: ревьюер иногда коммитит
-            # документ сам, своим 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
+            echo "::warning::документ ревью не создан"
+            exit 0
           fi
           git -c user.name="claude[bot]" \
               -c user.email="209825114+claude[bot]@users.noreply.github.com" \
@@ -685,26 +338,16 @@ jobs:
                      -c user.email="209825114+claude[bot]@users.noreply.github.com" \
                      rebase "origin/$target"; then
               git rebase --abort || true
-              # Тоже вердикт без артефакта: раньше exit 0 переставил бы метку.
-              echo "::error::документ ревью не удалось опубликовать в $target: конфликт (#171)"
-              exit 1
+              echo "::error::документ ревью не удалось опубликовать в $target: конфликт"
+              exit 0
             fi
             git push -q "https://x-access-token:$TOKEN@github.com/${{ github.repository }}" \
               "HEAD:$target"
           fi
-          # Постусловие: до ветки дошёл именно ожидаемый файл. Коммит с
-          # документом, названным не по формату, — тот же вердикт без
-          # артефакта, только дороже в обнаружении.
-          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"
+          echo "документ опубликован в $target"
 
       - name: Решение по вердикту
         id: decide
-        if: steps.rebase.outputs.conflict != 'true'
         env:
           OUT: ${{ steps.review.outputs.structured_output }}
           STAGE: ${{ needs.guard.outputs.stage }}
@@ -750,42 +393,14 @@ 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 "$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"
+          git fetch -q origin dev
+          git checkout -q -B merge-into-dev "origin/$BRANCH"
           if ! git -c user.name="claude[bot]" \
                    -c user.email="209825114+claude[bot]@users.noreply.github.com" \
                    rebase origin/dev; then
@@ -811,7 +426,6 @@ 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 }}

.github/workflows/publish-prerelease.yml

@@ -1,4 +1,4 @@
-name: Публикация пре-релиза (ручная)
+name: Publish prerelease
 run-name: Publish ${{ inputs.tag }}
 
 on:
@@ -19,17 +19,16 @@ concurrency:
 
 jobs:
   gate:
-    name: "Гейт: зелёная Проверка и релизный контракт"
     runs-on: ubuntu-latest
     outputs:
       sha: ${{ steps.candidate.outputs.sha }}
       tag: ${{ steps.candidate.outputs.tag }}
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v4
         with:
           ref: ${{ github.sha }}
           fetch-depth: 0
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         with: { node-version: 22 }
       - name: Pin the current dev candidate
         id: candidate
@@ -62,18 +61,17 @@ 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@v7
+      - uses: actions/checkout@v4
         with:
           ref: ${{ needs.gate.outputs.sha }}
           fetch-depth: 0
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         with: { node-version: 22 }
       - name: Build and verify both release assets before publication
         env:
@@ -83,6 +81,7 @@ 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 .)
@@ -174,7 +173,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@v9
+        uses: actions/github-script@v7
         env:
           EXPECTED_TAG: ${{ needs.gate.outputs.tag }}
         with:
@@ -200,7 +199,6 @@ 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
@@ -248,7 +246,6 @@ jobs:
           }
 
   announce:
-    name: Комментарий о публикации
     needs: [gate, publish]
     if: ${{ needs.publish.outputs.newly_published == 'true' }}
     uses: ./.github/workflows/announce.yml

.github/workflows/release-zip.yml

@@ -1,4 +1,4 @@
-name: HACS-zip к релизу
+name: Attach HACS zip to release
 # 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,7 +19,6 @@ permissions:
   contents: write
 jobs:
   zip:
-    name: Собрать houseplan.zip и приложить к релизу
     runs-on: ubuntu-latest
     steps:
       - name: Resolve tag
@@ -28,7 +27,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@v7
+      - uses: actions/checkout@v4
         with:
           ref: ${{ steps.tag.outputs.tag }}
       - name: Build houseplan.zip (contents of custom_components/houseplan at zip root)

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: "Релиз: ассеты после зелёной проверки"
+name: Release
 on:
   release:
     types: [published]
@@ -14,14 +14,13 @@ 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@v7
+      - uses: actions/checkout@v4
         with:
           ref: ${{ github.event.release.tag_name }}
           fetch-depth: 0
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         with: { node-version: 22 }
       - name: Require a green Validate for this exact commit
         env:
@@ -43,37 +42,35 @@ jobs:
         run: |
           set -euo pipefail
           SHA=$(git rev-parse HEAD)
-          node scripts/release-gate.mjs "$SHA" --workflow=performance.yml --label="Полные бенчмарки производительности"
+          node scripts/release-gate.mjs "$SHA" --workflow=performance.yml --label="Full Performance"
   build:
-    name: Сборка бандла и загрузка ассетов
     needs: gate
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v4
         with:
           ref: ${{ github.event.release.tag_name }}
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         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
-          node scripts/bundle-sync.mjs
+          cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
           npm run continuity:screencast
       - name: Upload failed continuity frames
         if: ${{ failure() && !github.event.release.prerelease }}
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@v4
         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@v3
+        uses: softprops/action-gh-release@v2
         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
@@ -83,7 +80,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Verify the published tag is the prerelease HACS will discover
-        uses: actions/github-script@v9
+        uses: actions/github-script@v7
         with:
           script: |
             const releases = await github.paginate(github.rest.repos.listReleases, {

.github/workflows/validate.yml

@@ -1,4 +1,4 @@
-name: Проверка (CI)
+name: Validate
 
 on:
   push:
@@ -6,12 +6,6 @@ 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.
@@ -21,279 +15,69 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  # Четыре секундных скрипта жили четырьмя job, каждая со своим checkout и
-  # setup-node ради нескольких секунд работы (#336). Здесь они шаги одной job.
-  #
-  # Независимость при этом сохранена намеренно: у каждого шага
-  # `continue-on-error`, поэтому упавший провенанс не прячет результат
-  # процессного гейта, а вердикт в конце падает, если упал хоть один. Прежняя
-  # запись «job независимый: краснеет сам и не роняет остальные» продолжает
-  # действовать — на уровне шагов, с той же гранулярностью в логе.
-  preflight:
-    name: "Предполётные проверки: документация, провенанс, процесс"
+  provenance:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v4
         with: { fetch-depth: 0 }
-      - uses: actions/setup-node@v7
+      - uses: actions/setup-node@v4
         with: { node-version: 22 }
-
-      - name: "Документация: гайды, ченджлоги, скриншот-индекс"
-        id: docs
-        continue-on-error: true
-        run: node scripts/check-docs.mjs --external
-
-      # Конвейер читает `process.yml` из ветки по умолчанию, поэтому файл обязан
-      # совпадать в `main` и `dev`. До этой проверки совпадение держалось на
-      # дисциплине: каждая правка требовала двух пушей и ручной сверки.
-      - name: "Процесс: process.yml идентичен в main и dev"
-        id: workflow_sync
-        continue-on-error: true
-        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
-
-      - name: "Провенанс коммитов: трейлеры и эталоны"
-        id: provenance
-        continue-on-error: true
+      - name: Validate commit trailers and hook mode
         env:
           EVENT_NAME: ${{ github.event_name }}
           BEFORE_SHA: ${{ github.event.before }}
           BASE_SHA: ${{ github.event.pull_request.base.sha }}
           HEAD_SHA: ${{ github.sha }}
-          DEVELOPMENT_BRANCH: dev
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
         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). Хуки ловят нарушение на
-      # машине автора, но их можно обойти `--no-verify`, а коммиты идут прямо в
-      # dev без PR — GitHub на своей стороне не блокирует ничего. Это последнее
-      # место, где нарушение правила №1 ловится машиной. Откат — удалить шаг,
-      # скрипт остаётся рабочим.
-      - name: "Процессный гейт: диапазон, трейлеры, статусы issue"
-        id: process_gate
-        continue-on-error: true
+  # Догоняющая проверка процесса (PROCESS.md §10.3). Хуки ловят нарушение на
+  # машине автора, но их можно обойти `--no-verify`, а коммиты идут прямо в dev
+  # без PR — GitHub на своей стороне не блокирует ничего. Это последнее место,
+  # где нарушение правила №1 ловится машиной. Job независимый: краснеет сам и
+  # не роняет остальные, откат — удалить его отсюда, скрипт остаётся рабочим.
+  process-gate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - name: Process gate
         env:
           EVENT_NAME: ${{ github.event_name }}
           BEFORE_SHA: ${{ github.event.before }}
           BASE_SHA: ${{ github.event.pull_request.base.sha }}
           HEAD_SHA: ${{ github.sha }}
-          DEVELOPMENT_BRANCH: dev
+          DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
           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 стоило бы автору лишнего круга «починил одно — узнал о
-      # втором».
-      - name: Вердикт предполётных проверок
-        env:
-          DOCS: ${{ steps.docs.outcome }}
-          WORKFLOW_SYNC: ${{ steps.workflow_sync.outcome }}
-          PROVENANCE: ${{ steps.provenance.outcome }}
-          PROCESS_GATE: ${{ steps.process_gate.outcome }}
-        run: |
-          fail=0
-          check() {
-            if [ "$2" = "success" ]; then
-              echo "ok   $1"
-            else
-              echo "FAIL $1 ($2)"
-              echo "- **$1**: $2" >> "$GITHUB_STEP_SUMMARY"
-              fail=1
-            fi
-          }
-          echo "### Предполётные проверки" >> "$GITHUB_STEP_SUMMARY"
-          check "документация" "$DOCS"
-          check "process.yml в main и dev" "$WORKFLOW_SYNC"
-          check "провенанс коммитов" "$PROVENANCE"
-          check "процессный гейт" "$PROCESS_GATE"
-          exit $fail
-
-  # Классификация изменённых путей: тяжёлые job идут только там, где менялось
-  # относящееся к ним. НА DEV ФИЛЬТРОВ НЕТ: гейт беты принимает «зелёный Validate
-  # на точном SHA», и если объём прогона зависит от diff, «зелёный» перестаёт
-  # значить одно и то же — кандидат релиза (манифесты + changelog) пропустил бы
-  # браузерные тесты, а прогон с пропущенными job всё равно success. Фильтры
-  # экономят на ветках задач, где 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@v7
-        with: { fetch-depth: 0 }
-      - id: classify
-        env:
-          EVENT_NAME: ${{ github.event_name }}
-          BEFORE_SHA: ${{ github.event.before }}
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.sha }}
-          REF: ${{ github.ref }}
-        run: |
-          if [ "$REF" = "refs/heads/dev" ]; then
-            echo "dev: без фильтров, всё true"
-            printf 'frontend=true\nbackend=true\nintegration=true\n' >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          zero=$(printf '%040d' 0)
-          base="$BEFORE_SHA"
-          if [ "$EVENT_NAME" = "pull_request" ]; then base="$BASE_SHA"; fi
-          # Новая ветка: before нулевой, диапазон считается от merge-base с dev,
-          # иначе классифицировалась бы вся история.
-          if [ -z "$base" ] || [ "$base" = "$zero" ] \
-             || ! git cat-file -e "$base" 2>/dev/null; then
-            git fetch -q origin dev
-            base=$(git merge-base origin/dev "$HEAD_SHA" || echo "$HEAD_SHA~1")
-          fi
-          files=$(git diff --name-only "$base" "$HEAD_SHA")
-          printf '%s\n' "$files" | head -50
-          has() { printf '%s\n' "$files" | grep -qE "$1" && echo true || echo false; }
-          {
-            echo "frontend=$(has '^(src/|demo/|test/|dist/|custom_components/houseplan/frontend/|package(-lock)?\.json$|rollup\.config\.mjs$|tsconfig)')"
-            echo "backend=$(has '^(custom_components/.*\.py$|tests_backend/|pytest\.ini$)')"
-            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@v7
+      - uses: actions/checkout@v4
       - 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@v7
+      - uses: actions/checkout@v4
       - 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@v7
-      - uses: actions/setup-node@v7
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: 22
           cache: npm
@@ -304,83 +88,31 @@ 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
-      # Бандл собирается один раз и уезжает артефактом (#336). Прежде каждая из
-      # пяти браузерных job собирала его заново: `bundle:sync` — это `tsc
-      # --noEmit` плюс rollup, около минуты на job.
-      #
-      # Подмену артефакта ловить не нужно отдельной проверкой: `assertFreshDemoBundle`
-      # сверяет вшитый в бандл отпечаток с `sourceFingerprint` выкачанного
-      # дерева, и каждая браузерная job делает это перед первым кадром.
-      - name: Выложить бандл для браузерных job
-        uses: actions/upload-artifact@v7
-        with:
-          name: card-bundle
-          path: dist/houseplan-card.js
-          retention-days: 1
-          if-no-files-found: error
+        run: |
+          cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js
+          cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
 
   smoke:
-    name: Смоки в браузере (шард ${{ matrix.shard }} из 3)
     # Gated on `frontend` so a typecheck failure does not burn browser minutes.
-    needs: [frontend, reuse]
-    if: needs.reuse.outputs.smoke != 'true'
+    needs: frontend
     runs-on: ubuntu-latest
-    # Смоки шардируются: последовательный прогон занимал ~7.5 минут и был
-    # критическим путём всего Validate. Три шарда режут его примерно вдвое;
-    # цена — трижды `npm ci` и сборка, около двух оплаченных минут раннера.
-    strategy:
-      fail-fast: false
-      matrix:
-        shard: [1, 2, 3]
     steps:
-      - uses: actions/checkout@v7
-      - uses: actions/setup-node@v7
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         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
-        if: steps.pw.outputs.cache-hit != 'true'
-        run: npx playwright install chromium
-      # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
-      # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
-      # сверяет вшитый отпечаток с исходниками этого дерева.
-      - name: Забрать собранный бандл
-        uses: actions/download-artifact@v7
-        with:
-          name: card-bundle
-          path: dist
-      - name: Разложить бандл по копиям
-        run: node scripts/bundle-sync.mjs
-      - name: Smoke suite (шард ${{ matrix.shard }} из 3)
-        env:
-          SHARD: ${{ matrix.shard }}
-          SHARDS: '3'
+      - name: Install Chromium for Playwright
+        run: npx playwright install --with-deps 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: |
           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"
@@ -390,78 +122,30 @@ 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@v7
+        uses: actions/upload-artifact@v4
         with:
-          name: smoke-logs-${{ matrix.shard }}
+          name: smoke-logs
           path: /tmp/smoke-logs
 
-  # Маркер переиспользования пишется ОДИН раз и только когда прошли все шарды:
-  # частично прогнанная матрица не имеет права выглядеть как выполненная работа.
-  smoke_done:
-    name: "Смоки: все шарды зелёные"
-    needs: [smoke, reuse]
-    if: needs.reuse.outputs.smoke != 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - 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'
+    needs: frontend
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
-      - uses: actions/setup-node@v7
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         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
-        if: steps.pw.outputs.cache-hit != 'true'
-        run: npx playwright install chromium
-      # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
-      # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
-      # сверяет вшитый отпечаток с исходниками этого дерева.
-      - name: Забрать собранный бандл
-        uses: actions/download-artifact@v7
-        with:
-          name: card-bundle
-          path: dist
-      - name: Разложить бандл по копиям
-        run: node scripts/bundle-sync.mjs
+        run: npx playwright install --with-deps chromium
+      - name: Build the exact source under review
+        run: npm run build && cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
       - name: Capture or verify golden matrix
         id: golden
         run: |
@@ -474,131 +158,51 @@ jobs:
           fi
       - name: Upload golden candidates/diffs
         if: failure() || steps.golden.outputs.has_baselines == 'false'
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@v4
         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, reuse]
-    if: needs.reuse.outputs.performance_smoke != 'true'
+    needs: frontend
     runs-on: ubuntu-latest
-    # 15 минут не хватало, когда установка браузера шла через apt: замер
-    # начинался на исходе окна (#206). Запас на холодный кэш — при попадании
-    # job укладывается в те же минуты, что и раньше.
-    timeout-minutes: 20
+    timeout-minutes: 15
     steps:
-      - uses: actions/checkout@v7
-      - uses: actions/setup-node@v7
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         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
-        if: steps.pw.outputs.cache-hit != 'true'
-        run: npx playwright install chromium
-      # Бандл приходит артефактом из job `frontend` (#336): та же сборка, но
-      # один раз на прогон. Свежесть проверяет сам продукт — `assertFreshDemoBundle`
-      # сверяет вшитый отпечаток с исходниками этого дерева.
-      - name: Забрать собранный бандл
-        uses: actions/download-artifact@v7
-        with:
-          name: card-bundle
-          path: dist
-      - name: Разложить бандл по копиям
-        run: node scripts/bundle-sync.mjs
+        run: npx playwright install --with-deps chromium
+      - name: Build the exact candidate source
+        run: npm run build && cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
       - 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
       - name: Enforce absolute smoke ceilings
         run: |
           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
-      # #330 AC7: перф-контракт ограничений стыков — быстрый (без браузера),
-      # ловит возврат квадратичных путей в оба зеркала прямо на пуше.
-      - name: Бюджеты ограничений стыков (#330)
-        run: npm run benchmark:junction-limits
       - name: Upload performance smoke report
         if: always()
-        uses: actions/upload-artifact@v7
+        uses: actions/upload-artifact@v4
         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:
-    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@v7
+      - uses: actions/checkout@v4
       # 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@v7
+      - uses: actions/setup-node@v4
         with: { node-version: 22 }
-      - uses: actions/setup-python@v7
+      - uses: actions/setup-python@v5
         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 }}

.gitignore

@@ -7,8 +7,3 @@ __pycache__/
 .venv-backend/
 artifacts/
 .agents/
-
-# Копия бандла для стенда: её собирает `npm run bundle:sync`, а в репозитории
-# она только росла — 364 версии по 1.16 МБ за семь недель (#255). Обязательных
-# копий две: `dist/` (артефакт сборки) и `custom_components/` (её ставит HACS).
-demo/srv/assets/houseplan-card.js

AGENTS.md

@@ -38,18 +38,13 @@ task records: problem, scope, acceptance criteria and discussion.
 **Status lives in labels:** `S1-new`, `S2-analysis`, `S3-spec`, `S4-spec-review`,
 `S5-ready`, `S6-in-progress`, `S7-code-review`, `S8-merged`, plus `blocked` on top
 of a status and `rejected` on a closed issue. Exactly one `S*` label per open
-issue. Labels are the whole of it: GitHub Projects is no longer used.
+issue. [GitHub Projects (v2)](https://github.com/users/Matysh/projects/1) is a
+human-facing view synchronised from the labels, not the source of truth.
 
-**The light track is the default, not a shortcut** (owner's decision 2026-08-27,
-issue #338). `small` — the spec lives in the issue body and its review is a
-comment. Analysis names the `small` criterion the task *fails* when it takes the
-full track; "ordinary track" without a named criterion is not a justification.
-The threshold itself did not move — only which side carries the proof. The full
-track stays what it was for geometry, config migrations and public contracts,
-where a criterion is broken plainly and saying which one is easy.
-
-`trivial` — the short track: no spec stage at all, `S2-analysis` straight to
-`S5-ready`, with the AC written into the issue body first. `trivial` requires a bug confined to one surface with no new UX
+Two shortcuts exist for small work. `small` — the light track: the spec lives in
+the issue body and its review is a comment. `trivial` — the short track: no spec
+stage at all, `S2-analysis` straight to `S5-ready`, with the AC written into the
+issue body first. `trivial` requires a bug confined to one surface with no new UX
 contract, no migration, no i18n, no perf or touch impact, at most three checkable
 AC, **and expected behaviour already on record** — nothing left to decide. Code
 review is never skipped on either track; it is what stands in for testing.
@@ -93,7 +88,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/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` |
+| **D — generated** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/srv/assets/houseplan-card.js`, `demo/golden/baselines/**` | never changes on its own |
 
 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`,
@@ -160,28 +155,6 @@ arrive. Cycles are counted per stage, so a code review spends its own budget.
 Everything else still requires the owner's explicit command: pushing `main`,
 creating tags, publishing betas and releases, closing issues.
 
-## Working trees (#115)
-
-One checkout, one `HEAD`: two agents sharing a directory inherit each other's
-branch, and twice in one hour a commit landed on someone else's task branch that
-way. The layout is therefore fixed:
-
-- **`houseplan-card-src/houseplan-card`** — the author's tree. Task branches live
-  here; nobody else commits in it. Unfamiliar local changes belong to the author
-  or the owner — never reset or clean them away.
-- **`houseplan-card-src/hp-dev`** — the owner's worktree, permanently on `dev`. For owner-side operations that must not disturb the
-  author's tree: pushing `dev`, restoring a hook's executable bit, emergencies.
-- **The reviewer and the infrastructure agent own no local tree.** The reviewer
-  runs in CI on a fresh checkout. The infrastructure agent reads via `git show`
-  and publishes through the GitHub API; it makes no local commits at all, so it
-  needs no `HEAD` of its own. Its scratch worktrees live outside the repo and are
-  pruned after use.
-
-A worktree is only usable on the machine that created it: the `.git` file records
-an absolute path in that machine's format. One created from a Linux sandbox is
-dead on Windows and vice versa — create worktrees on the machine that will use
-them, which for `hp-dev` means the owner's.
-
 ## Two-agent workflow
 
 **Codex** writes analysis, specs and all product code. **Claude** reviews specs and
@@ -261,15 +234,10 @@ 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 → in-task | #… · Document: …
+Verdict: green/yellow/red · cycle r<N>/4 · High: N · Medium: N → #… · Document: …
 ```
 
-High blocks. A Medium finding INSIDE the task's scope is fixed within the task:
-with no High findings the verdict is yellow, the author fixes it and the fix
-passes another review cycle — no separate issue (owner's decision 2026-08-19,
-#202: filing and servicing an issue costs far more than fixing in place). Only
-a Medium finding OUTSIDE the scope becomes its own issue — foreign scope is
-never patched from this branch. Low is fixed or waived with a note
+High blocks. Medium must become its own issue. 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.
@@ -280,9 +248,7 @@ the owner splits the task, rejects it, or arbitrates.
 
 On the light track (`small`: complexity ≤3, one surface, no config migration, no
 new UX contract, no perf or touch impact — all at once) the spec lives in the issue
-body and the spec review is a comment. Code review is never skipped. This track is
-the default: taking the full one means naming the criterion above that the task
-does not meet.
+body and the spec review is a comment. Code review is never skipped.
 
 ## Specs
 
@@ -330,22 +296,12 @@ byte-for-byte:
 
 ```
 cp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js
-npm run bundle:sync   # dist → custom_components + demo/srv/assets (#255)
+cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
 ```
 
-During the implementation cycle the fast gates always run. Since 2026-08-14 the
-owner's machine also carries Playwright with Chromium (Windows) and a full WSL
-environment, which changes one thing (#151): **before moving an issue to
-`S7-code-review`, run the smokes named in its AC locally** — `node
-demo/smoke_<name>.mjs`. A red smoke that reaches the review costs a cycle; run
-locally it costs a minute. Precedent: on #89 a fixture error lived through a
-whole review round that a local run would have caught immediately.
-
-The full smoke set, `golden` and `performance_smoke` still belong to the
-pre-beta run — which is then mandatory and complete. WSL runs of the full HA
-harness (`~/houseplan-card`, venv) and `golden:verify` are advisory; **the canon
-does not move**: the beta gate is CI at the exact SHA, and baselines are accepted
-only via `npm run golden:accept -- --reviewed` on a complete Linux CI artefact.
+During the implementation cycle only the fast gates run. `smoke`, `golden` and
+`performance_smoke` spin up Chromium and belong to the pre-beta run — which is then
+mandatory and complete.
 
 **Backend.** A full Home Assistant harness cannot run on native Windows at all:
 Home Assistant imports the Unix-only `fcntl` module. Its canon is Linux CI or WSL.
@@ -366,22 +322,14 @@ 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. 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.
+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.
 
 **CI is pinned to an exact SHA.** The release gate accepts only a `completed
 success` run for the candidate's SHA, not "the last green one"; a new push cancels
-an unfinished Validate for the same branch. Gate jobs, matching the actual
-`validate.yml` (#191): `docs`, `provenance`, `process-gate`, `hacs`, `hassfest`,
-`frontend`, `smoke`, `golden`, `performance_smoke`, `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.
+an unfinished Validate for the same branch. Jobs: `provenance`, `hacs`, `hassfest`,
+`frontend`, `smoke`, `golden`, `performance_smoke`, `backend`.
 
 **"Verified" without a named command and its result is not evidence.**
 

CONTRIBUTING.md

@@ -9,35 +9,6 @@ User-visible changes go into **both** changelogs in the same commit:
 `docs/CHANGELOG.md` (English) and `docs/CHANGELOG.ru.md` (Russian). Entries
 older than v1.42.0 exist only in the English file — no need to backfill them.
 
-## Translations
-
-A shipped UI language has three matching parts:
-
-1. `src/i18n/<code>.json` for the card;
-2. `custom_components/houseplan/translations/<code>.json` for the Home Assistant
-   integration;
-3. one static entry (dictionary import, code and native label) in
-   `src/i18n/registry.ts`.
-
-Use the canonical Home Assistant/BCP 47 language tag as `<code>` (for example,
-`fr` or `pt-BR`) and use that exact spelling for both JSON filenames. Lookup is
-case-insensitive and also accepts `_` from legacy locale sources.
-
-The registry drives language resolution, the visual-editor selector and parity
-tests. The tests reject missing or extra locale files; frontend dictionaries
-also fail on mismatched keys, empty values and changed placeholders.
-Placeholders such as `{name}` and `{n}` are a contract: do not translate, add
-or remove them.
-
-The current `subst()` helper does not implement plural rules. Phrase strings so
-their grammar does not depend on the numeric value (for example, use a neutral
-label followed by `{n}` rather than an English singular/plural pair).
-
-Adding a UI locale does not automatically create another full documentation
-set; maintain the existing English and Russian documentation according to the
-project's normal rules. Right-to-left layout is a separate product project,
-because the plan canvas and editors cannot be mirrored by translations alone.
-
 ## Where to ask
 
 Not sure whether something is a bug, or just want to discuss an idea before
@@ -47,12 +18,13 @@ requests still belong in [issues](https://github.com/Matysh/houseplan-card/issue
 
 ## Backlog and work status
 
-[GitHub Issues](https://github.com/Matysh/houseplan-card/issues) are the only
-active backlog. An issue owns scope and acceptance criteria; its **labels** own
-priority and workflow status — `PROCESS.md` §9 holds the vocabulary. Before
-starting planned work, link it to an existing issue or create one, and keep it
-current until the verified result is closed. Design specs and ADRs may support an
-issue, but they do not replace it or maintain a separate checklist.
+[GitHub Issues](https://github.com/Matysh/houseplan-card/issues) and the linked
+[GitHub Project v2](https://github.com/users/Matysh/projects/1) are the
+only active project backlog. Issues own scope and acceptance criteria; Project
+v2 owns prioritization and workflow status. Before starting planned work, link
+it to an existing issue or create one, add it to the Project, and keep both
+surfaces current until the verified result is closed. Design specs and ADRs may
+support an issue, but they do not replace it or maintain a separate checklist.
 
 ## Five-minute setup
 
@@ -74,8 +46,8 @@ every push — locally they are skipped when `homeassistant` is not importable.
 
 - **Docs in the same commit**: CHANGELOG entry for user-visible changes;
   `docs/STATUS.md` for state changes; `docs/DEVELOPMENT.md` for new gotchas.
-- Every UI string goes through `src/i18n/<lang>.json`; follow the
-  [Translations](#translations) flow for registry and backend parity.
+- Every UI string goes through `src/i18n/<lang>.json` (tests enforce en/ru key parity).
+  Adding a language = adding one JSON file + registering it in `src/i18n.ts`.
 - The built card must be committed in sync: `cp dist/houseplan-card.js
   custom_components/houseplan/frontend/` (CI compares them byte-for-byte).
 - Tap actions have a security model (locks/alarms never toggle from the plan) —

PROCESS.md

@@ -11,7 +11,7 @@
 > его не содержал вовсе.
 >
 > **Приоритет источников.** Канонический бэклог — GitHub Issues; статус живёт в
-> метках и больше нигде: Project v2 не используется. При расхождении
+> метках, Project v2 остаётся человеческим представлением. При расхождении
 > документации с GitHub побеждает GitHub. При расхождении этого документа с
 > `.github/workflows/*.yml` и `scripts/*` побеждает **фактическая автоматизация**:
 > она исполняется, а описание — нет. Расхождение при этом не игнорируется, а
@@ -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/golden/baselines/**` (копия стенда `demo/srv/assets/houseplan-card.js` с #255 не коммитится вовсе) | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью |
+| **D. Сгенерированное** | `dist/**`, `custom_components/houseplan/frontend/**`, `demo/srv/assets/houseplan-card.js`, `demo/golden/baselines/**` | Никогда не меняется само по себе. Коммит **только** класса D допустим лишь как релизный промоушен или как принятие эталонов с доказательством ревью |
 
 Практический смысл таблицы: «я только поправил тест» и «я только пересобрал
 бандл» перестают быть лазейками.
@@ -86,12 +86,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 
 ### 2.2 Аналитика и оценка
 
-Задача разбирается — и разобранная **сама идёт дальше**. Умолчание изменено
-решением владельца 2026-08-14: раньше аналитика ждала подтверждения по каждому
-пункту, и большинство ожиданий ничего не меняло — issue в основном описаны
-однозначно.
+Задача разбирается, продуктовое «да» ещё не дано.
 
-- **Кто:** агент-аналитик. Владелец не утверждает переход — он правит асинхронно.
+- **Кто:** агент-аналитик готовит, владелец решает.
 - **Чек-лист**, результат — комментарием в issue:
   1. дубликаты проверены (ссылки на похожие issue);
   2. в скоупе по `docs/SCOPE.md` и `docs/TOUCH-SUPPORT.md`;
@@ -101,23 +98,10 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   5. приоритет **P1/P2/P3**;
   6. тип: баг / фича / техдолг;
   7. затронутые поверхности (модули, диалоги, бэкенд, i18n);
-  8. трек — **по умолчанию `small`** (§5). Если задача идёт полным треком,
-     называется критерий §5, который она не проходит: «обычный трек» без
-     названного критерия обоснованием не является.
-- **Оценки и приоритет ставятся метками сразу, согласие не запрашивается.**
-  Комментарий аналитики — уведомление, а не запрос: **молчание владельца —
-  согласие**, несогласие он выражает правкой меток или комментарием, и это не
-  останавливает работу. Право отклонить задачу (`rejected`) остаётся за
-  владельцем на любой стадии.
-- **Вопросов владельцу на этом этапе нет.** Единственный класс вопросов, который
-  вообще задаётся владельцу, — продуктовые (§7.1: что человек видит или делает,
-  объём видимых изменений), и их место — этап ТЗ, пачкой, с вариантами по
-  умолчанию и `blocked`. Вопрос, который можно отложить до ТЗ, не задаётся в
-  аналитике; вопрос, не блокирующий написание ТЗ, не задаётся вовсе — вместо
-  него в ТЗ пишется блок принятых предположений.
-- **Выход:** `S3-spec` — переход выполняет сам аналитик, не дожидаясь ответа.
-  Либо, при явном конфликте со `SCOPE.md`, — предложение отклонить с причиной:
-  это единственный случай, когда аналитика останавливается и ждёт владельца.
+  8. лёгкий трек — да/нет по критериям §5.
+- **Приоритет и ценность — поля владельца.** Агент предлагает, владелец
+  утверждает; иначе агенты приоритизируют сами и P1 разрастается.
+- **Выход:** «ТЗ в работе» либо «Отклонено» с записанной причиной.
 
 ### 2.3 ТЗ в работе — написание ТЗ
 
@@ -133,14 +117,10 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   Его задача — не согласиться, а найти, где ТЗ не выполнимо или не проверяемо.
 - **Артефакт:** `docs/reviews/SPEC-REVIEW-<NN>-r<N>.md`, вердикт
   зелёный / жёлтый / красный. Лёгкий трек — комментарий в issue.
-- **High-находки блокируют.** Medium **в скоупе задачи** чинится в текущем
-  issue: без High это жёлтый вердикт, автор правит ТЗ, фикс проходит повторный
-  цикл. Medium **вне скоупа** — отдельный issue: чужой скоуп в этой задаче не
-  правится. «Оставили в тексте ревью» не считается закрытием ни для одной
-  (решение владельца 2026-08-19, #202: отдельный issue дороже правки на месте).
-  Low либо правится, либо снимается решением ревьюера с записью.
+- **High-находки блокируют.** Medium/Low — либо правятся, либо становятся
+  отдельными issue со ссылкой; «оставили в тексте ревью» не считается закрытием.
 - **Выход:** «Готово к разработке» либо возврат в «ТЗ в работе» — не более
-  4 циклов (§4). Второй и последующие циклы разбираются по дельте (§2.10).
+  4 циклов (§4).
 
 ### 2.5 Готово к разработке (DoR)
 
@@ -193,17 +173,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   кода отвечает на вопрос «оно вообще работает»: каждый AC либо доказан
   автотестом — и ревьюер убедился, что **тест умеет падать**, — либо разобран по
   коду с явной записью «проверено чтением, не исполнением».
-- **High блокируют.** Medium **в скоупе задачи** чинится в текущем issue:
-  без High это жёлтый вердикт и возврат автору, фикс проходит повторный цикл.
-  Medium **вне скоупа** — отдельный issue (#202).
-- **Вердикт привязан к SHA (#312).** Все числа и факты отчёта сверяются с
-  `git rev-parse HEAD` непосредственно перед подведением итогов, а не с SHA,
-  зафиксированным в начале разбора: во время ревью в ветку может прилететь
-  fix-up. Серверный стопор — шаг слияния конвейера сверяет вершину ветки с
-  SHA материала ревью (допустим только собственный doc-коммит публикации
-  поверх) и при расхождении отменяет слияние с возвратом в `S6-in-progress`.
+- **High блокируют.** Medium **обязаны** превратиться в issue.
 - **Выход:** очередь на пре-релиз либо возврат в «В разработке», не более
-  4 циклов (§4). Второй и последующие циклы разбираются по дельте (§2.10).
+  4 циклов (§4).
 
 ### 2.8 Закрытие после выпуска беты
 
@@ -224,42 +196,6 @@ 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. Правила
@@ -281,17 +217,13 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
    ревью-гейт.
 7. **Ревью возвращает не более 4 раз.** Пятый заход — решение владельца: разделить,
    отклонить или арбитраж (§4).
-8. **High блокирует. Medium в скоупе чинится в текущем issue** (без High —
-   жёлтый вердикт и повторный цикл); Medium вне скоупа становится отдельным
-   issue (#202). Low либо правится, либо снимается решением ревьюера с записью
-   в документе.
+8. **High блокирует. Medium становится issue.** 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. **Сгенерированное не коммитится само по себе.** Только релизный промоушен или
@@ -317,24 +249,11 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 
 ## 4. Лимит циклов ревью: 4
 
-Оба ревью-гейта возвращают задачу на правки не более **4 раз**.
+Оба ревью-гейта возвращают задачу на правки не более **4 раз**. Счётчик виден в
+имени документа: `-r1` … `-r4`; на четвёртом заходе ставится метка `review-4`.
 
 - **Что считается циклом:** отправка на ревью → вердикт с блокирующими находками
   → возврат. Уточняющий вопрос без вердикта циклом не считается.
-- **Зелёный вердикт цикла не образует** и бюджет не тратит (решение владельца
-  2026-08-20, issue #227): он ничего не вернул на правки. Практический случай —
-  зелёное ревью, слияние которого не удалось: конвейер сам предписывает ребейз и
-  возврат метки, и этот заход не должен наказываться. Раньше счётчик считал все
-  вердикты подряд, и на #225 последовательность жёлтый → зелёный → ребейз дала
-  `review-4` на задаче с зелёным ревью и зелёным CI.
-- **Заход и цикл — разные величины.** Заход — сколько раз ревью отработало; он
-  виден в имени документа (`-r1`, `-r2`, …) и нужен, чтобы два документа не
-  затёрли друг друга. Цикл — единица бюджета §4. Заходов законно бывает больше,
-  чем циклов, поэтому порог проверки 7 в `scripts/process-gate.mjs` выше лимита
-  циклов (шесть документов = четыре цикла плюс два ребейза).
-- Метка `review-4` ставится, когда исчерпан **бюджет циклов**; конвейер снимать
-  её не вправе — это решение владельца. Если бюджет пересчитан и оказался ниже
-  лимита, конвейер сообщает пересчёт, но метку не трогает.
 - **Исчерпание лимита — не «пятая попытка», а разбор.** Задача уходит владельцу,
   решение одно из трёх:
   1. **разделить** — issue закрывается как «заменён», вместо него 2–3 меньших с
@@ -350,26 +269,9 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
 
 ---
 
-## 5. Лёгкий трек (метка `small`) — путь по умолчанию
+## 5. Лёгкий трек (метка `small`)
 
-Умолчание изменено решением владельца 2026-08-27, issue #338. Прежде полный трек
-был бесплатен, а выбор лёгкого требовал обоснования. Фактическая цена: **2.9
-ревью-документа на задачу** в среднем и до шести на одну issue (#329, #316,
-#290) — при том что Medium-находки всё равно чинятся в той же задаче, без
-отдельного цикла.
-
-**Порог не изменился.** Критерии ниже те же и по-прежнему обязательны все
-одновременно. Изменилась сторона доказательства: теперь обосновывается не выбор
-лёгкого трека, а отказ от него — в `S2-analysis` называется критерий, который
-задача не проходит. Полный трек остаётся тем, чем был, для геометрии, миграций
-конфига и публичных контрактов: там критерии нарушаются сами, и назвать
-нарушенный несложно.
-
-Инверсия умолчания не отменяет ничего из §5 ниже и ничего из §4: бюджет четырёх
-циклов, арбитраж владельца, обязательность ТЗ на полном треке и правило «ревью
-до мержа» остаются как были. Меняется только стоимость пути по умолчанию.
-
-**Критерии — все одновременно; нарушенный называется явно:**
+**Критерии — все одновременно:**
 
 - сложность и риск ≤ 3;
 - одна поверхность (один диалог, один модуль, один эндпоинт);
@@ -528,12 +430,8 @@ issue #NN
 - **Занятие:** `Взял: <роль> · сессия <id> · ветка issue/NN-slug`
 - **Хендофф:** `Сделано: … · Файлы: … · Гейты: <команда → результат> ·
   НЕ сделано: … · Риски: … · Следующий статус: … · Новые issue: #…`
-- **Вердикт ревью:** `Вердикт: зелёный/жёлтый/красный · заход r<N> ·
-  блокирующих циклов K/<лимит> · High: N · Medium: N → в задаче | #… ·
-  Документ: docs/reviews/…`
-  («→ #…» — только у Medium вне скоупа; находки в скоупе возвращаются автору.
-  Заход — номер прогона ревью, K — израсходованный бюджет §4: зелёные вердикты
-  его не тратят, поэтому заход и K расходятся, #227)
+- **Вердикт ревью:** `Вердикт: зелёный/жёлтый/красный · цикл r<N>/<лимит> ·
+  High: N · Medium: N → #… · Документ: docs/reviews/…`
 - **Закрытие:** `Выпущено в <тег беты> · CI: <ссылка> · Changelog: <ссылка>`
 
 **Вперёд двигает только зелёный вердикт.** Жёлтый и красный возвращают автору;
@@ -564,58 +462,23 @@ issue #NN
 npx tsc --noEmit
 npm test
 npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js \
-              # копия стенда собирается `npm run bundle:sync`, в репозитории её нет (#255)
-node scripts/smoke-select.mjs --base origin/dev --head HEAD   # какие смоки относятся к диффу
+              && cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
 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'е по `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` при изменении видимого
+`typecheck`, `npm test`, `npm run build` со сверкой трёх копий бандла. По
+необходимости, определяемой diff'ом и AC: браузерные смоки (их 127 — прогон всех
+уместен только когда задача задевает всё), `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 тега.
 
 Часть гейтов запускается только здесь, то есть **после** пройденного код-ревью.
@@ -629,12 +492,9 @@ Performance зелёные на точном SHA; статусов issue не к
 
 ## 9. Метки — канонический статус
 
-Статус читается из меток: их видно в списке issue, их читает любой токен с
-доступом к Issues, и по ним же работает конвейер — смена метки порождает событие
-(§10.4). **Project v2 не используется** (решение владельца 2026-08-14): второе
-представление статуса рядом с метками требовало отдельного скоупа токена,
-синхронизации и внимания, а давало вид доски. Два источника одного факта
-расходятся — это уже случалось с колонкой «Статус ТЗ» в `docs/specs/README.md`.
+Статус читается из меток: их видно в списке issue и их читает любой токен с
+доступом к Issues, в отличие от Project v2, который требует отдельного скоупа.
+Project v2 остаётся человеческим представлением и синхронизируется по меткам.
 
 **Имена меток английские** (решение владельца 2026-08-12). Русские имена в этом
 документе были только на бумаге; репозиторий с самого начала жил на английских.
@@ -711,13 +571,6 @@ Performance зелёные на точном SHA; статусов issue не к
   считается от `merge-base` с `origin/dev`, а не от начала истории — иначе в него
   попали бы все нарушения, совершённые до появления гейта.
 
-  При возврате `main` в `dev` диапазон merge-коммита содержит второй родитель —
-  уже опубликованные в `main` коммиты с закрытыми issue. Для destination `dev`
-  общий скрипт pre-push/CI исключает только SHA, доказанно достижимые из
-  `origin/main`; сам merge и новые post-merge коммиты остаются под всеми
-  проверками. На `main`, beta/issue-ветки и обычный push в `dev` это исключение
-  не распространяется (issue #155).
-
   Проверка статуса issue требует `gh`, поэтому при его отсутствии хук печатает
   предупреждение и выполняет только офлайн-часть. Это сознательная уступка: хук,
   который не работает в самолёте, отключают целиком, а строгий проход всё равно
@@ -809,8 +662,8 @@ S7-code-review → код-ревью → слияние в dev → S8-merged л
 ```
 
 Ревьюер — `anthropics/claude-code-action`. Он читает `docs/SCOPE.md`, `AGENTS.md`,
-этот документ и тело issue, публикует разбор комментарием, заводит issue на Medium-находки
-вне скоупа задачи (#202), кладёт документ в `docs/reviews/` ветки задачи и возвращает вердикт
+этот документ и тело issue, публикует разбор комментарием, заводит issue на каждую
+Medium-находку, кладёт документ в `docs/reviews/` ветки задачи и возвращает вердикт
 структурированным JSON. **Метку переставляет отдельный детерминированный шаг по
 вердикту, а не модель.**
 
@@ -840,28 +693,6 @@ S7-code-review → код-ревью → слияние в dev → S8-merged л
 никто не может выйти и о котором никто не узнает, для конвейера хуже громкой
 ошибки.
 
-**Ветка приводится к `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`: работа действительно вернулась к автору, только осталась не
 правка кода, а ребейз. Вердикт при этом в силе, переделывать нечего. После ребейза
@@ -956,8 +787,7 @@ Golden, браузерные смоки, performance и полный HA-харн
 - принятие golden-эталонов ради зелёного CI или по частичному артефакту;
 - закрытие issue до выпуска беты с зелёным CI;
 - переоткрытие закрытого issue вместо нового бага;
-- Medium-находки, оставленные как TODO в документе ревью: в скоупе — чинятся
-  в текущем issue, вне скоупа — становятся отдельным (#202);
+- Medium-находки, оставленные как TODO в документе ревью;
 - **параллельные бэклоги** в файлах (`BACKLOG-*.md`, «планы» в docs);
 - ревью-документы вне репозитория;
 - попутные правки «раз уж я здесь»;

README.md

@@ -1,158 +1,379 @@
-# 🏠 House Plan — a live home map for Home Assistant
+# 🏠 House Plan — interactive floor plan card for Home Assistant
 
-[![HACS Default](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
+[![HACS Custom](https://img.shields.io/badge/HACS-Custom-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)
 
-📘 **[Full user guide](docs/USER-GUIDE.md)** · 🇷🇺 **[Русский](README.ru.md)** · 🗂 **[Project issues](https://github.com/Matysh/houseplan-card/issues)**
+**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.
 
-<!-- docs-section: overview -->
+> **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.
 
-## Your whole home at a glance
+![Interactive Home Assistant floor plan: live rooms, devices, lights and climate on a real floorplan card](docs/images/demo.gif)
 
-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.
+> ### 🚀 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.
 
-![Synthetic home in View mode with rooms, devices, light and climate](docs/images/01-view-desktop.png)
+🇷🇺 [Документация на русском](README.ru.md) · 💬 [Telegram chat: **@ha_houseplan**](https://t.me/ha_houseplan)
 
-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.
+**Feature highlights**
 
-> **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).
+- ♾️ **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.
 
-<!-- docs-section: features -->
+---
 
-## What House Plan provides
+## What it is and why
 
-- **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.
+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.
 
-![The same synthetic home in touch View mode](docs/images/02-view-touch.png)
+This is convenient when:
 
-<!-- docs-section: first-run -->
+- 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.
 
-## Your first working room
+The integration consists of two parts that are installed together:
 
-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.
+- **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.
 
-![Creating the first space](docs/images/03-space-create.png)
+---
 
-![Closing a room outline on its first point](docs/images/04-room-contour-close.png)
+## How it differs from alternatives
 
-![A selected partition and the Plan context tray](docs/images/05-plan-context-tray.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:
 
-![Device settings with binding provenance and the exact action result](docs/images/06-device-editor.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 |
 
-![Live presentation preview for the same device](docs/images/06-device-display-preview.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.
 
-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.
+Key advantages in short:
 
-<!-- docs-section: installation -->
+- **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.
 
 ## Installation
 
-### HACS
+One click if you already run HACS:
 
-[![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)
+[![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)
 
-House Plan is in the HACS default catalog — no custom repository needed.
 
-1. In HACS search for **House Plan** and install it.
+### 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.
 2. Restart Home Assistant.
-3. Open **Settings → Devices & services → Add integration → House Plan**.
+3. Add the integration: **Settings → Devices & Services → Add integration → House Plan**.
 
-The card is registered automatically. If you manage Lovelace resources
-manually, use the URL served by the integration:
+### Adding a plan screen
 
-```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:
+Create a new dashboard tab (a "Panel" view works best) and add the card:
 
 ```yaml
 type: custom:houseplan-card
 title: House plan
 ```
 
-Different screens may start on different spaces:
+Nothing else needs to be specified — everything else is configured right on the screen.
 
-```yaml
-type: custom:houseplan-card
-default_floor: ground
-```
+---
 
-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.
+## How to use
 
-## Detailed documentation
+### Step 1. Add a space (floor)
 
-- [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)
+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).
 
-<!-- docs-section: support -->
+![Empty plan — prompt to add a space](docs/images/02-onboarding-empty.png)
 
-## Support and feedback
+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.
 
-- 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.
+![Space creation dialog](docs/images/03-space-dialog.png)
 
-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).
+> 💡 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.
 
-License: [MIT](LICENSE).
+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>

README.ru.md

@@ -1,163 +1,351 @@
-# 🏠 House Plan — живой план дома для Home Assistant
+# 🏠 House Plan — интерактивный поэтажный план дома для Home Assistant
 
-[![HACS Default](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
+[![HACS Custom](https://img.shields.io/badge/HACS-Custom-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)
-[![CI](https://github.com/Matysh/houseplan-card/actions/workflows/validate.yml/badge.svg)](https://github.com/Matysh/houseplan-card/actions)
+[![GitHub stars](https://img.shields.io/github/stars/Matysh/houseplan-card)](https://github.com/Matysh/houseplan-card/stargazers)
 [![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)** · 🇬🇧 **[English](README.md)** · 🗂 **[Задачи проекта](https://github.com/Matysh/houseplan-card/issues)**
+📘 **[Полное руководство пользователя](docs/USER-GUIDE.ru.md)** · 🗂 **[Беклог проекта](https://github.com/users/Matysh/projects/1)**
 
-<!-- docs-section: overview -->
+**Превратите Home Assistant в живую интерактивную карту дома.** Загрузите или
+нарисуйте план этажа, обведите комнаты мышкой — и умные устройства появятся на
+своих местах: живые состояния, свет по клику, температура и влажность по
+комнатам, карта Zigbee-сигнала, светящиеся пятна ламп и полноэкранный
+киоск-режим для настенного планшета. Без YAML, без Inkscape и внешних
+редакторов — весь план настраивается прямо на дашборде.
 
-## Дом целиком — одним взглядом
+> **Редактировать планы рекомендуется на компьютере.** Режим просмотра и
+> киоск полноценно поддерживаются на телефонах и планшетах. Редакторы рассчитаны
+> прежде всего на desktop с мышью и клавиатурой: на touch-устройстве отдельные
+> операции могут быть менее удобны, работать ограниченно или отсутствовать.
 
-House Plan превращает Home Assistant в живую карту дома. Загрузите изображение
-плана или нарисуйте комнаты прямо на дашборде, свяжите их с зонами Home
-Assistant — и устройства появятся на плане автоматически. Сразу видно, где
-горит свет, открыта дверь, слишком холодно, слабый Zigbee-сигнал или сработал
-датчик протечки.
+![Интерактивный план дома для Home Assistant: комнаты, устройства, свет и климат на реальном поэтажном плане](docs/images/demo.gif)
 
-![Синтетический дом в режиме просмотра: комнаты, устройства, свет и климат](docs/images/01-view-desktop.png)
+> ### 🚀 Попробовать вживую — без установки
+> **[demo.houseplan.tech](https://demo.houseplan.tech)** — настоящий Home
+> Assistant с готовым планом. Вход **`demo`** / **`demo`**, можно нажимать всё:
+> включать свет, открывать редакторы, ломать что угодно. Каждый час стенд сам
+> возвращается в исходное состояние.
 
-Настройка выполняется в графическом интерфейсе: без YAML-разметки, Inkscape и
-внешнего редактора плана. Данные плана и расположение устройств хранятся на
-сервере Home Assistant и синхронизируются между экранами.
+🇬🇧 [Documentation in English](README.md) · 💬 [Чат в Telegram: **@ha_houseplan**](https://t.me/ha_houseplan)
 
-> **Редактируйте на компьютере.** Режим просмотра и киоск полноценно работают
-> на телефонах и планшетах. Редакторы рассчитаны прежде всего на мышь и
-> клавиатуру; на touch отдельные операции могут быть неудобны или недоступны.
-> Подробный контракт: [поддержка touch](docs/TOUCH-SUPPORT.md).
+**Главное**
 
-<!-- docs-section: features -->
+- ♾️ **Бесконечный холст** — нет «размера плана» и нет края, за который
+  нельзя выйти: рисуйте и ставьте устройства где угодно, тащите план на
+  любом зуме, отдаляйтесь, чтобы увидеть всё, и одной кнопкой вписывайте
+  план обратно в экран.
+- 🖱 **Редакторы прямо в карточке** — комнаты, двери, окна и ворота, комнаты-острова,
+  виртуальные стены и декор-слой рисуются кликами; размеры комнат меняются
+  перетаскиванием стен с живыми длинами и площадями; помощник выравнивания и
+  линейка в реальных метрах.
+- 💡 **Свет переключается кликом** из коробки; значок выключателя может
+  управлять группой ламп (в т.ч. «тупые» выключатели и кнопки-пульты).
+- 🌒 **Заливка «Свет по источникам»** — тёмный дом, где каждая горящая лампа
+  освещает ровно тот пол, который видит: через проёмы и открытые границы,
+  а стены, колонны и перегородки его не пропускают и дают настоящие тени.
+- ☀️ **Солнце на плане** — задайте компас, и фон живёт вместе с днём
+  (белый полдень → золотой час → глубокая ночь), а окна внешних стен пускают
+  в комнаты настоящие клинья солнечного света; облачность — опционально, от
+  weather-сущности.
+- 🪟 **Шторы открываются тапом** — одно действие открывает, закрывает или
+  останавливает штору, а сам значок морфится между открытым и закрытым
+  видом и мягко пульсирует кольцом, пока штора едет.
+- 🌡 **Карточки комнат**: температура, влажность, Zigbee-сигнал, свет «1 из 3»;
+  температурная заливка по комфортным границам.
+- 🚪 **Двери, окна и замки** с датчиками — отпирание только явной кнопкой,
+  никогда случайным тапом.
+- 📺 **Киоск-режим** для настенных планшетов и ТВ: полноэкранно, свайп между
+  этажами, автокарусель, свои размеры на каждом экране.
+- 🤖 **Роботы-пылесосы вживую** — маркер-база стоит на месте, а круглая
+  шайба ездит по плану в реальном времени, «выливая» путь из-под себя;
+  текущая и прошлая уборки хранятся на сервере. Калибровка — в один клик
+  (по именам комнат) или перетаскиванием призрака карты. Диагностика и явный
+  выбор источника поддерживают registry-less камеры карт и не подменяют молча
+  сломавшуюся привязку. Работают Xiaomi Cloud Map Extractor, dreame-vacuum
+  (Tasshack) и Valetudo.
+- 🔔 Новые устройства сами появляются на плане с красной точкой; раскладка
+  хранится **на сервере HA** — один план для всех экранов, живая синхронизация.
 
-## Что умеет House Plan
+---
 
-- **Живые состояния и безопасные действия.** Свет и другие безопасные устройства
-  переключаются с плана; замок нельзя открыть случайным нажатием.
-- **Три встроенных редактора.** «План» создаёт комнаты, стены и проёмы;
-  «Устройства» размещает и настраивает маркеры; «Подложка» добавляет линии,
-  подписи и мебель.
-- **Комнаты, связанные с зонами HA.** Новые устройства появляются автоматически,
-  а карточки комнат показывают температуру, влажность, свет и средний LQI.
-- **Свет и окружение.** Заливки комнат, Glow от ламп, тени от стен, дневной фон и
-  солнечные лучи из окон.
-- **Двери, окна, ворота и пылесосы.** Проёмы отражают реальные датчики и замки;
-  робот показывает позицию, базу и пройденный путь.
-- **Несколько этажей и экранов.** Вкладки пространств, жесты переключения,
-  локальный масштаб и отдельный стартовый этаж для каждой карточки.
-- **Киоск для настенного экрана.** Только план, полноэкранная навигация и размеры
-  значков, сохранённые отдельно для этого устройства.
 
-![Тот же синтетический дом в touch-режиме просмотра](docs/images/02-view-touch.png)
+## Что это и зачем
 
-<!-- docs-section: first-run -->
+House Plan показывает ваш умный дом так, как он выглядит на самом деле — на плане этажей. Вместо длинных списков сущностей вы видите комнаты и устройства на своих местах: где протечка, какая температура в детской, включён ли свет в прихожей, открыты ли ворота.
 
-## Первая рабочая комната
+Это удобно, когда:
 
-1. Установите интеграцию и добавьте карточку на дашборд.
-2. Создайте первое **пространство**: загрузите SVG/PNG/JPG/WebP либо выберите
-   вариант без изображения, чтобы нарисовать план вручную.
-3. В редакторе «План» выберите **Контур комнаты**, поставьте вершины и замкните
-   контур нажатием на первую точку.
-4. Назовите комнату и свяжите её с зоной Home Assistant. Для помещения без
-   устройств выберите «Без зоны».
-5. Откройте «Устройства»: устройства связанной зоны уже размещены автоматически;
-   перетащите маркеры в нужные места.
-6. При необходимости оформите подложку линиями, текстом и мебелью.
-7. Вернитесь в «Просмотр» — теперь план показывает живые состояния и принимает
-   безопасные действия.
+- устройств много, и списками пользоваться неудобно;
+- нужно быстро понять состояние дома «одним взглядом»;
+- хочется отдать доступ близким — по картинке разберётся любой;
+- вы хотите красивый обзорный экран для настенного планшета.
 
-![Создание первого пространства](docs/images/03-space-create.png)
+Интеграция состоит из двух частей, которые ставятся вместе:
 
-![Замыкание контура комнаты на первой точке](docs/images/04-room-contour-close.png)
+- **карточка Lovelace** `houseplan-card` — сам интерактивный план;
+- **серверный компонент** — хранит разметку комнат и позиции иконок в Home Assistant, поэтому план одинаков во всех браузерах и на всех устройствах.
 
-![Выбранная перегородка и контекстная панель редактора плана](docs/images/05-plan-context-tray.png)
+---
 
-![Настройка устройства с источником привязки и точным результатом действия](docs/images/06-device-editor.png)
+## Чем отличается от аналогов
 
-![Живой предпросмотр отображения того же устройства](docs/images/06-device-display-preview.png)
+Обычно план дома в Home Assistant делают через `picture-elements`, `ha-floorplan`
+или новые GUI-карточки, где стены и мебель рисуют прямо на дашборде. Там либо
+YAML/SVG, либо конфиг живёт в YAML карточки. House Plan — это **общий живой
+план** на серверной интеграции Home Assistant:
 
-Пошаговые сценарии, все инструменты и особые случаи описаны в
-[полном руководстве](docs/USER-GUIDE.ru.md). Возможности подложки отдельно
-зафиксированы в [документе редактора](docs/DECOR-EDITOR.md), а роботов — в
-[руководстве по пылесосам](docs/VACUUM.md).
+| | 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-section: installation -->
+**Одной фразой:** 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).
 
 ## Установка
 
-### Через HACS
+В один клик, если у вас уже есть HACS:
 
-[![Открыть репозиторий в 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)
+[![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)
 
-House Plan входит в основной каталог HACS — пользовательский репозиторий
-добавлять не нужно.
 
-1. Найдите **House Plan** в поиске HACS и установите.
-2. Перезапустите Home Assistant.
-3. Откройте **Настройки → Устройства и службы → Добавить интеграцию → House Plan**.
+### Через HACS (рекомендуется)
 
-Карточка регистрируется автоматически. Если ресурсы Lovelace управляются вручную,
-добавьте именно URL, который публикует интеграция:
+1. Откройте **HACS → меню (⋮) → Custom repositories**.
+2. Вставьте URL этого репозитория, категория — **Integration**, и нажмите **Add**.
+3. Найдите в списке **House Plan**, установите и **перезапустите Home Assistant**.
+4. Перейдите в **Настройки → Устройства и службы → Добавить интеграцию** и выберите **House Plan**.
 
-```yaml
-resources:
-  - url: /houseplan_files/houseplan-card.js
-    type: module
-```
+Карточка подключается автоматически — добавлять ресурс Lovelace вручную не нужно.
 
-Не используйте путь к файлу внутри `custom_components`: Home Assistant не
-публикует его как JavaScript-модуль.
+> **Карточка не грузится (`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/houseplan` в `config/custom_components`,
-перезапустите Home Assistant и добавьте интеграцию House Plan.
+1. Скопируйте папку `custom_components/houseplan` в каталог `config/custom_components` вашего Home Assistant.
+2. Перезапустите Home Assistant.
+3. Добавьте интеграцию: **Настройки → Устройства и службы → Добавить интеграцию → House Plan**.
 
-### Добавление карточки
+### Добавление экрана с планом
 
-Создайте представление дашборда (лучше Panel) и добавьте карточку через UI либо:
+Создайте новую вкладку дашборда (удобнее всего — в режиме «Панель»/Panel) и добавьте карточку:
 
 ```yaml
 type: custom:houseplan-card
 title: План дома
 ```
 
-Для нескольких экранов можно задать разные стартовые пространства:
+Больше ничего указывать не нужно — всё остальное настраивается прямо на экране.
 
-```yaml
-type: custom:houseplan-card
-default_floor: ground
-```
+---
 
-Все карточки используют общие серверные комнаты и координаты. Текущий режим,
-масштаб и выбранное пространство локальны для экрана. Одновременное
-редактирование поддерживает синхронизацию и проверку ревизий, но один объект
-лучше не менять параллельно в двух браузерах.
+## Как пользоваться
 
-## Где искать подробности
+### Шаг 1. Добавьте пространство (этаж)
 
-- [Полное руководство пользователя](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)
+При первом открытии план ещё пуст — House Plan сразу предложит создать первое пространство.
 
-<!-- docs-section: support -->
+Если в вашем Home Assistant уже настроены **этажи**, мастер предложит создать
+пространство для каждого: названия подставятся сами, план попросит по очереди,
+любой этаж можно пропустить.
 
-## Помощь и обратная связь
+![Пустой план — предложение добавить пространство](docs/images/02-onboarding-empty.png)
 
-- Вопросы и примеры планов: [Telegram @ha_houseplan](https://t.me/ha_houseplan).
-- Баги и предложения: [GitHub Issues](https://github.com/Matysh/houseplan-card/issues).
-- Перед отчётом обновите House Plan, перезапустите HA и выполните жёсткое
-  обновление страницы (`Ctrl+F5`). Приложите версию, браузер, логи и шаги
-  воспроизведения; приватные entity ID можно заменить вымышленными.
+В диалоге задайте **название** (например, «1 этаж») и выберите подложку: **загрузите** картинку плана (SVG, PNG, JPG, WebP), **возьмите уже загруженную** на сервер ранее или отметьте **«без подложки, нарисую комнаты сам»**. Холст бесконечный; картинка по умолчанию сохраняет пропорции, а подвинуть, изменить размер или повернуть её можно в любой момент в редакторе подложки.
 
-Скриншоты в документации получены воспроизводимой командой
-`npm run build && node demo/docs/capture.mjs` только на синтетических данных. Версия сценариев,
-fingerprint исходников и хеш каждого изображения находятся в
-[индексе снимков](docs/images/screenshots.json).
+![Диалог создания пространства](docs/images/03-space-dialog.png)
 
-Лицензия: [MIT](LICENSE).
+> 💡 Подложку можно нарисовать в любом планировщике (например, РЕМПЛАННЕР) или сфотографировать бумажный план. Лучше всего 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>

custom_components/houseplan/const.py

@@ -5,7 +5,7 @@ STORAGE_KEY = f"{DOMAIN}.layout"
 STORAGE_CONFIG_KEY = f"{DOMAIN}.config"
 STORAGE_VIRTUAL_LIGHTS_KEY = f"{DOMAIN}.virtual_lights"
 STORAGE_VERSION = 1
-STORAGE_MINOR_VERSION = 2
+STORAGE_MINOR_VERSION = 1
 FRONTEND_URL = "/houseplan_files/houseplan-card.js"
 PLANS_URL = "/houseplan_files/plans"
 PLANS_DIR = "houseplan/plans"  # relative to the HA configuration directory
@@ -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.68.1"
+VERSION = "1.63.0"
 
 # 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 = 9
+PLAN_MODEL_VERSION = 6
 EXPORT_VERSION = 1
 MAX_EXPORT_BYTES = 8 * 1024 * 1024
 IMPORT_PREVIEW_TTL_S = 10 * 60
@@ -65,5 +65,5 @@ MAX_IMPORT_PREVIEWS_TOTAL = 3
 DEFAULT_CONFIG: dict = {
     "spaces": [],
     "markers": [],
-    "settings": {"bg_mode": "daynight"},
+    "settings": {},
 }

custom_components/houseplan/coordinate_canonicalization.py

@@ -1,180 +0,0 @@
-"""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

custom_components/houseplan/junction_limits.py

@@ -1,428 +0,0 @@
-"""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
-
-import logging
-
-from .wall_segment_model import (
-    WALL_SEGMENT_MODEL_VERSION, WallSegmentMigrationError, commit_wall_segment_model,
-)
-
-_LOGGER = logging.getLogger(__name__)
-
-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
-# #331 §2.1: below this two points are ONE node / a node is ON the wall —
-# floating debris of pre-canonicalisation arithmetic, not a near miss.
-_INCIDENT_EPS = 2e-7
-_KEY_FACTOR = 1e7
-
-
-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 _quantize_key_coord(value: float) -> float:
-    """#331 §2.1: the canonicalisation formula — sign*floor(|v|*f+0.5)/f.
-
-    Native round() is banker's rounding and parts ways with JS Math-style
-    rounding on .5 ticks; coordinate canonicalisation already encodes this
-    parity lesson, and node keys must follow it. -0 normalises to 0.
-    """
-    rounded = math.copysign(
-        math.floor(abs(value) * _KEY_FACTOR + 0.5), value,
-    ) / _KEY_FACTOR
-    return 0.0 if rounded == 0 else rounded
-
-
-def _key(point) -> str:
-    return f"{_quantize_key_coord(point[0])},{_quantize_key_coord(point[1])}"
-
-
-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
-            # A ~0° pair is NOT a violation — and cannot be (#331 revision 4,
-            # learned in the field): a shared wall of two adjacent rooms is
-            # two co-located owner atoms ON ONE LINE, so every shared-wall
-            # node carries a legitimate 0° pair by construction. An exact
-            # duplicate stays a KNOWN LIMITATION of П1 at this level.
-            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 _build_node_index(segments: list[dict]) -> dict[str, list[dict]]:
-    by_node: dict[str, list[dict]] = {}
-    for item in segments:
-        for point in (item["a"], item["b"]):
-            by_node.setdefault(_key(point), []).append(item)
-    return by_node
-
-
-def collinear_run_length_units(
-    segment: dict, segments: list[dict],
-    by_node_index: dict[str, list[dict]] | None = None,
-) -> float:
-    """Length of the WALL a segment belongs to, not of the atom.
-
-    #331 §2.3/§2.4: an iterative edge walk over the collinear component — no
-    recursion (a 10 000-atom chain must answer, not overflow), no
-    combinatorial DFS (every atom joins at most once, O(E)), no silently
-    dropped fork. Collinearity is measured against the BASE segment's axis,
-    so an arc of small per-atom turns cannot pose as one straight wall.
-
-    #330 §4.3: the per-check caller builds the node index once.
-    """
-    by_node = by_node_index if by_node_index is not None else _build_node_index(segments)
-    visited = {id(segment)}
-    total = _length(segment["a"], segment["b"])
-    frontier = [segment["a"], segment["b"]]
-    base_cm = float(segment.get("cm") or 0)
-    while frontier:
-        node = frontier.pop()
-        for candidate in by_node.get(_key(node), ()):
-            if id(candidate) in visited:
-                continue
-            if not _collinear(candidate, segment):
-                continue
-            if float(candidate.get("cm") or 0) != base_cm:
-                continue
-            visited.add(id(candidate))
-            total += _length(candidate["a"], candidate["b"])
-            frontier.append(candidate["a"])
-            frontier.append(candidate["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]] = []
-    by_node = _build_node_index(segments)
-    for segment in segments:
-        units = collinear_run_length_units(segment, segments, by_node)
-        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.
-
-    #330 §4.5: the all-pairs form cost 372 ms on 576 atoms. Nodes and padded
-    segment bounding boxes are hashed into a grid with the threshold as cell
-    size; each node is compared only against its 9-cell neighbourhood.
-    Verdicts are identical — pinned by the equivalence unit and the parity
-    suite. Pair order inside the subject follows the lexicographic key order,
-    which replaces the i<j of the all-pairs loop.
-    """
-    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)
-    size = min_units if min_units > _EPS else 1.0
-
-    node_grid: dict[tuple[int, int], list] = {}
-    for node_key, point in nodes.items():
-        node_grid.setdefault(
-            (int(point[0] // size), int(point[1] // size)), []
-        ).append((node_key, point))
-    segment_grid: dict[tuple[int, int], list] = {}
-    for segment in segments:
-        x0 = min(segment["a"][0], segment["b"][0]) - min_units
-        x1 = max(segment["a"][0], segment["b"][0]) + min_units
-        y0 = min(segment["a"][1], segment["b"][1]) - min_units
-        y1 = max(segment["a"][1], segment["b"][1]) + min_units
-        for cx in range(int(x0 // size), int(x1 // size) + 1):
-            for cy in range(int(y0 // size), int(y1 // size) + 1):
-                segment_grid.setdefault((cx, cy), []).append(segment)
-
-    violations: list[tuple[str, str, float, float]] = []
-    for node_key, point in nodes.items():
-        cx, cy = int(point[0] // size), int(point[1] // size)
-        for dx in (-1, 0, 1):
-            for dy in (-1, 0, 1):
-                for other_key, other in node_grid.get((cx + dx, cy + dy), ()):
-                    if node_key >= other_key:
-                        continue
-                    distance = _length(point, other)
-                    # #331 §2.1: raw debris within the incidence quantum is ONE
-                    # node on two neighbouring keys — never a near miss.
-                    if distance <= _INCIDENT_EPS:
-                        continue
-                    if distance < min_units - 1e-9:
-                        violations.append((
-                            "distance", f"{node_key} ↔ {other_key}",
-                            (distance / grid_pitch) * (cell_cm or 1),
-                            MIN_NODE_DISTANCE_CM,
-                        ))
-        for segment in segment_grid.get((cx, cy), ()):
-            # 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(point, 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, *, side: str = "previous") -> 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 {}
-    # #330 §4.6: a document that already carries the current catalogue is
-    # used as-is. The migration's purpose here is to never compare a
-    # catalogue-less legacy baseline against a migrated candidate; a
-    # current-version document has the catalogue, so the purpose is met with
-    # zero work — while a no-op re-migration costs 0.8 s of _atomize on a
-    # 576-atom plan. Equivalence "as-is == migrated" for current-version
-    # documents is pinned by a parity case.
-    if int(config.get("model_version") or 0) >= WALL_SEGMENT_MODEL_VERSION:
-        migrated = config
-    else:
-        try:
-            migrated, _ = commit_wall_segment_model(config)
-        except (WallSegmentMigrationError, ValueError) as error:
-            # The wall-model barrier owns this verdict and reports it with its
-            # own code; here it merely means "no catalogue to read".
-            _LOGGER.debug("junction limits: %s migration fell back: %s", side, error)
-            migrated = config
-        except Exception:
-            # #331 §2.6 (AC6): a genuine migration bug on the CANDIDATE side
-            # must surface as an honest WS error, not a silent "no
-            # violations". The PREVIOUS side keeps the wide fallback — an
-            # unprovable inheritance is no reason to block an unrelated write
-            # (the exact P1 symptom this task fixes).
-            if side == "candidate":
-                raise
-            _LOGGER.debug("junction limits: previous-side migration bug swallowed by design")
-            migrated = config
-    return {
-        str(space.get("id")): space
-        for space in (migrated or {}).get("spaces") or []
-        if isinstance(space, dict)
-    }
-
-
-def space_violation_counts(spaces: dict[str, dict]) -> dict[str, dict[str, int]]:
-    """Violation counts per space per rule — the shape the barrier consumes
-    and the rev cache (#330 §4.2) stores. Documents are NOT retained."""
-    result: dict[str, dict[str, int]] = {}
-    for space_id, space in spaces.items():
-        counts: dict[str, int] = {}
-        for rule, _subject, _actual, _limit in space_violations(space):
-            counts[rule] = counts.get(rule, 0) + 1
-        result[space_id] = counts
-    return result
-
-
-def validate_junction_limits(
-    config: dict, previous: dict | None = None, *,
-    baseline_counts: dict[str, dict[str, int]] | None = None,
-) -> dict[str, dict[str, int]]:
-    """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.
-
-    A LEGACY document still goes through `commit_wall_segment_model` first,
-    so a catalogue-less baseline is compared in the same terms as the
-    candidate; a current-version document is used as-is (#330 §4.6).
-
-    `baseline_counts` (#330 §4.2) replaces the previous document entirely:
-    the caller caches the counts of the stored document by config_rev, so a
-    repeated write does not even touch `previous`. Returns the candidate's
-    counts — the value to cache after a successful write.
-    """
-    if baseline_counts is not None:
-        old_counts = baseline_counts
-    else:
-        old_counts = space_violation_counts(_migrated_spaces(previous))
-    new_spaces = _migrated_spaces(config, side="candidate")
-    candidate_counts: dict[str, dict[str, int]] = {}
-    for space_id, space in new_spaces.items():
-        # A brand-new space has nothing to inherit from — but neither is a
-        # first write allowed to arrive already broken.
-        before = old_counts.get(space_id) or {}
-        after: dict[str, list[tuple[str, str, float, float]]] = {}
-        for violation in space_violations(space):
-            after.setdefault(violation[0], []).append(violation)
-        candidate_counts[space_id] = {
-            rule: len(items) for rule, items in after.items()
-        }
-        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)
-    return candidate_counts

custom_components/houseplan/manifest.json

@@ -16,5 +16,5 @@
   "issue_tracker": "https://github.com/Matysh/houseplan-card/issues",
   "requirements": [],
   "single_config_entry": true,
-  "version": "1.68.1"
+  "version": "1.63.0"
 }

custom_components/houseplan/projection.py

@@ -1,95 +0,0 @@
-"""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
-    }

custom_components/houseplan/store.py

@@ -2,7 +2,6 @@
 from __future__ import annotations
 
 import asyncio
-import copy
 import logging
 from collections.abc import Awaitable, Callable
 from dataclasses import dataclass, field
@@ -20,39 +19,9 @@ from .const import (
     STORAGE_VERSION,
     STORAGE_VIRTUAL_LIGHTS_KEY,
 )
-from .coordinate_canonicalization import (
-    canonicalize_config_geometry,
-    canonicalize_layout_geometry,
-)
 
 
 _LOGGER = logging.getLogger(__name__)
-_BG_MODES = frozenset({"static", "daynight"})
-
-
-def migrate_config_background_mode(old_data: dict[str, Any]) -> dict[str, Any]:
-    """Materialize the legacy implicit background mode without changing its view.
-
-    Only the config-store document has a top-level ``config`` object. Layout
-    and virtual-light stores pass through this helper unchanged even though
-    they share the same Store subclass and minor version.
-    """
-    config = old_data.get("config")
-    if not isinstance(config, dict):
-        return old_data
-    settings = config.get("settings")
-    mode = settings.get("bg_mode") if isinstance(settings, dict) else None
-    if mode in _BG_MODES:
-        return old_data
-
-    data = copy.deepcopy(old_data)
-    migrated_config = data["config"]
-    migrated_settings = migrated_config.get("settings")
-    if not isinstance(migrated_settings, dict):
-        migrated_settings = {}
-        migrated_config["settings"] = migrated_settings
-    migrated_settings["bg_mode"] = "static"
-    return data
 
 
 class HouseplanStore(Store):
@@ -70,9 +39,10 @@ class HouseplanStore(Store):
         old_minor_version: int,
         old_data: dict[str, Any],
     ) -> dict[str, Any]:
-        if old_major_version == 1 and old_minor_version < 2:
-            return migrate_config_background_mode(old_data)
-        return old_data
+        data = old_data
+        # if old_major_version == 1 and old_minor_version < 2:
+        #     ...migrate...
+        return data
 
 
 @dataclass
@@ -101,11 +71,6 @@ class HouseplanData:
     # Parsed import candidates are short-lived, user-bound and memory-only.
     # dict keeps insertion order, which lets the preview service evict oldest.
     import_previews: dict[str, dict[str, Any]] = field(default_factory=dict)
-    # #330 §4.2: junction-limit violation counts of the STORED document,
-    # keyed by its rev — (rev, {space_id: {rule: count}}). One slot,
-    # memory-only, invalidated by a rev mismatch; the previous document is
-    # not re-judged on every write. Counts only — documents are never held.
-    junction_baseline: tuple[int, dict[str, dict[str, int]]] | None = None
 
 
 HouseplanConfigEntry = ConfigEntry[HouseplanData]
@@ -166,7 +131,7 @@ def layout_store_payload(
     }
     if metadata:
         out.update(metadata)
-    out["layout"] = canonicalize_layout_geometry(layout)
+    out["layout"] = layout
     out["rev"] = rev
     return out
 
@@ -214,8 +179,7 @@ async def async_save_config_state(
         except (TypeError, ValueError):
             previous_rev = 0
 
-    canonical_config = canonicalize_config_geometry(config)
-    payload = {"config": canonical_config, "rev": rev}
+    payload = {"config": config, "rev": rev}
     await runtime.config_store.async_save(payload)
 
     # The config is already durable at this point.  Reconciliation remains a
@@ -226,7 +190,7 @@ async def async_save_config_state(
     try:
         await async_reconcile_virtual_lights(
             runtime.virtual_light_store,
-            canonical_config,
+            config,
             rev,
             previous_config_rev=previous_rev,
         )

custom_components/houseplan/trails.py

@@ -10,7 +10,6 @@ want to see where the cleanup has already been).
 from __future__ import annotations
 
 import asyncio
-import math
 import time
 from typing import Any
 
@@ -25,33 +24,11 @@ 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.
 
@@ -87,10 +64,7 @@ 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")
-        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:
+        if not cur or cur.get("ended") 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:
@@ -99,9 +73,7 @@ class TrailBook:
             rec["current"] = cur
         pts: list[list[float]] = cur["points"]
         if pts and pts[-1][0] == x and pts[-1][1] == y:
-            # Clearing ended is observable state even if the source repeats
-            # the dock point: it must still reach Store and live cards.
-            return resumed
+            return False
         pts.append([x, y])
         if len(pts) > TRAIL_CAP:
             # decimate by two but never lose the freshest point
@@ -113,7 +85,7 @@ class TrailBook:
 
     def end_run(self, marker: str, now: float) -> bool:
         cur = (self.data.get(marker) or {}).get("current")
-        if cur and cur.get("ended") is None:
+        if cur and not cur.get("ended"):
             cur["ended"] = now
             return True
         return False

custom_components/houseplan/wall_segment_model.py

@@ -1,684 +0,0 @@
-"""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

custom_components/houseplan/websocket_api.py

@@ -24,11 +24,6 @@ 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 (
@@ -60,21 +55,11 @@ 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, OpeningPassageError,
-    PartitionOpeningHostError, PartitionOpeningJambMarginError,
-    WallModelClientOutdatedError, sanitize_filename,
-    validate_opening_passages, validate_partition_opening_hosts,
+    PLAN_EXTENSIONS, POS_SCHEMA, MarkerControlError, sanitize_filename,
     validate_marker_controls, validate_marker_light_entities,
-    validate_marker_value_badges, validate_wall_model_transition, valid_space_id,
+    validate_marker_value_badges, valid_space_id,
 )
 
 
@@ -151,7 +136,6 @@ 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)
@@ -279,7 +263,6 @@ 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,
     }
 )
@@ -304,7 +287,6 @@ 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("")),
                 )
@@ -440,12 +422,8 @@ async def ws_import_apply(hass: HomeAssistant, connection, msg: dict[str, Any])
             if kind == "full":
                 backup = {
                     "kind": "import",
-                    "config": canonicalize_config_geometry(
-                        config_data.get("config") or DEFAULT_CONFIG
-                    ),
-                    "layout": canonicalize_layout_geometry(
-                        layout_data.get("layout") or {}
-                    ),
+                    "config": config_data.get("config") or DEFAULT_CONFIG,
+                    "layout": layout_data.get("layout") or {},
                     "created": int(time.time()),
                     "after_config_rev": new_config_rev,
                     "after_layout_rev": new_layout_rev,
@@ -462,20 +440,16 @@ async def ws_import_apply(hass: HomeAssistant, connection, msg: dict[str, Any])
                 final_metadata[_OPTIMIZE_BACKUP] = backup
             pending = {
                 "kind": "import",
-                "config": canonicalize_config_geometry(target_config),
-                "layout": canonicalize_layout_geometry(target_layout),
+                "config": target_config,
+                "layout": target_layout,
                 "config_rev": new_config_rev,
                 "layout_rev": new_layout_rev,
                 "final_metadata": final_metadata,
             }
             rollback = {
                 "kind": "import_rollback",
-                "config": canonicalize_config_geometry(
-                    config_data.get("config") or DEFAULT_CONFIG
-                ),
-                "layout": canonicalize_layout_geometry(
-                    layout_data.get("layout") or {}
-                ),
+                "config": config_data.get("config") or DEFAULT_CONFIG,
+                "layout": layout_data.get("layout") or {},
                 "config_rev": config_rev,
                 "layout_rev": layout_rev,
                 "final_metadata": original_metadata,
@@ -518,9 +492,6 @@ 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",
     })
 
@@ -540,15 +511,10 @@ 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",
-        vol.Optional("space_id"): vol.All(str, vol.Length(min=1, max=200)),
-    }
-)
+@websocket_api.websocket_command({vol.Required("type"): "houseplan/layout/get"})
 @websocket_api.async_response
 async def ws_layout_get(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
-    """Return the saved layout, optionally narrowed to one space (#256)."""
+    """Return the saved layout."""
     rt = _runtime(hass, connection, msg["id"])
     if rt is None:
         return
@@ -556,9 +522,7 @@ 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": project_layout(
-                data.get("layout", {}), space_id=msg.get("space_id"),
-            ),
+            "layout": data.get("layout", {}),
             "rev": int(data.get("rev", 0)),
             "can_optimize_undo": _optimizer_backup_is_current(config_data, data),
             "undo_kind": _undo_kind(config_data, data),
@@ -598,9 +562,6 @@ 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,
@@ -662,10 +623,7 @@ async def ws_layout_update(hass: HomeAssistant, connection, msg: dict[str, Any])
             return
         data = await rt.store.async_load() or {}
         layout = data.get("layout", {})
-        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"]}
+        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)
@@ -773,10 +731,7 @@ 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": canonicalize_layout_geometry(touched),
-                },
+                "repair_backup": {"space": space_id, "positions": touched},
             },
             remove=("repair_backup",),
         )
@@ -1099,20 +1054,7 @@ async def ws_layout_delete(hass: HomeAssistant, connection, msg: dict[str, Any])
 # ---------------- space configuration ----------------
 
 
-_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.websocket_command({vol.Required("type"): "houseplan/config/get"})
 @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.
@@ -1120,11 +1062,6 @@ 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:
@@ -1148,20 +1085,12 @@ async def ws_config_get(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
     connection.send_result(
         msg["id"],
         {
-            "config": project_config(
-                config,
-                space_id=msg.get("space_id"),
-                fields=msg.get("fields"),
-                marker_fields=msg.get("marker_fields"),
-            ),
+            "config": config,
             "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,
         },
     )
 
@@ -1270,9 +1199,7 @@ def _missing_internal_attachments(
 @websocket_api.websocket_command(
     {
         vol.Required("type"): "houseplan/config/set",
-        # Semantic stale-client detection needs the stored v8 document and
-        # therefore runs inside the write lock before CONFIG_SCHEMA.
-        vol.Required("config"): dict,
+        vol.Required("config"): CONFIG_SCHEMA,
         vol.Optional("expected_rev"): int,
     }
 )
@@ -1321,41 +1248,13 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
         # Marker-to-marker light links are a semantic graph layered on top of
         # the lossless controls array. Validate only edges introduced by this
         # write so an unrelated edit can still round-trip a legacy broken ref.
-        # #330 §4.1/§4.2: the CPU part of validation runs in the executor —
-        # schema + semantic validators cost seconds on a large plan and the
-        # event loop must not carry that (HA guideline: >50 ms). write_lock
-        # is still held across the await: writes stay serialised, only the
-        # loop is freed. The junction baseline of the STORED document is
-        # cached by rev, so a repeated write does not re-judge `previous`.
-        baseline = rt.junction_baseline
-        baseline_counts = baseline[1] if baseline and baseline[0] == current_rev else None
-
-        def _validate_config_cpu():
-            validate_wall_model_transition(msg["config"], data.get("config"))
-            checked = CONFIG_SCHEMA(msg["config"])
-            msg["config"].clear()
-            msg["config"].update(checked)
+        try:
             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"))
-            validate_opening_passages(msg["config"], data.get("config"))
-            validate_partition_opening_hosts(msg["config"], data.get("config"))
-            return validate_junction_limits(
-                msg["config"], data.get("config"),
-                baseline_counts=baseline_counts,
-            )
-        try:
-            candidate_counts = await hass.async_add_executor_job(_validate_config_cpu)
-        except (
-            JunctionLimitError, MarkerControlError, OpeningPassageError,
-            PartitionOpeningHostError, PartitionOpeningJambMarginError,
-            WallModelClientOutdatedError,
-        ) as err:
+        except MarkerControlError 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
@@ -1373,17 +1272,6 @@ 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,
@@ -1391,9 +1279,6 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
             new_rev,
             previous_rev=int(current_rev),
         )
-        # The candidate just became the stored document: its counts are the
-        # next write's baseline (#330 §4.2).
-        rt.junction_baseline = (int(new_rev), candidate_counts)
         try:
             await _discard_optimizer_snapshot(rt)
         except Exception:  # noqa: BLE001 — stale backup cleanup is best-effort
@@ -1426,197 +1311,10 @@ 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"): dict,
+        vol.Required("config"): CONFIG_SCHEMA,
         vol.Required("layout"): LAYOUT_SCHEMA,
         vol.Required("expected_config_rev"): int,
         vol.Required("expected_layout_rev"): int,
@@ -1660,63 +1358,13 @@ async def ws_plan_optimize(hass: HomeAssistant, connection, msg: dict[str, Any])
         # Optimization is a normal configuration write with an additional
         # layout transaction. It must enforce the same marker-link semantics
         # as config/set; otherwise a crafted client can persist a new cycle.
-        # #330 §4.1: the same executor treatment as config/set — Optimize
-        # carries schema + a possible full migration, the costliest CPU path
-        # of all writers, and it used to run on the event loop.
-        def _validate_optimize_cpu():
-            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)
-            checked = CONFIG_SCHEMA(candidate_config)
-            migrated_size = len(json.dumps(checked, separators=(",", ":")))
-            if migrated_size > MAX_CONFIG_BYTES:
-                return migrated_size
-            msg["config"].clear()
-            msg["config"].update(checked)
+        try:
             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"))
-            validate_opening_passages(msg["config"], config_data.get("config"))
-            validate_partition_opening_hosts(
-                msg["config"], config_data.get("config"),
-                allow_optimize_rehost=True,
-            )
-            return None
-        try:
-            oversize = await hass.async_add_executor_job(_validate_optimize_cpu)
-            if oversize is not None:
-                connection.send_error(
-                    msg["id"], "too_large",
-                    f"Configuration is {oversize // 1024} KB, "
-                    f"the limit is {MAX_CONFIG_BYTES // 1024} KB",
-                )
-                return
-        except (
-            JunctionLimitError, MarkerControlError, OpeningPassageError,
-            PartitionOpeningHostError, PartitionOpeningJambMarginError,
-            WallModelClientOutdatedError,
-            WallSegmentMigrationError,
-        ) as err:
+        except MarkerControlError 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,
@@ -1735,19 +1383,15 @@ async def ws_plan_optimize(hass: HomeAssistant, connection, msg: dict[str, Any])
         new_layout_rev = layout_rev + 1
         backup = {
             "kind": "optimize",
-            "config": canonicalize_config_geometry(
-                config_data.get("config") or DEFAULT_CONFIG
-            ),
-            "layout": canonicalize_layout_geometry(
-                layout_data.get("layout", {})
-            ),
+            "config": config_data.get("config") or DEFAULT_CONFIG,
+            "layout": layout_data.get("layout", {}),
             "created": int(time.time()),
             "after_config_rev": new_config_rev,
             "after_layout_rev": new_layout_rev,
         }
         pending = {
-            "config": canonicalize_config_geometry(msg["config"]),
-            "layout": canonicalize_layout_geometry(msg["layout"]),
+            "config": msg["config"],
+            "layout": msg["layout"],
             "config_rev": new_config_rev,
             "layout_rev": new_layout_rev,
             "clear_backup": False,
@@ -1817,12 +1461,8 @@ 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 = canonicalize_config_geometry(
-            backup.get("config") or DEFAULT_CONFIG
-        )
-        restored_layout = canonicalize_layout_geometry(
-            backup.get("layout") or {}
-        )
+        restored_config = backup.get("config") or DEFAULT_CONFIG
+        restored_layout = backup.get("layout") or {}
         new_config_rev = config_rev + 1
         new_layout_rev = layout_rev + 1
         pending = {

demo/README.md

@@ -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/`:
-  `npm run bundle:sync` (копия стенда не коммитится, #255).
+  `cp dist/houseplan-card.js demo/srv/assets/`.
 - `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`.

demo/benchmark_coincident_partitions.mjs

@@ -1,92 +0,0 @@
-// #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;

demo/benchmark_coordinate_write_barrier.mjs

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

demo/benchmark_glow.mjs

@@ -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'), targetRoot,
+  {}, resolve(targetRoot, 'demo/srv'),
 );
 await page.addScriptTag({
   content: `window.__hpAssertCardContract = ${assertCardContract.toString()};`,

demo/benchmark_junction_limits.mjs

@@ -1,169 +0,0 @@
-/**
- * #330 §5: the performance contract of the junction limits (#329).
- *
- * Guards the CLASS of regression — a quadratic path returning — not runner
- * noise: budgets are 2-3x the measured post-fix numbers. Measures the exact
- * code the write barrier runs: the pure П1-П5 checks over a 576-atom plan
- * (the S2 reproduction grid of #330), for both mirrors. The python half runs
- * through a child process with the real custom_components module.
- *
- * Runs on test-build/ like benchmark:wall-model — no browser, no bundle.
- */
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-
-import {
-  checkNodes, checkSegmentLengths, checkNodeDistances, checkRoomClearance,
-  cmToUnits,
-} from '../test-build/junction-limits.js';
-import { commitWallSegmentModel } from '../test-build/wall-segment-model.js';
-import { GRID_STEP_N } from '../test-build/space-geometry.js';
-import {
-  innerContourForRoom, multiWallNodesForGeometry, wallBodiesGeometry,
-} from '../test-build/wall-thickness.js';
-
-const REPO_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
-const CELL = 5;
-const GRID_N = 12; // 576 contour atoms — the #330 S2 grid
-const WARMUPS = 2;
-const SAMPLES = 5;
-
-// Budgets are calibrated from the SLOWEST machine observed, not the
-// author's: the CI review runner measured tsFullCandidateMs at 169-171 ms
-// where the dev sandbox saw 88 (code-review 330-r1 H2). Each budget keeps
-// the spec's 2-3x allowance over that worst observation, so the bench turns
-// red for the O(n²) class (which costs seconds), not for a slower runner.
-const BUDGETS = {
-  tsSegmentLengthsMs: 60,
-  tsNodeDistancesMs: 80,
-  tsFullCandidateMs: 400,
-  pyWarmValidateMs: 300,
-  pyColdValidateMs: 5000,
-};
-
-const u = (cm) => cmToUnits(cm, CELL, GRID_STEP_N);
-const rooms = []; const walls = []; let k = 0;
-for (let i = 0; i < GRID_N; i++) {
-  for (let j = 0; j < GRID_N; j++) {
-    const x0 = u(310) * i; const y0 = u(310) * j;
-    const poly = [[x0, y0], [x0 + u(300), y0], [x0 + u(300), y0 + u(300)], [x0, y0 + u(300)]];
-    rooms.push({ id: `r${i}-${j}`, name: `r${i}${j}`, area: null, poly });
-    for (let e = 0; e < 4; e++) {
-      walls.push({ key: `w${k++}`, a: poly[e], b: poly[(e + 1) % 4], cm: 15 });
-    }
-  }
-}
-const legacy = {
-  spaces: [{
-    id: 's', title: 's', cell_cm: CELL, view_box: [0, 0, 1, 1],
-    rooms, walls, openings: [], room_drafts: [], partitions: [], wall_columns: [],
-  }],
-  markers: [], settings: {},
-};
-const { config: v9 } = commitWallSegmentModel(JSON.parse(JSON.stringify(legacy)));
-const space = v9.spaces[0];
-const segments = (space.wall_segments || []).map((item) => ({
-  id: item.id, a: item.a, b: item.b, cm: Number(item.cm),
-}));
-
-/** The same П1-П5 set the card's write barrier computes for one candidate. */
-const fullCandidate = () => {
-  const violations = [
-    ...checkNodes(segments),
-    ...checkSegmentLengths(segments, CELL, GRID_STEP_N),
-    ...checkNodeDistances(segments, CELL, GRID_STEP_N),
-  ];
-  // #330 §4.7: shared passes exactly as the card computes them.
-  const sharedNodes = multiWallNodesForGeometry(
-    space.rooms || [], space.walls || [], [], GRID_STEP_N, CELL, GRID_STEP_N, 1,
-  );
-  let sharedRoomGeometry;
-  if (sharedNodes.nodes.length) {
-    const geometry = wallBodiesGeometry(
-      space.rooms || [], space.walls || [], [], [], GRID_STEP_N, CELL, GRID_STEP_N, 1,
-    );
-    sharedRoomGeometry = geometry?.status === 'ok' || geometry?.status === 'degraded-extra'
-      ? geometry.roomGeom : undefined;
-  }
-  for (const room of space.rooms || []) {
-    let inner = null;
-    try {
-      inner = innerContourForRoom(
-        space.rooms || [], String(room.id), space.walls || [], [],
-        GRID_STEP_N, CELL, GRID_STEP_N, 1, sharedRoomGeometry, sharedNodes,
-      );
-    } catch { inner = null; }
-    violations.push(...checkRoomClearance(String(room.id), inner, CELL, GRID_STEP_N));
-  }
-  return violations.length;
-};
-
-const median = (fn) => {
-  for (let i = 0; i < WARMUPS; i++) fn();
-  const times = [];
-  for (let i = 0; i < SAMPLES; i++) {
-    const start = performance.now();
-    fn();
-    times.push(performance.now() - start);
-  }
-  times.sort((left, right) => left - right);
-  return times[Math.floor(times.length / 2)];
-};
-
-const tsSegmentLengthsMs = median(() => checkSegmentLengths(segments, CELL, GRID_STEP_N));
-const tsNodeDistancesMs = median(() => checkNodeDistances(segments, CELL, GRID_STEP_N));
-const tsFullCandidateMs = median(fullCandidate);
-
-// Python mirror: cold (legacy both sides) and warm (v9 + baseline counts).
-const pyScript = `
-import importlib.util, sys, types, os, json, time
-root = ${JSON.stringify(REPO_ROOT)}
-pr = os.path.join(root, 'custom_components'); hr = os.path.join(pr, 'houseplan')
-pkg = types.ModuleType('custom_components'); pkg.__path__ = [pr]; sys.modules['custom_components'] = pkg
-p2 = types.ModuleType('custom_components.houseplan'); p2.__path__ = [hr]; sys.modules['custom_components.houseplan'] = p2
-spec = importlib.util.spec_from_file_location('custom_components.houseplan.junction_limits', os.path.join(hr, 'junction_limits.py'))
-jl = importlib.util.module_from_spec(spec); sys.modules[spec.name] = jl; spec.loader.exec_module(jl)
-legacy = json.load(sys.stdin)
-from custom_components.houseplan.wall_segment_model import commit_wall_segment_model
-v9, _ = commit_wall_segment_model(json.loads(json.dumps(legacy)))
-prev = json.loads(json.dumps(v9)); cand = json.loads(json.dumps(v9))
-cand['spaces'][0]['rooms'][0]['name'] = 'x'
-t0 = time.perf_counter()
-jl.validate_junction_limits(json.loads(json.dumps(legacy)), json.loads(json.dumps(legacy)))
-cold = 1000 * (time.perf_counter() - t0)
-counts = jl.validate_junction_limits(json.loads(json.dumps(cand)), json.loads(json.dumps(prev)))
-best = None
-for _ in range(3):
-    t0 = time.perf_counter()
-    jl.validate_junction_limits(json.loads(json.dumps(cand)), None, baseline_counts=counts)
-    warm = 1000 * (time.perf_counter() - t0)
-    best = warm if best is None else min(best, warm)
-print(json.dumps({'pyColdValidateMs': cold, 'pyWarmValidateMs': best}))
-`;
-const python = process.env.PYTHON || (process.platform === 'win32' ? 'python' : 'python3');
-const pyRun = spawnSync(python, ['-c', pyScript], {
-  input: JSON.stringify(legacy), encoding: 'utf8', maxBuffer: 64 * 1024 * 1024,
-});
-if (pyRun.status !== 0) {
-  console.error('python mirror failed:', (pyRun.stderr || '').slice(-2000));
-  process.exit(1);
-}
-const py = JSON.parse(pyRun.stdout.trim().split('\n').pop());
-
-const results = {
-  tsSegmentLengthsMs, tsNodeDistancesMs, tsFullCandidateMs,
-  pyWarmValidateMs: py.pyWarmValidateMs, pyColdValidateMs: py.pyColdValidateMs,
-};
-const pass = Object.entries(BUDGETS).every(([name, budget]) => results[name] <= budget);
-console.log(JSON.stringify({
-  issue: 330,
-  fixture: { atoms: segments.length, grid: `${GRID_N}x${GRID_N}` },
-  warmups: WARMUPS, samples: SAMPLES,
-  results: Object.fromEntries(Object.entries(results).map(
-    ([name, value]) => [name, Math.round(value * 10) / 10],
-  )),
-  budgets: BUDGETS,
-  pass,
-}, null, 2));
-if (!pass) process.exitCode = 1;

demo/benchmark_large_house.mjs

@@ -14,27 +14,11 @@ const warmups = Math.max(0, Math.min(5, Number(valueArg('warmups')) || 1));
 const output = valueArg('output') ? resolve(valueArg('output')) : null;
 const targetRoot = resolve(valueArg('target-root') ?? '.');
 const profile = valueArg('profile') ?? 'large-house-v1';
-if (!['large-house-v1', 'large-house-isometric-v1', 'large-house-plan-snap-v1'].includes(profile))
+if (!['large-house-v1', 'large-house-isometric-v1'].includes(profile))
   throw new Error(`unknown large-house profile: ${profile}`);
 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()) {
-    space.room_drafts = [0, 1].map((draft) => {
-      const y = 0.985 + draft * 0.025;
-      return {
-        id: `perf-draft-${floor}-${draft}`,
-        points: [[0.10, y], [0.38, y], [0.46, y + 0.035]],
-        segments: [{ cm: 15 }, { cm: 20 }],
-      };
-    });
-  }
-  fixture.counts = { ...fixture.counts, drafts: 6, pointerMoves: 120 };
-}
 const viewport = { width: 1440, height: 1000 };
 
 const { page, browser } = await launch(
@@ -43,7 +27,6 @@ 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,10 +48,7 @@ const rows = [];
 try {
   for (let iteration = 0; iteration < warmups + samples; iteration++) {
     const measuredSample = iteration - warmups;
-    const row = await page.evaluate(async ({
-      fixture, sample, cardContract, isometric, requiresIsometric, planSnap, requiresPlanSnap,
-      requiresWallFace,
-    }) => {
+    const row = await page.evaluate(async ({ fixture, sample, cardContract, isometric, requiresIsometric }) => {
       const frame = () => new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
       const until = async (predicate, timeout = 10000) => {
         const started = performance.now();
@@ -124,8 +104,6 @@ try {
         openingTunnel: card._openingTunnelCache ? 1 : 0,
         openingWallIndex: card._openingWallIndexCache ? 1 : 0,
         isoGeometry: card._isoGeometryCache?.size ?? 0,
-        planSnapGeometry: card._planSnapGeometryCache ? 1 : 0,
-        wallFaceGraph: card._wallFaceGraphCache?.length ?? 0,
       });
 
       window.__card?.remove?.();
@@ -142,7 +120,6 @@ try {
       card.setConfig({
         type: 'custom:houseplan-card', title: `Performance baseline ${sample}`, icon_size: 3.4,
       });
-      let wsCalls = 0;
       const connection = {
         subscribeEvents: async () => () => undefined,
         subscribeMessage: async () => () => undefined,
@@ -157,7 +134,6 @@ try {
           three: { floor_id: 'three', name: 'Three', level: 2 },
         },
         callWS: async (message) => {
-          wsCalls++;
           if (message.type === 'houseplan/config/get')
             return { config: structuredClone(fixture.config), rev: 1, can_write: true };
           if (message.type === 'houseplan/layout/get')
@@ -179,13 +155,6 @@ 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'
@@ -227,112 +196,6 @@ try {
         await card.updateComplete;
       });
 
-      let planSnapDiagnostics = null;
-      const planSnapPointer = planSnap ? await duration(async () => {
-        card._setMode('plan');
-        card._tool = 'draw';
-        card._path = [];
-        card.requestUpdate();
-        await card.updateComplete;
-        await frame();
-        const stage = card.renderRoot.querySelector('.stage');
-        const overlay = card.renderRoot.querySelector('[data-hp="plan-snap-overlay"]');
-        if (requiresPlanSnap && !overlay) throw new Error('plan-snap candidate has no overlay');
-        const staticLines = overlay?.querySelectorAll('.plan-snap-line').length ?? 0;
-        const staticNodes = overlay?.querySelectorAll('.plan-snap-node[data-kind="endpoint"]').length ?? 0;
-        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) => ({
-          clientX: rect.left + ((x - view.x) / view.w) * rect.width,
-          clientY: rect.top + ((y - view.y) / view.h) * rect.height,
-        });
-        const firstEndpoint = overlay?.querySelector('.plan-snap-node[data-kind="endpoint"]');
-        const longLine = [...(overlay?.querySelectorAll('.plan-snap-line') || [])]
-          .map((line) => ({
-            line,
-            a: [+line.getAttribute('x1'), +line.getAttribute('y1')],
-            b: [+line.getAttribute('x2'), +line.getAttribute('y2')],
-          }))
-          .sort((a, b) => Math.hypot(b.b[0] - b.a[0], b.b[1] - b.a[1])
-            - Math.hypot(a.b[0] - a.a[0], a.b[1] - a.a[1]))[0];
-        const points = [
-          firstEndpoint
-            ? [+firstEndpoint.getAttribute('cx'), +firstEndpoint.getAttribute('cy')]
-            : [40, 40],
-          longLine
-            ? [(longLine.a[0] + longLine.b[0]) / 2, (longLine.a[1] + longLine.b[1]) / 2]
-            : [120, 40],
-          [10, 10],
-        ];
-        const seenKinds = new Set();
-        for (let index = 0; index < 120; index++) {
-          const point = points[index % points.length];
-          stage.dispatchEvent(new PointerEvent('pointermove', {
-            ...fromPlan(point[0], point[1]),
-            bubbles: true, composed: true, pointerId: 880, pointerType: 'mouse',
-          }));
-          await card.updateComplete;
-          const active = card.renderRoot.querySelector(
-            '[data-hp="plan-snap-overlay"] .plan-snap-node[data-active="true"]',
-          );
-          if (active) seenKinds.add(active.getAttribute('data-kind'));
-          if (requiresPlanSnap && card.renderRoot.querySelectorAll(
-            '[data-hp="plan-snap-overlay"] .plan-snap-node[data-active="true"]',
-          ).length > 1) throw new Error('plan-snap rendered more than one active candidate');
-        }
-        const finalOverlay = card.renderRoot.querySelector('[data-hp="plan-snap-overlay"]');
-        planSnapDiagnostics = {
-          supported: requiresPlanSnap,
-          staticLines,
-          staticNodes,
-          activeKinds: [...seenKinds].sort(),
-          cacheStable: cacheValue != null && card._planSnapGeometryCache?.value === cacheValue,
-          domStable: (finalOverlay?.querySelectorAll('.plan-snap-line').length ?? 0) === staticLines
-            && (finalOverlay?.querySelectorAll('.plan-snap-node[data-kind="endpoint"]').length ?? 0)
-              === 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;
-
       const resizePreview = await duration(async () => {
         card._setMode('plan');
         card._tool = 'resize';
@@ -346,7 +209,7 @@ try {
           target: null,
         };
         card._rszEdgeDown(quietEvent, room.id, 1);
-        const plan = card._resize?.plan;
+        const plan = card._rszDrag?.plan;
         if (!plan) throw new Error('large-house resize plan was not created');
         const target = [
           plan.a[0] + plan.n[0] * card._gridPitch,
@@ -416,10 +279,6 @@ try {
         modelReadyMs,
         firstStableRenderMs,
         ...(viewToggle ? { viewToggleMs: viewToggle.ms } : {}),
-        ...(planSnapPointer ? {
-          planSnapPointerMs: planSnapPointer.ms,
-          planSnapDiagnostics,
-        } : {}),
         spaceSwitchMs: spaceSwitch.ms,
         stateUpdateMs: stateUpdate.ms,
         resizePreviewMs: resizePreview.ms,
@@ -429,7 +288,6 @@ try {
         longTasks: {
           load: loadLongTaskResult,
           ...(viewToggle ? { viewToggle: viewToggle.longTasks } : {}),
-          ...(planSnapPointer ? { planSnapPointer: planSnapPointer.longTasks } : {}),
           spaceSwitch: spaceSwitch.longTasks,
           stateUpdate: stateUpdate.longTasks,
           resizePreview: resizePreview.longTasks,
@@ -448,7 +306,7 @@ try {
       return result;
     }, {
       fixture, sample: measuredSample, cardContract: LARGE_HOUSE_CARD_CONTRACT,
-      isometric, requiresIsometric, planSnap, requiresPlanSnap, requiresWallFace,
+      isometric, requiresIsometric,
     });
     if (measuredSample >= 0) rows.push(row);
   }
@@ -461,7 +319,6 @@ const metricNames = [
   'resizePreviewMs', 'panZoomMs', 'settingsDialogMs', 'switchCycleMs',
 ];
 if (isometric) metricNames.splice(2, 0, 'viewToggleMs');
-if (planSnap) metricNames.splice(2, 0, 'planSnapPointerMs');
 const report = {
   schema: 2,
   profile,

demo/benchmark_optimize_geometry_preflight.mjs

@@ -1,96 +0,0 @@
-// #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;

demo/benchmark_safe_resize.mjs

@@ -1,107 +0,0 @@
-// #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;

demo/benchmark_safe_resize_render.mjs

@@ -1,78 +0,0 @@
-// #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;

demo/benchmark_wall_union_isolation.mjs

@@ -1,118 +0,0 @@
-// #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;

demo/bundle-freshness.mjs

@@ -29,32 +29,3 @@ 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);
-}

demo/capture_device_icon_reference.mjs

@@ -1,202 +0,0 @@
-#!/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}`);

demo/capture_wall_strip_backup.mjs

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

demo/docs/capture.mjs

@@ -1,158 +0,0 @@
-#!/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();
-}

demo/docs/screenshots.mjs

@@ -1,75 +0,0 @@
-/**
- * Каталог сценариев съёмки документации. Отдельным модулем, потому что его
- * читают трое: сам капчур, `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,
-  },
-]);

demo/downgrade_open_passage.mjs

@@ -1,59 +0,0 @@
-// 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 });
-}

demo/fixtures/large-house.mjs

@@ -3,8 +3,6 @@
  * 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;
@@ -215,14 +213,8 @@ export const makeLargeHouseFixture = () => {
       cell_cm: 5,
       settings: { fill_mode: 'glow', show_borders: true, show_names: true },
       rooms,
-      // 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,
+      walls: segments.map((wall, index) => ({
+        key: `perf-wall-${floor}-${index}`, cm: 15, a: wall.a, b: wall.b,
       })),
       openings: makeOpenings(floor, segments, openingCount),
       partitions: makePartitions(floor, rooms, partitionCount),

demo/fixtures/v8-draft-regression.mjs

@@ -1,86 +0,0 @@
-/**
- * #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: {},
-  };
-}

demo/fixtures/visual-matrix.mjs

@@ -4,13 +4,22 @@ 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 — 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';
+// 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)}`;
+};
 
 const uniqueEdges = (rooms) => {
   const edges = new Map();
@@ -48,11 +57,6 @@ 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',
@@ -118,25 +122,7 @@ const lightingSpace = {
   decor: [],
 };
 
-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 runtime = () => {
   const devices = {};
   const entities = {};
   const states = {
@@ -150,8 +136,7 @@ const runtime = (includeAppliance = false) => {
   // The production projection must preserve them.
   const layout = {};
   const areas = Object.fromEntries(
-    [...geometryRooms, ...lightingRooms, ...(includeAppliance ? applianceRooms : [])]
-      .map((room) => [room.area, { area_id: room.area, name: room.name }]),
+    [...geometryRooms, ...lightingRooms].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('-', '_')}`;
@@ -186,44 +171,6 @@ const runtime = (includeAppliance = false) => {
   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 };
 };
 
@@ -235,12 +182,9 @@ export const VISUAL_MATRIX_COUNTS = Object.freeze({
   columns: geometrySpace.wall_columns.length + lightingSpace.wall_columns.length,
 });
 
-export const makeVisualMatrixFixture = ({ applianceLifecycle = false } = {}) => ({
+export const makeVisualMatrixFixture = () => ({
   config: {
-    spaces: [
-      structuredClone(geometrySpace), structuredClone(lightingSpace),
-      ...(applianceLifecycle ? [structuredClone(applianceSpace)] : []),
-    ],
+    spaces: [structuredClone(geometrySpace), structuredClone(lightingSpace)],
     // 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.
@@ -257,10 +201,6 @@ export const makeVisualMatrixFixture = ({ applianceLifecycle = false } = {}) =>
       },
     },
   },
-  ...runtime(applianceLifecycle),
-  counts: applianceLifecycle ? {
-    ...VISUAL_MATRIX_COUNTS,
-    spaces: VISUAL_MATRIX_COUNTS.spaces + 1,
-    rooms: VISUAL_MATRIX_COUNTS.rooms + applianceRooms.length,
-  } : VISUAL_MATRIX_COUNTS,
+  ...runtime(),
+  counts: VISUAL_MATRIX_COUNTS,
 });

demo/fixtures/wall-key.mjs

@@ -1,63 +0,0 @@
-/**
- * Ключ записи толщины стены — один на все фикстуры проекта.
- *
- * Копия формулы из `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)}`;
-};

demo/golden/README.md

@@ -28,12 +28,6 @@ radial spokes visible instead of hiding them under a translucent room fill.
 - `accept` requires `--reviewed`, a complete candidate report and current
   source fingerprint. It validates the whole set before copying anything and
   is the only command allowed to update baselines.
-- `scripts/golden-accept.mjs` wraps `accept` and additionally requires the
-  reviewer to declare intent: every scenario whose capture differs from its
-  accepted baseline must be named in `--expect-change=<id,id>`. Anything else
-  that differs refuses the whole acceptance, before a single file is copied.
-  This is what makes a local capture admissible (see below) and it
-  simultaneously blocks the one-command "accept everything so CI turns green".
 
 ## Workflow
 
@@ -41,7 +35,7 @@ Build and copy the exact current source first:
 
 ```bash
 npm run build
-npm run bundle:sync
+cp dist/houseplan-card.js demo/srv/assets/houseplan-card.js
 npm run golden:capture
 ```
 
@@ -49,57 +43,17 @@ Review `artifacts/golden/actual/` and, when existing references are present,
 `artifacts/golden/diff/`. If every image is intentional:
 
 ```bash
-node scripts/golden-accept.mjs --reviewed --expect-change=wall-junctions-plan-t-dark
+npm run golden:accept -- --reviewed
 npm run golden:verify
 ```
 
 Never accept images merely to make CI green. A matrix/framing change increments
 `GOLDEN_MATRIX_VERSION`; a normal rendering fix does not. The first canonical
 Linux baseline was reviewed and accepted during the v1.60.3-beta.1 gate.
-
-## Capturing candidates without a second CI round trip (#334)
-
-Accepting from the `golden-images` CI artifact still works and is still the
-safest route: unpack it and pass `--from=...`. It costs two full CI runs per
-visual fix, though — one to produce the artifact and one to verify the accepted
-baseline — and at matrix version 48 that toll is paid often.
-
-A local capture is admissible instead, because admissibility is now *proved*
-rather than assumed. Desktop font rasterisation can differ from the runner, but
-it cannot differ quietly: it would move every text-bearing scenario, not only
-the ones under edit. So the rule is simply that the capture must reproduce every
-accepted baseline the reviewer did not intend to change:
-
-```bash
-node scripts/golden-container.mjs                      # capture in the pinned image
-node scripts/golden-accept.mjs --reviewed --expect-change=<the scenarios you changed>
-```
-
-If the environment is not pixel-equivalent, unrelated scenarios come out
-`different`, the wrapper names them and refuses. A wrong container tag or a
-mismatched font set therefore cannot corrupt baselines — it can only fail.
-
-`scripts/golden-container.mjs` derives the image tag from the `playwright`
-version locked in `package-lock.json`, so the container Chromium equals the
-runner's; `--image=` overrides it when a distro-specific tag is needed
-(`...:v1.62.0-jammy`). The host `node_modules` is shadowed by an anonymous
-volume: the repository copy may be built for Windows, and `npm ci` inside the
-container would otherwise replace it with Linux binaries. The run does write
-`dist/` and the three bundle copies, exactly as a local `npm run bundle:sync`
-would.
-
-Docker is not a requirement of the rule, only a convenience: any Linux
-environment that satisfies the parity condition qualifies, WSL included. The
-`chromium` string recorded in the manifest keeps the browser build itself
-pinned, and `golden:verify` rejects a manifest captured by a different build.
-
-`scripts/golden-accept.mjs` deliberately wraps `demo/golden/accept.mjs` instead
-of replacing its checks: every `.mjs` under `demo/golden` belongs to
-`sourceFingerprint`, so editing the acceptance tool itself would declare the
-committed bundle, the documentation screenshot manifest and the baseline
-manifest stale — the very double round trip this change removes. Narrowing that
-corpus is worthwhile but separate: `scripts/source-fingerprint.mjs` is itself a
-build input, so any change to it forces one bundle rebuild.
+Future updates must still use the `golden-images` artifact produced by the Linux
+CI job as the review set: desktop font rasterisation can differ from the CI
+environment even with the same pinned Chromium. Pass its unpacked root via
+`--from=...` when accepting it locally.
 
 Scenarios may also declare a semantic pixel region (for example, a receiving
 room that must contain warm light). `golden:capture` and `golden:verify` reject

demo/golden/baselines/baselines-index.json

@@ -1,140 +1,59 @@
 {
   "schema": 1,
-  "matrixVersion": 48,
-  "acceptedAt": "2026-08-27T19:14:12.216Z",
-  "sourceFingerprint": "d3735b5ee1f41b4fbf52f95046ab81f8a4ca9e15b02b8b9ca4ff8e7eff3bb179",
+  "matrixVersion": 18,
+  "acceptedAt": "2026-08-13T19:26:19.387Z",
+  "sourceFingerprint": "27fda3d75e4cda95b9d85a9481f15ccd44b96d8c9d3311e0476718d36e2588c5",
   "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": "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"
+    "split-corner-wall-thin-dark": "6da64905a3a4f8e4b4d457e5b20d2d55e0e7c2c601316a088c4bcc6557d35cc6",
+    "split-corner-wall-thick-dark": "494d559aa71ee85f90b8cfa11c1d3087fa123e963dec2b0975e7ce6c1520852a",
+    "isometric-geometry-view-dark": "73939fa61bebe2254591a788fad455a026a5e3b7394eeff27d4fe9a905de7ad2",
+    "isometric-geometry-view-light": "fc62f6ee8935d2e0c57b4918bf5fe554056a5956747b53a752ae265349ce662e",
+    "isometric-live-layers-dark": "869c62bf9cd762c36d342d1a3bbd992969425b46b132f3243439735e2c75c14f",
+    "isometric-no-borders-dark": "36f972f95704bff81ea1a59bdf3cd2cf7b636ec7871780460e98b23e3ebc3da2",
+    "isometric-touch-kiosk-dark": "5eba7794e563e1ef5b9387184693c819976454d0efd222bd12b38aad8ea03e20",
+    "isometric-large-warm-remount-dark": "798d312671dffebf59034a39f2865a65ece27a84b150e77bc59038bb2567d07c",
+    "geometry-view-dark-fit": "3df272f6c3c3d20e9e375ea037f3dbb885657b94b0b29d0067505f4a73741237",
+    "geometry-view-light-fit": "a7f2c9667d9872dd84a37d5318fd238c9eabcc0f413017eb19e02204587b4e1a",
+    "geometry-plan-editor-dark": "19b5c84943b70074ba1aae51d1e54f9a59c44dde34fff89e32f0babb1e90a2ca",
+    "opening-placement-door-thick-wall-dark": "395c03bbf5d968e83664fd6621f0ac25902e718022f2e92ffbcddb8ce629cf9c",
+    "geometry-devices-editor-dark": "a9e4846ce5453400b87e6ad3d575882bc23a07b59dc3eecb612ed872b0c871ec",
+    "geometry-decor-editor-dark": "435b36096bbb2996d56ff0af262ddebff4a727edd841b0fad9b8d4f507b987ac",
+    "tray-wide-selection-en": "024ac666ac4dac01a36f7d1fdbf3bb41f76a627377f7c02dc373f429dfe96d43",
+    "tray-wide-tool-ru": "669fc1cf04433b936c0e9d05799ad19eda8bc003d5ab71937d0512c8f49ba921",
+    "tray-medium-group-en": "50cd3980b21f554bec2e76f4d2e8032f4bd30c0679477eb2f5cbe22f68935b7c",
+    "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": "1957c1c797c7793fb8dcf592ca74c9f2e3eccfcf4bac1d0187482c055bebb93b",
+    "backup-space-preview-mobile-ru": "998c6b52c1cc95109feb440a9966cade738154ceeae387246d40f8c56f9e8a3a"
   }
 }