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

# CODE-REVIEW-564-r2

**Issue:** #564 — «В узкой колонке нажатие достаётся соседнему маркеру: круг 44 px без разрешения перекрытий»
**Заход:** r2 (второй заход код-ревью; циклов ревью кода потрачено 1/4 — потрачены на жёлтый вердикт r1, зелёный вердикт бюджет не тратит, #227)
**Материал:** зафиксирован на точном SHA `032616f2237a8de5c5cbc2c125267a09902c2594`. Рабочая копия уже на нём; `git fetch`/`checkout` не выполнялись.

## Предыдущий раунд и дельта

Вердикт r1 (документ `docs/reviews/CODE-REVIEW-564-r1.md`, материал зафиксирован на SHA
`0af582daa56632736560df0bff6c78f778618c5a`) — **жёлтый**, единственная блокирующая находка
**M1 (Medium, в скоупе)**: AC2 требовал обязательным доказательством, помимо чистой unit-матрицы,
ещё и browser smoke для Icon/Text/Double/legacy capsule во всех четырёх направлениях; в диффе
r1 такого прогона не было — только синтетические прямоугольники (unit) и один реальный
браузерный прогон на обычных Icon-маркерах без direction-вариаций.

Дельта раунда: `git diff 0af582da..032616f2` — ровно один продуктовый коммит:

```
032616f2 test: покрыть реальные капсулы маркеров (#564)
```

(коммит `27126ad3` между ними — публикация документа ревью r1, не код). Диапазон
`origin/dev..HEAD` не менялся между раундами (`git merge-base origin/dev HEAD` = `a65c88bc`,
то же самое дерево `dev`, что и на r1) — ребейза не было, дельта локальна.

Изменённые файлы дельты:

```
demo/smoke_device_hit_capsules.mjs | 252 ++++++++++++++++++++++++++
docs/TESTING.md                    |  10 +-
scripts/mutation-registry.mjs      |  12 ++
```

Ни один файл дельты не лежит в `src/**` — `node scripts/smoke-select.mjs --base 0af582da --head
032616f2` подтверждает: «Исполняемого frontend-диффа нет… Browser-smoke этим диффом не
выбираются». Это ожидаемо: правка добавляет тест и мутанта, не трогая резолвер.

**Разбор этого раунда ограничен дельтой** (§2.10): полноценно перепроверено только то,
до чего дельта дотягивается — доказательство AC2 и связанный с ним мутационный виджет AC9.
Остальные AC (AC1, AC3–AC8, AC10, AC11) не имеют изменившегося доказательства в дельте и
наследуются из r1 (раздел ниже), кроме дешёвых гейтов, которые прогнаны заново, как требует
правило «дешёвые гейты — каждый раунд».

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **M1** (Medium, в скоупе) — AC2 не имел browser-smoke доказательства painted-priority для Icon/Text/Double/legacy capsule во всех четырёх направлениях | Новый `demo/smoke_device_hit_capsules.mjs`: рендерит реальные Icon (`static_icon`), Text (`display: value`), Double (`badge` + явный `value_badge`) и legacy (`badge` без `value_badge` → авто-производный двухзначный legacy-режим, `legacySupplementalMetrics` в `src/device-face.ts:35-48`) маркеры, по каждому — 4 кардинальных направления (`pos-right/bottom/left/top` для with-values типов, все 4 стороны painted core для Icon/Text). Соседа `hit-neighbour` кладёт раньше в DOM/index order и позиционирует так, что тестовая точка лежит строго в invisible 44 px floor соседа и вне его painted capsule, но внутри painted capsule цели. Проверяет одновременно `elementFromPoint` (нативный DOM hit-test), `_deviceHitOwnerAt` (семантический owner) и настоящий `page.mouse.click` с открытием info card. Плюс именованный мутант `dense-device-hit-browser-skips-painted-priority` (`scripts/mutation-registry.mjs`), который отключает `if (painted.length) return nearest(painted, point)` в `src/device-hit-owner.ts:77`. | Прогнано в этом раунде: `node demo/smoke_device_hit_capsules.mjs` → `{"realFaceKinds":true,"allSixteenCasesRan":true,"everyPaintedPointOwnsNativeAndSemanticHit":true,"everyPaintedPointOwnsClick":true}` / `OK`. `node scripts/mutation-gate.mjs --id=dense-device-hit-browser-skips-painted-priority` → «чистый прогон» зелёный, мутант «покраснел» → «поймано 1 из 1». `docs/TESTING.md:552-557` теперь называет обе строки доказательства AC2 явно. |

Других блокирующих находок в r1 не было (High: 0).

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

Документ: `docs/reviews/CODE-REVIEW-564-r1.md`, материал зафиксирован на SHA
`0af582daa56632736560df0bff6c78f778618c5a`. Принято без повторной проверки в этом раунде, потому
что дельта (`032616f2`) не касается их доказательств:

- **AC1** — J7 390/780 px, реальный click → dense1..dense5 (`demo/smoke_household_journeys.mjs`,
  не тронут дельтой);
- **AC3** — минимум 44×44 не уменьшен (`.dev::before` не изменён дельтой r2 по значению);
- **AC4** — латч владельца pointerdown→pointerup/cancel (`src/device-hit-owner.ts`,
  `test/device-hit-owner.test.mjs` — не тронуты дельтой);
- **AC5** — hover/tooltip у ближайшего owner, touch/pen без ложного mouse-hover;
- **AC6** — pinch/#563-совместимость (`src/touch-gesture-click-guard.ts` не тронут);
- **AC7** — детерминированный tie-break, изоляция карточек, фильтр hidden/removed/other-space;
- **AC8** — отсутствие per-frame layout scan, кэш с инвалидацией по контракту;
- **AC10** — typecheck/unit/build в цикле реализации, smoke/golden/perf — до беты;
- **AC11** — схема/координаты/action settings/i18n/backend API не менялись;
- трейлеры и changelog пяти коммитов диапазона `origin/dev..0af582da`;
- `check-docs`, `no-new-any`, байтовая идентичность бандла и скриншотов на момент r1.

Два из трёх именованных мутантов AC9, унаследованных из r1 (`dense-device-hit-falls-back-to-input-order`,
`device-touch-hover-gate-removed`, `zigbee-topology-hovered-endpoint-elevation-removed`), не
изменены дельтой — тем не менее перепроверены заново в этом раунде вместе с дешёвыми гейтами
(см. ниже), а не приняты слепо, поскольку это стоит недорого и дельта физически меняет тот же
файл `scripts/mutation-registry.mjs`, в который они прописаны.

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

Дешёвые гейты — гоняются в каждом раунде независимо от дельты:

| Гейт | Команда | Результат |
|---|---|---|
| Typecheck | `npx tsc --noEmit` | зелёный |
| Build + синхронизация трёх копий бандла | `npm run bundle:sync` (запускает `build`), затем `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` и `cmp … demo/srv/assets/houseplan-card.js` | зелёный, все три копии побайтово идентичны; `git status` после — чисто, новых diff'ов не осталось |
| `node scripts/no-new-any.mjs --base 0af582da --head 032616f2` | ручной прогон | «Новых any нет» (0 добавленных строк в `src/**/*.ts` — дельта не трогает `src/**`) |
| `node scripts/check-docs.mjs` | ручной прогон | `Documentation checks passed (7 files, 12 external links)` |
| `npm test` (2691 unit) | **не перегонялся** | подтверждён зелёным Validate на точном SHA `032616f2` (см. ниже) — правило «дешёвые гейты не перегонять, если Validate зелёный на этом SHA» |

CI Validate на точном SHA подтверждён напрямую, не только по ссылке автора:
`gh run view 34794194982` → `{"conclusion":"success","headSha":"032616f2237a8de5c5cbc2c125267a09902c2594","name":"Проверка (CI)","status":"completed"}`.
https://github.com/Matysh/houseplan-card/actions/runs/34794194982

Гейты по дельте (M1/AC2/AC9):

| Гейт | Команда | Результат |
|---|---|---|
| Новый browser smoke | `node demo/smoke_device_hit_capsules.mjs` | зелёный, все 16 случаев (`allSixteenCasesRan`), painted-приоритет и click подтверждены |
| Новый мутант | `node scripts/mutation-gate.mjs --id=dense-device-hit-browser-skips-painted-priority` | «поймано 1 из 1» |
| Унаследованные мутанты AC9, перепроверены т.к. общий файл реестра изменён | `node scripts/mutation-gate.mjs --id=dense-device-hit-falls-back-to-input-order` / `--id=device-touch-hover-gate-removed` / `--id=zigbee-topology-hovered-endpoint-elevation-removed` | все три — «поймано 1 из 1» |
| `smoke-select` по дельте | `node scripts/smoke-select.mjs --base 0af582da --head 032616f2` | «Исполняемого frontend-диффа нет… Browser-smoke этим диффом не выбираются» — корректно, дельта не трогает `src/**` |
| Трейлеры/changelog коммита дельты | `git show -s --format=full 032616f2` | `Issue: #564`, `User-Visible: no` — оба класс-B файла (`demo/**`, `scripts/**`) плюс `docs/TESTING.md`; changelog не требовался и не тронут (`git diff 0af582da..032616f2 -- docs/CHANGELOG.md docs/CHANGELOG.ru.md` пуст) |

**Не прогонялись в этом раунде** (осознанно): `golden:verify`, полный `performance_smoke`,
`pytest tests_backend`, полный набор из 248+ смоков и 15 смоков, выбранных под r1 (household
journeys, drag/modes/align/history/grid-snap/pan-zoom/static-icon/wireless-parity/touch-
tips/feedback/room-tooltip/room-fit, linked-light) — они уже прогнаны в r1 на SHA `0af582da`,
дельта их файлы не трогает, и `smoke-select` по дельте не выбрал ни одного из них. По AC10/ТЗ
§10 golden/perf/pytest остаются пред-релизным гейтом.

## Находки

Новых находок нет. High: 0, Medium: 0.

## Проверено и корректно

- **AC2 закрыт полностью**: painted core/capsule реально выигрывает у невидимого floor соседа
  для всех четырёх типов лица маркера (Icon/Text/Double/legacy) и всех четырёх направлений
  капсулы, подтверждено настоящим DOM (`getBoundingClientRect`, `elementFromPoint`) и настоящим
  кликом мыши, не только семантическим резолвером. Отображение типов в `demo/smoke_device_hit_
  capsules.mjs` сверено с реальной логикой `renderDeviceFace` (`src/device-face.ts:92-101`,
  `legacySupplementalMetrics` строки 35-48) — `badge.configured !== false` действительно даёт
  auto-derived двухзначный `with-legacy` путь, что подтверждает `setup.realFaceKinds: true` в
  выводе смока.
- Мутант `dense-device-hit-browser-skips-painted-priority` бьёт именно по строке приоритета
  painted-областей (`src/device-hit-owner.ts:77`, `if (painted.length) return nearest(painted,
  point)` → `if (false && painted.length) …`) и красит новый смок, не другие тесты — точечность
  подтверждена независимым прогоном.
- Дешёвые гейты (typecheck, build+3 копии бандла, no-new-any, check-docs) — зелёные при
  собственном прогоне на этом SHA; unit-набор из 2691 теста подтверждён зелёным Validate на
  точном SHA, факт green-конклюжна проверен напрямую через `gh run view`, а не только со слов
  автора.
- Трейлеры и класс изменённых файлов корректны: `demo/**`, `scripts/**`, `docs/TESTING.md` —
  класс B/C, `Issue: #564` присутствует, `User-Visible: no` оправдан (тестовая инфраструктура,
  без изменения поведения) и changelog не требовался.
- Дельта не расширяет scope и не трогает `src/**`, `custom_components/**`, схему конфигурации,
  координаты маркеров или action-контракты — согласовано с ТЗ §4 «Не входит в задачу».

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

- `npm test` целиком не перегонялся — заменён подтверждённым зелёным Validate на точном SHA
  `032616f2` (см. таблицу выше), что соответствует явному разрешению для этой задачи: дешёвые
  гейты не дублируются, если green Validate уже назван на этом SHA.
- Golden-эталоны, полный `performance_smoke`, `pytest tests_backend`, полный набор browser-
  смоков и 15 смоков r1 — не гонялись повторно: делта их не касается (`smoke-select` подтверждает
  «выбирать нечего»), а по ТЗ §10/AC10 golden и perf в любом случае пред-релизные гейты.
- Кросс-браузерное поведение `click instanceof PointerEvent` (риск, отмеченный в r1 как контекст,
  не находка) — не переисследовалось, дельта его не касается.
- Ручного тестирования в браузере поверх automated smoke не проводилось — весь браузерный
  прогон в этом раунде выполнен через `demo/smoke_device_hit_capsules.mjs` (Playwright/Chromium),
  что и есть требуемое AC2 browser-доказательство.

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

- Ветка: `issue/564-dense-marker-hit` (по комментариям issue); рабочая копия — detached HEAD на
  `032616f2237a8de5c5cbc2c125267a09902c2594`.
- `git rev-parse HEAD` = `032616f2237a8de5c5cbc2c125267a09902c2594`.
- `git merge-base origin/dev HEAD` = `a65c88bc11db09c65afe1d59ab1c51fdd01a6f30` — то же дерево
  `dev`, что и на r1; ребейза между раундами не было.
- Материал r1 для сравнения: SHA `0af582daa56632736560df0bff6c78f778618c5a`, документ
  `docs/reviews/CODE-REVIEW-564-r1.md`.

## Вердикт

Зелёный. Единственная блокирующая находка r1 (M1) закрыта исполняемым browser-smoke и именованным
мутантом, оба перепроверены в этом раунде и умеют падать. Новых находок нет, High: 0, Medium: 0.
Дешёвые гейты зелёные (частично перепрогнаны вручную, частично подтверждены Validate на точном
SHA). Issue готова к переходу в `S8-merged` по завершении промоушена.

---

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

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

- Ветка: `issue/564-dense-marker-hit`, коммит `032616f2237a` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `621d422b3a6cfc589a8659e8c6e9dc55c94b6b13`
  ```
  git log --all --format='%H %T' | grep 621d422b3a6c
  ```
- Тело issue: `f958e178616c6d48277f99106f9d84e76de72762c0c7b3e6f315231ff1cfec08`
- Вердикт конвейера: `green` · High 0