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

# CODE-REVIEW-391-r2

Issue: #391 «Ещё 26 as any на ключах i18n в device inbox (и рядом marker/gs) — тот же паттерн, что #390»
Этап: code (S7-code-review)
Заход: r2 · блокирующих циклов израсходовано 1 из 2 (израсходован жёлтым вердиктом r1)
Ветка: `issue/391-i18n-key-casts`
SHA под ревью: `c3f38654f6833d95e3299393afad8084652e2bb8`
Материал: `git diff origin/dev...HEAD`, `origin/dev` = `a3dcee52418e41ee698089910731ce0101492a24`.

## Почему разбор полный, а не только по находке M1

Между r1 и r2 ветка сменила базу: r1 разбирал SHA `81a4278a`, привязанный к
`origin/dev = eb5aa2a0`; сейчас `origin/dev = a3dcee52` — на один коммит
дальше (`ci: move the harness to the current Home Assistant`, #392,
класс B: `.github/workflows/{mutation-gate,validate}.yml`,
`tests_backend/requirements.txt`). Это ребейз на ушедший вперёд `dev`, а
инструкция раунда прямо называет такой ребейз триггером полного разбора
(«после ребейза это другой код», PROCESS.md §7.2) — независимо от того,
пересекается ли новый коммит dev с файлами задачи.

Проверил пересечение и содержимое, а не только факт ребейза:
`a3dcee52` не касается ни одного файла этой задачи (`src/**`,
`docs/images/**`, `scripts/mutation-gate.mjs`, `dist/**`,
`custom_components/houseplan/frontend/**`); прямое построчное сравнение
диффа `3bbc65aa` (продуктовый коммит после ребейза) с фрагментами, которые
r1 цитировал (строки 7746, 9766, 11772, 11979, 12043, 12252, 12408, 12596,
13098 в текущем файле), показывает тот же самый текст патча — ребейз не
переписал ни одну правку. Поэтому разбор ниже полный по всем AC (гейты
прогнаны заново), но выводы r1 о построчной верности диффа переиспользованы
там, где я сам подтвердил их идентичность чтением, а не поверил на слово.

## Скоуп (без изменений к r1)

Класс A: `src/houseplan-editor-runtime.ts` — снятие `as any` с 33 вызовов
`this.host._t(...)` в трёх семействах ключей (`device_inbox.*` — 26,
`marker.*` — 6, `gs.preflight_reason_*` — 1); вычисляемые ключи — `as
I18nKey`; литеральные — без каста.
Класс B: `scripts/mutation-gate.mjs` — перенос mutation-anchor #295
(`preflight-reason-lost-in-dialog`) на `src/houseplan-editor-runtime.ts` /
строгую сигнатуру `_t`, `guard`/`because` не менялись.
Класс C: `docs/images/screenshots.json` — новый коммит `7ae0f14d`,
закрывающий находку M1 из r1 (см. таблицу ниже).
Класс D: `dist/**`, `custom_components/houseplan/frontend/**`,
`demo/srv/assets/**` — пересборка.
`User-Visible: no` на всех трёх коммитах (`3bbc65aa`, `7ae0f14d`,
`c3f38654`), трейлер `Issue: #391` на месте — оба верны: чистый типовой
рефакторинг плюс служебный манифест скриншотов, видимого пользователю
эффекта нет, changelog не требуется и не тронут.

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **M1** (Medium, в скоупе) — `node scripts/check-docs.mjs` красный: закоммиченный `sourceFingerprint` (`d27cbb20…`) устарел относительно текущего `src/**` (`74378a15…`), докапчур не выполнялся | Коммит `7ae0f14d` заменяет ровно 11 полей в `docs/images/screenshots.json`: 1×`sourceFingerprint` (манифест) + 10×`sourceSha256` (по одному на сценарий), оба `d27cbb20…` → `74378a15…`; `imageSha256` каждого из 10 сценариев и сам PNG-набор не тронуты (`git diff --stat` по `docs/images/` показывает только `screenshots.json`, без бинарников) | Перепрогнал `node scripts/check-docs.mjs` на текущем SHA сам — `Documentation checks passed (7 files, 10 external links)`. Скрипт не просто читает поле: строка 134 пересчитывает `visualFingerprint(ROOT)` и сверяет с манифестом, строка 145 пересчитывает `sha256` каждого PNG с диска и сверяет с `imageSha256`, строка 147 сверяет `sourceSha256` сценария с `sourceFingerprint` манифеста — все три проверки прошли на живом дереве, это не заявление автора |

## Как проверялось (гейты прогнаны заново на `c3f38654`)

| Гейт | Команда | Результат |
|---|---|---|
| Typecheck | `npx tsc --noEmit` | pass, без вывода |
| Unit/integration | `npm test` | 1644 pass / 0 fail / 1 skipped — совпадает с отчётом автора |
| No-new-any (#342) | `git diff origin/dev...HEAD -- src/houseplan-editor-runtime.ts \| node scripts/no-new-any.mjs --diff -` | «Проверено добавленных строк: 32 в 1 файл(ах). Новых any нет.» |
| Mutation-gate (#295/#332) | `node --test test/mutation-gate.test.mjs` | 10/10 pass |
| Build | `npm run build` | pass |
| Bundle sync | `npm run bundle:sync` | pass; `git status --porcelain` после — пусто (обе generated-копии побайтово совпадают с закоммиченными) |
| Bundle budget | `npm run bundle:budget` | initial View 283100 B / budget 300000 B; lazy editor 143903 B; lazy locale 46996 B — совпадает с числами автора и с r1 |
| Docs fingerprint | `node scripts/check-docs.mjs` | pass (7 files, 10 external links) — см. таблицу закрытия M1 |
| Inventory | `npm run inventory` | Node 1645, pure backend 221, HA-harness 154, browser smokes 208 — совпадает с отчётом автора, расхождение r1 (1643 vs 1645) объяснялось несвязанным коммитом `eb5aa2a0` и здесь уже не проявляется |

Diff не трогает геометрию/модель (нет правок толщины стен, `layout`,
`marker.space`, `open_spans`, узлов/рёбер решётки) — `npm run invariants`
не запускался, решение не изменилось относительно r1.
Diff не трогает `custom_components/**/*.py` — `pytest tests_backend` не
запускался.
`golden:verify` не запускался: правка src — чистое удаление/сужение
TypeScript-каста, стирается на компиляции; докс-манифест меняет только
хранимые хэши, не сами кадры (подтверждено самим `check-docs.mjs`, а не
только рассуждением).

### Браузерные смоки

`node scripts/smoke-select.mjs --base origin/dev --head HEAD` на этом SHA
выдал ту же выборку, что и на r1 (ожидаемо: `src/**`-часть диффа
байт-в-байт та же, база сместилась только по несвязанным CI-файлам):

```
Изменено файлов src/**: 1 · символов проекта на изменённых строках: 4
Прямое совпадение (7): _showToast →
  smoke_help_affordance, smoke_junction_limits,
  smoke_optimize_coordinate_canonicalization, smoke_partition_openings,
  smoke_room_resize, smoke_tap_ctx, smoke_zero_wall_migration_unblocked
```

Решение: эти 7 не перегонял повторно — унаследовал из r1 (см. раздел
ниже), содержимое диффа, которое их выбрало, идентично проверенному в r1
(символ `_showToast` на той же строке, механическая связь, не поведенческая).
Отдельно перегнал сам, свежо на этом SHA:
`node demo/smoke_preflight_diagnostics.mjs` — это guard-команда
mutation-anchor `preflight-reason-lost-in-dialog`, который правит diff
напрямую (не механическая связь, а прямое совпадение с `guard` в
`scripts/mutation-gate.mjs:3258-3259`) — результат `OK`. Полный набор
(208 смоков) не запускался — не оправдано ни AC, ни объёмом дельты между
раундами (один файл манифеста скриншотов плюс несвязанный CI-коммит в
базе).

## Что проверено и корректно (реверифицировано на этом SHA, не унаследовано молча)

- Прочитан целиком дифф `3bbc65aa` (продуктовый коммит после ребейза) по
  файлу `src/houseplan-editor-runtime.ts` — все 9 изменённых мест
  (`_setInboxHidden`, `_renderAlignDialog`, `_renderDevicesBar`,
  `_renderDeviceInbox` ×2 блока, `_toggleHintLines`,
  `_valueBadgeCandidateLabel`, `_renderMarkerDialog` ×2) текстуально
  совпадают с тем, что цитировал r1 — ребейз не исказил ни одну правку.
- `grep -n "as any" src/houseplan-editor-runtime.ts`, отфильтрованный по
  `device_inbox\.|marker\.|gs\.preflight_reason_`, — пусто: ни одного
  каста этих трёх семейств не осталось.
- Условный `readd`/`add` — литеральный union без каста на каждой ветке
  (`row.category === 'readd' ? 'device_inbox.readd' : 'device_inbox.add'`,
  без `as any` вообще) — подтверждено чтением и тем, что `tsc --noEmit`
  зелёный без ослаблений типов.
- `scripts/mutation-gate.mjs`: анchor `preflight-reason-lost-in-dialog`
  ссылается на `src/houseplan-editor-runtime.ts` и строку с `as I18nKey`
  (не `as any`), `guard`/`because` не изменены — подтверждено чтением
  `scripts/mutation-gate.mjs:3254-3266` и зелёным
  `node demo/smoke_preflight_diagnostics.mjs`.
- Generated bundle (класс D) синхронизирован и совпадает побайтово после
  `npm run build && npm run bundle:sync` — `git status` пуст.
- Трейлеры всех трёх коммитов раунда (`3bbc65aa`, `7ae0f14d`, `c3f38654`)
  корректны: `Issue: #391`, `User-Visible: no`; changelog оправданно не
  тронут ни в одном.
- M1 закрыта проверяемо, не на слово: см. таблицу «Закрытие раунда r1».

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

Документ: `docs/reviews/CODE-REVIEW-391-r1.md`, SHA `81a4278a`
(зафиксирован в шапке того документа; на момент этого раунда сам SHA
недостижим в дереве — ветка ушла дальше по истории, но диффу это не
мешает: содержимое сверено текстуально, см. раздел выше).

Принято без повторной проверки в этом раунде:

- построчный пересчёт всех 33 целевых `as any` до правки и подтверждение,
  что ни один каст `tap.*`, `fill.*`, `decor.*`, `junction.*`, `vac.*`,
  `run.*` и generic `message`/`hintKey`/`labelKey` не тронут — r1 сверял
  это по полному диффу, который в r2 текстуально идентичен (см. «Что
  проверено» выше), пересчитывать заново нечего;
- 7 «прямых совпадений» браузерных смоков
  (`smoke_help_affordance`, `smoke_junction_limits`,
  `smoke_optimize_coordinate_canonicalization`, `smoke_partition_openings`,
  `smoke_room_resize`, `smoke_tap_ctx`,
  `smoke_zero_wall_migration_unblocked`) — прогнаны в r1 (8/8 OK вместе с
  guard-смоком), диффа, который их выбрал, в r2 не изменился;
- решение не гонять `npm run invariants`, `pytest tests_backend`,
  `golden:verify` и полный набор из 208 смоков — основания (diff не
  касается геометрии/`.py`/рендера, объём не сопоставим с полным набором)
  не изменились между раундами;
- оценка двух «нечистых» вычисляемых ключей
  (`marker.value_badge_attr_${source.attribute}`, `.replace()`/
  `.replaceAll()`) как принятого риска, а не новой находки — тот же
  профиль был под `as any` до задачи, ТЗ разрешает `as I18nKey` как
  единственный доступный вариант.

## Чего не проверял и почему

- `npm run invariants` — diff не касается геометрии/модели.
- `python -m pytest tests_backend` — diff не касается
  `custom_components/**/*.py`.
- `npm run golden:verify` — подтверждено самим `check-docs.mjs`
  (сверка `imageSha256` с диска), что кадры не изменились; полный
  golden-прогон был бы дороже без нового вопроса, на который надо
  ответить.
- 7 из 8 браузерных смоков (кроме guard-смока) — не перегонял повторно,
  унаследованы из r1 (см. раздел выше), диффа, который их выбрал, между
  раундами не изменился.
- Полный набор из 208 браузерных смоков — не оправдано ни AC, ни объёмом
  дельты между раундами.
- Performance-профили — не названы в AC, diff не касается чувствительных
  к перфу путей.
- Ручное тестирование в браузере (UI) — не требуется: изменение не может
  изменить скомпилированную семантику (стирание типовых кастов), докс-
  манифест не меняет кадры (подтверждено `check-docs.mjs`).

## Вердикт

Единственная находка r1 (M1) закрыта проверяемо — `check-docs.mjs`
пересчитывает и фингерпринт, и хэш каждого сохранённого PNG, и оба
совпадают на этом SHA, а не только на слово автора. Ребейз на ушедший
вперёд `dev` не задел ни один файл задачи и не исказил ни одну правку
(проверено текстуальным сравнением). Все дешёвые гейты зелены и совпадают
с отчётом автора. Новых находок нет. Все AC из тела issue выполнены и
подтверждены тестом либо построчным чтением с явной пометкой «проверено
чтением, не исполнением». Вердикт — зелёный.