build: prepare v1.73.0-beta.3 candidate

Issue: #53
Issue: #481
User-Visible: yes
Release: v1.73.0-beta.3

.github/workflows/mutation-gate.yml

@@ -31,8 +31,13 @@ on:
 permissions:
   contents: read
 
+# Группа зависит от события (#472). Прежде она была одна на всё, и ручной
+# запуск перед релизом отменял идущий по расписанию — так 24.08 погиб
+# еженедельный прогон, а отменённый в списке выглядит «не красным». Поймать
+# отмену изнутри нельзя: вместе с прогоном отменяются и не начавшиеся job,
+# включая любой репортёр. Значит отмену надо не ловить, а не допускать.
 concurrency:
-  group: mutation-gate
+  group: mutation-gate-${{ github.event_name }}
   cancel-in-progress: true
 
 jobs:
@@ -88,5 +93,104 @@ jobs:
       - name: Тёплый test-build для инкрементальной компиляции мутантов
         run: npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs
 
+      # Вывод шарда сохраняется артефактом (#472): строки
+      # `FAIL <id>: тест остался зелёным…` — единственное место, где названо,
+      # ЧТО сбежало. Без артефакта отказ безымянный. `PIPESTATUS` — чтобы
+      # `tee` не съел код выхода раннера.
       - name: Каждый тест ловит свою поломку
-        run: node scripts/mutation-gate.mjs --shard=${{ matrix.shard }}/4
+        run: |
+          mkdir -p artifacts
+          set -o pipefail
+          node scripts/mutation-gate.mjs --shard=${{ matrix.shard }}/4 2>&1 | tee artifacts/mutation-shard-${{ matrix.shard }}.log
+      - name: Сохранить лог шарда
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: mutation-shard-${{ matrix.shard }}
+          path: artifacts/mutation-shard-${{ matrix.shard }}.log
+          if-no-files-found: warn
+          retention-days: 30
+
+  # Адресат у отказа (#472). Только по расписанию: ручные прогоны перед
+  # релизом падают по замыслу, их результат владелец смотрит сам — issue на
+  # каждый такой отказ был бы шумом, который снова перестанут читать.
+  #
+  # Права job-уровня ЗАМЕНЯЮТ права workflow, а не дополняют (прецедент —
+  # validate.yml, job с actions: read): перечислены все три.
+  report:
+    name: "Отказ расписания: issue и Telegram"
+    needs: mutants
+    if: always() && github.event_name == 'schedule' && needs.mutants.result != 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read
+      issues: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: dev
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+      - name: Забрать логи шардов
+        uses: actions/download-artifact@v7
+        with:
+          pattern: mutation-shard-*
+          path: artifacts/mutation-logs
+      - name: Собрать отчёт
+        id: report
+        env:
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          # SHA — того дерева, которое чекаутили и гоняли (dev), а не
+          # github.sha: для расписания это вершина default-ветки main, и отчёт
+          # называл бы «dev @ <SHA main>» (ревью r1). Образец — process.yml.
+          SHA=$(git rev-parse HEAD)
+          mkdir -p artifacts
+          node scripts/mutation-gate-report.mjs \
+            --logs=artifacts/mutation-logs --shards=4 \
+            --run-url="$RUN_URL" --ref=dev --sha="$SHA" \
+            --body-out=artifacts/mutation-report.md \
+            --telegram-out=artifacts/mutation-telegram.txt >> "$GITHUB_OUTPUT"
+      # Одно issue, а не одно на неделю: открытое с тем же маркером в заголовке
+      # получает комментарий, новое заводится только если открытого нет.
+      - name: Issue — создать или дописать
+        id: issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          MARKER: ${{ steps.report.outputs.marker }}
+          TITLE: ${{ steps.report.outputs.title }}
+        run: |
+          existing=$(gh issue list --repo "$REPO" --state open --search "\"$MARKER\" in:title" \
+            --json number,title --jq '[.[] | select(.title | startswith(env.MARKER))][0].number // empty')
+          if [ -n "$existing" ]; then
+            gh issue comment "$existing" --repo "$REPO" --body-file artifacts/mutation-report.md
+            url="${{ github.server_url }}/$REPO/issues/$existing"
+          else
+            url=$(gh issue create --repo "$REPO" --title "$TITLE" \
+              --label infra --label process --label tests \
+              --body-file artifacts/mutation-report.md)
+          fi
+          echo "url=$url" >> "$GITHUB_OUTPUT"
+          echo "issue: $url"
+      # Тот же канал, что у релизов (announce.yml). Нет секретов — не отказ:
+      # issue уже заведено, а Telegram — второй адресат, не единственный.
+      - name: Telegram
+        if: always() && steps.issue.outcome == 'success'
+        env:
+          TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+          CHAT: ${{ secrets.TELEGRAM_CHAT_ID }}
+          ISSUE_URL: ${{ steps.issue.outputs.url }}
+        run: |
+          if [ -z "$TOKEN" ] || [ -z "$CHAT" ]; then
+            echo "::warning::TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID не заданы — оповещение пропущено, issue заведено"
+            exit 0
+          fi
+          TEXT=$(sed "s|(issue)|$ISSUE_URL|" artifacts/mutation-telegram.txt)
+          curl -sS --fail-with-body -X POST \
+            "https://api.telegram.org/bot$TOKEN/sendMessage" \
+            --data-urlencode "chat_id=$CHAT" \
+            --data-urlencode "text=$TEXT" \
+            -d disable_web_page_preview=true

.github/workflows/nightly.yml

@@ -0,0 +1,38 @@
+# Ночной полный прогон (#479).
+#
+# Тяжёлые job Validate — смоки, golden, performance_smoke — на обычном пуше не
+# идут: они ни разу не ловили дефект в момент ревью и стоили ~6 минут
+# критического пути на каждую итерацию. Полный набор идёт на кандидате беты
+# (трейлер `Release:`), по кнопке и здесь — каждую ночь на голове `dev`.
+#
+# Почему не `schedule` прямо в validate.yml: расписание исполняется на ветке
+# по умолчанию (`main`), а проверять надо `dev`. Один dispatch с `--ref dev`
+# делает это без переписывания checkout во всех job. Reuse (#208) сохраняется:
+# при неизменённом дереве ночной прогон обойдётся маркерами.
+#
+# Красный ночной прогон — сигнал автору последних коммитов на dev, не гейт:
+# гейт беты по-прежнему требует зелёный Validate на точном SHA кандидата, и
+# там полный набор идёт заново.
+name: Ночной полный прогон dev
+
+on:
+  schedule:
+    - cron: '30 2 * * *'
+  workflow_dispatch: {}
+
+permissions:
+  actions: write
+  contents: read
+
+jobs:
+  dispatch:
+    name: "Запустить Validate на dev с полным набором"
+    runs-on: ubuntu-latest
+    steps:
+      - env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+        run: |
+          set -euo pipefail
+          gh workflow run validate.yml --repo "$REPO" --ref dev -f full=true
+          echo "Validate(dev, full=true) поставлен в очередь: $(date -u +%FT%TZ)"

.github/workflows/performance.yml

@@ -36,7 +36,9 @@ jobs:
         profile:
           - large-house
           - isometric
+          - isometric-stage3
           - plan-snap
+          - interaction
           - blend
           - overlay
           - space-default
@@ -186,10 +188,18 @@ jobs:
               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
               ;;
+            isometric-stage3)
+              npm run benchmark:isometric-stage3-dense -- --allow-stage2-base --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/isometric-stage3-baseline.json
+              npm run benchmark:isometric-stage3-dense -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/isometric-stage3-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
               ;;
+            interaction)
+              npm run benchmark:large-house-interaction -- --target-root=../baseline --samples=7 --warmups=1 --output=../artifacts/performance/interaction-baseline.json
+              npm run benchmark:large-house-interaction -- --target-root=. --samples=7 --warmups=1 --output=../artifacts/performance/interaction-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
@@ -230,11 +240,17 @@ jobs:
               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
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-isometric.json --baseline=../artifacts/performance/isometric-baseline.json --candidate=../artifacts/performance/isometric-candidate.json --baseline-sha="$(git -C ../baseline rev-parse HEAD)" --candidate-sha="$(git rev-parse HEAD)" --output=../artifacts/performance/isometric-comparison.json
+              ;;
+            isometric-stage3)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-isometric-stage3-dense.json --baseline=../artifacts/performance/isometric-stage3-baseline.json --candidate=../artifacts/performance/isometric-stage3-candidate.json --baseline-sha="$(git -C ../baseline rev-parse HEAD)" --candidate-sha="$(git rev-parse HEAD)" --output=../artifacts/performance/isometric-stage3-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
               ;;
+            interaction)
+              npm run benchmark:compare -- --budgets=demo/performance/budgets-large-house-interaction.json --baseline=../artifacts/performance/interaction-baseline.json --candidate=../artifacts/performance/interaction-candidate.json --output=../artifacts/performance/interaction-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
               ;;

.github/workflows/process.yml

@@ -43,9 +43,19 @@ jobs:
       spent: ${{ steps.decide.outputs.spent }}
       limit: ${{ steps.decide.outputs.limit }}
     steps:
+      # Мелкий checkout: guard остаётся лёгким, но ему нужен
+      # scripts/review-doc-guard.mjs — счёт раундов вынесен туда, потому что
+      # inline-shell не покрывается тестами (#454). Node на раннере
+      # предустановлен, setup-node не нужен.
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 1
+          ref: dev
+          persist-credentials: false
       - id: decide
         env:
           GH_TOKEN: ${{ secrets.HP_PROCESS_TOKEN }}
+          REPO: ${{ github.repository }}
           LABEL: ${{ github.event.label.name }}
           BLOCKED: ${{ contains(github.event.issue.labels.*.name, 'blocked') }}
           EXHAUSTED: ${{ contains(github.event.issue.labels.*.name, 'review-4') }}
@@ -87,19 +97,78 @@ jobs:
           #
           # Вердикты считаются ТОЛЬКО своего этапа: иначе вердикт по ТЗ съедал
           # цикл из бюджета код-ревью (#89 получило r2/4). Этап опознаётся по
-          # имени документа в теле комментария; документа нет — вердикт не
-          # посчитается. Недосчёт даёт лишний заход, перерасчёт остановил бы
-          # работу досрочно: из двух ошибок выбрана обратимая.
+          # имени документа — раньше по подстроке маркера в теле комментария,
+          # теперь по имени документа ЭТОЙ задачи, `<MARKER>-<NUM>`: голая
+          # подстрока протекала на прозе. #454 поймала это на себе — разбор
+          # чужих задач в комментарии содержал `CODE-REVIEW`, и первый же
+          # код-ревью получил заход r3.
+          #
+          # Счёт по комментариям остаётся ровно тем же, но он БОЛЬШЕ НЕ
+          # ЕДИНСТВЕННЫЙ (#454). Маркер этапа попадает в тело комментария,
+          # только если ревьюер сам назвал имя файла, — то есть прежний счёт
+          # зависел от формулировки. На #449 первый спек-вердикт файла не
+          # назвал, заход r2 получил номер r1, и документ второго раунда лёг
+          # ПОВЕРХ документа первого. Оценка «недосчёт обратим» была неверна
+          # ровно здесь: номер захода входит в имя файла, и повтор номера — не
+          # лишний заход, а потеря артефакта.
+          #
+          # Поэтому рядом встаёт второй источник — опубликованные документы:
+          # их имена несёт сам конвейер, и подделать их прозой нельзя. Берётся
+          # МАКСИМУМ двух источников: недосчёт возможен только при отказе
+          # обоих, перерасчёт невозможен по построению.
           attempt=1; spent=0; spent_list=""
           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\")")
+            comments=$(mktemp)
+            gh issue view "$NUM" --repo "$REPO" --json comments > "$comments"
+
+            # Ветка задачи — та же, что выберет шаг ревью: свежая по коммиту.
+            # Её нет у задач, размеченных до появления конвейера; тогда счёт по
+            # файлам даёт ноль и работает страховка по комментариям.
+            branch=""; newest=""
+            for ref in $(gh api "repos/$REPO/git/matching-refs/heads/issue/$NUM-" \
+              --jq '.[].ref' 2>/dev/null | sed 's|^refs/heads/||'); do
+              date=$(gh api "repos/$REPO/commits/$ref" --jq '.commit.committer.date' 2>/dev/null || true)
+              if [ -n "$date" ] && { [ -z "$newest" ] || [ "$date" \> "$newest" ]; }; then
+                newest="$date"; branch="$ref"
+              fi
+            done
+            target="${branch:-dev}"
+            names=$(mktemp); docs=$(mktemp -d)
+            if ! gh api "repos/$REPO/contents/docs/reviews?ref=$target" --jq '.[].name' \
+              > "$names" 2>/dev/null; then
+              : > "$names"
+              echo "::warning::список docs/reviews на $target не получен — счёт по файлам отключён"
+            fi
+            # Каталог перечисляется одним ответом до 1000 записей; за этой
+            # границей ответ молча обрежется, и счёт по файлам занизится.
+            if [ "$(grep -c . "$names")" -ge 1000 ]; then
+              echo "::warning::в docs/reviews не меньше 1000 файлов — листинг contents обрезается, счёт по файлам ненадёжен"
+            fi
+            # Тела нужны только своим документам этапа: их единицы.
+            for name in $(grep -E "^${marker}-${NUM}-r[0-9]+\\.md$" "$names" || true); do
+              gh api "repos/$REPO/contents/docs/reviews/$name?ref=$target" \
+                -H 'Accept: application/vnd.github.raw' > "$docs/$name" 2>/dev/null || rm -f "$docs/$name"
+            done
+            list=$(mktemp)
+            counters=$(node scripts/review-doc-guard.mjs --counters \
+              --marker="$marker" --num="$NUM" --names="$names" --docs="$docs" \
+              --comments="$comments" --spent-list="$list")
+            spent_list=$(cat "$list")
+            # Пустой ответ означает, что скрипт не отработал. Тогда остаются
+            # значения по умолчанию (заход 1, циклов 0): guard обязан
+            # продолжить работу, а не встать.
+            new_attempt=$(printf '%s\n' "$counters" | sed -n 's/^attempt=//p')
+            new_spent=$(printf '%s\n' "$counters" | sed -n 's/^spent=//p')
+            new_blocking=$(printf '%s\n' "$counters" | sed -n 's/^blocking=//p')
+            case "$new_attempt" in ''|*[!0-9]*) echo "::warning::счётчик раундов не дал числа — работают значения по умолчанию" ;; *) attempt="$new_attempt" ;; esac
+            case "$new_spent" in ''|*[!0-9]*) : ;; *) spent="$new_spent" ;; esac
+            # Перечень учтённого обязан сходиться с числом: если цикл виден
+            # только документом, ссылка на комментарий его не объяснит.
+            if [ -n "$new_blocking" ]; then
+              spent_list="$spent_list
+          - документы: $new_blocking"
+            fi
+            echo "ветка материала: ${branch:-нет, читался dev}"
           fi
 
           # Отказ обязан быть виден в issue, а не только в логе прогона.

.github/workflows/publish-prerelease.yml

@@ -54,6 +54,23 @@ jobs:
         env:
           TAG: ${{ inputs.tag }}
         run: node scripts/release-contract.mjs "$TAG" --repo="$GITHUB_REPOSITORY"
+      # #479: тяжёлые job Validate идут только на коммите с трейлером `Release:`.
+      # Зелёный Validate без трейлера означал бы прогон без смоков и golden —
+      # класс тихого пропуска #171/#207, поэтому трейлер проверяется здесь явно.
+      - name: Require the Release trailer on the candidate commit
+        env:
+          SHA: ${{ steps.candidate.outputs.sha }}
+        run: |
+          set -euo pipefail
+          git log -1 --format=%B "$SHA" > /tmp/head-message.txt
+          if ! grep -Eq '^Release:[[:space:]]*v?[0-9]+\.[0-9]+\.[0-9]+' /tmp/head-message.txt; then
+            echo "::error::Candidate $SHA has no Release: trailer — Validate ran without the heavy gates (#479)"
+            exit 1
+          fi
+      # #479: свежесть скриншотов на обычном пуше — предупреждение; на
+      # кандидате она обязана быть доказана строгим режимом.
+      - name: Documentation screenshots are fresh for the candidate
+        run: node scripts/check-docs.mjs --screenshots=strict
       - name: Require green Validate for this exact SHA
         env:
           GH_TOKEN: ${{ github.token }}

.github/workflows/release.yml

@@ -34,6 +34,12 @@ jobs:
           # target_commitish (it may be a branch name) or an event-context SHA.
           SHA=$(git rev-parse HEAD)
           echo "release tag: $TAG; exact commit: $SHA"
+          # #479: тяжёлые job Validate идут только на коммите с трейлером
+          # `Release:`; без него зелёный Validate прогона без смоков не доказывает.
+          if ! git log -1 --format=%B "$SHA" | grep -Eq '^Release:[[:space:]]*v?[0-9]+\.[0-9]+\.[0-9]+'; then
+            echo "::error::$SHA has no Release: trailer — Validate ran without the heavy gates (#479)"
+            exit 1
+          fi
           node scripts/release-gate.mjs "$SHA"
       - name: Require full performance for a stable release
         if: ${{ !github.event.release.prerelease }}

.github/workflows/validate.yml

@@ -13,11 +13,22 @@ on:
     paths-ignore:
       - 'docs/reviews/**'
   pull_request:
+  # Полный набор тяжёлых job по кнопке и по ночам (#479): nightly.yml делает
+  # `gh workflow run validate.yml --ref dev -f full=true`.
+  workflow_dispatch:
+    inputs:
+      full:
+        description: 'Полный набор: смоки, golden, performance_smoke'
+        type: boolean
+        default: true
 
 # A new push supersedes an unfinished validation for the same branch or PR.
 # Exact-SHA release gates never depend on an obsolete commit.
+# Полный прогон по кнопке/ночью (#479) живёт в своей группе: первый ручной
+# запуск отменил очередной push конвейера через полторы минуты — ночной
+# результат обнулялся бы любым коммитом, пришедшим в то же окно.
 concurrency:
-  group: validate-${{ github.event.pull_request.number || github.ref }}
+  group: validate-${{ github.event_name == 'workflow_dispatch' && 'dispatch-' || '' }}${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
 jobs:
@@ -53,28 +64,47 @@ jobs:
       - uses: actions/setup-node@v7
         with: { node-version: 22 }
 
+      # Свежесть скриншотов на обычном пуше — предупреждение, на кандидате беты
+      # (трейлер `Release:`), по кнопке и на PR — ошибка (#479). Остальные
+      # проверки документации красят всегда. Режим считает тот же скрипт, что и
+      # выход `heavy` job `changes`, чтобы два места не разошлись.
       - name: "Документация: гайды, ченджлоги, скриншот-индекс"
         id: docs
         continue-on-error: true
-        run: node scripts/check-docs.mjs --external
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          HEAD_MESSAGE: ${{ github.event.head_commit.message }}
+          FULL_INPUT: ${{ inputs.full }}
+        run: |
+          heavy=$(node scripts/classify-changes.mjs --heavy)
+          mode=warn
+          [ "$heavy" = "heavy=true" ] && mode=strict
+          echo "скриншоты документации: режим $mode ($heavy)"
+          node scripts/check-docs.mjs --external --screenshots=$mode
 
       # Конвейер читает `process.yml` из ветки по умолчанию, поэтому файл обязан
       # совпадать в `main` и `dev`. До этой проверки совпадение держалось на
       # дисциплине: каждая правка требовала двух пушей и ручной сверки.
-      - name: "Процесс: process.yml идентичен в main и dev"
+      - name: "Процесс: process.yml и mutation-gate.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
+          # #472: расписание mutation-gate.yml тоже исполняется из ветки по
+          # умолчанию — та же ловушка, что у process.yml. Сверяются оба.
+          status=0
+          for file in process.yml mutation-gate.yml; do
+            if diff <(git show "origin/main:.github/workflows/$file") \
+                    <(git show "origin/dev:.github/workflows/$file"); then
+              echo "$file: main и dev идентичны"
+            else
+              echo "РАСХОЖДЕНИЕ: $file в main и dev различаются."
+              echo "Файл исполняется из ветки по умолчанию, поэтому"
+              echo "правку нужно отправить в обе ветки."
+              status=1
+            fi
+          done
+          exit $status
 
       # Оба гейта ниже судят САМ диапазон коммитов, а не объём проверок, и до
       # #388 брали его от головы предыдущего пуша. Прогон предыдущего пуша
@@ -158,7 +188,7 @@ jobs:
           }
           echo "### Предполётные проверки" >> "$GITHUB_STEP_SUMMARY"
           check "документация" "$DOCS"
-          check "process.yml в main и dev" "$WORKFLOW_SYNC"
+          check "process.yml и mutation-gate.yml в main и dev" "$WORKFLOW_SYNC"
           check "провенанс коммитов" "$PROVENANCE"
           check "процессный гейт" "$PROCESS_GATE"
           exit $fail
@@ -182,6 +212,11 @@ jobs:
       frontend: ${{ steps.classify.outputs.frontend }}
       backend: ${{ steps.classify.outputs.backend }}
       integration: ${{ steps.classify.outputs.integration }}
+      perf_iso: ${{ steps.classify.outputs.perf_iso }} # #473 §5
+      perf_interaction: ${{ steps.classify.outputs.perf_interaction }}
+      mutants: ${{ steps.classify.outputs.mutants }}
+      # Тяжёлые job только на кандидате/по кнопке/на PR (#479), см. шаг heavy.
+      heavy: ${{ steps.heavy.outputs.heavy }}
       base: ${{ steps.base.outputs.base }}
       # Разные вещи под разными именами намеренно: `base` — до какого коммита
       # классифицировать файлы ветки (#387), `range_base` — от какого коммита
@@ -198,6 +233,15 @@ jobs:
       # то есть допущение «до этого всё проверено». Concurrency отменяет прогон
       # предыдущего пуша штатно, и на #86 (r5) это дало зелёный статус ветки
       # без единого исполненного тяжёлого гейта.
+      # Смоки, golden, performance_smoke — на кандидате беты (трейлер
+      # `Release:`), по `workflow_dispatch full=true`, на PR (#479). Логика и
+      # её тест — scripts/classify-changes.mjs.
+      - id: heavy
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          HEAD_MESSAGE: ${{ github.event.head_commit.message }}
+          FULL_INPUT: ${{ inputs.full }}
+        run: node scripts/classify-changes.mjs --heavy | tee -a "$GITHUB_OUTPUT"
       - id: base
         if: github.event_name != 'pull_request'
         env:
@@ -237,7 +281,7 @@ jobs:
         run: |
           if [ "$REF" = "refs/heads/dev" ]; then
             echo "dev: без фильтров, всё true"
-            printf 'frontend=true\nbackend=true\nintegration=true\n' >> "$GITHUB_OUTPUT"
+            node scripts/classify-changes.mjs --all >> "$GITHUB_OUTPUT"
             exit 0
           fi
           zero=$(printf '%040d' 0)
@@ -261,7 +305,7 @@ jobs:
               echo "\`before\` (=$BEFORE_SHA) переписан force-push'ем: диапазон недоказуем,"
               echo "все тяжёлые job запускаются без фильтра путей (#347)."
             } >> "$GITHUB_STEP_SUMMARY"
-            printf 'frontend=true\nbackend=true\nintegration=true\n' >> "$GITHUB_OUTPUT"
+            node scripts/classify-changes.mjs --all >> "$GITHUB_OUTPUT"
             exit 0
           fi
           # Диапазон считается от последнего ДОКАЗАННО зелёного предка (#387),
@@ -271,17 +315,14 @@ jobs:
           if [ "$EVENT_NAME" = "pull_request" ]; then base="$BASE_SHA"; fi
           if [ -z "$base" ]; then
             echo "база не определена — полный прогон без классификации"
-            printf 'frontend=true\nbackend=true\nintegration=true\n' >> "$GITHUB_OUTPUT"
+            node scripts/classify-changes.mjs --all >> "$GITHUB_OUTPUT"
             exit 0
           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/|scripts/support-relay/|pytest\.ini$)')"
-            echo "integration=$(has '^(custom_components/houseplan/manifest\.json$|hacs\.json$|custom_components/.*\.py$|custom_components/.*/translations/)')"
-          } >> "$GITHUB_OUTPUT"
+          # Шаблоны — в scripts/classify-changes.mjs: там они проверяемы
+          # unit-тестом, здесь — только переписываются в выходы (#473 AC8).
+          printf '%s\n' "$files" | node scripts/classify-changes.mjs | tee -a "$GITHUB_OUTPUT"
 
   # Переиспользование результата тяжёлой job (#208). Ключ = входы поведения
   # (sourceFingerprint: src/**, demo/fixtures, demo/golden/*.mjs, манифесты
@@ -298,6 +339,10 @@ jobs:
   # заведомо новые и полный набор гейтов перед бетой и релизом идёт всегда.
   reuse:
     name: "Переиспользование: это дерево уже проверено"
+    # `changes` нужна ради набора профилей перф-смока (#473): ключ
+    # performance_smoke включает набор, иначе glow-only результат засчитался бы
+    # прогону, которому нужен изометрический профиль.
+    needs: changes
     runs-on: ubuntu-latest
     outputs:
       smoke: ${{ steps.probe.outputs.smoke }}
@@ -307,6 +352,7 @@ jobs:
       smoke_key: ${{ steps.keys.outputs.smoke }}
       golden_key: ${{ steps.keys.outputs.golden }}
       performance_smoke_key: ${{ steps.keys.outputs.performance_smoke }}
+      performance_smoke_set: ${{ steps.keys.outputs.performance_smoke_set }}
       backend_key: ${{ steps.keys.outputs.backend }}
     steps:
       - uses: actions/checkout@v7
@@ -314,12 +360,21 @@ jobs:
         with: { node-version: 22 }
       - name: Ключи переиспользования
         id: keys
+        env:
+          PERF_ISO: ${{ needs.changes.outputs.perf_iso }}
+          PERF_INTERACTION: ${{ needs.changes.outputs.perf_interaction }}
         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
+          # Набор профилей перф-смока — часть ключа (#473 AC5).
+          set=glow
+          [ "$PERF_ISO" = "true" ] && set="$set-iso"
+          [ "$PERF_INTERACTION" = "true" ] && set="$set-interaction"
+          echo "performance_smoke_set=$set" >> "$GITHUB_OUTPUT"
+          echo "performance_smoke set: $set"
       # lookup-only: маркер только проверяется, но не восстанавливается —
       # сохранять его в этой job нечего, она ничего не прогоняла.
       - name: Маркер smoke
@@ -341,7 +396,7 @@ jobs:
         uses: actions/cache/restore@v6
         with:
           path: .reuse-marker
-          key: reuse-performance_smoke-${{ steps.keys.outputs.performance_smoke }}
+          key: reuse-performance_smoke-${{ steps.keys.outputs.performance_smoke }}-${{ steps.keys.outputs.performance_smoke_set }}
           lookup-only: true
       - name: Маркер backend
         id: m_backend
@@ -398,6 +453,97 @@ jobs:
       - name: Hassfest validation
         uses: home-assistant/actions/hassfest@master
 
+  # Мутанты по диффу (#475). Свидетель гниёт двумя способами: изменился
+  # файл, который он патчит, либо изменился его гард. `--check` этого не
+  # видит — он проверяет существование якоря, а не достижимость ветки.
+  # Полный прогон раз в неделю ловит гниль с опозданием до релиза (#466,
+  # #467). Здесь гоняются только затронутые мутанты с той же базы диапазона,
+  # что и остальные гейты ветки (#387/#388). Релизный диапазон всё же может
+  # задеть сотню свидетелей, поэтому #480 делит тот же набор на три
+  # детерминированных непересекающихся шарда вместо ослабления проверки.
+  changed_mutants:
+    name: "Мутанты по диффу (${{ matrix.shard }}/3): затронутые свидетели краснеют"
+    needs: changes
+    if: needs.changes.outputs.frontend == 'true' || needs.changes.outputs.backend == 'true' || needs.changes.outputs.mutants == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        shard: [1, 2, 3]
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.14'
+      - name: Backend test dependencies
+        run: pip install -r tests_backend/requirements.txt
+      - name: Кэш браузеров Playwright
+        id: pw
+        uses: actions/cache@v6
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ runner.os }}-${{ hashFiles('package-lock.json') }}
+      - name: Установить Chromium
+        if: steps.pw.outputs.cache-hit != 'true'
+        run: npx playwright install --with-deps chromium
+      # Журнал пойманных свидетелей (#481). Отменённый или упавший по таймауту
+      # прогон не пропадает: журнал пишется после каждого пойманного мутанта и
+      # сохраняется при любом исходе шага, а следующий пуш начинает с того
+      # места, где предыдущий остановился. Мутант с тем же отпечатком входов
+      # (файлы патча и гарда, без строки версии) повторно не гоняется.
+      - name: Журнал свидетелей (последний по шарду)
+        uses: actions/cache/restore@v6
+        with:
+          path: artifacts/mutation-ledger
+          key: mutation-ledger-${{ matrix.shard }}-${{ github.run_id }}
+          restore-keys: mutation-ledger-${{ matrix.shard }}-
+      - name: Затронутые мутанты ловятся
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BEFORE_SHA: ${{ github.event.before }}
+          PROVEN_BASE: ${{ needs.changes.outputs.range_base }}
+          HEAD_SHA: ${{ github.sha }}
+          REF: ${{ github.ref }}
+          SHARD: ${{ matrix.shard }}
+        run: |
+          set -euo pipefail
+          git fetch -q origin dev
+          zero=$(printf '%040d' 0)
+          base=""
+          if [ "$EVENT_NAME" != "pull_request" ] && [ "$REF" = "refs/heads/dev" ]; then
+            base="${PROVEN_BASE:-$BEFORE_SHA}"
+          fi
+          if [ -z "$base" ] || [ "$base" = "$zero" ] \
+             || ! git cat-file -e "$base" 2>/dev/null; then
+            base=$(git merge-base origin/dev "$HEAD_SHA" || echo "")
+          fi
+          if [ -z "$base" ]; then
+            echo "не нашёл базу диапазона — мутанты по диффу пропущены, это увидит следующий пуш"
+            exit 0
+          fi
+          echo "диапазон: $base..$HEAD_SHA"
+          npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs
+          node scripts/mutation-gate.mjs --changed="$base..$HEAD_SHA" --shard="$SHARD/3" \
+            --ledger="artifacts/mutation-ledger/shard-$SHARD.json"
+      # Сохраняется всегда: и после красного шага (пойманные до отказа уже
+      # записаны), и при отмене прогона — post-шаг cache/save исполняется,
+      # пока job не убита целиком. Ключ уникален на прогон: cache не
+      # перезаписывает существующий ключ, а restore-keys берёт самый новый.
+      - name: Сохранить журнал свидетелей
+        if: always()
+        uses: actions/cache/save@v6
+        with:
+          path: artifacts/mutation-ledger
+          key: mutation-ledger-${{ matrix.shard }}-${{ github.run_id }}
+
   frontend:
     name: "Фронтенд: типы, юниты, мутанты, синхрон бандла"
     needs: changes
@@ -486,9 +632,10 @@ jobs:
   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: [changes, frontend, reuse]
+    if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.smoke != 'true'
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     # Смоки шардируются: последовательный прогон занимал ~7.5 минут и был
     # критическим путём всего Validate. Три шарда режут его примерно вдвое;
     # цена — трижды `npm ci` и сборка, около двух оплаченных минут раннера.
@@ -556,10 +703,14 @@ jobs:
             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
+            if timeout --kill-after=10s 180s node "$f" > "/tmp/smoke-logs/$name.log" 2>&1; then
               echo "ok   $name"
             else
+              status=$?
               echo "FAIL $name"
+              if [ "$status" -eq 124 ]; then
+                echo "diagnostic smoke-timeout: $name exceeded 180s"
+              fi
               # Диагностические строки смока печатаются раньше вердикта, и
               # `tail -20` их срезал: на #411 сам смок сообщал, НАСКОЛЬКО
               # разошлись кадры (введено в #302), а в логе прогона осталось
@@ -585,8 +736,8 @@ jobs:
   # частично прогнанная матрица не имеет права выглядеть как выполненная работа.
   smoke_done:
     name: "Смоки: все шарды зелёные"
-    needs: [smoke, reuse]
-    if: needs.reuse.outputs.smoke != 'true'
+    needs: [changes, smoke, reuse]
+    if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.smoke != 'true'
     runs-on: ubuntu-latest
     steps:
       - name: Записать маркер успеха
@@ -608,8 +759,8 @@ jobs:
     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: [changes, frontend, reuse]
+    if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.golden != 'true'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
@@ -706,13 +857,14 @@ jobs:
     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: [changes, frontend, reuse]
+    if: needs.changes.outputs.heavy == 'true' && needs.reuse.outputs.performance_smoke != 'true'
     runs-on: ubuntu-latest
     # 15 минут не хватало, когда установка браузера шла через apt: замер
     # начинался на исходе окна (#206). Запас на холодный кэш — при попадании
-    # job укладывается в те же минуты, что и раньше.
-    timeout-minutes: 20
+    # job укладывается в те же минуты, что и раньше. Диффозависимые профили
+    # (#473) добавляют до двух замеров по 3 образца — окно расширено под них.
+    timeout-minutes: 30
     steps:
       - uses: actions/checkout@v7
       - uses: actions/setup-node@v7
@@ -752,10 +904,26 @@ jobs:
         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
           npm run benchmark:compare -- --absolute-only --budgets=demo/performance/budgets-space-glow-smoke.json --candidate=artifacts/performance-smoke/space-candidate.json --output=artifacts/performance-smoke/space-comparison.json
+      # Диффозависимые профили (#473 §5): изометрия — когда дифф задел
+      # `src/iso-*`, взаимодействие — когда живой путь или оркестраторы кадра.
+      # Абсолютные потолки — `hardMaxMs` полных профилей: регрессия #160
+      # (9 870 мс против 3 500) ловится с одного образца, шум — нет.
+      - name: Изометрический профиль по диффу (#473)
+        if: needs.changes.outputs.perf_iso == 'true'
+        run: |
+          npm run benchmark:large-house -- --profile=large-house-isometric-v1 --samples=3 --warmups=1 --output=artifacts/performance-smoke/isometric-candidate.json
+          npm run benchmark:compare -- --absolute-only --budgets=demo/performance/budgets-isometric-smoke.json --candidate=artifacts/performance-smoke/isometric-candidate.json --output=artifacts/performance-smoke/isometric-comparison.json
+      - name: Профиль взаимодействия по диффу (#473)
+        if: needs.changes.outputs.perf_interaction == 'true'
+        run: |
+          npm run benchmark:large-house -- --profile=large-house-interaction-v1 --samples=3 --warmups=1 --output=artifacts/performance-smoke/interaction-candidate.json
+          npm run benchmark:compare -- --absolute-only --budgets=demo/performance/budgets-interaction-smoke.json --candidate=artifacts/performance-smoke/interaction-candidate.json --output=artifacts/performance-smoke/interaction-comparison.json
       # #330 AC7: перф-контракт ограничений стыков — быстрый (без браузера),
       # ловит возврат квадратичных путей в оба зеркала прямо на пуше.
       - name: Бюджеты ограничений стыков (#330)
         run: npm run benchmark:junction-limits
+      - name: Быстрый commit точки стены (#461)
+        run: npm run benchmark:wall-draw-click -- --output=artifacts/performance-smoke/wall-draw-click.json
       - name: Upload performance smoke report
         if: always()
         uses: actions/upload-artifact@v7
@@ -777,7 +945,7 @@ jobs:
         continue-on-error: true
         with:
           path: .reuse-marker
-          key: reuse-performance_smoke-${{ needs.reuse.outputs.performance_smoke_key }}
+          key: reuse-performance_smoke-${{ needs.reuse.outputs.performance_smoke_key }}-${{ needs.reuse.outputs.performance_smoke_set }}
 
   backend:
     name: "Бэкенд: pytest в Home Assistant"

AGENTS.md

@@ -153,8 +153,12 @@ in between.
 
 If the rebase conflicts the pipeline says so in the issue and sends the task back
 to `S6-in-progress`. The verdict still stands: nothing needs reviewing again, the
-remaining work is the rebase. Resolve it, push the branch, re-apply
-`S7-code-review`. The second review run is not a formality — after a rebase onto a
+remaining work is the rebase. When the conflict is only in the committed bundle
+(`dist/**`, `custom_components/houseplan/frontend/**` — the usual case when two
+tasks built it in parallel), run `node scripts/rebase-on-dev.mjs` (#479): it takes
+`dev`'s copy through the rebase, rebuilds with `npm run bundle:sync` and amends
+the result into your last commit; a conflict anywhere else aborts and leaves the
+tree as it was. Then push the branch and re-apply `S7-code-review`. The second review run is not a formality — after a rebase onto a
 moved `dev` this is different code, and accepting it unchecked is how regressions
 arrive. Cycles are counted per stage, so a code review spends its own budget.
 
@@ -334,6 +338,23 @@ npm run bundle:sync   # dist → custom_components + demo/srv/assets (#255)
 npm run bundle:budget # initial View graph <= 256000 B gzip (#337)
 ```
 
+`npm run gate:small` runs the mandatory part of PROCESS §8 in one go (#479):
+unit tests, build with typecheck, `no-new-any` and `smoke-select` in parallel,
+then the bundle-tree comparison and the bundle budget. It prints the smokes the
+diff selects but does not run them — those, `golden`, `pytest` and `check-docs
+--screenshots=strict` remain the author's call by diff and AC.
+
+**Heavy CI gates run on the beta candidate, nightly and on demand — not on every
+push (#479).** `smoke`, `golden` and `performance_smoke` in Validate are gated
+on the `heavy` output: true for a head commit carrying a `Release:` trailer, for
+`workflow_dispatch full=true` (which `nightly.yml` issues on `dev` every night)
+and for pull requests. A plain push to `dev` runs preflight, frontend (types,
+units, build, bundle sync, no-new-any), backend, hacs and hassfest. Screenshot
+freshness in `check-docs` is likewise a warning on a plain push and an error on
+the candidate; `publish-prerelease.yml` and `release.yml` refuse a candidate
+without the `Release:` trailer, so a green Validate without the heavy jobs can
+never pass for a release.
+
 During the implementation cycle the fast gates always run. Since 2026-08-14 the
 owner's machine also carries Playwright with Chromium (Windows) and a full WSL
 environment, which changes one thing (#151): **before moving an issue to
@@ -344,9 +365,27 @@ 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.
+harness (`~/houseplan-card`, venv) are advisory; **the canon does not move**:
+the beta gate is CI at the exact SHA.
+
+**Verifying and capturing are different things (#455).** `golden:verify` is
+advisory and legal anywhere, Windows included: it reports differences and
+accepts nothing. **Capturing** frames is refused outside Linux
+before the browser even starts — `golden:capture` through
+`demo/golden/policy.mjs`, documentation screenshots through
+`npm run docs:capture` (use that script, not a bare `node
+demo/docs/capture.mjs`: the gate sits one step earlier because editing the
+capture script invalidates the committed screenshot index). The refusal prints
+the WSL command. The reason is not policy but physics: Windows
+rasterizes text through DirectWrite with different subpixel and DPI behaviour,
+so no frame ever matches an accepted baseline byte for byte, no environment
+witness can exist, and acceptance would refuse anyway (#401 accepts any
+environment that proves itself with byte-identical undeclared frames — Linux is
+simply the only one we have). The deliberate override is
+`HP_ALLOW_FOREIGN_CAPTURE="reason"`; the reason travels into the output and the
+manifest. Baselines are still accepted only via
+`npm run golden:accept -- --reviewed` on a complete artefact, and the accepted
+index records the platform next to the Chromium build.
 
 **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.
@@ -399,21 +438,20 @@ Chromium — a `1e-6`-tolerance magnet-snap on the opening-*placement* path. It
 reproduces against the pristine committed bundle, so treat it as
 pre-existing/pixel-precision, not a regression you introduced.
 
-## Labs flags
+## Alpha experiments
 
 `src/labs.ts` is the single registry and resolver for hidden presentation
-experiments. Activate a live flag through `?hp-labs=<id>` or the shared hash
-grammar, remove it with `-<id>`, and use `off` to clear the set. Do not add a
-YAML/config switch for a Labs-only experiment. A new entry needs a unique
-lowercase id, issue, numeric-core `since`, numeric-core `expires`, summary and
-unit/browser coverage. Invalid or duplicate registry entries fail closed.
+experiments. One browser-local switch controls the complete set known to the
+installed build: `hp_alpha=1` in query or the shared hash grammar enables and
+persists it, while `hp_alpha=0` disables and persists it. Do not add per-feature
+URL/storage keys or a YAML/config switch. The legacy `hp-labs` grammar and
+`houseplan_card_labs_v1` storage are ignored and never migrated.
 
-Expiry is exclusive and ignores prerelease suffixes: an entry expiring at
-`1.65.0` is unavailable in `1.65.0-beta.1`. Before that cycle, either remove the
-experiment or graduate it through its own reviewed issue; never extend expiry as
-an incidental change. Labs may alter presentation only and must not gate data,
-migrations, stores, HA actions or network calls. Current renderer details are in
-`docs/ISOMETRIC.md`.
+A new registry entry needs a unique lowercase id, issue, summary and
+unit/browser coverage; it does not get `since` or `expires`. Invalid or duplicate
+entries fail closed. Alpha capabilities may alter presentation only and must not
+gate data, migrations, stores, HA actions or network calls. Current renderer
+details are in `docs/ISOMETRIC.md`.
 
 Demo harness render quirk: the fake `hass` in `demo.html` is set once, so opening the
 page directly in a browser renders the floor plan but **device icons only appear

PROCESS.md

@@ -193,6 +193,35 @@ S1-new → S2-analysis → S3-spec → S4-spec-review ⟲ → S5-ready →
   кода отвечает на вопрос «оно вообще работает»: каждый AC либо доказан
   автотестом — и ревьюер убедился, что **тест умеет падать**, — либо разобран по
   коду с явной записью «проверено чтением, не исполнением».
+- **Защитный AC доказывается таблицей «чем краснеет» (#435).** Для каждого AC,
+  заявляющего защиту — валидация, гард, лимит, отказ, инвариант, — в документе
+  ревью обязательна строка из трёх столбцов: **AC · чем доказан** (точная
+  команда или имя теста) **· чем краснеет** — мутация, снятая защита или
+  отрицательная проба, с результатом прогона. Пустой третий столбец — находка
+  Medium, а не примечание.
+
+  «Тест умеет падать» без названной мутации и её вывода доказательством не
+  является. Аудит v1.71.0-beta.1 нашёл пять контрактов #51 и #423, где тест
+  оставался зелёным на снятой защите; все пять прошли код-ревью как доказанные,
+  а два теста были записаны в закрытие coverage-ratchet под именами, обещавшими
+  то, чего они не проверяли (#430).
+
+  Мутант в `scripts/mutation-gate.mjs` обязателен, когда защита живёт в
+  продуктовом коде и проверяется дорогим гейтом (смок, бэкенд, golden): там
+  ревьюер не воспроизведёт отрицательный прогон второй раз. Для чистых юнитов
+  достаточно прогона со снятой защитой, приведённого в документе.
+
+  Считаются **защитные AC без названного свидетеля**, а не мутанты на
+  подсистему: у #421 мутанты были, и дыра всё равно проехала. «Сколько мутантов
+  принесла задача» остаётся признаком — у #423 их ноль, и именно у #423 нашёлся
+  тест, спрашивавший регулярку, находит ли она подстроку, которую сам же и
+  вырезал.
+
+  Правило не распространяется на AC, не заявляющие защиту (расположение, текст,
+  формат вывода): там свидетель — обычное сравнение ожидаемого с фактическим, и
+  третий столбец превратился бы в ритуал. И не отменяет «проверено чтением»:
+  тогда во втором столбце стоит «чтением», а не имя теста, и читатель ревью
+  видит разницу.
 - **High блокируют.** Medium **в скоупе задачи** чинится в текущем issue:
   без High это жёлтый вердикт и возврат автору, фикс проходит повторный цикл.
   Medium **вне скоупа** — отдельный issue (#202).
@@ -632,6 +661,17 @@ python -m pytest tests_backend -q     # py3.13, если менялся бэке
 при следующей задаче (#237). Пересъёмка — `npm run build && node
 demo/docs/capture.mjs`, коммит вместе с задачей.
 
+**Перф-смок в Validate зависит от диффа** (#473). Два glow-профиля
+гоняются всегда; при правке `src/iso-*` добавляется `large-house-isometric-v1`,
+при правке `src/live-*`, `src/render-*`, `houseplan-render-lifecycle.ts`,
+`houseplan-card.ts` — `large-house-interaction-v1`, оба по три образца против
+абсолютных потолков `hardMaxMs` полных профилей (`budgets-*-smoke.json`).
+Это гейт на «в разы», а не «на проценты»: регрессия #160 (первый кадр 9 870 мс
+против потолка 3 500) ловится ещё в ревью, а не предрелизным гейтом под тегом.
+Классификацию делает `scripts/classify-changes.mjs`, набор профилей входит в
+ключ переиспользования `performance_smoke`. Ревьюер по-прежнему принимает
+зелёный Validate на SHA как подтверждение дешёвых гейтов — смок его часть.
+
 Условие честности такого сужения: ревьюер обязан перечислить, какие гейты прогнал,
 какие нет и почему. Непрогнанный гейт становится видимым решением, а не молчаливым
 пропуском.

README.md

@@ -94,17 +94,46 @@ House Plan is in the HACS default catalog — no custom repository needed.
 2. Restart Home Assistant.
 3. Open **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:
+The card is registered automatically. After installing or updating House Plan,
+restart Home Assistant and fully reload the page: `Ctrl+F5` on Windows/Linux or
+`Cmd+Shift+R` on macOS.
+
+#### Storage mode (Home Assistant default)
+
+No YAML is normally needed. If automatic registration did not make the card
+available, open **Settings → Dashboards → menu ⋮ → Resources → Add
+resource**, enter `/houseplan_files/houseplan-card.js`, and select **JavaScript
+module**.
+
+#### YAML resources mode (Home Assistant 2026.2+)
+
+To manage resources in `configuration.yaml` independently of the dashboard
+mode, use:
 
 ```yaml
-resources:
-  - url: /houseplan_files/houseplan-card.js
-    type: module
+lovelace:
+  resource_mode: 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.
+#### Legacy Home Assistant 2024.6–2026.1
+
+Only for a full-YAML dashboard that is already managed in YAML, use:
+
+```yaml
+lovelace:
+  mode: yaml
+  resources:
+    - url: /houseplan_files/houseplan-card.js
+      type: module
+```
+
+`mode: yaml` changes the dashboard itself to YAML mode. Do not switch a storage
+dashboard to legacy YAML just for House Plan; use the Storage mode instructions
+above instead. Do not use the on-disk path inside `custom_components`; Home
+Assistant does not serve that path as a JavaScript module.
 
 ### Manual installation
 

README.ru.md

@@ -98,17 +98,46 @@ House Plan входит в основной каталог HACS — пользо
 2. Перезапустите Home Assistant.
 3. Откройте **Настройки → Устройства и службы → Добавить интеграцию → House Plan**.
 
-Карточка регистрируется автоматически. Если ресурсы Lovelace управляются вручную,
-добавьте именно URL, который публикует интеграция:
+Карточка регистрируется автоматически. После установки или обновления
+House Plan перезапустите Home Assistant и полностью перезагрузите
+страницу: `Ctrl+F5` в Windows/Linux или `Cmd+Shift+R` в macOS.
+
+#### Режим Storage (по умолчанию в Home Assistant)
+
+Обычно YAML не нужен. Если авторегистрация не сделала карточку доступной,
+откройте **Настройки → Панели управления → меню ⋮ → Ресурсы → Добавить
+ресурс**, укажите `/houseplan_files/houseplan-card.js` и выберите тип
+**JavaScript-модуль**.
+
+#### YAML-ресурсы в Home Assistant 2026.2+
+
+Чтобы управлять ресурсами в `configuration.yaml` независимо от режима
+самой панели, используйте:
 
 ```yaml
-resources:
-  - url: /houseplan_files/houseplan-card.js
-    type: module
+lovelace:
+  resource_mode: yaml
+  resources:
+    - url: /houseplan_files/houseplan-card.js
+      type: module
 ```
 
-Не используйте путь к файлу внутри `custom_components`: Home Assistant не
-публикует его как JavaScript-модуль.
+#### Home Assistant 2024.6–2026.1: устаревший режим
+
+Только для панели, которая уже полностью управляется через YAML:
+
+```yaml
+lovelace:
+  mode: yaml
+  resources:
+    - url: /houseplan_files/houseplan-card.js
+      type: module
+```
+
+`mode: yaml` переводит в YAML-режим саму панель. Не переключайте
+storage-панель в устаревший YAML только ради House Plan; используйте
+инструкцию для Storage выше. Не используйте путь к файлу внутри
+`custom_components`: Home Assistant не публикует его как JavaScript-модуль.
 
 ### Вручную
 

assets/fonts/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

custom_components/houseplan/__init__.py

@@ -6,7 +6,6 @@ import logging
 from datetime import timedelta
 from pathlib import Path
 
-from homeassistant.components.frontend import add_extra_js_url
 from homeassistant.core import HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady
 from homeassistant.helpers.event import async_track_time_interval
@@ -16,9 +15,11 @@ from .const import (
     ASSETS_DIR,
     DOMAIN,
     FILES_DIR,
-    FRONTEND_URL,
     PLANS_DIR,
-    VERSION,
+)
+from .frontend_registration import (
+    async_remove_frontend_registration,
+    async_setup_frontend_registration,
 )
 from .geometry_migration import migrate_config, migrate_layout, pending_from_config
 from .plans import collect_attachments, collect_plans, sweep_upload_temps
@@ -99,49 +100,12 @@ async def async_setup_entry(hass: HomeAssistant, entry: HouseplanConfigEntry) ->
         )
     )
 
-    # Static paths cannot be unregistered — register once per HA run.
-    if not hass.data[DOMAIN].get("static_registered"):
-        hass.data[DOMAIN]["static_registered"] = True
-        static_paths = []
-        try:
-            from homeassistant.components.http import StaticPathConfig
-
-            if card_path.exists():
-                static_paths.append(StaticPathConfig(FRONTEND_URL, str(card_path), cache_headers=False))
-            # NOTE (audit B1): plans and marker files are NO LONGER static.
-            # They are served by HouseplanContentView, which requires auth.
-            # Only the entry and manifest-gated JS chunks stay public —
-            # Lovelace modules must be loadable without an auth header.
-            if static_paths:
-                await hass.http.async_register_static_paths(static_paths)
-        except ImportError:  # very old HA versions
-            if card_path.exists():
-                hass.http.register_static_path(FRONTEND_URL, str(card_path), cache_headers=False)
-
-    if not card_path.exists():
-        _LOGGER.warning("houseplan-card.js not found next to the integration: %s", card_path)
-        return True
-
-    # Register the card. Preferably as a Lovelace resource (the frontend AWAITS
-    # resources before rendering dashboards, so the card is available even on a cold
-    # start of the mobile app). If the resource registry is unavailable (YAML-mode
-    # Lovelace, old versions) — fall back to extra_module_url.
-    module_url = f"{FRONTEND_URL}?v={VERSION}"
-    registered = await _register_lovelace_resource(hass, module_url)
-    if not registered:
-        add_extra_js_url(hass, module_url)
-    # Tell the user exactly where the card lives — the #1 support issue is people adding a
-    # Lovelace resource pointing at the on-disk path (/custom_components/...), which HA does
-    # not serve (wrong MIME → "Custom element doesn't exist"). The correct served URL is below.
-    if registered:
-        _LOGGER.info("House Plan card auto-registered as a Lovelace resource: %s", module_url)
-    else:
-        _LOGGER.info(
-            "House Plan card is served at %s . Lovelace resources look YAML-managed — add it "
-            "manually under `resources:` as { url: %s, type: module }. Do NOT use the on-disk "
-            "path /custom_components/houseplan/frontend/houseplan-card.js (HA does not serve it).",
-            module_url, module_url,
-        )
+    # NOTE (audit B1): plans and marker files are no longer static. They are
+    # served by HouseplanContentView, which requires auth. Only the manifest-
+    # gated frontend bundle stays public so Lovelace can load it. Registration
+    # failures are observable and recoverable, but never skip storage migration,
+    # repairs or housekeeping below.
+    await async_setup_frontend_registration(hass, entry, card_path)
 
     # One-time move to the square canvas (v1.48.0). Coordinates used to be
     # normalised against a per-space aspect ratio; the canvas is now always
@@ -319,61 +283,8 @@ async def async_unload_entry(hass: HomeAssistant, entry: HouseplanConfigEntry) -
     return True
 
 
-async def async_remove_entry(hass: HomeAssistant, entry) -> None:
-    """Clean up on integration removal: drop our Lovelace resource entry."""
-    try:
-        resources = _lovelace_resources(hass)
-        if resources is None or not hasattr(resources, "async_delete_item"):
-            return
-        for item in list(resources.async_items()):
-            if str(item.get("url", "")).split("?", 1)[0] == FRONTEND_URL:
-                await resources.async_delete_item(item["id"])
-                _LOGGER.debug("House Plan Lovelace resource removed: %s", item.get("url"))
-    except Exception as err:  # noqa: BLE001 — best-effort cleanup
-        _LOGGER.debug("Could not remove the Lovelace resource on uninstall: %s", err)
-
-
-def _lovelace_resources(hass: HomeAssistant):
-    lovelace = hass.data.get("lovelace")
-    resources = getattr(lovelace, "resources", None)
-    if resources is None and isinstance(lovelace, dict):
-        resources = lovelace.get("resources")
-    return resources
-
-
-async def _register_lovelace_resource(hass: HomeAssistant, module_url: str) -> bool:
-    """Register (or update) the card in the Lovelace resource registry.
-
-    Returns True on success. Idempotent: if a resource with our path exists —
-    update the URL on version change; otherwise create it. Any exception → False
-    (fall back to extra_module_url).
-    """
-    try:
-        resources = _lovelace_resources(hass)
-        if resources is None:
-            return False
-        # the resource registry must be loaded
-        if hasattr(resources, "loaded") and not resources.loaded:
-            await resources.async_load()
-            resources.loaded = True
-        elif hasattr(resources, "async_get_info"):
-            await resources.async_get_info()
-        # only storage mode allows creating items
-        if not hasattr(resources, "async_create_item"):
-            return False
-        base = FRONTEND_URL
-        existing = [
-            item for item in resources.async_items()
-            if str(item.get("url", "")).split("?", 1)[0] == base
-        ]
-        if existing:
-            item = existing[0]
-            if item.get("url") != module_url and hasattr(resources, "async_update_item"):
-                await resources.async_update_item(item["id"], {"url": module_url})
-            return True
-        await resources.async_create_item({"res_type": "module", "url": module_url})
-        _LOGGER.debug("House Plan card registered as a Lovelace resource: %s", module_url)
-        return True
-    except Exception as err:  # noqa: BLE001 — any failure → fallback
-        _LOGGER.debug("Could not register the Lovelace resource (%s), falling back to extra_module_url", err)
-        return False
+async def async_remove_entry(
+    hass: HomeAssistant, entry: HouseplanConfigEntry
+) -> None:
+    """Clean up frontend registration and notice on integration removal."""
+    await async_remove_frontend_registration(hass, entry)

custom_components/houseplan/asset_integrity.py

@@ -0,0 +1,144 @@
+"""Bounded, shared integrity verification for content-addressed decor assets."""
+from __future__ import annotations
+
+import hashlib
+import logging
+import stat
+import threading
+from collections import OrderedDict
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Callable
+
+from .const import DOMAIN
+
+_LOGGER = logging.getLogger(__name__)
+
+ASSET_INTEGRITY_CACHE_ENTRIES = 256
+ASSET_HASH_CHUNK_BYTES = 64 * 1024
+ASSET_INTEGRITY_FOLLOWER_TIMEOUT_SECONDS = 30.0
+_HASS_DATA_KEY = "asset_integrity_verifier"
+
+
+@dataclass(frozen=True)
+class FileSignature:
+    """File version facts available without reading its content."""
+
+    size: int
+    mtime_ns: int
+    ctime_ns: int
+
+
+@dataclass(frozen=True)
+class _CacheEntry:
+    signature: FileSignature
+    digest: str
+
+
+@dataclass
+class _Flight:
+    event: threading.Event
+    digest: str | None = None
+
+
+def _signature(path: Path) -> FileSignature:
+    current = path.stat()
+    if not stat.S_ISREG(current.st_mode):
+        raise OSError("asset is not a regular file")
+    return FileSignature(
+        size=current.st_size,
+        mtime_ns=current.st_mtime_ns,
+        ctime_ns=current.st_ctime_ns,
+    )
+
+
+def _stream_sha256(path: Path) -> str:
+    """Hash a blob without retaining its bytes in memory."""
+    digest = hashlib.sha256()
+    with path.open("rb") as stream:
+        while chunk := stream.read(ASSET_HASH_CHUNK_BYTES):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+class AssetIntegrityVerifier:
+    """Thread-safe LRU digest cache with per-file-version single-flight."""
+
+    def __init__(
+        self,
+        max_entries: int = ASSET_INTEGRITY_CACHE_ENTRIES,
+        *,
+        hasher: Callable[[Path], str] | None = None,
+        event_factory: Callable[[], threading.Event] | None = None,
+    ) -> None:
+        if max_entries < 1:
+            raise ValueError("max_entries must be positive")
+        self._max_entries = max_entries
+        self._hasher = hasher or _stream_sha256
+        self._event_factory = event_factory or threading.Event
+        self._lock = threading.Lock()
+        self._cache: OrderedDict[str, _CacheEntry] = OrderedDict()
+        self._inflight: dict[tuple[str, FileSignature], _Flight] = {}
+
+    def verify(self, path: Path, expected_digest: str) -> bool:
+        """Return whether one stable file version has the expected digest."""
+        try:
+            canonical = str(path.resolve())
+        except (OSError, RuntimeError):
+            return False
+        try:
+            before = _signature(path)
+        except OSError:
+            with self._lock:
+                self._cache.pop(canonical, None)
+            return False
+
+        key = (canonical, before)
+        with self._lock:
+            cached = self._cache.get(canonical)
+            if cached is not None and cached.signature == before:
+                self._cache.move_to_end(canonical)
+                return cached.digest == expected_digest
+            if cached is not None:
+                self._cache.pop(canonical, None)
+            flight = self._inflight.get(key)
+            owner = flight is None
+            if owner:
+                flight = _Flight(self._event_factory())
+                self._inflight[key] = flight
+
+        assert flight is not None
+        if not owner:
+            if not flight.event.wait(ASSET_INTEGRITY_FOLLOWER_TIMEOUT_SECONDS):
+                return False
+            return flight.digest == expected_digest
+
+        digest: str | None = None
+        stable = False
+        try:
+            digest = self._hasher(path)
+            # Never publish a digest for bytes that changed while they were read.
+            stable = _signature(path) == before
+        except Exception as err:  # noqa: BLE001 - filesystem/hash seam fails dark
+            _LOGGER.debug("House Plan asset integrity check failed: %s", err)
+        finally:
+            with self._lock:
+                if stable and digest is not None:
+                    self._cache[canonical] = _CacheEntry(before, digest)
+                    self._cache.move_to_end(canonical)
+                    while len(self._cache) > self._max_entries:
+                        self._cache.popitem(last=False)
+                    flight.digest = digest
+                self._inflight.pop(key, None)
+                flight.event.set()
+        return stable and digest == expected_digest
+
+
+def get_asset_integrity_verifier(hass: Any) -> AssetIntegrityVerifier:
+    """Return the single verifier shared by HTTP and WS on this HA instance."""
+    domain_data = hass.data.setdefault(DOMAIN, {})
+    verifier = domain_data.get(_HASS_DATA_KEY)
+    if not isinstance(verifier, AssetIntegrityVerifier):
+        verifier = AssetIntegrityVerifier()
+        domain_data[_HASS_DATA_KEY] = verifier
+    return verifier

custom_components/houseplan/const.py

@@ -51,7 +51,7 @@ SCHEDULED_GRACE_S = 30 * 24 * 3600
 FILES_DIR = "houseplan/files"
 ASSETS_DIR = "houseplan/assets"
 CONF_ADMIN_ONLY = "admin_only"
-VERSION = "1.71.0-beta.1"
+VERSION = "1.73.0-beta.3"
 DECOR_ASSETS_API_VERSION = 1
 
 # #43: the support transport is deliberately not configurable.  A user supplied
@@ -70,7 +70,7 @@ MAX_SUPPORT_CONTACT_CODEPOINTS = 320
 # 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 = 10
 EXPORT_VERSION = 2
 MAX_EXPORT_BYTES = 8 * 1024 * 1024
 IMPORT_PREVIEW_TTL_S = 10 * 60
@@ -101,7 +101,8 @@ ERROR_CODES: frozenset[str] = frozenset({
     "invalid_light_entity", "invalid_marker_control", "invalid_name",
     "invalid_partition_opening_host",
     "invalid_partition_opening_jamb_margin", "invalid_passage_fields",
-    "invalid_space_id", "invalid_toggle_entity", "invalid_value_badge",
+    "invalid_space_id", "invalid_toggle_entity", "invalid_vacuum_map_route",
+    "invalid_value_badge",
     "invalid_value_badge_attribute", "invalid_value_badge_position",
     "invalid_value_badge_source", "invalid_value_source",
     "invalid_value_source_attribute", "io_error", "marker_control_cycle",

custom_components/houseplan/coordinate_canonicalization.py

@@ -14,6 +14,7 @@ COORDINATE_DECIMALS = 9
 COORDINATE_FACTOR = 10**COORDINATE_DECIMALS
 LATTICE_GRID_N = 240
 LATTICE_NOISE_STEPS = 1e-4
+DECOR_BOX_KINDS = ("rect", "ellipse", "furniture", "image")
 
 
 def canonicalize_number(value: Any) -> Any:
@@ -150,13 +151,15 @@ def canonicalize_config_geometry(config: Any) -> Any:
             kind = decor.get("kind")
             if kind == "line":
                 _lattice_fields(decor, ("x1", "y1", "x2", "y2"))
-            elif kind in ("rect", "ellipse", "furniture"):
+            elif kind in DECOR_BOX_KINDS:
                 _lattice_fields(decor, ("x", "y", "w", "h"))
                 _scalar_fields(decor, ("angle",))
             elif kind == "text":
                 _lattice_fields(decor, ("x", "y"))
                 _scalar_fields(decor, ("scale", "angle"))
 
+        # Legacy-only read boundary: v9 drafts are canonicalized before the
+        # wall-model migration turns their edges into current partitions.
         for draft in _records(space.get("room_drafts")):
             _lattice_points(draft.get("points"))
 

custom_components/houseplan/decor_assets.py

@@ -10,6 +10,7 @@ import hashlib
 import json
 import math
 import re
+import stat
 import struct
 import xml.etree.ElementTree as ET
 from dataclasses import dataclass
@@ -372,20 +373,75 @@ def asset_meta_path(root: Path, asset_id: str) -> Path:
     return root / f"{asset_id}.json"
 
 
+def _physical_asset_inventory(root: Path) -> list[tuple[Path, int]]:
+    """Observe regular promoted blobs once, tolerating concurrent removals."""
+    try:
+        if not root.is_dir():
+            return []
+        entries = list(root.iterdir())
+    except OSError:
+        return []
+
+    inventory: list[tuple[Path, int]] = []
+    for path in entries:
+        if path.suffix not in ASSET_EXTENSIONS or not ASSET_ID_RE.fullmatch(path.stem):
+            continue
+        try:
+            current = path.stat(follow_symlinks=False)
+        except OSError:
+            continue
+        if stat.S_ISREG(current.st_mode):
+            inventory.append((path, current.st_size))
+    return sorted(inventory, key=lambda item: item[0].name)
+
+
+def physical_asset_blobs(root: Path) -> list[Path]:
+    """Return exact promoted blob files, independently from their sidecars."""
+    return [path for path, _size in _physical_asset_inventory(root)]
+
+
+def physical_asset_usage(root: Path) -> tuple[int, int]:
+    """Return promoted blob count and actual bytes used for quota checks."""
+    inventory = _physical_asset_inventory(root)
+    return len(inventory), sum(size for _path, size in inventory)
+
+
+def _read_catalog_row(root: Path, path: Path) -> dict[str, Any] | None:
+    """Read one sidecar through the validation shared by list and resolve."""
+    try:
+        row = json.loads(path.read_text(encoding="utf-8"))
+        if not isinstance(row, dict):
+            return None
+        aid = str(row.get("asset_id") or "")
+        ext = row.get("ext")
+        blob = root / f"{aid}{ext}"
+        if (
+            path.stem != aid
+            or not ASSET_ID_RE.fullmatch(aid)
+            or ext not in ASSET_EXTENSIONS
+            or not blob.is_file()
+        ):
+            return None
+        return row
+    except (OSError, ValueError, TypeError):
+        return None
+
+
+def read_asset(root: Path, asset_id: str) -> dict[str, Any] | None:
+    """Read one exact catalog row without scanning unrelated sidecars."""
+    if not ASSET_ID_RE.fullmatch(asset_id):
+        return None
+    return _read_catalog_row(root, asset_meta_path(root, asset_id))
+
+
 def read_catalog(root: Path) -> list[dict[str, Any]]:
     rows: list[dict[str, Any]] = []
     if not root.is_dir():
         return rows
     for path in root.glob("*.json"):
-        try:
-            row = json.loads(path.read_text(encoding="utf-8"))
-            aid = str(row.get("asset_id") or "")
-            ext = row.get("ext")
-            blob = root / f"{aid}{ext}"
-            if ASSET_ID_RE.fullmatch(aid) and ext in ASSET_EXTENSIONS and blob.is_file():
-                rows.append(row)
-        except (OSError, ValueError, TypeError):
-            continue
+        row = _read_catalog_row(root, path)
+        if row is not None:
+            rows.append(row)
     return sorted(
         rows,
         key=lambda row: (str(row.get("created_at", "")), str(row["asset_id"])),

custom_components/houseplan/diagnostics.py

@@ -31,7 +31,6 @@ async def async_get_config_entry_diagnostics(
                 "has_plan": bool(s.get("plan_url")),
                 "rooms": len(s.get("rooms", [])),
                 "rooms_with_area": sum(1 for r in s.get("rooms", []) if r.get("area")),
-                "room_drafts": len(s.get("room_drafts", [])),
                 "partitions": len(s.get("partitions", [])),
                 "wall_columns": len(s.get("wall_columns", [])),
             }

custom_components/houseplan/frontend/houseplan-assets.json

@@ -1,125 +1,251 @@
 {
   "schema": 1,
-  "fingerprint": "816ff9c893e23b7441e73210f85024741ff6c5bf8dabd2fb0df9e8b8055bc693",
+  "fingerprint": "16404f74463739afada7755507e1bf32b9468a1125505ff93b9a73cddb36ea18",
   "entry": "houseplan-card.js",
   "initialViewFiles": [
-    "houseplan-assets/houseplan-card-Dwkibvgo.js",
+    "houseplan-assets/houseplan-card-Dj3l4riu.js",
     "houseplan-card.js"
   ],
-  "initialViewGzipBytes": 291031,
+  "initialViewGzipBytes": 289689,
   "lazyFiles": [
-    "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-    "houseplan-assets/de-DJX-vLW1.js",
-    "houseplan-assets/editor-Dvui5H3b.js",
-    "houseplan-assets/fr-DVmfM6Kw.js",
-    "houseplan-assets/houseplan-editor-runtime-9AEP51ly.js",
-    "houseplan-assets/houseplan-onboarding-runtime-CnVK5oOC.js"
+    "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+    "houseplan-assets/de-CvTiqIp9.js",
+    "houseplan-assets/editor-CVB0Rprj.js",
+    "houseplan-assets/fr-DcbpQBPN.js",
+    "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+    "houseplan-assets/guard-kV3ui_0R.js",
+    "houseplan-assets/houseplan-editor-runtime-VRkO32UK.js",
+    "houseplan-assets/houseplan-onboarding-runtime-DtvWEN8d.js",
+    "houseplan-assets/hp-zigbee-topology-overlay-5l6jYuHP.js",
+    "houseplan-assets/iso-scene-render-BoV9kUH5.js",
+    "houseplan-assets/live-interaction-runtime-ktbS2aJv.js",
+    "houseplan-assets/pdf-export-DtGfc39P.js",
+    "houseplan-assets/zigbee-topology-BVov8wVf.js",
+    "houseplan-assets/zigbee-topology-runtime-qetRggvA.js"
   ],
-  "lazyGzipBytes": 214972,
+  "lazyGzipBytes": 377481,
   "lazyEditorFiles": [
-    "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-    "houseplan-assets/editor-Dvui5H3b.js",
-    "houseplan-assets/houseplan-editor-runtime-9AEP51ly.js"
+    "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+    "houseplan-assets/editor-CVB0Rprj.js",
+    "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+    "houseplan-assets/guard-kV3ui_0R.js",
+    "houseplan-assets/houseplan-editor-runtime-VRkO32UK.js",
+    "houseplan-assets/zigbee-topology-BVov8wVf.js"
   ],
-  "lazyEditorGzipBytes": 159157,
+  "lazyEditorGzipBytes": 195230,
   "lazyOnboardingFiles": [
-    "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-    "houseplan-assets/houseplan-onboarding-runtime-CnVK5oOC.js"
+    "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+    "houseplan-assets/houseplan-onboarding-runtime-DtvWEN8d.js"
   ],
-  "lazyOnboardingGzipBytes": 14132,
+  "lazyOnboardingGzipBytes": 14327,
   "lazyLocaleFiles": [
-    "houseplan-assets/de-DJX-vLW1.js",
-    "houseplan-assets/fr-DVmfM6Kw.js"
+    "houseplan-assets/de-CvTiqIp9.js",
+    "houseplan-assets/fr-DcbpQBPN.js"
   ],
-  "lazyLocaleGzipBytes": 48859,
+  "lazyLocaleGzipBytes": 50276,
+  "lazyIsometricFiles": [
+    "houseplan-assets/guard-kV3ui_0R.js",
+    "houseplan-assets/iso-scene-render-BoV9kUH5.js"
+  ],
+  "lazyIsometricGzipBytes": 13452,
+  "lazyFurnitureArtFiles": [
+    "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js"
+  ],
+  "lazyFurnitureArtGzipBytes": 10252,
+  "lazyPdfFiles": [
+    "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+    "houseplan-assets/pdf-export-DtGfc39P.js"
+  ],
+  "lazyPdfGzipBytes": 114553,
   "files": [
     {
-      "path": "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-      "sha256": "455450cbc7b74f052fb112680af9ba4be145af8c3a1061907ec541b63957f22f",
-      "rawBytes": 20974,
-      "gzipBytes": 7176,
+      "path": "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+      "sha256": "93cad6469e3654c57cb99e56bcbc476d7bd2ed0ba4b427dd4642a896ffac317e",
+      "rawBytes": 21592,
+      "gzipBytes": 7359,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-Dwkibvgo.js"
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/de-DJX-vLW1.js",
-      "sha256": "73d198680c17602addf41855748533ed47233e81e9bdc02a786034aeac0e4e63",
-      "rawBytes": 81798,
-      "gzipBytes": 24701,
+      "path": "houseplan-assets/de-CvTiqIp9.js",
+      "sha256": "58ef84d390a3768827cb509cae61a9299d1b2237171d716bbb5b2f0b8c396070",
+      "rawBytes": 84320,
+      "gzipBytes": 25381,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/editor-Dvui5H3b.js",
-      "sha256": "11578ded60410e4e879c9342ee74c8a0968477ea2bae98eb18480a0ad02d303c",
-      "rawBytes": 3826,
-      "gzipBytes": 1580,
+      "path": "houseplan-assets/editor-CVB0Rprj.js",
+      "sha256": "97c577eaeddedc28c84d09a980c20e858fa92db3da5ede5ba1249c2a675240b8",
+      "rawBytes": 3837,
+      "gzipBytes": 1589,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/houseplan-card-Dwkibvgo.js"
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/fr-DVmfM6Kw.js",
-      "sha256": "167bed2822ce7e2b38d47e8dc1d73648d10c04d469979bf05e414000b53487b4",
-      "rawBytes": 83973,
-      "gzipBytes": 24158,
+      "path": "houseplan-assets/fr-DcbpQBPN.js",
+      "sha256": "161b5fa336f7f434ccfe98de0522724cbde83f78a1e33a113139f1e1cd72826f",
+      "rawBytes": 86352,
+      "gzipBytes": 24895,
       "isEntry": false,
       "imports": [],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/houseplan-card-Dwkibvgo.js",
-      "sha256": "d16deb0fc6f591040a2f97d51102e3e355da35cb3d1b69aa79472406c28d3ed2",
-      "rawBytes": 1033612,
-      "gzipBytes": 290234,
+      "path": "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+      "sha256": "71d1b96aa57c8e671a265b267618883adb9b28631794bee99c884938619801dd",
+      "rawBytes": 33655,
+      "gzipBytes": 10252,
+      "isEntry": false,
+      "imports": [],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/guard-kV3ui_0R.js",
+      "sha256": "742edae60745f4f8c7b60c4629433de715b9093699bceb370cc7b2c1acb7816e",
+      "rawBytes": 518,
+      "gzipBytes": 369,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/houseplan-card-Dj3l4riu.js",
+      "sha256": "889417c180066998beb8de107f19b09372de059586f9207c388f3904c3ab0a11",
+      "rawBytes": 1041197,
+      "gzipBytes": 288894,
       "isEntry": false,
       "imports": [],
       "dynamicImports": [
-        "houseplan-assets/de-DJX-vLW1.js",
-        "houseplan-assets/editor-Dvui5H3b.js",
-        "houseplan-assets/fr-DVmfM6Kw.js",
-        "houseplan-assets/houseplan-editor-runtime-9AEP51ly.js",
-        "houseplan-assets/houseplan-onboarding-runtime-CnVK5oOC.js"
+        "houseplan-assets/de-CvTiqIp9.js",
+        "houseplan-assets/editor-CVB0Rprj.js",
+        "houseplan-assets/fr-DcbpQBPN.js",
+        "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+        "houseplan-assets/houseplan-editor-runtime-VRkO32UK.js",
+        "houseplan-assets/houseplan-onboarding-runtime-DtvWEN8d.js",
+        "houseplan-assets/hp-zigbee-topology-overlay-5l6jYuHP.js",
+        "houseplan-assets/iso-scene-render-BoV9kUH5.js",
+        "houseplan-assets/live-interaction-runtime-ktbS2aJv.js",
+        "houseplan-assets/pdf-export-DtGfc39P.js"
       ]
     },
     {
-      "path": "houseplan-assets/houseplan-editor-runtime-9AEP51ly.js",
-      "sha256": "c1b8f90458afedddbbdde98570c517d6e66dfcee08ad4764b1ac2473bdf89fb4",
-      "rawBytes": 574225,
-      "gzipBytes": 150401,
+      "path": "houseplan-assets/houseplan-editor-runtime-VRkO32UK.js",
+      "sha256": "19a3ed2f8336ef5875becf0dd9341e1eb2acba92e3eefcccb2a4a4f0c2fe1865",
+      "rawBytes": 631884,
+      "gzipBytes": 168231,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-        "houseplan-assets/houseplan-card-Dwkibvgo.js"
+        "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+        "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+        "houseplan-assets/guard-kV3ui_0R.js",
+        "houseplan-assets/houseplan-card-Dj3l4riu.js",
+        "houseplan-assets/zigbee-topology-BVov8wVf.js"
+      ],
+      "dynamicImports": [
+        "houseplan-assets/zigbee-topology-runtime-qetRggvA.js"
+      ]
+    },
+    {
+      "path": "houseplan-assets/houseplan-onboarding-runtime-DtvWEN8d.js",
+      "sha256": "8ae0c319d6d953503893af057911e8dd80b1496aced771b33e59a2c9d7462888",
+      "rawBytes": 28071,
+      "gzipBytes": 6968,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/backdrop-pick-CVsiO2U3.js",
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
       ],
       "dynamicImports": []
     },
     {
-      "path": "houseplan-assets/houseplan-onboarding-runtime-CnVK5oOC.js",
-      "sha256": "bd169896116229e76b37243106bde64755589017639890d36dd19282c872db7a",
-      "rawBytes": 28088,
-      "gzipBytes": 6956,
+      "path": "houseplan-assets/hp-zigbee-topology-overlay-5l6jYuHP.js",
+      "sha256": "6abe885e9c2aaed324383b5d5cd3d6fbe2e15a035e75714fa81bd03ffbd60364",
+      "rawBytes": 11034,
+      "gzipBytes": 3732,
       "isEntry": false,
       "imports": [
-        "houseplan-assets/backdrop-pick-DWD0ZQTc.js",
-        "houseplan-assets/houseplan-card-Dwkibvgo.js"
+        "houseplan-assets/houseplan-card-Dj3l4riu.js",
+        "houseplan-assets/zigbee-topology-BVov8wVf.js",
+        "houseplan-assets/zigbee-topology-runtime-qetRggvA.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/iso-scene-render-BoV9kUH5.js",
+      "sha256": "fc7a3e8043131534d6e8a06436604b8cfce30507db7e1605e9fbd3f2f112691a",
+      "rawBytes": 38562,
+      "gzipBytes": 13083,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/guard-kV3ui_0R.js",
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/live-interaction-runtime-ktbS2aJv.js",
+      "sha256": "3bb9ad1896160fdce6c80f26e1aae3326492fd746d1b377aac1803ede9a69ce5",
+      "rawBytes": 5196,
+      "gzipBytes": 2129,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/pdf-export-DtGfc39P.js",
+      "sha256": "fbaccc807ebf53736fc787d08ec655fc34282dceac8b6179f7f7b45d175c4a08",
+      "rawBytes": 220678,
+      "gzipBytes": 104301,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/furniture-plan-art.generated-CNpyYWJT.js",
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/zigbee-topology-BVov8wVf.js",
+      "sha256": "9567e8eb9e5493ebec9fe6eb20dc4d697668ba366f34e4dbebdd4dc1f27711f6",
+      "rawBytes": 18961,
+      "gzipBytes": 7430,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
+      ],
+      "dynamicImports": []
+    },
+    {
+      "path": "houseplan-assets/zigbee-topology-runtime-qetRggvA.js",
+      "sha256": "42b7519d904e811226d3f3c3a3eb7d4ddad31a930e556c2ab70bdf33646c1d46",
+      "rawBytes": 3941,
+      "gzipBytes": 1762,
+      "isEntry": false,
+      "imports": [
+        "houseplan-assets/houseplan-card-Dj3l4riu.js",
+        "houseplan-assets/zigbee-topology-BVov8wVf.js"
       ],
       "dynamicImports": []
     },
     {
       "path": "houseplan-card.js",
-      "sha256": "730163666440793e44be0ee5482f7080931370f94555a1d52072d3a54698447e",
+      "sha256": "14428c282530203899c2f201e015faaab528358f62b3ce4393c347bc9acf39b3",
       "rawBytes": 1183,
-      "gzipBytes": 797,
+      "gzipBytes": 795,
       "isEntry": true,
       "imports": [
-        "houseplan-assets/houseplan-card-Dwkibvgo.js"
+        "houseplan-assets/houseplan-card-Dj3l4riu.js"
       ],
       "dynamicImports": []
     }

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

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

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

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

custom_components/houseplan/frontend/houseplan-assets/guard-kV3ui_0R.js

@@ -0,0 +1 @@
+globalThis.__HOUSEPLAN_BUILD_FINGERPRINT__="16404f74463739afada7755507e1bf32b9468a1125505ff93b9a73cddb36ea18";import{dK as r,dL as t,dM as s}from"./houseplan-card-Dj3l4riu.js";const e={},a=r(class extends t{constructor(){super(...arguments),this.ot=e}render(r,t){return t()}update(r,[t,e]){if(Array.isArray(t)){if(Array.isArray(this.ot)&&this.ot.length===t.length&&t.every((r,t)=>r===this.ot[t]))return s}else if(this.ot===t)return s;return this.ot=Array.isArray(t)?Array.from(t):t,this.render(t,e)}});export{a as i};

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

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

custom_components/houseplan/frontend/houseplan-card.js

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

custom_components/houseplan/frontend_registration.py

@@ -0,0 +1,659 @@
+"""Register the House Plan card with the Home Assistant frontend."""
+from __future__ import annotations
+
+import asyncio
+import logging
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Literal
+
+from homeassistant.components import frontend, persistent_notification
+from homeassistant.core import HomeAssistant, callback
+from homeassistant.helpers.event import async_call_later
+from homeassistant.helpers.start import async_at_started
+from homeassistant.helpers.translation import async_get_translations
+
+from .const import DOMAIN, FRONTEND_URL, VERSION
+from .store import HouseplanConfigEntry
+
+_LOGGER = logging.getLogger(__name__)
+
+FRONTEND_REGISTRATION_KEY = "frontend_registration"
+FRONTEND_STATIC_REGISTERED_KEY = "static_registered"
+FRONTEND_FALLBACK_URLS_KEY = "frontend_fallback_urls"
+FRONTEND_RELOAD_NOTICE_DATA_KEY = "frontend_reload_notice_created"
+FRONTEND_RELOAD_NOTICE_ID = "houseplan_frontend_reload_notice"
+FRONTEND_RETRY_DELAY_SECONDS = 1.0
+
+_NOTICE_TITLE_KEY = "component.houseplan.issues.frontend_reload_notice.title"
+_NOTICE_DESCRIPTION_KEY = (
+    "component.houseplan.issues.frontend_reload_notice.description"
+)
+_NOTICE_TITLE_FALLBACK = "House Plan card connected"
+_NOTICE_DESCRIPTION_FALLBACK = (
+    "The House Plan card is connected. Fully reload this page to use the latest "
+    "frontend (`Ctrl+F5` on Windows/Linux or `Cmd+Shift+R` on macOS). If you "
+    "manage dashboard resources manually in storage mode, open Settings → "
+    "Dashboards → Resources."
+)
+
+RegistrationStatus = Literal[
+    "not_attempted",
+    "created",
+    "updated",
+    "existing",
+    "registry_pending",
+    "yaml_fallback",
+    "transient_error",
+    "error_fallback",
+]
+ResourceLoader = Literal[
+    "none",
+    "lovelace_resource",
+    "extra_module_url",
+    "lovelace_resource_with_session_fallback",
+]
+ReloadNoticeStatus = Literal[
+    "created",
+    "already_created",
+    "pending_frontend",
+]
+
+
+@dataclass(frozen=True, slots=True)
+class RegistrationOutcome:
+    """Result of one Lovelace resource registry attempt."""
+
+    status: RegistrationStatus
+    last_error: str | None = None
+
+
+@dataclass(slots=True)
+class FrontendRegistrationState:
+    """Observable state and lifecycle handles for the current config-entry run."""
+
+    card_file_present: bool
+    static_path_registered: bool = False
+    resource_status: RegistrationStatus = "not_attempted"
+    loader: ResourceLoader = "none"
+    module_url: str | None = None
+    retry_pending: bool = False
+    retry_attempted: bool = False
+    last_error: str | None = None
+    first_reload_notice: ReloadNoticeStatus = "pending_frontend"
+    active: bool = True
+    fallback_added: bool = False
+    _cancel_started: Callable[[], None] | None = field(default=None, repr=False)
+    _cancel_timer: Callable[[], None] | None = field(default=None, repr=False)
+    _retry_task: asyncio.Task[None] | None = field(default=None, repr=False)
+    _notice_lock: asyncio.Lock = field(default_factory=asyncio.Lock, repr=False)
+
+    @callback
+    def cancel(self) -> None:
+        """Prevent all delayed work for this setup generation."""
+        self.active = False
+        self.retry_pending = False
+        if self._cancel_started is not None:
+            self._cancel_started()
+            self._cancel_started = None
+        if self._cancel_timer is not None:
+            self._cancel_timer()
+            self._cancel_timer = None
+        if self._retry_task is not None and not self._retry_task.done():
+            self._retry_task.cancel()
+        self._retry_task = None
+
+
+def _safe_error(phase: str, err: BaseException) -> str:
+    """Return a support-safe failure fingerprint without message or path data."""
+    return f"{phase}:{type(err).__name__}"
+
+
+def _lovelace_resources(hass: HomeAssistant):
+    """Return the Lovelace resource collection across supported HA versions."""
+    lovelace = hass.data.get("lovelace")
+    resources = getattr(lovelace, "resources", None)
+    if resources is None and isinstance(lovelace, dict):
+        resources = lovelace.get("resources")
+    return resources
+
+
+def _is_current(hass: HomeAssistant, state: FrontendRegistrationState) -> bool:
+    """Return whether a delayed operation still belongs to the loaded entry."""
+    return (
+        state.active
+        and hass.data.get(DOMAIN, {}).get(FRONTEND_REGISTRATION_KEY) is state
+    )
+
+
+def _owned_fallback_urls(hass: HomeAssistant) -> set[str]:
+    """Return exact extra-module URLs owned for this Home Assistant run."""
+    domain_data = hass.data.setdefault(DOMAIN, {})
+    urls = domain_data.get(FRONTEND_FALLBACK_URLS_KEY)
+    if not isinstance(urls, set):
+        urls = set()
+        domain_data[FRONTEND_FALLBACK_URLS_KEY] = urls
+    return urls
+
+
+def _active_extra_module_urls(hass: HomeAssistant) -> frozenset[str] | None:
+    """Return HA's current module URLs, or None when the API is unknowable.
+
+    ``add_extra_js_url`` is intentionally idempotent and has no ownership
+    return value.  Looking before adding is therefore the only way to avoid
+    claiming (and later removing) an identical URL configured by the user.
+    Both the oldest supported HA and current HA expose ``UrlManager.urls``;
+    unknown future/legacy shapes fail closed and are never claimed.
+    """
+    key = getattr(frontend, "DATA_EXTRA_MODULE_URL", None)
+    if key is None:
+        return None
+    manager = hass.data.get(key)
+    if manager is None:
+        # Frontend setup normally creates the manager before this integration.
+        # If it is genuinely absent, no configured URL can predate our add;
+        # add_extra_js_url will either create/use its supported path or fail.
+        return frozenset()
+    urls = getattr(manager, "urls", None)
+    if not isinstance(urls, (set, frozenset, list, tuple)):
+        return None
+    return frozenset(url for url in urls if isinstance(url, str))
+
+
+async def _async_remove_duplicate_resources(
+    resources,
+    existing: list[dict],
+    canonical_id: str,
+    *,
+    is_active: Callable[[], bool],
+) -> None:
+    """Best-effort remove legacy duplicates after choosing one authority."""
+    remover = getattr(resources, "async_delete_item", None)
+    if remover is None:
+        return
+    for item in existing:
+        if item.get("id") == canonical_id:
+            continue
+        if not is_active():
+            return
+        try:
+            await remover(item["id"])
+        except asyncio.CancelledError:
+            raise
+        except Exception:  # noqa: BLE001 - canonical registration still succeeded
+            _LOGGER.debug(
+                "Could not remove a duplicate House Plan Lovelace resource",
+                exc_info=True,
+            )
+
+
+async def async_register_lovelace_resource(
+    hass: HomeAssistant,
+    module_url: str,
+    *,
+    is_active: Callable[[], bool] | None = None,
+) -> RegistrationOutcome:
+    """Create or update the canonical Lovelace resource entry."""
+    active = is_active or (lambda: True)
+    resources = _lovelace_resources(hass)
+    if resources is None:
+        return RegistrationOutcome("registry_pending")
+    if not hasattr(resources, "async_create_item"):
+        return RegistrationOutcome("yaml_fallback")
+
+    try:
+        if not active():
+            return RegistrationOutcome("registry_pending")
+        if hasattr(resources, "async_get_info"):
+            await resources.async_get_info()
+        elif hasattr(resources, "loaded") and not resources.loaded:
+            await resources.async_load()
+            resources.loaded = True
+        if not active():
+            return RegistrationOutcome("registry_pending")
+
+        existing = [
+            item
+            for item in resources.async_items()
+            if str(item.get("url", "")).split("?", 1)[0] == FRONTEND_URL
+        ]
+        if existing:
+            # Prefer an already-current entry when legacy duplicates exist. This
+            # preserves its stable id while the remaining same-base entries are
+            # removed best effort below.
+            item = next(
+                (candidate for candidate in existing if candidate.get("url") == module_url),
+                existing[0],
+            )
+            if item.get("url") == module_url and item.get("type") == "module":
+                await _async_remove_duplicate_resources(
+                    resources,
+                    existing,
+                    item["id"],
+                    is_active=active,
+                )
+                return RegistrationOutcome("existing")
+            if not hasattr(resources, "async_update_item"):
+                return RegistrationOutcome(
+                    "transient_error", "registry_update:UnsupportedOperation"
+                )
+            if not active():
+                return RegistrationOutcome("registry_pending")
+            await resources.async_update_item(
+                item["id"], {"url": module_url, "res_type": "module"}
+            )
+            await _async_remove_duplicate_resources(
+                resources,
+                existing,
+                item["id"],
+                is_active=active,
+            )
+            return RegistrationOutcome("updated")
+
+        if not active():
+            return RegistrationOutcome("registry_pending")
+        await resources.async_create_item(
+            {"url": module_url, "res_type": "module"}
+        )
+        _LOGGER.debug("House Plan card registered as a Lovelace resource")
+        return RegistrationOutcome("created")
+    except asyncio.CancelledError:
+        raise
+    except Exception as err:  # noqa: BLE001 - typed fallback is intentional
+        _LOGGER.debug("Could not register the House Plan Lovelace resource", exc_info=True)
+        return RegistrationOutcome("transient_error", _safe_error("registry", err))
+
+
+def _add_fallback(
+    hass: HomeAssistant, state: FrontendRegistrationState
+) -> None:
+    """Add this setup's exact versioned extra-module URL, best effort."""
+    if state.module_url is None or not _is_current(hass, state):
+        return
+    owned_urls = _owned_fallback_urls(hass)
+    if state.module_url in owned_urls:
+        state.fallback_added = True
+        state.loader = "extra_module_url"
+        return
+    active_before = _active_extra_module_urls(hass)
+    if active_before is not None and state.module_url in active_before:
+        # The exact URL predates this setup. It is a working loader, but it is
+        # not ours to remove after registry recovery or on uninstall.
+        state.fallback_added = True
+        state.loader = "extra_module_url"
+        return
+    try:
+        frontend.add_extra_js_url(hass, state.module_url)
+    except Exception as err:  # noqa: BLE001 - frontend setup must remain available
+        state.loader = "none"
+        state.last_error = _safe_error("fallback_add", err)
+        _LOGGER.warning("Could not add the House Plan frontend fallback", exc_info=True)
+        return
+    if active_before is not None:
+        owned_urls.add(state.module_url)
+    else:
+        _LOGGER.debug(
+            "House Plan could not prove ownership of the frontend fallback; "
+            "it will remain until Home Assistant restarts"
+        )
+    state.fallback_added = True
+    state.loader = "extra_module_url"
+
+
+def _remove_owned_fallback_url(
+    hass: HomeAssistant,
+    state: FrontendRegistrationState,
+    module_url: str,
+) -> bool:
+    """Remove one exact integration-owned fallback when HA supports it."""
+    owned_urls = _owned_fallback_urls(hass)
+    if module_url not in owned_urls:
+        return True
+    remover = getattr(frontend, "remove_extra_js_url", None)
+    if remover is None:
+        return False
+    try:
+        remover(hass, module_url)
+    except KeyError:
+        # Another lifecycle path already removed the exact URL.
+        owned_urls.discard(module_url)
+        return True
+    except Exception as err:  # noqa: BLE001 - registry remains authoritative
+        state.last_error = _safe_error("fallback_remove", err)
+        _LOGGER.debug("Could not remove the House Plan frontend fallback", exc_info=True)
+        return False
+    owned_urls.discard(module_url)
+    return True
+
+
+def _remove_fallback(
+    hass: HomeAssistant, state: FrontendRegistrationState
+) -> bool:
+    """Remove this setup's exact fallback when the running HA supports it."""
+    if state.module_url is None:
+        return True
+    owned_urls = _owned_fallback_urls(hass)
+    if state.module_url in owned_urls:
+        removed = _remove_owned_fallback_url(hass, state, state.module_url)
+        state.fallback_added = not removed
+        return removed
+
+    # A pre-existing/user-owned or uninspectable exact URL must never be
+    # removed. Report the combined loader while it is known (or conservatively
+    # assumed) to remain active in this HA document lifecycle.
+    active = _active_extra_module_urls(hass)
+    state.fallback_added = active is None or state.module_url in active
+    return not state.fallback_added
+
+
+async def _async_create_reload_notice(
+    hass: HomeAssistant,
+    entry: HouseplanConfigEntry,
+    state: FrontendRegistrationState,
+) -> None:
+    """Create and persist the one-time localized hard-reload instruction."""
+    # Initial fallback setup and the one-second retry may overlap when loading a
+    # translation is slow. Serialize the persisted one-shot contract rather
+    # than relying only on the stable notification ID (which prevents two UI
+    # rows but would still perform and persist two creates).
+    async with state._notice_lock:
+        if entry.data.get(FRONTEND_RELOAD_NOTICE_DATA_KEY) is True:
+            if state.first_reload_notice != "created":
+                state.first_reload_notice = "already_created"
+            return
+        if (
+            not _is_current(hass, state)
+            or not state.card_file_present
+            or not state.static_path_registered
+            or state.loader == "none"
+        ):
+            state.first_reload_notice = "pending_frontend"
+            return
+
+        title = _NOTICE_TITLE_FALLBACK
+        description = _NOTICE_DESCRIPTION_FALLBACK
+        try:
+            translations = await async_get_translations(
+                hass,
+                hass.config.language,
+                "issues",
+                integrations={DOMAIN},
+            )
+            title = translations.get(_NOTICE_TITLE_KEY, title)
+            description = translations.get(_NOTICE_DESCRIPTION_KEY, description)
+        except asyncio.CancelledError:
+            raise
+        except Exception:  # noqa: BLE001 - built-in English fallback is intentional
+            _LOGGER.debug(
+                "Could not load the House Plan reload notice translation",
+                exc_info=True,
+            )
+
+        if not _is_current(hass, state):
+            return
+        try:
+            persistent_notification.async_create(
+                hass,
+                description,
+                title=title,
+                notification_id=FRONTEND_RELOAD_NOTICE_ID,
+            )
+        except Exception:  # noqa: BLE001 - do not consume flag on failure
+            state.first_reload_notice = "pending_frontend"
+            _LOGGER.warning(
+                "Could not create the House Plan reload notice", exc_info=True
+            )
+            return
+        try:
+            hass.config_entries.async_update_entry(
+                entry,
+                data={**entry.data, FRONTEND_RELOAD_NOTICE_DATA_KEY: True},
+            )
+        except Exception:  # noqa: BLE001 - roll back the unpersisted notice
+            # A stable ID prevents duplicate rows, but dismissing the notice is
+            # still important: without a durable flag, displaying it would make
+            # System Health claim that the one-shot contract is pending while a
+            # user-visible notice already exists. A later setup/retry can now
+            # attempt the complete create+persist operation honestly.
+            try:
+                persistent_notification.async_dismiss(
+                    hass, FRONTEND_RELOAD_NOTICE_ID
+                )
+            except Exception:  # noqa: BLE001 - stable ID remains a safe fallback
+                _LOGGER.debug(
+                    "Could not roll back an unpersisted House Plan reload notice",
+                    exc_info=True,
+                )
+            state.first_reload_notice = "pending_frontend"
+            _LOGGER.warning(
+                "Could not persist the House Plan reload notice state",
+                exc_info=True,
+            )
+            return
+        state.first_reload_notice = "created"
+
+
+async def _async_retry_registration(
+    hass: HomeAssistant,
+    entry: HouseplanConfigEntry,
+    state: FrontendRegistrationState,
+) -> None:
+    """Perform the single delayed resource-registry retry."""
+    if not _is_current(hass, state) or state.module_url is None:
+        return
+    state.retry_pending = False
+    state.retry_attempted = True
+    outcome = await async_register_lovelace_resource(
+        hass,
+        state.module_url,
+        is_active=lambda: _is_current(hass, state),
+    )
+    if not _is_current(hass, state):
+        return
+
+    if outcome.status in {"created", "updated", "existing"}:
+        state.resource_status = outcome.status
+        state.last_error = outcome.last_error
+        state.loader = (
+            "lovelace_resource"
+            if _remove_fallback(hass, state)
+            else "lovelace_resource_with_session_fallback"
+        )
+    elif outcome.status == "yaml_fallback":
+        state.resource_status = "yaml_fallback"
+        state.last_error = outcome.last_error
+        _add_fallback(hass, state)
+    else:
+        state.resource_status = "error_fallback"
+        state.last_error = outcome.last_error or "registry_retry:Unavailable"
+        _add_fallback(hass, state)
+
+    await _async_create_reload_notice(hass, entry, state)
+
+
+def _schedule_retry(
+    hass: HomeAssistant,
+    entry: HouseplanConfigEntry,
+    state: FrontendRegistrationState,
+) -> None:
+    """Schedule exactly one lifecycle-bound retry after HA start plus one second."""
+    state.retry_pending = True
+
+    @callback
+    def _after_started(_event=None) -> None:
+        if not _is_current(hass, state):
+            return
+        state._cancel_started = None
+
+        @callback
+        def _after_delay(_now=None) -> None:
+            if not _is_current(hass, state):
+                return
+            state._cancel_timer = None
+            state._retry_task = entry.async_create_background_task(
+                hass,
+                _async_retry_registration(hass, entry, state),
+                "houseplan frontend resource retry",
+            )
+
+        state._cancel_timer = async_call_later(
+            hass, FRONTEND_RETRY_DELAY_SECONDS, _after_delay
+        )
+
+    state._cancel_started = async_at_started(hass, _after_started)
+
+
+async def async_setup_frontend_registration(
+    hass: HomeAssistant,
+    entry: HouseplanConfigEntry,
+    card_path: Path,
+) -> FrontendRegistrationState:
+    """Register static/card resources without blocking the rest of entry setup."""
+    domain_data = hass.data.setdefault(DOMAIN, {})
+    previous = domain_data.get(FRONTEND_REGISTRATION_KEY)
+    if isinstance(previous, FrontendRegistrationState):
+        previous.cancel()
+
+    card_file_present = card_path.is_file()
+    module_url = f"{FRONTEND_URL}?v={VERSION}" if card_file_present else None
+    active_fallbacks = _active_extra_module_urls(hass)
+    fallback_added = module_url is not None and (
+        module_url in _owned_fallback_urls(hass)
+        or (active_fallbacks is not None and module_url in active_fallbacks)
+    )
+    state = FrontendRegistrationState(
+        card_file_present=card_file_present,
+        loader="extra_module_url" if fallback_added else "none",
+        module_url=module_url,
+        first_reload_notice=(
+            "already_created"
+            if entry.data.get(FRONTEND_RELOAD_NOTICE_DATA_KEY) is True
+            else "pending_frontend"
+        ),
+        fallback_added=fallback_added,
+    )
+    domain_data[FRONTEND_REGISTRATION_KEY] = state
+    entry.async_on_unload(state.cancel)
+
+    if domain_data.get(FRONTEND_STATIC_REGISTERED_KEY):
+        state.static_path_registered = True
+    elif card_file_present:
+        try:
+            try:
+                from homeassistant.components.http import StaticPathConfig
+            except ImportError:  # Home Assistant versions before the async API
+                hass.http.register_static_path(
+                    FRONTEND_URL, str(card_path), cache_headers=False
+                )
+            else:
+                await hass.http.async_register_static_paths(
+                    [StaticPathConfig(FRONTEND_URL, str(card_path), cache_headers=False)]
+                )
+        except asyncio.CancelledError:
+            raise
+        except Exception as err:  # noqa: BLE001 - setup continues without frontend
+            state.last_error = _safe_error("static_path", err)
+            _LOGGER.warning("Could not register the House Plan static path", exc_info=True)
+        else:
+            domain_data[FRONTEND_STATIC_REGISTERED_KEY] = True
+            state.static_path_registered = True
+
+    if not card_file_present:
+        _LOGGER.warning("houseplan-card.js was not found next to the integration")
+        return state
+    if not state.static_path_registered or state.module_url is None:
+        return state
+
+    outcome = await async_register_lovelace_resource(
+        hass,
+        state.module_url,
+        is_active=lambda: _is_current(hass, state),
+    )
+    if not _is_current(hass, state):
+        return state
+    state.resource_status = outcome.status
+    state.last_error = outcome.last_error
+
+    if outcome.status in {"created", "updated", "existing"}:
+        state.loader = (
+            "lovelace_resource"
+            if _remove_fallback(hass, state)
+            else "lovelace_resource_with_session_fallback"
+        )
+        _LOGGER.info(
+            "House Plan card auto-registered as a Lovelace resource: %s",
+            state.module_url,
+        )
+    else:
+        _add_fallback(hass, state)
+        if outcome.status in {"registry_pending", "transient_error"}:
+            _schedule_retry(hass, entry, state)
+        else:
+            _LOGGER.info(
+                "House Plan card uses the frontend extra-module fallback: %s",
+                state.module_url,
+            )
+
+    await _async_create_reload_notice(hass, entry, state)
+    return state
+
+
+@callback
+def get_frontend_registration_state(
+    hass: HomeAssistant,
+) -> FrontendRegistrationState | None:
+    """Return current frontend registration state for System Health."""
+    state = hass.data.get(DOMAIN, {}).get(FRONTEND_REGISTRATION_KEY)
+    return state if isinstance(state, FrontendRegistrationState) else None
+
+
+async def async_remove_frontend_registration(
+    hass: HomeAssistant, entry: HouseplanConfigEntry
+) -> None:
+    """Remove all House Plan resource entries and its one-time notice."""
+    state = get_frontend_registration_state(hass)
+    if state is not None:
+        state.cancel()
+        domain_data = hass.data.get(DOMAIN, {})
+        if domain_data.get(FRONTEND_REGISTRATION_KEY) is state:
+            domain_data.pop(FRONTEND_REGISTRATION_KEY, None)
+
+    # Fallback ownership belongs to this HA run, not to the latest config-entry
+    # generation. A bundle-missing reload can therefore have no current URL
+    # while an earlier exact URL is still registered. Uninstall cleans every
+    # URL that this integration itself added, and never pattern-matches foreign
+    # extra-module entries.
+    cleanup_state = state or FrontendRegistrationState(card_file_present=False)
+    for module_url in tuple(_owned_fallback_urls(hass)):
+        _remove_owned_fallback_url(hass, cleanup_state, module_url)
+
+    try:
+        persistent_notification.async_dismiss(hass, FRONTEND_RELOAD_NOTICE_ID)
+    except Exception:  # noqa: BLE001 - uninstall cleanup is best effort
+        _LOGGER.debug("Could not dismiss the House Plan reload notice", exc_info=True)
+
+    try:
+        resources = _lovelace_resources(hass)
+        if resources is None or not hasattr(resources, "async_delete_item"):
+            return
+        if hasattr(resources, "async_get_info"):
+            await resources.async_get_info()
+        for item in list(resources.async_items()):
+            if str(item.get("url", "")).split("?", 1)[0] != FRONTEND_URL:
+                continue
+            try:
+                await resources.async_delete_item(item["id"])
+            except asyncio.CancelledError:
+                raise
+            except Exception:  # noqa: BLE001 - continue best-effort cleanup
+                _LOGGER.debug(
+                    "Could not remove one House Plan Lovelace resource",
+                    exc_info=True,
+                )
+                continue
+            _LOGGER.debug("House Plan Lovelace resource removed")
+    except asyncio.CancelledError:
+        raise
+    except Exception:  # noqa: BLE001 - uninstall cleanup is best effort
+        _LOGGER.debug("Could not remove the House Plan Lovelace resource", exc_info=True)

custom_components/houseplan/http_api.py

@@ -24,6 +24,7 @@ try:  # KEY_HASS — the modern way to access hass from the aiohttp application
 except ImportError:  # older HA versions
     KEY_HASS = "hass"  # type: ignore[assignment]
 
+from .asset_integrity import get_asset_integrity_verifier
 from .auth import may_write
 from .const import (
     ASSETS_DIR,
@@ -43,8 +44,9 @@ from .decor_assets import (
     ASSET_ID_RE,
     DecorAssetError,
     asset_meta_path,
+    physical_asset_usage,
     public_asset,
-    read_catalog,
+    read_asset,
     validate_asset,
 )
 from .import_export import ImportFailure, create_preview
@@ -176,18 +178,13 @@ class HouseplanContentView(HomeAssistantView):
         if not str(path).startswith(str(base)):
             return web.Response(status=404)
 
-        if not await hass.async_add_executor_job(path.is_file):
-            return web.Response(status=404)
         suffix = path.suffix.lower()
         if kind == "assets":
-            try:
-                digest = await hass.async_add_executor_job(
-                    lambda: hashlib.sha256(path.read_bytes()).hexdigest(),
-                )
-            except OSError:
-                return web.Response(status=404)
-            if digest != path.stem:
+            verifier = get_asset_integrity_verifier(hass)
+            if not await hass.async_add_executor_job(verifier.verify, path, path.stem):
                 return web.Response(status=404)
+        elif not await hass.async_add_executor_job(path.is_file):
+            return web.Response(status=404)
         headers = {
             "Cache-Control": "private, max-age=31536000, immutable"
                 if kind == "assets" else "private, max-age=3600",
@@ -269,24 +266,12 @@ class HouseplanDecorAssetUploadView(HomeAssistantView):
 
         def _store() -> tuple[dict, bool]:
             root.mkdir(parents=True, exist_ok=True)
-            existing = next(
-                (row for row in read_catalog(root) if row["asset_id"] == validated.asset_id),
-                None,
-            )
+            existing = read_asset(root, validated.asset_id)
             if existing is not None:
                 existing_blob = root / f"{validated.asset_id}{existing['ext']}"
                 if hashlib.sha256(existing_blob.read_bytes()).hexdigest() != validated.asset_id:
                     raise DecorAssetError("invalid_image", "The stored image failed its integrity check")
                 return existing, True
-            rows = read_catalog(root)
-            used = sum(int(row.get("bytes") or 0) for row in rows)
-            if len(rows) >= MAX_DECOR_ASSETS_COUNT or used + len(validated.data) > MAX_DECOR_ASSETS_BYTES:
-                raise DecorAssetError("capacity_exceeded", "The decor image store is full")
-            try:
-                if shutil.disk_usage(root).free - len(validated.data) < MIN_FREE_BYTES:
-                    raise DecorAssetError("capacity_exceeded", "Not enough free disk space")
-            except OSError:
-                pass
             aid = validated.asset_id
             blob = root / f"{aid}{validated.ext}"
             meta = asset_meta_path(root, aid)
@@ -296,6 +281,33 @@ class HouseplanDecorAssetUploadView(HomeAssistantView):
                 "ext": validated.ext, "width": validated.width, "height": validated.height,
                 "bytes": len(validated.data), "created_at": datetime.now(timezone.utc).isoformat(),
             }
+            # A hard stop may have promoted the content-addressed blob before
+            # its sidecar. Its exact path and digest prove that no new physical
+            # bytes are needed, so repair remains possible even at full quota.
+            if blob.exists():
+                if not blob.is_file() or hashlib.sha256(blob.read_bytes()).hexdigest() != aid:
+                    raise DecorAssetError("invalid_image", "The stored image failed its integrity check")
+                fd, meta_temp_name = tempfile.mkstemp(prefix=".asset-meta-", dir=str(root))
+                os.close(fd)
+                meta_temp = Path(meta_temp_name)
+                try:
+                    with meta_temp.open("w", encoding="utf-8") as stream:
+                        stream.write(json.dumps(row, ensure_ascii=False, separators=(",", ":")))
+                        stream.flush()
+                        os.fsync(stream.fileno())
+                    os.replace(meta_temp, meta)
+                    return row, False
+                finally:
+                    meta_temp.unlink(missing_ok=True)
+
+            count, used = physical_asset_usage(root)
+            if count >= MAX_DECOR_ASSETS_COUNT or used + len(validated.data) > MAX_DECOR_ASSETS_BYTES:
+                raise DecorAssetError("capacity_exceeded", "The decor image store is full")
+            try:
+                if shutil.disk_usage(root).free - len(validated.data) < MIN_FREE_BYTES:
+                    raise DecorAssetError("capacity_exceeded", "Not enough free disk space")
+            except OSError:
+                pass
             fd, temp_name = tempfile.mkstemp(prefix=".asset-", dir=str(root))
             os.close(fd)
             temp = Path(temp_name)
@@ -310,14 +322,6 @@ class HouseplanDecorAssetUploadView(HomeAssistantView):
                     stream.write(json.dumps(row, ensure_ascii=False, separators=(",", ":")))
                     stream.flush()
                     os.fsync(stream.fileno())
-                if blob.exists():
-                    # A previous hard stop may have promoted the blob but not
-                    # its sidecar. The content hash proves those bytes; finish
-                    # the catalog transaction rather than leaving a ghost.
-                    if hashlib.sha256(blob.read_bytes()).hexdigest() != aid:
-                        raise DecorAssetError("invalid_image", "The stored image failed its integrity check")
-                    os.replace(meta_temp, meta)
-                    return row, True
                 os.replace(temp, blob)
                 promoted_blob = True
                 os.replace(meta_temp, meta)
@@ -337,7 +341,8 @@ class HouseplanDecorAssetUploadView(HomeAssistantView):
             async with runtime.upload_lock:
                 row, reused = await hass.async_add_executor_job(_store)
         except DecorAssetError as err:
-            return web.json_response({"error": err.code, "message": str(err)}, status=507)
+            status = 507 if err.code == "capacity_exceeded" else 400
+            return web.json_response({"error": err.code, "message": str(err)}, status=status)
         except OSError as err:
             _LOGGER.warning("House Plan decor asset upload: store failed: %s", err)
             return web.json_response({"error": "io_error"}, status=500)

custom_components/houseplan/import_export.py

@@ -52,6 +52,7 @@ from .validation import (
     sanitize_marker_id,
     validate_marker_controls,
     validate_marker_light_entities,
+    validate_marker_vacuum_routes,
     validate_marker_value_badges,
     validate_opening_passages,
     validate_partition_opening_hosts,
@@ -69,11 +70,17 @@ _LIVE_TEXT_ENTITY = re.compile(r"^[a-z0-9_]+\.[a-z0-9_]+$")
 _LIVE_TEXT_ATTRIBUTE = re.compile(r"^[a-zA-Z0-9_.-]+$")
 _PLAN_ONLY_DASH = "—"
 _IMPORT_ID_NAMESPACES = {
-    "space", "room", "marker", "partition", "wall", "opening", "decor", "draft",
-    "draft_segment", "column",
+    "space", "room", "marker", "partition", "wall", "opening", "decor", "column",
 }
 _MAX_IMPORT_LINEAGE_DEPTH = 16
 _REPORT_EXAMPLE_LIMIT = 24
+_DECOR_ASSET_MIME_BY_SUFFIX = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+}
+_DECOR_ASSET_MIME_TYPES = frozenset(_DECOR_ASSET_MIME_BY_SUFFIX.values())
 
 _SPACE_PLAN_FIELDS = (
     "id", "title", "cell_cm", "plan_url", "plan_aspect", "plan_x", "plan_y",
@@ -98,6 +105,7 @@ _DECOR_KIND_FIELDS = {
     "ellipse": ("x", "y", "w", "h", "angle", "fill", "fill_color", "fill_opacity"),
     "text": ("x", "y", "text", "size", "size_cm", "scale", "angle"),
     "furniture": ("symbol", "x", "y", "w", "h", "angle", "flip_h", "flip_v"),
+    "image": ("asset_id", "x", "y", "w", "h", "angle", "flip_h", "flip_v"),
 }
 
 
@@ -257,7 +265,6 @@ def _project_plan_only_space(space: dict[str, Any]) -> dict[str, Any]:
     collections: tuple[tuple[str, tuple[str, ...]], ...] = (
         ("walls", ("key", "cm", "a", "b")),
         ("wall_segments", ("id", "a", "b", "cm")),
-        ("room_drafts", ("id", "points", "segments")),
         ("partitions", ("id", "a", "b", "cm")),
         ("wall_columns", ("id", "shape", "center", "cm", "angle")),
         ("open_spans", ("a", "b")),
@@ -268,11 +275,6 @@ def _project_plan_only_space(space: dict[str, Any]) -> dict[str, Any]:
         values = []
         for item in space.get(name) or []:
             selected = _pick_fields(item, fields)
-            if name == "room_drafts" and "segments" in selected:
-                selected["segments"] = [
-                    _pick_fields(segment, ("id", "cm"))
-                    for segment in selected.get("segments") or []
-                ]
             values.append(selected)
         projected[name] = values
     if "openings" in space:
@@ -470,10 +472,9 @@ def content_manifest(config: dict[str, Any], config_root: Path) -> list[dict[str
                 # Identity is extension-neutral: a missing target must compute
                 # exactly the same expected manifest as the source.
                 "url": aid, "asset_id": aid, "storage": "internal",
-                "mime": metadata.get("mime") or {
-                    ".png": "image/png", ".jpg": "image/jpeg", ".webp": "image/webp",
-                    ".svg": "image/svg+xml",
-                }.get(blob.suffix if blob else ""),
+                "mime": metadata.get("mime") or _DECOR_ASSET_MIME_BY_SUFFIX.get(
+                    blob.suffix if blob else ""
+                ),
                 "hash": aid, "exists_at_export": exists,
             })
     return out
@@ -503,7 +504,16 @@ def create_export(
     # Read before voluptuous coercions: bool is an int subclass and must not
     # become a plausible model 1 in an otherwise valid export.
     model_version = _stored_model_version(raw_config)
-    config = CONFIG_SCHEMA(raw_config)
+    if model_version > PLAN_MODEL_VERSION:
+        raise ImportFailure("future_model", "The stored plan uses a newer data model")
+    try:
+        raw_config["model_version"] = model_version
+        config, _ = commit_wall_segment_model(raw_config)
+        config = CONFIG_SCHEMA(config)
+    except (WallSegmentMigrationError, vol.Invalid) as err:
+        code = err.code if isinstance(err, WallSegmentMigrationError) else "invalid_config"
+        raise ImportFailure(code, str(err)) from err
+    model_version = PLAN_MODEL_VERSION
     # Compatibility belongs to the envelope.  Keeping this field inside the
     # payload would either duplicate it or tempt an exporter to silently stamp
     # the current version over an older/future stored model.
@@ -568,6 +578,23 @@ def create_export(
                         and ref[len("marker:"):] not in selected_ids:
                     marker.pop("value_source", None)
                     dropped_marker_links += 1
+                # #162: a robot map routed into ANOTHER space cannot travel
+                # with a single-space export — its target would not exist on
+                # import, and a route with a dead space resolves to nothing.
+                # Same neutralisation contract as the marker refs above: drop
+                # it and count it, so the preview states the loss up front.
+                vacuum = marker.get("vacuum")
+                routes = vacuum.get("map_routes") if isinstance(vacuum, dict) else None
+                if isinstance(routes, list):
+                    kept_routes = [
+                        route for route in routes
+                        if isinstance(route, dict) and str(route.get("space")) == str(space_id)
+                    ]
+                    dropped_marker_links += len(routes) - len(kept_routes)
+                    # An explicit list is route authority even when filtering
+                    # leaves it empty. Turning [] into None would revive any
+                    # legacy calibration dictionary after import (#443).
+                    vacuum["map_routes"] = kept_routes
             config = {
                 "spaces": [_json_copy(space)],
                 "markers": _json_copy(selected_markers),
@@ -802,7 +829,11 @@ def _validate_plan_only_document(
         raise ImportFailure("invalid_format", "Plan-only placement manifest is not canonical")
     content = document.get("content_manifest")
     if not isinstance(content, list) or any(
-        not isinstance(item, dict) or item.get("owner") != "space"
+        not isinstance(item, dict)
+        or not (
+            item.get("owner") == "space"
+            or item.get("owner") == "decor" and item.get("kind") == "decor_asset"
+        )
         for item in content
     ):
         raise ImportFailure("invalid_format", "Plan-only export contains private content")
@@ -1249,7 +1280,7 @@ def build_space_merge(
         str(value)
         for sp in current_config.get("spaces") or []
         for collection in (
-            (sp,), sp.get("rooms") or [], sp.get("room_drafts") or [],
+            (sp,), sp.get("rooms") or [],
             sp.get("partitions") or [], sp.get("wall_segments") or [],
             sp.get("wall_columns") or [],
             sp.get("openings") or [], sp.get("decor") or [],
@@ -1261,18 +1292,11 @@ def build_space_merge(
     } | {
         str(m.get("id")) for m in current_config.get("markers") or []
         if m.get("id") is not None
-    } | {
-        str(segment.get("id"))
-        for sp in current_config.get("spaces") or []
-        for draft in sp.get("room_drafts") or []
-        for segment in draft.get("segments") or []
-        if isinstance(segment, dict) and segment.get("id") is not None
     } | {
         str(value)
         for incoming_space in spaces
         for collection in (
             (incoming_space,), incoming_space.get("rooms") or [],
-            incoming_space.get("room_drafts") or [],
             incoming_space.get("partitions") or [], incoming_space.get("wall_segments") or [],
             incoming_space.get("wall_columns") or [],
             incoming_space.get("openings") or [], incoming_space.get("decor") or [],
@@ -1284,12 +1308,6 @@ def build_space_merge(
     } | {
         str(m.get("id")) for m in incoming.get("markers") or []
         if m.get("id") is not None
-    } | {
-        str(segment.get("id"))
-        for incoming_space in spaces
-        for draft in incoming_space.get("room_drafts") or []
-        for segment in draft.get("segments") or []
-        if isinstance(segment, dict) and segment.get("id") is not None
     }
     old_space_id = str(space.get("id"))
     _record_bounded_lineage(
@@ -1302,7 +1320,7 @@ def build_space_merge(
     }
     id_maps["space"][old_space_id] = new_space_id
     for collection, prefix in (
-        ("rooms", "room"), ("room_drafts", "draft"), ("partitions", "partition"),
+        ("rooms", "room"), ("partitions", "partition"),
         ("wall_segments", "wall"),
         ("wall_columns", "column"), ("openings", "opening"), ("decor", "decor"),
     ):
@@ -1315,18 +1333,6 @@ def build_space_merge(
                 id_map[old] = _fresh(prefix, old, used)
                 id_maps[prefix][old] = id_map[old]
                 item["id"] = id_map[old]
-    for draft in space.get("room_drafts") or []:
-        for segment in draft.get("segments") or []:
-            if not isinstance(segment, dict) or segment.get("id") is None:
-                continue
-            old = str(segment["id"])
-            _record_bounded_lineage(
-                reference_report, bounded_seen, "draft_segment", old,
-            )
-            new = _fresh("draft_segment", old, used)
-            id_map[old] = new
-            id_maps["draft_segment"][old] = new
-            segment["id"] = new
     old_room_ids = id_maps["room"]
     for room in space.get("rooms") or []:
         if room.get("open_to"):
@@ -1569,6 +1575,7 @@ def build_space_merge(
         validate_marker_controls(merged_config, current_config)
         validate_marker_light_entities(merged_config, current_config)
         validate_marker_value_badges(merged_config, current_config)
+        validate_marker_vacuum_routes(merged_config, current_config)
         validate_opening_passages(merged_config, current_config)
         validate_partition_opening_hosts(merged_config, current_config)
     except (
@@ -1639,14 +1646,24 @@ def _content_state(document: dict[str, Any], same_source: bool, config_root: Pat
     for item in expected:
         row = dict(item)
         declared = supplied_by_id[identity(item)]
-        row["exists_at_export"] = declared.get("exists_at_export")
+        declared_exists = declared.get("exists_at_export")
+        row["exists_at_export"] = declared_exists
         if item.get("kind") == "decor_asset":
             aid = str(item.get("asset_id") or item.get("url") or "")
+            declared_mime = declared.get("mime")
+            valid_mime = (
+                isinstance(declared_mime, str)
+                and declared_mime in _DECOR_ASSET_MIME_TYPES
+            )
+            missing_mime = declared_exists is False and declared_mime is None
             if (declared.get("asset_id") != aid or declared.get("hash") != aid
-                    or declared.get("mime") not in {
-                        "image/png", "image/jpeg", "image/webp", "image/svg+xml",
-                    }):
+                    or type(declared_exists) is not bool
+                    or not (valid_mime or missing_mime)):
                 raise ImportFailure("invalid_content", "Invalid decor asset manifest row")
+            # Preserve the source description for preview/digest purposes. It
+            # never selects or serves target bytes; the exact local hash below
+            # remains authoritative for availability.
+            row["mime"] = declared_mime
             candidates = sorted((config_root / ASSETS_DIR).glob(f"{aid}.*"))
             blob = next((path for path in candidates if path.suffix in {".png", ".jpg", ".webp", ".svg"}), None)
             exists = False
@@ -1758,21 +1775,20 @@ def _materialize_import_candidate(
     if confirmation_required:
         _detach_missing(imported_config, content)
     incoming_model = int(prepared.get("model_version", 0) or 0)
-    target_model = int(current_config.get("model_version", 0) or 0)
-    requires_v8 = incoming_model >= 8 or target_model >= 8
-    if requires_v8:
-        try:
-            # A v8 target cannot be downgraded by a v7 backup, while an
-            # incoming v8 graph must retain its already-persisted IDs. When
-            # both sides are v7 the accepted compatibility contract keeps the
-            # import v7 until a later structural write or explicit Optimize.
-            imported_config["model_version"] = incoming_model
-            imported_config, _ = commit_wall_segment_model(imported_config)
-            prepared["payload"]["config"] = imported_config
-            if prepared["kind"] == "space":
-                current_config, _ = commit_wall_segment_model(current_config)
-        except WallSegmentMigrationError as err:
-            raise ImportFailure(err.code, str(err)) from err
+    migration: dict[str, int] = {}
+    try:
+        # Import preview and apply operate only on the current materialized
+        # wall model. Legacy drafts are converted before copy/remap, so no
+        # current merge path can recreate their carrier.
+        imported_config["model_version"] = incoming_model
+        imported_config, _ = commit_wall_segment_model(
+            imported_config, migration_report=migration,
+        )
+        prepared["payload"]["config"] = imported_config
+        if prepared["kind"] == "space":
+            current_config, _ = commit_wall_segment_model(current_config)
+    except WallSegmentMigrationError as err:
+        raise ImportFailure(err.code, str(err)) from err
     if prepared["kind"] == "space":
         config, layout, details = build_space_merge(
             prepared, current_config, current_layout, duplicate_policy,
@@ -1780,8 +1796,6 @@ def _materialize_import_candidate(
         )
     else:
         config = imported_config
-        if not requires_v8 and incoming_model > 0:
-            config["model_version"] = incoming_model
         _materialize_global_background(config)
         layout = _json_copy(prepared["payload"]["layout"])
         if not same_source:
@@ -1801,6 +1815,7 @@ def _materialize_import_candidate(
     except vol.Invalid as err:
         raise ImportFailure("invalid_layout", str(err)) from err
     details = _json_copy(details)
+    details["migration"] = migration
     details["counts"] = _counts(config, layout)
     return config, layout, details
 
@@ -1854,6 +1869,7 @@ def create_preview(
             validate_marker_controls(incoming_config, validate_all=True)
             validate_marker_light_entities(incoming_config, validate_all=True)
             validate_marker_value_badges(incoming_config, validate_all=True)
+            validate_marker_vacuum_routes(incoming_config, validate_all=True)
         except MarkerControlError as err:
             raise ImportFailure(err.code, str(err)) from err
     content, confirmation = _content_state(document, same_source, config_root)

custom_components/houseplan/junction_limits.py

@@ -97,7 +97,7 @@ def cm_to_units(cm: float, cell_cm: float, grid_pitch: float = GRID_STEP_N) -> f
 
 
 def limit_segments(space: dict[str, Any]) -> list[dict[str, Any]]:
-    """Every wall the limits judge: contour atoms, partitions, draft segments."""
+    """Every current wall the limits judge: contour atoms and partitions."""
     segments: list[dict[str, Any]] = []
     for segment in space.get("wall_segments") or []:
         if _finite_point(segment.get("a")) and _finite_point(segment.get("b")):
@@ -113,19 +113,6 @@ def limit_segments(space: dict[str, Any]) -> list[dict[str, Any]]:
                 "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]
 

custom_components/houseplan/manifest.json

@@ -1,6 +1,9 @@
 {
   "domain": "houseplan",
   "name": "House Plan",
+  "after_dependencies": [
+    "lovelace"
+  ],
   "codeowners": [
     "@Matysh"
   ],
@@ -16,5 +19,5 @@
   "issue_tracker": "https://github.com/Matysh/houseplan-card/issues",
   "requirements": [],
   "single_config_entry": true,
-  "version": "1.71.0-beta.1"
+  "version": "1.73.0-beta.3"
 }

custom_components/houseplan/strings.json

@@ -19,6 +19,22 @@
     "broken_plan": {
       "title": "Floor plan image is missing",
       "description": "The plan file `{file}` for space `{space}` was not found in `config/houseplan/plans/`. Open the space settings in the House Plan card and upload the plan again."
+    },
+    "frontend_reload_notice": {
+      "title": "House Plan card connected",
+      "description": "The House Plan card is connected. Fully reload this page to use the latest frontend (`Ctrl+F5` on Windows/Linux or `Cmd+Shift+R` on macOS). If you manage dashboard resources manually in storage mode, open Settings → Dashboards → Resources."
+    }
+  },
+  "system_health": {
+    "info": {
+      "card_file": "House Plan card file",
+      "static_path": "Static frontend path",
+      "resource_status": "Resource registration status",
+      "resource_loader": "Frontend resource loader",
+      "resource_url": "Frontend resource URL",
+      "resource_retry": "Resource registration retry",
+      "resource_error": "Frontend registration error",
+      "first_reload_notice": "First reload notice"
     }
   }
 }

custom_components/houseplan/support_package.py

@@ -140,6 +140,9 @@ def _global_settings(value: object) -> dict[str, Any]:
     out = _copy_keys(value, ("glow_radius_cm", "bg_color", "north_deg", "bg_mode", "sun_rays"))
     if not isinstance(value, dict):
         return out
+    show_room_tooltip = value.get("show_room_tooltip")
+    if isinstance(show_room_tooltip, bool):
+        out["show_room_tooltip"] = show_room_tooltip
     fill_colors = value.get("fill_colors")
     if isinstance(fill_colors, dict):
         out["fill_colors"] = {
@@ -322,21 +325,6 @@ def _project_space(ids: _Pseudonyms, space: dict[str, Any], index: int) -> dict[
         }
         for item in space.get("walls") or [] if isinstance(item, dict)
     ]
-    out["room_drafts"] = []
-    for draft in space.get("room_drafts") or []:
-        if not isinstance(draft, dict):
-            continue
-        out["room_drafts"].append({
-            "id": ids.get("draft", draft.get("id")),
-            "points": _points(draft.get("points")),
-            "segments": [
-                {
-                    **({"id": ids.get("wall", segment.get("id"))} if segment.get("id") else {}),
-                    "cm": segment.get("cm"),
-                }
-                for segment in draft.get("segments") or [] if isinstance(segment, dict)
-            ],
-        })
     out["partitions"] = [
         {"id": ids.get("partition", item.get("id")), "a": _point(item.get("a")),
          "b": _point(item.get("b")), "cm": item.get("cm")}
@@ -426,7 +414,6 @@ def _summary(config: object, layout: object) -> dict[str, Any]:
     return {
         "spaces": len(spaces),
         "rooms": sum(len(space.get("rooms") or []) for space in spaces if isinstance(space, dict)),
-        "room_drafts": sum(len(space.get("room_drafts") or []) for space in spaces if isinstance(space, dict)),
         "walls": sum(len(space.get("wall_segments") or space.get("walls") or []) for space in spaces if isinstance(space, dict)),
         "partitions": sum(len(space.get("partitions") or []) for space in spaces if isinstance(space, dict)),
         "columns": sum(len(space.get("wall_columns") or []) for space in spaces if isinstance(space, dict)),

custom_components/houseplan/system_health.py

@@ -6,6 +6,7 @@ from typing import Any
 from homeassistant.components import system_health
 from homeassistant.core import HomeAssistant, callback
 
+from .frontend_registration import get_frontend_registration_state
 from .store import get_data
 
 
@@ -23,13 +24,51 @@ async def system_health_info(hass: HomeAssistant) -> dict[str, Any]:
     cfg_raw = await data.config_store.async_load() or {}
     layout_raw = await data.store.async_load() or {}
     config = cfg_raw.get("config", {})
-    return {
+    result = {
         "config_rev": cfg_raw.get("rev", 0),
         "spaces": len(config.get("spaces", [])),
         "rooms": sum(len(s.get("rooms", [])) for s in config.get("spaces", [])),
-        "room_drafts": sum(len(s.get("room_drafts", [])) for s in config.get("spaces", [])),
         "partitions": sum(len(s.get("partitions", [])) for s in config.get("spaces", [])),
         "wall_columns": sum(len(s.get("wall_columns", [])) for s in config.get("spaces", [])),
         "markers": len(config.get("markers", [])),
         "layout_entries": len(layout_raw.get("layout", {})),
     }
+    frontend = get_frontend_registration_state(hass)
+    if frontend is None:
+        result.update(
+            {
+                "card_file": "missing",
+                "static_path": "not_registered",
+                "resource_status": "not_attempted",
+                "resource_loader": "none",
+                "resource_url": "unavailable",
+                "resource_retry": "not_needed",
+                "resource_error": "none",
+                "first_reload_notice": "pending_frontend",
+            }
+        )
+        return result
+
+    result.update(
+        {
+            "card_file": "present" if frontend.card_file_present else "missing",
+            "static_path": (
+                "registered"
+                if frontend.static_path_registered
+                else "not_registered"
+            ),
+            "resource_status": frontend.resource_status,
+            "resource_loader": frontend.loader,
+            "resource_url": frontend.module_url or "unavailable",
+            "resource_retry": (
+                "pending"
+                if frontend.retry_pending
+                else "attempted"
+                if frontend.retry_attempted
+                else "not_needed"
+            ),
+            "resource_error": frontend.last_error or "none",
+            "first_reload_notice": frontend.first_reload_notice,
+        }
+    )
+    return result

custom_components/houseplan/trails.py

@@ -21,6 +21,7 @@ from homeassistant.helpers.event import async_call_later, async_track_state_chan
 from homeassistant.helpers.storage import Store
 
 from .const import DOMAIN
+from .vacuum_routes import effective_routes
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -31,14 +32,31 @@ 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:
+def same_run_identity(run: Any, route_id: str, map_id: str) -> bool:
+    """Whether a stored run and a fresh point belong to the same cleanup.
+
+    Route identity wins when both sides have one: two maps of one robot may
+    share a map id only across different sources, and a route change (new
+    source, map or target space) is a new run by definition (#162). A run
+    written before #162 carries no route id, so it is still matched by map id
+    and keeps resuming exactly as it used to.
+    """
+    if not isinstance(run, dict):
+        return False
+    stored_route = run.get("route_id")
+    if route_id and isinstance(stored_route, str) and stored_route:
+        return stored_route == route_id
+    return run.get("map_id") == map_id
+
+
+def can_resume_trail_run(run: Any, map_id: str, now: float, route_id: str = "") -> 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:
+    if not same_run_identity(run, route_id, map_id):
         return False
     ended = run.get("ended")
     if (
@@ -84,18 +102,27 @@ class TrailBook:
     def __init__(self, data: dict[str, Any] | None = None) -> None:
         self.data: dict[str, Any] = data if isinstance(data, dict) else {}
 
-    def on_point(self, marker: str, map_id: str, x: float, y: float, now: float) -> bool:
+    def on_point(
+        self, marker: str, map_id: str, x: float, y: float, now: float,
+        route_id: str = "", source: str = "",
+    ) -> bool:
         rec = self.data.setdefault(marker, {})
         cur = rec.get("current")
-        resumed = bool(cur and can_resume_trail_run(cur, map_id, now))
+        resumed = bool(cur and can_resume_trail_run(cur, map_id, now, route_id))
         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") is not None or not same_run_identity(cur, route_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:
                 rec["previous"] = cur
             cur = {"map_id": map_id, "started": now, "ended": None, "points": []}
+            # #162: the run remembers WHICH route wrote it, so the card can put
+            # it on the right floor without re-deriving the routing itself.
+            if route_id:
+                cur["route_id"] = route_id
+            if source:
+                cur["source"] = source
             rec["current"] = cur
         pts: list[list[float]] = cur["points"]
         if pts and pts[-1][0] == x and pts[-1][1] == y:
@@ -122,11 +149,33 @@ class TrailBook:
         """Forget every stored run of one plan marker."""
         return self.data.pop(marker, None) is not None
 
+    def drop_unknown_routes(self, marker: str, route_ids: set[str]) -> bool:
+        """Forget runs whose route no longer exists (deleted or re-targeted).
+
+        Only runs that name a route are touched. A pre-#162 run names none and
+        is adopted by the card instead — deleting it here would destroy history
+        the user can still legitimately see.
+        """
+        rec = self.data.get(marker)
+        if not isinstance(rec, dict):
+            return False
+        changed = False
+        for slot in ("current", "previous"):
+            run = rec.get(slot)
+            if not isinstance(run, dict):
+                continue
+            stored = run.get("route_id")
+            if isinstance(stored, str) and stored and stored not in route_ids:
+                rec.pop(slot)
+                changed = True
+        return changed
+
 
 class TrailRecorder:
     """HA wiring: watch the tracked entities, feed the book, persist, notify."""
 
     def __init__(self, hass: HomeAssistant, rt: Any) -> None:
+        self.routes_by_marker: dict[str, list[dict[str, Any]]] = {}
         self.hass = hass
         self.rt = rt
         self.store = Store(hass, 1, f"{DOMAIN}.trails")
@@ -166,22 +215,35 @@ class TrailRecorder:
             cfg = stored.get("config") or {}
             pairs: dict[str, list[tuple[str, str]]] = {}
             health_pairs: set[tuple[str, str]] = set()
+            routes_by_marker: dict[str, list[dict[str, Any]]] = {}
             for m in cfg.get("markers") or []:
                 if m.get("removed") is True:
                     continue
                 v = m.get("vacuum") or {}
                 src = v.get("source")
-                if not src or v.get("live") is False:
+                if v.get("live") is False:
                     continue
                 marker_id = str(m.get("id"))
-                health_pairs.add((marker_id, str(src)))
+                # #162: a multi-floor robot may publish each map through its own
+                # camera, so every route source is watched — not only the root
+                # discovery source, which is now just one of them.
+                routes = effective_routes(marker_id, v, str(m.get("space") or ""), src)
+                routes_by_marker[marker_id] = routes
+                sources = {str(route["source"]) for route in routes if route.get("source")}
+                if src:
+                    sources.add(str(src))
+                if not sources:
+                    continue
                 vac = self._vacuum_entity(m)
-                if vac:
-                    # HP-1540-03: append, never overwrite — every floor's
-                    # marker records its own copy of the run
-                    pairs.setdefault(src, []).append((marker_id, vac))
+                for source in sorted(sources):
+                    health_pairs.add((marker_id, source))
+                    if vac:
+                        # HP-1540-03: append, never overwrite — every floor's
+                        # marker records its own copy of the run
+                        pairs.setdefault(source, []).append((marker_id, vac))
             self._refresh_source_health(health_pairs)
             self.pairs = pairs
+            self.routes_by_marker = routes_by_marker
             self._resubscribe()
             # A run already in progress (HA restarted mid-cleanup, or the user
             # just finished calibrating) must start recording NOW, not at the
@@ -261,6 +323,17 @@ class TrailRecorder:
             for marker in config.get("markers") or []
             if marker.get("id") is not None and marker.get("removed") is not True
         }
+        # #162: a route that vanished (deleted, or re-targeted to another
+        # space, which is a new identity) takes its own runs with it, while the
+        # marker and its other routes stay untouched.
+        for marker in config.get("markers") or []:
+            marker_id = str(marker.get("id"))
+            if marker.get("removed") is True or marker_id not in self.book.data:
+                continue
+            vacuum = marker.get("vacuum") or {}
+            routes = effective_routes(
+                marker_id, vacuum, str(marker.get("space") or ""), vacuum.get("source"))
+            self.book.drop_unknown_routes(marker_id, {str(r.get("id")) for r in routes})
         orphan_ids = set(self.book.data) - live_marker_ids
         if not orphan_ids:
             return 0
@@ -381,9 +454,26 @@ class TrailRecorder:
             except (TypeError, ValueError):
                 continue
             map_id = resolve_map_id(attrs, st_vac.attributes)
-            changed |= self.book.on_point(marker, map_id, x, y, now)
+            route_id = self._route_id(marker, src, map_id)
+            changed |= self.book.on_point(
+                marker, map_id, x, y, now, route_id=route_id,
+                source=src if route_id else "",
+            )
         return changed
 
+    def _route_id(self, marker: str, source: str, map_id: str) -> str:
+        """The route this point belongs to, or "" when routing cannot say.
+
+        Validation keeps (source, map_id) unique inside one marker, so at most
+        one route can match. No match means the map is unmapped: the point is
+        still recorded — raw history is valuable — but it is not filed under a
+        route that does not own it.
+        """
+        for route in getattr(self, "routes_by_marker", {}).get(marker) or ():
+            if route.get("source") == source and route.get("map_id") == map_id:
+                return str(route.get("id") or "")
+        return ""
+
     @callback
     def _on_state(self, event: Any) -> None:
         eid = event.data.get("entity_id")

custom_components/houseplan/translations/de.json

@@ -25,6 +25,22 @@
     "broken_plan": {
       "title": "Grundrissbild fehlt",
       "description": "Die Plandatei `{file}` für den Bereich `{space}` wurde in `config/houseplan/plans/` nicht gefunden. In den Bereichseinstellungen der House-Plan-Karte den Plan erneut hochladen."
+    },
+    "frontend_reload_notice": {
+      "title": "House-Plan-Karte verbunden",
+      "description": "Die House-Plan-Karte ist verbunden. Laden Sie diese Seite vollständig neu, um die aktuelle Benutzeroberfläche zu verwenden (`Ctrl+F5` unter Windows/Linux oder `Cmd+Shift+R` unter macOS). Wenn Sie Dashboard-Ressourcen im Speichermodus manuell verwalten, öffnen Sie Einstellungen → Dashboards → Ressourcen."
+    }
+  },
+  "system_health": {
+    "info": {
+      "card_file": "Datei der House-Plan-Karte",
+      "static_path": "Statischer Frontend-Pfad",
+      "resource_status": "Status der Ressourcenregistrierung",
+      "resource_loader": "Lademethode der Frontend-Ressource",
+      "resource_url": "URL der Frontend-Ressource",
+      "resource_retry": "Wiederholung der Ressourcenregistrierung",
+      "resource_error": "Fehler der Frontend-Registrierung",
+      "first_reload_notice": "Erster Hinweis zum Neuladen"
     }
   }
 }

custom_components/houseplan/translations/en.json

@@ -25,6 +25,22 @@
     "broken_plan": {
       "title": "Floor plan image is missing",
       "description": "The plan file `{file}` for space `{space}` was not found in `config/houseplan/plans/`. Open the space settings in the House Plan card and upload the plan again."
+    },
+    "frontend_reload_notice": {
+      "title": "House Plan card connected",
+      "description": "The House Plan card is connected. Fully reload this page to use the latest frontend (`Ctrl+F5` on Windows/Linux or `Cmd+Shift+R` on macOS). If you manage dashboard resources manually in storage mode, open Settings → Dashboards → Resources."
+    }
+  },
+  "system_health": {
+    "info": {
+      "card_file": "House Plan card file",
+      "static_path": "Static frontend path",
+      "resource_status": "Resource registration status",
+      "resource_loader": "Frontend resource loader",
+      "resource_url": "Frontend resource URL",
+      "resource_retry": "Resource registration retry",
+      "resource_error": "Frontend registration error",
+      "first_reload_notice": "First reload notice"
     }
   }
 }

custom_components/houseplan/translations/fr.json

@@ -25,6 +25,22 @@
     "broken_plan": {
       "title": "L’image du plan est introuvable",
       "description": "Le fichier de plan `{file}` pour l’espace `{space}` est introuvable dans `config/houseplan/plans/`. Ouvrez les paramètres de l’espace dans la carte House Plan et téléversez de nouveau le plan."
+    },
+    "frontend_reload_notice": {
+      "title": "Carte House Plan connectée",
+      "description": "La carte House Plan est connectée. Rechargez complètement cette page pour utiliser l’interface la plus récente (`Ctrl+F5` sous Windows/Linux ou `Cmd+Shift+R` sous macOS). Si vous gérez manuellement les ressources du tableau de bord en mode stockage, ouvrez Paramètres → Tableaux de bord → Ressources."
+    }
+  },
+  "system_health": {
+    "info": {
+      "card_file": "Fichier de la carte House Plan",
+      "static_path": "Chemin statique de l’interface",
+      "resource_status": "État de l’enregistrement de la ressource",
+      "resource_loader": "Mode de chargement de la ressource",
+      "resource_url": "URL de la ressource de l’interface",
+      "resource_retry": "Nouvelle tentative d’enregistrement",
+      "resource_error": "Erreur d’enregistrement de l’interface",
+      "first_reload_notice": "Premier avis de rechargement"
     }
   }
 }

custom_components/houseplan/translations/ru.json

@@ -25,6 +25,22 @@
     "broken_plan": {
       "title": "Файл плана этажа не найден",
       "description": "Файл плана `{file}` пространства `{space}` не найден в `config/houseplan/plans/`. Откройте настройки пространства в карточке House Plan и загрузите план заново."
+    },
+    "frontend_reload_notice": {
+      "title": "Карточка House Plan подключена",
+      "description": "Карточка House Plan подключена. Полностью перезагрузите эту страницу, чтобы использовать актуальный интерфейс (`Ctrl+F5` в Windows/Linux или `Cmd+Shift+R` в macOS). Если вы вручную управляете ресурсами панели в режиме хранения, откройте Настройки → Панели → Ресурсы."
+    }
+  },
+  "system_health": {
+    "info": {
+      "card_file": "Файл карточки House Plan",
+      "static_path": "Статический путь интерфейса",
+      "resource_status": "Статус регистрации ресурса",
+      "resource_loader": "Способ загрузки ресурса",
+      "resource_url": "URL ресурса интерфейса",
+      "resource_retry": "Повтор регистрации ресурса",
+      "resource_error": "Ошибка регистрации интерфейса",
+      "first_reload_notice": "Первое уведомление о перезагрузке"
     }
   }
 }

custom_components/houseplan/vacuum_routes.py

@@ -0,0 +1,212 @@
+"""Map-to-space routing for multi-floor vacuums (#162).
+
+Python mirror of ``src/vacuum-routes.ts``. The recorder and the import/export
+flows must answer "which floor is this map on?" exactly the way the card does,
+so both sides are driven by the same shared fixtures in
+``test/fixtures/vacuum-routes/``. Keep the two files in step: a divergence here
+shows up as a robot drawn on the wrong floor, which is worse than no robot.
+"""
+from __future__ import annotations
+
+import re
+from typing import Any
+
+VAC_ROUTE_LIMIT = 32
+VAC_ROUTE_ID_MAX = 128
+VAC_ROUTE_SOURCE_MAX = 255
+VAC_ROUTE_MAP_ID_MAX = 255
+VAC_ROUTE_ERROR = "invalid_vacuum_map_route"
+
+_ENTITY_ID = re.compile(r"^[a-z_]+\.[a-zA-Z0-9_]+$")
+
+
+def normalize_route_matrix(raw: Any) -> list[float] | None:
+    """Six finite numbers, or nothing; a five-number matrix is not almost fine."""
+    if not isinstance(raw, (list, tuple)) or len(raw) != 6:
+        return None
+    out: list[float] = []
+    for value in raw:
+        # bool is an int in Python; a boolean is not a coordinate.
+        if isinstance(value, bool) or not isinstance(value, (int, float)):
+            return None
+        number = float(value)
+        if number != number or number in (float("inf"), float("-inf")):
+            return None
+        out.append(number)
+    return out
+
+
+def is_entity_id_like(value: Any) -> bool:
+    return isinstance(value, str) and bool(_ENTITY_ID.match(value))
+
+
+def validate_marker_routes(
+    marker_id: str, routes: Any, space_ids: set[str] | None,
+) -> list[dict[str, str]]:
+    """Shape/uniqueness/reference issues for one marker's routes.
+
+    ``space_ids`` None means the spaces are not known in this context (import
+    preview), so the referential check is skipped instead of failing every
+    route.
+    """
+    if routes is None:
+        return []
+
+    def issue(route_id: str, reason: str) -> dict[str, str]:
+        return {
+            "code": VAC_ROUTE_ERROR, "markerId": marker_id,
+            "routeId": route_id, "reason": reason,
+        }
+
+    if not isinstance(routes, list):
+        return [issue("", "not_object")]
+    problems: list[dict[str, str]] = []
+    if len(routes) > VAC_ROUTE_LIMIT:
+        problems.append(issue("", "limit"))
+    seen_ids: set[str] = set()
+    seen_identity: set[str] = set()
+    for raw in routes:
+        if not isinstance(raw, dict):
+            problems.append(issue("", "not_object"))
+            continue
+        route_id = raw.get("id") if isinstance(raw.get("id"), str) else ""
+        if not route_id or len(route_id) > VAC_ROUTE_ID_MAX:
+            problems.append(issue(route_id or "", "id"))
+            continue
+        if route_id in seen_ids:
+            problems.append(issue(route_id, "duplicate_id"))
+        seen_ids.add(route_id)
+        source = raw.get("source")
+        if not is_entity_id_like(source) or len(source) > VAC_ROUTE_SOURCE_MAX:
+            problems.append(issue(route_id, "source"))
+        map_id = raw.get("map_id")
+        # An empty map id is a real id (resolve_map_id): type and length only.
+        if not isinstance(map_id, str) or len(map_id) > VAC_ROUTE_MAP_ID_MAX:
+            problems.append(issue(route_id, "map_id"))
+        space = raw.get("space")
+        if not isinstance(space, str) or not space:
+            problems.append(issue(route_id, "space"))
+        elif space_ids is not None and space not in space_ids:
+            problems.append(issue(route_id, "unknown_space"))
+        calibration = raw.get("calibration")
+        if calibration is not None and normalize_route_matrix(calibration) is None:
+            problems.append(issue(route_id, "calibration"))
+        if isinstance(source, str) and isinstance(map_id, str):
+            identity = source + " " + map_id
+            if identity in seen_identity:
+                problems.append(issue(route_id, "duplicate_identity"))
+            seen_identity.add(identity)
+    return problems
+
+
+def legacy_route_id(marker_id: str, source: str, map_id: str) -> str:
+    return "legacy:" + marker_id + " " + source + " " + map_id
+
+
+def effective_routes(
+    marker_id: str, vacuum: Any, dock_space: str, discovered_source: str | None = None,
+) -> list[dict[str, Any]]:
+    """The routes a marker effectively has, legacy calibration included."""
+    if not isinstance(vacuum, dict):
+        return []
+    explicit = vacuum.get("map_routes")
+    if isinstance(explicit, list):
+        out = []
+        for route in explicit:
+            if not isinstance(route, dict) or not isinstance(route.get("id"), str):
+                continue
+            if not route["id"]:
+                continue
+            out.append({
+                "id": route["id"],
+                "source": str(route.get("source") or ""),
+                "map_id": str(route.get("map_id") or ""),
+                "space": str(route.get("space") or ""),
+                "calibration": normalize_route_matrix(route.get("calibration")),
+            })
+        return out
+    source = vacuum.get("source")
+    if not isinstance(source, str) or not source:
+        source = discovered_source or ""
+    if not source:
+        return []
+    calibration = vacuum.get("calibration")
+    if not isinstance(calibration, dict):
+        return []
+    out = []
+    for map_id, matrix in calibration.items():
+        normalized = normalize_route_matrix(matrix)
+        if normalized is None:
+            continue
+        out.append({
+            "id": legacy_route_id(marker_id, source, str(map_id)),
+            "source": source, "map_id": str(map_id), "space": dock_space,
+            "calibration": normalized,
+        })
+    return out
+
+
+def resolve_route(
+    routes: list[dict[str, Any]], observed: dict[str, str], space_ids: set[str] | None,
+) -> dict[str, Any]:
+    """Pick the one route the robot is on right now — or refuse to pick.
+
+    List order must never decide a floor: two plausible routes are ambiguous,
+    not "the first one".
+    """
+    matched: list[dict[str, Any]] = []
+    saw_telemetry = False
+    fallback_source = ""
+    fallback_map_id = ""
+    for route in routes:
+        source = route.get("source")
+        if source not in observed:
+            continue
+        seen = observed[source]
+        saw_telemetry = True
+        if not fallback_source:
+            fallback_source = source
+            fallback_map_id = seen
+        if seen == route.get("map_id"):
+            matched.append(route)
+    if len(matched) > 1:
+        return {"kind": "ambiguous", "routeIds": sorted(str(r.get("id")) for r in matched)}
+    if len(matched) == 1:
+        route = matched[0]
+        if space_ids is not None and route.get("space") not in space_ids:
+            return {"kind": "missing_space", "route": route}
+        matrix = normalize_route_matrix(route.get("calibration"))
+        if matrix is None:
+            return {"kind": "needs_calibration", "route": route}
+        return {"kind": "ready", "route": {**route, "calibration": matrix}}
+    if saw_telemetry:
+        return {"kind": "unmapped", "source": fallback_source, "mapId": fallback_map_id}
+    if observed:
+        source = sorted(observed)[0]
+        return {"kind": "unmapped", "source": source, "mapId": observed[source]}
+    return {"kind": "none"}
+
+
+def adopt_legacy_run(
+    run: Any, routes: list[dict[str, Any]], root_source: str | None,
+) -> dict[str, Any]:
+    """Where a run recorded before #162 belongs (spec 11.3.1).
+
+    Such a run stores only ``{map_id, started, ended, points}``: it carries no
+    source at all. The one surviving witness of the subscription that wrote it
+    is the marker's root ``vacuum.source``, so that is what narrows the
+    candidates; without it only the map id is compared. Two candidates mean the
+    run is not drawn — not that the first one wins.
+    """
+    if not isinstance(run, dict) or not isinstance(run.get("map_id"), str):
+        return {"kind": "orphan_run"}
+    map_id = run["map_id"]
+    root = root_source if isinstance(root_source, str) else ""
+    candidates = [route for route in routes if route.get("map_id") == map_id]
+    if root:
+        candidates = [route for route in candidates if route.get("source") == root]
+    if len(candidates) == 1:
+        return {"kind": "adopted", "route": candidates[0]}
+    if not candidates:
+        return {"kind": "orphan_run"}
+    return {"kind": "ambiguous_run", "routeIds": sorted(str(r.get("id")) for r in candidates)}

custom_components/houseplan/validation.py

@@ -17,6 +17,7 @@ from custom_components.houseplan.coordinate_canonicalization import (
     canonicalize_layout_geometry,
     canonicalize_position,
 )
+from custom_components.houseplan.vacuum_routes import validate_marker_routes
 
 # ---------- limits and extension sets ----------
 PLAN_EXTENSIONS = {"svg": "image/svg+xml", "png": "image/png", "jpg": "image/jpeg", "webp": "image/webp"}
@@ -179,6 +180,17 @@ def validate_wall_model_transition(config: dict, previous: dict | None) -> None:
     except (TypeError, ValueError):
         return  # CONFIG_SCHEMA owns malformed values.
     previous = previous or {}
+    if old_model >= 10 and new_model < 10 and any(
+        "room_drafts" in space for space in config.get("spaces") or []
+        if isinstance(space, dict)
+    ):
+        # A v9 card can echo a cached draft without changing the contour
+        # projection at all. The old catalogue guard therefore cannot see the
+        # destructive downgrade, but v10 must never persist the removed
+        # carrier again (#478 AC2).
+        raise WallModelClientOutdatedError(
+            f"stored model={old_model}; submitted legacy room_drafts model={new_model}"
+        )
     contour_geometry_changed = (
         _catalog_coupled_wall_geometry_projection(config)
         != _catalog_coupled_wall_geometry_projection(previous)
@@ -882,6 +894,50 @@ def validate_marker_value_badges(
             validate_source(source, "value_source")
 
 
+def validate_marker_vacuum_routes(
+    config: dict, previous: dict | None = None, *, validate_all: bool = False
+) -> None:
+    """Validate changed vacuum map routes; dormant future data round-trips.
+
+    Change-aware like the badge validator above (#162): an untouched legacy or
+    future-shaped block must not block an unrelated save, but any edit to
+    routing has to leave the marker in a state the resolver can answer for —
+    unique identities, six-number matrices and target spaces that exist.
+    """
+    markers = config.get("markers") or []
+    spaces = config.get("spaces")
+    space_ids = None
+    if isinstance(spaces, list):
+        space_ids = {
+            str(space.get("id")) for space in spaces
+            if isinstance(space, dict) and isinstance(space.get("id"), str)
+        }
+    old_markers = (previous or {}).get("markers") or []
+    old_by_id = {str(marker.get("id")): marker for marker in old_markers}
+    by_id = {str(marker.get("id")): marker for marker in markers}
+    new_ids = set(by_id)
+    consumed_old_ids: set[str] = set()
+    for marker_id, marker in by_id.items():
+        old_marker = _matching_previous_marker(
+            marker, marker_id, old_by_id, old_markers, new_ids,
+            consumed_old_ids, validate_all,
+        )
+        routes = (marker.get("vacuum") or {}).get("map_routes")
+        old_routes = None if validate_all else ((old_marker or {}).get("vacuum") or {}).get("map_routes")
+        if not validate_all and routes == old_routes:
+            continue
+        problems = validate_marker_routes(marker_id, routes, space_ids)
+        if problems:
+            reasons = ", ".join(sorted({problem["reason"] for problem in problems}))
+            # Literal, not the constant: the #42 scanner proves the emitted
+            # code against ERROR_CODES by reading the source, and it cannot
+            # follow a name. The pair is pinned by a test below.
+            raise MarkerControlError(
+                "invalid_vacuum_map_route",
+                f"Invalid vacuum map routes on {marker_id}: {reasons}",
+            )
+
+
 def validate_marker_light_entities(
     config: dict, previous: dict | None = None, *, validate_all: bool = False
 ) -> None:
@@ -1069,8 +1125,8 @@ MAX_DECOR = 1000
 # later constant declaration.
 MAX_WALLS = 200_000
 MAX_WALL_SEGMENTS = 200_000
-MAX_ROOM_DRAFTS = 200
-MAX_DRAFT_SEGMENTS = 2000
+_LEGACY_MAX_ROOM_DRAFTS = 200
+_LEGACY_MAX_DRAFT_SEGMENTS = 2000
 MAX_PARTITIONS = 2000
 MAX_WALL_COLUMNS = 500
 # Open (virtual) wall stretches, docs/superpowers/specs/2026-08-05-open-spans-delete-design.md.
@@ -1439,7 +1495,7 @@ WALL_SEGMENT_SCHEMA = vol.All(
 )
 
 
-def _room_draft_segments(value: dict) -> dict:
+def _legacy_room_draft_segments(value: dict) -> dict:
     """An open draft has exactly one thickness per consecutive edge."""
     if len(value.get("segments", [])) != max(0, len(value.get("points", [])) - 1):
         raise vol.Invalid("room draft segments must match consecutive point pairs")
@@ -1448,7 +1504,7 @@ def _room_draft_segments(value: dict) -> dict:
     return value
 
 
-ROOM_DRAFT_SCHEMA = vol.All(
+_LEGACY_ROOM_DRAFT_SCHEMA = vol.All(
     vol.Schema(
         {
             vol.Required("id"): vol.All(str, vol.Length(min=1, max=64)),
@@ -1464,7 +1520,7 @@ ROOM_DRAFT_SCHEMA = vol.All(
         },
         extra=vol.ALLOW_EXTRA,
     ),
-    _room_draft_segments,
+    _legacy_room_draft_segments,
 )
 
 def _partition_nonzero(value: dict) -> dict:
@@ -1547,7 +1603,7 @@ def _space_geometry_invariants(value: dict) -> dict:
     draft_segments = sum(
         len(item.get("segments", [])) for item in value.get("room_drafts", [])
     )
-    if draft_segments > MAX_DRAFT_SEGMENTS:
+    if draft_segments > _LEGACY_MAX_DRAFT_SEGMENTS:
         raise vol.Invalid("too many saved room-draft segments")
     for draft in value.get("room_drafts", []):
         for segment in draft.get("segments", []):
@@ -1661,7 +1717,7 @@ SPACE_SCHEMA = vol.All(vol.Schema(
         ),
         vol.Optional("zero_wall_style"): vol.In(["dashed", "solid"]),
         vol.Optional("room_drafts"): vol.All(
-            [ROOM_DRAFT_SCHEMA], vol.Length(max=MAX_ROOM_DRAFTS)
+            [_LEGACY_ROOM_DRAFT_SCHEMA], vol.Length(max=_LEGACY_MAX_ROOM_DRAFTS)
         ),
         vol.Optional("partitions"): vol.All(
             [PARTITION_SCHEMA], vol.Length(max=MAX_PARTITIONS)
@@ -1729,6 +1785,22 @@ MARKER_SCHEMA = vol.Schema(
                     {str: vol.All([_finite], vol.Length(min=6, max=6))}
                 ),
                 vol.Optional("segment_map"): vol.Schema({str: str}),
+                # #162: canonical map -> space routing. The schema checks the
+                # shape only; identity uniqueness and the referential space
+                # check live in validate_marker_vacuum_routes, which is
+                # change-aware and must not reject untouched legacy data.
+                vol.Optional("map_routes"): vol.Any(
+                    None,
+                    vol.All([vol.Schema({
+                        vol.Required("id"): vol.All(str, vol.Length(min=1, max=128)),
+                        vol.Required("source"): vol.All(str, vol.Length(min=1, max=255)),
+                        vol.Required("map_id"): vol.All(str, vol.Length(max=255)),
+                        vol.Required("space"): vol.All(str, vol.Length(min=1, max=64)),
+                        vol.Optional("calibration"): vol.Any(
+                            None, vol.All([_finite], vol.Length(min=6, max=6)),
+                        ),
+                    }, extra=vol.ALLOW_EXTRA)], vol.Length(max=32)),
+                ),
             }),
         ),
         vol.Optional("controls"): vol.Any(None, vol.All([_TEXT], vol.Length(max=MAX_CONTROLS))),
@@ -1816,6 +1888,8 @@ def _config_wall_segment_invariants(value: dict) -> dict:
         if model >= 9:
             if "open_spans" in space or any("open_to" in room for room in space.get("rooms", [])):
                 raise vol.Invalid("v9 config must not contain legacy open boundaries")
+        if model >= 10 and "room_drafts" in space:
+            raise vol.Invalid("v10 config must not contain room_drafts")
         segments = space.get("wall_segments")
         if segments is None:
             raise vol.Invalid("v8+ space requires wall_segments")
@@ -1856,9 +1930,10 @@ def _config_wall_segment_invariants(value: dict) -> dict:
         if actual_walls != expected_walls:
             raise vol.Invalid("wall compatibility projection must match wall_segments")
 
-        for draft in space.get("room_drafts", []):
-            if any(not segment.get("id") for segment in draft.get("segments", [])):
-                raise vol.Invalid("v8+ draft wall segments require ids")
+        if model < 10:
+            for draft in space.get("room_drafts", []):
+                if any(not segment.get("id") for segment in draft.get("segments", [])):
+                    raise vol.Invalid("v8+ draft wall segments require ids")
 
         partitions = {item["id"]: item for item in space.get("partitions", [])}
         wall_opening_intervals: dict[str, list[tuple[float, float]]] = {}
@@ -1935,6 +2010,7 @@ CONFIG_SCHEMA = vol.All(
                     vol.Optional("north_deg"): _north_deg,
                     vol.Optional("bg_mode"): _BG_MODE,
                     vol.Optional("sun_rays"): bool,
+                    vol.Optional("show_room_tooltip"): bool,
                     # Removed from the UI/runtime in 2026-08-08. Keep accepting the
                     # legacy field so an existing stored config can still load; the
                     # frontend ignores it and removes it on the next settings save.

custom_components/houseplan/wall_segment_model.py

@@ -1,4 +1,4 @@
-"""Deterministic persisted contour-wall identity (model v9, issues #282/#306).
+"""Deterministic persisted contour-wall identity (model v10, issues #282/#478).
 
 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
@@ -10,14 +10,17 @@ import base64
 import copy
 import hashlib
 import math
+import re
 import uuid
 from typing import Any
 
 from .coordinate_canonicalization import canonicalize_config_geometry
 
-WALL_SEGMENT_MODEL_VERSION = 9
+WALL_SEGMENT_MODEL_VERSION = 10
 GRID_STEP_N = 1 / 240
 EPS = 1e-9
+LEGACY_DRAFT_POINT_EPSILON = 0.001
+_LEGACY_NUMBER = re.compile(r"^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$")
 
 
 class WallSegmentMigrationError(ValueError):
@@ -30,6 +33,29 @@ class WallSegmentMigrationError(ValueError):
         super().__init__(f"{reason}: {detail}" if detail else reason)
 
 
+def _legacy_finite_number(value: Any) -> float | None:
+    if isinstance(value, bool) or not isinstance(value, (int, float, str)):
+        return None
+    if isinstance(value, str) and not _LEGACY_NUMBER.fullmatch(value.strip()):
+        return None
+    try:
+        parsed = float(value)
+    except (TypeError, ValueError):
+        return None
+    return parsed if math.isfinite(parsed) else None
+
+
+def _legacy_draft_point(value: Any) -> list[float] | None:
+    if not isinstance(value, list) or len(value) < 2:
+        return None
+    x, y = _legacy_finite_number(value[0]), _legacy_finite_number(value[1])
+    return None if x is None or y is None else [x, y]
+
+
+def _legacy_identity(value: Any) -> str:
+    return value if isinstance(value, str) else ""
+
+
 def _point_key(point: list[float]) -> str:
     return f"{float(point[0]):.12f},{float(point[1]):.12f}"
 
@@ -618,7 +644,74 @@ def _host_openings(
             opening.pop("host", None)
 
 
-def _migrate_space(space: dict[str, Any], initial_migration: bool) -> int:
+def _migrate_room_drafts_to_partitions(
+    space: dict[str, Any], initial_migration: bool,
+) -> tuple[int, int]:
+    if "room_drafts" not in space:
+        return 0, 0
+    if not initial_migration:
+        raise WallSegmentMigrationError("duplicate-id", "model v10 must not contain room_drafts")
+    drafts = space.get("room_drafts") or []
+    used = {
+        str(item["id"])
+        for name in ("rooms", "openings", "decor", "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"]
+    }
+    used.update(
+        str(draft["id"]) for draft in drafts
+        if isinstance(draft, dict) and isinstance(draft.get("id"), str) and draft["id"]
+    )
+    partitions = copy.deepcopy(space.get("partitions") or [])
+    converted = 0
+    for draft in drafts:
+        draft_identity = _legacy_identity(draft.get("id")) if isinstance(draft, dict) else ""
+        if not isinstance(draft, dict):
+            raise WallSegmentMigrationError("zero-length", draft_identity)
+        points = draft.get("points") if isinstance(draft.get("points"), list) else []
+        segments = draft.get("segments") if isinstance(draft.get("segments"), list) else []
+        if len(points) < 2 or len(segments) != len(points) - 1:
+            raise WallSegmentMigrationError("zero-length", draft_identity)
+        for index, segment in enumerate(segments):
+            a = _legacy_draft_point(points[index])
+            b = _legacy_draft_point(points[index + 1])
+            if a is None or b is None or (
+                abs(a[0] - b[0]) < LEGACY_DRAFT_POINT_EPSILON
+                and abs(a[1] - b[1]) < LEGACY_DRAFT_POINT_EPSILON
+            ):
+                raise WallSegmentMigrationError("zero-length", draft_identity)
+            cm = _legacy_finite_number(segment.get("cm") if isinstance(segment, dict) else None)
+            if cm is None or cm < 0 or cm > 100:
+                raise WallSegmentMigrationError("thickness-conflict", draft_identity)
+            segment_id = segment.get("id") if isinstance(segment, dict) and isinstance(segment.get("id"), str) else ""
+            if not segment_id or segment_id in used:
+                base = deterministic_wall_segment_id(
+                    _legacy_identity(space.get("id")), a, b,
+                    [f"draft:{draft_identity}:{index}"],
+                )
+                segment_id = base
+                suffix = 2
+                while segment_id in used:
+                    segment_id = f"{base}-{suffix}"
+                    suffix += 1
+            used.add(segment_id)
+            partitions.append({"id": segment_id, "a": a, "b": b, "cm": cm})
+            converted += 1
+    if partitions:
+        space["partitions"] = partitions
+    else:
+        space.pop("partitions", None)
+    space.pop("room_drafts", None)
+    return len(drafts), converted
+
+
+def _migrate_space(
+    space: dict[str, Any], initial_migration: bool,
+) -> tuple[int, int, int]:
+    migrated_drafts, migrated_draft_segments = _migrate_room_drafts_to_partitions(
+        space, initial_migration,
+    )
     old: dict[str, dict[str, Any]] = {}
     for segment in space.get("wall_segments") or []:
         segment_id = str(segment.get("id", ""))
@@ -652,47 +745,35 @@ def _migrate_space(space: dict[str, Any], initial_migration: bool) -> int:
     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)
+    return (
+        sum(1 for segment in segments if segment["id"] not in old),
+        migrated_drafts,
+        migrated_draft_segments,
+    )
 
 
-def commit_wall_segment_model(config: Any) -> tuple[Any, int]:
+def commit_wall_segment_model(
+    config: Any, *, migration_report: dict[str, int] | None = None,
+) -> 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
+    migrated_drafts = 0
+    migrated_draft_segments = 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)
+        wall_segments, drafts, draft_segments = _migrate_space(space, initial_migration)
+        migrated += wall_segments
+        migrated_drafts += drafts
+        migrated_draft_segments += draft_segments
     candidate["model_version"] = WALL_SEGMENT_MODEL_VERSION
+    if migration_report is not None:
+        migration_report.clear()
+        migration_report.update({
+            "room_drafts": migrated_drafts,
+            "room_draft_segments": migrated_draft_segments,
+        })
     return canonicalize_config_geometry(candidate), migrated

custom_components/houseplan/websocket_api.py

@@ -21,6 +21,7 @@ from homeassistant.const import __version__ as HA_VERSION
 from homeassistant.core import HomeAssistant, callback
 from homeassistant.helpers import issue_registry as ir
 
+from .asset_integrity import get_asset_integrity_verifier
 from .auth import may_write
 from .const import (
     ASSETS_DIR,
@@ -50,10 +51,12 @@ from .coordinate_canonicalization import (
     canonicalize_layout_geometry,
 )
 from .decor_assets import (
+    ASSET_EXTENSIONS,
     ASSET_ID_RE,
     asset_meta_path,
     asset_refs,
     public_asset,
+    read_asset,
     read_catalog,
 )
 from .import_export import (
@@ -110,6 +113,7 @@ from .validation import (
     valid_space_id,
     validate_marker_controls,
     validate_marker_light_entities,
+    validate_marker_vacuum_routes,
     validate_marker_value_badges,
     validate_opening_passages,
     validate_partition_opening_hosts,
@@ -1135,22 +1139,29 @@ async def ws_assets_list(hass: HomeAssistant, connection, msg: dict[str, Any]) -
 @websocket_api.async_response
 async def ws_assets_resolve(hass: HomeAssistant, connection, msg: dict[str, Any]) -> None:
     """Resolve each unique id once; absent/corrupt content is reported missing."""
-    root = Path(hass.config.path(ASSETS_DIR))
+    rt = _runtime(hass, connection, msg["id"])
+    if rt is None:
+        return
     requested = set(msg["asset_ids"])
+    allowed = requested
+    if not _check_write(hass, connection):
+        async with rt.write_lock:
+            stored = await rt.config_store.async_load() or {}
+            referenced = set(asset_refs(stored.get("config") or {}))
+        allowed = requested & referenced
+
+    root = Path(hass.config.path(ASSETS_DIR))
+    verifier = get_asset_integrity_verifier(hass)
 
     def _resolve() -> tuple[list[dict], list[str]]:
         rows: list[dict] = []
         found: set[str] = set()
-        for row in read_catalog(root):
-            aid = row["asset_id"]
-            if aid not in requested:
+        for aid in sorted(allowed):
+            row = read_asset(root, aid)
+            if row is None:
                 continue
             path = root / f"{aid}{row['ext']}"
-            try:
-                import hashlib
-                if hashlib.sha256(path.read_bytes()).hexdigest() != aid:
-                    continue
-            except OSError:
+            if not verifier.verify(path, aid):
                 continue
             rows.append(public_asset(row))
             found.add(aid)
@@ -1188,15 +1199,23 @@ async def ws_assets_delete(hass: HomeAssistant, connection, msg: dict[str, Any])
             return
 
         def _delete() -> bool:
-            row = next((item for item in read_catalog(root) if item["asset_id"] == aid), None)
             removed = False
-            if row:
+            for extension in ASSET_EXTENSIONS:
+                path = root / f"{aid}{extension}"
+                if not path.is_file():
+                    continue
                 try:
-                    (root / f"{aid}{row['ext']}").unlink()
+                    path.unlink()
+                    removed = True
+                except FileNotFoundError:
+                    pass
+            meta = asset_meta_path(root, aid)
+            if meta.is_file():
+                try:
+                    meta.unlink()
                     removed = True
                 except FileNotFoundError:
                     pass
-            asset_meta_path(root, aid).unlink(missing_ok=True)
             return removed
 
         removed = await hass.async_add_executor_job(_delete)
@@ -1560,6 +1579,7 @@ async def ws_config_set(hass: HomeAssistant, connection, msg: dict[str, Any]) ->
             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_marker_vacuum_routes(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(
@@ -1918,6 +1938,7 @@ async def ws_plan_optimize(hass: HomeAssistant, connection, msg: dict[str, Any])
             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_marker_vacuum_routes(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"),

demo/benchmark_large_house.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 /** Reproducible browser benchmark and report producer for HP-PERF-01. */
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { launch } from './serve.mjs';
 import { LARGE_HOUSE_COUNTS, makeLargeHouseFixture } from './fixtures/large-house.mjs';
@@ -8,6 +9,10 @@ import { assertFreshDemoBundle } from './bundle-freshness.mjs';
 import { ensureHarnessEditorRuntime } from './editor-runtime-compat.mjs';
 import { summarizeLongTasks, summarizeTimings } from './performance/evaluate.mjs';
 import { assertCardContract, LARGE_HOUSE_CARD_CONTRACT } from './performance/card-contract.mjs';
+import {
+  ISOMETRIC_STAGE3_DENSE_PROFILE,
+  makeIsometricStage3DenseFixture,
+} from './performance/isometric-stage3-dense-fixture.mjs';
 
 const valueArg = (name) => process.argv.find((arg) => arg.startsWith(`--${name}=`))?.slice(name.length + 3);
 const samples = Math.max(1, Math.min(20, Number(valueArg('samples')) || 7));
@@ -15,26 +20,49 @@ 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', ISOMETRIC_STAGE3_DENSE_PROFILE,
+  'large-house-plan-snap-v1', 'large-house-interaction-v1',
+].includes(profile))
   throw new Error(`unknown large-house profile: ${profile}`);
-const isometric = profile === 'large-house-isometric-v1';
+const stage3Dense = profile === ISOMETRIC_STAGE3_DENSE_PROFILE;
+const allowStage2Base = process.argv.includes('--allow-stage2-base');
+if (allowStage2Base && !stage3Dense)
+  throw new Error('--allow-stage2-base is valid only for the Stage 3 dense profile');
+const requireStage3 = stage3Dense && !allowStage2Base;
+const isometric = profile === 'large-house-isometric-v1' || stage3Dense;
 const planSnap = profile === 'large-house-plan-snap-v1';
+const interaction = profile === 'large-house-interaction-v1';
 const requiresIsometric = isometric && existsSync(resolve(targetRoot, 'src/iso-projection.ts'));
+const requiresIsoStructuralBuildCounter = requiresIsometric
+  && readFileSync(resolve(targetRoot, 'src/houseplan-card.ts'), 'utf8')
+    .includes('private _isoStructuralBuildCount');
 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();
+const requiresInteraction = interaction && existsSync(resolve(targetRoot, 'src/live-viewport.ts'));
+const fixture = stage3Dense ? makeIsometricStage3DenseFixture() : makeLargeHouseFixture();
+const fixtureCounts = stage3Dense ? fixture.counts : LARGE_HOUSE_COUNTS;
+const sourceSha = (() => {
+  try {
+    return execFileSync('git', ['-C', targetRoot, 'rev-parse', 'HEAD'], { encoding: 'utf8' }).trim();
+  } catch {
+    return null;
+  }
+})();
+if (isometric && !sourceSha)
+  throw new Error(`${profile} requires an exact git source SHA`);
 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 }],
-      };
-    });
+    space.partitions ||= [];
+    for (const chain of [0, 1]) {
+      const y = 0.985 + chain * 0.025;
+      space.partitions.push(
+        { id: `perf-chain-${floor}-${chain}-0`, a: [0.10, y], b: [0.38, y], cm: 15 },
+        { id: `perf-chain-${floor}-${chain}-1`, a: [0.38, y], b: [0.46, y + 0.035], cm: 20 },
+      );
+    }
   }
-  fixture.counts = { ...fixture.counts, drafts: 6, pointerMoves: 120 };
+  fixture.counts = { ...fixture.counts, chainSegments: 12, pointerMoves: 120 };
 }
 const viewport = { width: 1440, height: 1000 };
 
@@ -71,7 +99,8 @@ try {
     const measuredSample = iteration - warmups;
     const row = await page.evaluate(async ({
       fixture, sample, cardContract, isometric, requiresIsometric, planSnap, requiresPlanSnap,
-      requiresWallFace,
+      requiresWallFace, interaction, requiresInteraction, stage3Dense, requireStage3,
+      requiresIsoStructuralBuildCounter, profile,
     }) => {
       const frame = () => new Promise((done) => requestAnimationFrame(() => requestAnimationFrame(done)));
       const until = async (predicate, timeout = 10000) => {
@@ -113,6 +142,15 @@ try {
           longTasks: await longTasks.stop(),
         };
       };
+      // Current candidates split Stage 3 out of the initial graph. Comparison
+      // bundles remain valid: their older monolithic renderer has no preload
+      // hook and is already available synchronously.
+      const ensureIsoRuntime = async (card) => {
+        if (typeof card._ensureIsoSceneRuntime !== 'function') return;
+        if (!(await card._ensureIsoSceneRuntime()))
+          throw new Error(`${profile} isometric runtime did not load`);
+        await card.updateComplete;
+      };
       const forceGc = async () => {
         if (typeof globalThis.gc !== 'function') return false;
         globalThis.gc();
@@ -131,15 +169,128 @@ try {
         planSnapGeometry: card._planSnapGeometryCache ? 1 : 0,
         wallFaceGraph: card._wallFaceGraphCache?.length ?? 0,
       });
+      const isoStructuralBuildCount = (card) => Number.isFinite(card._isoStructuralBuildCount)
+        ? card._isoStructuralBuildCount : null;
+      const stage3Snapshot = (card) => {
+        const stage = card.renderRoot.querySelector('.stage');
+        // Count the interactive HTML owners, not the diagnostic SVG
+        // ground/tether/plate primitives which deliberately repeat kind/id.
+        const overlayRoots = [...card.renderRoot.querySelectorAll(
+          '[data-hp-iso-overlay-kind][data-hp-iso-floor][data-hp-iso-visual]',
+        )];
+        const overlaySelectors = {
+          device: '[data-hp="device"]',
+          'room-label': '[data-hp="room-label"]',
+          'opening-lock': '.oplock',
+        };
+        const totalRootsByKind = Object.fromEntries(Object.entries(overlaySelectors)
+          .map(([kind, selector]) => [kind, card.renderRoot.querySelectorAll(selector).length]));
+        const stage3RootsByKind = Object.fromEntries(Object.keys(overlaySelectors)
+          .map((kind) => [kind, overlayRoots.filter((root) =>
+            root.getAttribute('data-hp-iso-overlay-kind') === kind).length]));
+        const openingSurfaceCounts = Object.fromEntries(
+          fixture.stage3Dense.expectedOpeningKinds.map((kind) => [kind,
+            card.renderRoot.querySelectorAll(`.iso-opening-panel[data-kind="${kind}"]`).length,
+          ]),
+        );
+        const vacuumRoots = [...card.renderRoot.querySelectorAll('.vacpuck, .vactrail')];
+        const materialDefinitions = card.renderRoot.querySelectorAll('[data-hp-iso-material-def]');
+        const definitionCounts = {
+          total: materialDefinitions.length,
+          patterns: card.renderRoot.querySelectorAll('pattern[data-hp-iso-material-def]').length,
+          filters: card.renderRoot.querySelectorAll('filter[data-hp-iso-material-def]').length,
+        };
+        const pulseDeviceId = fixture.stage3Dense?.pulseDeviceIdsBySpace?.[card._space] || '';
+        const pulseRoot = card.renderRoot.querySelector(
+          `.dev[data-id="${CSS.escape(pulseDeviceId)}"]`,
+        );
+        const facetCounts = {
+          value: card.renderRoot.querySelectorAll('.dev .value-badge').length,
+          lqi: card.renderRoot.querySelectorAll('.dev .lqi').length,
+          new: card.renderRoot.querySelectorAll('.dev .newdot').length,
+          pulse: pulseRoot?.querySelectorAll('.device-pulse, .activity-dot').length ?? 0,
+          roomMetrics: card.renderRoot.querySelectorAll('.roomlabel .rlmetrics').length,
+        };
+        const rawBuilds = stage?.getAttribute('data-hp-iso-structural-builds');
+        const structuralBuilds = rawBuilds == null ? null : Number(rawBuilds);
+        return {
+          effectiveProjection: typeof card._effectiveProjection === 'function'
+            ? card._effectiveProjection() : null,
+          isoStageRevision: stage?.getAttribute('data-hp-iso-stage') ?? null,
+          structuralBuilds: Number.isFinite(structuralBuilds) ? structuralBuilds : null,
+          renderedOverlayCount: overlayRoots.length,
+          raisedOverlayCount: overlayRoots
+            .filter((root) => root.getAttribute('data-hp-iso-raised') === 'true').length,
+          nudgedOverlayCount: overlayRoots
+            .filter((root) => root.getAttribute('data-hp-iso-nudged') === 'true').length,
+          raisedVacuumCount: vacuumRoots.filter((root) =>
+            root.getAttribute('data-hp-iso-raised') === 'true'
+            || root.hasAttribute('data-hp-iso-overlay-kind')).length,
+          overlayKinds: [...new Set(overlayRoots
+            .map((root) => root.getAttribute('data-hp-iso-overlay-kind'))
+            .filter(Boolean))].sort(),
+          totalRootsByKind,
+          stage3RootsByKind,
+          openingSurfaceCounts,
+          materialDefinitionCount: definitionCounts.total,
+          definitionCounts,
+          facetCounts,
+          pulseDiagnostics: pulseRoot ? {
+            id: pulseRoot.getAttribute('data-id'),
+            state: pulseRoot.getAttribute('data-state'),
+            className: pulseRoot.className,
+            ariaLabel: pulseRoot.getAttribute('aria-label'),
+          } : null,
+        };
+      };
+      const assertStage3Snapshot = (snapshot, label) => {
+        if (!requireStage3) return;
+        const expectedKinds = fixture.stage3Dense.expectedOverlayKinds;
+        const missingKinds = expectedKinds.filter((kind) => !snapshot.overlayKinds.includes(kind));
+        const failures = [];
+        if (snapshot.effectiveProjection !== 'iso') failures.push('effective projection is not iso');
+        if (snapshot.isoStageRevision !== '3') failures.push('Stage 3 revision marker is absent');
+        if (snapshot.structuralBuilds == null) failures.push('structural build counter is absent');
+        if (snapshot.renderedOverlayCount < 1) failures.push('no raised overlay roots rendered');
+        if (snapshot.raisedOverlayCount !== snapshot.renderedOverlayCount)
+          failures.push('one or more Stage 3 overlay roots remained on the floor plane');
+        if (snapshot.nudgedOverlayCount < 1) failures.push('dense fixture produced no bounded nudge');
+        if (snapshot.raisedVacuumCount !== 0) failures.push('floor-bound vacuum was marked as raised');
+        if (missingKinds.length) failures.push(`missing overlay kinds: ${missingKinds.join(', ')}`);
+        for (const kind of expectedKinds) {
+          const total = snapshot.totalRootsByKind[kind];
+          const stage3 = snapshot.stage3RootsByKind[kind];
+          if (total < 1) failures.push(`no rendered ${kind} roots`);
+          else if (stage3 !== total)
+            failures.push(`${kind} Stage 3 roots ${stage3}/${total}`);
+        }
+        for (const kind of fixture.stage3Dense.expectedOpeningKinds) {
+          if (!(snapshot.openingSurfaceCounts[kind] > 0))
+            failures.push(`no Stage 3 ${kind} opening surfaces`);
+        }
+        for (const [facet, count] of Object.entries(snapshot.facetCounts)) {
+          if (!(count > 0)) failures.push(`no observable ${facet} facet${facet === 'pulse'
+            ? ` (${JSON.stringify(snapshot.pulseDiagnostics)})` : ''}`);
+        }
+        if (snapshot.materialDefinitionCount < 1
+            || snapshot.materialDefinitionCount > fixture.stage3Dense.materialDefinitionLimit) {
+          failures.push(`material definitions ${snapshot.materialDefinitionCount}`
+            + ` exceed 1..${fixture.stage3Dense.materialDefinitionLimit}`);
+        }
+        if (!(snapshot.definitionCounts.patterns > 0)) failures.push('no shared texture pattern');
+        if (!(snapshot.definitionCounts.filters > 0)) failures.push('no shared shadow filter');
+        if (failures.length)
+          throw new Error(`Stage 3 ${label} contract failed: ${failures.join('; ')}`);
+      };
 
       window.__card?.remove?.();
       localStorage.clear();
       if (isometric) {
-        localStorage.setItem('houseplan_card_labs_v1', JSON.stringify(['iso']));
+        localStorage.setItem('houseplan_card_alpha_v1', '1');
         localStorage.setItem('houseplan_card_view_v1', JSON.stringify(Object.fromEntries(
           fixture.config.spaces.map((space) => [space.id, 'iso']),
         )));
-        history.replaceState(null, '', '?hp-labs=iso');
+        history.replaceState(null, '', '?hp_alpha=1');
       } else history.replaceState(null, '', location.pathname);
       const host = document.getElementById('host');
       const card = document.createElement('houseplan-card');
@@ -151,10 +302,10 @@ try {
         subscribeEvents: async () => () => undefined,
         subscribeMessage: async () => () => undefined,
       };
-      const hassFor = (states) => ({
+      const hassBase = {
         language: 'en', locale: { language: 'en' },
         user: { id: 'perf', name: 'Performance fixture', is_admin: true },
-        devices: fixture.devices, entities: fixture.entities, areas: fixture.areas, states,
+        devices: fixture.devices, entities: fixture.entities, areas: fixture.areas,
         floors: {
           one: { floor_id: 'one', name: 'One', level: 0 },
           two: { floor_id: 'two', name: 'Two', level: 1 },
@@ -178,17 +329,19 @@ try {
         localize: () => null,
         formatEntityState: (state) => state.state,
         config: { unit_system: { length: 'km' } },
-      });
+      };
+      const hassFor = (states) => ({ ...hassBase, states });
 
       const loadLongTasks = startLongTaskWindow();
       const loadStarted = performance.now();
       host.replaceChildren(card);
-      if (requiresIsometric) {
+      if (requiresIsometric && window.__hpAlpha !== true) {
         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: '' });
+        // Comparison bundles before #448 do not understand hp_alpha. Preserve
+        // the cross-version benchmark only for that base; current candidates
+        // must activate through the real URL/storage contract above.
+        card._onLabsSnapshot({ alpha: true, active: Object.freeze(['iso']), space: '' });
       }
       card.hass = hassFor(fixture.states);
       // launch() warms its own bootstrap card, but each measured sample creates
@@ -196,6 +349,7 @@ try {
       // construction; monolithic stable bundles remain immediate (#380).
       if (!await window.__hpEnsureHarnessEditorRuntime(card))
         throw new Error('large-house editor runtime did not preload');
+      if (isometric) await ensureIsoRuntime(card);
       window.__hpAssertCardContract(card, cardContract);
       if (requiresIsometric && (typeof card._setProjection !== 'function'
           || !(card._isoGeometryCache instanceof Map))) {
@@ -206,14 +360,52 @@ try {
       await frame();
       const modelReadyMs = Number((performance.now() - loadStarted).toFixed(2));
       await until(() => card._booting === false);
+      if (interaction && '_bootSoft' in card) await until(() => card._bootSoft === false);
       await frame();
       const firstStableRenderMs = Number((performance.now() - loadStarted).toFixed(2));
+      const initialProjection = typeof card._effectiveProjection === 'function'
+        ? card._effectiveProjection() : null;
+      if (requiresIsometric && initialProjection !== 'iso')
+        throw new Error(`${profile} entered Flat fallback instead of effective Iso`);
+      const initialIsoFingerprint = card.renderRoot
+        .querySelector('[data-hp="iso-walls"]')?.getAttribute('data-fingerprint') ?? null;
+      if (requiresIsometric && !initialIsoFingerprint)
+        throw new Error(`${profile} has no rendered Iso geometry fingerprint`);
+      const initialIsoStructuralBuilds = isometric ? isoStructuralBuildCount(card) : null;
+      if (requiresIsoStructuralBuildCounter && initialIsoStructuralBuilds == null)
+        throw new Error(`${profile} has no structural build counter`);
+      const initialStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (initialStage3) assertStage3Snapshot(initialStage3, 'initial render');
       const loadLongTaskResult = await loadLongTasks.stop();
+      let fullRenderCount = 0;
+      let diagnosticsScanCount = 0;
+      let physicalPreflightCount = 0;
+      let physicalPreflightMs = 0;
+      const fullRenderReasons = [];
+      if (interaction) {
+        const renderBody = card._renderBody.bind(card);
+        card._renderBody = (...args) => { fullRenderCount++; return renderBody(...args); };
+        const bindingStatus = card._bindingStatus.bind(card);
+        card._bindingStatus = (...args) => { diagnosticsScanCount++; return bindingStatus(...args); };
+        const checkSpacePhysicalGeometry = card._checkSpacePhysicalGeometry.bind(card);
+        card._checkSpacePhysicalGeometry = (...args) => {
+          physicalPreflightCount++;
+          const started = performance.now();
+          try { return checkSpacePhysicalGeometry(...args); }
+          finally { physicalPreflightMs += performance.now() - started; }
+        };
+        const willUpdate = card.willUpdate.bind(card);
+        card.willUpdate = (changed) => {
+          fullRenderReasons.push([...changed.keys()].map(String));
+          return willUpdate(changed);
+        };
+      }
       const viewToggle = isometric ? await duration(async () => {
         if (typeof card._setProjection === 'function') {
           card._setProjection('flat');
           await card.updateComplete;
           card._setProjection('iso');
+          await ensureIsoRuntime(card);
           await card.updateComplete;
         } else {
           // Comparison SHAs before #89 intentionally ignore the Labs operation.
@@ -226,7 +418,19 @@ try {
         await card.updateComplete;
       });
 
-      const firstEntity = Object.keys(fixture.states)[0];
+      const steadyStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (steadyStage3) assertStage3Snapshot(steadyStage3, 'steady floor');
+      const steadyIsoFingerprint = card.renderRoot
+        .querySelector('[data-hp="iso-walls"]')?.getAttribute('data-fingerprint') ?? null;
+      if (requiresIsometric && !steadyIsoFingerprint)
+        throw new Error(`${profile} lost Iso geometry after the space switch`);
+      const steadyIsoStructuralBuilds = isometric ? isoStructuralBuildCount(card) : null;
+      if (requiresIsoStructuralBuildCounter && steadyIsoStructuralBuilds == null)
+        throw new Error(`${profile} lost its structural build counter after the space switch`);
+
+      const firstEntity = stage3Dense
+        ? fixture.stage3Dense.stateEntityId
+        : Object.keys(fixture.states)[0];
       const nextStates = {
         ...fixture.states,
         [firstEntity]: { ...fixture.states[firstEntity], state: fixture.states[firstEntity].state === 'on' ? 'off' : 'on' },
@@ -235,6 +439,464 @@ try {
         card.hass = hassFor(nextStates);
         await card.updateComplete;
       });
+      const afterStateStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (afterStateStage3) assertStage3Snapshot(afterStateStage3, 'HA-only update');
+      const afterStateFingerprint = card.renderRoot
+        .querySelector('[data-hp="iso-walls"]')?.getAttribute('data-fingerprint') ?? null;
+      if (requiresIsometric && afterStateFingerprint !== steadyIsoFingerprint)
+        throw new Error(`${profile} rebuilt Iso geometry for an HA-only state update`);
+      const afterStateIsoStructuralBuilds = isometric ? isoStructuralBuildCount(card) : null;
+      if (requiresIsoStructuralBuildCounter
+          && afterStateIsoStructuralBuilds !== steadyIsoStructuralBuilds) {
+        throw new Error(`${profile} performed a structural rebuild for an HA-only state update`);
+      }
+      if (requireStage3 && afterStateStage3.structuralBuilds !== steadyStage3.structuralBuilds)
+        throw new Error(`${profile} rebuilt Stage 3 structure for an HA-only state update`);
+
+      let stage3States = nextStates;
+      const openingUpdate = stage3Dense ? await duration(async () => {
+        const entityId = fixture.stage3Dense.contactEntityId;
+        const current = stage3States[entityId];
+        stage3States = {
+          ...stage3States,
+          [entityId]: { ...current, state: current.state === 'on' ? 'off' : 'on' },
+        };
+        card.hass = hassFor(stage3States);
+        await card.updateComplete;
+      }) : null;
+      const afterOpeningStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (afterOpeningStage3) assertStage3Snapshot(afterOpeningStage3, 'opening update');
+      if (stage3Dense && requiresIsometric && afterOpeningStage3?.effectiveProjection !== 'iso')
+        throw new Error(`${profile} entered Flat fallback during an opening update`);
+      if (requireStage3 && afterOpeningStage3.structuralBuilds !== steadyStage3.structuralBuilds)
+        throw new Error(`${profile} rebuilt Stage 3 structure for an opening update`);
+
+      const overlayInteraction = stage3Dense ? await duration(async () => {
+        const overlay = card.renderRoot.querySelector(requireStage3
+          ? '[data-hp-iso-overlay-kind="device"][data-hp-iso-floor][data-hp-iso-visual]'
+          : '[data-hp="device"]');
+        if (!overlay) throw new Error(`${profile} dense fixture rendered no interactive device`);
+        overlay.dispatchEvent(new PointerEvent('pointerover', {
+          bubbles: true, composed: true, pointerId: 885, pointerType: 'mouse', isPrimary: true,
+        }));
+        overlay.focus?.();
+        await card.updateComplete;
+        await frame();
+        overlay.dispatchEvent(new PointerEvent('pointerout', {
+          bubbles: true, composed: true, pointerId: 885, pointerType: 'mouse', isPrimary: true,
+        }));
+        overlay.blur?.();
+        await card.updateComplete;
+      }) : null;
+      const afterInteractionStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (afterInteractionStage3)
+        assertStage3Snapshot(afterInteractionStage3, 'hover/focus update');
+      if (stage3Dense && requiresIsometric && afterInteractionStage3?.effectiveProjection !== 'iso')
+        throw new Error(`${profile} entered Flat fallback during a hover/focus update`);
+      if (requireStage3
+          && afterInteractionStage3.structuralBuilds !== steadyStage3.structuralBuilds) {
+        throw new Error(`${profile} rebuilt Stage 3 structure for a hover/focus update`);
+      }
+
+      let interactionDiagnostics = null;
+      let interactionTimings = null;
+      let interactionLongTasks = null;
+      const interactionSeries = interaction ? await duration(async () => {
+        const deltas = {};
+        const timings = {};
+        interactionLongTasks = {};
+        const diagnosticsBefore = diagnosticsScanCount;
+        const reasonsBefore = fullRenderReasons.length;
+        const beforeIrrelevant = fullRenderCount;
+        const intakeBefore = card._hassSequence;
+        const irrelevantStarted = performance.now();
+        let currentStates = nextStates;
+        for (let index = 0; index < 30; index++) {
+          currentStates = {
+            ...currentStates,
+            'sensor.performance_unrelated': {
+              entity_id: 'sensor.performance_unrelated', state: `${sample}:${index}`,
+            },
+          };
+          card.hass = hassFor(currentStates);
+        }
+        await card.updateComplete;
+        await frame();
+        timings.irrelevantHaTicksMs = performance.now() - irrelevantStarted;
+        deltas.irrelevantFullRenders = fullRenderCount - beforeIrrelevant;
+        deltas.irrelevantHassIntakes = card._hassSequence - intakeBefore;
+
+        const relevantBefore = fullRenderCount;
+        const relevantStarted = performance.now();
+        currentStates = {
+          ...currentStates,
+          [firstEntity]: {
+            ...currentStates[firstEntity],
+            state: currentStates[firstEntity].state === 'on' ? 'off' : 'on',
+          },
+        };
+        card.hass = hassFor(currentStates);
+        await card.updateComplete;
+        await frame();
+        timings.relevantHaTickMs = performance.now() - relevantStarted;
+        deltas.relevantOutsideGestureFullRenders = fullRenderCount - relevantBefore;
+
+        const stage = card.renderRoot.querySelector('.stage');
+        const device = card.renderRoot.querySelector('[data-hp="device"]');
+        const room = card.renderRoot.querySelector('[data-hp="room"]');
+        const heavy = card.renderRoot.querySelector('.wallbodies');
+        if (!stage || !device || !room || !heavy)
+          throw new Error('interaction profile has no stage/device/room/heavy scene');
+        const rect = stage.getBoundingClientRect();
+        const hoverBefore = fullRenderCount;
+        const hoverLongTasks = startLongTaskWindow();
+        const hoverStarted = performance.now();
+        device.dispatchEvent(new PointerEvent('pointerover', {
+          clientX: rect.left + rect.width / 2, clientY: rect.top + rect.height / 2,
+          bubbles: true, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+        }));
+        for (let index = 0; index < 40; index++) {
+          device.dispatchEvent(new PointerEvent('pointermove', {
+            clientX: rect.left + 100 + index, clientY: rect.top + 100 + index / 2,
+            bubbles: true, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+          }));
+          if ((index + 1) % 20 === 0) {
+            await card.updateComplete;
+            await frame();
+          }
+        }
+        const liveTip = card.renderRoot.querySelector('[data-hp-live-tip]');
+        deltas.tooltipVisible = !!liveTip && !liveTip.hidden && !!liveTip.textContent?.trim();
+        device.dispatchEvent(new PointerEvent('pointerleave', {
+          bubbles: false, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+        }));
+        room.dispatchEvent(new PointerEvent('pointerenter', {
+          clientX: rect.left + 300, clientY: rect.top + 300,
+          bubbles: false, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+        }));
+        for (let index = 0; index < 40; index++) {
+          room.dispatchEvent(new PointerEvent('pointermove', {
+            clientX: rect.left + 300 + index, clientY: rect.top + 300 + index / 2,
+            bubbles: true, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+          }));
+          if ((index + 1) % 20 === 0) { await card.updateComplete; await frame(); }
+        }
+        room.dispatchEvent(new PointerEvent('pointerleave', {
+          bubbles: false, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+        }));
+        for (let index = 0; index < 40; index++) {
+          stage.dispatchEvent(new PointerEvent('pointermove', {
+            clientX: rect.left + 20 + index, clientY: rect.top + 20,
+            bubbles: true, composed: true, pointerId: 991, pointerType: 'mouse', isPrimary: true,
+          }));
+          if ((index + 1) % 20 === 0) { await card.updateComplete; await frame(); }
+        }
+        await card.updateComplete;
+        timings.hoverSeriesMs = performance.now() - hoverStarted;
+        deltas.hoverFullRenders = fullRenderCount - hoverBefore;
+        deltas.hoverTargets = ['device', 'room', 'miss'];
+        interactionLongTasks.hoverSeries = await hoverLongTasks.stop();
+
+        const cameraSvg = card.renderRoot.querySelector('[data-hp-live-viewbox="camera"], [data-hp-live-viewbox="floor"], .zoomwrap > svg');
+        const initialViewBox = cameraSvg?.getAttribute('viewBox') || '';
+        const panLongTasks = startLongTaskWindow();
+        const panStarted = performance.now();
+        const panMoveRenders = [];
+        const panTerminalRenders = [];
+        let relevantDuringGestureFullRenders = 0;
+        let relevantDuringGestureIntakes = 0;
+        for (let dragIndex = 0; dragIndex < 4; dragIndex++) {
+          const pointerId = 992 + dragIndex;
+          stage.dispatchEvent(new PointerEvent('pointerdown', {
+            clientX: rect.left + 200, clientY: rect.top + 200, button: 0, buttons: 1,
+            bubbles: true, composed: true, pointerId, pointerType: 'mouse', isPrimary: true,
+          }));
+          await card.updateComplete;
+          const panMoveBefore = fullRenderCount;
+          for (let index = 0; index < 20; index++) {
+            stage.dispatchEvent(new PointerEvent('pointermove', {
+              clientX: rect.left + 205 + index * 3, clientY: rect.top + 202 + index,
+              button: 0, buttons: 1, bubbles: true, composed: true,
+              pointerId, pointerType: 'mouse', isPrimary: true,
+            }));
+            if (dragIndex === 0 && index === 10) {
+              const deferredBefore = fullRenderCount;
+              const deferredIntakeBefore = card._hassSequence;
+              for (let tick = 0; tick < 3; tick++) {
+                currentStates = {
+                  ...currentStates,
+                  [firstEntity]: { ...currentStates[firstEntity], state: `gesture-${tick}` },
+                };
+                card.hass = hassFor(currentStates);
+              }
+              await card.updateComplete;
+              relevantDuringGestureFullRenders += fullRenderCount - deferredBefore;
+              relevantDuringGestureIntakes += card._hassSequence - deferredIntakeBefore;
+            }
+            if ((index + 1) % 10 === 0) {
+              await card.updateComplete;
+              await frame();
+            }
+          }
+          const beforeTerminal = fullRenderCount;
+          panMoveRenders.push(beforeTerminal - panMoveBefore);
+          stage.dispatchEvent(new PointerEvent('pointerup', {
+            clientX: rect.left + 265, clientY: rect.top + 222, button: 0, buttons: 0,
+            bubbles: true, composed: true, pointerId, pointerType: 'mouse', isPrimary: true,
+          }));
+          await card.updateComplete;
+          await frame();
+          panTerminalRenders.push(fullRenderCount - beforeTerminal);
+        }
+        timings.panSeriesMs = performance.now() - panStarted;
+        interactionLongTasks.panSeries = await panLongTasks.stop();
+        const movedViewBox = cameraSvg?.getAttribute('viewBox') || '';
+        const currentView = card._viewOr(card._baseVb());
+        const currentDevice = card._devices.find((item) => item.id === device.dataset.id);
+        const position = currentDevice ? card._pos(currentDevice) : null;
+        const scene = position ? card._scenePoint([position.x, position.y]) : null;
+        const deviceRect = device.getBoundingClientRect();
+        const expectedX = scene ? rect.left + ((scene[0] - currentView.x) / currentView.w) * rect.width : 0;
+        const expectedY = scene ? rect.top + ((scene[1] - currentView.y) / currentView.h) * rect.height : 0;
+        const overlayErrorPx = scene ? Math.hypot(
+          deviceRect.left + deviceRect.width / 2 - expectedX,
+          deviceRect.top + deviceRect.height / 2 - expectedY,
+        ) : Infinity;
+
+        const cameraLongTasks = startLongTaskWindow();
+        const cameraStarted = performance.now();
+        const cameraBefore = fullRenderCount;
+        const pinchPointerA = 1001, pinchPointerB = 1002;
+        stage.dispatchEvent(new PointerEvent('pointerdown', {
+          clientX: rect.left + 360, clientY: rect.top + 300, button: 0, buttons: 1,
+          bubbles: true, composed: true, pointerId: pinchPointerA,
+          pointerType: 'touch', isPrimary: true,
+        }));
+        stage.dispatchEvent(new PointerEvent('pointerdown', {
+          clientX: rect.left + 460, clientY: rect.top + 300, button: 0, buttons: 1,
+          bubbles: true, composed: true, pointerId: pinchPointerB,
+          pointerType: 'touch', isPrimary: false,
+        }));
+        await card.updateComplete;
+        const pinchMoveBefore = fullRenderCount;
+        for (let index = 0; index < 20; index++) {
+          stage.dispatchEvent(new PointerEvent('pointermove', {
+            clientX: rect.left + 360 - index, clientY: rect.top + 300,
+            button: 0, buttons: 1, bubbles: true, composed: true,
+            pointerId: pinchPointerA, pointerType: 'touch', isPrimary: true,
+          }));
+          stage.dispatchEvent(new PointerEvent('pointermove', {
+            clientX: rect.left + 460 + index, clientY: rect.top + 300,
+            button: 0, buttons: 1, bubbles: true, composed: true,
+            pointerId: pinchPointerB, pointerType: 'touch', isPrimary: false,
+          }));
+          if ((index + 1) % 5 === 0) await frame();
+        }
+        const pinchTerminalBefore = fullRenderCount;
+        for (const pointerId of [pinchPointerA, pinchPointerB]) {
+          stage.dispatchEvent(new PointerEvent('pointerup', {
+            clientX: rect.left + 410, clientY: rect.top + 300,
+            button: 0, buttons: 0, bubbles: true, composed: true,
+            pointerId, pointerType: 'touch', isPrimary: pointerId === pinchPointerA,
+          }));
+        }
+        await card.updateComplete;
+        await frame();
+        const pinchTerminalRenders = fullRenderCount - pinchTerminalBefore;
+        for (let index = 0; index < 4; index++) {
+          stage.dispatchEvent(new WheelEvent('wheel', {
+            deltaY: index % 2 ? 120 : -120,
+            clientX: rect.left + rect.width / 2,
+            clientY: rect.top + rect.height / 2,
+            bubbles: true, cancelable: true,
+          }));
+        }
+        await until(() => !card._cameraTransition.active);
+        await card.updateComplete;
+        await frame();
+        timings.cameraSeriesMs = performance.now() - cameraStarted;
+        interactionLongTasks.cameraSeries = await cameraLongTasks.stop();
+        deltas.cameraMoveFullRenders = pinchTerminalBefore - pinchMoveBefore;
+        deltas.cameraTerminalFullRenders = pinchTerminalRenders;
+        deltas.cameraFullRenders = fullRenderCount - cameraBefore;
+
+        const editorLongTaskWindows = [];
+        const editorConfigBefore = JSON.stringify(card._serverCfg);
+        const editorCallsBefore = wsCalls;
+        const editorPaintBefore = card._liveEditorPaintCount || 0;
+        let editorElapsed = 0;
+        const editorMoveRenders = [];
+        const editorTerminalRenders = [];
+
+        card._setMode('plan', false);
+        card._tool = 'draw';
+        card._path = [[100, 100]];
+        card.requestUpdate();
+        await card.updateComplete;
+        await until(() => !card._modeTransitionBusy && card._continuity.state === 'steady');
+        for (let index = 0; index < 5; index++) await frame();
+        let editorStage = card.renderRoot.querySelector('.stage');
+        let editorRect = editorStage.getBoundingClientRect();
+        let editorView = card._viewOr(card._baseVb());
+        const fromScene = (x, y) => ({
+          clientX: editorRect.left + ((x - editorView.x) / editorView.w) * editorRect.width,
+          clientY: editorRect.top + ((y - editorView.y) / editorView.h) * editorRect.height,
+        });
+        let editorPartLongTasks = startLongTaskWindow();
+        let partStarted = performance.now();
+        let editorMoveBefore = fullRenderCount;
+        for (let index = 0; index < 40; index++) {
+          editorStage.dispatchEvent(new PointerEvent('pointermove', {
+            ...fromScene(110 + index * 2, 110 + index),
+            bubbles: true, composed: true, pointerId: 1101,
+            pointerType: 'mouse', isPrimary: true,
+          }));
+          if ((index + 1) % 10 === 0) await frame();
+        }
+        let editorTerminalBefore = fullRenderCount;
+        editorMoveRenders.push(editorTerminalBefore - editorMoveBefore);
+        card._cursorPt = null;
+        card._path = [];
+        card.requestUpdate();
+        await card.updateComplete;
+        await frame();
+        editorTerminalRenders.push(fullRenderCount - editorTerminalBefore);
+        editorElapsed += performance.now() - partStarted;
+        editorLongTaskWindows.push(await editorPartLongTasks.stop());
+
+        card._tool = 'resize';
+        card.requestUpdate();
+        await card.updateComplete;
+        const resizeRoom = card._rszRooms()[0];
+        const resizeEvent = {
+          pointerId: 1102, stopPropagation: () => undefined,
+          preventDefault: () => undefined, target: null,
+        };
+        card._rszEdgeDown(resizeEvent, resizeRoom.id, 1);
+        const resizePlan = card._resize?.plan || card._rszDrag?.plan;
+        if (!resizePlan) throw new Error('interaction resize plan was not created');
+        const resizePreflightBefore = physicalPreflightCount;
+        const resizePreflightMsBefore = physicalPreflightMs;
+        editorStage = card.renderRoot.querySelector('.stage');
+        editorRect = editorStage.getBoundingClientRect();
+        editorView = card._viewOr(card._baseVb());
+        // A browser delivers pointerdown and pointermove as separate tasks.
+        // Keep the synthetic harness from attributing both handlers to one
+        // impossible long task while still timing every move-side preflight.
+        await new Promise((done) => setTimeout(done, 0));
+        editorPartLongTasks = startLongTaskWindow();
+        partStarted = performance.now();
+        editorMoveBefore = fullRenderCount;
+        for (let index = 0; index < 40; index++) {
+          const target = [
+            resizePlan.a[0] + resizePlan.n[0] * card._gridPitch * (1 + index / 40),
+            resizePlan.a[1] + resizePlan.n[1] * card._gridPitch * (1 + index / 40),
+          ];
+          card._rszMove({
+            ...resizeEvent,
+            clientX: editorRect.left + ((target[0] - editorView.x) / editorView.w) * editorRect.width,
+            clientY: editorRect.top + ((target[1] - editorView.y) / editorView.h) * editorRect.height,
+          });
+          if ((index + 1) % 10 === 0) await frame();
+        }
+        editorTerminalBefore = fullRenderCount;
+        editorMoveRenders.push(editorTerminalBefore - editorMoveBefore);
+        deltas.resizeLivePreflightChecks = physicalPreflightCount - resizePreflightBefore;
+        deltas.resizeLivePreflightMs = physicalPreflightMs - resizePreflightMsBefore;
+        card._rszCancelDrag();
+        await card.updateComplete;
+        await frame();
+        editorTerminalRenders.push(fullRenderCount - editorTerminalBefore);
+        editorElapsed += performance.now() - partStarted;
+        editorLongTaskWindows.push(await editorPartLongTasks.stop());
+
+        card._setMode('decor', false);
+        card._decorTool = 'select';
+        const decorShape = card._decorList.find((shape) =>
+          shape.kind === 'furniture' || shape.kind === 'rect' || shape.kind === 'ellipse');
+        if (!decorShape) throw new Error('interaction profile has no transformable decor');
+        card._decorSel = decorShape.id;
+        card.requestUpdate();
+        await card.updateComplete;
+        await until(() => !card._modeTransitionBusy && card._continuity.state === 'steady');
+        for (let index = 0; index < 5; index++) await frame();
+        card._dtMeasure();
+        await card.updateComplete;
+        editorStage = card.renderRoot.querySelector('.stage');
+        editorRect = editorStage.getBoundingClientRect();
+        editorView = card._viewOr(card._baseVb());
+        const box = card._decorBoxOf(decorShape);
+        const cornerX = box.x + box.w, cornerY = box.y + box.h;
+        const decorPointer = (x, y) => ({
+          pointerId: 1103, pointerType: 'mouse', shiftKey: false,
+          clientX: editorRect.left + ((x - editorView.x) / editorView.w) * editorRect.width,
+          clientY: editorRect.top + ((y - editorView.y) / editorView.h) * editorRect.height,
+          stopPropagation: () => undefined, preventDefault: () => undefined,
+          currentTarget: null, target: null,
+        });
+        card._dtStart(decorPointer(cornerX, cornerY), 'scale', [1, 1]);
+        await card.updateComplete;
+        await frame();
+        editorPartLongTasks = startLongTaskWindow();
+        partStarted = performance.now();
+        editorMoveBefore = fullRenderCount;
+        for (let index = 0; index < 40; index++) {
+          card._dtMove(decorPointer(cornerX + index, cornerY + index / 2));
+          if ((index + 1) % 10 === 0) await frame();
+        }
+        editorTerminalBefore = fullRenderCount;
+        editorMoveRenders.push(editorTerminalBefore - editorMoveBefore);
+        card._cancelDecorGesture();
+        await card.updateComplete;
+        await frame();
+        editorTerminalRenders.push(fullRenderCount - editorTerminalBefore);
+        editorElapsed += performance.now() - partStarted;
+        editorLongTaskWindows.push(await editorPartLongTasks.stop());
+        timings.editorSeriesMs = editorElapsed;
+        interactionLongTasks.editorSeries = {
+          supported: editorLongTaskWindows.every((window) => window.supported),
+          count: editorLongTaskWindows.reduce((sum, window) => sum + window.count, 0),
+          maxMs: Math.max(0, ...editorLongTaskWindows.map((window) => window.maxMs)),
+          totalMs: editorLongTaskWindows.reduce((sum, window) => sum + window.totalMs, 0),
+        };
+        deltas.editorMoveFullRenders = editorMoveRenders;
+        deltas.editorTerminalFullRenders = editorTerminalRenders;
+        deltas.editorLivePaints = (card._liveEditorPaintCount || 0) - editorPaintBefore;
+        deltas.editorConfigStable = JSON.stringify(card._serverCfg) === editorConfigBefore;
+        deltas.editorWsWrites = wsCalls - editorCallsBefore;
+        deltas.editorLongTaskParts = editorLongTaskWindows;
+
+        card._setMode('view', false);
+        await card.updateComplete;
+        await frame();
+        deltas.panMoveFullRenders = panMoveRenders;
+        deltas.terminalFullRenders = panTerminalRenders;
+        deltas.relevantDuringGestureFullRenders = relevantDuringGestureFullRenders;
+        deltas.relevantDuringGestureIntakes = relevantDuringGestureIntakes;
+        deltas.viewBoxMoved = !!initialViewBox && initialViewBox !== movedViewBox;
+        deltas.overlayErrorPx = Number(overlayErrorPx.toFixed(2));
+        deltas.heavyNodeStable = card.renderRoot.querySelector('.wallbodies') === heavy;
+        deltas.diagnosticsScans = diagnosticsScanCount - diagnosticsBefore;
+        deltas.fullRenderReasons = fullRenderReasons.slice(reasonsBefore);
+        interactionTimings = timings;
+        interactionDiagnostics = { supported: requiresInteraction, ...deltas };
+        if (requiresInteraction && (
+          deltas.irrelevantFullRenders !== 0 || deltas.irrelevantHassIntakes !== 30
+          || deltas.relevantOutsideGestureFullRenders !== 1 || deltas.hoverFullRenders !== 0
+          || deltas.hoverTargets.join(',') !== 'device,room,miss'
+          || deltas.panMoveFullRenders.some((count) => count !== 0)
+          || deltas.terminalFullRenders.some((count) => count !== 1)
+          || deltas.relevantDuringGestureFullRenders !== 0 || !deltas.tooltipVisible
+          || deltas.relevantDuringGestureIntakes !== 3
+          || deltas.cameraMoveFullRenders !== 0 || deltas.cameraTerminalFullRenders !== 1
+          || deltas.editorMoveFullRenders.some((count) => count !== 0)
+          || deltas.editorTerminalFullRenders.some((count) => count > 1)
+          || deltas.resizeLivePreflightChecks < 1
+          || deltas.editorLivePaints < 3 || !deltas.editorConfigStable || deltas.editorWsWrites !== 0
+          || !deltas.viewBoxMoved || deltas.overlayErrorPx > 1 || !deltas.heavyNodeStable
+          || deltas.diagnosticsScans !== 0
+        )) throw new Error(`interaction structural contract failed: ${JSON.stringify(interactionDiagnostics)}`);
+      }) : null;
 
       let planSnapDiagnostics = null;
       const planSnapPointer = planSnap ? await duration(async () => {
@@ -317,12 +979,14 @@ try {
         )) 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 oldChainId = card._activeWallChainId;
+          const oldPartitionIds = card._activeWallChainPartitionIds;
+          const oldCms = card._wallChainSegmentCms;
           const beforePath = [[10, 10]];
           card._path = [[10, 10], [20, 10]];
-          card._activeDraftId = 'perf-face-draft';
-          card._draftSegmentCms = [15];
+          card._activeWallChainId = 'perf-face-chain';
+          card._activeWallChainPartitionIds = ['perf-face-segment'];
+          card._wallChainSegmentCms = [15];
           const acceptedStarted = performance.now();
           card._offerWallFaces(beforePath);
           planSnapDiagnostics.wallFaceAcceptedClickMs = performance.now() - acceptedStarted;
@@ -330,8 +994,9 @@ try {
           card._wallFaceBatch = null;
           card._roomDialog = false;
           card._path = oldPath;
-          card._activeDraftId = oldDraftId;
-          card._draftSegmentCms = oldCms;
+          card._activeWallChainId = oldChainId;
+          card._activeWallChainPartitionIds = oldPartitionIds;
+          card._wallChainSegmentCms = oldCms;
           if (planSnapDiagnostics.wallFaceAcceptedClickMs > 1000
               || planSnapDiagnostics.wallFaceCacheEntries < 1
               || planSnapDiagnostics.wallFaceCacheEntries > 4) {
@@ -422,16 +1087,29 @@ try {
       const cacheGrowth = Object.fromEntries(
         Object.keys(cacheEntries).map((key) => [key, cacheEntries[key] - cacheBefore[key]]),
       );
+      const finalProjection = typeof card._effectiveProjection === 'function'
+        ? card._effectiveProjection() : null;
+      if (requiresIsometric && finalProjection !== 'iso')
+        throw new Error(`${profile} ended the sample in Flat fallback`);
+      const finalStage3 = stage3Dense ? stage3Snapshot(card) : null;
+      if (finalStage3) assertStage3Snapshot(finalStage3, 'final warmed state');
 
       const result = {
         sample,
         modelReadyMs,
         firstStableRenderMs,
         ...(viewToggle ? { viewToggleMs: viewToggle.ms } : {}),
+        ...(openingUpdate ? { openingUpdateMs: openingUpdate.ms } : {}),
+        ...(overlayInteraction ? { overlayInteractionMs: overlayInteraction.ms } : {}),
         ...(planSnapPointer ? {
           planSnapPointerMs: planSnapPointer.ms,
           planSnapDiagnostics,
         } : {}),
+        ...(interactionSeries ? {
+          interactionSeriesMs: interactionSeries.ms,
+          ...interactionTimings,
+          interactionDiagnostics,
+        } : {}),
         spaceSwitchMs: spaceSwitch.ms,
         stateUpdateMs: stateUpdate.ms,
         resizePreviewMs: resizePreview.ms,
@@ -441,7 +1119,10 @@ try {
         longTasks: {
           load: loadLongTaskResult,
           ...(viewToggle ? { viewToggle: viewToggle.longTasks } : {}),
+          ...(openingUpdate ? { openingUpdate: openingUpdate.longTasks } : {}),
+          ...(overlayInteraction ? { overlayInteraction: overlayInteraction.longTasks } : {}),
           ...(planSnapPointer ? { planSnapPointer: planSnapPointer.longTasks } : {}),
+          ...(interactionSeries ? interactionLongTasks || {} : {}),
           spaceSwitch: spaceSwitch.longTasks,
           stateUpdate: stateUpdate.longTasks,
           resizePreview: resizePreview.longTasks,
@@ -454,6 +1135,26 @@ try {
         heapGrowthBytes: heapBefore == null || heapAfter == null ? null : heapAfter - heapBefore,
         preciseGc: typeof globalThis.gc === 'function',
         renderedDevices: card._devices?.length ?? 0,
+        effectiveProjection: finalProjection,
+        ...(isometric ? {
+          isoStructuralBuilds: {
+            supported: steadyIsoStructuralBuilds != null && afterStateIsoStructuralBuilds != null,
+            initial: initialIsoStructuralBuilds,
+            beforeHaUpdate: steadyIsoStructuralBuilds,
+            afterHaUpdate: afterStateIsoStructuralBuilds,
+            haUpdateDelta: steadyIsoStructuralBuilds == null || afterStateIsoStructuralBuilds == null
+              ? null : afterStateIsoStructuralBuilds - steadyIsoStructuralBuilds,
+          },
+        } : {}),
+        ...(finalStage3 ? {
+          isoStageRevision: finalStage3.isoStageRevision,
+          stage3Diagnostics: {
+            ...finalStage3,
+            steadyUpdateStructuralBuildDelta: requireStage3
+              ? afterInteractionStage3.structuralBuilds - steadyStage3.structuralBuilds
+              : null,
+          },
+        } : {}),
       };
       card.remove();
       await frame();
@@ -461,6 +1162,8 @@ try {
     }, {
       fixture, sample: measuredSample, cardContract: LARGE_HOUSE_CARD_CONTRACT,
       isometric, requiresIsometric, planSnap, requiresPlanSnap, requiresWallFace,
+      interaction, requiresInteraction, stage3Dense, requireStage3,
+      requiresIsoStructuralBuildCounter, profile,
     });
     if (measuredSample >= 0) rows.push(row);
   }
@@ -473,10 +1176,15 @@ const metricNames = [
   'resizePreviewMs', 'panZoomMs', 'settingsDialogMs', 'switchCycleMs',
 ];
 if (isometric) metricNames.splice(2, 0, 'viewToggleMs');
+if (stage3Dense) metricNames.splice(3, 0, 'openingUpdateMs', 'overlayInteractionMs');
 if (planSnap) metricNames.splice(2, 0, 'planSnapPointerMs');
+if (interaction) metricNames.splice(2, 0,
+  'interactionSeriesMs', 'hoverSeriesMs', 'panSeriesMs', 'cameraSeriesMs',
+  'editorSeriesMs', 'irrelevantHaTicksMs', 'relevantHaTickMs');
 const report = {
   schema: 2,
   profile,
+  sourceSha,
   generatedAt: new Date().toISOString(),
   buildFingerprint,
   runtime: {
@@ -488,11 +1196,16 @@ const report = {
     deviceScaleFactor: 1,
     reducedMotion: true,
   },
-  fixture: LARGE_HOUSE_COUNTS,
+  fixture: fixtureCounts,
   samples,
   warmups,
   summary: summarizeTimings(rows, metricNames),
   longTasks: summarizeLongTasks(rows),
+  effectiveProjection: [...new Set(rows.map((row) => row.effectiveProjection))],
+  ...(stage3Dense ? {
+    isoStageRevision: [...new Set(rows.map((row) => row.isoStageRevision))],
+    stage3Required: requireStage3,
+  } : {}),
   rows,
   note: `Compare with a base-SHA report captured by the same runner and evaluate the ${profile} budget.`,
 };

demo/benchmark_wall_draw_click.mjs

@@ -0,0 +1,113 @@
+/** #461 production-bundle wall-draw terminal-click performance profile. */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { launch, finish } from './serve.mjs';
+import {
+  installWallDrawClickHarness, resetWallDrawClickHarness, runWallDrawClickChain,
+  runWallDrawFinishProfile,
+} from './wall-draw-click-harness.mjs';
+
+const outputArg = process.argv.find((arg) => arg.startsWith('--output='));
+const output = outputArg ? resolve(outputArg.slice('--output='.length)) : null;
+const { page, browser } = await launch({ width: 1200, height: 900 }, 1);
+await installWallDrawClickHarness(page);
+
+const run = async (remote) => {
+  const fixture = await resetWallDrawClickHarness(page, remote);
+  // One complete chain warms the browser/JIT; reset removes all of its state.
+  await runWallDrawClickChain(page);
+  await resetWallDrawClickHarness(page, remote);
+  return { fixture, result: await runWallDrawClickChain(page) };
+};
+const base = await run(false);
+const remote = await run(true);
+const runFinish = async (remoteVariant) => {
+  await resetWallDrawClickHarness(page, remoteVariant);
+  // Warm the distinct finalizer path, then measure it from the same fixture.
+  await runWallDrawFinishProfile(page);
+  await resetWallDrawClickHarness(page, remoteVariant);
+  return runWallDrawFinishProfile(page);
+};
+const baseFinish = await runFinish(false);
+const remoteFinish = await runFinish(true);
+const sorted = [...base.result.times].sort((a, b) => a - b);
+const medianMs = sorted[Math.floor(sorted.length / 2)];
+const maxMs = Math.max(...base.result.times);
+const remoteSorted = [...remote.result.times].sort((a, b) => a - b);
+const remoteMedianMs = remoteSorted[Math.floor(remoteSorted.length / 2)];
+
+const clickShape = (click) => click.fullSpacePhysicalChecks === 0
+  && click.localPhysicalChecks === 1
+  && click.junctionArtifactPasses === 1
+  && click.configWrites === 1 && click.history === 1 && click.pathPoints === 1;
+const fixtureShape = base.fixture.spaces === 5 && base.fixture.rooms === 12
+  && base.fixture.positiveSegments >= 36 && base.fixture.savedPartitions === 8;
+const remoteFixtureShape = remote.fixture.positiveSegments === base.fixture.positiveSegments * 2;
+const structural = fixtureShape && remoteFixtureShape
+  && base.result.first.fullSpacePhysicalChecks === 0
+  && base.result.first.localPhysicalChecks === 0
+  && base.result.first.configWrites === 0 && base.result.first.history === 0
+  && base.result.clicks.length === 7 && base.result.clicks.every(clickShape)
+  && remote.result.clicks.every(clickShape)
+  && base.result.metrics.localProofMaxObjects < base.fixture.positiveSegments
+  && remote.result.metrics.localProofMaxObjects === base.result.metrics.localProofMaxObjects
+  && base.result.ids.length === 7 && new Set(base.result.ids).size === 7
+  && base.result.metrics.wallGenericFallbacks === 0
+  && base.result.terminal.fullSpacePhysicalChecks === 0
+  && base.result.terminal.localPhysicalChecks === 0
+  && base.result.terminal.configWrites === 0 && base.result.terminal.history === 0
+  && base.result.terminalPartitionCount === base.fixture.savedPartitions + 7
+  && base.result.activeCleared;
+const finishStructural = baseFinish.terminal.fullSpacePhysicalChecks === 0
+  && baseFinish.terminal.localPhysicalChecks === 1
+  && baseFinish.terminal.configWrites === 1
+  && baseFinish.terminal.history === 0
+  && baseFinish.terminal.wallFinishBarriers === 1
+  && baseFinish.terminal.wallGenericFallbacks === 0
+  && baseFinish.surviving.length === 1
+  && baseFinish.terminalPartitionCount === base.fixture.savedPartitions + 1
+  && baseFinish.optimizeChanged === false
+  && baseFinish.activeCleared
+  && remoteFinish.terminal.fullSpacePhysicalChecks === 0
+  && remoteFinish.terminal.localPhysicalChecks === 1
+  && remoteFinish.terminal.configWrites === 1
+  && remoteFinish.terminal.wallFinishBarriers === 1
+  && remoteFinish.surviving.length === 1
+  && remoteFinish.optimizeChanged === false;
+const budgets = {
+  medianMs: 150,
+  maxMs: 250,
+  remoteMedianMs: medianMs * 1.5 + 20,
+  finishMs: 250,
+  remoteFinishMs: baseFinish.finishMs * 1.5 + 20,
+};
+const timing = medianMs <= budgets.medianMs && maxMs <= budgets.maxMs
+  && remoteMedianMs <= budgets.remoteMedianMs
+  && baseFinish.finishMs <= budgets.finishMs
+  && remoteFinish.finishMs <= budgets.remoteFinishMs;
+const report = {
+  issue: 461, profile: 'wall-draw-click-v1',
+  fixture: base.fixture, remoteFixture: remote.fixture,
+  timing: {
+    samplesMs: base.result.times.map((value) => Math.round(value * 10) / 10),
+    medianMs: Math.round(medianMs * 10) / 10,
+    maxMs: Math.round(maxMs * 10) / 10,
+    remoteMedianMs: Math.round(remoteMedianMs * 10) / 10,
+    finishMs: Math.round(baseFinish.finishMs * 10) / 10,
+    remoteFinishMs: Math.round(remoteFinish.finishMs * 10) / 10,
+  },
+  budgets: Object.fromEntries(Object.entries(budgets)
+    .map(([key, value]) => [key, Math.round(value * 10) / 10])),
+  counters: base.result.metrics,
+  finishCounters: baseFinish.terminal,
+  structural: structural && finishStructural,
+  timingPass: timing,
+  pass: structural && finishStructural && timing,
+};
+if (output) {
+  mkdirSync(dirname(output), { recursive: true });
+  writeFileSync(output, `${JSON.stringify(report, null, 2)}\n`);
+}
+console.log(JSON.stringify(report, null, 2));
+if (!report.pass) process.exitCode = 1;
+await finish(browser);

demo/benchmark_zigbee_topology.mjs

@@ -0,0 +1,47 @@
+/** #54: bounded provider normalization and incident-only hover performance. */
+import { performance } from 'node:perf_hooks';
+import { mapTopologies, normalizeZhaTopology, resolveMappedTopologyHover } from '../test-build/zigbee-topology.js';
+
+const NODES = 500;
+const SAMPLES = 9;
+const BUDGETS = { normalizeMs: 80, mapMs: 160, firstHoverMs: 180, repeatedHoverMs: 120 };
+const hex = (index) => index.toString(16).padStart(16, '0');
+const rows = Array.from({ length: NODES }, (_, index) => ({
+  ieee: hex(index + 1), device_reg_id: `d${index}`, device_type: index ? 'Router' : 'Coordinator',
+  neighbors: [1, 2, 3, 4, 5, 6].flatMap((offset) => {
+    const other = index + offset;
+    return other < NODES ? [{ ieee: hex(other + 1), lqi: (index * 17 + offset * 13) % 256 }] : [];
+  }),
+}));
+const registry = {
+  revision: 1, authoritative: true, access: 'full', lastSuccess: Date.now(), entities: {},
+  devices: Object.fromEntries(rows.map((_, index) => [`d${index}`, { id: `d${index}` }])),
+};
+const active = { kind: 'active', enabledEntityIds: [], allEntityIds: [] };
+const devices = rows.map((_, index) => ({
+  id: `m${index}`, name: '', model: '', area: '', space: index % 5 ? 'main' : 'remote',
+  icon: '', entities: [], bindingKind: 'device', bindingRef: `d${index}`, bindingStatus: active,
+}));
+
+const measured = (fn) => {
+  const samples = [];
+  for (let i = 0; i < SAMPLES; i++) {
+    const started = performance.now(); fn(); samples.push(performance.now() - started);
+  }
+  samples.sort((a, b) => a - b);
+  return samples[Math.floor(samples.length * .9)];
+};
+
+let topology; let mapped;
+const normalizeMs = measured(() => { topology = normalizeZhaTopology(rows); });
+const mapMs = measured(() => { mapped = mapTopologies([topology], devices, registry); });
+const firstHoverMs = measured(() => resolveMappedTopologyHover(mapped, 'main', 'm1'));
+const repeatedHoverMs = measured(() => {
+  for (let i = 1; i <= 20; i++) resolveMappedTopologyHover(mapped, 'main', `m${i}`);
+});
+const result = { nodes: topology.nodes.length, links: topology.links.length,
+  normalizeMs, mapMs, firstHoverMs, repeatedHoverMs };
+console.log(JSON.stringify(result, null, 2));
+for (const [name, budget] of Object.entries(BUDGETS)) {
+  if (result[name] > budget) throw new Error(`${name} ${result[name].toFixed(2)} ms > ${budget} ms`);
+}

demo/docs/capture.mjs

@@ -132,6 +132,12 @@ const applyDocumentationState = (page, scenario) => page.evaluate(async (current
     card._infoCard = device;
   }
 
+  if (current.dialog === 'pdf') {
+    if (!(await card._pdfRuntimeLoader.ensure()))
+      throw new Error('documentation PDF runtime did not load');
+    card._pdfDialog = true;
+  }
+
   card.requestUpdate();
   await card.updateComplete;
   await frame();
@@ -154,7 +160,11 @@ const applyDocumentationState = (page, scenario) => page.evaluate(async (current
   }
 
   await settleCamera();
-  return { dialog: !!card.renderRoot.querySelector('hp-dialog') };
+  // Most dialogs render hp-dialog directly into the card, while the lazy PDF
+  // surface owns that shell inside hp-pdf-dialog's shadow root.  The host is
+  // the stable public capture boundary; reaching through its shadow root here
+  // would couple documentation capture to the dialog implementation.
+  return { dialog: !!card.renderRoot.querySelector('hp-dialog, hp-pdf-dialog') };
 }, scenario);
 
 mkdirSync(OUTPUT, { recursive: true });

demo/docs/screenshots.mjs

@@ -4,7 +4,7 @@
  * `scripts/docs-accept.mjs` (#246). Импортировать его из `capture.mjs` нельзя —
  * тот скрипт при импорте поднимает браузер и снимает картинки.
  */
-export const DOC_SCREENSHOT_VERSION = 1;
+export const DOC_SCREENSHOT_VERSION = 2;
 export const DOC_SCREENSHOTS = Object.freeze([
   {
     id: 'view-desktop', file: '01-view-desktop.png', fixture: 'visual',
@@ -72,4 +72,10 @@ export const DOC_SCREENSHOTS = Object.freeze([
     title: 'House Plan — synthetic home', language: 'en', theme: 'dark',
     viewport: { width: 1000, height: 900 }, capture: 'page', expectDialog: true,
   },
+  {
+    id: 'pdf-export', file: '10-pdf-export.png', fixture: 'visual',
+    space: 'golden-geometry', mode: 'view', dialog: 'pdf',
+    title: 'House Plan — synthetic home', language: 'en', theme: 'light',
+    viewport: { width: 900, height: 760 }, capture: 'page', expectDialog: true,
+  },
 ]);

demo/fixtures/wall-draw-click.mjs

@@ -0,0 +1,56 @@
+const CELL_CM = 5;
+const point = (x, y) => [x / 240, y / 240];
+
+const roomAt = (id, x, y) => {
+  const poly = [point(x, y), point(x + 24, y), point(x + 24, y + 24), point(x, y + 24)];
+  const wallIds = poly.map((_, index) => `${id}-wall-${index}`);
+  return {
+    room: { id, name: id, area: null, poly, wall_ids: wallIds },
+    segments: poly.map((a, index) => ({
+      id: wallIds[index], a, b: poly[(index + 1) % poly.length], cm: 15,
+    })),
+    walls: poly.map((a, index) => ({
+      key: `${id}-legacy-${index}`, a, b: poly[(index + 1) % poly.length], cm: 15,
+    })),
+  };
+};
+
+const roomGrid = (prefix, xOffset = 0) => Array.from({ length: 12 }, (_, index) =>
+  roomAt(`${prefix}-${index}`, xOffset + 8 + (index % 4) * 32, 8 + Math.floor(index / 4) * 32));
+
+export const WALL_DRAW_CLICK_POINTS = [
+  point(152, 144), point(176, 144), point(176, 168), point(200, 168),
+  point(200, 144), point(224, 144), point(224, 168), point(236, 168),
+];
+
+export function makeWallDrawClickFixture(remoteVariant = false) {
+  const primary = roomGrid('base');
+  const remote = remoteVariant ? roomGrid('remote', 300) : [];
+  const all = [...primary, ...remote];
+  const savedPartitions = Array.from({ length: 4 }, (_, index) => {
+    const points = [
+      point(8 + index * 28, 112), point(20 + index * 28, 112),
+      point(20 + index * 28, 124),
+    ];
+    return points.slice(1).map((b, edge) => ({
+      id: `saved-partition-${index}-${edge}`, a: points[edge], b, cm: 15,
+    }));
+  }).flat();
+  const edited = {
+    id: 'edited', title: 'Wall draw click', cell_cm: CELL_CM,
+    view_box: [0, 0, 1, 1],
+    rooms: all.map((item) => item.room),
+    wall_segments: all.flatMap((item) => item.segments),
+    walls: all.flatMap((item) => item.walls),
+    partitions: savedPartitions, wall_columns: [], openings: [], open_spans: [],
+  };
+  return {
+    model_version: 10,
+    spaces: [edited, ...Array.from({ length: 4 }, (_, index) => ({
+      id: `other-${index}`, title: `Other ${index}`, cell_cm: CELL_CM,
+      view_box: [0, 0, 1, 1], rooms: [], wall_segments: [], walls: [],
+      partitions: [], wall_columns: [], openings: [], open_spans: [],
+    }))],
+    markers: [], settings: {},
+  };
+}

demo/golden/accept.mjs

@@ -10,6 +10,9 @@ import {
   goldenAcceptancePlan, goldenAcceptanceRefusal, goldenSilentDeclarations,
   goldenWitnessRefusal,
 } from '../../scripts/golden-acceptance.mjs';
+import {
+  assertCaptureEnvironment, captureEnvironment, environmentNote,
+} from '../../scripts/capture-environment.mjs';
 
 const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
 const reviewed = process.argv.includes('--reviewed');
@@ -38,6 +41,16 @@ if (typeof report.chromium !== 'string' || !report.chromium)
   throw new Error('candidate report does not identify its Chromium build');
 if (!Array.isArray(report.results)) throw new Error('candidate report has no scenario results');
 
+// Среда приёмки (#455). Отчёт съёмки платформу не несёт — `run.mjs` входит в
+// корпус sourceFingerprint, и его правка объявила бы устаревшими бандл,
+// скриншоты документации и сам индекс эталонов. Но приёмка идёт там же, где
+// лежат артефакты, поэтому её платформа — честный признак среды кадров.
+const environment = captureEnvironment();
+const foreignAllowed = assertCaptureEnvironment({ kind: 'golden', stage: 'accept' });
+if (foreignAllowed) {
+  console.log(`Чужая среда приёмки разрешена осознанно: ${foreignAllowed}`);
+}
+
 const refusal = goldenAcceptanceRefusal(report.results, declared, declaredNew);
 if (refusal) throw new Error(refusal);
 
@@ -72,7 +85,18 @@ const witnessCheck = goldenWitnessRefusal({
   skipWitnesses,
   skipReason,
 });
-if (witnessCheck.refusal) throw new Error(witnessCheck.refusal);
+if (witnessCheck.refusal) {
+  // Приписка про среду — то, чего не хватало отказу: «свидетелей 0 из 10» без
+  // неё читается как «объяви больше сцен», и обход в одну команду выглядит
+  // решением (#455).
+  const note = environmentNote({
+    capturedOn: environment.platform,
+    acceptedOn: existsSync(manifestPath)
+      ? JSON.parse(readFileSync(manifestPath, 'utf8')).platform || null
+      : null,
+  });
+  throw new Error(note ? `${witnessCheck.refusal}\n${note}` : witnessCheck.refusal);
+}
 // Кандидат проверяется целиком, до всякого решения о замене: сломанный отчёт
 // не имеет права оставить каталог эталонов половинным.
 for (const scenario of GOLDEN_SCENARIOS) {
@@ -102,6 +126,9 @@ writeFileSync(resolve(baselineRoot, GOLDEN_BASELINE_MANIFEST), `${JSON.stringify
   acceptedAt: new Date().toISOString(),
   sourceFingerprint: report.buildFingerprint,
   chromium: report.chromium,
+  // Платформа рядом с версией браузера: провенанс среды, по которому следующая
+  // приёмка отличит «объявили не то» от «сняли не там» (#455).
+  platform: environment.platform,
   // #355: след приёмки в артефакте, не только в истории shell.
   witnesses: skipWitnesses
     ? { skipped: true, reason: skipReason }

demo/golden/baselines/baselines-index.json

@@ -1,14 +1,18 @@
 {
   "schema": 1,
-  "matrixVersion": 54,
-  "acceptedAt": "2026-09-02T05:20:33.824Z",
-  "sourceFingerprint": "baf59953cfd6eb3543f7da5af21787b20dc76f136b74782ae917f811d2fc1ab5",
+  "matrixVersion": 57,
+  "acceptedAt": "2026-09-07T02:12:07.024Z",
+  "sourceFingerprint": "be1f77110b0cecb8df31bb3975762395858023520ad1bbdb0a4840f2ea028077",
   "chromium": "151.0.7922.34",
+  "platform": "win32",
   "witnesses": {
-    "count": 90,
+    "count": 100,
     "floor": 10
   },
   "scenarios": {
+    "version-mismatch-desktop-dark-en": "ad08f293c728913549b0a71a1a514a60e3030d885acfb0c9951f1d9a1125a1d3",
+    "version-mismatch-touch-light-ru": "bf511c2e7e8714e30a12126c0c0b7f7ea7f5885e8c8ee0c475b364f6510c8702",
+    "version-mismatch-kiosk-attempted-dark-de": "d3d0863fe814d20f5b081de6ac14f8bbf7d559be019808e62cd6dcdc7abcaa70",
     "hidden-wall-diagnostics-plan-light": "4113474796ccb1b7b8c876fcb463e97eb77bb1ec96129195a0dafdcc7ccca334",
     "hidden-wall-diagnostics-plan-dark": "40c48868f0251aec3b1a14c0eef77a78cc7965420fb9b41f46f8190d1fdfd11a",
     "coincident-partition-before-dark": "daacbc763c81ad037b305fc34572729c063ec542d031821660b8d3d096a35d19",
@@ -20,36 +24,42 @@
     "split-corner-wall-thin-dark": "9a509f0fa7ee8503c54a508c313b47e10f8044f0a9931791d1cab83467dc3f90",
     "split-corner-wall-thick-dark": "51ac5e7594386e306f5ebc94e50d6c6d428fd6a4f26a447b28e1cbdd429afda7",
     "split-zero-divider-taper-dark": "eb43a7ba81ebd8b1f7c7f76306bb6205ea77a5cef3c21739d40ca540f0f7a1bf",
-    "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": "299401bd4b499876d40678593308b42ac8aa4d3328113f27ad5940fc3621184a",
+    "isometric-geometry-view-dark": "52b01bf23b31353900ea9174fdb4b9d27a586f8370fb9b00c4db6b9bbe7f73f2",
+    "isometric-geometry-view-light": "6ee98e56782feaabf784eea7d927ea35bdde054d8605484f4a5e92ea93f7c82a",
+    "isometric-live-layers-dark": "0d123ab0285fe3ad8487fb5263c3d8074fe2d2490091868ed648009039c04a3b",
+    "isometric-no-borders-dark": "7cd9e7d9797c920e7f3564a24b1fd6143b4da94a342af3b34d5a1cd8d584f11b",
+    "isometric-touch-kiosk-dark": "a6515349431d53688415e42a7711e8adf052eacf5e63a74f892fed60002c6d11",
+    "isometric-large-warm-remount-dark": "91f24287e8c3148fd6470ab4abc4f856f2863c2ae7372cd90a3770ddee48f209",
+    "isometric-stage3-overlays-light": "efb39c86776c507b25a8f1955f7371086cdca92e0df0ecb4c4127577fb925ba9",
+    "isometric-stage3-overlays-dark": "af2af4520240ebec87d84727fccc249c5a008b0ce4403bb9c2d37aa317d8a3e8",
+    "isometric-stage3-openings-dark": "a387ad33e2d238cd5f5088f9de2be8797f8b724d40599ef21eaae4ad0ff27b33",
+    "isometric-stage3-forced-colors-dark": "36bd5a28a336b2be2d33640dc57d8eb3992198c812c6cfb5c20bf7daa6a611f2",
+    "isometric-stage3-no-filter-dark": "277e79c005736ed81135f70517902ccea4d4300ee886e0cf05eb027e7b46d687",
     "geometry-view-dark-fit": "1ea111a2f68d71c2d2269ee65ac70b586b7d8a3a76f550bb1caf8d154bf42b26",
     "geometry-view-light-fit": "80bbb618619731dcb9dbd5e872785f32f1e52ff71ce989a2154c5f1218812eda",
+    "pdf-export-geometry-light": "34db73d337876dd4461dd4431c4909c85ea3a4a95fa5849e72839c8d18ff1e03",
     "vacuum-trail-smoothing-dark": "b33ddbfaed72f51e601576bbf87664a08578fbce5c22c69a11d83cc2644ff312",
-    "room-label-parity-view-dark": "0b4dd478e9b5e0f7acbf46c135309c8b1ed984b8c21f9c7ca0be9a25c10779b7",
-    "room-label-parity-plan-dark": "9112819b3af20153022dbc79940961c2776d70eaeb61716dad62df3c4c518665",
-    "room-label-parity-view-light": "a8a9915d2900a1347e85baa3df2ebde602904a9e35bbcc143fea7b1067c171f0",
-    "room-label-parity-plan-light": "354e6c78c6daf94305b9b0c9b4efa5caea89a327d3a81f634f1c3f5c6674524c",
+    "room-label-parity-view-dark": "eea967d733bea8c08242d9265e572dc13ee90894e0df71a4ca93cee7631f7fef",
+    "room-label-parity-plan-dark": "dfc804fa1aa5bc0222759463195bae0751513e0e428c8eae0bbc9d49fbc5a1b9",
+    "room-label-parity-view-light": "bb15fe24a803b1a3e07b778ccdda7c187bf8b85cd0d2f0c85e65bd77029d500e",
+    "room-label-parity-plan-light": "8ca4ce563f87d15c70b680ea61fcbf19ba0881123f9bb4bf76e6ea6f4e58c76d",
     "washer-active-cycle-dark": "0f38b85f2f912059a6380a0642a4d0314ea5c6fa6acb9568e1c4abbf4a7731a2",
     "washer-idle-cycle-dark": "08d5f10dc14b548e6a149c8d9c93f9b635854604cebd681644f30a1ca0b4ee4d",
     "day-cycle-dawn-dark": "cee9dea7017ee192dc69771822e53583df973dceecd46279c93079ba6bc730c5",
     "day-cycle-day-dark": "96fb83defa72f78d9e58413505f9250fae9cc766e21bdecb4b23374e04f15d43",
     "day-cycle-dusk-dark": "eca235de3abf21776b160d1b79cde3309952f0030bc2031a0ada7bdf2847d2be",
     "day-cycle-night-dark": "feec7492db1187b84e59cb627de9dd8d6d412f1dfc2643c3eab5cafe8f198f7c",
-    "geometry-plan-editor-dark": "0fc3d491560d87e9c9b0285729c50bd20bc85c959b487b40c4d47f8c9378e8f4",
-    "safe-resize-handles-clamp-light": "1a5adb25fd12180bc7b9781924abb4ffad637579ec1eba9e1a76481523080960",
-    "safe-resize-handles-clamp-dark": "bd0035cacc4d8c16c789754507a00f673b75cfecd1569635e673683e5b9f0247",
-    "space-tab-drop-before-light": "d174ac6b543672ebd649e7c9363c3bb79b22b417f7d899c08f755e273632f702",
-    "space-tab-drop-after-dark": "eb8d6bae0e32392234bd4462652e2a8f7831d7017bf5e8d8106c9d6f203b3eaf",
-    "plan-snap-endpoint-light": "dd4fc2254ae457e9ae5628b1e97ca0228699cdedf9b57f5358b2280dbebd6d6e",
-    "plan-snap-line-gaps-dark": "b8457468ef5d4b8b38b62c4a52950364d231aedb7549fcbcbd4ee6f9444569e1",
-    "wall-junctions-plan-preview-light": "3151196d0015c56a46b17a599513ced13dc5558c03106e98fb7d6dda5fad8de2",
-    "wall-junctions-plan-t-dark": "6d16a52e7cf362622778e5b5692b6f3ae4ec04c790e5117144fb0ca50f6c70b2",
+    "geometry-plan-editor-dark": "6fa29c51ac37449e53ff76afe17760a86325e160f53040c737619aae1095599d",
+    "safe-resize-handles-clamp-light": "98db89eb1ec29aa6297ac0bc10653c8efce16175833091d0e76dd033ad9f4a8e",
+    "safe-resize-handles-clamp-dark": "581f85ca93197ba796e72daa67402eebb7c64f13d4722b5d33943577837c8980",
+    "space-tab-drop-before-light": "2678c840a33ade95f8a038213a696132612cb9bae8290e467ae9c4ac2ee265e3",
+    "space-tab-drop-after-dark": "f4f3ab1bb986426f281753a101b4055fae1f5f1ed0c04c8d41071dfa260978f1",
+    "plan-snap-endpoint-light": "40f761e1a7a12e5113ec6e736c6d7176908d8a1585281c2c2f438bc1fee36e1d",
+    "plan-snap-line-gaps-dark": "e4e5e15a98e35ac26a5b0fe7ef674341fb55d8445587ccc25a81603e1ef92774",
+    "wall-junctions-plan-preview-light": "f6f450768912f37b3d91730cc38f43b399eab781e585bdbe6c9bb29458b56f4c",
+    "wall-junctions-plan-t-dark": "6c3748e931407079e3aad3ade77c46069ef75444c27405549d1610670a33ad95",
     "wall-junctions-view-dark": "ad23e5fb0ca9ba23f58ee4839cec489e7d05a28ef193d424b451a4020ef8ce0b",
-    "junction-patch-resilience-plan-dark": "80d032f5962dce27cd3577972e3d651d41080dae22c114fde8aec4c4b605f24e",
+    "junction-patch-resilience-plan-dark": "8ad87deb245097cd090f301d259710323cf4ea577cd8edaf16607d6ad8a3d29d",
     "junction-patch-resilience-view-dark": "4ba710fd6859f958ad6c576a01d0b240a3b1723fe9df54f8cabd971414a943a6",
     "wall-union-isolation-view-light": "426ef2ada0e69febd73ab305aa99b600a95e69db68dc30dae4c5288ee1151604",
     "wall-union-isolation-view-dark": "215ed9d8cba31c5de4cb9d0e2b347bf0c96c8d1bba4d35feca57d6f66fc25322",
@@ -57,27 +67,27 @@
     "orthogonal-strip-cell-5-view-dark": "05cdd744d09025719eda4c5e68cf3ebc5d7d201afd3028da91262d0f4874c126",
     "orthogonal-strip-cell-1-view-dark": "9c0f91b11d47f1c5df4476774ae6028db21dc15cc6fb81d9f80009e0fa86bffe",
     "wall-key-roundtrip-view-dark": "cc6f755c03b1a586684627fc1dc27eb1aa28d2673a6c79bcb687da94a6bf9b3b",
-    "isometric-wall-junctions-dark": "d1956cbbde9a6a02953ce80eb8a0f74ca06ea268a4c60bb09b5b3981c26d9731",
-    "opening-placement-door-thick-wall-dark": "d986d82fe68bec4b0b0556870d3ec7de280a00acb42cf0165a3d64f91f994bed",
-    "opening-placement-passage-thick-wall-dark": "f53908dbdf8cf6681c97317398e8a04cd98ebacdbc81571c2d15d38b2599e049",
-    "opening-placement-passage-thick-wall-light": "f7bdf033bbc511b34269044c450f8c93a3493e27bbbcf758050b7798197efd80",
+    "isometric-wall-junctions-dark": "af692b2c01293c59cc74e5731309e6612c913ca1c8384572fd1cb67a19d0f902",
+    "opening-placement-door-thick-wall-dark": "9d587eff0c2561ef5f84e9280cd812fa6e9af7cf6ff00c922d275796774ba513",
+    "opening-placement-passage-thick-wall-dark": "6ed48b39c0e11fbf4b0df7d3e4dad8078e5b17694f1a780936a864bebd0c1c57",
+    "opening-placement-passage-thick-wall-light": "3d4e3a5d9b67f2450fab9ccc0f5dc91f4485080582377de904f16ea1d62fbafa",
     "opening-symbol-room-wall-light": "c487c11f12b2bba1473559a82af3320b7995fa9c8d1b379274b942e431930beb",
     "opening-symbol-diagonal-partition-dark": "77101350b15845207644b6df86a3bc5f48b4dc873b9cfd7443c0d23507412de3",
     "opening-symbol-flip-pairs-light": "c2d9102921483da1d0216ed9bc55fc9112d67762f159df8af64a277f0db0acf4",
-    "isometric-opening-symbol-parity-dark": "1e254ed43da00a16d3048e9a2d29db0a43c7790991b1006ecb7205d002bd1f63",
-    "geometry-devices-editor-dark": "7c4072fce11f91b2c894bdb5f4f9113e72089306d629c995d38dfd17f2b65cc8",
-    "device-inbox-desktop-en-light": "89587944da06872f610da33e8e39441d108cb34849d8b09d4925bff4d0977565",
-    "device-inbox-desktop-ru-dark": "fe9506408fc198c167f2d4b9cfe91bd9fdfb722b311772457ae44c9d06248680",
-    "device-inbox-narrow-ru-dark": "3ddb3b66a613c6406d3d9ce2d4d479c8d84eff04acd9b5b2dce02c4c777fc738",
-    "geometry-decor-editor-dark": "4023e36ff4521011153983538e4a43ad80efd92bf07d523c333982bbd2f80ad6",
+    "isometric-opening-symbol-parity-dark": "e2ead596818f6182bd2478dc3823f31312d361080c99afbb9c7f7d1862cf781c",
+    "geometry-devices-editor-dark": "e273c4fe49619a5856a9212ff6261803640e5afa79b841edfccf5a4056e0264d",
+    "device-inbox-desktop-en-light": "a73761da0594ba2138f098d971d74566f9915f59a563fd55295add241145ba36",
+    "device-inbox-desktop-ru-dark": "5a9eb32ffb7f408c6bf8adca9d76b0d01d7b0b514f8b33a01e500f9230541f1a",
+    "device-inbox-narrow-ru-dark": "65c46b7311f850f305147d75a24ddeded67c9e8b18ea362c88b9964c50a5b727",
+    "geometry-decor-editor-dark": "2f8a3742166c10c0a5aa1239c9b6b7d908e7e578dc43229274b17d015c47503c",
     "tray-wide-selection-en": "5a535b457b8b274ff25085ee992aebd95d756415afe1321d0aadee70610d5801",
-    "tray-wide-tool-ru": "56c09bb397b76b7e5c6f4d7eaf7ab59e5d96faa409e553c45c6ce7605e9a9418",
-    "tray-medium-group-en": "b38abb69d1fac7414fc24d6cda6b5698eb861f8af94054605902e8529fe1e993",
-    "tray-medium-selection-ru": "b53f9513b167a33cffed2177603ae5b562264a83d5544d938c2af42ec8a551a5",
+    "tray-wide-tool-ru": "99abefe9c5b0f21356e87b46fc6d6d615cf9b799614c14bf8fffa0261fd9059a",
+    "tray-medium-group-en": "afdb651c687cabda48e62d426b9ef4926a23caa86904fe6fa2c163930070b2bd",
+    "tray-medium-selection-ru": "5d78f5d818514ab80a4fb2949274edffd372e0d2e41bc3ccf39a22fd7c993f6b",
     "tray-narrow-palette-en": "ae23f1b1384bec23ec272156cb2b7d3fe4088addaefa2f575bc1daa0480569a1",
-    "furniture-categories-light": "02ce65879aca968d05c7400e32d3f38c73a53f3bc036ee306fdf851ed84ed88c",
-    "furniture-variants-dark": "f52db569690a67e84701aeb79cc8967c9ee117b543fd9bf3d6fb8c3fee7a660b",
-    "furniture-variants-light": "4a78f688423f0f0946f50ec1a92fe9a3de5bfa288c7e153425c1beadf5c5f839",
+    "furniture-categories-light": "1aae9b6166146b06c6571730761daed5690ea50769e6dc618a66c19339f5d834",
+    "furniture-variants-dark": "aa15801cc56ab488e9563e05d15694db48294dd4f3d7e5bc238b4f79ec8d9b7b",
+    "furniture-variants-light": "286269d08ddcc086747d0703a59cd03bac29b11b69839364c01cb8492a00602d",
     "furniture-placement-preview-light": "f983eda1bf42e27d17afb78eada8b96b192a7e91bebb0c70e6766994000aabe3",
     "furniture-plan-art-dark": "e83a8c40add2bf33af304f86ad29fc77d8d47bd7228f17c152e962f3431e0c50",
     "furniture-transform-light": "3e37e03457bac87c9d7eaf6bbeb0f4054fb6e6a66a7da5953714446a92ccf296",
@@ -133,33 +143,33 @@
     "large-house-zoom-040-dark": "5601d5ce3b1fe79365984301872a851d6c2e81878ec6f6cc3b88aab811d8609a",
     "large-house-zoom-250-dark": "7abb72baba00ed035d9f7519b99e1d9f872a6cef81861ed096a511fe9320471f",
     "large-house-warm-remount-dark": "441c32f130b8f291582482fa6445f9c85f6f13c61b956020d4fa1d6153094efa",
-    "device-dialog-desktop-en": "465175fc9960c7ceb5208cf62f919381d56179ef12a93bee20e5c7af63757e7a",
-    "device-dialog-mobile-ru": "8128783f4e9f9ff301f15db9fa7388b51aa7e8a4a74ac0aaf962b21ecda52c78",
-    "device-dialog-desktop-de": "8440d4e980fac5df53142b6b118e527d9c0272e7515b65faaba6a58bc9441075",
-    "german-view-mobile-light": "55112787d9a26be66dfd8b724115962c4b891d1f8276b7b5b36b0ff25da48257",
-    "toggle-entity-dialog-desktop-en": "7a8ac3071d8bb3f79f2bfe724d0138e2b309baab3104ef8afb0b2b081c8b82b1",
-    "toggle-entity-dialog-mobile-ru": "d3062e76da27218cac45ca4c76f34b358d9cb98e85288f24e64b7de1bcca949d",
-    "device-help-popover-light-ru": "c2146f13d03841c395b0772f1a21de358c62a8703d3d02e7d026fac8ae29955e",
-    "decor-color-popover-mobile-ru": "c65318327c6e4631c769419e791a749d667b4dfc36f2e3fc46d6fac53180cf1b",
-    "decor-color-popover-desktop-en": "60de64b1bc072327cb88d2e876732d50d5cb7441c850f52b7af6f4ed5c6de22b",
-    "general-color-popover-desktop-en": "762c20c3d0499c1ea444e5d980eec4e78c7112455589b5202010f53a8b51099c",
-    "settings-help-zoom-200-en-light": "bb1192a52bab5ebc6984a5d799a32d05f9ce374ce6b493f5f618b639eedce8d5",
-    "settings-help-zoom-200-ru-dark": "13e7fdd19017c38a5659394e622ff54ac8a426f9cb6e85b3248864767aa9f42b",
-    "support-desktop-empty-light-en": "fecabb63521f258acc66ecdf7a438db10c73d0eac39618c55fb51287080f01f5",
-    "support-desktop-preview-dark-en": "a866aa74e3385ac45e837b328d64ed65bc4b108eb9dc4149fcccf393975e72b6",
-    "support-phone-validation-light-ru": "7a461c00631a05872b9aab1f4c0b0b65d1c918273ff06bba25c7bd2e87fba1ca",
-    "support-phone-success-dark-en": "81f83402933a573002581646d0b322f3770f3df41d5334373315ed5ad4974883",
-    "support-relay-error-light-en": "e9a9ad906e106eedfa6e84c592325f1604eb64c89c51135c076ac87a6a0766b2",
-    "support-tablet-preview-dark-ru": "1264e005cd764408edb9b285a5dfbe92ceb90cb925f624b8f65cd47edb96c0c9",
-    "device-ripple-color-popover-mobile-ru": "d9ebf83ad0d2995b46f6174daf6e21ca5404952afa308ddd3a66ecefcee565d0",
-    "space-room-color-popover-desktop-ru": "9bbbcf9c5ea6ff5490b500be8cb3086af9d368d14ca50c304f42a697e296ece1",
-    "backup-full-preview-desktop-en": "0fbd23a92121668001faf5c9ed555a31107704f3074d1791709c8436517d3d1f",
-    "backup-plan-only-export-desktop-en": "ce66fb57edbc87d56355b0d73a2d4203a67c275d5927d400ef1758ac0b607b34",
-    "backup-space-preview-mobile-ru": "82cd93cb495ad77b92d635b4a3715601b1ae0e5e2974edcbbd461fe872c75bad",
-    "optimize-preflight-dialog-dark-en": "101e1a97c6229c693a4edfb4878c6a4564132d6fbcaddd6276cb25aefa429260",
-    "optimize-preflight-dialog-light-ru": "4f34a59baa95b7ad0ad3dbb47f23996537878f6b666dc9111236713f513de97e",
-    "optimize-orphan-references-dark-en": "c8122eda61a52ead0f3609b9872b513004ffbc44c1d4928ec11e5d3b5978af78",
-    "optimize-orphan-references-light-ru": "3cc0b16af015cf695f8bd278dee4d76b160639021a33bc3a28441fb72a5e8e5c",
+    "device-dialog-desktop-en": "f3a3a45dad2cc22e692366114a4f87272b39ba261c1509e8a501dbfb82b6584e",
+    "device-dialog-mobile-ru": "7ac796286ab4e65275838b4095ea3f16491311f99fd98cad3bbb475c6061e31c",
+    "device-dialog-desktop-de": "9d39d3e73a3f36171e8cc7c930bcb43bfbfd788e31db0f584962300a2b00ca93",
+    "german-view-mobile-light": "dc252c1a0ced7c636dfbd5cc3113abe546d568b9c62e4812326ab604dfd4e5cd",
+    "toggle-entity-dialog-desktop-en": "3ea2bb828b554b6fb544b77fdef2af947e45af632769f4deab03c6adf195fa68",
+    "toggle-entity-dialog-mobile-ru": "2d433f3f1fab9e9d4c3d413c302ac0d3b44a2d46ec9ecbf098c3063da6f1df04",
+    "device-help-popover-light-ru": "1905d843c715b5d1f1dbfe06ca5cbcb8f0fea27f26301bfc1b826227334d10b2",
+    "decor-color-popover-mobile-ru": "dbe9b01e848d3f2776ac74c6bad0134c978b04c07c37b674ca7c823aff5fcd33",
+    "decor-color-popover-desktop-en": "034cf59419f2e940e5fd05be10f441714291a90a2043a7cfcd6e1cda249a1292",
+    "general-color-popover-desktop-en": "16c7b7c206970a6f36c5c70cf493d3e04ea6509a89c65751c83842096c1550d6",
+    "settings-help-zoom-200-en-light": "a6f49b4d0a171dc5f74d409c6e7df0e1c57bc52086b3a66dd794efde1236eef8",
+    "settings-help-zoom-200-ru-dark": "90e9052fa339ada6a8c05b1732a5786bee9b61266d1a9305f316c4fc35c03df2",
+    "support-desktop-empty-light-en": "87d6db3b1d5a5d58034ddba0612c59bc1d3ce42ad43e812a6c28ce42a38ff499",
+    "support-desktop-preview-dark-en": "4ab4a46a6f06064df60f3bb7ba62229398061c9407380050269d7523b502a2d4",
+    "support-phone-validation-light-ru": "37059c99431d6890d1f1a66444c7e853e51387655cd1ee6474063299281f2b1f",
+    "support-phone-success-dark-en": "8471706c17e14d199e6d8ca329d4cfe15cb7910f9d0aec28bfd839f49e002612",
+    "support-relay-error-light-en": "ea6cfd6385561562eea3300b802e5036ac63dfb21bad7e9b7bb57e4dbb5e605e",
+    "support-tablet-preview-dark-ru": "549310cc299c346f5495abbd386e5e56b011c812d815cbbe39871165cf9d7981",
+    "device-ripple-color-popover-mobile-ru": "93d04a498e16ac7e98bd420bef566645c2215488138568c5b150110380aa782e",
+    "space-room-color-popover-desktop-ru": "c4cb215714ce98728c2e7b9d3f083055650b639302578874d28067c741ba0cf8",
+    "backup-full-preview-desktop-en": "c8fbd39e63e6ff3f8158ae36ae4ef299ad7635bf41dc490547cd6ad56aeffdfc",
+    "backup-plan-only-export-desktop-en": "cf00fa1784b7a4c4aa3153802ca6a79afbe988ae1b70a9c5ba1983aba0863b4f",
+    "backup-space-preview-mobile-ru": "4575ba8783647518abbbe9903fd915ec0d3caceaa08a70fa70cf8bf8e7b08356",
+    "optimize-preflight-dialog-dark-en": "fa16f7caa6ab75db6a76ada7d21450cee488900a7dc70505867bed7c6f5325d5",
+    "optimize-preflight-dialog-light-ru": "14ff81985b7564e23f9d1124c2be44a31b017186691745a6092fe918e79328e1",
+    "optimize-orphan-references-dark-en": "d6a59ae1f7accef832ac6458c618ab4719d110c0154a4d607454fc7dab34d8a1",
+    "optimize-orphan-references-light-ru": "88455ebb34a052abcc75cd4454f1256cebb11ee0a8b880b8507235c332f8ae14",
     "card-editor-invalid-default-floor-light-en": "dbf251ece014cfee252e0dcb2d7c00eda66aa4b5bd125e4c83e248d4319d24b3",
     "card-editor-invalid-default-floor-dark-ru": "422b74bb391b87e383350247ef1bc1f10ca48c8f6fe418f75bde94e62e3b8bc0"
   }