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

# CODE-REVIEW-271-r3

- Issue: [#271](https://github.com/Matysh/houseplan-card/issues/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 о точности мутационного гейта, не блокирующий и не переоткрываемый.