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

CODE-REVIEW-508-r2

Issue: #508 — «Сводная панель: в диалоге настроек не работает прокрутка — колесом мыши и touch на мобильных» Материал: 6ac513caa09a8e583869879412aa3a0c67d04488 (рабочая копия уже на нём). Ветка приведена конвейером к dev до ревью: e23d742c → 6ac513ca, поверх легло 1 коммит dev (несвязанный — docs: review document for #502). Заход: r2 · блокирующих циклов израсходовано 0 из 4. Ребейз на ушедший вперёд dev формально делает дерево другим (§7.2) → разбор полный, а не по дельте.

Почему вообще r2, если r1 был зелёным без находок

Код-ревью r1 (docs/reviews/CODE-REVIEW-508-r1.md, материал 768e1281) уже завершилось вердиктом «зелёный, находок нет» с исчерпывающим личным прогоном гейтов, мутантов, смоков и подтверждением автора на живом стенде HA. Сразу после публикации вердикта автор сообщил в issue: «Автоматическое ревью не отработало» — статусная метка не переставилась, конвейер оставил задачу на месте. Затем конвейер перебазировал ветку на успевший уйти вперёд dev (там landing получил несвязанный коммит с ревью-доком для issue #502) и передал её на повторное ревью уже под новым SHA. Автор с момента r1 в код и ТЗ не вносил ничего — это не возврат на правки, а техническое повторение ревью из-за сбоя механики метки плюс ребейз. Поэтому раздела «находка → возврат → правка» в этом раунде по существу нет: проверка ниже — подтверждение, что ребейз не изменил и не сломал ничего, а не разбор чьих-то правок.

Скоуп

Не изменился с r1: один функциональный коммит (e38beed7, экс-768e1281) — класс A (src/hp-dialog.ts, src/summary-panel-editor.ts) + класс B (новый смок demo/smoke_summary_dialog_scroll.mjs, контрактный юнит-тест test/hp-dialog-contract.test.mjs, два мутанта в scripts/mutation-gate.mjs) + класс C (docs/ARCHITECTURE.md, оба CHANGELOG) + класс D (пересобранный бандл во всех копиях, docs/images/screenshots.json — только фингерпринт). hp-dialog получает opt-in булев атрибут flex-content (?flexcontent на ha-dialog, обе HA-ветки рендера); нативная <dialog>-ветка не тронута. Диалог настроек сводной панели его объявляет — единственный из десяти вызывающих <hp-dialog>.

J1 (docs/SCOPE.md) — обзорная сводная панель входит в «show the whole home at a glance»; чистый баг-фикс регресса после #505, скоуп не расширен, продукт не меняет договор.

Как проверялось (это не дельта — это независимая перепроверка «ничего не изменилось»)

Первый шаг — не поверить заявлению «ребейз ничего не тронул», а доказать его:

git diff 768e1281 e38beed7 --stat   # r1-материал vs текущий фикс-коммит

Результат: единственная разница — файл docs/reviews/SPEC-REVIEW-502-r1.md (несвязанный коммит dev для issue #502). Все файлы продукта — src/hp-dialog.ts, src/summary-panel-editor.ts, test/hp-dialog-contract.test.mjs, docs/ARCHITECTURE.md, оба CHANGELOG, scripts/mutation-gate.mjs, demo/smoke_summary_dialog_scroll.mjs, весь пересобранный бандл — побайтово идентичны материалу r1. docs/images/screenshots.json проверен построчно (grep imageSha256 на диффе): изменились только sourceFingerprint/sourceSha256-контекст, ни один imageSha256 не сдвинулся.

Это и определило объём: код доказанно тот же, что уже получил зелёный вердикт с личными прогонами гейтов, мутантов и смоков (не только заявлением автора — заявление в r1 тоже было перепроверено исполнением). Все выводы AC1–AC6 из r1 остаются в силе автоматически, потому что применяются к тому же байт-в-байт коду. Тем не менее раунд объявлен «полным» (ребейз, §7.2), поэтому ниже — не просто ссылка на r1, а собственный прогон части гейтов на текущем SHA 6ac513ca, чтобы исключить эффекты самого ребейза (окружение сборки, конфликт слияния бандла и т. п.), а не только идентичность текста диффа.

Дешёвые гейты

Validate на 6ac513ca зелёный (дано в задаче ревью, https://github.com/Matysh/houseplan-card/actions/runs/34397342070) — tsc, npm test (2436/2436), npm run build со сверкой бандла уже подтверждены конвейером на этом самом SHA, повторно не гонял.

Прогнано лично на 6ac513ca (не на материале r1 — на текущем SHA)

Гейт/смок	Результат
node --test test/hp-dialog-contract.test.mjs (AC1 текстовая часть, AC4)	3/3 pass
node scripts/check-docs.mjs (диф трогает src/**)	«Documentation checks passed (7 files, 12 external links)» — совпадает с числом из r1
node scripts/bundle-sync.mjs (пересборка + раскладка по трём местам: dist, custom_components/houseplan/frontend, demo/srv/assets)	выполнено; git status --porcelain после — пусто (отслеживаемые копии не разошлись с коммитом)
node demo/smoke_summary_dialog_scroll.mjs (AC1/AC2, прямое совпадение)	OK
node demo/smoke_summary_panel_polish.mjs (AC3, прямое совпадение — файл смока не менялся)	OK
node demo/smoke_dialog_modal_recovery.mjs (зарегистрированная связь: общий hp-dialog)	OK
node demo/smoke_esc_dialogs.mjs (зарегистрированная связь)	OK
node demo/smoke_dialog_footer_width.mjs (зарегистрированная связь)	OK
node scripts/mutation-gate.mjs --id=summary-dialog-drops-flex-content	чистый прогон OK → мутация: «тест покраснел, как обязан» → поймано 1 из 1
node scripts/mutation-gate.mjs --id=hp-dialog-ignores-flex-content	то же → поймано 1 из 1
node scripts/smoke-select.mjs --base origin/dev --head HEAD	«НЕОПРЕДЕЛЁННОСТЬ» — 2 файла src/**, 0 символов на изменённых строках (тот же результат, что в r1); выбор смоков выше сделан вручную: прямое совпадение (диалог панели) + зарегистрированные связи (общий hp-dialog)
grep -rn "<hp-dialog" src/	10 вызывающих (включая summary-panel-editor.ts); ровно список из test/hp-dialog-contract.test.mjs AC4, opt-in — один

Изначально попытка запустить браузерные смоки провалилась ошибкой окружения (Failed to fetch dynamically imported module: http://demo.local/..., page.waitForFunction timeout) — это была не регрессия, а отсутствие локальной копии demo/srv/assets (она не хранится в репозитории, scripts/bundle-sync.mjs: «копий две с половиной», рабочая копия стенда собирается заново). Тот же таймаут воспроизводился на demo/smoke_summary_panel_polish.mjs, файл которого этот диф не трогает вовсе — это подтвердило, что причина в окружении ревью-песочницы, а не в коде. После node scripts/bundle-sync.mjs (пересборка из уже собранного dist/) оба смока пошли зелёными.

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

Код-ревью r1 не имело находок (High 0, Medium 0, Low 0) — блокирующих находок для закрытия нет. Раунд r2 открылся не как возврат на правки, а как техническое повторение из-за несработавшей автоматической перестановки метки после зелёного вердикта r1, дополненное последующим ребейзом на ушедший вперёд dev (конвейер, не автор). Автор кода/ТЗ с момента r1 не менял — независимо доказано выше диффом 768e1281..e38beed7.

Находка r1	Статус	Где видно
(нет находок)	—	docs/reviews/CODE-REVIEW-508-r1.md, раздел «Находки»: «Нет. High: 0, Medium: 0, Low: 0»

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

Без повторного самостоятельного вывода, но с проверкой байт-в-байт идентичности кода (см. «Как проверялось»), наследую из docs/reviews/CODE-REVIEW-508-r1.md (материал 768e1281f9119b12d018b416372984ff17eae62d, дерево 1594677359b610e22fc5886db02f66bc3c943322):

• диагноз (scroll chaining обрывается на height-unbound .summary-editor под ha-dialog, overflow: auto + overscroll-behavior: contain) — независимо подтверждён автором на живом стенде HA 2026.9.1, не только в стабе смока;
• личные прогоны tsc, npm test (2437/2436 pass+1 skip), no-new-any, bundle:budget на материале r1 — не переигрывал повторно, т. к. Validate CI зелёный на 6ac513ca покрывает те же проверки на байт-в-байт идентичном коде;
• вывод AC6 (i18n/модель/перф не задеты, трейлеры Issue:/User-Visible: yes и оба CHANGELOG в одном коммите) — перепроверен построчно, см. «AC → доказательство» ниже, поэтому это скорее «переподтверждено», чем слепо унаследовано;
• трассировку к спек-ревью (SPEC-REVIEW-508-r1.md жёлтый → SPEC-REVIEW-508-r2.md зелёный на SHA f02af9330b17a37eea6c8086f4335cbbc7265d36, M1/M2 закрыты правкой тела issue) — код-ревью r1 её не переоткрывало, r2 тоже не переоткрывает: текст issue с тех пор не менялся.

AC → доказательство → чем краснеет (переподтверждено лично на 6ac513ca)

AC	Доказано	Чем краснеет
AC1 (HA-ветка: колесо крутит .summary-editor, шапка/футер неподвижны)	demo/smoke_summary_dialog_scroll.mjs сценарий (a) — OK, лично	оба мутанта, лично: «покраснел, как обязан»
AC2 (touch 390×844 крутит редактор; диалог ≤ вьюпорта; футер доступен)	сценарий (b) — OK, лично	те же два мутанта
AC3 (нативная ветка не меняется)	smoke_summary_panel_polish — OK, лично; файл смока не в диффе	не защитный AC
AC4 (прочие 9 hp-dialog без flex-content)	test/hp-dialog-contract.test.mjs — 3/3 pass, лично; grep по src/** — 10 вызывающих, 1 opt-in	ассерт === 1 в тесте (in-memory проба r1 сохраняет силу — код теста не менялся)
AC5 (оба мутанта пойманы)	оба мутанта лично прогнаны — «поймано 1 из 1» каждый	это и есть доказательство
AC6 (User-Visible: yes, оба changelog, i18n/модель/перф не задеты)	git show --stat e38beed7: docs/CHANGELOG.md+docs/CHANGELOG.ru.md в том же коммите; git log -1 коммита содержит Issue: #508 и User-Visible: yes; ни один i18n/translations файл не в диффе; src/hp-dialog.ts diff — только проброс булева атрибута, новых обработчиков нет	не защитный AC, доказано чтением

Одно число — один источник

Диф не вводит и не дублирует ни одну видимую пользователю величину (площадь, значение, подпись): меняется только внутренняя раскладка скролл-контейнера через булев атрибут. test/single-source-numbers.test.mjs не затрагивается и не требуется для этой правки.

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

• Обе HA-ветки рендера (describedBy и без) несут ?flexcontent=${this.flexContent} — строки src/hp-dialog.ts:515,531, подтверждено и тестом, и мутантами лично.
• Нативная <dialog>-ветка не содержит flexcontent/связанных селекторов — регресс на неё исключён и тестом (smoke_summary_panel_polish), и построчным чтением.
• docs/TOUCH-SUPPORT.md:48–49 называет «simple settings form» сводной панели гарантированной View-touch- поверхностью — включение touch в скоуп не расширение, а обязательное соответствие контракту.
• Терминология CHANGELOG.ru.md («сводной панели», «настроек») совпадает с docs/USER-GUIDE.ru.md:264 («Настройки сводной панели»).
• docs/images/screenshots.json: только sourceFingerprint/sourceSha256; все 11 imageSha256 идентичны — докс-скриншоты не изменились по существу.
• Один коммит (e38beed7), трейлеры Issue: #508 и User-Visible: yes на месте.
• После bundle-sync рабочая копия чиста (git status --porcelain пуст) — три копии бандла (dist, custom_components/houseplan/frontend, demo/srv/assets) согласованы с закоммиченным.
• Ребейз сам по себе не внёс никакого продуктового изменения — доказано диффом, а не заявлено.

Находки

Нет. High: 0, Medium: 0, Low: 0.

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

• npm run golden:verify — атрибут opt-in, ?flexcontent= в Lit убирает атрибут целиком при false, разметка прочих hp-dialog не меняется ни на байт; golden-сцен диалога сводной панели в репозитории нет (снято ещё в SPEC-REVIEW-508-r1.md M1). Риск нулевой, решение то же, что в r1, переподтверждено тем же рассуждением на идентичном коде.
• python -m pytest tests_backend — диф не касается custom_components/houseplan/**/*.py.
• Полная матрица смоков (237 шт.) и перф-профили — не названы в AC; smoke-select вернул «НЕОПРЕДЕЛЁННОСТЬ» (2 файла src/**, 0 символов на изменённых строках, порог «широкого» — 47 смоков). Выбор сужен вручную до прямого совпадения (smoke_summary_dialog_scroll, smoke_summary_panel_polish) и зарегистрированных связей на общий hp-dialog (smoke_dialog_modal_recovery, smoke_esc_dialogs, smoke_dialog_footer_width) — все пять прогнаны лично, все зелёные.
• npm run invariants — диф не трогает геометрию/рёбра комнат/layout/marker.space/open_spans, гейт не применим.
• Полный npm test (все 2436 юнитов) — не переигрывал повторно вживую: Validate CI уже подтвердил его зелёным на этом самом SHA 6ac513ca (ссылка выше), а не на другом; вместо повторного полного прогона лично выполнен целевой test/hp-dialog-contract.test.mjs.

Вердикт

Зелёный. Разбор — полный (ребейз, §7.2), но не «с нуля»: доказано диффом, что код байт-в-байт идентичен уже одобренному материалу r1, и это доказательство переподтверждено собственными прогонами гейтов, смоков и мутантов на текущем SHA 6ac513ca, а не принятием чужого вердикта на веру. Находок нет. Раунд не образует цикл (§4) — вердикт зелёный.

---

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

• Ветка: issue/508-summary-dialog-scroll, коммит e23d742cd508 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: 5fc02b5d1de102ed9770f28fc5eb3a41098cbc11

  git log --all --format='%H %T' | grep 5fc02b5d1de1
  

• Вердикт конвейера: green · High 0