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

CODE-REVIEW-251-r2

• Issue: #251 — «Маркер выключателя гаснет, когда недоступна управляемая им лампа — читается как «выключатель offline»»
• Этап: код-ревью (PROCESS.md §2.7), заход r2, блокирующих циклов израсходовано 1/4 до этого разбора
• Ветка: issue/251-controller-target-availability
• r1: вердикт красный, High: 1 (H1 — golden-эталон device-icon-state-table-{light,dark} сломан diff'ом, не переприннят), Medium: 0. Документ: docs/reviews/CODE-REVIEW-251-r1.md. SHA, на котором получен вердикт r1, в коротком комментарии-вердикте issue не назван — сама находка процесса; восстановлен из тела документа r1 (таблица гейтов: «диапазон origin/dev..HEAD, HEAD f18b5b4»), а не из угадывания.
• Разбор по дельте (PROCESS.md §2.10): дельта f18b5b4..HEAD — три файла (принятие golden-baseline + правка одной смок-фикстуры + коммит документа r1), не меняет контракт поведения, не задевает новую подсистему, размер несопоставим с исходной задачей (b984f16). Полный разбор не требуется.

Дельта r2 → r1

$ git log --oneline f18b5b4..HEAD
268348d test(smoke): mark cover controller available
e09e449 test(golden): accept v1.67.0-beta.4 controller states
e8d86f4 docs: review document for #251        (артефакт r1, публикация конвейера)

$ git diff --stat f18b5b4..HEAD
 demo/golden/baselines/baselines-index.json         |   8 +-
 demo/golden/baselines/device-icon-state-table-dark.png   | Bin
 demo/golden/baselines/device-icon-state-table-light.png  | Bin
 demo/smoke_cover_plate_precedence.mjs               |   8 +-
 docs/reviews/CODE-REVIEW-251-r1.md                  | 201 ++++++++

e8d86f4 — публикация r1-документа шагом конвейера, класс C, не предмет этого разбора.

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

Находка r1	Чем закрыта	Где это видно
H1 (High) — demo/golden/baselines/device-icon-state-table-{light,dark}.png не переприняты под изменённый demo/golden/matrix.mjs (маркер golden-left-linkquality получил controls+tap_action, light.golden_light_three → unavailable); golden:verify/CI-job golden красны, docs/TESTING.md заявляет недоказанный AC6	Коммит e09e449 test(golden): accept v1.67.0-beta.4 controller states — полноценная приёмка через npm run golden:accept -- --reviewed по прогону CI golden на полном Linux-артефакте (Baseline-Reviewed: .../actions/runs/32617372743, Release: v1.67.0-beta.4), ровно как требовал вердикт r1, а не локальная перезапись.	Воспроизвёл сам: node demo/golden/run.mjs --mode=capture --scenario=device-icon-state-table-light → passed; то же для -dark → passed (было different, diffRatio 0.0014 при пороге 0.0005). sourceFingerprint в baselines-index.json (b674338…) совпадает с sourceFingerprint(cwd), пересчитанным на текущем дереве — эталон принят со свежего, а не устаревшего дерева.

Сопутствующая находка, всплывшая у автора при пере-прогоне (не была частью H1, не входит в бюджет циклов — обнаружена и устранена автором самостоятельно до повторной подачи): полный exact-HEAD прогон (.../runs/32618422055) поймал устаревшую фикстуру smoke_cover_plate_precedence.mjs — маркер p_remote (сущность sensor.remote, controls: ['light.hall']) не имел собственного живого состояния, и после отделения controller/target availability (b984f16) стал классифицироваться как unavail вместо мирроринга состояния цели. Коммит 268348d явно задаёт sensor.remote: st('online', {}) — тот же приём, что применён к фикстуре солнца на #89: дефект в фикстуре, а не сокрытие. Проверил разбором и экспериментом (см. ниже) — предмет теста (target-state mirroring) не изменился, тест сохранил способность падать.

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

Без повторной проверки — код и AC1–AC9 не менялись между f18b5b4 и HEAD, задокументировано в docs/reviews/CODE-REVIEW-251-r1.md на SHA f18b5b4:

• Продуктовая семантика §6.1/§7.1/§7.2 ТЗ (controllerAvailability() в src/device-presentation.ts, unavailableToggleTargetNames() и confirm-race в src/device-toggle.ts/houseplan-card.ts) — читана построчно, юнит-матрица и 4 мутационных гварда подтверждены r1.
• AC7 (модель/схема/конфиг не меняются), AC8 (документация, i18n, changelog RU+EN в b984f16), AC9 (bundle parity в рамках реализации).
• Трейлеры и провенанс продуктовых коммитов ba0c787/b984f16/f18b5b4.
• Скриншоты документации (f18b5b4, прогон 32617490601) и структурная проверка check-docs.mjs (без --external).
• Смок-выборка по diff'у origin/dev..HEAD: 4 прямых совпадения (smoke_controls, smoke_help_affordance, smoke_optimize_coordinate_canonicalization, smoke_partition_openings) — src-диапазон не менялся с r1, повторный подбор дал бы тот же список (перепроверено ниже, не только унаследовано).

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

Дешёвые гейты — прогнаны заново на текущем HEAD (268348d), не унаследованы, т.к. дёшевы и код изменился:

Гейт	Результат
npx tsc --noEmit	чисто, без вывода
npm test	# tests 1117 / # pass 1117 / # fail 0 / # skipped 0
npm run build	OK; cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js и cmp … demo/srv/assets/houseplan-card.js — три копии идентичны, SHA-256 7a526c3fd9993b9d2de95eb842c9e66962a9b7c26f8d6135e8131ad562e23292 (совпадает с хендоффом автора)
node scripts/process-gate.mjs --range origin/dev..HEAD --issues	гейт пройден, предупреждений 0 (7 коммитов в диапазоне)

node scripts/check-docs.mjs --external не обязателен в этом раунде — дельта f18b5b4..HEAD не трогает src/** — но прогнан для очистки контекста: Documentation checks passed (7 files, 10 external links).

По необходимости, определяемой дельтой:

Гейт	Результат
node demo/golden/run.mjs --mode=capture --scenario=device-icon-state-table-light	passed — H1 закрыт
node demo/golden/run.mjs --mode=capture --scenario=device-icon-state-table-dark	passed — H1 закрыт
node demo/smoke_cover_plate_precedence.mjs	OK, все проверки true, включая remoteMirrorsItsControls/remoteOffIsNeutral
node scripts/smoke-select.mjs --base f18b5b4 --head HEAD	«Исполняемого frontend-диффа нет (src/**/*.ts не тронут)» — браузерные смоки этой дельтой не выбираются, выбирать нечего
node scripts/smoke-select.mjs --base origin/dev --head HEAD (сверка с r1)	тот же список из 4 прямых совпадений, что и в r1 — src-диапазон с r1 не менялся

Дисциплина «тест умеет падать» — проверена экспериментом, не заявлением. Извлёк версию smoke_cover_plate_precedence.mjs с SHA f18b5b4 (до фикса) во временный файл и прогнал его против текущего (исправленного) бандла:

$ git show f18b5b4:demo/smoke_cover_plate_precedence.mjs > demo/smoke_cover_plate_precedence.OLD.mjs
$ node demo/smoke_cover_plate_precedence.OLD.mjs
...
FAILED (2):
  - remoteMirrorsItsControls: expected true, got false
  - remoteOffIsNeutral: expected true, got false

(временный файл удалён сразу после прогона, git status --short — чисто). Подтверждает: старая фикстура ломалась ровно по причине, названной автором (own-availability теперь требует живой собственной сущности), правка — не сокрытие регрессии, а необходимая адаптация фикстуры под новый, уже принятый в ТЗ контракт (аналогия с фикстурой #89, разрешённая PROCESS.md §11.4 по духу, хотя формально это не тот этап).

Не гонял: полный npm run golden:verify (~40 сценариев) и python -m pytest tests_backend — дельта не трогает ни остальные golden-сценарии, ни custom_components/**/*.py; unittest backend вне скоупа дельты. Оба уже были вне скоупа и в r1. Performance-профили не названы в AC и не затронуты дельтой.

Находки

Нет находок High или Medium в этом раунде. Low не заводился и не снимался — в дельте нечего оспаривать: golden принят по правилам (§3.13, --reviewed на полном Linux-артефакте), фикстура актуализирована с воспроизведённым доказательством.

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

• H1 закрыт доказательно: оба golden-сценария из находки перепройдены заново и дают passed на текущем дереве, sourceFingerprint в принятом baseline соответствует текущему исходнику.
• Приёмка golden прошла по правилам процесса: Release:/Baseline-Reviewed: трейлеры на коммите класса D, ссылка на реальный прогон CI (32617372743), не локальная перезапись.
• Смок-фикстура smoke_cover_plate_precedence.mjs не потеряла способность падать — проверено прогоном старой версии на новом коде, а не заявлением автора.
• Оба новых коммита несут Issue: #251 и User-Visible: no — корректно, поведение не меняется, только тестовая инфраструктура и эталоны.
• Всё, унаследованное из r1 (см. таблицу выше), не тронуто дельтой и не требует повторной проверки.

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

• Полный npm run golden:verify по всем ~40 сценариям — не задет дельтой; предрелизная обязанность (§8), не гейт ревью. Автор уже подтвердил 95/95 на exact-HEAD прогоне CI (32618851703).
• python -m pytest tests_backend — дельта не трогает Python.
• Реальную HA-инсталляцию/ручной клик — фазы ручного тестирования в цикле нет; вопрос «работает ли» для продуктовой логики закрыт в r1 (юнит-матрица, мутанты, production-bundle smoke), а в r2 предметом были только тестовые артефакты, а не продуктовый код.
• Провенанс самих CI-прогонов (32617372743, 32618422055, 32618851703) как содержимого GitHub Actions — не открывал вложения раннов, доверился структуре трейлеров и совпадению фингерпринта/хэшей на локальном воспроизведении.

Вердикт

Зелёный. H1 закрыт с воспроизведённым доказательством, новая сопутствующая правка фикстуры проверена на способность падать, дешёвые гейты и предметные (golden-сценарии из находки, задетый смок) зелёные на текущем HEAD. Готово к слиянию.