diff --git a/docs/reviews/CODE-REVIEW-583-r2.md b/docs/reviews/CODE-REVIEW-583-r2.md new file mode 100644 index 00000000..c6d8cd0d --- /dev/null +++ b/docs/reviews/CODE-REVIEW-583-r2.md @@ -0,0 +1,227 @@ +# 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