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

CODE-REVIEW-562-r3

Скоуп

Issue #562 «Process: отвязать роли и инфраструктурный трек от конкретных агентов», заход r3, блокирующих циклов израсходовано 2/4 до этого раунда. Прошлый вердикт — жёлтый (Medium в скоупе), документ docs/reviews/CODE-REVIEW-562-r2.md, материал 8f000dd459393cd0d17e9cfa58513a68f7f5ffa1.

Материал этого раунда — ровно d6180f7f5de6991fc7bc678a2203da820993c544, рабочая копия уже на нём. git fetch/checkout не выполнялись.

Ветка приведена конвейером к dev между раундами: поверх авторского b75130f7 (тот же коммит, что вёл в комментарии автора к r3, локально эквивалентен d6180f7f — см. проверку ниже) легло 2 коммита dev (744f502b «ci: include dynamic backend inputs in gates (#542)» и f6e5651c «docs: review document for #542»). После ребейза формально другой код (§7.2) → разбор в этом раунде ведётся полностью, а не по дельте.

Проверил цену этого решения предметно, а не только продекларировал: git diff b75130f7 d6180f7f --stat показывает ровно 6 файлов — docs/TESTING.md, docs/reviews/CODE-REVIEW-542-r1.md, scripts/check-inputs.mjs, scripts/mutation-gate.mjs, test/check-inputs.test.mjs, test/gate-reuse.test.mjs — это в точности содержимое двух указанных коммитов dev (#542), никаких иных различий между до- и после-ребейзным деревом нет. Дополнительно проверил, что три коммита самой задачи #562 (process: / fix: доказывать infra-трек… / fix: подсказывать infra-вход…) физически идентичны по содержимому до и после ребейза: git diff 8f000dd4 7b58f73e (те же логические коммиты пред- и пост-ребейз) отличается ровно на те же 6 файлов #542, то есть сам diff задачи #562 ребейз не тронул ни байтом. Правки #542 (check-inputs.mjs, mutation-gate.mjs, backend-гейт CI) и правки #562 (task-packet.mjs, process-gate.mjs, AGENTS.md, PROCESS.md) не пересекаются ни одним файлом — интерференции нет. Разбор веду полным по объёму (все AC заново), но с этим установленным фактом на руках: риск, из-за которого правило §7.2 существует, здесь предметно не реализовался.

Полный диапазон origin/dev(f6e5651c)..HEAD, 5 содержательных для истории задачи коммитов (2 — документы предыдущих раундов, не код):

3934f8d8 process: отвязать роли от конкретных агентов (#562)      — материал r1
f5388259 docs: review document for #562                            — документ r1
7b58f73e fix: доказывать infra-трек по diff (#562)                  — материал r2 (= 8f000dd4 до ребейза)
a66649a1 docs: review document for #562                            — документ r2
d6180f7f fix: подсказывать infra-вход до появления ветки (#562)     — материал r3 (= b75130f7 до ребейза)

git diff origin/dev...HEAD --stat: AGENTS.md, PROCESS.md, scripts/process-gate.mjs, scripts/task-packet.mjs, test/process-gate.test.mjs, test/task-packet.test.mjs, плюс два новых файла docs/reviews/CODE-REVIEW-562-{r1,r2}.md. Класс изменений: A не затронут вовсе (AGENTS.md/PROCESS.md — класс C, scripts/**/test/** — класс B) — задача сама себя корректно относит к инфраструктурному треку. Трейлеры на всех трёх содержательных коммитах: Issue: #562, User-Visible: no — верно, продуктовое поведение не менялось, changelog не нужен и не тронут.

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

Гейт	Прогнан	Результат
npx tsc --noEmit / npm test (весь набор) / npm run build + сверка бандлов	нет, переиспользован	Validate на d6180f7f green: https://github.com/Matysh/houseplan-card/actions/runs/34743984705
node --test test/task-packet.test.mjs	да	10/10 зелёных
node --test test/process-gate.test.mjs	да	35/35 зелёных
Тот же test/task-packet.test.mjs против кода r2 (7b58f73e, через git worktree)	да	8/10 — новый тест #562: before a branch exists the infra label prompts classification but grants no rights падает (AssertionError: /предварительно/ не совпало с 'полный'), т.е. тест реально ловит регресс r2, а не проходит тавтологически
node scripts/smoke-select.mjs --base origin/dev --head HEAD	да	«Исполняемого frontend-диффа нет… Browser-smoke этим диффом не выбираются» — выбирать нечего
node scripts/check-docs.mjs	нет	diff не касается src/**
golden:verify, pytest tests_backend, npm run invariants	нет	diff не меняет рендер/геометрию/Python
git diff-инспекция интерференции с #542 (соседние коммиты dev от ребейза)	да	0 пересекающихся файлов (см. «Скоуп»)

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

Находка r2	Чем закрыта	Где это видно
Medium — до появления ветки (branch === null) infrastructure был всегда false, и statusless issue с меткой infra получал от task-packet.mjs заведомо неверный ответ «вне процесса, ждать S-метку владельца» вместо «инфраструктурный вход, делай сразу»	Введён отдельный флаг infrastructureHint = branch == null && status == null && labels.includes('infra'). Track для этого состояния теперь 'инфраструктурный (предварительно; подтвердить путями/diff)', а rightsFor добавляет явную строку «метка infra — только подсказка, не доказательство и не право: до ветки проверь предполагаемые пути; без class A начинай сразу, при любом class A нужен продуктовый S-flow» и меняет default-ветку switch на «предварительный инфраструктурный вход: после проверки отсутствия class A реализовать → push ветки → S7-code-review; diff станет окончательным доказательством». Это ровно вариант, предложенный самой находкой r2 («явно писать неопределённость... маркировать как непроверенный diff'ом, а не как решённый факт»), а не решение «доверять метке безусловно» — поэтому находка r1 (метка = безусловное доказательство трека) этим не реанимируется	scripts/task-packet.mjs:27,39-51,118-125; воспроизвёл сам: buildPacket({issue:{...}, labels:['infra']}) (без branch) на d6180f7f даёт track: 'инфраструктурный (предварительно; подтвердить путями/diff)' и три строки rights, включая подсказку — команда и полный вывод см. «Как проверялось»
(методологический риск: не поймать регресс тавтологичным тестом)	Новый тест test/task-packet.test.mjs:125-136 (#562: before a branch exists...) целенаправленно вызывает buildPacket без branch — именно тот путь, который r2 поймал руками, а старые тесты не покрывали	Проверено запуском той же версии теста против кода r2 (7b58f73e) через git worktree: падает (AssertionError), то есть тест не тавтологичен

Находка r2 закрыта: сценарий «взять задачу, вызвать пакет до push ветки» теперь даёт согласованную рекомендацию «после проверки путей — начинай», а не блокирующее «жди метку владельца», что для инфраструктурного трека противоречило бы самому issue #562. При этом граница r1 (тематическая метка НЕ даёт права на класс A и НЕ подменяет механический критерий, когда ветка уже есть) не нарушена: infrastructureHint действует только при branch == null && status == null, тест #562: the infra label alone never grants the accelerated track (метка infra + реальный S6-in-progress) остаётся зелёным и продолжает требовать track === 'полный'.

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

Формально это полный разбор (ребейз, §7.2), но там, где текст между раундами буквально не изменился, вывод предыдущих раундов подтверждён повторным чтением, а не просто принят на слово:

• AC1 (роли не закреплены за Codex/Claude в AGENTS.md/PROCESS.md; локальный CODEX-RUNBOOK.md вне репозитория и вне материала ревью) — перечитал AGENTS.md («Agent-neutral workflow») и PROCESS.md (раздел ролей) целиком в этом раунде; текст идентичен тому, что проверяли r1/r2 (дельта 3934f8d8 не тронута ни 7b58f73e, ни d6180f7f — оба диффа ограничены scripts/task-packet.mjs/test/task-packet.test.mjs). Документ первичного вывода: docs/reviews/CODE-REVIEW-562-r1.md, SHA 53f0635e (= 3934f8d8 после ребейза).
• AC2 (оба документа одинаково описывают маршруты S1–S8 и инфра-без-S → S7 ↔ S6 → S8) — то же самое: перечитал диаграмму PROCESS.md §2 и абзац AGENTS.md про accelerated entry заново, они согласуются друг с другом дословно так же, как на r1.
• AC3 (независимость автора/ревьюера, автоматическое ревью и слияние, разрешение владельца на выпуск) — механика конвейера (S7-code-review триггерит автоматический ревью, зелёный вердикт мержит и ставит S8-merged) не менялась ни одним из трёх коммитов #562; process-gate.mjs и test/process-gate.test.mjs в этой задаче меняют только текст сообщений/комментариев (см. далее), не логику.
• AC4 (исторические документы ревью не переписаны) — docs/reviews/ CODE-REVIEW-562-r1.md и -r2.md в полном диапазоне origin/dev...HEAD присутствуют только как добавленные файлы (git diff --stat: только insertions, 0 deletions на этих путях) — ни один существующий файл docs/reviews/** не тронут.
• scripts/process-gate.mjs / test/process-gate.test.mjs — перечитал диф заново (полный разбор): оба файла в этом раунде меняют только строки комментариев и текст сообщений (#118 → #562, обновлённая формулировка), логика isInfrastructureRange/checkIssueStatuses не затронута — прогнал test/process-gate.test.mjs целиком (35/35) для проверки, что переименования не сломали ни одной проверки.

Проверка AC issue #562 (полная, по коду этого SHA)

AC	Проверка	Результат
AC1: AGENTS.md/PROCESS.md/локальный CODEX-RUNBOOK.md не закрепляют работу за Codex/Claude	Прочитал оба файла целиком в затронутых разделах: AGENTS.md «Agent-neutral workflow» — «No task type is reserved for Codex, Claude or any other named model»; PROCESS.md — таблица ролей по агентам заменена абзацем «Роли не закреплены за моделями или именами агентов». Таблица Исполнитель → роли из старой версии удалена полностью (git diff подтверждает: -| Исполнитель | Роли | и весь блок). CODEX-RUNBOOK.md — не в репозитории (путь C:\Users\...), вне материала ревью, как и на r1/r2	Выполнено для двух документов в репозитории; третий вне доказуемости этим ревью — унаследовано с r1
AC2: оба документа одинаково описывают продуктовый S1–S8 и инфраструктурный «без S → S7 ↔ S6 → S8»	PROCESS.md §2: инфраструктурный трек (§1): без S → S7-code-review ⟲ S6-in-progress → S8-merged; AGENTS.md: «Once the branch is ready and pushed, apply S7-code-review... green review... sets S8-merged; findings or a failed merge return the issue to S6-in-progress». Формулировки эквивалентны машиночитаемо (те же 4 состояния, та же стрелка возврата)	Выполнено
AC3: независимость автора/ревьюера, автоматическое ревью, автоматическое слияние, прямое разрешение владельца на выпуск	AGENTS.md: «Author and reviewer are independent agents/sessions... the reviewer must start without implementation context and must not be the author grading their own work»; releases остаются «explicitly commanded by the owner». Механизм автослияния (S7-code-review → controller → dev → S8-merged) в PROCESS.md не переписан по существу, только убрано закрепление за Claude/Codex в описании техреализации ревьюера («Текущая техническая реализация независимого ревьюера — anthropics/claude-code-action; это деталь автоматизации, а не закрепление роли»)	Выполнено
AC4: исторические документы ревью не переписываются	git diff origin/dev...HEAD --stat показывает docs/reviews/CODE-REVIEW-562-r1.md/-r2.md только как новые файлы (100% insertions); ни один файл вида CODE-REVIEW-*-r*.md/SPEC-REVIEW-*-r*.md другой задачи не в диапазоне	Выполнено

Находки

Нет. High — 0, Medium — 0, Low — 0. Находка r2 закрыта предметно (см. таблицу выше), новых находок в дельте 7b58f73e..d6180f7f и в остальном полном разборе не обнаружено.

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

• Регресс r2 (statusless infra-issue без ветки получал команду «жди S-метку») исправлен именно так, как просила находка: неопределённость явно названа («подсказка, не доказательство и не право»), а не превращена в новое безусловное доверие метке — граница r1 (метка не даёт прав, когда ветка/diff уже есть) не нарушена, подтверждено прогоном теста «the infra label alone never grants the accelerated track».
• Новый тест на регресс r2 не тавтологичен — воспроизвёл падение на предыдущем SHA через git worktree.
• classify() для вычисления branch.infrastructure переиспользуется из scripts/process-gate.mjs — тот же механический критерий, что у блокирующего гейта, а не отдельная копия правила.
• Ребейз конвейера не внёс интерференции: файлы, добавленные dev в это же дерево (#542, check-inputs.mjs/mutation-gate.mjs/docs/TESTING.md), не пересекаются ни с одним файлом, который трогает #562.
• Трейлеры Issue: #562 / User-Visible: no верны на всех трёх содержательных коммитах; изменение чисто инфраструктурное (класс A не тронут), changelog не требуется и не тронут.
• docs/reviews/** не переписан — только добавлены документы прошлых раундов задачи.

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

• Полный npx tsc --noEmit / npm test / npm run build не перегонял — переиспользован зелёный Validate именно на материале ревью (d6180f7f, ссылка выше); прогнал таргетно изменённые тестовые файлы и негативную пробу на предыдущем SHA вместо этого.
• node scripts/check-docs.mjs, browser-смоки, golden:verify, pytest tests_backend, npm run invariants — не запускал: diff не касается src/**, demo/**, Python или геометрии; smoke-select подтвердил отсутствие исполняемого frontend-диффа.
• Локальный CODEX-RUNBOOK.md владельца — физически вне репозитория и вне материала ревью, не проверялся (как и на r1/r2).
• Содержимое коммитов #542, попавших в дерево ребейзом, не ревьюировал повторно по существу — они уже прошли собственный код-ревью (docs/reviews/CODE-REVIEW-542-r1.md, зелёный вердикт) и не входят в диапазон origin/dev...HEAD этой задачи; проверил только отсутствие файловой интерференции с #562.

Вердикт: зелёный · заход r3 · блокирующих циклов 2/4 · High: 0 · Medium: 0

---

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

• Ветка: issue/562-agent-neutral-workflow, коммит d6180f7f5de6 — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
• Дерево материала: c34dca167de81bea95a3c17b8436bcecb1760dfd

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

• Тело issue: 520e2e2d0230ee82ee9e86795aa5e61e4172442aa24bea85a9429dd5aa7677ae
• Вердикт конвейера: green · High 0