houseplan-card/docs/reviews/SPEC-REVIEW-489-r2.md

# SPEC-REVIEW-489-r2

- **Issue:** https://github.com/Matysh/houseplan-card/issues/489
- **Этап:** ТЗ на ревью (PROCESS.md §2.4)
- **Материал:** `docs/specs/489-data-hp-contract.md` на SHA `e072b222749d38fc1c7b5000b16907438bc5c6ee`
  (commit `e072b222`, ветка `issue/489-data-hp-contract`).
- **Предыдущий раунд:** r1, вердикт жёлтый, SHA `9cf10bdde7696e13c049fe83b4dc284622386127`
  (commit `9cf10bdd`), документ `docs/reviews/SPEC-REVIEW-489-r1.md`. SHA в вердикте
  комментария не был назван явно — восстановлен по истории коммитов (`9cf10bdd` —
  единственный коммит, добавивший этот файл, непосредственный родитель следующего
  коммита-документа `a48827ec`).
- **Заход:** r2. Блокирующих циклов израсходовано 1 из 4 (лимит на полном треке — 4).

## Скоуп разбора

Дельта — `git diff 9cf10bdd..e072b222 -- docs/specs/489-data-hp-contract.md`:
26 строк (18 добавлено / 8 удалено), без ребейза (история линейна,
`git merge-base 9cf10bdd e072b222` = `9cf10bdd`, HEAD — прямой потомок). Дельта
целиком лежит в четырёх местах документа, и все четыре — это ровно три находки
r1:

1. §6.2 — строка `data-hp-mode` (M3);
2. §6.3 — три строки `zoom-in`/`zoom-out`/`zoom-fit` (M1);
3. §10 AC7/AC8 — формулировка гейта документации (M2);
4. §14 release-артефакты + §15 принятые предположения — те же M2/M3, раскрытые
   подробнее.

Новых подсистем, нового публичного поведения или изменения контракта дельта не
вводит — это правки формулировок в тех же разделах, что r1 уже разобрал построчно.
Объём разбора этого раунда: закрытие всех трёх находок проверено чтением
актуального кода/скриптов (не только текста ТЗ), продуктовая рамка и разделы,
которых дельта не касается, — унаследованы из r1 без повторной проверки (раздел
ниже).

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

| Находка | Чем закрыта | Где это видно |
|---|---|---|
| **M1** — условие «когда отображается header» для zoom-кнопок требовало нового render-условия либо вводило в заблуждение | Формулировка заменена на «как сейчас: в ordinary plan render; в kiosk остаётся в DOM внутри скрытого CSS header» — выбран вариант (a) из r1: хук существует как сегодня, kiosk не меняет DOM | `docs/specs/489-data-hp-contract.md` §6.3, строки zoom-in/zoom-out/zoom-fit. Проверено чтением `src/houseplan-card.ts:11400` (`<div class="hdr ${this._kiosk ? 'kioskhide' : ''}">`) — `.zoomctl` (строка 11471) рендерится безусловно внутри `.hdr`, kiosk добавляет только CSS-класс `kioskhide`, элемент остаётся в DOM. Формулировка ТЗ теперь совпадает с кодом дословно |
| **M2** — гейт `check-docs` не назван обязательным, команда не та (`check:docs` вместо `check-docs.mjs`), пересъёмка скриншотов не упомянута в §14 | AC7/AC8 переписаны на точную команду `node scripts/check-docs.mjs`, названную обязательной («поскольку меняется `src/**`, дополнительно обязателен»); §14 получил новый пункт про канонический комплект docs screenshots из workflow **Docs screenshots**, принятый `npm run docs:accept -- --reviewed --from=<распакованный-артефакт>`, с явным запретом локальной пересъёмки | §10 AC7/AC8 и §14. Проверено: `scripts/check-docs.mjs` существует и реализует ровно то поведение, что описано (`scripts/docs-freshness.mjs` — по умолчанию `strict`, т.е. без флага фейлит при устаревшем отпечатке, не просто предупреждает); `npm run docs:accept` в `package.json:18` → `node scripts/docs-accept.mjs`, поддерживает `--reviewed --from=`; формулировка о workflow **Docs screenshots** и запрете локальной пересъёмки совпадает дословно с `PROCESS.md` §8 (строки 648–651) |
| **M3** — `data-hp-mode="device"` (ед. число) расходился с уже опубликованным `mode-devices` без объяснения | Значение изменено на `devices`, словарь `view/plan/devices/decor`; §15 явно фиксирует: «`devices` сохраняет уже опубликованное имя `.stage.mode-devices`... отдельное третье имя `device`... не вводится» | §6.2 и §15. Проверено: `docs/STYLING-HOOKS.md:286` обещает стабильность `mode-devices`; внутренний код везде использует `_mode === 'devices'` (`src/houseplan-card.ts:1768, 2947, 5727, 6826` и др.) и `data-editor-navigation="devices"` уже существует (`src/houseplan-card.ts:11446` при `m` из `['plan','devices','decor']`). Новое значение ТЗ совпадает с обоими существующими публичными именами, расхождение устранено, а не переименовано в третье |

Все три находки закрыты по существу, не декларативно: формулировки ТЗ после
правки проверены построчно против текущего кода и скриптов, а не приняты на
слово автора.

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

Без повторной проверки в этом раунде приняты выводы `docs/reviews/SPEC-REVIEW-489-r1.md`
(SHA `9cf10bdde7696e13c049fe83b4dc284622386127`), поскольку дельта их не задевает:

- структура документа содержит все обязательные разделы §7.1;
- продуктовая рамка (сценарий, персона, отсутствие нового пользовательского
  поведения, соответствие job'у из `docs/SCOPE.md` через инфраструктуру
  тестирования) — без конфликта;
- открытых продуктовых вопросов владельцу нет и не должно быть — все решения
  технические;
- §6.3 `space-add`/`space-settings`, §6.4 (три редактора, `toolbar`/`tool`/
  `editor-close`/`tray`, `EditorSecondaryController` как кандидат под `tray`),
  §6.5 (диалоги, выборка 10 из 33 call site), §6.6 (панель #486, единственный
  `menu`-обработчик и заголовок) — сверены с кодом в r1, дельта их не трогает;
  доверяю выводу без повторного построчного сравнения;
- §9 i18n (тривиально выполнено — ссылки в `USER-GUIDE.ru.md` пока нет);
- пустое состояние (§6.3 `empty`/`create-space`) и три его ветки — без
  расхождений в r1;
- открытые технические детали, оставленные на этап кода без блокировки:
  полнота словаря `data-tool` по launcher-группам, оставшиеся 23 из 33
  call site диалогов, реализуемость regex/AST-сканера AC6.

## Что проверено в этом раунде (сверх таблицы закрытия)

- Линейность истории между r1 и r2: `git log --oneline`, `git merge-base` —
  ребейза не было, полный разбор по этому основанию не требуется.
- Дельта не выходит за пределы четырёх мест, перечисленных в «Скоуп разбора»:
  сверено полным `git diff 9cf10bdd..e072b222` (не только упомянутые в
  коммит-сообщении места).
- Внутренняя согласованность новых формулировок друг с другом и с остальным
  документом (§14 бюллет не дублирует и не противоречит AC7/AC8; §15 пункт про
  `devices` не противоречит §6.2).

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

- Гейты (typecheck/test/build) не гонялись: правка — только markdown ТЗ, кода
  для проверки нет, как и в r1.
- Разделы вне дельты (см. «Унаследовано») не перечитывались построчно повторно.

## Вердикт

`Вердикт: зелёный · заход r2 · блокирующих циклов 1/4 · High: 0 · Medium: 0`

Все три Medium из r1 закрыты по существу и подтверждены чтением актуального
кода/скриптов, а не только текста правки. Новых находок дельта не создала.
ТЗ готово к переходу на код-ревью (S7).

---

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

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

- Ветка: `issue/489-data-hp-contract`, коммит `e072b222749d` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `885a8d6d361cac9ce02dae5c998fd60df6c65759`
  ```
  git log --all --format='%H %T' | grep 885a8d6d361c
  ```
- ТЗ `docs/specs/489-data-hp-contract.md`, блоб `127ce9505c272a9a4152b92157d71d78b96b1070`
  ```
  git log --all --find-object=127ce9505c272a9a4152b92157d71d78b96b1070 -- docs/specs/489-data-hp-contract.md
  ```