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

CODE-REVIEW-33-r2

• Issue: https://github.com/Matysh/houseplan-card/issues/33
• ТЗ: docs/specs/033-config-schema-lifecycle.md (ревизия 3, зелёное ревью SPEC-REVIEW-33-r2)
• Ветка: issue/33-config-schema-lifecycle
• SHA материала ревью: 15fa33b9d965ee463a8e61e8de2c13dec41a1832 (git rev-parse HEAD)
• Заход: r2 · блокирующих циклов израсходовано 1 из 4
• Предыдущий раунд: CODE-REVIEW-33-r1, жёлтый, на SHA 572cf928969fd8849299170ba3d42ff61d7ef423
• Дельта этого раунда: git diff 572cf928..15fa33b9 — один коммит 15fa33b9 («fix: close CODE-REVIEW-33-r1 M1-M3»), трейлеры Issue: #33, User-Visible: no

Скоуп раунда

Разбор ПО ДЕЛЬТЕ, не заново — согласно PROCESS.md §2.9/§2.7 и правилу этого цикла. Дельта локальна: 6 файлов, ни один не src/**, ни один не геометрия/схема:

Файл	Изменение
scripts/config-audit.mjs	сужение MIGRATION_STATUSES (закрывает M3)
test/config-schema-parity.test.mjs	переписан AC7-тест: весь src/**, актуальное имя дампа (закрывает M1)
docs/CHANGELOG.md, docs/CHANGELOG.ru.md, docs/ARCHITECTURE.md	удалён задвоенный абзац/раздел (закрывает M2)
docs/reviews/CODE-REVIEW-33-r1.md	публикация документа предыдущего раунда (артефакт конвейера, не код)

Рантайм-поведение конфига не менялось (не менялось и в r1); дельта — это ровно три точечные правки по числу находок r1, без побочных изменений скоупа. Условие «разбор остаётся полным» (ребейз, новый контракт поведения, новая подсистема, объём дельты сопоставим с задачей) не выполняется ни по одному пункту — сокращаю объём разбора до дельты и наследую остальное.

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

Находка r1	Чем закрыта	Где это видно
M1 — AC7-тест искал строку 'config-schema-manifest', которой нет нигде после переименования файла в f4318721; тест не мог падать.	Тест переписан: рекурсивный обход всего src/** (readdirSync с withFileTypes, фильтр по .ts/.js/.mjs/.json), поиск актуальной строки 'config-schema.json'.	test/config-schema-parity.test.mjs:96-106. Проверено исполнением заново в этом раунде: дописал в src/houseplan-card.ts строку fetch('./scripts/config-schema.json') (тот же приём, что в r1) и перезапустил тест — теперь not ok 3, тест красный с точным указанием файла; после отката файла — снова зелёный (node --test test/config-schema-parity.test.mjs → 3/3).
M2 — абзац/раздел #33 задвоен в CHANGELOG.md, CHANGELOG.ru.md, ARCHITECTURE.md (второй feat-коммит повторил правки первого).	Вторая копия удалена в каждом из трёх файлов.	Диф 15fa33b9: docs/ARCHITECTURE.md −24 строки, docs/CHANGELOG.md −7, docs/CHANGELOG.ru.md −7. Проверено чтением и подсчётом в этом раунде: grep -c на характерную фразу в каждом файле даёт 1 (было 2). Заголовок ## Schema as the source of truth (#33, 2026-08-30) встречается в ARCHITECTURE.md один раз (docs/ARCHITECTURE.md:1503).
M3 — config-audit.mjs расширил exit-код 3 на drop-on-validation и decision-required; для decision-required (group_lights/exclude_integrations — живые поддерживаемые поля, ждущие решения #44) это семантически неверно и вводит в заблуждение.	MIGRATION_STATUSES сужен ровно до контракта ТЗ Блока 3: migrate-on-write, migrate-on-settings-save, deprecated-read. Новый комментарий объясняет, почему оба статуса исключены.	scripts/config-audit.mjs:80-88. Проверено исполнением заново, своими фикстурами (тест задачи это не покрывает — см. ниже): {settings:{group_lights:true}} → exit=0 (было бы 3 до фикса); {spaces:[{...,aspect:1.2}],...} → exit=0. Контракт спеки (docs/specs/033-config-schema-lifecycle.md:102-105, «3 — migration available (найдены поля со статусом migrate-*/deprecated-read)») теперь воспроизведён буквально.

Ни одна находка не закрыта «на словах»: по каждой — либо перегон теста с воспроизведением регрессии (M1), либо построчная сверка файла (M2), либо собственный ad hoc прогон, раз штатный test/config-audit.test.mjs фикстуры с decision-required/drop-on-validation не содержит и не мог бы отличить старое поведение от нового (M3 — см. «Находки» ниже, это Low, не блокирует раунд).

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

Из CODE-REVIEW-33-r1 (SHA 572cf928) принимается без повторной проверки — дельта этого раунда не касается доказательной базы этих пунктов:

• AC1 (свежесть/детерминизм/полнота манифеста, 265 путей) — доказано в r1 исполнением (dump-config-schema.py --check, pytest freshness). Файлы манифеста и дамп-скрипт не менялись между 572cf928 и 15fa33b9.
• AC2/AC3 (parity 8 пар + анти-гниение allow-list) — доказано в r1 мутантом schema-manifest-enum-drift (1/1). scripts/schema-compat-allowlist.mjs и validation.py не менялись в дельте; сам parity-блок теста (строки 1-92) не тронут — правка коснулась только AC7-блока в конце файла.
• AC4 (полнота registry) — доказано в r1 мутантом registry-selector-dead-decision (1/1). scripts/config-field-registry.mjs не менялся в дельте.
• AC5 (lossless-фикстуры, round-trip будущих полей) — доказано в r1 pytest на трёх фикстурах test/fixtures/config-lifecycle/. Фикстуры не менялись в дельте.
• enforcedBy для 4 реализованных механизмов (show_all, weather_entity, ripple, aspect/segments) — подтверждено чтением кода в r1, код этих механизмов не менялся.
• Трейлеры и разнесение классов (build-коммит 572cf928 отдельно от feat) — оценено в r1, не относится к дельте этого раунда (у неё свой коммит со своими трейлерами, проверен отдельно выше).
• Не-скоуп (поведение конфига, судьба group_lights/exclude_integrations как таковая — не паспорт, а решение #44) — подтверждено в r1, дельта его не расширяет и не сужает.

Что проверено в этом раунде дополнительно к таблице закрытия

• AC6 (exit-коды 0/3/2) пересмотрен целиком, не только по факту закрытия M3: штатный test/config-audit.test.mjs (не менялся в дельте) по-прежнему зелёный — current.json → 0, oldest-supported.json → 3 (за счёт show_all/weather_entity/ ripple, которые остались в MIGRATION_STATUSES; aspect в той же фикстуре имеет статус drop-on-validation и больше не участвует, но фикстура всё равно даёт 3 по другим находкам — тест не мог бы заметить сужение сам по себе), broken.json → 2. Отсутствие штатного теста именно на decision-required/drop-on-validation в изоляции — Low-разрыв в покрытии AC6, не блокирует раунд (см. «Находки»).
• AC7 пересмотрен целиком (это и есть предмет M1): тест теперь читает весь src/** (102 файла верхнего уровня плюс поддиректории editors/, render/, i18n/ — итого 115 файлов по find src -type f), а не 2 файла, как раньше. Проверил, что обход не пропускает поддиректории (реализация рекурсивна, entry.isDirectory() идёт в walk снова) и что фильтр расширений (.ts/.js/.mjs/.json) не даёт ложноположительных срабатываний на бинарные/генерируемые артефакты.

Гейты, прогнанные в этом раунде

Зелёного Validate на SHA 15fa33b9 нет — прогнал дешёвые гейты лично.

Гейт	Команда	Результат
typecheck	npx tsc --noEmit	чисто
unit (полный)	npm test	1608 pass / 0 fail / 1 skipped — то же число, что в r1, дельта не сдвинула счётчик
docs fingerprint	node scripts/check-docs.mjs	«Documentation checks passed (7 files, 10 external links)» — не обязателен (дельта не трогает src/**), прогнан из осторожности, т.к. дёшев
AC7-тест изолированно, с воспроизведением регрессии	node --test test/config-schema-parity.test.mjs (дважды: с посаженным fetch('./scripts/config-schema.json') в src/houseplan-card.ts, и после отката)	красный с посаженной регрессией → зелёный (3/3) после отката — тест умеет падать, доказано в этом раунде заново
M3 руками, две ad hoc фикстуры	node scripts/config-audit.mjs <config с только group_lights> и <config с только aspect>	оба exit=0 (было бы 3 до фикса)

Не прогонял и почему:

• npm run build + сверка трёх копий бандла — дельта не трогает ни один файл src/** и ни один бандлируемый скрипт; dist/**/custom_components/.../frontend/** не менялись (git diff --stat 572cf928..15fa33b9 подтверждает — их нет в списке). Билд не мог измениться, гонять его — тратить время без нового сигнала.
• npm run bundle:budget — по той же причине (нет изменений в бандлируемом коде).
• npm run invariants — дельта не трогает геометрию/layout/marker.space/open_spans; повторный прогон унаследован из r1 (фикстуры lifecycle не менялись).
• Мутанты schema-manifest-enum-drift/registry-selector-dead-decision — код, который они бьют (validation.py, config-field-registry.mjs, allowlist), не менялся в дельте; результат унаследован из r1.
• python -m pytest tests_backend -q — дельта не трогает custom_components/**/*.py и не трогает tests_backend/**; ноль оснований перегонять.
• Браузерные смоки / smoke-select.mjs — дельта не содержит ни одного изменённого символа src/** (там вообще нет правок src/**, кроме временной ad hoc-мутации, откаченной после проверки); инструмент нечего сравнивать, не запускал.
• golden:verify — дельта не меняет рендер/геометрию/стили.

Находки

Три находки r1 закрыты состоятельно (см. таблицу выше). Новых Medium/High дельта не принесла. Одна Low-находка, заводимая как заметка, а не блокирующая:

L1 — AC6 не имеет штатного регрессионного теста на изолированные decision-required/drop-on-validation

test/config-audit.test.mjs не менялся в этой правке и по-прежнему проверяет только три lifecycle-фикстуры Блока 3, ни одна из которых не изолирует «только decision-required» или «только drop-on-validation». Штатный прогон npm test зелёный и до, и (гипотетически) после отката M3-фикса — потому что oldest-supported.json всё равно даёт exit 3 через show_all/weather_entity/ripple. То есть M3 закрыта фактически (проверено вручную выше), но не закреплена тестом задачи — будущая правка может случайно вернуть decision-required в MIGRATION_STATUSES, и штатный набор этого не заметит. Не блокирует: серьёзность Low, находка технической полноты покрытия, а не дефект поведения на HEAD. Можно снять правкой (добавить кейс с изолированным decision-required-конфигом в test/config-audit.test.mjs) либо принять с записью — решение автора.

Что проверено и корректно (сводно, r1 + r2)

• Все три Medium из r1 закрыты и перепроверены исполнением в этом раунде (таблица «Закрытие раунда r1»).
• AC1-AC5 унаследованы из r1 без повторной проверки (см. «Унаследовано из r1») — доказательная база не затронута дельтой.
• AC6 пересмотрен целиком в контексте M3-фикса: контракт exit-кодов теперь буквально соответствует ТЗ (docs/specs/033-config-schema-lifecycle.md:102-105).
• AC7 пересмотрен целиком в контексте M1-фикса: тест теперь способен поймать регрессию, которую называет своей целью, и покрывает весь src/**, а не 2 файла.
• Дублирование документации (M2) устранено без остатка в трёх файлах.
• Трейлеры коммита 15fa33b9 корректны: Issue: #33, User-Visible: no — правки не вводят новое видимое поведение (дедуп уже анонсированного changelog-абзаца плюс внутренняя коррекция dev-инструмента и теста), отдельного изменения в changelog не требуется.
• Один источник числа: у этой дельты нет ни одной новой пользовательской величины (правки — тест, CLI dev-инструмент, дедуп документации) — правило не применяется.

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

• Полный tests_backend с реальной Home Assistant — не установлена в этой песочнице; дельта в любом случае не трогает custom_components/**/*.py.
• Полный набор мутантов и golden/браузерные смоки — не относятся к дельте (см. таблицу гейтов выше с обоснованием по каждому пункту).
• Судьба group_lights/exclude_integrations как продуктовое решение (#44) — вне скоупа #33, не судил.

Вердикт

Зелёный. High: 0, Medium: 0. Все три Medium-находки r1 закрыты состоятельно и перепроверены исполнением заново в этом раунде (не только чтением диффа): M1 — тест подтверждённо умеет падать на реальном воспроизведении старой регрессии; M2 — дублирующиеся абзацы отсутствуют во всех трёх файлах; M3 — контракт exit-кодов воспроизведён буквально по ТЗ и проверен на изолированных ad hoc конфигурациях, которых штатный набор задачи не покрывает (отсюда одна Low-заметка о неполноте покрытия AC6, не блокирует). Дешёвые гейты (tsc, npm test 1608/0/1, check-docs) зелёные на HEAD; остальные гейты обоснованно унаследованы из r1 или признаны неприменимыми к локальной дельте.