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

# CODE-REVIEW-562-r2

## Скоуп

Issue #562 «Process: отвязать роли и инфраструктурный трек от конкретных
агентов», заход r2, блокирующих циклов израсходовано 1/4 до этого раунда.

Материал ревью — ровно `8f000dd459393cd0d17e9cfa58513a68f7f5ffa1` (рабочая
копия уже на нём). Полный диапазон против `dev`: `origin/dev(9c08d583)..HEAD`
(два содержательных коммита — `53f0635e` разобран и получил жёлтый вердикт в
r1, `8f000dd4` — правка этого раунда; `00ac0875` — только документ r1).

Раунд не первый и предыдущий вердикт был жёлтым (Medium в скоупе), поэтому по
PROCESS.md §2.9 разбор ведётся по дельте: находка r1 плюс всё, до чего дельта
дотягивается, а не полный повторный прогон. Дельта раунда — ровно
`53f0635e..8f000dd4`:

```
scripts/task-packet.mjs   | 16 +++++++++++-----
test/task-packet.test.mjs | 17 +++++++++++++++--
2 files changed, 26 insertions(+), 7 deletions(-)
```

Это не ребейз (родитель тот же `dev`-merge-base `9c08d583`, что и в r1),
контракт поведения затронут ровно там же, где была находка r1, новая
подсистема не задета — сокращение объёма законно.

Трейлеры коммита `8f000dd4`: `Issue: #562`, `User-Visible: no` — верны
(правка внутри `scripts/**` и `test/**`, класс A не тронут, changelog не
нужен и не тронут).

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

| Гейт | Результат | Источник |
|---|---|---|
| `npx tsc --noEmit` / `npm test` (полный) / `npm run build` + сверка бандлов | зелёный | Validate на `8f000dd4`, https://github.com/Matysh/houseplan-card/actions/runs/34743589488 (переиспользован по инструкции, не перегонялся) |
| `node --test test/task-packet.test.mjs` (таргетно, по дельте) | зелёный, 9/9 | прогнан в этом ревью |
| Тест на старом коде (`53f0635e`) с тем же файлом теста | красный, 2/9 | прогнан в этом ревью через `git worktree` — доказывает, что новый негативный тест умеет падать (см. находки закрытия r1 ниже) |
| `node scripts/smoke-select.mjs --base 53f0635e --head 8f000dd4` | «Исполняемого frontend-диффа нет... Тронуто файлов: 3» | прогнан; смоки не выбираются — диффу нечего проверять браузером |
| `node scripts/check-docs.mjs` | не запускался | дельта не трогает `src/**` |
| `golden:verify`, `pytest tests_backend`, `npm run invariants` | не запускались | нет визуальных/Python/геометрических изменений |

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

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| Medium — `task-packet.mjs` определял «инфраструктурный» трек и запрет класса A по тематической метке `infra`, а не по механическому критерию из `process-gate.mjs`, из-за чего продуктовая задача с меткой `infra` + `S6-in-progress` получала неверный ответ «класс A трогать нельзя» | `rightsFor` больше не читает `infra` из `labels` вообще — трек передаётся явным параметром `{ infrastructure }`; `buildPacket` вычисляет его из `branch.infrastructure`, а тот в `collectInputs` — из реального diff `base..ref` через переиспользованный `classify()` из `process-gate.mjs` (тот же критерий, что у блокирующего гейта) | `scripts/task-packet.mjs:22,27,30,110-121,209-210`; воспроизведение — `node -e "rightsFor('S6-in-progress', ['infra'])"` теперь возвращает `'продуктовый код трогать МОЖНО'`, а не запрет |
| (следствие) отсутствие теста на комбинацию `infra` + реальная `S*`-метка | новый тест `test/task-packet.test.mjs:112-120` явно бьёт `labels: ['infra', 'S6-in-progress']` и требует `track === 'полный'` + разрешение на класс A | проверено запуском теста против кода r1 (`53f0635e`) — падает с `AssertionError: expected 'полный', actual 'инфраструктурный'`, то есть тест действительно ловит старый баг, а не проходит тавтологически |

Находка r1 закрыта полностью для того сценария, для которого была написана
(ложное «нельзя» для помеченной `infra` продуктовой задачи). Дельта, однако,
меняет ещё одну ветку того же кода (как трек вычисляется, когда ветки ещё
нет) — это и есть новая находка этого раунда, см. ниже.

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

Приняты без повторной проверки (дельта этого раунда их не касается):

- **AC1** (роли не закреплены за Codex/Claude в `AGENTS.md`/`PROCESS.md`;
  локальный `CODEX-RUNBOOK.md` вне материала) и **AC2** (оба документа
  одинаково описывают маршруты S1–S8 и инфра-без-S → S7 ↔ S6 → S8) —
  `AGENTS.md` и `PROCESS.md` дельтой `8f000dd4` не тронуты вовсе (диф
  ограничен `scripts/task-packet.mjs` и `test/task-packet.test.mjs`).
  Документ: `docs/reviews/CODE-REVIEW-562-r1.md`, SHA `53f0635e`.
- **AC3** (независимость автора/ревьюера, автоматическое ревью и слияние,
  разрешение владельца на выпуск) — механика конвейера этой дельтой не
  затронута. Документ: тот же, SHA `53f0635e`.
- **AC4** (исторические документы ревью не переписаны) — дельта `8f000dd4`
  не касается `docs/reviews/**` (см. `git show --stat 8f000dd4` в скоупе
  выше — только `scripts/` и `test/`). Документ: тот же, SHA `53f0635e`.
- `scripts/process-gate.mjs` и `test/process-gate.test.mjs` — не изменены
  этой дельтой (последний раз правились в `53f0635e`, только переименования
  сообщений/ссылки на issue); логика `isInfrastructureRange` не тронута.
  Документ: тот же, SHA `53f0635e`.

## Находки

### Medium (в скоупе) — после фикса статусless infra-issue без опубликованной ветки получает заведомо неверную подсказку «вне процесса, ждать S-метку владельца»

- **Файл:** `scripts/task-packet.mjs:118` (`const infrastructure = branch?.infrastructure === true;`) и `scripts/task-packet.mjs:39-51` (`rightsFor`, ветка `default`).
- **Что не так:** новый критерий полностью корректен, когда ветка уже
  опубликована и `collectInputs` успел посчитать diff. Но пока ветки на
  `origin/issue/NN-*` ещё нет (`refs[0]` пуст в `collectInputs`), `branch`
  остаётся `null`, и `infrastructure` теперь **всегда** `false` — старый
  путь через `labels.includes('infra')`, который умел ответить верно даже
  без ветки, убран целиком, а альтернативы для случая «ветки ещё нет» не
  появилось.

  Это ровно момент, для которого сама задача #562 вводит ускоренный трек:
  «Инфраструктурная задача выполняется сразу... без стадий S1–S6 до первого
  хендоффа. По готовности ветка публикуется» (тело issue). И это ровно
  прописанный сценарий использования инструмента: `AGENTS.md:378` — «Start a
  task from its packet... node scripts/task-packet.mjs --issue NN» — команда,
  которую в первую очередь запускают при взятии задачи, то есть до того, как
  какая-либо ветка опубликована.

- **Воспроизведение:**

  ```
  $ node -e "import('./scripts/task-packet.mjs').then(({ buildPacket }) =>
      console.log(buildPacket({
        issue: { number: 999, title: 'infra no branch yet', state: 'OPEN', url: 'u', body: '' },
        labels: ['infra'],
      })))"
  track: полный
  rights: [
    'продуктовый код трогать НЕЛЬЗЯ: статус не S5/S6/S7 (правило №1)',
    'статусной метки нет — продуктовая задача вне процесса; вход — первая S*-метка владельца'
  ]
  ```

  На коде r1 (`53f0635e`) тот же вызов давал верный ответ:

  ```
  track: инфраструктурный
  rights: [
    'файлы класса A трогать НЕЛЬЗЯ; инфраструктурную реализацию МОЖНО вести сразу по issue (#562)',
    'инфраструктурный вход: реализовать и проверить → push ветки → S7-code-review; ТЗ и S1–S6 не нужны (#562)'
  ]
  ```

  Это регресс, внесённый именно правкой этого раунда, а не унаследованная
  проблема: до `8f000dd4` тот же вход обрабатывался верно.

- **Почему это не поймал новый тест:** оба новых/изменённых теста этого
  раунда (`test/task-packet.test.mjs:20-24,112-120`) передают `branch`
  явным объектом с уже посчитанным `infrastructure`. Ни один тест не
  вызывает `buildPacket`/`rightsFor` для statusless `infra`-issue **без**
  `branch` — то есть без ветки, что и есть штатное состояние в момент
  «взять задачу и вызвать пакет».

- **Серьёзность:** Medium, в скоупе (файл и тест изменены этим же диффом).
  Не High: `task-packet.mjs` — консультативный инструмент, ничего не решает
  и не блокирует ни один реальный push; блокирующий гейт (`process-gate.mjs`)
  метку не читает и этой правкой не затронут. Риск — неверная подсказка
  ровно в момент, когда агент решает, можно ли начинать инфраструктурную
  реализацию без S-метки: вместо разрешения «делай сразу» пакет теперь
  говорит «жди S-метку от владельца», что для инфра-трека прямо противоречит
  тексту issue #562 и `PROCESS.md`.
- **Что чинить:** для случая без ветки не возвращать уверенное «вне
  процесса» — либо явно писать неопределённость («трек не подтверждён без
  diff опубликованной ветки; по метке `infra` похоже на инфраструктурный»),
  либо (эквивалент предложения r1, вариант «привязать трек к metки без
  diff», применённый только к before-branch состоянию) при отсутствии ветки
  временно доверять `labels.includes('infra')` как единственному
  доступному сигналу, но маркировать его в выводе как непроверенный
  diff'ом, а не как решённый факт.

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

- Находка r1 закрыта именно так, как и была сформулирована: `task-packet.mjs`
  для мисклассифицированной продуктовой задачи (`infra` + реальная
  `S6-in-progress`) больше не запрещает класс A — трек и права теперь
  выводятся из того же механического критерия (`classify()` из
  `process-gate.mjs`), что и у блокирующего гейта, а не из темы issue.
- Новый тест `#562: the infra label alone never grants the accelerated
  track` — не тавтологичен: проверено падением на снапшоте `53f0635e`
  (`AssertionError`, 2 упавших теста из 9).
- Тесты дельты: 9/9 зелёных на `8f000dd4`.
- Трейлеры `Issue: #562` / `User-Visible: no` верны; класс A не тронут;
  changelog не требуется и не тронут — соответствует характеру правки.
- `docs/reviews/**` этой дельтой не тронут — AC4 остаётся выполненным.
- `smoke-select` подтверждает: diff не задевает `src/**`/`demo/**`, браузерные
  смоки этому раунду не нужны.

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

- Полный `npx tsc --noEmit` / `npm test` / `npm run build` не перегонялись —
  переиспользован зелёный Validate на этом самом SHA `8f000dd4` (ссылка
  выше); вместо этого таргетно перегнан изменённый тестовый файл и его же
  версия на предыдущем SHA (для проверки «тест умеет падать»).
- `AGENTS.md`, `PROCESS.md`, локальный `CODEX-RUNBOOK.md` — не перечитывались
  заново: дельта раунда их не трогает (см. «Унаследовано из r1»).
- `check-docs`, browser-смоки, `golden:verify`, `pytest tests_backend`,
  `npm run invariants` — не запускались: дельта ограничена `scripts/**` и
  `test/**`, ни `src/**`, ни `demo/**`, ни Python, ни геометрия не тронуты.
- Реальное поведение `scripts/process-gate.mjs` (блокирующий гейт) — не
  перепроверялось: этой дельтой файл не изменён, вывод r1 (диффо-зависимый,
  метку `infra` не читает) остаётся в силе.

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

- SHA материала: `8f000dd459393cd0d17e9cfa58513a68f7f5ffa1`
- Дельта раунда: `53f0635eddcd66346bca3bc2a92056d333ed1ca3..8f000dd459393cd0d17e9cfa58513a68f7f5ffa1` (2 файла, 26 строк)
- Полный диапазон против `dev`: `origin/dev(9c08d583)..HEAD`
- Дерево: рабочая копия на этом SHA во время всего разбора

---

<!-- material-anchors: сгенерировано конвейером (#414) -->

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

- Ветка: `issue/562-agent-neutral-workflow`, коммит `8f000dd45939` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
- Дерево материала: `36ef122f5778df5144077d79a3584a54a421ee1e`
  ```
  git log --all --format='%H %T' | grep 36ef122f5778
  ```
- Тело issue: `520e2e2d0230ee82ee9e86795aa5e61e4172442aa24bea85a9429dd5aa7677ae`
- Вердикт конвейера: `yellow` · High 0