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

CODE-REVIEW-290-r2

• Issue: https://github.com/Matysh/houseplan-card/issues/290
• Ветка: issue/290-near-axis-authoring-repair
• Диапазон: origin/dev (f472af88) → HEAD (db77470d)
• ТЗ: docs/specs/290-near-axis-authoring-and-repair.md, ревью ТЗ зелёное на r2 (docs/reviews/SPEC-REVIEW-290-r2.md)
• Заход: r2 (код-ревью), блокирующих циклов 1/4
• Вердикт: зелёный · High: 0 · Medium: 0

0. Примечание о трассируемости r1 (методология, не находка против автора)

Документ docs/reviews/CODE-REVIEW-290-r1.md называет диапазон origin/dev (523190d8) → HEAD (5aae905a). Ни один из этих двух SHA не резолвится в текущей истории: 523190d8 — реальный коммит, но он на 10 коммитов позади текущего origin/dev (f472af88); 5aae905a не существует вовсе. Также сам вердикт-комментарий в issue не называет SHA явно (только документ). Причина, установленная сравнением git diff 523190d8..f472af88: между r1 и этим заходом issue #289 (независимая задача, тоже трогающая src/resize.ts) была домержена в dev, и ветка #290 была перебазирована на новый dev — отсюда новые SHA всех коммитов (коммиттер-даты всех коммитов диапазона сгруппированы в окне 15:51–16:01, тогда как авторские даты разбросаны по всему дню — прямой след rebase).

Это ровно случай «ребейз на ушедший вперёд dev — после ребейза это другой код» (PROCESS.md §7.2). Поэтому раздел src/resize.ts разобран заново полностью, а не по дельте между коммитами: я лично воспроизвёл поведение дефекта H1 r1 на старом resize.ts (восстановленном из 43264eda) и на новом и убедился, что вывод не зависит от того, какой SHA был назван в r1 — код, который дошёл до меня, доказан напрямую (§3.1). #289 не тронул src/near-axis.ts, src/houseplan-card.ts, src/plan-optimizer.ts, src/wall-thickness.ts (проверено: git diff 523190d8..f472af88 --stat) — для них дельта-разбор корректен, см. «Унаследовано из r1».

1. Скоуп диффа этого раунда

Между состоянием, которое содержательно проверял r1 (коммит 43264eda, последний коммит с полным фиче-контентом до раунда) и текущим HEAD, вне docs/reviews/**, изменилось:

custom_components/houseplan/frontend/houseplan-card.js | 299 +++++++++----------
dist/houseplan-card.js                                  | 299 +++++++++----------
docs/images/09-device-info.png                          | Bin 146160 -> 146170 bytes
docs/images/screenshots.json                            |  24 ++++++++++------
scripts/model-invariants.mjs                            |   7 +-
scripts/mutation-gate.mjs                                |  36 +++
src/resize.ts                                            |   9 +-
test/model-invariants.test.mjs                           |   4 +
test/near-axis.test.mjs                                  |  28 ++
test/resize.test.mjs                                     |  24 ++

Это в точности три находки r1 (High H1, Medium M1, Medium M2) плюс пересборка dist/frontend-копии (класс D, следствие правки resize.ts) и пересъёмка одного docs-скриншота (device-info, class C/D — фингерпринт источника изменился у всех 10 сцен, но imageSha256 реально сдвинулся только у этой одной; проверил — панель device-info не касается resize/near-axis, это шум капчура, check-docs.mjs принял). src/near-axis.ts, src/houseplan-card.ts, src/plan-optimizer.ts, src/wall-thickness.ts, все demo/i18n/docs-файлы фичи в этом раунде не менялись.

2. Как проверялось — гейты

Гейт	Команда	Результат
typecheck	npx tsc --noEmit	зелёный
unit	npm test	1232 passed, 1 skipped, 0 failed (было 1226/1/0 на r1 — прирост от новых тестов H1/M1/M2)
build + bundle parity	npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js	идентичны, git status чист после сборки
docs fingerprint	node scripts/check-docs.mjs (обязателен: диф трогает src/**)	«Documentation checks passed (7 files, 10 external links)»
invariants (обязателен: диф трогает geometry/resize)	npm run invariants -- --config test/fixtures/real-plan-second-floor.json --near-axis и --config test/fixtures/real-plan-first-floor.json --near-axis	буквальный CLI-вызов теперь работает без обёртки (закрывает вторичную придирку M2 из r1): real-second-floor: 1 / 0 почти-осевых стен; полный прогон без --near-axis — «Инварианты выполнены», exit 0 на обоих
mutation-gate (3 новых мутанта AC9)	node scripts/mutation-gate.mjs --id=near-axis-shared-owner-repair-partial / --id=near-axis-shared-owner-double-counted / --id=near-axis-optimize-confirmation-bypassed	все три: «тест покраснел, как обязан», «поймано 1 из 1»
mutation-gate реестр	node scripts/mutation-gate.mjs --check	без FAIL, все якоря патчей валидны (реестр не устарел)
smoke-выборка	node scripts/smoke-select.mjs --base origin/dev --head HEAD	см. §2.1
golden	не запускал	диф не добавляет/не меняет golden-сценарии; H1-фикс — это validation-логика (validateSafeResize), не рендер; ни один golden baseline на near-axis/resize-геометрии не завязан
performance	не запускал	AC не называет количественный бюджет для этой правки; фикс сужает существующую проверку (меньше работы на итерацию, не больше)
backend pytest	не запускал	диф не трогает custom_components/**/*.py

2.1 Смок-выборка

node scripts/smoke-select.mjs --base origin/dev --head HEAD (по всему диффу issue, не только по дельте раунда — дельта слишком мала для собственной осмысленной выборки):

• Прямое совпадение (3): smoke_decor_layer_order.mjs, smoke_room_resize.mjs, smoke_zero_divider_taper.mjs (roomPoly/ samePoint). Прогнал все три на текущем HEAD (после npm run bundle:sync, до этого демо не поднималось — не хватало demo/srv/assets/houseplan-card.js, ожидаемо, класс D не коммитится): зелёные, OK.
• Зарегистрированная связь (1): smoke_near_axis_optimize.mjs — прогнан как guard мутанта near-axis-optimize-confirmation-bypassed, зелёный.
• Слабая связь (19, общий символ _path): не прогонял в этом раунде. Дельта не трогает houseplan-card.ts/authoring-путь (уже проверено r1 на идентичном по содержанию коммите 43264eda, включая специально smoke_wall_junctions.mjs по прецеденту #234 — wall-thickness.ts в этом раунде не менялся). Наследую решение r1 не гонять остальные 17.

3. Находки

Новых находок нет.

3.1 Проверка закрытия High H1 (не декларативно — воспроизведением на обоих состояниях кода)

Файл: src/resize.ts:1012-1023

Старый код (был на момент r1, восстановлен из 43264eda для сравнения, временно, без коммита — git status чист до и после):

for (let index = 0; index < next.length; index++) {
  if (classifyNearAxisSegment(next[index], next[(index + 1) % next.length])) return false;
}

Новый код (615c0744):

const n = original.poly.length;
const prev = (edge - 1 + n) % n;
const involvedEdges = [prev, edge, (edge + 1) % n];
for (const index of involvedEdges) {
  if (classifyNearAxisSegment(next[index], next[(index + 1) % n])) return false;
}

Прогнал напрямую (не через demo, через test-build/resize.js) на фикстуре test/fixtures/279-near-orthogonal-junction.json (та самая геометрия, что в теле issue и в real-plan-second-floor.json):

Handle	Старый код	Новый код
north-west, edge 3 (осевое ребро, не смежное с near-axis edge 1)	invalid-geometry	partial-shared
south-west, edge 1 (осевое ребро, не смежное с near-axis edge 3)	invalid-geometry	enabled: true

Оба ребра под старым кодом валились с invalid-geometry — это и есть H1: near-axis проверка была не привязана к сдвигаемому ребру и валила весь полигон. Под новым кодом south-west,1 включается штатно — прямое доказательство, что over-broad проверка снята. north-west,3 теперь блокируется, но по другой, не связанной с #290 причине: resolveSafeResize после исходной near-axis-проверки (d=0) идёт дальше и пробует реальные шаги ±step; для этого ребра оба шага ломают sideOwnershipPreserved — это ветка resolveSafeResize (src/resize.ts:923-925), унаследованная от #289 («не превращать shared стену в outer»), и она не зависит от near-axis классификатора вообще. Убедился математически: сдвигаемые вершины — это ровно edge и edge+1; рёбра, инцидентные им — ровно {prev, edge, edge+1}; других рёбер, которые могли бы измениться от драга, не существует — значит involvedEdges полон и корректен, недостача исключена.

Тест test/resize.test.mjs:308+ (#290 a remote near-axis edge does not disable an unrelated exact resize handle, дважды правленный — 615c0744 → 6ded0f01 reconcile) фиксирует ровно эту таблицу: явно проверяет, что north-west,3 даёт partial-shared (с комментарием «#289 still blocks...», не «near-axis»), и что south-west,1 — реальный успешный кейс. Формулировка АС3 («Outer и exact-shared safe drags сохраняют moving/side edges exact-axis») совпадает с новым скоупом involvedEdges дословно — не шире и не уже.

Вывод: H1 закрыт по существу, не только тестом. git diff 615c0744..6ded0f01 («test: reconcile near-axis resize proof») — не заметание находки, а самокоррекция автора: первая версия теста в 615c0744 утверждала enabled: true для north-west,3, что было бы неверно (реально partial-shared); следующий коммит поймал это и добавил правильный негативный кейс вместо удаления проверки.

3.2 Проверка закрытия Medium M1 (mutation-gate)

scripts/mutation-gate.mjs теперь регистрирует все 6 категорий AC9. Три новых (near-axis-shared-owner-repair-partial, near-axis-shared-owner-double-counted, near-axis-optimize-confirmation-bypassed) прогнаны индивидуально (--id=...), все убиты целевым тестом/смоком (§2, таблица гейтов). --check не находит устаревших якорей ни у одного из 20+ мутантов реестра.

3.3 Проверка закрытия Medium M2 (AC10 автотест)

test/near-axis.test.mjs:106-132 — новый тест #290 Optimize reduces the tracked real-plan near-axis profile and stays idempotent вызывает nearAxisProfile/optimizePlans на обеих реальных фикстурах (real-plan-first-floor.json, real-plan-second-floor.json): проверяет строгое after.total <= before.total, точное равенство after.total === before.total - wallsStraightened, нулевой wallsStraightened на втором проходе (идемпотентность) и явно before.total === 1, repaired.report.wallsStraightened === 1, after.total === 0 для second-floor — это ровно факт, который r1 проверял вручную. npm test прогнал — тест зелёный, участвует в общем прогоне (не отдельный ad-hoc скрипт). Убедился, что тест умеет падать: без правки readModel (M2 внутри M1-коммита также чинит парсинг {note, space} в scripts/model-invariants.mjs) он не понадобился бы для самого near-axis теста (тот использует nearAxisProfile напрямую на {spaces:[space]}, собранном вручную в тесте, не через CLI) — а вот CLI-путь npm run invariants -- --config <fixture> теперь тоже работает буквально, что и было второй, менее блокирующей претензией M2.

4. Проверено и корректно (в этом раунде)

• Все три находки r1 (H1, M1, M2) закрыты по существу, не только декларативно — см. §3.1–3.3.
• git status чист на всём протяжении проверки: build, bundle:sync, mutation-gate (использует временные worktree, не трогает основное дерево), временная подмена src/resize.ts для сравнения — всё восстановлено.
• Коммитные трейлеры всего диапазона origin/dev..HEAD (9 коммитов): Issue: #290 на каждом; User-Visible: yes только на 43264eda (единственный коммит с видимым поведением — Optimize報report/UI), и в нём же правки docs/CHANGELOG.md/docs/CHANGELOG.ru.md (проверено ещё в r1, перепроверил сам факт присутствия обоих файлов в файловом списке того коммита). Три новых коммита раунда (615c0744, 6ded0f01, db77470d) — все User-Visible: no, changelog не требуется и не тронут.
• «Одно число, один источник»: в дельте раунда новых видимых пользователю чисел не появилось (правки — валидационная логика, тесты, CLI-парсинг); test/single-source-numbers.test.mjs прошёл в общем прогоне.

5. Унаследовано из r1 (без повторной проверки в этом раунде)

Документ: docs/reviews/CODE-REVIEW-290-r1.md. SHA, названный в том документе (5aae905a), не резолвится (см. §0) — как эквивалент указываю 43264eda, который содержательно идентичен по всем файлам, перечисленным ниже (не тронут ни #289-rebase, ни коммитами этого раунда — проверено git diff 523190d8..f472af88 --stat и git diff 43264eda..HEAD --stat).

• AC1 (boundary matrix threshold/inclusive) — src/near-axis.ts, test/near-axis.test.mjs boundary-тест; r1 подтвердил мутантами near-axis-threshold-weakened/near-axis-inclusive-boundary-disabled.
• AC2 (Walls authoring не сохраняет 316×1) — src/houseplan-card.ts, demo/smoke_plan_drawing_repairs.mjs; r1 прогнал смок и мутант near-axis-authoring-snap-bypassed.
• AC4/AC5/AC6/AC7 (Optimize чинит 316×1, сохраняет related geometry, multi-space/cell_cm) — src/plan-optimizer.ts, test/near-axis.test.mjs, test/plan-optimizer.test.mjs; r1 проверил чтением и ручным прогоном для multi-space части.
• AC8 (UI/Undo/revision, atomic write) — demo/smoke_near_axis_optimize.mjs; r1 прогнал все 7 сценариев смока.
• Документация (CANVAS/RESIZE/WALL-THICKNESS/ARCHITECTURE/ CONFIG-COMPATIBILITY/USER-GUIDE(.ru)/TESTING/CHANGELOG(.ru)) — не тронута в этом раунде, терминология уже сверена r1.
• Low L1 (AC1 source guard не механизирован, grep-гейта нет) — снят с записью в r1, дельта этого раунда его не касается, риск тот же.

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

Находка r1	Чем закрыта	Где видно
High H1 — near-axis проверка валит весь полигон комнаты, а не moving/side edges	src/resize.ts:1018-1023 сужен до involvedEdges = [prev, edge, edge+1]	615c0744 (fix: scope near-axis resize validation); воспроизведено мной на старом/новом коде в §3.1; тест test/resize.test.mjs:308+, дважды доведённый до правильного утверждения в 6ded0f01
Medium M1 — 3 из 6 обязательных мутантов AC9 отсутствуют	добавлены near-axis-shared-owner-repair-partial, near-axis-shared-owner-double-counted, near-axis-optimize-confirmation-bypassed	scripts/mutation-gate.mjs:964-999 (615c0744); все три прогнаны индивидуально, см. §3.2
Medium M2 — AC10 не покрыт автотестом на реальных планах	новый тест на обеих real-plan-*.json фикстурах + читатель readModel принимает {note, space} без обёртки	test/near-axis.test.mjs:106-132, scripts/model-invariants.mjs:519-524 (615c0744); прогнано, см. §3.3
Low L1 (source guard не механизирован)	не в скоупе этого раунда, снят с записью r1	— (унаследовано, см. §5)

7. Чего не проверял

• Полный Linux CI Validate на точном SHA HEAD — не переоткрывал gh-прогон отдельно; полагаюсь на локальный повтор дешёвых гейтов + целевые смоки
  • мутанты, как и r1.
• Полный набор demo/smoke_*.mjs (182 файла) — прогнал только прямые совпадения и зарегистрированную связь из smoke-select; слабую связь (19 файлов на _path) не прогонял в этом раунде — дельта не касается houseplan-card.ts/authoring-пути, где эти смоки актуальны; полный набор — предрелизный гейт (PROCESS.md §8).
• npm run golden:verify и performance-профили — не запускал; правка сужает существующую проверку в validateSafeResize (валидационная логика, не рендер, не добавляет работы), в AC нет количественного бюджета для этой части.
• python -m pytest tests_backend — не запускал; диф не трогает Python.
• Touch/pinch/pointercancel — дельта раунда не трогает pointer-разбор вообще (resize.ts validation logic не завязана на источник события); унаследовано из r1, который проверил это для authoring-пути.