houseplan-card/docs/reviews/CODE-REVIEW-126-r2.md

CODE-REVIEW-126-r2

• Issue: #126 — «Смена area устройства в HA не переносит иконку в новую комнату, если позиция была сохранена»
• Этап: code (PROCESS.md §2.7)
• Заход: r2 · блокирующих циклов 1/4
• Диапазон: origin/dev...HEAD, HEAD = 26cb00db
• Вердикт: зелёный · High: 0 · Medium: 0

Скоуп раунда

r1 (код-ревью, docs/reviews/CODE-REVIEW-126-r1.md, вердикт жёлтый на SHA, названном в вердикте как 34b99b95) нашёл один High и один Medium, оба в скоупе задачи. Ревью этого раунда — по дельте, а не заново, согласно PROCESS.md §2.9: причина не в ребейзе на ушедший вперёд dev (git merge-base HEAD origin/dev = 5c8cb58e = сам origin/dev, т.е. база не сдвигалась) и не в новой подсистеме — исправления r1 локальны к тестовой обвязке и одной строке продуктового кода.

SHA-несостыковка (зафиксирована, не блокирует). 34b99b95 из вердикта r1 не существует в текущей истории (git cat-file -t 34b99b95 → Not a valid object name). По временным меткам коммитов (633cb20e 09:24 → b319fc95 09:29 → 61dd7ccb 09:44, добавляющий сам CODE-REVIEW-126-r1.md) и по содержимому диффа b319fc95 — это тот же логический снимок, что был назван 34b99b95 в вердикте: тот же продуктовый коммит + тот же screenshot-refresh, непосредственно предшествующий добавлению документа ревью. Хэш разошёлся, видимо, из-за локального reword/amend перед публикацией. Использую b319fc95 как границу дельты — контент, а не сам хэш, подтверждён построчно ниже.

Дельта — коммиты d5268086 («fix: harden HA area relocation regressions», User-Visible: no) и 26cb00db («docs: refresh canonical screenshots for area relocation», User-Visible: no), диапазон b319fc95..HEAD:

demo/golden/harness.mjs          |  15 ++-
demo/golden/matrix.mjs           |  38 +++++++
demo/smoke_area_relocation.mjs   | 205 +++++++++++++++++++++++++++++++++++--
demo/smoke_discovery_filters.mjs |  15 +++
demo/smoke_marker_stay.mjs       |  10 +-
demo/smoke_subarea.mjs           |  11 +-
demo/smoke_vacuum_firstuse.mjs   |  21 ++--
demo/srv/demo.html               |   5 +
src/houseplan-card.ts            |   5 +
+ dist/**, custom_components/houseplan/frontend/** (сгенерированные копии, класс D)
+ docs/images/*.png, docs/images/screenshots.json (класс C, канонические скриншоты)

Продуктовая логика src/device-area-relocation.ts, src/types.ts, backend (validation.py, websocket_api.py, config-schema.json), unit-тесты резолвера — не изменились между b319fc95 и HEAD (git diff --stat по этим путям — пусто). По §2.9 п.4 повторно проверяю только те AC, чьё доказательство дельта задевает: AC-доказательства через browser smoke (AC2, AC6 §19 ТЗ) и Save-диалог устройства (AC-контракт roomTouched, r1 H1). Остальные AC наследую из r1 без повторной проверки — см. раздел ниже.

Закрытие раунда r1

Находка r1	Чем закрыта	Где это видно
H1 (High) — demo/smoke_subarea.mjs и demo/smoke_marker_stay.mjs писали _markerDialog.room напрямую, минуя реальное DOM-событие #marker-room; после введения roomTouched эта запись стала no-op, smoke проходил vacuously (smoke_subarea реально падал 6/14 на 34b99b95)	smoke_subarea.mjs теперь берёт реальный <select id="marker-room"> из renderRoot, ставит .value и диспатчит настоящий change-event (bubbles: true, composed: true), затем читает _markerDialog.roomTouched === true как отдельную проверку realRoomChangeMarkedTouched. smoke_marker_stay.mjs (тестирует другой инвариант — что позиция НЕ мигрирует при смене комнаты) явно проставляет roomTouched: true рядом с прямой записью room, восстанавливая запись как реальное действие, плюс добавлена проверка roomChangePersisted	demo/smoke_subarea.mjs (diff), demo/smoke_marker_stay.mjs (diff). Прогнано мной: node demo/smoke_subarea.mjs → 15/15 true; node demo/smoke_marker_stay.mjs → 8/8 true (см. «Как проверялось»)
M1 (Medium) — demo/smoke_area_relocation.mjs покрывал 4 из 8 сценариев §19 ТЗ; cross-space, standalone entity marker, explicit-override/composite exclusion и cold-start backfill были доказаны только на уровне чистого resolver в unit-тестах, не через production bundle	Добавлены сценарии crossSpaceRelocated (переезд между пространствами через тот же _syncAreaRelocations), standaloneEntityRelocated (entity-маркер без device), explicitOverrideExcluded (явный marker.room_id/area не трогается), compositeGroupExcluded (markerless light-group не переезжает и не получает attention), coldStartBackfilled (отдельная свежесозданная карта, первый authoritative rebuild, delete-before-config порядок)	demo/smoke_area_relocation.mjs (diff, +205 строк). Прогнано мной: node demo/smoke_area_relocation.mjs → 18/18 true, все пять новых полей включены

Оба закрытия проверены исполнением теста на текущем HEAD, не пересказом коммита автора.

Унаследовано из r1

Без повторной проверки в этом раунде — дельта этих путей не касается:

• Резолвер и его контракт (§8/§11/§12 ТЗ: duplicate-Area guard, known-binding area-changed, backfill по сохранённой точке, explicit wins, eligibility virtual/unverified/removed/composite) — src/device-area-relocation.ts, проверено в r1 построчно против ТЗ, unit-тесты test/device-area-relocation.test.mjs подтверждены как способные падать. Документ: docs/reviews/CODE-REVIEW-126-r1.md (раздел «Что проверено и корректно»), SHA b319fc95 (=34b99b95 вердикта).
• AC3 (read-only/static truth) — space-render.ts/space-geometry.ts (markerPos, ignoreSaved), подтверждено smoke staticReadOnlyProjection/ staticMadeNoWrites в r1. Файлы не менялись в дельте.
• AC9 (fail-safe, delete-first, retry) — _syncAreaRelocations (houseplan-card.ts:5137-5251 на момент r1), проверено по коду и smoke failedConfigRetryable/configRetrySucceeded. Единственная правка этой области в дельте — добавленная строка _saveConfigDebounced.cancel() внутри уже проверенного в r1 блока (см. «Новое в дельте» ниже), остальной контур не тронут.
• AC10 (no Undo после relocation) — _cancelDeviceDrag()/ _devicePositionHistory.clear(), прочитано в r1, не покрыто отдельным smoke (низкий риск, отмечено в r1 как принятый пробел).
• Backend схема и import/export (marker_area_snapshot, лимит MAX_KNOWN_DEVICES/MAX_MARKER_AREA_SNAPSHOT, tests_backend/test_validation.py, tests_backend/test_ha_import_export.py) — не менялись в дельте, приняты в r1 по коду и тестам.
• Changelog/трейлеры продуктового коммита — 633cb20e (User-Visible: yes) уже содержит правки docs/CHANGELOG.md и docs/CHANGELOG.ru.md в том же коммите; это проверено в r1 и не изменилось.

Источник: docs/reviews/CODE-REVIEW-126-r1.md, диапазон на SHA 34b99b95 (содержимое = b319fc95 в текущей истории, см. «SHA-несостыковка» выше).

Новое в дельте (не из r1, самостоятельно проверено)

Автор указал ещё два самостоятельно найденных и исправленных дефекта, не поднятых r1. Проверены по коду и исполнением:

1. Дублирующая config-запись при пересечении Area-sync с debounced пользовательской записью (src/houseplan-card.ts:5214, if (this._saveConfigDebounced.pending()) this._saveConfigDebounced.cancel();). Прочитано: _saveConfigDebounced (houseplan-card.ts:7695) при срабатывании таймера просто вызывает _writeConfig() над текущим this._serverCfg — не хранит отдельный payload. debounce().cancel() (houseplan-card.ts:756-760) очищает таймер без trailing-вызова. Поэтому отмена ожидающего таймера прямо перед синхронным await this._writeConfig() не теряет пользовательскую мутацию (она уже находится в this._serverCfg к моменту rebuild) и убирает гарантированный повторный сетевой write несколько сотен миллисекунд спустя. Корректно, находок нет.
2. Golden-сценарии и два «legacy»-смока читали устаревший снэпшот cfg/ writes до one-time provenance-бэкафилла #126, из-за чего добавление резолвера начало превращать чужие тестовые фикстуры (намеренно расположенные вне «своей» HA-комнаты для проверки иконок на фиксированных координатах) в сценарии релокации и портить write-count инварианты. Правки изолируют это через markerAreaSnapshot-«прошивку» golden-фикстур (demo/golden/harness.mjs, demo/golden/matrix.mjs) и через ожидание _areaRelocationWrite/_writeChain перед снятием baseline в smoke_discovery_filters.mjs/smoke_vacuum_firstuse.mjs. Оба поля — реальные, существующие свойства (_areaRelocationWrite: houseplan-card.ts:1013, _writeChain: houseplan-card.ts:7489), не опечатки с молчаливым undefined. Подтверждено исполнением (см. ниже).

Как проверялось

Дешёвые гейты. Инструкция ревью подтверждает Validate на 26cb00db — success (https://github.com/Matysh/houseplan-card/actions/runs/33368059072), это покрывает npx tsc --noEmit, npm test, npm run build на точном SHA; повторно не гонял. Дополнительно сам прогнал (дёшево, диф трогает src/**):

• npm run build — green (несёт tsc --noEmit);
• npm run bundle:sync — green; git status --porcelain после — пусто, т.е. dist/, custom_components/houseplan/frontend/, demo/srv/assets/ синхронны с committed-состоянием на этом SHA;
• node scripts/check-docs.mjs — green (диф трогает src/houseplan-card.ts).

Smoke, отобранные по дельте и риску. node scripts/smoke-select.mjs --base b319fc95 --head HEAD:

Изменено файлов src/**: 1 · символов проекта на изменённых строках: 1
Прямое совпадение (9): _saveConfigDebounced →
  smoke_config_writer, smoke_danger_confirmation, smoke_decor_default_persist,
  smoke_discovery_filters, smoke_grid_snap, smoke_optional_space_model,
  smoke_save_race, smoke_v8_draft_write, smoke_vacuum_firstuse

Прогнал все 9 «прямых совпадений» плюс три smoke, изменённых в дельте напрямую (smoke_area_relocation, smoke_subarea, smoke_marker_stay — уже учтены/включены выше):

Smoke	Причина прогона	Результат
smoke_area_relocation.mjs	изменён в дельте (M1 r1)	18/18 true
smoke_subarea.mjs	изменён в дельте (H1 r1)	15/15 true
smoke_marker_stay.mjs	изменён в дельте (H1 r1)	8/8 true
smoke_discovery_filters.mjs	изменён в дельте + прямое совпадение	OK
smoke_vacuum_firstuse.mjs	изменён в дельте + прямое совпадение	27/27 true
smoke_config_writer.mjs	прямое совпадение _saveConfigDebounced	OK
smoke_danger_confirmation.mjs	прямое совпадение	OK (19/19 true; stderr-стек в выводе принадлежит намеренному error-path тесту markerCancelAccept, не сбою)
smoke_decor_default_persist.mjs	прямое совпадение	OK
smoke_grid_snap.mjs	прямое совпадение	6/6 true
smoke_optional_space_model.mjs	прямое совпадение	6/6 true
smoke_save_race.mjs	прямое совпадение	4/4 true
smoke_v8_draft_write.mjs	прямое совпадение	6/6 true

Итого 12/12 запущенных — зелёные. Остальные ~198 smoke не отбирались инструментом на этой дельте и не прогонялись — полная матрица является предрелизным гейтом, не гейтом ревью.

Golden. Дельта редактирует demo/golden/harness.mjs и demo/golden/matrix.mjs (новое поле markerAreaSnapshot в фикстурах) — это прямое изменение исходных данных для видимого рендера, поэтому прогнал npm run golden:verify целиком: 60/60 passed, 0 failed, включая два сценария, которые правка непосредственно защищает (orphan-references-*, где markerless-фикстуры намеренно вне «своей» комнаты).

Не прогонял: npm run invariants (дельта не трогает рёбра комнат, записи толщины, layout-схему или open_spans; src/space-geometry.ts не менялся между b319fc95 и HEAD); python -m pytest tests_backend (backend не менялся в дельте, r1 уже проверил точечно); performance-профили (не названы в AC, не задеты дельтой); полный smoke_* набор (~198 файлов, не отобраны инструментом и не требуются объёмом дельты).

Единый источник чисел

Дельта не вводит и не меняет ни одной пользовательски видимой величины (только тестовую обвязку и внутренний debounce-guard) — раздел «одно число — один источник» неприменим к этому раунду; актуален вывод r1 (не поднимал находок по этому классу).

Итог

Оба блокировавших находки r1 закрыты и подтверждены исполнением тестов, а не текстом коммита. Два дополнительных самостоятельно найденных дефекта (debounce double-write, golden/legacy-smoke изоляция от provenance-бэкафилла) читаются корректно и подтверждены прогоном golden (60/60) и целевых smoke (12/12). Новых находок нет. High: 0, Medium: 0 — задача готова к S8.