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

CODE-REVIEW-289-r2

• Issue: #289 «Ресайз комнаты с общими стенами портит их толщину»
• Этап: код-ревью (PROCESS.md §2.7)
• Заход: r2 · блокирующих циклов израсходовано 1 из 4 (r1 — красный, потратил цикл)
• Диапазон: git log --oneline origin/dev..HEAD / git diff origin/dev...HEAD
• Ветка: issue/289-no-mixed-role-resize
• HEAD: a7618151ccf00603561ee5f7ff471add918ea151
• Коммиты в диапазоне (8):
  • 6a4e665d — ТЗ (первая редакция)
  • 8877e8c6 — SPEC-REVIEW-289-r1 (жёлтый)
  • 0bca6dfb — правки ТЗ по r1
  • 2ad20dca — SPEC-REVIEW-289-r2 (зелёный)
  • bca3bfd5 fix: prevent mixed-role walls during resize — реализация, Issue: #289, User-Visible: yes
  • 849b3e5f — CODE-REVIEW-289-r1 (красный, High: 1 · Medium: 1)
  • 10ca913f test: keep resize smokes self-contained — Issue: #289, User-Visible: no
  • a7618151 test: accept safe resize baselines — Issue: #289, User-Visible: no, Release: v1.67.0-beta.10, Baseline-Reviewed: …/actions/runs/32726613816

Почему разбор ПОЛНЫЙ, а не по дельте

Проверил родителя первого коммита ветки:

git rev-parse 6a4e665d^  → 5272287671bd176ca07aec0edaf3c3413d41985e
git rev-parse origin/dev → 5272287671bd176ca07aec0edaf3c3413d41985e   (тот же коммит,
                                                                        "test: accept fixture wall key baselines")

Вся ветка #289, включая самый первый (спековый) коммит, стоит на новом dev, который уже включает отдельно смёрженный #260 (c14dcecb + baseline-accept). SHA 5142fc8b/4d1285a9/9031ba0d, названные в CODE-REVIEW-289-r1, в текущем репозитории не существуют — история переписана. Это ребейз на ушедший вперёд dev (PROCESS.md §2.10, §7.2 AGENTS.md): «после ребейза это другой код». Провёл полный разбор AC1–AC9 заново, а не только проверку двух находок r1.

Технический контракт ТЗ (§2–§4, AC1–AC9) при этом не пересматриваю — он не изменился со SPEC-REVIEW-289-r2 (зелёный, docs/reviews/SPEC-REVIEW-289-r2.md, SHA e02c282d/2ad20dca): наследую его без повторной защиты контракта самого по себе, но заново проверяю, что реализация ему соответствует.

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

Находка r1	Чем закрыта	Где видно
H1 (High) — код #260 (wall-key.mjs, fixture-wall-key.test.mjs, правки large-house.mjs/visual-matrix.mjs/model-invariants.test.mjs) продублирован прямо в коммит реализации, вопреки ТЗ §11 и телу issue	Ветка переписана: git show bca3bfd5 --stat — коммит реализации содержит только файлы #289 (15 файлов: resize.ts, resize.test.mjs, i18n, docs, changelog, smoke_room_resize.mjs, mutation-gate.mjs, бандл). #260 смёрджен в dev отдельно (c14dcecb) и ветка перебазирована на него — git ls-tree origin/dev -- demo/fixtures/wall-key.mjs и git ls-tree HEAD -- demo/fixtures/wall-key.mjs дают идентичный blob-hash 1693fadb…, то есть #289 больше не несёт этот код, а наследует его от dev	git show bca3bfd5 --stat; git ls-tree origin/dev|HEAD -- demo/fixtures/wall-key.mjs
H1, вторая часть — golden isometric-geometry-view-{dark,light} ломались диффом, не относящимся к #289	Прогнал полный npm run golden:verify на текущем HEAD — обе сцены isometric-geometry-view-dark/light зелёные (passed), как и весь остальной матрикс (0 different из полного набора)	npm run golden:verify, локальный прогон в этом ревью (лог приложен ниже)
M1 (Medium, в скоупе) — golden safe-resize-handles-clamp-{dark,light} не пересобран/не принят через golden:accept --reviewed на артефакте канонического Linux CI	Коммит a7618151 несёт Release: v1.67.0-beta.10 и Baseline-Reviewed: https://github.com/Matysh/houseplan-card/actions/runs/32726613816. Проверил сам этот прогон через gh run view 32726613816 --json jobs: реальный CI-запуск на точном SHA 849b3e5f761f42688291cf97b332cefb75cfa189 (это коммит из текущей истории ветки), job golden действительно отработал и напечатал ровно одну «живую» разницу (different safe-resize-handles-clamp-dark; -light уже был passed, но принят вместе — ровно то, что рекомендовал r1, т.к. на пороге). Diff коммита a7618151 меняет только baselines-index.json, screenshots.json и два PNG safe-resize-handles-clamp-{dark,light} — никакого «принятия ради зелёного CI» посторонних сцен	gh run view 32726613816 --repo Matysh/houseplan-card --json jobs; git show a7618151 --stat; git show a7618151 -s --format=%B

Обе находки закрыты по существу, а не декларативно — H1 подтверждён составом дерева коммита и идентичностью blob-хэшей с dev, M1 подтверждён обращением к реальному прогону CI по указанному URL, а не доверием к тексту коммита.

Как проверялось (гейты)

Гейт	Команда	Результат
typecheck	npx tsc --noEmit	зелёный, без вывода
unit	npm test	1223 passed, 1 skipped, 0 failed
build + сверка бандлов	npm run build; git status --short после — пусто; diff dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js — идентичны; npm run bundle:sync синхронизировал demo/srv/assets (не коммитится, #255)	зелёный, три копии синхронны
docs fingerprint	node scripts/check-docs.mjs	«Documentation checks passed (7 files, 10 external links)»
process-gate (офлайн)	node scripts/process-gate.mjs	«гейт пройден, предупреждений 0» на диапазоне из 8 коммитов
commit provenance	node scripts/validate-commit-provenance.mjs origin/dev..HEAD	зелёный, без вывода
целевой мутант (AC8)	node scripts/mutation-gate.mjs --id=safe-resize-side-ownership-bypassed	«поймано 1 из 1» — тест умеет падать
полный набор мутантов	node scripts/mutation-gate.mjs (фон)	все frontend/#289-мутанты зелёные; единственный FAIL — storage_helpers_are_the_final_canonical_barrier (tests_backend), падает из-за отсутствия pytest в окружении (No module named pytest), не связан с диффом (#289 не трогает custom_components/**/*.py) — известное ограничение окружения (AGENTS.md)
выборка смоков	node scripts/smoke-select.mjs --base origin/dev --head HEAD	прямое совпадение: demo/smoke_sun_soft.mjs (символ axisOf, не изменён по существу); зарегистрированная связь: demo/smoke_room_resize.mjs
demo/smoke_room_resize.mjs (зарегистрированная связь + AC7)	прогнан	OK, {"done":true}, exit 0, ни одной строки FAILED
demo/smoke_sun_soft.mjs (прямое совпадение)	прогнан	все проверки true, OK
demo/smoke_pan_any_zoom.mjs (задет коммитом 10ca913f, self-contained fix)	прогнан	все проверки true, включая resizeHandlePresent: true — новый селектор [aria-disabled="false"] исправно находит включённую ручку
performance	node demo/benchmark_safe_resize.mjs	pass: true; pointer p95 ≈0.017 мс, commit-preflight p95 ≈0.002 мс — далеко внутри бюджетов 16 мс / 75 мс
model invariants на реальных планах (AC5)	часть npm test (test/model-invariants.test.mjs, real-plan-first-floor.json/real-plan-second-floor.json)	зелёный, включает checkMixedRoleRecords/checkWallRecordsPreserved/checkWallKeys
golden (полная матрица — обязательна, т.к. диф меняет видимую доступность ручки resize, и это дополнительно нужно после ребейза)	npm run golden:verify (фон, полный набор)	exit 0, 0 different, включая safe-resize-handles-clamp-{dark,light} и isometric-geometry-view-{dark,light}

Не прогонял:

• python -m pytest tests_backend — diff не трогает custom_components/**/*.py (только синхронизированный бандл); в этом окружении нет .venv-backend, локальный pytest вообще недоступен (см. FAIL в мутациях выше) — не относится к скоупу #289;
• npm run benchmark:safe-resize-render — не назван в AC, диф не меняет render-путь предпросмотра сверх уже измеренного benchmark_safe_resize (buildSideOwnership вызывается только в resolveSafeResize, не в hot path pointermove — проверено чтением);
• полный demo/smoke_*.mjs (181 файл по smoke-select) — выборка smoke-select.mjs вернула ровно два релевантных файла, оба прогнаны; остальные 179 не тронуты диффом ни по символам, ни по слабой связи.

Проверено и корректно (полный разбор AC1–AC9, не унаследовано)

• AC1 (exact repro запрещён до жеста): resolveSafeResize() на test/fixtures/289-mixed-role-resize.json — {enabled:false, reason:'partial-shared'} в обоих направлениях (unit test/resize.test.mjs:311). Прочитал сам алгоритм (buildSideOwnership/sideOwnershipPreserved, src/resize.ts:711-819): ownership profile строится по side-рёбрам через ownershipIntervalsOnLine/ownershipRuns на атомарных пересечениях, роль (outer/shared(A,B)) выводится из geometry, не из thickness record — соответствует §4.1 ТЗ. Мутант safe-resize-side-ownership-bypassed красит именно тест #289 side ownership — подтверждено прогоном.
• AC2 (причина доступна человеку): resize.disabled.partial-shared — RU «Нельзя сдвинуть только часть общей стены» / EN «Only part of a shared wall cannot be moved» — дословно совпадает с текстом ТЗ и issue (src/i18n/ru.json:90, en.json:90). aria-disabled, tabindex="0", _rszDisabledKey, cursor: not-allowed — существующая инфраструктура #277, не изменена (test/resize-production-path.test.mjs, зелёный в составе npm test); отдельный click/tap/toast смок для этой причины не расширялся — общий путь уже покрыт smoke_room_resize.mjs (проверено чтением, не отдельным прогоном по новому reason-тексту, но сам факт наличия disabled-состояния гесты проверен прогоном смока).
• AC3 (directed clamp не перепрыгивает роль): test/resize.test.mjs:341-350 — resolveSafeResize на fixture с безопасным исходящим направлением остаётся enabled:true, clampSafeResize(...,40,...) === 20 (останов ровно на границе владения), обратное направление -40 → -40 работает. Прочитал sideOwnershipPreserved (строки 785-816): пересечение breakpoints старого/нового профиля по oldRole/nextRole корректно разрешает рост в пустое пространство (!oldOwns && newOwns ветка) только если новая роль совпадает с terminalRole предыдущего конца пролёта.
• AC4 (позитивные сценарии #277 сохранены): та же fixture, resolveSafeResize([main], ..., {...SAFE, step:5}) даёт enabled:true — обычный наружный resize не заблокирован целиком. Полный npm test прогнал все существующие #277-тесты (non-shared, exact-shared, diagonal/side-angle, irregular corner, obstacles) без единого regress — 1223/1223 passed.
• AC5 (persisted model чиста): checkMixedRoleRecords, checkWallRecordsPreserved, checkWallKeys — зелёные на обеих реальных моделях проекта (test/model-invariants.test.mjs, «реальные планы проекта эту проверку» — прогнан отдельно, ok). Production-смок дополнительно проверяет checkMixedRoleRecords-эквивалент на живом _serverCfg (safe_resize.owner_boundary_no_mixed_role в smoke_room_resize.mjs).
• AC6 (preview/commit — один proof): прочитал _rszUp() (src/houseplan-card.ts:8616-8639) — commit вызывает validateSafeResize(g.rooms, g.openings, g.plan, g.d, g.opts) с тем же plan.sideOwnership, построенным один раз в resolveSafeResize (_rszResolution, src/houseplan-card.ts:8413-8434, кэшируется по снапшоту). При провале — resize.commit_failed тост, _cfgEpoch++, без partial write. Расхождение проверено существующим #277-тестом («lossy persistence rekey stops at the last complete preview»).
• AC7 (production-bundle smoke): demo/smoke_room_resize.mjs содержит явный 43-шаговый forbidden-жест (обе стороны) и разрешённый outer/range drag на реальном bundle — прогнан, OK, 0 FAILED.
• AC8 (мутант): safe-resize-side-ownership-bypassed убивается точечно паттерном --test-name-pattern="#289 side ownership"; патч мутации (if (false && !sideOwnershipPreserved(...))) отключает именно и только новую проверку — прочитано в scripts/mutation-gate.mjs, прогнано и подтверждено (поймано 1 из 1).
• AC9 (локальные гейты): typecheck/test/build/check-docs — зелёные (таблица выше); targeted mutation/smoke — зелёные; process-gate и provenance — зелёные.
• §7 Performance: buildSideOwnership вызывается только внутри resolveSafeResize, не в clampSafeResize/applySafeResize/pointermove — подтверждено чтением всего файла src/resize.ts. benchmark_safe_resize подтверждает бюджеты с большим запасом (p95 0.017 мс / 0.002 мс против 16 мс / 75 мс).
• Терминология: docs/USER-GUIDE.ru.md, docs/RESIZE.md используют каноническое «ручка» — L1 из ревью ТЗ в продуктовую документацию не просочился (проверено чтением диффа docs/USER-GUIDE.ru.md, docs/RESIZE.md).
• Changelog: docs/CHANGELOG.md/.ru.md правлены в коммите bca3bfd5 с User-Visible: yes — трейлер соответствует; текст описывает именно наблюдаемое поведение (стена «стопорится» на границе роли), не термины реализации.
• Один источник числа: фича не вводит новое отображаемое значение — только disabled/enabled-состояние ручки и текст причины; раздел неприменим. test/single-source-numbers.test.mjs зелёный отдельно (в составе полного прогона мутаций и npm test).
• Откат (§9 ТЗ): чистый revert bca3bfd5 возвращает прежнюю eligibility; ни миграция, ни feature-флаг не требуются — persisted schema/model не меняются (проверено чтением: diff не содержит правок версии схемы или compatibility-полей).
• Отсутствие leftover #260: git diff origin/dev...HEAD --stat содержит только файлы, относящиеся к #289 (24 файла: код, тесты, документация, оба changelog, бандл, golden-приёмка) — ничего постороннего.

Находки

Нет. High: 0. Medium: 0. Low: 0.

Обе находки r1 (H1 High, M1 Medium-в-скоупе) закрыты предметно и проверены не на слово автора, а обращением к самим артефактам (состав дерева коммита, идентичность blob-хэшей с dev, независимый прогон golden:verify, прямой запрос к GitHub Actions по указанному run-id). Дополнительный полный разбор AC1–AC9, обязательный из-за ребейза на ушедший вперёд dev, не вскрыл новых расхождений с контрактом ТЗ (docs/specs/289-no-mixed-role-resize.md, зелёное SPEC-REVIEW-289-r2).

Унаследовано из r1 (код-ревью) / из ревью ТЗ

• Технический контракт §2–§4 и формулировки AC1–AC9 самого ТЗ — не пересматриваю по существу: docs/reviews/SPEC-REVIEW-289-r2.md, зелёный вердикт, SHA e02c282d/2ad20dca. Спека не менялась в этом коде-раунде (git diff 2ad20dca..HEAD -- docs/specs/289-no-mixed-role-resize.md — пусто).
• Формулировка disabled-текста и терминология «ручка» vs «рукоятка» (L1 ревью ТЗ) — снята ревьюером ТЗ на r2 с запиской, не переоткрываю: в продуктовых текстах используется каноническая «ручка» (проверено выше отдельно, не только по наследству).
• Технические находки CODE-REVIEW-289-r1 не наследуются молча — обе (H1, Medium M1) перепроверены заново по артефактам, а не приняты на слово (см. «Закрытие раунда r1» выше). Остальная («Проверено и корректно») часть r1-документа не наследуется вовсе: ребейз на ушедший вперёд dev требует полного разбора (см. раздел выше), и весь он проведён заново в этом документе, а не скопирован.

Вывод

Все AC1–AC9 доказаны автотестом с проверенной способностью падать (мутант, unit, production-смок) либо разобраны чтением кода с explicit пометкой «проверено чтением» там, где отдельного смока нет. Обе находки предыдущего красного захода закрыты предметно. Полный golden:verify, полный npm test, targeted smoke/mutation, process-gate и provenance — зелёные. Готово к слиянию.