houseplan-card/docs/reviews/CODE-REVIEW-329-r3.md

CODE-REVIEW-329-r3

Этап: code · заход r3 · блокирующих циклов израсходовано 2 из 4

Скоуп раунда

Предыдущий вердикт (code r2, 226-й комментарий issue) — красный, единственная находка r2-H1: мутант junction-limit-backend-raw-baseline в scripts/mutation-gate.mjs был добавлен с guard: 'python3 -m pytest tests_backend/test_junction_limits.py -q', в обход конвенции ВСЕХ прочих бэкенд-мутантов реестра (node scripts/backend-test-guard.mjs <pattern> <file>), из-за чего test/mutation-gate.test.mjs красился на CI.

Вердикт r2 получен на SHA 26c6e870 (Matysh: «Актуальный HEAD ветки для ревью — 26c6e870», непосредственно перед вердиктом). Автор закрыл находку коммитом 273b0d5e, текущий HEAD.

Дельта этого раунда:

git diff 26c6e870..HEAD --stat  (без docs/reviews/*)
 scripts/mutation-gate.mjs   | 4 ++--
 test/mutation-gate.test.mjs | 6 +-----
 2 files changed, 3 insertions(+), 7 deletions(-)

Дельта не затрагивает src/**, бэкенд-продакшен-код, геометрию, документацию пользователя — только реестр мутантов и его контрактный тест. Это ровно то, что запрошено находкой r2-H1, без побочных правок. Разбор по дельте признан достаточным: изменение локально, не является ребейзом, не меняет контракт поведения продукта и по объёму несопоставимо мало относительно исходной задачи (две строки правки guard + возврат теста к исходному виду).

Что проверено (дельта)

1. Форма guard соответствует конвенции. Новый guard — node scripts/backend-test-guard.mjs test_legacy_baseline_is_judged_after_the_same_migration tests_backend/test_junction_limits.py — совпадает по форме со всеми остальными записями реестра, использующими бэкенд-хелпер (проверено grep -n "backend-test-guard" scripts/mutation-gate.mjs — 16 вхождений, новое неотличимо от прочих).
2. Контракт теста возвращён к исходному виду. test/mutation-gate.test.mjs снова требует, чтобы guard называл .mjs (убрана временная ветка .py, убран комментарий-объяснение, который её оправдывал). grep подтвердил: других мутантов, называющих .py напрямую (в обход хелпера), в реестре нет — правка не откроет дыру для будущих аналогичных случаев.
3. Мутант по-прежнему ловит регрессию. Прогнан НЕ ТОЛЬКО --check (проверяет только уникальность якоря патча), а полный цикл конкретного мутанта: node scripts/mutation-gate.mjs --id=junction-limit-backend-raw-baseline →

   ok   чистый прогон: node scripts/backend-test-guard.mjs test_legacy_baseline_is_judged_after_the_same_migration tests_backend/test_junction_limits.py
   ok   junction-limit-backend-raw-baseline: тест покраснел, как обязан
   поймано 1 из 1
   

   То есть подтверждено обеими половинами: код без мутации проходит целевой тест, а с применённым патчем (migrated = config вместо прогона через commit_wall_segment_model) целевой тест красится. Это и есть доказательство «тест умеет падать» для данной находки.
4. pytest напрямую. python3 -m pytest tests_backend/test_junction_limits.py -q → 8 passed. (pytest в песочнице ревью отсутствовал изначально, установлен pip3 install --user pytest — тот же шаг, что r2 констатировал как разовую особенность окружения, не продукта.)
5. npm test → # tests 1391 / # pass 1390 / # fail 0 / # skipped 1, совпадает с итогом, который автор указал в коммите 273b0d5e.
6. npx tsc --noEmit — чисто (дельта не трогает .ts, но прогнан по правилу «всегда»).
7. npm run build — собрался, dist/houseplan-card.js создан. Сверка бандла: cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js — совпадает побайтово. Третья копия, demo/srv/assets/houseplan-card.js, в дереве отсутствует (она untracked рабочая копия demo-стенда, bundle-sync.mjs создаёт её по требованию) — отсутствие ожидаемо и не связано с этой правкой, дельта фронтенд не трогает.
8. node scripts/check-docs.mjs → Documentation checks passed (7 files, 10 external links). Формально необязателен (дельта не в src/**), прогнан по инерции — зелёный.
9. node scripts/smoke-select.mjs --base 26c6e870 --head HEAD → «Исполняемого frontend-диффа нет (src/**/*.ts не тронут). Browser-smoke этим диффом не выбираются — выбирать нечего». Полный прогон смоков не делал — инструмент прямо говорит, что выбирать нечего, а не «неопределённость».

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

Находка	Чем закрыта	Где это видно
r2-H1: guard бэкенд-мутанта в обход конвенции .mjs-хелпера, контрактный тест красный на CI	scripts/mutation-gate.mjs: guard мутанта junction-limit-backend-raw-baseline переписан на node scripts/backend-test-guard.mjs test_legacy_baseline_is_judged_after_the_same_migration tests_backend/test_junction_limits.py; test/mutation-gate.test.mjs: контракт every guard command points at a file that exists возвращён к проверке только .mjs, временная ветка для .py и оправдывающий её комментарий убраны	Коммит 273b0d5e; npm test 1390/0 (было 1389 passed/1 failed на 0824e510); точечный прогон node scripts/mutation-gate.mjs --id=junction-limit-backend-raw-baseline — «поймано 1 из 1»

Унаследовано из r2 (и, транзитивно, из r1)

Без повторной проверки исполнением приняты — дельта r3 их не касается кодом, которого они доказывают:

• H1 (бэкенд мигрирует обе стороны перед сравнением) — доказано в r1, подтверждено закрытым в r2 тестом test_legacy_baseline_is_judged_after_the_same_migration и мутантом. Документ: docs/reviews/CODE-REVIEW-329-r2.md, раздел «Закрытие раунда r1», SHA 26c6e870.
• M1 (мёртвый код apexCaps/clipPolygonOutsideCap/degenerateApexCaps удалён) — docs/reviews/CODE-REVIEW-329-r2.md, SHA 26c6e870.
• M2/M3 (дубль раздела USER-GUIDE устранён, канал Resize описан верно) — там же, SHA 26c6e870.
• M4 (AC10, Optimize не создаёт новых нарушений, доказан двумя юнитами) — там же, SHA 26c6e870.
• Остальные AC (П1–П5 юниты и границы, §4 честная вершина + golden, AC5a/b, AC7a через реальный pointer-жест, AC7b, паритет AC9, скоуп применения AC8) — впервые проверены и признаны корректными в docs/reviews/CODE-REVIEW-329-r1.md, подтверждены неизменными в r2 (дельта r1→r2 их не трогала за вычетом перечисленных выше M1–M4 и H1); дельта r2→r3 тем более их не трогает (единственные изменённые файлы — scripts/mutation-gate.mjs и test/mutation-gate.test.mjs, не пересекающиеся с производственным кодом junction-limits, рендером или бэкендом). Документ: docs/reviews/CODE-REVIEW-329-r1.md, SHA e1df015d; golden/invariants/мутанты для этих AC — из отчёта r1 («что прогнано»).
• Полный HA-harness backend не прогоняется — унаследованный пробел окружения, констатирован ещё в r1 (недоступны homeassistant/voluptuous), подтверждён в r2, в r3 не переоценивался — дельта его не касается.

Чего не проверял в этом раунде и почему

• npm run golden:verify — не прогонял. Дельта не трогает рендер, геометрию, стили, слои; полная матрица (~80 сцен) уже прогнана и зелёная в r2 на коде, который в r3 не менялся.
• npm run invariants — не прогонял. Дельта не трогает рёбра комнат, записи толщины, layout, marker.space, open_spans — инварианты модели здесь неприменимы.
• Браузерные смоки — не прогонял ни одного. smoke-select.mjs для диапазона 26c6e870..HEAD прямо сообщает «выбирать нечего»: единственные изменённые файлы — scripts/mutation-gate.mjs и test/mutation-gate.test.mjs, оба вне src/**, ни один смок такой диапазон не оценивает даже как слабую связь.
• python -m pytest tests_backend -q (полный набор) — прогнал только файл test_junction_limits.py, целевой для находки; полный бэкенд-набор не запускал, так как дельта не трогает бэкенд-продакшен-код (только тест и реестр мутантов на фронтенде/CI), а test_junction_limits.py — тот файл, контракт которого проверяет закрытие r2-H1.
• Performance-профили — не прогонял, в AC не названы и дельта их не задевает.
• Полный .github/workflows/mutation-gate.yml (пересборка бандла на каждого мутанта) — не прогонял; это предрелизный гейт (PROCESS.md §8), несоразмерен точечной правке одной записи реестра. Точечный прогон именно этого мутанта сделан отдельно (см. выше) и достаточен как доказательство.

Вывод

Единственная находка r2 (High) закрыта по существу и подтверждена исполнением: guard мутанта следует конвенции, контракт реестра не ослаблен, мутант по-прежнему доказанно ловит регрессию H1 (1/1), npm test и pytest tests_backend/test_junction_limits.py зелёные. Новых находок delta не создаёт — правка изолирована в тестовой инфраструктуре, не пересекается с продакшен-кодом или пользовательским поведением. Trailer коммита (Issue: #329, User-Visible: no) корректен для чисто тестового изменения; changelog не тронут — верно, правок не требовалось.

Вердикт: зелёный.