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