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

# CODE-REVIEW-476-r2

- **Issue:** #476 — Явное завершение выбора цвета кнопкой «ОК»
- **Этап:** код-ревью (PROCESS.md §2.7), заход r2, блокирующих циклов израсходовано 1 из 4
- **Ветка:** `issue/476-color-picker-ok`, HEAD `6e0e1f8c` (`origin/dev` = `fc5973c2`, ровно merge-base — ветка полностью приведена к `dev`, ребейз чист, конфликтов нет)
- **Диапазон:** `git log --oneline origin/dev..HEAD` — 9 коммитов; материал — `git diff origin/dev...HEAD`, 56 файлов
- **ТЗ:** `docs/specs/476-color-picker-ok.md`, полный трек, ревью ТЗ зелёное на r2 (`docs/reviews/SPEC-REVIEW-476-r2.md`)

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

Между r1 код-ревью (жёлтый, `docs/reviews/CODE-REVIEW-476-r1.md`, доказано на `HEAD b5a1001e`) и этим заходом ветка дважды двигалась:

1. автор устранил M1 и M2 коммитом `test: harden color picker confirmation guards` — локальная правка тестов/реестров, ожидаемый предмет обычной дельты;
2. затем `origin/dev` ушёл вперёд ещё на 5 коммитов, review не запустился («Ревью не запускалось» — конфликт слияния, цикл не израсходован), и автор перебазировал ветку на `fc5973c2`, разрешив конфликт только в сгенерированных `dist/**`/`custom_components/houseplan/frontend/**` (пересобраны из объединённых исходников).

Пункт 2 — ребейз на ушедший вперёд `dev`, что PROCESS.md §2.10/§7.2 прямо называет «другим кодом», обязывающим к полному разбору. Я его сделал: ниже — полная таблица гейтов и AC, а не только диф вокруг M1/M2. Практически это означало не доверять чужому заявлению «конфликтовали только сгенерированные файлы», а проверить самому: `git log --oneline origin/dev..HEAD -- src/hp-color-opacity.ts` показывает **ровно один** коммит (`82f65acd`, реализация, предшествующая r1-ревью) — второй ребейз действительно не тронул продуктовую логику, только сгенерированные бандлы и `docs/images/screenshots.json` (fingerprint). Это подтверждено чтением, а не принято на слово.

## О «SHA не назван» (проверка §2.10, шаг 1)

Комментарий-вердикт r1 в issue (11:47:29Z) сам по себе не называет проверенный SHA — но материал по процессу объявляется не в комментарии, а в блоке «Материал раунда» документа (`CODE-REVIEW-476-r1.md`), и там SHA есть: в прозе документа — `HEAD b5a1001e` (после того как конвейер сам привёл ветку к `dev`, "34a6b276 → b5a1001e"), в машинном блоке — коммит `34a6b276473c` (тот же материал, тег до этого приведения) плюс дерево `94485fdc0eca...`. Отсутствие SHA в комментарии — не находка: PROCESS.md §2.10 явно возлагает эту обязанность на документ, а не на комментарий.

Оба анкера (`34a6b276473c`, `b5a1001e`) сейчас не резолвятся в этом чекауте (`git cat-file -t 94485fdc0eca... ` → `could not get object info`) — это следствие **второго** ребейза (пункт 2 выше), случившегося **после** публикации документа r1 (12:11 против 11:47). На момент публикации r1 материал был жив, что и требуется §2.10; это обычный случай осиротевшего SHA («98 из 804»), не находка. Проверить содержимое напрямую я не мог, поэтому опираюсь на: (а) единственный коммит, трогающий `src/hp-color-opacity.ts`, не менялся между r1 и сейчас (см. выше), (б) построчное сравнение текста файла ниже совпадает с тем, что описывает документ r1.

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

`src/hp-color-opacity.ts` (61 строка, коммит `82f65acd`, не менялся после r1) — полноширинная кнопка «ОК», `_hexNeedsValidInput` защита от обхода невалидного HEX повторным подтверждением, `_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 на `6e0e1f8c` нет (`gh run view 34032363066` — `completed/failure`, единственный красный job — `Golden-кадры против принятых эталонов`; `Фронтенд`, `Предполётные проверки`, оба перф/смок-джоба и все 3 шарда браузерных смоков — `success`). Прогнал сам:

| Гейт | Команда | Результат |
|---|---|---|
| Typecheck | `npx tsc --noEmit` | чисто, без вывода |
| Unit-тесты | `npm test` | `2077 tests, pass 2076, fail 0, skipped 1` — совпадает с заявленным |
| 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` пуст после сборки |
| 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: делта не добавила новых строк в `.ts`) |
| Process-gate | `node scripts/process-gate.mjs` | «гейт пройден, предупреждений 0» (9 коммитов в диапазоне) |
| Выбор смоков | `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 (`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`) — просмотрел список повторно, все про другие поверхности; не гонял |
| Целевой смок 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`, все поля `true`, включая `fallbackPickerHasConfirm`/`fallbackPickerConfirmCloses` |
| Bundle budget | `npm run bundle:budget` | initial View `299595 B` gzip, потолок `300500±2000` — в бюджете; запас `1471 Б` — тот же пред-существующий долг #367, не новый |
| Golden (advisory) | `npm run golden:verify` | 15 `different` из 150 сцен: 5 названных в ТЗ color-popover сцен (ожидаемо, см. AC1) + **10 `isometric-*`**, не относящихся к этому диффу (см. отдельный раздел ниже); 135 `passed` |
| Мутация 1 (M1) | `node scripts/mutation-gate.mjs --id=color-picker-invalid-confirm-latch-removed` | патч снимает `if (this._hexNeedsValidInput) {...}` в `_commitHex`; guard — `smoke_color_picker.mjs` → «тест покраснел, как обязан», «поймано 1 из 1» |
| Мутация 2 (M2) | `node scripts/mutation-gate.mjs --id=color-picker-confirm-click-through` | патч снимает `event.stopPropagation()` из `_confirm`; guard — новый `smoke_color_picker_consumers.mjs` → «тест покраснел, как обязан», «поймано 1 из 1» |
| Применимость всех мутантов | `node scripts/mutation-gate.mjs --check` | все патчи ложатся на текущий код, включая оба новых |

**Не гонял и почему** (не изменилось с r1, диф их не задевает):
- `python -m pytest tests_backend` — diff не трогает `custom_components/**/*.py`.
- `npm run invariants` / `model-invariants.mjs` — diff не меняет рёбра комнат, толщину, `layout`, `marker.space`, `open_spans`.
- Performance-профили — не названы в AC; §15 ТЗ обоснованно утверждает отсутствие влияния (один статический `button`, один `click`-handler в уже открытом lazy-picker); perf-smoke job в CI зелёный.
- Полная матрица `demo/smoke_*.mjs` и полный `scripts/mutation-gate.mjs` (226 смоков, десятки мутантов) — предрелизные гейты (PROCESS §8), не гейт код-ревью на задаче такого объёма; прогнаны только целевые/прямые + два новых мутанта.
- `npm run golden:accept` — не моя роль на этом этапе.
- «Одно число — один источник»: диф не добавляет и не меняет пользовательскую числовую величину (кнопка не показывает значение), правило неприменимо; `test/single-source-numbers.test.mjs` зелёный в составе `npm test`.

## Golden: 10 `isometric-*` diff — не относится к #476

`golden:verify` на этой ветке даёт 15 `different`. Пять совпадают с ТЗ (§13.4: `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`) — просмотрел `actual/`+`diff/` глазами, разница ровно в кнопке и вертикальном сдвиге содержимого, цвет/геометрия/тема не поехали. Остальные десять — все сцены `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`) — их не должно быть, диф этой задачи не трогает ни один `src/*isometric*` файл.

Проверил происхождение: поднял временный `git worktree add /tmp/dev-check origin/dev --detach` (чистый `fc5973c2`, без единого коммита #476), собрал бандл (`npm run bundle:sync`) и прогнал `golden:verify` там же — те же ровно 10 сцен `isometric-*` выходят `different`, 0 отношения к color-picker. Chromium совпадает с эталоном побайтово по версии (`151.0.7922.34` — `demo/golden/baselines/baselines-index.json` vs установленный движок), так что это не известный кейс расхождения рендеринга по окружению. Причина видна по истории `dev`: `be5eeb41 fix: remove isometric overlay plates` (issue #471) поменял рендер, но последний коммит, принимающий golden-эталоны, — `de215578 test: accept isometric stage 3 golden baselines`, **до** `be5eeb41`; после него в `dev` нет коммита с принятыми isometric-эталонами. Это преднесённый долг `dev` от #471, полностью независимый от этой ветки — красный CI job `Golden-кадры против принятых эталонов` на `6e0e1f8c` красится и по этой причине тоже, но её причина не в #476. Golden — предрелизный, не код-ревью гейт (PROCESS §8); не завожу отдельный issue: не моя находка по существу (баг чужой, уже смердженной задачи #471, чинится обычным циклом приёмки эталонов перед бетой, а не патчем из этой ветки), и я не уверен, что это дефект, а не намеренно отложенное до релизного гейта принятие — распознавать и чинить чужой merged-код здесь означало бы расширять скоуп этой задачи.

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

| Находка r1 | Чем закрыта | Где видно |
|---|---|---|
| **M1** — AC4-защита (`_hexNeedsValidInput`) доказана только смоком, без постоянного мутанта в `scripts/mutation-gate.mjs` | Зарегистрирован мутант `color-picker-invalid-confirm-latch-removed` (guard `demo/smoke_color_picker.mjs`) | `scripts/mutation-gate.mjs` (коммит `6e0e1f8c`); лично прогнал `--id=color-picker-invalid-confirm-latch-removed` → «тест покраснел, как обязан» |
| **M2** — AC3-защита (`stopPropagation()` в `_confirm`) не доказана тестом, способным упасть — единственный проверенный потребитель гасил клик выше по DOM независимо от мутации | Добавлен `demo/smoke_color_picker_consumers.mjs`, сценарий `generalConfirmDoesNotClickThrough` на «lightOn» (general settings, потребитель без внешнего гасителя); зарегистрирован мутант `color-picker-confirm-click-through` (guard — новый смок) | `demo/smoke_color_picker_consumers.mjs:49-63`, `scripts/mutation-gate.mjs` (коммит `6e0e1f8c`); лично прогнал `--id=color-picker-confirm-click-through` → «тест покраснел, как обязан» |

Оба закрытия проверены исполнением мутанта, не заявлением автора: патч применяется к `_commitHex`/`_confirm`, гоняется именно названный guard, тест красится, патч откатывается, `git status --short` пуст.

## Унаследовано из r1 (без повторной проверки)

Документ: `docs/reviews/CODE-REVIEW-476-r1.md`, материал — дерево `94485fdc0eca504692dd2776c7f3c86518a8dfb9` (SHA-анкеры мертвы после второго ребейза, см. раздел выше; сам r1-документ пережил ребейз бит-в-бит, коммит `baea0fcf`).

Основание наследования — не доверие, а факт: `src/hp-color-opacity.ts` не менялся ни одним коммитом между `82f65acd` (реализация, предшествующая r1) и `HEAD`; я лично перечитал этот файл целиком в текущем HEAD (строки 480–740) и построчно сверил с описанием r1 (`_hexNeedsValidInput` семантика, `_confirm`/`_commitHex`/`_hexInput` взаимодействие, DOM-порядок кнопки, CSS-контракт) — расхождений нет.

Наследуется без повторной проверки:
- **AC1** (видимая кнопка/геометрия) — unit + 5 golden-сцен, разница только в кнопке (я сам пересмотрел эти же 5 сцен в этом заходе, см. таблицу гейтов — согласуется с r1);
- **AC2** (live parity, без дублирующего события) — мутация r1 №2 (снятие условия дедупликации в `_commitHex`) остаётся в силе, код не менялся;
- **AC3** (успешное завершение, кроме click-through-защиты — она пересмотрена заново выше) — закрытие/фокус-часть, код не менялся;
- **AC5** (прежние close paths) — Escape/outside/trigger, код нетронут;
- **AC6** (i18n/a11y) — 4 языка, DOM-порядок = Tab-порядок;
- **AC7** (touch/fallback/lifecycle, кроме нового `generalConfirmDoesNotClickThrough`-сценария) — Popover/fallback паритет;
- **AC8** (совместимость/бюджеты) — нет новых config/storage/backend полей;
- Low L1 (стилевая склейка `houseplan-card.ts:5932`), L2 (keyboard activation только через `.click()`), L3 (outside pointer/повторный trigger не покрыты автотестом, пред-существующий пробел) — сняты r1 с записью, делта их не касается, повторно не пересматривал.

## Находки

Нет. Обе Medium-находки r1 закрыты и лично перепроверены исполнением (см. «Закрытие раунда r1»). Новых находок дельта (M1/M2-фикс + чистый пересбор `dist/**` при ребейзе) не внесла — единственный файл продуктовой логики (`src/hp-color-opacity.ts`) не менялся со времени r1.

High: 0. Medium в скоупе: 0. Medium вне скоупа: 0 (десять `isometric-*` golden-diff — не находка этой задачи, см. раздел выше; issue не завожу).

## AC — таблица доказательств (r2, полная)

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

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

- `src/hp-color-opacity.ts` идентичен коду, разобранному в r1: единственный коммит диапазона, трогающий файл (`82f65acd`), лежит до r1-ревью; перечитал файл заново и подтвердил соответствие описанию.
- Обе Medium-находки r1 закрыты воспроизводимыми мутантами, лично прогнанными до и после патча: `color-picker-invalid-confirm-latch-removed` и `color-picker-confirm-click-through` оба «покраснели, как обязаны».
- `demo/smoke_color_picker_consumers.mjs` тестирует click-through защиту на потребителе (`general settings/lightOn`) без внешнего гасителя событий — устраняет ровно ту слабость, которую нашёл r1 (там decor-tool consumer гасил клик независимо от продуктовой защиты).
- Дельта после второго ребейза ограничена сгенерированными `dist/**`/`custom_components/houseplan/frontend/**` и `docs/images/screenshots.json` (fingerprint) — подтверждено: `git log --oneline origin/dev..HEAD -- src/hp-color-opacity.ts` даёт один коммит, предшествующий обоим ребейзам.
- `dist`/`custom_components/houseplan/frontend` синхронны с исходником (`cmp` идентичны, `git status --short` пуст после пересборки).
- Process-gate, трейлеры (`Issue: #476` на всех 9 коммитах, `User-Visible: yes` только на `82f65acd` с обоими changelog в этом же коммите) — корректны.
- 10 golden-diff `isometric-*` подтверждённо не относятся к этому диффу: воспроизведены на чистом `origin/dev` в отдельном worktree без единого коммита #476.

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

- `pytest tests_backend`, `npm run invariants`, performance-профили, полная матрица `demo/smoke_*.mjs`, полный `scripts/mutation-gate.mjs` (кроме двух целевых), `golden:accept` — см. обоснование в таблице гейтов.
- 15 «слабых» смоков по `stopPropagation` — просмотрел список имён повторно (не изменился с r1), все про другие поверхности, не про `hp-color-opacity`.
- Не расследовал глубже происхождение golden-долга #471 сверх того, что нужно, чтобы отделить его от этой задачи (не моя роль — задача другого issue).

## Вывод

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

---

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

- Ветка: `issue/476-color-picker-ok`, HEAD `6e0e1f8ca24b10a87569f9fec07810e08b7fa71c`.
- `origin/dev` = `fc5973c2239a2d25485b1acc955d0b0da620370c`, совпадает с `git merge-base origin/dev HEAD` — ветка полностью приведена, конфликтов нет.
- Диапазон: `git log --oneline origin/dev..HEAD` (9 коммитов) / `git diff origin/dev...HEAD` (56 файлов).
- Предыдущий документ: `docs/reviews/CODE-REVIEW-476-r1.md` (коммит `baea0fcfedfacd0393a750750279ce4f869dd5b9`), материал того захода — дерево `94485fdc0eca504692dd2776c7f3c86518a8dfb9` (SHA-анкеры `34a6b276473c`/`b5a1001e` мертвы после второго ребейза, объяснено выше).

---

<!-- material-anchors: сгенерировано конвейером (#414) -->

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

- Ветка: `issue/476-color-picker-ok`, коммит `6e0e1f8ca24b` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `2e8d8ce4b2320c3d28cc4e815b1c45da973a797e`
  ```
  git log --all --format='%H %T' | grep 2e8d8ce4b232
  ```
- ТЗ `docs/specs/476-color-picker-ok.md`, блоб `d21066d56e69c35fe7d0b40d9f965968dac9f803`
  ```
  git log --all --find-object=d21066d56e69c35fe7d0b40d9f965968dac9f803 -- docs/specs/476-color-picker-ok.md
  ```