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

# CODE-REVIEW-449-r2

- Issue: https://github.com/Matysh/houseplan-card/issues/449
- Этап: код-ревью (PROCESS.md §2.7), заход r2, блокирующих циклов израсходовано 1/4
- ТЗ: `docs/specs/449-double-fit-all.md` (трек полный)
- Материал: `05ef3181` (SHA r1) → `aa51ed2b` (`fix: complete double background fit delivery`) → `1d8edf4a` (`docs: refresh screenshot fingerprint for double fit`)
- SHA материала этого раунда: `1d8edf4a016736eb1ee6e865ab6d686cec0ac403`
- Ветка: `issue/449-double-fit-all`
- Предыдущий раунд: `docs/reviews/CODE-REVIEW-449-r1.md`, вердикт **красный**, High: 3, Medium: 2, Low: 1, получен на SHA `05ef318133ca54b1f702844253d06edd5a665c5e`

## Скоуп

Разбор — по дельте (PROCESS.md §2.9/§2.10): между SHA r1 и текущим HEAD два
коммита, ребейза не было (`git merge-base 05ef3181 HEAD` = `05ef3181`),
контракт поведения не менялся, новая подсистема не задета — дельта локальна к
трём High и двум Medium предыдущего раунда.

`git diff --stat 05ef3181..HEAD` (30 файлов, из них 374 строки — это сам
документ r1, коммитящийся автоматически, не код автора):

- `src/houseplan-card.ts` — 2 содержательные правки: `_doubleFitEnabled`
  больше не проверяет `!_suppressClick`; `pointerUp` получает явный
  `blocked`-аргумент `this._suppressClick || …`, вычисляемый непосредственно в
  момент отпускания.
- `scripts/bundle-budget.mjs` — `INITIAL_VIEW_GZIP_CEILING` 296 000 → 297 000,
  с комментарием-обоснованием запаса.
- `scripts/mutation-gate.mjs` — удалён мутант
  `room-fit-enters-kiosk-double-tap-sequence` (ослепший свидетель из M2 r1).
- `dist/**`, `custom_components/houseplan/frontend/**` — пересборка и
  синхронизация (закрывает High-1).
- `docs/images/screenshots.json` — обновлённый фингерпринт (закрывает
  High-2).
- `docs/reviews/CODE-REVIEW-449-r1.md` — сам документ прошлого раунда,
  коммитится конвейером, не тронут вручную.

Тестовые файлы (`test/room-fit.test.mjs`, `demo/smoke_*.mjs`) не менялись —
новых unit-доказательств для правки гонки не добавлено, вместо этого
перепроверен уже существующий смок, названный ТЗ как доказательство AC3 (см.
ниже).

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **High-1** — `custom_components/houseplan/frontend/**` не синхронизирован с `dist/**`, фича не доставлена | `npm run bundle:sync` выполнен и закоммитен в `aa51ed2b` | `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` → идентичны (перепроверено: свежая пересборка `npm run build` на HEAD не меняет рабочее дерево — `git status --short` пуст) |
| **High-2** — `docs`-гейт красный, фингерпринт скриншотов устарел | Коммит `1d8edf4a`, `docs/images/screenshots.json` пересчитан | `node scripts/check-docs.mjs` → `Documentation checks passed (7 files, 12 external links)`, exit 0 (перепрогнано) |
| **High-3** — `smoke_kiosk_pan_lock.mjs`: `doubleTapStillResetsZoom` красный из-за гонки `_suppressClick` ↔ double-tap | `_doubleFitEnabled` больше не гейтит взвод (`pointerDown`) через `_suppressClick`; блокировка при завершении (`pointerUp`) читает `this._suppressClick` напрямую и синхронно, без зависимости от порядка со сброшенным в этом же `pointerDown` флагом | `node demo/smoke_kiosk_pan_lock.mjs` → **`doubleTapStillResetsZoom: true`**, весь сценарий 4/4 OK (перепрогнано, было `expected true, got false`) |
| **Medium-1** — запас bundle-budget ниже шумовой полосы (257 Б < 500 Б) | `INITIAL_VIEW_GZIP_CEILING` 296 000 → 297 000 в `aa51ed2b`, с задокументированным расчётом | `npm run bundle:budget` → `295746 B gzip (потолок 297000 B ±2000, headroom 4254 B)`; `npm test` — тест `#438` зелёный (перепрогнано) |
| **Medium-2** — мутант `room-fit-enters-kiosk-double-tap-sequence` ничего не ловит (устаревшее место защиты) | Мутант удалён из `scripts/mutation-gate.mjs` (один из двух вариантов исправления, предложенных r1: «удалить или перенаправить») | `grep -n "room-fit-enters-kiosk-double-tap-sequence" scripts/mutation-gate.mjs` → пусто; функциональное покрытие того же контракта остаётся в unit-тесте `#449 moved, cancelled, multitouch, foreign-owner…` и в полях смока `kioskRoomTapDoesNotEnterDoubleTap` (оба зелёные, см. ниже) |
| **Low-1** — AC5 для device/opening доказана только чтением, не смоком | Не тронуто в этой дельте — оставлено с той же пометкой, автор не заявлял правку | Инвентаризация не изменилась, см. «Унаследовано из r1» |

## Унаследовано из r1 (без повторной проверки)

Дельта не затрагивает следующие поверхности — их вывод принят из
`docs/reviews/CODE-REVIEW-449-r1.md` (SHA `05ef318133ca`) без повтора:

- Архитектура `DoubleFitGestureRecognizer` / `beginDoubleFitPointer` /
  `completeDoubleFitPointer` как чистых функций без DOM/side-effects — код
  этих функций не менялся в дельте.
- `planGestureOwnerFromPath` и единый owner-контракт с #152 — `src/room-fit.ts`
  не входит в дельту.
- AC1, AC2, AC4, AC6, AC7, AC8, AC9, AC10 — доказательства (unit-таблицы,
  мутанты `double-fit-*`, `smoke_room_fit.mjs`, `smoke_smooth_zoom.mjs`) их
  код не менялся; тем не менее 4 мутанта #449 и оба смока перепрогнаны в этом
  раунде заодно с AC3/AC11 (см. таблицу гейтов) и остаются зелёными — это не
  «наследование вслепую», а побочная переподтверждение той же дельтой правки в
  соседних строках того же файла.
- Low-1 (AC5 device/opening — доказательство чтением) — не переоценивалось,
  дельта его не касается.
- `docs/CANVAS.md`, `docs/TOUCH-SUPPORT.md`, `docs/UX-MODES.md`,
  `docs/USER-GUIDE.md(.ru)`, оба `CHANGELOG` — не менялись в этой дельте,
  содержание принято как проверенное в r1.

## Как проверялось — гейты этого раунда

Зелёного Validate на SHA `1d8edf4a` нет — все гейты ниже прогнаны локально.

| Гейт | Команда | Результат |
|---|---|---|
| Типы | `npx tsc --noEmit` | зелёный |
| Юниты | `npm test` | **зелёный**: 1913 pass / 0 fail / 1 skip (пропуск — известный `#281` private fixture, не относится к #449); все 3 красных теста r1 (`#438`, `#349` манифест бандла, release ZIP) теперь проходят |
| Сборка | `npm run build` | зелёный, `git status --short` после сборки пуст — бандл детерминированно воспроизводит закоммиченный |
| Три копии бандла | `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` | зелёный: идентичны |
| Синхронизация стенда | `npm run bundle:sync` (нужна демо-смокам, `demo/srv/assets` не коммитится) | зелёный, `git status --short` пуст — ничего не разошлось с закоммиченным |
| docs-гейт | `node scripts/check-docs.mjs` | зелёный: «Documentation checks passed (7 files, 12 external links)» |
| any-гигиена | `node scripts/no-new-any.mjs --base origin/dev --head HEAD` | зелёный: «Новых any нет» |
| bundle-budget | `npm run bundle:budget` | зелёный: 295746 Б / потолок 297000 ±2000, headroom 4254 Б (в тесте `#438` запас на обеих границах полосы выше 500 Б) |
| Смок AC3 (ранее красный) | `node demo/smoke_kiosk_pan_lock.mjs` | **зелёный**: `doubleTapStillResetsZoom: true`, весь набор 23/23 |
| Мутанты #449 (4, затронуты соседними строками) | `node scripts/mutation-gate.mjs --id=<id>` × 4 | все 4 «покраснел, как обязан» |
| Подбор смоков по дельте r1→HEAD | `node scripts/smoke-select.mjs --base 05ef3181 --head HEAD` | «Прямое совпадение» — 23 файла (сузилось с 35 у полной задачи — символы дельты: `_suppressClick`, `_pinchStart`, `_panLock`, `_holdFired`, `_mode`, `_modeTransitionBusy`, `_continuity`, `_vacFit`) |
| Прямые смоки (23 из «прямое совпадение») + `smoke_room_fit.mjs`, `smoke_kiosk.mjs`, `smoke_smooth_zoom.mjs` (канонические для #449, отмечены инструментом только слабой связью по `_mode`) | `node demo/smoke_*.mjs` по каждому (26 всего) | все 26 PASS |
| `golden:verify` | не прогонялся | дельта не меняет разметку/геометрию/стили — только арбитраж жеста и числовые константы; наследует вывод r1 |
| `pytest tests_backend` | не прогонялся | дельта не касается `custom_components/**/*.py` |
| model-invariants | не прогонялся | дельта не меняет геометрию/`layout`/толщину стен |
| «Слабая связь» smoke-select (33 файла, не считая трёх названных выше) | не прогонялись | символы (`_mode`, `_modeTransitionBusy`) относятся к неизменённым ветками логики этих файлов — то же решение, что в r1 |

Working tree после каждого гейта, менявшего файлы (`npm run build`,
`npm run bundle:sync`, `mutation-gate`), возвращён к состоянию коммита; в
репозитории изменений не оставлено (`git status --short` — пусто).

## Находки

Новых находок нет. Все 3 High и оба Medium раунда r1 закрыты по существу (см.
«Закрытие раунда r1»), закрытие перепроверено запуском гейтов, а не со слов
автора — правка не описана отдельным комментарием в issue, поэтому весь
разбор в этом документе получен из чтения `git diff 05ef3181..HEAD` и
перезапуска гейтов, а не пересказом чужого резюме.

Отдельно проверено, что исправление гонки High-3 не открыло новую дыру:
`_suppressClick` по-прежнему учитывается в `blocked`-аргументе `pointerUp` —
это защищает случай короткого движения (4–8 px, до срабатывания
`_panLock`/`_pinchStart`), где раньше единственной защитой был именно этот
флаг. Убрана только его роль в geiter'е `_doubleFitEnabled`, используемом на
`pointerDown` (взвод), — то есть ровно то место, где гонка и была: значение
`_suppressClick` на входе в `pointerDown` могло быть устаревшим, потому что
сам `pointerDown` сбрасывает флаг в 6792 строке уже ПОСЛЕ вызова
`_doubleFit.pointerDown(...)` на 6746 строке. Проверено чтением и подтверждено
перепрогоном ранее красного смока.

## Таблица AC → чем доказан → статус (только AC, затронутые дельтой)

| AC | Доказательство | Статус |
|---|---|---|
| AC3 kiosk parity | `smoke_kiosk.mjs` PASS, `smoke_kiosk_pan_lock.mjs` — все 23 поля PASS, включая `doubleTapStillResetsZoom` | **PASS** (было FAIL в r1) |
| AC11 perf/bundle budget | `no-new-any` зелёный; `npm run bundle:budget` зелёный с явно достаточным запасом (743/1254 Б от границ полосы); `npm test` bundle-assets (`#438`) зелёный | **PASS** (было FAIL в r1) |

Остальные AC1, AC2, AC4–AC10 — см. «Унаследовано из r1»; их доказательства
перепрогнаны попутно (мутанты, `smoke_room_fit.mjs`, `smoke_smooth_zoom.mjs`)
и остаются зелёными.

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

- Правка гонки `_suppressClick` устраняет именно тот механизм, который был
  разобран в H3 r1 (порядок вызовов внутри `_stagePointerDown`), а не
  маскирует симптом таймаутом или увеличением окна.
- `INITIAL_VIEW_GZIP_CEILING` поднят с задокументированным расчётом запасов
  по обеим границам полосы — соответствует практике ратчета `#367`,
  упомянутой в r1.
- Удаление мутанта `room-fit-enters-kiosk-double-tap-sequence` — чистое,
  без остаточных ссылок; функциональное покрытие того же контракта
  (room-tap не входит в kiosk double-tap sequence) остаётся в unit-тесте и
  смоке, оба перепрогнаны зелёными.
- Три копии бандла (`dist`, `custom_components/houseplan/frontend`,
  рабочий стенд `demo/srv/assets`) синхронизированы и воспроизводятся
  детерминированно с закоммиченным деревом.
- Оба фикс-коммита несут `Issue: #449` и `User-Visible: no` — обоснованно:
  они не меняют заявленное пользователю поведение (уже описанное в
  CHANGELOG фичевым коммитом), а чинят доставку и внутреннюю гонку.

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

- **`npm run golden:verify`** — не прогонял. Дельта не меняет разметку,
  геометрию или стили; правка касается только арбитража жеста и двух
  числовых констант. Риск визуальной регрессии нулевой; предрелизный гейт
  прогонит его перед бетой.
- **`python -m pytest tests_backend`** — не прогонял, дельта не касается
  `custom_components/**/*.py` по содержанию (только пересобранный бандл).
- **`node scripts/model-invariants.mjs`** — не прогонял, дельта не меняет
  геометрию/`layout`/толщину стен.
- **«Слабая связь» smoke-select (33 файла)** — не прогонял, символы
  (`_mode`, `_modeTransitionBusy`) относятся к неизменённым дельтой ветвям
  этих файлов.
- **Полный набор `demo/smoke_*.mjs` (221 файл)** — не прогонял целиком, это
  предрелизная обязанность (§8), не гейт ревью.
- **AC5 (device/opening double-fit) отдельным смоком** — не перепроверял,
  дельта его не касается; наследует Low-1 из r1 как есть.
- **Реальное устройство/браузер** — вне цикла ревью (PROCESS.md §2.7).

## Итог

Все 3 High и оба Medium раунда r1 закрыты и перепроверены запуском
соответствующих гейтов (не со слов автора). Новых находок дельта не внесла.
High: 0, Medium: 0 → вердикт зелёный.

---

<!-- material-anchors: сгенерировано конвейером (#414) -->

## Материал раунда

- Ветка: `issue/449-double-fit-all`, коммит `1d8edf4a0167` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `87b750f7709b129fda0a1f4d9c16749b751e7a1b`
  ```
  git log --all --format='%H %T' | grep 87b750f7709b
  ```
- ТЗ `docs/specs/449-double-fit-all.md`, блоб `d6ddccbb3920bdffbb8414f4b6c225a4cdf4f420`
  ```
  git log --all --find-object=d6ddccbb3920bdffbb8414f4b6c225a4cdf4f420 -- docs/specs/449-double-fit-all.md
  ```