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

CODE-REVIEW-271-r3

• Issue: #271
• Этап: code (PROCESS.md §2.7)
• Заход: r3 · блокирующих циклов израсходовано 1 из 4
• HEAD ревью: c0b231fa06ea1eb4ba577d849e3a180f1801b8f4
• Диапазон: origin/dev...HEAD (origin/dev = d68e876f784b9c54ab4f9906b2d725393531c711 = точный merge-base — ветка линейна на актуальном dev, конфликт ребейза разрешён)
• Вердикт: зелёный · High: 0 · Medium: 0

Почему это полный разбор, а не разбор по дельте

r2 (HEAD 5ad9191, зелёный) не домержился в dev: ветка конфликтовала, и по процессу задачу вернули в S6-in-progress не как код-находку, а как merge-conflict. Автор сделал линейный ребейз (--force-with-lease) на ушедший вперёд dev вместо merge-коммита; старые SHA (5ad9191, 17c4ade) переписаны и больше не существуют в репозитории (git cat-file -t — ошибка).

Правило из брифинга этого раунда прямое: «ребейз на ушедший вперёд dev — после ребейза это другой код, разбор полным». Я не могу продиффить старое ревью против несуществующего SHA, поэтому весь код, диф и гейты этого документа проверены заново на текущем HEAD, а не унаследованы по факту совпадения текста автора.

Скоуп задачи

Регресс #271: buildMultiWallNodeMap() в degree-3+ узле хранил для сонаправленного луча только {u, halfDepth}, теряя длину исходного WallInterval; bevelMultiWallBody() перестраивал каждый луч прямоугольником длиной 8×H независимо от реального конца. Итог — несуществующие стены/торцы/тени после Optimize. Скоуп по ТЗ (docs/specs/271-finite-multiwall-rays.md, принято зелёным на SPEC-REVIEW-271-r1): сохранить конечную длину каждого canonical ray и не продолжать local masonry/paper/occluder дальше реального конца, без изменения MITRE_LIMIT/MULTI_WALL_JOIN_LIMIT, координат комнат, snapping, wall keys, opening symbols или схемы конфигурации. Соответствует J1 ("план не должен придумывать архитектуру") и J6 (одна каноническая геометрия для всех потребителей).

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

Диф origin/dev...HEAD — 21 файл вне сборочных артефактов (в т.ч. три docs/reviews/*-271-r*.md документа предыдущих раундов и сам спек, которые не являются предметом этого код-ревью).

Прочитан построчно:

• src/wall-thickness.ts — единственный продуктовый файл (110 строк дифа). MultiWallNodeRaySupport{halfDepth,length} хранит физический finite-strip; canonicalSupports() строит недоминированное множество Парето-пар (halfDepth, length) (дубликаты и доминируемые страйпы схлопываются, недоминируемые — напр. короткий толстый + длинный тонкий сонаправленные — оба остаются); bevelMultiWallBody() теперь строит по прямоугольнику на каждый support с supportExtent = min(extent, support.length) вместо одного прямоугольника на весь узел длиной 8H.
• test/wall-thickness.test.mjs — новые тесts (issue #271, две штуки: finite co-directional supports + permutation/order-independence; door-adjacent fixture) и правки существующих #249/#197 тестов под новую форму ray (length, supports).
• demo/golden/{harness,matrix}.mjs, test/golden-matrix.test.mjs — absentWallProbes для AC6.
• demo/smoke_junction_patch_resilience.mjs — все новые проверки (*StopsAt- FiniteRayEndpoint, *StopsAtLateralFiniteRayProbe, nearDoor*) идут через out.<key> и обязаны быть true в checkAll() — не декоративные поля.
• scripts/mutation-gate.mjs, scripts/smoke-links.mjs — новый мутант и обновлённая smoke-link регистрация.
• docs/{ARCHITECTURE,WALL-THICKNESS,TESTING,USER-GUIDE,USER-GUIDE.ru, CHANGELOG,CHANGELOG.ru}.md, docs/images/* — согласованы с контрактом.

Прогнано лично на точном HEAD (не переписано со слов автора):

Гейт	Команда	Результат
Typecheck	npx tsc --noEmit	чисто, без вывода
Unit	npm test	1165 passed, 0 failed (см. примечание ниже про 1 skip)
Build	npm run build	ок, 9.9s
Bundle sync	npm run bundle:sync + побайтовый diff трёх копий	dist, custom_components/houseplan/frontend, demo/srv/assets идентичны; git status после сборки чист
Docs fingerprint	node scripts/check-docs.mjs	Documentation checks passed (7 files, 10 external links)
Smoke selection	node scripts/smoke-select.mjs --base origin/dev --head HEAD	те же 2 смока, что называл автор (smoke_junction_patch_resilience.mjs, smoke_multiwall_junction.mjs), связь «зарегистрированная» через MultiWallNodeRaySupport
Targeted smoke 1	node demo/smoke_junction_patch_resilience.mjs	OK, все 27 полей out.* (включая новые nearDoor*) — true
Targeted smoke 2	node demo/smoke_multiwall_junction.mjs	OK, регресс #249 не тронут
Mutation	node scripts/mutation-gate.mjs --id=multi-wall-finite-ray-disabled	поймано 1 из 1 — мутант красит именно AC1/AC2-тест
Semantic golden (AC6)	node demo/golden/run.mjs --mode=capture --scenario=junction-patch-resilience-{plan,view}-dark	оба different (PNG-baseline не принят — ожидаемо), без прежней ошибки golden finite multi-wall ray contract failed
Приватность (AC8)	git diff --stat + find по репозиторию	1.json/2.json владельца не попали в диф и не найдены в дереве

Дополнительно прочитан алгоритм на корректность вручную: canonicalSupports убирает только те (halfDepth, length)-страйпы, чей прямоугольник целиком лежит внутри прямоугольника другого выжившего страйпа той же оси (обе координаты не больше плюс eps) — то есть удаление не теряет площадь, только убирает избыточные пары перед union. Тест на permutation/reversed-intervals (строка 856 test/wall-thickness.test.mjs) подтверждает детерминизм независимо от порядка/направления входа — сам прогнал этот тест в составе полного npm test.

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

• AC1 (node map не теряет длину) — доказано table-driven unit (test/wall-thickness.test.mjs:840), permutation/reversed-interval deep-equal подтверждён, прогнан.
• AC2 (короткий ray не достраивается) — geometry-unit с assertProbeInside/assertProbeOutside на [0,10]/[0,100] в geom, roomGeom и clean-floor; мутант multi-wall-finite-ray-disabled красит его.
• AC3 (реальные длинные rays и join #249 не обрезаны) — существующий тест «issue #249 node classification…» обновлён под новую форму ray и прошёл без ослабления исходных ассертов (масса #249-проверок на excessive-wedge не тронута).
• AC4 (проём без ложной тени) — новый unit (test/wall-thickness.test.mjs:917, фикстура 197-junction-patch.json переиспользована без изменений) плюс nearDoor* в browser smoke; прогнал оба, зелёные. Мутация теста подтверждена автором вручную в r2 (откат фикса красит door-тест) — я это не повторял, т.к. это тестирование теста, а не продукта, и в r2 уже задокументировано с точным местом правки.
• AC5 (все поверхности) — Plan/View/kiosk/Static/hidden Iso/clean-floor/ light-barrier поля в smoke — все true, включая nearDoorLightStopsAtFiniteRay.
• AC6 (semantic golden) — перепрогнал оба сценария лично, ошибка контракта не воспроизводится.
• AC7 (мутант ловит регресс) — прогнал лично, 1 из 1.
• AC8 (приватность/детерминизм) — проверено отсутствие приватных экспортов; детерминизм — через permutation-тесты AC1/AC3.
• AC9 (локальные гейты) — все выполнены лично, см. таблицу выше.
• Трейлеры: коммит e3b635a (fix(walls): bound multi-wall repairs to finite rays) несёт Issue: #271 + User-Visible: yes и включает оба changelog (docs/CHANGELOG.md, docs/CHANGELOG.ru.md) в этом же коммите. Остальные коммиты диапазона — User-Visible: no (тесты/документация/ревью-доки), корректно.
• Документация: ARCHITECTURE.md/WALL-THICKNESS.md/TESTING.md описывают ровно тот контракт supports/dominance, что реализован в коде; формулировки USER-GUIDE.md/USER-GUIDE.ru.md не придумывают новую терминологию сверх «короткое плечо» / «торец, тень, световой барьер», уже принятой в r1/r2.
• Скоуп: явные wall_columns не тронуты, MITRE_LIMIT/MULTI_WALL_JOIN_LIMIT не менялись, схема/модель/i18n не менялись — соответствует §5 ТЗ.

Находки

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

Low (не блокирует, унаследовано и подтверждено повторно): мутационный гейт multi-wall-finite-ray-disabled использует --test-name-pattern="issue #271 keeps finite", который матчит только AC1/AC2-тест (test/wall-thickness.test.mjs:840), но не door-adjacent AC4-тест (test/wall-thickness.test.mjs:917, начинается со слов «keeps a nearby door slot»). Способность AC4-теста падать при регрессии проверена автором вручную в r2 (откат supportExtent = extent в src/wall-thickness.ts:2102), не самим автогейтом. Это уже было отмечено в r2 как Low и оставлено на суждение автора; в r3 код и гейт не менялись — finding не переоткрываю, фиксирую как прежний статус.

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

• Приватные экспорты владельца 1.json/2.json — недоступны мне (не коммитятся по контракту AC8); численные примеры из issue/ТЗ сверены только по совпадению с таблицами issue/ТЗ через минимизированные fixtures, не повторным прогоном на реальных приватных файлах.
• Полный npm run golden:verify / полная smoke-матрица (174 сценария) / performance_smoke / полный Linux HA harness — по PROCESS.md это пред-релизный гейт, не гейт код-ревью; вне скоупа этого раунда, как и в r1/r2.
• npm run invariants -- --config <...> — не запускал: диф не меняет persisted config/layout/model version, edges комнат, marker.space или open_spans (подтверждено — git diff по test/fixtures/** пуст, новая дверь в smoke/unit добавлена только in-memory в тесте, не как сохранённая fixture). Правка исключительно про read-time reconstruction геометрии, так что точечная проверка конкретного экспорта инвариантов конфигурации здесь не применима; общие инварианты по всем моделям проекта покрыты уже прогнанным npm test.
• Ручная сессия в браузере / визуальная приёмка PNG-baseline — не выполнялась; семантический golden-контракт проверен исполнением, побайтовая приёмка снимков по правилам PROCESS остаётся пред-релизным шагом (golden:accept -- --reviewed на полном Linux CI артефакте).
• Расхождение теста (1165 passed / 0 skipped здесь vs заявленные автором 1164 passed / 1 skipped) — не дефект: единственный переменный тест (test/process-gate.test.mjs) условно скипается при недоступности git/gh-стаба; в этой среде git доступен, поэтому тест выполнился, а не скипнулся. Общее число тестов (npm run inventory → 1165) совпадает.

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

r2 (HEAD 5ad9191, документ docs/reviews/CODE-REVIEW-271-r2.md) сам был зелёным (High: 0, Medium: 0) — находок для закрытия в этом раунде нет. Единственная незакрытая запись r2 — Low про mutation-gate.mjs-паттерн (см. раздел «Находки» выше): не находка в скоупе, а принятое автором решение не чинить низкий риск; статус не изменился между r2 и r3 (код гейта и door-теста не менялся в дифе origin/dev...HEAD).

Из r2	Статус в r3	Где видно
(нет High/Medium в r2)	—	r2 был зелёным, цикл не тратился
Low: mutation-gate не покрывает AC4-тест по имени	не изменилось, waived	scripts/mutation-gate.mjs (--test-name-pattern="issue #271 keeps finite") не редактировался в этом раунде; сам прогнал node scripts/mutation-gate.mjs --id=multi-wall-finite-ray-disabled — ловит только AC1/AC2

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

Из-за ребейза этот раунд разобран полностью (см. раздел выше), поэтому унаследованных без проверки утверждений о коде и гейтах нет — весь диф, все AC и все гейты перепроверены лично на HEAD c0b231f. Из r1/r2 (docs/reviews/SPEC-REVIEW-271-r1.md, CODE-REVIEW-271-r1.md, CODE-REVIEW-271-r2.md, SHA 396b391/17c4ade/5ad9191 — сами эти SHA уже не существуют после ребейза) принято без повторного самостоятельного воссоздания только процессное:

• Что ТЗ было независимо проверено и принято зелёным на SPEC-этапе (r1); контракт §6 ТЗ я перечитал и сверил с текущим кодом сам, но факт прохождения отдельного spec-review цикла не переигрываю.
• Что High/Medium находки r1 (ложный golden-probe и отсутствие door-adjacent regression-guard) были реальными на своём HEAD — это уже доказано исполнением в комментарии r1 и не отражается на текущем коде, который я проверял с нуля независимо от того разбора.

Гейты, которые прогнаны, и почему остальные — нет

Прогнаны: tsc --noEmit, npm test, npm run build + побайтовая сверка трёх бандлов, check-docs.mjs, smoke-select.mjs, оба выбранных targeted smoke, целевой mutation, оба целевых semantic golden сценария (capture-режим, семантический assert, не PNG-приёмка). Не прогнаны и почему: полный golden/smoke/performance/HA-harness — пред-релизный гейт по PROCESS, не гейт код-ревью; npm run invariants — diff не касается persisted config/layout/geometry-ссылок, только read-time reconstruction.

Итог

Вердикт: зелёный. Правка воспроизводимо устраняет описанный в issue регресс (короткие лучи 20.833/12.5/1.382/200 больше не достраиваются до 8H), не ослабляет #197/#249/#261-контракты, согласована по всем поверхностям и в обоих changelog. Единственная открытая запись — принятый ранее Low о точности мутационного гейта, не блокирующий и не переоткрываемый.