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

CODE-REVIEW-609-r2

Issue: #609 · Этап: code · Заход: r2 · Блокирующих циклов израсходовано: 1 из 4 Материал: e8e5c863e474ea70f5567510c96587f90eeafcfa (рабочая копия на нём; git status чист) Validate на этом SHA: success — https://github.com/Matysh/houseplan-card/actions/runs/35804202890

Скоуп раунда

r1 (материал 4b27268e) закрыт жёлтым вердиктом с единственным Medium: диагностика verify_ha_form_shell_609.mjs не переключала тему/масштаб текста, а demo/srv/demo.html жёстко задаёт тёмную палитру, так что AC5 не был доказан исполнением, только заявлен. Один Low снят без цикла (мутанты ссылались на несуществующий «AC8»).

Дельта r1→r2 — ровно один коммит, e8e5c863 (test(dialog): cover HA theme and enlarged text, Issue: #609, User-Visible: no):

demo/helpers/README-ha-dialog-505.md               |   7 +-
demo/verify_ha_form_shell_609.mjs                  |  54 ++++++
docs/design/600-settings-dialogs/ACCEPTANCE.md     |   6 +-
.../pairs/room-ha-dark-text-200.png                | Bin 0 -> 57909 bytes
.../600-settings-dialogs/pairs/room-ha-light.png   | Bin 41120 -> 47927 bytes
.../pairs/room-ha-mobile-light.png                 | Bin 30218 -> 33659 bytes
docs/reviews/CODE-REVIEW-609-r1.md                 | 194 +++++++++++++++++++
scripts/mutation-registry.mjs                      |   4 +-

src/** не тронут — продуктовый код идентичен материалу r1. Это подтверждено git diff --stat 4b27268e..e8e5c863 (список выше, ни одного файла класса A) и делает объём разбора локальным: единственная подсистема, которую задевает дельта, — диагностика/доказательства #609 (класс B) и её документация (класс C). Рёбра комнат, layout, marker.space, open_spans, толщина стен дельтой не затронуты — geometry-инварианты не в скоупе r2.

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

Дешёвые гейты (npx tsc --noEmit, npm test, npm run build + сверка бандла) не перегонялись: они входят в зелёный Validate на этом же SHA, а дельта их не касается (ни одного файла с типами или исполняемым продуктовым кодом).

Прогнал сам, целиком по делу этого раунда:

1. node demo/verify_ha_form_shell_609.mjs (без --capture, чтобы не менять рабочую копию) — green. Снял фактические значения из JSON-вывода:
   • light desktop: cardBackground rgb(255,255,255), formBodyBackground rgb(231,234,238), colorScheme light, rootFontSize 16px, panel 560×940, один scrollOwners (.body.ha-scrollbar);
   • dark + 200%: cardBackground rgb(32,33,38), formBodyBackground rgb(43,45,51), colorScheme dark, rootFontSize 32px, panel по-прежнему 560×940 (±1px), один scroll-owner, horizontalOverflow: false, footer в границах панели. Оба набора чисел совпадают с тем, что автор привёл в комментарии передачи — не «на слово», а по фактическому stdout.
2. Тест умеет падать. Временно вырезал первый вызов setPresentation({theme: 'light', ...}) (эмуляция ровно того бага, который нашёл r1: демо остаётся на жёстко зашитой тёмной палитре) и перезапустил — тест упал на desktop.cardBackground: actual 'rgb(28, 37, 48)' (буквально --card-background-color:#1c2530 из demo/srv/demo.html:9) против expected 'rgb(255, 255, 255)'. Это тот самый регресс, который r1 требовал исключить. Файл восстановлен из бэкапа, git status после — чист.
3. node demo/smoke_ha_form_shell_parity.mjs (дешёвый Validate-свидетель, файл не входит в дельту, но зависит от той же CSS-цепочки) — green.
4. node scripts/mutation-gate.mjs --check — все мутанты ok, включая три формо-оболочечных: ha-form-shell-width-falls-back-to-generic, ha-form-shell-loses-canvas, ha-form-shell-mobile-keeps-desktop-inset (последние два — с исправленным в дельте r2 комментарием).
5. node scripts/check-docs.mjs — Documentation checks passed (7 files, 12 external links). Формально дельта не трогает src/**, поэтому отпечаток документации не обязан быть перепрогнан по правилам раунда — прогнал всё равно, т.к. дельта меняет docs/design/** и README рядом; green.
6. npm run bundle:sync перед пунктом 1 (диагностике нужен свежий бандл) — git status до и после идентичен: бандл уже был синхронизирован, новых изменений в dist/**/custom_components/houseplan/frontend/**/demo/srv/assets/** не появилось.
7. Прочитал производственный CSS, который делает возможным сам трюк setPresentation: src/hp-dialog.ts:211-217 (.content канва — --secondary-background-color) и src/styles/dialogs.styles.ts:568-583 (hp-dialog[form-shell] .body — --hpf-canvas, который сам фолбэчит на --secondary-background-color; src/styles/form-kit.styles.ts:544). Тест переопределяет ровно эти custom properties на documentElement, инлайн-стиль которого перебивает захардкоженный :root{} в demo.html — механизм фикса соответствует продуктовому коду, а не подгоняет тест под цифры.

Не прогонял и почему: npx tsc --noEmit, npm test, npm run build (с трёхкратной сверкой копий бандла) и npm run golden:verify — покрыты зелёным Validate на этом же SHA, а дельта их зону не задевает (нет продуктового TS, нет изменений, видимых golden). npm run invariants — дельта не трогает геометрию. Полный список browser smoke (demo/smoke_*.mjs) — дельта касается ровно одной подсистемы (#609 form-shell диагностика), прогон всех остальных не добавил бы доказательной силы; scripts/smoke-select.mjs не запускал отдельно, т.к. годный кандидат (smoke_ha_form_shell_parity.mjs) уже очевиден по имени и уже прогнан. python -m pytest tests_backend — дельта не трогает custom_components/**/*.py.

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

Находка r1	Чем закрыта	Где это видно
Medium — AC5 не доказан исполнением: диагностика не переключает тему/шрифт, demo.html жёстко задаёт тёмную палитру, светлая тема физически не возникает	demo/verify_ha_form_shell_609.mjs получил setPresentation(), который инлайн-стилем на documentElement перебивает захардкоженные HA-токены demo.html, плюс новый desktop-кейс dark + root font 32px	demo/verify_ha_form_shell_609.mjs:99-114 (функция), :147-186 (вызовы и ассерты для light и dark/200%); исполнено мной — см. п.1 «Как проверялось», реальные rgb-значения совпадают для обеих тем, а откат первого вызова setPresentation воспроизвёл именно старый баг (п.2)
Low (снят без цикла) — два мутанта в mutation-registry.mjs ссылаются на несуществующий «AC8»	Ссылки исправлены на реальные пункты ТЗ	git diff 4b27268e..e8e5c863 -- scripts/mutation-registry.mjs: #609 AC1/AC8 → #609 AC1, #609 AC4/AC8 → #609 AC4; mutation-gate.mjs --check подтверждает оба мутанта по-прежнему ok

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

Без повторной проверки в r2 принято (документ docs/reviews/CODE-REVIEW-609-r1.md, SHA 4b27268e, вердикт жёлтый · High 0 · Medium 1):

• AC1 (desktop 560×940, канва, один scroll-body, footer) — доказано исполнением verify_ha_form_shell_609.mjs на закреплённом home-assistant-frontend==20260729.7.
• AC2 (mobile fullscreen 480×800 и 390×844, без переполнения) — то же.
• AC3 (пять потребителей form-shell + отрицательный generic-контроль) — smoke_ha_form_shell_parity.mjs + test/form-shell-consumers.test.mjs (r1 лично снял form-shell у room-settings-dialog.ts и увидел падение).
• AC4 (13 golden-сцен диалогов не меняются) — golden:verify зелёный на Linux; инфраструктурно golden-харнес не регистрирует ha-dialog, поэтому CSS для этой ветки не может задеть пиксели нативной ветки.
• AC6 (мутанты ловят потерю ширины/канвы/fullscreen) — три мутанта зарегистрированы и проверены по отдельности на настоящую регрессию.
• AC7 (фикстура #505 без внешних запросов/WebSocket/ошибок) — fixture.assertClean() в диагностике, проверено r1.
• Продуктовый код src/hp-dialog.ts и src/styles/dialogs.styles.ts в части #609 — прочитан r1 построчно и не менялся с тех пор (подтверждено пустым git diff --stat 4b27268e..e8e5c863 по src/**), поэтому в r2 не перечитывал заново весь файл — только фрагменты, нужные для проверки механизма setPresentation (п.7 «Как проверялось»).

Не наследую слепо: пересчитал заново именно то, что задевает дельта — AC5 и оба Low-мутанта, см. таблицу выше.

Находки

Нет находок, оставшихся в скоупе после закрытия r1. Продуктовых, архитектурных или новых замечаний к самой дельте (диагностика + документация) не нашёл: логика переопределения тем соответствует реальным CSS-переменным продукта (проверено чтением и исполнением), числа в тесте и в комментарии автора совпадают буквально, тест доказанно падает при откате фикса.

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

• Механизм setPresentation не подделывает результат: он переопределяет ровно те custom properties, которые продукт уже читает (--card-background-color, --secondary-background-color, --ha-card-background), а не создаёт параллельную систему цветов.
• «Одно число — один источник»: cardBackground и formBodyBackground снимаются с реальных DOM-узлов (getComputedStyle) после card.updateComplete, а не задаются тестом напрямую — сравнение честное, не тавтология.
• Скриншоты-доказательства (room-ha-light.png, room-ha-mobile-light.png, новый room-ha-dark-text-200.png) пересняты в момент, когда фикстура действительно в заявленной теме (byte-diff трёх файлов это подтверждает — старые два не идентичны новым, значит не переиспользованы вслепую).
• Трейлеры коммита e8e5c863: Issue: #609, User-Visible: no — верно, продуктовое поведение не изменилось; изменений в demo/golden/baselines/** нет, поэтому Release:/Baseline-Reviewed: не требуются; changelog не тронут, что согласуется с User-Visible: no.
• Класс изменений выдержан: demo/** и scripts/** — класс B (issue переиспользован, как разрешено), docs/** — класс C, часть DoD issue; ни один файл класса A/D не в дельте кроме уже подтверждённого пустого diff бандла после bundle:sync.

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

• Полный набор npm test / tsc --noEmit / npm run build — не перегонял, положился на зелёный Validate этого SHA (дельта их зону не задевает).
• golden:verify в этом раунде — не перегонял; продуктовый CSS не менялся, а r1 уже подтвердил, что golden-харнес не видит ha-dialog-ветку в принципе.
• Полный список demo/smoke_*.mjs — прогнал только адресный smoke_ha_form_shell_parity.mjs; остальные не относятся к дельте (только диагностика и docs одного issue).
• npm run invariants — дельта не меняет геометрию/рёбра/layout.
• python -m pytest tests_backend — дельта не трогает Python.
• Живой настоящий HA вручную (браузером) — по правилам процесса ручного тестирования в цикле нет; доказательство — исполнение диагностики на закреплённой офлайн-фикстуре #505, что и было сделано.

---

Материал раунда

• Ветка: issue/609-ha-form-shell-parity, коммит e8e5c863e474 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: 8b68353a33207d127ff8a4789c3bbd38150751d3

  git log --all --format='%H %T' | grep 8b68353a3320
  

• Тело issue: b08b9257ed688a47f3a0f422cdddc1bfc7cf7c511e81ada3ceeac8c2ce354d51
• Вердикт конвейера: green · High 0