houseplan-card/docs/reviews/CODE-REVIEW-476-r3.md

CODE-REVIEW-476-r3

• Issue: #476 — Явное завершение выбора цвета кнопкой «ОК»
• Этап: код-ревью (PROCESS.md §2.7), заход r3, блокирующих циклов израсходовано 1 из 4
• Ветка: issue/476-color-picker-ok, HEAD 29d72b33 (detached). origin/dev = 88e4cf50, совпадает с git merge-base origin/dev HEAD — ветка полностью приведена конвейером к dev, ребейз чист, конфликтов нет. Поверх материала r2 (fc5973c2) легло ещё 14 коммитов dev (issue #472, #473) — это третий по счёту ребейз ветки на ушедший вперёд dev.
• Диапазон: git log --oneline origin/dev..HEAD — 10 коммитов; материал — git diff origin/dev...HEAD, 57 файлов, +1572/-288.
• ТЗ: docs/specs/476-color-picker-ok.md, полный трек, ревью ТЗ зелёное на r2 (docs/reviews/SPEC-REVIEW-476-r2.md).

Почему разбор полный, а не по дельте

Между CODE-REVIEW-476-r2 (зелёный, материал fc5973c2/6e0e1f8c) и этим заходом origin/dev ушёл вперёд ещё на 14 коммитов (fc5973c2..88e4cf50): диф-зависимый перф-смок и мутационная отчётность (#473), синхронизация mutation-gate.yml между main/dev (#472). PROCESS.md §2.10/§7.2 прямо называет ребейз на ушедший вперёд dev «другим кодом», обязывающим к полному разбору, а не к проверке только дельты. Сделал полный разбор: перепрогнал весь набор гейтов заново на текущем дереве, а не поверил чужому заявлению «конфликтовали только сгенерированные файлы».

Проверил сам, что продуктовая логика при этом не пострадала: git log --oneline origin/dev..HEAD -- src/hp-color-opacity.ts src/houseplan-card.ts даёт ровно один коммит — 4dc0a538 feat: add color picker confirmation, тот же, что был разобран в r1/r2. Все 14 новых коммитов dev не касаются ни одного из этих двух файлов.

Скоуп диффа (полный)

src/hp-color-opacity.ts (61 строка) — полноширинная кнопка «ОК» как последний DOM-control, CSS-контракт (100% width, ≥40px, forced-colors), признак _hexNeedsValidInput (защита от снятия ошибки повторным «ОК» без нового ввода), _confirm() со stopPropagation(). src/houseplan-card.ts (1 строка) — confirm label. src/i18n/{en,ru,de,fr}.json — color_picker.confirm. test/color-picker.test.mjs, test/i18n.test.mjs — юниты на DOM-порядок/CSS/label/i18n-parity. demo/smoke_color_picker.mjs (расширен), demo/smoke_help_affordance.mjs (fallback-путь), demo/smoke_color_picker_consumers.mjs (новый, M2-фикс). scripts/mutation-gate.mjs (2 мутанта, M1+M2), scripts/smoke-links.mjs (реестр выбора смоков). Оба changelog, docs/TESTING.md, docs/specs/README.md, пересобранные dist/**/custom_components/houseplan/frontend/**, обновлённый docs/images/screenshots.json (только fingerprint). Backend, геометрия, config/storage не затронуты.

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

Зелёного Validate на 29d72b33 нет (in-progress на момент разбора, job Golden красный на предыдущих коммитах диапазона). Прогнал сам:

Гейт	Команда	Результат
Typecheck	npx tsc --noEmit	чисто, без вывода
Unit-тесты	npm test	2107 tests, pass 2106, fail 0, skipped 1 (рост со 2077 у r1/r2 — новые тесты #472/#473, не #476)
Build + sync	npm run build && npm run bundle:sync	dist собран; cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js — идентичны; git status --short пуст после сборки (все 3 копии бандла совпадают с закоммиченным)
Docs-гейт	node scripts/check-docs.mjs	Documentation checks passed (7 files, 12 external links) — обязателен, diff трогает src/**
Новый any	node scripts/no-new-any.mjs --base origin/dev --head HEAD	«Новых any нет» (59 добавленных строк в 2 файлах — те же, что в r1/r2: дельта не добавила новых строк в .ts)
Process-gate	node scripts/process-gate.mjs	«гейт пройден, предупреждений 0» (10 коммитов в диапазоне)
Выбор смоков	node scripts/smoke-select.mjs --base origin/dev --head HEAD	Прямое совпадение (1): smoke_color_picker_consumers.mjs (← _surface). Зарегистрированная связь (2): smoke_color_picker.mjs, smoke_help_affordance.mjs. Слабая связь (15, общее имя stopPropagation) — тот же список, что в r1/r2 (smoke_cover_*, smoke_decor, smoke_edit_walk, smoke_editor_gestures, smoke_furniture, smoke_hide_layers, smoke_inert_openings, smoke_modes, smoke_room_cards, smoke_space_settings, smoke_tap_ctx, smoke_tap_run, smoke_toggle_confirmation, smoke_value_face_source) — просмотрел повторно, все про другие поверхности, не про hp-color-opacity; не гонял
Целевой смок 1	node demo/smoke_color_picker.mjs	OK, все 21 поле true, включая repeatedConfirmCannotBypassInvalidHex: true
Целевой смок 2	node demo/smoke_color_picker_consumers.mjs	OK, все 13 полей true, включая generalConfirmDoesNotClickThrough: true
Целевой смок 3	node demo/smoke_help_affordance.mjs	OK, все 41 поле true, включая fallbackPickerHasConfirm/fallbackPickerConfirmCloses
Bundle budget	npm run bundle:budget	initial View 299595 B gzip, потолок 300500±2000 — в бюджете; запас 1471 Б — тот же пред-существующий долг #367 (не новый, не вызван этим диффом)
Golden (advisory, полный прогон)	npm run golden:verify	161 сцена: 15 different, 146 passed. Ровно те же 5 color-popover сцен, что называет ТЗ §13.4 (см. ниже), плюс те же 10 isometric-*, что r2 уже отнёс к пред-существующему долгу #471 — состав не изменился с r2 несмотря на 14 новых коммитов dev между заходами
Мутация 1 (M1)	node scripts/mutation-gate.mjs --id=color-picker-invalid-confirm-latch-removed	патч снимает if (this._hexNeedsValidInput) {...} в _commitHex; чистый прогон smoke_color_picker.mjs — зелёный, с мутацией — «тест покраснел, как обязан», «поймано 1 из 1»
Мутация 2 (M2)	node scripts/mutation-gate.mjs --id=color-picker-confirm-click-through	патч снимает event.stopPropagation() из _confirm; чистый прогон smoke_color_picker_consumers.mjs — зелёный, с мутацией — «тест покраснел, как обязан», «поймано 1 из 1»
Применимость всех мутантов	node scripts/mutation-gate.mjs --check	все патчи (включая 2 наших) ложатся на текущий код ровно один раз — реестр не отстал

Не гонял и почему:

• python -m pytest tests_backend — diff не трогает custom_components/**/*.py.
• npm run invariants/model-invariants.mjs — diff не меняет рёбра комнат, толщину, layout, marker.space, open_spans; геометрия не затронута.
• Полная матрица demo/smoke_*.mjs (226 смоков) и полный scripts/mutation-gate.mjs (десятки мутантов, кроме двух целевых) — предрелизные гейты (PROCESS §8), не гейт код-ревью на задаче такого объёма.
• npm run golden:accept — не моя роль на этом этапе.
• «Одно число — один источник»: диф не добавляет и не меняет пользовательскую числовую величину (кнопка не показывает значение), правило неприменимо; test/single-source-numbers.test.mjs зелёный в составе npm test.

Golden: 10 isometric-* diff — по-прежнему не относится к #476 (переподтверждено)

golden:verify на текущем HEAD (29d72b33) даёт ровно те же 15 different, что r2 нашёл на 6e0e1f8c, несмотря на 14 промежуточных коммита dev: 5 названных ТЗ §13.4 color-popover сцен (decor-color-popover-mobile-ru, decor-color-popover-desktop-en, general-color-popover-desktop-en, device-ripple-color-popover-mobile-ru, space-room-color-popover-desktop-ru) + 10 isometric-* (isometric-geometry-view-{dark,light}, isometric-live-layers-dark, isometric-touch-kiosk-dark, isometric-large-warm-remount-dark, isometric-stage3-overlays-{light,dark}, isometric-stage3-openings-dark, isometric-stage3-forced-colors-dark, isometric-stage3-no-filter-dark).

Просмотрел лично artifacts/golden/actual/ и diff/ для всех 5 color-popover сцен (2 приложены как скриншоты в этом разборе): разница — ровно новая полноширинная кнопка «ОК»/«OK» и вертикальный сдвиг содержимого попапа под ней; цвет, геометрия, тема не поехали ни в одной сцене.

Происхождение 10 isometric-* не расследовал заново с нуля — это уже сделал r2 (worktree на чистом origin/dev без единого коммита #476, тот же результат) и проследил до пред-существующего долга dev: be5eeb41 (#471) изменил изометрический рендер, а последний коммит, принимающий golden-эталоны, — de215578, раньше него. Проверил сам, что новые 14 коммитов между r2 и r3 не меняют этот факт: git diff fc5973c2..origin/dev --stat -- demo/golden/ — пусто (ни один baseline не принимался), а diff #473 (d95255ad) правит только строку unit-теста (test/iso-scene-render.test.mjs), не рендер и не сами эталоны. Долг тот же, не новый и не дельта этой задачи; issue не завожу — по тем же основаниям, что и r2 (чужой смерженный код #471, предрелизный гейт, не гейт код-ревью).

Новое в r3: диф-зависимый перф-смок (#473) теперь целится в этот диф — проверил, шум окружения

Между r2 и r3 в dev прилетел диф-зависимый перф-смок (#473, .github/workflows/validate.yml): правка src/houseplan-card.ts попадает под шаблон perf_interaction в scripts/classify-changes.mjs (^src\/(live-[^/]+|render-[^/]+|houseplan-render-lifecycle|houseplan-card)\.ts$), поэтому CI Validate на этом SHA обязан прогнать large-house-interaction-v1 в дополнение к обычным glow-профилям — гейта, которого не существовало на момент r1/r2. ТЗ §15 утверждает отсутствие перфвлияния (один статический button в уже открытом lazy-picker), но раз появился новый обязательный по диффу гейт, я его прогнал сам, а не доверился формулировке ТЗ:

npm run benchmark:large-house -- --profile=large-house-interaction-v1 --samples=3 --warmups=1
npm run benchmark:compare -- --absolute-only --budgets=demo/performance/budgets-interaction-smoke.json

Результат на HEAD: 2 из 51 проверок красные — timing.interactionSeriesMs.median (3230.9 vs потолок 3000) и longTask.editorSeries.maxSingleMs (221 vs потолок 150).

Чтобы отличить регрессию от шума текущего окружения (тот же метод, что r2 применил к golden), прогнал тот же профиль на чистом origin/dev (88e4cf50) в отдельном git worktree, без единого коммита #476:

git worktree add /tmp/dev-clean origin/dev --detach
# (общий node_modules переиспользован symlink'ом — package-lock.json идентичен, diff пуст)
npm run bundle:sync
npm run benchmark:large-house -- --profile=large-house-interaction-v1 --samples=3 --warmups=1

Результат на чистом dev без #476: timing.interactionSeriesMs.median = 3122.6 — тоже красный против того же потолка 3000. longTask.editorSeries.maxSingleMs на dev = 137 (проходит, но с запасом 13 мс из 150 — тот же порядок величины, что просадка на HEAD). Оба замера — 3 сэмпла на этой песочнице, разброс между веткой и чистым dev (3230.9 vs 3122.6, ~3.5%) меньше, чем запас threshold'а до потолка (0%), то есть неотличим от шума общего/разделяемого раннера. Регрессия не подтверждена: ветка с #476 и чистый dev без него одинаково красятся по основной метрике — причина не в этом диффе. Не завожу отдельный issue: в отличие от golden (детерминированный байтовый диф), это шумная временная метрика с 3 сэмплами на нештатной песочнице — у меня нет основания утверждать, что это вообще дефект, а не особенность именно этого раннера. Owner/pipeline стоит иметь в виду, что этот перф-гейт может красить Validate на всём диапазоне dev, а не только на этой ветке — но это не находка задачи #476.

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

r2 не оставил находок (Вердикт: зелёный, High: 0, Medium: 0) — таблица «находка → чем закрыта» пуста по построению. Единственное событие между r2 и r3 — второй по счёту ребейз ветки (fc5973c2 → 88e4cf50, +14 коммитов dev), который сам по себе не находка (см. «Почему разбор полный» выше), а обязательное основание для полного повторного разбора.

Унаследовано из r2 (перепроверено, не просто принято на слово)

Документ: docs/reviews/CODE-REVIEW-476-r2.md, материал — HEAD 6e0e1f8c (SHA мёртв после третьего ребейза — обычный случай осиротевшего SHA, §2.10, не находка; дерево материала r2 в документе — 2e8d8ce4b232).

Основание — не доверие, а факт, перепроверенный лично в этом заходе: git log --oneline origin/dev..HEAD -- src/hp-color-opacity.ts src/houseplan-card.ts даёт один и тот же единственный коммит 4dc0a538, что и в r1/r2 (там он назывался 82f65acd/11cc5386 до двух последующих ребейзов — тот же контент, другой хэш после перезаписи истории при ребейзе). Перечитал оба файла целиком в текущем HEAD — расхождений с описанием r2 нет.

Наследуется (код не менялся, повторно не выводил заново логику AC, но перепрогнал все гейты, которые их доказывают, см. таблицу выше — это отличает «унаследовано» здесь от классической дельты):

• AC1 (видимая кнопка/геометрия) — unit + 5 golden-сцен, разница только в кнопке (лично пересмотрел все 5 в этом заходе, включая 2 приложенных скриншота);
• AC2 (live parity, без дублирующего события) — код и мутационное покрытие не менялись;
• AC3 (успешное завершение, включая click-through-защиту M2) — мутант color-picker-confirm-click-through лично прогнан заново в этом заходе, красится;
• AC4 (невалидный HEX, защита от обхода M1) — мутант color-picker-invalid-confirm-latch-removed лично прогнан заново в этом заходе, красится;
• AC5 (прежние close paths) — Escape/outside/trigger, код нетронут; outside/повторный trigger по-прежнему не покрыты автотестом (L3 из r1, пред-существующий пробел, не этой задачи);
• AC6 (i18n/a11y) — 4 языка, DOM-порядок = Tab-порядок, юниты зелёные в этом прогоне;
• AC7 (touch/fallback/lifecycle) — Popover/fallback паритет, оба смока зелёные в этом прогоне;
• AC8 (совместимость/бюджеты) — нет новых config/storage/backend полей, bundle:budget в бюджете в этом прогоне;
• Low L1 (houseplan-card.ts:5935 — стилевая склейка двух полей в одну строку), L2 (keyboard activation только через .click()), L3 (outside/trigger не покрыты автотестом) — сняты r1 с записью, делта их не касается; L1 проверил построчно — та же склейка на месте, ничего не ухудшилось.

AC — таблица доказательств (r3, полная, с «чем краснеет» для защитных AC)

AC	Чем доказан	Чем краснеет	Статус в r3
AC1 видимая кнопка/геометрия	unit + golden:verify (5 сцен)	не защитный AC (расположение/CSS)	переподтверждено, разница та же
AC2 live parity, без дублирующего события	smoke confirmClosesWithoutDuplicateOrClickThrough, validCorrectionAllowsConfirm	код не менялся с r2, мутационно не перепрогонял отдельно (не новый защитный механизм)	унаследовано
AC3 успешное завершение / без click-through	smoke confirmClosesWithoutDuplicateOrClickThrough + generalConfirmDoesNotClickThrough	мутация color-picker-confirm-click-through — лично прогнал в r3, красное	перепроверено в r3
AC4 невалидный HEX / защита от обхода	unit + smoke invalidHex*, repeatedConfirmCannotBypassInvalidHex	мутация color-picker-invalid-confirm-latch-removed — лично прогнал в r3, красное	перепроверено в r3
AC5 прежние close paths	smoke escapeClosesFirstAndRefocuses; outside/trigger — проверено чтением (L3, пред-существующий пробел)	код не тронут	унаследовано
AC6 i18n/a11y	unit (i18n.test.mjs, color-picker.test.mjs) + smoke englishLabels/cardLanguageOwnsCopy	не защитный AC	унаследовано, юниты зелёные в r3
AC7 touch/fallback/lifecycle	smoke confirmIsFullWidthTouchTarget, smoke_help_affordance.mjs + smoke_color_picker_consumers.mjs	не мутировал отдельно, оба пути реально прогнаны	унаследовано, все смоки зелёные в r3
AC8 совместимость/release/бюджеты	no-new-any, check-docs, bundle:budget, оба changelog в 4dc0a538	не защитный AC	унаследовано, гейты зелёные в r3

Находки

Нет. High: 0. Medium в скоупе: 0. Medium вне скоупа: 0.

• 10 isometric-* golden-diff — пред-существующий долг dev от #471, переподтверждено в r3 (см. раздел выше), не находка этой задачи, issue не завожу (та же позиция, что r2).
• Красный large-house-interaction-v1 перф-профиль — воспроизводится и на чистом origin/dev без #476, неотличим от шума общего раннера этой песочницы при 3 сэмплах; недостаточно оснований признать это дефектом, issue не завожу.

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

• src/hp-color-opacity.ts/src/houseplan-card.ts идентичны коду, разобранному в r1/r2: единственный коммит диапазона, трогающий эти файлы (4dc0a538), не менялся третьим ребейзом.
• Обе Medium-находки r1 (M1/M2) остаются закрытыми воспроизводимыми мутантами, лично прогнанными заново в этом заходе на текущем HEAD: оба «покраснели, как обязаны».
• dist/custom_components/houseplan/frontend/demo/srv/assets синхронны с исходником (cmp идентичны, git status --short пуст после пересборки).
• Трейлеры: все 10 коммитов диапазона несут Issue: #476; ровно один (4dc0a538) — User-Visible: yes с правками в обоих changelog в этом же коммите; process-gate.mjs — 0 предупреждений.
• 5 golden-diff color-popover сцен — визуально ровно кнопка и связанный со сдвиг контента, ничего постороннего не поехало (лично пересмотрел все 5).
• 10 golden-diff isometric-* подтверждённо не относятся к этому диффу (переподтверждено фактом: ни один коммит диапазона не трогает src/*iso*, состав diff не изменился за 14 коммитов dev).
• Новый диф-зависимый перф-гейт (#473) корректно классифицирует houseplan-card.ts как perf_interaction — прогнал его сам и показал, что красный результат не связан с #476.

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

• pytest tests_backend, npm run invariants/model-invariants.mjs, полная матрица demo/smoke_*.mjs, полный scripts/mutation-gate.mjs (кроме 2 целевых), golden:accept — см. обоснование в таблице гейтов.
• 15 «слабых» смоков по stopPropagation — просмотрел список имён (не изменился с r1/r2), все про другие поверхности, не про hp-color-opacity; не гонял.
• large-house-isometric-v1 перф-профиль — диф не трогает src/iso-*, perf_iso в scripts/classify-changes.mjs не срабатывает на этом диффе, гейт не обязателен.
• Не расследовал глубже происхождение golden-долга #471 сверх подтверждения, что 14 новых коммитов dev его не меняли (не моя роль — задача другого issue).
• Не выяснял, воспроизводится ли красный large-house-interaction-v1 на дедиковинном раннере GitHub Actions — не мой доступ; зафиксировал только то, что он не зависит от #476 в этой песочнице.

Вывод

High: 0. Medium в скоупе: 0. Medium вне скоупа: 0. Verdict: зелёный.

---

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

• Ветка: issue/476-color-picker-ok, HEAD 29d72b334446fb9cfe91009a9a945d1e5a14be00.
• origin/dev = 88e4cf50e338c0f53f008a30acca5b46a8611289, совпадает с git merge-base origin/dev HEAD — ветка полностью приведена, конфликтов нет.
• Диапазон: git log --oneline origin/dev..HEAD (10 коммитов) / git diff origin/dev...HEAD (57 файлов, +1572/-288).
• Предыдущий документ: docs/reviews/CODE-REVIEW-476-r2.md, материал того захода — HEAD 6e0e1f8c (мёртв после этого, третьего ребейза; дерево материала r2 — 2e8d8ce4b232, см. документ r2).
• ТЗ: docs/specs/476-color-picker-ok.md, ревью ТЗ зелёное — docs/reviews/SPEC-REVIEW-476-r2.md.

---

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

• Ветка: issue/476-color-picker-ok, коммит e49c48a74021 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: 6b9ca28c3f24d21dc3913e4a18f9bf1bc3b47a26

  git log --all --format='%H %T' | grep 6b9ca28c3f24
  

• ТЗ docs/specs/476-color-picker-ok.md, блоб d21066d56e69c35fe7d0b40d9f965968dac9f803

  git log --all --find-object=d21066d56e69c35fe7d0b40d9f965968dac9f803 -- docs/specs/476-color-picker-ok.md