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

CODE-REVIEW-510-r2

• Issue: https://github.com/Matysh/houseplan-card/issues/510
• Материал: 00130e08aa247cd8796a99125deb7f9b5131bfa1 (рабочая копия на нём; git rev-parse HEAD сверен непосредственно перед выводом)
• Заход: r2 · блокирующих циклов израсходовано (после этого раунда) 2 из 4
• Ветка: issue/510-mutants-on-candidate-and-review-gate
• Предыдущий раунд: CODE-REVIEW-510-r1 (жёлтый, Medium M1), материал cbece6324f83b3400364fcd1a8eb1fa3b321a3ff
• ТЗ: docs/specs/510-mutants-on-candidate-and-review-waits-validate.md (r2 добавил одно предложение про cancelled), ревью ТЗ зелёное на r4 (docs/reviews/SPEC-REVIEW-510-r4.md)

Скоуп раунда

git log --oneline cbece632..00130e08:

00130e08 ci: a cancelled Validate dispatch proves nothing to the review gate
f6e64ba9 docs: review document for #510

Никакого ребейза между r1 и r2 не было: 00130e08 — прямой потомок cbece632 (два коммита сверху), дерево то же самое плюс точечный фикс M1. Это не смена кода по содержанию (§7.2) — разбор ведётся по дельте.

git diff cbece632..00130e08 --stat:

docs/reviews/CODE-REVIEW-510-r1.md                                          | 191 +++++++++
docs/specs/510-mutants-on-candidate-and-review-waits-validate.md            |   2 +-
scripts/merge-candidate.mjs                                                 |   4 +-
scripts/mutation-gate.mjs                                                   |  11 ++
scripts/validate-gate.mjs                                                   |  10 +-
test/validate-gate.test.mjs                                                 |  18 ++
6 files changed, 233 insertions(+), 3 deletions(-)

Предмет дельты — ровно закрытие M1 из r1: «отменённый (cancelled) dispatch-прогон читается как красный вместо того, чтобы игнорироваться», найденное в двух местах (scripts/validate-gate.mjs и scripts/merge-candidate.mjs). Разбор этого раунда сосредоточен на том, чем и насколько полно M1 закрыт; остальные AC (1, 3, 4, 5, 6) delta не задевает — унаследованы из r1 без повторной проверки (раздел ниже).

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

Зелёного Validate на 00130e08 не найдено (см. заголовок задачи) — гейты прогнаны лично.

Гейт	Команда	Результат
typecheck	npx tsc --noEmit	зелёный, без вывода
unit (полный набор)	npm test	2421 тестов, 2420 pass, 1 skip (предсуществующий #281, не в этом диффе), 0 fail
build + бандл	npm run build затем cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js	сборка зелёная, копии идентичны
check-docs / golden / смоки / инварианты / pytest / perf	не прогонялись	src/** и custom_components/**/*.py в дельте не тронуты — те же основания, что в r1 (AC6)
новый мутант протокола review-returns-task-on-cancelled-dispatch	node scripts/mutation-gate.mjs --id=review-returns-task-on-cancelled-dispatch	поймано 1 из 1 (лично, не со слов хендоффа)
пять мутантов, подтверждённых в r1 (AC4)	не перепрогонялись	делта не трогает их патчи/guard-и (mutation-gate.mjs только добавил новую запись) — унаследовано

Демонстрация: тест умеет падать — и её отсутствие там, где оно важно

Для нового мутанта review-returns-task-on-cancelled-dispatch заявленный раннер сам это доказывает («тест покраснел, как обязан»). Но M1 в r1 назвал два места с одним и тем же паттерном — scripts/validate-gate.mjs и scripts/merge-candidate.mjs. Проверил вторую половину лично:

cp scripts/merge-candidate.mjs /tmp/merge-candidate.mjs.bak
# вручную снял фильтр отменённых прогонов:
#   const runs = all.filter((x) => (!event || x.event === event) && x.conclusion !== 'cancelled');
# → const runs = all.filter((x) => (!event || x.event === event));
node --test test/merge-candidate.test.mjs   # 10/10 pass — ни одного упавшего
npm test                                     # 2420/2420 pass — ни одного упавшего
cp /tmp/merge-candidate.mjs.bak scripts/merge-candidate.mjs   # восстановлено, git diff пуст

Результат: снятие фикса в merge-candidate.mjs не роняет ни одного теста во всём проекте. См. находку ниже.

Находки

Medium (в скоупе задачи — чинится в этой же задаче, без отдельного issue)

M1 (новая, r2). Закрытие M1(r1) асимметрично: половина фикса в scripts/merge-candidate.mjs не защищена ни одним тестом или мутантом.

• Файл: scripts/merge-candidate.mjs:145 — waitValidate внутри realOps:

  const runs = all.filter((x) => (!event || x.event === event) && x.conclusion !== 'cancelled');
  

  Сам код корректен и делает ровно то, что требует обновлённый текст ТЗ («то же в waitValidate слияния»): отменённый прогон исключается из списка кандидатов, гейт слияния ждёт замену вместо того, чтобы красить кандидата.
• Но: ни один тест не вызывает эту ветку кода. test/merge-candidate.test.mjs проверяет mergeCandidate() только с полностью замоканным ops.waitValidate (строки 83, 207) либо со «настоящим git», где ops.waitValidate тоже подменён фейком (строка 207 того же теста) — реальная реализация waitValidate внутри realOps() не вызывается ни разу ни в одном тесте проекта. Соответственно ни один из пяти мутантов, привязанных к merge-candidate.mjs (merge-pushes-unvalidated-candidate, merge-ignores-lease-rejection, merge-waits-push-run-without-mutants и др., scripts/mutation-gate.mjs:3696,3707,8178), не патчит и не может поймать регресс именно этой строки — реестр про неё вообще не знает.
• Воспроизведено лично (см. блок выше): при полностью снятом фильтре x.conclusion !== 'cancelled' весь набор (npm test, 2420 тестов) остаётся зелёным. Это ровно тот класс дефекта, о котором предупреждает сама дисциплина ревью этого проекта («зелёный тест без реальной защиты», PROCESS.md §2.7, прецеденты #423/#430) — только тут защиты нет вообще, а не «не та».
• Почему это Medium, а не Low/наблюдение: scripts/validate-gate.mjs получил в этом же коммите два прицельных теста и мутант реестра для ровно того же паттерна; scripts/merge-candidate.mjs — тот же паттерн, та же формулировка ТЗ, но без единого свидетеля. Будущий рефакторинг (например, унификация двух копий одной и той же логики фильтрации, которую сам этот диф оставил задублированной) может тихо вернуть «cancelled = red» именно в путь слияния кандидата — и ничего в CI об этом не сообщит. Это не гипотетический сценарий, а прямое следствие того, что issue #510 в целом решает задачу «не тратить впустую циклы ревью/минуты раннера»: путь слияния (merge-candidate.mjs) — как раз тот, где отменённый прогон при повторной попытке гейта слияния красит готового к мержу кандидата.
• Почему в скоупе: M1 в r1 явно называла оба файла как один и тот же дефект («тот же паттерн в scripts/merge-candidate.mjs:147»); закрытие найдено только частичным — код исправлен, но не тестом, который умеет упасть. Чинится добавлением теста, эксплуатирующего realOps().waitValidate напрямую (с фейковым sh/gh или через существующий git-фикстурный тест строка ~200, но с подставленным реальным waitValidate вместо фейка) плюс записи в реестр мутантов.

Других Medium/High не найдено.

Low

Не найдено требующих записи.

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

Находка r1	Чем закрыта	Где это видно
M1 (cancelled dispatch читается как red вместо игнорирования) — половина 1: scripts/validate-gate.mjs:32	Код: validate-gate.mjs:60-66 — ветка run.conclusion === 'cancelled' добавляет прогон в ignored, сбрасывает tracked, продолжает цикл (ждёт замену либо диспатчит свой). Тест: test/validate-gate.test.mjs:109-125 — два новых сценария («замена уже есть» / «замены нет»), лично прогнаны, зелёные. Мутант: scripts/mutation-gate.mjs id review-returns-task-on-cancelled-dispatch — лично прогнан, поймано 1 из 1	git diff cbece632..00130e08 -- scripts/validate-gate.mjs test/validate-gate.test.mjs scripts/mutation-gate.mjs; вывод node scripts/mutation-gate.mjs --id=review-returns-task-on-cancelled-dispatch выше
M1 — половина 2: scripts/merge-candidate.mjs:147 (было)	Код исправлен: merge-candidate.mjs:145 — тот же фильтр x.conclusion !== 'cancelled' внутри waitValidate. Тест/мутант — отсутствуют, регрессия не ловится (см. воспроизведение выше)	git diff cbece632..00130e08 -- scripts/merge-candidate.mjs; ручной откат фикса + npm test (2420/2420 pass) выше — новая находка M1(r2)
Low (r1: «не найдено требующих записи»)	—	нечего закрывать, r1 не оставил Low

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

Принято без повторной проверки в этом раунде — дельта (docs/specs/*.md +1 строка, scripts/{merge-candidate,mutation-gate,validate-gate}.mjs, test/validate-gate.test.mjs) их не задевает. Источник — CODE-REVIEW-510-r1.md на материале cbece6324f83b3400364fcd1a8eb1fa3b321a3ff:

• AC1 (обычный push не запускает changed_mutants; dispatch/PR/schedule/кандидат беты — запускают) — доказано test/classify-changes.test.mjs + test/validate-workflow.test.mjs, мутант mutants-run-on-every-push («поймано 1 из 1» в r1). Файлы дельтой не тронуты.
• AC2 (гейт находит/запускает/красный/таймаут/несовпадение SHA) — доказано test/validate-gate.test.mjs (исходные 9 сценариев r1) + review-doc-guard.test.mjs, мутанты review-starts-on-red-validate / review-trusts-push-run-without-mutants. .github/workflows/process.yml дельтой r1→r2 не тронут вовсе.
• AC3 (слияние ждёт dispatch с мутантами, не push) — доказано test/merge-candidate.test.mjs, мутанты merge-waits-push-run-without-mutants / merge-pushes-unvalidated-candidate. Логика диспатча/ожидания, за исключением фильтра cancelled (см. новую находку M1 выше), дельтой не изменена.
• AC4 (мутанты протокола пойманы штатным раннером) — пять мутантов r1 подтверждены лично в r1; дельта r2 добавляет к ним шестой (review-returns-task-on-cancelled-dispatch, подтверждён в этом раунде). Остальные пять не перепрогонялись — их патчи/guard-файлы не менялись.
• AC5 (доки описывают место мутантов и правила хендоффа) — PROCESS.md/AGENTS.md/docs/TESTING.md/docs/specs/README.md сверены построчно в r1; в дельте r1→r2 из этого списка правок нет (только сам ТЗ-файл получил одно уточняющее предложение — см. git diff выше, прочитано, соответствует коду).
• AC6 (src/** не тронут, perf/touch/UX не задеты) — верно и для этой дельты: git diff cbece632..00130e08 --stat не содержит ни одного файла src/**.
• Асимметрия дизайна между validate-gate.mjs (учитывает чужой push-прогон) и merge-candidate.mjs (SHA кандидата всегда свежий) — признана обоснованной в r1, дельта её не меняет.

Что проверено и корректно (в этом раунде)

• scripts/validate-gate.mjs: ветка cancelled корректно встроена в существующий цикл ignored/tracked=null/continue — не ломает уже протестированные сценарии (chужой skip-dispatch, красный, таймаут, «материал сменился», слежение за tracked-run — все 9 старых тестов плюс 2 новых зелёные).
• scripts/merge-candidate.mjs: сама формула фильтра корректна и синтаксически идентична логике validate-gate.mjs — по коду поведение правильное (проверено чтением и ручным откатом-и-восстановлением, описанным выше), проблема только в отсутствии автотеста.
• Правка ТЗ (docs/specs/...md, одна строка) точно описывает реализованное поведение обоих мест, включая «то же в waitValidate слияния» — текст не разошёлся с кодом.
• scripts/mutation-gate.mjs: новая запись review-returns-task-on-cancelled-dispatch синтаксически корректна (find/replace совпадают один-в-один со строкой кода), guard запускает верный тестовый файл, лично прогнана — красит тест при внесении мутации и не красит при чистом дереве.

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

• check-docs.mjs, golden, смоки, инварианты модели, pytest tests_backend, perf-профили — дельта не касается src/**, custom_components/**/*.py или геометрии; основание не изменилось с r1 (AC6).
• Пять мутантов протокола, подтверждённых в r1 (mutants-run-on-every-push, review-starts-on-red-validate, review-trusts-push-run-without-mutants, merge-waits-push-run-without-mutants, merge-pushes-unvalidated-candidate) — не перепрогонял: дельта не меняет ни их patches, ни guard-файлы (git diff выше показывает только добавление новой записи в реестр).
• Реальный прогон validate-gate.mjs/merge-candidate.mjs против живого GitHub Actions — не воспроизводил (та же причина, что в r1: gh в этом окружении не аутентифицирован для целей ревью); логика проверена юнитами, мутантами и, для найденного пробела, ручным откатом-фикса — это и есть предмет код-ревью для скрипта без сети.
• Зеркалирование process.yml/validate.yml в main (AC5, §5.3 ТЗ) — шаг публикации после слияния, не код-ревью.

Материал раунда

• SHA: 00130e08aa247cd8796a99125deb7f9b5131bfa1 (сверено git rev-parse HEAD перед выводом).
• Предыдущий материал (r1, код): cbece6324f83b3400364fcd1a8eb1fa3b321a3ff.
• Ребейза между раундами не было — прямые 2 коммита сверху, дельта локальна.

Вердикт

Жёлтый: одна находка Medium в скоупе (M1(r2) — половина фикса M1(r1) в scripts/merge-candidate.mjs не защищена тестом/мутантом, регресс воспроизведён лично и не ловится ни одним из 2420 тестов проекта), High нет. Остальное из r1 (AC1, AC3–AC6, половина M1 в validate-gate.mjs) закрыто полностью и подтверждено. Возврат автору для добавления теста (и, по возможности, мутанта) на realOps().waitValidate в scripts/merge-candidate.mjs.

---

Материал раунда

• Ветка: issue/510-mutants-on-candidate-and-review-gate, коммит 00130e08aa24 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: e53cf9a26b9c66fb7602e485b8dffd1c7d286212

  git log --all --format='%H %T' | grep e53cf9a26b9c
  

• ТЗ docs/specs/510-mutants-on-candidate-and-review-waits-validate.md, блоб d68ed7818b4c77535305d0aae7da9765a2ad6c61

  git log --all --find-object=d68ed7818b4c77535305d0aae7da9765a2ad6c61 -- docs/specs/510-mutants-on-candidate-and-review-waits-validate.md
  

• Вердикт конвейера: yellow · High 0