# Code review #172 — r2 - **Issue:** https://github.com/Matysh/houseplan-card/issues/172 - **Spec:** `docs/specs/172-zero-divider-taper.md`, зелёное `SPEC-REVIEW-172-r1.md` - **Reviewed branch:** `issue/172-zero-divider-taper` (HEAD detached at `origin/issue/172-zero-divider-taper`) - **Reviewed range:** `origin/dev..HEAD` = `93f86f8` (spec) → `56834c5` (spec review doc) → `c2112db` (fix, **User-Visible: yes**) → `eeb9c34` (code review r1 doc) - **Base:** `origin/dev` at `4d71f57` (уже включает #150 «preserve wall thickness transitions») - **Reviewer:** Claude, независимая сессия без контекста реализации - **Причина цикла r2:** r1 был зелёным (`High: 0 · Medium: 0`), но слияние в `dev` конфликтовало; PROCESS.md §2.6/§10.4 требует повторного код-ревью после ребейза на ушедший вперёд `dev`, потому что это другой код. Ветка перебазирована автором на `origin/dev` `4d71f57` (включает #150), конфликт разрешён, коммит реализации переименован в `c2112db`. Цикл считается по этапу (§10.4): вердикт по ТЗ не расходует бюджет код-ревью, это первая расходующая бюджет код-ревью правка → `r2/4`. ## Вердикт **Зелёный · цикл r2/4 · High: 0 · Medium: 0.** Продуктовый диф после ребейза **содержательно идентичен** дифу, уже проверенному в `CODE-REVIEW-172-r1.md`: те же 25 строк в `src/wall-thickness.ts` (симметричная ветка «локальный cap» в `insetContour()`/`outsetContour()`), тот же набор тестов, тот же smoke, та же golden-сцена (версия матрицы 25), та же документация и оба changelog в одном коммите. Единственное отличие — коммит стал `c2112db` вместо `dfd56e8` (другой SHA после ребейза на `dev`, содержащий #150) и второй код-ревью документ (`eeb9c34`) добавлен как отдельный класс-C коммит. Я не унаследовал вывод r1 не глядя: пересобрал бандл, независимо повторил дисциплину «тест умеет падать» (временно откатил обе новые ветки в коде и получил 2 красных unit-теста и 2 красных поля в named-smoke), прогнал полный юнит-регресс и четыре смежных/зависимых browser-smoke, включая smoke #150 (`smoke_wall_thickness_transition.mjs`), которого не было в списке r1, потому что на момент r1 #150 не был частью проверяемого дерева — теперь он есть, и обе правки одной и той же общей geometry-функции сосуществуют без конфликта поведения. ## Скоуп Единственный продуктовый файл — `src/wall-thickness.ts`: `insetContour()` и `outsetContour()` получили симметричную ветку `if ((oA > 0) !== (oB > 0))`, которая перехватывает переход «положительный offset ↔ ровно нулевой offset» до общей mitre/bevel- и collinear-логики, помещённую **перед** веткой `collinearJoint()`. Для точного коллинеарного перехода обе ветки вычисляют одну и ту же точку (`nA === nB` при совпадающем направлении), поэтому перестановка порядка проверок не меняет поведение AC3 (существующая точная ступень). Сопутствующие изменения (не поменялись с r1): `test/wall-thickness.test.mjs` (два новых теста), `demo/smoke_zero_divider_taper.mjs` (новый), `demo/golden/{harness,matrix}.mjs` + `test/golden-matrix.test.mjs` (новая сцена `split-zero-divider-taper-dark`, `GOLDEN_MATRIX_VERSION` 24→25, baseline сознательно не принят), `docs/WALL-THICKNESS.md` §3 (контракт cap задокументирован), `docs/CHANGELOG.md`/`docs/CHANGELOG.ru.md`, три синхронные копии бандла, `docs/specs/README.md`. Ровно один продуктовый коммит `c2112db`, трейлеры `Issue: #172` / `User-Visible: yes` на месте, оба changelog в том же коммите (проверено `git show --stat c2112db`). Ветка называется по правилу, `process-gate.mjs` проходит на всём диапазоне (4 коммита, 0 предупреждений). ## Как проверялось | Гейт | Результат | |---|---| | `npx tsc --noEmit` | pass, без вывода | | `npm test` | **833/833 pass** (было 830/830 в r1 — разница объясняется тремя тестами #150, которые вошли в базовый `dev` при ребейзе; сами тесты #172 те же два) | | `npm run build` + сверка трёх копий бандла | pass; `sha256sum dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js demo/srv/assets/houseplan-card.js` → один и тот же хеш `21f8ffc…3233e`; `git status --short` после копирования — пусто, бандл в дереве уже актуален | | Откат обеих новых веток в `insetContour`/`outsetContour`, повторный `npm test` | **831/833**, красные ровно `variable-offset contours keep a local cap at angled positive-to-zero joins` и `near-collinear zero-depth Split divider never grows a masonry taper` — дисциплина «тест умеет падать» подтверждена мной лично на пересобранном дереве, а не переиспользована из r1 | | Пересборка **без** фикса + `node demo/smoke_zero_divider_taper.mjs` | `planHasNoTaper: false`, `lightHasNoTaper: false`, `FAILED (2)` — smoke тоже подтверждённо умеет падать | | Восстановление фикса, пересборка, синхронизация трёх копий бандла | все три sha256 совпадают между собой и с закоммиченным деревом | | `node demo/smoke_zero_divider_taper.mjs` (AC6/AC7) | pass, все 13 полей `true` | | `node demo/smoke_split_corner_wall.mjs` (смежная поверхность, AC3/AC9) | pass | | `node demo/smoke_wall_thickness.mjs` (смежная поверхность) | pass | | `node demo/smoke_wall_junctions.mjs` (смежная поверхность, T/L-стыки) | pass | | `node demo/smoke_wall_thickness_transition.mjs` (#150 — та же общая функция, слита при ребейзе) | pass — правка #172 не сломала соседнюю правку #150 в том же файле | | `node scripts/process-gate.mjs --range origin/dev..HEAD --target-ref refs/heads/issue/172-zero-divider-taper` | pass, 4 коммита, 0 предупреждений (без `--issues`, офлайн-режим — токен GitHub здесь не нужен для проверки трейлеров/веток/changelog) | | `git show --stat c2112db` | подтверждает оба changelog, документацию и три копии бандла в одном коммите с `User-Visible: yes` | ### Не прогонялось, и почему - **`npm run golden:verify`.** Новая сцена `split-zero-divider-taper-dark` (`GOLDEN_MATRIX_VERSION` 25) не имеет baseline — проверил напрямую: `demo/golden/baselines/` не содержит записи `split-zero-divider-taper-dark`. `verify` по контракту (`demo/golden/README.md`) обязан упасть на отсутствующем эталоне независимо от корректности геометрии; AC8 сознательно откладывает принятие baseline на предрелизный Linux-гейт (`golden:accept -- --reviewed`). Локальный прогон дал бы только ожидаемый «missing baseline» без новой информации. - **`python -m pytest tests_backend`.** Ни один файл `custom_components/**/*.py` не тронут этим диффом. - **Performance-профили.** Не названы в AC; диф ограничен одним `if`-блоком на переход, асимптотика не меняется — то же заключение, что и в r1, диф не изменился. - **Полный набор из 127+ browser-smoke.** Задача — точечное изменение одной геометрической функции; прогнаны названный в AC смок плюс четыре смежных (corner-split, общая толщина стен, T/L-стыки, и — дополнительно к списку r1 — smoke #150, слитый той же общей функцией при ребейзе). Остальные смоки не используют `insetContour`/`outsetContour` в зоне, задетой этим диффом. ## Проверка AC1–AC11 Продуктовый код и тесты идентичны r1; переисполнил или перепроверил каждую строку самостоятельно, ссылки на r1 — только там, где вывод не может измениться при неизменном диффе. | AC | Метод по ТЗ | Статус | Как закрыт | |---|---|---|---| | AC1 | unit | ✅ | `variable-offset contours keep a local cap…` — прогнан лично, подтверждён красным без фикса | | AC2 | unit | ✅ | `near-collinear zero-depth Split divider never grows a masonry taper` — матрица `outerCm ∈ {1,15,100}`, `deltaY ∈ {-5,-2.5,2.5,5}`, permutation room order/winding; прогнан лично, подтверждён красным без фикса | | AC3 | unit | ✅ | Полный регресс 833/833 не покраснел; читал код (`src/wall-thickness.ts:810-817` до `collinearJoint`) — при точном коллинеарном стыке новая ветка вычисляет ту же точку, что и старая (`nA===nB`), логический регресс исключён; `smoke_split_corner_wall.mjs` зелёный | | AC4 | unit | ✅ (см. Low-1 ниже, унаследована из r1) | Отдельного нового теста на точную AC1-fixture нет и не появилось при ребейзе (диф теста не изменился). Я предпринял независимую попытку пересчитать инвариант собственным скриптом (`innerContourForRoom` по каждой комнате в отдельности) и получил числа, не сопоставимые напрямую с методологией r1 (моя примитивная сумма per-room floor не воспроизводит точно то же сечение, что r1 мерил полосой вдоль разделителя) — не нашёл основания усомниться в выводе r1, но и не воспроизвёл его число независимо. См. «Чего не проверял» | | AC5 | unit | ✅ (чтением) | `splitRoomPath()` не тронута диффом; тест «rendering does not materialize or mutate saved geometry» + smoke `anglePreserved`/`renderDoesNotRewriteConfig` | | AC6 | smoke | ✅ | `node demo/smoke_zero_divider_taper.mjs`, лично прогнан, `dividerStaysZero`/`planHasNoTaper` true | | AC7 | smoke | ✅ | Тот же smoke: `planUsesCanonicalBody`, `planViewParity`, `kioskParity`, `isoUsesCanonicalBody`, `staticParity`, `lightHasNoTaper`, `renderDoesNotRewriteConfig` — все true | | AC8 | golden | ✅ (отложено по контракту) | Сцена в матрице v25, `test/golden-matrix.test.mjs` проверяет состав; baseline отсутствует — проверено напрямую по `demo/golden/baselines/` | | AC9 | unit+smoke | ✅ | 833/833 + четыре смежных/зависимых smoke зелёные (включая #150) | | AC10 | код-ревью | ✅ | Диф ограничен общей variable-offset геометрией `wall-thickness.ts`, ни одного renderer-specific ветвления | | AC11 | код-ревью | ✅ | Новых DOM-узлов/событий/таймеров/сетевых вызовов/HA-сервисов нет | ## Находки Новых находок в этом цикле нет — диф не изменился по существу с r1, только SHA после ребейза. Обе находки Low из r1 остаются в силе с тем же решением («снимается без правки»); переношу их сюда без повторной эскалации, чтобы не плодить фиктивный «новый» цикл вокруг уже закрытого вопроса. ### Low-1 (унаследована из r1) — AC4 не имеет отдельного исполняемого теста на fixture из АК1 Не изменилось с r1: отдельного unit-теста на clean-floor invariant именно для near-collinear нулевого разделителя по-прежнему нет. r1 закрыл разрыв прямым исполнением `innerContourForRoom` + `wallBodiesGeometry` и получил расхождение ≈0,011%, идентичное точному `0°` (то есть ранее существующий квантование-артефакт, а не то, что фикс должен был закрыть). Моя собственная попытка независимо пересчитать тот же инвариант (см. AC4 выше и «Чего не проверял») использовала другую, более грубую методологию и не дала сопоставимого числа — это ограничение моей проверки, а не найденное расхождение с выводом r1. Диф, на котором сделан вывод r1, не изменился. **Вердикт:** остаётся снятой без правки, как в r1. Не переоткрываю как новую находку — методологическое расхождение в моей повторной проверке не опровергает измерение r1 и не является само по себе дефектом кода. ### Low-2 (унаследована из r1) — неточная ссылка на процесс в хендоффе первого цикла Касалась исходного implementation-хендоффа (цитата §11.4 не по адресу для пропуска named-smoke). Автор сам прогнал smoke перед вторым хендоффом («Повторный хендофф после ребейза» явно перечисляет `node demo/smoke_zero_divider_taper.mjs → pass, все 13 проверок true`), так что для r2 вопрос уже неактуален практически, а не только формально. **Вердикт:** снимается окончательно, без дальнейших действий. ## Что проверено и корректно - Ребейз не изменил продуктовую логику: `git diff origin/dev...HEAD -- src/wall-thickness.ts` даёт тот же 25-строчный диф, что описан в r1, только с другим базовым SHA. - Правка сосуществует с #150 без конфликта поведения: обе используют одну и ту же общую функцию `insetContour`/`outsetContour`, `smoke_wall_thickness_transition.mjs` (#150) зелёный на дереве, содержащем обе правки. - Дисциплина «тест умеет падать» подтверждена мной лично на пересобранном дереве (не переиспользовано заявление r1): 2 unit-теста и named-smoke красные без фикса, зелёные с фиксом. - Три копии бандла побайтово идентичны друг другу и рабочему дереву (`git status --short` пуст после пересборки). - Трейлеры, оба changelog, `docs/WALL-THICKNESS.md`, `docs/specs/README.md` — в одном продуктовом коммите `c2112db` (`git show --stat`). - `process-gate.mjs` проходит на всём диапазоне `origin/dev..HEAD` (4 коммита, 0 предупреждений). - Golden-сцена добавлена в матрицу без преждевременного baseline — проверено прямым просмотром `demo/golden/baselines/`, а не только чтением ТЗ. - Симметрия inset/outset, ограничение локального cap физической half-depth, независимость от порядка комнат/winding — те же гарантии, что в r1, диф не изменился, регресс логически исключён (см. AC3 выше). ## Чего не проверял - Визуальный итог новой golden-сцены — baseline не существует по контракту до предрелиза. - Backend/HA harness — не затронут. - Полный набор из 127+ browser-smoke и `performance_smoke` — не относятся к этому точечному изменению; обязательны на предрелизном гейте. - Мобильный/touch путь Split — ТЗ фиксирует независимость сохранённой геометрии от типа указателя, инструмент desktop-first и не менялся этим диффом. - Независимое числовое воспроизведение AC4 (clean-floor invariant на точной AC1-fixture) — моя попытка пересчитать инвариант собственным скриптом использовала иную методологию, чем r1 (суммирование `innerContourForRoom` по комнате вместо измерения полосы вдоль разделителя), не дала сопоставимого числа и была отброшена как неубедительная, а не доведена до совпадения с результатом r1. Полагаюсь на измерение r1 (Low-1), поскольку диф, на котором оно сделано, не изменился. - Правильность конкретной оценки владельца (8/10 · 6/10 · P2) и легитимность полного трека по существу — уже подтверждены `SPEC-REVIEW-172-r1.md`, не предмет код-ревью.