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

# CODE-REVIEW-113-r2 — honest optional contract for `_spaceModel()`, post-rebase re-check

- **Issue:** https://github.com/Matysh/houseplan-card/issues/113
- **ТЗ:** `docs/specs/113-optional-space-model.md`, ревью ТЗ — `docs/reviews/SPEC-REVIEW-113-r1.md`
  (зелёный, Medium-1 → #184, не блокирует)
- **Предыдущий цикл:** `docs/reviews/CODE-REVIEW-113-r1.md` — зелёный, High 0, Medium 0. Слияние
  автоматически не прошло (конфликт `issue/113-optional-space-model` ↔ `dev`), поэтому issue
  вернулся в `S6-in-progress` не за переделку кода, а за ребейз (AGENTS.md «Two-agent workflow»:
  «после ребейза на сдвинутый `dev` это другой код, и принимать его без проверки нельзя»).
- **Диапазон:** `origin/dev..HEAD`, `origin/dev` = `c1676cf` (docs: review document for #117).
  `git merge-base origin/dev HEAD` = `c1676cf` — ветка полностью перебазирована, дивергенции нет.
- **Коммиты (5):** `0c2a5de` (specify contract), `135497b` (spec review doc), `1e8503b`
  (**реализация** — «Make empty space model explicit», это переехавший `09b5a74` из r1), `047363c`
  (r1 code-review doc), `66fa8f4` (**новый после r1** — «Keep mutation anchor aligned after optional
  model change»).
- **Цикл:** r2/4 (счётчик по этапу код-ревью; ревью ТЗ отдельно на r1)
- **Роль:** ревьюер кода (Claude), свежая сессия, без контекста реализации автора и без контекста
  собственного прогона r1.

## 1. Скоуп цикла r2

`dev` продвинулся между r1 и этим ребейзом: слиты #132/#157 (hosted/partition openings) и #173
(unified wall topology). Автор перебазировал `issue/113-optional-space-model` на новый `dev`
(`c1676cf`) и разрешил конфликты, сохранив обе стороны. Это **другой код**, чем тот, что получил
зелёный вердикт в r1 — задача этого цикла не «доверять r1», а заново пройти по чек-листу §2.7 на
итоговом дереве.

Diff `origin/dev...HEAD` (16 файлов) идентичен по содержанию r1 плюс один новый коммит:

- `66fa8f4` меняет **только** `scripts/mutation-gate.mjs`: якорь мутации
  `same-space-room-change-recenters` использовал буквальный текст
  `prevPos.s === targetSpace`, но ребейз/реализация переименовала локальную переменную в
  `targetSpaceId` (проверено чтением `src/houseplan-card.ts:12908,13018,13033` — переменная
  везде называется `targetSpaceId`, старого имени `targetSpace` в файле нет). Мутационный якорь —
  точное совпадение строки, поэтому несовпадающий текст сделал бы мутационный тест **тихо
  неработающим** (find не совпадает → патч не применяется → «поймано» покажет ложный `OK`, а не
  реальную проверку). `66fa8f4` возвращает якорь к соответствию исходнику.
- `Issue: #113` / `User-Visible: no` на месте на всех 5 коммитах, включая новый.

Остальные 15 файлов — то же содержание, что было предметом r1 (проверено `git diff`: единственный
новый функциональный код появляется только в `66fa8f4`). Часть строк diff'а (`_saveMarker`,
`partitions`) теперь физически стоит рядом с кодом #132/#157/#173, слитым в `dev` до ребейза — эти
call sites `_spaceModel()`/`.partitions` уже были в скоупе оригинальной реализации (видно по
`targetSpaceModel`, `space.partitions`/`model.partitions` в diff'е — не новые правки этого цикла,
перенеслись без изменений при ребейзе). Отдельно проверено: слитый в `dev` код не добавил **новых**
необработанных обращений к `_spaceModel()` вне diff'а этой ветки (см. §3).

`User-Visible: no` остаётся в силе без изменений (§13 ТЗ), changelog не трогается — согласовано.

## 2. Как проверялось — таблица гейтов

| Гейт | Команда | Результат |
|---|---|---|
| Typecheck | `npx tsc --noEmit` | OK, без ошибок |
| Unit | `npm test` | `877/877` OK (было `811/811` в r1 — рост за счёт тестов, слитых в `dev` вместе с #132/#157/#173, не связан с этим диффом) |
| Build + 3 копии бандла | `npm run build`, затем `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` и `cmp dist/houseplan-card.js demo/srv/assets/houseplan-card.js` | OK, обе сверки — байт-в-байт совпадение |
| Именованный smoke (AC3–AC6) | `node demo/smoke_optional_space_model.mjs` | OK, все 9 подпроверок `true` |
| Именованный smoke (AC6, read-only cold start) | `node demo/smoke_readonly_cold_start.mjs` | OK, все 13 подпроверок `true` |
| Мутационный guard AC10/AC4/AC5 (не менялся этим циклом) | `node scripts/mutation-gate.mjs --id=empty-space-cleanup-disabled` | `поймано 1 из 1`, чистый прогон зелёный |
| **Мутационный guard, якорь которого правит `66fa8f4`** | `node scripts/mutation-gate.mjs --id=same-space-room-change-recenters` | `поймано 1 из 1` — якорь совпал с исходником, патч применился, `smoke_subarea.mjs` покраснел, как обязан. Это прямое подтверждение, что правка якоря не сделала тест немым |
| Именованный smoke затронутого якоря | `node demo/smoke_subarea.mjs` (чистое дерево) | OK, все 14 подпроверок `true` |
| Regression: поверхности, слитые из #132/#157/#173, рядом с которыми правился diff (`_saveMarker`/`partitions`) | `node demo/smoke_partition_openings.mjs`, `node demo/smoke_unified_wall_tool.mjs`, `node demo/smoke_room_autoclose.mjs` | OK, все зелёные |
| Process gate | `node scripts/process-gate.mjs --issues` | `диапазон origin/dev..HEAD, коммитов 5`, `гейт пройден, предупреждений 0` |
| Контракт call sites | `grep -n "_spaceModel()!" src/houseplan-card.ts` и `grep -n "_spaceModel()\s*\." src/houseplan-card.ts \| grep -v "?\."` | пусто — ни non-null assertion, ни naked deref после `_spaceModel()` в production source |

**Не прогонялось, и почему:**

- **Полный набор 135(+) браузерных смоков** — не расширился в этом цикле относительно r1: этот
  ребейз не добавил новых поверхностей, кроме тех трёх (`partition_openings`, `unified_wall_tool`,
  `room_autoclose`), которые были рядом с изменёнными строками и прогнаны выше. Остальное
  логическое обоснование r1 (guard, недостижимый при непустой модели) не изменилось — новый
  функциональный код этого цикла ограничен одной правкой строки в тестовом скрипте, не в продукте.
- **`npm run golden:verify`** — не прогонялся; тот же аргумент, что и в r1 (guard добавлен *до*
  существующей логики и физически недостижим при непустой модели), плюс этот цикл не меняет ни
  одной строки `src/houseplan-card.ts` относительно r1 — только `scripts/mutation-gate.mjs`
  (класс B, не влияет на визуальный результат).
- **`python -m pytest tests_backend`** — ни один файл `custom_components/**/*.py` не тронут ни в
  этом коммите, ни в диапазоне.
- **Performance-профили** — не названы в AC, hot path не тронут этим циклом (единственная правка —
  тестовый скрипт).
- Остальные смоки вне таблицы — сознательно не прогонялись; сужение соразмерно объёму нового кода
  цикла (одна строка в `mutation-gate.mjs`), а не всей задаче #113 заново.

## 3. Проверка AC (docs/specs/113-optional-space-model.md §10) — переподтверждение после ребейза

Продуктовый код (`src/houseplan-card.ts`, `src/space-model-selection.ts`) идентичен принятому в r1
(проверено `git diff` — единственный новый коммит цикла трогает только `scripts/mutation-gate.mjs`),
поэтому доказательства AC1–AC9 из r1 переносятся без изменений; ниже — что перепроверено заново на
итоговом дереве, а не просто процитировано.

| AC | Статус в r2 |
|---|---|
| AC1–AC2 (optional тип, отсутствие non-null assertions) | перепроверено заново: `tsc --noEmit` зелёный на итоговом дереве; grep на `_spaceModel()!`/naked deref — пусто (см. §2) |
| AC3–AC6 (empty lifecycle, delete-last, pending action abort, read-only cold start) | перепроверено исполнением: `smoke_optional_space_model.mjs`, `smoke_readonly_cold_start.mjs` — оба зелёные на итоговом дереве после ребейза |
| AC7 (non-empty View/editors pixel/action parity) | перепроверено smoke-регрессией на поверхностях, слитых из #132/#157/#173 и физически соседствующих с diff'ом (`partition_openings`, `unified_wall_tool`, `room_autoclose`, `subarea`) — все зелёные; логический аргумент r1 (guard недостижим при непустой модели) не изменился, т.к. продуктовый код не менялся |
| AC8 (stale explicit id не мутирует первый space) | код не менялся; `test/space-model-selection.test.mjs` в составе зелёного `npm test` |
| AC9 (active-id fallback) | код не менялся; тот же unit-тест |
| AC10 (type/source gates ловят регрессию сигнатуры) | **перепроверено исполнением заново** — `empty-space-cleanup-disabled` (не менялся) и, отдельно, мутационный тест, чей якорь чинит этот цикл (`same-space-room-change-recenters`): подтверждено, что после правки якорь совпадает с исходником и мутация по-прежнему ловится (§2, §4) |

## 4. Дисциплина «тест умеет падать» — что именно проверено исполнением в этом цикле

Ядро этого цикла — не переисполнение доказательств r1 (код там не менялся), а верификация того, что
единственная новая правка (`66fa8f4`) не превратила существующий мутационный гейт в фиктивный:

- До правки старый якорь (`prevPos.s === targetSpace`) не совпал бы ни с одной строкой текущего
  `src/houseplan-card.ts` (переменная называется `targetSpaceId` во всех трёх местах использования —
  проверено grep'ом). Несовпадающий `find` в `scripts/mutation-gate.mjs` не бросает ошибку — он
  просто не применяет патч, тест против чистого дерева проходит с эффективно нулевым мутационным
  покрытием, а `поймано 1 из 1` в CI осталось бы зелёным без реальной проверки — то есть перед
  `66fa8f4` этот конкретный guard тихо перестал бы что-либо ловить.
- Прогон `node scripts/mutation-gate.mjs --id=same-space-room-change-recenters` на текущем дереве
  подтверждает обратное: `find` совпал, патч применился, `smoke_subarea.mjs` **покраснел** — тест
  умеет падать по факту исполнения, не предположительно.
- То же самое для `empty-space-cleanup-disabled` (якорь не менялся этим циклом, но перепрогнан
  заново на итоговом дереве после ребейза, а не процитирован из r1): `поймано 1 из 1`.

## 5. Находки

Нет находок High. Нет находок Medium.

Два Low из r1 (стейл `_splitSel`/`_mergeDialog`/`_wallDialog` при пустом переходе; недостижимый
защитный `if (!space) return nothing` в `render()`) относятся к продуктовому коду, который в этом
цикле не менялся — они разобраны и сняты в `docs/reviews/CODE-REVIEW-113-r1.md` §5, повторно не
переоткрываю.

## 6. Что проверено и корректно

- `git merge-base origin/dev HEAD` совпадает с `origin/dev` — ветка действительно линейно
  перебазирована, диапазон `origin/dev..HEAD` не содержит посторонних коммитов и не пропускает ни
  один слитый коммит основной линии.
- Продуктовый diff (`src/houseplan-card.ts`, `src/space-model-selection.ts`,
  `docs/ARCHITECTURE.md`, `docs/TESTING.md`, тесты, smoke) идентичен r1 построчно — единственная
  дельта цикла ограничена `scripts/mutation-gate.mjs` (класс B).
- Call sites, физически расположенные рядом со слитыми из #132/#157/#173 фичами (`_saveMarker`
  targetSpaceModel/targetSpaceId, `.partitions` в `_openPairs`/соседних хелперах), уже были частью
  оригинальной классификации #113 (видно по `targetSpaceModel`/`space.partitions` в diff'е — не
  новые изменения этого цикла); слитый код сам по себе использует новую optional-сигнатуру
  корректно там, где обращается к `_spaceModel()` (например, `_spaceModel()?.partitions` в коде,
  пришедшем из `dev`) — проверено чтением и не нарушено ни одним из трёх smoke по этим
  поверхностям.
- `docs/ARCHITECTURE.md`: баннер «Updated» корректно продвинут на дату ребейза, инвариант
  optional-space описан консистентно с кодом; `docs/TESTING.md` чек-лист ссылается на реальные
  smoke/unit/mutation имена, все они существуют и зелёные.
- Трейлеры на всех 5 коммитах диапазона: `Issue: #113`, `User-Visible: no` — включая новый
  `66fa8f4`. `node scripts/process-gate.mjs --issues` зелёный, 0 предупреждений.
- `tsconfig.test.json` и `docs/specs/README.md` — механические регистрации нового файла/записи,
  соответствуют содержимому.

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

- Полный браузерный набор смоков и `golden:verify` — обоснование в §2 (нулевой продуктовый diff
  относительно r1, узкий новый код цикла — одна строка в тестовом скрипте).
- `pytest tests_backend` — класс A/B бэкенда не тронут.
- Performance-профили — не названы в AC, hot path не тронут ни в r1, ни в этом цикле.
- Содержательный повторный аудит AC1–AC9 «с нуля» без опоры на r1 — не требуется: код, который они
  доказывают, не менялся байт в байт (проверено `git diff` между продуктовым кодом r1 и текущим
  деревом), поэтому это не «доверие прошлому вердикту», а подтверждённый факт отсутствия изменений
  в этой части.
- Medium-1/#184 (fallback-семантика ТЗ §6) — по-прежнему отдельный issue, не в скоупе этого
  код-ревью и не в скоупе #113.

## 8. Вердикт

Ребейз на `c1676cf` не изменил ни строки продуктового кода #113: единственная новая правка цикла —
восстановление мутационного якоря, сломанного переименованием переменной в результате мержа. Правка
проверена исполнением на способность ловить регрессию (не голословно), все фаст-гейты и релевантные
smoke зелёные на итоговом дереве, AC1–AC10 подтверждены заново (без изменений там, где код не
менялся, и напрямую — там, где менялся). High: 0. Medium: 0.

**Вердикт: зелёный · цикл r2/4 · High: 0 · Medium: 0 → нет · Документ: docs/reviews/CODE-REVIEW-113-r2.md**