houseplan-card/docs/reviews/CODE-REVIEW-520-r3.md

# CODE-REVIEW-520-r3

Issue: #520 · Этап: code · Заход: r3 · Материал: `a325294d7a9d8ef4ecfeab2ed3e248318a650ab5`
Вердикт: **зелёный** · High: 0 · Medium: 0

## Скоуп

Третий заход код-ревью после жёлтого r2 (`docs/reviews/CODE-REVIEW-520-r2.md`,
единственная находка Medium-1: `node scripts/check-docs.mjs` красный на материале
ревью — диф трогает `src/houseplan-card.ts` и `src/config-adoption.ts`, что
инвалидирует отпечаток скриншотов документации, а ветка не привезла свой коммит
обновления).

Дельта r2→r3 — ровно один коммит правки `a325294d` поверх материала r2
(`462b5645`) плюс публикационный коммит документа r2 (`3066fec1`, без кода):

```
$ git diff --stat 462b5645..a325294d
 docs/images/screenshots.json       |  24 +--
 docs/reviews/CODE-REVIEW-520-r2.md | 358 +++++++++
 2 files changed, 370 insertions(+), 12 deletions(-)
```

Дельта **локальна** в смысле §2.9/§2.10: только `docs/images/screenshots.json`
(класс C, отпечаток + 11 `sourceSha256`), ни одного файла класса A/B, `dist/**`
и `custom_components/houseplan/frontend/**` не тронуты, продуктовый код между
r2 и r3 не менялся вовсе (`git diff 462b5645..a325294d -- src test scripts
custom_components` — пусто). Разбор в этом раунде сужен до дельты и до находки
r2 — остальное наследуется из r2 без повторной проверки (раздел ниже).

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

1. Найден вердикт предыдущего раунда (комментарий issue #11, 2026-09-10
   17:47:34) и материал, на котором он получен: `462b56453cd6948c083e62ad8c92ec29aeb022b2`,
   зафиксирован в `docs/reviews/CODE-REVIEW-520-r2.md` блоком «Материал раунда».
   `git diff 462b5645..a325294d` — предмет этого раунда (см. «Скоуп»).
2. По единственной находке r2 показано, чем именно она закрыта — не заявлением
   автора: `git diff 462b5645..a325294d -- docs/images/screenshots.json`
   меняет ровно `sourceFingerprint` и 11 полей `sourceSha256`
   (`ccbbfb4e5aa1… → c615d58061456…`), ни один `imageSha256` не изменился —
   то есть ни один PNG не поменялся, менялся только отпечаток источников.
   Прогнал сам:
   ```
   $ node scripts/check-docs.mjs
   Documentation checks passed (7 files, 12 external links).
   ```
   Красный до фикса зафиксирован в документе r2 буквальным выводом той же
   команды («ERROR screenshot source fingerprint is stale…») — «умеет падать»
   доказано предыдущим раундом, здесь показан переход в зелёное на исправленном
   материале.
3. Трейлеры коммита `a325294d`: `Issue: #520`, `User-Visible: no` — корректно,
   диф не меняет ничего, что видит пользователь дома (только служебный
   отпечаток документации); changelog не тронут — соответствует.
4. `dist/**` и `custom_components/houseplan/frontend/**` не входят в диф этого
   коммита (`git show --stat a325294d`) — ожидаемо для чисто документационной
   правки; сверил, что три копии бандла всё ещё совпадают побайтово:
   `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js`
   — молча (совпадают).
5. `node scripts/process-gate.mjs` на диапазоне `origin/dev..HEAD` — «гейт
   пройден, предупреждений 2» (те же WARN про `node_modules` вне классов
   A/B/C/D на исторических коммитах `37ef970d`/`e181b08f`, уже закрыты и
   разобраны в r1/r2 как гигиена ветки, не влияющая на финальное дерево).
6. Дешёвые гейты (`typecheck`, `npm test`, `npm run build` со сверкой копий
   бандла) на точном материале `a325294d` подтверждены зелёным Validate:
   https://github.com/Matysh/houseplan-card/actions/runs/34513504274
   (`headSha` сверен через `gh run view --json headSha` — совпадает с
   материалом раунда). Не перегонял третьей парой глаз — принято по инструкции
   ревью, это не новый код с прошлого раунда (продуктовый код между r2 и r3
   не менялся).
7. **Тело issue менялось повторно после r2.** Ревью r2 уже зафиксировало
   расхождение с записанным хешем SPEC-REVIEW-520-r3 (#517: `60492a3aec5f…`
   против тогдашнего `4524f04412...`). Между вердиктом r2 (17:47:34) и
   материалом r3 тело изменилось **ещё раз** — автор сам называет это в
   хендоффе (комментарий issue #12): добавлены AC7 и пункт риска про отпечаток
   скриншотов, по прямому требованию находки Medium-1 r2. Текущий хеш тела:
   `sha256sum` по тексту, полученному `gh issue view 520 --json body -q .body`
   → `f318b25f5815fa66aeaa7cbc5ce1d63e23fab0a8e50493962634b01e0ca86e96` —
   отличается от обоих предыдущих записанных значений. Сверено построчно:
   правка аддитивна — AC1–AC6, «Причина», «Контракт», «Риски» (кроме одного
   нового пункта) не тронуты; новый AC7 («`check-docs` зелёный на материале
   ревью») и новый риск-пункт об отпечатке скриншотов дословно описывают
   именно то, что закрывает коммит `a325294d`, и ничего сверх этого. Новых
   продуктовых развилок текст не вводит, `User-Visible: no` не меняется.
   Возврата в `S4-spec-review` не требую — та же логика, что применил r2 к
   первому расхождению (дисциплинированное обновление ТЗ вслед за находкой
   кода, не смена скоупа).

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

| Находка r2 | Чем закрыта | Где это видно |
|---|---|---|
| Medium-1 — `node scripts/check-docs.mjs` красный на материале ревью: отпечаток скриншотов документации устарел (диф трогает `src/houseplan-card.ts`, `src/config-adoption.ts`) | Коммит `a325294d`: отпечаток обновлён через `npm run docs:accept -- --identical` (#512) — все 11 кадров пересняты и совпали с закоммиченными побайтово (ни один `imageSha256` не изменился), обновился только `sourceFingerprint` и 11 `sourceSha256` | Прогнал `node scripts/check-docs.mjs` на материале `a325294d` сам — «Documentation checks passed (7 files, 12 external links)»; `git diff 462b5645..a325294d -- docs/images/screenshots.json` показывает ровно 12 изменённых полей, ноль изменённых `imageSha256` |

Находка r2 закрыта полностью и минимально — правка не расширилась за пределы
её предмета.

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

Продуктовый код между материалом r2 (`462b5645`) и материалом r3 (`a325294d`)
не менялся — дельта чисто документационная (см. «Скоуп»), поэтому из
`docs/reviews/CODE-REVIEW-520-r2.md` наследуется всё содержательное:

- **Находка r1 (High) и её закрытие.** Механизм регрессии (микрозадача после
  `await` в `adoptAuthoritativeGated`, а не Lit `wrapped`) и хук `afterAdopt` —
  r2 перепроверил независимым измерением на изолированном `git worktree`
  (база `a44fbd37` vs `462b5645`), оба профиля (`interaction`, `isometric`),
  `benchmark:compare` — все строки бюджета зелёные. Код с тех пор не менялся,
  повторное измерение в этом раунде избыточно.
- **AC1, AC2, AC6** — тесты и все четыре мутанта (`adoption-bodies-declared-reactive`,
  `adoption-notifies-no-host-on-config-replacement`, `adoption-tail-defers-caller-hook`,
  `authoritative-load-seeds-devices-after-the-await`) перепрогнаны r2 лично,
  «поймано 1 из 1» каждый; код, которого это касается, в дельте r2→r3
  отсутствует.
- **AC3, AC4, AC5** — измерены r2 независимо (не на слово автора): 18 циклов /
  3 сборки / 3 эпохи на обоих деревьях и обоих профилях, `benchmark:compare`
  — 0 красных строк, `cache.entries.cleanFloor` 100 (interaction) / 60
  (isometric). Перф-путь этой дельтой не задет.
- **Бюджет бандла** (потолок 300 300 → 300 400, +40 Б) и `test/bundle-assets.test.mjs`
  (26/26 pass) — не тронуты дельтой.
- **17 из 17 «прямых совпадений» `smoke-select`** плюс 3 названных автором
  сверх выборки — прогнаны r2 лично, все `OK`; исходный код, который они
  проверяют, в этой дельте не менялся.
- **Гигиена ветки** (симлинк `node_modules`, исправление `.gitignore`) —
  зафиксирована в r1, не менялась.
- **Первое расхождение тела issue с хешем SPEC-REVIEW-520-r3** (#517) —
  разобрано r2, решение «возврата в spec не требую» подтверждено тем же
  рассуждением и в этом раунде (см. п.7 «Как проверялось» — уже про второе,
  новое расхождение).
- **Откат** — «один revert» из ТЗ технически устарел (теперь три файла, не
  один), это отмечено уже r2 как факт вне AC; не предмет этого раунда.

Материал: `docs/reviews/CODE-REVIEW-520-r2.md`, SHA `462b56453cd6948c083e62ad8c92ec29aeb022b2`.

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

- **AC7** (новый в теле issue, добавлен вслед за находкой Medium-1 r2) —
  `node scripts/check-docs.mjs` зелёный на материале `a325294d`, прогнан
  лично: «Documentation checks passed (7 files, 12 external links)».
  «Чем краснеет» — устаревший `sourceFingerprint`, продемонстрировано самим
  переходом красный (документ r2) → зелёный (этот документ) на одном и том же
  коде отпечатка.
- Ни один `imageSha256` не изменился в диффе r2→r3 — визуальный контент
  скриншотов не менялся, обновление чисто механическое (отпечаток источников).
- Три копии бандла (`dist/houseplan-card.js`,
  `custom_components/houseplan/frontend/houseplan-card.js`, стендовая не
  коммитится) совпадают побайтово — сверено `cmp`.
- Трейлеры `a325294d` — `Issue: #520`, `User-Visible: no`, корректно для
  чисто документационной правки.
- `node scripts/process-gate.mjs` — гейт пройден, предупреждения те же, что
  и в r1/r2 (гигиена исторических коммитов, не влияет на финальное дерево).
- Validate зелёный на точном материале раунда (`headSha` сверен явно, не
  принят на слово) — typecheck/test/build подтверждены этим прогоном.
- Второе расхождение тела issue с записанным хешем ревью ТЗ — названо,
  разобрано построчно (аддитивно, соответствует коммиту `a325294d`), решение
  «без возврата в spec» обосновано.

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

- **`npx tsc --noEmit`, `npm test` (весь набор), `npm run build` третьим
  прогоном** — Validate зелёный на точном материале `a325294d`
  (headSha сверен), продуктовый код между r2 и r3 не менялся; перегон дал бы
  тот же результат, что уже подтверждён r2 и Validate.
- **Полное измерение перф-профилей (`benchmark:compare`)** — не перегонял: код
  пути загрузки не менялся между r2 и r3, r2 уже воспроизвёл результат
  независимо на изолированном `git worktree`, эта дельта его не касается.
- **Смоки `demo/smoke_*.mjs`** — не перегонял ни одного: диф r2→r3 не
  затрагивает `src/**`/`demo/**`, `smoke-select` на этой дельте не даёт ни
  одного совпадения (проверил: диф ограничен `docs/**`, инструмент по
  символам кода не находит кандидатов).
- **`npm run golden:verify`** — не запускал: диф не меняет рендер ни байтом,
  визуальная приёмка `--identical` уже доказала попиксельное совпадение всех
  11 кадров с закоммиченными PNG.
- **`npm run invariants`, `python -m pytest tests_backend`** — geometry и
  Python-бэкенд этой дельтой не затронуты (не были затронуты и всей веткой,
  подтверждено r2).

## Гейты: что прогнал сам и почему

| Гейт | Прогнан | Результат |
|---|---|---|
| `node scripts/check-docs.mjs` | да (предмет находки r2, обязателен) | зелёный: «Documentation checks passed (7 files, 12 external links)» |
| `git diff 462b5645..a325294d` (полный, не только имена файлов) | да | 2 файла: отпечаток + публикационный документ r2 |
| `cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` | да | совпадают побайтово |
| `node scripts/process-gate.mjs` | да | пройден, 2 предупреждения (унаследованы, не новые) |
| `gh run view 34513504274 --json headSha,conclusion` | да | `headSha` = материал раунда, `conclusion: success` |
| `sha256sum` тела issue | да | отличается от обеих предыдущих записей — находка по #517, разобрана в тексте (не блокирует) |
| `npx tsc --noEmit`, `npm test`, `npm run build` (свежий прогон) | нет | Validate зелёный на точном SHA, продуктовый код с r2 не менялся |
| Perf `benchmark:compare` (оба профиля) | нет | код пути загрузки не менялся с r2, где уже измерено независимо |
| `demo/smoke_*.mjs` | нет | дельта не касается `src/**`/`demo/**`, кандидатов ноль |
| `npm run golden:verify` | нет | визуальный контент не менялся, доказано `--identical` |
| `npm run invariants`, `pytest tests_backend` | нет | geometry/backend вне диапазона всей ветки |

## Вердикт

Зелёный. High: 0, Medium: 0. Единственная находка r2 (Medium-1, `check-docs`
красный из-за устаревшего отпечатка скриншотов) закрыта минимальной и точной
правкой — один файл, только отпечаток, ни одного изменённого PNG; перепроверено
прямым прогоном гейта на материале раунда, не на слово автора. Продуктовый код
не менялся с r2, чья находка High (регрессия первого кадра) и все AC1–AC6 уже
были независимо перепроверены измерением и остаются в силе. Новое, второе
расхождение тела issue с зафиксированным хешем ревью ТЗ (#517) названо и
разобрано — аддитивно, соответствует коду, возврата в spec не требует. Задача
готова к пре-релизной очереди.

---

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

- Ветка: `issue/520-first-frame`, коммит `a325294d7a9d8ef4ecfeab2ed3e248318a650ab5`.
- Родитель материала r2: `462b56453cd6948c083e62ad8c92ec29aeb022b2` (`docs/reviews/CODE-REVIEW-520-r2.md`).
- Тело issue на момент ревью: sha256 `f318b25f5815fa66aeaa7cbc5ce1d63e23fab0a8e50493962634b01e0ca86e96`
  (получено `gh issue view 520 --json body -q .body | sha256sum`), отличается от
  записанного в SPEC-REVIEW-520-r3 (`60492a3aec5f…`) и от значения, названного
  в CODE-REVIEW-520-r2 (`4524f04412...`) — разобрано в тексте, возврата в spec
  не требует.
- Вердикт этого документа: зелёный · High 0 · Medium 0

---

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

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

- Ветка: `issue/520-first-frame`, коммит `a325294d7a9d` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `f7b30b932911c9f15765594194a6a0b7852d9f1c`
  ```
  git log --all --format='%H %T' | grep f7b30b932911
  ```
- Тело issue: `80073dd20133cdbba0bc717c7996f490c2d9010734fecedc11fcf8f894190143`
- Вердикт конвейера: `green` · High 0