From a17820b3fea65f18811b92eb04cd160521756ea0 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 05:08:47 +0000 Subject: [PATCH] docs: review document for #415 Issue: #415 User-Visible: no --- docs/reviews/CODE-REVIEW-415-r2.md | 194 +++++++++++++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 docs/reviews/CODE-REVIEW-415-r2.md diff --git a/docs/reviews/CODE-REVIEW-415-r2.md b/docs/reviews/CODE-REVIEW-415-r2.md new file mode 100644 index 00000000..4e0db892 --- /dev/null +++ b/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. Новых находок нет. Вердикт — зелёный.