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 выполнены и подтверждены тестом либо построчным чтением с явной пометкой «проверено чтением, не исполнением». Вердикт — зелёный.