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

# CODE-REVIEW-415-r2

Issue: #415 — «Полиш диалога помощи: размер кнопки и белый фон сообщения»
Ветка: `issue/415-support-visual-polish`
SHA ревью: `b0122803737d47950f8c2295b479afa53b8369e0`
Трек: `trivial` (AC в теле issue, без файла в `docs/specs/`) — этап ревью: **code**.
Заход: r2 · блокирующих циклов израсходовано 1 из 2 (зелёный вердикт этого
захода цикл не образует, #227).

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

Между r1 и r2 ветка была **перебазирована на ушедший вперёд `dev`**: r1 стоял на
`afe5e989` (тогдашний `origin/dev`), сейчас `origin/dev` = `206732e9` («ci:
refuse a review round that cites an unreachable SHA», issue #413, чужая
задача — попала в базу только ребейзом). Старый SHA r1
(`2fc8c1203782026bb45647ad54ef11857f7eb2c3`) в дереве больше не существует
(`git cat-file -t` — «could not get object info»): команда `git diff <тот
SHA>..HEAD` из §2.10 не выполнима буквально. Это ровно случай §7.2 «ребейз на
ушедший вперёд `dev` — после ребейза это другой код», поэтому материал этого
раунда — `git diff origin/dev...HEAD` целиком, а не узкая дельта поверх
осиротевшего SHA.

Продуктовый диф при этом **побайтово не менялся** — сверено построчно с телом
CODE-REVIEW-415-r1 (см. ниже раздел «Закрытие раунда r1»): те же три строки в
`src/houseplan-card.ts`, `src/styles/plan.styles.ts`,
`src/styles/dialogs.styles.ts`. Новый код в диапазоне — только пересъёмка
скриншотов и сам документ r1.

## Скоуп

Issue фиксирует два визуальных расхождения после #43:

- **AC1 (smoke):** кнопки «Общие настройки» и «Помощь и обратная связь» в одной
  шапке должны иметь одинаковые фактические ширину и высоту; отдельный размер
  для кнопки помощи не задаётся.
- **AC2 (smoke + golden перед бетой):** поле «Сообщение» должно использовать ту
  же поверхность ввода, что поле контакта (белую в светлой теме, штатную
  тёмную — в тёмной); read-only preview (`.supportraw`) не меняется.

Диапазон `origin/dev...HEAD` (3 коммита):
`d1691f4b` fix: align support controls (класс A+B+C, `Issue: #415`,
`User-Visible: yes`) → `c6fac8bf` docs: review document for #415 (класс C,
`User-Visible: no`) → `b0122803` docs: refresh reviewed support screenshots
(класс C — `docs/images/**`, не класс D; `User-Visible: no`).

Затронуто по коду: `src/houseplan-card.ts`, `src/styles/plan.styles.ts`,
`src/styles/dialogs.styles.ts`, `demo/smoke_support_feedback.mjs`,
`test/support-feedback.test.mjs`, оба changelog, бандлы (класс D),
`docs/images/*.png` + `docs/images/screenshots.json` (класс C, пересъёмка).
Без i18n, без миграции, без geometry — совпадает с заявленным в issue
«Затрагиваемое».

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

| Гейт | Команда | Результат |
|---|---|---|
| Типы | `npx tsc --noEmit` | зелёный, без вывода |
| Юнит-тесты | `npm test` | 1729 passed / 0 failed / 1 skipped (совпадает с хендоффом автора) |
| Сборка | `npm run build` | зелёный |
| Сверка бандла (3 копии) | `npm run bundle:sync` → `cmp dist/houseplan-card.js custom_components/.../houseplan-card.js`, `cmp dist/houseplan-assets.json custom_components/.../houseplan-assets.json`, `git status --porcelain` | все три идентичны, рабочее дерево чисто |
| Документационный гейт | `node scripts/check-docs.mjs` | **зелёный** («Documentation checks passed (7 files, 10 external links)») — была High-находка r1, закрыта |
| Новый `any` | `node scripts/no-new-any.mjs --base origin/dev --head HEAD` | 7 добавленных строк в 3 файлах, новых `any` нет |
| Оффлайн-гейт процесса | `node scripts/process-gate.mjs` | «гейт пройден, предупреждений 1» — WARN п.3 (нет `docs/specs/415-*.md`) ожидаемо для трека `trivial` |
| Выбор смоков | `node scripts/smoke-select.mjs --base origin/dev --head HEAD` | см. раздел ниже — идентичен выбору r1 (продуктовый диф не менялся) |
| Целевой смок (AC1+AC2) | `node demo/smoke_support_feedback.mjs` | **OK**, `headerActionsMatch: true`, `messageSurfaceMatchesContact: true` |
| Смок умеет падать | тот же смок на `src/houseplan-card.ts` + оба `*.styles.ts` из `afe5e989` (временный `git checkout`, независимо от r1) | `headerActionsMatch: false`, `messageSurfaceMatchesContact: false` — воспроизведено лично, дерево возвращено (`git status --porcelain` пуст, `cmp` бандла зелёный) |
| Точечные смежные смоки | `node demo/smoke_general_settings.mjs`, `node demo/smoke_help_affordance.mjs` | оба **OK** |
| CI-прогон пересъёмки | `gh run view 33592550716` | `conclusion: success`, workflow «Скриншоты документации», `headSha: c6fac8bf` — ссылка в коммите `b0122803` подтверждена, не выдумана |
| Провенанс пересъёмки | `git diff origin/dev...HEAD -- docs/images/screenshots.json` | 10 сценариев, у всех 10 обновился `sourceSha256` (глобальный отпечаток), у 8 обновился `imageSha256` — ровно совпадает с текстом коммита «Eight changed frames were reviewed; two byte-identical frames remain as environment witnesses» |

### Выбор браузерных смоков (`scripts/smoke-select.mjs`)

Вывод идентичен r1 (продуктовый диф не менялся):

```
Изменено файлов src/**: 3 · символов проекта на изменённых строках: 2
Матрица: 213 смоков · порог «широкого» символа: больше 42 смоков

Прямое совпадение (9): smoke_backup_transfer, smoke_bg_color,
smoke_color_picker_consumers, smoke_dialog_zombie, smoke_esc_dialogs,
smoke_general_settings, smoke_ha_controls, smoke_help_affordance, smoke_sun
  ← _openSettingsDialog (совпадение по имени JS-символа на изменённой строке,
     сама функция не менялась — менялся только список CSS-классов)
```

Решение по 9 найденным — то же, что в r1, и оно не устарело: причина
совпадения (общая строка вызова `_openSettingsDialog`/`_openSupportDialog`, не
сама функция) не изменилась, диф не изменился. Прогнал повторно два самых
предметно близких — `smoke_general_settings.mjs`, `smoke_help_affordance.mjs` —
оба **OK**. Остальные 7 не прогонял по той же причине, что и в r1: чисто
визуальная правка класса, не затрагивающая обработчик клика или разметку
диалогов. Полный прогон всех 213 смоков — предрелизный гейт (§8), не гейт
ревью.

### Что не проверял и почему

- **`npm run golden:verify`** — не прогонял. В `demo/golden/` нет сценариев,
  ссылающихся на `.support-button`, `.header-action` или `.supportmessage`
  (проверено `grep -rl` по `demo/golden/`) — совпадает с тем, что AC2 сам
  относит golden-проверку к «перед бетой», не к код-ревью.
- **`node scripts/model-invariants.mjs`** — не прогонял. Диф не касается
  геометрии, рёбер, `layout`, `marker.space`, `open_spans`.
- **`python -m pytest tests_backend`** — не прогонял. `custom_components/**/*.py`
  не тронут.
- **Performance-профили** — не названы в AC, не прогонял.
- Остальные 7 из 9 «прямое совпадение» смоков — решение см. выше, не изменилось
  с r1.
- Полный прогон 213 смоков — предрелизный гейт, здесь не нужен: диф не «задевает
  всё».

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **High** — `node scripts/check-docs.mjs` красный («screenshot source fingerprint is stale»): диф трогает `src/**`, отпечаток документации считается по всему `src/**` безусловно (§8) | Джоба `Docs screenshots` (`workflow_dispatch`) прогнана, артефакт принят `npm run docs:accept -- --reviewed --from=<артефакт>` с явным `--expect-change` на 8 сценариях, эталоны закоммичены в `b0122803` | `node scripts/check-docs.mjs` → «Documentation checks passed (7 files, 10 external links)» — перепроверено лично на SHA `b0122803`, не только со слов автора; CI-прогон `33592550716` подтверждён `gh run view` как реально существующий `success` |

Других находок в r1 не было — таблица из одной строки полна.

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

Ниже — то, что подтверждено уже в r1 (`docs/reviews/CODE-REVIEW-415-r1.md`, SHA
`2fc8c1203782026bb45647ad54ef11857f7eb2c3`) и **дополнительно перепроверено
лично в этом раунде** тем же способом (документ ревью недостижим по SHA, но
процитированные в нём строки кода сверены построчно с текущим диффом — они не
изменились):

- **AC1.** `.support-button` не несёт стилей размера — правило переименовано в
  `.header-action` (`src/styles/plan.styles.ts:188`) и навешено на обе кнопки
  шапки (`src/houseplan-card.ts:11496,11499`); `support-button` остался только
  как селектор-хук, ноль правил стиля на нём (перепроверено `grep -rn
  "support-button" src/` — одно вхождение, в шаблоне). Автотест
  `headerActionsMatch` умеет падать — перепроверено лично на исходниках
  `afe5e989`, независимо от r1.
- **AC2.** `.supportmessage` получил `background: var(--hp-bg)`
  (`src/styles/dialogs.styles.ts`), тот же токен, что `.namein`
  (`src/styles/dialogs.styles.ts:355`, тоже `var(--hp-bg)`) — перепроверено
  `grep -n ".namein" -A5`. `.supportraw` не тронут — не входит в диф. Автотест
  `messageSurfaceMatchesContact` умеет падать — перепроверено тем же способом.
- **Трейлеры и changelog коммита `d1691f4b`** — `Issue: #415`,
  `User-Visible: yes`, оба changelog правлены в том же коммите, терминология
  совпадает с `docs/USER-GUIDE.ru.md:58,1920` («Общие настройки», «Помощь и
  обратная связь») — перепроверено повторным `grep` по гайду.
- **Тестовый контракт `test/support-feedback.test.mjs`** — статический
  дубль-контроль поверх браузерного смока (ровно два вхождения
  `header-action` в шапке, правило `.header-action` содержит `min-width:44px`,
  `.supportmessage` содержит `background: var(--hp-bg)`) — диф файла
  перечитан целиком в этом раунде, не только унаследован.

Не перепроверялось заново, унаследовано без замечаний (диф этих утверждений не
касается): продуктовое рассуждение r1 о том, что задача не расширяет скоуп
(«ни новых сценариев, ни миграции, ни i18n, ни touch/perf») — дельта раунда
(рёбейз + пересъёмка скриншотов + документ) этого вывода не задевает.

## Находки

Новых находок нет. Находка r1 (High, check-docs) закрыта и перепроверена лично
(см. выше), новых High/Medium/Low в дельте этого раунда (рёбейз на `206732e9`,
пересъёмка 8 кадров, документ ревью r1) не обнаружено — рёбейз принёс только
чужой, не пересекающийся с этим диффом коммит #413 (CI-инструмент, не
продуктовый код), конфликтов слияния нет (`git status --porcelain` пуст на
каждом шаге проверки).

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

- **AC1 и AC2** — доказаны автотестом, который умеет падать; перепроверено
  лично в этом раунде независимо от r1 (см. «Унаследовано из r1»).
- **check-docs** — зелёный на точном SHA `b0122803`, ссылка на реальный
  успешный CI-прогон пересъёмки подтверждена через `gh run view`, а не принята
  на слово.
- **Провенанс пересъёмки** — 8 изменившихся кадров и 2 кадра-свидетеля в
  `screenshots.json` совпадают с формулировкой коммита `b0122803` число в
  число.
- **Рёбейз не сломал ничего**: `npm test` (1729/1730), `tsc`, `build`+`cmp`
  трёх копий бандла, `process-gate.mjs`, целевой и точечные смоки — все
  зелёные на актуальном `origin/dev` (`206732e9`), а не на устаревшей базе.
- **Трейлеры класса C.** `b0122803` трогает только `docs/images/**`
  (класс C по таблице §1, не класс D — `dist/**`,
  `custom_components/houseplan/frontend/**`, `demo/golden/baselines/**`), и
  `scripts/validate-commit-provenance.mjs` требует `Release`/`Baseline-Reviewed`
  только для `demo/golden/baselines/*.png|.json` — эта пара трейлеров сюда не
  относится; вместо неё коммит несёт содержательную строку «Canonical Linux
  capture: <ссылка>» в стиле вывода `scripts/docs-accept.mjs`. Формальных
  требований гейта это не нарушает.
- **Никакого расширения скоупа.** Диф раунда — рёбейз, документ ревью,
  пересъёмка скриншотов; продуктовый код не менялся ни строкой.

## Вывод

Единственная находка r1 (High, `check-docs`) закрыта и лично перепроверена, а
не принята со слов автора: гейт зелёный, CI-прогон пересъёмки существует и
успешен, провенанс `screenshots.json` совпадает с текстом коммита. Рёбейз на
ушедший вперёд `dev` потребовал полного разбора (§7.2), а не узкой дельты —
проведён полностью: оба AC передоказаны автотестом, который умеет падать,
независимо от r1. Новых находок нет. Вердикт — зелёный.