houseplan-card/docs/reviews/CODE-REVIEW-385-r1.md

CODE-REVIEW-385-r1

• Issue: https://github.com/Matysh/houseplan-card/issues/385
• Этап: code (PROCESS.md §2.7)
• Заход: r1 (первый цикл код-ревью для этого issue) · блокирующих циклов израсходовано 0 из 4
• ТЗ: docs/specs/385-audit-lows.md, ревизия 2 (принята SPEC-REVIEW-385-r2, зелёный, 687b2966)
• Коммиты в диапазоне origin/dev..HEAD:
  • 353724b2 fix: audit-lows batch from the v1.69.0 audit (#385) — User-Visible: yes, Issue: #385
  • 564bf419 build: refresh bundle trees for #385 — User-Visible: no, Issue: #385

Скоуп

Четыре точечные правки по ТЗ rev2:

• (а) src/houseplan-editor-runtime.ts — клик по уже выбранному binding-кандидату (список HA-сущностей, :12305-12313) и повторный выбор уже активного virtual-режима (:12252-12260) становятся no-op: valueSource/valueSourceTouched и бейдж не трогаются, сбрасывается только bindingOpen.
• (б) src/devices.ts — rewriteMarkerControlReferences больше не сажает value_badge: undefined / value_source: undefined условным спредом.
• (в) scripts/process-gate.mjs — предикат релизности вынесен в isReleaseCommit(subject, one) (единственная копия выражения, оба дизъюнкта); parseRecords вызывает дорогой releaseSourceViolationsOf только когда isReleaseCommit истинен для этого коммита.
• (г) custom_components/houseplan/import_export.py — параный комментарий у обоих форматов обезвреживания (value_badge полями, value_source удалением ключа) + объединяющий pytest.

Плюс тесты (test/devices.test.mjs, test/process-gate.test.mjs, tests_backend/test_ha_import_export.py), два новых мутанта (scripts/mutation-gate.mjs), правка demo/smoke_value_face_source.mjs, ченджлоги, обновление трёх копий бандла.

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

Материал — git log --oneline origin/dev..HEAD и git diff origin/dev...HEAD построчно по каждому изменённому файлу (src/devices.ts, src/houseplan-editor-runtime.ts, scripts/process-gate.mjs, custom_components/houseplan/import_export.py, все тестовые файлы, scripts/mutation-gate.mjs, ченджлоги). Дополнительно чтением проверено окружение диффа: полный список мест, где _valueBadgeForBinding и d.binding = встречаются в houseplan-editor-runtime.ts (grep), чтобы исключить третий путь выбора binding, который спека просила перепроверить отдельно (раздел «Риски» ТЗ) — найдено ровно два места выбора значения (:12257/:12310), оба в диффе; третье найденное вхождение (:12275-12280, радио «from HA») не присваивает binding конкретному значению и не трогает valueSource ни до, ни после диффа — вне контракта (а).

Гейты прогнаны лично на 564bf419 (зелёного Validate на этом SHA не было):

Гейт	Результат
npx tsc --noEmit	чисто
npm test	1587 tests, 1586 pass, 0 fail, 1 skipped — совпадает с заявленным автором
npm run build + сверка трёх копий бандла	git status --short пуст после билда — дерево уже актуально
node scripts/check-docs.mjs	"Documentation checks passed (7 files, 10 external links)"
npm run bundle:budget	initial View 277 979 B / 300 000 B, headroom 22 021 B — совпадает с заявленным (+28 Б от базы)
node scripts/mutation-gate.mjs --id=same-binding-click-resets-source	поймано 1/1
node scripts/mutation-gate.mjs --id=release-proof-computed-for-every-commit	поймано 1/1
node demo/smoke_value_face_source.mjs (после npm run bundle:sync, локальный demo/srv/assets не в git)	все 16 полей true, включая sameBindingKeepsSource/sameVirtualKeepsSource (AC1/AC2) и регресс-ветку bindingResetToAuto
python3 -m pytest tests_backend/test_ha_import_export.py -k 385	1 passed (AC5)
python3 -m pytest tests_backend/ -q (полный, т.к. тронут import_export.py)	446 passed, 1 skipped, 1 error — см. «Не проверял/не относится»
node --test test/single-source-numbers.test.mjs	3/3 — диф не добавляет новую видимую величину, гейт для полноты

node scripts/smoke-select.mjs --base origin/dev --head HEAD: 2 файла в src/**, 1 символ на изменённых строках (_markerDialog), матрица 205 смоков, порог широкого символа 41. Вывод — НЕОПРЕДЕЛЁННОСТЬ: только слабая связь по общему имени _markerDialog (33 смока, включая уже прогнанный smoke_value_face_source.mjs). Остальные 32 не прогонялись: связь слабая (общее имя состояния диалога маркеров, а не конкретно binding-клика), smoke_value_face_source.mjs — прямое совпадение (это тот самый смок, который автор расширил под AC1/AC2) и уже покрывает сценарий диалога целиком (открытие/выбор/сохранение/переоткрытие/статическая карточка/tap). Инварианты модели (npm run invariants) не прогонялись — диф не трогает рёбра комнат, толщину стен, layout, marker.space, open_spans. npm run golden:verify не прогонялся — диф не меняет рендер/геометрию/стили (логика диалога, отбрасывание ключа, гейт-скрипт, экспорт-нейтрализация).

Находки

Блокирующих (High) находок нет. Medium в скоупе — нет.

L1 (Low, не блокирует, снимаю записью). scripts/process-gate.mjs:118-121 и :166 — предикат релизности (isReleaseCommit) действительно один и тот же и переиспользуется (AC4 выполнен буквально), но вспомогательный one(name) продублирован двумя разными реализациями: в makeCommit — через all(name)[0] ?? null на matchAll(/…/gmi), в parseRecords — через text.match(/…/mi). Поведенчески идентичны (обе находят первое ^Name:\s*(.+)$ без учёта регистра), и это подтверждено новым тестом (test/process-gate.test.mjs — коммит-бета с Release:-трейлером и стабильный релиз по subject дают одинаковую классификацию в обоих вызовах). Риск чисто будущий: если кто-то поменяет формат трейлера в одном one, не тронув другой, isReleaseCommit в parseRecords и в makeCommit разойдётся по входу, а не по логике предиката — сам предикат от этого не расходится (это то, что просило AC4), но результат классификации коммита — да. Не в скоупе AC4 (там речь про предикат, не про хелпер one), масштаб — рефакторинг не по этой задаче. Оставляю на усмотрение автора.

Что проверено и корректно

• (а) — оба места выбора binding в скоупе, третьего нет (проверено grep + чтением, см. «Как проверялось»); ранний no-op сохраняет весь драфт кроме закрытия списка, что буквально соответствует контракту ТЗ. Смок гоняет и успешный сценарий (сохранение source, предпросмотр, статическая карточка, реакция на unavailable), и обе новые ветки (а), не разрывая старую регресс-ветку bindingResetToAuto.
• (б) — условный спред верен: ключ появляется в выходном объекте только когда исходное значение (marker.value_badge/marker.value_source) было задано или было переписано на новый ref; для marker без ключа valueBadge/valueSource остаются undefined из : marker.value_badge fallback → ключ не создаётся. Тест test/devices.test.mjs бьёт по обеим веткам (голый маркер, маркер с существующим value_source).
• (в) — семантика гейта не изменена (для нерелизных null как и раньше, () => null больше не нужен — сравнение по значению, не по идентичности функции), дорогая проверка теперь гарантированно вызывается только для тех же коммитов, для которых isRelease истинен, потому что это буквально одна и та же функция isReleaseCommit, вызванная дважды с одним subject. Тест воспроизводит именно контрпример из ТЗ (бета-приёмка с Release: трейлером — второй дизъюнкт).
• (г) — асимметрия форматов задокументирована на месте, dropped_marker_links считает оба пути, pytest пришпиливает оба формата одновременно (не по отдельности, как раньше было бы недостаточно для AC5).
• Ченджлоги (docs/CHANGELOG.md, docs/CHANGELOG.ru.md) правлены в том же коммите 353724b2, что и код, запись только про (а), соответствует User-Visible: yes и разделу «Release-артефакты» ТЗ. Трейлеры Issue: и User-Visible: на месте на обоих коммитах диапазона.
• Три копии бандла (dist/, custom_components/houseplan/frontend/, houseplan-assets.json×2) синхронны с исходниками — билд с нуля не дал diff после коммита 564bf419.

Чего не проверял

• Полный browser-smoke матрицы (205 файлов) — не прогонял; инструмент дал только слабую связь по общему имени _markerDialog, прямое совпадение (smoke_value_face_source.mjs) прогнано и покрывает сценарий диалога целиком. Остальные 32 «слабых» смока не трогают binding-клик по названию и по факту (проверены выборочно по имени — smoke_binding_picker.mjs, smoke_binding_ui.mjs, smoke_dialog_zombie.mjs про открытие/закрытие диалогов и выбор HA-сущности, не про повторный клик по уже выбранной); полный прогон матрицы — предрелизная обязанность, не гейт этого ревью.
• npm run golden:verify — диф не меняет рендер/геометрию/стили/слои.
• npm run invariants — диф не трогает геометрию модели (рёбра, толщину, layout, marker.space, open_spans).
• Perf-профили — не названы в AC; (в) — только уменьшение работы гейта, ТЗ прямо говорит «бенч не требуется».
• tests_backend/test_ha_upload.py::test_upload_ok — упал с AssertionError на проверке типа daemon-потока при остановке aiohttp-сервера (_run_safe_shutdown_loop / threading._DummyThread). Файл и код upload не входят в диф этой задачи (диф трогает только import_export.py из бэкенда), само падение — про завершение потока, не про сериализацию маркеров/экспорт. Отношу к флаку окружения песочницы, а не к регрессии этой правки; целевой тест AC5 (test_issue_385_space_export_drops_badge_and_value_face_links_together) и весь test_ha_import_export.py (запускался в составе полного прогона) прошли зелёным.

AC — прослеживаемость

AC	Доказательство	Статус
AC1	demo/smoke_value_face_source.mjs → sameBindingKeepsSource; регресс bindingResetToAuto	прогнано лично, зелёное
AC2	тот же смок → sameVirtualKeepsSource (плюс бейдж не проверяется отдельным полем смока, но реализация в (а) обрабатывает бейдж тем же early-return — проверено чтением)	прогнано лично + чтением
AC3	test/devices.test.mjs "#385(б) rewrite never plants…"	прогнано в составе npm test
AC4	test/process-gate.test.mjs "#385(в) the diff proof runs only for release-classified commits…" + мутант release-proof-computed-for-every-commit	прогнано лично, мутант пойман 1/1
AC5	tests_backend/test_ha_import_export.py::test_issue_385_space_export_drops_badge_and_value_face_links_together	прогнано лично, passed
AC6	tsc/test/build/check-docs/bundle:budget — см. таблицу гейтов выше	прогнано лично, всё зелёное

Вывод

Все шесть AC доказаны автотестами, которые лично прогнаны и (там, где предусмотрены мутанты) умеют падать. Единственная находка — Low, вне критического пути, снята записью с обоснованием. Реализация точно соответствует ТЗ rev2 по всем четырём пунктам, скоуп не расширен и не сужен.

Вердикт: зелёный.