orchestrator/docs/work-items/ORCH-060/03-acceptance-criteria.md

Критерии приёмки: ORCH-060

Work Item ID: ORCH-060

Формат: каждый критерий — Дано / Когда / Тогда, с однозначным PASS/FAIL.

---

AC-1 — Escalated-задача (retry == лимит) не разблокируется (главный кейс ET-013)

• Дано: задача на stage='development', без активного job, age >= grace, check_ci_green зелёный; в agent_runs ровно MAX_DEVELOPER_RETRIES (=3) записей agent='developer'.
• Когда: выполняется Reconciler.reconcile_gate_once().
• Тогда: стадия остаётся development; advance_stage/advance_if_gate_passed не приводит к смене стадии; unblocked_total == 0; новый developer/reviewer job не создаётся.
• PASS: стадия не изменилась И unblocked_total == 0 И нет новых job.
• FAIL: стадия стала review / появился новый job / unblocked_total > 0.

AC-2 — Граница: retry > лимита тоже пропускается

• Дано: то же, но developer-записей > MAX_DEVELOPER_RETRIES (например 4–5).
• Когда: reconcile_gate_once().
• Тогда: задача пропущена (как AC-1).
• PASS / FAIL: как AC-1.

AC-3 — Регресс happy-path: retry < лимита по-прежнему доигрывается

• Дано: development, без активного job, age >= grace, check_ci_green зелёный; developer-записей < MAX_DEVELOPER_RETRIES (например 0, 1 или 2).
• Когда: reconcile_gate_once().
• Тогда: задача доигрывается development → review; unblocked_total == 1; enqueue следующего агента происходит как раньше.
• PASS: стадия стала review И unblocked_total == 1.
• FAIL: задача пропущена / стадия не изменилась.

AC-4 — Граница ровно на лимите (==3) → skip, на (лимит−1) → advance

• Дано: две задачи-близнеца, идентичные кроме числа developer-записей: одна с MAX_DEVELOPER_RETRIES, другая с MAX_DEVELOPER_RETRIES − 1.
• Когда: reconcile_gate_once().
• Тогда: первая пропущена (skip), вторая доиграна (advance).
• PASS: ровно одна из двух доиграна (та, что −1).
• FAIL: обе доиграны / обе пропущены / доиграна задача на лимите.

AC-5 — Plane-статус Blocked → пропуск

• Дано: задача-кандидат F-1 (stage не-терминальный, без активного job, age >= grace, гейт зелёный), у которой текущий Plane-статус issue = Blocked; retry < лимита (чтобы изолировать именно этот гард).
• Когда: reconcile_gate_once().
• Тогда: задача пропущена; стадия не меняется; unblocked_total == 0.
• PASS: стадия не изменилась И unblocked_total == 0.
• FAIL: задача доиграна.

AC-6 — Plane-статус Needs Input → пропуск

• Дано: как AC-5, но Plane-статус = Needs Input.
• Когда: reconcile_gate_once().
• Тогда: задача пропущена (как AC-5).
• PASS / FAIL: как AC-5.

AC-7 — Тишина при пропуске (no spam)

• Дано: escalated-задача (как AC-1).
• Когда: reconcile_gate_once() (один или несколько тиков).
• Тогда: НЕ вызывается _note_unblock; нет лог-строки ... разблокирована; нет send_telegram; нет notify_qg_failure (пропуск — раньше оценки гейта).
• PASS: ни одна из перечисленных нотификаций не вызвана.
• FAIL: вызвана любая нотификация.

AC-8 — Никакого сетевого вызова гейта на escalated-задаче

• Дано: escalated-задача (как AC-1) с замоканным check_ci_green.
• Когда: reconcile_gate_once().
• Тогда: check_ci_green (через advance_if_gate_passed/_run_qg) НЕ вызывается для этой задачи — пропуск происходит раньше.
• PASS: мок гейта не вызван.
• FAIL: мок гейта вызван.

AC-9 — F-2 не доигрывает Blocked/Needs Input (регресс)

• Дано: issue в Plane-статусе Blocked или Needs Input (не входит в {in_progress, approved, rejected}).
• Когда: reconcile_plane_once().
• Тогда: ни handle_status_start, ни handle_verdict не вызываются для этого issue; unblocked_total == 0.
• PASS: обработчики не вызваны.
• FAIL: вызван любой обработчик.

AC-10 — Never-raise: ошибка проверки статуса не ломает тик

• Дано: проверка blocked/needs-input (Plane API в Варианте A) бросает исключение для одной задачи; в выборке есть ещё одна валидная задача.
• Когда: reconcile_gate_once().
• Тогда: тик не падает; сбойная задача консервативно НЕ трогается (skip); остальные обрабатываются.
• PASS: исключение изолировано, остальные задачи обработаны.
• FAIL: исключение всплыло из reconcile_gate_once.

AC-11 — Лимит не хардкодится

• Дано: код F-1-гарда.
• Тогда: используется stage_engine.MAX_DEVELOPER_RETRIES, а не литерал 3.
• PASS: граница берётся из константы.
• FAIL: в reconciler.py появился магический 3.

AC-12 — Документация обновлена (golden source)

• Дано: PR задачи.
• Тогда: обновлены docs/architecture/README.md (описание F-1 с новым skip), CHANGELOG.md, создан 06-adr/ADR-001-*.md.
• PASS: все три артефакта обновлены/созданы в этом же PR.
• FAIL: любой отсутствует (reviewer → REQUEST_CHANGES).

AC-13 — Регресс существующих тестов reconciler

• Дано: существующий tests/test_reconciler.py (ORCH-053).
• Когда: pytest tests/test_reconciler.py -q.
• Тогда: все прежние тесты зелёные (поведение happy-path/analysis/kill-switch не сломано).
• PASS: 0 регрессий.
• FAIL: любой ранее зелёный тест упал.