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

# CODE-REVIEW-354-r2

- **Issue:** https://github.com/Matysh/houseplan-card/issues/354
- **Этап:** код-ревью (PROCESS.md §2.7)
- **Заход:** r2 · блокирующих циклов израсходовано 1 из 2 (лёгкий трек, лимит 2)
- **SHA материала:** `c1356fae1845d04264ed79628c93d3f1598c449f` (`git rev-parse HEAD`)
- **SHA предыдущего раунда (r1):** `1397afefd5564abf76cb6ed87b9f5eaee074361b`
  (не назван в r1-вердикте — см. документ CODE-REVIEW-354-r1.md, шапка)
- **Ветка:** `issue/354-language-runtime`
- **Вердикт: зелёный**

## Скоуп

Разбор по дельте (PROCESS.md §2.9): единственный новый коммит с момента
r1 — `c1356fae` («test: prove the failure delivery itself, not only the
unsubscription (#354 r1-M1)»), `git diff 1397afef..c1356fae`. Коммит написан
явно как правка находки r1-M1 (плюс попутно взята r1-L1) — продуктовый
контракт К1/К2/К3 не переоткрывается, ребейза на ушедший вперёд `dev` не
было (`1397afef` — прямой родитель `c1356fae`), новая подсистема не
задета. Дельта локальна — полный разбор не требуется.

Файлы дельты: `src/i18n/registry.ts` (13 строк), `test/i18n-runtime.test.mjs`
(23 строки), `scripts/mutation-gate.mjs` (новый мутант, 19 строк),
`docs/USER-GUIDE.md`/`docs/USER-GUIDE.ru.md` (по 1 предложению),
синхронизированные копии бандла (`dist/**`, `custom_components/houseplan/
frontend/**`) и `docs/images/screenshots.json` + `docs/images/06-device-editor.png`
(перегенерированы `check-docs` из-за смены `sourceFingerprint`, т.к.
`src/i18n/registry.ts` входит в `src/**`).

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **M1** (Medium) — юнит `subscribeLanguageLoadFailures` не проводил код через реальный fan-out, ловил только «отписка молчит» | Fan-out вынесен в экспортируемую `notifyLanguageLoadFailures(code)` (`src/i18n/registry.ts:58-64`); юнит теперь вызывает её напрямую и проверяет доставку двум живым подписчикам, молчание одного после отписки и полную тишину после отписки обоих | `test/i18n-runtime.test.mjs:173-191` (тело теста, см. «Как проверялось»); новый мутант `locale-failure-delivery-cut` в `scripts/mutation-gate.mjs:659-668` воспроизводит именно ту правку, которой r1-ревьюер поймал дыру, и красит юнит — прогнан мной лично, 1/1 |
| **L1** (Low) — `docs/USER-GUIDE.ru.md` не упоминал новый тост при отказе локали | Абзац о немецкой локали в обоих гайдах дополнен предложением о тосте | `docs/USER-GUIDE.md:149-153`, `docs/USER-GUIDE.ru.md:155-158` (см. диф `git diff 1397afef..c1356fae -- docs/USER-GUIDE.md docs/USER-GUIDE.ru.md`) |

Обе находки закрыты по существу, не текстом коммит-сообщения — проверено
чтением диффа и повторным прогоном нового мутанта.

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

Код-контракты, которых дельта не касается, приняты из
`docs/reviews/CODE-REVIEW-354-r1.md` (SHA `1397afef`) без повторного
разбора, кроме точечных перепроверок ниже, которые дельта затронула
косвенно (общий прогон тестов/мутантов/смока и один точечный grep):

- **AC1/К1** (`LANGUAGE_RUNTIME` — экземпляр `LanguageRuntime`, рукописный
  дубль удалён) — сама конструкция `new LanguageRuntime(...)` в дельте
  переписана только в части четвёртого аргумента (инлайн-стрелка →
  именованная функция), логика и итоговое поведение не изменились.
  Перепроверено попутно: мутант `language-runtime-handwritten-duplicate`
  прогнан мной повторно на `HEAD` — 1/1 поймана.
- **AC3/К3** (контракт-юнит + мутант на возврат дубля) — не в дельте,
  перепроверено попутно тем же прогоном, зелёный.
- **К2-периметр** (только `houseplan-card.ts` подписывается и показывает
  тост; `space-card.ts`, `editor.ts`, `space-editor.ts` — без
  тост-инфраструктуры) — файлы вне дельты, не тронуты. Перепроверено
  точечно: `grep -rn "notifyLanguageLoadFailures" src/` — единственное
  использование внутри `registry.ts` (конструктор рантайма), периметр не
  расширился.
- **i18n-ключ `toast.locale_load_failed`** и его тексты en/ru/de — вне
  дельты, не тронуты; паритет-тест ключей локалей входит в общий прогон
  `npm test`, прошёл в его составе.
- **Трейлеры и changelog за поведенческую часть** — уже приняты в r1 для
  `1397afef`. У `c1356fae` — `Issue: #354`, `User-Visible: no`, что верно:
  дельта не создаёт новое пользовательское поведение (тост уже был
  User-Visible в `1397afef`), только выносит внутреннюю функцию для
  тестируемости и правит документацию/тестовую инфраструктуру. Changelog
  в `c1356fae` не тронут — и не должен быть.

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

Зелёного `Validate` на SHA `c1356fae` не найдено — все гейты прогнаны мной лично.

| Гейт | Результат | Команда |
|---|---|---|
| typecheck | зелёный, без вывода | `npx tsc --noEmit` |
| unit-тесты (полный набор) | зелёный, 1487 pass / 0 fail / 1 skip (тот же skip, что и в r1, не связан с #354) | `npm test` |
| build + сверка 3 копий бандла | зелёный, `git status --porcelain` пуст после `npm run build && npm run bundle:sync` | `npm run build && npm run bundle:sync` |
| docs-гейт (скриншоты/фингерпринт) | зелёный, «Documentation checks passed (7 files, 10 external links)» — фингерпринт уже пересчитан автором в самом коммите | `node scripts/check-docs.mjs` |
| bundle:budget | зелёный, справочно, 257212 B < 282000 B | `npm run bundle:budget` |
| provenance (трейлеры) | зелёный | `node scripts/validate-commit-provenance.mjs` |
| мутант М1-фикса `locale-failure-delivery-cut` | поймана 1/1, «тест покраснел, как обязан» | `node scripts/mutation-gate.mjs --id=locale-failure-delivery-cut` |
| мутант К1/К3 `language-runtime-handwritten-duplicate` (наследуется, перепроверен попутно) | поймана 1/1 | `node scripts/mutation-gate.mjs --id=language-runtime-handwritten-duplicate` |
| мутант К2 `locale-failure-toast-dropped` (наследуется, перепроверен попутно) | поймана 1/1 | `node scripts/mutation-gate.mjs --id=locale-failure-toast-dropped` |
| `demo/smoke_german_locale.mjs` (полный прогон) | зелёный, все 9 проверок `true`, включая `failureShowsToast` | `node demo/smoke_german_locale.mjs` |
| `node scripts/smoke-select.mjs --base 1397afef --head HEAD` | см. ниже | — |

**smoke-select:** дельта касается 1 файла `src/**`, 2 изменённых символа
проекта (`languageLoadFailureListeners`, `notifyLanguageLoadFailures`) — оба
не встречаются ни в одном из 198 смоков, инструмент вернул
**НЕОПРЕДЕЛЁННОСТЬ**. Решение: новый браузерный смок не нужен. Оба символа —
чисто внутренняя разводка (замыкание вынесено в именованную функцию для
юнит-тестируемости), наблюдаемое поведение через них не меняется — оно уже
доказано `demo/smoke_german_locale.mjs` (`failureShowsToast`), который
является зарегистрированной связью для контракта К2 и прогнан целиком
выше, зелёный.

## Находки

Нет. Обе находки r1 закрыты по существу (см. «Закрытие раунда r1»), новых
дефектов дельта не вносит.

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

- **AC4, часть 2 (юнит на `subscribeLanguageLoadFailures`)** — ранее
  единственный незакрытый пункт АС4. Текст ТЗ требует «подписка получает
  код, отписка работает»: новый тест (`test/i18n-runtime.test.mjs:173-191`)
  вызывает `notifyLanguageLoadFailures('de')` и проверяет, что оба живых
  подписчика получают код (`['de', '2:de']`), что отписанный слушатель
  замолкает, а второй продолжает получать (`['de', '2:de', '2:de']`), и что
  после отписки обоих доставок больше нет. Проверено автотестом — сам
  прогнал `node --test --test-name-pattern="#354" test/i18n-runtime.test.mjs`
  внутри `mutation-gate` (гейт печатает «чистый прогон» перед мутацией) —
  зелёный. Adversarial-часть: мутант `locale-failure-delivery-cut` заменяет
  ровно ту строку `for (const listener of languageLoadFailureListeners)
  listener(code);`, которой в r1 я вручную ломал доставку и юниты этого не
  замечали — теперь красит юнит (1/1, воспроизведено мной запуском
  `node scripts/mutation-gate.mjs --id=locale-failure-delivery-cut`).
  Дисциплина «тест умеет падать» соблюдена не на словах автора, а моим
  собственным прогоном.
- **Контракт-юнит теперь пиннит и саму разводку**: новая ассерция в
  `test/i18n-runtime.test.mjs:146-150` матчит источник на
  `new LanguageRuntime(LANGUAGE_REGISTRY, BUILD_FINGERPRINT, console.warn,
  notifyLanguageLoadFailures,)` — если кто-то вернёт инлайн-стрелку без
  фан-аута наружу, юнит покраснеет раньше мутационного гейта. Проверено
  чтением и совпадением с текущим `src/i18n/registry.ts:73-79`.
- **L1-фикс не переизобретает формулировку**: оба абзаца
  (`docs/USER-GUIDE.md:149-153`, `docs/USER-GUIDE.ru.md:155-158`) описывают
  тот же сценарий («обе попытки не удались») и добавляют одно предложение
  про тост, не меняя остального текста — проверено построчным диффом.
- **User-Visible: no обоснован по существу**, не только по трейлеру: дельта
  не меняет ни один пользовательский артефакт (текст тоста, ключи локалей,
  условия его появления) — только внутреннее имя функции и тестовую/
  документационную обвязку. Changelog оставлен нетронутым правомерно.
- **Генерируемые копии бандла**: после `npm run build && npm run
  bundle:sync` рабочее дерево чистое — три копии синхронны с
  закоммиченным состоянием на `HEAD`.
- **Регенерация docs-фингерпринта корректна**: `sourceFingerprint` в
  `docs/images/screenshots.json` пересчитан автором в том же коммите
  (потому что `src/i18n/registry.ts` входит в покрытие отпечатка) и
  `check-docs.mjs` подтверждает его актуальность — не унаследованный
  зелёный статус из r1, а новый, пересчитанный под `c1356fae`.
- **«Одно число — один источник»**: дельта не добавляет и не меняет ни
  одну пользователю видимую величину (тот же текст тоста, что и в r1) —
  правило не применимо.

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

- `npm run golden:verify` — дельта не меняет геометрию/рендер/стили/слои
  (внутренняя разводка i18n + два предложения в докс); решение, не
  пропуск.
- `python -m pytest tests_backend` — ни один `custom_components/**/*.py` не
  тронут ни в r1, ни в этой дельте.
- `npm run invariants` — геометрия, `layout`, `marker.space`, `open_spans`
  не затронуты.
- Performance-профили — не названы в AC, чувствительные к перфу пути не
  задеты.
- Новый браузерный смок под `languageLoadFailureListeners`/
  `notifyLanguageLoadFailures` — не создавался; см. обоснование в разделе
  «Как проверялось» (smoke-select → НЕОПРЕДЕЛЁННОСТЬ, поведение уже
  доказано существующим `demo/smoke_german_locale.mjs`).
- 5 из 6 «прямых совпадений» `smoke-select` по символу `_showToast` из
  r1 — вне дельты этого раунда, не перепрогонялись повторно (тот же метод
  и там не менялся).
- Ручной просмотр карточки в живом браузере HA — только автоматические
  прогоны (unit, mutation-gate, Playwright-смок).