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

CODE-REVIEW-511-r1

Issue: #511 — release-gate: судить по последнему завершённому прогону на SHA, отменённые не блокируют Этап: code (PROCESS.md §2.7) Заход: r1 · блокирующих циклов израсходовано 0 из 2 (лёгкий трек) SHA материала: 9d8f89d2600d573a7d57834659c1de0f0445f2dd (рабочая копия закреплена на нём, git fetch/checkout не выполнялись) Класс изменения: B — гейты и тулинг (scripts/**, test/**, docs/**); issue переиспользован из аналитики/spec, статус S7-code-review, лёгкий трек (small)

Скоуп

Диапазон origin/dev..HEAD — один коммит 9d8f89d2:

demo/performance/README.md |  4 +++-
docs/DEVELOPMENT.md        |  9 ++++++---
scripts/mutation-gate.mjs  | 22 ++++++++++++++++++++++
scripts/release-gate.mjs   | 33 ++++++++++++++++++++++++---------
test/release-gate.test.mjs | 40 ++++++++++++++++++++++++++++++----------
5 files changed, 85 insertions(+), 23 deletions(-)

src/**, custom_components/**, .github/workflows/**, dist/** не тронуты — чистая инфраструктура сборочного/релизного гейта, продуктовый код не меняется. Ни одного класса A файла в диффе.

Продуктовая рамка (docs/SCOPE.md): задача не про J1–J7 напрямую — это внутренний инструмент релизного процесса (инфраструктура, не UX). SCOPE.md её не ограничивает; проверка по AGENTS.md/PROCESS.md релевантна вместо неё.

Материал ревью

Issue #511, тело (проблема · решение владельца · AC1–AC3 · откат) и вся история комментариев:

• S2-аналитика (Codex) → трек small.
• Spec-review r1 (жёлтый, Medium в скоупе: AC3 указывал на несуществующий docs/performance/README.md).
• Spec-review r2 (зелёный): AC3 переформулирован на реальный docs/DEVELOPMENT.md:359-360, раздел «Откат» добавлен, способ доказательства AC2/AC3 назван. Отмечена пограничная (не блокирующая) двусмысленность второй части AC3 про demo/performance/README.md — «та же фраза» может значить либо правку существующей, либо добавление новой поясняющей фразы; оба чтения ведут к одному безопасному результату.
• Хендофф S6→S7 (Codex): описание реализации, тестов, мутантов, локального прогона.

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

Материал — сам диплой (сборка) не запускался, зелёного Validate на этом SHA нет, поэтому дешёвые гейты прогнаны вручную:

Гейт	Команда	Результат
Типы	npx tsc --noEmit	чисто, без вывода
Юнит-тесты (весь набор)	npm test	# tests 2408 / pass 2407 / fail 0 / skipped 1 — единственный skip не в test/release-gate.test.mjs и не связан с диффом (не найден в измененных файлах; предсуществующий, не регрессия этой задачи)
Юнит-тесты (точечно)	node --test test/release-gate.test.mjs	6/6 pass
Сборка	npm run build	успешно, tsc --noEmit && rollup -c зелёные; git status --short после сборки пуст — три копии бандла (dist, custom_components/houseplan/frontend, demo/srv/assets) уже в синхроне, диффом не задеты (src/** не менялся)
Синтаксис mutation-gate.mjs	node --check scripts/mutation-gate.mjs	ОК

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

• node scripts/check-docs.mjs — не требуется: диплом не трогает src/** (отпечаток скриншотов документации завязан на src/**, здесь он не устарел).
• Инварианты модели (npm run invariants) — диплом не трогает геометрию, рёбра комнат, layout, толщину, open_spans; неприменимо.
• Browser-смоки — прогнал node scripts/smoke-select.mjs --base origin/dev --head HEAD: вывод — «Исполняемого frontend-диффа нет (src/**/.ts не тронут). Browser-smoke этим диффом не выбираются — это не "пропустить проверки", а "выбирать нечего": смоки проверяют собранную карточку. Тронуто файлов: 5.»* Диплом состоит из Node-скрипта, его теста и markdown — карточка не пересобирается по-другому, смоки бить нечего.
• npm run golden:verify — диплом не меняет рендер/геометрию/стили/слои.
• python -m pytest tests_backend -q — custom_components/**/*.py не тронут.
• Перфоманс-профили — не названы в AC, диплом не трогает чувствительные к перфу пути (только формулировку в README).

Проверка AC по коду

AC1 — [green(older), red(newer)]→fail; [red(older), green(newer)]→success; [cancelled]→wait; [cancelled(newer), green(older)]→success; незавершённый последний → wait; пустой список → wait.

Доказано автотестом test/release-gate.test.mjs (тест #511: the latest non-cancelled run is the verdict…), покрывающим ровно эти шесть пар плюс порядок-независимость и latestRelevantRun напрямую. Читкой кода (scripts/release-gate.mjs:16-25) подтверждено соответствие алгоритма формулировке AC: latestRelevantRun отбрасывает conclusion === 'cancelled', сортирует по run_started_at/created_at (убыв.), при равенстве — по id; classifyValidateRuns возвращает wait при отсутствии/незавершённости последнего релевантного прогона, иначе success/fail по его conclusion.

Дисциплина «тест умеет падать» проверена не декларативно, а вручную для обоих заявленных мутантов — временно применил патчи release-gate-counts-cancelled-runs и release-gate-oldest-run-wins к рабочей копии scripts/release-gate.mjs, прогнал node --test test/release-gate.test.mjs, вернул файл (git diff --stat после отката — пусто):

• мутант «cancelled считаются» → 5 pass / 1 fail;
• мутант «побеждает самый старый» → 4 pass / 2 fail.

Оба мутанта ловятся тестом реально, не только по утверждению автора. AC1 выполнен.

AC2 — release.yml не меняется, вызовы release-gate.mjs для Validate и Full Performance те же.

git diff --stat origin/dev...HEAD не содержит .github/workflows/** вовсе. Прочитан текущий .github/workflows/release.yml:43 (node scripts/release-gate.mjs "$SHA") и :52 (node scripts/release-gate.mjs "$SHA" --workflow=performance.yml --label=…) — совпадают с состоянием до задачи, CLI-контракт скрипта (invokedDirectly-блок, scripts/release-gate.mjs:80-95) не менялся. AC2 выполнен, доказано чтением, не исполнением workflow (GitHub Actions здесь не прогонялись — сам гейт CI, его тело неисполнимо локально).

AC3 — docs/DEVELOPMENT.md и demo/performance/README.md описывают новую семантику; доказательство — grep фраз в release-gate.test.

Тест #511 AC3: the release documents describe the latest-run semantics (test/release-gate.test.mjs) читает оба файла и проверяет: (а) docs/DEVELOPMENT.md содержит новую формулировку и не содержит старую («A missing, failed,\ncancelled or one-hour-timed-out Validate withholds»); (б) demo/performance/README.md содержит новую фразу. Прогнан — зелёный. Читкой самих файлов (docs/DEVELOPMENT.md:356-363, demo/performance/README.md:121-127) подтверждено, что текст не просто проходит regex, а содержательно верен: старая ложная фраза про cancelled удалена, новая описывает алгоритм «последний нетронутый cancelled прогон» с явной отсылкой на #511 и на прецедент v1.73.0.

Пограничное чтение AC3, отмеченное в spec-review r2 (правка существующей фразы vs добавление новой), разрешилось в пользу более безопасного варианта — добавления новой поясняющей фразы в оба файла без порчи соседнего контекста; расхождения между двумя чтениями не осталось: результат проверяем и корректен при любом из них. AC3 выполнен.

Прочее замечаемое (не блокирует)

• waitForGreenWorkflow (scripts/release-gate.mjs:52-53) вычисляет latestRelevantRun(runs) отдельно от classifyValidateRuns(runs), которая внутри себя тоже вызывает latestRelevantRun — двойной проход по тому же массиву на каждой итерации поллинга. Функционально безвредно (массив — максимум 100 элементов по per_page=100, опрос раз в 30 с), не находка, а наблюдение; не поднимаю до Low, так как эффективность здесь не в AC и не влияет на корректность.
• Единственный skipped тест в npm test не входит ни в один из изменённых файлов и не упомянут в хендоффе как связанный с #511 — не регрессия этой задачи, дальше не копал (вне скоупа).

Трейлеры

Коммит 9d8f89d2: Issue: #511, User-Visible: no. Соответствует духу изменения — чисто внутренний CI-гейт, ни одно наблюдаемое пользователем поведение карточки не меняется, оба changelog корректно не тронуты.

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

• Алгоритм latestRelevantRun/classifyValidateRuns соответствует AC1 буква в букву, включая все шесть заявленных пар и порядок-независимость сортировки.
• release.yml не изменён и не должен был быть.
• Оба канонических документа (docs/DEVELOPMENT.md, demo/performance/README.md) синхронизированы с новой семантикой, старая ложная формулировка удалена.
• Мутанты release-gate-counts-cancelled-runs и release-gate-oldest-run-wins действительно ловятся тестом (проверено ручным патчем, не только заявлением автора).
• Полный юнит-набор, typecheck и сборка зелёные на этом SHA.

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

• CI/GitHub Actions поведение release.yml вживую (реальный тег/релиз) — вне возможностей ревью-цикла, риск закрыт чтением кода (CLI-контракт и вызовы не изменились) и модульными тестами самого гейта.
• Golden, browser-смоки, backend pytest, инварианты модели, перф-профили — неприменимы к диффу (обоснование в разделе «Как проверялось»).

Вердикт

High: 0, Medium: 0. Все три AC доказаны — автотестом с подтверждённой способностью падать (AC1, AC3) и чтением кода/workflow (AC2). Гейты (tsc, весь юнит-набор, build, точечный тест, smoke-select) зелёные. Трейлеры корректны. Не в скоупе задачи находок нет.

Зелёный.

---

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

• Ветка: issue/511-release-gate-latest-run, коммит 9d8f89d2600d — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: a22d70bc0a55770f667bb6afb4d3f943b50518a6

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

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