docs(ORCH-021): post-deploy HEALTHY/NONE for ORCH-026

.env.example

@@ -12,47 +12,6 @@ ORCH_GITEA_WEBHOOK_SECRET=
 ORCH_CLAUDE_BIN=/usr/bin/claude
 ORCH_REPOS_DIR=/home/slin/repos
 ORCH_DB_PATH=/app/data/orchestrator.db
-
-# ── Agent model / effort / fallback (ORCH-41, validation ORCH-74) ─────────────
-# Per-agent LLM model + reasoning effort, resolved by launcher.resolve_agent_*.
-# Resolution priority (per agent): project-override (projects_json agent_models/
-# agent_efforts) > ORCH_AGENT_MODEL_<AGENT> / ORCH_AGENT_EFFORT_<AGENT> >
-# ORCH_AGENT_MODEL_DEFAULT / ORCH_AGENT_EFFORT_DEFAULT > CLI default (no flag).
-# The frontmatter `model:` in .openclaw/agents/*.md is DESCRIPTIVE only and is NOT
-# read — config below is the single source of truth for the model (ORCH-74 G1).
-#
-# ORCH-74 (G2): a resolved MODEL name is validated (^claude-…$ format check) before
-# it reaches --model. A structurally invalid name (typo, gpt-4, empty) is logged and
-# the next valid level is used (in the limit: no --model flag). Forward-compatible:
-# a future claude-* version passes without editing any allowlist. EFFORT is validated
-# against low|medium|high|xhigh|max (ORCH-41); an invalid effort is dropped.
-#
-# All 6 agents resolve to claude-opus-4-8 (model-routing G3 NOT enabled). Leave the
-# per-agent overrides empty to use the default. Do NOT hardcode the model version
-# anywhere except ORCH_AGENT_MODEL_DEFAULT.
-ORCH_AGENT_MODEL_DEFAULT=claude-opus-4-8
-ORCH_AGENT_MODEL_ANALYST=
-ORCH_AGENT_MODEL_ARCHITECT=
-ORCH_AGENT_MODEL_DEVELOPER=
-ORCH_AGENT_MODEL_REVIEWER=
-ORCH_AGENT_MODEL_TESTER=
-ORCH_AGENT_MODEL_DEPLOYER=
-# Effort split (ORCH-081/ORCH-52h): thinking agents (analyst/architect/reviewer)
-# -> high; developer -> xhigh (coding/agentic role, Opus 4.8 canon); mechanical
-# agents (tester/deployer) -> medium. NB: an empty ORCH_AGENT_EFFORT_*= no longer
-# zeroes the effort — the launcher falls back to a per-role floor (= the config.py
-# class-default) so each role still runs at its canonical level (ORCH-081).
-ORCH_AGENT_EFFORT_DEFAULT=high
-ORCH_AGENT_EFFORT_ANALYST=high
-ORCH_AGENT_EFFORT_ARCHITECT=high
-ORCH_AGENT_EFFORT_DEVELOPER=xhigh
-ORCH_AGENT_EFFORT_REVIEWER=high
-ORCH_AGENT_EFFORT_TESTER=medium
-ORCH_AGENT_EFFORT_DEPLOYER=medium
-# Optional --fallback-model used when the primary is overloaded. Empty -> no flag
-# (G4 NOT enabled, ADR-001 ORCH-74: determinism — all agents stay on opus-4-8). A
-# non-empty value is validated by the SAME predicate as the model; a typo is dropped.
-ORCH_AGENT_FALLBACK_MODEL=
 # ORCH-042/ORCH-067: live-tracker mode. bump (DEFAULT since ORCH-067) -> on every
 # update the old card is deleted and a fresh one is sent silently to the BOTTOM of
 # the chat (deleteMessage + sendMessage + repoint), so the current status is always
@@ -107,20 +66,6 @@ ORCH_PREMERGE_REBASE_ALWAYS=true
 #     cache them into job_deps (the scheduler then reads only the DB).
 ORCH_TASK_DEPS_ENABLED=true
 ORCH_TASK_DEPS_SOURCE=db
-# ORCH-088 (Stage 1, serial e2e): per-repo serial gate. A NEW task's analyst-job does
-# NOT enter analysis (no branch cut, no analyst) while the same repo has an EARLIER
-# unfinished task (FIFO, tasks.id < the job's task) OR the repo is frozen. The branch
-# cut is DEFERRED from start_pipeline to the analyst-job claim so its base is a fresh
-# origin/main already containing the predecessor (anti-stale-base). Gate lives in
-# claim_next_job (offline hot-path, fail-OPEN on error); freeze (FR-5) is a durable
-# repo_freeze row set on post-deploy DEGRADED, cleared manually via
-# POST /serial-gate/unfreeze?repo=<repo>. Leaf src/serial_gate.py (never-raise).
-#   SERIAL_GATE_ENABLED=false -> claim AND start_pipeline are 1:1 as before ORCH-088.
-#   SERIAL_GATE_REPOS (CSV) -> scope; EMPTY = ALL repos (not self-hosting-only).
-#   SERIAL_GATE_FREEZE_ENABLED=false -> the rollback-freeze layer is off (not set/read).
-ORCH_SERIAL_GATE_ENABLED=true
-ORCH_SERIAL_GATE_REPOS=
-ORCH_SERIAL_GATE_FREEZE_ENABLED=true
 # ORCH-071/073: merge-verify under-gate on the `deploy -> done` edge (врезка in
 # advance_stage, NOT a new STAGE_TRANSITIONS edge / registered QG). A deterministic
 # merge-actor merges the feature code-PR via the Gitea PR-merge API (never push/
@@ -137,17 +82,11 @@ ORCH_SERIAL_GATE_FREEZE_ENABLED=true
 #   REGRESSION_GUARD_ENABLED  -> kill-switch for the ORCH-073 main-integrity regression
 #                                guard (false -> SHA-in-main alone gates done); reuses the
 #                                merge-verify scope, so non-self repos are a no-op.
-#   MERGE_VERIFY_AUTOCREATE_PR_ENABLED -> ORCH-082: guarantee an open code-PR
-#                                (head==branch, base==main) via merge_gate.ensure_open_pr
-#                                BEFORE the deterministic merge_pr (fixes the false HOLD
-#                                "no open PR"). false -> exactly pre-ORCH-082 behaviour.
-#                                Reuses the merge-verify scope; non-self repos -> no-op.
 ORCH_MERGE_VERIFY_ENABLED=true
 ORCH_MERGE_VERIFY_REPOS=
 ORCH_MERGE_PR_TIMEOUT_S=60
 ORCH_MERGE_VERIFY_TIMEOUT_S=60
 ORCH_REGRESSION_GUARD_ENABLED=true
-ORCH_MERGE_VERIFY_AUTOCREATE_PR_ENABLED=true
 # ORCH-036: executable self-deploy of the `deploy` stage. For the self-hosting repo
 # (orchestrator) the stage REALLY restarts prod (8500) via a detached host hook;
 # deploy_status: SUCCESS means proven health-ok, not an LLM declaration. Three

.openclaw/agents/analyst.md

@@ -1,6 +1,7 @@
 ---
 name: analyst
 description: Бизнес-аналитик. Создаёт пакет документов анализа для work item.
+model: claude-sonnet-4-6
 tools:
   - Filesystem (Read везде; Write только docs/work-items/<plane-id>/*)
   - Bash (git log, grep — только для чтения контекста)

.openclaw/agents/architect.md

@@ -1,6 +1,7 @@
 ---
 name: architect
 description: Архитектор системы. Принимает архитектурные решения по ТЗ, фиксирует как ADR.
+model: claude-opus-4-7
 tools:
   - Filesystem (Read везде; Write только docs/)
   - Bash (read-only: grep, git log)

.openclaw/agents/deployer.md

@@ -1,6 +1,7 @@
 ---
 name: deployer
 description: DevOps-агент. Запускает staging-проверку и/или прод-деплой. Пишет 15-staging-log.md и 14-deploy-log.md.
+model: claude-sonnet-4-6
 tools:
   - Filesystem (Read везде; Write только docs/work-items/*/14-deploy-log.md, docs/work-items/*/15-staging-log.md)
   - Bash (docker, git, curl, ssh)

.openclaw/agents/developer.md

@@ -1,6 +1,7 @@
 ---
 name: developer
 description: Senior разработчик. Реализует ТЗ по ADR, пишет тесты, открывает PR.
+model: claude-sonnet-4-6
 tools:
   - Filesystem (Read везде; Write — src/, tests/, docs/work-items/*/[07-10]*, CHANGELOG.md)
   - Git (commit, push; merge запрещён)

.openclaw/agents/reviewer.md

@@ -1,6 +1,7 @@
 ---
 name: reviewer
 description: Senior code reviewer. Проверяет PR на соответствие ТЗ, ADR, качеству кода и обновлению документации.
+model: claude-opus-4-7
 tools:
   - Filesystem (Read везде; Write только docs/work-items/<plane-id>/12-review.md)
   - Git (read-only: log, diff, blame)

.openclaw/agents/tester.md

@@ -1,6 +1,7 @@
 ---
 name: tester
 description: QA-инженер. Прогоняет тесты, оформляет отчёт.
+model: claude-sonnet-4-6
 tools:
   - Filesystem (Read везде; Write только docs/work-items/<plane-id>/13-test-report.md)
   - Bash (pytest, curl)

.task-dev.md

@@ -1,4 +1,4 @@
-Work item: ORCH-088
+Work item: ORCH-061
 Repo: orchestrator
-Branch: feature/ORCH-088-orch-88-10-20
+Branch: feature/ORCH-061-bug-deploy-staging-development
 Stage: development

CLAUDE.md

@@ -6,8 +6,8 @@
 ## Стек
 - Backend: FastAPI + uvicorn (Python 3.12)
 - БД: SQLite (`src/db.py`)
-- Агенты: Claude CLI (`ORCH_CLAUDE_BIN`), по одному промпту на роль в `.openclaw/agents/`. **ORCH-74:** модель/эффорт агента берутся ТОЛЬКО из config (`resolve_agent_model`/`resolve_agent_effort`, ORCH-41) — frontmatter `model:` удалён как мёртвый, frontmatter описательный; имя модели валидируется форматом `^claude-…$` перед `--model` (never-break).
-- Очередь задач: собственная (SQLite `jobs`, `src/queue_worker.py`, ORCH-1). **ORCH-026:** `claim_next_job` гейтит задачи с незавершёнными зависимостями (`job_deps`, `NOT EXISTS`) без занятия слота `max_concurrency`; декларации/детект циклов — leaf `src/task_deps.py` (kill-switch `ORCH_TASK_DEPS_ENABLED`). Сериализация мержа одного репо — безусловный pre-merge rebase под merge-lease (`ORCH_PREMERGE_REBASE_ALWAYS`). **ORCH-088 (serial gate, Этап 1):** новая задача репо не входит в `analysis` (analyst-job не выбирается, ветка не режется), пока в репо есть **более ранняя** незавершённая задача (`t2.id < jobs.task_id`, FIFO) ИЛИ репо заморожен (`repo_freeze`). Срез ветки **отложен** со `start_pipeline` на момент claim analyst-job (`launcher._materialize_deferred_branch`) — база = свежий `origin/main` с кодом предшественника (анти-stale-base). Post-deploy `DEGRADED` → durable per-repo freeze (`repo_freeze`, `cleared_at IS NULL` = активен) + Telegram; снятие — вручную `POST /serial-gate/unfreeze?repo=…`. Leaf `src/serial_gate.py` (claim — fail-OPEN, freeze — fail-CLOSED); флаги `ORCH_SERIAL_GATE_ENABLED` (kill-switch), `ORCH_SERIAL_GATE_REPOS` (CSV; пусто = все репо), `ORCH_SERIAL_GATE_FREEZE_ENABLED`. Блок `serial_gate` в `GET /queue`. `STAGE_TRANSITIONS`/`QG_CHECKS` не тронуты.
+- Агенты: Claude CLI (`ORCH_CLAUDE_BIN`), по одному промпту на роль в `.openclaw/agents/`
+- Очередь задач: собственная (SQLite `jobs`, `src/queue_worker.py`, ORCH-1). **ORCH-026:** `claim_next_job` гейтит задачи с незавершёнными зависимостями (`job_deps`, `NOT EXISTS`) без занятия слота `max_concurrency`; декларации/детект циклов — leaf `src/task_deps.py` (kill-switch `ORCH_TASK_DEPS_ENABLED`). Сериализация мержа одного репо — безусловный pre-merge rebase под merge-lease (`ORCH_PREMERGE_REBASE_ALWAYS`).
 - Контейнеризация: Docker + Compose
 - CI/CD: Gitea Actions (`.gitea/workflows/`)
 - Деплой: docker compose на mva154
@@ -41,92 +41,36 @@ created → analysis → architecture → development → review → testing →
 ## Статусная модель Plane (ORCH-066) — индикация ≠ управление
 Статусы Plane — это **слой B (индикация)**, отдельный от **слоя A (машина стадий)** `src/stages.py::STAGE_TRANSITIONS`. Plane показывает наблюдателю осмысленную картину (`Backlog → Todo → Analysis → Architecture → Development → Code-Review → Testing → Awaiting Deploy → Deploying → Monitoring after Deploy → Done` + человеческие гейты `In Review/Approved`, `Confirm Deploy`), но НИКОГДА не управляет конвейером. Маппинг и сеттеры — `src/plane_sync.py` (6 новых ключей: `to_analyse/analysis/code_review/awaiting_deploy/deploying/monitoring`), с project-relative alias-fallback: на частично сконфигурированном проекте новый ключ деградирует на базовый UUID ТОГО ЖЕ проекта (нулевая регрессия для enduro-trails). Детали — `docs/architecture/README.md`.
 
-## Нотификации / Telegram live-tracker (ORCH-042/066/067/087)
+## Нотификации / Telegram live-tracker (ORCH-042/066/067)
 Каждая задача = **одна карточка** в Telegram (`src/notifications.py`). Поведение карточки:
 - **Дефолт `tracker_mode` — `bump`** (ORCH-067; `edit` доступен через `ORCH_TRACKER_MODE=edit`).
   `bump` на каждом обновлении удаляет старую карточку и шлёт свежую вниз чата (тихо), `edit`
   редактирует на месте. Инвариант «одна карточка на задачу» — в обоих режимах.
-- **Зачистка сирот (ORCH-087):** bump ведёт авторитетный леджер ВСЕХ созданных карточек
-  (таблица `tracker_messages`, `deleted_at IS NULL` = жива) и на каждом обновлении удаляет
-  ВСЕ незакрытые mid, а не только скаляр `tracker_message_id` (он сохранён как указатель на
-  текущую карточку, BC). Это устраняет класс «замёрзшая сирота» (старая карточка с заголовком
-  ранней стадии, потерявшая ссылку при гонке/`delete`-fail+`send`-ok). Новый mid пишется в
-  леджер ТОЛЬКО при успешном `send` (BR-6); transient-`delete` остаётся незакрытым для ретрая;
-  «already gone»/>48ч (`_DELETE_GONE_MARKERS`) → закрывается. Остаточная гонка самозалечивается
-  за один bump. Known-limitation: Telegram 48ч (сироты старше неудаляемы).
-- **Эффорт в строке стадии (ORCH-087):** колонка `agent_runs.effort` стампится фактическим
-  `resolve_agent_effort` в `launcher._spawn` (CLI его в result-JSON не возвращает); строка
-  рендерится `· {model} · {effort}` (developer=`xhigh`, tester/deployer=`medium`, прочие=`high`);
-  пустой/исторический effort → суффикс опускается.
-- **Честное итоговое время (ORCH-087):** done-строка = три независимых подписанных метрики
-  `⏱️ Агенты {Σ agent_runs} · твоё {review~cap} · общее с ожиданием {wall}` (раньше `Всего {wall}`
-  читалось как сумма, которой не является). «Твоё» ограничено `tracker_brd_review_cap_s`
-  (`ORCH_TRACKER_BRD_REVIEW_CAP_S`, дефолт 2ч; маркер `~` при отсечке аномального застоя).
 - **Статус-строка карточки** (`📍 <status_label>`) показывает текущий Plane-статус по модели
   ORCH-066 (`plane_status_label`). Оффлайн-ядро (`stage → статус`, In Review из brd-clock)
   работает всегда без сети; best-effort live-overlay (kill-switch `tracker_live_status`,
   TTL-кэш, короткий таймаут) лишь дорисовывает ветки, неотличимые offline (Needs Input /
-  Blocked / Rejected / Cancelled / **Confirm Deploy** / Deploying / Monitoring) и **никогда не
-  блокирует конвейер**.
+  Blocked / Rejected / Cancelled / Deploying / Monitoring) и **никогда не блокирует конвейер**.
 - **Кликабельный номер задачи** (`plane_issue_link`) — `ORCH-NNN` в карточке И во всех
   уведомлениях (`notify_*`, alert'ы стадий) рендерится как `<a href=…>` на issue в Plane;
   fail-safe → просто `html.escape(номер)`, если ссылку построить нельзя. Никогда не падает.
-- **Без link-preview (ORCH-080):** оба примитива (`send_telegram`/`edit_telegram`) шлют
-  payload с `disable_web_page_preview: True` — баннер Plane («Modern project management»)
-  под кликабельной ссылкой `ORCH-NNN` больше не разворачивается ни в карточке (`bump`/`edit`),
-  ни в notify/alert-сообщениях. `parse_mode: HTML` сохранён → ссылка остаётся кликабельной.
 - Транспорт (`send_telegram`/`edit_telegram`/`delete_telegram`), `disable_notification`
   (карточка тихая, пингуют только alert-хелперы), схема БД — не трогаются.
 
-## Авто-режим по лейблам: autoApprove + autoDeploy (ORCH-089)
-Конвейер имеет два **человеческих** гейта, тормозящих пакетный автономный прогон
-(эпик ORCH-088): гейт BRD (`analysis`: ручной `Approved`) и гейт прод-деплоя
-(`deploy` Phase A: ручной `Confirm Deploy`, ORCH-059). ORCH-089 снимает **только эти
-два человеческих решения** — выборочно (лейбл Plane на задаче), декларативно,
-обратимо, **не трогая ни одной технической проверки**. Инвариант: авто-режим снимает
-лишь ожидание человеческого сигнала; `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/схема БД
-— **не трогаются**. Аддитивно: leaf `src/labels.py` (never-raise) + две точечные врезки.
-- **`autoApprove`** → врезка в `stage_engine._handle_analysis_approved_flow` (ветка
-  `files_ok`): `set_issue_approved` (индикация) + лог/Telegram/Plane-коммент +
-  `advance_stage(..., finished_agent=None)` — **тот же путь, что человеческий Approved**
-  (`approved-via-status` → `analysis → architecture` + `mark_brd_review_ended`).
-- **`autoDeploy`** → врезка в `stage_engine._handle_self_deploy_phase_a` после advance
-  на `deploy` + `clear_state`: лог/Telegram/Plane-коммент + `_handle_self_deploy_phase_b`
-  (маркер `INITIATED`, статус `Deploying`, finalizer). Пропускаются лишь
-  индикативно-человеческие шаги. **BR-5 структурно:** Phase A достигается только после
-  зелёных под-гейтов ребра `deploy-staging → deploy` (security → merge-gate →
-  image-freshness → staging) → autoDeploy физически не деплоит сломанное.
-- **Чтение лейблов** — `plane_sync.fetch_issue_labels` (`None` при ошибке ≠ `[]`) +
-  `get_project_labels` (`{normalized_name→uuid}`, TTL-кэш); сопоставление по
-  нормализованному имени (`strip().casefold()`), неоднозначность → «нет лейбла».
-  Источник истины — Plane API, не payload вебхука. Новый сеттер `set_issue_approved`.
-- **Флаги** (`config.py`): `auto_label_enabled` (kill-switch), `auto_approve_label`/
-  `auto_deploy_label`, `auto_label_repos` (CSV; **пусто → self-hosting only**),
-  `auto_label_states_ttl_s`. `applies(repo)` (локальный) проверяется ПЕРВЫМ; `has_label`
-  (сеть) — только при `applies==True` → при выключенном флаге нулевой сетевой оверхед.
-- **Fail-safe (never auto):** любая ошибка/недоступность Plane/неоднозначность →
-  «нет авто» → ручной гейт (never-raise). Прозрачность: лог + Telegram + Plane-коммент +
-  live-карточка; блок `auto_labels` в `GET /queue`. **Инфра-предусловие:** создать лейблы
-  `autoApprove`/`autoDeploy` в Plane-проекте ORCH (их отсутствие = ручной режим, fail-safe).
-  Детали — `docs/work-items/ORCH-089/06-adr/ADR-001-auto-label-gates.md`,
-  `docs/architecture/adr/adr-0018-auto-label-gates.md`.
-
 ## Конвенции
 - Conventional Commits (`feat:`, `fix:`, `docs:`, `refactor:`, `test:`)
 - Ветки: `feature/ORCH-NNN-slug`, `fix/ORCH-NNN-slug`
 - ADR per work-item: `docs/work-items/<plane-id>/06-adr/ADR-NNN-slug.md`
 - Global ADR (сквозные решения): `docs/architecture/adr/adr-NNNN-slug.md`
 - Work items: `docs/work-items/<plane-id>/`
-- Машинные вердикты Quality Gate — строго YAML-frontmatter (`verdict:`, `deploy_status:`, `staging_status:`, `security_status:`), никогда проза. **ORCH-52c (ORCH-076):** парсинг frontmatter сведён к единому контракту `src/frontmatter.py` (reader `read_frontmatter_value` — BC; единый парс-примитив `parse_frontmatter`; writer `render/write_frontmatter`; валидатор схемы `validate_schema`/`REQUIRED_FIELDS` — warning-only по умолчанию, hard-fail только под kill-switch `frontmatter_validation_strict`, дефолт `False`). Пять вердикт-парсеров (`check_reviewer_verdict`, `_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status`, `parse_security_status`) читают через ОДНУ точку парсинга; семантика вердиктов и `STAGE_TRANSITIONS`/состав `QG_CHECKS` — 1:1. Формальная спека «стадия → обязательный выход» + обязательная frontmatter-схема — `docs/_standards/HANDOFF_PROTOCOL.md`
+- Машинные вердикты Quality Gate — строго YAML-frontmatter (`verdict:`, `deploy_status:`, `staging_status:`, `security_status:`), никогда проза
 
 ## Артефакты задачи (`docs/work-items/<plane-id>/`)
 `00-business-request.md`, `01-brd.md`, `02-trz.md`, `03-acceptance-criteria.md`, `04-test-plan.yaml`, `06-adr/ADR-NNN-slug.md`, `07-infra-requirements.md`, `08-data-requirements.md`, `10-tech-risks.md`, `12-review.md`, `13-test-report.md`, `14-deploy-log.md`, `15-staging-log.md`, `16-post-deploy-log.md` (post-deploy наблюдение, ORCH-021), `17-security-report.md` (security-гейт: `security_status:`/secrets/deps, ORCH-022).
 
-**Стандарт документов (ORCH-075, ORCH-52b):** структура каждого дока, карта «стадия→агент→документ→гейт→machine-key» и конвенция ADR-naming зафиксированы в `docs/_standards/PIPELINE_DOCS.md` (golden source); копируемые скелеты — в `docs/_templates/`. Перед написанием номерного дока бери скелет из `docs/_templates/` и не меняй имя machine-key frontmatter (регистр чувствителен — иначе гейт упадёт ложно).
-
 ## Правила для агентов
 1. Перед любым действием прочесть этот файл и `docs/architecture/README.md`.
-2. **Документация = golden source наравне с кодом.** Изменил функционал → обнови доку В ТОМ ЖЕ PR. Архитектурное решение → заведи ADR (формат — `docs/_standards/PIPELINE_DOCS.md` §4). Структура номерных доков и шаблоны — `docs/_standards/PIPELINE_DOCS.md` + `docs/_templates/`. Обнови `CHANGELOG.md`.
+2. **Документация = golden source наравне с кодом.** Изменил функционал → обнови доку В ТОМ ЖЕ PR. Архитектурное решение → заведи ADR. Обнови `CHANGELOG.md`.
 3. Никогда не править артефакты других этапов.
 4. Никогда не комментировать ТЗ задним числом — если ТЗ не годится, возвращай в Анализ.
 5. Никогда не закрывать задачу самостоятельно — это делает CI / финальная стадия.

README.md

@@ -121,7 +121,6 @@ uvicorn src.main:app --reload --port 8500
 | `ORCH_REPOS_DIR` | Repos dir (container) | `/repos` |
 | `ORCH_HOST_REPOS_DIR` | Repos dir (host) | `/home/slin/repos` |
 | `ORCH_DB_PATH` | SQLite path | `/app/data/orchestrator.db` |
-| `ORCH_RUNS_DIR` | Базовый каталог per-run логов агентов (`<runs_dir>/{run_id}.log`, ORCH-087) | `/app/data/runs` |
 | `ORCH_MAX_CONCURRENCY` | Сколько jobs воркер запускает параллельно (ORCH-1) | `1` |
 | `ORCH_QUEUE_POLL_INTERVAL` | Период опроса очереди воркером, сек (ORCH-1) | `2.0` |
 | `ORCH_PREFLIGHT_CACHE_TTL` | Кэш preflight (CLI/net), сек (ORCH-1 resilience) | `45` |

docs/_standards/HANDOFF_PROTOCOL.md

@@ -1,118 +0,0 @@
-# HANDOFF_PROTOCOL — формальный контракт handoff «стадия → обязательный выход»
-
-> **Назначение.** Нормативная спека: что КАЖДАЯ стадия конвейера обязана оставить на выходе —
-> какие документы и какие frontmatter-ключи. Дополняет [`PIPELINE_DOCS.md`](PIPELINE_DOCS.md)
-> (карта «документ → агент → стадия → гейт → machine-key») «вертикальным» срезом по стадиям и
-> вводит **обязательную frontmatter-схему** для машинной проверки.
->
-> **Статус истины (важно).** Источник истины поведения — **код**: `src/stages.py`
-> (`STAGE_TRANSITIONS`), `src/qg/checks.py` (`QG_CHECKS` / `check_*` / `_parse_*`),
-> `src/stage_engine.py` (врезки под-гейтов). Машинный контракт чтения/записи/валидации
-> frontmatter — `src/frontmatter.py`. Эта спека **документирует**; при расхождении первичен код
-> (правило ORCH-075).
-
-Введено задачей **ORCH-076** (ORCH-52c — слой 2 эпика ORCH-52: машинный контракт). Слой 1
-(ORCH-075/52b) дал описательный стандарт документов; ORCH-52c реализовала единый машинный
-frontmatter-контракт (reader + writer + валидатор) и свела чтение пяти вердиктов к одной точке
-парсинга. Сквозной ADR: [`adr-0020-frontmatter-contract.md`](../architecture/adr/adr-0020-frontmatter-contract.md);
-детально — [`ORCH-076/06-adr/ADR-001-frontmatter-contract.md`](../work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md).
-
----
-
-## 1. Обязательная frontmatter-схема (машинный источник: `frontmatter.REQUIRED_FIELDS`)
-
-Forward-looking аддитивная схема: набор полей, которые handoff-документ стадии **должен** нести
-в ведущем YAML-frontmatter. Машинный источник истины — кортеж
-[`src/frontmatter.py`](../../src/frontmatter.py) `REQUIRED_FIELDS`:
-
-| Поле | Смысл |
-|------|-------|
-| `work_item` | ID задачи (`ORCH-NNN` / `ET-NNN`) — к какой задаче относится выход |
-| `stage` | стадия, на выходе которой написан документ (`analysis` … `deploy`) |
-| `author_agent` | роль-автор (`analyst` / `architect` / `developer` / `reviewer` / `tester` / `deployer`) |
-| `status` | человеко/машинно-читаемый статус выхода стадии |
-| `created_at` | дата создания артефакта (YYYY-MM-DD) |
-| `model_used` | модель агента, сгенерировавшего артефакт (`claude-…`) |
-
-**Режим проверки (ORCH-52c, критично для self-hosting).** Валидатор схемы
-`frontmatter.validate_schema` / `maybe_warn_schema` по умолчанию **warning-only** и **никогда не
-влияет на boolean-вердикт ни одного гейта**: отсутствие полей логируется (`logger.warning`), но не
-роняет конвейер и не заваливает гейт. Жёсткий режим (hard-fail) зарезервирован на будущее
-(ORCH-52d) и включается ТОЛЬКО kill-switch'ем `frontmatter_validation_strict`
-(env `ORCH_FRONTMATTER_VALIDATION_STRICT`, дефолт `False`). Схема **аддитивна**: старый
-документ-вердикт без этих полей читается гейтом ровно как раньше (см. §3).
-
----
-
-## 2. Контракт handoff по стадиям
-
-Категории документов — как в `PIPELINE_DOCS.md` §2: **required** (всегда), **when-applicable**
-(при наличии предмета: инфра / данные / security / post-deploy — отсутствие не нарушение).
-«Machine-verdict ключ» — поле, которое exit-гейт/под-гейт ребра читает ТОЛЬКО из frontmatter
-(никогда из прозы). Набор документов/ключей/гейтов **согласован 1:1 с `PIPELINE_DOCS.md` §2–§3**.
-
-| Стадия (выход) | Агент | Обязательные документы на выходе | Machine-verdict ключ (читает гейт ребра) | Гейт ребра |
-|----------------|-------|----------------------------------|------------------------------------------|------------|
-| `created` | система (`_create_initial_docs`) / заказчик | `00-business-request.md` | — (вход, не гейтится) | — |
-| `analysis` | analyst | `01-brd.md`, `02-trz.md`, `03-acceptance-criteria.md`, `04-test-plan.yaml` | — (гейт проверяет наличие файлов + Approved) | `check_analysis_approved` |
-| `architecture` | architect | `06-adr/ADR-NNN-<slug>.md` (≥1); `07-infra-requirements.md`, `08-data-requirements.md`, `10-tech-risks.md` (when-applicable/required-info) | — (гейт проверяет наличие `06-adr/` ≥1 ИЛИ `07-…`) | `check_architecture_done` |
-| `development` | developer | код + тесты в ветке (артефакт-док не пишется; гейт — зелёный CI) | — (гейт читает CI-статус Gitea) | `check_ci_green` |
-| `review` | reviewer | `12-review.md` | `verdict:` (`APPROVED` \| `REQUEST_CHANGES`) | `check_reviewer_verdict` |
-| `testing` | tester | `13-test-report.md` | `result:` / `verdict:` / `status:` (`PASS` \| `FAIL` \| `BLOCKED`; три равноранговых, ORCH-047) | `check_tests_passed` |
-| `deploy-staging` | deployer | `15-staging-log.md` (required для self-hosting); `17-security-report.md` (security-под-гейт, when-applicable) | `staging_status:` (`SUCCESS` \| `FAILED`); `security_status:` (`PASS` \| `FAIL`) | `check_staging_status` (ребро); под-гейты ребра `deploy-staging→deploy`: `check_security_gate` → `check_branch_mergeable` → `check_staging_image_fresh` |
-| `deploy` | deployer / deploy-finalizer | `14-deploy-log.md` | `deploy_status:` (`SUCCESS` \| `FAILED`) | `check_deploy_status` |
-| `done` | — | — (терминал) | — | — |
-| пост-`done` наблюдение | post-deploy-monitor | `16-post-deploy-log.md` (when-applicable, ORCH-021) | `post_deploy_status:` (`HEALTHY` \| `DEGRADED`) — **информационный, не гейт** | — (телеметрия петли уроков / наблюдаемость) |
-
-### Примечания (нормативные)
-
-- **Под-гейты ребра `deploy-staging → deploy`** (`check_security_gate` → `check_branch_mergeable`
-  → `check_staging_image_fresh`) — это **врезки в `advance_stage`**, а НЕ строки
-  `STAGE_TRANSITIONS`. Их порядок и условность раската не меняются этой спекой.
-- **`15-staging-log.md`** обязателен только для self-hosting репо (`orchestrator`); для прочих
-  репо staging-гейт — N/A (ORCH-35), документ не требуется.
-- **`16-post-deploy-log.md`** несёт `post_deploy_status:`, но это **информационный** ключ
-  (телеметрия ORCH-8 / наблюдаемость), гейтом он НЕ парсится.
-- **`09-…` / `05-…` / `11-…`** — зарезервированные/legacy номера; канон reviewer'а — `12-review.md`.
-
----
-
-## 3. Machine-verdict доки vs информационные (честный механизм проверки)
-
-Полностью согласовано с `PIPELINE_DOCS.md` §3. Machine-verdict док — гейт читает ТОЛЬКО
-YAML-frontmatter (через единый `frontmatter.parse_frontmatter`), маппит ключ в вердикт; имя ключа
-чувствительно к регистру, значение парсер приводит к верхнему регистру.
-
-| Документ | Machine-key | Парсер | Эффект вердикта |
-|----------|-------------|--------|-----------------|
-| `12-review.md` | `verdict:` | `check_reviewer_verdict` | `APPROVED` → дальше; `REQUEST_CHANGES` → откат на `development` |
-| `13-test-report.md` | `result:` / `verdict:` / `status:` | `_parse_tests_verdict` | `PASS` → дальше; `FAIL`/`BLOCKED` → откат (негативный токен авторитетен) |
-| `14-deploy-log.md` | `deploy_status:` | `_parse_deploy_status` | `SUCCESS` → `done`; `FAILED` → откат (БАГ-8) |
-| `15-staging-log.md` | `staging_status:` | `_parse_staging_status` | `SUCCESS` → дальше; `FAILED` → откат (self-hosting; иначе N/A) |
-| `17-security-report.md` | `security_status:` | `check_security_gate` → `parse_security_status` | `PASS` → дальше; `FAIL` → откат |
-
-**Информационные доки** (гейтом НЕ парсятся): `00-business-request.md`, `08-data-requirements.md`,
-`10-tech-risks.md`, `16-post-deploy-log.md`.
-
-**Аддитивность схемы (§1).** Документ-вердикт БЕЗ полей схемы из §1, но с вердикт-ключом, читается
-гейтом РОВНО как раньше: схема не участвует в вычислении вердикта при дефолтном
-`frontmatter_validation_strict=False`.
-
----
-
-## 4. Единый машинный контракт — `src/frontmatter.py`
-
-Все операции с frontmatter сведены в один leaf-модуль (never-raise):
-
-- `read_frontmatter_value(path, key) -> str | None` — single-key reader (контракт неизменен, BC).
-- `parse_frontmatter(content) -> FrontmatterParse` — **единственная точка** парсинга YAML-frontmatter
-  (`data` / `has_block` / `malformed` / `yaml_error`); пять вердикт-парсеров делегируют сюда.
-- `parse_frontmatter_dict` / `read_frontmatter` — ярлыки к распарсенному mapping.
-- `render_frontmatter` / `write_frontmatter` — writer (формат совместим с существующими парсерами).
-- `validate_schema` / `REQUIRED_FIELDS` / `maybe_warn_schema` — схема §1 (warning-only по умолчанию).
-- `strip_frontmatter` — общий хелпер тела (заменил дубли).
-- Kill-switch жёсткой валидации: `config.frontmatter_validation_strict`
-  (env `ORCH_FRONTMATTER_VALIDATION_STRICT`, дефолт `False`).
-
-> Перед написанием номерного дока бери скелет из [`docs/_templates/`](../_templates/) и **не меняй
-> имя machine-key frontmatter** (регистр чувствителен — иначе гейт упадёт ложно).

docs/_standards/PIPELINE_DOCS.md

@@ -1,153 +0,0 @@
-# PIPELINE_DOCS — стандарт документов конвейера (golden source структуры)
-
-> **Назначение.** Единая карта «стадия → агент → документ → категория → гейт/механизм →
-> frontmatter machine-key» + конвенция ADR-naming. Это **golden source структуры** номерных
-> документов work item (`00-business-request.md` … `17-security-report.md`), который каждая
-> агентская роль пишет на своей стадии.
->
-> **Статус истины (важно).** Манифест **документирует** текущее поведение гейтов, но НЕ является
-> их источником истины. Источник истины — код: `src/stages.py` (`STAGE_TRANSITIONS`),
-> `src/qg/checks.py` (`QG_CHECKS` / `check_*` / `_parse_*`), `src/stage_engine.py`. При будущей
-> правке гейта первична правка кода, манифест обновляется следом (ORCH-075 / ADR-001 §D2).
->
-> **Копируемые скелеты** каждого документа — в каталоге [`docs/_templates/`](../_templates/):
-> «скопировал → заполнил → не угадываешь структуру/ключ».
-
-Введён задачей **ORCH-075** (ORCH-52b — слой 1 эпика ORCH-52). Сквозной ADR:
-[`docs/architecture/adr/adr-0019-pipeline-docs-standard.md`](../architecture/adr/adr-0019-pipeline-docs-standard.md);
-детально — `docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md`.
-
----
-
-## 1. Конвейер стадий (ground-truth `STAGE_TRANSITIONS`)
-
-```
-created → analysis → architecture → development → review → testing → deploy-staging → deploy → done
-                          ↑                          │
-                          └──── REQUEST_CHANGES ──────┘  (откат на development, max 3 retries)
-```
-
-Каждое ребро несёт ровно один exit-гейт (`src/stages.py`):
-`check_analysis_approved → check_architecture_done → check_ci_green → check_reviewer_verdict →
-check_tests_passed → check_staging_status → check_deploy_status`.
-
-**Под-гейты ребра `deploy-staging → deploy`** (`check_security_gate` → `check_branch_mergeable` →
-`check_staging_image_fresh`) — это **врезки в `advance_stage`**, а НЕ строки `STAGE_TRANSITIONS`.
-Аналогично под-гейт ребра `deploy → done` (`_handle_merge_verify`, ORCH-071/073) — врезка, не
-зарегистрированный QG. Карта стадий о них не «лжёт»: они не являются стадиями.
-
----
-
-## 2. Манифест: документ → агент → категория → стадия → гейт → machine-key
-
-Категории: **required** (пишется всегда), **when-applicable** (пишется при наличии предмета:
-инфра / данные / security / post-deploy — отсутствие не нарушение), **optional** / **legacy**.
-
-| Документ | Владелец-агент | Категория | Стадия написания | Гейт / механизм проверки | Frontmatter machine-key |
-|----------|----------------|-----------|------------------|--------------------------|-------------------------|
-| `00-business-request.md` | система (Plane webhook `_create_initial_docs`) / заказчик | required | `created` (инициализация) | не гейтится (вход) | — |
-| `01-brd.md` | analyst | required | `analysis` | exit-гейт `analysis→architecture` = `check_analysis_approved` (Approved + полнота файлов); helper `check_analysis_complete` (наличие `01/02/03/04`) | — |
-| `02-trz.md` | analyst | required | `analysis` | то же | — |
-| `03-acceptance-criteria.md` | analyst | required | `analysis` | то же | — |
-| `04-test-plan.yaml` | analyst | required | `analysis` | то же | — |
-| `06-adr/ADR-NNN-<slug>.md` | architect | required | `architecture` | `check_architecture_done` (наличие каталога `06-adr/` ≥1 файл ИЛИ `07-infra-requirements.md`) | — |
-| `07-infra-requirements.md` | architect | when-applicable | `architecture` | `check_architecture_done` (учитывается при наличии) | — |
-| `08-data-requirements.md` | architect | when-applicable | `architecture` | информационный (гейтом не парсится) | — |
-| `10-tech-risks.md` | architect | required | `architecture` | информационный (гейтом не парсится) | — |
-| `12-review.md` | reviewer | required | `review` | `check_reviewer_verdict` | `verdict:` (`APPROVED` \| `REQUEST_CHANGES`) |
-| `13-test-report.md` | tester | required | `testing` | `check_tests_passed` (`_parse_tests_verdict`) | `result:` / `verdict:` / `status:` (`PASS` \| `FAIL` \| `BLOCKED`; три равноранговых, ORCH-047) |
-| `14-deploy-log.md` | deployer / deploy-finalizer | required | `deploy` | `check_deploy_status` (`_parse_deploy_status`) | `deploy_status:` (`SUCCESS` \| `FAILED`) |
-| `15-staging-log.md` | deployer | required (self-hosting) | `deploy-staging` | `check_staging_status` (self-hosting; иначе N/A — ORCH-35) | `staging_status:` (`SUCCESS` \| `FAILED`) |
-| `16-post-deploy-log.md` | post-deploy-monitor | when-applicable | пост-`done` наблюдение (ORCH-021; не ребро `STAGE_TRANSITIONS`) | информационный (гейтом не парсится) | `post_deploy_status:` (`HEALTHY` \| `DEGRADED`) |
-| `17-security-report.md` | security-гейт (детерминированный, ORCH-022) | when-applicable | под-гейт ребра `deploy-staging→deploy` | `check_security_gate` (врезка в `advance_stage`) | `security_status:` (`PASS` \| `FAIL`) |
-
-### Примечания манифеста (нормативные)
-
-- **Под-гейты ребра `deploy-staging→deploy`** (`check_security_gate` → `check_branch_mergeable` →
-  `check_staging_image_fresh`) исполняются как врезки в `advance_stage`, а НЕ строки
-  `STAGE_TRANSITIONS`. Не путать с exit-гейтами рёбер.
-- **`09-review.md`** — legacy fallback от старой нумерации; **канон — `12-review.md`**. В основную
-  таблицу как канон не вносится; reviewer пишет `12-review.md`.
-- **Категория `when-applicable`** = документ пишется при наличии соответствующего предмета
-  (инфра / данные / security / post-deploy). Его отсутствие — не нарушение приёмки.
-- **`05-…` / `09-…` / `11-…`** — зарезервированные/legacy номера, в текущем каноне не используются.
-
----
-
-## 3. Machine-verdict доки vs информационные (честный механизм проверки)
-
-**Machine-verdict доки** — гейт читает ТОЛЬКО YAML-frontmatter (никогда прозу), маппит ключ в
-вердикт. Имя ключа чувствительно к регистру; значение парсер приводит к верхнему регистру.
-
-| Документ | Machine-key | Парсер (`src/qg/checks.py`) | Эффект вердикта |
-|----------|-------------|-----------------------------|-----------------|
-| `12-review.md` | `verdict:` | `check_reviewer_verdict` | `APPROVED` → дальше; `REQUEST_CHANGES` → откат на `development` |
-| `13-test-report.md` | `result:` / `verdict:` / `status:` | `_parse_tests_verdict` | `PASS` → дальше; `FAIL`/`BLOCKED` → откат |
-| `14-deploy-log.md` | `deploy_status:` | `_parse_deploy_status` | `SUCCESS` → `done`; `FAILED` → откат (БАГ-8) |
-| `15-staging-log.md` | `staging_status:` | `_parse_staging_status` | `SUCCESS` → дальше; `FAILED` → откат (self-hosting; иначе N/A) |
-| `17-security-report.md` | `security_status:` | `check_security_gate` | `PASS` → дальше; `FAIL` → откат |
-
-**Информационные доки** — гейтом НЕ парсятся (структура ничего не блокирует):
-`00-business-request.md` (вход), `08-data-requirements.md`, `10-tech-risks.md`,
-`16-post-deploy-log.md` (несёт `post_deploy_status:`, но это телеметрия петли уроков ORCH-8 /
-наблюдаемость, не гейт).
-
----
-
-## 4. Конвенция ADR-naming
-
-### Per-work-item ADR (основное)
-
-- **Путь:** `docs/work-items/<plane-id>/06-adr/`
-- **Имя файла:** `ADR-NNN-<kebab-slug>.md`
-  - `NNN` — 3-значный, начинается с `001`; инкремент при нескольких ADR в одной задаче
-    (`ADR-001-…`, `ADR-002-…`).
-  - `<kebab-slug>` — kebab-case (нижний регистр, слова через дефис), отражает суть решения.
-- **Стадия:** пишет **architect** на стадии `architecture`; гейтится `check_architecture_done`
-  (наличие каталога `06-adr/` ≥ 1 файла).
-
-### Сквозной (cross-cutting) ADR
-
-Решения, затрагивающие несколько компонентов/ролей или поведение всего конвейера, **дублируются**
-в глобальный реестр:
-
-- **Путь:** `docs/architecture/adr/`
-- **Имя файла:** `adr-NNNN-<kebab-slug>.md` (4-значная сквозная нумерация, последовательная по
-  всему репозиторию; на момент ORCH-075 реестр доходит до `adr-0019`).
-
-### Примеры из репозитория (реальные, проверенные)
-
-- `docs/work-items/ORCH-088/06-adr/ADR-001-serial-gate.md`
-- `docs/work-items/ORCH-089/06-adr/ADR-001-auto-label-gates.md`
-- `docs/work-items/ORCH-071/06-adr/ADR-001-merge-verify-gate.md`
-- Сквозные: `docs/architecture/adr/adr-0017-serial-gate.md`,
-  `docs/architecture/adr/adr-0018-auto-label-gates.md`.
-
----
-
-## 5. Как пользоваться шаблонами
-
-1. Скопируй нужный скелет из [`docs/_templates/`](../_templates/) в
-   `docs/work-items/<plane-id>/` под канонным именем (для ADR — `06-adr/ADR-001-<slug>.md`).
-2. Заполни секции; **не удаляй** machine-key frontmatter у machine-verdict доков и **не меняй имя
-   ключа** (регистр чувствителен — иначе гейт упадёт ложно).
-3. Сверяйся с манифестом (§2–§3): какой агент, на какой стадии, какой гейт читает документ.
-
-> Стандарт **описательный** (слой 1). **Машинный слой реализован в ORCH-52c (ORCH-076):** единый
-> frontmatter-контракт (reader + writer + валидатор) в [`src/frontmatter.py`](../../src/frontmatter.py)
-> и формальная спека handoff [`HANDOFF_PROTOCOL.md`](HANDOFF_PROTOCOL.md) («стадия → обязательный
-> выход» + обязательная frontmatter-схема `REQUIRED_FIELDS`). Пять вердикт-парсеров
-> (`check_reviewer_verdict`, `_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status`,
-> `parse_security_status`) читают вердикт через ОДНУ точку парсинга (`parse_frontmatter`); семантика
-> вердиктов 1:1. Валидатор обязательной схемы по умолчанию **warning-only** (kill-switch
-> `frontmatter_validation_strict`, дефолт `False`) — соблюдение схемы пока на ответственности агента
-> и reviewer'а, enforcement придёт с ORCH-52d.
-
----
-
-## 6. Спека handoff (машинный контракт, ORCH-52c)
-
-Вертикальный срез «стадия → обязательные документы + frontmatter-ключи на выходе» и обязательная
-frontmatter-схема вынесены в отдельную нормативную спеку [`HANDOFF_PROTOCOL.md`](HANDOFF_PROTOCOL.md)
-(набор документов/ключей/гейтов согласован 1:1 с §2–§3 этого манифеста). Машинный источник
-обязательной схемы — `frontmatter.REQUIRED_FIELDS`.

docs/_templates/00-business-request.md

@@ -1,8 +0,0 @@
-# Business Request: <краткий заголовок задачи>
-
-Work Item ID: ORCH-NNN
-
-## Description
-
-<Что хочет заказчик/Владелец своими словами: проблема, желаемый результат, контекст.
-Допускается `TBD` на входе — analyst уточняет на стадии `analysis` и формализует в 01-brd.md.>

docs/_templates/01-brd.md

@@ -1,34 +0,0 @@
-# 01 — BRD (бизнес-требования): ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: analysis
-
-## 1. Бизнес-контекст и проблема
-<Зачем задача, какую боль/риск закрывает. Установленные факты — не изобретать.>
-
-## 2. Объём (scope)
-
-### В объёме
-- <что делаем>
-
-### Вне объёма
-- <что явно НЕ делаем — чтобы исключить расползание>
-
-## 3. Заинтересованные стороны
-<Кто заказчик, кого затрагивает, кто принимает результат.>
-
-## 4. Бизнес-требования (BR)
-- **BR-1** — <требование, проверяемое>
-- **BR-2** — …
-
-## 5. Нефункциональные требования (NFR)
-- **NFR-1** — <надёжность / совместимость / обратимость / безопасность>
-- **NFR-2** — …
-
-## 6. Допущения и ограничения
-<Допущения, на которых стоит решение; внешние ограничения.>
-
-## 7. Критерии успеха
-<Резюме; детальные PASS/FAIL — в 03-acceptance-criteria.md.>
-
-## 8. Риски
-<Краткий перечень; детали — 10-tech-risks.md (заполняет архитектор).>

docs/_templates/02-trz.md

@@ -1,30 +0,0 @@
-# 02 — ТЗ (TRZ): ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: analysis
-
-> ТЗ описывает **конкретные изменения к реализации**, выведенные из BRD и фактического кода.
-> Архитектурное обоснование/решения — задача архитектора (06-adr).
-
-## 1. Сводка изменения
-<Что меняется, в одном-двух абзацах.>
-
-## 2. Задействованные модули / пути
-| Путь | Действие |
-|------|----------|
-| `src/<module>.py` | изменить / создать |
-
-## 3. Функциональные требования
-### FR-1 — <название>
-<Поведение, контракт, инварианты. Привязать к BR.>
-
-## 4. Изменения API
-<Новые/изменённые эндпоинты; либо «Нет.».>
-
-## 5. Изменения схемы БД
-<Таблицы/миграции/индексы; либо «Нет.».>
-
-## 6. Требования к новым/изменённым QG checks
-<Изменения `QG_CHECKS` / `check_*`; либо «Нет.».>
-
-## 7. Совместимость / регресс
-<Обратная совместимость, kill-switch, область раската, обратимость.>

docs/_templates/03-acceptance-criteria.md

@@ -1,31 +0,0 @@
-# 03 — Критерии приёмки (Acceptance Criteria): ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: analysis
-
-Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
-(что считается провалом). Любой машинный/ручной reviewer проверяет их буквально по файлам
-репозитория.
-
----
-
-## AC-1 — <краткий заголовок>
-
-**Условие:** <проверяемое условие>
-- **PASS:** <что должно быть истинно>
-- **FAIL:** <что считается провалом>
-
----
-
-## AC-2 — <краткий заголовок>
-
-**Условие:** <…>
-- **PASS:** <…>
-- **FAIL:** <…>
-
----
-
-## Сводная матрица AC ↔ FR/BR
-| AC | Покрывает |
-|----|-----------|
-| AC-1 | BR-1 / FR-1 |
-| AC-2 | BR-2 / FR-2 |

docs/_templates/04-test-plan.yaml

@@ -1,20 +0,0 @@
-work_item: ORCH-NNN
-title: "<краткое название тест-плана>"
-framework: pytest
-scope: "<что покрывается тестами; что вне покрытия>"
-notes: >
-  <Свободные заметки: окружение, особенности, что считается регрессом.
-  Полный регресс tests/ должен оставаться зелёным.>
-
-tests:
-  - id: TC-01
-    type: unit            # unit | integration
-    description: "<что проверяет тест>"
-    module: tests/test_<feature>.py
-    expected: PASS
-
-  - id: TC-02
-    type: integration
-    description: "<…>"
-    module: tests/test_<feature>.py
-    expected: PASS

docs/_templates/06-adr-ADR-NNN-slug.md

@@ -1,43 +0,0 @@
-# ADR-NNN: <Заголовок решения>
-
-> **Шаблон ADR.** Скопируй в `docs/work-items/<plane-id>/06-adr/ADR-NNN-<kebab-slug>.md`.
-> `NNN` начинается с `001`, инкремент при нескольких ADR в задаче. `<kebab-slug>` — нижний
-> регистр, слова через дефис. Сквозное (cross-cutting) решение дополнительно дублируй в
-> `docs/architecture/adr/adr-NNNN-<kebab-slug>.md` (4-значная глобальная нумерация).
-> См. `docs/_standards/PIPELINE_DOCS.md` §4.
-
-Work Item: **ORCH-NNN** — <короткое описание>
-Стадия: **architecture**
-Сквозная регистрация: **`docs/architecture/adr/adr-NNNN-<slug>.md`** (если решение
-кросс-каттинговое; иначе — «N/A, локальное решение задачи»).
-
-## Статус
-Proposed   <!-- Proposed | Accepted | Superseded by ADR-… -->
-
-## Контекст
-<Какую проблему решаем; факты, сверенные с кодом (`src/…`); почему «как есть» не годится.>
-
-## Решение
-
-### Сводка
-<Суть выбранного решения в одном-двух абзацах.>
-
-### D1 — <название аспекта решения>
-<Конкретное решение по аспекту, инварианты, привязка к FR/AC.>
-
-### D2 — <название аспекта решения>
-<…>
-
-## Альтернативы
-- **<альтернатива>** — отвергнуто: <почему>.
-
-## Последствия
-- **+** <положительный эффект>
-- **−** <издержка / приятый компромисс + митигейшн>
-- **Откат:** <как полностью откатить изменение>
-
-## Ссылки
-- BRD: `docs/work-items/ORCH-NNN/01-brd.md`
-- TRZ: `docs/work-items/ORCH-NNN/02-trz.md`
-- Acceptance: `docs/work-items/ORCH-NNN/03-acceptance-criteria.md`
-- Сверено по коду: `src/…`

docs/_templates/07-infra-requirements.md

@@ -1,19 +0,0 @@
-# 07 — Инфра-требования: ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: architecture
-
-> When-applicable. Если инфраструктура не затрагивается — оставить явные `N/A` по пунктам
-> (файл создаётся для аудитопригодности, а не из-за изменения топологии).
-
-## I-1. Топология / окружения
-<Контейнеры, порты, сеть, тома, хост; либо `N/A`.>
-
-## I-2. Переменные окружения / секреты
-<Новые env-переменные, изменения `.env` / `.env.example`, секреты; либо `N/A`.>
-
-## I-3. Деплой / рестарт
-<Требуется ли рестарт прод-контейнера; self-hosting инвариант (не ронять прод вне staging);
-либо `N/A`.>
-
-## I-4. CI/CD
-<Изменения `.gitea/workflows/`, новые тестовые шаги; либо «без изменений».>

docs/_templates/08-data-requirements.md

@@ -1,15 +0,0 @@
-# 08 — Требования к данным: ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: architecture
-
-> When-applicable / информационный (гейтом не парсится). Если данные/схема не затрагиваются —
-> оставить явные `N/A`.
-
-## Изменения схемы БД
-<Новые/изменённые таблицы, индексы, миграции (`init_db`); либо `N/A`.>
-
-## Новые/изменённые сущности
-<Поля, колонки, инварианты данных; либо «Нет.».>
-
-## Совместимость данных / миграции
-<Аддитивность, идемпотентность миграций, restart-safe, влияние на общую прод-БД; либо `N/A`.>

docs/_templates/10-tech-risks.md

@@ -1,16 +0,0 @@
-# 10 — Технические риски: ORCH-NNN — <название>
-
-Work Item: **ORCH-NNN** · Repo: **<repo>** · Стадия: architecture
-
-> Информационный (гейтом не парсится). Перечисляет риски реализации и их митигейшн.
-
-## Реестр рисков
-
-| ID | Риск | Вер. | Влия. | Митигейшн |
-|----|------|------|-------|-----------|
-| TR-1 | <описание риска> | Низ./Сред./Выс. | Низ./Сред./Выс. | <как снижаем> |
-| TR-2 | <…> | | | |
-
-## Сводный вывод
-<Доминирующий класс рисков; нужна ли эскалация `arch:major-change` / возврат в анализ;
-итоговая оценка остаточного риска для прод-конвейера (self-hosting).>

docs/_templates/12-review.md

@@ -1,31 +0,0 @@
----
-type: review
-work_item_id: ORCH-NNN
-verdict: APPROVED        # APPROVED | REQUEST_CHANGES  (machine-key — читает check_reviewer_verdict)
-version: 1
----
-
-# Review ORCH-NNN
-
-> Машинный вердикт читается ТОЛЬКО из `verdict:` во frontmatter (никогда из прозы).
-> `APPROVED` → дальше по конвейеру; `REQUEST_CHANGES` → откат на `development`.
-
-## Summary
-<Краткая оценка: реализовано ли по ТЗ/ADR, покрытие тестами, обновлена ли документация.>
-
-## Оси проверки
-<Корректность, соответствие ADR/инвариантам, тесты, документация, совместимость/регресс.>
-
-## Findings
-
-### P0 — Blocker
-- (нет)
-
-### P1 — Must fix
-- (нет)
-
-### P2 — Should fix
-- (нет)
-
-## Документация
-<Обновлена ли документация (README/CLAUDE/CHANGELOG/архитектура) в том же PR. Нет → REQUEST_CHANGES.>

docs/_templates/13-test-report.md

@@ -1,33 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-NNN
-result: PASS            # PASS | FAIL | BLOCKED  (machine-key — читает _parse_tests_verdict)
----
-
-# Test Report — ORCH-NNN
-
-> Машинный вердикт читается ТОЛЬКО из frontmatter. Канонический ключ — `result:`; равнорангово
-> допускаются `verdict:` / `status:` (ORCH-047). Любой негативный токен (`FAIL`/`BLOCKED`) —
-> авторитетен.
-
-## Окружение
-- Python: <версия>
-- pytest: <версия>
-- Дата: YYYY-MM-DD
-- Worktree: `feature/ORCH-NNN-<slug>`
-
-## Результаты
-
-### Полный регресс
-<`pytest tests/ -q` — итог (N passed); прод-контейнер не трогается.>
-
-### Профильные сюиты
-<Целевые тесты задачи.>
-
-### Сопоставление с тест-планом
-| TC ID | Описание | Тест-функция | Результат |
-|-------|----------|--------------|-----------|
-| TC-01 | <…> | test_… | PASS |
-
-### Сопоставление с критериями приёмки
-<AC-1…AC-N — покрыт каким тестом / результат.>

docs/_templates/14-deploy-log.md

@@ -1,14 +0,0 @@
----
-deploy_status: SUCCESS    # SUCCESS | FAILED  (machine-key — читает _parse_deploy_status)
-work_item: ORCH-NNN
-hook_exit_code: 0
-deployed_by: deploy-finalizer
----
-
-# Deploy log — ORCH-NNN
-
-> Машинный вердикт читается ТОЛЬКО из `deploy_status:` во frontmatter.
-> `SUCCESS` → `done`; `FAILED` → откат на `development` (БАГ-8).
-
-<Краткое описание деплоя: что выкачено, exit-code хука, кто/что зафиксировало вердикт
-(детерминированный finalizer Фаза C, не LLM, для self-hosting).>

docs/_templates/15-staging-log.md

@@ -1,20 +0,0 @@
----
-staging_status: SUCCESS    # SUCCESS | FAILED  (machine-key — читает _parse_staging_status)
-timestamp: YYYY-MM-DDTHH:MM:SSZ
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-> Машинный вердикт читается ТОЛЬКО из `staging_status:` во frontmatter. Реален для self-hosting
-> (`orchestrator`); для прочих репо гейт — N/A (ORCH-35). `SUCCESS` → дальше; `FAILED` → откат.
-
-Staging test suite — итог (например: «All REAL pipeline checks passed»). Запуск канонически
-внутри контейнера `orchestrator-staging` (8501).
-
-## Results
-- **Block A (SMOKE)**: <…>
-- **Block B (ACCESS)**: <…>
-- **Block C (E2E)**: <…>
-
-REAL failed: <none | перечень>.

docs/_templates/16-post-deploy-log.md

@@ -1,21 +0,0 @@
----
-post_deploy_status: HEALTHY    # HEALTHY | DEGRADED  (информационный, гейтом НЕ парсится — телеметрия ORCH-021)
-action_taken: NONE             # NONE | ALERT_ONLY | ROLLBACK_OK | ROLLBACK_FAILED
-work_item: ORCH-NNN
-window_s: 900
-checks_total: 0
-checks_failed: 0
----
-
-# Post-deploy log — ORCH-NNN
-
-> Пост-`done` наблюдение прода (ORCH-021). НЕ ребро `STAGE_TRANSITIONS`, гейтом не парсится —
-> frontmatter машиночитаем для петли уроков ORCH-8 / наблюдаемости.
-
-Окно наблюдения: <window_s>s; опросов всего: <checks_total>, с провалом: <checks_failed>.
-
-## Серия наблюдений
-<Краткая серия сигналов health / доли 5xx; классификация HEALTHY/DEGRADED.>
-
-## Решение
-<Реакция: для self-hosting всегда `ALERT_ONLY` (ручной approve, тик не откатывает прод).>

docs/_templates/17-security-report.md

@@ -1,26 +0,0 @@
----
-security_status: PASS      # PASS | FAIL  (machine-key — читает check_security_gate)
-work_item: ORCH-NNN
-secrets_found: 0
-deps_blocking: 0
-deps_warning: 0
-deps_audit_degraded: false
----
-
-# Security Report — ORCH-NNN
-
-> Детерминированный security-гейт (ORCH-022) — под-гейт ребра `deploy-staging→deploy` (врезка в
-> `advance_stage`, не строка `STAGE_TRANSITIONS`). Машинный вердикт читается ТОЛЬКО из
-> `security_status:`. `PASS` → дальше; `FAIL` → откат.
-
-## Verdict
-<clean / blocking: N secrets, M blocking CVE(s).>
-
-## Secrets
-<secret-scanning (gitleaks, offline): None | перечень.>
-
-## Dependencies (blocking)
-<dependency audit (pip-audit): None | перечень блокирующих CVE.>
-
-## Dependencies (warning)
-<Не блокирующие предупреждения зависимостей.>

docs/architecture/README.md

@@ -9,11 +9,11 @@
 - **Stage Engine** (`src/stage_engine.py`) — исполнение переходов, диспетчеризация QG (`_run_qg`), откаты, синхронизация с Plane.
 - **Review/Test Parsers** (`src/review_parse.py`, ORCH-046) — defensive-извлечение дословного must-fix текста из артефактов для встраивания в `task_desc` заворота: `extract_review_findings` (P0/P1 из `12-review.md`), `extract_test_failures` (фрагмент тела `13-test-report.md`). Контракт «never raise»: любая ошибка → `""`.
 - **Quality Gates** (`src/qg/checks.py`) — проверки выхода со стадии, реестр `QG_CHECKS`.
-- **Agent Launcher** (`src/agents/launcher.py`) — запуск Claude CLI агентов в изолированном git worktree, мониторинг, auto-advance. Модель/эффорт каждого агента резолвятся из config (`resolve_agent_model`/`resolve_agent_effort`, ORCH-41), а не из frontmatter промпта. **ORCH-74:** имя модели валидируется форматом `^claude-…$` (`is_valid_model`) перед `--model`; невалидное → лог + откат на следующий уровень/CLI-дефолт (never-break, как `VALID_EFFORTS` для эффорта). Тот же предикат гардит inline-чтение `--fallback-model`.
+- **Agent Launcher** (`src/agents/launcher.py`) — запуск Claude CLI агентов в изолированном git worktree, мониторинг, auto-advance.
 - **Queue** (`src/queue_worker.py`, ORCH-1) — персистентная очередь задач (SQLite `jobs`), atomic claim, max_concurrency, ретраи, restart-safe. **ORCH-026:** `claim_next_job` гейтит задачи с незавершёнными зависимостями (`job_deps`, `NOT EXISTS`) без занятия слота; декларации/циклы — leaf `src/task_deps.py`.
 - **Job-reaper** (`src/job_reaper.py`, ORCH-065 — [adr-0011](adr/adr-0011-job-reaper-lease-reclaim.md)) — фоновый daemon-поток (каркас `reconciler`), стартует/останавливается в `main.lifespan` (после `reconciler.start()` / перед `worker.stop()`). Детектирует «мёртвый» `running`-job **без рестарта** процесса (Tier-1 мёртвый `jobs.pid` после `reaper_dead_ticks` тиков; Tier-2 `agent_runs.exit_code` записан, а job ещё `running`; Tier-3 backstop `reaper_max_running_s`) и приводит строку к корректному статусу через те же контракты (`_try_advance_stage`/`_finalize_job`, gate-driven; exit≠0/неизвестно → `attempts<max`→`queued`, иначе `failed`+Telegram). Атомарный reap-claim (guard `status='running'`) совместим со стартовым `requeue_running_jobs`. Тот же поток периодически делает проактивный реклейм stale/dead merge-lease (см. ниже). never-raise; kill-switch `ORCH_REAPER_ENABLED`; снимок в `GET /queue` (блок `reaper`).
 - **Reconciler** (`src/reconciler.py`, ORCH-053 — реализовано, [adr-0007](adr/adr-0007-reconciler.md)) — фоновый daemon-поток (паттерн `queue_worker`), стартует/останавливается в `main.lifespan` (после `worker.start()` / перед `worker.stop()`). Реконсилирует рассинхрон «источник истины ≠ стадия задачи» при потерянном webhook. F-1 gate-side (продвигает застрявшую стадию по локальной БД через штатный `advance_stage(..., finished_agent=None)`), F-2 plane-side (опрос Plane API → `handle_*` из `plane.py`), F-3 (БД-fallback `sha→branch` в `handle_ci_status`). Источник истины — гейт/Plane, не событие; идемпотентность (active-job guard + atomic-claim + grace); kill-switch `ORCH_RECONCILE_ENABLED`. `analysis` F-1 не трогает (человеческий гейт). F-1 также пропускает escalated (retry≥лимита) и Blocked/Needs-Input задачи (ORCH-060). Наблюдаемость — блок `reconcile` в `GET /queue`.
-- **Notifications / Live-tracker** (`src/notifications.py`, ORCH-042/ORCH-067) — ОДНА live-карточка на задачу (`update_task_tracker`), обновляется на каждом переходе. Режим `ORCH_TRACKER_MODE` (дефолт `bump` с ORCH-067: delete+silent send+repoint внизу чата; `edit` — правка на месте). Карточка несёт строку Plane-статуса `📍 …` (оффлайн-ядро `plane_status_label` + best-effort live-overlay `_live_plane_branch_override`, kill-switch `ORCH_TRACKER_LIVE_STATUS`) и кликабельный номер задачи (`plane_issue_link`/`link_for` → ссылка в Plane, fail-safe на сырой номер). **ORCH-080:** оба низкоуровневых примитива (`send_telegram`/`edit_telegram`) шлют payload с `disable_web_page_preview: True` — Telegram больше не разворачивает баннер link-preview Plane под карточкой/уведомлениями; `parse_mode: HTML` сохранён (ссылка остаётся кликабельной), безусловно без kill-switch. Все алерты, упоминающие `work_item_id`, делают номер кликабельным. **ORCH-087:** bump ведёт авторитетный леджер всех созданных карточек (`tracker_messages`, `deleted_at IS NULL` = жива) и на каждом обновлении зачищает ВСЕ незакрытые mid (а не только скаляр `tracker_message_id`) → класс «замёрзшая сирота» устранён; строка стадии несёт фактический эффорт рядом с моделью (`· {model} · {effort}`, колонка `agent_runs.effort`, стамп в `launcher._spawn`); done-строка времени переписана на три подписанных метрики `⏱️ Агенты · твоё{~cap} · общее с ожиданием` (кап `ORCH_TRACKER_BRD_REVIEW_CAP_S`); deploy-цикл дополнен overlay-ключом `confirm_deploy`. Контракт всего компонента — never raises; карточка всегда silent. Детали — [internals.md](internals.md) §7 и [ADR-001](../work-items/ORCH-087/06-adr/ADR-001-tracker-orphan-cleanup.md).
+- **Notifications / Live-tracker** (`src/notifications.py`, ORCH-042/ORCH-067) — ОДНА live-карточка на задачу (`update_task_tracker`), обновляется на каждом переходе. Режим `ORCH_TRACKER_MODE` (дефолт `bump` с ORCH-067: delete+silent send+repoint внизу чата; `edit` — правка на месте). Карточка несёт строку Plane-статуса `📍 …` (оффлайн-ядро `plane_status_label` + best-effort live-overlay `_live_plane_branch_override`, kill-switch `ORCH_TRACKER_LIVE_STATUS`) и кликабельный номер задачи (`plane_issue_link`/`link_for` → ссылка в Plane, fail-safe на сырой номер). Все алерты, упоминающие `work_item_id`, делают номер кликабельным. Контракт всего компонента — never raises; карточка всегда silent. Детали — [internals.md](internals.md) §7.
 - **Project Registry** (`src/projects.py`, ORCH-6) — Plane project id → repo + prefix; фильтрация вебхуков по проекту.
 - **Plane Sync** (`src/plane_sync.py`) — синхронизация статусов/комментариев в Plane. Резолв статусов проекта `get_project_states` (ORCH-10) кэширует `{logical_key→uuid}` per-project; **ORCH-068** добавляет в кэш-запись `{uuid→group}` (для терминал-исключения F-2) и **TTL** `ORCH_PLANE_STATES_TTL_S` (дефолт 300с; `0` → прежний lifetime-кэш) — устаревший набор статусов самозалечивается без рестарта процесса через существующий `reload_project_states()` (баг кэша после появления нового Plane-статуса). Форма возврата `get_project_states` неизменна (обратная совместимость).
 
@@ -39,37 +39,7 @@ created → analysis → architecture → development → review → testing →
 
 **Реестр QG** (`QG_CHECKS`): check_analysis_approved, check_analysis_complete, check_architecture_done, check_ci_green, check_review_approved, check_tests_passed, check_reviewer_verdict, check_tests_local, check_deploy_status, check_staging_status, check_branch_mergeable (ORCH-043), check_staging_image_fresh (ORCH-058), check_security_gate (ORCH-022).
 
-**Канон гейтов:** машинные вердикты читаются ТОЛЬКО из YAML-frontmatter, никогда из прозы. Лог-файлы мержатся в `origin/main` отдельным PR; гейт читает из `origin/main`. **Единый frontmatter-контракт (ORCH-52c / ORCH-076):** парсинг YAML-frontmatter сведён к одной точке — `src/frontmatter.parse_frontmatter` (структура `data/has_block/malformed/yaml_error`, never-raise); пять вердикт-парсеров (`check_reviewer_verdict`, `_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status`, `parse_security_status`) делегируют ей вместо дублированной ad-hoc логики. Модуль также несёт writer (`render/write_frontmatter`), валидатор обязательной схемы (`validate_schema`/`REQUIRED_FIELDS`, warning-only по умолчанию; hard-fail только под kill-switch `frontmatter_validation_strict`, дефолт `False`) и общий `strip_frontmatter`. Семантика вердиктов / `STAGE_TRANSITIONS` / состав `QG_CHECKS` — без изменений (1:1).
-
-### Стандарт документов конвейера (ORCH-075, ORCH-52b)
-Структура номерных документов work item (`00-business-request.md` … `17-security-report.md`),
-карта «стадия → агент → документ → категория → гейт/механизм → frontmatter machine-key» и
-конвенция ADR-naming зафиксированы как golden source в
-[`docs/_standards/PIPELINE_DOCS.md`](../_standards/PIPELINE_DOCS.md); копируемые скелеты — в
-[`docs/_templates/`](../_templates/). Манифест **документирует** поведение гейтов (источник истины
-остаётся код: `src/stages.py`, `src/qg/checks.py`), честно различая machine-verdict доки
-(`12/13/14/15/17` — несут читаемый гейтом ключ) и информационные (`00/08/10/16` — гейтом не
-парсятся). Это слой 1 (описательный). **Слой 2 (машинный) реализован в ORCH-52c (ORCH-076):**
-единый frontmatter-контракт `src/frontmatter.py` + формальная спека handoff «стадия → обязательный
-выход» с обязательной frontmatter-схемой (`REQUIRED_FIELDS`) —
-[`docs/_standards/HANDOFF_PROTOCOL.md`](../_standards/HANDOFF_PROTOCOL.md). ADR:
-[adr-0019](adr/adr-0019-pipeline-docs-standard.md) / [adr-0020](adr/adr-0020-frontmatter-contract.md),
-детально — `docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md`,
-`docs/work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md`.
-
-### Модель и эффорт по ролям (ORCH-41, валидация ORCH-74)
-Модель и `--effort` каждого агента берутся из config (`src/config.py`), резолвятся `launcher.resolve_agent_model` / `resolve_agent_effort` по приоритету **project-override (`projects_json` `agent_models`/`agent_efforts`) > `ORCH_AGENT_MODEL_<AGENT>`/`ORCH_AGENT_EFFORT_<AGENT>` > `*_default` > CLI-дефолт (без флага)**. **Эффорт (ORCH-081):** ниже `*_default` добавлен непустой **per-role floor** — class-default поля `agent_effort_<role>` из `config.py` (его пустой env перебить не может). Floor — строго последний уровень (ниже default) и срабатывает ТОЛЬКО когда все уровни пусты, поэтому пустые прод-`ORCH_AGENT_EFFORT_*=` (которые pydantic трактует как явное `''` и обнуляют дефолт) больше не приводят к запуску без `--effort`: каждая роль получает свой канонический пол (developer=`xhigh`, tester/deployer=`medium`, прочие=`high`). Непустой явный конфиг по-прежнему побеждает floor; опечатка вне `VALID_EFFORTS` дропается валидацией ДО floor (never-break, не маскируется). См. `docs/work-items/ORCH-081/06-adr/ADR-001-effort-resolution-floor.md`. frontmatter `model:` в `.openclaw/agents/*.md` **удалён** (ORCH-74 G1) — он был мёртвой/лживой декларацией (launcher его не читает); config — единственный источник правды о модели. Model-routing (G3) НЕ включён — все 6 агентов на `claude-opus-4-8`.
-
-| Агент | Модель | Эффорт |
-|-------|--------|--------|
-| analyst | claude-opus-4-8 | high |
-| architect | claude-opus-4-8 | high |
-| developer | claude-opus-4-8 | xhigh |
-| reviewer | claude-opus-4-8 | high |
-| tester | claude-opus-4-8 | medium |
-| deployer | claude-opus-4-8 | medium |
-
-**Валидация (ORCH-74 G2, never-break):** резолвенное имя модели проходит формат-чек `is_valid_model` (`^claude-[a-z0-9.-]+$`) перед попаданием в `--model`. Невалидное (опечатка, `gpt-4`, пустое) → `logger.warning` + откат на следующий валидный уровень (в пределе — без `--model`, CLI-дефолт); мусор **никогда** не уезжает в CLI и запуск не падает. Форма — формат-чек, а не статичный allowlist: forward-compatible (будущие `claude-*` проходят без правки кода). Тот же предикат гардит inline-чтение `--fallback-model` (`agent_fallback_model` читается мимо резолва — TRZ §4). Эффорт валидируется множеством `VALID_EFFORTS` (`low|medium|high|xhigh|max`). Fallback (G4) НЕ включён (`agent_fallback_model=""`). Детали — `docs/work-items/ORCH-074/06-adr/ADR-001-model-name-validation.md`.
+**Канон гейтов:** машинные вердикты читаются ТОЛЬКО из YAML-frontmatter, никогда из прозы. Лог-файлы мержатся в `origin/main` отдельным PR; гейт читает из `origin/main`.
 
 ### Условный staging-гейт (ORCH-35)
 `check_staging_status` реален только для self-hosting (`is_self_hosting_repo(repo)` → `orchestrator`); для остальных проектов → no-op `(True, "Staging gate N/A")`. Для orchestrator парсит `staging_status:` из `15-staging-log.md`; FAILED → откат на `development`. Подробнее: [ADR-0003](adr/adr-0003-staging-gate.md).
@@ -108,84 +78,6 @@ Self-hosting зацикливался на `deploy-staging`: `scripts/staging_ch
 
 Подробнее: [adr-0015](adr/adr-0015-task-deps-and-merge-serialization.md), детально — `docs/work-items/ORCH-026/06-adr/ADR-001-merge-serialization-and-task-deps.md`.
 
-### Per-repo serial gate: пакетный автономный режим (ORCH-088 — реализовано)
-Эпик «10–20 задач за ночь», Этап 1 (serial e2e). Закрывает **stale-анализ**: ветка задачи N+1
-срезалась на входе в анализ (`start_pipeline._create_gitea_branch`) от `main`, ещё не содержащего код
-предшественника N (физическое код-затирание уже закрыто ORCH-026; ORCH-088 — **логический** разрыв).
-Новая задача репо не входит в `analysis` (не режет ветку, не запускает analyst), пока в том же репо
-есть незавершённая задача (`stage != 'done'`) или репо заморожен. Аддитивно, под kill-switch, область
-репо, never-raise, restart-safe; `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` — **без изменений**.
-- **Gate-в-claim** (`db.claim_next_job`) — analyst-job (`jobs.agent='analyst'`) применимого репо не
-  выбирается, если `EXISTS` **более ранняя** незавершённая задача репо (`t2.id < jobs.task_id`) ИЛИ
-  активна строка `repo_freeze`. По образцу `task_deps` `NOT EXISTS` (ORCH-026); только локальная БД
-  (offline hot-path, NFR-2). Job'ы уже активной задачи проходят свободно. **FIFO-уточнение реализации
-  (FR-2):** ADR-001 D1 фиксировал псевдо-SQL `t2.id != jobs.task_id`; при `!=` пакет одновременно
-  созданных свежих задач (все в `analysis`) взаимно блокировался бы (каждая — «другая незавершённая»
-  для остальных) ⇒ дедлок всей serial-очереди. `<` допускает ровно самую раннюю задачу и сериализует
-  остальные за ней (строго по одной, FIFO по `jobs.id`), при этом по-прежнему не блокирует rework-analyst
-  собственной задачи (R-7) и сохраняет AC-1.
-- **Отложенный срез ветки (анти-stale-base, AC-6):** для применимого репо `start_pipeline` создаёт
-  task-row + enqueue analyst, но **не** создаёт Gitea-ветку/docs; срез релоцируется на момент claim
-  analyst-job (launcher), когда `origin/main` уже содержит предшественника (`done` ⇔ SHA-в-main,
-  ORCH-071/073). `ensure_worktree` режет от свежего `origin/main` ⇒ AC-6 структурно. Идемпотентно
-  (`_create_gitea_branch` 409 = no-op).
-- **Durable per-repo freeze** (новая аддитивная таблица `repo_freeze`, `cleared_at IS NULL` = активен) —
-  post-deploy `DEGRADED`/rollback (ORCH-021) → `set_repo_freeze` + Telegram-алерт; gate закрыт
-  безусловно до **ручного** снятия (`POST /serial-gate/unfreeze`). Деградировавшая задача уже `done`
-  (BR-7) ⇒ отдельный сигнал, независимый от `stage`.
-- **Согласование NFR-1:** hot-claim тотальный сбой построения gate-фрагмента → **fail-open** (не
-  заклинить очередь всех проектов, AC-8); freeze в Python-слое (`is_repo_frozen`) → **fail-closed**
-  (безопасность прода, AC-9).
-- Чистая логика — leaf `src/serial_gate.py` (never-raise). Флаги `serial_gate_enabled` (kill-switch),
-  `serial_gate_repos` (CSV; **пусто ⇒ все репо**, в отличие от self-hosting-only ORCH-35/43/58),
-  `serial_gate_freeze_enabled`. Наблюдаемость — аддитивный блок `serial_gate` в `GET /queue`
-  (per-repo `active_task` / `waiting` / `frozen`). Cross-repo параллелизм сохранён (FR-3); при
-  выключенном флаге — нулевая регрессия (enduro не затронут).
-
-Подробнее: [adr-0017](adr/adr-0017-serial-gate.md), детально —
-`docs/work-items/ORCH-088/06-adr/ADR-001-serial-gate.md`,
-`docs/work-items/ORCH-088/08-data-requirements.md`.
-
-### Авто-режим по лейблам: autoApprove + autoDeploy (ORCH-089 — реализовано)
-Конвейер имеет два **человеческих** гейта, тормозящих пакетный автономный прогон (эпик
-ORCH-088): гейт BRD (`analysis`: ждёт ручного `Approved`) и гейт прод-деплоя (`deploy`:
-Phase A ждёт ручного `Confirm Deploy`, ORCH-059). ORCH-089 снимает **только эти два
-человеческих решения** — выборочно (лейбл Plane на задаче), декларативно, обратимо, **не
-трогая ни одной технической проверки**. Аддитивно, по образцу условных под-гейтов
-(ORCH-035/043/058/059/088): leaf `src/labels.py` (never-raise) + точечные врезки + флаги;
-`STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / схема БД — **не трогаются**.
-- **`autoApprove`** → врезка в `stage_engine._handle_analysis_approved_flow` (ветка
-  `files_ok`) после `In Review`+коммента: `set_issue_approved` (индикация) +
-  лог/Telegram/Plane-коммент + `advance_stage(..., finished_agent=None)` — **тот же путь, что
-  человеческий Approved** (`approved-via-status` → `analysis → architecture` +
-  `mark_brd_review_ended`). Без дублирования переходной логики.
-- **`autoDeploy`** → врезка в `stage_engine._handle_self_deploy_phase_a` сразу после advance
-  на `deploy` + `clear_state`: лог/Telegram/Plane-коммент + `_handle_self_deploy_phase_b(...)`
-  (idempotency-маркер `INITIATED`, статус `Deploying`, finalizer). Пропускаются лишь
-  индикативно-человеческие шаги (`Awaiting Deploy` + «ask-human»). **BR-5 структурно:** Phase A
-  достигается только после зелёных под-гейтов ребра `deploy-staging → deploy` (security →
-  merge-gate → image-freshness → staging) → autoDeploy физически не деплоит сломанное.
-- **Чтение лейблов** — `plane_sync.fetch_issue_labels` (поле `labels` issue, `None` при
-  ошибке ≠ `[]`) + `get_project_labels` (`{normalized_name→uuid}`, TTL-кэш по образцу
-  `get_project_states`); сопоставление по нормализованному имени (`strip().casefold()`),
-  неоднозначность → «нет лейбла». Источник истины — Plane API, не payload вебхука. Новый
-  сеттер `set_issue_approved` (ключ `approved` уже в `_DEFAULT_STATES`).
-- **Флаги** (`config.py`): `auto_label_enabled` (kill-switch), `auto_approve_label`/
-  `auto_deploy_label`, `auto_label_repos` (CSV; **пусто → self-hosting only**),
-  `auto_label_states_ttl_s`. `applies(repo)` (локальный) проверяется ПЕРВЫМ; `has_label`
-  (сеть) — только при `applies==True` → при выключенном флаге нулевой сетевой оверхед,
-  нулевая регрессия для enduro.
-- **Fail-safe (never auto):** любая ошибка/недоступность Plane/неоднозначность →
-  «нет авто» → ручной гейт (never-raise). **Идемпотентность:** autoApprove — advance один раз
-  (поздний Approved/F-2 видят `architecture`); autoDeploy — маркер `INITIATED`. **Прозрачность
-  (AC-7):** лог + Telegram + Plane-коммент + live-карточка; блок `auto_labels` в `GET /queue`.
-- **Инфра-предусловие:** создать лейблы `autoApprove`/`autoDeploy` в Plane-проекте ORCH
-  (labels API); их отсутствие = `has_label` False = ручной режим (fail-safe).
-
-Подробнее: [adr-0018](adr/adr-0018-auto-label-gates.md), детально —
-`docs/work-items/ORCH-089/06-adr/ADR-001-auto-label-gates.md`,
-`docs/work-items/ORCH-089/07-infra-requirements.md`.
-
 ### Исполняемый самодеплой стадии `deploy` (ORCH-36)
 `deploy` перестаёт быть «бумажной»: для self-hosting (`is_self_hosting_repo`) стадия
 РЕАЛЬНО деплоит прод (8500) через хост-хук `scripts/orchestrator-deploy-hook.sh`,
@@ -300,39 +192,6 @@ merge-в-main вообще**. Detached host-деплой лишь retag'ал о
 `docs/work-items/ORCH-071/06-adr/ADR-001-merge-verify-gate.md`,
 `docs/work-items/ORCH-073/06-adr/ADR-001-merge-verify-sha-truth-and-regression-guard.md`.
 
-#### Гарантированный код-PR перед merge-verify (ORCH-082 — фикс ложного HOLD «no open PR»)
-Под-гейт merge-verify (ORCH-071/073) детерминированно мержит **открытый** код-PR ветки в `main`
-(`merge_pr`, фильтр `head.ref==branch` И `base.ref=="main"`). Но конвейер **не гарантировал**, что
-к моменту merge у ветки этот PR есть: PR создаётся единственной `launcher._ensure_pr` **только** на
-developer-пути и **только** при свежем worktree-коммите. На деплое ORCH-074 (08.06, первая задача
-после ручных восстановлений `main`) у ветки не оказалось открытого код-PR → `merge_pr` вернул
-`("False", "no open PR")` → защита ORCH-073 верно удержала задачу (HOLD, не ложный `done`), но это
-лечило следствие. ORCH-082 закрывает **отсутствующий инвариант** «к merge-verify у ветки есть
-открытый код-PR» аддитивно, внутри того же под-гейта, не трогая машину стадий:
-- **Новый leaf-актор `merge_gate.ensure_open_pr(repo, branch) -> (status, detail)`** (never-raise):
-  `GET …/pulls?state=open` с фильтром `head.ref==branch` И `base.ref=="main"` (**идентичен**
-  `merge_pr`/ORCH-073 FR-3 — авто-docs-PR `base != main` НЕ код-PR) → `("existed", N)`; иначе
-  `POST …/pulls` → `("created", N)`; гонка «PR exists»/409/422 → повторный GET → `existed` (без
-  дублей); любая иная ошибка → `("failed", reason)`.
-- **Врезка в `_handle_merge_verify`** ПОСЛЕ резолва `validated_revision` и **ПЕРЕД** `merge_pr`:
-  `created|existed` → штатно к `merge_pr` → `verify_merged_to_main`; `failed` → честный HOLD+alert
-  через новый helper `_hold_pr_create_failed` (текст «PR создать не удалось» — отличим от
-  not-merged HOLD; `result.note="pr-create-failed-hold"`), задача остаётся на `deploy`, БЕЗ отката
-  на development.
-- **Защита ORCH-073 неприкосновенна и приоритетна:** подтверждение merge остаётся ТОЛЬКО
-  `verify_merged_to_main` (SHA-в-main) + `check_main_regression`; `ensure_open_pr` устраняет лишь
-  **ложный** HOLD «no open PR», но не маскирует реально невлитый код (тот → HOLD как прежде).
-- **`launcher._ensure_pr`** рекомендуется делегировать в `ensure_open_pr` (единый код создания PR),
-  сохранив прежний триггер «только developer-путь».
-- **Условность как ORCH-35/43/58/71:** kill-switch `merge_verify_autocreate_pr_enabled` (дефолт
-  `true`); область — `merge_verify_applies(repo)` (self-hosting / `merge_verify_repos`); non-self —
-  no-op. `False` → поведение ORCH-074 1:1. Идемпотентность из Gitea (наличие открытого PR), **без
-  миграции БД** (restart-safe). `STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД, `check_deploy_status`,
-  exit-коды хука, merge-gate, image-freshness — без изменений; `main` не push/force-push.
-
-Подробнее: [adr-0016](adr/adr-0016-ensure-open-pr-before-merge-verify.md) (amends 0013/0014);
-детально — `docs/work-items/ORCH-082/06-adr/ADR-001-ensure-open-pr-before-merge-verify.md`.
-
 ### Post-deploy наблюдение прода + реакция на деградацию (ORCH-021 — реализовано)
 Конвейер заканчивался на `deploy → done` и **забывал про прод**: «успех» = health-check
 в момент рестарта (~60с). Класс «зелёный деплой, красный прод» (прецедент ET-8 —
@@ -428,42 +287,6 @@ helper `validated_revision` питает и штамп A, и `EXPECTED_REVISION`
 Подробнее: [adr-0012](adr/adr-0012-security-gate.md), детально —
 `docs/work-items/ORCH-022/06-adr/ADR-001-security-gate.md`.
 
-### Live-трекер: зачистка сирот + эффорт в карточке + честное время (ORCH-087 — реализовано)
-Скалярный `tasks.tracker_message_id` (только последний `message_id`) при рассинхроне
-bump-режима (доминанты: гонка двух `update_task_tracker` и delete-fail+send-ok)
-терял ссылку на прежние карточки → **осиротевшие «замёрзшие»** карточки (скриншот
-ORCH-082: `📍 To Analyse` на задаче, реально дошедшей до `deploy`). G0-расследование
-([ADR-001](../work-items/ORCH-087/06-adr/ADR-001-tracker-orphan-cleanup.md)):
-рендер исправен, корень — потеря учёта старых mid. Решение (bump сохраняется как
-дефолт — фича «карточка внизу» ORCH-042/067):
-- **G1 — полный учёт mid:** аддитивная таблица-леджер `tracker_messages(task_id,
-  message_id, created_at, deleted_at)` (вариант A1; JSON-массив A2 отклонён —
-  lost-update при гонке). На каждом bump зачищаются ВСЕ незакрытые mid (`deleted_at
-  IS NULL`): успех/«already gone» → `deleted_at`, transient → остаётся для ретрая;
-  новый mid в леджер + `set_tracker_message_id` ТОЛЬКО при `send is not None` (BR-6).
-  Скаляр `tracker_message_id` сохранён (BC). Остаточная гонка самозалечивается за один
-  переход (лок не вводится). Known-limitation: Telegram 48ч (сироты старше неудаляемы).
-- **G2/G3 — заголовок/deploy-цикл:** после G1 единственная живая карточка несёт
-  заголовок текущей стадии; `_LIVE_BRANCH_LABELS` дополняется ключом `confirm_deploy`
-  (полнота цикла `Awaiting Deploy → Deploying → Confirm Deploy → Monitoring → Done`).
-- **BR-EFF — эффорт в строке стадии:** новая колонка `agent_runs.effort TEXT`,
-  стамп фактического `resolve_agent_effort` в `launcher._spawn` (CLI эффорт не
-  возвращает); рендер `· {model} · {effort}` (developer=`xhigh`, tester/deployer=
-  `medium`, прочие=`high`); пустой → суффикс опускается.
-- **BR-G5 — честное время:** done-строка `⏱️ Агенты {agent} · твоё {review~cap} ·
-  общее с ожиданием {wall}` — три независимых подписанных метрики; `agent`=Σ
-  `agent_runs` (главная, точная); «твоё» ограничено порогом
-  `tracker_brd_review_cap_s` (дефолт 2ч, маркер `~` при отсечке аномального застоя);
-  `wall` подписан «с ожиданием», не выдаётся за сумму.
-- **Инварианты:** `STAGE_TRANSITIONS`/`QG_CHECKS`/стадии — без изменений; миграции
-  аддитивны/идемпотентны (общая прод-БД, enduro не трогается); never-raise,
-  `disable_notification`, `plane_issue_link` (ORCH-067), `disable_web_page_preview`
-  (ORCH-080) — сохранены; разработка поверх свежего `origin/main` (ORCH-86),
-  `reconciler.py` не эродируется.
-
-Детально — [ADR-001](../work-items/ORCH-087/06-adr/ADR-001-tracker-orphan-cleanup.md),
-`docs/work-items/ORCH-087/08-data-requirements.md`.
-
 ### Reconciler: реконсиляция потерянных webhook (ORCH-053 — реализовано)
 Конвейер продвигается только входящими webhook; потерянное событие (502 на ребилде,
 нет ретраев у Plane/Gitea, неразрезолвленный `sha→branch`) → задача застревает молча
@@ -481,18 +304,6 @@ ORCH-082: `📍 To Analyse` на задаче, реально дошедшей
   ET-013) и (2) в явном Plane-статусе **Blocked** / **Needs Input** (Вариант A —
   запрос Plane API, без миграции БД; never-raise → консервативный skip). Гард
   retry-count проверяется первым (дёшево, локальный SQL).
-  **ORCH-086 (закрытие F-1-пробела ORCH-068):** терминал-исключение и `state_uuid`-dedup
-  (изначально только F-2) распространены на F-1. После дешёвых локальных гардов F-1 делает
-  **один** резолв Plane-статуса задачи на тик (общий fetch для Guard 2 + терминал-скипа +
-  `_note_unblock`); терминальная задача (группа Plane `completed`/`cancelled`, fallback —
-  логические ключи `done`/`cancelled`, ЛИБО стадия в БД орка ∈ `{done, cancelled}`) →
-  **безусловный** ранний скип (`skipped_terminal_total++`, без `advance`/уведомления; не подчинён
-  `reconcile_skip_blocked_enabled`). Вызов `_note_unblock` на F-1 теперь передаёт `state_uuid` →
-  in-memory dedup работает на обоих путях (страховка от повтора после рестарта). Лечит
-  периодическое ложное «ET-002 done разблокирована (потерян webhook)» для терминальных в Plane
-  задач (enduro/orchestrator), сохраняя легитимный unblock реально застрявшей не-терминальной
-  задачи. `STAGE_TRANSITIONS`/`QG_CHECKS`/схема БД/сигнатуры/новые флаги — без изменений. Детали —
-  `docs/work-items/ORCH-086/06-adr/ADR-001-reconciler-f1-terminal-skip-and-dedup.md`.
 - **F-2 plane-side:** опрос Plane API per-project → `handle_status_start` /
   `handle_verdict` из `webhooks/plane.py` (логика не дублируется).
   **ORCH-068 (livelock-fix):** (1) задачи в **терминальной группе** Plane
@@ -646,7 +457,7 @@ Monitoring after Deploy → Done
 ```
 
 - **Длительность** считается launcher'ом (`_monitor_agent`) и пробрасывается в `_post_usage_comments`; для analyst (коммент строится в `stage_engine`) используется DB-фоллбэк `usage.get_agent_duration(task_id, agent)`.
-- **Vердикт-парсер** — единый контракт `src/frontmatter.py` (defensive, never-raise): коммент-хелпер использует `read_frontmatter_value(...)` (single-key, BC), гейты — `parse_frontmatter(...)` (ORCH-52c). Машинные ключи: reviewer → `verdict:` (12-review.md); **testing-гейт `check_tests_passed` (13-test-report.md) → любое из трёх равноправных: `result:` (канон промпта тестера), `verdict:`, `status:`** (ORCH-047, ADR-001); deployer → `deploy_status:` (14-deploy-log.md), `staging_status:` (15-staging-log.md). Negative-токен в любом поле авторитетен (перебивает positive).
+- **Vердикт-парсер** — `src/frontmatter.read_frontmatter_value(...)` (defensive, никогда не raise). Машинные ключи: reviewer → `verdict:` (12-review.md); **testing-гейт `check_tests_passed` (13-test-report.md) → любое из трёх равноправных: `result:` (канон промпта тестера), `verdict:`, `status:`** (ORCH-047, ADR-001); deployer → `deploy_status:` (14-deploy-log.md), `staging_status:` (15-staging-log.md). Negative-токен в любом поле авторитетен (перебивает positive).
 - Формат коммента **не** меняет реестр гейтов и стадий; коммент — отображение, не управление.
 
 ## База данных (SQLite)
@@ -655,7 +466,6 @@ Monitoring after Deploy → Done
 - `agent_runs` — запуски агентов (run_id, usage, cost)
 - `jobs` — очередь задач (ORCH-1); колонка `pid` (ORCH-065) — pid агентского процесса для liveness-детекции зомби job-reaper'ом
 - `job_deps` — декларативные зависимости задач (ORCH-026, Уровень B): `(task_id, depends_on_task_id)`, аддитивная; источник истины планировщика для гейта «B ждёт A»
-- `repo_freeze` — durable per-repo rollback-freeze (ORCH-088, FR-5): `(id, repo, frozen_at, reason, work_item_id, cleared_at)`, аддитивная append-only; активный freeze ⇔ строка репо с `cleared_at IS NULL`. Выставляется post-deploy `DEGRADED` (`set_repo_freeze`), снимается вручную (`POST /serial-gate/unfreeze` → `cleared_at=now`). Гейтит serial-claim безусловно (деградировавшая задача уже `done`)
 
 ## Изоляция (git worktree, ORCH-2)
 Каждая задача исполняется в отдельном git worktree, ветки не пересекаются. Репозитории проектов разделены под `/repos/<project>`.
@@ -665,8 +475,7 @@ Monitoring after Deploy → Done
 |--------|------|----------|
 | GET | `/health` | health check |
 | GET | `/status` | активные задачи (stage != done) |
-| GET | `/queue` | очередь: counts + max_concurrency + resilience + reconcile (ORCH-053) + reaper (ORCH-065) + post_deploy (ORCH-021) + task_deps (ORCH-026) + serial_gate (ORCH-088) + последние jobs |
-| POST | `/serial-gate/unfreeze` | ORCH-088 (FR-5): ручное снятие per-repo rollback-freeze (query/body `repo=<repo>`) → `{ok, repo, cleared, frozen}`; идемпотентно. Альтернатива — `UPDATE repo_freeze SET cleared_at=datetime('now') WHERE repo=? AND cleared_at IS NULL` |
+| GET | `/queue` | очередь: counts + max_concurrency + resilience + reconcile (ORCH-053) + reaper (ORCH-065) + post_deploy (ORCH-021) + последние jobs |
 | POST | `/webhook/plane` | Plane webhook |
 | POST | `/webhook/gitea` | Gitea webhook (push, PR, CI status) |
 
@@ -684,4 +493,3 @@ Monitoring after Deploy → Done
 *Актуально на 2026-06-07. Обновлять при изменении src/stages.py, src/qg/checks.py, src/main.py. Статусы доработок: ORCH-036 (исполняемый самодеплой `deploy`, adr-0007) — реализовано; ORCH-043 (merge-gate, adr-0006) — design, ветка feature/ORCH-043; ORCH-053 (reconciler, adr-0007, src/reconciler.py) — реализовано; ORCH-060 (F-1 skip escalated/Blocked/Needs-Input, `docs/work-items/ORCH-060/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-060 (Guard 1 `developer_retry_count>=MAX_DEVELOPER_RETRIES` + Guard 2 `plane_sync.fetch_issue_state` Blocked/Needs-Input, флаг `ORCH_RECONCILE_SKIP_BLOCKED_ENABLED`); ORCH-058 (провенанс staging-образа: check_staging_image_fresh + staging_check свежего образа + хук-guard, adr-0008) — реализовано в ветке feature/ORCH-058 (обновлять также при изменении src/image_freshness.py, scripts/orchestrator-deploy-hook.sh, Dockerfile); ORCH-061 (толерантность staging-вердикта к инфра-FAIL C9a/C9b, adr-0009, `docs/work-items/ORCH-061/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-061 (обновлять также при изменении src/staging_verdict.py, scripts/staging_check.py, флаг staging_infra_tolerance_enabled); ORCH-021 (post-deploy наблюдение прода + реакция на деградацию, adr-0010, `docs/work-items/ORCH-021/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-021-post-deploy-rollback (reserved-agent job `post-deploy-monitor`: арм в src/stage_engine.py блок `next_stage == "done"`, тик `run_post_deploy_monitor` + перехват в src/agents/launcher.py ДО _spawn; чистая логика src/post_deploy.py never-raise; флаги `post_deploy_*` в src/config.py; блок `post_deploy` в `/queue`; артефакт 16-post-deploy-log.md; self-hosting всегда ALERT_ONLY — тик не рестартит прод; обновлять также при изменении src/post_deploy.py / арм-блока / launcher-перехвата); ORCH-065 (job-reaper + проактивный реклейм merge-lease + идемпотентная финализация merge, adr-0011, `docs/work-items/ORCH-065/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-065 (новый daemon-поток src/job_reaper.py + старт/стоп в src/main.py lifespan; колонка `jobs.pid` через _ensure_column + проставление в src/agents/launcher.py `_spawn`; функции реклейма lease `pid_alive`/`reclaim_stale_lease` + guard `pr_already_merged` в src/merge_gate.py (консультируется merge-актором — промпт `.openclaw/agents/deployer.md`); флаги `reaper_*`/`lease_reclaim_*` в src/config.py; блок `reaper` в `/queue`; обновлять также при изменении этих мест); ORCH-059 (выделенный статус-триггер прод-деплоя «Confirm Deploy», ADR `docs/work-items/ORCH-059/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-059 (маппинг `"Confirm Deploy"→"confirm_deploy"` в src/plane_sync.py `_PLANE_NAME_TO_KEY`, НЕ в `_DEFAULT_STATES` = fail-closed; ветка `handle_confirm_deploy` + fail-closed `.get("confirm_deploy")` в src/webhooks/plane.py `handle_issue_updated`; keyword-only `confirm_deploy` в src/stage_engine.py `advance_stage` — Фаза B деплоит ТОЛЬКО при `confirm_deploy=True`, иначе `Approved`-на-`deploy` = no-op; CTA Фазы A просит «Confirm Deploy»; эксплуатация — статус доски «Confirm Deploy» в Plane-проекте ORCH, `docs/work-items/ORCH-059/07-infra-requirements.md`).*
 *Актуально на 2026-06-07. Обновлять при изменении src/stages.py, src/qg/checks.py, src/main.py. Статусы доработок: ORCH-036 (исполняемый самодеплой `deploy`, adr-0007) — реализовано; ORCH-043 (merge-gate, adr-0006) — design, ветка feature/ORCH-043; ORCH-053 (reconciler, adr-0007, src/reconciler.py) — реализовано; ORCH-060 (F-1 skip escalated/Blocked/Needs-Input, `docs/work-items/ORCH-060/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-060 (Guard 1 `developer_retry_count>=MAX_DEVELOPER_RETRIES` + Guard 2 `plane_sync.fetch_issue_state` Blocked/Needs-Input, флаг `ORCH_RECONCILE_SKIP_BLOCKED_ENABLED`); ORCH-058 (провенанс staging-образа: check_staging_image_fresh + staging_check свежего образа + хук-guard, adr-0008) — реализовано в ветке feature/ORCH-058 (обновлять также при изменении src/image_freshness.py, scripts/orchestrator-deploy-hook.sh, Dockerfile); ORCH-061 (толерантность staging-вердикта к инфра-FAIL C9a/C9b, adr-0009, `docs/work-items/ORCH-061/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-061 (обновлять также при изменении src/staging_verdict.py, scripts/staging_check.py, флаг staging_infra_tolerance_enabled); ORCH-021 (post-deploy наблюдение прода + реакция на деградацию, adr-0010, `docs/work-items/ORCH-021/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-021-post-deploy-rollback (reserved-agent job `post-deploy-monitor`: арм в src/stage_engine.py блок `next_stage == "done"`, тик `run_post_deploy_monitor` + перехват в src/agents/launcher.py ДО _spawn; чистая логика src/post_deploy.py never-raise; флаги `post_deploy_*` в src/config.py; блок `post_deploy` в `/queue`; артефакт 16-post-deploy-log.md; self-hosting всегда ALERT_ONLY — тик не рестартит прод; обновлять также при изменении src/post_deploy.py / арм-блока / launcher-перехвата); ORCH-065 (job-reaper + проактивный реклейм merge-lease + идемпотентная финализация merge, adr-0011, `docs/work-items/ORCH-065/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-065 (новый daemon-поток src/job_reaper.py + старт/стоп в src/main.py lifespan; колонка `jobs.pid` через _ensure_column + проставление в src/agents/launcher.py `_spawn`; функции реклейма lease `pid_alive`/`reclaim_stale_lease` + guard `pr_already_merged` в src/merge_gate.py (консультируется merge-актором — промпт `.openclaw/agents/deployer.md`); флаги `reaper_*`/`lease_reclaim_*` в src/config.py; блок `reaper` в `/queue`; обновлять также при изменении этих мест); ORCH-066 (осмысленная статусная модель Plane — слой B, `docs/work-items/ORCH-066/06-adr/ADR-001-plane-status-model.md`) — реализовано в ветке feature/ORCH-066-plane (только Plane-индикация: новые ключи `to_analyse`/`analysis`/`code_review`/`awaiting_deploy`/`deploying`/`monitoring` в `_PLANE_NAME_TO_KEY`/`_DEFAULT_STATES` + project-relative `_STATE_ALIAS_FALLBACK` в get_project_states + `_STAGE_TO_STATE_KEY` analysis/review + 5 новых `set_issue_*` в src/plane_sync.py; триггер `in_progress`→`to_analyse` и `set_issue_analysis` в src/webhooks/plane.py; Phase A→Awaiting Deploy / Phase B→Deploying / terminal-sync split monitoring↔done / post-deploy monitor HEALTHY→Done DEGRADED→Blocked в src/stage_engine.py; F-2 триггер `to_analyse` + Guard 2 skip-set с вычитанием base_working в src/reconciler.py; `STAGE_TRANSITIONS`/QG/схема БД НЕ трогаются; без kill-switch — раскат гейтится созданием 6 Plane-статусов оператором, `docs/work-items/ORCH-066/07-infra-requirements.md`; обновлять при изменении этих мест).*
 *Актуально на 2026-06-07. Обновлять при изменении src/stages.py, src/qg/checks.py, src/main.py. Статусы доработок: ORCH-036 (исполняемый самодеплой `deploy`, adr-0007) — реализовано; ORCH-043 (merge-gate, adr-0006) — design, ветка feature/ORCH-043; ORCH-053 (reconciler, adr-0007, src/reconciler.py) — реализовано; ORCH-060 (F-1 skip escalated/Blocked/Needs-Input, `docs/work-items/ORCH-060/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-060 (Guard 1 `developer_retry_count>=MAX_DEVELOPER_RETRIES` + Guard 2 `plane_sync.fetch_issue_state` Blocked/Needs-Input, флаг `ORCH_RECONCILE_SKIP_BLOCKED_ENABLED`); ORCH-058 (провенанс staging-образа: check_staging_image_fresh + staging_check свежего образа + хук-guard, adr-0008) — реализовано в ветке feature/ORCH-058 (обновлять также при изменении src/image_freshness.py, scripts/orchestrator-deploy-hook.sh, Dockerfile); ORCH-061 (толерантность staging-вердикта к инфра-FAIL C9a/C9b, adr-0009, `docs/work-items/ORCH-061/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-061 (обновлять также при изменении src/staging_verdict.py, scripts/staging_check.py, флаг staging_infra_tolerance_enabled); ORCH-021 (post-deploy наблюдение прода + реакция на деградацию, adr-0010, `docs/work-items/ORCH-021/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-021-post-deploy-rollback (reserved-agent job `post-deploy-monitor`: арм в src/stage_engine.py блок `next_stage == "done"`, тик `run_post_deploy_monitor` + перехват в src/agents/launcher.py ДО _spawn; чистая логика src/post_deploy.py never-raise; флаги `post_deploy_*` в src/config.py; блок `post_deploy` в `/queue`; артефакт 16-post-deploy-log.md; self-hosting всегда ALERT_ONLY — тик не рестартит прод; обновлять также при изменении src/post_deploy.py / арм-блока / launcher-перехвата); ORCH-065 (job-reaper + проактивный реклейм merge-lease + идемпотентная финализация merge, adr-0011, `docs/work-items/ORCH-065/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-065 (новый daemon-поток src/job_reaper.py + старт/стоп в src/main.py lifespan; колонка `jobs.pid` через _ensure_column + проставление в src/agents/launcher.py `_spawn`; функции реклейма lease `pid_alive`/`reclaim_stale_lease` + guard `pr_already_merged` в src/merge_gate.py (консультируется merge-актором — промпт `.openclaw/agents/deployer.md`); флаги `reaper_*`/`lease_reclaim_*` в src/config.py; блок `reaper` в `/queue`; обновлять также при изменении этих мест); ORCH-068 (livelock-fix reconciler F-2: терминал-исключение по группе состояния + `_note_unblock` только при подтверждённом state change + дедуп; TTL `_STATES_CACHE`, `docs/work-items/ORCH-068/06-adr/ADR-001`) — реализовано в ветке feature/ORCH-068 (D1 терминал-гард по группе `_is_terminal_state` + `get_project_state_groups` в src/plane_sync.py; D2 сравнение стадии до/после `_dispatch` + дедуп-словарь в src/reconciler.py; TTL-запись `_STATES_CACHE` + флаг `plane_states_ttl_s` в src/config.py; счётчики `skipped_terminal_total`/`deduped_total` в `/queue`; обновлять также при изменении src/reconciler.py F-2, src/plane_sync.py `get_project_states`/`get_project_state_groups`/`_STATES_CACHE`).*
-*Актуально на 2026-06-09. Статус доработки: ORCH-088 (per-repo serial gate, Этап 1 serial e2e, adr-0017, `docs/work-items/ORCH-088/06-adr/ADR-001-serial-gate.md`) — реализовано в ветке feature/ORCH-088 (leaf src/serial_gate.py never-raise: gate-фрагмент в src/db.py `claim_next_job` fail-OPEN c FIFO-условием `t2.id < jobs.task_id` + freeze `repo_freeze.cleared_at IS NULL`, freeze-решения fail-CLOSED; отложенный срез ветки src/webhooks/plane.py `start_pipeline` → src/agents/launcher.py `_materialize_deferred_branch` (sync `asyncio.run` в worker-потоке) при claim analyst-job; durable freeze таблица `repo_freeze` (idempotent миграция в init_db) + `set_repo_freeze` в src/stage_engine.py DEGRADED-ветке `run_post_deploy_monitor` + ручное снятие `POST /serial-gate/unfreeze` в src/main.py; флаги `serial_gate_enabled`/`serial_gate_repos`/`serial_gate_freeze_enabled` в src/config.py; блок `serial_gate` в `GET /queue`; `STAGE_TRANSITIONS`/`QG_CHECKS` НЕ трогаются; обновлять также при изменении этих мест).*

docs/architecture/adr/README.md

@@ -21,19 +21,12 @@ Per-work-item решения живут в `docs/work-items/<id>/06-adr/ADR-NNN-
 | adr-0013 | Merge-в-main + пост-деплой верификация как условие `done` | accepted | 2026-06-08 | ORCH-071 |
 | adr-0014 | SHA-в-main — единственный критерий merge-verify + регресс-гард | accepted | 2026-06-08 | ORCH-073 |
 | adr-0015 | Зависимости задач (B ждёт A) + сериализация merge внутри репо | accepted | 2026-06-08 | ORCH-026 |
-| adr-0016 | ensure_open_pr — гарантированный код-PR перед merge-verify | accepted | 2026-06-09 | ORCH-082 |
-| adr-0017 | Per-repo serial gate (пакетный автономный режим, serial e2e) | proposed | 2026-06-09 | ORCH-088 |
-| adr-0018 | Авто-режим по лейблам (autoApprove + autoDeploy) | accepted | 2026-06-09 | ORCH-089 |
-| adr-0019 | Стандарт документов конвейера (PIPELINE_DOCS, слой 1) | accepted | 2026-06-09 | ORCH-075 |
-| adr-0020 | Единый frontmatter-контракт + спека handoff (reader/writer/валидатор) | accepted | 2026-06-09 | ORCH-076 |
 
 > ⚠️ Историческая коллизия: номер `0007` занят двумя файлами —
 > `adr-0007-reconciler.md` (ORCH-053) и `adr-0007-executable-self-deploy.md`
 > (ORCH-036). Оба accepted; для новых сквозных ADR использовать следующий
-> свободный номер (текущий максимум — `0020`).
+> свободный номер (текущий максимум — `0015`).
 > adr-0014 **amends** adr-0013 (меняет критерий merge-verify на «SHA-в-main»).
-> adr-0016 **amends** adr-0013/0014 (гарантирует открытый код-PR перед merge_pr, ORCH-082).
-> adr-0020 реализует машинный слой к adr-0019 (ORCH-52b→52c).
 
 ## Формат
 **Контекст → Решение → Альтернативы → Последствия → Связи.** Статус: proposed / accepted / superseded.

docs/architecture/adr/adr-0016-ensure-open-pr-before-merge-verify.md

@@ -1,52 +0,0 @@
-# ADR-0016: ensure_open_pr — гарантированный код-PR перед merge-verify (ORCH-082)
-
-## Статус
-Accepted — амендмент к [adr-0013](adr-0013-merge-verify-gate.md) и
-[adr-0014](adr-0014-merge-verify-sha-source-of-truth.md). Детально:
-`docs/work-items/ORCH-082/06-adr/ADR-001-ensure-open-pr-before-merge-verify.md`.
-
-## Контекст
-Merge-verify (ORCH-071/073) — под-гейт ребра `deploy → done`: детерминированно мержит код-PR в
-`main` (`merge_pr`) и подтверждает merge **только** по «SHA-в-main» (`verify_merged_to_main`,
-ORCH-073). На деплое ORCH-074 (08.06) `merge_pr` вернул `("False", "no open PR")`: у ветки **не
-было** открытого PR с `head==branch` И `base=="main"`. Защита ORCH-073 верно удержала задачу
-(HOLD, не ложный `done`), но это лечило **следствие**.
-
-Первопричина (код-аудит): PR создаётся в конвейере **единственной** функцией
-`launcher._ensure_pr`, вызываемой **только** на developer-пути и **только** при свежем
-worktree-коммите. Любой сценарий без свежего developer-коммита (бойнс без правок, повторный
-прогон, **ручное восстановление ветки/`main`** — случай ORCH-074) оставляет ветку без код-PR.
-Инвариант «к merge-verify у ветки есть открытый код-PR» в конвейере **отсутствовал** → блокер
-автономного деплоя (ORCH-54).
-
-## Решение
-Аддитивно обеспечить инвариант **внутри того же под-гейта**, ПЕРЕД `merge_pr`, не трогая машину
-стадий:
-
-1. **Новый leaf-актор `merge_gate.ensure_open_pr(repo, branch) -> (status, detail)`** (never-raise):
-   `GET …/pulls?state=open` с фильтром **`head.ref==branch` И `base.ref=="main"`** (идентичен
-   `merge_pr`/ORCH-073 FR-3 — авто-docs-PR не считается код-PR) → `("existed", N)`; иначе
-   `POST …/pulls` → `("created", N)`; гонка «PR exists» → повторный GET → `existed` (без дублей);
-   любая ошибка → `("failed", reason)`.
-2. **Врезка в `_handle_merge_verify`** ПОСЛЕ резолва `validated_revision` и ПЕРЕД `merge_pr`:
-   `created|existed` → штатно к `merge_pr`; `failed` → честный HOLD+alert через новый helper
-   `_hold_pr_create_failed` (текст «PR создать не удалось» — отличим от not-merged HOLD), задача
-   остаётся на `deploy`, БЕЗ отката на development.
-3. **Kill-switch `merge_verify_autocreate_pr_enabled`** (дефолт `True`); область —
-   `merge_verify_applies` (self-hosting / `merge_verify_repos`). `False` → поведение ORCH-074 1:1.
-4. **`launcher._ensure_pr`** рекомендуется делегировать в `ensure_open_pr` (единый код создания
-   PR), сохранив прежний триггер «только developer-путь».
-
-## Последствия
-- **Защита ORCH-073 неприкосновенна и приоритетна:** подтверждение merge остаётся ТОЛЬКО
-  `verify_merged_to_main` (SHA-в-main) + `check_main_regression`. Создание PR устраняет лишь
-  **ложный** HOLD «no open PR», но не маскирует реально невлитый код (тот → HOLD как прежде).
-- **Без миграций:** идемпотентность выводится из Gitea (наличие открытого PR), схема БД не меняется
-  — restart-safe; повторный заход (reaper/reconciler/re-approve) → `existed`, дублей нет.
-- **Инварианты целы:** `STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД, `check_deploy_status`,
-  exit-коды хука, merge-gate (ORCH-043), image-freshness (ORCH-058) — без изменений; `main` не
-  push/force-push; never-raise на всём пути.
-- **Наблюдаемость:** один однозначный исход в логах на проход — created / existed / failed; HOLD по
-  failed текстуально отличим от HOLD not-merged.
-- **Минус:** код-PR может создаваться после прохождения гейтов — безопасно, т.к. гейты валидируют
-  код ветки, а merge-verify идёт ПОСЛЕ всех гейтов; PR — лишь механизм слияния, ревью не обходится.

docs/architecture/adr/adr-0017-serial-gate.md

@@ -1,59 +0,0 @@
-# adr-0017: Per-repo serial gate (пакетный автономный режим, serial e2e)
-
-Статус: **proposed** · Дата: 2026-06-09 · Источник: **ORCH-088** (Этап 1)
-Детально: `docs/work-items/ORCH-088/06-adr/ADR-001-serial-gate.md`.
-
-## Контекст
-Цель эпика ORCH-088 — масштаб автономности: накидать вечером 10–20 задач и получить к утру пакет,
-последовательно проведённый через весь конвейер (analysis → … → deploy → done). Корневая проблема —
-**stale-анализ**: ветка задачи N+1 срезается на входе в анализ (`start_pipeline._create_gitea_branch`)
-от `main`, ещё не содержащего код предшественника N. Физическое код-затирание уже закрыто (ORCH-026
-auto_rebase + merge-lease); остаётся **логический** разрыв. Plane API v1 не имеет bulk/relations ⇒
-очередь/зависимости хранятся у оркестратора (gate по локальной БД).
-
-## Решение
-**Per-repo serial gate** — новая задача репо не входит в `analysis` (не режет ветку, не запускает
-analyst), пока в том же репо есть незавершённая задача (`stage != 'done'`) или репо заморожен.
-Три механизма, аддитивно, под kill-switch, с областью репо, never-raise, restart-safe:
-
-1. **Gate-в-claim** (`db.claim_next_job`) — analyst-job (`jobs.agent='analyst'`) применимого репо не
-   выбирается, если `EXISTS` другая незавершённая задача репо ИЛИ активна строка `repo_freeze`. По
-   образцу `task_deps` `NOT EXISTS` (ORCH-026); только локальная БД (offline hot-path). Job'ы уже
-   активной задачи проходят свободно; rework-analyst не блокирует себя (`t2.id != jobs.task_id`).
-2. **Отложенный срез ветки** — для применимого репо `start_pipeline` создаёт task-row + enqueue
-   analyst, но **не** создаёт Gitea-ветку/docs; срез релоцируется на момент claim analyst-job
-   (launcher), когда `origin/main` уже содержит предшественника (`done` ⇔ SHA-в-main, ORCH-071/073).
-   `ensure_worktree` режет от свежего `origin/main` ⇒ AC-6 структурно. Идемпотентно (409 = no-op).
-3. **Durable per-repo freeze** (`repo_freeze`) — post-deploy `DEGRADED`/rollback (ORCH-021) →
-   `set_repo_freeze` + Telegram-алерт; gate закрыт безусловно до **ручного** снятия
-   (`POST /serial-gate/unfreeze`). Деградировавшая задача уже `done` (BR-7) ⇒ нужен отдельный сигнал.
-
-Чистая логика — leaf `src/serial_gate.py` (never-raise). Флаги `serial_gate_enabled` (kill-switch),
-`serial_gate_repos` (CSV; **пусто ⇒ все репо**, в отличие от self-hosting-only ORCH-35/43/58),
-`serial_gate_freeze_enabled`. Наблюдаемость — блок `serial_gate` в `GET /queue`.
-
-## Альтернативы
-- **Гейт в `start_pipeline` + re-trigger при `done`** — больше состояния/путей, риск зависших задач;
-  relocation на claim переиспользует restart-safe `jobs`-очередь.
-- **Freeze как колонка `tasks`** — неверная семантика (freeze per-repo, задача уже `done`).
-- **Self-hosting-only область** — лишает enduro анти-stale-base (FR-3).
-- **Отдельная таблица очереди ожидания** — избыточно; `jobs(queued)`+gate достаточно.
-- **Снятие freeze Plane-жестом** — перегрузка статусов (анти-паттерн ORCH-059).
-
-## Последствия
-- **+** AC-6 закрыт структурно; AC-2/AC-3 «бесплатны» (ожидание = `queued` job без ветки);
-  переиспользование проверенных паттернов; cross-repo параллелизм сохранён; `STAGE_TRANSITIONS` /
-  `QG_CHECKS` / `check_*` / merge-gate / merge-verify / image-freshness / post-deploy / deploy-хук /
-  `max_concurrency` — **без изменений**.
-- **NFR-1:** hot-claim тотальный сбой → **fail-open** (не заклинить очередь всех проектов); freeze в
-  Python-слое → **fail-closed** (безопасность прода).
-- **−** Срез ветки/docs мигрируют из async в sync-путь launcher (обёртка); Blocked-задача держит пакет
-  (Этап 1, осознанно); freeze снимается только вручную.
-- Откат: `serial_gate_enabled=False` ⇒ claim/старт 1:1 как до ORCH-088; таблица `repo_freeze` инертна.
-- **Вне скопа** (Этап 1): merge-очередь FIFO, pre-merge rebase как отдельная фича, фазы A/B/C,
-  любой параллелизм задач внутри одного репо, зависимость от ORCH-83.
-
-## Связи
-- Переиспользует: adr-0002 (очередь ORCH-1), adr-0015 (claim-gate/auto_rebase/merge-lease ORCH-026),
-  adr-0010 (post-deploy monitor — источник DEGRADED), adr-0013/0014 (merge-verify ⇒ `done`⇔SHA-в-main).
-- Новая аддитивная таблица `repo_freeze` (`docs/work-items/ORCH-088/08-data-requirements.md`).

docs/architecture/adr/adr-0018-auto-label-gates.md

@@ -1,59 +0,0 @@
-# ADR-0018: Авто-режим по лейблам — autoApprove / autoDeploy (ORCH-089)
-
-## Статус
-Accepted (реализация — ORCH-089)
-
-## Контекст
-Конвейер имеет два **человеческих** гейта, тормозящих пакетный автономный прогон
-(эпик ORCH-088, «10–20 задач за ночь»):
-1. **BRD** (`analysis`): ждёт ручного Plane-статуса `Approved` → advance на `architecture`.
-2. **Прод-деплой** (`deploy`): Phase A ставит `Awaiting Deploy` и ждёт ручного
-   `Confirm Deploy` (ORCH-059) → Phase B (`initiate_deploy`).
-
-Для доверенных задач оба клика избыточны. Нужно снять **только эти два человеческих
-решения**, выборочно/декларативно (лейбл Plane на задаче), не ослабляя ни одной
-технической проверки.
-
-## Решение
-Аддитивно, по образцу условных под-гейтов (ORCH-035/043/058/059/088): leaf-модуль чистой
-логики `src/labels.py` (never-raise) + точечные врезки + флаги. `STAGE_TRANSITIONS`, реестр
-`QG_CHECKS`, все `check_*`, схема БД — **не трогаются**.
-
-- **`autoApprove`** (лейбл задачи) → в `_handle_analysis_approved_flow` (ветка `files_ok`)
-  после `In Review`+коммента: `set_issue_approved` (индикация) + лог/Telegram/Plane-коммент +
-  `advance_stage(..., finished_agent=None)` — тот же путь, что человеческий Approved
-  (`approved-via-status` → `analysis → architecture` + `mark_brd_review_ended`). Без
-  дублирования переходной логики.
-- **`autoDeploy`** (лейбл задачи) → в `_handle_self_deploy_phase_a` сразу после advance на
-  `deploy` + `clear_state`: лог/Telegram/Plane-коммент + `_handle_self_deploy_phase_b(...)`
-  (idempotency-маркер `INITIATED`, `Deploying`, finalizer). Пропускаются лишь
-  индикативно-человеческие шаги (`Awaiting Deploy` + «ask-human»).
-- **Чтение лейблов** — `plane_sync.fetch_issue_labels` + `get_project_labels` (TTL-кэш,
-  образец `get_project_states`); сопоставление по нормализованному имени; источник истины —
-  Plane API (не payload). Новый сеттер `set_issue_approved` (ключ `approved` уже в states).
-- **Флаги:** `auto_label_enabled` (kill-switch), `auto_approve_label`/`auto_deploy_label`
-  (имена), `auto_label_repos` (CSV; **пусто → self-hosting only**), `auto_label_states_ttl_s`.
-  `applies(repo)` (локальный) проверяется ПЕРВЫМ; `has_label` (сеть) — только если
-  `applies==True` → при выключенном флаге нулевой сетевой оверхед.
-
-## Критические инварианты
-- **Авто-режим снимает ТОЛЬКО человеческое решение**, не ослабляя ни один тех-гейт
-  (CI / staging / security / merge-gate / image-freshness / merge-verify / regression-guard /
-  post-deploy). autoDeploy живёт в точке, где все под-гейты ребра `deploy-staging → deploy`
-  уже зелёные → структурно «никогда не деплоит сломанное».
-- **Fail-safe (never auto):** любая ошибка/недоступность Plane/неоднозначность имени →
-  «нет авто» → ручной гейт (согласовано с fail-closed-практикой ORCH-059). never-raise.
-- **Нулевая регрессия:** без лейблов / `auto_label_enabled=False` / репо вне scope →
-  поведение 1:1 как до ORCH-089 (enduro не затронут).
-- **Идемпотентность:** autoApprove — advance применяется один раз (поздний Approved/F-2
-  видят уже `architecture`); autoDeploy — маркер `INITIATED`.
-
-## Последствия
-**+** минимальная поверхность, единый источник истины перехода, декларативно/обратимо,
-независимые лейблы, безопасный дефолт. **−** Approved-статус транзиентен (durable-аудит —
-лог/Telegram/коммент); 1–2 GET к Plane на гейт применимого репо (TTL-кэш карты лейблов);
-требуется однократно создать лейблы в Plane-проекте ORCH (инфра-предусловие; их отсутствие =
-fail-safe ручной режим).
-
-Детально: `docs/work-items/ORCH-089/06-adr/ADR-001-auto-label-gates.md`,
-`07-infra-requirements.md`, `10-tech-risks.md`.

docs/architecture/adr/adr-0019-pipeline-docs-standard.md

@@ -1,49 +0,0 @@
-# adr-0019: Стандарт документов пайплайна (docs/_standards + docs/_templates + ADR-naming)
-
-Статус: **proposed** · Дата: 2026-06-09 · Источник: **ORCH-075** (ORCH-52b, слой 1 эпика ORCH-52)
-Детально: `docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md`.
-
-## Контекст
-Агенты всех ролей пишут номерные доки work item (`00…17`) «по памяти»; каталогов
-`docs/_standards/` и `docs/_templates/` нет. Следствия: разнобой структуры между задачами; риск
-рассинхрона критичных frontmatter-ключей машинных доков (`verdict:` / `result:` / `deploy_status:` /
-`staging_status:` / `security_status:`), которые читает гейт; отсутствует целостная карта «стадия →
-агент → документ → гейт». Эпик ORCH-52 слоист: слой 1 (52b) фиксирует **договорённость**, машинная
-проверка/валидатор — отдельный слой 52c.
-
-## Решение
-**Документационный стандарт, docs-only, выведенный из фактического кода и эталонных доков:**
-
-1. `docs/_standards/PIPELINE_DOCS.md` — манифест-карта «стадия → документ → владелец-агент →
-   категория (`required`/`when-applicable`/`optional`) → гейт/механизм → frontmatter machine-key».
-   Манифест **документирует** поведение гейтов (источник истины остаётся `src/`), честно различает
-   machine-verdict доки (`12,13,14,15,17`) и информационные (`00,08,10,16`), и помечает под-гейты
-   ребра `deploy-staging→deploy` (security/merge/image-freshness) как врезки в `advance_stage`, а не
-   строки `STAGE_TRANSITIONS`.
-2. `docs/_templates/*` — копируемые скелеты для каждого `required`/`when-applicable` дока; секции
-   выведены из эталонов (ORCH-088/073/089/071), новые не изобретаются; машинные доки несут точный
-   frontmatter-ключ из ground-truth.
-3. **ADR-naming** канонизирован: `docs/work-items/<plane-id>/06-adr/ADR-NNN-<kebab-slug>.md` (NNN с
-   `001`); кросс-каттинговые решения дублируются в этот глобальный реестр `adr-NNNN-<slug>.md`.
-
-Подключение — ссылки из `CLAUDE.md` и `docs/architecture/README.md` + запись в `CHANGELOG.md`.
-
-## Альтернативы
-- Сразу валидатор на гейте — отвергнуто (ORCH-52c; нарушил бы docs-only/NFR-1, групповой риск).
-- Манифест как источник истины гейтов — отвергнуто (дубль-истина «манифест ≠ код»).
-- Шаблоны в `docs/work-items/_template/` — отвергнуто (риск для сканеров/гейтов наличия файлов).
-- Ретро-фит истории доков — отвергнуто (вне scope, отдельный риск).
-
-## Последствия
-- **+** Единый golden source структуры доков; меньше ложных падений гейтов из-за неверного
-  frontmatter-ключа; ADR-naming записан; база для ORCH-52c.
-- **+ Нулевой рантайм-риск:** только `docs/**` + `CLAUDE.md` + `CHANGELOG.md`; `STAGE_TRANSITIONS` /
-  `QG_CHECKS` / `check_*` / `src/stage_engine.py` / схема БД — без изменений; полностью обратимо.
-- **−** Манифест — снимок поведения гейтов, дрейфует до ORCH-52c (митигейшн: источник истины — код,
-  reviewer-правило, привязка к именам `check_*`); стандарт описательный, не принуждающий.
-
-## Связи
-- Источник: ORCH-075 (`docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md`).
-- Документирует (не меняет): adr-0003/0006/0008/0012/0013/0014/0016 (гейты и под-гейты ребра),
-  `STAGE_TRANSITIONS` (`src/stages.py`), `QG_CHECKS` (`src/qg/checks.py`).
-- Downstream: ORCH-52c (frontmatter-валидатор / writer-контракт), ORCH-52d (правка промптов).

docs/architecture/adr/adr-0020-frontmatter-contract.md

@@ -1,63 +0,0 @@
-# adr-0020: Единый frontmatter-контракт + спека handoff (reader/writer/валидатор)
-
-Статус: **Accepted** · Дата: 2026-06-09 · Источник: **ORCH-076** (ORCH-52c)
-Детально: [`docs/work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md`](../../work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md)
-
-## Контекст
-
-Слой 1 эпика ORCH-52 (ORCH-075/52b) дал **описательный** стандарт документов
-(`docs/_standards/PIPELINE_DOCS.md`), явно отложив машинную проверку на ORCH-52c. В коде:
-`src/frontmatter.py` — только single-key reader (never-raise), а ~10-строчный блок парсинга
-YAML-frontmatter **продублирован** в 5 вердикт-парсерах (`check_reviewer_verdict`,
-`_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status`, `parse_security_status`)
-+ в `_strip_frontmatter`/`extract_security_findings`. Единого контракта чтения, writer'а, схемы
-и формальной спеки handoff — нет. Эти парсеры читают вердикты **на гейтах self-hosting**
-инструмента, обслуживающего прод других проектов из общего инстанса → любой регресс = стоп
-конвейера всех проектов.
-
-## Решение
-
-1. **`src/frontmatter.py` → полный frontmatter-контракт** (функции в существующем leaf-модуле,
-   контракт **never-raise**): сохранённый `read_frontmatter_value` (без изменений) + единый
-   парс-примитив `parse_frontmatter(content) -> FrontmatterParse` (единственная точка
-   YAML-логики, структура различает no-block / malformed / yaml-error / data) + `render_/
-   write_frontmatter` (writer) + `validate_schema` (обязательная схема
-   `work_item, stage, author_agent, status, created_at, model_used`) + `strip_frontmatter`.
-2. **Унифицируется механизм парсинга, НЕ семантика.** Все 5 вердикт-парсеров читают YAML через
-   `parse_frontmatter`; token-наборы, upper-casing, приоритет негативного токена, 3-полевой
-   контракт tester'а (ORCH-047), fallback `worktree→origin/main` — **1:1**. Сигнатуры и
-   `tuple[bool, str]` — неизменны. Reason-строки переносятся дословно.
-3. **Валидатор не hard-fail по умолчанию.** Флаг `frontmatter_validation_strict` (env
-   `ORCH_FRONTMATTER_VALIDATION_STRICT`, дефолт `False`): default — warning/лог, **вне
-   вердикт-пути гейтов** (нулевая регрессия); hard-fail — зарезервированный strict-режим
-   (включение — с ORCH-52d). Иначе ORCH-52c заблокировала бы собственный деплой.
-4. **Формальная спека handoff** `docs/_standards/HANDOFF_PROTOCOL.md` — «стадия → обязательный
-   выход» (документы + frontmatter-ключи), согласована 1:1 с `PIPELINE_DOCS.md` §2–§3; источник
-   истины — код. `PIPELINE_DOCS.md` обновляется ссылкой + отметкой о реализации машинного слоя.
-5. **Без изменений** `STAGE_TRANSITIONS`, состава `QG_CHECKS`, API, схемы БД.
-
-## Альтернативы
-
-- Общий «умный» verdict-резолвер (поле+токены для всех гейтов) — отклонён: различия token-логики
-  → риск тонкого регресса на гейте при self-hosting. Унифицируем только парс YAML.
-- Класс/новый пакет — отклонён: состояния нет, лишний blast radius.
-- Hard-fail валидатор по умолчанию — отклонён (NFR-3: self-block собственного деплоя).
-- Сторонняя `python-frontmatter` — отклонена: лишняя зависимость ради ~30 строк.
-
-## Последствия
-
-- **+** Конец дублирования/рассинхрона парсинга; writer+валидатор+схема готовы к ORCH-52d;
-  спека handoff закрывает пробел контракта стадий.
-- **+** Нулевая регрессия по построению: семантика и reason-строки 1:1, валидатор инертен при
-  дефолте, never-raise сохранён, enduro 1:1.
-- **−** Унификация частичная (парс, не семантика); strict-режим «спящий» до ORCH-52d.
-- **Обратимость:** `frontmatter_validation_strict=False` ⇒ прежнее поведение; перевод гейтов
-  поведенчески инвариантен.
-- **Риск:** первый боевой `autoDeploy` орка (ORCH-089) — наблюдение за стадией `deploy`
-  (`docs/work-items/ORCH-076/10-tech-risks.md`).
-
-## Связи
-
-- Опирается: adr-0019 (pipeline-docs-standard, ORCH-075), ORCH-016 (reader), ORCH-047
-  (3-полевой tester), adr-0012 (security-гейт), adr-0018 (auto-label/`autoDeploy`).
-- Готовит: ORCH-52d (эмиссия полной схемы агентами; возможное включение strict).

docs/work-items/ORCH-026/16-post-deploy-log.md

@@ -0,0 +1,14 @@
+---
+post_deploy_status: HEALTHY
+action_taken: NONE
+work_item: ORCH-026
+window_s: 900
+checks_total: 30
+checks_failed: 0
+---
+
+# Post-deploy log — ORCH-021 post-deploy monitor
+
+Наблюдение прода завершено: `post_deploy_status: HEALTHY`, `action_taken: NONE`.
+
+Окно наблюдения: 900s; опросов всего: 30, из них с провалом: 0.

docs/work-items/ORCH-074/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-52a: фикс модели/эффорта агентов (мёртвый frontmatter → routing+effort)
-
-Work Item ID: ORCH-074
-
-## Description
-
-TBD

docs/work-items/ORCH-074/01-brd.md

@@ -1,89 +0,0 @@
-# BRD — ORCH-074: фикс модели агентов (мёртвый frontmatter → валидация имени)
-
-Work Item ID: ORCH-074
-Эпик: ORCH-052 (слой 3), под-задача ORCH-52a
-Приоритет: **urgent**
-Тип: доработка механизма выбора модели агентов (self-modifying).
-
-## 0. История ревизий
-
-- **rev.1 (08.06):** первичный пакет аналитики по фиксированному скоупу Славы.
-- **rev.2 (08.06, текущая):** задача возвращена стейкхолдером в In Progress.
-  Проверены последние комментарии и описание issue в Plane — НОВЫХ субстантивных
-  ответов/изменений скоупа нет (только bot-комменты + служебный маркер
-  «Агент перезапущен с ответами стейкхолдера»). Скоуп остаётся прежним
-  (G1 + G2 + опц. G4; G3 снят; эффорт не трогаем). Пакет переподтверждён против
-  фактического кода (`launcher.py`, `config.py`); уточнён код-факт по G4: fallback
-  читается напрямую на `launcher.py:374` мимо `resolve_agent_model`, поэтому
-  валидация G2 должна покрыть и fallback (детали — ТЗ §4, AC-5, TC-11).
-
-## 1. Контекст и проблема
-
-Каркас выбора модели агентов реализован в ORCH-041 и **работает корректно**:
-`src/agents/launcher.py::resolve_agent_model(agent, project_id)` резолвит модель
-по приоритету project-override → `ORCH_AGENT_MODEL_<AGENT>` → `agent_model_default`
-→ CLI-дефолт. Все 6 агентов сейчас резолвятся в `claude-opus-4-8` (через
-`agent_model_default`).
-
-Аудит кода (08.06) выявил два дефекта данных/валидации (НЕ дефект механизма):
-
-- **P1. Лживый/мёртвый `model:` во frontmatter `.openclaw/agents/*.md`.**
-  Все 6 промптов содержат `model:` в YAML-frontmatter:
-  `claude-sonnet-4-6` (analyst, developer, tester, deployer) и
-  `claude-opus-4-7` (architect, reviewer). launcher **НЕ читает** frontmatter
-  `model:` — это мёртвая декларация, которая лжёт о реально используемой модели
-  и нарушает принцип «документация = golden source». Мина: если кто-то «починит»
-  launcher читать frontmatter → все агенты молча упадут на устаревшие модели.
-
-- **P2. Нет валидации ИМЕНИ модели.** В отличие от effort (есть `VALID_EFFORTS`-гард,
-  невалидный effort логируется и дропается), имя модели не валидируется. Опечатка
-  в `agent_model_*` / project-override → `--model <мусор>` → CLI падает или тихо
-  деградирует. Нарушение принципа never-break.
-
-## 2. Решение Славы (08.06) — фиксированный скоп
-
-> G3 model-routing **НЕ включаем** — ВСЕ 6 агентов остаются на `claude-opus-4-8`.
-> Скоп: **G1** (убрать лживый `model:` из frontmatter) + **G2** (валидация имени
-> модели, never-break) + **опц. G4** (`fallback_model` — на усмотрение архитектора,
-> НЕ routing). **Эффорт НЕ трогать.** AC-4 (routing) снят.
-
-## 3. Бизнес-цели
-
-| ID | Цель | Драйвер |
-|----|------|---------|
-| G1 | Устранить лживый frontmatter: убрать `model:` из всех 6 `.openclaw/agents/*.md`. config — единственный источник правды модели. | Наблюдаемость (frontmatter не лжёт) |
-| G2 | Добавить валидацию имени модели: невалидное имя → лог + откат на default, никогда не передаётся в `--model`. | Надёжность (never-break) |
-| G4 | (опц., решает архитектор) Задать `agent_fallback_model` для страховки доступности. | Надёжность (availability) |
-
-## 4. Не-цели (явно вне скоупа)
-
-- **G3 routing НЕ включаем.** Все 6 агентов остаются `claude-opus-4-8`. AC-4 снят.
-- **Эффорт НЕ трогать** — уже корректно настроен (`thinking → high`, `tester/deployer → medium`).
-- **Не менять resolve-механизм ORCH-041** — он корректен. Меняются только данные
-  (frontmatter, опц. config) + добавляется валидация.
-- **Не трогать non-self поведение** — per-project override (`projects.py agent_models`)
-  для enduro-trails остаётся рабочим.
-
-## 5. Заинтересованные стороны
-
-- **Owner (Слава)** — зафиксировал скоп; деплой через штатный «Confirm Deploy».
-- **Агенты оркестратора** — потребители resolve-механизма (self-hosting).
-- **Проект enduro-trails** — НЕ должен пострадать (общий инстанс/БД/очередь).
-
-## 6. Риски и инварианты
-
-- **Self-hosting:** изменение применяется к БУДУЩИМ запускам агентов. НЕ ломать
-  текущий конвейер; не ронять прод-контейнер. Деплой только через «Confirm Deploy».
-- **never-break:** невалидная модель/эффорт НЕ должны ронять запуск агента —
-  деградация на default/CLI-дефолт + лог.
-- **frontmatter автогенерация:** убедиться, что инструмент (если автогенерит
-  frontmatter) не вернёт `model:` обратно. Frontmatter остаётся описательным
-  (`name`/`description`/`tools`).
-- **enduro per-project override** не должен сломаться валидацией (валидные имена
-  проходят без изменения поведения).
-
-## 7. Бизнес-эффект
-
-- Frontmatter перестаёт лгать → меньше риск «починки», ломающей агентов.
-- Опечатка в имени модели больше не роняет/деградирует запуск агента.
-- (опц.) fallback повышает доступность при перегрузке основной модели.

docs/work-items/ORCH-074/02-trz.md

@@ -1,112 +0,0 @@
-# ТЗ — ORCH-074: убрать мёртвый frontmatter `model:` + валидация имени модели
-
-Work Item ID: ORCH-074
-Базируется на: BRD `01-brd.md`. Скоп фиксирован решением Славы (08.06):
-**G1 + G2 + опц. G4. G3 (routing) НЕ включаем. Эффорт НЕ трогать.**
-
-## 1. Задействованные модули `src/` и файлы
-
-| Файл | Изменение |
-|------|-----------|
-| `.openclaw/agents/analyst.md` | **G1:** удалить строку `model: claude-sonnet-4-6` из frontmatter |
-| `.openclaw/agents/architect.md` | **G1:** удалить строку `model: claude-opus-4-7` |
-| `.openclaw/agents/developer.md` | **G1:** удалить строку `model: claude-sonnet-4-6` |
-| `.openclaw/agents/reviewer.md` | **G1:** удалить строку `model: claude-opus-4-7` |
-| `.openclaw/agents/tester.md` | **G1:** удалить строку `model: claude-sonnet-4-6` |
-| `.openclaw/agents/deployer.md` | **G1:** удалить строку `model: claude-sonnet-4-6` |
-| `src/agents/launcher.py` | **G2:** добавить валидацию имени модели в `resolve_agent_model` (или helper), по образцу `VALID_EFFORTS`-гарда в `resolve_agent_effort` |
-| `src/config.py` | **G4 (опц.):** задать `agent_fallback_model` (если архитектор решит). При G2 — возможно добавить константу/настройку валидного формата модели |
-| `docs/architecture/README.md` | **AC-6:** таблица «модель/эффорт по ролям» актуализирована; нет упоминаний sonnet/opus-4-7 как «модели агента» |
-| `.env.example` | **AC-3/AC-6:** добавить блок `ORCH_AGENT_MODEL_*` / `ORCH_AGENT_EFFORT_*` / `ORCH_AGENT_FALLBACK_MODEL` (сейчас в `.env.example` их НЕТ) |
-| `CLAUDE.md` | **AC-6:** при необходимости — отметить, что модель агента берётся ТОЛЬКО из config (frontmatter описательный) |
-| `CHANGELOG.md` | запись о доработке |
-| `tests/test_resolve_agent_model.py` | **AC-2:** добавить кейсы валидации мусорного имени |
-
-## 2. G1 — убрать мёртвый frontmatter `model:`
-
-Удалить **только** строку `model: …` из YAML-frontmatter каждого из 6 файлов
-`.openclaw/agents/*.md`. Остальные ключи (`name`, `description`, `tools`/`model`-comment)
-не трогать. frontmatter остаётся валидным YAML и описательным.
-
-Проверка (AC-1):
-```
-grep -L "^model:" .openclaw/agents/*.md   # должны вернуться ВСЕ 6 файлов
-```
-(`grep -L` печатает файлы БЕЗ совпадения — все 6 не должны содержать `^model:`.)
-
-## 3. G2 — валидация имени модели (never-break)
-
-Требование (НЕ предписывает архитектуру — выбор предиката за архитектором):
-
-- Резолвенное имя модели валидируется ПЕРЕД возвратом из `resolve_agent_model`
-  (либо в общем helper). Невалидное имя → `logger.warning(...)` + откат на
-  следующий валидный уровень (в пределе — `agent_model_default`, а если и он
-  невалиден → `""`, т.е. без флага `--model`, CLI-дефолт). **Никогда** не вернуть
-  мусор, который попадёт в `--model`.
-- Поведение — точная аналогия `resolve_agent_effort` (`VALID_EFFORTS`): валидный →
-  как есть; невалидный → лог + дроп.
-- Предикат валидности (на усмотрение архитектора, рекомендация аналитика):
-  формат-чек `claude-*` (forward-compatible — новые версии моделей не требуют
-  правки allowlist) ЛИБО явный `VALID_MODELS` allowlist (строже, но требует
-  поддержки при выходе новых моделей). **Выбор и обоснование — в ADR.**
-- **Рекомендация аналитика (форма):** оформить предикат как отдельный
-  чистый helper (напр. `is_valid_model(name) -> bool` рядом с `VALID_EFFORTS`),
-  а не инлайнить в `resolve_agent_model` — тогда ОДИН валидатор переиспользуется
-  и резолвом модели, и чтением fallback (G4, см. §4). Финальная форма — за
-  архитектором.
-- Инвариант обратной совместимости: ВСЕ ныне используемые валидные имена
-  (`claude-opus-4-8`, а также enduro per-project override) проходят валидацию
-  без изменения поведения. Невалидным считается только мусор (опечатка,
-  `gpt-4`, пустая строка после strip и т.п.).
-- Контракт уровней резолва ORCH-041 сохраняется: валидация добавляется поверх,
-  механизм приоритетов не меняется.
-
-## 4. G4 — fallback_model (опционально, решает архитектор)
-
-- `src/config.py::agent_fallback_model` сейчас `""` (флаг не прокидывается).
-- Если архитектор решит включить — задать каноничное имя модели; launcher уже
-  прокидывает его в `--fallback-model` (`launcher.py:374-375`, попадает в cmd
-  на строке 388).
-- **⚠️ Код-факт (проверено 08.06):** fallback читается НАПРЯМУЮ —
-  `fb = settings.agent_fallback_model` (`launcher.py:374`) — и **НЕ проходит**
-  через `resolve_agent_model`, значит валидация G2, добавленная внутри
-  `resolve_agent_model`, его НЕ покроет. Следствие для архитектора: если G4
-  включается, валидацию имени модели (G2) надо применить ТАКЖЕ к fallback на
-  его месте чтения (или вынести валидатор в отдельный helper, который вызывают
-  ОБА: и резолв модели, и чтение fallback). Иначе опечатка в `agent_fallback_model`
-  обходит G2 и уезжает в `--fallback-model` — нарушение never-break.
-- Если архитектор решит НЕ включать — оставить `""`, AC-5 помечается N/A в ADR.
-
-## 5. Изменения API / схемы БД
-
-- **API (HTTP):** нет.
-- **Схема БД:** нет миграций.
-- **CLI-команда агента:** формируется в `launcher._spawn` (строки 384-392).
-  Меняется только КАЧЕСТВО значения `--model` (валидное/дроп), сама структура
-  команды не меняется.
-
-## 6. Требования к QG checks
-
-- Новых QG-чеков НЕ требуется. Валидация — это runtime-гард в launcher, не
-  отдельный quality-gate.
-
-## 7. Артефакты pipeline
-
-Должны быть созданы/обновлены в ЭТОМ PR (golden source = код + доки):
-- `docs/architecture/README.md` — таблица «модель/эффорт по ролям».
-- `.env.example` — блок переменных моделей/эффорта/fallback.
-- `CHANGELOG.md` — запись.
-- `06-adr/ADR-NNN-*.md` — решение по предикату валидации (G2) и по G4 (fallback вкл/выкл).
-- ADR архитектора фиксирует: выбран вариант G1 «убрать» (не «читать frontmatter»).
-
-## 8. Эффорт — НЕ ТРОГАТЬ
-
-`agent_effort_*` корректны (`thinking → high`, `tester/deployer → medium`).
-Менять только при явном отдельном обосновании (вне скоупа этой задачи).
-
-## 9. Грабли
-
-- Имена моделей — каноничные строки Claude CLI; сверить с тем, что реально
-  принимает CLI на проде (`ORCH_CLAUDE_BIN`). НЕ хардкодить версию вне `config.py`.
-- Если frontmatter автогенерится инструментом — убедиться, что `model:` не вернётся.
-- Self-hosting: НЕ ронять прод-контейнер; деплой через «Confirm Deploy».

docs/work-items/ORCH-074/03-acceptance-criteria.md

@@ -1,81 +0,0 @@
-# Критерии приёмки — ORCH-074
-
-Work Item ID: ORCH-074
-Скоп (Слава 08.06): G1 + G2 + опц. G4. **G3 routing снят — AC-4 не применяется.**
-
-Каждый критерий: чёткое условие PASS/FAIL.
-
----
-
-## AC-1 — frontmatter `model:` убран из всех 6 промптов (G1)
-
-- **PASS:** ни один файл `.openclaw/agents/*.md` не содержит строки `^model:` в
-  frontmatter. Команда `grep -L "^model:" .openclaw/agents/*.md` возвращает все 6
-  файлов (analyst, architect, developer, reviewer, tester, deployer).
-- **FAIL:** хотя бы в одном файле осталась строка `model:`.
-- Доп. инвариант: frontmatter остаётся валидным YAML; ключи `name`/`description`/`tools`
-  сохранены.
-
-## AC-2 — валидация имени модели, never-break (G2)
-
-- **PASS:** при невалидном `agent_model_*` / project-override (мусорное имя)
-  `resolve_agent_model` возвращает откат на default (или `""`), пишет
-  `logger.warning`, и мусор **никогда** не попадает в `--model`. Покрыто
-  unit-тестом с мусорным именем (см. `04-test-plan.yaml`, TC-03..TC-05).
-- **FAIL:** мусорное имя проходит насквозь в `--model`, или валидация роняет
-  запуск агента (исключение вместо graceful-деградации).
-
-## AC-3 — resolve_agent_model осмыслен для всех 6 агентов
-
-- **PASS:** для каждого из 6 агентов `resolve_agent_model(agent)` (без
-  project_id) возвращает `claude-opus-4-8` (routing G3 выключен → intelligence-
-  модель для всех). Значение документировано в README (таблица env) и `.env.example`.
-- **FAIL:** хотя бы один агент резолвится в пустую/невалидную/устаревшую модель,
-  либо документация не отражает фактическую модель.
-
-## AC-4 — routing (G3) — **СНЯТ (N/A)**
-
-- Routing НЕ включается в этой задаче. Критерий не применяется. ADR фиксирует
-  отказ от G3 как осознанное решение Славы (08.06).
-
-## AC-5 — fallback_model (G4, опционально)
-
-- **PASS (если G4 включён):** `agent_fallback_model` задан каноничным именем,
-  проходит валидацию G2, прокидывается в `--fallback-model` (launcher 374-375).
-  Доп. инвариант never-break: МУСОРНЫЙ fallback НЕ попадает в `--fallback-model`
-  (валидируется тем же предикатом G2; учтено, что fallback читается напрямую на
-  `launcher.py:374`, минуя `resolve_agent_model` — см. TRZ §4). Задокументирован.
-- **PASS (если G4 НЕ включён):** `agent_fallback_model = ""`, ADR явно фиксирует
-  отказ; AC-5 помечен N/A.
-- **FAIL:** fallback задан невалидным именем, ИЛИ невалидный fallback проходит в
-  `--fallback-model`, ИЛИ включён без документации/ADR.
-
-## AC-6 — синхронизация документации
-
-- **PASS:** `docs/architecture/README.md`, `CLAUDE.md`, `.env.example`
-  синхронизированы — таблица «модель по ролям» актуальна (все = `claude-opus-4-8`);
-  НЕТ упоминаний `claude-sonnet-4-6` / `claude-opus-4-7` как «модели агента»
-  (если они не используются). `.env.example` содержит блок
-  `ORCH_AGENT_MODEL_*` / `ORCH_AGENT_EFFORT_*` / `ORCH_AGENT_FALLBACK_MODEL`.
-- **FAIL:** документация противоречит config, или остались мёртвые упоминания
-  sonnet/opus-4-7 как модели агента.
-
-## AC-7 — pytest зелёный + never-break
-
-- **PASS:** `pytest tests/ -q` зелёный. Невалидная модель/эффорт НЕ роняет запуск
-  агента (graceful-деградация подтверждена тестами).
-- **FAIL:** падают тесты, или невалидный вход роняет запуск.
-
-## AC-8 — enduro per-project override не сломан
-
-- **PASS:** валидный per-project override (`projects.py agent_models`) для не-self
-  проекта (enduro) резолвится и проходит валидацию без изменения поведения
-  (покрыто существующими тестами `test_resolve_agent_model.py`).
-- **FAIL:** валидация ломает корректный per-project override.
-
-## AC-9 — ADR зафиксирован
-
-- **PASS:** ADR в `06-adr/` фиксирует: (а) выбран вариант G1 «убрать frontmatter»
-  (не «читать»); (б) предикат валидации G2 (формат-чек vs allowlist) с обоснованием;
-  (в) решение по G4 (вкл/выкл) и по отказу от G3.
-- **FAIL:** ADR отсутствует или не покрывает эти решения.

docs/work-items/ORCH-074/04-test-plan.yaml

@@ -1,103 +0,0 @@
-work_item: ORCH-074
-# Скоп (Слава 08.06): G1 + G2 + опц. G4. G3 routing снят (no routing tests).
-# Эффорт не трогаем (no new effort tests beyond never-break regression).
-
-tests:
-  # ---- G1: frontmatter `model:` убран из всех 6 промптов (AC-1) ----
-  - id: TC-01
-    type: integration
-    description: >
-      Ни один .openclaw/agents/*.md не содержит строки `^model:` во frontmatter.
-      Тест итерирует по 6 файлам, ассертит отсутствие model:-строки.
-    module: tests/test_agent_frontmatter_no_model.py
-    expected: PASS
-
-  - id: TC-02
-    type: integration
-    description: >
-      frontmatter каждого из 6 промптов остаётся валидным YAML и сохраняет ключи
-      name/description (парсинг между первыми двумя '---' без ошибок).
-    module: tests/test_agent_frontmatter_no_model.py
-    expected: PASS
-
-  # ---- G2: валидация имени модели, never-break (AC-2, AC-7) ----
-  - id: TC-03
-    type: unit
-    description: >
-      Мусорное имя в agent_model_<agent> (напр. 'gpt-4' или 'claud-opus-typo')
-      -> resolve_agent_model откатывается на default (claude-opus-4-8) и НЕ
-      возвращает мусор. Проверяется также warning в логах (caplog).
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  - id: TC-04
-    type: unit
-    description: >
-      Мусорное имя в project-override (agent_models) -> resolve_agent_model
-      откатывается на следующий валидный уровень (default), мусор не передаётся.
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  - id: TC-05
-    type: unit
-    description: >
-      Невалиден И override, И default -> resolve_agent_model возвращает ""
-      (без флага --model, CLI-дефолт). never-break: исключение НЕ бросается.
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  - id: TC-06
-    type: unit
-    description: >
-      Валидное каноничное имя (claude-opus-4-8) проходит валидацию без изменения:
-      resolve_agent_model('developer') == 'claude-opus-4-8'. Регрессия ORCH-041.
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  # ---- AC-3: все 6 агентов резолвятся в осмысленную модель ----
-  - id: TC-07
-    type: unit
-    description: >
-      Для всех 6 агентов (analyst/architect/developer/reviewer/tester/deployer)
-      resolve_agent_model(agent) == 'claude-opus-4-8' (routing выключен).
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  # ---- AC-8: enduro per-project override не сломан валидацией ----
-  - id: TC-08
-    type: unit
-    description: >
-      Валидный per-project override (agent_models у не-self проекта) резолвится и
-      проходит валидацию без изменения поведения (регрессия ORCH-041).
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  # ---- G4: fallback_model (опц.) — условный тест ----
-  - id: TC-09
-    type: unit
-    description: >
-      ЕСЛИ G4 включён архитектором: agent_fallback_model задан валидным именем и
-      проходит валидацию G2. ЕСЛИ выключен: agent_fallback_model == "" (тест
-      подтверждает дефолт). Финальная форма теста зависит от решения в ADR.
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  # ---- G4 never-break: fallback читается напрямую (launcher.py:374), мимо
-  #      resolve_agent_model — валидация G2 должна покрыть и его (см. TRZ §4) ----
-  - id: TC-11
-    type: unit
-    description: >
-      ЕСЛИ G4 включён: мусорное agent_fallback_model НЕ попадает в --fallback-model
-      (валидируется тем же предикатом G2, дропается с warning, never-break).
-      ЕСЛИ G4 выключен: кейс помечается N/A в test-report (синхронно с ADR).
-    module: tests/test_resolve_agent_model.py
-    expected: PASS
-
-  # ---- AC-7: общий зелёный прогон / never-break regression ----
-  - id: TC-10
-    type: integration
-    description: >
-      Полный pytest зелёный; невалидная модель/эффорт не роняет запуск агента
-      (graceful-деградация). Регрессия resolve_agent_effort (VALID_EFFORTS) цела.
-    module: tests/
-    expected: PASS

docs/work-items/ORCH-074/06-adr/ADR-001-model-name-validation.md

@@ -1,145 +0,0 @@
-# ADR-001: Убрать мёртвый frontmatter `model:` + валидация имени модели через формат-чек `claude-*`
-
-Work Item ID: ORCH-074
-Эпик: ORCH-052 (слой 3), под-задача ORCH-52a
-Связан с: ORCH-041 (каркас `resolve_agent_model`/`resolve_agent_effort`), `src/config.py`, `src/agents/launcher.py`
-
-## Статус
-Accepted
-
-## Контекст
-
-Каркас выбора модели агентов (ORCH-041) работает корректно: `launcher.resolve_agent_model(agent, project_id)`
-резолвит модель по приоритету project-override → `ORCH_AGENT_MODEL_<AGENT>` → `agent_model_default`
-→ CLI-дефолт. Все 6 агентов резолвятся в `claude-opus-4-8` (через `agent_model_default`).
-
-Аудит кода (08.06) выявил два дефекта **данных/валидации** (не дефект механизма):
-
-- **P1 — лживый/мёртвый `model:` во frontmatter.** Все 6 промптов `.openclaw/agents/*.md`
-  содержат `model:` (`claude-sonnet-4-6` у analyst/developer/tester/deployer, `claude-opus-4-7`
-  у architect/reviewer). launcher **не читает** frontmatter `model:` — это мёртвая декларация,
-  которая лжёт о реально используемой модели и нарушает принцип «документация = golden source».
-  Мина: если кто-то «починит» launcher читать frontmatter → все агенты молча уедут на устаревшие
-  модели.
-- **P2 — нет валидации имени модели.** В отличие от effort (`VALID_EFFORTS`-гард в
-  `resolve_agent_effort`), имя модели не валидируется. Опечатка в `agent_model_*` / project-override
-  → `--model <мусор>` → CLI падает или тихо деградирует. Нарушение принципа never-break.
-
-Скоуп зафиксирован стейкхолдером (Слава, 08.06): **G1 + G2 + опц. G4. G3 routing НЕ включаем
-(все 6 агентов остаются `claude-opus-4-8`). Эффорт не трогаем.** rev.2 BRD подтвердила скоуп
-без изменений. Код-факт (TRZ §4): `agent_fallback_model` читается напрямую на `launcher.py:374`,
-минуя `resolve_agent_model`.
-
-Архитектор должен зафиксировать три решения: (а) форма G1, (б) предикат валидации G2,
-(в) судьба G4 (fallback) и G3 (routing).
-
-## Решение
-
-### Решение 1 (G1): убрать `model:` из frontmatter, НЕ учить launcher его читать
-
-Из YAML-frontmatter всех 6 файлов `.openclaw/agents/*.md` удаляется **только** строка `model: …`.
-Ключи `name`/`description`/`tools` сохраняются; frontmatter остаётся валидным YAML и **описательным**.
-config (`agent_model_*` / `agent_model_default`) остаётся **единственным источником правды** о модели.
-
-Отвергнутая альтернатива — научить launcher читать frontmatter `model:` — отвергнута: она вводит
-второй источник правды (frontmatter ⊕ config), усложняет резолв, и моментально активировала бы
-устаревшие значения (sonnet-4-6 / opus-4-7) для всех агентов. «Убрать» проще, безопаснее и
-устраняет мину раз и навсегда.
-
-### Решение 2 (G2): предикат валидации — формат-чек `claude-*`, оформленный отдельным helper
-
-Добавляется **чистый helper** `is_valid_model(name: str) -> bool` рядом с `VALID_EFFORTS` в
-`src/agents/launcher.py`. Предикат — **формат-чек**, а не allowlist имён:
-
-```
-strip → непустая строка → соответствует ^claude-[a-z0-9.-]+$
-```
-
-То есть: имя после `strip()` непусто, начинается с `claude-` и состоит только из строчных
-букв/цифр/точек/дефисов. Регэксп оформляется модульной константой (напр. `_MODEL_NAME_RE`).
-
-**Почему формат-чек, а не allowlist `VALID_MODELS`:**
-allowlist (по образцу `VALID_EFFORTS`) воссоздаёт ровно ту мину, которую мы убиваем в G1 — статичный
-список имён, который **врёт при устаревании**. Когда Anthropic выпустит `claude-opus-4-9`, оператор,
-корректно прописавший новую модель, получит её молчаливый дроп на устаревший default (never-break
-сработает против пользователя). Это хуже, чем пропустить структурно-корректное, но опечатанное имя:
-финальный авторитет о существовании модели — сам Claude CLI, а не наш код. Формат-чек
-**forward-compatible** (новые версии проходят без правки кода) и ловит реальные классы отказов:
-чужой провайдер (`gpt-4`), пустая строка/пробелы, мусор с недопустимыми символами, неверный префикс
-(`claud-opus-typo`). Признанное ограничение: формат-чек НЕ ловит опечатку, которая всё ещё выглядит
-как валидное claude-имя (`claude-opus-typo`) — такие отсекает CLI на запуске (контракт never-break
-+ exit-code обработка в `_monitor_agent` это покрывают). Задача валидатора — не быть реестром моделей,
-а не дать **структурному мусору** уехать в `--model`.
-
-**Применение (контракт never-break):**
-- В `resolve_agent_model`: резолвенное имя валидируется **перед возвратом**. Невалидное →
-  `logger.warning(...)` + откат на следующий валидный уровень. Реализация: helper применяется внутри
-  каскада приоритетов так, что невалидный уровень пропускается (project-override невалиден → пробуем
-  env → default), а если итог всё равно невалиден → возврат `""` (без флага `--model`, CLI-дефолт).
-  **Никогда** не возвращается мусор и **никогда** не бросается исключение.
-- Контракт уровней резолва ORCH-041 сохраняется: валидация добавляется **поверх**, порядок приоритетов
-  и сигнатуры не меняются. Все ныне используемые валидные имена (`claude-opus-4-8`, валидный enduro
-  per-project override) проходят без изменения поведения.
-- Поведенческая аналогия с `resolve_agent_effort` (`VALID_EFFORTS`): валидный → как есть, невалидный →
-  лог + дроп. Разница только в форме предиката (формат-чек vs множество) по причинам выше.
-
-### Решение 3 (G4): fallback НЕ включаем; но валидатор применяем к точке чтения fallback
-
-`agent_fallback_model` остаётся `""` (флаг `--fallback-model` не прокидывается). **AC-5 помечается
-N/A.** Обоснование отказа:
-- G3 выключен ради **детерминизма**: все агенты на `claude-opus-4-8`. Fallback вернул бы скрытую
-  вариативность модели под нагрузкой (агент молча отработал бы на другой модели) — это противоречит
-  духу зафиксированного скоупа.
-- Нет наблюдаемой проблемы доступности, мотивирующей fallback. Принцип минимального изменения.
-- Self-hosting: новое рантайм-поведение под нагрузкой трудно наблюдать; не вводим без нужды.
-
-**При этом** helper `is_valid_model` применяется ТАКЖЕ на месте чтения fallback (`launcher.py:374`,
-`fb = settings.agent_fallback_model`) — **независимо** от того, что значение сейчас пустое. Причина —
-код-факт TRZ §4: fallback читается напрямую, мимо `resolve_agent_model`, поэтому валидация только
-внутри резолва его НЕ покрывает. Защитный гард на месте чтения навсегда закрывает дыру never-break:
-если кто-то позже задаст `ORCH_AGENT_FALLBACK_MODEL` с опечаткой, мусор будет залогирован и
-сброшен (`fb_flag = ""`), а не уедет в `--fallback-model`. Для текущего пустого значения регрессии нет:
-`is_valid_model("") == False` → `fb_flag = ""` — то же поведение, что и сейчас (`if fb`). Это делает
-**TC-11** проверяемым (мусорный fallback дропается) при выключенном G4.
-
-### Решение 4 (G3): routing НЕ включаем
-
-Подтверждается отказ от model-routing как осознанное решение стейкхолдера (Слава, 08.06). Все 6
-агентов резолвятся в `claude-opus-4-8`. **AC-4 = N/A.**
-
-## Размещение и форма (для разработчика)
-
-- `is_valid_model(name)` + `_MODEL_NAME_RE` — в `src/agents/launcher.py` рядом с `VALID_EFFORTS`
-  (один валидатор, два места вызова: резолв модели и чтение fallback — оба в этом модуле, без
-  кросс-модульного импорта).
-- Префикс `claude-` хардкодится в launcher: оркестратор привязан к Claude CLI (`CLAUDE_BIN`),
-  конфигурировать предикат не нужно (не over-engineering). Каноничная версия модели по-прежнему
-  живёт ТОЛЬКО в `config.py::agent_model_default` — в launcher версия не хардкодится.
-- frontmatter: удалить только `model:`-строку; не вносить генератор, возвращающий её обратно.
-
-## Последствия
-
-**Плюсы:**
-- frontmatter перестаёт лгать; config — единственный источник правды о модели (golden source цел).
-- Опечатка/чужой провайдер/мусор в имени модели больше не роняет и не деградирует запуск агента
-  (never-break соблюдён в обеих точках: резолв и fallback).
-- Forward-compatible: будущие модели Claude не требуют правки кода (в отличие от allowlist).
-- Минимальное изменение: механизм ORCH-041, API, схема БД, структура CLI-команды не меняются.
-
-**Минусы / ограничения:**
-- Формат-чек пропускает структурно-валидную опечатку вида `claude-opus-typo` (отсекается CLI на
-  запуске + never-break обработкой exit-code). Принятый компромисс ради forward-compat.
-- Префикс `claude-` зашит — при гипотетической смене CLI-провайдера потребуется правка (приемлемо:
-  оркестратор Claude-специфичен по дизайну).
-
-**Не затрагивается:**
-- API (HTTP) — нет. Схема БД — нет миграций. Стадии/QG — без изменений (это runtime-гард в launcher,
-  не quality-gate). Топология/инфра — без изменений (07/08 артефакты не требуются).
-- Эффорт (`agent_effort_*`) и `VALID_EFFORTS`-гард — не трогаются (регрессия покрыта TC-10).
-- enduro per-project override — валидные имена проходят без изменения поведения (AC-8 / TC-08).
-
-## Соответствие принципам
-
-Всё в Docker / один сервер — да. Минимум зависимостей — новых нет. Без ORM/очередей/облака — да.
-Self-hosting: изменение применяется к БУДУЩИМ запускам агентов, прод-контейнер не перезапускается
-в рамках задачи; прод-деплой орка — только через staging-гейт (8501) и Plane-статус «Confirm Deploy».

docs/work-items/ORCH-074/10-tech-risks.md

@@ -1,23 +0,0 @@
-# Технические риски — ORCH-074
-
-Work Item ID: ORCH-074
-Связан с: ADR-001 (`06-adr/ADR-001-model-name-validation.md`).
-
-| ID | Риск | Вероятность | Влияние | Митигация |
-|----|------|-------------|---------|-----------|
-| R-1 | **Валидация роняет запуск агента** (исключение вместо graceful-деградации) — нарушение never-break, встал бы конвейер всех проектов. | Низкая | Высокое | Helper `is_valid_model` — чистый предикат без исключений; невалидное → `logger.warning` + откат на default/`""`. Покрыто TC-03..TC-05, TC-10. |
-| R-2 | **Fallback обходит валидацию** (код-факт: `launcher.py:374` читает `agent_fallback_model` напрямую, мимо `resolve_agent_model`). | Средняя (если позже зададут fallback) | Среднее | ADR-001 решение 3: один helper применяется ТАКЖЕ на месте чтения fallback. Мусорный fallback дропается с warning. Покрыто TC-11. |
-| R-3 | **Регрессия enduro per-project override** — валидация ломает корректный не-self override (общий инстанс/БД/очередь). | Низкая | Высокое | Валидные claude-имена проходят формат-чек без изменения поведения; механизм приоритетов ORCH-041 не меняется. Покрыто TC-08. |
-| R-4 | **Формат-чек пропускает структурную опечатку** вида `claude-opus-typo` (валидный префикс, несуществующая модель). | Средняя | Низкое | Принятый компромисс (ADR-001): финальный авторитет — CLI; never-break + обработка exit-code в `_monitor_agent` покрывают отказ запуска. Allowlist отвергнут как воссоздающий мину устаревания (G1). |
-| R-5 | **frontmatter-генератор возвращает `model:` обратно** → мина P1 оживает. | Низкая | Среднее | Проверить отсутствие автогенератора, возвращающего `model:`; frontmatter остаётся описательным. Покрыто TC-01/TC-02 (CI-гард на отсутствие `^model:`). |
-| R-6 | **Хардкод версии модели в launcher** при добавлении валидации. | Низкая | Среднее | Префикс `claude-` зашит осознанно (CLI-специфика); каноничная ВЕРСИЯ остаётся только в `config.py::agent_model_default`. Регэксп версию не фиксирует. |
-| R-7 | **Self-hosting деплой** — рестарт прод-контейнера встанет конвейер всех проектов (enduro). | — | Высокое | Изменение применяется к будущим запускам; прод-деплой только через staging-гейт (8501) и Plane-статус «Confirm Deploy». Без немедленного рестарта прода. |
-
-## Инварианты (должны держаться после изменения)
-
-1. **never-break**: невалидная модель/эффорт/fallback НЕ роняет запуск агента — деградация на
-   default/CLI-дефолт + лог.
-2. **Один источник правды о модели**: config (`agent_model_*`); frontmatter — описательный.
-3. **Обратная совместимость ORCH-041**: все валидные имена (`claude-opus-4-8`, enduro override)
-   резолвятся без изменения поведения; порядок приоритетов и сигнатуры не меняются.
-4. **Детерминизм**: все 6 агентов = `claude-opus-4-8` (G3/routing выключен, G4/fallback выключен).

docs/work-items/ORCH-074/12-review.md

@@ -1,69 +0,0 @@
----
-type: review
-work_item_id: ORCH-074
-verdict: APPROVED
-version: 1
----
-
-# Review ORCH-074
-
-## Summary
-PR закрывает оба зафиксированных дефекта каркаса выбора модели (ORCH-41) в рамках
-скоупа G1 + G2 (+ защитный гард точки чтения fallback при выключенном G4), без
-изменения механизма резолва, API или схемы БД. Реализация точно соответствует
-ADR-001 и ТЗ; документация синхронизирована в том же PR; все 1012 тестов зелёные.
-Вердикт — **APPROVED**, P0/P1 findings нет.
-
-## Соответствие ТЗ и AC
-- **AC-1 (G1):** `grep -L "^model:" .openclaw/agents/*.md` возвращает все 6 файлов;
-  ни одной строки `^model:` не осталось. frontmatter остаётся валидным YAML
-  (`name`/`description`/`tools` сохранены) — покрыто `test_agent_frontmatter_no_model.py`.
-- **AC-2 (G2 never-break):** `resolve_agent_model` валидирует имя через `is_valid_model`
-  ПЕРЕД возвратом, мусорный уровень логируется (`logger.warning`) и пропускается;
-  при невалидных всех уровнях → `""` (CLI-дефолт), исключение не бросается. TC-03..05.
-- **AC-3:** все 6 агентов резолвятся в `claude-opus-4-8` (TC-07), значение в README-таблице
-  и `.env.example`.
-- **AC-4 (G3):** N/A — отказ зафиксирован в ADR.
-- **AC-5 (G4):** `agent_fallback_model=""` (выкл); тот же предикат гардит inline-чтение
-  fallback в `_spawn` (код-факт TRZ §4 учтён) — мусорный fallback дропается. ADR помечает N/A.
-- **AC-6 (доки):** README (новая секция «Модель и эффорт по ролям» + валидация),
-  `CLAUDE.md`, `.env.example` синхронизированы; стале-упоминаний `claude-sonnet-4-6`/
-  `claude-opus-4-7` как модели агента в актуальных доках нет (`grep` пуст).
-- **AC-7:** `pytest tests/ -q` → 1012 passed.
-- **AC-8:** валидный enduro per-project override проходит без изменения поведения (TC-08).
-- **AC-9:** ADR-001 фиксирует G1 «убрать», предикат G2 (формат-чек vs allowlist с
-  обоснованием), решения по G4 и G3.
-
-## Соответствие ADR
-Реализация 1:1 с ADR-001: `is_valid_model` + `_MODEL_NAME_RE` (`^claude-[a-z0-9.-]+$`)
-рядом с `VALID_EFFORTS`; один предикат, две точки вызова (резолв модели и чтение
-fallback); каскад приоритетов ORCH-41 сохранён (рефакторинг на генератор
-`_agent_model_candidates` с валидацией-со-скипом); версия модели по-прежнему живёт
-только в `config.py::agent_model_default`. Глобальные ADR не нарушены.
-
-## Качество кода
-- `is_valid_model` корректно обрабатывает `None`/пустое/whitespace (`if not name`),
-  никогда не бросает; содержательные docstrings с обоснованием формат-чека.
-- never-break соблюдён в обеих точках; `if fb` short-circuit сохраняет нулевую
-  регрессию для текущего пустого fallback.
-- Тесты содержательные: предикат (accept/reject), каскад-скип, граничные кейсы,
-  регрессия per-project override, выключенный G4.
-
-## Findings
-
-### P0 — Blocker
-- нет
-
-### P1 — Must fix
-- нет
-
-### P2 — Should fix
-- нет
-
-## Документация
-Обновлена полностью в этом же PR: `docs/architecture/README.md` (компонент Agent
-Launcher + новая секция «Модель и эффорт по ролям» с таблицей и описанием валидации),
-`CLAUDE.md` (строка про источник модели и валидацию), `.env.example` (блок
-`ORCH_AGENT_MODEL_*`/`ORCH_AGENT_EFFORT_*`/`ORCH_AGENT_FALLBACK_MODEL`),
-`CHANGELOG.md` (запись по задаче), ADR `06-adr/ADR-001-model-name-validation.md`.
-Требование «изменён src/ → обновлена документация» выполнено.

docs/work-items/ORCH-074/13-test-report.md

@@ -1,82 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-074
-result: PASS
----
-
-# Test Report — ORCH-074
-
-Убрать мёртвый frontmatter `model:` из 6 промптов + валидация имени модели (never-break).
-Скоп: G1 + G2 + опц. G4 (выключен). G3 routing снят. Review-вердикт: APPROVED.
-
-## Окружение
-- Python: 3.12.13
-- pytest: 8.3.3
-- Ветка: feature/ORCH-074-orch-52a-frontmatter-routing-e (worktree)
-- prod health (8500): `{"status":"ok","service":"orchestrator"}`
-- Дата: 2026-06-08
-
-## Результаты по тест-плану (04-test-plan.yaml)
-
-| TC ID | Описание | Тест | Результат |
-|-------|----------|------|-----------|
-| TC-01 | Ни один `.openclaw/agents/*.md` не содержит `^model:` (G1, AC-1) | test_no_model_line_in_frontmatter[×6] | PASS |
-| TC-02 | frontmatter валидный YAML, ключи name/description сохранены | test_frontmatter_still_valid_yaml_with_keys[×6] | PASS |
-| TC-03 | Мусорный `agent_model_<agent>` → откат на default, warning, мусор не в `--model` | test_garbage_per_agent_env_falls_back_to_default | PASS |
-| TC-04 | Мусорный project-override → откат на default | test_garbage_project_override_falls_back_to_default | PASS |
-| TC-05 | Невалидны override И default → `""` (CLI-дефолт), без исключения | test_all_levels_invalid_returns_empty | PASS |
-| TC-06 | Валидное `claude-opus-4-8` проходит без изменения (регрессия ORCH-041) | test_valid_canonical_unchanged | PASS |
-| TC-07 | Все 6 агентов резолвятся в `claude-opus-4-8` (routing выкл) | test_all_six_agents_resolve_to_opus_4_8 | PASS |
-| TC-08 | Валидный enduro per-project override не сломан валидацией | test_valid_per_project_override_unchanged | PASS |
-| TC-09 | G4 выключен: `agent_fallback_model == ""` (дефолт) | test_fallback_model_disabled_by_default | PASS |
-| TC-10 | Полный pytest зелёный; never-break graceful-деградация | tests/ (1012 passed) | PASS |
-| TC-11 | G4 never-break (мусорный fallback не в `--fallback-model`) | — | N/A (G4 выключен, синхр. с ADR/AC-5) |
-
-Доп. предикат-юниты: `test_is_valid_model_accepts_canonical`, `test_is_valid_model_rejects_garbage` — PASS.
-
-## Проверка критериев приёмки
-
-| AC | Статус | Подтверждение |
-|----|--------|---------------|
-| AC-1 frontmatter `model:` убран | PASS | `grep -L "^model:" .openclaw/agents/*.md` → все 6 файлов; `grep -rn "^model:"` → пусто |
-| AC-2 валидация never-break | PASS | TC-03..05 |
-| AC-3 все 6 → `claude-opus-4-8` | PASS | TC-07 |
-| AC-4 routing G3 | N/A | снят решением (ADR) |
-| AC-5 fallback G4 | PASS | G4 выключен, `agent_fallback_model=""`, ADR фиксирует отказ (TC-09) |
-| AC-6 синхронизация доков | PASS | проверено reviewer (README/CLAUDE.md/.env.example) |
-| AC-7 pytest зелёный | PASS | 1012 passed |
-| AC-8 enduro override | PASS | TC-08 |
-| AC-9 ADR | PASS | 06-adr/ADR-001 присутствует |
-
-## Smoke test API (prod, read-only)
-```
-GET /health → HTTP 200  {"status":"ok","service":"orchestrator"}
-GET /status → HTTP 200
-GET /queue  → HTTP 200
-```
-
-## Вывод pytest
-```
-$ python -m pytest tests/ -q
-1012 passed, 1 warning in 22.07s
-
-$ python -m pytest tests/test_agent_frontmatter_no_model.py tests/test_resolve_agent_model.py -v
-32 passed, 1 warning in 0.37s
-```
-(1 warning — PydanticDeprecatedSince20 в `src/config.py:5`, существующий, вне скоупа задачи.)
-
-## AC-1 grep-проверка
-```
-$ grep -L "^model:" .openclaw/agents/*.md
-.openclaw/agents/analyst.md
-.openclaw/agents/architect.md
-.openclaw/agents/deployer.md
-.openclaw/agents/developer.md
-.openclaw/agents/reviewer.md
-.openclaw/agents/tester.md
-$ grep -rn "^model:" .openclaw/agents/*.md   # пусто (exit 1)
-```
-
-## Итог
-**PASS** — все применимые тест-кейсы (TC-01..10) зелёные, TC-11 корректно N/A (G4 выключен),
-все AC выполнены (AC-4 — N/A по скоупу), smoke API OK. Задача готова к стадии deploy-staging.

docs/work-items/ORCH-074/14-deploy-log.md

@@ -1,12 +0,0 @@
----
-deploy_status: SUCCESS
-work_item: ORCH-074
-hook_exit_code: 0
-deployed_by: deploy-finalizer
----
-
-# Deploy log — ORCH-036 executable self-deploy
-
-Прод-деплой завершён хост-хуком с exit-code `0` -> `deploy_status: SUCCESS`.
-
-Вердикт зафиксирован детерминированным finalizer'ом (Фаза C), не LLM.

docs/work-items/ORCH-074/15-staging-log.md

@@ -1,56 +0,0 @@
----
-staging_status: SUCCESS
-timestamp: 2026-06-08T18:57:59+00:00
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-Staging test suite completed inside the `orchestrator-staging` container
-(`docker exec` via Docker Engine API, ADR-001 / ORCH-048 canonical method —
-preserves the running instance's process-env so the B6 registry-isolation check
-reads `.env.staging` correctly).
-
-- Command: `python3 /repos/orchestrator/scripts/staging_check.py --base-url http://localhost:8501 --mode stub`
-- Exit code: **0** → `staging_status: SUCCESS`
-- Result: **8/10 checks PASS**, REAL failed: none.
-
-## Infra waiver (ORCH-061)
-
-```
-INFRA-WAIVED: C9a Branch appears in orchestrator-sandbox, C9b Analyst job enqueued in staging queue (known sandbox-infra; real checks green)
-VERDICT: SUCCESS (exit 0) — SUCCESS (infra-waived): ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue'] are known sandbox-infra checks; all real checks green
-```
-
-C9a/C9b are the two sandbox-infra-only checks (depend on SANDBOX bot accounts being
-project members, not on the pipeline). Both were tolerated because every REAL check
-is green; the script still exits 0 (fail-closed for any real failure). Trusting the
-exit code per ORCH-061 — no re-judging of waived checks.
-
-## Full output
-
-```
-[Block A] SMOKE
-  ✓ PASS  A1 GET /health → 200 status=ok  [HTTP 200, body={'status': 'ok', 'service': 'orchestrator'}]
-  ✓ PASS  A2 GET /queue → 200 with counts/max_concurrency/resilience
-  ✓ PASS  A3 ORCH_STAGING=true (not prod)  [ORCH_STAGING=true]
-
-[Block B] ACCESS
-  ✓ PASS  B4 Plane: sandbox project accessible  [HTTP 200, found 5 project(s), sandbox=YES]
-  ✓ PASS  B5 Gitea: orchestrator-sandbox accessible, push=true
-  ✓ PASS  B6 Registry: sandbox present, prod ET/ORCH absent  [sandbox=YES, prod-ET=NO(good), prod-ORCH=NO(good)]
-
-[Block C] E2E  (mode=stub)
-  ✓ PASS  C7 Create issue in Plane SANDBOX  [HTTP 201]
-  ✓ PASS  C8 Trigger pipeline via /webhook/plane  [HTTP 200, resp={'status': 'accepted'}]
-  ✗ FAIL  C9a Branch appears in orchestrator-sandbox  [branch=not found]   (SANDBOX_INFRA, waived)
-  ✗ FAIL  C9b Analyst job enqueued in staging queue                        (SANDBOX_INFRA, waived)
-
-[CLEANUP]
-  ✓ PASS  CLEANUP: deleted Plane issue (HTTP 204)
-
-RESULT: 8/10 checks PASS
-  REAL failed         : none
-  SANDBOX_INFRA failed: ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue']
-  tolerance: staging_infra_tolerance_enabled=True
-```

docs/work-items/ORCH-075/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-52b: стандарт документов (docs/_templates + манифест стадий + ADR-naming)
-
-Work Item ID: ORCH-075
-
-## Description
-
-TBD

docs/work-items/ORCH-075/01-brd.md

@@ -1,111 +0,0 @@
-# 01 — BRD: ORCH-075 — ORCH-52b: стандарт документов (docs/_templates + манифест стадий + ADR-naming)
-
-Work Item: **ORCH-075**
-Repo: **orchestrator** (self-hosting)
-Стадия: analysis
-Заказчик: Owner / команда агентов оркестратора
-Тип: documentation-standard (слой 1 эпика ORCH-52)
-
-> Документ фиксирует **бизнес-требования** к созданию стандарта документов пайплайна.
-> ORCH-52b — слой 1 («стандарт»): только документация (манифест + канонические шаблоны +
-> конвенция ADR-naming). Любая принудительная проверка/валидатор/правка кода и промптов —
-> вне scope (это ORCH-52c/52d). Источник истины для манифеста — фактические
-> `STAGE_TRANSITIONS` / `QG_CHECKS` и реальные эталонные доки в репозитории, а не вымысел.
-
----
-
-## 1. Бизнес-контекст и проблема
-
-### 1.1. Текущее состояние (проверено в репо)
-- Каталоги `docs/_templates/` и `docs/_standards/` **не существуют**.
-- Агенты (`analyst` → `architect` → … → `deployer`) пишут номерные доки work item
-  (`00-business-request.md` … `17-security-report.md`) «с нуля по памяти».
-- Конвенция ADR-naming `06-adr/ADR-NNN-<kebab-slug>.md` фактически уже сложилась в репо,
-  но **нигде не зафиксирована** как стандарт.
-
-### 1.2. Боль
-- **Разнобой структуры** между задачами: набор и порядок секций одного и того же дока
-  плавает от work item к work item (видно при сравнении BRD/ТЗ разных задач).
-- Машинные доки-вердикты (`12-review.md`, `13-test-report.md`, `14-deploy-log.md`,
-  `15-staging-log.md`, `17-security-report.md`) держат критичный frontmatter-ключ
-  (`verdict:` / `deploy_status:` / `staging_status:` / `security_status:`), читаемый
-  гейтом — но единого канонического скелета с этим ключом нет → риск рассинхрона.
-- Нет единой карты «какая стадия / какой агент пишет какой документ и на каком гейте он
-  проверяется» — онбординг новых агентских ролей и аудит покрытия затруднён.
-
-### 1.3. Почему именно стандарт (а не сразу валидатор)
-Эпик ORCH-52 разбит на слои, чтобы **сначала зафиксировать договорённость (golden source
-документации)**, а уже потом, отдельной задачей (52c), навешивать машинную проверку
-frontmatter/шаблонов на гейте. Стандарт без кода — обратимый, низкорисковый, не трогает
-работающий прод-конвейер (self-hosting). Это снижает групповой риск.
-
-## 2. Объём (scope)
-
-### 2.1. В объёме (ORCH-52b)
-1. **Манифест** `docs/_standards/PIPELINE_DOCS.md`: таблица «стадия → документ» с
-   владельцем-агентом, категорией (`required` / `when-applicable` / `optional`), стадией
-   написания и гейтом/механизмом проверки — **сверенная с фактическими `QG_CHECKS` и
-   `stage_engine`**.
-2. **Канонические шаблоны** `docs/_templates/*` — скелеты (frontmatter при необходимости +
-   обязательные секции) для всех номерных доков из реального набора.
-3. **Конвенция ADR-naming** — зафиксировать сложившийся формат `06-adr/ADR-NNN-<kebab-slug>.md`
-   (нумерация с `001`, где живёт, как формируется slug); раздел в манифесте/стандарте.
-4. Ссылки на новый стандарт в `CLAUDE.md` и `docs/architecture/README.md`; запись в
-   `CHANGELOG.md`.
-
-### 2.2. Вне объёма (явно — это ORCH-52c / 52d)
-- Frontmatter-валидатор в коде; writer-контракт; принудительная проверка наличия/структуры
-  шаблонов на Quality Gate.
-- Любые изменения `QG_CHECKS` / `STAGE_TRANSITIONS` / `check_*` / `src/stage_engine.py` /
-  схемы БД.
-- Правка системных промптов агентов (`.openclaw/agents/*`) — это слой 52d.
-- Массовое приведение **уже существующих** доков прошлых задач к новому шаблону (ретро-фит).
-
-## 3. Заинтересованные стороны
-| Роль | Интерес |
-|------|---------|
-| Owner | Единообразие и аудитопригодность документации проекта |
-| Агенты analyst/architect | Готовый скелет → меньше расхождений, быстрее старт |
-| Агенты reviewer/tester/deployer | Предсказуемый frontmatter машинных доков |
-| ORCH-52c (downstream) | Стандарт = база для frontmatter-валидатора/writer-контракта |
-
-## 4. Бизнес-требования (BR)
-| ID | Требование |
-|----|------------|
-| BR-1 | Создан `docs/_standards/PIPELINE_DOCS.md` — манифест, покрывающий **все** номерные доки реального набора (00,01,02,03,04,06,07,08,10,12,13,14,15,16,17) с владельцем-агентом и категорией. |
-| BR-2 | Каждому `required` и `when-applicable` доку соответствует канонический шаблон в `docs/_templates/` (frontmatter при необходимости + обязательные секции). |
-| BR-3 | Формат ADR-naming `06-adr/ADR-NNN-<kebab-slug>.md` зафиксирован в стандарте и совпадает с реальными ADR в репо. |
-| BR-4 | Манифест и шаблоны **согласованы с фактическими эталонными доками** (ORCH-088/073/089/071): нет секций, которых никто не пишет, и наоборот; frontmatter-ключи машинных доков совпадают с тем, что реально парсят гейты. |
-| BR-5 | Обновлены `CLAUDE.md` и `docs/architecture/README.md` со ссылкой на стандарт; добавлена запись в `CHANGELOG.md`. |
-| BR-6 | Манифест отражает категорию проверки документа фактическим механизмом: какие доки несут machine-verdict frontmatter, читаемый гейтом, а какие информационные (не гейтятся). |
-
-## 5. Нефункциональные требования (NFR)
-| ID | Требование |
-|----|------------|
-| NFR-1 | **Нулевой риск для прода:** изменения — только под `docs/` (+ `CLAUDE.md`/`CHANGELOG.md`). Ни строки кода/гейтов. |
-| NFR-2 | **Достоверность:** все утверждения манифеста о стадии/агенте/гейте проверяемы по `src/stages.py` / `src/qg/checks.py` / `src/stage_engine.py`. |
-| NFR-3 | **Не изобретать:** шаблоны выведены из существующих эталонов, не из фантазии; новые секции не вводятся. |
-| NFR-4 | **Читаемость:** манифест — на русском, в стиле существующей документации проекта; таблицы машиночитаемо-аккуратные. |
-| NFR-5 | **Обратимость:** удаление новых файлов полностью откатывает изменение без следов в поведении системы. |
-
-## 6. Допущения и ограничения
-- Реальный набор номерных доков и их частота взяты из `docs/work-items/` (факты в описании
-  задачи); считаем его авторитетным на момент задачи.
-- Эталонные («golden») задачи для извлечения скелетов — ORCH-088, ORCH-073, ORCH-089, ORCH-071.
-- `09-review.md` — legacy fallback (канон — `12-review.md`); в манифест как канон **не**
-  вводится, при необходимости упоминается примечанием.
-- Стадия `monitoring` для `16-post-deploy-log.md` — пост-`done` наблюдение (ORCH-021), не
-  ребро `STAGE_TRANSITIONS`; манифест это отражает явно.
-
-## 7. Критерии успеха
-- Любой агент, открыв `docs/_standards/PIPELINE_DOCS.md`, понимает: какой документ он пишет
-  на своей стадии, в какой категории, с каким frontmatter и где он проверяется.
-- Для каждого `required`/`when-applicable` дока существует шаблон, который можно скопировать
-  и заполнить без догадок о структуре.
-- ADR-naming больше не «устная традиция», а записанная конвенция.
-- Полный набор уточняющих PASS/FAIL — в `03-acceptance-criteria.md`.
-
-## 8. Риски
-Технические риски и митигейшн ведёт архитектор в `10-tech-risks.md`. Ключевой бизнес-риск —
-**рассинхрон стандарта с кодом** (манифест описал гейт, которого нет, или наоборот): митигируется
-NFR-2 (сверка с `src/`) и AC-1/AC-4.

docs/work-items/ORCH-075/02-trz.md

@@ -1,141 +0,0 @@
-# 02 — ТЗ (TRZ): ORCH-075 — ORCH-52b: стандарт документов
-
-Work Item: **ORCH-075** · Repo: **orchestrator** · Стадия: analysis
-
-> ТЗ описывает **конкретные артефакты к созданию** (манифест + шаблоны + раздел ADR-naming) и
-> их обязательное содержимое, выведенное из фактических `STAGE_TRANSITIONS`/`QG_CHECKS` и
-> эталонных доков. Это **docs-only** изменение: исходный код, гейты, схема БД, промпты —
-> НЕ затрагиваются (см. §7). Архитектурное обоснование/решения — задача архитектора (06-adr).
-
-## 1. Сводка изменения
-Создать каталоги `docs/_standards/` и `docs/_templates/`, наполнить их манифестом
-«стадия→документ», каноническими скелетами номерных доков и зафиксировать ADR-naming.
-Обновить точки-ссылки (`CLAUDE.md`, `docs/architecture/README.md`, `CHANGELOG.md`).
-
-## 2. Задействованные модули / пути
-| Путь | Действие |
-|------|----------|
-| `docs/_standards/PIPELINE_DOCS.md` | **создать** — манифест стадия→документ + раздел ADR-naming |
-| `docs/_templates/00-business-request.md` | **создать** — шаблон |
-| `docs/_templates/01-brd.md` | **создать** |
-| `docs/_templates/02-trz.md` | **создать** |
-| `docs/_templates/03-acceptance-criteria.md` | **создать** |
-| `docs/_templates/04-test-plan.yaml` | **создать** |
-| `docs/_templates/06-adr-ADR-NNN-slug.md` | **создать** — шаблон ADR (имя файла шаблона без коллизии с реальной нумерацией) |
-| `docs/_templates/07-infra-requirements.md` | **создать** (when-applicable) |
-| `docs/_templates/08-data-requirements.md` | **создать** (when-applicable) |
-| `docs/_templates/10-tech-risks.md` | **создать** |
-| `docs/_templates/12-review.md` | **создать** (frontmatter `verdict:`) |
-| `docs/_templates/13-test-report.md` | **создать** (frontmatter `result:`) |
-| `docs/_templates/14-deploy-log.md` | **создать** (frontmatter `deploy_status:`) |
-| `docs/_templates/15-staging-log.md` | **создать** (frontmatter `staging_status:`) |
-| `docs/_templates/16-post-deploy-log.md` | **создать** (frontmatter `post_deploy_status:`) |
-| `docs/_templates/17-security-report.md` | **создать** (frontmatter `security_status:`) |
-| `CLAUDE.md` | **изменить** — ссылка на стандарт в разделе «Артефакты задачи» / «Правила для агентов» |
-| `docs/architecture/README.md` | **изменить** — ссылка на стандарт |
-| `CHANGELOG.md` | **изменить** — запись в `## [Unreleased]` |
-
-> Точное имя файла-шаблона ADR оставлено на усмотрение разработчика/архитектора при условии,
-> что **внутри** шаблона и в манифесте зафиксирован реальный целевой формат
-> `06-adr/ADR-NNN-<kebab-slug>.md` (см. §3, FR-3).
-
-## 3. Функциональные требования
-
-### FR-1 — Манифест `docs/_standards/PIPELINE_DOCS.md`
-Содержит таблицу-манифест, покрывающую **все** номерные доки реального набора. Для каждого —
-колонки: `Документ`, `Владелец-агент`, `Категория`, `Стадия написания`, `Гейт/механизм
-проверки`, `Frontmatter machine-key (если есть)`. Манифест ДОЛЖЕН соответствовать
-ground-truth ниже (сверено по `src/`):
-
-| Документ | Владелец-агент | Категория | Стадия написания | Гейт / проверка | Machine-key |
-|----------|----------------|-----------|------------------|-----------------|-------------|
-| `00-business-request.md` | система (Plane webhook `_create_initial_docs`) / заказчик | required | `created` (инициализация) | не гейтится (вход) | — |
-| `01-brd.md` | analyst | required | `analysis` | exit-гейт `analysis→architecture` = `check_analysis_approved` (Approved + полнота файлов); helper `check_analysis_complete` (наличие) | — |
-| `02-trz.md` | analyst | required | `analysis` | то же | — |
-| `03-acceptance-criteria.md` | analyst | required | `analysis` | то же | — |
-| `04-test-plan.yaml` | analyst | required | `analysis` | то же | — |
-| `06-adr/ADR-NNN-<slug>.md` | architect | required | `architecture` | `check_architecture_done` (наличие каталога/ADR) | — |
-| `07-infra-requirements.md` | architect | when-applicable | `architecture` | `check_architecture_done` (учитывается при наличии) | — |
-| `08-data-requirements.md` | architect | when-applicable | `architecture` | информационный (гейтом не парсится) | — |
-| `10-tech-risks.md` | architect | required | `architecture` | информационный (гейтом не парсится) | — |
-| `12-review.md` | reviewer | required | `review` | `check_reviewer_verdict` | `verdict:` (APPROVED\|REQUEST_CHANGES) |
-| `13-test-report.md` | tester | required | `testing` | `check_tests_passed` | `result:`/`verdict:`/`status:` (PASS\|FAIL\|BLOCKED) |
-| `14-deploy-log.md` | deployer / deploy-finalizer | required | `deploy` | `check_deploy_status` | `deploy_status:` (SUCCESS\|FAILED) |
-| `15-staging-log.md` | deployer | required (self-hosting) | `deploy-staging` | `check_staging_status` (self-hosting; иначе N/A) | `staging_status:` (SUCCESS\|FAILED) |
-| `16-post-deploy-log.md` | post-deploy-monitor | when-applicable | пост-`done` наблюдение (ORCH-021, не ребро `STAGE_TRANSITIONS`) | информационный (гейтом не парсится) | `post_deploy_status:` |
-| `17-security-report.md` | security-гейт (детерминированный, ORCH-022) | when-applicable | под-гейт ребра `deploy-staging→deploy` | `check_security_gate` | `security_status:` (PASS\|FAIL) |
-
-Примечания манифеста (обязательны):
-- Под-гейты ребра `deploy-staging→deploy` (`check_security_gate` → `check_branch_mergeable` →
-  `check_staging_image_fresh`) — **не** строки `STAGE_TRANSITIONS`, а врезки в `advance_stage`.
-- `09-review.md` — legacy fallback; канон — `12-review.md` (упомянуть примечанием, в основную
-  таблицу как канон не вносить).
-- Категория `when-applicable` = пишется при наличии соответствующего предмета (инфра/данные/
-  security/post-deploy); её отсутствие — не нарушение.
-
-### FR-2 — Шаблоны `docs/_templates/*`
-Каждый шаблон — копируемый скелет. Обязательные элементы по типам (выведено из эталонов
-ORCH-088/073/089/071):
-
-- **Документы БЕЗ frontmatter** (`00`,`01`,`02`,`03`,`06-adr`,`07`,`08`,`10`): заголовок `#`,
-  строка метаданных `Work Item / Repo / Стадия`, и фиксированные `##`-секции (ниже §FR-2.1).
-- **YAML-only**: `04-test-plan.yaml` — корневые ключи + список `tests:` (ниже §FR-2.2).
-- **Документы С YAML-frontmatter** (`12`,`13`,`14`,`15`,`16`,`17`): блок `---…---` с
-  machine-key из таблицы FR-1 + body-секции.
-
-#### FR-2.1 Обязательные секции по документу (минимальный канон)
-- `00-business-request.md`: `# Business Request: <subject>`; строка `Work Item ID:`; `## Description`.
-- `01-brd.md`: `## 1. Бизнес-контекст и проблема`, `## 2. Объём (scope)` (с `### В объёме`/`### Вне объёма`), `## 3. Заинтересованные стороны`, `## 4. Бизнес-требования (BR)`, `## 5. Нефункциональные требования (NFR)`, `## 6. Допущения и ограничения`, `## 7. Критерии успеха`, `## 8. Риски`.
-- `02-trz.md`: `## 1. Сводка изменения`, `## 2. Задействованные модули`, `## 3. Функциональные требования`, `## 4. Изменения API`, `## 5. Изменения схемы БД`, `## 6. Требования к QG checks`, `## 7. Совместимость / регресс`.
-- `03-acceptance-criteria.md`: преамбула формата; повторяемый блок `## AC-N — <title>` с `**Условие:**`, `- **PASS:**`, `- **FAIL:**`; опц. `## Сводная матрица AC ↔ FR/BR`.
-- `06-adr (шаблон)`: `# ADR-NNN: <title>`, метаданные (`Work Item`,`Стадия: architecture`,`Сквозная регистрация:`), `## Статус`, `## Контекст`, `## Решение` (с `### Сводка` и `### D1 — …`), `## Альтернативы`, `## Последствия`, `## Ссылки`.
-- `07-infra-requirements.md`: `# 07 — Инфра-требования`, нумерованные `## I-N. <topic>`.
-- `08-data-requirements.md`: `# 08 — Требования к данным`, секции по таблицам/колонкам/миграциям.
-- `10-tech-risks.md`: `# 10 — Технические риски`, таблица `| ID | Риск | Вер. | Влия. | Митигейшн |`, `## Сводный вывод`.
-- `12-review.md`: frontmatter `type: review` / `work_item_id:` / `verdict:` / `version:`; body `## Summary`, `## Оси проверки`, `## Findings` (`### P0`/`### P1`/`### P2`), `## Документация`.
-- `13-test-report.md`: frontmatter `type: test-report` / `work_item_id:` / `result:`; body `## Окружение`, `## Результаты` (`### Полный регресс`, `### Профильные сюиты`, `### Сопоставление с тест-планом`, `### Сопоставление с критериями приёмки`).
-- `14-deploy-log.md`: frontmatter `deploy_status:` / `work_item:` / `hook_exit_code:` / `deployed_by:`; body — краткое описание деплоя.
-- `15-staging-log.md`: frontmatter `staging_status:` / `timestamp:` / `base_url:`; body — `# Staging Gate Log` + результаты проверок.
-- `16-post-deploy-log.md`: frontmatter `post_deploy_status:` / `action_taken:` / `work_item:`; body — окно наблюдения/серия/решение.
-- `17-security-report.md`: frontmatter `security_status:` / `work_item:`; body — secret-scan + dependency-audit результаты.
-
-#### FR-2.2 `04-test-plan.yaml`
-Корень: `work_item:`, `title:`, `framework: pytest`, опц. `scope:`/`notes:`. Список `tests:`
-с элементами `{ id: TC-NN, type: unit|integration, description, module: tests/…, expected: PASS }`.
-
-### FR-3 — Конвенция ADR-naming
-Зафиксировать в `PIPELINE_DOCS.md` отдельным разделом:
-- Путь: `docs/work-items/<plane-id>/06-adr/`.
-- Имя: `ADR-NNN-<kebab-slug>.md`, `NNN` с `001`, инкремент при нескольких ADR в одной задаче.
-- `slug` — kebab-case (нижний регистр, дефисы), отражает суть решения.
-- Сквозные (cross-cutting) решения дублируются в `docs/architecture/adr/adr-NNNN-<slug>.md`
-  (4-значная глобальная нумерация) — это уже существующая конвенция, лишь зафиксировать.
-- Примеры из репо: `ADR-001-serial-gate`, `ADR-001-auto-label-gates`, `ADR-001-merge-verify-gate`.
-
-### FR-4 — Точки-ссылки
-- `CLAUDE.md`: в разделе «Артефакты задачи» и/или «Правила для агентов» добавить ссылку на
-  `docs/_standards/PIPELINE_DOCS.md` и `docs/_templates/` как golden source структуры доков.
-- `docs/architecture/README.md`: добавить ссылку/абзац о стандарте документов.
-- `CHANGELOG.md`: запись в `## [Unreleased]` (`docs:` тип).
-
-## 4. Изменения API
-Нет. Эндпоинты не добавляются и не меняются.
-
-## 5. Изменения схемы БД
-Нет. Таблицы/миграции не затрагиваются.
-
-## 6. Требования к новым/изменённым QG checks
-Нет. `QG_CHECKS` и `check_*` **не трогаются** (это ORCH-52c). Манифест лишь **документирует**
-текущее поведение гейтов.
-
-## 7. Совместимость / регресс
-- Изменения только под `docs/` + `CLAUDE.md` + `CHANGELOG.md`. Поведение рантайма неизменно.
-- Существующие доки прошлых задач не модифицируются (нет ретро-фита).
-- `09-review.md` (legacy) сохраняется как fallback; манифест канонизирует `12-review.md`.
-- Удаление новых файлов → полный откат без следов (NFR-5).
-
-## 8. Артефакты, создаваемые/обновляемые по pipeline
-Создаются: `docs/_standards/PIPELINE_DOCS.md`, `docs/_templates/*` (15 шаблонов).
-Обновляются: `CLAUDE.md`, `docs/architecture/README.md`, `CHANGELOG.md`.
-Downstream-доки самой задачи ORCH-075 (`06-adr`, `10-tech-risks`, `12-review`, `13-test-report`,
-`14-deploy-log`, `15-staging-log`) — по штатному конвейеру.

docs/work-items/ORCH-075/03-acceptance-criteria.md

@@ -1,104 +0,0 @@
-# 03 — Критерии приёмки (Acceptance Criteria): ORCH-075 — ORCH-52b: стандарт документов
-
-Work Item: **ORCH-075** · Repo: **orchestrator** · Стадия: analysis
-
-Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
-(что считается провалом). Скоп — только создание стандарта/шаблонов/манифеста (docs-only).
-
-> Критерии унаследованы из AC задачи и расширены проверяемыми условиями. Любой машинный/ручной
-> reviewer проверяет их буквально по файлам репозитория.
-
----
-
-## AC-1 — Манифест создан и покрывает весь реальный набор
-
-**Условие:** существует `docs/_standards/PIPELINE_DOCS.md` с таблицей-манифестом.
-- **PASS:** файл существует; манифест содержит строки для **всех** номерных доков реального
-  набора — `00, 01, 02, 03, 04, 06, 07, 08, 10, 12, 13, 14, 15, 16, 17`; для каждого указаны
-  владелец-агент (analyst/architect/developer/reviewer/tester/deployer/система) и категория
-  (`required` / `when-applicable` / `optional`).
-- **FAIL:** файла нет; пропущен хотя бы один документ набора; у дока отсутствует владелец или
-  категория.
-
----
-
-## AC-2 — Шаблоны созданы для каждого required/when-applicable дока
-
-**Условие:** существует `docs/_templates/` с каноническими скелетами.
-- **PASS:** для каждого `required` и `when-applicable` дока есть файл-шаблон; в шаблоне
-  присутствуют (а) frontmatter с machine-key там, где он требуется по FR-1 (`12`→`verdict:`,
-  `13`→`result:`, `14`→`deploy_status:`, `15`→`staging_status:`, `16`→`post_deploy_status:`,
-  `17`→`security_status:`), и (б) обязательные `##`-секции из ТЗ §FR-2.1.
-- **FAIL:** отсутствует шаблон для какого-либо required/when-applicable дока; в шаблоне
-  машинного дока нет требуемого frontmatter-ключа; набор секций произвольный, не из ТЗ.
-
----
-
-## AC-3 — ADR-naming зафиксирован
-
-**Условие:** в стандарте есть раздел про ADR-naming.
-- **PASS:** зафиксирован формат `06-adr/ADR-NNN-<kebab-slug>.md` (NNN с `001`), путь
-  (`docs/work-items/<plane-id>/06-adr/`), правило формирования slug (kebab-case) и связь со
-  сквозным реестром `docs/architecture/adr/adr-NNNN-<slug>.md`; приведён ≥1 реальный пример.
-- **FAIL:** ADR-naming не описан, либо описанный формат не совпадает с реальными ADR в репо
-  (напр. указана нумерация не с `001`, неверный путь, неверный регистр slug).
-
----
-
-## AC-4 — Согласованность с фактическими эталонами
-
-**Условие:** манифест и шаблоны соответствуют реальным эталонным докам (ORCH-088/073/089/071)
-и фактическому коду.
-- **PASS:** в шаблонах нет секций, которых никто не пишет в эталонах; все секции эталонов,
-  входящие в общий канон, присутствуют; frontmatter-ключи машинных доков совпадают с тем, что
-  реально парсят `src/qg/checks.py` (`verdict:`/`result:`/`deploy_status:`/`staging_status:`/
-  `security_status:`); привязка «документ→стадия→гейт» совпадает с `src/stages.py`
-  (`STAGE_TRANSITIONS`).
-- **FAIL:** шаблон вводит выдуманную секцию; манифест приписывает доку неверную стадию/гейт/
-  агента; frontmatter-ключ в шаблоне не тот, что читает гейт.
-
----
-
-## AC-5 — Ссылки и CHANGELOG обновлены
-
-**Условие:** точки-ссылки и журнал изменений отражают новый стандарт.
-- **PASS:** `CLAUDE.md` и `docs/architecture/README.md` содержат ссылку на
-  `docs/_standards/PIPELINE_DOCS.md` (и/или `docs/_templates/`); в `CHANGELOG.md` добавлена
-  запись в `## [Unreleased]` типа `docs:`.
-- **FAIL:** хотя бы одна из трёх точек не обновлена.
-
----
-
-## AC-6 — Код гейтов НЕ изменён
-
-**Условие:** изменение строго docs-only.
-- **PASS:** `git diff` не содержит изменений в `src/qg/checks.py` (`QG_CHECKS`/`check_*`),
-  `src/stages.py` (`STAGE_TRANSITIONS`), `src/stage_engine.py`, схеме БД и любом коде гейтов;
-  затронуты только `docs/**`, `CLAUDE.md`, `CHANGELOG.md` (+ опционально новые файлы тестов).
-- **FAIL:** изменён любой из перечисленных кодовых модулей/гейтов/схемы.
-
----
-
-## AC-7 — Манифест различает machine-verdict и информационные доки
-
-**Условие:** манифест честно отражает механизм проверки.
-- **PASS:** документы, чей frontmatter читает гейт (`12,13,14,15,17`), помечены своим
-  machine-key и гейтом; информационные (`00,08,10,16`) явно помечены как не гейтящиеся;
-  под-гейты ребра `deploy-staging→deploy` (security/merge/image-freshness) отмечены как врезки
-  в `advance_stage`, а не строки `STAGE_TRANSITIONS`.
-- **FAIL:** информационный док представлен как гейтящийся (или наоборот); под-гейты выданы за
-  стадии.
-
----
-
-## Сводная матрица AC ↔ BR
-
-| AC | Покрывает BR |
-|----|--------------|
-| AC-1 | BR-1 |
-| AC-2 | BR-2 |
-| AC-3 | BR-3 |
-| AC-4 | BR-4, BR-6 |
-| AC-5 | BR-5 |
-| AC-6 | NFR-1, NFR-5 |
-| AC-7 | BR-6, NFR-2 |

docs/work-items/ORCH-075/04-test-plan.yaml

@@ -1,136 +0,0 @@
-work_item: ORCH-075
-title: "ORCH-52b — стандарт документов (docs/_standards + docs/_templates + ADR-naming)"
-scope: "docs-only: проверяется НАЛИЧИЕ и СТРУКТУРА новых файлов-стандартов/шаблонов; код гейтов не трогается"
-framework: pytest
-notes: >
-  Изменение документационное. Тесты — лёгкие структурные проверки (existence + наличие
-  обязательных секций/frontmatter-ключей), новый файл tests/test_orch_52b_docs_standard.py.
-  Тесты НЕ меняют QG_CHECKS/STAGE_TRANSITIONS и не вводят новый гейт (это ORCH-52c). Полный
-  регресс tests/ должен остаться зелёным (отсутствие регресса от docs-изменения).
-
-tests:
-  - id: TC-01
-    type: integration
-    description: "docs/_standards/PIPELINE_DOCS.md существует и непустой"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-02
-    type: integration
-    description: "Манифест PIPELINE_DOCS.md упоминает все номерные доки набора: 00,01,02,03,04,06,07,08,10,12,13,14,15,16,17"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-03
-    type: integration
-    description: "Манифест указывает владельца-агента для каждого дока (analyst/architect/reviewer/tester/deployer/система упомянуты)"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-04
-    type: integration
-    description: "Манифест содержит категории required / when-applicable / optional"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-05
-    type: integration
-    description: "Каталог docs/_templates/ существует и содержит шаблоны для всех required/when-applicable доков"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-06
-    type: integration
-    description: "Шаблон 12-review содержит frontmatter-ключ verdict:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-07
-    type: integration
-    description: "Шаблон 13-test-report содержит frontmatter-ключ result:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-08
-    type: integration
-    description: "Шаблон 14-deploy-log содержит frontmatter-ключ deploy_status:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-09
-    type: integration
-    description: "Шаблон 15-staging-log содержит frontmatter-ключ staging_status:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-10
-    type: integration
-    description: "Шаблон 17-security-report содержит frontmatter-ключ security_status:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-11
-    type: integration
-    description: "Шаблон 16-post-deploy-log содержит frontmatter-ключ post_deploy_status:"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-12
-    type: integration
-    description: "Шаблон 01-brd содержит обязательные секции: Бизнес-контекст, Объём, Бизнес-требования, NFR"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-13
-    type: integration
-    description: "Шаблон 02-trz содержит обязательные секции: Задействованные модули, Изменения API, Изменения схемы БД, QG checks"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-14
-    type: integration
-    description: "Шаблон 03-acceptance-criteria содержит блок AC-N с метками PASS и FAIL"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-15
-    type: integration
-    description: "Шаблон 04-test-plan.yaml — валидный YAML с ключами work_item и tests (список с id/type/description/module/expected)"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-16
-    type: integration
-    description: "Раздел ADR-naming присутствует и фиксирует формат ADR-NNN-<slug>.md с нумерацией с 001 и kebab-slug"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-17
-    type: integration
-    description: "ADR-naming в стандарте совпадает с реальными ADR в репо (напр. существует docs/work-items/ORCH-088/06-adr/ADR-001-*.md)"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-18
-    type: integration
-    description: "CLAUDE.md содержит ссылку на docs/_standards/PIPELINE_DOCS.md"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-19
-    type: integration
-    description: "docs/architecture/README.md содержит ссылку на стандарт документов"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-20
-    type: integration
-    description: "CHANGELOG.md содержит запись об ORCH-52b/ORCH-075 в разделе Unreleased"
-    module: tests/test_orch_52b_docs_standard.py
-    expected: PASS
-
-  - id: TC-21
-    type: integration
-    description: "Регресс: полный прогон pytest tests/ зелёный (docs-изменение не ломает существующие тесты)"
-    module: tests/
-    expected: PASS

docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md

@@ -1,160 +0,0 @@
-# ADR-001: Стандарт документов пайплайна (docs/_standards + docs/_templates + ADR-naming)
-
-Work Item: **ORCH-075** (ORCH-52b — слой 1 эпика ORCH-52)
-Стадия: **architecture**
-Сквозная регистрация: **`docs/architecture/adr/adr-0019-pipeline-docs-standard.md`** (решение
-кросс-каттинговое — задаёт правила доко-письма для ВСЕХ агентских ролей).
-
-## Статус
-Proposed
-
-## Контекст
-Агенты конвейера (`analyst → architect → developer → reviewer → tester → deployer` + системные
-акторы deploy-finalizer / post-deploy-monitor / security-гейт) пишут номерные документы work item
-(`00-business-request.md` … `17-security-report.md`) «с нуля по памяти». Каталогов
-`docs/_standards/` и `docs/_templates/` не существует (проверено в репо). Следствия:
-
-- **Разнобой структуры** одного и того же документа от задачи к задаче (набор/порядок секций
-  плавает) — затрудняет ревью и онбординг новых ролей.
-- **Риск рассинхрона машинных вердиктов.** Доки `12-review.md` / `13-test-report.md` /
-  `14-deploy-log.md` / `15-staging-log.md` / `17-security-report.md` несут frontmatter-ключ,
-  который читает гейт (`verdict:` / `result:` / `deploy_status:` / `staging_status:` /
-  `security_status:`), но единого канонического скелета с этим ключом нет → агент может выдать
-  ключ не того имени/регистра и уронить гейт ложно.
-- **Нет карты «стадия → агент → документ → гейт».** Какая роль пишет какой документ и где он
-  проверяется — нигде не зафиксировано целостно.
-
-Эпик ORCH-52 намеренно разбит на слои: **сначала зафиксировать договорённость** (golden source
-структуры доков), и лишь потом, отдельной задачей (52c), навесить машинную проверку
-frontmatter/шаблонов на гейте. Слой 1 (эта задача) — **только документация**: манифест,
-канонические шаблоны, конвенция ADR-naming. Любой валидатор/правка кода/правка промптов — вне
-scope. Ключевое архитектурное ограничение задачи (NFR-1): **ни строки кода/гейтов** — изменения
-строго под `docs/**` (+ `CLAUDE.md` / `CHANGELOG.md`).
-
-Ground-truth для манифеста — **фактические** `STAGE_TRANSITIONS` (`src/stages.py`), `QG_CHECKS` /
-`check_*` (`src/qg/checks.py`), `src/stage_engine.py` и реальные эталонные доки (ORCH-088/073/089/071),
-а не вымысел. Сверка проведена на стадии architecture (см. §Решение D5).
-
-## Решение
-
-### Сводка
-Создать **документационный стандарт** из трёх артефактов, выведенный из фактического кода и
-эталонных доков, и подключить его ссылками из точек-онбординга. Никаких рантайм-изменений.
-
-- `docs/_standards/PIPELINE_DOCS.md` — манифест-карта «стадия → документ → агент → категория →
-  гейт/механизм → frontmatter machine-key» + раздел ADR-naming.
-- `docs/_templates/*` — копируемые скелеты для каждого `required` / `when-applicable` дока.
-- Ссылки из `CLAUDE.md` и `docs/architecture/README.md`; запись в `CHANGELOG.md`.
-
-### D1 — Местоположение и разделение «стандарт» vs «шаблон»
-Два каталога с раздельной ответственностью: `docs/_standards/` — **описательный** golden source
-(манифест, конвенции, человекочитаемая карта); `docs/_templates/` — **копируемые** скелеты для
-заполнения. Префикс `_` выводит служебные каталоги наверх листинга и визуально отделяет их от
-`docs/work-items/` / `docs/architecture/` / `docs/operations/`. Шаблоны — НЕ work item, не имеют
-`<plane-id>`, не парсятся гейтами (живут вне `docs/work-items/`), поэтому не влияют на
-`check_architecture_done` / `check_analysis_complete` и не попадают под ретро-фит.
-
-### D2 — Манифест как производная от кода, а не параллельный источник истины
-`PIPELINE_DOCS.md` **документирует** текущее поведение гейтов, но НЕ становится их источником
-истины (источник остаётся `src/`). Это устраняет класс «манифест разошёлся с кодом»: при будущем
-изменении гейта (ORCH-52c+) правка кода первична, манифест — следом. Манифест честно различает:
-- **machine-verdict доки** (`12,13,14,15,17`) — несут frontmatter-ключ, читаемый гейтом; в
-  манифесте помечены ключом и именем `check_*`;
-- **информационные доки** (`00,08,10,16`) — гейтом не парсятся; помечены явно как не-гейтящиеся
-  (чтобы не возникало ложного ожидания, что их структура что-то блокирует).
-
-Под-гейты ребра `deploy-staging → deploy` (`check_security_gate` → `check_branch_mergeable` →
-`check_staging_image_fresh`) в манифесте отмечаются как **врезки в `advance_stage`**, а НЕ строки
-`STAGE_TRANSITIONS` — иначе карта соврёт о топологии машины стадий (AC-7).
-
-### D3 — Шаблоны выведены из эталонов, новые секции не изобретаются
-Скелеты извлекаются из реальных «golden» задач (ORCH-088/073/089/071) и текущей задачи ORCH-075.
-Инвариант (NFR-3): **в шаблоне нет секции, которой никто не пишет в эталонах**, и наоборот — общий
-канон секций эталона присутствует. Минимальный обязательный набор секций по каждому документу
-зафиксирован в TRZ §FR-2.1 и является контрактом приёмки (AC-2/AC-4). Документы с машинным
-вердиктом несут в шаблоне точный frontmatter-ключ из ground-truth таблицы (D5), чтобы скопированный
-скелет проходил гейт без догадок.
-
-### D4 — ADR-naming: канонизация сложившейся традиции, не новый формат
-Зафиксировать **уже существующий** формат, не вводя нового:
-- Путь: `docs/work-items/<plane-id>/06-adr/`.
-- Имя: `ADR-NNN-<kebab-slug>.md`; `NNN` с `001`, инкремент при нескольких ADR в одной задаче.
-- `slug` — kebab-case (нижний регистр, дефисы), отражает суть решения.
-- Кросс-каттинговые решения **дублируются** в глобальном реестре
-  `docs/architecture/adr/adr-NNNN-<slug>.md` (4-значная сквозная нумерация) — это уже действующая
-  конвенция (подтверждено: реестр идёт до `adr-0018`), лишь записывается.
-- Примеры из репо (проверены): `ADR-001-serial-gate`, `ADR-001-auto-label-gates`,
-  `ADR-001-merge-verify-gate`.
-
-Сам этот ADR следует конвенции и дублируется как `adr-0019` — стандарт демонстрирует себя.
-
-### D5 — Достоверность: сверка манифеста с `src/` на стадии architecture (NFR-2)
-Перед фиксацией манифеста ground-truth сверен с кодом. Подтверждено:
-
-| Документ | Гейт / механизм | Machine-key | Подтверждено в |
-|----------|-----------------|-------------|----------------|
-| `01–04` | `check_analysis_approved` (exit `analysis→architecture`); helper `check_analysis_complete` (наличие `01/02/03/04`) | — | `stages.py`, `qg/checks.py:check_analysis_complete` |
-| `06-adr/` | `check_architecture_done` (наличие каталога `06-adr/` ≥1 файл ИЛИ `07-infra-requirements.md`) | — | `qg/checks.py:check_architecture_done` |
-| `12-review.md` | `check_reviewer_verdict` | `verdict:` | `qg/checks.py` |
-| `13-test-report.md` | `check_tests_passed` | `result:`/`verdict:`/`status:` (три равноранговых, ORCH-047) | `qg/checks.py:_parse_tests_verdict` |
-| `14-deploy-log.md` | `check_deploy_status` | `deploy_status:` | `qg/checks.py:_parse_deploy_status` |
-| `15-staging-log.md` | `check_staging_status` (self-hosting; иначе N/A — ORCH-35) | `staging_status:` | `qg/checks.py:_parse_staging_status` |
-| `17-security-report.md` | `check_security_gate` (под-гейт ребра `deploy-staging→deploy`) | `security_status:` | `qg/checks.py` |
-| `16-post-deploy-log.md` | информационный (пост-`done` наблюдение ORCH-021, не ребро) | `post_deploy_status:` (не гейтится) | `stage_engine.run_post_deploy_monitor` |
-| `00/08/10` | не гейтятся (вход / информационные) | — | — |
-
-`STAGE_TRANSITIONS` (проверено): `analysis→architecture→development→review→testing→deploy-staging
-→deploy→done`; рёбра несут ровно `check_analysis_approved / check_architecture_done / check_ci_green
-/ check_reviewer_verdict / check_tests_passed / check_staging_status / check_deploy_status`.
-Под-гейты `security/merge/image-freshness` в `STAGE_TRANSITIONS` **отсутствуют** (врезки в
-`advance_stage`) — подтверждает D2.
-
-### D6 — Разграничение ответственности стадий (что пишет архитектор vs разработчик)
-Эта стадия (architecture) производит **только** ADR + tech-risks (+ N/A infra/data). Сами артефакты
-стандарта (`PIPELINE_DOCS.md`, `docs/_templates/*`) и правки точек-ссылок
-(`CLAUDE.md` / `docs/architecture/README.md` / `CHANGELOG.md`) создаёт стадия development по TRZ §2 —
-чтобы не было двойного авторства и конфликтов. Архитектор фиксирует **контракт** (что и где должно
-появиться, по каким инвариантам), разработчик его **реализует**.
-
-## Альтернативы
-- **Один файл-стандарт без каталога шаблонов** — отвергнуто: шаблон должен быть копируемым
-  отдельным файлом (UX «скопировал и заполнил», AC-2), а не вырезкой из прозы манифеста.
-- **Сразу валидатор frontmatter на гейте** — отвергнуто намеренно (это ORCH-52c): нарушило бы
-  NFR-1 (правка кода/гейтов) и подняло бы групповой self-hosting риск без предварительной фиксации
-  договорённости. Слой «стандарт» обязан предшествовать слою «проверка».
-- **Манифест как источник истины для гейтов** — отвергнуто: породило бы дубль-истину и класс
-  «манифест ≠ код». Источник остаётся `src/`; манифест — производная (D2).
-- **Положить шаблоны в `docs/work-items/_template/`** — отвергнуто: попадание под `docs/work-items/`
-  с `<plane-id>`-семантикой риск-фактор для гейтов наличия файлов и сканеров; служебный каталог
-  должен быть вне дерева work item (D1).
-- **Ретро-фит существующих доков под новый шаблон** — отвергнуто (вне scope, BRD §2.2): массовая
-  правка истории — отдельный риск и шум; стандарт применяется к новым задачам вперёд.
-- **Не заводить глобальный `adr-0019`** — отвергнуто: решение кросс-каттинговое (правила
-  доко-письма для всех ролей), а FR-3 сам канонизирует дублирование сквозных решений в глобальный
-  реестр — стандарт обязан следовать собственному правилу.
-
-## Последствия
-- **+** Единая карта «стадия → агент → документ → гейт → machine-key»; копируемые скелеты →
-  меньше разнобоя и ложных падений гейтов из-за неверного frontmatter-ключа; ADR-naming перестаёт
-  быть устной традицией; готовая база для ORCH-52c (валидатор).
-- **+ Нулевой рантайм-риск (NFR-1/NFR-5):** изменения только под `docs/**` + `CLAUDE.md` +
-  `CHANGELOG.md`. `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / `src/stage_engine.py` / схема БД —
-  **не трогаются**. Удаление новых файлов полностью откатывает изменение без следов в поведении
-  системы (обратимость).
-- **− Дрейф во времени:** манифест — снимок поведения гейтов; при будущей правке гейта его нужно
-  обновлять вручную (до ORCH-52c, где появится проверка). Митигейшн: D2 (источник истины — код) +
-  reviewer-правило «обновлена ли документация» + явная привязка манифеста к именам `check_*`.
-- **−** Стандарт описательный, не принуждающий: агент может его проигнорировать (форсинг — 52c).
-  Осознанно принято как цена слоистого подхода.
-- **Откат:** удалить `docs/_standards/PIPELINE_DOCS.md`, `docs/_templates/*`, снять ссылки и запись
-  CHANGELOG — система ведёт себя в точности как до ORCH-075.
-
-## Ссылки
-- BRD: `docs/work-items/ORCH-075/01-brd.md`
-- TRZ: `docs/work-items/ORCH-075/02-trz.md` (ground-truth таблица FR-1, секции FR-2.1)
-- Acceptance: `docs/work-items/ORCH-075/03-acceptance-criteria.md`
-- Tech-risks: `docs/work-items/ORCH-075/10-tech-risks.md`
-- Глобальный реестр: `docs/architecture/adr/adr-0019-pipeline-docs-standard.md`
-- Эталоны скелетов: ORCH-088 / ORCH-073 / ORCH-089 / ORCH-071 (`docs/work-items/*/`)
-- Сверено по коду: `src/stages.py` (`STAGE_TRANSITIONS`), `src/qg/checks.py` (`QG_CHECKS`,
-  `_parse_*`), `src/stage_engine.py`.

docs/work-items/ORCH-075/07-infra-requirements.md

@@ -1,25 +0,0 @@
-# 07 — Инфра-требования: ORCH-075 (ORCH-52b — стандарт документов)
-
-Work Item: **ORCH-075** · Repo: **orchestrator** · Стадия: architecture
-
-## I-1. Топология / окружения
-**N/A.** Изменение docs-only: создаются `docs/_standards/PIPELINE_DOCS.md`, `docs/_templates/*` и
-правятся `CLAUDE.md` / `docs/architecture/README.md` / `CHANGELOG.md`. Контейнеры (`orchestrator`
-8500, `orchestrator-staging` 8501), Docker Compose, сеть, тома, хост mva154 — **не затрагиваются**.
-
-## I-2. Переменные окружения / секреты
-**N/A.** Новые env-переменные не вводятся; `.env` / `.env.staging` / `.env.example` не меняются;
-секретов не добавляется.
-
-## I-3. Деплой / рестарт
-**N/A.** Рантайм-поведение не меняется → прод-рестарт не требуется. Изменение проходит штатный
-self-hosting путь (`deploy-staging` 8501 → `deploy` 8500) как обычный PR, но эффект деплоя — лишь
-появление новых docs-файлов в образе; функциональной нагрузки на рестарт нет. Self-hosting инвариант
-соблюдён: **не ронять / не рестартить прод вне staging-гейта** — здесь это и не нужно.
-
-## I-4. CI/CD
-Без изменений в `.gitea/workflows/`. Добавляется один тестовый файл
-`tests/test_orch_52b_docs_standard.py` (структурные проверки), исполняемый существующим pytest-шагом.
-
-> Вывод: инфраструктурных требований нет. Файл создан для аудитопригодности (явное N/A), а не из-за
-> изменения топологии.

docs/work-items/ORCH-075/08-data-requirements.md

@@ -1,28 +0,0 @@
-# 08 — Требования к данным: ORCH-075 (ORCH-52b — стандарт документов)
-
-Work Item: **ORCH-075** · Repo: **orchestrator** · Стадия: architecture
-
-## Изменения схемы БД
-**N/A.** Изменение docs-only. Таблицы SQLite (`jobs`, `tasks`, `job_deps`, `repo_freeze`,
-`agent_runs`, `tracker_messages`, …), индексы, миграции (`init_db`) — **не затрагиваются**.
-
-## Новые/изменённые сущности
-**Нет.** Манифест и шаблоны — статические Markdown/YAML-файлы под `docs/`, вне модели данных
-рантайма. Гейты наличия файлов (`check_analysis_complete` / `check_architecture_done`) сканируют
-только `docs/work-items/<plane-id>/` и служебные каталоги `docs/_standards/` / `docs/_templates/` не
-видят (см. ADR-001 §D1, риск TR-6).
-
-## Frontmatter machine-keys (документируются, не вводятся)
-Стандарт лишь **фиксирует** уже существующие машиночитаемые ключи, которые парсят гейты — это НЕ
-новые поля данных и не изменение хранения:
-
-| Документ | Ключ | Парсер (`src/qg/checks.py`) |
-|----------|------|-----------------------------|
-| `12-review.md` | `verdict:` | `check_reviewer_verdict` |
-| `13-test-report.md` | `result:` / `verdict:` / `status:` | `_parse_tests_verdict` |
-| `14-deploy-log.md` | `deploy_status:` | `_parse_deploy_status` |
-| `15-staging-log.md` | `staging_status:` | `_parse_staging_status` |
-| `17-security-report.md` | `security_status:` | `check_security_gate` |
-| `16-post-deploy-log.md` | `post_deploy_status:` | информационный (не гейтится) |
-
-> Вывод: требований к данным/схеме нет. Файл создан для аудитопригодности (явное N/A).

docs/work-items/ORCH-075/10-tech-risks.md

@@ -1,28 +0,0 @@
-# 10 — Технические риски: ORCH-075 (ORCH-52b — стандарт документов)
-
-Work Item: **ORCH-075** · Repo: **orchestrator** · Стадия: architecture
-
-> Изменение docs-only (NFR-1): только `docs/**` + `CLAUDE.md` + `CHANGELOG.md`. Рантайм-рисков
-> деградации прода нет по построению. Основные риски — **достоверность** манифеста и **дрейф**
-> стандарта относительно кода.
-
-## Реестр рисков
-
-| ID | Риск | Вер. | Влия. | Митигейшн |
-|----|------|------|-------|-----------|
-| TR-1 | **Рассинхрон манифеста с кодом** — манифест приписывает доку неверную стадию/гейт/агента или неверный frontmatter-ключ (напр. `12-review` → не `verdict:`). | Сред. | Сред. (вводит агентов в заблуждение, ложные ожидания) | NFR-2: ground-truth сверен с `src/stages.py` / `src/qg/checks.py` / `src/stage_engine.py` на стадии architecture (ADR-001 §D5, таблица сверки). AC-4 проверяет привязку буквально по файлам. Источник истины остаётся код (D2). |
-| TR-2 | **Дрейф во времени** — будущая правка гейта (ORCH-52c+) не отражается в манифесте, т.к. форсинга нет. | Сред. | Низ. (до 52c — описательный документ) | D2 (источник истины — код, манифест производный); reviewer-правило «обновлена ли документация»; явная привязка строк манифеста к именам `check_*`; ORCH-52c добавит машинную проверку. |
-| TR-3 | **Шаблон вводит выдуманную секцию** или, наоборот, упускает секцию общего канона эталонов. | Сред. | Низ. | NFR-3: скелеты выведены строго из эталонов ORCH-088/073/089/071 + ORCH-075; TRZ §FR-2.1 фиксирует минимальный обязательный набор секций; AC-2/AC-4 проверяют. |
-| TR-4 | **Неверный machine-key в шаблоне машинного дока** — скопированный скелет уронит гейт ложно (напр. `deploy_status` написан `Deploy-Status`/иной регистр). | Низ. | Выс. (если бы дошло до прода — ложный откат БАГ-8) | Ключи в шаблонах берутся ДОСЛОВНО из `_parse_*` (`deploy_status`/`staging_status`/`security_status`/`verdict`/`result`); парсеры делают `.upper()` на значении, но имя ключа чувствительно — шаблон фиксирует точное имя. AC-2 проверяет наличие ключа. Гейты при этом **не трогаются** (docs-only). |
-| TR-5 | **Коллизия имени файла-шаблона ADR** с реальной нумерацией (`06-adr/ADR-NNN-…`). | Низ. | Низ. | TRZ §2: имя шаблона ADR без `<plane-id>`-контекста и вне `docs/work-items/` (напр. `docs/_templates/06-adr-ADR-NNN-slug.md`); внутри фиксируется реальный целевой путь/формат. |
-| TR-6 | **Шаблоны парсятся гейтами наличия файлов** (`check_architecture_done` / `check_analysis_complete` ловят `docs/_templates/*`). | Оч.низ. | Сред. | D1: служебные каталоги `docs/_standards/` / `docs/_templates/` лежат ВНЕ `docs/work-items/<plane-id>/`; гейты сканируют только путь work item → шаблоны структурно невидимы гейтам. |
-| TR-7 | **Регресс существующих тестов** от docs-изменения. | Оч.низ. | Сред. | Изменения не трогают `src/`; новый тест `tests/test_orch_52b_docs_standard.py` — только структурные проверки наличия/секций; TC-21 требует зелёного полного `pytest tests/`. |
-| TR-8 | **CHANGELOG-конфликт при merge** (`## [Unreleased]` правят параллельные задачи). | Низ. | Низ. | Корневой `.gitattributes` `CHANGELOG.md merge=union` (ORCH-073 FR-4) авто-сливает append-правки без конфликта. |
-
-## Сводный вывод
-Риск для прод-конвейера (self-hosting) — **отсутствует по построению**: изменение docs-only,
-полностью обратимо (NFR-5), `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / схема БД не затрагиваются
-(AC-6). Доминирующий класс рисков — **достоверность и дрейф** манифеста (TR-1/TR-2); закрыт сверкой
-с `src/` на стадии architecture (ADR-001 §D5) и принципом «источник истины — код, манифест —
-производная». Эскалация `arch:major-change` не требуется (нет новой стадии/QG/компонента/смены БД).
-Возврат в анализ не требуется — ТЗ удовлетворяется без нарушения принципов архитектуры.

docs/work-items/ORCH-075/12-review.md

@@ -1,71 +0,0 @@
----
-type: review
-work_item_id: ORCH-075
-verdict: APPROVED
-version: 1
----
-
-# Review ORCH-075 — ORCH-52b: стандарт документов конвейера
-
-## Summary
-Docs-only задача: создан golden source структуры номерных документов (`docs/_standards/PIPELINE_DOCS.md`),
-15 копируемых шаблонов (`docs/_templates/*`), зафиксирована конвенция ADR-naming, заведён сквозной
-ADR `adr-0019`, обновлены точки-ссылки (CLAUDE.md, architecture/README.md, CHANGELOG.md).
-Манифест и шаблоны **сверены с фактическим кодом** — соответствие подтверждено. Все 7 критериев
-приёмки выполнены. P0/P1/P2 findings нет → **APPROVED**.
-
-## Оси проверки
-
-### 1. Соответствие ТЗ (02-trz.md)
-- FR-1 (манифест) — таблица покрывает весь реальный набор `00/01/02/03/04/06/07/08/10/12/13/14/15/16/17`,
-  колонки владелец/категория/стадия/гейт/machine-key присутствуют. ✓
-- FR-2 (шаблоны) — все 15 шаблонов созданы; секции совпадают с FR-2.1 (спот-чек 01-brd, 02-trz,
-  06-adr, 04-test-plan). ✓
-- FR-3 (ADR-naming) — §4 фиксирует путь, `ADR-NNN-<kebab-slug>`, связь с глобальным реестром, примеры. ✓
-- FR-4 (точки-ссылки) — CLAUDE.md (раздел «Артефакты задачи» + правило 2), README §«Стандарт
-  документов конвейера», CHANGELOG `## [Unreleased]` (`docs`-тип). ✓
-
-### 2. Соответствие ADR (06-adr/ADR-001 + adr-0019)
-- D2 «манифест документирует, источник истины — код» отражён в самом манифесте (блок «Статус истины»). ✓
-- D5 ground-truth сверка соответствует тому, что реально читает код (проверено независимо). ✓
-- Стандарт следует собственной конвенции (заведён `adr-0019`). ✓
-
-### 3. Качество кода (docs-only) — сверка с `src/`
-Независимо подтверждено по источнику истины:
-- `STAGE_TRANSITIONS` (`src/stages.py`) — рёбра и exit-гейты совпадают с манифестом 1:1.
-- Frontmatter-ключи совпадают с парсерами: `verdict:`→`check_reviewer_verdict`; `result:`/`verdict:`/
-  `status:`→`_parse_tests_verdict`; `deploy_status:`→`_parse_deploy_status`; `staging_status:`→
-  `_parse_staging_status`; `security_status:`→`check_security_gate`/`security_gate.py`.
-- `check_analysis_complete` (01/02/03/04) и `check_architecture_done` (06-adr ≥1 файл ИЛИ 07-infra) —
-  формулировки манифеста точны.
-- Под-гейты ребра `deploy-staging→deploy` корректно помечены как врезки в `advance_stage`, не строки
-  `STAGE_TRANSITIONS` (AC-7).
-- AC-6: `git diff` по `src/` пуст — код/гейты/схема БД не тронуты.
-
-### 4. Качество тестов
-`tests/test_orch_52b_docs_standard.py` — 20 содержательных структурных тестов (наличие манифеста,
-покрытие всех доков, владельцы/категории, frontmatter-ключи каждого машинного шаблона, ADR-naming
-против реального репо, валидность YAML тест-плана, точки-ссылки, CHANGELOG). Прогон: **20 passed**.
-
-## Findings
-
-### P0 — Blocker
-- нет
-
-### P1 — Must fix
-- нет
-
-### P2 — Should fix
-- нет
-
-### P3 — Nice-to-have
-- [ ] В `06-adr/ADR-001` §D4 формулировка «реестр идёт до `adr-0018`» описывает состояние ДО добавления
-  текущего `adr-0019` (что верно), тогда как `PIPELINE_DOCS.md` §4 говорит «доходит до `adr-0019`».
-  Несоответствие безвредно (разные срезы времени), правка не требуется.
-
-## Документация
-Это docs-only задача — документация **является** деливерейблом. `src/` не изменён, поэтому правило
-CLAUDE.md «изменил src → обнови доку» неприменимо в блокирующем смысле. Сама документация проверена на
-достоверность против кода (`src/stages.py`, `src/qg/checks.py`, `src/security_gate.py`) и эталонных
-доков — расхождений нет. Точки-онбординга (CLAUDE.md, architecture/README.md) и CHANGELOG обновлены.
-Статус документации: **полностью обновлена и верифицирована**.

docs/work-items/ORCH-075/13-test-report.md

@@ -1,85 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-075
-result: PASS
----
-
-# Test Report — ORCH-075 (ORCH-52b: стандарт документов конвейера)
-
-## Окружение
-- Python: 3.12.13
-- pytest: 8.3.3
-- Дата: 2026-06-09
-- Ветка: `feature/ORCH-075-orch-52b-docs-templates-adr-na`
-- Prod health (`http://localhost:8500/health`): `{"status":"ok","service":"orchestrator"}`
-- Review verdict (12-review.md): **APPROVED** (предусловие выполнено)
-
-## Smoke-тест API (read-only, прод не трогался)
-| Endpoint | Результат |
-|----------|-----------|
-| `GET /health` | `{"status":"ok","service":"orchestrator"}` — OK |
-| `GET /status` | OK — активная задача ORCH-075 (id 68) на стадии `testing` |
-| `GET /queue` | OK — counts {running:1, done:871, failed:4}, breaker `closed`, reconcile/reaper enabled |
-
-## Результаты
-
-### Полный регресс
-`python -m pytest tests/ -q` → **1177 passed, 1 warning in 38.08s** (warning — Pydantic V2 deprecation в `src/config.py`, не относится к задаче). Регресса от docs-изменения нет.
-
-### Профильная сюита
-`python -m pytest tests/test_orch_52b_docs_standard.py -v` → **20 passed in 0.39s**.
-
-### Сопоставление с тест-планом (04-test-plan.yaml)
-
-| TC ID | Описание | Результат |
-|-------|----------|-----------|
-| TC-01 | PIPELINE_DOCS.md существует и непустой | PASS |
-| TC-02 | Манифест упоминает все номерные доки (00..17) | PASS |
-| TC-03 | Манифест указывает владельца-агента для каждого дока | PASS |
-| TC-04 | Манифест содержит категории required/when-applicable/optional | PASS |
-| TC-05 | docs/_templates/ содержит шаблоны всех required/when-applicable доков | PASS |
-| TC-06 | Шаблон 12-review содержит `verdict:` | PASS |
-| TC-07 | Шаблон 13-test-report содержит `result:` | PASS |
-| TC-08 | Шаблон 14-deploy-log содержит `deploy_status:` | PASS |
-| TC-09 | Шаблон 15-staging-log содержит `staging_status:` | PASS |
-| TC-10 | Шаблон 17-security-report содержит `security_status:` | PASS |
-| TC-11 | Шаблон 16-post-deploy-log содержит `post_deploy_status:` | PASS |
-| TC-12 | Шаблон 01-brd содержит обязательные секции | PASS |
-| TC-13 | Шаблон 02-trz содержит обязательные секции | PASS |
-| TC-14 | Шаблон 03-acceptance-criteria содержит блок AC-N с PASS/FAIL | PASS |
-| TC-15 | Шаблон 04-test-plan.yaml — валидный YAML с work_item/tests | PASS |
-| TC-16 | Раздел ADR-naming фиксирует формат ADR-NNN-<slug>.md (с 001, kebab) | PASS |
-| TC-17 | ADR-naming совпадает с реальными ADR в репо | PASS |
-| TC-18 | CLAUDE.md ссылается на docs/_standards/PIPELINE_DOCS.md | PASS |
-| TC-19 | docs/architecture/README.md ссылается на стандарт | PASS |
-| TC-20 | CHANGELOG.md содержит запись ORCH-52b/ORCH-075 в Unreleased | PASS |
-| TC-21 | Регресс: полный прогон pytest tests/ зелёный | PASS |
-
-### Сопоставление с критериями приёмки (03-acceptance-criteria.md)
-
-| AC | Критерий | Результат |
-|----|----------|-----------|
-| AC-1 | Манифест создан, покрывает весь набор + владелец/категория | PASS (TC-01..04) |
-| AC-2 | Шаблоны для каждого required/when-applicable + frontmatter-ключи + секции | PASS (TC-05..14) |
-| AC-3 | ADR-naming зафиксирован | PASS (TC-16) |
-| AC-4 | Согласованность с эталонами и кодом | PASS (TC-15,17; reviewer сверил с src/) |
-| AC-5 | Ссылки + CHANGELOG обновлены | PASS (TC-18..20) |
-| AC-6 | Код гейтов НЕ изменён (docs-only) | PASS — `git diff origin/main...HEAD -- src/` пуст; затронуты только `docs/**`, `CLAUDE.md`, `CHANGELOG.md`, `tests/test_orch_52b_docs_standard.py` |
-| AC-7 | Манифест различает machine-verdict и информационные доки | PASS (reviewer подтвердил врезки `advance_stage` и разметку гейтов) |
-
-## Вывод pytest
-```
-........................................................................ [ 97%]
-.........................                                                [100%]
-=============================== warnings summary ===============================
-src/config.py:5: PydanticDeprecatedSince20: ...
-1177 passed, 1 warning in 38.08s
-```
-```
-tests/test_orch_52b_docs_standard.py — 20 passed, 1 warning in 0.39s
-```
-
-## Итог
-**PASS** — полный регресс зелёный (1177 passed), профильная сюита зелёная (20 passed),
-smoke API OK, изменение строго docs-only (AC-6 подтверждён: `src/` не тронут).
-Задача готова к стадии `deploy-staging`.

docs/work-items/ORCH-075/14-deploy-log.md

@@ -1,12 +0,0 @@
----
-deploy_status: SUCCESS
-work_item: ORCH-075
-hook_exit_code: 0
-deployed_by: deploy-finalizer
----
-
-# Deploy log — ORCH-036 executable self-deploy
-
-Прод-деплой завершён хост-хуком с exit-code `0` -> `deploy_status: SUCCESS`.
-
-Вердикт зафиксирован детерминированным finalizer'ом (Фаза C), не LLM.

docs/work-items/ORCH-075/15-staging-log.md

@@ -1,49 +0,0 @@
----
-staging_status: SUCCESS
-timestamp: 2026-06-09T10:22:40Z
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-Staging test suite completed against the live `orchestrator-staging` instance (8501).
-Result: **8/10 checks PASS**, exit code **0** → `staging_status: SUCCESS`.
-
-All REAL (pipeline) checks are green. The only two failures are the known
-sandbox-infra checks **C9a / C9b**, which depend on SANDBOX bot accounts being
-project members (infra precondition), not on the pipeline. Per ORCH-061 they are
-tolerated when every REAL check is green; the suite printed an `INFRA-WAIVED:` line
-and exited 0 (fail-closed for real checks preserved).
-
-## Execution
-
-- Command: `python3 /repos/orchestrator/scripts/staging_check.py --base-url http://localhost:8501 --mode stub`
-- Ran inside the `orchestrator-staging` container (canonical, ADR-001 / ORCH-048),
-  so the B6 registry-isolation check reads the running instance's own process-env.
-- Note: the `docker` CLI is not installed in this environment; the exec was issued
-  through the mounted Docker Engine API socket (`/var/run/docker.sock`), which is
-  functionally equivalent to `docker exec orchestrator-staging …`.
-
-## Observability — waiver line (ORCH-061)
-
-```
-INFRA-WAIVED: C9a Branch appears in orchestrator-sandbox, C9b Analyst job enqueued in staging queue (known sandbox-infra; real checks green)
-VERDICT: SUCCESS (exit 0) — SUCCESS (infra-waived): ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue'] are known sandbox-infra checks; all real checks green
-```
-
-## Check summary
-
-| Block | Check | Result |
-|-------|-------|--------|
-| A SMOKE | A1 GET /health → 200 status=ok | ✓ PASS |
-| A SMOKE | A2 GET /queue → 200 with counts/max_concurrency/resilience | ✓ PASS |
-| A SMOKE | A3 ORCH_STAGING=true (not prod) | ✓ PASS |
-| B ACCESS | B4 Plane: sandbox project accessible | ✓ PASS |
-| B ACCESS | B5 Gitea: orchestrator-sandbox accessible, push=true | ✓ PASS |
-| B ACCESS | B6 Registry: sandbox present, prod ET/ORCH absent | ✓ PASS |
-| C E2E | C7 Create issue in Plane SANDBOX | ✓ PASS |
-| C E2E | C8 Trigger pipeline via /webhook/plane | ✓ PASS |
-| C E2E | C9a Branch appears in orchestrator-sandbox | ✗ FAIL (SANDBOX_INFRA, waived) |
-| C E2E | C9b Analyst job enqueued in staging queue | ✗ FAIL (SANDBOX_INFRA, waived) |
-
-REAL failed: none. SANDBOX_INFRA failed: C9a, C9b (waived). Exit code: 0.

docs/work-items/ORCH-076/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-52c: протокол handoff + frontmatter-контракт (writer/валидатор/схема)
-
-Work Item ID: ORCH-076
-
-## Description
-
-TBD

docs/work-items/ORCH-076/01-brd.md

@@ -1,151 +0,0 @@
-# 01 — BRD (бизнес-требования): ORCH-076 — ORCH-52c: протокол handoff + frontmatter-контракт (writer/валидатор/схема)
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: analysis
-
-## 1. Бизнес-контекст и проблема
-
-Это **слой 2 эпика ORCH-52** (стандартизация документного конвейера). Слой 1 (ORCH-52b /
-ORCH-075) уже в `main`: создан **описательный** стандарт `docs/_standards/PIPELINE_DOCS.md`
-+ копируемые скелеты `docs/_templates/*`. Стандарт честно фиксирует карту «стадия → агент →
-документ → гейт → frontmatter machine-key», но прямо помечен как слой описательный:
-«Машинная проверка соответствия шаблонам/frontmatter — отдельная задача ORCH-52c».
-
-Установленные факты (проверено в репо на ветке задачи):
-
-- **`src/frontmatter.py` = ТОЛЬКО reader.** Единственная функция
-  `read_frontmatter_value(path, key) -> str | None` (single-key, ~2.6 KB). В docstring
-  модуля прямой коммент: *«merging into a single parser is a follow-up task»* — это и есть
-  ORCH-52c. Контракт reader — **never raises** (любая ошибка → `None` + `logger.debug`).
-- **Протокол вердиктов размазан по отдельным парсерам с дублированной ~10-строчной
-  YAML-frontmatter-логикой:**
-  - `src/qg/checks.py::check_reviewer_verdict` — читает `verdict:` из `12-review.md`;
-  - `src/qg/checks.py::_parse_tests_verdict` — читает `result:`/`verdict:`/`status:` из
-    `13-test-report.md` (три равноранговых поля, ORCH-047);
-  - `src/qg/checks.py::_parse_deploy_status` — читает `deploy_status:` из `14-deploy-log.md`;
-  - `src/qg/checks.py::_parse_staging_status` — читает `staging_status:` из `15-staging-log.md`;
-  - `src/security_gate.py::parse_security_status` — читает `security_status:` из `17-security-report.md`;
-  - `src/post_deploy.py` — пишет/читает `post_deploy_status:` в `16-post-deploy-log.md`;
-  - `src/review_parse.py` — defensive-извлечение прозы (`_strip_frontmatter`).
-  Каждый парсер заново реализует `content.startswith("---")` → `split("---", 2)` →
-  `yaml.safe_load`. Единого контракта нет → риск рассинхрона (разная обработка ошибок,
-  разный набор токенов, разный регистр).
-- **Нет формальной спеки handoff:** нигде не зафиксировано «что КАЖДАЯ стадия ОБЯЗАНА
-  оставить на выходе» (полный список артефактов + обязательные frontmatter-ключи) как
-  единый контракт передачи между стадиями.
-
-**Боль/риск:** без единого контракта чтения вердиктов и без обязательной схемы frontmatter
-каждая правка одного парсера может разойтись с остальными; новый агентский документ легко
-написать с неверным ключом/регистром (гейт упадёт ложно), а отсутствие машинной проверки
-схемы оставляет соблюдение стандарта на ручную дисциплину reviewer'а.
-
-**⚠️ Self-hosting.** Задача меняет КОД, читающий вердикты НА ГЕЙТАХ (review/staging/security/
-tester/deploy) в инструменте, который сейчас обслуживает прод (enduro-trails) из общего
-инстанса. Любой регресс чтения вердикта = остановка конвейера всех проектов. Поэтому
-рефакторинг обязан быть строго обратно совместимым и fail-safe.
-
-## 2. Объём (scope)
-
-### В объёме
-- **Спека handoff** в `docs/_standards/` (рядом с `PIPELINE_DOCS.md`): формальный контракт
-  «стадия → обязательный выход» (какие документы + какие frontmatter-ключи обязательны на
-  выходе каждой стадии), согласованный с манифестом ORCH-52b.
-- **Расширение `src/frontmatter.py`:** к существующему reader добавить **writer** (запись
-  YAML-frontmatter) и **валидатор** обязательной схемы. Обязательная схема:
-  `work_item`, `stage`, `author_agent`, `status`, `created_at`, `model_used`.
-- **Единый контракт вердиктов в одном месте** (док + единый frontmatter-API): гейты
-  (reviewer→`verdict:`, tester→`result:`, deployer→`deploy_status:`, staging→`staging_status:`,
-  security→`security_status:`) читают СТАНДАРТНЫЕ поля через единый frontmatter-API, а не
-  через разрознённые ad-hoc парсеры.
-- Обновление документации (CLAUDE.md, architecture/README, ADR — глобальный и per-work-item,
-  CHANGELOG).
-
-### Вне объёма
-- **Правка промптов агентов** (`.openclaw/agents/*.md`), чтобы те эмитили новую полную схему
-  — это **ORCH-52d** (слой 3).
-- **Ретро-фит старых документов** (дописывание новой схемы в уже существующие work-items).
-- Изменение `STAGE_TRANSITIONS` и **состава** `QG_CHECKS` (какие гейты существуют).
-- Изменение **семантики** вердиктов (какое значение → какой переход) — только КАК они
-  читаются.
-- Включение hard-fail валидации схемы по умолчанию (дефолт — warning; hard-fail только под
-  явно включённым kill-switch).
-
-## 3. Заинтересованные стороны
-
-- **Заказчик / Owner** — Слава (homenet542): подтверждает BRD (ручной гейт остаётся ручным).
-- **Самообслуживаемый инструмент (self-hosting)** — оркестратор правит сам себя; задача —
-  первый боевой тест `autoDeploy` (см. примечание ниже).
-- **Затрагиваемые роли конвейера** — reviewer / tester / deployer / security-гейт (их
-  вердикты теперь читаются через единый API); architect/analyst (новая обязательная схема
-  для будущих документов, фактическое внедрение — ORCH-52d).
-- **Другие проекты (enduro-trails)** — НЕ должны почувствовать изменений (нулевая регрессия).
-
-## 4. Бизнес-требования (BR)
-
-- **BR-1** — `src/frontmatter.py` предоставляет полный набор операций над YAML-frontmatter:
-  **reader** (сохранён без изменения контракта), **writer** (сериализация frontmatter в
-  документ), **валидатор** (проверка обязательной схемы).
-- **BR-2** — Обязательная схема frontmatter определена и проверяема: поля `work_item`,
-  `stage`, `author_agent`, `status`, `created_at`, `model_used`.
-- **BR-3** — Создана формальная спека handoff в `docs/_standards/`, согласованная с
-  `PIPELINE_DOCS.md`: для каждой стадии указано, какие документы и какие frontmatter-ключи
-  она обязана оставить на выходе.
-- **BR-4** — Контракт вердиктов сведён в ОДНО место; все пять гейтов-вердиктов
-  (review/staging/security/tester/deploy) читают стандартные поля через единый
-  frontmatter-API, а не через разрознённые парсеры.
-- **BR-5** — Семантика вердиктов неизменна: то же значение → тот же переход/откат, что и
-  сейчас (включая трёх-полевой контракт tester'а ORCH-047 и токен-логику BLOCKED/FAILED).
-
-## 5. Нефункциональные требования (NFR)
-
-- **NFR-1 (обратная совместимость, критично self-hosting)** — Существующие документы-вердикты
-  БЕЗ новой полной схемы ПРОДОЛЖАЮТ читаться гейтами (fallback на текущее поведение). Старый
-  `12/13/14/15/17`-док без `work_item/stage/...` парсится по вердикт-ключу как раньше.
-- **NFR-2 (never-raise / fail-safe)** — Ошибка writer'а или валидатора НЕ роняет конвейер
-  (тот же контракт, что у reader: любая ошибка → лог + безопасное значение, исключение
-  наружу не выходит).
-- **NFR-3 (валидатор не self-block)** — Валидатор обязательной схемы НЕ является hard-fail
-  на гейте по умолчанию (иначе сама ORCH-52c заблокировала бы себя на собственном деплое,
-  т.к. её документы и документы соседей ещё без полной схемы). Дефолт — warning/лог;
-  жёсткость — под kill-switch (флаг).
-- **NFR-4 (нулевая регрессия для enduro)** — Поведение для не-self-hosting репозиториев и
-  всех существующих гейтов остаётся 1:1; полный регресс `tests/` зелёный.
-- **NFR-5 (обратимость)** — Поведенческие изменения (если есть, напр. строгая валидация)
-  закрываются kill-switch с дефолтом, эквивалентным прежнему поведению.
-
-## 6. Допущения и ограничения
-
-- Frontmatter везде в каноне — ведущий YAML-блок между `---` … `---` (как в `qg/checks.py`
-  и `frontmatter.py`).
-- Источник истины о поведении гейтов остаётся КОД (`src/stages.py`, `src/qg/checks.py`,
-  `src/stage_engine.py`); спека/манифест документируют, а не управляют (правило ORCH-075).
-- `model_used` в схеме — это модель, которой документ создан; фактический источник значения
-  для агентских доков — резолв `resolve_agent_model` (ORCH-41); проставление в реальные
-  документы агентами — ORCH-52d, вне scope.
-- `pyyaml` уже зависимость проекта (используется во всех существующих парсерах).
-- Реализационные решения (одна функция-парсер vs класс, точная сигнатура writer/валидатора,
-  имя модуля контракта вердиктов) — прерогатива архитектора (06-adr), здесь не предрешаются.
-
-## 7. Критерии успеха
-
-Задача успешна, если: `src/frontmatter.py` несёт reader+writer+валидатор обязательной схемы;
-спека handoff создана и согласована с `PIPELINE_DOCS.md`; все пять гейтов-вердиктов читают
-через единый frontmatter-API; старые доки-вердикты продолжают проходить гейты (анти-регресс);
-ошибка writer/валидатора не роняет конвейер, hard-fail валидации под kill-switch (дефолт —
-warning); `STAGE_TRANSITIONS` и состав `QG_CHECKS` не изменены, семантика вердиктов неизменна;
-документация обновлена; **сама ORCH-52c проходит свои гейты** (включая первый боевой
-`autoDeploy`). Детальные PASS/FAIL — `03-acceptance-criteria.md`.
-
-## 8. Риски
-
-- **Регресс чтения вердикта на гейте** → остановка конвейера всех проектов (главный риск
-  self-hosting). Митигация — строгая обратная совместимость + полный регресс тестов гейтов.
-- **Самоблокировка валидатором** на собственном деплое (документы без полной схемы).
-  Митигация — NFR-3 (валидатор не hard-fail по умолчанию).
-- **Расхождение спеки handoff с фактом кода** → «лживый» стандарт. Митигация — согласование
-  с `PIPELINE_DOCS.md` и явная пометка «источник истины — код».
-- **Первый боевой `autoDeploy`** — авто-подтверждение прод-деплоя орка (см. примечание).
-  Детали митигации/наблюдения — задача архитектора (`10-tech-risks.md`).
-
-> **Примечание (АВТО-ДЕПЛОЙ).** На этой задаче выставлен лейбл `autoDeploy` (ORCH-089): орк
-> САМ подтверждает прод-деплой после зелёного staging + всех тех-гейтов. BRD-гейт остаётся
-> ручным (Слава подтверждает BRD). Это первый боевой тест `autoDeploy`.

docs/work-items/ORCH-076/02-trz.md

@@ -1,124 +0,0 @@
-# 02 — ТЗ (TRZ): ORCH-076 — ORCH-52c: протокол handoff + frontmatter-контракт (writer/валидатор/схема)
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: analysis
-
-> ТЗ описывает **конкретные изменения к реализации**, выведенные из BRD и фактического кода.
-> Архитектурное обоснование/решения (как именно структурировать модуль контракта вердиктов,
-> точные сигнатуры) — задача архитектора (06-adr).
-
-## 1. Сводка изменения
-
-ORCH-52c превращает `src/frontmatter.py` из single-key reader в полный frontmatter-контракт
-(**reader + writer + валидатор обязательной схемы**) и сводит **разрознённое чтение вердиктов**
-гейтов к **единому frontmatter-API**, не меняя ни состав гейтов, ни семантику вердиктов.
-Дополнительно создаётся **формальная спека handoff** в `docs/_standards/`, согласованная с
-манифестом ORCH-52b (`PIPELINE_DOCS.md`). Всё строго обратно совместимо (старые доки читаются
-как раньше), never-raise, валидатор не hard-fail по умолчанию (kill-switch).
-
-## 2. Задействованные модули / пути
-
-| Путь | Действие |
-|------|----------|
-| `src/frontmatter.py` | **изменить** — добавить writer + валидатор + чтение всего frontmatter (multi-key/dict); reader `read_frontmatter_value` сохранить (контракт неизменен) |
-| `src/qg/checks.py` | **изменить** — `check_reviewer_verdict`, `_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status` перевести на чтение через единый frontmatter-API (поведение/токены/семантика 1:1) |
-| `src/security_gate.py` | **изменить** — `parse_security_status` читает `security_status:` через единый API (семантика 1:1) |
-| `src/post_deploy.py` | **изменить (по решению архитектора)** — чтение `post_deploy_status:` через единый API (информационный, не гейт) |
-| `src/review_parse.py` | **возможно изменить** — `_strip_frontmatter` может использовать общий хелпер; контракт «never raise → ""» сохранить |
-| `src/config.py` | **изменить** — добавить kill-switch строгой валидации (напр. `frontmatter_validation_strict: bool = False`) |
-| `docs/_standards/HANDOFF_PROTOCOL.md` (имя — на усмотрение архитектора/стандарта) | **создать** — формальная спека handoff «стадия → обязательный выход» |
-| `docs/_standards/PIPELINE_DOCS.md` | **изменить** — связать со спекой handoff, отметить что ORCH-52c реализовала машинный контракт |
-| `tests/test_frontmatter.py` | **создать** — unit на reader/writer/валидатор/round-trip |
-| `tests/` (гейты) | **изменить/создать** — анти-регресс тесты чтения вердиктов через новый API |
-| `CLAUDE.md`, `docs/architecture/README.md`, `CHANGELOG.md`, ADR | **изменить/создать** — документация |
-
-## 3. Функциональные требования
-
-### FR-1 — Writer frontmatter (BR-1)
-В `src/frontmatter.py` добавить функцию записи: принимает данные frontmatter (mapping
-ключ→значение) и тело документа, возвращает/записывает строку с каноничным ведущим
-YAML-блоком `---\n…\n---\n<body>`. Формат на 100% совместим с существующими парсерами
-(`split("---", 2)` + `yaml.safe_load`). **never-raise** (NFR-2): ошибка сериализации/записи →
-лог + безопасный результат, исключение наружу не выходит. Точная сигнатура (in-memory render
-vs запись в файл, перезапись существующего frontmatter) — решение архитектора.
-
-### FR-2 — Валидатор обязательной схемы (BR-2, NFR-3)
-В `src/frontmatter.py` добавить валидатор, проверяющий наличие обязательных полей схемы:
-`work_item`, `stage`, `author_agent`, `status`, `created_at`, `model_used`. Возвращает
-структурированный результат (список отсутствующих/невалидных полей + признак валидности).
-**Поведение по умолчанию — warning/лог, НЕ blocker** (NFR-3): отсутствие полей не роняет
-конвейер и не заваливает гейт. Жёсткость (hard-fail) включается ТОЛЬКО kill-switch'ем
-`frontmatter_validation_strict` (дефолт `False`). never-raise.
-
-### FR-3 — Полночтение frontmatter / единый reader-API (BR-1, BR-4)
-В `src/frontmatter.py` добавить чтение ВСЕГО frontmatter как mapping (а не только single-key),
-поверх которого строится единый доступ к вердикт-полям. Существующий
-`read_frontmatter_value(path, key)` сохраняется без изменения контракта (обратная
-совместимость вызывающих — `notifications.build_status_comment` и т.п.). never-raise.
-
-### FR-4 — Единый контракт чтения вердиктов (BR-4, BR-5, NFR-1)
-Пять гейтов-вердиктов читают свои стандартные поля через единый frontmatter-API:
-
-| Гейт / парсер | Документ | Стандартное поле | Семантика (НЕИЗМЕННА) |
-|---------------|----------|------------------|------------------------|
-| `check_reviewer_verdict` | `12-review.md` | `verdict:` | `APPROVED`→дальше; `REQUEST_CHANGES`→откат на development |
-| `_parse_tests_verdict` | `13-test-report.md` | `result:` / `verdict:` / `status:` (3 равноранговых, ORCH-047) | `PASS`→дальше; `FAIL`/`BLOCKED`→откат; негативный токен авторитетен |
-| `_parse_deploy_status` | `14-deploy-log.md` | `deploy_status:` | `SUCCESS`→done; `FAILED`→откат (БАГ-8) |
-| `_parse_staging_status` | `15-staging-log.md` | `staging_status:` | `SUCCESS`→дальше; `FAILED`→откат (self-hosting; иначе N/A) |
-| `parse_security_status` | `17-security-report.md` | `security_status:` | `PASS`→дальше; `FAIL`→откат |
-
-Требование: **только механизм чтения** унифицируется (одна точка парсинга YAML-frontmatter);
-наборы токенов (`_TESTS_NEGATIVE_TOKENS`/`_TESTS_POSITIVE_TOKENS`), приведение к верхнему
-регистру, обработка «no frontmatter / bad YAML / missing key», fallback `worktree → origin/main`
-для deploy/staging — сохраняются 1:1. Возврат каждого `check_*` — прежний `tuple[bool, str]`.
-
-### FR-5 — Обратная совместимость старых доков (NFR-1, критично)
-Документ-вердикт БЕЗ новых полей схемы (`work_item/stage/author_agent/status/created_at/
-model_used`), но с вердикт-ключом (`verdict:`/`result:`/`deploy_status:`/…) ДОЛЖЕН читаться
-гейтом ровно как сейчас. Новая схема — аддитивна; её отсутствие не влияет на чтение вердикта.
-
-### FR-6 — Спека handoff (BR-3)
-Создать в `docs/_standards/` формальную спеку «стадия → обязательный выход»: для каждой стадии
-(`created`→`analysis`→`architecture`→`development`→`review`→`testing`→`deploy-staging`→`deploy`
-→`done`) перечислить обязательные документы и обязательные frontmatter-ключи на выходе.
-Согласовать с таблицей §2 `PIPELINE_DOCS.md` (тот же набор документов/ключей/гейтов), явно
-указать «источник истины — код». Различать machine-verdict доки и информационные (как в
-`PIPELINE_DOCS.md` §3).
-
-## 4. Изменения API
-
-Нет. HTTP-эндпоинты не добавляются/не меняются. (Опционально архитектор может предложить блок
-наблюдаемости в `GET /queue` для счётчика валидации — НЕ требование данной задачи.)
-
-## 5. Изменения схемы БД
-
-Нет. Таблицы/миграции/индексы не затрагиваются. Контракт работает на файлах
-(YAML-frontmatter) и in-memory.
-
-## 6. Требования к новым/изменённым QG checks
-
-- **Состав `QG_CHECKS` НЕ изменяется** (никаких новых/удалённых зарегистрированных гейтов) —
-  AC-6 / правило CLAUDE.md.
-- Изменяется только **внутренняя реализация чтения вердикта** существующих `check_*`/`_parse_*`
-  (делегирование единому frontmatter-API). Сигнатуры и возвращаемые значения (`tuple[bool,str]`)
-  — неизменны.
-- Новый kill-switch `frontmatter_validation_strict` (config) управляет жёсткостью валидатора
-  схемы; дефолт `False` (warning-only) → нулевая поведенческая регрессия.
-
-## 7. Совместимость / регресс
-
-- **Обратная совместимость (NFR-1):** старые доки-вердикты без новой схемы читаются как
-  раньше; контракт `read_frontmatter_value` неизменен; формат writer'а совместим с
-  существующими парсерами.
-- **never-raise (NFR-2):** writer/валидатор/единый reader не выбрасывают исключений в
-  конвейер (паттерн текущего `frontmatter.py`).
-- **kill-switch / обратимость (NFR-3, NFR-5):** `frontmatter_validation_strict=False` (дефолт)
-  → валидация только логирует; `True` → строгий режим (на будущее). Поведение деградирует к
-  прежнему при дефолтном флаге.
-- **Неизменность контрактов (AC-6):** `STAGE_TRANSITIONS`, состав `QG_CHECKS`, семантика
-  вердиктов, fallback `worktree→origin/main`, трёх-полевой контракт tester (ORCH-047),
-  токен-логика BLOCKED/FAILED — без изменений.
-- **Нулевая регрессия enduro (NFR-4):** для не-self-hosting репо поведение 1:1; условные гейты
-  (ORCH-35/43/58) не затрагиваются по существу.
-- **Полный регресс `tests/` зелёный** перед мержем.
-- **self-hosting:** не перезапускать прод-контейнер вручную; деплой через штатный путь;
-  первый боевой `autoDeploy` (наблюдение — за стадией deploy).

docs/work-items/ORCH-076/03-acceptance-criteria.md

@@ -1,104 +0,0 @@
-# 03 — Критерии приёмки (Acceptance Criteria): ORCH-076 — ORCH-52c: протокол handoff + frontmatter-контракт
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: analysis
-
-Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
-(что считается провалом). Любой машинный/ручной reviewer проверяет их буквально по файлам
-репозитория. Критерии прямо отражают AC из постановки задачи (AC-1…AC-7).
-
----
-
-## AC-1 — frontmatter: reader + writer + валидатор
-
-**Условие:** `src/frontmatter.py` несёт полный контракт.
-- **PASS:** в `src/frontmatter.py` есть (а) сохранённый reader `read_frontmatter_value` с
-  прежним контрактом; (б) **writer** (запись/рендер YAML-frontmatter); (в) **валидатор**
-  обязательной схемы, проверяющий поля `work_item`, `stage`, `author_agent`, `status`,
-  `created_at`, `model_used`. Все три покрыты unit-тестами.
-- **FAIL:** отсутствует writer ИЛИ валидатор; или валидатор не проверяет полный список из
-  6 обязательных полей; или контракт reader сломан (изменена сигнатура/поведение).
-
----
-
-## AC-2 — спека handoff создана и согласована
-
-**Условие:** формальный контракт handoff в `docs/_standards/`.
-- **PASS:** в `docs/_standards/` создан документ-спека, где для КАЖДОЙ стадии указано, какие
-  документы и какие frontmatter-ключи она обязана оставить на выходе; набор документов/ключей/
-  гейтов согласован с `PIPELINE_DOCS.md` §2–§3 (нет противоречий); `PIPELINE_DOCS.md`
-  обновлён ссылкой на спеку и отметкой о реализации машинного контракта в ORCH-52c.
-- **FAIL:** спека отсутствует, не в `docs/_standards/`, покрывает не все стадии, или
-  противоречит `PIPELINE_DOCS.md` (другой набор ключей/документов).
-
----
-
-## AC-3 — единый контракт вердиктов
-
-**Условие:** гейты читают вердикты через единый frontmatter-API.
-- **PASS:** контракт вердиктов сведён в ОДНО место (единый frontmatter-API); все пять
-  вердикт-точек — `check_reviewer_verdict` (`verdict:`), `_parse_tests_verdict`
-  (`result:`/`verdict:`/`status:`), `_parse_deploy_status` (`deploy_status:`),
-  `_parse_staging_status` (`staging_status:`), `parse_security_status` (`security_status:`) —
-  парсят YAML-frontmatter через этот API, а не дублированной ad-hoc логикой.
-- **FAIL:** хотя бы один из пяти гейтов по-прежнему содержит собственную дублированную
-  реализацию парсинга YAML-frontmatter вместо единого API.
-
----
-
-## AC-4 — анти-регресс: старые доки читаются, ORCH-52c проходит свои гейты (критично self-hosting)
-
-**Условие:** обратная совместимость + самопрохождение.
-- **PASS:** документ-вердикт БЕЗ новой полной схемы (только с вердикт-ключом) читается гейтом
-  ровно как до задачи (подтверждено тестом для каждого из пяти гейтов); полный регресс
-  `tests/` зелёный; **сама ORCH-52c проходит свои гейты** (review→testing→staging→deploy)
-  и доезжает до `done`.
-- **FAIL:** любой старый док-вердикт перестал читаться/изменил вердикт; регресс `tests/`
-  красный; задача застряла/откатилась на собственном гейте из-за нового контракта.
-
----
-
-## AC-5 — never-raise + валидатор не hard-fail по умолчанию (kill-switch)
-
-**Условие:** fail-safe и не-самоблокирующая валидация.
-- **PASS:** ошибка writer'а/валидатора логируется и НЕ роняет конвейер (исключение наружу не
-  выходит, подтверждено тестом на битом вводе); валидация обязательной схемы по умолчанию —
-  warning/лог, НЕ blocker; hard-fail доступен ТОЛЬКО под kill-switch
-  (`frontmatter_validation_strict`, дефолт `False`).
-- **FAIL:** ошибка writer/валидатора пробрасывается в конвейер; ИЛИ отсутствие полей схемы
-  по умолчанию заваливает гейт/останавливает задачу; ИЛИ нет kill-switch для строгого режима.
-
----
-
-## AC-6 — STAGE_TRANSITIONS и состав QG_CHECKS не изменены; семантика неизменна
-
-**Условие:** инварианты конвейера.
-- **PASS:** `src/stages.py::STAGE_TRANSITIONS` и реестр `QG_CHECKS` (`src/qg/checks.py`) —
-  без изменений по составу (те же стадии, те же зарегистрированные гейты); семантика каждого
-  вердикта (значение → переход/откат) идентична прежней, включая ORCH-047 (3 равноранговых
-  поля tester) и приоритет негативного токена.
-- **FAIL:** изменён состав `STAGE_TRANSITIONS`/`QG_CHECKS`; или хоть один вердикт даёт другой
-  переход при том же значении, что до задачи.
-
----
-
-## AC-7 — документация обновлена
-
-**Условие:** golden-source документации синхронна с кодом.
-- **PASS:** обновлены `CLAUDE.md`, `docs/architecture/README.md`, `CHANGELOG.md`; заведён
-  ADR per-work-item (`docs/work-items/ORCH-076/06-adr/ADR-001-*.md`) и сквозной
-  (`docs/architecture/adr/adr-NNNN-*.md`); спека handoff и `PIPELINE_DOCS.md` согласованы.
-- **FAIL:** функционал изменён, но доки/ADR/CHANGELOG не обновлены (reviewer →
-  REQUEST_CHANGES по правилу CLAUDE.md №6).
-
----
-
-## Сводная матрица AC ↔ FR/BR
-| AC | Покрывает |
-|----|-----------|
-| AC-1 | BR-1 / BR-2 / FR-1 / FR-2 / FR-3 |
-| AC-2 | BR-3 / FR-6 |
-| AC-3 | BR-4 / FR-4 |
-| AC-4 | NFR-1 / NFR-4 / FR-5 |
-| AC-5 | NFR-2 / NFR-3 / NFR-5 / FR-2 |
-| AC-6 | BR-5 / NFR-1 |
-| AC-7 | правило CLAUDE.md №2/№6 |

docs/work-items/ORCH-076/04-test-plan.yaml

@@ -1,122 +0,0 @@
-work_item: ORCH-076
-title: "ORCH-52c — handoff-протокол + frontmatter writer/валидатор/единый контракт вердиктов"
-framework: pytest
-scope: >
-  Покрывается: writer/валидатор/единое чтение frontmatter (src/frontmatter.py);
-  чтение пяти гейтов-вердиктов через единый API при семантике 1:1; обратная
-  совместимость старых доков без новой схемы; never-raise; kill-switch строгой
-  валидации. Вне покрытия: правка промптов агентов (ORCH-52d), ретро-фит старых
-  документов, изменение STAGE_TRANSITIONS/состава QG_CHECKS.
-notes: >
-  Полный регресс tests/ должен оставаться зелёным (анти-регресс гейтов, AC-4/AC-6).
-  Регресс = любой существующий тест гейтов (review/tester/deploy/staging/security),
-  ставший красным, или изменение вердикта при том же входном значении.
-  Тесты не должны требовать сети (frontmatter — файловый/in-memory контракт).
-
-tests:
-  # --- frontmatter.py: writer / валидатор / reader (AC-1, AC-5) ---
-  - id: TC-01
-    type: unit
-    description: "Writer сериализует mapping в каноничный ведущий YAML-frontmatter (--- ... ---), читаемый существующими парсерами"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-02
-    type: unit
-    description: "Round-trip: writer записал frontmatter -> reader read_frontmatter_value возвращает те же значения по ключам"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-03
-    type: unit
-    description: "Валидатор: полная схема (work_item/stage/author_agent/status/created_at/model_used) -> valid=True, нет отсутствующих полей"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-04
-    type: unit
-    description: "Валидатор: отсутствие части обязательных полей -> valid=False со списком отсутствующих, но БЕЗ исключения (warning-only по умолчанию)"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-05
-    type: unit
-    description: "never-raise: writer и валидатор на битом вводе (None/не-mapping/нечитаемый путь/битый YAML) не выбрасывают исключение, возвращают безопасное значение + лог"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-06
-    type: unit
-    description: "reader read_frontmatter_value сохраняет прежний контракт (single-key, None на ошибку/отсутствие, strip, регистр сохранён)"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  - id: TC-07
-    type: unit
-    description: "kill-switch frontmatter_validation_strict: False -> отсутствие полей не блокирует; True -> строгий режим сигнализирует невалидность"
-    module: tests/test_frontmatter.py
-    expected: PASS
-
-  # --- единый контракт вердиктов: чтение через общий API, семантика 1:1 (AC-3, AC-6) ---
-  - id: TC-08
-    type: unit
-    description: "check_reviewer_verdict через единый API: verdict: APPROVED -> (True); REQUEST_CHANGES -> (False); отсутствие -> (False) — как до задачи"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-09
-    type: unit
-    description: "_parse_tests_verdict через единый API: ORCH-047 три равноранговых поля (result/verdict/status), приоритет негативного токена (BLOCKED/FAILED) сохранён"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-10
-    type: unit
-    description: "_parse_deploy_status через единый API: deploy_status SUCCESS -> (True); FAILED -> (False); missing/bad YAML -> (False) — семантика БАГ-8 неизменна"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-11
-    type: unit
-    description: "_parse_staging_status через единый API: SUCCESS/FAILED семантика и условность ORCH-35 (non-self -> N/A pass) сохранены"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-12
-    type: unit
-    description: "parse_security_status через единый API: security_status PASS -> (True); FAIL -> (False) — семантика неизменна"
-    module: tests/test_security_gate.py
-    expected: PASS
-
-  # --- обратная совместимость / анти-регресс (AC-4) ---
-  - id: TC-13
-    type: unit
-    description: "Старый док-вердикт БЕЗ новой схемы (только verdict/result/deploy_status/staging_status/security_status) читается каждым из пяти гейтов как до задачи"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-14
-    type: unit
-    description: "Док С новой полной схемой + вердикт-ключом читается гейтом с тем же вердиктом, что и без схемы (схема аддитивна, не влияет на вердикт)"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  - id: TC-15
-    type: integration
-    description: "fallback worktree -> origin/main для check_deploy_status/check_staging_status сохранён при чтении через единый API"
-    module: tests/test_qg_verdicts.py
-    expected: PASS
-
-  # --- инварианты конвейера (AC-6) ---
-  - id: TC-16
-    type: unit
-    description: "Состав QG_CHECKS и STAGE_TRANSITIONS не изменён (тот же набор ключей/стадий, что эталон)"
-    module: tests/test_stages_invariants.py
-    expected: PASS
-
-  # --- полный регресс ---
-  - id: TC-17
-    type: integration
-    description: "Полный прогон tests/ зелёный (нет регресса существующих тестов гейтов и конвейера)"
-    module: tests/
-    expected: PASS

docs/work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md

@@ -1,248 +0,0 @@
-# ADR-001: Единый frontmatter-контракт (reader+writer+валидатор) и унификация чтения вердиктов
-
-Work Item: **ORCH-076** (ORCH-52c, слой 2 эпика ORCH-52) · Repo: **orchestrator** · Стадия: architecture
-Дата: 2026-06-09 · Статус: **Accepted**
-
-> Сквозная версия — [`docs/architecture/adr/adr-0020-frontmatter-contract.md`](../../../architecture/adr/adr-0020-frontmatter-contract.md).
-
----
-
-## Статус
-Accepted
-
-## Контекст
-
-(Подробно — `01-brd.md` §1, `02-trz.md`.) Слой 1 эпика (ORCH-075/52b) дал **описательный**
-стандарт `docs/_standards/PIPELINE_DOCS.md`. ORCH-52c — **машинный** слой. Установлено в коде
-на ветке задачи:
-
-- `src/frontmatter.py` = **только reader** (`read_frontmatter_value(path, key) -> str | None`,
-  never-raise → `None`). В docstring прямой коммент: *«merging into a single parser is a
-  follow-up task»* — это и есть данная задача.
-- **Парсинг YAML-frontmatter дублируется** в 5+ местах (~10 строк
-  `content.startswith("---")` → `split("---", 2)` → `yaml.safe_load` → `isinstance(dict)`):
-  `qg/checks.py::check_reviewer_verdict`, `_parse_tests_verdict`, `_parse_deploy_status`,
-  `_parse_staging_status`; `security_gate.py::parse_security_status`; плюс `_strip_frontmatter`
-  в `review_parse.py` и `security_gate.extract_security_findings`. Каждый — своя обработка
-  ошибок и свои reason-строки → риск рассинхрона.
-- **Нет машинно-проверяемой схемы** обязательного frontmatter и **нет формальной спеки
-  handoff** «что каждая стадия обязана оставить на выходе».
-
-**⚠️ Self-hosting (главное ограничение проектирования).** Затрагиваемый код читает вердикты
-**на гейтах** в инструменте, который прямо сейчас обслуживает прод (enduro-trails) из общего
-инстанса с общей БД/очередью. Любой регресс чтения вердикта = остановка конвейера ВСЕХ
-проектов. Рефакторинг обязан быть **строго обратно совместимым, never-raise, нулевая
-регрессия**. Плюс на задаче выставлен лейбл `autoDeploy` (ORCH-089) — это **первый боевой
-автодеплой** орка (детали риска — `10-tech-risks.md`).
-
-## Движущие силы (требования)
-
-BR-1…BR-5, NFR-1…NFR-5 (`01-brd.md`), FR-1…FR-6 (`02-trz.md`), AC-1…AC-7
-(`03-acceptance-criteria.md`). Ключевые инварианты-ограничители:
-
-- **INV-1** `STAGE_TRANSITIONS` и **состав** `QG_CHECKS` — не меняются (AC-6).
-- **INV-2** Семантика каждого вердикта (значение → переход/откат) — 1:1, включая 3-полевой
-  контракт tester'а (ORCH-047) и приоритет негативного токена (AC-6, FR-4).
-- **INV-3** Контракт `read_frontmatter_value` — неизменен (внешние вызыватели: `usage.py`,
-  `notifications.build_status_comment`) (FR-3).
-- **INV-4** Валидатор схемы **не hard-fail по умолчанию** — иначе ORCH-52c заблокировала бы
-  собственный деплой (её доки и доки соседей ещё без полной схемы) (NFR-3).
-- **INV-5** Никаких изменений API и схемы БД (TRZ §4–§5).
-
----
-
-## Решение
-
-### D1. `src/frontmatter.py` становится единым frontmatter-контрактом (1 модуль, функции)
-
-Выбран **набор функций в существующем leaf-модуле** (не класс, не новый пакет): модуль уже
-есть, не зависит ни от чего проектного (только `logging` + ленивый `yaml`), импортируем без
-циклов из `qg/checks.py`, `security_gate.py`, `post_deploy.py`, `review_parse.py`. Класс/состояние
-не нужны — операции чистые. Это минимизирует blast radius (требование self-hosting).
-
-**Публичный API (имена канонические; точные дефолты — в реализации, контракт фиксирован здесь):**
-
-```python
-# --- константы схемы ---
-REQUIRED_FIELDS = ("work_item", "stage", "author_agent", "status", "created_at", "model_used")
-
-# --- reader: СОХРАНЁН без изменения контракта (INV-3) ---
-def read_frontmatter_value(path: str, key: str) -> str | None: ...
-
-# --- единый парс-примитив (единственная точка YAML-логики) ---
-@dataclass(frozen=True)
-class FrontmatterParse:
-    data: dict          # {} если нет/битый/не-mapping
-    has_block: bool     # присутствовал ведущий ---…--- блок
-    malformed: bool     # был "---", но < 3 сегментов (незакрытый блок)
-    yaml_error: str | None  # текст ошибки yaml.safe_load, иначе None
-
-def parse_frontmatter(content: str) -> FrontmatterParse: ...   # never-raise
-def parse_frontmatter_dict(content: str) -> dict: ...          # ярлык → .data; never-raise → {}
-def read_frontmatter(path: str) -> dict: ...                   # файл → parse; never-raise → {}
-
-# --- writer ---
-def render_frontmatter(data: Mapping[str, object], body: str = "") -> str: ...
-    # → "---\n<yaml>\n---\n<body>"; формат совместим со split("---",2)+safe_load; never-raise → body
-def write_frontmatter(path: str, data: Mapping, body: str = "") -> bool: ...
-    # персист render_frontmatter; never-raise → False (ошибка логируется)
-
-# --- валидатор схемы ---
-@dataclass(frozen=True)
-class SchemaValidation:
-    valid: bool
-    missing: list[str]      # отсутствующие/пустые обязательные поля
-def validate_schema(data: Mapping, *, required=REQUIRED_FIELDS) -> SchemaValidation: ...  # never-raise
-
-# --- общий хелпер тела (заменяет дубли _strip_frontmatter) ---
-def strip_frontmatter(content: str) -> str: ...   # never-raise → content
-```
-
-**Контракт всего модуля — never-raise** (NFR-2), как у действующего reader: любая ошибка
-(I/O, YAML, сериализация) → `logger.debug/warning` + безопасное значение (`{}` / `False` /
-исходный текст), исключение наружу **не выходит**.
-
-`parse_frontmatter` возвращает **структуру** (а не голый dict), чтобы каждый гейт мог
-**воспроизвести свои текущие reason-строки 1:1** (см. D2) — это и есть способ сохранить
-семантику без переписывания сообщений (INV-2).
-
-### D2. Унифицируется МЕХАНИЗМ парсинга, а НЕ семантика вердиктов
-
-AC-3/FR-4 требуют «читать через единый frontmatter-API, а не дублированной ad-hoc логикой».
-Унифицируется **ровно повторяющийся блок** `startswith/split/safe_load/isinstance` →
-замена на `parse_frontmatter(content)`. **Token-логика, upper-casing, набор полей, приоритет
-негативного токена, fallback `worktree → origin/main` — остаются в каждом гейте без изменений.**
-Это сознательное ограничение объёма унификации: общий «умный» verdict-резолвер увеличил бы
-риск тонкого регресса на гейтах (недопустимо при self-hosting). Каждый `check_*`/`_parse_*`
-сохраняет сигнатуру и `tuple[bool, str]`.
-
-Маппинг состояний `FrontmatterParse` → существующие reason-строки (пример для tester'а,
-остальные аналогично):
-
-| Состояние | Прежняя ветка | Сохраняемая reason-строка |
-|-----------|---------------|---------------------------|
-| `not has_block` | `not content.startswith("---")` | "No YAML frontmatter in test report …" |
-| `malformed` | `len(parts) < 3` | "Malformed YAML frontmatter in test report" |
-| `yaml_error` | `except yaml.YAMLError` | "Invalid YAML frontmatter in test report: {e}" |
-| `data` (dict) | `fm.get(...)` | прежняя token-логика поверх `parse.data` |
-
-Точки перевода (FR-4):
-
-| Парсер | Файл | Поле(я) | Семантика — НЕ менять |
-|--------|------|---------|----------------------|
-| `check_reviewer_verdict` | `12-review.md` | `verdict:` | APPROVED→дальше; REQUEST_CHANGES→откат |
-| `_parse_tests_verdict` | `13-test-report.md` | `result:`/`verdict:`/`status:` (3 равноранг., ORCH-047) | PASS→дальше; FAIL/BLOCKED→откат; негативный токен авторитетен |
-| `_parse_deploy_status` | `14-deploy-log.md` | `deploy_status:` | SUCCESS→done; FAILED→откат (БАГ-8) |
-| `_parse_staging_status` | `15-staging-log.md` | `staging_status:` | SUCCESS→дальше; FAILED→откат (self-hosting) |
-| `parse_security_status` | `17-security-report.md` | `security_status:` | PASS→дальше; FAIL→откат (FAIL авторитетен) |
-
-`post_deploy.py` (`post_deploy_status:`, информационный) и `review_parse._strip_frontmatter`/
-`security_gate.extract_security_findings` (извлечение прозы) переводятся на
-`parse_frontmatter_dict` / `strip_frontmatter` соответственно — снимает оставшиеся дубли без
-изменения их «never-raise → пусто» контрактов.
-
-### D3. Валидатор: библиотека + warning-only, hard-fail строго под kill-switch
-
-`validate_schema` — **чистая библиотечная функция** (INV-4, NFR-3). Чтобы гарантировать
-**нулевую регрессию гейтов**, в default-режиме валидатор **не участвует в вычислении
-boolean-вердикта** ни одного гейта. Вместо этого:
-
-- Новый флаг `config.frontmatter_validation_strict: bool = False`
-  (env `ORCH_FRONTMATTER_VALIDATION_STRICT`).
-- **Default (`False`):** опциональный warning-emit — при чтении machine-verdict дока, не
-  несущего полной схемы, единый хелпер `maybe_warn_schema(content, doc_label)` пишет
-  `logger.warning("frontmatter schema incomplete: missing …")` и **возвращает управление без
-  влияния на вердикт** (чистый no-op для `tuple[bool,str]`). Это удовлетворяет «по умолчанию
-  warning/лог» (FR-2), оставаясь поведенчески инертным.
-- **Strict (`True`):** зарезервированный режим будущего ужесточения (ORCH-52d+). Когда
-  включён, тот же хелпер может вернуть гейту вето. На ORCH-52c флаг **остаётся `False`** в
-  проде и в `.env.staging` — иначе задача self-block'нется (её доки без полной схемы). Strict
-  покрывается unit-тестом, но не включается.
-
-Решение «валидатор вне вердикт-пути по умолчанию» — осознанный выбор в пользу безопасности
-self-hosting: машинная проверка схемы **существует и тестируется**, но **физически не может**
-завалить гейт при дефолте.
-
-### D4. Формальная спека handoff — `docs/_standards/HANDOFF_PROTOCOL.md`
-
-Создаётся (на стадии development, как doc-deliverable) рядом с `PIPELINE_DOCS.md`. Структура
-(нормативно для разработчика):
-
-1. **Назначение + статус истины** — «источник истины поведения = код (`stages.py`,
-   `qg/checks.py`, `stage_engine.py`); спека документирует» (правило ORCH-075).
-2. **Обязательная frontmatter-схема** — таблица 6 полей (`work_item`, `stage`, `author_agent`,
-   `status`, `created_at`, `model_used`) + смысл каждого; ссылка на `frontmatter.REQUIRED_FIELDS`
-   как на машинный источник.
-3. **Контракт handoff по стадиям** — для каждой стадии (`created`→…→`done`): какие документы
-   **обязан** оставить выход стадии и какие frontmatter-ключи (machine-verdict ключ + будущая
-   общая схема). **Согласовано 1:1 с `PIPELINE_DOCS.md` §2–§3** (тот же набор
-   документов/ключей/гейтов; различие machine-verdict vs информационные сохранено).
-4. **Перекрёстная ссылка** на единый API `src/frontmatter.py` и на флаг
-   `frontmatter_validation_strict`.
-
-`PIPELINE_DOCS.md` обновляется: блок «слой 1 описательный → ORCH-52c реализовала машинный
-контракт» + ссылка на `HANDOFF_PROTOCOL.md` и на `src/frontmatter.py` (закрывает явную метку
-«машинная проверка — отдельная задача ORCH-52c» в §5).
-
-### D5. Без изменений API/БД/состава гейтов
-
-Подтверждено INV-1/INV-5: HTTP-эндпоинты, `STAGE_TRANSITIONS`, реестр `QG_CHECKS`, схема БД —
-не трогаются. Опциональный счётчик валидации в `GET /queue` — **не вводим** (TRZ §4: не
-требование; добавил бы поверхность без нужды).
-
----
-
-## Альтернативы (отклонены)
-
-- **A1. Общий «умный» verdict-резолвер** (одна функция читает поле+токены для всех 5 гейтов).
-  Отклонено: token-наборы и правила различаются (особенно ORCH-047 3-поля + приоритет
-  негатива); единая абстракция повысила бы риск тонкого регресса на гейте → недопустимо при
-  self-hosting. Унифицируем только парс YAML (D2).
-- **A2. Класс `Frontmatter`/новый пакет.** Отклонено: состояния нет, операции чистые; класс —
-  лишняя церемония и больший blast radius. Функции в существующем leaf-модуле проще и
-  безопаснее.
-- **A3. Валидатор как hard-fail на гейте по умолчанию.** Отклонено прямо BRD/NFR-3: заблокирует
-  собственный деплой ORCH-52c. Default — warning-only, hard-fail под флагом (D3).
-- **A4. Сторонняя библиотека `python-frontmatter`.** Отклонено: новая зависимость ради ~30
-  строк; `pyyaml` уже в проекте, формат тривиален, контроль над never-raise важнее.
-- **A5. Ретро-фит схемы в существующие доки / правка промптов агентов.** Вне scope (это
-  ORCH-52d, слой 3). Схема аддитивна и forward-looking.
-
----
-
-## Последствия
-
-**Плюсы**
-- Единственная точка YAML-парсинга → конец рассинхрона обработки ошибок между гейтами.
-- Writer + валидатор + полная схема готовы к ORCH-52d (агенты начнут эмитить схему).
-- Спека handoff закрывает пробел «что стадия обязана оставить», согласована с манифестом.
-- Нулевая поведенческая регрессия по построению: семантика и reason-строки 1:1, валидатор вне
-  вердикт-пути при дефолте, never-raise сохранён.
-
-**Минусы / ограничения**
-- Унификация частичная (только парс, не семантика) — token-логика всё ещё живёт в каждом
-  гейте. Это сознательный компромисс безопасности; полная унификация семантики — возможная
-  будущая задача с отдельным риск-бюджетом.
-- Strict-режим валидатора пока «спящий» (тестируется, но не включён) — реальная польза от
-  enforcement появится только с ORCH-52d.
-- Reason-строки нужно перенести **дословно** — за этим следит reviewer и анти-регресс-тесты.
-
-**Обратимость**
-- `frontmatter_validation_strict=False` (дефолт) ⇒ поведение эквивалентно прежнему.
-- Перевод гейтов на `parse_frontmatter` поведенчески инвариантен; откат — точечный возврат
-  inline-блока (но не требуется при зелёном регрессе).
-
-**Тестирование (обязательно перед мержем)**
-- `tests/test_frontmatter.py` (новый): reader (контракт неизменен), writer (round-trip
-  `render → parse`), валидатор (полный/неполный набор, strict on/off), битый ввод → never-raise.
-- Анти-регресс на каждый из 5 гейтов: старый док-вердикт **без** новой схемы → тот же
-  `tuple[bool,str]`, что до задачи (NFR-1/AC-4); negative-token-приоритет tester'а (ORCH-047).
-- Полный `pytest tests/ -q` зелёный.
-
-## Связи
-- Реализует: BR-1…BR-5, FR-1…FR-6, AC-1…AC-7.
-- Опирается на: ORCH-075/52b (`PIPELINE_DOCS.md`, манифест), ORCH-016 (`frontmatter.py` reader),
-  ORCH-047 (3-полевой tester-вердикт), ORCH-022 (security-гейт), ORCH-089 (`autoDeploy`).
-- Готовит почву: ORCH-52d (агенты эмитят полную схему; возможное включение strict).
-- Сквозной ADR: `docs/architecture/adr/adr-0020-frontmatter-contract.md`.
-- Риски/инфра/данные: `10-tech-risks.md`, `07-infra-requirements.md`, `08-data-requirements.md`.

docs/work-items/ORCH-076/07-infra-requirements.md

@@ -1,50 +0,0 @@
-# 07 — Требования к инфраструктуре: ORCH-076 (ORCH-52c)
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: architecture
-
-## Сводка
-
-ORCH-52c — чисто кодово-документная задача (frontmatter-контракт + спека handoff). **Топология
-инфраструктуры не меняется**: ни контейнеров, ни портов, ни volume, ни сети, ни CI-workflow.
-Деплой — штатным путём конвейера через staging (8501) → прод (8500). Раздел существует для
-фиксации двух операционных предусловий и одного конфиг-флага.
-
-## Изменения инфраструктуры
-
-- **Нет.** Compose-сервисы, порты (8500/8501), volume (`./data`, `./data/staging`), Gitea
-  Actions — без изменений.
-- БД/миграции — нет (см. `08-data-requirements.md`).
-- HTTP API — нет новых/изменённых эндпоинтов.
-
-## Конфигурация (env)
-
-| Ключ | Значение по умолчанию | Где | Назначение |
-|------|----------------------|-----|------------|
-| `ORCH_FRONTMATTER_VALIDATION_STRICT` | `false` | `.env` / `.env.staging` | Kill-switch строгой валидации схемы frontmatter. **На ORCH-52c держать `false`** (иначе self-block: доки ещё без полной схемы). Включается не раньше ORCH-52d. |
-
-> Флаг **аддитивный**; его отсутствие в окружении эквивалентно `false` (pydantic-дефолт
-> `frontmatter_validation_strict: bool = False`). Явная установка не требуется на этой задаче;
-> строка в `.env.example` добавляется документации ради.
-
-## Операционные предусловия
-
-### П-1. Лейбл `autoDeploy` (первый боевой автодеплой — ORCH-089)
-На задаче выставлен лейбл `autoDeploy`: после зелёного staging и всех тех-гейтов орк **сам**
-подтверждает прод-деплой (Фаза B ORCH-036/059), без ручного «Confirm Deploy».
-- Предусловие: лейбл `autoDeploy` существует в Plane-проекте ORCH и проставлен на ORCH-076
-  (инфра-предусловие ORCH-089). Его отсутствие = fail-safe → ручной гейт (деплой не сорвётся,
-  просто потребует ручного «Confirm Deploy»).
-- BRD-гейт остаётся **ручным** (Слава подтверждает BRD) — `autoApprove` НЕ выставлен.
-- Наблюдение: стадия `deploy` орка должна пройти через зелёные под-гейты ребра
-  `deploy-staging → deploy` (security → merge-gate → image-freshness → staging) до Фазы B —
-  `autoDeploy` физически не деплоит сломанное (BR-5 ORCH-089). Детали реакции на сбой —
-  `10-tech-risks.md` (R-3).
-
-### П-2. Self-hosting рестарт-дисциплина
-Прод-контейнер `orchestrator` (8500) — общий для всех проектов. Деплой ORCH-52c проходит через
-штатный detached host-хук (ORCH-036), **не** ручным `docker compose`. Ручной рестарт прод-
-контейнера в рамках задачи **запрещён** (встанет конвейер enduro). Откат — `orchestrator-deploy-hook.sh --rollback` (стандартный путь), не предмет этой задачи.
-
-## Вне инфра-объёма
-- Изменения промптов агентов, ретро-фит схемы в старые доки — ORCH-52d.
-- Любые новые сервисы/демоны/cron — не вводятся.

docs/work-items/ORCH-076/08-data-requirements.md

@@ -1,34 +0,0 @@
-# 08 — Требования к данным / схеме БД: ORCH-076 (ORCH-52c)
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: architecture
-
-## Сводка
-
-**Изменений схемы БД нет.** Контракт frontmatter работает исключительно на **файлах**
-(YAML-frontmatter номерных документов `docs/work-items/<id>/*.md`) и **in-memory** строках.
-SQLite (`src/db.py`) — таблицы, индексы, миграции — **не затрагиваются** (TRZ §5).
-
-## Детали
-
-| Аспект | Состояние |
-|--------|-----------|
-| Новые таблицы | нет |
-| Изменённые таблицы / колонки | нет |
-| Индексы | нет |
-| Миграции | нет (restart-safe без миграции) |
-| Persistent state | нет (writer пишет в файлы доков, не в БД) |
-
-## Модель данных контракта (файлы, не БД)
-
-- **Обязательная frontmatter-схема** (машинный источник — `frontmatter.REQUIRED_FIELDS`):
-  `work_item`, `stage`, `author_agent`, `status`, `created_at`, `model_used`. Это контракт
-  **документа**, не строки БД. Фактическое проставление полей агентами — ORCH-52d (вне scope).
-- **Вердикт-ключи** (читаются единым API, семантика 1:1): `verdict:` (12), `result:`/`verdict:`/
-  `status:` (13, ORCH-047), `deploy_status:` (14), `staging_status:` (15), `security_status:`
-  (17), `post_deploy_status:` (16, информационный). Формат — ведущий YAML-блок `---…---`.
-
-## Совместимость данных
-- Старые документы-вердикты **без** новой схемы остаются валидными (схема аддитивна; её
-  отсутствие не влияет на чтение вердикта — NFR-1).
-- Формат writer'а (`render_frontmatter`) совместим с существующим
-  `split("---", 2)` + `yaml.safe_load` — старые и новые парсеры читают единообразно.

docs/work-items/ORCH-076/10-tech-risks.md

@@ -1,25 +0,0 @@
-# 10 — Технические риски: ORCH-076 (ORCH-52c)
-
-Work Item: **ORCH-076** · Repo: **orchestrator** · Стадия: architecture
-
-Информационный документ (гейтом не парсится). Источник истины по решениям — `06-adr/ADR-001`.
-
-| ID | Риск | Вероятн. | Влияние | Митигация | Остаточно |
-|----|------|----------|---------|-----------|-----------|
-| **R-1** | **Регресс чтения вердикта на гейте** (review/testing/staging/deploy/security) при переводе на единый `parse_frontmatter` → ложный откат/застревание → **остановка конвейера ВСЕХ проектов** (главный self-hosting риск). | средняя | критическое | Унифицируется только парс YAML, НЕ семантика (ADR D2); сигнатуры/`tuple[bool,str]`/токены/upper-case/fallback `worktree→origin/main` 1:1; reason-строки переносятся дословно через `FrontmatterParse`-состояния; **анти-регресс-тест на каждый из 5 гейтов** (старый док → тот же вердикт) + полный `pytest tests/` зелёный до мержа (AC-4/AC-6). | низкое |
-| **R-2** | **Самоблокировка валидатором** на собственном деплое: доки ORCH-52c (и соседей) ещё без полной 6-польной схемы → strict-валидатор завалил бы гейт. | высокая (если включить strict) | высокое | `frontmatter_validation_strict` дефолт `False`; валидатор в default-режиме **вне вердикт-пути** гейтов (warning-only, чистый no-op для boolean); strict тестируется, но НЕ включается до ORCH-52d; `false` в `.env`/`.env.staging` (NFR-3, ADR D3). | очень низкое |
-| **R-3** | **Первый боевой `autoDeploy`** (ORCH-089): орк сам подтверждает прод-рестарт после staging → если регресс R-1 проскользнул мимо тестов, автодеплой выкатит его без человеческой паузы. | низкая | высокое | `autoDeploy` достигает Фазы B только после зелёных под-гейтов ребра `deploy-staging→deploy` (security→merge-gate→image-freshness→staging) — не деплоит сломанное (BR-5 ORCH-089); обязательная страховка staging (8501); пост-деплой мониторинг ORCH-021 (`ALERT_ONLY` для self) ловит «зелёный деплой, красный прод» с откатом durable-freeze (ORCH-088); ручной BRD-гейт сохранён. Наблюдать стадию `deploy` вживую (Telegram-карточка). | низкое |
-| **R-4** | **Дрейф reason-строк / сообщений гейтов** при рефакторе → тесты, ассертящие текст, краснеют; логи/Plane-комменты меняют формулировку. | средняя | низкое | Маппинг `FrontmatterParse → прежняя reason-строка` зафиксирован в ADR D2; переносить дословно; ассерты в анти-регресс-тестах фиксируют текущий текст. | низкое |
-| **R-5** | **Расхождение спеки handoff с фактом кода** → «лживый» стандарт. | средняя | среднее | `HANDOFF_PROTOCOL.md` согласован 1:1 с `PIPELINE_DOCS.md` §2–§3 (тот же набор документов/ключей/гейтов); явная пометка «источник истины — код» (правило ORCH-075); reviewer сверяет (CLAUDE.md №2/№6). | низкое |
-| **R-6** | **Скрытое исключение из writer/валидатора** прорывается в конвейер (нарушение never-raise) на битом вводе. | низкая | высокое | Контракт всего модуля never-raise (как действующий reader): любая ошибка → лог + безопасное значение; **тест на битом вводе** (невалидный YAML, не-mapping, I/O-ошибка) подтверждает отсутствие проброса (AC-5/NFR-2). | очень низкое |
-| **R-7** | **Циклический импорт** при использовании `frontmatter` из `qg/checks.py`/`security_gate.py`/`post_deploy.py`/`review_parse.py`. | низкая | среднее | `frontmatter.py` — leaf без проектных зависимостей (только `logging` + ленивый `yaml`); импортируется, не импортирует проектные модули — циклов нет. | очень низкое |
-| **R-8** | **Частичная унификация** (token-логика осталась в каждом гейте) воспринимается reviewer'ом как недовыполнение AC-3. | низкая | низкое | AC-3 требует «парсить YAML через единый API, а не дублированной логикой» — выполнено (D2); неунификация семантики — осознанный выбор безопасности, зафиксирован в ADR (альтернатива A1 отклонена). | очень низкое |
-
-## Сводные митигации (обязательные перед мержем)
-1. Анти-регресс-тест на каждый из 5 вердикт-гейтов (старый док без схемы → прежний вердикт).
-2. `tests/test_frontmatter.py`: reader (контракт неизменен) / writer (round-trip) / валидатор
-   (полный/неполный, strict on/off) / битый ввод → never-raise.
-3. Полный `pytest tests/ -q` зелёный.
-4. `frontmatter_validation_strict=False` в прод/staging env.
-5. Живое наблюдение стадии `deploy` (первый `autoDeploy`); готовность к
-   `orchestrator-deploy-hook.sh --rollback` штатным путём (не ручной рестарт).

docs/work-items/ORCH-076/12-review.md

@@ -1,93 +0,0 @@
----
-type: review
-work_item_id: ORCH-076
-verdict: APPROVED
-version: 1
----
-
-# Review ORCH-076 — ORCH-52c: единый frontmatter-контракт + спека handoff
-
-## Summary
-
-Изменение реализует слой 2 эпика ORCH-52: `src/frontmatter.py` превращён из single-key
-reader'а в полный машинный контракт (reader + writer + валидатор схемы + единый парс-примитив),
-а дублированное чтение YAML-frontmatter в пяти вердикт-парсерах сведено к одной точке
-(`parse_frontmatter`). Дополнительно создана формальная спека handoff
-(`docs/_standards/HANDOFF_PROTOCOL.md`).
-
-Реализация **полностью соответствует ТЗ и ADR-001/adr-0020**: унифицирован только МЕХАНИЗМ
-парсинга (D2), семантика вердиктов, token-логика, приоритет негативного токена, fallback
-`worktree→origin/main` и трёх-полевой контракт tester (ORCH-047) сохранены 1:1. Валидатор
-warning-only по умолчанию, hard-fail только под kill-switch `frontmatter_validation_strict`
-(дефолт `False`) — критично для self-hosting (задача не self-block'ится). Весь модуль
-never-raise. `STAGE_TRANSITIONS` и состав `QG_CHECKS` не тронуты (подтверждено TC-16).
-
-Проверка по осям:
-- **Соответствие ТЗ:** FR-1…FR-6 реализованы (writer, валидатор, полночтение, единый контракт
-  вердиктов, BC старых доков, спека handoff). API/БД не тронуты (TRZ §4–§5). ✓
-- **Соответствие AC:** AC-1…AC-7 выполнены (см. ниже). ✓
-- **Соответствие ADR:** D1–D5 реализованы как спроектировано (функции в leaf-модуле,
-  unify-механизм-не-семантику, warning-only validator, спека handoff, без API/БД). ✓
-- **Качество кода:** docstrings на всех публичных функциях; never-raise контракт выдержан
-  (broad-except + лог + безопасный возврат); leaf-модуль без проектных импортов (cycle-free).
-- **Тесты:** содержательные, покрывают writer/round-trip/валидатор/strict/never-raise/reader
-  (`test_frontmatter.py`), семантику пяти гейтов + BC + origin/main fallback
-  (`test_qg_verdicts.py`), security-гейт (`test_security_gate.py`), инварианты реестра
-  (`test_stages_invariants.py`). Полный регресс **1212 passed**.
-
-Проверка AC:
-- **AC-1** (reader+writer+валидатор, unit-tested): ✓ `read_frontmatter_value` (BC),
-  `render/write_frontmatter`, `validate_schema` с 6 полями `REQUIRED_FIELDS`; TC-01…TC-07.
-- **AC-2** (спека handoff в `docs/_standards/`, согласована): ✓ покрывает все стадии
-  `created`→`done`, набор документов/ключей/гейтов 1:1 с `PIPELINE_DOCS.md` §2–§3;
-  `PIPELINE_DOCS.md` обновлён ссылкой + отметкой реализации (§5–§6).
-- **AC-3** (единый контракт вердиктов): ✓ все 5 (`check_reviewer_verdict`,
-  `_parse_tests_verdict`, `_parse_deploy_status`, `_parse_staging_status`,
-  `parse_security_status`) делегируют `parse_frontmatter`; ad-hoc блоки удалены.
-- **AC-4** (BC старых доков + регресс зелёный): ✓ TC-13/TC-14 для старых доков без схемы;
-  1212 tests green.
-- **AC-5** (never-raise + warning-only + kill-switch): ✓ TC-05 (битый ввод), `maybe_warn_schema`
-  инертен при дефолте, `frontmatter_validation_strict` в `config.py`.
-- **AC-6** (`STAGE_TRANSITIONS`/`QG_CHECKS` неизменны, семантика 1:1): ✓ TC-16; вердикт-логика
-  не тронута.
-- **AC-7** (документация): ✓ см. раздел «Документация».
-
-## Findings
-
-### P0 — Blocker
-- Нет.
-
-### P1 — Must fix
-- Нет.
-
-### P2 — Should fix
-- Нет.
-
-### P3 — Nice-to-have
-- [ ] `_parse_tests_verdict` (`src/qg/checks.py`): для редкого случая «валидный YAML, но не
-  mapping» во frontmatter старая ветка возвращала reason `"Malformed YAML frontmatter in test
-  report (not a mapping)"`, новая реализация маршрутизирует этот ввод в путь пустых данных →
-  reason `"No machine-readable verdict/status/result in test report frontmatter"`.
-  **Boolean-вердикт идентичен (`False` в обоих случаях) → семантика и STAGE_TRANSITIONS не
-  затронуты (AC-6 соблюдён).** Расхождение только в reason-строке (лог/коммент). ADR D2 заявляет
-  «reason-строки 1:1» — здесь незначительное отклонение в крайне редком кейсе. Можно при желании
-  добавить явную ветку для паритета, но это не обязательно.
-- [ ] `parse_security_status` (`src/security_gate.py`) не вызывает `maybe_warn_schema`, тогда как
-  4 из 5 вердикт-парсеров его вызывают. Поскольку warning инертен (не влияет на вердикт), это
-  чисто косметическая несогласованность наблюдаемости. Для единообразия можно добавить вызов.
-
-## Документация
-
-Обновлено в том же PR (golden source синхронен с кодом, правило CLAUDE.md №2/№6):
-- `CLAUDE.md` — блок про единый frontmatter-контракт в «Конвенциях».
-- `docs/architecture/README.md` — «Канон гейтов» (единый контракт), компонент frontmatter,
-  ссылки на спеку handoff и adr-0020.
-- `docs/_standards/HANDOFF_PROTOCOL.md` — **создан** (спека handoff, все стадии, обязательная
-  схема `REQUIRED_FIELDS`).
-- `docs/_standards/PIPELINE_DOCS.md` — обновлён (слой 2 реализован, §5–§6 + ссылки).
-- `CHANGELOG.md` — детальная запись `[Unreleased]`.
-- ADR: per-work-item `docs/work-items/ORCH-076/06-adr/ADR-001-frontmatter-contract.md` +
-  сквозной `docs/architecture/adr/adr-0020-frontmatter-contract.md`; индекс
-  `docs/architecture/adr/README.md` обновлён (adr-0018/0019/0020, max=0020).
-
-Документация полная и согласованная — претензий нет.

docs/work-items/ORCH-076/13-test-report.md

@@ -1,85 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-076
-result: PASS
----
-
-# Test Report — ORCH-076
-
-ORCH-52c: протокол handoff + единый frontmatter-контракт (writer/валидатор/схема).
-
-## Окружение
-- Python: 3.12.13
-- pytest: 8.3.3
-- Ветка: `feature/ORCH-076-orch-52c-handoff-frontmatter-w`
-- Worktree: `/repos/_wt/orchestrator/feature_ORCH-076-orch-52c-handoff-frontmatter-w`
-- Дата: 2026-06-09
-
-## Предусловия
-- Review-вердикт `12-review.md`: **APPROVED** (P0/P1/P2 — нет; два P3 nice-to-have, не блокирующие).
-- Prod health (8500): `{"status":"ok","service":"orchestrator"}` — конвейер прочих проектов не тронут.
-
-## Smoke test API (prod 8500, read-only)
-| Endpoint | Результат |
-|----------|-----------|
-| `GET /health` | PASS — `{"status":"ok","service":"orchestrator"}` |
-| `GET /status` | PASS — задача ORCH-076 видна на стадии `testing` (id 69) |
-| `GET /queue` | PASS — counts/reconcile/reaper/post_deploy/merge_verify в норме (done=897, failed=4) |
-
-## Результаты по тест-плану (04-test-plan.yaml)
-
-| TC ID | Описание | Модуль | Результат |
-|-------|----------|--------|-----------|
-| TC-01 | Writer сериализует mapping в каноничный YAML-frontmatter | tests/test_frontmatter.py | PASS |
-| TC-02 | Round-trip writer → read_frontmatter_value | tests/test_frontmatter.py | PASS |
-| TC-03 | Валидатор: полная схема → valid=True | tests/test_frontmatter.py | PASS |
-| TC-04 | Валидатор: неполная схема → valid=False, без исключения | tests/test_frontmatter.py | PASS |
-| TC-05 | never-raise: writer/валидатор на битом вводе | tests/test_frontmatter.py | PASS |
-| TC-06 | reader read_frontmatter_value: прежний контракт (BC) | tests/test_frontmatter.py | PASS |
-| TC-07 | kill-switch frontmatter_validation_strict (False/True) | tests/test_frontmatter.py | PASS |
-| TC-08 | check_reviewer_verdict через единый API (APPROVED/REQUEST_CHANGES/missing) | tests/test_qg_verdicts.py | PASS |
-| TC-09 | _parse_tests_verdict: ORCH-047 3 поля + приоритет негативного токена | tests/test_qg_verdicts.py | PASS |
-| TC-10 | _parse_deploy_status: SUCCESS/FAILED/missing (БАГ-8 1:1) | tests/test_qg_verdicts.py | PASS |
-| TC-11 | _parse_staging_status: SUCCESS/FAILED + условность ORCH-35 | tests/test_qg_verdicts.py | PASS |
-| TC-12 | parse_security_status: PASS/FAIL семантика 1:1 | tests/test_security_gate.py | PASS |
-| TC-13 | Старый док-вердикт без новой схемы читается всеми 5 гейтами | tests/test_qg_verdicts.py | PASS |
-| TC-14 | Док с полной схемой + вердикт-ключом — тот же вердикт (схема аддитивна) | tests/test_qg_verdicts.py | PASS |
-| TC-15 | fallback worktree → origin/main сохранён через единый API | tests/test_qg_verdicts.py | PASS |
-| TC-16 | Состав QG_CHECKS и STAGE_TRANSITIONS не изменён | tests/test_stages_invariants.py | PASS |
-| TC-17 | Полный прогон tests/ зелёный (анти-регресс) | tests/ | PASS |
-
-Все 17 тест-кейсов плана покрыты и зелёные. TC-таргетные модули
-(`test_frontmatter.py`, `test_qg_verdicts.py`, `test_security_gate.py`,
-`test_stages_invariants.py`) — **49 passed**.
-
-## Покрытие критериев приёмки (03-acceptance-criteria.md)
-| AC | Подтверждено | Результат |
-|----|--------------|-----------|
-| AC-1 reader+writer+валидатор, unit-tested | TC-01…TC-07 | PASS |
-| AC-2 спека handoff в docs/_standards/ согласована | (review/doc-check) | PASS |
-| AC-3 единый контракт вердиктов (5 точек) | TC-08…TC-12 | PASS |
-| AC-4 BC старых доков + регресс зелёный + самопрохождение | TC-13/TC-14 + полный регресс + задача на testing | PASS |
-| AC-5 never-raise + warning-only + kill-switch | TC-05/TC-07 | PASS |
-| AC-6 STAGE_TRANSITIONS/QG_CHECKS неизменны | TC-16 | PASS |
-| AC-7 документация обновлена | review «Документация» | PASS |
-
-## Вывод pytest
-
-Полный регресс:
-```
-1212 passed, 1 warning in 34.97s
-```
-
-TC-таргетные модули:
-```
-49 passed, 1 warning in 0.44s
-```
-
-Единственное предупреждение — `PydanticDeprecatedSince20` (class-based config в
-`src/config.py`), предсуществующее, не связано с ORCH-076, не влияет на результат.
-Сетевых зависимостей в тестах нет (frontmatter — файловый/in-memory контракт).
-
-## Итог
-**PASS** — полный регресс зелёный (1212 passed), все 17 TC плана PASS, smoke API OK,
-prod-контейнер не тронут. Регрессий гейтов (review/tester/deploy/staging/security) нет,
-семантика вердиктов 1:1. Задача готова к переходу на `deploy-staging`.

docs/work-items/ORCH-076/15-staging-log.md

@@ -1,42 +0,0 @@
----
-staging_status: SUCCESS
-timestamp: 2026-06-09T11:13:04Z
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-Staging test suite completed against the live `orchestrator-staging` instance (8501).
-Run canonically **inside** the `orchestrator-staging` container (ORCH-048 / ADR-001) via the
-Docker Engine API `exec` (equivalent to `docker exec`; the host `docker` CLI was unavailable,
-but the script still executed in-container so B6 reads the instance's own `.env.staging`
-process-env — no false registry FAIL).
-
-Command:
-```
-python3 /repos/orchestrator/scripts/staging_check.py --base-url http://localhost:8501 --mode stub
-```
-
-## Result
-
-```
-RESULT: 8/10 checks PASS
-REAL failed         : none
-SANDBOX_INFRA failed: ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue']
-tolerance: staging_infra_tolerance_enabled=True
-```
-
-INFRA-WAIVED: C9a Branch appears in orchestrator-sandbox, C9b Analyst job enqueued in staging queue (known sandbox-infra; real checks green)
-
-VERDICT: SUCCESS (exit 0) — SUCCESS (infra-waived): ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue'] are known sandbox-infra checks; all real checks green
-
-## Notes
-
-- **Exit code: 0** → `staging_status: SUCCESS` (trusting the exit code per ORCH-061; waived
-  checks are not re-judged).
-- All REAL pipeline checks passed: A1/A2/A3 (smoke), B4/B5/B6 (access + registry isolation),
-  C7/C8 (E2E issue create + webhook trigger).
-- The only failures are the two SANDBOX_INFRA checks **C9a/C9b**, which depend on SANDBOX bot
-  accounts being members of the sandbox Plane project — an infra precondition, not a pipeline
-  regression. They are tolerated (`ORCH_STAGING_INFRA_TOLERANCE_ENABLED=true`) while every REAL
-  check is green; the script printed the `INFRA-WAIVED:` / `VERDICT:` lines above and exited 0.

docs/work-items/ORCH-080/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-52g: убрать Telegram link-preview (логотип Plane) в уведомлениях трекера
-
-Work Item ID: ORCH-080
-
-## Description
-
-TBD

docs/work-items/ORCH-080/01-brd.md

@@ -1,73 +0,0 @@
-# 01-BRD — ORCH-080: убрать Telegram link-preview (логотип Plane) в уведомлениях трекера
-
-Work Item ID: ORCH-080
-Эпик: ORCH-052 (под-задача ORCH-52g)
-Тип: Доработка (UX уведомлений)
-Приоритет: LOW (косметика)
-Зона: `src/notifications.py`
-
-## 1. Контекст и проблема
-
-Каждая задача в Telegram сопровождается одной live-карточкой трекера (`src/notifications.py`,
-ORCH-042/066/067). С ORCH-067 в карточке появился **кликабельный номер задачи** —
-`<a href="https://plane.mva154.duckdns.org/.../issues/<id>/">ORCH-NNN</a>`.
-
-Telegram по умолчанию разворачивает **link-preview** (web page preview) для первой ссылки
-в сообщении. Из-за ссылки на Plane под каждым сообщением трекера раскрывается крупный
-баннер-превью **«Plane — Modern project management»**.
-
-**Жалоба (Слава, 08.06):** баннер уродует ленту чата и дублируется на каждой задаче/каждом
-обновлении карточки (особенно заметно в дефолтном режиме `bump`, где карточка пересоздаётся
-на каждом переходе).
-
-## 2. Диагностика (код-аудит `src/notifications.py`)
-
-| Функция | Эндпоинт | Текущий JSON-payload | Превью |
-|---------|----------|----------------------|--------|
-| `send_telegram()` (стр. 52-62) | `POST /sendMessage` | `chat_id`, `text`, `parse_mode: HTML`, `disable_notification` | **разворачивается** (нет `disable_web_page_preview`) |
-| `edit_telegram()` (стр. 165-174) | `POST /editMessageText` | `chat_id`, `message_id`, `text`, `parse_mode: HTML` | **разворачивается** (нет `disable_web_page_preview`) |
-
-Причина баннера: оба payload **не содержат** ключ `disable_web_page_preview`. Telegram Bot API
-по умолчанию (отсутствие ключа) включает превью.
-
-`delete_telegram()` (`/deleteMessage`) превью не порождает — правки не требует.
-
-## 3. Бизнес-цель
-
-Карточка трекера и уведомления в Telegram **не должны** показывать баннер link-preview Plane,
-при этом ссылка на задачу **остаётся кликабельной**.
-
-## 4. Бизнес-требования
-
-- **BR-1.** В payload `sendMessage` (`send_telegram`) присутствует `disable_web_page_preview: True`.
-- **BR-2.** В payload `editMessageText` (`edit_telegram`) присутствует `disable_web_page_preview: True`.
-- **BR-3.** Баннер-превью Plane больше не появляется ни под карточкой трекера (оба режима
-  `bump`/`edit`), ни под отдельными notify-сообщениями, которые идут через `send_telegram`
-  (`notify_approve_requested`, `notify_error`, alert'ы стадий) — все они используют тот же
-  низкоуровневый примитив.
-- **BR-4.** Кликабельная ссылка `<a href>` на задачу в Plane сохраняется (`parse_mode: HTML`
-  не меняется).
-- **BR-5.** Контракт **never-raise** сохранён: отправка/редактирование никогда не валит
-  оркестратор; `pytest` зелёный.
-
-## 5. Не-цели (вне скоупа)
-
-- Не менять текст/формат/верстку карточки.
-- Не трогать `parse_mode` (HTML нужен для `<a href>`).
-- Не трогать bump/edit-логику (`update_task_tracker`), репойнт `tracker_message_id`,
-  delete-семантику.
-- Не вводить флаги/конфиг — поведение «без превью» безусловное (превью никому не нужно).
-- Не трогать схему БД.
-
-## 6. Заинтересованные лица
-
-- **Слава (Owner)** — инициатор, конечный наблюдатель ленты Telegram.
-
-## 7. Грабли / координация
-
-- Файл `src/notifications.py` затрагивает также ORCH-067 (и потенциально другие задачи эпика).
-  Сверить, что правки (две строки) не конфликтуют при merge.
-- Один репозиторий с ORCH-74 → по ORCH-026 действует сериализация merge.
-  Запускать **после** того как ORCH-74 доедет в `main` (или когда конвейер свободен),
-  чтобы не плодить параллельный merge в `orchestrator`.
-- Деплой — штатный через **Confirm Deploy** (self-hosting, ORCH-059).

docs/work-items/ORCH-080/02-trz.md

@@ -1,102 +0,0 @@
-# 02-TRZ — ORCH-080: убрать Telegram link-preview в уведомлениях трекера
-
-Work Item ID: ORCH-080
-Зона изменений: `src/notifications.py` (две строки)
-
-## 1. Задействованные модули `src/`
-
-- `src/notifications.py` — **единственный** изменяемый модуль:
-  - `send_telegram(text, disable_notification=False)` — обёртка `POST .../sendMessage`.
-  - `edit_telegram(message_id, text)` — обёртка `POST .../editMessageText`.
-
-Косвенно затронуты (поведение улучшается без изменения их кода — они вызывают изменённые
-примитивы): `update_task_tracker` (bump+edit), `notify_approve_requested`, `notify_error`,
-а также вызовы `send_telegram` из `launcher`/`stage_engine` (alert'ы деплоя/падений).
-
-## 2. Изменения кода
-
-### 2.1. `send_telegram()` — добавить ключ в JSON-payload `httpx.post`
-
-В словаре `json={...}` вызова `sendMessage` (текущие стр. 55-60) добавить строку:
-
-```python
-"disable_web_page_preview": True,
-```
-
-Итоговый payload:
-```python
-json={
-    "chat_id": s.telegram_chat_id,
-    "text": text,
-    "parse_mode": "HTML",
-    "disable_notification": disable_notification,
-    "disable_web_page_preview": True,
-},
-```
-
-### 2.2. `edit_telegram()` — добавить ключ в JSON-payload `httpx.post`
-
-В словаре `json={...}` вызова `editMessageText` (текущие стр. 168-173) добавить строку:
-
-```python
-"disable_web_page_preview": True,
-```
-
-Итоговый payload:
-```python
-json={
-    "chat_id": s.telegram_chat_id,
-    "message_id": message_id,
-    "text": text,
-    "parse_mode": "HTML",
-    "disable_web_page_preview": True,
-},
-```
-
-> Примечание: Telegram Bot API исторически принимает top-level `disable_web_page_preview`
-> для `sendMessage`/`editMessageText` (актуальная схема также поддерживает
-> `link_preview_options.is_disabled`, но top-level флаг остаётся валиден и совместим).
-> Используем top-level флаг — минимальная, обратносовместимая правка, как указано в задаче.
-
-## 3. Изменения API
-
-Нет изменений внутреннего HTTP API оркестратора. Меняется только тело исходящих запросов к
-Telegram Bot API (добавлен один булев ключ в payload двух методов).
-
-## 4. Изменения схемы БД
-
-Нет.
-
-## 5. Требования к новым QG checks
-
-Нет. Новые Quality Gate проверки не вводятся.
-
-## 6. Конфиг / флаги
-
-Нет. Поведение «без превью» — безусловное (kill-switch не требуется: превью трекера
-не нужно никому, риск регрессии нулевой; правка обратимая одной строкой).
-`parse_mode`, `disable_notification`, bump/edit-логика — без изменений.
-
-## 7. Артефакты, обновляемые по pipeline
-
-- `CHANGELOG.md` — запись в `## [Unreleased]` (тип `fix:` — косметика UX уведомлений).
-- Документация: правка `src/notifications.py` затрагивает поведение, описанное в
-  `CLAUDE.md` (раздел «Нотификации / Telegram live-tracker») и
-  `docs/architecture/README.md` (компонент Notifications). Достаточно короткой ремарки,
-  что карточка/уведомления шлются без web-page-preview (по желанию архитектора — определить
-  объём в ADR; ADR не обязателен для столь малой косметики, решение за архитектором).
-
-## 8. Контракты-инварианты (не нарушать)
-
-- **never-raise**: обе функции по-прежнему ловят все исключения (`try/except: pass`/`return`)
-  и не валят оркестратор.
-- Возвращаемые значения не меняются: `send_telegram` → `message_id|None`,
-  `edit_telegram` → `EDIT_*`.
-- `parse_mode: "HTML"` сохранён в обоих payload (иначе `<a href>` сломается).
-- `disable_notification` в `send_telegram` сохранён (карточка тихая).
-- Инвариант «одна карточка на задачу» (bump/edit) не затрагивается.
-
-## 9. Commit / ветка
-
-- Ветка: `feature/ORCH-080-orch-52g-telegram-link-preview` (существует).
-- Commit: `fix: disable Telegram link-preview in tracker notifications (ORCH-080)`.

docs/work-items/ORCH-080/03-acceptance-criteria.md

@@ -1,59 +0,0 @@
-# 03-Acceptance Criteria — ORCH-080
-
-Work Item ID: ORCH-080
-
-Каждый критерий имеет явное условие PASS/FAIL.
-
-## AC-1 — `disable_web_page_preview` в payload `sendMessage`
-
-- **PASS:** JSON-payload вызова `httpx.post(.../sendMessage)` в `send_telegram()` содержит
-  ключ `"disable_web_page_preview"` со значением `True`.
-- **FAIL:** ключ отсутствует или `False`.
-- **Проверка:** unit-тест (мок `httpx`) инспектирует `httpx.post.call_args.kwargs["json"]`.
-
-## AC-2 — `disable_web_page_preview` в payload `editMessageText`
-
-- **PASS:** JSON-payload вызова `httpx.post(.../editMessageText)` в `edit_telegram()` содержит
-  ключ `"disable_web_page_preview"` со значением `True`.
-- **FAIL:** ключ отсутствует или `False`.
-- **Проверка:** unit-тест (мок `httpx`) инспектирует `httpx.post.call_args.kwargs["json"]`.
-
-## AC-3 — баннер link-preview Plane исчез в карточке трекера
-
-- **PASS:** в реальном чате Telegram карточка трекера задачи (режимы `bump` и `edit`)
-  больше не показывает баннер «Plane — Modern project management».
-- **FAIL:** баннер всё ещё разворачивается.
-- **Проверка:** ручная верификация на staging (8501) после деплоя — наблюдение карточки в
-  Telegram. Автоматически косвенно покрыто AC-1/AC-2 (payload содержит флаг).
-
-## AC-4 — ссылка на задачу остаётся кликабельной
-
-- **PASS:** в карточке/уведомлениях номер задачи `ORCH-NNN` остаётся кликабельной ссылкой
-  `<a href=...>` на issue в Plane; `parse_mode: "HTML"` сохранён в обоих payload.
-- **FAIL:** `parse_mode` изменён/удалён, либо ссылка перестала рендериться как `<a href>`.
-- **Проверка:** unit-тест проверяет, что `"parse_mode": "HTML"` присутствует в обоих payload;
-  существующие тесты ссылок (`test_notify_issue_links.py`) остаются зелёными.
-
-## AC-5 — сохранены существующие поля payload
-
-- **PASS:** `send_telegram` payload по-прежнему содержит `chat_id`, `text`, `parse_mode`,
-  `disable_notification`; `edit_telegram` payload — `chat_id`, `message_id`, `text`,
-  `parse_mode`. Возвращаемые значения функций не изменились
-  (`send_telegram → message_id|None`, `edit_telegram → EDIT_*`).
-- **FAIL:** любое из перечисленных полей удалено/переименовано, либо изменился контракт
-  возврата.
-- **Проверка:** unit-тесты payload + существующие тесты трекера/классификации исходов.
-
-## AC-6 — never-raise сохранён, pytest зелёный
-
-- **PASS:** при сетевой/HTTP-ошибке `send_telegram`/`edit_telegram` не бросают исключение
-  (возврат `None`/`EDIT_FAILED`); вся сюита `pytest tests/ -q` зелёная.
-- **FAIL:** любое исключение наружу или красный pytest.
-- **Проверка:** существующие тесты never-raise (`test_resilience.py`,
-  `test_telegram_tracker.py`) + полный прогон.
-
-## AC-7 — документация обновлена в том же PR
-
-- **PASS:** `CHANGELOG.md` содержит запись об ORCH-080; при необходимости — короткая ремарка
-  в `CLAUDE.md`/`docs/architecture/README.md` о подавлении link-preview.
-- **FAIL:** функционал изменён, документация не обновлена (Reviewer → REQUEST_CHANGES).

docs/work-items/ORCH-080/04-test-plan.yaml

@@ -1,76 +0,0 @@
-work_item: ORCH-080
-description: >
-  Подавление Telegram link-preview (disable_web_page_preview: True) в payload
-  send_telegram (sendMessage) и edit_telegram (editMessageText). Сохранить
-  parse_mode HTML, disable_notification, never-raise и контракты возврата.
-
-tests:
-  - id: TC-01
-    type: unit
-    description: >
-      send_telegram() кладёт "disable_web_page_preview": True в JSON-payload
-      httpx.post(.../sendMessage). Проверка через мок httpx и инспекцию
-      httpx.post.call_args.kwargs["json"].
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-02
-    type: unit
-    description: >
-      edit_telegram() кладёт "disable_web_page_preview": True в JSON-payload
-      httpx.post(.../editMessageText). Проверка через мок httpx и инспекцию
-      payload.
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-03
-    type: unit
-    description: >
-      Регрессия parse_mode: оба payload (sendMessage и editMessageText)
-      по-прежнему содержат "parse_mode": "HTML" — ссылка <a href> остаётся
-      кликабельной (AC-4).
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-04
-    type: unit
-    description: >
-      Регрессия полей send_telegram: payload содержит chat_id, text,
-      parse_mode, disable_notification; disable_notification прокидывается
-      из аргумента (True/False) без изменений (AC-5).
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-05
-    type: unit
-    description: >
-      Контракты возврата не изменились: send_telegram возвращает message_id
-      при ok:true, None при отсутствии креденшелов/ошибке; edit_telegram
-      возвращает EDIT_OK при ok:true (AC-5, AC-6).
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-06
-    type: unit
-    description: >
-      never-raise: при httpx.post бросающем исключение send_telegram->None и
-      edit_telegram->EDIT_FAILED, без проброса исключения (AC-6).
-    module: tests/test_link_preview_disabled.py
-    expected: PASS
-
-  - id: TC-07
-    type: integration
-    description: >
-      Полный прогон существующей сюиты трекера/уведомлений остаётся зелёным
-      (нет регрессий bump/edit-логики, классификации исходов, ссылок):
-      pytest tests/test_telegram_tracker.py tests/test_tracker_bump.py
-      tests/test_notify_issue_links.py tests/test_resilience.py.
-    module: tests/test_telegram_tracker.py
-    expected: PASS
-
-  - id: TC-08
-    type: integration
-    description: >
-      Вся сюита pytest tests/ -q зелёная (общая регрессия, AC-6).
-    module: tests/
-    expected: PASS

docs/work-items/ORCH-080/06-adr/ADR-001-disable-telegram-link-preview.md

@@ -1,63 +0,0 @@
-# ADR-001: Подавление Telegram link-preview в низкоуровневых примитивах нотификаций
-
-## Статус
-Accepted
-
-## Контекст
-С ORCH-067 карточка трекера и notify-сообщения несут кликабельный номер задачи
-`<a href="https://plane.mva154.duckdns.org/.../issues/<id>/">ORCH-NNN</a>`. Telegram
-Bot API по умолчанию (при отсутствии ключа `disable_web_page_preview`) разворачивает
-web-page-preview для первой ссылки в сообщении — под каждым сообщением трекера
-раскрывается баннер «Plane — Modern project management». В дефолтном режиме `bump`
-(ORCH-067) карточка пересоздаётся на каждом переходе, поэтому баннер дублируется на
-каждой задаче и каждом обновлении, засоряя ленту (жалоба Owner, 08.06).
-
-Код-аудит (`src/notifications.py`) подтвердил причину: JSON-payload обоих
-низкоуровневых примитивов — `send_telegram()` (`POST /sendMessage`, стр. 55-60) и
-`edit_telegram()` (`POST /editMessageText`, стр. 168-173) — **не содержит** ключ
-`disable_web_page_preview`. Все вышестоящие нотификации (`update_task_tracker` в обоих
-режимах, `notify_approve_requested`, `notify_error`, alert'ы стадий из
-`launcher`/`stage_engine`) проходят через эти два примитива.
-
-## Решение
-Добавить `"disable_web_page_preview": True` в JSON-payload `httpx.post` обоих примитивов:
-`send_telegram()` и `edit_telegram()`. Изменение — **на уровне низкоуровневого
-примитива**, а не на уровне каждого вызова, потому что:
-
-1. **Единая точка** — все исходящие сообщения трекера/нотификаций идут через эти две
-   функции; правка двух строк гасит баннер у ВСЕХ потребителей (карточка `bump`/`edit`,
-   notify-хелперы, alert'ы) без изменения их кода.
-2. **Безусловно, без флага** — превью Plane не нужно никому (это не данные, а навигация
-   по ссылке, которая остаётся кликабельной). Kill-switch не вводится: риск регрессии
-   нулевой, правка обратима одной строкой. Это согласуется с принципом «минимум
-   зависимостей/конфигурации».
-3. **Top-level флаг, а не `link_preview_options.is_disabled`** — top-level
-   `disable_web_page_preview` остаётся валиден и обратносовместим в Bot API; это
-   минимальная правка без введения вложенной структуры.
-
-`parse_mode: "HTML"` сохраняется в обоих payload (иначе `<a href>` перестанет
-рендериться — ссылка должна остаться кликабельной). `disable_notification`,
-bump/edit-логика, repoint `tracker_message_id`, delete-семантика, контракты возврата
-(`send_telegram → message_id|None`, `edit_telegram → EDIT_*`) — не затрагиваются.
-
-## Последствия
-**Плюсы:**
-- Баннер link-preview исчезает под карточкой трекера (оба режима) и под всеми
-  notify/alert-сообщениями — одна правда в двух примитивах.
-- Ссылка на задачу остаётся кликабельной (HTML сохранён).
-- Нулевой риск: ключ аддитивный, контракты примитивов и инвариант «одна карточка на
-  задачу» не меняются; `never-raise` (`try/except`) сохранён.
-
-**Минусы / ограничения:**
-- Поведение безусловное — нет конфигурации «вернуть превью». Сознательный выбор:
-  превью трекера не имеет ценности, флаг был бы лишней поверхностью.
-
-**Не затрагивается:** `STAGE_TRANSITIONS`, реестр `QG_CHECKS`, схема БД, `parse_mode`,
-`disable_notification`, транспортные хелперы `delete_telegram`/repoint-логика. Глобальный
-ADR не требуется — решение локально для `src/notifications.py`, не сквозное.
-
-## Self-hosting
-Изменение не требует немедленного рестарта прод-контейнера и не меняет топологию.
-Деплой — штатный через staging (8501) → `Confirm Deploy` (ORCH-059). По ORCH-026
-(сериализация merge одного репо) задача мержится после освобождения конвейера
-`orchestrator` (координация с ORCH-074 — см. BRD §7).

docs/work-items/ORCH-080/10-tech-risks.md

@@ -1,22 +0,0 @@
-# 10-Tech Risks — ORCH-080
-
-Work Item ID: ORCH-080
-Зона: `src/notifications.py` (две строки в `send_telegram`/`edit_telegram`)
-
-Косметическая правка UX (LOW). Топология, схема БД, стадии, QG — не меняются.
-Риск регрессии оценён как **нулевой**; ниже — остаточные пункты для внимания.
-
-| # | Риск | Вероятность | Влияние | Митигация |
-|---|------|-------------|---------|-----------|
-| R-1 | Опечатка ключа/значения (`disable_web_page_preview`) — баннер не гаснет | Низкая | Низкое (косметика) | unit-тест AC-1/AC-2 инспектирует `httpx.post.call_args.kwargs["json"]`; ручная верификация на staging (AC-3) |
-| R-2 | Случайное удаление `parse_mode: "HTML"` → ссылка `<a href>` ломается | Очень низкая | Среднее (теряется кликабельность) | AC-4: unit-тест на наличие `parse_mode: "HTML"` в обоих payload; `test_notify_issue_links.py` остаётся зелёным |
-| R-3 | Merge-конфликт с ORCH-067/ORCH-074 в `src/notifications.py` | Низкая | Низкое | По ORCH-026 сериализация merge одного репо; запуск после доезда ORCH-74 в `main` (BRD §7); pre-merge rebase (ORCH-043) |
-| R-4 | Регрессия контракта возврата примитивов (`message_id|None` / `EDIT_*`) | Очень низкая | Среднее | Правка строго аддитивна (новый ключ в payload), возвраты не трогаются; AC-5 + существующие тесты трекера |
-| R-5 | Telegram депрекейтит top-level `disable_web_page_preview` в пользу `link_preview_options` | Очень низкая | Низкое (forward-compat) | Top-level флаг остаётся валиден и обратносовместим; миграция на `link_preview_options.is_disabled` — отдельная задача при необходимости |
-
-## Инварианты, которые НЕЛЬЗЯ нарушить
-- `never-raise` обоих примитивов (`try/except` сохранён).
-- `parse_mode: "HTML"` в обоих payload (иначе `<a href>` ломается).
-- `disable_notification` в `send_telegram` (карточка тихая).
-- Инвариант «одна карточка на задачу» (bump/edit) — не затрагивается.
-- Контракты возврата: `send_telegram → message_id|None`, `edit_telegram → EDIT_*`.

docs/work-items/ORCH-080/12-review.md

@@ -1,72 +0,0 @@
----
-type: review
-work_item_id: ORCH-080
-verdict: APPROVED
-version: 1
----
-
-# Review ORCH-080
-
-## Summary
-Задача убирает баннер Telegram link-preview («Plane — Modern project management»),
-который разворачивался под кликабельной ссылкой `ORCH-NNN` в карточке трекера и
-во всех notify/alert-сообщениях. Решение точно соответствует TRZ и ADR-001:
-добавлен ключ `"disable_web_page_preview": True` в JSON-payload обоих
-низкоуровневых примитивов `send_telegram` (`POST /sendMessage`) и `edit_telegram`
-(`POST /editMessageText`) — единая точка для всех потребителей, без kill-switch,
-без изменения контрактов. Изменение минимально (2 строки + комментарии),
-аддитивно и обратимо.
-
-Проверены все четыре оси (ТЗ, ADR, качество кода, тесты) + документация. Findings
-уровней P0/P1/P2 — нет.
-
-## Findings
-
-### P0 — Blocker
-- нет
-
-### P1 — Must fix
-- нет
-
-### P2 — Should fix
-- нет
-
-## Соответствие ТЗ и AC
-- TRZ §2.1/§2.2 — ключ добавлен в оба payload в точности как предписано. ✅
-- AC-1 — `disable_web_page_preview: True` в `sendMessage` payload (TC-01). ✅
-- AC-2 — то же в `editMessageText` payload (TC-02). ✅
-- AC-3 — баннер исчезает (ручная верификация на staging; косвенно покрыто AC-1/AC-2). ✅
-- AC-4 — `parse_mode: "HTML"` сохранён в обоих payload, ссылка кликабельна (TC-03);
-  `tests/test_notify_issue_links.py` зелёный. ✅
-- AC-5 — поля `chat_id/text/parse_mode/disable_notification` (send) и
-  `chat_id/message_id/text/parse_mode` (edit) сохранены; контракты возврата
-  (`message_id|None`, `EDIT_*`) не изменились (TC-04/TC-05). ✅
-- AC-6 — never-raise сохранён (TC-06); полный прогон `pytest tests/ -q` — **1058 passed**. ✅
-- AC-7 — документация обновлена в том же PR (см. ниже). ✅
-
-## Соответствие ADR
-ADR-001 (Accepted): правка на уровне примитива (а не каждого вызова), безусловно
-без флага, top-level `disable_web_page_preview` вместо `link_preview_options`,
-`parse_mode: HTML` сохранён, контракты и инвариант «одна карточка на задачу» не
-тронуты. Реализация соответствует решению 1:1. Глобальные ADR не нарушены
-(`STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД — без изменений). ✅
-
-## Качество кода
-- Изменение минимальное, целевое; комментарии ссылаются на ORCH-080 и поясняют цель.
-- `try/except` never-raise в обеих функциях не затронут; пути без кредов и контракты
-  возврата сохранены.
-- Тесты содержательные: инспектируют реальный payload через мок `httpx`
-  (`call_args.kwargs["json"]`), покрывают флаг, регрессию `parse_mode`/полей,
-  контракты возврата и never-raise (TC-01..06). Нет тривиальных/пустых тестов.
-- Security: ключ булев, новых поверхностей/секретов нет.
-
-## Документация
-Изменён `src/` (поведение исходящих Telegram-запросов) → документация обновлена в
-том же PR, как требует CLAUDE.md §2/§6:
-- `CHANGELOG.md` — запись в `## [Unreleased]` (тип `fix:`). ✅
-- `CLAUDE.md` — раздел «Нотификации / Telegram live-tracker» дополнен пунктом
-  «Без link-preview (ORCH-080)». ✅
-- `docs/architecture/README.md` — компонент Notifications дополнен ремаркой ORCH-080. ✅
-- ADR `docs/work-items/ORCH-080/06-adr/ADR-001-disable-telegram-link-preview.md` заведён. ✅
-
-Документация соответствует коду; расхождений нет.

docs/work-items/ORCH-080/13-test-report.md

@@ -1,66 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-080
-result: PASS
----
-
-# Test Report — ORCH-080
-
-Подавление Telegram link-preview (`disable_web_page_preview: True`) в `send_telegram`
-(`sendMessage`) и `edit_telegram` (`editMessageText`). Сохранены `parse_mode: HTML`,
-`disable_notification`, never-raise и контракты возврата.
-
-## Окружение
-- Python: 3.12.13
-- pytest: 8.3.3
-- Дата: 2026-06-09
-- Ветка: `feature/ORCH-080-orch-52g-telegram-link-preview`
-- Review verdict: APPROVED (`12-review.md`)
-
-## Smoke test API (prod 8500, read-only)
-| Endpoint | Результат |
-|----------|-----------|
-| `GET /health` | `{"status":"ok","service":"orchestrator"}` — OK |
-| `GET /status` | OK (ORCH-080 = task #62, stage `testing`) |
-| `GET /queue` | OK (breaker `closed`, preflight_ok, reconcile/reaper enabled) |
-
-## Результаты тестов
-
-| TC ID | Описание | Тест(ы) | Результат |
-|-------|----------|---------|-----------|
-| TC-01 | `disable_web_page_preview: True` в payload `sendMessage` (AC-1) | `test_send_telegram_disables_link_preview` | PASS |
-| TC-02 | `disable_web_page_preview: True` в payload `editMessageText` (AC-2) | `test_edit_telegram_disables_link_preview` | PASS |
-| TC-03 | Регрессия `parse_mode: HTML` в обоих payload (AC-4) | `test_send_telegram_keeps_parse_mode_html`, `test_edit_telegram_keeps_parse_mode_html` | PASS |
-| TC-04 | Регрессия полей `send_telegram` + проброс `disable_notification` (AC-5) | `test_send_telegram_preserves_existing_fields`, `test_send_telegram_disable_notification_default_false`, `test_edit_telegram_preserves_existing_fields` | PASS |
-| TC-05 | Контракты возврата (`message_id`/`None`/`EDIT_OK`) (AC-5/AC-6) | `test_send_telegram_returns_message_id`, `test_send_telegram_returns_none_without_creds`, `test_edit_telegram_returns_edit_ok` | PASS |
-| TC-06 | never-raise → `None`/`EDIT_FAILED` без проброса (AC-6) | `test_send_telegram_never_raises`, `test_edit_telegram_never_raises` | PASS |
-| TC-07 | Регресс сюиты трекера/уведомлений (bump/edit, ссылки, resilience) | `test_telegram_tracker.py`, `test_tracker_bump.py`, `test_notify_issue_links.py`, `test_resilience.py` (+ `test_link_preview_disabled.py`) — 106 passed | PASS |
-| TC-08 | Полная регрессия `pytest tests/ -q` (AC-6) | вся сюита — 1058 passed | PASS |
-
-## Покрытие Acceptance Criteria
-- AC-1 — TC-01 ✅
-- AC-2 — TC-02 ✅
-- AC-3 (баннер исчез в чате) — ручная верификация на staging (8501) после деплоя; автоматически косвенно покрыто AC-1/AC-2 (payload несёт флаг). Не блокирует тест-гейт.
-- AC-4 — TC-03 + `test_notify_issue_links.py` зелёный ✅
-- AC-5 — TC-04/TC-05 ✅
-- AC-6 — TC-06 + полный прогон зелёный ✅
-- AC-7 — документация (CHANGELOG/CLAUDE.md/architecture/ADR) проверена на review-стадии ✅
-
-## Вывод pytest
-
-Полная сюита:
-```
-1058 passed, 1 warning in 26.61s
-```
-
-Целевые файлы ORCH-080 (TC-01..07):
-```
-106 passed, 1 warning in 3.24s
-```
-(`test_link_preview_disabled.py` — 12 passed.)
-
-Единственный warning — `PydanticDeprecatedSince20` в `src/config.py:5` (предсуществующий, не связан с ORCH-080).
-
-## Итог
-**PASS** — все автоматические тесты (TC-01..08) зелёные, smoke API OK, регрессий нет.
-Задача готова к переходу на стадию `deploy-staging`.

docs/work-items/ORCH-080/14-deploy-log.md

@@ -1,12 +0,0 @@
----
-deploy_status: SUCCESS
-work_item: ORCH-080
-hook_exit_code: 0
-deployed_by: deploy-finalizer
----
-
-# Deploy log — ORCH-036 executable self-deploy
-
-Прод-деплой завершён хост-хуком с exit-code `0` -> `deploy_status: SUCCESS`.
-
-Вердикт зафиксирован детерминированным finalizer'ом (Фаза C), не LLM.

docs/work-items/ORCH-080/15-staging-log.md

@@ -1,26 +0,0 @@
----
-staging_status: SUCCESS
-timestamp: 2026-06-08T22:31:47Z
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-Staging test suite completed against the live `orchestrator-staging` instance (port 8501).
-Run canonically **inside** the container via the Docker exec API (REST equivalent of
-`docker exec orchestrator-staging python3 /repos/orchestrator/scripts/staging_check.py
---base-url http://localhost:8501 --mode stub`), so B6 reads the staging instance's own
-process-env registry (ORCH-048, ADR-001).
-
-**Exit code: 0 → advance.** All REAL pipeline checks passed (8/10 PASS).
-
-- Block A (SMOKE): A1 /health, A2 /queue, A3 ORCH_STAGING=true — PASS
-- Block B (ACCESS): B4 Plane sandbox, B5 Gitea sandbox (push=true), B6 registry isolation
-  (sandbox present, prod ET/ORCH absent) — PASS
-- Block C (E2E): C7 create issue in SANDBOX, C8 trigger pipeline via /webhook/plane — PASS
-- C9a/C9b — FAILED but **waived** (known sandbox-infra checks; depend on SANDBOX bot
-  accounts being project members, not on the pipeline). Tolerated under ORCH-061 because
-  every REAL check is green.
-
-INFRA-WAIVED: C9a Branch appears in orchestrator-sandbox, C9b Analyst job enqueued in staging queue (known sandbox-infra; real checks green)
-VERDICT: SUCCESS (exit 0) — SUCCESS (infra-waived): ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue'] are known sandbox-infra checks; all real checks green

docs/work-items/ORCH-081/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-52h: эффорт агентов резолвится в пустую строку в проде (env перебивает config)
-
-Work Item ID: ORCH-081
-
-## Description
-
-TBD

docs/work-items/ORCH-081/01-brd.md

@@ -1,82 +0,0 @@
-# 01 — BRD: ORCH-081 (ORCH-52h)
-
-**Work Item:** ORCH-081
-**Эпик:** ORCH-052 (продолжение ORCH-52a / ORCH-074)
-**Тип:** Багфикс (конфигурация эффорта агентов)
-**Приоритет:** HIGH
-**Repo:** orchestrator (self-hosting)
-
-## 1. Контекст и проблема
-
-При проверке ORCH-074 (08.06) обнаружено: `resolve_agent_effort()` для **всех 6 агентов
-в проде** возвращает пустую строку `''`, хотя в `src/config.py` заданы осмысленные
-дефолты (`agent_effort_default="high"`, per-agent `high`/`medium`). Итог: флаг
-`--effort` **не передаётся** в Claude CLI, и каждый агент бежит на встроенном
-CLI-дефолте эффорта, а **не** на заявленном `high`/`medium`.
-
-### Корень (диагностика)
-В проде env-переменные `ORCH_AGENT_EFFORT_DEFAULT` и
-`ORCH_AGENT_EFFORT_{ANALYST,ARCHITECT,DEVELOPER,REVIEWER,TESTER,DEPLOYER}` выставлены в
-**пустую строку** (`VAR=` без значения). Pydantic Settings трактует присутствующую
-env-переменную (даже пустую) как явное значение и **перебивает** дефолт класса:
-`agent_effort_* = ''`. В цепочке резолва (`launcher._resolve_agent_attr`):
-- per-agent `''` → falsy → пропуск (уровень 2);
-- default `''` → falsy → пропуск (уровень 3);
-- → возврат `''` (уровень 4, «без флага»).
-
-Поскольку **и default тоже пуст**, привычный откат «per-agent пуст → взять default»
-не спасает: откатываться не на что. Это ключевой нюанс — фикс обязан давать каждой
-роли непустой «пол» (floor) даже когда И per-agent, И default env пусты.
-
-## 2. Бизнес-ценность / зачем важно
-
-Для Opus 4.8 (канон Anthropic) уровень reasoning-эффорта влияет на качество вывода
-**сильнее**, чем у прежних моделей. Coding/agentic роли (особенно `developer`) должны
-идти минимум на `high`, а `developer` — кандидат на `xhigh`. Сейчас фактически работает
-неконтролируемый CLI-дефолт → прямой удар по стратегии надёжности и предсказуемости
-качества всего конвейера (включая enduro-trails из общего инстанса).
-
-## 3. Решение (бизнес-уровень)
-
-Принят **вариант (c)** (решение Славы, 08.06): пустая строка эффорта трактуется как
-«не задано» и откатывается на осмысленный per-role дефолт (а не на CLI-дефолт),
-**устойчиво** к пустым env. Дополнительно — зафиксировать целевые дефолты в `config.py`
-и `.env.example`.
-
-### Целевые значения эффорта (единственный апгрейд — `developer`)
-| Агент | Эффорт | Обоснование |
-|-------|--------|-------------|
-| analyst | high | intelligence-роль |
-| architect | high | intelligence-роль |
-| **developer** | **xhigh** | coding/agentic, канон Opus 4.8 → апгрейд с `high` |
-| reviewer | high | intelligence-роль |
-| tester | medium | механическая роль |
-| deployer | medium | механическая роль |
-
-`developer → xhigh` — единственное изменение относительно текущих config-дефолтов;
-остальные значения подтверждают текущий замысел и фиксируются устойчиво.
-
-## 4. Грабли / ограничения (из бизнес-запроса)
-
-- **Хост-репо / env-правки НЕ переживают деплой**, если положены в git-managed файл
-  (урок 08.06 про docker-compose + TZ). Источник правды для реальных значений —
-  `.env` на хосте (gitignored), канон-шаблон — `.env.example`. Фикс обязан быть
-  **code-side robust**: даже если прод-`.env` снова окажется с пустыми
-  `ORCH_AGENT_EFFORT_*`, эффорт всё равно резолвится в целевые значения.
-- **Self-hosting:** правка касается инструмента, который сейчас в проде обслуживает и
-  другие проекты. Прод-контейнер `orchestrator` не ронять в рамках задачи; деплой —
-  через штатный `deploy-staging` → `Confirm Deploy`.
-
-## 5. Не-цели
-
-- НЕ трогать model-резолв (`resolve_agent_model` — сделан в ORCH-074).
-- НЕ включать G3 model-routing — все 6 агентов остаются на `claude-opus-4-8`.
-- НЕ менять значения эффорта сверх согласованных (`high`/`medium`/`xhigh` для
-  developer). Иные значения — отдельное взвешенное решение.
-
-## 6. Затронутые стороны
-
-- Все агенты конвейера (analyst → deployer) во всех проектах общего инстанса.
-- Операторы (правка прод-`.env`), документация (README таблица, `.env.example`).
-</content>
-</invoke>

docs/work-items/ORCH-081/02-trz.md

@@ -1,110 +0,0 @@
-# 02 — ТЗ: ORCH-081 (ORCH-52h)
-
-**Work Item:** ORCH-081 · **Тип:** багфикс конфигурации · **Repo:** orchestrator
-
-Документ описывает ТРЕБУЕМОЕ ПОВЕДЕНИЕ и затронутые модули. Конкретный механизм
-(field_validator vs изменение резолвера) — на усмотрение архитектора; ниже зафиксированы
-инварианты, которым любая реализация обязана удовлетворять.
-
-## 1. Задействованные модули
-
-| Модуль | Роль в задаче |
-|--------|----------------|
-| `src/config.py` (`Settings`) | дефолты эффорта; устойчивость к пустому env (ядро фикса) |
-| `src/agents/launcher.py` | `resolve_agent_effort` / `_resolve_agent_attr` (цепочка резолва), `VALID_EFFORTS`, сборка `--effort` в `_spawn` |
-| `.env.example` | канон-шаблон значений эффорта по ролям |
-| `docs/architecture/README.md` | таблица «Модель и эффорт по ролям» (строки ~47–54) |
-| `CHANGELOG.md` | запись о фиксе |
-| `tests/test_resolve_agent_effort.py` | расширить кейсами пустого env |
-
-## 2. Корень бага (точная механика)
-
-`launcher._resolve_agent_attr` (строки ~104–114):
-```
-per_agent = getattr(settings, f"agent_effort_{agent}", "")  # '' в проде -> falsy -> skip
-default   = getattr(settings, "agent_effort_default", "")    # '' в проде -> falsy -> skip
-return ""                                                     # уровень 4: без флага
-```
-Pydantic: `ORCH_AGENT_EFFORT_*=` (пустая строка в env) перебивает дефолт класса →
-поле `= ''`. Поскольку пустым оказывается **и** `agent_effort_default`, у резолва нет
-непустого «пола» для отката → `''` → `--effort` не передаётся.
-
-## 3. Требования к фиксу (вариант c)
-
-### FR-1. Непустой floor на каждую роль при пустом env
-При ЛЮБОЙ комбинации пустых `ORCH_AGENT_EFFORT_*` (включая `ORCH_AGENT_EFFORT_DEFAULT=`)
-`resolve_agent_effort(agent)` обязан вернуть целевое непустое значение для каждой из 6
-ролей:
-
-| agent | результат |
-|-------|-----------|
-| analyst | `high` |
-| architect | `high` |
-| developer | `xhigh` |
-| reviewer | `high` |
-| tester | `medium` |
-| deployer | `medium` |
-
-Замечание для реализации: floor должен быть **per-role**, а не единым на default —
-иначе пустой `ORCH_AGENT_EFFORT_TESTER=` снапнется на `high` вместо `medium`. Т.е.
-«пустая строка трактуется как не-задано» применяется так, чтобы каждая роль получала
-СВОЙ канонический дефолт, а не общий.
-
-### FR-2. Приоритет резолва сохраняется
-Порядок не меняется: project-override (`projects_json.agent_efforts`) > per-agent env >
-default > floor. Непустой явный env/override по-прежнему ПОБЕЖДАЕТ floor (оператор может
-осознанно задать, напр., `ORCH_AGENT_EFFORT_DEVELOPER=high`, и это применится).
-
-### FR-3. Валидация невалидного значения не регрессирует
-Значение вне `VALID_EFFORTS` (`low|medium|high|xhigh|max`) по-прежнему логируется
-(`logger.warning`) и **дропается** → `''` (без флага). Floor НЕ должен «спасать» явную
-опечатку (`turbo`/`ultra`) — поведение ORCH-41 сохраняется (never-break, мусор не
-уезжает в CLI).
-
-### FR-4. `developer → xhigh` зафиксирован явно
-`config.py`: `agent_effort_developer` со значением `xhigh` (сейчас `high`).
-`.env.example`: `ORCH_AGENT_EFFORT_DEVELOPER=xhigh` (сейчас `high`) + правка комментария
-про split (developer теперь xhigh, не в группе «thinking → high»).
-
-### FR-5. `xhigh` принимается CLI-слоем
-Подтвердить, что `xhigh` присутствует в `VALID_EFFORTS`
-(`src/agents/launcher.py:22` — уже `frozenset({"low","medium","high","xhigh","max"})`,
-**присутствует**; добавления не требуется, только верификация тестом). Эффорт реально
-собирается в команду: `_spawn` строит `effort_flag = f"--effort {effort} "` при непустом
-`effort` (строка ~434) — путь проброса не менять, только убедиться тестом сборки флага.
-
-## 4. Изменения API / схемы БД
-
-- **API endpoints:** нет.
-- **Схема БД:** нет.
-- **Конфиг (env-контракт):** значения `ORCH_AGENT_EFFORT_*` неизменны по ИМЕНАМ;
-  меняется лишь дефолт `developer` (high → xhigh) и устойчивость к пустым значениям.
-  Обратная совместимость: непустой явный env работает 1:1 как раньше.
-
-## 5. Требования к QG checks
-
-Новых QG checks не требуется. Гейты конвейера не затрагиваются.
-
-## 6. Артефакты pipeline (обновить в ТОМ ЖЕ PR)
-
-- `src/config.py` — дефолт developer + устойчивость к пустому env.
-- `src/agents/launcher.py` — если фикс кладётся в резолвер (на усмотрение архитектора).
-- `.env.example` — `ORCH_AGENT_EFFORT_DEVELOPER=xhigh` + правка комментария split.
-- `docs/architecture/README.md` — таблица эффорта: developer `high` → `xhigh`; при
-  необходимости — ремарка про floor/устойчивость к пустому env.
-- `CHANGELOG.md` — запись (`fix:`).
-- `tests/test_resolve_agent_effort.py` — новые кейсы (см. 04-test-plan.yaml).
-
-## 7. Операционная часть (вне PR-кода, для деплой-лога)
-
-- Реальные значения — в прод-`.env` на хосте (gitignored). Рекомендуется привести
-  прод-`.env` к каноне `.env.example` (developer=xhigh, остальные непустые), НО фикс
-  обязан работать и без этого (FR-1). Не коммитить секреты/хост-env в git.
-- Деплой — через `deploy-staging` (8501) → `Confirm Deploy`. Прод-контейнер не ронять
-  вне штатного хука.
-
-## 8. Definition of Done
-
-AC-1…AC-5 из `03-acceptance-criteria.md` выполнены; `pytest -q` зелёный; документация
-(README + `.env.example` + CHANGELOG) синхронизирована в том же PR; never-break соблюдён.
-</content>

docs/work-items/ORCH-081/03-acceptance-criteria.md

@@ -1,60 +0,0 @@
-# 03 — Критерии приёмки: ORCH-081 (ORCH-52h)
-
-Каждый критерий — чёткое условие PASS/FAIL. Пустой env моделируется в unit-тестах
-(установка `agent_effort_* = ""`), проверка «в проде» — операционная (post-deploy).
-
-## AC-1 — осмысленный непустой эффорт для всех 6 агентов
-**PASS:** `resolve_agent_effort(agent)` возвращает целевое непустое значение для каждой
-роли при канонической конфигурации:
-
-| agent | ожидаемое |
-|-------|-----------|
-| analyst | `high` |
-| architect | `high` |
-| developer | `xhigh` |
-| reviewer | `high` |
-| tester | `medium` |
-| deployer | `medium` |
-
-**FAIL:** любой агент возвращает `''` или значение, отличное от таблицы.
-
-## AC-2 — пустой env НЕ приводит к пустому эффорту (вариант c)
-**PASS:** при `agent_effort_default = ""` И всех `agent_effort_<role> = ""`
-(моделирование прод-env, где `ORCH_AGENT_EFFORT_*=` пусты) `resolve_agent_effort` для
-каждой из 6 ролей возвращает значение по таблице AC-1 (floor per-role срабатывает:
-developer=`xhigh`, tester/deployer=`medium`, остальные=`high`), а **не** `''`.
-**FAIL:** хотя бы одна роль при полностью пустом env даёт `''`.
-
-## AC-3 — эффорт реально пробрасывается в запуск агента
-**PASS:** в `launcher._spawn` (или эквивалентной сборке) при непустом резолвнутом
-эффорте формируется `--effort <value> ` во флагах команды; при пустом — флаг
-отсутствует. Тест сборки флага подтверждает наличие `--effort xhigh ` для developer и
-`--effort medium ` для tester.
-**FAIL:** `--effort` отсутствует при непустом значении ИЛИ присутствует при пустом.
-
-## AC-4 — документация синхронизирована
-**PASS:** `.env.example` содержит `ORCH_AGENT_EFFORT_DEVELOPER=xhigh` и корректный
-комментарий про split; таблица «Модель и эффорт по ролям» в
-`docs/architecture/README.md` показывает developer = `xhigh` (остальные без изменений);
-`CHANGELOG.md` содержит запись о фиксе.
-**FAIL:** любой из трёх артефактов рассинхронизирован с фактическими дефолтами config.
-
-## AC-5 — never-break, тесты зелёные
-**PASS:**
-- `pytest -q` целиком зелёный (включая существующие
-  `tests/test_resolve_agent_effort.py` и новые кейсы).
-- Невалидное значение эффорта (`turbo`/`ultra`/`bogus`) по-прежнему логируется и
-  дропается в `''` (floor его НЕ маскирует) — регрессии валидации ORCH-41 нет.
-- Непустой явный per-agent env / project-override по-прежнему побеждает floor
-  (приоритет резолва сохранён).
-- `xhigh ∈ VALID_EFFORTS` (подтверждено тестом).
-
-**FAIL:** падение любого теста, регрессия валидации/приоритета, либо `xhigh`
-отвергается как невалидный.
-
-## AC-6 (операционный, для деплой-стадии) — проверка в проде
-**PASS:** после деплоя на проде `resolve_agent_effort` для 6 агентов даёт значения
-AC-1 (проверяется в рантайме прод-инстанса / по логам запуска агента — наличие
-`--effort` с верным уровнем). Фиксируется в `14-deploy-log.md`.
-**FAIL:** в проде хотя бы один агент бежит без `--effort` или с неверным уровнем.
-</content>

docs/work-items/ORCH-081/04-test-plan.yaml

@@ -1,86 +0,0 @@
-work_item: ORCH-081
-description: >
-  Тест-план фикса ORCH-52h — устойчивость резолва эффорта к пустому env (вариант c) +
-  фиксация целевых дефолтов (developer -> xhigh). Расширяет существующий
-  tests/test_resolve_agent_effort.py. Пустой прод-env моделируется установкой
-  agent_effort_* = "" на settings (через monkeypatch), как уже делают текущие тесты.
-tests:
-  - id: TC-01
-    type: unit
-    description: >
-      Канонические дефолты: resolve_agent_effort для всех 6 ролей даёт
-      analyst/architect/reviewer=high, developer=xhigh, tester/deployer=medium.
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-1, FR-4]
-    expected: PASS
-
-  - id: TC-02
-    type: unit
-    description: >
-      Пустой env (вариант c): при agent_effort_default="" И всех
-      agent_effort_<role>="" каждая из 6 ролей возвращает целевое значение по AC-1
-      (НЕ ""). Ключевой кейс бага: developer -> xhigh, tester/deployer -> medium,
-      analyst/architect/reviewer -> high.
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-2]
-    expected: PASS
-
-  - id: TC-03
-    type: unit
-    description: >
-      Floor НЕ маскирует опечатку: невалидное значение (default/per-agent/override =
-      'turbo'/'ultra'/'bogus') по-прежнему логируется и дропается в "" (валидация
-      ORCH-41 не регрессирует). Проверить, что floor не подменяет невалидный явный ввод
-      на дефолт.
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-5, FR-3]
-    expected: PASS
-
-  - id: TC-04
-    type: unit
-    description: >
-      Приоритет сохранён: непустой per-agent env побеждает floor/ default
-      (ORCH_AGENT_EFFORT_DEVELOPER=high -> "high", не "xhigh"); project-override
-      побеждает per-agent (agent_efforts={"developer":"xhigh"}).
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-5, FR-2]
-    expected: PASS
-
-  - id: TC-05
-    type: unit
-    description: >
-      xhigh валиден: xhigh ∈ VALID_EFFORTS и resolve_agent_effort с developer-дефолтом
-      xhigh не дропается.
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-5, FR-5]
-    expected: PASS
-
-  - id: TC-06
-    type: unit
-    description: >
-      Сборка флага: при resolve developer=xhigh во флагах присутствует "--effort xhigh ",
-      при tester=medium — "--effort medium "; при пустом эффорте "--effort" отсутствует
-      (mirror логики _spawn, как существующие test_flags_* кейсы).
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-3]
-    expected: PASS
-
-  - id: TC-07
-    type: integration
-    description: >
-      Документация синхронизирована: .env.example содержит
-      ORCH_AGENT_EFFORT_DEVELOPER=xhigh; README таблица эффорта показывает developer
-      xhigh. (Проверяется ревьюером/тестером по diff; опционально — текстовая ассерта.)
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-4]
-    expected: PASS
-
-  - id: TC-08
-    type: unit
-    description: >
-      Регрессия существующего набора: весь tests/test_resolve_agent_effort.py +
-      tests/test_resolve_agent_model.py остаются зелёными (never-break ORCH-41/074).
-    module: tests/test_resolve_agent_effort.py
-    covers: [AC-5]
-    expected: PASS
-</content>

docs/work-items/ORCH-081/06-adr/ADR-001-effort-resolution-floor.md

@@ -1,129 +0,0 @@
-# ADR-001: Per-role floor для резолва `--effort`, устойчивый к пустому env
-
-**Work Item:** ORCH-081 (ORCH-52h) · **Эпик:** ORCH-052 (после ORCH-074)
-**Связанные:** ORCH-41 (резолв model/effort), ORCH-074 (валидация модели, `is_valid_model`)
-
-## Статус
-Accepted
-
-## Контекст
-
-В проде `resolve_agent_effort()` возвращает `''` для всех 6 агентов, хотя в
-`src/config.py` заданы осмысленные дефолты (`high`/`medium`). Итог: флаг `--effort`
-не передаётся в Claude CLI, каждый агент бежит на встроенном CLI-дефолте, а не на
-заявленном уровне. Для Opus 4.8 reasoning-эффорт сильнее влияет на качество, чем у
-прежних моделей, → прямой удар по предсказуемости качества всего конвейера (включая
-enduro-trails из общего инстанса).
-
-### Корень (точная механика)
-Pydantic Settings трактует **присутствующую** env-переменную — даже пустую
-(`ORCH_AGENT_EFFORT_DEVELOPER=` без значения) — как явное значение и **перебивает**
-дефолт класса: поле `= ''`. В проде пусты И per-agent (`ORCH_AGENT_EFFORT_<ROLE>=`),
-И default (`ORCH_AGENT_EFFORT_DEFAULT=`). Цепочка резолва (`_resolve_agent_attr`):
-
-```
-project-override (agent_efforts) → пусто
-per-agent env ('') → falsy → skip
-default ('') → falsy → skip
-→ '' (уровень 4: без флага)
-```
-
-Привычный откат «per-agent пуст → взять default» не спасает: откатываться не на что —
-default тоже пуст. Нужен непустой **per-role** «пол» (floor) ниже default.
-
-### Дополнительное ограничение (урок 08.06)
-Хост-правки env, положенные в git-managed файл, **не переживают деплой**. Источник
-правды реальных значений — `.env` на хосте (gitignored). Значит, фикс обязан быть
-**code-side robust**: даже если прод-`.env` снова окажется с пустыми
-`ORCH_AGENT_EFFORT_*`, эффорт всё равно резолвится в целевые значения.
-
-## Рассмотренные варианты
-
-### Вариант A — `field_validator` в `config.py` (coerce пустой → дефолт на уровне поля)
-Валидатор каждого `agent_effort_*` конвертирует пустую строку в канонический дефолт
-поля.
-**Отклонён:** ломает приоритет FR-2. Если per-agent поле всегда непустое, оно ВСЕГДА
-бьёт `default` (уровень 3 становится мёртвым для роли с пустым env). Сценарий: оператор
-ставит `ORCH_AGENT_EFFORT_DEFAULT=max`, per-agent оставляет пустыми — намерение «все
-роли на max», но coercion на уровне поля даст каждой роли её per-role дефолт, а не
-`max`. Floor обязан стоять **строго ниже** default, а это видно только в резолвере,
-где доступна вся цепочка приоритетов.
-
-### Вариант B — explicit hardcoded map `{analyst: high, …}` в `launcher.py`
-Отдельная константа-карта per-role floor.
-**Отклонён как первичный:** вводит **второй источник правды** рядом с дефолтами
-`config.py`. Баг, который мы чиним, — это и есть дрейф/рассинхрон конфигурации;
-заводить новую поверхность дрейфа концептуально неверно (карту и config надо вручную
-держать в синхроне).
-
-### Вариант C — floor в резолвере, значение = class-default поля (ПРИНЯТО)
-Floor применяется как **последний** уровень в `resolve_agent_effort`, ниже `default`,
-а его значение берётся из **декларированного class-default** соответствующего поля
-`Settings` (через `model_fields`), который пустой env НЕ может перебить.
-
-## Решение
-
-Фикс кладётся в `resolve_agent_effort` (`src/agents/launcher.py`), `_resolve_agent_attr`
-остаётся общим с model-резолвом и **не трогается** (floor — effort-специфичен).
-
-### Цепочка резолва (новая, уровень 4 — floor)
-```
-1. project-override  (projects_json.agent_efforts[agent])   — непустой побеждает
-2. per-agent env     (settings.agent_effort_<agent>)        — непустой побеждает
-3. global default    (settings.agent_effort_default)        — непустой побеждает
-4. per-role FLOOR    (class-default поля agent_effort_<agent>) — НОВОЕ, непустой пол
-   ↓ (только если все 1–3 пусты)
-5. валидация VALID_EFFORTS → невалидное дропается в '' (ORCH-41, never-break)
-```
-
-### Ключевые инварианты реализации
-- **Floor = class-default поля, а не instance-значение.** `type(settings).model_fields[f"agent_effort_{agent}"].default` возвращает декларированный дефолт (`high`/`medium`/`xhigh`), который пустой env не клобберит. Это восстанавливает значение, которое pydantic дал бы, не будь спурьозного `VAR=`. **Единый источник правды — `config.py`**: developer-апгрейд на `xhigh` делается одной правкой поля, floor подтягивается автоматически.
-- **Floor применяется ДО валидации и ТОЛЬКО при пустом резолве.** Порядок критичен для FR-3: явная опечатка (`turbo`) — непустая, поэтому floor НЕ применяется, и значение штатно дропается валидацией в `''`. Floor не маскирует мусор.
-- **Floor — строго уровень 4 (ниже default).** Непустой явный env/override/`default` по-прежнему побеждает floor (FR-2). Floor срабатывает лишь когда сконфигурировать эффорт забыли/занулили на всех уровнях.
-- **Unknown-agent fallback:** если поля `agent_effort_<agent>` нет (имя не из 6 ролей), floor деградирует на class-default `agent_effort_default` (`high`) — непустой безопасный пол, never-break.
-
-### Сопутствующая правка config (FR-4)
-`config.py`: `agent_effort_developer` `high → xhigh` (канон Opus 4.8: coding/agentic роль).
-Это единственное изменение значений; остальные (`analyst/architect/reviewer=high`,
-`tester/deployer=medium`) подтверждаются и фиксируются устойчиво. Поскольку floor =
-class-default, апгрейд автоматически становится и новым floor для developer.
-
-### Целевые значения (floor при полностью пустом env)
-| agent | floor |
-|-------|-------|
-| analyst | high |
-| architect | high |
-| developer | **xhigh** |
-| reviewer | high |
-| tester | medium |
-| deployer | medium |
-
-## Последствия
-
-**Плюсы**
-- Code-side robust: пустой прод-`.env` больше не обнуляет эффорт; целевые уровни
-  гарантированы без зависимости от хост-правок, которые не переживают деплой.
-- Единый источник правды (`config.py`); нулевой риск дрейфа floor-карты.
-- Приоритет резолва и контракт ORCH-41 сохранены 1:1; непустой явный конфиг работает
-  как раньше (полная обратная совместимость).
-- Валидация ORCH-41 не регрессирует — опечатки по-прежнему дропаются, never-break.
-
-**Минусы / ограничения**
-- Лёгкая зависимость от pydantic-v2 API (`model_fields[...].default`) — публичный
-  стабильный атрибут, но это связь с внутренним устройством Settings. Замокать в тестах
-  тривиально.
-- «CLI-дефолт без флага» как исход для 6 штатных ролей становится недостижим — это
-  намеренно: для известных ролей всегда есть непустой пол. Unknown-agent сохраняет
-  безопасный непустой fallback.
-
-**Не затрагивается**
-- API endpoints — нет. Схема БД — нет. QG checks / гейты конвейера — нет.
-  Model-резолв (ORCH-074) — нет. Путь проброса `--effort` в `_spawn` (стр. ~434) — нет
-  (только верификация тестом, FR-3/FR-5).
-
-## Деплой (self-hosting)
-Правка касается инструмента, обслуживающего в проде и другие проекты. Прод-контейнер
-`orchestrator` не ронять в рамках задачи; деплой — штатно `deploy-staging` (8501) →
-`Confirm Deploy`. Рекомендуется привести прод-`.env` к каноне `.env.example`
-(developer=xhigh, остальные непустые), НО фикс обязан работать и без этого (FR-1).
-Проверка в проде (AC-6) фиксируется в `14-deploy-log.md`.

docs/work-items/ORCH-081/10-tech-risks.md

@@ -1,17 +0,0 @@
-# 10 — Технические риски: ORCH-081 (ORCH-52h)
-
-| ID | Риск | Вероятн. | Влияние | Митигация |
-|----|------|----------|---------|-----------|
-| R-1 | **Floor маскирует опечатку.** Если floor применить ПОСЛЕ/ВМЕСТО валидации, мусорное `turbo` подменится на floor вместо дропа → регрессия never-break ORCH-41. | низк. | средн. | Floor строго ДО валидации и ТОЛЬКО при пустом резолве (значение `turbo` непустое → floor не трогается → дроп). Покрыть тестом FR-3 (опечатка → `''`). |
-| R-2 | **Floor перебивает явный конфиг.** Ошибка порядка → floor встанет выше default/per-agent и `ORCH_AGENT_EFFORT_DEFAULT=max` перестанет применяться. | низк. | средн. | Floor — строго уровень 4 (ниже default). Тест FR-2: непустой default/per-agent/override побеждает floor. |
-| R-3 | **Зависимость от pydantic-internal** `model_fields[...].default`. Будущий мажор pydantic может сменить API → floor отвалится. | низк. | низк. | Публичный стабильный атрибут pydantic v2. Тест AC-1/AC-2 поймает регрессию сразу (floor вернёт не то/пусто). Фиксируется версией pydantic в зависимостях. |
-| R-4 | **Дрейф floor vs config** при выборе hardcoded-карты. | — | — | Снят архитектурно: floor = class-default поля, единый источник правды (см. ADR-001, вариант B отклонён). |
-| R-5 | **Self-hosting:** правка резолва эффорта затрагивает запуск ВСЕХ агентов всех проектов общего инстанса; ошибка ломает конвейер enduro-trails тоже. | низк. | высок. | Обязательный `deploy-staging` (8501) перед прод-деплоем; прод-контейнер не ронять вне штатного хука; `Confirm Deploy`-гейт. Post-deploy проверка AC-6 по логам запуска агента. |
-| R-6 | **Прод-`.env` снова с пустыми `ORCH_AGENT_EFFORT_*`** после деплоя (урок 08.06: git-managed env не переживает). | средн. | низк. | Именно это и закрывает фикс (FR-1, code-side robust): эффорт резолвится в floor независимо от состояния `.env`. Приведение `.env` к каноне — рекомендация, не зависимость. |
-| R-7 | **`xhigh` не принимается CLI-слоем.** developer-апгрейд бессмыслен, если `xhigh ∉ VALID_EFFORTS`. | очень низк. | средн. | `xhigh` уже в `VALID_EFFORTS` (`launcher.py:22`); добавления не требуется — только верификация тестом (FR-5). |
-
-## Сводный вывод
-Изменение локализовано в `resolve_agent_effort` + один дефолт `config.py`; не трогает
-API, схему БД, QG-гейты, model-резолв и путь проброса `--effort`. Главный остаточный
-риск — операционный (R-5, self-hosting), снимается штатным staging-гейтом. Контракт
-ORCH-41/ORCH-074 сохранён, обратная совместимость полная.

docs/work-items/ORCH-081/12-review.md

@@ -1,57 +0,0 @@
----
-type: review
-work_item_id: ORCH-081
-verdict: APPROVED
-version: 1
----
-
-# Review ORCH-081 (ORCH-52h) — устойчивость резолва `--effort` к пустому env + developer→xhigh
-
-## Summary
-Фикс конфигурационного бага: в проде `resolve_agent_effort()` возвращал `''` для всех 6 агентов (пустые `ORCH_AGENT_EFFORT_*=` перебивают class-default pydantic), `--effort` не доходил до Claude CLI. Решение — вариант C по ADR-001: непустой **per-role floor** уровня 4 в `resolve_agent_effort`, значение = декларированный class-default поля `agent_effort_<agent>` через `model_fields[...].default`. `developer` поднят `high→xhigh` в `config.py` (единый источник правды, floor подтягивается автоматически).
-
-Реализация полностью соответствует ТЗ и ADR; вся документация синхронизирована в том же бранче; `pytest -q` — **1031 passed**.
-
-## Соответствие ТЗ (FR-1…FR-5)
-- **FR-1** per-role floor при пустом env → каждая роль получает свой канон (`_agent_effort_floor`, TC-02). ✓
-- **FR-2** приоритет резолва сохранён: явный env/override/default побеждают floor (TC-04: `test_explicit_env_beats_floor`, `test_default_beats_floor`, `test_project_override_beats_floor`). ✓
-- **FR-3** валидация не регрессирует: непустая опечатка (`turbo`) не доходит до floor → дропается в `''` (TC-03 `test_floor_does_not_mask_typo`). ✓
-- **FR-4** `agent_effort_developer = "xhigh"` в `config.py`; `ORCH_AGENT_EFFORT_DEVELOPER=xhigh` + правка комментария split в `.env.example`. ✓
-- **FR-5** `xhigh ∈ VALID_EFFORTS`; сборка флага `--effort xhigh `/`--effort medium ` подтверждена (TC-05/TC-06). ✓
-
-## Соответствие ADR-001
-- Floor как **строго уровень 4** ниже default, в резолвере — ✓ (вариант C, не field_validator/не hardcoded map).
-- Floor = **class-default поля** (`type(settings).model_fields[...].default`), который пустой env перебить не может — ✓.
-- `_resolve_agent_attr` (общий с model-резолвом) **не тронут** — ✓.
-- Floor применяется **ДО валидации и только при пустом резолве** — ✓.
-- Unknown-agent деградирует на class-default `agent_effort_default` (`high`) — ✓ (`test_empty_env_unknown_agent_floor_is_default`).
-- Никаких изменений API / схемы БД / QG / model-резолва / пути проброса в `_spawn` — ✓.
-
-## Качество кода и тестов
-- Чистый leaf-helper, подробные docstrings, контракт never-raise соблюдён.
-- Тесты содержательные, покрывают все AC/FR (канон-дефолты, floor per-role, не-маскирование опечатки, приоритет на 3 уровнях, `xhigh`-валидность, сборка флага + негативные кейсы).
-
-## Findings
-
-### P0 — Blocker
-- (нет)
-
-### P1 — Must fix
-- (нет)
-
-### P2 — Should fix
-- (нет)
-
-### P3 — Nice-to-have
-- `tests/test_resolve_agent_effort.py:218-219` — продублирована строка `assert "--fallback-model" not in flags` в `test_flags_absent_when_model_empty`. Безвредно, можно убрать при случае.
-
-## Документация
-Изменён `src/` → документация обновлена в том же бранче (доку-гейт пройден):
-- `docs/architecture/README.md` — таблица «Модель и эффорт по ролям»: developer = `xhigh`; добавлена ремарка про per-role floor / устойчивость к пустому env (AC-4). ✓
-- `.env.example` — `ORCH_AGENT_EFFORT_DEVELOPER=xhigh` + комментарий split/floor (AC-4). ✓
-- `CHANGELOG.md` — запись `fix:` с разбором корня/фикса. ✓
-- `docs/work-items/ORCH-081/06-adr/ADR-001-effort-resolution-floor.md` — присутствует (Accepted). ✓
-
-## Примечание (вне scope ревью)
-- AC-6 — операционная проверка в проде после деплоя, фиксируется в `14-deploy-log.md` на стадии deploy. К коду PR не относится.
-- `git diff main...HEAD` показывает также код ORCH-074 (`is_valid_model`/`resolve_agent_model`) из-за устаревшего локального `main`; собственно изменения ORCH-081 — коммит `56bf303` (+ README обновлён в линии бранча). На ревью это не влияет: HEAD-состояние корректно по всем осям.

docs/work-items/ORCH-081/13-test-report.md

@@ -1,61 +0,0 @@
----
-type: test-report
-work_item_id: ORCH-081
-result: PASS
----
-
-# Test Report — ORCH-081 (ORCH-52h)
-
-Устойчивость резолва `--effort` к пустому env (вариант c) + фиксация целевых
-дефолтов (developer → xhigh).
-
-## Окружение
-- Python: 3.12.13
-- pytest: 8.3.3
-- Repo/branch: orchestrator @ `feature/ORCH-081-orch-52h-env-config` (worktree)
-- prod `/health`: ok (8500) · staging `/health`: ok (8501) — не трогались
-- Дата: 2026-06-08
-
-## Результаты по тест-плану (04-test-plan.yaml)
-
-| TC ID | Описание | Покрытие | Результат |
-|-------|----------|----------|-----------|
-| TC-01 | Канонические дефолты: 6 ролей дают high/high/xhigh/high/medium/medium | AC-1, FR-4 | PASS |
-| TC-02 | Пустой env (вариант c): per-role floor, developer→xhigh, tester/deployer→medium, остальные→high (НЕ "") | AC-2 | PASS |
-| TC-03 | Floor НЕ маскирует опечатку: `turbo`/`ultra`/`bogus` логируется и дропается в "" | AC-5, FR-3 | PASS |
-| TC-04 | Приоритет сохранён: непустой per-agent env / project-override побеждают floor/default | AC-5, FR-2 | PASS |
-| TC-05 | `xhigh ∈ VALID_EFFORTS` и не дропается | AC-5, FR-5 | PASS |
-| TC-06 | Сборка флага: `--effort xhigh ` (developer), `--effort medium ` (tester); пустой → флаг отсутствует | AC-3 | PASS |
-| TC-07 | Документация синхронизирована: `.env.example` DEVELOPER=xhigh, README таблица developer=xhigh | AC-4 | PASS |
-| TC-08 | Регрессия: весь набор test_resolve_agent_effort.py + полный регресс зелёные | AC-5 | PASS |
-
-### Сопоставление с критериями приёмки
-- **AC-1** — `test_canonical_effort_all_roles[*]` (6 параметров) → PASS.
-- **AC-2** — `test_empty_env_falls_back_to_per_role_floor[*]` (6 параметров) + `test_empty_env_unknown_agent_floor_is_default` → PASS.
-- **AC-3** — `test_flags_present_when_configured`, `test_flags_effort_per_role`, `test_flags_absent_when_effort_empty` → PASS.
-- **AC-4** — verified по diff: `src/config.py:108` `agent_effort_developer = "xhigh"`; `.env.example:48` `ORCH_AGENT_EFFORT_DEVELOPER=xhigh`; `docs/architecture/README.md` таблица developer=`xhigh`; `CHANGELOG.md` содержит запись `fix:` → PASS.
-- **AC-5** — `test_floor_does_not_mask_typo`, `test_*_beats_floor`, `test_xhigh_is_valid`, `test_invalid_*_dropped` + полный регресс зелёный → PASS.
-- **AC-6** — операционный, вне scope стадии testing: проверяется в рантайме прода на стадии `deploy`, фиксируется в `14-deploy-log.md`.
-
-## Smoke test API (prod 8500)
-- `GET /health` → `{"status":"ok","service":"orchestrator"}`
-- `GET /status` → HTTP 200
-- `GET /queue` → HTTP 200
-
-## Вывод pytest
-
-Целевой файл задачи:
-```
-tests/test_resolve_agent_effort.py ... 29 passed, 1 warning in 0.36s
-```
-
-Полный регресс:
-```
-........................................................................ [ 97%]
-.......................                                                  [100%]
-1031 passed, 1 warning in 27.02s
-```
-(единственный warning — PydanticDeprecatedSince20 в `src/config.py:5`, не относится к задаче, предсуществующий.)
-
-## Итог
-**PASS** — все 8 TC пройдены, критерии AC-1…AC-5 выполнены (AC-6 операционный, для стадии deploy), полный регресс `1031 passed`, smoke API зелёный. Прод/staging-контейнеры не затрагивались.

docs/work-items/ORCH-081/14-deploy-log.md

@@ -1,12 +0,0 @@
----
-deploy_status: SUCCESS
-work_item: ORCH-081
-hook_exit_code: 0
-deployed_by: deploy-finalizer
----
-
-# Deploy log — ORCH-036 executable self-deploy
-
-Прод-деплой завершён хост-хуком с exit-code `0` -> `deploy_status: SUCCESS`.
-
-Вердикт зафиксирован детерминированным finalizer'ом (Фаза C), не LLM.

docs/work-items/ORCH-081/15-staging-log.md

@@ -1,27 +0,0 @@
----
-staging_status: SUCCESS
-timestamp: 2026-06-08T19:47:45+00:00
-base_url: http://localhost:8501
----
-
-# Staging Gate Log
-
-Staging test suite completed. Exit code 0 → advance.
-
-Canonical run inside the `orchestrator-staging` container (ORCH-048, ADR-001) via the
-Docker Engine API over the unix socket (docker CLI unavailable in the agent container):
-
-```
-python3 /repos/orchestrator/scripts/staging_check.py --base-url http://localhost:8501 --mode stub
-```
-
-Result: **8/10 checks PASS**, all REAL checks green.
-
-```
-INFRA-WAIVED: C9a Branch appears in orchestrator-sandbox, C9b Analyst job enqueued in staging queue (known sandbox-infra; real checks green)
-VERDICT: SUCCESS (exit 0) — SUCCESS (infra-waived): ['C9a Branch appears in orchestrator-sandbox', 'C9b Analyst job enqueued in staging queue'] are known sandbox-infra checks; all real checks green
-```
-
-The two waived checks (C9a/C9b) are the known sandbox-infra-only checks tolerated under
-ORCH-061 (SANDBOX bot accounts are not members of the sandbox Plane project — not a pipeline
-regression). All pipeline (REAL) checks A1–A3, B4–B6, C7–C8 passed.

docs/work-items/ORCH-082/00-business-request.md

@@ -1,7 +0,0 @@
-# Business Request: ORCH-81: конвейер не создаёт PR для ветки → деплой стопорится на merge-verify (HOLD)
-
-Work Item ID: ORCH-082
-
-## Description
-
-TBD

docs/work-items/ORCH-082/01-brd.md

@@ -1,119 +0,0 @@
-# 01 — BRD: ORCH-082 (ORCH-81)
-
-**Конвейер не создаёт PR для ветки → деплой стопорится на merge-verify (HOLD)**
-
-- Work Item: **ORCH-082** (Plane-заголовок «ORCH-81»)
-- Repo: `orchestrator` (self-hosting)
-- Тип: **Багфикс / надёжность конвейера**
-- Приоритет: **HIGH** — блокирует автономный деплой
-- Зона: создание PR (reviewer/developer/deployer пути), `src/merge_gate.py`, `src/stage_engine.py` (`_handle_merge_verify`), `src/agents/launcher.py` (`_ensure_pr`)
-
----
-
-## 1. Контекст и проблема
-
-При деплое **ORCH-074** (08.06, статус «Confirm Deploy») детерминированный finalizer
-(`run_deploy_finalizer` → под-гейт `_handle_merge_verify`) вызвал
-`merge_gate.merge_pr(repo, branch)` и получил **`ok=False` («no open PR»)**: в Gitea для
-ветки `feature/ORCH-074-…` **не существовало открытого PR** с `head.ref==branch` и
-`base.ref=="main"`.
-
-Защита **ORCH-073** (fail-closed по «SHA-в-main») отработала **корректно**: задача удержана
-на стадии `deploy` (НЕ `done`), Plane → Blocked, Telegram-alert, ложно-зелёного `done` не
-произошло. Это **правильное** поведение для случая «merge реально невозможен».
-
-**Дефект не в защите, а в инварианте до неё:** автономный конвейер **не гарантировал**, что к
-моменту merge у ветки существует открытый PR. PR на сегодня создаётся ровно в одном месте —
-`launcher._ensure_pr`, вызываемом **только** на пути `agent == "developer"` и **только** когда
-в этом конкретном run был непустой git-diff, успешный commit и успешный push (см. root-cause
-ниже). Любой сценарий, где developer-run не произвёл свежий коммит, оставляет ветку **без PR**,
-и задача неминуемо застревает на merge-verify.
-
-### Workaround, применённый вручную (НЕ фикс)
-PR #79 создан вручную через Gitea API (`mergeable=True`) → штатно перезапущен
-`run_deploy_finalizer` → `merge_pr` честно влил код в `main` → задача `done`. Это разовое ручное
-вмешательство, **не** устранение причины.
-
-### Почему это системный пробел, а не разовый сбой
-Так как создание PR **не гарантировано конвейером**, любая следующая задача с тем же стечением
-обстоятельств (developer-run без нового коммита; тихо упавший вызов создания PR; ветка
-восстановлена/пересоздана вручную) застрянет на merge-verify тем же образом. Автономность
-деплоя (цель ORCH-54) этим заблокирована.
-
----
-
-## 2. Root cause (предварительный аудит кода — подтвердить логами G1)
-
-PR создаётся **исключительно** функцией `AgentLauncher._ensure_pr` (`src/agents/launcher.py`),
-которая вызывается из `_monitor_agent` по цепочке условий:
-
-```
-exit_code == 0
-  → есть worktree-изменения (git status --porcelain непусто)
-    → git commit succeeded
-      → git push succeeded
-        → agent == "developer"   ←── ТОЛЬКО здесь вызывается self._ensure_pr(...)
-```
-
-Отсюда минимум три структурных способа остаться без PR:
-
-- **R-A (условное создание).** Если developer-run завершился без изменений (`git status`
-  пустой) — ветка уже была закоммичена/запушена в прошлый run, бойнс REQUEST_CHANGES без новых
-  правок, повторный прогон, или ручное восстановление ветки — `_ensure_pr` **не вызывается
-  вовсе**. PR не появится никогда. (Соответствует гипотезе ТЗ №2.)
-- **R-B (тихий сбой создания).** `_ensure_pr` ловит любое исключение
-  (`except Exception → logger.error → return None`): транзиентная ошибка Gitea на шаге
-  `POST …/pulls` теряется без ретрая и без эскалации. Конвейер «думает», что developer
-  отработал, и едет дальше. (Гипотеза ТЗ №1 — silent fail.)
-- **R-C (разъехавшееся состояние ветки/PR).** ORCH-074 — первая задача после серии ручных
-  восстановлений `main` 08.06. PR мог быть закрыт/пересоздан, либо у ветки остался только
-  авто-docs-PR (`base != main`), который `merge_pr`/`pr_already_merged` корректно НЕ считают
-  кодовым PR. (Гипотеза ТЗ №4.)
-
-Идемпотентность (гипотеза №3): сам `_ensure_pr` идемпотентен на чтении (сначала `GET …open&head`,
-создаёт только если пусто), но он не запускается вне «свежий developer-коммит», поэтому
-идемпотентность не достигает merge-стадии — никакой флаг «PR создан» в БД не хранится.
-
-**Вывод:** гарантия «к моменту merge у ветки есть открытый код-PR» в конвейере **отсутствует**.
-
----
-
-## 3. Бизнес-цели
-
-| ID | Цель |
-|----|------|
-| **G1** | Установить и задокументировать точную причину отсутствия PR на ORCH-074 (код-аудит + логи run_id 396/398). |
-| **G2** | Гарантировать инвариант: к моменту merge-verify у ветки **есть** открытый код-PR; если его нет — finalizer/deployer создаёт его сам, **идемпотентно**, ПЕРЕД `merge_pr`, вместо HOLD на ручное вмешательство. |
-| **G3** | Явно логировать факт PR: **PR-created / PR-existed / PR-create-failed** (наблюдаемость). |
-
-## 4. Не-цели (явные границы)
-
-- НЕ ослаблять защиту ORCH-073: fail-closed по «SHA-в-main» остаётся. Реальная невозможность
-  merge → по-прежнему HOLD + alert.
-- НЕ авто-мержить без PR (PR — обязательный артефакт ревью/слияния).
-- НЕ создавать PR в неподходящий момент — только на ребре `deploy → done`, ПОСЛЕ прохождения
-  всех гейтов (security/merge-gate/staging/image-freshness уже пройдены).
-- НЕ менять `STAGE_TRANSITIONS`, реестр `QG_CHECKS`, схему БД, контракты `check_deploy_status`,
-  exit-коды хука.
-
-## 5. Заинтересованные стороны
-- **Owner** (homenet542) — автономность деплоя орка.
-- Все проекты на инстансе (enduro-trails) — общий прод/очередь: ложный HOLD self-задачи не
-  должен требовать ручного вмешательства, а реальный дефект merge — обязан удерживаться.
-
-## 6. Бизнес-риски и допущения
-- **Грабли (из ORCH-073):** у ветки может быть несколько PR (код-PR + авто docs-PR). Создание/
-  выбор PR обязан фильтровать `head.ref==branch` И `base.ref=="main"`, иначе слияние/верификация
-  схватят не тот PR.
-- **Допущение:** merge-verify исполняется ПОСЛЕ всех гейтов, поэтому создание PR именно здесь не
-  обходит ревью и безопасно по времени.
-- **Контракт надёжности:** весь новый путь — **never-raise**; ошибка создания PR (Gitea
-  недоступна) → честный HOLD + alert, а не исключение в `advance_stage`.
-
-## 7. Definition of Done (бизнес-уровень)
-1. Root cause задокументирован (`06-adr/` архитектором, ссылка из ADR на этот BRD).
-2. После фикса задача с веткой без PR не зависает: конвейер создаёт PR идемпотентно и доводит до
-   `done` (при честном merge).
-3. Защита ORCH-073 цела (регресс-тест на «код не в main» → HOLD).
-4. Логи различают created/existed/failed.
-5. `pytest` зелёный; never-raise соблюдён.

docs/work-items/ORCH-082/02-trz.md

@@ -1,108 +0,0 @@
-# 02 — ТЗ: ORCH-082 (ORCH-81)
-
-**Гарантированный идемпотентный код-PR перед merge-verify + наблюдаемость**
-
-> Машина стадий, реестр `QG_CHECKS`, схема БД, exit-коды хука, контракты
-> `check_deploy_status`/`_parse_deploy_status`, защита ORCH-073 (SHA-в-main) — **НЕ меняются**.
-> Изменение — точечная врезка «ensure PR» в под-гейт merge-verify + новый идемпотентный
-> PR-актор в `merge_gate` + структурное логирование.
-
----
-
-## 1. Задействованные модули `src/`
-
-| Модуль | Роль в задаче | Характер изменения |
-|--------|---------------|--------------------|
-| `src/merge_gate.py` | leaf-логика merge-актора (`merge_pr`, `verify_merged_to_main`, `pr_already_merged`) | **+ новый идемпотентный актор** `ensure_open_pr(repo, branch) -> (status, detail)` (never-raise). |
-| `src/stage_engine.py` | под-гейт `_handle_merge_verify` на ребре `deploy → done` | **врезка:** вызвать `ensure_open_pr` ПЕРЕД `merge_pr`; на `failed` → честный HOLD+alert; логировать исход. |
-| `src/agents/launcher.py` | `_ensure_pr` (текущий единственный создатель PR) | **усилить наблюдаемость** (различать created/existed/failed) — опционально переиспользовать новый актор `merge_gate.ensure_open_pr`, чтобы создание PR было единым кодом. Поведение «создавать только у developer» НЕ ужесточать без необходимости. |
-| `src/config.py` | флаги | **+ kill-switch** `merge_verify_autocreate_pr_enabled` (дефолт `True`), область — та же `merge_verify_applies` (self-hosting / `merge_verify_repos`). |
-| `docs/architecture/README.md`, `CHANGELOG.md` | golden source | обновить (раздел ORCH-071/073 merge-verify — дописать про авто-создание PR). |
-
-> Точная сигнатура `ensure_open_pr`, имя/дефолт kill-switch и место врезки — за архитектором
-> (ADR). Ниже — функциональные требования к поведению, не финальный дизайн.
-
-## 2. Функциональные требования
-
-### FR-1 — Идемпотентный PR-актор `merge_gate.ensure_open_pr(repo, branch)`
-Возвращает структурированный исход (например `("existed"|"created"|"failed", detail)`):
-1. `GET …/pulls?state=open` → если есть PR с **`head.ref==branch` И `base.ref=="main"`** →
-   `("existed", <number>)`. **Фильтр идентичен `merge_pr`/ORCH-073 FR-3** — авто-docs-PR
-   (`base != main`) НЕ считается код-PR.
-2. Иначе `POST …/pulls` (`head=branch`, `base=main`, заголовок/тело — авто) → `201` →
-   `("created", <number>)`.
-3. Идемпотентность: если параллельно PR уже создан и Gitea вернёт ошибку «PR exists» —
-   повторный `GET` подтверждает существующий PR и возвращает `("existed", …)`, **дубль не
-   плодится** (AC-2).
-4. Любая иная ошибка HTTP/parse/сети → `("failed", <reason>)`. **Never-raise.**
-
-### FR-2 — Врезка в `_handle_merge_verify` (ребро `deploy → done`)
-Внутри существующего `_handle_merge_verify`, ПОСЛЕ `merge_verify_applies(repo)`-гейта и
-резолва `validated_revision`, но **ПЕРЕД** `merge_pr`:
-- если `merge_verify_autocreate_pr_enabled` → вызвать `ensure_open_pr(repo, branch)`;
-- `status == "created"|"existed"` → продолжить штатно к `merge_pr` → `verify_merged_to_main`;
-- `status == "failed"` → **честный HOLD + alert** (как сегодняшний not-merged путь:
-  `note_not_merged_alert` + `set_issue_blocked` + Plane-коммент + Telegram; задача остаётся на
-  `deploy`, НЕ `done`, БЕЗ отката на development) с сообщением, отражающим «PR создать не
-  удалось» (а не «PR не влит»).
-- kill-switch off → текущее поведение 1:1 (никакого создания PR).
-
-### FR-3 — Защита ORCH-073 цела (регресс-инвариант)
-Создание PR **не подменяет** проверку слияния. После `ensure_open_pr` + `merge_pr` верификация
-остаётся **только** `verify_merged_to_main` (SHA-в-main, ORCH-073 FR-1) + регресс-гард
-(`check_main_regression`). Если код реально не оказался в `main` — HOLD сохраняется. Создание PR
-лишь устраняет **ложный** HOLD «no open PR», который конвейер обязан был предотвратить.
-
-### FR-4 — Наблюдаемость (G3)
-В лог писать однозначный исход на каждом из мест работы с PR:
-- `merge-verify ensure_open_pr -> created PR #N` /
-- `… -> existed PR #N` /
-- `… -> failed: <reason>`.
-Сообщение HOLD при `failed` обязано отличаться текстом от HOLD «not merged» (оператор должен
-видеть, что причина — невозможность создать PR, а не невозможность слить уже созданный).
-Желательно — пометка исхода в `14-deploy-log.md` (best-effort, frontmatter `deploy_status:`
-нетронут).
-
-### FR-5 — Идемпотентность повторного прохода
-Повторный заход в merge-verify (reaper / reconciler / повторный approve) при уже существующем
-PR → `ensure_open_pr` возвращает `("existed", …)`, `merge_pr` → `already-merged`/штатно — **без
-дублей PR и без побочных эффектов** (INV-5/AC-9 ORCH-073 сохранены).
-
-## 3. Изменения API (HTTP / внутренние)
-- **Внешний HTTP API сервиса — без изменений** (новых endpoint нет).
-- **Исходящие вызовы Gitea:** новый `POST /api/v1/repos/{owner}/{repo}/pulls` из контекста
-  merge-verify (тот же вызов, что уже делает `_ensure_pr`); чтение — существующий
-  `GET …/pulls?state=open`.
-- **Внутренний контракт `merge_gate`:** новая публичная функция `ensure_open_pr` (leaf,
-  never-raise), вызывается из `stage_engine._handle_merge_verify` (и опционально из
-  `launcher._ensure_pr`).
-
-## 4. Изменения схемы БД
-**Нет.** Состояние идемпотентности выводится из самого Gitea (наличие открытого PR), миграции
-не требуются. (Согласуется с restart-safe-моделью merge-verify.)
-
-## 5. Требования к новым QG checks
-**Новых зарегистрированных QG-checks нет.** Это под-гейт-врезка в `advance_stage`
-(`_handle_merge_verify`), как и сам ORCH-071 merge-verify — не отдельный `QG_CHECKS`-элемент.
-Реестр `QG_CHECKS` не трогается.
-
-## 6. Конфигурация / kill-switch
-- `merge_verify_autocreate_pr_enabled: bool = True` (env `ORCH_MERGE_VERIFY_AUTOCREATE_PR_ENABLED`).
-  `False` → ровно прежнее поведение (нет авто-создания PR; «no open PR» → HOLD как раньше).
-- Область действия — `merge_gate.merge_verify_applies(repo)`: реально только для self-hosting /
-  `merge_verify_repos`; прочие репо — no-op.
-
-## 7. Артефакты pipeline (создать/обновить)
-- `docs/work-items/ORCH-082/06-adr/ADR-001-*.md` — архитектор (root cause G1 + дизайн ensure-PR).
-- `12-review.md`, `13-test-report.md`, `14/15/16-*` — последующие стадии.
-- Обновить `docs/architecture/README.md` (блок ORCH-071/073) и `CHANGELOG.md` — в ТОМ ЖЕ PR
-  (правило агентов №2/№6).
-
-## 8. Инварианты (не нарушать)
-- `STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД, `check_deploy_status`/`_parse_deploy_status`,
-  exit-коды хука, terminal-sync, merge-gate (ORCH-043), image-freshness (ORCH-058) — **без
-  изменений**.
-- Контракт **never-raise** на всём пути merge-verify (INV-1 ORCH-073).
-- Слияние только через PR (`POST /pulls/{index}/merge`); `main` никогда не push/force-push.
-- Защита ORCH-073 (SHA-в-main + регресс-гард) приоритетна: при конфликте «создать PR» проигрывает
-  «не дать ложно-зелёный done».

docs/work-items/ORCH-082/03-acceptance-criteria.md

@@ -1,69 +0,0 @@
-# 03 — Критерии приёмки: ORCH-082 (ORCH-81)
-
-Каждый критерий — однозначное условие PASS/FAIL. Машинные вердикты гейтов — только из
-YAML-frontmatter.
-
----
-
-### AC-1 — Root cause задокументирован
-- **PASS:** в `06-adr/ADR-001-*.md` зафиксировано, **почему** PR не создался на ORCH-074
-  (со ссылкой на код-путь `launcher._ensure_pr` и/или логи run_id 396/398), и какая из гипотез
-  R-A/R-B/R-C подтвердилась.
-- **FAIL:** причина не названа / только догадка без привязки к коду или логам.
-
-### AC-2 — Гарантированный идемпотентный код-PR к merge-verify
-- **PASS:** к моменту merge-verify у ветки гарантированно существует открытый PR с
-  `head.ref==branch` И `base.ref=="main"`; повторный вызов авто-создания при уже существующем PR
-  **не плодит дубль** (возвращает existed).
-- **FAIL:** при отсутствии PR задача сразу уходит в HOLD; ИЛИ повторный проход создаёт второй PR.
-
-### AC-3 — Авто-создание PR ПЕРЕД merge_pr (вместо немедленного HOLD)
-- **PASS:** при физическом отсутствии открытого код-PR `_handle_merge_verify` сначала создаёт PR
-  (`ensure_open_pr → created`), затем выполняет `merge_pr` → `verify_merged_to_main`; ложного
-  HOLD «no open PR» не возникает.
-- **FAIL:** «no open PR» по-прежнему приводит к HOLD без попытки создать PR (при включённом
-  kill-switch).
-
-### AC-4 — Защита ORCH-073 цела (регресс)
-- **PASS:** при реальном «код не в `main`» (`verify_merged_to_main → False`) — по-прежнему HOLD +
-  alert + `set_issue_blocked`, задача НЕ `done`, БЕЗ авто-отката на development. Регресс-гард
-  `check_main_regression` не ослаблен.
-- **FAIL:** создание PR маскирует невлитый код и пропускает задачу в `done`; ИЛИ ослаблен
-  SHA-в-main / регресс-гард.
-
-### AC-5 — Логи различают исход PR
-- **PASS:** в логах присутствует ровно один однозначный исход на проход: **PR-created** /
-  **PR-existed** / **PR-create-failed**; HOLD по «create-failed» текстуально отличим от HOLD
-  «not merged».
-- **FAIL:** исход не логируется или created/existed/failed неразличимы.
-
-### AC-6 — Грабли мультиPR: фильтр base==main
-- **PASS:** при наличии у ветки авто-docs-PR (`base != main`) актор НЕ принимает его за код-PR и
-  создаёт/выбирает именно PR на `main`.
-- **FAIL:** docs-PR трактуется как код-PR (слияние/верификация работают не с тем PR).
-
-### AC-7 — Never-raise + честный HOLD при недоступности Gitea
-- **PASS:** при ошибке создания PR (Gitea недоступна/HTTP-ошибка) `ensure_open_pr` возвращает
-  `failed`, путь merge-verify даёт честный HOLD+alert, исключение НЕ всплывает в `advance_stage`.
-- **FAIL:** исключение пробрасывается / процесс падает / задача молча уходит в `done`.
-
-### AC-8 — Kill-switch off → прежнее поведение 1:1
-- **PASS:** при `merge_verify_autocreate_pr_enabled=False` авто-создание не выполняется; «no open
-  PR» → HOLD как до фикса (поведение ORCH-074 воспроизводится).
-- **FAIL:** при выключенном флаге PR всё равно создаётся.
-
-### AC-9 — Условность (область self-hosting)
-- **PASS:** для не-self репозиториев (`merge_verify_applies → False`) врезка — no-op; создание PR
-  остаётся за прежним механизмом.
-- **FAIL:** авто-создание срабатывает для чужих репо.
-
-### AC-10 — Инварианты не нарушены
-- **PASS:** `STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД, `check_deploy_status`, exit-коды хука,
-  merge-gate/image-freshness — без изменений; `main` не push/force-push; документация
-  (`README.md`, `CHANGELOG.md`) обновлена в этом же PR.
-- **FAIL:** затронут любой из перечисленных инвариантов / документация не обновлена.
-
-### AC-11 — pytest зелёный
-- **PASS:** `pytest tests/ -q` зелёный, включая новые тесты из `04-test-plan.yaml` и
-  существующие `test_merge_verify*.py` / `test_orch073_*` / `test_merge_actor.py`.
-- **FAIL:** любой тест падает.

docs/work-items/ORCH-082/04-test-plan.yaml

@@ -1,90 +0,0 @@
-work_item: ORCH-082
-title: "Гарантированный идемпотентный код-PR перед merge-verify (фикс ложного HOLD)"
-strategy: >
-  Юнит-тесты на новый идемпотентный актор merge_gate.ensure_open_pr (мок Gitea HTTP)
-  и интеграционные тесты на врезку в stage_engine._handle_merge_verify (мок merge_gate
-  + verify), включая регресс ORCH-073. Все пути — never-raise. Gitea и git мокаются,
-  сеть не дёргается.
-
-tests:
-  # ---- ensure_open_pr: идемпотентный PR-актор (FR-1) ----
-  - id: TC-01
-    type: unit
-    description: "ensure_open_pr: открытого код-PR нет -> POST создаёт PR -> ('created', N); фильтр base==main применён"
-    module: tests/test_orch082_ensure_pr.py
-    expected: PASS
-
-  - id: TC-02
-    type: unit
-    description: "ensure_open_pr: открытый PR head==branch И base==main уже есть -> ('existed', N), POST не вызывается (нет дубля)"
-    module: tests/test_orch082_ensure_pr.py
-    expected: PASS
-
-  - id: TC-03
-    type: unit
-    description: "Грабли мультиPR: у ветки только docs-PR (base!=main) -> он НЕ считается код-PR -> создаётся PR на main (AC-6)"
-    module: tests/test_orch082_ensure_pr.py
-    expected: PASS
-
-  - id: TC-04
-    type: unit
-    description: "ensure_open_pr never-raise: Gitea POST/GET кидает HTTP/timeout -> ('failed', reason), исключение не всплывает (AC-7)"
-    module: tests/test_orch082_ensure_pr.py
-    expected: PASS
-
-  - id: TC-05
-    type: unit
-    description: "Идемпотентность гонки: POST вернул 'PR exists' -> повторный GET подтверждает существующий -> ('existed', N), дубль не создан"
-    module: tests/test_orch082_ensure_pr.py
-    expected: PASS
-
-  # ---- _handle_merge_verify: врезка ensure-PR (FR-2/FR-3) ----
-  - id: TC-06
-    type: integration
-    description: "merge-verify: PR отсутствовал -> ensure_open_pr создаёт -> merge_pr -> verify True -> deploy->done БЕЗ ложного HOLD (AC-3)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  - id: TC-07
-    type: integration
-    description: "Регресс ORCH-073: PR создан/влит, но verify_merged_to_main=False (код не в main) -> HOLD + set_issue_blocked, НЕ done, без отката (AC-4)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  - id: TC-08
-    type: integration
-    description: "ensure_open_pr -> 'failed' (Gitea down) -> честный HOLD+alert, текст отличается от 'not merged', advance_stage не падает (AC-7)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  - id: TC-09
-    type: integration
-    description: "Kill-switch merge_verify_autocreate_pr_enabled=False -> ensure_open_pr не вызывается, 'no open PR' -> прежний HOLD 1:1 (AC-8)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  - id: TC-10
-    type: integration
-    description: "Условность: non-self репо (merge_verify_applies=False) -> врезка no-op, авто-создание не выполняется (AC-9)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  - id: TC-11
-    type: integration
-    description: "Идемпотентный повторный проход (reaper/reconciler): PR уже existed, merge_pr=already-merged -> verify True -> done, без дублей PR (AC-2/FR-5)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  # ---- Наблюдаемость (G3 / AC-5) ----
-  - id: TC-12
-    type: unit
-    description: "Логи различают created/existed/failed; HOLD-сообщение create-failed != HOLD-сообщение not-merged (caplog, AC-5)"
-    module: tests/test_orch082_merge_verify_autocreate.py
-    expected: PASS
-
-  # ---- Регресс существующего merge-verify контракта ----
-  - id: TC-13
-    type: integration
-    description: "Happy-path ORCH-071/073 не изменён: merge_pr ok + verify True + регресс-гард ok -> done, merged_to_main: true во frontmatter"
-    module: tests/test_merge_verify.py
-    expected: PASS

docs/work-items/ORCH-082/06-adr/ADR-001-ensure-open-pr-before-merge-verify.md

@@ -1,221 +0,0 @@
-# ADR-001: Гарантированный идемпотентный код-PR перед merge-verify (ensure_open_pr)
-
-- Work Item: **ORCH-082** (Plane-заголовок «ORCH-81»)
-- Repo: `orchestrator` (self-hosting)
-- Связь: амендмент к merge-verify ([adr-0013](../../../architecture/adr/adr-0013-merge-verify-gate.md),
-  [adr-0014](../../../architecture/adr/adr-0014-merge-verify-sha-source-of-truth.md));
-  глобально зафиксировано в [adr-0016](../../../architecture/adr/adr-0016-ensure-open-pr-before-merge-verify.md)
-- BRD/ТЗ/AC: `01-brd.md`, `02-trz.md`, `03-acceptance-criteria.md`
-
-## Статус
-Accepted
-
-## Контекст
-
-### Что случилось (инцидент ORCH-074, 08.06)
-Деплой ORCH-074 встал на под-гейте merge-verify (ребро `deploy → done`):
-`run_deploy_finalizer → _handle_merge_verify` вызвал `merge_gate.merge_pr(repo, branch)` и
-получил `ok=False, "no open PR"` — в Gitea для ветки `feature/ORCH-074-…` **не было открытого
-PR** с `head.ref==branch` И `base.ref=="main"`. Защита ORCH-073 (fail-closed по «SHA-в-main»)
-**отработала правильно**: задача удержана на `deploy` (НЕ `done`), Plane → Blocked, Telegram-alert,
-ложно-зелёного `done` не произошло. Разблокировано вручную — PR #79 создан через Gitea API,
-finalizer перезапущен, код честно влит, задача `done`. Это **workaround, не фикс**.
-
-### Root cause (G1, подтверждён код-аудитом)
-PR создаётся в конвейере **ровно в одном месте** — `AgentLauncher._ensure_pr`
-(`src/agents/launcher.py:1079`), и вызывается он из `_monitor_agent` **только** по цепочке
-условий (`src/agents/launcher.py:751–753`):
-
-```
-exit_code == 0
-  → git status --porcelain непусто (есть worktree-изменения)
-    → git commit succeeded
-      → git push succeeded
-        → agent == "developer"   ←── ТОЛЬКО здесь вызывается self._ensure_pr(...)
-```
-
-Отсюда класс «ветка без PR» структурно неизбежен. Подтверждённые код-аудитом ветви:
-
-- **R-A (условное создание) — структурный первопричинный дефект.** Если в конкретном
-  developer-run нет свежих изменений (`git status` пуст: ветка уже была закоммичена/запушена
-  ранее, бойнс REQUEST_CHANGES без новых правок, повторный прогон, **ручное восстановление
-  ветки**) — `_ensure_pr` **не вызывается вовсе**. PR не появится никогда. Никакого
-  персистентного флага «PR создан» в БД нет, поэтому идемпотентность чтения внутри `_ensure_pr`
-  до merge-стадии не доходит.
-- **R-C (разъехавшееся состояние ветки/PR) — проксимальный триггер ORCH-074.** ORCH-074 — первая
-  задача после серии **ручных восстановлений `main` 08.06**: открытый код-PR был закрыт/не
-  пересоздан, у ветки мог остаться лишь авто-docs-PR (`base != main`), который `merge_pr` (фильтр
-  `base=="main"`, ORCH-073 FR-3) корректно НЕ считает кодовым.
-- **R-B (тихий сбой создания) — потенциальная, не первопричина здесь.** `_ensure_pr` глотает любое
-  исключение (`except Exception → logger.error → return None`): транзиентная ошибка Gitea на
-  `POST …/pulls` теряется без ретрая и эскалации.
-
-**Вывод:** в конвейере **отсутствует инвариант** «к моменту merge-verify у ветки есть открытый
-код-PR». Защита ORCH-073 верно ловит следствие, но причина — выше по потоку. Любая следующая
-задача с тем же стечением обстоятельств застрянет тем же образом → автономный деплой (ORCH-54)
-заблокирован.
-
-### Ограничения, которые нельзя нарушать
-- Защита ORCH-073 (SHA-в-main + регресс-гард) — приоритетна. Создание PR **не должно** маскировать
-  реально невлитый код.
-- `STAGE_TRANSITIONS`, реестр `QG_CHECKS`, схема БД, `check_deploy_status`/`_parse_deploy_status`,
-  exit-коды хука, merge-gate (ORCH-043), image-freshness (ORCH-058) — без изменений.
-- Весь путь merge-verify — **never-raise**.
-- Слияние только через PR; `main` никогда не push/force-push.
-
-## Решение
-
-Закрыть пробел инвариантом «обеспечить открытый код-PR» **внутри того же под-гейта merge-verify**,
-ПЕРЕД детерминированным `merge_pr`. Три точечные врезки, симметричные существующему дизайну
-ORCH-071/073 (leaf-актор в `merge_gate` + врезка в `_handle_merge_verify` + kill-switch). Машина
-стадий и реестры не трогаются.
-
-### Р-1. Новый идемпотентный leaf-актор `merge_gate.ensure_open_pr(repo, branch)`
-
-Сигнатура (решение архитектора по ТЗ §1):
-
-```python
-def ensure_open_pr(repo: str, branch: str) -> tuple[str, str]:
-    """Гарантировать открытый код-PR (head==branch, base==main). never-raise.
-    Возврат: ("existed", "<number>") | ("created", "<number>") | ("failed", "<reason>").
-    """
-```
-
-Алгоритм (FR-1):
-1. `GET …/pulls?state=open` → найти PR с **`head.ref==branch` И `base.ref=="main"`**. Фильтр
-   **идентичен** `merge_pr`/ORCH-073 FR-3 — авто-docs-PR (`base != main`) НЕ считается код-PR
-   (AC-6). Нашли → `("existed", <number>)`.
-2. Иначе `POST …/pulls` (`head=branch`, `base="main"`, авто-заголовок/тело) → `201` →
-   `("created", <number>)`.
-3. **Идемпотентность при гонке:** если на `POST` Gitea вернёт «PR exists»/`409`/`422` —
-   повторный `GET` (шаг 1) подтверждает существующий PR → `("existed", …)`. Дубль не плодится
-   (AC-2, FR-5).
-4. Любая иная HTTP/parse/сетевая ошибка → `("failed", <reason>)`. **Never-raise** (`except
-   Exception → ("failed", str(e))`).
-
-Актор — **leaf** (зависит только от `settings` + `httpx`, без импорта `stage_engine`), как
-`merge_pr`/`verify_merged_to_main`. Таймауты — переиспользовать `settings.merge_pr_timeout_s`
-(тот же класс Gitea-вызовов).
-
-> **Почему фильтр `base=="main"` критичен** (грабли ORCH-073): у ветки одновременно бывают код-PR
-> и авто-docs-PR. Без фильтра актор «увидит» docs-PR как existed и не создаст нужный код-PR, а
-> `merge_pr` потом не найдёт что мержить → петля. Один и тот же предикат `head==branch &&
-> base=="main"` гарантирует, что `ensure_open_pr` и `merge_pr` работают с одним и тем же PR.
-
-### Р-2. Врезка в `_handle_merge_verify` (ребро `deploy → done`)
-
-В существующем `_handle_merge_verify` (`src/stage_engine.py:1324`), **ПОСЛЕ**
-`merge_verify_applies(repo)`-гейта и резолва `sha = image_freshness.validated_revision(...)`,
-но **ПЕРЕД** `merge_pr`:
-
-```python
-sha = image_freshness.validated_revision(repo, branch)
-
-# ORCH-082: гарантировать открытый код-PR ДО детерминированного merge_pr.
-if settings.merge_verify_autocreate_pr_enabled:
-    pr_status, pr_detail = merge_gate.ensure_open_pr(repo, branch)
-    logger.info(
-        f"Task {task_id}: merge-verify ensure_open_pr -> {pr_status} ({pr_detail})"
-    )
-    if pr_status == "failed":
-        return _hold_pr_create_failed(
-            task_id, repo, work_item_id, branch, pr_detail, result
-        )
-    # "created" | "existed" -> штатно продолжаем к merge_pr.
-
-merged_ok, merge_msg = merge_gate.merge_pr(repo, branch)
-...
-```
-
-Семантика (FR-2):
-- `created | existed` → продолжаем штатно к `merge_pr` → `verify_merged_to_main` → регресс-гард.
-- `failed` → **честный HOLD + alert** через новый helper `_hold_pr_create_failed` (см. Р-3); задача
-  остаётся на `deploy` (НЕ `done`), БЕЗ отката на development — симметрично текущему not-merged/
-  regressed HOLD.
-- kill-switch off → блок пропускается целиком → поведение 1:1 как до фикса (AC-8).
-
-Место выбрано так, что **никакой существующий шаг не сдвигается**: `merge_pr` и
-`verify_merged_to_main` остаются на своих местах с теми же контрактами. Создание PR — это только
-страховка инварианта ДО них.
-
-### Р-3. Новый HOLD-helper `_hold_pr_create_failed` (распознаваемость причины, FR-4/AC-5)
-
-Зеркало существующего `_hold_main_regressed` (`src/stage_engine.py:1280`). Текст HOLD **обязан
-отличаться** от not-merged HOLD: оператор должен видеть, что причина — **невозможность создать
-PR** (Gitea недоступна), а не **невозможность слить уже созданный**:
-
-```python
-def _hold_pr_create_failed(task_id, repo, work_item_id, branch, reason, result) -> bool:
-    merge_gate.note_not_merged_alert(work_item_id)  # переиспользуем счётчик-нотификатор
-    msg = (f"PR создать не удалось: {reason} (repo={repo}, branch={branch}, "
-           f"wi={work_item_id}). Открытый код-PR отсутствует и не создан — задача "
-           f"удержана на `deploy` (НЕ done). Нужно проверить доступность Gitea / создать PR.")
-    # set_issue_blocked + plane_add_comment + send_telegram (каждый в try/except, never-break HOLD)
-    result.alerted = True
-    result.note = "pr-create-failed-hold"   # отличается от "merge-not-verified-hold"
-    result.advanced = False
-    return True
-```
-
-Это сохраняет инвариант «никогда не пробрасываем исключение в `advance_stage`»: `failed` —
-структурированный исход, а не throw.
-
-### Р-4. Единый источник кода создания PR (опционально, рекомендуется)
-
-`launcher._ensure_pr` рекомендуется **делегировать** в `merge_gate.ensure_open_pr`, чтобы создание
-PR жило в одном месте и одинаково логировало created/existed/failed (G3). **Поведенческий
-инвариант:** триггер «создавать PR только в developer-пути со свежим коммитом» **НЕ ужесточается**
-(BRD/ТЗ §1) — меняется лишь реализация под капотом, не условие вызова. Это снижает риск
-рассинхрона двух копий логики «выбрать/создать PR». Если делегирование увеличивает диффу/риск —
-допустимо оставить `_ensure_pr` как есть и лишь усилить его логирование (created/existed/failed);
-функциональная цель ORCH-082 достигается врезкой Р-2 независимо.
-
-### Р-5. Kill-switch и область действия
-
-- `merge_verify_autocreate_pr_enabled: bool = True`
-  (env `ORCH_MERGE_VERIFY_AUTOCREATE_PR_ENABLED`) в `src/config.py`, рядом с
-  `merge_verify_enabled`/`regression_guard_enabled`.
-- `False` → ровно прежнее поведение: авто-создания нет, «no open PR» → HOLD как в ORCH-074 (AC-8).
-- Область — `merge_gate.merge_verify_applies(repo)` (self-hosting / `merge_verify_repos`); прочие
-  репо — no-op, создание PR остаётся за прежним механизмом (AC-9). Отдельного `*_repos` для
-  авто-создания НЕ вводим: семантически оно неотделимо от merge-verify, у которого уже есть область.
-
-## Последствия
-
-### Плюсы
-- Закрыт структурный пробел: к merge-verify ветка гарантированно имеет открытый код-PR; ложный
-  HOLD «no open PR» больше не требует ручного вмешательства (AC-2/AC-3).
-- Защита ORCH-073 цела и приоритетна: верификация остаётся **только** `verify_merged_to_main`
-  (SHA-в-main) + `check_main_regression`. Реально невлитый код → HOLD как прежде (AC-4/FR-3).
-- Идемпотентность по факту Gitea (наличие открытого PR), без новой колонки/таблицы — согласуется с
-  restart-safe-моделью merge-verify; повторный заход (reaper/reconciler/re-approve) → `existed`,
-  дублей нет (FR-5/AC-2).
-- Распознаваемые исходы в логах и в HOLD-тексте: created / existed / failed (G3/AC-5).
-- Инварианты сохранены: `STAGE_TRANSITIONS`, `QG_CHECKS`, схема БД, `check_deploy_status`,
-  exit-коды хука, merge-gate, image-freshness — не тронуты (AC-10). `main` не push/force-push.
-
-### Минусы / ограничения
-- Auto-создание PR на ребре `deploy → done` означает, что код-PR может появиться **после** того,
-  как все гейты (security/merge-gate/staging/image-freshness) уже пройдены по ветке. Это безопасно
-  по времени (BRD §6 допущение): ревью/гейты валидируют **код ветки**, а PR — лишь механизм
-  слияния; merge-verify исполняется ПОСЛЕ всех гейтов. PR здесь не обходит ревью.
-- При недоступности Gitea задача попадёт в HOLD (как и сегодня) — но теперь с явным текстом
-  «PR создать не удалось» вместо «PR не влит». Это сознательный fail-closed (AC-7): never-raise,
-  честный HOLD, не ложно-зелёный `done`.
-- Небольшое дублирование Gitea-вызовов между `ensure_open_pr` и `merge_pr` (оба GET список PR). Это
-  приемлемо: два независимых leaf-актора с одинаковым фильтром важнее микро-оптимизации; объединять
-  в один вызов — увеличить связность без пользы.
-
-### Влияние на self-hosting
-Изменение строго аддитивно и под kill-switch (`True`). Прод-контейнер не рестартится этой задачей;
-выкат — через staging-гейт (8501) как любая ORCH-задача. На ребре `deploy → done` риск-профиль не
-растёт: при любом сбое — HOLD, не падение `advance_stage`, конвейер всех проектов не встаёт.
-
-## Связанные документы
-- BRD/ТЗ/AC: `01-brd.md`, `02-trz.md`, `03-acceptance-criteria.md`
-- Тех-риски: `10-tech-risks.md`
-- Глобальный амендмент: [adr-0016](../../../architecture/adr/adr-0016-ensure-open-pr-before-merge-verify.md)
-- Контекст merge-verify: [adr-0013](../../../architecture/adr/adr-0013-merge-verify-gate.md),
-  [adr-0014](../../../architecture/adr/adr-0014-merge-verify-sha-source-of-truth.md)
-- Постмортем фантомного merge: `docs/history/LESSONS_2026-06-08_phantom-merge.md`,
-  runbook `docs/operations/PHANTOM_MERGE_RUNBOOK.md`