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

CODE-REVIEW-306-r2

• Issue: #306 — нулевые стены вместо виртуальных границ
• Этап: code (PROCESS.md §2.7)
• Заход: r2 · блокирующих циклов израсходовано 1/4 (r1 — жёлтый, M1+M2 в скоупе, L1 на суждение автора; зелёный вердикт цикла не образует, §4/#227)
• Ветка / SHA материала: issue/306-zero-thickness-walls @ 9134d862667e907f877830207d78916697bf59f4 (git status чист, HEAD совпадает с SHA, названным автором в комментарии от 2026-08-26T11:07)
• Предыдущий раунд: docs/reviews/CODE-REVIEW-306-r1.md, вердикт жёлтый, материал a66fb7ef53906bed33c6f92369b14e8e398be3bd

1. Скоуп раунда — дельта, не задача целиком

Разбор ведётся по §2.10: r1 закрыл полный первый заход код-ревью (91 файл, +4210/-2989), r2 — правки по трём находкам r1, ничего больше.

a66fb7ef53906bed33c6f92369b14e8e398be3bd — ancestor текущего HEAD (rebase не происходил, merge-base HEAD origin/dev == origin/dev, ветка уже содержит весь dev). Дельта git diff a66fb7ef..HEAD — 13 файлов, +406/-49:

custom_components/houseplan/frontend/houseplan-card.js | 13 +-  (D, сгенерировано)
dist/houseplan-card.js                                  | 13 +-  (D, сгенерировано)
docs/CHANGELOG.md                                        |  5 +-
docs/CHANGELOG.ru.md                                      |  5 +-
docs/images/09-device-info.png                            | bin  (D, сгенерировано)
docs/images/screenshots.json                               | 24 +-
docs/reviews/CODE-REVIEW-306-r1.md                          |290 + (документ этого же ревью)
src/houseplan-card.ts                                        | 48 +-
src/i18n/en.json                                              |  7 +-
src/i18n/ru.json                                              |  7 +-
src/plan-optimizer.ts                                          | 10 +-
test/i18n.test.mjs                                              | 29 +-
test/plan-optimizer.test.mjs                                     |  4 +-

Дельта локальна: не меняет контракт поведения (единая семантика cm:0, миграция, Resize/Undo, backend-схема не тронуты), не задевает новую подсистему, не сопоставима по объёму с задачей (13 файлов против 91, +406/-49 против +4210/-2989). Условия «разбор остаётся полным» (ребейз на ушедший dev, смена контракта, новая подсистема, сопоставимый объём) не выполнены — разбор по дельте, §2.10 п.4.

2. Как проверялось

2.1 Гейты — что прогнано лично

Гейт	Команда	Результат
Typecheck	npx tsc --noEmit	green, exit 0
Unit	npm test	1346 tests: 1345 passed, 1 skipped, 0 failed
Build + сверка бандлов	npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js, затем npm run bundle:sync	green; все три копии (dist/, custom_components/houseplan/frontend/, demo/srv/assets/) byte-identical, SHA-256 189ad1c164d68494ef92fef48d50690e3c79d4b2fd46778cdd44900c30b7f16c — совпадает с хешем, названным автором в хендоффе 2026-08-26T11:07
Docs fingerprint	node scripts/check-docs.mjs	green: «Documentation checks passed (7 files, 10 external links)» — обязателен, дельта трогает src/** (i18n-строки, toast-wiring)
Смок-выборка по дельте	node scripts/smoke-select.mjs --base a66fb7ef53906bed33c6f92369b14e8e398be3bd --head HEAD	15 «прямое совпадение» (_showToast, _drawWallCm, NORM_W); вывод и решение по каждой строке — §2.3
Целевой браузерный смок (лично, Chromium песочницы)	node demo/smoke_zero_walls.mjs (после npm run bundle:sync)	green, все ключи true, включая openingBlocksZero (проверяет ровно путь toast.zero_wall_opening_conflict, переименованный этой правкой)

2.2 Что НЕ прогонялось и почему

• node scripts/model-invariants.mjs — не прогонялся. Дельта не трогает геометрию/ссылки на неё: изменение в plan-optimizer.ts — чисто счётный рефакторинг (legacyZeroContourLines(...) вынесен в переменную и посчитана её длина, тело цикла и его эффект на config/layout не изменились, проверено построчным чтением диффа). src/houseplan-card.ts меняет только выбор ключа i18n для существующих веток _showToast, ни одна точка записи геометрии не задета. Гейт был green на предыдущем полном заходе (r1, a66fb7ef) и делта его не касается.
• npm run golden:verify / golden-эталоны — не прогонялся и не принимался. Дельта не меняет рендер, геометрию, стили или слои — только текст toast/Optimize и одну ре-акцептированную документационную PNG (см. ниже), в demo/golden/baselines/** изменений нет (подтверждено git diff --stat дельты).
• python -m pytest tests_backend -q — не прогонялся. Дельта не трогает custom_components/**/*.py (подтверждено git diff --stat).
• Полный набор demo/smoke_*.mjs (191 файл) — не прогонялся, дельта не задевает всё: точечная правка i18n-текста и Optimize-репортинга, не новый контракт поведения. Полный набор — предрелизный гейт (§8), не гейт ревью.
• 14 из 15 «прямых совпадений» смок-выборки не прогнаны отдельно — проверены чтением на релевантность (детали §2.3), кроме уже прогнанного smoke_zero_walls.
• Performance-профиль (benchmark:wall-model) — не прогонялся: дельта не трогает горячий путь геометрии/кэшей, в AC13/AC17 не названа.

2.3 Разбор смок-выборки по дельте

smoke-select.mjs вернул только категорию «прямое совпадение» (15 файлов, порог широкого символа — 39 смоков, ни один совпавший символ его не достиг). Проверка каждой строки чтением содержимого смока на предмет реальной, а не по имени, связи с изменёнными строками:

Смок	Символ-триггер	Решение
smoke_zero_walls.mjs	не в списке (совпадение вне выборки)	прогнан — прямо проверяет openingBlocksZero через toast.zero_wall_opening_conflict
smoke_partition_openings.mjs	_showToast	не прогнан — файл не содержит ссылок на zero_wall_*/cmRaw, _showToast matched на несвязанной строке (grep пуст на релевантных паттернах)
smoke_room_resize.mjs	_showToast	не прогнан — тот же результат: нет ссылок на изменённые ветки
smoke_help_affordance.mjs	_showToast	не прогнан — про подсказки интерфейса, не про zero-wall toasts
smoke_optimize_coordinate_canonicalization.mjs	_showToast	не прогнан — файл не проверяет spansMerged/legacyZeroWallsMigrated/gs.optimize_changes (grep пуст)
smoke_draw_wall_thickness.mjs	_drawWallCm	не прогнан — единственная проверка _drawWallCm === 15, положительная толщина, не задевает ветку === 0
smoke_unified_wall_tool.mjs, smoke_wall_chain_merge.mjs, smoke_wall_face_overlap.mjs	_drawWallCm	не прогнаны — нет проверок ambiguous-ветки или === 0 (grep пуст)
smoke_wall_chain_thickness.mjs	_drawWallCm	не прогнан — проверяет === 30, не относится к дельте
smoke_active_chain_ink.mjs, smoke_drag_bounds.mjs, smoke_grid_snap.mjs, smoke_infinite_canvas.mjs, smoke_junction_holes.mjs, smoke_wallthick_standalone.mjs	NORM_W	не прогнаны — NORM_W совпал вне контекста дельты (модульная константа, используется в сотнях не связанных мест)

Ни один из непрогнанных смоков не содержит ассерта на изменённые строки — совпадения по имени символа, не по поведению. Слабых связей (категория «НЕОПРЕДЕЛЁННОСТЬ») в выдаче не было вовсе.

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

Находка r1	Чем закрыта	Где видно
M1 (Medium, в скоупе) — Optimize называл cm:0 «виртуальными» (gs.optimize_changes), смешанный счётчик spansMerged вместо раздельных «legacy virtual spans migrated» / «zero-wall atoms merged» (§8.4 ТЗ)	En/ru-текст gs.optimize_changes заменён на «merged zero-thickness wall fragments» / «объединено отрезков стен нулевой толщины»; добавлен отдельный ключ gs.zero_walls_migrated и поле OptimizeReport.legacyZeroWallsMigrated, посчитанное отдельно от spansMerged в цикле миграции; в разметке добавлена отдельная строка ${r.legacyZeroWallsMigrated ? html...} рядом со строкой spansMerged	src/i18n/en.json:820-821, src/i18n/ru.json:820-821, src/plan-optimizer.ts:60-61,485,516-518,701, src/houseplan-card.ts:16937-16939; unit test/i18n.test.mjs:53-77 (проверяет буквальный текст + cardSource ссылку), test/plan-optimizer.test.mjs:600 (assert.equal(first.report.legacyZeroWallsMigrated, 1) — тест умеет падать: сборка без нового поля/счётчика провалит оба ассерта)
M2 (Medium, в скоупе) — changelog не предупреждал о backup перед миграцией model v9, хотя §12.2 ТЗ прямо требует	В оба changelog добавлено предложение «Export a backup before the first structural save, import or Optimize plans that writes model v9: downgrade to an older version does not understand the new wall model, and restoring that backup is the supported way back» / рус. эквивалент	docs/CHANGELOG.md:10-15, docs/CHANGELOG.ru.md:17-22, оба в одном коммите f15bdc67 (User-Visible: yes, оба changelog в том же коммите — трейлер-требование выполнено)
L1 (Low, на суждение автора) — 4 i18n-ключа §15 ТЗ (toast.zero_wall_opening_conflict, toast.zero_wall_ambiguous, toast.zero_wall_migration_blocked, gs.zero_walls_migrated) переиспользовали обобщённые ключи вместо выделенных	Все четыре ключа заведены отдельно в en/ru и подключены в местах вызова: toast.zero_wall_opening_conflict заменил toast.zero_wall_opening в трёх местах блокировки проёма; toast.zero_wall_ambiguous подключён веткой this._drawWallCm === 0 ? 'toast.zero_wall_ambiguous' : 'toast.wall_repair_ambiguous' в обоих местах ambiguous-репейра стены; toast.zero_wall_migration_blocked подключён через новый хелпер _showWallModelMigrationBlocked, который сам выбирает специализированный или общий ключ по _hasLegacyZeroWallFields(); gs.zero_walls_migrated — см. M1	src/houseplan-card.ts:7350-7368 (хелперы), :8143-8146,8221-8224 (ambiguous), :8349,11721,11761 (opening conflict), :7439,7571,15679 (migration blocked через хелпер); unit test/i18n.test.mjs:72-91 — новый тест issue 306 zero-wall failures have dedicated symmetric copy, проверяет и текст, и присутствие имени ключа в собранном cardSource

Все три находки закрыты по коду, не по заявлению автора: правки прочитаны построчно, _drawWallCm === 0 подтверждена как геттер активной толщины инструмента «Стены» (src/houseplan-card.ts:6700, используется тем же паттерном в соседней проверке cmRaw === 0 строкой ниже), рефакторинг plan-optimizer.ts не меняет побочных эффектов миграции (тело цикла идентично, добавлено только присваивание счётчика).

4. Новые находки

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

Дельта — точечная (текст toast/changelog + разделение счётчика Optimize), риск регрессии низкий: изменённые ветки — либо чистое добавление счётчика без влияния на существующий эффект (M1), либо документация (M2), либо выбор строки по уже существующему и повсеместно используемому в этом же файле предикату === 0 (L1). smoke_zero_walls — единственный смок, реально проверяющий один из трёх изменённых путей (toast.zero_wall_opening_conflict), зелёный.

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

• Trailers коммитов дельты: f15bdc67 — Issue: #306, User-Visible: yes, оба changelog в том же коммите; db4e0ef9 — документ ревью, User-Visible: no; 9134d862 — приёмка скриншотов, Source: на прогон CI, User-Visible: no. Все три корректны по PROCESS.md §10.2/AGENTS.md.
• Одно число — один источник: gs.zero_walls_migrated показывает r.legacyZeroWallsMigrated, gs.optimize_changes показывает r.spansMerged — это два разных по смыслу счётчика (legacy-конвертация и слияние атомов), каждый вычисляется и отображается ровно один раз, дублирования одной и той же величины нет.
• Приёмка скриншотов (docs/images/screenshots.json, 09-device-info.png) ссылается на реальный прогон CI (Source: в коммите), проведена после смены sourceFingerprint, вызванной правками src/**; check-docs.mjs подтверждает соответствие текущему src/**. Единственное изменённое изображение — 09-device-info.png, что совпадает с заявлением автора («17 пикселей, delta=1»); остальные девять кадров сохранили прежний imageSha256 при новом sourceSha256 — ожидаемо для чисто-текстовых изменений, не меняющих их вёрстку.
• AC13 (Optimize показывает counts) и AC18 (документация/changelog описывают backup) — единственные AC, доказательство которых дельта задевает; оба подтверждены заново по коду и тестам выше (§3).

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

• Полный HA backend harness (python -m pytest tests_backend, полный) — дельта не трогает Python; итоговый гейт — CI job backend на точном SHA.
• golden:verify — дельта не меняет визуал; в demo/golden/baselines/** изменений нет.
• 14 из 15 смоков с «прямым совпадением» символа — решение по каждому в §2.3, ни один не содержит ассерта на изменённые строки.
• Полный набор demo/smoke_*.mjs и performance_smoke — предрелизный гейт, не гейт этого раунда.
• Ручное исполнение приложения в браузере — не выполнялось; доказательство идёт через smoke_zero_walls.mjs (реально исполняется в Chromium песочницы) и чтение кода для остального.

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

Без повторной проверки в этом раунде принято по docs/reviews/CODE-REVIEW-306-r1.md (материал a66fb7ef53906bed33c6f92369b14e8e398be3bd):

• полный разбор AC1–AC9, AC10 (кроме переименованного ключа — закрытие показано в §3 этого документа), AC11, AC12, AC14–AC18 (кроме changelog-строки — §3);
• проверка backend-схемы (validation.py, wall_segment_model.py) чтением + автором названный прогон «pure backend — 206 passed, 1 skipped»;
• единая семантика cm:0 без zero_kind/compatibility-маркера (AC3, grep по всему r1-диффу);
• Glow/солнце через общий resolver (AC5–AC7, src/zero-walls.ts);
• защита проёмов от потери на уровне backend+frontend+смок (AC10, часть про сам guard, не про текст toast);
• touch-контракт, i18n-полнота (кроме 4 ключей §15, разобранных в §3), release-артефакты (кроме changelog-строки backup);
• model-invariants и golden — green на a66fb7ef (полный первый заход).

Вывод

Все три находки r1 (M1, M2, L1) закрыты по коду, не по заявлению автора. Новых находок нет. Дешёвые гейты (typecheck, test, build+bundle, check-docs — дельта трогает src/**) green лично. Целевой смок, реально проверяющий изменённый путь, green. Задача готова к очереди на пре-релиз.

Вердикт: зелёный · заход r2 · блокирующих циклов 1/4 · High: 0 · Medium: 0