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

CODE-REVIEW-250-r2

Скоуп раунда

Этап: code (PROCESS.md §2.7). Заход r2. Блокирующих циклов израсходовано 1 из 4 (потрачен жёлтым вердиктом r1; зелёный вердикт цикл не образует, §4).

Предыдущий раунд: r1, вердикт жёлтый, документ docs/reviews/CODE-REVIEW-250-r1.md, получен на SHA 7269550 (комментарий от 2026-08-22T23:15:18Z; SHA в самом вердикте не назван — восстановлен сопоставлением диапазона origin/dev..HEAD (4 коммита) и таймстампа комментария с git log; это отдельно отмечено в находках ниже).

Единственная находка r1 — CR-1 (Medium, в скоупе): после переименования теста test/opening-symbol.test.mjs ('shared renderer centres defaults…' → 'shared renderer centres every flip…') мутационный guard opening-gate-flip-cancels-turn в scripts/mutation-gate.mjs:1678 продолжал искать старый --test-name-pattern, ноль подтестов совпадало, node --test возвращал успех и на чистом, и на мутированном коде — guard не мог упасть.

Дельта раунда: git diff 7269550..HEAD (за вычетом коммита 7180eee, кладущего сам документ ревью r1) — коммит ed7ea29 "test: restore gate flip mutation coverage":

scripts/mutation-gate.mjs | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

Единственное изменение — строка паттерна:

- + '&& node --test --test-name-pattern="shared renderer centres defaults" '
+ + '&& node --test --test-name-pattern="shared renderer centres every flip" '

Дельта не трогает src/**, продуктовое поведение, контракт AC или новую подсистему — это точечное исправление тестовой инфраструктуры, ровно закрывающее CR-1. Согласно PROCESS.md §2.9 разбор ведётся по дельте, а не заново; условий для полного повторного разбора (ребейз, смена контракта, новая подсистема, объём дельты сопоставимый с задачей) нет.

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

Всё проверено исполнением, не только чтением диффа:

1. node scripts/mutation-gate.mjs --id=opening-gate-flip-cancels-turn → поймано 1 из 1 (guard теперь падает на мутанте, как требует ТЗ §14).
2. grep -n "shared renderer centres every flip" test/opening-symbol.test.mjs → тест с новым именем существует (строка 70), паттерн находит ровно один подтест.
3. grep -rn "shared renderer centres defaults" scripts/ test/ → пусто, других устаревших ссылок на старое имя нет.
4. Проверены остальные записи mutation-gate.mjs, ссылающиеся на test/opening-symbol.test.mjs (строки 773, 1650, 1664) — их паттерны не зависят от переименованного теста, переименование их не касается.
5. node scripts/mutation-gate.mjs --id=opening-symbol-flip-restores-edge-offset → поймано 1 из 1 — повторно проверен основной мутант задачи (не был предметом CR-1, но дешёвый и относится к тому же файлу).
6. npx tsc --noEmit → чисто, exit 0.
7. npm test → 1114/1114 pass, 0 fail, 0 skip.
8. npm run build → зелёно; dist/houseplan-card.js, demo/srv/assets/houseplan-card.js, custom_components/houseplan/frontend/houseplan-card.js — три копии, все с одинаковым SHA-256 806648ae60367be89ae4f4be1d8a6830d5ecc1f46bbd4548961536e8c27234c6 (совпадает с SHA, заявленным автором на r1 — ожидаемо: дельта r2 не трогает src/**, бандл не меняется).
9. node scripts/process-gate.mjs --range origin/dev..HEAD --issues → «гейт пройден, предупреждений 0» (полный диапазон, 6 коммитов).
10. Трейлеры коммита ed7ea29: Issue: #250, User-Visible: no — корректно, правка не меняет видимого поведения.

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

Находка	Чем закрыта	Где это видно
CR-1 (Medium, в скоупе): --test-name-pattern="shared renderer centres defaults" не матчит переименованный тест, guard opening-gate-flip-cancels-turn не может упасть	Коммит ed7ea29: паттерн заменён на "shared renderer centres every flip"	scripts/mutation-gate.mjs:1678; исполнением — node scripts/mutation-gate.mjs --id=opening-gate-flip-cancels-turn → поймано 1 из 1 (этим ревью, не только заявлением автора)

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

Без повторной проверки в этом раунде, на основании docs/reviews/CODE-REVIEW-250-r1.md (SHA 7269550) — дельта r2 не затрагивает ни один из этих фактов:

• AC1–AC9 ТЗ docs/specs/250-opening-centerline.md: безусловный нулевой offset openingSymbolOffset(), сохранение зеркала створки, независимость gate/passage, parity Flat/Static/Iso, физическая глубина косяков, tunnel/wall-cut контроль — подтверждены на 7269550 unit-матрицей, мутантом opening-symbol-flip-restores-edge-offset и целевыми smoke (smoke_wall_thickness, smoke_isometric_contract, smoke_opening_preview).
• Документация и оба changelog (RU/EN) правлены синхронно в user-visible коммите 0eb9ffe; docs/WALL-THICKNESS.md, docs/USER-GUIDE.ru.md, docs/ARCHITECTURE.md, docs/ISOMETRIC.md обновлены по AC8.
• node scripts/check-docs.mjs был зелёным на 7269550; в r2 не перепрогонялся, так как дельта не трогает src/** (отпечаток скриншотов документации не может измениться).
• Docs screenshots job принят на точном SHA 0eb9ffe480ca58f518ecce197a5431a0e45a1477, артефакт просмотрен автором.
• Golden impact (npm run golden:verify) разобран на 7269550: единственная целевая изменившаяся сцена задачи (opening-symbol-flip-pairs-light) верна, остальные три целевые сцены не поехали; широкий внешний baseline drift — предбетовый гейт, не блокирует code review. В r2 не перепрогонялся: дельта не трогает src/**, рендер не может измениться.
• smoke-select на 6-символьной дельте r1 дал НЕОПРЕДЕЛЁННОСТЬ; автор вручную прогнал три релевантных smoke. В r2 дельта — однострочная правка тестового скрипта, не продуктового кода; смоки к ней неприменимы и не перепрогонялись.

Находки этого раунда

Блокирующих находок нет.

Low, снята с записью. SHA, на котором получен вердикт r1, не был назван в самом тексте вердикта — пришлось восстанавливать его сопоставлением диапазона коммитов и таймстампа комментария с git log. Не блокирует (восстановление однозначно и заняло одну команду), но на будущее вердикт код-ревью должен явно называть SHA диапазона, чтобы следующий раунд не тратил на это отдельный шаг.

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

• Единственное изменение дельты (scripts/mutation-gate.mjs:1678) точно и полностью закрывает CR-1: паттерн исполнением подтверждён рабочим, мутант падает 1/1.
• Побочных ссылок на старое имя теста не осталось.
• Полный диапазон origin/dev..HEAD (6 коммитов) зелёный по typecheck, test, build (три копии бандла идентичны), process-gate --issues.
• Трейлеры коммита ed7ea29 корректны (Issue: #250, User-Visible: no), что соответствует характеру правки (тестовая инфраструктура, не видимое поведение).

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

• node scripts/check-docs.mjs — не прогонял в r2. Дельта не трогает src/**, отпечаток скриншотов документации зависит только от src/**, поэтому результат не может измениться относительно зелёного 7269550.
• npm run golden:verify — не прогонял в r2. Дельта не меняет ни один рендер-путь (src/** не тронут), полный разбор был выполнен и принят на 7269550.
• Браузерные смоки demo/smoke_*.mjs, включая smoke-select — не прогонял в r2. Продуктовый код не менялся; релевантные смоки (smoke_wall_thickness, smoke_isometric_contract, smoke_opening_preview) были прогнаны и зелёные на 7269550, дельта r2 их не касается.
• python -m pytest tests_backend -q — не требуется, custom_components/**/*.py не тронут ни в одном коммите диапазона.
• Performance-профили — не требуются, в AC не названы и чувствительные к перфу пути не тронуты.

Вердикт

Зелёный. Единственная находка предыдущего раунда закрыта точечно и подтверждена исполнением (мутант падает 1/1). Новых находок в дельте r2 нет, кроме Low-замечания к процессу (не блокирует). AC1–AC9 наследуются из r1 без изменений, так как дельта их не задевает.