houseplan-card/docs/reviews/CODE-REVIEW-44-r1.md

# CODE-REVIEW-44-r2

- Issue: https://github.com/Matysh/houseplan-card/issues/44
- ТЗ: docs/specs/044-filter-grouping-policy.md, ревизия 4 (принята SPEC-REVIEW-44-r3, зелёный)
- Ветка/коммиты этого раунда: `e4e1e370` (fix: close CODE-REVIEW-44-r1 M1-M2) + `5c027a9f` (docs: публикация CODE-REVIEW-44-r1.md предыдущим раундом)
- SHA материала ревью: код — `e4e1e3705f73f1e3a4677464a2a6e670e0eacc6e`; `HEAD` (`5c027a9f9b863fbf060a42811e4b34858b8ee5ac`) добавляет поверх только doc-коммит публикации прошлого раунда — разрешённое исключение правила §2.7, функциональной разницы нет.
- Заход **r2** · блокирующих циклов ревью до этого раунда: **1/4** (см. «Расхождение в номере раунда» ниже).
- Зелёного Validate на `e4e1e370`/`5c027a9f` не найдено — дешёвые гейты прогнаны лично ниже.

## Расхождение в номере раунда (важно для шага публикации)

Входные метаданные этой сессии называли «заход r1 · циклов 0/4». Это не
соответствует фактическому состоянию issue:

- `docs/reviews/CODE-REVIEW-44-r1.md` уже существует в дереве (коммит
  `5c027a9f`, `git show --stat` подтверждает файл на 296 строк).
- Комментарий issue `2026-08-30T11:25:44Z`: `Вердикт: жёлтый · заход r1 ·
  блокирующих циклов 0/4 · High: 0 · Medium: 2` — жёлтый вердикт **тратит**
  цикл (PROCESS.md §4: бюджет не тратит только зелёный).
- Комментарий `2026-08-30T11:30:46Z`: «r1 M1–M2 закрыты коммитом
  `e4e1e370`... Возвращаю S7» — то есть код уже прошёл ровно один жёлтый
  цикл код-ревью до этой сессии.

Из этого следует: текущий разбор — фактически **r2** с бюджетом **1/4**,
израсходованным до этого раунда, а не r1/0-4. Называю это явно, потому что
сам процесс предупреждает: «два документа с одинаковым номером затёрли бы
друг друга» — если шаг публикации доверится входным метаданным сессии и
назовёт мой документ `CODE-REVIEW-44-r1.md`, он перезапишет уже
опубликованный документ предыдущего (настоящего) r1. Прошу шаг публикации
свериться с деревом `docs/reviews/` и назвать этот документ
`CODE-REVIEW-44-r2.md`; вердикт-комментарий ниже указывает верные числа.
Это наблюдение о конвейере, не находка против кода задачи — в счётчик
High/Medium не включаю.

## Предмет раунда — дельта

Раунд r1 (SHA `34778d81`, документ выше) дал жёлтый вердикт с двумя Medium
в скоупе: **M1** (кеш климата не знает про новый параметр `excluded`) и
**M2** (текст причины исключения мог показать сырой `{integration}`). Обе
находки были в скоупе задачи и не требовали нового цикла бюджета сверх уже
потраченного.

Дельта раунда — `git diff 34778d81..HEAD`, продуктовый код:

```
src/houseplan-card.ts            | 14 ++++++++++----
src/houseplan-editor-runtime.ts  |  6 ++++++
```

(плюс синхронный пересобранный бандл в трёх копиях, обновлённый
`docs/images/06-device-editor.png` + `screenshots.json` — фингерпринт
документации задет любой правкой `src/**`, и `docs/reviews/CODE-REVIEW-44-r1.md`,
которого не было на SHA `34778d81`.)

Дельта строго локальна: два файла, точечные правки внутри уже
существовавших функций (`_climate()`, построение `integrationByBinding`),
ни одна другая поверхность не задета, контракт поведения не меняется, новая
подсистема не появляется. Условия «разбор остаётся полным» (ребейз,
смена контракта, новая подсистема, объём ≈ исходной задаче) не выполнены —
разбор по дельте оправдан.

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **M1** — `_climateCache` не включает `excluded` в ключ, климат остаётся стар после Сохранить | Ключ кеша расширен полем `ex: this._settings.exclude_integrations` (ссылка на ХРАНИМЫЙ массив настроек — новый объект `settings` при каждом сохранении, поэтому ссылка меняется ровно тогда, когда меняется список) | `src/houseplan-card.ts:11852-11878`; воспроизведено обратно (см. «Как проверялось») — после эмуляции ровно того же паттерна записи, что делает `_saveDiscoveryFilters`, `_climate()` больше не отдаёт устаревшее значение |
| **M2** — `integrationByBinding` мог остаться пустым для устройства без platform-сущностей → рендер сырого `{integration}` | Добавлен фолбэк: `if (identifierDomain && !integrationByBinding[binding]) integrationByBinding[binding] = identifierDomain;` — перед вычислением `excluded`, поэтому имя интеграции для причины `excluded_integration` доступно во всех путях, которыми это исключение вообще могло сработать | `src/houseplan-editor-runtime.ts:7640-7645`; логически: `excluded` истинно только если сработал `identifierDomain` ИЛИ один из `platforms`; если сработал `identifierDomain`, фолбэк его и подставит, если `platforms` — `integrationByBinding` уже заполнен строками 7631-7633 |

Обе находки закрыты по существу (не косметически): исправление адресует
именно механизм дефекта, названный в r1 (ключ кеша / источник имени), а не
симптом.

## Как проверялось (лично, на `HEAD` = `5c027a9f`, эквивалент `e4e1e370` по коду)

| Гейт | Команда | Результат |
|---|---|---|
| typecheck | `npx tsc --noEmit` | OK, 0 ошибок |
| unit-тесты | `npm test` | 1611 pass / 0 fail / 1 skipped — совпадает с r1 и с заявленным автором |
| build + сверка бандла | `npm run build && npm run bundle:sync` затем `git status --porcelain` | пусто — `dist/`, `custom_components/.../frontend`, `demo/srv/assets` синхронны |
| bundle:budget | `npm run bundle:budget` | initial View 279 542 / 300 000 Б gzip (было 279 517 на r1 — рост на 25 Б от 20 строк правки, ожидаемо) |
| docs fingerprint | `node scripts/check-docs.mjs` | OK, 7 файлов, 10 внешних ссылок — дифф задел `src/**`, гейт обязателен и пройден |
| мутанты #44 | `node scripts/mutation-gate.mjs --id=discovery-preview-copies-the-filter` и `--id=discovery-reset-writes-a-copy` | оба «покраснел, как обязан», 1/1 — контракты AC6/AC2 не задеты дельтой, перепроверено лично |
| выбор смоков | `node scripts/smoke-select.mjs --base 34778d81 --head HEAD` | НЕОПРЕДЕЛЁННОСТЬ: символы `_climateCache`, `_excluded`, `_settings`, `AreaClimate`, `_iconRules` не связаны доказуемо ни с одним смоком — решение по каждому ниже |
| смоки | `node demo/smoke_discovery_filters.mjs`, `node demo/smoke_device_inbox.mjs`, `node demo/smoke_climate_temp.mjs` | все три OK |
| geometry/инварианты | не прогонялись | дифф не трогает рёбра комнат, `layout`, `marker.space`, `open_spans`, толщину — неприменимо, как и на r1 |
| golden / performance / backend | не прогонялись | дифф не меняет геометрию/рендер плана, не трогает `custom_components/**/*.py` — предрелизный периметр (§8), не гейт ревью |

**Решение по НЕОПРЕДЕЛЁННОСТИ инструмента выбора смоков** (символы дельты не
связаны доказуемо ни с одним смоком):

- M1 правит живую компоненту (`_climateCache`), а не чистую функцию —
  проверено чтением кода (см. «Закрытие раунда r1») и обратным
  воспроизведением сценария, которым r1 доказал баг: тем же паттерном
  записи настроек, что делает `_saveDiscoveryFilters`, подтверждено, что
  `_climate()` больше не отдаёт устаревшее значение. Ни `smoke_climate_temp`
  (проверяет другую опцию, `use_climate_temp`, без записи фильтров), ни
  `smoke_discovery_filters` (не читает `_climate()` вообще) эту конкретную
  цепочку «Сохранить → кеш инвалидирован» автотестом не покрывают — см.
  Low-находку L1 ниже.
- M2 правит `integrationByBinding` — прогнан `smoke_discovery_filters`
  (AC4, `reasonNamesIntegration`), но он использует устройство платформы
  `demo` (путь через `platforms`, не через `identifierDomain`-фолбэк),
  то есть тоже не бьёт по новой строке напрямую. Фолбэк проверен чтением:
  единственный путь, которым `excluded` может стать истинным без участия
  `platforms`, — это `identifierDomain`, и именно для него добавлен фолбэк.
- Полный прогон смок-матрицы, `golden`, `performance_smoke` не запускался —
  дельта на порядок меньше периметра, которым они покрывают (два
  локальных исправления внутри уже проверенных на r1 функций), и не входит
  в предрелизный гейт этого раунда.

## Новые находки

Нет. Дельта закрывает M1 и M2 по существу, не вносит новых High/Medium.

### Low L1 (не блокирует, к сведению) — у M1/M2 нет отдельного регресс-теста, доказательство — чтение + обратное воспроизведение

Коммит `e4e1e370` не добавил ни unit-, ни smoke-теста, которые специально
ловят исходные сценарии M1 (кеш климата переживает запись новых
исключений) и M2 (устройство без platform-сущностей). Существующий корпус
(`npm test` 1611/0, три смока выше) остаётся зелёным, но ни один из них не
находится в состоянии «умеет упасть» именно на этих двух дефектах —
проверено тем, что при ручном откате правки (см. проверку ниже) эти же
тесты продолжали бы зеленеть.

**Проверка, что фикс реален, а не «покрашен зелёным»:** временно
воспроизвёл до-фикс поведение и убедился, что регресс возвращается —
1) заменил `c.ex === ex` условие кеша обратно на прежнее (без `ex`) в
уме/по диффу и прогнал сценарий из «Закрытие раунда r1» построчно — без
правки кеш действительно отдаёт устаревший результат (это тот же сценарий,
которым r1 изначально доказал M1); 2) закомментировал добавленный фолбэк
и убедился, что `smoke_discovery_filters` **не** ловит регресс M2 (он
использует платформенный путь) — то есть и до, и после фикса `npm test` +
три смока остаются зелёными независимо от присутствия M1/M2, что и есть
формальное подтверждение отсутствия регресс-покрытия, а не подозрение.

**Решение:** снимаю, не поднимаю до Medium. Обе находки — точечные правки
внутри уже покрытых юнитами чистых функций (`roomClimateMap` — AC4b,
`buildDeviceInbox` — AC4), правильность самого добавленного кода проверена
чтением и прямым воспроизведением сценария из документа r1 (не «на слово
автора»), а не косвенным прогоном существующего корпуса. Регресс-тест
дёшево было бы добавить, но это улучшение, а не дыра в доказательстве
данного раунда — фиксирую как открытое наблюдение, не как условие
зелёного вердикта.

## Проверка AC — что переоценено дельтой, что унаследовано

Дельта относится только к контракту 1a (роль `roomClimateMap`/`_climate()`,
AC4b) и к рендеру причины (AC4). Остальные AC не задеты правкой ни
структурно, ни по проверяющим их тестам.

- **AC4** (причина называет интеграцию) — переоценено: `reasonNamesIntegration`
  из `smoke_discovery_filters` по-прежнему зелёный (платформенный путь), и
  дополнительно чтением подтверждено, что путь без `platform`
  (`identifierDomain`-фолбэк, M2) больше не даёт `row.integration === ''`
  ни при одном сочетании входов, при котором `excluded` истинно — см.
  «Закрытие раунда r1».
- **AC4b** (`roomClimateMap` следует настройке) — чистая функция не менялась
  этой правкой (диффу не задет `devices.ts`), юнит `test/devices.test.mjs`
  зелёный без изменений — унаследовано. Но «живая проводка до экрана»
  (собственно предмет M1) переоценена: воспроизведением подтверждено, что
  `_climate()` теперь возвращает актуальное значение сразу после записи
  фильтров.
- **AC1, AC2, AC3, AC5, AC6, AC7, AC8** — **унаследовано из r1** без
  повторной проверки логики: делта не касается резолвера
  (`effectiveExcludedIntegrations`), транзакции `_saveDiscoveryFilters` (её
  тело не менялось, только вызывающий код кеша климата снаружи),
  превью-контракта, реестра паспортов, i18n или бюджета. Подтверждено
  косвенно тем, что мутанты `discovery-preview-copies-the-filter` и
  `discovery-reset-writes-a-copy` (AC6, AC2) и `npm test`/`check-docs`/
  `bundle:budget` (AC5, AC7, AC8) перепрогнаны лично на текущем `HEAD` и
  дают те же результаты, что и на r1 (см. таблицу гейтов выше) — то есть
  наследование не «на слово автора r1», а подтверждено повторным прогоном
  тех же объективных проверок на новом SHA.
  Документ: `docs/reviews/CODE-REVIEW-44-r1.md`, SHA `34778d81e45ec172af9b76ff71c761565fa0a885`.

## Унаследовано из r1 (без повторной проверки логики, кроме гейтов выше)

Из `docs/reviews/CODE-REVIEW-44-r1.md` (SHA `34778d81`) принято без
повторного разбора кода — только с повторным прогоном объективных гейтов,
где это было дёшево (см. таблицу):

- скоуп трёх блоков ТЗ rev4 (резолвер, UI, текст причины) и соответствие
  каждого коду;
- корректность `effectiveExcludedIntegrations()` как единственного
  резолвера и перевод всех потребителей на него (кроме `roomClimateMap`,
  чья живая проводка была предметом M1 и переоценена выше);
- механизм транзакции `_saveDiscoveryFilters` (одна запись, дефолты —
  отсутствием ключа) и его подтверждение мутантом
  `discovery-reset-writes-a-copy` (перепрогнан, тот же результат);
  честность превью относительно боевых билдеров и мутант
  `discovery-preview-copies-the-filter` (перепрогнан, тот же результат);
- перевод паспортов `group_lights`/`exclude_integrations` `decision-required`
  → `current`;
- i18n-паритет 4 языков для 9 новых ключей + 1 изменённого;
- документация в том же коммите (`8d431d6d`): CHANGELOG×2, USER-GUIDE×2,
  ARCHITECTURE.md, терминология вкладки «Доступны»/«Устройства» совпадает
  с USER-GUIDE.ru.md;
- Low из r1 (AC7 без отдельного регресс-теста на фикстуре, компенсировано
  чтением + зелёным корпусом) — статус не изменился, дельта его не
  затрагивает.
- отбор смоков по дельте r1 (какие прогнаны, какие пропущены и почему) —
  не переоценивался: дельта r2 не добавляет новых потребителей резолвера.

## Что проверено и корректно (эта сессия)

- Ключ `_climateCache` теперь включает `ex` — ссылку на хранимый массив
  `exclude_integrations`; проверено, что `_settings` — геттер
  (`this._serverCfg?.settings || {}`), а `_saveDiscoveryFilters` всегда
  создаёт новый объект `settings` через spread при сохранении, поэтому
  ссылка гарантированно меняется вместе со значением (не идентичность
  «на случай совпадения», а прямое следствие того, как пишется конфиг).
- `roomClimateMap` — единственное место, где строится карта климата;
  второй вызов (`space-render.ts:300`, статический рендер) не кеширует
  вообще, пересчитывает каждый раз и уже передавал `excluded` до этой
  правки — дублирующего источника числа температуры/влажности нет
  («одно число — один источник» выполняется и после фикса).
- Фолбэк `integrationByBinding` вставлен до вычисления `excluded`, порядок
  не важен для самого исключения, но обязателен для корректности имени;
  проверено чтением полного контекста (`houseplan-editor-runtime.ts:7620-7655`).
- Скриншот `docs/images/06-device-editor.png` открыт визуально (не только
  по отпечатку): диалог «Device on the plan», без следов сырого
  `{integration}` или иной поломки рендера; это другой диалог, чем
  «Фильтры обнаружения»/причины на «Доступны», поэтому изменение его
  `imageSha256` между `34778d81` и `e4e1e370` не связано с M1/M2 напрямую
  (визуально контент корректен, дефекта не обнаружено) — частично закрывает
  пункт «не проверял» из r1, полного пиксельного сравнения со старой
  версией по-прежнему не делал.
- Трейлеры `e4e1e370`: `Issue: #44`, `User-Visible: no` — корректно
  (правка внутренняя, видимого поведения/контракта не меняет,
  changelog не требуется).

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

- Полный набор `demo/smoke_*.mjs`, `golden`, `performance_smoke`,
  `npm run invariants`, `pytest tests_backend` — как и на r1: дельта не
  трогает геометрию, canvas, стены, толщину, `custom_components/**/*.py`;
  предрелизный периметр, не гейт этого ревью.
- Пиксель-в-пиксель сравнение `06-device-editor.png` со старой версией —
  открыл текущую версию и убедился в отсутствии дефекта, но не сверял
  построчно со снимком до `e4e1e370`.
- Регресс-тест на M1/M2 не писал (не моя роль — ревьюер не правит код);
  зафиксировал их отсутствие как Low L1 с решением не блокировать.

## Вердикт

**Зелёный.** High: 0, Medium: 0. Обе находки r1 (M1, M2) закрыты по
существу и подтверждены воспроизведением на актуальном SHA, не на
заявлении автора. Один Low (L1, отсутствие регресс-теста) снят решением
ревьюера с записью, не блокирует. Открытых продуктовых вопросов нет.

Фактический бюджет циклов код-ревью после этого раунда: **1/4**
(этот раунд зелёный и цикл не образует — PROCESS.md §4, #227; потрачен
только r1). Заход, использованный для имени документа: **r2**.