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 — нет.

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

---

<!-- material-anchors: сгенерировано конвейером (#414) -->

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

- Ветка: `issue/583-isometric-visual-corrections`, коммит `85a5c7387e43` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `d59c9dd6510437f40978b9ddb6a386bc33226aaa`
  ```
  git log --all --format='%H %T' | grep d59c9dd65104
  ```
- Тело issue: `5c6f59d62afacaf36715df788207cc8b3df775aab0991091d0d0ae322f9ac844`
- Вердикт конвейера: `green` · High 0