houseplan-card/docs/reviews/CODE-REVIEW-229-r3.md

Код-ревью #229 · заход r3

Вердикт: зелёный · заход r3 · блокирующих циклов 2/4 · High: 0 · Medium: 0

Скоуп разбора

Разбор — по дельте, правило §2.9/§2.10. Предыдущий раунд (r2) получен на SHA ed13b4a (документ docs/reviews/CODE-REVIEW-229-r2.md; SHA в самом тексте вердикта не назван — восстановлен по git log и по фразе автора «Коммит ed13b4a» в хендоффе, предшествующем вердикту). Правка по r2 — один коммит fab0c38 («refactor: one function owns the junction geometry of a space»).

Дельта: git diff ed13b4a..HEAD — 11 файлов, из них содержательные src/wall-merge.ts (+33/-0), src/houseplan-card.ts (-16 строк локально, вызов геометрии заменён на одну строчку), src/plan-optimizer.ts (аналогично -13), scripts/mutation-gate.mjs (2 мутанта перенацелены), test/wall-merge.test.mjs (+3 юнита). Остальное — docs/images/screenshots.json (только sourceFingerprint, автоматически из-за изменившегося бандла; imageSha256 не менялся, кадры те же) и коммит с документом ревью r2 (fe2fcef, не код).

Дельта локальна: одна находка (Medium-1 r2), один модуль, ни новая подсистема, ни смена контракта поведения не затронуты — User-Visible: no в коммите верен, продуктовое поведение не менялось ни на шаг, только внутренняя организация кода и тестов. Полный повторный разбор не требуется; объём проверки — сама правка плюс всё, до чего она дотягивается (оба вызывающих места и мутационное покрытие обоих путей).

Находка r2 и её закрытие

Medium-1 (r2, в скоупе, возвращена в задачу): дефект High-1 (двойное масштабирование roomPolygons, из-за которого T-стык партиции к середине комнатной стены не находился) был идентичен в двух местах — _mergeSpacePartitions (карта) и optimizePlans («Оптимизировать планы») — потому что каждый вызывающий строил геометрию примыканий самостоятельно. Регрессионное покрытие защищало только путь оптимизатора; путь карты, который r1 воспроизвёл вторым способом («в браузере через реальные клики»), не имел ни юнита, ни мутанта.

находка	чем закрыта	где это видно
Medium-1: однобокое покрытие двойного масштабирования room-полигонов, защищён только plan-optimizer.ts	Геометрия примыканий (комнаты, колонны, концы черновиков) вынесена в одну функцию spaceMergeGeometry(space, { excludeDraftId }); оба вызывающих теперь однострочный вызов — масштаб можно ошибиться ровно в одном месте	src/wall-merge.ts:278-295 (новая функция); src/houseplan-card.ts:6551-6557 и src/plan-optimizer.ts:503-506 (оба вызывающих — по одной строке, без собственного построения геометрии)
— регрессия для обоих путей	Мутанты partition-merge-rescales-rooms и chain-merge-sees-own-draft перенацелены с plan-optimizer.test.mjs/смока на общий test/wall-merge.test.mjs, патчат теперь сам spaceMergeGeometry	scripts/mutation-gate.mjs:721-741; юниты test/wall-merge.test.mjs:214-262

Закрытие проверено не по заявлению автора, а исполнением (см. «Как проверялось»): оба мутанта, применённые к текущему коду, красят гвард, а не только исходный.

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

Материал: git diff ed13b4a..HEAD и git diff origin/dev...HEAD (полный диапазон issue). Ручного тестирования в цикле нет — далее только то, что исполнено или разобрано по коду с явной пометкой.

Прочитано и разобрано по коду:

• src/wall-merge.ts:278-295 (spaceMergeGeometry) — сопоставлено построчно со старыми телами обоих вызывающих (см. git diff выше): семантика идентична, включая то, что plan-optimizer.ts не передаёт excludeDraftId — как и раньше, там исключения черновика не было и не нужно (оптимизатор не выполняется во время активного рисования).
• Проверено отсутствие циклического импорта: wall-merge.ts теперь импортирует roomPoly из ./logic; logic.ts не импортирует wall-merge.ts (grep — 0 совпадений). Компилируется без ошибок (см. ниже) — само по себе уже доказательство при бандлинге через rollup/tsc.

Проверено исполнением:

• npx tsc --noEmit — чисто.
• npm test — 1007/1007, без изменений к количеству от заявленного автором.
• npm run build + сверка трёх копий бандла (dist/houseplan-card.js, custom_components/houseplan/frontend/houseplan-card.js, demo/srv/assets/houseplan-card.js) — идентичны побайтово (sha256 9dd1ec1a…), git status после сборки чист — закоммиченный бандл соответствует исходникам.
• node scripts/check-docs.mjs — passed (7 файлов, 10 внешних ссылок); подтверждает, что изменение sourceFingerprint в screenshots.json легитимно и не требует новых кадров (imageSha256 не менялся).
• node scripts/process-gate.mjs — гейт пройден, предупреждений 0.
• node demo/smoke_wall_chain_merge.mjs — OK, все 9 проверок, включая chainMergesIntoTheWallItTouches, draftIsGone (путь §8.6 через реальные клики).
• node demo/smoke_wall_junctions.mjs — OK, все 12 проверок (соседняя поверхность — T-стыки и геометрия примыканий).
• node demo/smoke_optimize_coordinate_canonicalization.mjs — OK, все 13 проверок (путь «Оптимизировать планы»).
• Дисциплина «тест умеет падать» — оба перенацеленных мутанта проверены вручную (штатный харнесс mutation-gate.mjs непригоден для юнит-гвардов до #235, независимо от этой задачи):
  • partition-merge-rescales-rooms (патч возвращает лишнее деление на 1000 внутри spaceMergeGeometry): наложен на src/wall-merge.ts, пересобран test-build (tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs), node --test --test-name-pattern="issue 229" test/wall-merge.test.mjs дал 2 падения (space geometry keeps rooms in the coordinates… и a junction on a room side survives…, 1 !== 0). Патч снят, повторный прогон — 19/19 зелёных.
  • chain-merge-sees-own-draft (патч заменяет исключение черновика на void exclude): тем же способом — 1 падение (the chain being finished is not its own junction). Патч снят, 19/19 зелёных.
  • После снятия обоих патчей полный npm test — 1007/1007, git status чист (никаких временных правок не осталось).

Не прогонялось и почему: полный набор из 127 смоков, golden:verify, pytest tests_backend, performance-профили — дельта этого раунда не задевает рендер, backend или перф-пути; полные наборы — предрелизный гейт (§8), не гейт ревью соразмерного изменения. Задетые поверхности (карта, оптимизатор, T-стыки, слияние цепочки) покрыты смоками выше и юнитами.

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

Без повторной проверки в этом раунде, дельта не касается их доказательной поверхности:

• AC1, AC3-AC7, AC9 — наследованы уже в r2 из документа docs/reviews/CODE-REVIEW-229-r1.md (SHA 50a00e4); дельта r2→r3 не затрагивает пересчёт host.t, материализацию x/y/angle, допуски, канонизацию направления, транзитивность/порядконезависимость слияния — их код не менялся.
• AC8 (§8.6, слияние ограничено компонентой связности новой цепочки) — проверено в r1/r2 чтением и смоком; в r3 логика seedIds в mergeCollinearPartitions не менялась, изменился только источник геометрии примыканий, который seedIds не касается. Перепроверено попутно смоком smoke_wall_chain_merge.mjs (chainMergesIntoTheWallItTouches) в этом раунде — совпадает.
• AC2 (T-стык партиции к середине комнатной стены) — критерий из документа docs/reviews/CODE-REVIEW-229-r2.md (SHA ed13b4a) не наследован вслепую: это и есть предмет дельты r3, перепроверено заново в этом раунде (юнит «a junction on a room side survives, through the shared geometry», исполнен, зелёный; мутант, умеет падать — см. выше).

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

• spaceMergeGeometry — единственный источник геометрии примыканий для обоих путей; масштаб координат общий с партициями (без лишнего деления), исключение активного черновика — опционально и по умолчанию отключено (важно для пути оптимизатора, где активного черновика не бывает).
• Новые юниты (test/wall-merge.test.mjs:214-262) покрывают три вещи по отдельности: масштаб полигонов (включая x/y/w/h-комнату и комнату без геометрии), исключение черновика (обе ветки), сам T-стык — и делают это на уровне модуля, не дублируя мутационное покрытие смоком.
• Трейлеры коммита fab0c38: Issue: #229, User-Visible: no — верно, поведение продукта не меняется, правка рефакторит внутреннюю организацию; changelog не требуется и не тронут.
• Импорт roomPoly из ./logic в wall-merge.ts не создаёт цикла зависимостей.

Чего не проверял

• Полный набор смоков (127), npm run golden:verify, python -m pytest tests_backend, performance-профили — не задеты дельтой этого раунда (см. «Как проверялось»).
• Сценарий «комната через реальные клики» в смоке — автор honestly сообщил, что не взлетел (_offerWallFaces не даёт цепочке завершиться штатно) и оставил покрытие на юнитах общего модуля. Не блокирует: AC2 доказан юнитом на уровне mergeCollinearPartitions/spaceMergeGeometry, что достаточно — геометрия примыканий и механика предложения стен (_offerWallFaces) — разные слои, и дефект r1/r2 жил именно в геометрии. Если понадобится клик-путь через реальную комнату — отдельная работа поверх _offerWallFaces, не предмет этой задачи.

Итог

Обе High из r1 и единственная Medium из r2 закрыты по существу и перепроверены исполнением. Дефект устранён на уровне причины (общая функция геометрии), а не симптома — оба мутанта краснеют для обоих путей из одного патча. Задача готова к выходу из цикла ревью.