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

CODE-REVIEW-583-r2

Issue: #583 · Материал: 85a5c7387e4305cb6e26dabb4560b10bed373f9e (заход r2, полный трек) Ветка: issue/583-isometric-visual-corrections Раунд не первый → разбор ведётся по дельте (PROCESS §2.9, #214).

Вердикт предыдущего раунда и его SHA

Вердикт r1: жёлтый, High: 0 · Medium: 1 → в задаче, документ docs/reviews/CODE-REVIEW-583-r1.md. В самом тексте вердикта SHA не назван (нарушение формата — фиксирую как наблюдение, не как отдельную находку, поскольку не блокирует и не влияет на объём этого раунда). SHA восстановлен из раздела «Материал раунда» этого же документа и из истории комментариев issue: e2801e4e8b1b7a38be88a6dea210caba0e756783 (коммит «test: align isometric smoke with physical host faces (#583)», подтверждён зелёным push-Validate run 35063947392, объявленным автором сразу после этого коммита).

Дельта r1 → r2

git diff e2801e4e..85a5c738 --stat

Только пять содержательных путей плюс синхронный пересобранный бандл и уже запушенный r1-документ:

• demo/golden/harness.mjs (+3/−1)
• demo/golden/matrix.mjs (offset center → selected-face для 3 iso door/gate записей)
• demo/golden/run.mjs (+15/−4, assertOpeningSymbolContract)
• test/golden-matrix.test.mjs (+4/−2)
• docs/reviews/CODE-REVIEW-583-r1.md (добавлен предыдущим раундом, не автором задачи)
• dist/**, custom_components/.../frontend/**, demo/srv/assets/** — пересборка бандла (см. «Как проверялось»)

src/** дельтой не затронут ни одной строкой (проверено: git diff e2801e4e..85a5c738 --stat -- src/ — пусто). Это чисто test-harness правка, устраняющая ровно ту находку, которую вернул r1. Рамка ТЗ, продуктовый контракт (§6 issue), скоуп/не-скоуп — не меняются. Разбор сокращён до дельты: делта локальна, не является ребейзом на ушедший вперёд dev, не меняет поведенческий контракт и не задевает новую подсистему.

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

Находка r1	Чем закрыта	Где видно
Medium: demo/golden/run.mjs/matrix.mjs (openingIsoContract) не обновлены под host-face pivot door/gate; isometric-opening-symbol-parity-dark падает исключением semantic golden Iso centre failed for golden-iso-door: 12.5, харнесс не может даже переснять сцену	matrix.mjs: offset у golden-iso-door/golden-iso-gate-default/golden-iso-gate-flipped заменён center → selected-face. harness.mjs: prepareGoldenFixture теперь требует expectedOffset = 'selected-face' для iso non-window вместо жёсткого 'center'. run.mjs: assertOpeningSymbolContract считает faceOffset — максимальное расстояние leaf.hinge до face.selectedStart/selectedEnd (leaf 0 → start, leaf 1 → end) — и для offset:'selected-face' требует faceOffset ≤ epsilon и type !== 'window'; для offset:'center' требует type === 'window'. test/golden-matrix.test.mjs синхронизирован с тем же вычислением expectedOffset и больше не требует gate.offset === 'center' жёстко	Лично прогнал node --test test/golden-matrix.test.mjs — 50/50 passed. Лично прогнал полный npm run golden:verify на 85a5c738: 160 passed, 12 different, 0 error — isometric-opening-symbol-parity-dark теперь в списке different (обычный ожидающий пересъёмки пиксель), не error. Сумма аномалий (12) равна сумме r1 (11 different + 1 error = 12) — исключение подтверждено закрытым, ни одна другая сцена не сдвинулась

Дисциплина «тест должен уметь падать» соблюдена в обе стороны: до фикса именно этот прогон (error на isometric-opening-symbol-parity-dark) — задокументированная находка r1 и подтверждён исторически (комментарий автора и документ r1); после фикса тот же прогон лично воспроизведён мной и даёт different, не error.

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

Всё, что не задето дельтой, принято без повторной проверки — docs/reviews/CODE-REVIEW-583-r1.md на SHA e2801e4e8b1b7a38be88a6dea210caba0e756783:

• AC1 (тени). iso-contact-shadow/iso-leaf-shadow удалены, осталась одна iso-ambient-shadow; Glow/SUN не тронуты. Подтверждено r1 чтением iso-scene-render.ts/plan.styles.ts + isometric-contract.test.mjs + browser-смок.
• AC2/AC3 (дверь «вросла» в стену). leafBasis() для door/gate использует input.face вместо openingSymbolOffset; buildIsoWallDepthQueue() сортирует слои любого opening (не только window) по cameraDepth. Подтверждено r1 алгебраически + новыми unit-тестами на матрице angle×side×flipH.
• AC2 §6.2 п.5 (контур). stroke: none у .iso-opening-panel.iso-material-matte-leaf во всех темах, окна не тронуты. Подтверждено r1 чтением стилей + тестом + смоком.
• AC4-11 (взаимные коллизии). resolveIsoOverlayCollisions(): единый бюджет 48 CSS px от raisedScene (не аддитивный), приоритет по меньшему требуемому отклонению со стабильным tie-break kind/id, room labels исключены из pass, room/wall safety переиспользует существующие примитивы, плотная неразрешимая группа помечается degraded без скрытия/уменьшения, кэш по collisionSignature, fit-режим пропускает live-поиск, ограниченная решётка кандидатов вместо O(n²). Подтверждено r1 построчным чтением + permutation/order-independence unit-тестами.
• Документация. docs/ISOMETRIC.md, docs/ARCHITECTURE.md, docs/STATUS.md — обновлены консистентно с кодом (подтверждено r1 построчно).
• Trailers/release-артефакты. Issue: #583/User-Visible: no на обоих коммитах реализации; CHANGELOG.md/docs/CHANGELOG.ru.md не менялись — верно для скрытого экспериментального режима (§14 ТЗ). Подтверждено r1.
• Бандл/сборка. 3 копии (dist, custom_components/.../frontend, demo/srv/assets) синхронны, bundle:budget в лимите. Подтверждено r1 на e2801e4e; в этом раунде бандл был пересобран заново (см. ниже) и остаётся синхронным.

Ни один унаследованный пункт дельтой r1→r2 не затронут (дельта не касается src/iso-*.ts, стилей, iso-overlays.ts), поэтому переисполнение их доказательств не требуется.

Как проверялось (только дельта r2)

Дешёвые гейты на 85a5c738 уже зелёные (Validate run 35064206893, указан в задаче) — tsc/npm test/npm run build не перегонял ради самого факта зелёности. Но:

• node --test test/golden-matrix.test.mjs — лично прогнал: 50/50 passed. Тест напрямую покрывает изменённый файл.
• npm run build + npm run bundle:sync — лично прогнал: собрался, git status после пересборки чист — три копии бандла (dist, custom_components/houseplan/frontend, demo/srv/assets) на 85a5c738 побайтово совпадают с уже закоммиченными. Это подтверждает, что бандл в этом SHA — не устаревший артефакт, хотя дельта r1→r2 не трогает src/** (хеши чанков в дифф сместились из-за цепочки content-hash в манифесте Rollup — проверил, что это не функциональное изменение: пересборка с текущего HEAD воспроизводит те же файлы, что уже лежат в дереве).
• node scripts/no-new-any.mjs --base e2801e4e --head 85a5c738 — «Проверено добавленных строк в src/**/*.ts: 0 в 0 файл(ах). Новых any нет.» — ожидаемо, дельта не трогает src/**.
• npm run golden:verify (полный набор, 172 сцены) — лично прогнал целиком, т.к. это прямое доказательство закрытия Medium-находки r1 (не просто пересчитанный dev-репорт автора, а мой собственный прогон): 160 passed, 12 different, 0 error. Это и есть демонстрация «тест умеет падать»: на SHA r1 (e2801e4e) та же сцена бросала исключение (см. таблицу закрытия выше), на 85a5c738 — нет.
• node scripts/smoke-select.mjs --base e2801e4e --head 85a5c738 — «Исполняемого frontend-диффа нет (src/**/*.ts не тронут). Browser-smoke этим диффом не выбираются — выбирать нечего.» Не прогонял ни одного browser-smoke в этом раунде: дельта не меняет собранную карточку (подтверждено байт-в-байт совпадением бандла выше), а все browser-smoke проверяют именно её.
• node scripts/check-docs.mjs — не гонял: дельта не трогает src/**, условие «любая правка фронтенда обнуляет отпечаток» неприменимо; сам отпечаток уже был корректно учтён (или не менялся) в r1 на e2801e4e, а дельта r1→r2 фронтенд не трогает.
• Инварианты модели (npm run invariants) — не гонял: дельта не трогает layout, room edges, marker.space, open_spans или любую другую каноническую геометрию — только golden test-harness.
• python -m pytest tests_backend — не гонял, Python не тронут.
• Performance — не гонял: дельта не меняет ни один runtime-путь (src/** пуст в диффе), только офлайн test-харнесс.

Разбор дельты

Три файла плюс синхронизированный unit-тест, все три правки — одно и то же изменение семантики golden-контракта, применённое консистентно:

1. demo/golden/matrix.mjs — конфигурация трёх iso door/gate записей получила offset: 'selected-face' вместо 'center', отражая реальное поведение leafBasis() (уже подтверждённое r1: offset = input.face для door/gate). Окно (golden-iso-window) осталось 'center' — верно, leafBasis() для window по-прежнему использует openingSymbolOffset.
2. demo/golden/harness.mjs — prepareGoldenFixture считает expectedOffset по тому же правилу (iso + не-window → selected-face, иначе center) и требует точного совпадения вместо старого жёсткого 'center'. Это гарантирует, что сам fixture не может быть настроен рассогласованно с рантайм-поведением.
3. demo/golden/run.mjs, assertOpeningSymbolContract — добавлена faceOffset (расстояние leaf.hinge до face.selectedStart/selectedEnd по индексу leaf) и ветвление по item.offset. Проверил алгебраически по src/iso-openings.ts:238-247,276-328: для door leaves=[leafBasis(input,0, [-half,0],...)], для gate leaves=[leafBasis(...,0,[-half,0],...), leafBasis(...,1,[half,0],...)]; при offset=input.face хиндж leaf 0 алгебраически равен start + face.offset = face.selectedStart, хиндж leaf 1 (только у gate) — end + face.offset = face.selectedEnd. Это ровно то сопоставление, которое реализует run.mjs (leaf.leaf===0 ? selectedStart : selectedEnd). Контракт не ослаблен: старая ветка center получила дополнительное требование type==='window', которого раньше не было (раньше любой тип с offset:'center' проходил проверку одного и того же условия) — то есть строгость контракта выросла, а не упала.
4. test/golden-matrix.test.mjs — синхронизирован с тем же вычислением expectedOffset; удалено устаревшее жёсткое требование gate.offset === 'center', которое стало бы ложным срабатыванием против уже исправленной матрицы.

Побочно: старое допустимое значение offset: 'edge' (в ['center','edge'].includes(...) до правки) выпало из проверки — в matrix.mjs оно нигде не используется (проверено grep), так что это не регрессия, а удаление мёртвой опции без потребителей.

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

• Единственная Medium-находка r1 закрыта и доказана личным прогоном, а не словами автора: golden:verify больше не даёт error, суммарное число аномалий (12) не изменилось — не появилось новых расхождений и не потерялось старое доказательство.
• Дельта не трогает src/**, поэтому не может внести регрессию в унаследованные из r1 AC1-AC11; унаследованные доказательства остаются в силе без переисполнения.
• Trailers коммита 85a5c738 (Issue: #583, User-Visible: no) корректны для test-only правки; changelog не требуется и не менялся.
• Бандл синхронен на 85a5c738 (пересобрал и сверил лично).

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

• Полный browser-smoke набор и три целевых смока r1 — дельта не трогает src/**/собранную карточку, smoke-select.mjs явно подтвердил «выбирать нечего».
• Калиброванный performance_smoke/Full Performance — не запускается на обычном пуше, дельта не трогает runtime-пути; остаётся предрелizным долгом как и было зафиксировано r1 для AC11/AC13.
• Пересъёмка/приёмка 12 ожидающих different-сцен — сознательно отложена на предрелизный этап (PROCESS §8), теперь харнесс способен их переснять без исключения (что и было условием находки r1).
• pytest tests_backend, npm run invariants — соответствующие поверхности не тронуты ни исходной задачей, ни этой дельтой.

Вердикт

Единственная Medium-находка r1 закрыта точечно, ровно в заявленном месте, доказана собственным прогоном (не заявлением автора), не создала новых находок и не расширила/сузила скоуп задачи. Delta не трогает src/**, поэтому ни один унаследованный AC не поставлен под риск. High — нет, Medium — нет.

Вердикт: зелёный.

---

Материал раунда

• Ветка: issue/583-isometric-visual-corrections, коммит 85a5c7387e43 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: d59c9dd6510437f40978b9ddb6a386bc33226aaa

  git log --all --format='%H %T' | grep d59c9dd65104
  

• Тело issue: 5c6f59d62afacaf36715df788207cc8b3df775aab0991091d0d0ae322f9ac844
• Вердикт конвейера: green · High 0