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

# CODE-REVIEW-313-r2

Issue: #313 · этап: код (code) · трек: `small` · заход: r2 · блокирующих циклов
израсходовано: 1 из 2 · SHA материала ревью: `ed126d6a436c7e4499c13d37d0068627235ab7c3`
· SHA предыдущего раунда (r1, красный): `5e5dad277cbdc238a5af899ff6727aed60d604b1`

## Скоуп

Один коммит поверх r1 — `ed126d6a` («fix: keep a stored zero draft thickness
and guard both thickness writers (#313)»), заявленный автором как закрытие
ровно двух находок CODE-REVIEW-313-r1 (High + Medium), без новых AC и без
изменения контракта ТЗ.

Дельта `git diff 5e5dad27..ed126d6a`:

```
.../houseplan/frontend/houseplan-card.js | 4 ++--
demo/smoke_wallthick_standalone.mjs      | 12 +++++++++++-
dist/houseplan-card.js                   | 4 ++--
docs/images/screenshots.json             | 22 +++++++++++-----------
src/houseplan-card.ts                    |  7 ++++++-
test/wall-union-isolation.test.mjs       | 11 ++++++++++-
```

(плюс `docs/reviews/CODE-REVIEW-313-r1.md`, добавленный отдельным
docs-коммитом `d34e56ba` конвейером публикации между r1 и r2 — не продуктовый
код, не часть разбора.)

Дельта строго локальна: одна ветка резолвера драфта в `_wallThickHit`
(1 файл src/**) и один тестовый гвард (1 файл test/**), плюс фикстура и три
новых ассерта в уже существующем смоке. Нет ребейза на ушедший вперёд `dev`
(родитель `ed126d6a` — тот же `5e5dad27`/`d34e56ba`, `dev` не двигался),
контракт поведения не меняется, новая подсистема не задета. Объём разбора —
по дельте, полный повторный проход по r1 не требуется; раздел «Унаследовано»
ниже перечисляет, что принято без повторной проверки.

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **High** — `_wallThickHit`, ветка сегментов драфта: `Number(draft.segments[i]?.cm) \|\| 15` не отличает «сегмента нет» от «cm сегмента = 0»; сохранённый 0 читался/показывался/при Apply-без-правки записывался как 15 | `src/houseplan-card.ts:11978-11981`: `const rawCm = Number(draft.segments[i]?.cm); … cm: Number.isFinite(rawCm) ? rawCm : 15` — фолбэк на 15 срабатывает только когда `Number(...)` даёт `NaN` (запись отсутствует), сохранённый `0` проходит `Number.isFinite` и доходит до диалога нулём | `demo/smoke_wallthick_standalone.mjs`: фикстура `room_drafts[0].segments` расширена вторым сегментом `{ cm: 0 }` (строки 20-24); три новых ассерта — `zeroSegmentSurvives` (hit несёт `cm===0`), `zeroSegmentFieldEmpty` (`_wallDialog.value === ''`), `zeroSegmentNotCorrupted` (Apply без правки не меняет `segments[1].cm`). Перепроверил исполнением: смок зелёный на HEAD; откатив резолвер на старый `\|\| 15` и пересобрав бандл, получил ровно эти три ассерта красными (`FAILED (3): zeroSegmentSurvives / zeroSegmentFieldEmpty / zeroSegmentNotCorrupted`) — тест умеет падать именно на этом дефекте |
| **Medium** — гвард `test/wall-union-isolation.test.mjs:107` (regexp по всему исходнику одной строкой) не отличает мутацию новой точки коммита независимой кладки от мутации легаси-точки; «поймано 1 из 1» у мутанта обманчиво | `test/wall-union-isolation.test.mjs`: паттерн приведён к `\/_commitPhysicalGeometry\(\s*this\._t\('history\.${historyKey}'/` (терпит перенос строки после открывающей скобки) плюс новый явный ассерт `assert.equal((source.match(/_commitPhysicalGeometry\(\s*this\._t\('history\.wall_thickness'/g) \|\| []).length, 2, 'both thickness writers route through the common barrier')` | Изолированно мутировал только новую точку коммита независимой кладки (`src/houseplan-card.ts:12069-12071`, `_commitPhysicalGeometry` → `_recordGeometry`), пересобрал тестовый бандл (`npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs`) и прогнал `node --test test/wall-union-isolation.test.mjs`: тест красный — `both thickness writers route through the common barrier / 1 !== 2`. Легаси-точку не трогал — до правки такая изолированная мутация гварду проходила незамеченной (ровно то, что описывал r1). Дополнительно прогнал `node scripts/mutation-gate.mjs --id=wall-thickness-writer-bypasses-common-barrier` на чистом дереве — «поймано 1 из 1», согласуется с заявлением автора «pass 0 / fail 1» |

Обе находки закрыты минимальными, локальными правками, ровно там, где были
найдены; новых находок делта не добавляет.

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

Всё, кроме двух исправленных находок, принято без повторной проверки —
делта их не задевает. Источник: `docs/reviews/CODE-REVIEW-313-r1.md`,
SHA `5e5dad277cbdc238a5af899ff6727aed60d604b1`.

- **AC1** (перегородка: hit → диалог → `partition.cm` → Undo) — закрыт в r1
  смоком + ручной проверкой Undo (`_geometryHistory.size === 1`). Делта не
  трогает партиционную ветку резолвера/writer'а.
- **AC3** (приоритет наложения #308-фикстуры; отказ нуля/пусто для независимой
  кладки) — закрыт в r1 смоком + `smoke_optimize_coincident_partition`. Делта
  не трогает тай-брейк `offer(...)` и ветку валидации диапазона.
- **AC4** (комнатные стены не регрессируют) — закрыт в r1: `wallIntervals(...)`
  байтово не менялся, три названных смока + `npm test` зелёные. Делта не
  трогает комнатную ветку резолвера/writer'а (строка 12100 не изменилась).
- Приоритет независимой кладки при точном наложении, разные объекты `sp`/
  `space` и корректность поиска по `id`, скрытие кнопки «на всю комнату» по
  `d.source.kind`, порядок валидации диапазона до/после ветвления по
  источнику, переиспользование тостов и ключей i18n — прочитано и принято
  в r1, код этих участков в делте не изменился.
- CHANGELOG (оба файла) и трейлеры `Issue:`/`User-Visible: yes` для фичи в
  целом — заведены коммитом `5e5dad27`, проверены в r1. Коммит r2
  (`ed126d6a`) сам несёт `User-Visible: no` без правки CHANGELOG — это
  корректно: фича ещё не смержена/не выпущена, CHANGELOG уже описывает её на
  уровне контракта («любую стену… ноль отклонён»), а r2 лишь чинит
  внутреннюю порчу данных в ещё не выпущенном коде, не меняя ни
  задокументированное поведение, ни его формулировку — проверил `git diff
  5e5dad27..ed126d6a -- docs/CHANGELOG.md docs/CHANGELOG.ru.md`: дельта
  пуста, значит новый видимый факт CHANGELOG не потерял.
- `docs/USER-GUIDE.ru.md` — дополнен в r1, делта его не трогает.
- Инварианты модели — в r1 обосновано и проверено (`npm run invariants --
  config test/fixtures/276-coincident-partition.json`, 1 предсуществующее
  нарушение, не следствие диффа): диф вообще не создаёт новую форму записи
  геометрии, пишет в `partition.cm`/`draft.segments[i].cm` тем же путём, что
  уже существующий `_savePhysicalDialog`. Делта r2 меняет только fallback при
  ЧТЕНИИ значения и текст тестового регэкспа — ни `wall_segments[]`, ни ключи,
  ни `open_spans` не затронуты ни в r1, ни в r2, поэтому инварианты в r2 не
  перепрогонялись.
- Golden/`pytest tests_backend`/perf — не запускались ни в r1 (рендер и
  бэкенд не менялись), ни в r2 (та же причина, делта тем более не касается
  рендера — только числовой fallback и текст теста).

## Гейты — прогнал (r2)

| Гейт | Команда | Результат |
|---|---|---|
| typecheck | `npx tsc --noEmit` | зелёный, без вывода |
| unit (полный) | `npm test` | 1335 pass / 1 skip / 0 fail (1336 total) |
| build + bundle sync | `npm run build && npm run bundle:sync` | пересобрал; `sha256sum dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js demo/srv/assets/houseplan-card.js` — три одинаковых хеша |
| docs fingerprint | `node scripts/check-docs.mjs` (диф трогает `src/**`) | «Documentation checks passed (7 files, 10 external links)» |
| новый смок (AC1/AC2, High) | `node demo/smoke_wallthick_standalone.mjs` | OK, все 13 под-проверок true, включая три новых |
| смок умеет падать (High) | откат резолвера на `\|\| 15`, пересборка бандла, повторный прогон смока | `FAILED (3): zeroSegmentSurvives, zeroSegmentFieldEmpty, zeroSegmentNotCorrupted` — красный ровно на закрытой находке; вернул файл, дерево снова чистое |
| гвард умеет падать (Medium) | мутация только новой точки коммита (`_commitPhysicalGeometry`→`_recordGeometry`, houseplan-card.ts:12069), пересборка тестового бандла (`npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs`), `node --test test/wall-union-isolation.test.mjs` | красный: `both thickness writers route through the common barrier / 1 !== 2`; вернул файл, дерево чистое |
| точечный мутационный гейт | `node scripts/mutation-gate.mjs --id=wall-thickness-writer-bypasses-common-barrier` | «поймано 1 из 1» на чистом дереве |
| смок-выборка по делте | `node scripts/smoke-select.mjs --base 5e5dad27 --head HEAD` | «НЕОПРЕДЕЛЁННОСТЬ: … ни один смок не связан доказуемо» (0 символов проекта на изменённых строках делты — новая локальная переменная `rawCm`, регэксп теста). Не повод ничего не гонять: смок, напрямую относящийся к находкам (`smoke_wallthick_standalone`), уже прогнан выше вместе с падением на мутации — этого достаточно для делты такого размера |
| три названных смока AC4 (регрессия комнатных стен, делта их не трогает, но дёшево перепроверить) | `node demo/smoke_wall_thickness.mjs`, `node demo/smoke_wallthick_hover_width.mjs`, `node demo/smoke_resize_wall_thickness.mjs` | все три OK |

### Не прогонял (и почему)

- Полная матрица `smoke_*.mjs` (191 файл) и `golden:verify` — предрелизная
  обязанность (PROCESS.md §8), не гейт ревью; делта не меняет рендер/геометрию
  результата, `smoke-select` не назвал ни одного дополнительного кандидата.
- `python -m pytest tests_backend -q` — `custom_components/**/*.py` не тронут
  ни в делте, ни в r1.
- `npm run invariants` на конкретной конфигурации — делта не меняет запись
  геометрии (см. «Унаследовано» выше); повторный прогон не добавил бы
  информации к выводу r1.
- Performance-профили — не названы в AC, чувствительные к перфу пути не
  тронуты.

## Вердикт

Зелёный. Обе находки r1 (High и Medium) закрыты точными, локальными правками
ровно в тех местах, где были найдены; для каждой перепроверил исполнением не
только «стало зелёным», но и «умеет падать» — откатил правку и получил
ожидаемое красное на смоке (High) и на юнит-гварде (Medium). Делта не
затрагивает ни один из участков, закрытых r1 («Унаследовано» выше), новых
находок не обнаружено.