docs: review document for #415

Issue: #415
User-Visible: no

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

@@ -0,0 +1,194 @@
+# 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. Новых находок нет. Вердикт — зелёный.