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

Закрывает Type B эпика ORCH-10 (по ADR-001 ORCH-103, D1–D11):

- deploy/bundled/docker-compose.yml — самодостаточный compose всего стека
  (орк + watchdog + Gitea 1.22.6 + зеркало upstream Plane CE v0.23.1,
  ~14 контейнеров); project name orchestrator-bundle (узнаваемый префикс),
  container_name не пиннится, staging-контура нет; одна bridge-сеть,
  машинный трафик — сервис-DNS, наружу только человеческие порты;
  GITEA__webhook__ALLOWED_HOST_LIST=orchestrator; все образы пиннованы
  неподвижными тегами. Корневой compose/Dockerfile/src/** — байт-в-байт.
- deploy/bundled/.env.example — конфиг-канон bundle (плейсхолдеры, ни одного
  дефолтного пароля; key-set-sync интерполяций держит тест).
- scripts/bootstrap_bundle.py — python stdlib-only, режимы plan/apply/verify,
  step-движок check→ensure, exit 0/2/1: preflight (fail-fast до мутаций) →
  секреты (gen_secrets.py + stdlib secrets, без перетирания) → up+готовность →
  init Gitea автоматом → init Plane (manual-step с API-верификацией) →
  онбординг строго onboard_project.py apply+verify → token-remote клон →
  сборка .env/.env.watchdog (единственный писатель, права 600) → health.
  Delete-операций нет вообще (D9), секреты не печатаются (NFR-3).
- CHANGELOG.md, CLAUDE.md (абзац Type B), .gitignore (deploy/bundled/repos/).

Док BUNDLED_SETUP.md, REPLICATION §1, arch README, adr-0038 и три структурных
тест-модуля (TC-01…TC-11) — в предыдущих коммитах ветки; полный регресс
1844 passed, ruff по файлам задачи чистый.

Refs: ORCH-103

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.env.example

@@ -5,14 +5,68 @@ ORCH_PLANE_API_URL=http://plane-app-api-1:8000
 ORCH_PLANE_WEB_URL=
 ORCH_PLANE_API_TOKEN=
 ORCH_PLANE_WORKSPACE_SLUG=
+# Webhook secrets are GENERATED PER HOST: python3 scripts/gen_secrets.py
+# (ORCH-101 / AC-5: production secrets are NEVER copied to a new host).
 ORCH_PLANE_WEBHOOK_SECRET=
 ORCH_GITEA_URL=http://localhost:3000
+# External (browser) URL of Gitea for clickable Branch/PR links in comments;
+# empty -> falls back to ORCH_GITEA_URL.
+ORCH_GITEA_PUBLIC_URL=
 ORCH_GITEA_TOKEN=
 ORCH_GITEA_WEBHOOK_SECRET=
+ORCH_GITEA_OWNER=admin
+# Per-agent Plane bot tokens (optional): when set, comments are posted under
+# the matching bot so Plane shows the real author; empty -> ORCH_PLANE_API_TOKEN.
+ORCH_PLANE_BOT_ANALYST=
+ORCH_PLANE_BOT_ARCHITECT=
+ORCH_PLANE_BOT_DEVELOPER=
+ORCH_PLANE_BOT_REVIEWER=
+ORCH_PLANE_BOT_TESTER=
+ORCH_PLANE_BOT_DEPLOYER=
+ORCH_PLANE_BOT_STREAM=
+# Telegram live-tracker / alerts (empty -> notifications are logged, not sent).
+ORCH_TELEGRAM_BOT_TOKEN=
+ORCH_TELEGRAM_CHAT_ID=
+# ORCH-6: project registry — JSON array of {plane_project_id, repo,
+# work_item_prefix, name}. Empty -> built-in default registry (src/projects.py)
+# whose Plane UUIDs belong to the ORIGINAL host. On a NEW host this key is
+# MANDATORY (ORCH-101 replication checklist, docs/operations/REPLICATION.md).
+ORCH_PROJECTS_JSON=
 ORCH_CLAUDE_BIN=/usr/bin/claude
-ORCH_REPOS_DIR=/home/slin/repos
 ORCH_DB_PATH=/app/data/orchestrator.db
 
+# ── ORCH-101: host parametrization (replication foundation, ADR-001 D1–D7) ───
+# Every host-specific value lives HERE (defaults = the current production host;
+# an empty/absent value keeps behaviour 1:1). The same names are read by BOTH
+# pydantic Settings (env_file) and docker-compose ${VAR:-default} interpolation
+# (compose reads .env/shell, NOT a service's env_file). Full variable map and
+# the new-host procedure: docs/operations/REPLICATION.md.
+#   AGENT_HOME_DIR -> HOME of all actor subprocesses (agents/finalizer/monitor)
+#                     AND the target of the .claude/.claude.json/.ssh mounts AND
+#                     Dockerfile ARG APP_HOME (ORCH-040 group moves together).
+#   AGENT_GIT_NAME / GIT_EMAIL_DOMAIN -> git identity of agent commits; system
+#                     actors keep platform names deploy-finalizer/post-deploy-
+#                     monitor under the same domain.
+#   STAGING_PORT   -> staging instance port; image_freshness fail-closes when it
+#                     equals the prod port (ORCH-058 AC-9 guard).
+#   HOST_*         -> host-side sources of the bind mounts (repos, ~/.claude,
+#                     ~/.claude.json, ssh keydir, claude-code dist, node binary).
+#   RUN_UID/RUN_GID/DOCKER_GID -> container uid:gid + host docker group for
+#                     docker.sock access (group_add «МИНА 1», ORCH-040).
+ORCH_AGENT_HOME_DIR=/home/slin
+ORCH_AGENT_GIT_NAME=claude-bot
+ORCH_GIT_EMAIL_DOMAIN=mva154.local
+ORCH_STAGING_PORT=8501
+ORCH_HOST_REPOS_DIR=/home/slin/repos
+ORCH_HOST_CLAUDE_DIR=/home/slin/.claude
+ORCH_HOST_CLAUDE_JSON=/home/slin/.claude.json
+ORCH_HOST_SSH_DIR=/home/slin/.orchestrator-ssh
+ORCH_HOST_CLAUDE_CODE_DIR=/usr/lib/node_modules/@anthropic-ai/claude-code
+ORCH_HOST_NODE_BIN=/usr/bin/node
+ORCH_RUN_UID=1000
+ORCH_RUN_GID=1000
+ORCH_DOCKER_GID=999
+
 # ── 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/

.env.staging.example

@@ -36,6 +36,14 @@ ORCH_CLAUDE_BIN=/usr/bin/claude
 ORCH_REPOS_DIR=/repos
 ORCH_HOST_REPOS_DIR=/home/slin/repos
 
+# ── ORCH-101: host parametrization ───────────────────────────────────────────
+# The host keys (ORCH_AGENT_HOME_DIR / ORCH_AGENT_GIT_NAME / ORCH_GIT_EMAIL_DOMAIN /
+# ORCH_STAGING_PORT / ORCH_HOST_* / ORCH_RUN_* / ORCH_DOCKER_GID) default to the
+# current production host — set them ONLY on a new/different host (see
+# docs/operations/REPLICATION.md). NB: docker-compose ${VAR:-default}
+# interpolation reads the project .env / shell, NOT this env_file — values that
+# must reach compose (mounts/uid/ports) belong in .env, not here.
+
 # ── Database (ISOLATION KEY for staging) ─────────────────────────────────────
 # The staging volume mounts ./data/staging:/app/data, so the DB physically lives
 # at ./data/staging/orchestrator.db on the host — fully isolated from prod.

.env.watchdog.example

@@ -0,0 +1,42 @@
+# .env.watchdog — конфигурация sidecar-watchdog (контейнер orchestrator-watchdog).
+# Канонический example (ORCH-102, ADR-001 D5; симметрия .env.example/.env.staging.example).
+#
+# ⚠️ СЕМАНТИКА ФАЙЛА-НОСИТЕЛЯ: sidecar-контейнер читает ТОЛЬКО этот файл
+# (compose: env_file {path: .env.watchdog, required: false}). Ключ WATCHDOG_*,
+# положенный в .env, для sidecar ИНЕРТЕН (его видит лишь контейнер орка).
+# Отсутствие файла НЕ ломает `docker compose up` (required: false); нет токена →
+# fail-safe: watchdog пишет алерты в логи, но не отправляет.
+#
+# Создание на хосте: cp .env.watchdog.example .env.watchdog → заполнить два токена.
+# DO NOT COMMIT реальный .env.watchdog — этот файл только шаблон (зеркало
+# .env.staging.example); реальные значения живут на хосте.
+#
+# Нормативы:
+#   * C-1 (ORCH-100): у watchdog СВОЙ Telegram-бот — независимый канал алертов.
+#     Переиспользовать токен орка (ORCH_TELEGRAM_BOT_TOKEN) ЗАПРЕЩЕНО: упавший
+#     орк не сможет сообщить о себе своим же ботом.
+#   * Когерентность порта: WATCHDOG_METRICS_URL следует за прод-портом
+#     (ORCH_DEPLOY_PROD_TARGET_PORT) — сменил порт орка → обнови URL здесь.
+#   * Key-set этого файла = блок WATCHDOG_* в .env.example (канон ключей);
+#     синхронность держит tests/test_lite_setup_doc.py (key-sync, TC-02b).
+#     Значения = дефолты watchdog/config.py.
+
+WATCHDOG_ENABLED=true
+WATCHDOG_INTERVAL_S=30
+WATCHDOG_HTTP_TIMEOUT_S=5
+WATCHDOG_COOLDOWN_S=1800
+WATCHDOG_METRICS_URL=http://127.0.0.1:8500/metrics
+WATCHDOG_ORCH_DOWN_TICKS=3
+WATCHDOG_MEM_PCT=90
+WATCHDOG_DISK_CRIT_ENABLED=false
+WATCHDOG_DISK_CRIT_PCT=97
+WATCHDOG_DISK_PATHS=/repos,/app/data
+WATCHDOG_AGENT_HUNG_MIN=20
+WATCHDOG_AGENT_CPU_FLOOR=0.01
+WATCHDOG_STAGE_STUCK_MIN=120
+WATCHDOG_QUEUE_DEPTH=20
+WATCHDOG_CONTAINERS=orchestrator
+WATCHDOG_DOCKER_SOCK=/var/run/docker.sock
+WATCHDOG_DEPS=
+WATCHDOG_TG_BOT_TOKEN=
+WATCHDOG_TG_CHAT_ID=

.gitignore

@@ -7,5 +7,10 @@ data/
 .pytest_cache/
 # ORCH-31: staging env (secrets, not committed — see .env.staging.example)
 .env.staging
+# ORCH-102: sidecar-watchdog env (secrets, not committed — see .env.watchdog.example)
+.env.watchdog
 # ORCH-31: staging DB data directory
 data/staging/
+# ORCH-103: Bundled-тираж — локальные клоны репо bundle-инсталляции (целевой хост);
+# deploy/bundled/.env и deploy/bundled/data покрыты неякорными `.env` / `data/` выше
+deploy/bundled/repos/

.task-dev.md

@@ -1,4 +1,4 @@
-Work item: ORCH-009
+Work item: ORCH-103
 Repo: orchestrator
-Branch: feature/ORCH-009-turnkey-plane
+Branch: feature/ORCH-103-orch-10b-bundled-bootstrap
 Stage: development

CHANGELOG.md

@@ -3,6 +3,24 @@
 Формат: [Keep a Changelog](https://keepachangelog.com/). Записи — на смысловой PR/задачу.
 
 ## [Unreleased]
+- **ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт** (ORCH-103, `feat`): закрыт Type B эпика ORCH-10 — заказчик **без собственной инфраструктуры** получает конвейер «под ключ»: одна команда `docker compose -f deploy/bundled/docker-compose.yml up -d` поднимает весь стек (орк + watchdog + Gitea + зеркало upstream Plane CE ≈14 контейнеров), один прогон `scripts/bootstrap_bundle.py apply` доводит его до рабочего состояния. Рантайм байт-в-байт: `src/**`/корневой compose/`Dockerfile`/`STAGE_TRANSITIONS`/`QG_CHECKS`/схема БД — ноль изменений (паттерн ORCH-009/102, kill-switch не нужен — активация только явным запуском оператора на целевом хосте). ADR: `docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`, сквозной `adr-0038-bundled-replication-canon.md`.
+  - **Bundle-compose (D1–D4):** новый top-level каталог `deploy/` (дистрибутивы развёртывания); `deploy/bundled/docker-compose.yml` — один самодостаточный файл, project name `orchestrator-bundle` (узнаваемый префикс томов/контейнеров, по нему preflight детектирует «грязный хост»); `container_name` не пиннится (bundle и Lite не сталкиваются на одном хосте); staging-контура орка нет вовсе (self-hosting у заказчика = маршрут Lite). Все сторонние образы пиннованы неподвижными тегами (Plane CE v0.23.1 upstream-имена сервисов, Gitea 1.22.6, postgres/valkey/rabbitmq/minio). Сеть — одна bridge: машинный трафик строго сервис-DNS (`http://orchestrator:8500/webhook/plane|gitea`, `ORCH_GITEA_URL=http://gitea:3000`), наружу — только человеческие порты `BUNDLE_ORCH_PORT`/`BUNDLE_PLANE_PORT`/`BUNDLE_GITEA_HTTP_PORT`; postgres/redis/mq/minio не публикуются; мина Gitea закрыта `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator`. Конфиг-канон — `deploy/bundled/.env.example` (только плейсхолдеры, ни одного дефолтного пароля; key-set-sync интерполяций держит тест); runtime-конфиг орка/watchdog — корневые `.env`/`.env.watchdog` (канон Lite 1:1, `env_file required: false` — первый `up` живёт до сборки конфига).
+  - **Bootstrap (D5–D8):** `scripts/bootstrap_bundle.py` — python stdlib-only (модули платформы не импортируются, держится ast-сканом), режимы `plan` (дефолт, ноль мутаций) / `apply` / `verify`, step-движок check→ensure (повторный запуск = каскад skip, resume после manual-step = повторный запуск), exit-контракт 0/2/1. Шаги: preflight (fail-fast ДО мутаций: docker/compose, порты, RAM/диск, чистота хоста по префиксу) → секреты (webhook — **строго** субпроцессом `gen_secrets.py`; bundle-креды — stdlib `secrets`; существующие не перетираются без `--force-secrets`; значения не печатаются) → up+готовность (healthchecks + poll, migrator exit 0) → init Gitea полностью автоматом (`gitea admin user create`/`generate-access-token`; branch protection НЕ настраивается — норматив D10 ORCH-009/INV-4) → init Plane (честные manual-step c API-верификацией результата; workspace-webhook — ensure с fallback на manual-step) → онбординг sandbox-проекта **строго** `onboard_project.py apply+verify` (нулевой дрейф канона статусов/лейблов) → git-доступ агентов HTTP token-remote (ssh-контур не вводится) → сборка корневых `.env`/`.env.watchdog` (bootstrap — единственный писатель, права 600) → health/итоговая сводка PASS/FAIL. Delete-операций НЕТ вообще (D9): teardown — только документированная процедура.
+  - **Док-канон (D10):** `docs/deployment/BUNDLED_SETUP.md` — 14 разделов в порядке маршрута оператора (рамка → требования к хосту с цифрами RAM/диск/CPU и картой портов («Plane ≈ 14 контейнеров») → предусловия → код → секреты → запуск → bootstrap с перечнем manual-step → LLM/Telegram/онбординг ссылками на LITE_SETUP §7–§8/ONBOARDING → smoke (REPLICATION §4) → stateless-проверка → остановка/полный сброс → траблшутинг); каждый шаг = fenced-команда + «Проверка:» PASS/FAIL; REPLICATION.md §1 — строка Type B → ✅ ORCH-103. **Норматив сопровождения (NFR-5):** меняешь шаги Bundled-тиража → обнови BUNDLED_SETUP.md в том же PR.
+  - **Анти-дрейф (D11):** три структурных тест-модуля без docker/сети/LLM — `tests/test_bundle_compose.py` (состав сервисов, пины образов, изоляция томов, key-set-sync, заморозка корневого compose), `tests/test_bundled_setup_doc.py` (14 разделов, FORBIDDEN — импорт из `test_no_host_hardcodes.py`, секрет-эвристика hex≥32/alnum≥40, env-ключи ⊆ канонов, «22 статуса» импортом `plane_sync`, кросс-рефы, CHANGELOG), `tests/test_bootstrap_script.py` (кирпичи, stdlib-only, нет delete-операций/своего списка статусов, unit чистых функций preflight/плана/рендера, exit 0/2/1). `.gitignore` дополнен `deploy/bundled/repos/` (клоны целевого хоста не коммитятся; `.env`/`data/` уже покрыты неякорными паттернами).
+- **ORCH-10a Lite-тираж: инструкция LITE_SETUP + канон watchdog-конфига + анти-дрейф контур** (ORCH-102, `docs`): закрыт Type A эпика ORCH-10 — заказчик разворачивает у себя **только орк+watchdog** и донастраивает окружение (Plane/Gitea/Telegram/LLM) по одной сквозной инструкции «голый хост → работающий конвейер». **Docs+tests** (паттерн ORCH-077/092): `src/**`/`docker-compose.yml`/`Dockerfile`/`scripts/**` — ноль изменений; конвейер (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД) — байт-в-байт. ADR: `docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md`, сквозной `adr-0037-lite-replication-canon.md`.
+  - **Главный продукт (D1/D2):** новый docs-раздел `docs/deployment/` (витрина тиража, читатель — внешний оператор) с golden source `docs/deployment/LITE_SETUP.md` — 13 нормативных разделов в порядке маршрута оператора (рамка → предусловия хоста → перенос кода → конфигурация → Plane → Gitea → LLM → Telegram → запуск → регистрация проекта → smoke → stateless-проверка → траблшутинг ×7); каждый шаг = fenced-команда + явная «Проверка:»/PASS/FAIL; хост-специфика — только плейсхолдеры `<...>`/`$ENV_VAR`; канон не форкается — статусы/env/вебхуки/smoke ссылками на ONBOARDING §1 / REPLICATION §2–§4 / SETUP_WEBHOOKS.
+  - **Канон watchdog-конфига (D5, исход А-4):** новый `.env.watchdog.example` (третий env-example; key-set = блок `WATCHDOG_*` `.env.example`, 19 ключей, токены — пустые плейсхолдеры) закрывает ловушку файла-носителя: sidecar читает ТОЛЬКО `.env.watchdog`, ключ `WATCHDOG_*` в `.env` для него инертен; шапка несёт C-1 (ORCH-100: свой бот, токен орка переиспользовать запрещено) и когерентность порта `WATCHDOG_METRICS_URL` ⇄ `ORCH_DEPLOY_PROD_TARGET_PORT`; `.env.watchdog` добавлен в `.gitignore` (секрет-гигиена, зеркало `.env.staging`).
+  - **Нормативы разделов:** Gitea (D3, исход А-1) — branch protection на `main` НЕ включать (ADR D10 ORCH-009: ломает PR-merge API merge-актора → ложные HOLD; INV-4), pre-receive хуки платформа не вводит, ОДИН глобальный webhook-секрет на все репо; staging-вилка (D6, исход А-5) — базовый Lite-контур БЕЗ staging (нужен только под self-hosting развитие платформы); источник кода (D7, исход А-6) — параметризованный `git clone <ORCHESTRATOR_GIT_URL>`; stateless (AC-3) — пустая БД при первом старте, секреты только свежевыпущенные `gen_secrets.py`, явная проверка чистоты через `GET /queue`.
+  - **Анти-дрейф контур (D8):** новый `tests/test_lite_setup_doc.py` (25 структурных тестов, без сети/LLM/subprocess) — 13 разделов в порядке D2; обязательные кирпичи; key-sync `.env.watchdog.example` ⇄ `.env.example`; каждый упомянутый env-ключ существует в каноне; compose-подмножество (ровно 3 сервиса, staging строго за `profiles: [staging]`, дефолтный `up -d` = ровно орк+watchdog, анти-появление `plane*`/`gitea*`); fenced-скан боевых литералов (импорт `FORBIDDEN` из `test_no_host_hardcodes.py` — один источник истины) + эвристика секретоподобных значений с негативным самочеком; сверка «22 статуса» импортом `plane_sync._PLANE_NAME_TO_KEY`; перекрёстность REPLICATION→LITE_SETUP + CHANGELOG.
+  - **Перекрёстные доки (FR-7):** REPLICATION.md §1 — строка «Type A — Lite» → ✅ ORCH-102 + ссылка; README.md — способность Lite-тиража + `docs/deployment/` в структуре; INFRA.md — `.env.watchdog` в секрет-нормативе + ссылка на deployment-раздел; CLAUDE.md — блок ORCH-102.
+- **Фундамент тиража 10-common: расхардкод хоста + секреты нового хоста + smoke-процедура** (ORCH-101, `feat`): платформа разворачивается на новой инфре **без правки кода** — только env/конфиг (эпик ORCH-10, критический путь обоих типов A Lite / B Bundled; stateless по решению 10.06). Конвейер (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД) — байт-в-байт не тронут; **каждый дефолт = боевому значению** → пустой/неизменённый `.env` ⇒ поведение 1:1 (kill-switch-природа, отдельный флаг не вводится — NFR-2; enduro не затронут). ADR: `docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md`, сквозной `adr-0036-replication-foundation-host-parametrization.md`.
+  - **Расхардкод (D2, FR-1/FR-2):** четыре код-блокера закрыты тремя новыми `Settings`-ключами + реюзом существующих: `agent_home_dir` (`ORCH_AGENT_HOME_DIR`, HOME всех акторских env), `agent_git_name`/`git_email_domain` (`ORCH_AGENT_GIT_NAME`/`ORCH_GIT_EMAIL_DOMAIN`, git-идентичность: агенты — `claude-bot@<домен>` через единый `launcher.agent_git_env()` ×2 места; системные акторы держат платформенные имена `deploy-finalizer`/`post-deploy-monitor` под тем же доменом). `plane_sync.notify_stage_change` строит ссылки Branch/PR из `gitea_public_url`(fallback `gitea_url`)+`gitea_owner` вместо литералов `git.mva154.duckdns.org`/`admin`. `SELF_HOSTING_REPO` — **нормативная платформенная константа** тиража (D3: конфиг-ключ превращал бы опечатку в активацию деплой-машинерии на чужом репо или тихое выключение всех self-гейтов), пин-тест.
+  - **Staging-порт + исполняемый инвариант ORCH-058 (D4):** `_STAGING_PORT` → ключ `staging_port` (`ORCH_STAGING_PORT`, дефолт 8501; то же имя интерполируется в compose `command:` staging — один факт, одно имя); в начале freshness-пути новый **fail-closed guard**: `staging_port == deploy_prod_target_port` → отказ «staging rebuild refused» + Telegram-алерт, **без тихого fallback** — анти-prod-гарантия из подразумеваемой константы стала исполняемой. Имена сервисов/профиля остаются константами.
+  - **Инфра-файлы (D5/D6/D7, FR-3):** `docker-compose.yml` — полная интерполяция `${VAR:-default}` (реестр B: `ORCH_HOST_REPOS_DIR`/`_CLAUDE_DIR`/`_CLAUDE_JSON`/`_SSH_DIR`/`_CLAUDE_CODE_DIR`/`_NODE_BIN`, `ORCH_DOCKER_GID` (group_add «МИНА 1» сохранён ×3), `ORCH_RUN_UID/GID`, реюз `ORCH_DEPLOY_SSH_USER`/`_HOST_REPO_PATH`/`_PROD_TARGET_PORT`); оба app-сервиса получили явный `command:` (прод — `${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}`); группа ORCH-040 (uid/gid/HOME/маунты/useradd) двигается согласованно через `build.args APP_UID/APP_GID/APP_HOME`. `Dockerfile` — `ARG APP_UID/APP_GID/APP_USER/APP_HOME` (useradd параметризован; CMD сознательно остаётся exec-form 8500 — PID-1/сигнальная семантика `init: true` не тронута). `orchestrator-deploy-hook.sh` — `REPO="${REPO:-…}"`; **оба инвокера** (`self_deploy.build_deploy_command`, `image_freshness.rebuild_staging_image`) передают `REPO=` явно из конфига (exit-контракт хука 0/1/2 не тронут).
+  - **Секреты (D8, FR-4):** новый stdlib-only `scripts/gen_secrets.py` — криптослучайные `ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET` (`secrets.token_hex(32)`, повторный запуск — другие значения); режим по умолчанию — печать; `--write` **никогда не перезаписывает существующий `.env` молча** (отказ exit=2, перезапись только `--force`); чек-лист внешних токенов (Plane/Gitea/BotFather/watchdog) + нормативное «боевые секреты не копируются». `.env.example` дополнен до полноты ключей старта (+`ORCH_GITEA_OWNER`/`_PUBLIC_URL`, `ORCH_PLANE_BOT_*`, `ORCH_TELEGRAM_*`, `ORCH_PROJECTS_JSON`, блок хост-параметризации).
+  - **Smoke + доки (D9, FR-5/FR-7):** новый runbook `docs/operations/REPLICATION.md` — карта переменных, процедура секретов, пошаговая smoke-процедура с явными PASS/FAIL (compose config → `/health` → `/queue`+`/metrics` → onboarding sandbox → тестовая задача → артефакты `01–04` стадии analysis; расширенно — до `done`), границы 10-common vs Lite vs Bundled, платформенные конвенции; карта env `INFRA.md` дополнена; `.env.staging.example` согласован.
+  - **Анти-регресс (D10, FR-6):** новый структурный сканер `tests/test_no_host_hardcodes.py` — запрещённые литералы (`82.22.50.71`/`/home/slin`/`mva154`/`duckdns`) в исполняемом коде `src/**`+`watchdog/**` ломают CI; комментарии/докстринги исключены через `tokenize`; `config.py` — структурное исключение (канон дефолтов); allowlist пуст; негативная самопроверка (подсаженный литерал ловится). Тесты: `test_host_config_keys.py` (ключи/guard/REPO/D3-пин), `test_infra_parametrization.py` (интерполяция compose = боевым дефолтам, ORCH-040-группа, Dockerfile ARG, полнота `.env.example`), `test_secrets_gen.py`, `test_replication_smoke.py`.
 - **Turnkey-онбординг проектов: kit + операторский CLI + runbook** (ORCH-009, `feat`): способность развернуть **новый** проект одним проходом (домен D5.2 эпика саморазвития) — **вне рантайма и вне конвейера**: `src/**` байт-в-байт (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД — не тронуты, снапшот-контроль `tests/test_onboarding_invariants.py`), kill-switch не нужен (активация — только явный запуск CLI человеком). Эталон — сам репозиторий orchestrator (каноны ORCH-52b/c/d/e). ADR: `docs/work-items/ORCH-009/06-adr/ADR-001-turnkey-onboarding-kit-and-cli.md` (D1…D11), сквозной `docs/architecture/adr/adr-0035-turnkey-project-onboarding.md`.
   - **Kit `onboarding/repo-skeleton/` (D1–D3, FR-1/FR-2/FR-3):** параметризуемый каркас нового репо — 6 промптов агентов канона 52d/92 (5 XML-секций в нормативном порядке, «❌ → ✅», `<escalation>` у developer/reviewer/tester, frontmatter-схема 52c с плейсхолдерными датами/моделями, machine-verdict ключи байт-в-байт; язык — канон орка: 5 ru + deployer en c рамкой shared-host-гардрейлов), reviewer-gate «дока не обновлена → `REQUEST_CHANGES`», паспорт `CLAUDE.md`, `AGENTS.md` (карта доков + правила ведения), `CONTRIBUTING.md`, `README`/`CHANGELOG`, скелет `docs/` (`ARCHITECTURE`/`PIPELINE`/`PRODUCT_VISION`/`operations/INFRA.md` с обязательными секциями топологии/env/границ/рисков общего хоста, реестр сквозных ADR), `.env.example`. Плейсхолдеры `{{NAME}}` + stdlib-рендер (без новых pip-зависимостей); словарь — `onboarding/placeholders.json` (биекция словарь↔kit держится тестом). **Канон не форкается (BR-2):** `docs/_templates/` (16) + `docs/_standards/` (3) в kit не хранятся — копируются live из чекаута в момент материализации.
   - **CLI `scripts/onboard_project.py` (D4–D7, D11, FR-4/FR-5):** режимы `plan` (дефолт, GET-only, ноль мутаций сети/диска) / `apply` (идемпотентный ensure: существующее → `skipped(exists)`, delete-операций нет вовсе) / `verify` (round-trip реестра, резолв всех 22 статусов включая fail-closed `Confirm Deploy`/`STOP`, лейблы, webhook активен, полнота kit в репо, скан неразрешённых плейсхолдеров). Закрытый список read-only импортов из `src` (нулевой дрейф по построению): `projects._parse_projects_json`, `plane_sync._PLANE_NAME_TO_KEY`, `config.settings`. Канонические группы статусов фиксированы ADR D5 (код-критично: `STOP`→`cancelled` ORCH-090; терминальные группы только у Done/Cancelled/STOP — иначе terminal-detection ORCH-068 ложно терминалит). Gitea: репо `auto_init=false` + per-repo webhook (`push`/`pull_request`/`status`, **переиспользует** глобальный `ORCH_GITEA_WEBHOOK_SECRET` — новый сломал бы HMAC существующих, TR-6); initial push — **только** в свежесозданный пустой репо (INV-4 не затрагивается). Реестр: merged-вывод `ORCH_PROJECTS_JSON` через фактический парсер; скрипт `.env` НЕ правит, прод НЕ рестартит, ничего не удаляет (NFR-2); секреты маскируются (NFR-3); Plane CE API-пробел → `manual-step` со ссылкой на runbook (fail-safe, TR-8). Отчёт `created/skipped(exists)/manual-step` + `--json`; exit-коды 0/2/1.

CLAUDE.md

@@ -294,6 +294,92 @@ API → `manual-step` (fail-safe); **runbook** `docs/operations/ONBOARDING.md` (
 `docs/work-items/ORCH-009/06-adr/ADR-001-turnkey-onboarding-kit-and-cli.md`, сквозной
 `docs/architecture/adr/adr-0035-turnkey-project-onboarding.md`.
 
+## Тираж платформы: фундамент 10-common (ORCH-101)
+Платформа разворачивается на новой инфре **без правки кода** — только env/конфиг (эпик ORCH-10,
+оба типа A Lite / B Bundled, stateless). Принцип: **дефолт каждого параметра = боевому значению**
+(пустой `.env` ⇒ поведение байт-в-байт; kill-switch-природа, отдельный флаг не вводится).
+`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД — не тронуты.
+- **Расхардкод:** ключи `agent_home_dir`/`agent_git_name`/`git_email_domain` (HOME + git-идентичность
+  акторов: агенты — единый `launcher.agent_git_env()`; системные имена `deploy-finalizer`/
+  `post-deploy-monitor` — платформенные литералы под тем же доменом), `staging_port`; ссылки
+  Plane-комментариев — из `gitea_public_url`/`gitea_owner`. `docker-compose.yml` — интерполяция
+  `${VAR:-default}` (карта `ORCH_HOST_*`/`ORCH_DOCKER_GID`/`ORCH_RUN_UID/GID`; группа ORCH-040
+  uid/gid/HOME/маунты — одни env насквозь, «МИНА 1» сохранена); `Dockerfile` — `ARG APP_*`
+  (CMD exec-form 8500 не тронут); deploy-hook — `"${REPO:-…}"` + явная передача `REPO=` обоими
+  инвокерами. **Платформенные константы (НЕ конфиг):** `SELF_HOSTING_REPO="orchestrator"` (узел
+  «empty CSV → self-hosting only» всех `*_repos`-leaf'ов), имена сервисов/профиля, контейнерный
+  layout. **Инвариант ORCH-058 усилен:** guard fail-closed `staging_port == прод-порт` → отказ
+  freshness-пути ДО любого ssh/build, без тихого fallback.
+- **Секреты нового хоста:** stdlib `scripts/gen_secrets.py` (`secrets.token_hex(32)`; печать по
+  умолчанию; `--write` отказывает при существующем `.env`, перезапись только `--force`); норматив —
+  боевые секреты не копируются. `.env.example` — канон 100% ключей старта.
+- **Smoke тиража:** runbook `docs/operations/REPLICATION.md` (карта env, чек-лист секретов,
+  пошаговый smoke с PASS/FAIL до артефактов `01–04`/`done`, границы 10-common vs Lite vs Bundled).
+  Анти-регресс — `tests/test_no_host_hardcodes.py` (запрещённые литералы в исполняемом коде
+  `src/**`+`watchdog/**`; `tokenize`-исключение комментариев/докстрингов; config-модули — канон
+  дефолтов, вне скана; allowlist пуст). Детали —
+  `docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md`, сквозной
+  `docs/architecture/adr/adr-0036-replication-foundation-host-parametrization.md`.
+
+## Lite-тираж: орк+watchdog на инфре заказчика (ORCH-102)
+Закрыт **Type A** эпика ORCH-10 (поверх фундамента 10-common ORCH-101): заказчик разворачивает
+у себя ТОЛЬКО `orchestrator`+`orchestrator-watchdog` и донастраивает окружение
+(Plane/Gitea/Telegram/LLM — его инсталляции) по одной сквозной инструкции. **Docs+tests**
+(паттерн ORCH-077/092): `src/**`/compose/Dockerfile/`scripts/**` не тронуты; конвейер байт-в-байт.
+- **Golden source** — `docs/deployment/LITE_SETUP.md` (новый раздел `docs/deployment/` — витрина
+  тиража, читатель — внешний оператор; vs `docs/operations/` — эксплуатация НАШЕГО прода): 13
+  нормативных разделов в порядке маршрута оператора, каждый шаг = fenced-команда + явная
+  «Проверка:»/PASS/FAIL, хост-специфика только плейсхолдерами; канон не форкается — статусы/env/
+  вебхуки/smoke ссылками на ONBOARDING §1 / REPLICATION §2–§4 / SETUP_WEBHOOKS (явно в доке —
+  только fail-closed имена `Confirm Deploy`/`STOP` и обязательные ключи нового хоста).
+- **Канон watchdog-конфига** — новый `.env.watchdog.example` (key-set = блок `WATCHDOG_*`
+  `.env.example`, держится key-sync тестом): sidecar читает ТОЛЬКО `.env.watchdog`, ключ
+  `WATCHDOG_*` в `.env` для него инертен (ловушка файла-носителя закрыта); C-1 ORCH-100 — свой
+  бот, токен орка не переиспользовать; `.env.watchdog` в `.gitignore`.
+- **Нормативы:** Gitea — branch protection на `main` НЕ включать (ADR D10 ORCH-009 / INV-4),
+  pre-receive не вводится, ОДИН глобальный webhook-секрет; compose НЕ форкается (дефолтный
+  `up -d` = ровно орк+watchdog, staging строго за `profiles: [staging]` — вилка только под
+  self-hosting развитие платформы); stateless — данные/задачи/секреты боевого хоста НЕ
+  переносятся, проверка чистоты через `GET /queue`.
+- **Анти-дрейф** — `tests/test_lite_setup_doc.py` (структурный, без сети/LLM/subprocess):
+  13 разделов в порядке, кирпичи, env-ключи ⊂ `.env.example`, compose-подмножество
+  (анти-появление `plane*`/`gitea*`), fenced-скан `FORBIDDEN` (импорт из
+  `test_no_host_hardcodes.py`) + секрет-эвристика, «22 статуса» сверкой импорта
+  `plane_sync._PLANE_NAME_TO_KEY`, перекрёстность REPLICATION→LITE_SETUP. **Норматив
+  сопровождения (NFR-5):** меняешь шаги тиража → обнови LITE_SETUP.md в том же PR. Детали —
+  `docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md`, сквозной
+  `docs/architecture/adr/adr-0037-lite-replication-canon.md`.
+
+## Bundled-тираж: весь стек одним комплектом (ORCH-103)
+Закрыт **Type B** эпика ORCH-10 (поверх 10-common ORCH-101 и канона Lite ORCH-102): заказчик
+**без собственной инфраструктуры** получает весь стек одним комплектом — новый top-level каталог
+**`deploy/bundled/`** (самодостаточный compose: орк + watchdog + Gitea + зеркало upstream Plane CE
+≈14 контейнеров; project name `orchestrator-bundle` = узнаваемый префикс томов/контейнеров;
+`container_name` не пиннится; staging-контура нет вовсе — самразвитие платформы у заказчика =
+маршрут Lite) + **`scripts/bootstrap_bundle.py`** (python stdlib-only, режимы `plan` (дефолт) /
+`apply`/`verify`, step-движок check→ensure, exit 0/2/1), доводящий стек одним прогоном: preflight
+(fail-fast до мутаций) → секреты (webhook — строго `gen_secrets.py`; bundle-креды — stdlib
+`secrets`, без перетирания без `--force-secrets`) → up+готовность → init Gitea (полностью
+автоматом, `gitea admin …`; branch protection НЕ включается — D10 ORCH-009/INV-4) → init Plane
+(честные manual-step c API-верификацией; молчаливый пропуск запрещён) → онбординг sandbox-проекта
+**строго** `onboard_project.py apply+verify` (22 статуса — `plane_sync._PLANE_NAME_TO_KEY`, нулевой
+дрейф канона) → git-доступ агентов HTTP token-remote (ssh-контур не вводится) → сборка корневых
+`.env`/`.env.watchdog` (bootstrap — единственный писатель live-конфигов) → health/итог.
+Сеть — одна bridge, машинный трафик строго сервис-DNS (`http://orchestrator:8500/webhook/*`),
+наружу — только человеческие порты (`BUNDLE_ORCH_PORT`/`BUNDLE_PLANE_PORT`/`BUNDLE_GITEA_HTTP_PORT`);
+мина Gitea закрыта `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator`. Все сторонние образы пиннованы
+неподвижными тегами; teardown — только документированная процедура BUNDLED_SETUP §13 (delete-операций
+в скрипте НЕТ вообще). Рантайм байт-в-байт: `src/**`, корневой compose, `Dockerfile`,
+`STAGE_TRANSITIONS`/`QG_CHECKS`/схема БД — не тронуты; kill-switch не нужен (активация — только
+явный запуск оператором, паттерн ORCH-009/102). Golden source — `docs/deployment/BUNDLED_SETUP.md`
+(14 разделов канона LITE_SETUP; общие шаги — ссылками на LITE_SETUP/ONBOARDING/REPLICATION).
+Анти-дрейф — `tests/test_bundle_compose.py` (состав/пины/key-set-sync/заморозка корневого compose),
+`tests/test_bundled_setup_doc.py` (разделы/FORBIDDEN-импорт/секрет-эвристика/env-ключи/кросс-рефы),
+`tests/test_bootstrap_script.py` (кирпичи/stdlib-only ast-сканом/нет delete-операций/unit чистых
+функций). **Норматив сопровождения (NFR-5):** меняешь шаги Bundled-тиража → обнови BUNDLED_SETUP.md
+в том же PR. Детали — `docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`,
+сквозной `docs/architecture/adr/adr-0038-bundled-replication-canon.md`.
+
 ## Конвенции
 - Conventional Commits (`feat:`, `fix:`, `docs:`, `refactor:`, `test:`)
 - Ветки: `feature/ORCH-NNN-slug`, `fix/ORCH-NNN-slug`

Dockerfile

@@ -35,7 +35,16 @@ RUN set -eux; \
 # "No user exists for uid 1000" (rc=255), breaking the detached self-deploy ssh
 # launch (ORCH-36 Phase B). Create a real user 1000 with a home dir so getpwuid()
 # resolves and ssh can start.
-RUN groupadd -g 1000 app && useradd -u 1000 -g 1000 -m -d /home/slin -s /bin/bash slin
+# ORCH-101 (D5): uid/gid/home/username are build ARGs (defaults = current prod
+# values); compose build.args wires APP_UID/APP_GID/APP_HOME from the SAME env
+# vars as the runtime user: and the mount targets, so the ORCH-040 group
+# (uid/gid/HOME/mounts/useradd) moves coherently. APP_USER is passwd cosmetics
+# (the ENTRY matters for getpwuid/ssh, not the name) — Dockerfile-default only.
+ARG APP_UID=1000
+ARG APP_GID=1000
+ARG APP_USER=slin
+ARG APP_HOME=/home/slin
+RUN groupadd -g ${APP_GID} app && useradd -u ${APP_UID} -g ${APP_GID} -m -d ${APP_HOME} -s /bin/bash ${APP_USER}
 COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 COPY src/ ./src/
@@ -48,4 +57,9 @@ COPY src/ ./src/
 # and bounced the task off `deploy-staging`. We just ensure the mountpoint exists.
 RUN mkdir -p /app/data
 ENV PYTHONPATH=/app
+# ORCH-101 (D5): CMD deliberately stays exec-form with the documented 8500
+# default — an ARG cannot reach a runtime CMD, and a shell-form CMD would break
+# the verified `init: true` + exec-form PID-1/signal semantics (B-2). The prod
+# port is parametrised on the compose layer (`command:` with
+# ${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}), which overrides this CMD.
 CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8500"]

README.md

@@ -70,6 +70,8 @@ data/
 └── runs/                # Agent output logs ({run_id}.log)
 docs/
 ├── PRODUCT_VISION.md            # Видение продукта
+├── deployment/
+│   └── LITE_SETUP.md            # Lite-тираж: орк+watchdog на инфре заказчика (ORCH-102)
 ├── architecture/
 │   ├── README.md                # Обзор архитектуры, компоненты, API
 │   ├── internals.md             # Схема БД, потоки, resilience-слой
@@ -144,6 +146,17 @@ uvicorn src.main:app --reload --port 8500
 | `ORCH_BUG_FAST_TRACK_ENABLED` | Kill-switch багфикс-трека (ORCH-019): задача с меткой Plane `Bug` пропускает стадию `architecture`; `false` → старт и маршрут 1:1 как до ORCH-019 (нулевая регрессия) | `true` |
 | `ORCH_BUG_FAST_TRACK_LABEL` | Имя метки Plane, активирующей багфикс-трек (ORCH-019) | `Bug` |
 | `ORCH_BUG_FAST_TRACK_REPOS` | CSV область репо для багфикс-трека; **пусто → self-hosting only** (`orchestrator`) — enduro подключается явным CSV (ORCH-019) | `""` |
+| `ORCH_AGENT_HOME_DIR` | ORCH-101: HOME акторских процессов + таргет маунтов `.claude`/`.ssh` + `ARG APP_HOME` (группа ORCH-040) | `/home/slin` |
+| `ORCH_AGENT_GIT_NAME` / `ORCH_GIT_EMAIL_DOMAIN` | ORCH-101: git-идентичность коммитов агентов (`claude-bot@mva154.local` при дефолтах) | `claude-bot` / `mva154.local` |
+| `ORCH_STAGING_PORT` | ORCH-101: порт staging (читают `image_freshness` и compose); guard fail-closed при совпадении с прод-портом (ORCH-058 AC-9) | `8501` |
+| `ORCH_HOST_CLAUDE_DIR` / `_CLAUDE_JSON` / `_SSH_DIR` / `_CLAUDE_CODE_DIR` / `_NODE_BIN` | ORCH-101: host-источники bind-маунтов (compose-интерполяция) | боевые пути mva154 |
+| `ORCH_RUN_UID` / `ORCH_RUN_GID` / `ORCH_DOCKER_GID` | ORCH-101: uid:gid контейнера и gid docker-группы (`group_add`, ORCH-040) | `1000`/`1000`/`999` |
+
+Тираж платформы на новый хост (полная карта, секреты, smoke) — `docs/operations/REPLICATION.md` (ORCH-101).
+**Lite-тираж под ключ (ORCH-102):** разворачивание орк+watchdog на инфраструктуре заказчика
+по одной сквозной инструкции «голый хост → работающий конвейер» (Plane/Gitea/Telegram/LLM
+заказчик ставит сам и подключает по шагам) — `docs/deployment/LITE_SETUP.md`; канон конфига
+sidecar-watchdog — `.env.watchdog.example`; анти-дрейф — `tests/test_lite_setup_doc.py`.
 
 ## Очередь задач (ORCH-1 / F-2b)
 

deploy/bundled/.env.example

@@ -0,0 +1,61 @@
+# deploy/bundled/.env — конфиг bundle-ИНФРЫ (ORCH-103, ADR-001 D2).
+# Канонический example: 100% ключей интерполяции deploy/bundled/docker-compose.yml
+# (key-set-sync держит tests/test_bundle_compose.py) + ключи init-кред, которые
+# заполняет bootstrap. Создание: cp .env.example .env (или это сделает
+# scripts/bootstrap_bundle.py apply); права 600.
+#
+# ⚠️ СЕМАНТИКА ФАЙЛА-НОСИТЕЛЯ (TR-8): этот файл читает ТОЛЬКО compose-интерполяция
+# bundle (авто-чтение .env из project dir deploy/bundled/). Runtime-конфиг самого
+# оркестратора и watchdog — КОРНЕВЫЕ .env / .env.watchdog (каноны Lite 1:1:
+# .env.example / .env.watchdog.example, карта — docs/operations/REPLICATION.md §2).
+# Единственный писатель всех live-файлов — scripts/bootstrap_bundle.py: дублируемые
+# ключи (uid/gid, HOME, пути Claude CLI) когерентны механически, не дисциплиной.
+#
+# DO NOT COMMIT реальный deploy/bundled/.env (покрыт неякорным `.env` в .gitignore).
+# Секреты: НИ ОДНОГО дефолтного пароля — пустые значения ниже генерирует bootstrap
+# (stdlib secrets) и никогда не печатает (NFR-3); повторный запуск НЕ перетирает
+# существующие значения без явного --force-secrets.
+
+# --- Публичная точка инсталляции -------------------------------------------
+# Хост, по которому браузер оператора открывает Plane/Gitea и по которому
+# строятся публичные ссылки (ORCH_GITEA_PUBLIC_URL / ORCH_PLANE_WEB_URL / WEB_URL
+# Plane / ROOT_URL Gitea). HTTPS/домены/reverse-proxy заказчика — вне bundle.
+BUNDLE_PUBLIC_HOST=localhost
+
+# --- Карта публикуемых портов (D4: только человеческие точки) ---------------
+# Конфликт порта на хосте → отказ preflight bootstrap ДО любых мутаций (BR-7).
+BUNDLE_ORCH_PORT=8500
+BUNDLE_PLANE_PORT=8080
+BUNDLE_GITEA_HTTP_PORT=3000
+
+# --- Идентичность контейнера орка (реюз имён ORCH-101: один факт = одно имя) --
+# uid:gid владельца deploy/bundled/repos (инвариант ORCH-040); docker-gid хоста
+# («МИНА 1», узнать: getent group docker). Заполняет bootstrap из id -u/-g/getent.
+ORCH_RUN_UID=1000
+ORCH_RUN_GID=1000
+ORCH_DOCKER_GID=999
+# HOME всех акторов в контейнере (группа ORCH-040 двигается одной переменной).
+ORCH_AGENT_HOME_DIR=/home/orchestrator
+
+# --- LLM-предусловие хоста заказчика (bundle НЕ поставляет Claude CLI) -------
+# Пути дистрибутива claude-code/node и кред CLI на хосте (канон — LITE_SETUP §7).
+ORCH_HOST_CLAUDE_CODE_DIR=/usr/lib/node_modules/@anthropic-ai/claude-code
+ORCH_HOST_NODE_BIN=/usr/bin/node
+ORCH_HOST_CLAUDE_DIR=~/.claude
+ORCH_HOST_CLAUDE_JSON=~/.claude.json
+
+# --- Внутренние креды Plane CE-стека (upstream-имена; значения — bootstrap) --
+POSTGRES_USER=plane
+POSTGRES_PASSWORD=
+POSTGRES_DB=plane
+SECRET_KEY=
+RABBITMQ_DEFAULT_USER=plane
+RABBITMQ_DEFAULT_PASS=
+RABBITMQ_DEFAULT_VHOST=plane
+MINIO_ROOT_USER=plane-minio-admin
+MINIO_ROOT_PASSWORD=
+
+# --- Init-креды Gitea (D6: один пользователь-бот = админ, владелец репо,
+#     носитель API-токена; создаёт bootstrap через `gitea admin user create`) --
+GITEA_ADMIN_USERNAME=orchestrator-bot
+GITEA_ADMIN_PASSWORD=

deploy/bundled/docker-compose.yml

@@ -0,0 +1,338 @@
+# ORCH-103 (Type B Bundled, ADR-001 D1–D4): самодостаточный compose ВСЕГО стека
+# для тиража «под ключ» на хост заказчика: orchestrator + orchestrator-watchdog +
+# Gitea + Plane CE (зеркало официального selfhost-référence makeplane/plane
+# v0.23.1: имена сервисов и env-контракт — upstream, анти-дрейф к их докам; наши
+# отличия от référence: пиннинг неподвижными тегами литералом вместо ${APP_RELEASE}
+# (NFR-6, держится tests/test_bundle_compose.py), убраны replicas/platform/SENTRY,
+# секреты БЕЗ дефолтных значений — их генерирует scripts/bootstrap_bundle.py).
+#
+# Этот файл НЕ исполняется в нашем прод-контуре (корневой docker-compose.yml —
+# байт-в-байт, заморожен анти-дрейфом ORCH-102); активация — только явный запуск
+# оператором на целевом хосте (паттерн ORCH-009, kill-switch не нужен).
+#
+# Конфиг-слои (D2): интерполяции ${VAR} читаются compose'ом из deploy/bundled/.env
+# (авто-чтение из project dir — без --env-file-футгана); канон ключей —
+# deploy/bundled/.env.example (key-set-sync держит тест). Runtime-конфиг орка и
+# watchdog — КОРНЕВЫЕ .env / .env.watchdog (канон Lite 1:1, REPLICATION §2);
+# их единственный писатель — bootstrap_bundle.py.
+#
+# Сеть (D4): одна bridge-сеть проекта; машинный трафик — строго сервис-DNS
+# (Plane→орк http://orchestrator:8500/webhook/plane, Gitea→орк .../webhook/gitea,
+# орк→Plane http://proxy, орк→Gitea http://gitea:3000); network_mode: host НЕ
+# используется (ssh-деплой-контур нашего хоста в bundle структурно спит —
+# ORCH_DEPLOY_SSH_HOST пуст). Наружу публикуются ТОЛЬКО человеческие порты
+# (орк/Plane proxy/Gitea web); postgres/redis/mq/minio не публикуются.
+#
+# Project name = узнаваемый префикс томов/контейнеров orchestrator-bundle_* (D1);
+# container_name сознательно НЕ пиннится ни у кого — bundle и Lite/корневой
+# compose не сталкиваются по именам на одном хосте.
+name: orchestrator-bundle
+
+networks:
+  default:
+    name: orchestrator-bundle
+    driver: bridge
+
+# Env-контракт Plane CE — upstream-имена (référence v0.23.1). Значения секретов
+# (POSTGRES_PASSWORD/SECRET_KEY/RABBITMQ_DEFAULT_PASS/MINIO_ROOT_PASSWORD) живут
+# ТОЛЬКО в deploy/bundled/.env (генерирует bootstrap); дефолтных паролей нет.
+x-plane-env: &plane-env
+  environment:
+    - WEB_URL=http://${BUNDLE_PUBLIC_HOST:-localhost}:${BUNDLE_PLANE_PORT:-8080}
+    - DEBUG=0
+    - CORS_ALLOWED_ORIGINS=http://${BUNDLE_PUBLIC_HOST:-localhost}:${BUNDLE_PLANE_PORT:-8080}
+    - GUNICORN_WORKERS=1
+    # db (upstream-имена; host/port — фиксированные сервис-DNS этого файла)
+    - PGHOST=plane-db
+    - PGDATABASE=${POSTGRES_DB:-plane}
+    - POSTGRES_USER=${POSTGRES_USER:-plane}
+    - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
+    - POSTGRES_DB=${POSTGRES_DB:-plane}
+    - POSTGRES_PORT=5432
+    - PGDATA=/var/lib/postgresql/data
+    - DATABASE_URL=postgresql://${POSTGRES_USER:-plane}:${POSTGRES_PASSWORD}@plane-db:5432/${POSTGRES_DB:-plane}
+    # redis
+    - REDIS_HOST=plane-redis
+    - REDIS_PORT=6379
+    - REDIS_URL=redis://plane-redis:6379/
+    # rabbitmq
+    - RABBITMQ_HOST=plane-mq
+    - RABBITMQ_PORT=5672
+    - RABBITMQ_DEFAULT_USER=${RABBITMQ_DEFAULT_USER:-plane}
+    - RABBITMQ_DEFAULT_PASS=${RABBITMQ_DEFAULT_PASS}
+    - RABBITMQ_DEFAULT_VHOST=${RABBITMQ_DEFAULT_VHOST:-plane}
+    - RABBITMQ_VHOST=${RABBITMQ_DEFAULT_VHOST:-plane}
+    - AMQP_URL=amqp://${RABBITMQ_DEFAULT_USER:-plane}:${RABBITMQ_DEFAULT_PASS}@plane-mq:5672/${RABBITMQ_DEFAULT_VHOST:-plane}
+    # application secret (генерирует bootstrap; дефолта сознательно НЕТ)
+    - SECRET_KEY=${SECRET_KEY}
+    # datastore (minio)
+    - USE_MINIO=1
+    - AWS_REGION=
+    - AWS_ACCESS_KEY_ID=${MINIO_ROOT_USER:-plane-minio-admin}
+    - AWS_SECRET_ACCESS_KEY=${MINIO_ROOT_PASSWORD}
+    - AWS_S3_ENDPOINT_URL=http://plane-minio:9000
+    - AWS_S3_BUCKET_NAME=uploads
+    - MINIO_ROOT_USER=${MINIO_ROOT_USER:-plane-minio-admin}
+    - MINIO_ROOT_PASSWORD=${MINIO_ROOT_PASSWORD}
+    - BUCKET_NAME=uploads
+    - FILE_SIZE_LIMIT=5242880
+    # live server
+    - API_BASE_URL=http://api:8000
+    # proxy
+    - NGINX_PORT=80
+
+services:
+  # ── Платформа: орк + sidecar-watchdog (образы собираются из этого же чекаута;
+  #    корневой Dockerfile / watchdog/Dockerfile — без правок, NFR-1) ──────────
+  orchestrator:
+    build:
+      context: ../..
+      # ORCH-101 (D5): uid/gid/home двигаются ОДНОЙ группой с user: и таргетами
+      # маунтов ниже (инвариант ORCH-040). Дефолты bundle нейтральны (D2).
+      args:
+        APP_UID: ${ORCH_RUN_UID:-1000}
+        APP_GID: ${ORCH_RUN_GID:-1000}
+        APP_HOME: ${ORCH_AGENT_HOME_DIR:-/home/orchestrator}
+    restart: unless-stopped
+    user: "${ORCH_RUN_UID:-1000}:${ORCH_RUN_GID:-1000}"
+    init: true
+    command: ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8500"]
+    ports:
+      # человеческая точка: операторский smoke `curl /health` (D4)
+      - "${BUNDLE_ORCH_PORT:-8500}:8500"
+    volumes:
+      # данные/репозитории — bind ВНУТРИ project dir (uid-причины ORCH-040;
+      # покрыты .gitignore: неякорный data/ + deploy/bundled/repos/)
+      - ./data:/app/data
+      - ./repos:/repos
+      - /var/run/docker.sock:/var/run/docker.sock
+      # LLM-предусловие хоста заказчика (bundle его НЕ поставляет, BRD §1.3)
+      - ${ORCH_HOST_CLAUDE_CODE_DIR:-/usr/lib/node_modules/@anthropic-ai/claude-code}:/opt/claude-code:ro
+      - ${ORCH_HOST_NODE_BIN:-/usr/bin/node}:/usr/bin/node:ro
+      - ${ORCH_HOST_CLAUDE_DIR:-~/.claude}:${ORCH_AGENT_HOME_DIR:-/home/orchestrator}/.claude
+      - ${ORCH_HOST_CLAUDE_JSON:-~/.claude.json}:${ORCH_AGENT_HOME_DIR:-/home/orchestrator}/.claude.json:ro
+      # ssh-контур в bundle сознательно НЕ вводится (ADR D8): git-доступ агентов
+      # — HTTP token-remote, деплой-хуки нашего хоста структурно спят.
+    # runtime-конфиг орка собирает bootstrap (шаг 8); required:false — первый
+    # `up -d` поднимает стек ДО сборки конфига (AC-1), орк жив без него.
+    env_file:
+      - path: ../../.env
+        required: false
+    environment:
+      - ORCH_REPOS_DIR=/repos
+    group_add:
+      - "${ORCH_DOCKER_GID:-999}"
+
+  orchestrator-watchdog:
+    build:
+      context: ../..
+      dockerfile: watchdog/Dockerfile
+    restart: unless-stopped
+    init: true
+    mem_limit: 128m
+    mem_reservation: 32m
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./repos:/repos:ro
+      - ./data:/app/data:ro
+    env_file:
+      - path: ../../.env.watchdog
+        required: false
+    environment:
+      # bundle-сеть ≠ host-network Lite: метрики — по сервис-DNS; имя контейнера
+      # орка детерминировано project name (container_name не пиннится, D1).
+      # environment перекрывает env_file → когерентность механическая (TR-8).
+      - WATCHDOG_METRICS_URL=http://orchestrator:8500/metrics
+      - WATCHDOG_CONTAINERS=orchestrator-bundle-orchestrator-1
+    group_add:
+      - "${ORCH_DOCKER_GID:-999}"
+
+  # ── Gitea (D6): официальный образ, НЕ rootless; init полностью автоматом —
+  #    bootstrap создаёт админа/токен через `gitea admin ...` CLI в контейнере.
+  #    Branch protection на main НЕ настраивается (норматив D10 ORCH-009/INV-4).
+  gitea:
+    image: gitea/gitea:1.22.6
+    restart: unless-stopped
+    ports:
+      - "${BUNDLE_GITEA_HTTP_PORT:-3000}:3000"
+    environment:
+      - GITEA__database__DB_TYPE=sqlite3
+      - GITEA__security__INSTALL_LOCK=true
+      - GITEA__server__DOMAIN=${BUNDLE_PUBLIC_HOST:-localhost}
+      - GITEA__server__ROOT_URL=http://${BUNDLE_PUBLIC_HOST:-localhost}:${BUNDLE_GITEA_HTTP_PORT:-3000}/
+      # ssh-контур не вводится (D8): порт не публикуется, ssh выключен.
+      - GITEA__server__DISABLE_SSH=true
+      - GITEA__service__DISABLE_REGISTRATION=true
+      # МИНА TR-4 (D4): Gitea по умолчанию режет webhook'и в приватные адреса —
+      # без этой строки «задача не появилась» гарантирован.
+      - GITEA__webhook__ALLOWED_HOST_LIST=orchestrator
+    volumes:
+      - gitea-data:/data
+    healthcheck:
+      test: ["CMD", "curl", "-fsS", "http://localhost:3000/api/healthz"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+
+  # ── Plane CE — зеркало upstream selfhost-référence v0.23.1 (D3) ────────────
+  web:
+    <<: *plane-env
+    image: makeplane/plane-frontend:v0.23.1
+    restart: unless-stopped
+    command: node web/server.js web
+    depends_on:
+      - api
+      - worker
+
+  space:
+    <<: *plane-env
+    image: makeplane/plane-space:v0.23.1
+    restart: unless-stopped
+    command: node space/server.js space
+    depends_on:
+      - api
+      - worker
+      - web
+
+  admin:
+    <<: *plane-env
+    image: makeplane/plane-admin:v0.23.1
+    restart: unless-stopped
+    command: node admin/server.js admin
+    depends_on:
+      - api
+      - web
+
+  live:
+    <<: *plane-env
+    image: makeplane/plane-live:v0.23.1
+    restart: unless-stopped
+    command: node live/dist/server.js live
+    depends_on:
+      - api
+      - web
+
+  api:
+    <<: *plane-env
+    image: makeplane/plane-backend:v0.23.1
+    restart: unless-stopped
+    command: ./bin/docker-entrypoint-api.sh
+    volumes:
+      - logs_api:/code/plane/logs
+    depends_on:
+      - plane-db
+      - plane-redis
+      - plane-mq
+
+  worker:
+    <<: *plane-env
+    image: makeplane/plane-backend:v0.23.1
+    restart: unless-stopped
+    command: ./bin/docker-entrypoint-worker.sh
+    volumes:
+      - logs_worker:/code/plane/logs
+    depends_on:
+      - api
+      - plane-db
+      - plane-redis
+      - plane-mq
+
+  beat-worker:
+    <<: *plane-env
+    image: makeplane/plane-backend:v0.23.1
+    restart: unless-stopped
+    command: ./bin/docker-entrypoint-beat.sh
+    volumes:
+      - logs_beat-worker:/code/plane/logs
+    depends_on:
+      - api
+      - plane-db
+      - plane-redis
+      - plane-mq
+
+  migrator:
+    <<: *plane-env
+    image: makeplane/plane-backend:v0.23.1
+    restart: "no"
+    command: ./bin/docker-entrypoint-migrator.sh
+    volumes:
+      - logs_migrator:/code/plane/logs
+    depends_on:
+      - plane-db
+      - plane-redis
+
+  plane-db:
+    <<: *plane-env
+    image: postgres:15.7-alpine
+    restart: unless-stopped
+    command: postgres -c 'max_connections=1000'
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+
+  plane-redis:
+    <<: *plane-env
+    image: valkey/valkey:7.2.5-alpine
+    restart: unless-stopped
+    volumes:
+      - redisdata:/data
+    healthcheck:
+      test: ["CMD", "valkey-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+
+  plane-mq:
+    <<: *plane-env
+    image: rabbitmq:3.13.6-management-alpine
+    restart: always
+    volumes:
+      - rabbitmq_data:/var/lib/rabbitmq
+    healthcheck:
+      test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"]
+      interval: 15s
+      timeout: 10s
+      retries: 12
+
+  plane-minio:
+    <<: *plane-env
+    # upstream-référence держит latest — bundle пиннит неподвижный тег (NFR-6)
+    image: minio/minio:RELEASE.2024-05-28T17-19-04Z
+    restart: unless-stopped
+    command: server /export --console-address ":9090"
+    volumes:
+      - uploads:/export
+    healthcheck:
+      test: ["CMD", "curl", "-fsS", "http://localhost:9000/minio/health/live"]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+
+  proxy:
+    <<: *plane-env
+    image: makeplane/plane-proxy:v0.23.1
+    restart: unless-stopped
+    ports:
+      # человеческая точка: UI Plane в браузере оператора (D4)
+      - "${BUNDLE_PLANE_PORT:-8080}:80"
+    depends_on:
+      - web
+      - api
+      - space
+
+# Состояние Plane/Gitea — именованные тома проекта (префикс orchestrator-bundle_,
+# D1/D2); preflight bootstrap детектирует «грязный хост» по этому префиксу.
+volumes:
+  pgdata:
+  redisdata:
+  uploads:
+  logs_api:
+  logs_worker:
+  logs_beat-worker:
+  logs_migrator:
+  rabbitmq_data:
+  gitea-data:

docker-compose.yml

@@ -1,42 +1,65 @@
+# ORCH-101 (replication foundation): every host-specific value is interpolated
+# as ${VAR:-default}; the defaults equal the current production values, so an
+# empty environment resolves to a byte-for-byte equivalent of the previous file
+# (zero regression, BR-5). Compose reads ${VAR} from the project `.env` /shell —
+# NOT from a service's env_file (so .env.staging does NOT interpolate); the
+# Settings-shared names (ORCH_AGENT_HOME_DIR, ORCH_STAGING_PORT, ...) are read
+# by pydantic from env_file AND by compose from .env — one name per fact (D1).
+# Container-side paths (/app/data, /repos, /opt/claude-code, docker.sock) are a
+# container-layout convention, NOT host values — deliberately not parametrised.
+# See docs/operations/REPLICATION.md for the full variable map.
 services:
   orchestrator:
-    build: .
+    build:
+      context: .
+      # ORCH-101 (D5): uid/gid/home move as ONE coherent group with the runtime
+      # user: and the mount targets below (ORCH-040 invariant).
+      args:
+        APP_UID: ${ORCH_RUN_UID:-1000}
+        APP_GID: ${ORCH_RUN_GID:-1000}
+        APP_HOME: ${ORCH_AGENT_HOME_DIR:-/home/slin}
     container_name: orchestrator
     restart: unless-stopped
     # ORCH-040: бежим под uid:gid хоста (slin=1000:1000), а не root, чтобы
     # артефакты конвейера (worktree + docs) создавались как slin:slin и git на
     # хосте работал без ручного chown. Доступ к docker.sock сохранён через
     # group_add: ["999"] (МИНА 1 — НЕ удалять). См. ADR-001 ORCH-040.
-    user: "1000:1000"
+    user: "${ORCH_RUN_UID:-1000}:${ORCH_RUN_GID:-1000}"
     # init: true injects docker-init (tini) as PID 1 so reparented grandchild
     # processes from the claude/node subprocess tree are reaped (no zombies, B-2).
     init: true
     network_mode: host
+    # ORCH-101 (D5): the prod port is configurable on the compose layer (the
+    # Dockerfile CMD keeps its exec-form 8500 default — ADR-001 D5); the default
+    # resolves byte-for-byte to the previous image CMD. Reuses the existing
+    # ORCH_DEPLOY_PROD_TARGET_PORT (no second truth about the prod port).
+    command: ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}"]
     volumes:
       - ./data:/app/data
-      - /home/slin/repos:/repos
+      - ${ORCH_HOST_REPOS_DIR:-/home/slin/repos}:/repos
       - /var/run/docker.sock:/var/run/docker.sock
-      - /usr/lib/node_modules/@anthropic-ai/claude-code:/opt/claude-code:ro
-      - /usr/bin/node:/usr/bin/node:ro
-      - /home/slin/.claude:/home/slin/.claude
-      - /home/slin/.claude.json:/home/slin/.claude.json:ro
-      # ORCH-040: target согласован с HOME=/home/slin (launcher), не /root/.ssh.
-      - /home/slin/.orchestrator-ssh:/home/slin/.ssh:ro
+      - ${ORCH_HOST_CLAUDE_CODE_DIR:-/usr/lib/node_modules/@anthropic-ai/claude-code}:/opt/claude-code:ro
+      - ${ORCH_HOST_NODE_BIN:-/usr/bin/node}:/usr/bin/node:ro
+      - ${ORCH_HOST_CLAUDE_DIR:-/home/slin/.claude}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.claude
+      - ${ORCH_HOST_CLAUDE_JSON:-/home/slin/.claude.json}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.claude.json:ro
+      # ORCH-040: target согласован с HOME (launcher: settings.agent_home_dir),
+      # не /root/.ssh — обе стороны двигаются одной переменной ORCH_AGENT_HOME_DIR.
+      - ${ORCH_HOST_SSH_DIR:-/home/slin/.orchestrator-ssh}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.ssh:ro
     env_file: .env
     environment:
       - ORCH_REPOS_DIR=/repos
-      - ORCH_HOST_REPOS_DIR=/home/slin/repos
+      - ORCH_HOST_REPOS_DIR=${ORCH_HOST_REPOS_DIR:-/home/slin/repos}
       # legacy enduro deployer (read via os.environ, keep as-is):
-      - DEPLOY_SSH_USER=slin
+      - DEPLOY_SSH_USER=${ORCH_DEPLOY_SSH_USER:-slin}
       - DEPLOY_SSH_HOST=127.0.0.1
-      - DEPLOY_HOOK_SCRIPT=/home/slin/bin/enduro-deploy-hook.sh
+      - DEPLOY_HOOK_SCRIPT=${DEPLOY_HOOK_SCRIPT:-/home/slin/bin/enduro-deploy-hook.sh}
       # ORCH-036 self-deploy (read via pydantic ORCH_ prefix; host-network -> 127.0.0.1, ssh key mounted):
-      - ORCH_DEPLOY_SSH_USER=slin
+      - ORCH_DEPLOY_SSH_USER=${ORCH_DEPLOY_SSH_USER:-slin}
       - ORCH_DEPLOY_SSH_HOST=127.0.0.1
       - ORCH_DEPLOY_HOOK_SCRIPT=scripts/orchestrator-deploy-hook.sh
-      - ORCH_DEPLOY_HOST_REPO_PATH=/home/slin/repos/orchestrator
+      - ORCH_DEPLOY_HOST_REPO_PATH=${ORCH_DEPLOY_HOST_REPO_PATH:-/home/slin/repos/orchestrator}
     group_add:
-      - "999"
+      - "${ORCH_DOCKER_GID:-999}"
 
   # ORCH-100 (FND/F1b): sidecar-watchdog — the monitoring brain in a SEPARATE
   # container (observer separated from observed, ADR-001 D2). Deploying it builds
@@ -60,7 +83,7 @@ services:
     mem_reservation: 32m
     volumes:
       - /var/run/docker.sock:/var/run/docker.sock:ro
-      - /home/slin/repos:/repos:ro
+      - ${ORCH_HOST_REPOS_DIR:-/home/slin/repos}:/repos:ro
       - ./data:/app/data:ro
     # Optional env_file (required: false): a missing .env.watchdog must NOT fail
     # `docker compose up` for the prod orchestrator (self-hosting safety). Absent
@@ -69,7 +92,7 @@ services:
       - path: .env.watchdog
         required: false
     group_add:
-      - "999"
+      - "${ORCH_DOCKER_GID:-999}"
 
   # ORCH-31: staging instance (port 8501, isolated DB).
   # Starts ONLY with: docker compose --profile staging up -d orchestrator-staging
@@ -77,35 +100,42 @@ services:
   orchestrator-staging:
     profiles:
       - staging
-    build: .
+    build:
+      context: .
+      args:
+        APP_UID: ${ORCH_RUN_UID:-1000}
+        APP_GID: ${ORCH_RUN_GID:-1000}
+        APP_HOME: ${ORCH_AGENT_HOME_DIR:-/home/slin}
     container_name: orchestrator-staging
     restart: unless-stopped
     # ORCH-040: тот же uid хоста, что и у prod (см. комментарий выше / ADR-001).
-    user: "1000:1000"
+    user: "${ORCH_RUN_UID:-1000}:${ORCH_RUN_GID:-1000}"
     init: true
     network_mode: host
-    command: ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8501"]
+    # ORCH-101 (D4): the same ORCH_STAGING_PORT that settings.staging_port reads —
+    # the image_freshness rebuild target and the listening port can never drift.
+    command: ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "${ORCH_STAGING_PORT:-8501}"]
     volumes:
       - ./data/staging:/app/data
-      - /home/slin/repos:/repos
+      - ${ORCH_HOST_REPOS_DIR:-/home/slin/repos}:/repos
       - /var/run/docker.sock:/var/run/docker.sock
-      - /usr/lib/node_modules/@anthropic-ai/claude-code:/opt/claude-code:ro
-      - /usr/bin/node:/usr/bin/node:ro
-      - /home/slin/.claude:/home/slin/.claude
-      - /home/slin/.claude.json:/home/slin/.claude.json:ro
-      # ORCH-040: target согласован с HOME=/home/slin (launcher), не /root/.ssh.
-      - /home/slin/.orchestrator-ssh:/home/slin/.ssh:ro
+      - ${ORCH_HOST_CLAUDE_CODE_DIR:-/usr/lib/node_modules/@anthropic-ai/claude-code}:/opt/claude-code:ro
+      - ${ORCH_HOST_NODE_BIN:-/usr/bin/node}:/usr/bin/node:ro
+      - ${ORCH_HOST_CLAUDE_DIR:-/home/slin/.claude}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.claude
+      - ${ORCH_HOST_CLAUDE_JSON:-/home/slin/.claude.json}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.claude.json:ro
+      # ORCH-040: target согласован с HOME (settings.agent_home_dir), не /root/.ssh.
+      - ${ORCH_HOST_SSH_DIR:-/home/slin/.orchestrator-ssh}:${ORCH_AGENT_HOME_DIR:-/home/slin}/.ssh:ro
     env_file: .env.staging
     environment:
       - ORCH_REPOS_DIR=/repos
-      - ORCH_HOST_REPOS_DIR=/home/slin/repos
-      - DEPLOY_SSH_USER=slin
+      - ORCH_HOST_REPOS_DIR=${ORCH_HOST_REPOS_DIR:-/home/slin/repos}
+      - DEPLOY_SSH_USER=${ORCH_DEPLOY_SSH_USER:-slin}
       - DEPLOY_SSH_HOST=127.0.0.1
-      - DEPLOY_HOOK_SCRIPT=/home/slin/bin/enduro-deploy-hook.sh
+      - DEPLOY_HOOK_SCRIPT=${DEPLOY_HOOK_SCRIPT:-/home/slin/bin/enduro-deploy-hook.sh}
       # Staging DB is isolated via ./data/staging volume mount.
       # Inside the container the path remains /app/data/orchestrator.db (same default),
-      # but on the host it physically lives at ./data/staging/orchestrator.db — 
+      # but on the host it physically lives at ./data/staging/orchestrator.db —
       # completely separate from prod ./data/orchestrator.db.
       - ORCH_DB_PATH=/app/data/orchestrator.db
     group_add:
-      - "999"
+      - "${ORCH_DOCKER_GID:-999}"

docs/architecture/README.md

@@ -158,6 +158,93 @@ orchestrator (каноны ORCH-52b/c/d/e); enduro-trails эталоном не
 `docs/work-items/ORCH-009/06-adr/ADR-001-turnkey-onboarding-kit-and-cli.md` (D1…D11),
 `docs/work-items/ORCH-009/07-infra-requirements.md`.
 
+## Тираж платформы: фундамент 10-common (ORCH-101)
+
+Фундамент эпика ORCH-10 (D5.3 «Масштаб»: раздача платформы заказчикам-тестерам, типы A Lite /
+B Bundled, оба stateless). Платформа разворачивается на новой инфре **без правки кода** — только
+env/конфиг; конвейер (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД) —
+байт-в-байт не тронут. Три слоя:
+
+- **Расхардкод по принципу «дефолт = боевое значение»** (kill-switch-природа: отсутствие новых
+  переменных = текущее поведение 1:1). Новые ключи: `ORCH_AGENT_HOME_DIR` (HOME акторских
+  процессов: launcher ×2 / self-deploy / post-deploy), `ORCH_AGENT_GIT_NAME` +
+  `ORCH_GIT_EMAIL_DOMAIN` (git-идентичности `<actor>@<domain>`; системные имена
+  `deploy-finalizer`/`post-deploy-monitor` — платформенные литералы), `ORCH_STAGING_PORT`.
+  Ссылки в Plane-комментариях — из существующих `gitea_public_url`/`gitea_owner`.
+  `docker-compose.yml` — интерполяция `${VAR:-default}` (карта `ORCH_HOST_*`/`ORCH_DOCKER_GID`/
+  `ORCH_RUN_UID/GID`; группа ORCH-040 uid/gid/HOME/маунты двигается одними env насквозь, «МИНА 1»
+  `group_add` сохранена); `Dockerfile` — `ARG APP_*` (CMD не трогается: exec-form + `init: true`);
+  deploy-hook — `"${REPO:-…}"` + явная передача `REPO=` инвокерами. **Платформенные константы
+  (нормативно, НЕ конфиг):** `SELF_HOSTING_REPO="orchestrator"` (узел «empty CSV → self-hosting
+  only» всех `*_repos`-leaf'ов), имена сервисов/образов/профиля, контейнерный layout.
+  **Инвариант ORCH-058 усилен:** staging-порт конфигурируем только с fail-closed guard'ом
+  (`staging_port == прод-порт` → отказ freshness-пути ДО любого ssh/build, без тихого fallback).
+- **Секреты нового хоста:** stdlib `scripts/gen_secrets.py` (криптослучайные webhook-секреты
+  `secrets.token_hex(32)`; печать по умолчанию; `--write` отказывает при существующем `.env`,
+  перезапись — только явный `--force`) + чек-лист внешних токенов. Норматив: боевые секреты
+  текущего хоста не копируются ни на одном шаге.
+- **Smoke-верификация тиража:** runbook `docs/operations/REPLICATION.md` (deployment golden
+  source: карта env, чек-лист секретов, пошаговый smoke с PASS/FAIL — `/health` → `/queue`+
+  `/metrics` → `onboard_project.py plan/apply/verify` → тестовая задача → артефакты `01–04`;
+  расширенно — до `done`); без нового скрипта — кирпичи уже в репо. Анти-регресс — структурный
+  сканер `tests/test_no_host_hardcodes.py` (запрещённые литералы в исполняемом коде
+  `src/**`+`watchdog/**`; `tokenize`-исключение комментариев/докстрингов; config-модули — канон
+  дефолтов, вне скана; allowlist пуст).
+
+Подробнее: [adr-0036](adr/adr-0036-replication-foundation-host-parametrization.md), детально —
+`docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md` (D1…D10),
+`docs/work-items/ORCH-101/07-infra-requirements.md`, `10-tech-risks.md`.
+
+**Type A — Lite (ORCH-102 — design).** Поверх 10-common вводится канон Lite-тиража: новый
+docs-раздел `docs/deployment/` (витрина тиража, читатель — внешний оператор) с golden source
+`docs/deployment/LITE_SETUP.md` — сквозной маршрут «голый хост → работающий конвейер» из 13
+нормативных разделов (предусловия → код → конфиг/секреты → Plane → Gitea → LLM → Telegram →
+запуск → онбординг проекта → smoke → stateless-проверка → траблшутинг), каждый шаг =
+fenced-команда + явная проверка (PASS/FAIL), хост-специфика — только плейсхолдеры. Compose не
+форкается: `docker-compose.yml` сам является Lite-подмножеством (дефолтный `up -d` поднимает
+ровно `orchestrator`+`orchestrator-watchdog`; staging — за профилем, в Lite опционален). Канон
+watchdog-конфига — новый `.env.watchdog.example` (key-set = блоку `WATCHDOG_*` `.env.example`;
+sidecar читает только `.env.watchdog`; C-1 ORCH-100 — отдельный бот). Норматив тиражной
+инсталляции Gitea: branch protection на `main` НЕ включать (D10 ORCH-009, защита merge-актора).
+Анти-дрейф — структурный `tests/test_lite_setup_doc.py`. Рантайм/конвейер — байт-в-байт
+(docs+tests). Подробнее: [adr-0037](adr/adr-0037-lite-replication-canon.md), детально —
+`docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md`.
+
+**Type B — Bundled (ORCH-103).** Закрывает эпик ORCH-10: весь стек одним комплектом
+(орк + watchdog + Gitea + Plane CE ≈13–14 контейнеров) для заказчика без собственной
+инфраструктуры. Состав Plane — зеркало официального selfhost-référence v0.23.1
+(upstream-имена сервисов web/space/admin/api/worker/beat-worker/migrator/live +
+plane-db/plane-redis/plane-mq/plane-minio/proxy); Gitea — `gitea/gitea:1.22.6`
+(не rootless, ssh выключен). Новый top-level каталог **`deploy/`** (исполняемые дистрибутивы; дополняет
+`docs/deployment/` — инструкции): `deploy/bundled/docker-compose.yml` — один самодостаточный
+compose с `name: orchestrator-bundle` (узнаваемый префикс томов/контейнеров; `container_name`
+не пиннится — нет коллизий с корневым compose на одном хосте), пиннинг сторонних образов
+неподвижными тегами литералом (не `latest`); корневой compose не форкается (заморожен
+анти-дрейфом ORCH-102); staging-контур орка в bundle отсутствует, репо `orchestrator` не
+регистрируется → self-deploy-машинерия структурно спит (`SELF_HOSTING_REPO`-леафы не матчатся).
+Сеть — одна bridge: машинный трафик строго сервис-DNS (webhooks в обе стороны, API, /metrics),
+наружу — только человеческие порты (Plane 8080 / Gitea 3000 / орк 8500; явный
+`GITEA__webhook__ALLOWED_HOST_LIST=orchestrator` против дефолтного запрета приватных таргетов).
+Конфиг-слои: `deploy/bundled/.env.example` (канон bundle-инфры, key-set-sync тест) → live
+`deploy/bundled/.env` (авто-чтение compose из project dir, без `--env-file`-футгана); runtime
+орка/watchdog — корневые `.env`/`.env.watchdog` ровно по канону Lite (`env_file: required:
+false` до сборки); **единственный писатель live-файлов — bootstrap**.
+`scripts/bootstrap_bundle.py` (python stdlib-only, `plan`-дефолт/`apply`/`verify`, step-движок
+check→ensure, exit 0/2/1): preflight fail-fast до мутаций → секреты (`gen_secrets.py` +
+stdlib-креды стека, в логи не печатаются) → up+ожидание готовности → init Gitea (полностью
+автоматом через CLI; branch protection НЕ включать — D10 ORCH-009) → init Plane CE (честные
+manual-step: инструкция → подтверждение → API-верификация результата) → онбординг
+sandbox-проекта строго `onboard_project.py apply`/`verify` (host-venv, канон ONBOARDING) →
+git-доступ агентов token-remote (`_push_url`-паттерн; ssh-контур не вводится) → сборка env
+орка → health/итог; delete-операций в скрипте нет — teardown только документированной
+процедурой (§13). Golden source — `docs/deployment/BUNDLED_SETUP.md` (14 разделов по канону
+LITE_SETUP, требования к хосту по замеру тестового развёртывания; REPLICATION §1 — отметка
+Type B). Анти-дрейф — `tests/test_bundle_compose.py` / `test_bundled_setup_doc.py` /
+`test_bootstrap_script.py`. Рантайм/конвейер — байт-в-байт; kill-switch не нужен (активация —
+только явный запуск оператора на целевом хосте, паттерн ORCH-009). Подробнее:
+[adr-0038](adr/adr-0038-bundled-replication-canon.md), детально —
+`docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`.
+
 ## Конвейер и Quality Gates
 
 ```

docs/architecture/adr/README.md

@@ -41,11 +41,13 @@ Per-work-item решения живут в `docs/work-items/<id>/06-adr/ADR-NNN-
 | adr-0033 | Sidecar-watchdog F1b — мозг мониторинга в отдельном контейнере | proposed | 2026-06-10 | ORCH-100 |
 | adr-0034 | Машинный журнал уроков — таблица `lessons` + observer-leaf | proposed | 2026-06-10 | ORCH-098 |
 | adr-0035 | Turnkey-онбординг проектов — kit + операторский CLI + runbook | proposed | 2026-06-10 | ORCH-009 |
+| adr-0036 | Фундамент тиража платформы — параметризация хоста, секреты, smoke (10-common) | proposed | 2026-06-10 | ORCH-101 |
+| adr-0037 | Канон Lite-тиража — `docs/deployment/LITE_SETUP.md` + `.env.watchdog.example` | proposed | 2026-06-10 | ORCH-102 |
 
 > ⚠️ Историческая коллизия: номер `0007` занят двумя файлами —
 > `adr-0007-reconciler.md` (ORCH-053) и `adr-0007-executable-self-deploy.md`
 > (ORCH-036). Оба accepted; для новых сквозных ADR использовать следующий
-> свободный номер (текущий максимум — `0035`).
+> свободный номер (текущий максимум — `0037`).
 > 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).

docs/architecture/adr/adr-0036-replication-foundation-host-parametrization.md

@@ -0,0 +1,109 @@
+---
+work_item: ORCH-101
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# adr-0036: Фундамент тиража платформы — параметризация хоста, секреты, smoke (ORCH-101, 10-common)
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5.3 «Масштаб») — тираж платформы для заказчиков-тестеров двумя типами (A Lite /
+B Bundled), оба stateless. Платформа была фактически прибита к хосту `mva154`: четыре места в
+`src/**` обходили конфиг (внешний Gitea-URL в `plane_sync`, HOME + git-идентичности акторов в
+`launcher`/`self_deploy`/`post_deploy`), `docker-compose.yml`/`Dockerfile`/deploy-hook несли
+литералы путей/uid/gid/портов; механизма выпуска нового комплекта секретов и процедуры верификации
+развёрнутой копии не существовало. ORCH-101 (10-common) — общий фундамент обоих типов тиража.
+
+Это сквозное решение: оно задаёт **платформенные конвенции тиража** и трогает блоки, помеченные
+маркерами ORCH-036/ORCH-040/ORCH-058 (по `docs/_standards/TRACEABILITY.md` — сводный ADR вместо
+архео-перечисления). Детальный пакет решений (D1…D10) — work-item ADR:
+`docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md`.
+
+## Решение
+
+**Принцип: «дефолт = боевое значение».** Каждое хост-специфичное значение читается из конфига
+(`Settings` env `ORCH_*` / compose-интерполяция `${VAR:-default}` / Dockerfile `ARG` /
+shell-default хука) с дефолтом, равным текущему боевому значению. Отсутствие новых переменных =
+байт-в-байт текущее поведение (kill-switch-природа; отдельный функциональный флаг не вводится).
+`src/config.py` и `watchdog/config.py` — единственные легитимные места хост-литералов в коде.
+
+**Новые конфиг-ключи:** `agent_home_dir` (`ORCH_AGENT_HOME_DIR`, `/home/slin`) — HOME всех
+акторских процессов; `agent_git_name` (`claude-bot`) + `git_email_domain` (`mva154.local`) —
+git-идентичности (`<actor>@<domain>`; системные акторы `deploy-finalizer`/`post-deploy-monitor` —
+платформенные литералы); `staging_port` (`ORCH_STAGING_PORT`, `8501`). Ссылки в Plane-комментариях —
+из существующих `gitea_public_url`/`gitea_owner`. Compose-слой — карта `ORCH_HOST_*`/
+`ORCH_DOCKER_GID`/`ORCH_RUN_UID/GID` + реюз `ORCH_DEPLOY_*`; порт прод/стейджинг — явные `command:`
+с `${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}` / `${ORCH_STAGING_PORT:-8501}` (CMD образа не трогается —
+exec-form + `init: true` сохранены).
+
+**Платформенные конвенции тиража (нормативно):**
+1. **`SELF_HOSTING_REPO = "orchestrator"` — константа, не конфиг.** На ней «empty CSV →
+   self-hosting only» всех `*_repos`-leaf'ов; конфигурируемость превращала бы опечатку env в
+   активацию деплой-машинерии на чужом репо или тихое выключение всех self-гейтов. Репо платформы
+   в тираже обязан называться `orchestrator` (REPLICATION.md).
+2. **Имена compose-сервисов/контейнеров/образов, профиль `staging`, `network_mode: host`,
+   контейнерный layout (`/app/data`, `/repos`, `/opt/claude-code`)** — конвенции, не переменные
+   (для образов истина уже в конфиге `deploy_prod_*_image`).
+3. **Staging-порт конфигурируем ТОЛЬКО с fail-closed guard'ом** (усиление инварианта ORCH-058
+   AC-9): freshness-путь отказывает ДО любого ssh/build при
+   `staging_port == deploy_prod_target_port` — без тихого fallback. Explicit-pass таргета хуку
+   (`TARGET_PORT=` и др.) сохранён; добавлена явная передача `REPO=` обоими инвокерами хука
+   (его строка 38 становится `"${REPO:-…}"` — exit-контракт 0/1/2 ORCH-036 не тронут).
+4. **Группа ORCH-040 неделима:** uid/gid/HOME/маунт-таргеты/`useradd` управляются одними env
+   насквозь (`ORCH_RUN_UID/GID`, `ORCH_AGENT_HOME_DIR` → compose `user:`/таргеты/`build.args
+   APP_*`); `group_add` docker-gid («МИНА 1») не удаляется — литерал станет
+   `${ORCH_DOCKER_GID:-999}`.
+
+**Секреты нового хоста:** stdlib-скрипт `scripts/gen_secrets.py` — криптослучайные webhook-секреты
+(`secrets.token_hex(32)`), печать по умолчанию, `--write` отказывает при существующем `.env`
+(перезапись — только явный `--force`); внешние токены (Plane/Gitea/Telegram/watchdog) — по
+чек-листу. Норматив: **боевые секреты текущего хоста не копируются ни на одном шаге**.
+
+**Smoke-верификация тиража:** runbook `docs/operations/REPLICATION.md` (deployment golden source:
+карта env, чек-лист секретов, пошаговый smoke с PASS/FAIL: `compose config` → `/health` →
+`/queue`+`/metrics` → `onboard_project.py plan/apply/verify` → тестовая задача → артефакты `01–04`
+в ветке; расширенно — до `done`; границы 10-common vs Lite vs Bundled). Нового smoke-скрипта нет —
+шаги собраны из существующих кирпичей.
+
+**Анти-регресс (постоянная CI-гарантия):** структурный сканер `tests/test_no_host_hardcodes.py` —
+запрещённые литералы (`82.22.50.71`, `/home/slin`, `mva154`, `duckdns`; список централизован) в
+исполняемом коде `src/**`+`watchdog/**`; `tokenize`-исключение комментариев/докстрингов;
+структурное исключение двух config-модулей (канон дефолтов); allowlist пуст; негативная
+самопроверка.
+
+### Что НЕ меняется
+`STAGE_TRANSITIONS`, состав `QG_CHECKS`, семантика `check_*`, machine-verdict ключи, схема БД —
+байт-в-байт; значения существующих конфиг-дефолтов; INV-4; прод-контейнер в рамках задачи не
+рестартуется (правки compose/Dockerfile инертны до штатного деплоя через staging 8501 →
+`Confirm Deploy`).
+
+## Альтернативы
+- **`ORCH_SELF_HOSTING_REPO` конфигом** — отвергнуто: узел безопасности; опечатка = групповой риск.
+- **Staging-порт константой** — отвергнуто: compose-порт параметризуется (AC-6), константа дала бы
+  рассинхрон слоёв; пара «ключ + guard» строго сильнее.
+- **Smoke-скрипт-обвязка / генератор в `onboard_project.py`** — отвергнуто: лишняя поверхность;
+  разные жизненные циклы (онбординг проекта ≠ provisioning хоста).
+
+## Последствия
+- Платформа разворачивается на чужой инфре env-конфигурацией; критический путь ORCH-10 разблокирован
+  (Lite/Bundled строятся поверх REPLICATION.md).
+- Инвариант ORCH-058 переходит из «подразумеваемого константой» в исполняемый guard; возврат
+  хост-хардкода ломает CI структурно.
+- Цена: ~13 новых env-имён (на текущем хосте настраивать нечего — дефолты боевые) и правило
+  «интерполяция читает `.env`/shell, не `env_file`» (зафиксировано в REPLICATION.md).
+- Откат: не задавать переменные (дефолты = прежнее поведение); полный — revert PR (без миграций).
+
+## Связи
+adr-0005 (ORCH-040 — uid/HOME/«МИНА 1»; группа становится параметризуемой, инвариант сохранён),
+adr-0008 (ORCH-058 — INV-FRESH/AC-9; guard усиливает), adr-0007 (ORCH-036 — exit-контракт хука
+не тронут), adr-0035 (ORCH-009 — onboarding переиспользуется smoke-процедурой; kit не форкается),
+adr-0001 (`is_self_hosting_repo` — конвенция имени закреплена). Детально —
+`docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md` (D1…D10),
+`07-infra-requirements.md`, `10-tech-risks.md`.

docs/architecture/adr/adr-0037-lite-replication-canon.md

@@ -0,0 +1,96 @@
+---
+work_item: ORCH-102
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# adr-0037: Канон Lite-тиража — `docs/deployment/LITE_SETUP.md` + `.env.watchdog.example` (ORCH-102, 10a)
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5 «Масштаб»), тип **A — Lite**: раздача орк+watchdog заказчику-тестеру, окружение
+(Plane/Gitea/LLM/Telegram) он донастраивает сам. Фундамент 10-common (ORCH-101, adr-0036) в
+`main`: технически платформа разворачивается без правки кода, но операционно знания размазаны по
+4 operations-докам, писанным для оператора НАШЕГО хоста, — заказчик не может развернуть Lite без
+доп-вопросов. Решения Владельца 10.06: оба типа тиража stateless; главный продукт ORCH-102 —
+инструкция-golden-source в репо.
+
+Сквозной характер: вводится новый docs-раздел, новый канонический example-файл и нормативы,
+обязательные для всех будущих задач эпика ORCH-10 и для любого агента, меняющего шаги тиража.
+Детальный пакет решений (D1…D9, исходы вопросов ТЗ А-1…А-6) — work-item ADR:
+`docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md`.
+
+## Решение
+
+1. **Новый docs-раздел `docs/deployment/` — витрина тиража.** Семантика: `deployment/` — «как
+   развернуть платформу у себя» (читатель — внешний оператор), `operations/` — «как
+   эксплуатировать наш прод». Golden source Lite — **`docs/deployment/LITE_SETUP.md`**:
+   сквозной маршрут «голый хост → работающий конвейер» из 13 нормативных разделов (рамка →
+   предусловия → код → конфиг/секреты → Plane → Gitea → LLM → Telegram → запуск → онбординг →
+   smoke → stateless-проверка → траблшутинг); каждый шаг = fenced-команда + явная проверка
+   (PASS/FAIL); хост-специфика — только плейсхолдеры. Канон не форкается: статусы/env/вебхуки —
+   ссылками на ONBOARDING/REPLICATION/SETUP_WEBHOOKS (`REPLICATION.md` остаётся в
+   `operations/`; перекрёстные ссылки в обе стороны). **Норматив сопровождения:** изменение
+   шагов тиража → обновление LITE_SETUP.md в том же PR (правило агентов №2).
+2. **Compose не форкается.** `docker-compose.yml` сам является Lite-подмножеством (ровно
+   `orchestrator` + `orchestrator-watchdog` + `orchestrator-staging` за `profiles: [staging]`;
+   дефолтный `up -d` поднимает орк+watchdog; сервисов Plane/Gitea нет) — отдельный
+   `docker-compose.lite.yml` не вводится; свойство становится CI-гарантией (структурный тест
+   через `yaml.safe_load`).
+3. **`.env.watchdog.example` — третий канонический env-example** (рядом с `.env.example`/
+   `.env.staging.example`): закрывает ловушку файла-носителя (sidecar читает ТОЛЬКО
+   `.env.watchdog`; ключ `WATCHDOG_*` в `.env` для него инертен). Key-set = ровно блок
+   `WATCHDOG_*` из `.env.example` (равенство множеств держит тест); токены — плейсхолдеры;
+   шапка несёт C-1 ORCH-100 (отдельный watchdog-бот, токен орка переиспользовать запрещено)
+   и когерентность `WATCHDOG_METRICS_URL` ⇄ `ORCH_DEPLOY_PROD_TARGET_PORT`.
+4. **Норматив тиражной инсталляции Gitea: branch protection на `main` НЕ включать; pre-receive
+   хуки не вводятся** (подтверждение ORCH-009 ADR-001 D10 для чужих инсталляций:
+   required-approvals/status-checks ломают PR-merge API merge-актора → ложные HOLD; защита
+   `main` — конвенция + скоуп токенов + INV-4).
+5. **Staging-контур в Lite опционален:** базовый контур заказчика = prod-оркестратор + watchdog;
+   песочница 8501 нужна только при self-hosting развитии платформы у заказчика (регистрация
+   проекта `orchestrator`); guard ORCH-058 (staging-порт ≠ прод-порт) действует.
+6. **Анти-дрейф — постоянная CI-гарантия:** `tests/test_lite_setup_doc.py` (структурный, без
+   сети/LLM): разделы/кирпичи дока, env-ключи дока ⊂ `.env.example`, key-sync watchdog-example,
+   compose-подмножество, stateless-норматив + отсутствие секретов/боевых литералов в
+   fenced-блоках (реюз центрального `FORBIDDEN` из `tests/test_no_host_hardcodes.py` импортом),
+   перекрёстность REPLICATION→LITE_SETUP + CHANGELOG.
+
+### Что НЕ меняется
+`src/**`, `docker-compose.yml`, `Dockerfile`, `scripts/**`; `STAGE_TRANSITIONS`, состав
+`QG_CHECKS`, семантика `check_*`, machine-verdict ключи, схема БД — байт-в-байт. Новый QG не
+регистрируется (структурные тесты попадают в существующие гейты). Прод-контейнер в рамках
+задачи не рестартуется (выкат — штатно: staging 8501 → `Confirm Deploy`).
+
+## Альтернативы
+- **Инструкция в `docs/operations/`** — отвергнуто: другой целевой читатель; путь зафиксирован
+  Владельцем (D-4).
+- **`docker-compose.lite.yml`** — отвергнуто: вторая правда о сервисах = дрейф-поверхность.
+- **Pre-receive/branch protection как «защита `main`»** — отвергнуто: класс инцидента ORCH-063
+  (ложные HOLD merge-актора); пересмотр — только отдельным ADR.
+- **Без example-файла watchdog (шаг прозой)** — отвергнуто: двусмысленность файла-носителя
+  остаётся; example + key-sync тест надёжнее.
+
+## Последствия
+- Type A эпика ORCH-10 закрыт продуктом-инструкцией; Type B (Bundled) строится поверх
+  (переиспользует разделы Lite). Полнота инструкции и compose-подмножество защищены CI.
+- Цена: новый golden source требует сопровождения (норматив «в том же PR» + структурный тест
+  рвёт CI при дрейфе); осознанный дубль ключей `WATCHDOG_*` в двух example-файлах — под
+  key-sync тестом.
+- Откат: удалить `docs/deployment/`, тест и `.env.watchdog.example`, вернуть строку
+  REPLICATION.md §1 — состояние 1:1 (docs+tests, без миграций).
+
+## Связи
+adr-0036 (ORCH-101 — фундамент 10-common; этот ADR строит слой Lite поверх), adr-0035
+(ORCH-009 — onboarding-CLI/kit переиспользуются маршрутом §5/§6/§10; D10 подтверждён п.4),
+adr-0033 (ORCH-100 — sidecar-watchdog; C-1 независимый Telegram-канал закреплён в example),
+adr-0008 (ORCH-058 — staging-порт guard, вилка staging п.5), adr-0027/INV-4 (merge-актор —
+основание запрета branch protection). Детально —
+`docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md`,
+`docs/work-items/ORCH-102/10-tech-risks.md`.

docs/architecture/adr/adr-0038-bundled-replication-canon.md

@@ -0,0 +1,114 @@
+---
+work_item: ORCH-103
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# adr-0038: Канон Bundled-тиража — `deploy/bundled/` + bootstrap + `BUNDLED_SETUP.md` (ORCH-103, 10b)
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5 «Масштаб»), тип **B — Bundled**: заказчик без собственной инфраструктуры
+получает **весь стек одним комплектом** (орк + watchdog + Gitea + Plane CE ≈13–14 контейнеров) и
+bootstrap, доводящий его до рабочего конвейера одним запуском. Фундамент готов: 10-common
+(ORCH-101, adr-0036 — хост-параметризация/секреты/smoke) и Lite (ORCH-102, adr-0037 — док-канон
+`docs/deployment/`). Корневой `docker-compose.yml` заморожен анти-дрейфом ORCH-102 (ровно 3
+сервиса, запрет подстрок `plane`/`gitea`) → комплект обязан жить отдельным файлом.
+
+Сквозной характер: вводится новый top-level каталог `deploy/` (дистрибутивы развёртывания),
+новый канонический env-example и нормативы, обязательные для будущих задач эпика ORCH-10 и
+любого агента, меняющего шаги тиража. Детальный пакет решений (D1…D11, исходы OQ-1…OQ-7 ТЗ) —
+work-item ADR: `docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`.
+
+## Решение
+
+1. **Новый top-level каталог `deploy/` — исполняемые дистрибутивы развёртывания** (дополняет
+   `docs/deployment/` — инструкции). Bundled-комплект: **`deploy/bundled/docker-compose.yml`** —
+   один самодостаточный compose всего стека с top-level `name: orchestrator-bundle` (project
+   name = узнаваемый префикс томов/контейнеров; `container_name` не пиннится — нет коллизий с
+   корневым compose на одном хосте). Staging-контур орка в bundle **отсутствует вовсе**; репо
+   `orchestrator` в bundle-инсталляции не регистрируется → self-deploy-машинерия структурно спит
+   (`SELF_HOSTING_REPO`-леафы не матчатся).
+2. **Конфиг-слои:** `deploy/bundled/.env.example` — канон bundle-инфры (committed, плейсхолдеры;
+   key-set-sync тест: каждая `${VAR}`-интерполяция bundle-compose имеет ключ в каноне) → live
+   `deploy/bundled/.env` (авто-чтение compose из project dir — без `--env-file`-футгана; покрыт
+   неякорным `.env` в `.gitignore`); runtime орка/watchdog — **корневые `.env`/`.env.watchdog`
+   ровно по канону Lite** (REPLICATION §2 применим 1:1), в bundle-compose — `env_file:
+   required: false` (первый `up` жив до сборки конфига). **Bootstrap — единственный писатель**
+   всех трёх live-файлов (когерентность дублируемых ключей — механическая). Один факт = одно имя
+   (ORCH-101 D1): существующие факты — существующие `ORCH_*`-имена; bundle-only — `BUNDLE_*`;
+   внутренние креды Plane — upstream-имена.
+3. **Состав/пиннинг:** Plane CE — зеркало официального selfhost-référence (upstream-имена
+   сервисов/env); Gitea — `gitea/gitea` (не rootless). Пиннинг — **точный неподвижный тег
+   литералом** (не `latest`, не интерполяция; digest не требуется); точные теги фиксирует
+   developer по проверенному стенду; форму держит структурный тест.
+4. **Сеть:** одна именованная bridge-сеть; машинный трафик — строго сервис-DNS
+   (`http://orchestrator:8500/webhook/*`, `http://gitea:3000`, plane-proxy); `network_mode: host`
+   в bundle не используется (ssh-деплой-пути неактивны: `ORCH_DEPLOY_SSH_HOST` пуст). Наружу —
+   только человеческие порты (Plane proxy 8080 / Gitea 3000 / орк 8500; конфигурируемы);
+   БД/брокер/minio не публикуются. Публичные URL — от `BUNDLE_PUBLIC_HOST` (split internal/public
+   уже в конфиге орка). Мина Gitea закрывается явно: `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator`.
+5. **Bootstrap `scripts/bootstrap_bundle.py`:** python stdlib-only, без импортов из `src/**`;
+   режимы `plan` (дефолт, ноль мутаций) / `apply` / `verify`; step-движок check→ensure
+   (идемпотентность, resume = повторный запуск); exit `0/2/1`. Preflight fail-fast до мутаций
+   (docker/порты/чистота томов по префиксу/RAM/диск; Claude CLI — warning). **Кирпичи не
+   дублируются:** секреты — субпроцесс `gen_secrets.py`; статусы/лейблы/репо/вебхуки — строго
+   `onboard_project.py apply`+`verify` (host-venv, канон ONBOARDING). Init Gitea — полностью
+   автоматом (CLI в контейнере; branch protection НЕ настраивается — D10 ORCH-009/adr-0037 п.4);
+   init Plane CE — честные **manual-step чекпоинты** (инструкция → подтверждение →
+   API-верификация; прогрессивная автоматизация разрешена без смены контракта). Git-доступ
+   агентов — HTTP token-remote (паттерн `_push_url`); ssh-контур не вводится. Секреты в
+   логи не печатаются; delete-операций в скрипте нет вообще — teardown только документированной
+   процедурой (`BUNDLED_SETUP` §13).
+6. **Док-канон:** `docs/deployment/BUNDLED_SETUP.md` — 14 нормативных разделов по форме
+   LITE_SETUP (fenced-команда + «Проверка:» PASS/FAIL, плейсхолдеры, общие шаги ссылками на
+   LITE_SETUP/ONBOARDING/REPLICATION — канон не форкается), включая «Требования к хосту» с
+   цифрами **по замеру** тестового развёртывания. REPLICATION §1: Type B → ✅ ORCH-103.
+   **Норматив сопровождения:** изменил шаги Bundled-тиража → обнови BUNDLED_SETUP.md в том же PR.
+7. **Анти-дрейф — постоянная CI-гарантия:** `tests/test_bundle_compose.py` /
+   `test_bundled_setup_doc.py` / `test_bootstrap_script.py` (структурные, без docker/сети/LLM:
+   состав сервисов, заморозка корневого compose, пины, key-set-sync, разделы дока, FORBIDDEN —
+   импортом из `test_no_host_hardcodes.py`, секрет-эвристика, ссылки на кирпичи, отсутствие
+   delete-операций, unit чистых функций preflight/плана, exit-контракт).
+
+### Что НЕ меняется
+`src/**`, корневой `docker-compose.yml`, `Dockerfile`, `.gitea/workflows/**`, `onboarding/**`,
+промпты `.openclaw/agents/**`; `STAGE_TRANSITIONS`, состав `QG_CHECKS`, семантика `check_*`,
+machine-verdict ключи, схема БД — байт-в-байт. Kill-switch не вводится (активация — только явный
+запуск оператора на целевом хосте, паттерн ORCH-009). Прод-контейнер в рамках задачи не
+рестартуется; наши данные/секреты не переносятся (stateless, решение Владельца 10.06).
+
+## Альтернативы
+- **Расширение корневого compose (профиль `bundled`)** — отвергнуто: заморожен анти-дрейфом
+  ORCH-102/нормативом «compose не форкается»; смешение дистрибутива с боевым контуром.
+- **Include-композиция / live-env через `--env-file`** — отвергнуто: лишние степени свободы
+  запуска, молчаливые дефолты при забытом флаге.
+- **Орк в bundle на host-network + `host-gateway`** — отвергнуто: хост-сеть нужна была
+  ssh-деплой-контуру нашего хоста, который в bundle спит; bridge даёт чистые двунаправленные
+  сервис-DNS-URL.
+- **Digest-пиннинг / rootless-Gitea / ssh-доступ агентов / bash-bootstrap / reset-режим
+  скрипта** — отвергнуты (см. work-item ADR-001, «Альтернативы»).
+
+## Последствия
+- Эпик ORCH-10 закрыт по обоим типам: A (Lite, инструкция) + B (Bundled, комплект); заказчик
+  без инфраструктуры разворачивает конвейер «под ключ».
+- Цена: пиннованные версии Plane/Gitea стареют (апгрейд — отдельные задачи); manual-step Plane CE
+  размывают «одну команду» — неустранимо честно (нет API), митигировано контрактом чекпоинта;
+  двойной `.env`-слой — под единственным писателем-bootstrap и key-sync тестом.
+- Откат: удалить `deploy/`, bootstrap, BUNDLED_SETUP.md, три тест-модуля, строку REPLICATION §1 —
+  состояние 1:1 (docs+scripts+tests, без миграций).
+
+## Связи
+adr-0036 (ORCH-101 — фундамент 10-common: параметризация, gen_secrets, REPLICATION/smoke),
+adr-0037 (ORCH-102 — док-канон `docs/deployment/`, compose-подмножество, запрет branch
+protection), adr-0035 (ORCH-009 — onboarding-CLI: 22 статуса, manual-step паттерн, `_push_url`,
+D10), adr-0027/INV-4 (merge-актор — основание норматива Gitea), adr-0001
+(`SELF_HOSTING_REPO`-конвенция — почему self-гейты в bundle спят). Детально —
+`docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md`,
+`07-infra-requirements.md`, `10-tech-risks.md`.

docs/deployment/BUNDLED_SETUP.md

@@ -0,0 +1,436 @@
+# BUNDLED_SETUP — Bundled-тираж: весь стек одним комплектом (ORCH-103)
+
+> **Golden source Bundled-тиража (Type B эпика ORCH-10).** Маршрут «чистый хост →
+> работающий конвейер» для заказчика **без собственной инфраструктуры**: один
+> compose-комплект (`deploy/bundled/docker-compose.yml`) поднимает оркестратор +
+> watchdog + Gitea + Plane CE, один запуск `scripts/bootstrap_bundle.py apply`
+> доводит стек до рабочего состояния. Каждый шаг — исполняемая команда + явная
+> проверка результата (**Проверка:** / PASS / FAIL). Хост-специфика — только
+> плейсхолдеры `<...>` и `$ENV_VAR`. Тираж **stateless**: данные/задачи/секреты
+> боевого (исходного) хоста **НЕ переносятся** ни на одном шаге (§12).
+> Границы слоёв тиража (10-common vs Lite vs Bundled) — `docs/operations/REPLICATION.md` §1;
+> канон Lite (своя инфраструктура Plane/Gitea) — `docs/deployment/LITE_SETUP.md`.
+
+---
+
+## 1. Рамка Bundled
+
+**Что входит в комплект** (compose-проект `orchestrator-bundle`, одна bridge-сеть):
+- `orchestrator` (конвейер, образ собирается из этого чекаута) и
+  `orchestrator-watchdog` (независимый sidecar-мониторинг);
+- **Gitea** (git-хостинг, пиннованный официальный образ);
+- **Plane CE — ≈ 14 контейнеров** (зеркало официального selfhost-комплекта:
+  web/space/admin/api/worker/beat-worker/migrator/live + postgres/redis/
+  rabbitmq/minio/proxy) — это **ресурсоёмко**, см. §2.
+
+**Что НЕ входит** (внешние предусловия заказчика):
+- **Claude CLI / LLM-доступ** — дистрибутив claude-code, node и аутентификация
+  живут на хосте и пробрасываются маунтами (§8); без них стек поднимется, но
+  конвейер не поедет;
+- **Telegram-боты** — опциональны (§9): пусто = деградация только нотификаций;
+- **HTTPS/домены/reverse-proxy** — вне bundle: наружу публикуются три http-порта
+  (§2), терминирование TLS — средствами заказчика.
+
+**Bundled vs Lite:** Lite (`LITE_SETUP.md`) подключает оркестратор к **вашим**
+Plane/Gitea; Bundled везёт их **с собой** на чистых томах. Staging-контур орка в
+bundle отсутствует вовсе: заказчик Type B эксплуатирует платформу для своих
+проектов, а не развивает её self-hosting'ом (нужен self-hosting — маршрут Lite,
+`LITE_SETUP.md` §9.3). Репо `orchestrator` в bundle-инсталляции **не
+регистрируется** как проект.
+
+**Осознанный компромисс (TR-7):** git-доступ агентов — HTTP token-remote
+(токен бот-юзера в конфиге локальных чекаутов, права 600); ssh-контур
+сознательно не вводится; порты БД/брокера/minio наружу не публикуются.
+
+---
+
+## 2. Требования к хосту
+
+Linux x86_64, один хост. Минимумы проверяет preflight bootstrap **до любых
+мутаций** (пороги — константы `scripts/bootstrap_bundle.py`, ниже — те же цифры;
+подтверждаются замером приёмочного развёртывания):
+
+| Ресурс | Минимум | Почему |
+|--------|---------|--------|
+| RAM | **8 GB** | Plane CE — ≈ 14 контейнеров (миграции и брокер прожорливы) |
+| Диск | **40 GB** свободно | образы стека + тома postgres/minio/gitea + данные орка |
+| CPU | **4 vCPU** (рекомендация) | меньше — стек поднимется, но будет медленным |
+
+**Карта публикуемых портов** (дефолты; конфигурируемы в
+`deploy/bundled/.env`, ключи `BUNDLE_*`):
+
+| Порт | Ключ | Сервис |
+|------|------|--------|
+| 8500 | `BUNDLE_ORCH_PORT` | API оркестратора (`/health`, `/queue`, `/metrics`, вебхуки) |
+| 8080 | `BUNDLE_PLANE_PORT` | Plane UI (proxy) |
+| 3000 | `BUNDLE_GITEA_HTTP_PORT` | Gitea web/API |
+
+Postgres/redis/rabbitmq/minio наружу **не публикуются** (машинный трафик —
+внутрисетевой сервис-DNS).
+
+```bash
+free -g                                   # RAM ≥ 8 GB
+df -h .                                   # свободно ≥ 40 GB
+nproc                                     # ≥ 4
+ss -ltn | grep -E ':(8500|8080|3000)\b' || echo "ports free"
+```
+
+**Проверка:** ресурсы не ниже минимумов и `ports free` — PASS. Порт занят →
+смените соответствующий `BUNDLE_*`-ключ в §5 (или освободите порт) — иначе
+preflight откажет (FAIL до мутаций, это штатно).
+
+---
+
+## 3. Предусловия
+
+Софт хоста: Docker Engine + Compose v2, git, python3 (+venv), sudo у оператора.
+
+```bash
+uname -sm                      # Linux x86_64
+docker --version && docker compose version
+git --version && python3 --version
+python3 -m venv --help >/dev/null && echo "venv: ok"
+getent group docker            # третье поле — gid, понадобится в §5 (ORCH_DOCKER_GID)
+id -u && id -g                 # uid/gid оператора (ORCH_RUN_UID / ORCH_RUN_GID)
+```
+
+**Проверка:** все команды отвечают без ошибок, gid группы docker известен —
+PASS; что-то отсутствует — FAIL (доставьте пакет средствами дистрибутива).
+
+---
+
+## 4. Получение кода
+
+Переносится **только код** — чекаут репо `orchestrator` (норматив §12).
+
+```bash
+git clone <ORCHESTRATOR_GIT_URL> <путь-чекаута>
+cd <путь-чекаута>
+ls deploy/bundled/docker-compose.yml deploy/bundled/.env.example \
+   scripts/bootstrap_bundle.py scripts/gen_secrets.py scripts/onboard_project.py
+```
+
+**Проверка:** все пять файлов на месте — PASS. Канал дистрибуции
+(`<ORCHESTRATOR_GIT_URL>`) согласуйте с поставщиком платформы (как в
+`LITE_SETUP.md` §3).
+
+---
+
+## 5. Секреты
+
+Все секреты инсталляции выпускаются **заново на месте** (§12): webhook-секреты —
+`scripts/gen_secrets.py`, внутренние креды Plane/Gitea-стека — генерирует
+bootstrap (в репо — только пустые плейсхолдеры, ни одного дефолтного пароля).
+
+**5.1. Конфиг bundle-инфры.**
+
+```bash
+cd <путь-чекаута>
+cp deploy/bundled/.env.example deploy/bundled/.env
+chmod 600 deploy/bundled/.env
+# заполнить НЕсекретные ключи: BUNDLE_PUBLIC_HOST (IP/имя хоста для браузера),
+# карту портов BUNDLE_* (§2), ORCH_RUN_UID/ORCH_RUN_GID (из §3),
+# ORCH_DOCKER_GID (getent group docker, §3), пути Claude CLI (§8).
+```
+
+**Проверка:**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml config --quiet && echo "config: PASS"
+```
+
+`config: PASS` — интерполяция согласована; ошибка — FAIL (опечатка в
+`deploy/bundled/.env`).
+
+**5.2. Секрет-значения** (пустые ключи `deploy/bundled/.env` и корневого `.env`)
+заполнит `bootstrap_bundle.py apply` (§7): webhook-секреты — субпроцессом
+`gen_secrets.py`, креды postgres/rabbitmq/minio/`SECRET_KEY` Plane и пароль
+админ-бота Gitea — stdlib-генератором. Значения **не печатаются** (только имена
+ключей); повторный запуск **не перетирает** существующие секреты (явная
+регенерация — флаг `--force-secrets`, допустим только ДО первого запуска стека).
+
+```bash
+grep -cE '^(POSTGRES_PASSWORD|SECRET_KEY|RABBITMQ_DEFAULT_PASS|MINIO_ROOT_PASSWORD|GITEA_ADMIN_PASSWORD)=$' \
+  deploy/bundled/.env
+```
+
+**Проверка:** до §7 счётчик `5` (пустые плейсхолдеры) — PASS; после §7 — `0`.
+
+---
+
+## 6. Запуск bundle-compose
+
+Одна команда поднимает весь стек (≈ 16 контейнеров; первый запуск тянет образы
+и гоняет миграции Plane — это минуты, не секунды).
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml up -d
+docker compose -f deploy/bundled/docker-compose.yml ps
+```
+
+**Проверка:** все сервисы в состоянии `Up`/`Up (healthy)`; `migrator` —
+`Exited (0)` (одноразовая миграция) — PASS. Контейнер в рестарт-цикле — FAIL
+(§14). Шаг идемпотентен; можно пропустить — `bootstrap_bundle.py apply` выполнит
+`up -d` сам (§7).
+
+---
+
+## 7. Bootstrap
+
+Доводка «одним запуском»: preflight → секреты → up/готовность → init Gitea
+(полностью автоматом: админ-бот + API-токен) → init Plane → онбординг
+sandbox-проекта **строго** кирпичом `onboard_project.py` (22 канонических
+статуса, включая fail-closed **`Confirm Deploy`** и **`STOP`**, лейблы,
+репо+webhook — golden source `docs/operations/ONBOARDING.md` §1) → git-доступ
+агентов → сборка `.env`/`.env.watchdog` → health.
+
+```bash
+python3 scripts/bootstrap_bundle.py            # план + preflight-диагностика (ноль мутаций)
+python3 scripts/bootstrap_bundle.py apply      # полный прогон
+```
+
+**Manual-step чекпоинты Plane CE** (API первичной инициализации в CE нет;
+каждый чекпоинт: точная инструкция → подтверждение → верификация результата
+API-пробой, молчаливый пропуск запрещён):
+1. **instance setup** — открыть Plane UI, зарегистрировать первого
+   пользователя (станет администратором инстанса);
+2. **workspace** — создать workspace, ввести его slug в bootstrap;
+3. **API-токен** — Workspace Settings → API tokens, вставить значение в
+   bootstrap (ввод скрыт; уходит в `ORCH_PLANE_API_TOKEN`);
+4. **workspace-webhook** — bootstrap регистрирует сам (запись в Postgres
+   инсталляции, путь Б канона `LITE_SETUP.md` §5.4) и проверяет; при отказе —
+   честный ручной шаг с той же проверкой;
+5. **порядок статусов на доске** — drag-and-drop по отчёту onboard
+   (`docs/operations/ONBOARDING.md`).
+
+Exit-коды: `0` — успех; `2` — остановка на manual-step/предусловии (выполните
+шаг и перезапустите `apply` — завершённые шаги пропускаются, повторный запуск
+безопасен); `1` — ошибка. Пароль админ-бота Gitea — ключ `GITEA_ADMIN_PASSWORD`
+в `deploy/bundled/.env` (права 600; вход в UI Gitea под
+`GITEA_ADMIN_USERNAME`).
+
+**Проверка:**
+
+```bash
+python3 scripts/bootstrap_bundle.py verify && echo "bootstrap: PASS"
+```
+
+`verify` зелёный (health/queue/metrics + onboard verify) — PASS; exit 2 —
+остались ручные пункты отчёта; exit 1 — FAIL (§14).
+
+---
+
+## 8. LLM (claude CLI)
+
+Канон — `LITE_SETUP.md` §7 (полностью применим; не дублируется). Кратко: на
+хост ставятся claude-code + node, выполняется интерактивный логин CLI; пути
+прописываются в `deploy/bundled/.env` (это источники маунтов контейнера орка):
+`ORCH_HOST_CLAUDE_CODE_DIR`, `ORCH_HOST_NODE_BIN`, `ORCH_HOST_CLAUDE_DIR`,
+`ORCH_HOST_CLAUDE_JSON`.
+
+```bash
+claude --version
+docker compose -f deploy/bundled/docker-compose.yml exec orchestrator /usr/bin/claude --version
+```
+
+**Проверка:** обе команды печатают версию — PASS; вторая падает — пути в
+`deploy/bundled/.env` не указывают на фактические каталоги хоста (§14.4).
+
+---
+
+## 9. Telegram
+
+Канон — `LITE_SETUP.md` §8 (два независимых бота, C-1: токен орка для watchdog
+переиспользовать запрещено). Ключи орка (`ORCH_TELEGRAM_BOT_TOKEN`,
+`ORCH_TELEGRAM_CHAT_ID`) — в корневой `.env`; ключи watchdog
+(`WATCHDOG_TG_BOT_TOKEN`, `WATCHDOG_TG_CHAT_ID`) — **только** в `.env.watchdog`
+(файл-носитель, `LITE_SETUP.md` §4.3). Шаг опционален: пустые токены =
+деградация только нотификаций.
+
+```bash
+grep -E '^ORCH_TELEGRAM_(BOT_TOKEN|CHAT_ID)=' .env
+grep -E '^WATCHDOG_TG_(BOT_TOKEN|CHAT_ID)=' .env.watchdog
+docker compose -f deploy/bundled/docker-compose.yml up -d orchestrator orchestrator-watchdog
+```
+
+**Проверка:** ключи заполнены и контейнеры пересозданы → тестовое сообщение от
+обоих ботов (`getMe` — команды в `LITE_SETUP.md` §8) — PASS; пусто — осознанный
+PASS без нотификаций.
+
+---
+
+## 10. Онбординг следующих проектов
+
+Sandbox-проект создал bootstrap (§7). Каждый следующий проект заказчика —
+штатный runbook `docs/operations/ONBOARDING.md` поверх bundle-инсталляции; для
+команд из чекаута: Plane/Gitea доступны на `localhost`-портах §2, webhook-URL —
+in-network `http://orchestrator:8500/webhook/gitea`.
+
+```bash
+. .venv/bin/activate    # venv создан bootstrap'ом (§7)
+python3 scripts/onboard_project.py plan \
+  --name "<имя проекта>" --repo <repo> --prefix <PREFIX> \
+  --stack "<стек>" --test-cmd "<команда тестов>" \
+  --prod-port <порт-прода> --staging-port <порт-staging> \
+  --webhook-url http://orchestrator:8500/webhook/gitea
+# план устроил → apply → verify (как в LITE_SETUP.md §10), затем:
+# строку ORCH_PROJECTS_JSON из отчёта — в .env и пересоздать орк:
+docker compose -f deploy/bundled/docker-compose.yml up -d --force-recreate orchestrator
+```
+
+**Проверка:** `verify` зелёный; `GET /queue` отвечает после пересоздания — PASS.
+
+---
+
+## 11. Smoke
+
+Процедура — чек-лист `docs/operations/REPLICATION.md` §4 (шаги 0–5; шаг 6 «до
+`done`» — опционально) поверх bundle-инсталляции, без форка. Минимальный сигнал
+«конвейер доехал»: issue в sandbox-проекте Plane → статус **To Analyse** →
+артефакты `01`–`04` в ветке задачи.
+
+```bash
+curl -fsS http://127.0.0.1:8500/health
+curl -fsS http://127.0.0.1:8500/queue   | python3 -m json.tool | head -30
+curl -fsS http://127.0.0.1:8500/metrics | python3 -m json.tool | head -10
+# создать issue в Plane (порт 8080) → перевести в «To Analyse», затем:
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool | head -40   # job появился
+git -C deploy/bundled/repos/sandbox fetch origin
+git -C deploy/bundled/repos/sandbox ls-tree --name-only origin/<ветка-задачи> "docs/work-items/<id>/"
+```
+
+**Проверка:** оба направления связности живы — job в `/queue` (Plane→орк
+доехал), `ls-tree` показывает `01-brd.md` … `04-test-plan.yaml` (орк→Gitea
+пишет; Gitea→орк события идут) — PASS. Любой шаг FAIL → тираж FAIL: соберите
+`docker compose -f deploy/bundled/docker-compose.yml logs --tail 100 orchestrator`
+и снапшот `GET /queue`, разбор — §14. (Порты замените, если меняли `BUNDLE_*`.)
+
+---
+
+## 12. Stateless-проверка
+
+**Нормативно: данные/задачи/секреты/БД боевого (исходного) хоста НЕ
+переносятся** (зеркало `docs/operations/REPLICATION.md` §5). Все тома bundle
+созданы заново при первом `up`; секреты — только свежевыпущенные (§5); в
+Plane/Gitea инсталляции нет чужих задач/репо/пользователей.
+
+```bash
+docker volume ls --format '{{.Name}}' | grep '^orchestrator-bundle' # только тома этой инсталляции
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool        # счётчики нулевые
+```
+
+**Проверка:** в `/queue` нулевые счётчики и ни одной чужой задачи (никаких
+work-item исходного хоста) — PASS. Чужая задача/перенесённый файл БД — FAIL:
+инсталляция собрана не stateless, выполните полный сброс (§13) и повторите.
+
+---
+
+## 13. Остановка и полный сброс
+
+Teardown — **только эта документированная процедура** (в bootstrap delete-режима
+сознательно нет, ADR-001 D9).
+
+**Остановка (обратимая):**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml down
+```
+
+**Проверка:** `docker compose -f deploy/bundled/docker-compose.yml ps` пуст;
+тома целы (`docker volume ls | grep orchestrator-bundle`) — PASS.
+
+**Полный сброс (НЕОБРАТИМО — удаляет все данные Plane/Gitea/орка):**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml down -v
+rm -rf deploy/bundled/data deploy/bundled/repos
+rm -f deploy/bundled/.env .env .env.watchdog
+```
+
+**Проверка:** `docker volume ls --format '{{.Name}}' | grep -c '^orchestrator-bundle'`
+→ `0`; live-конфигов нет — PASS (хост чист, можно разворачивать заново с §5).
+
+---
+
+## 14. Траблшутинг
+
+Формат: симптом → диагностика → лечение.
+
+**14.1. Webhook не доходит (issue в Plane есть, job в `/queue` нет).**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml logs --tail 50 orchestrator | grep -i "webhook\|signature"
+docker compose -f deploy/bundled/docker-compose.yml exec -T plane-db \
+  psql -U plane -d plane -c "SELECT url, is_active FROM webhooks;"
+```
+
+Лечение: (а) нет строки webhook → §7 чекпоинт 4; (б) URL не
+`http://orchestrator:8500/webhook/plane` → исправьте на in-network URL;
+(в) 401/HMAC → секрет в Plane обязан байт-в-байт совпадать с
+`ORCH_PLANE_WEBHOOK_SECRET` корневого `.env`. Для Gitea-направления проверьте
+Recent Deliveries в настройках hook'а репо; помните про
+`GITEA__webhook__ALLOWED_HOST_LIST=orchestrator` в bundle-compose (без него
+Gitea молча режет вебхуки в приватные адреса).
+
+**14.2. Не хватает RAM / OOM (контейнеры Plane в рестарт-цикле).**
+
+```bash
+free -g && docker stats --no-stream | head -20
+docker compose -f deploy/bundled/docker-compose.yml ps
+```
+
+Лечение: минимум §2 (8 GB; Plane ≈ 14 контейнеров). Меньше — добавьте RAM/swap;
+preflight bootstrap отказывает заранее именно поэтому.
+
+**14.3. Порт занят (`up` падает с bind error).**
+
+```bash
+ss -ltnp | grep -E ':(8500|8080|3000)\b'
+```
+
+Лечение: смените `BUNDLE_ORCH_PORT`/`BUNDLE_PLANE_PORT`/`BUNDLE_GITEA_HTTP_PORT`
+в `deploy/bundled/.env` и повторите `up`/bootstrap.
+
+**14.4. claude не найден / агент падает на старте.**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml exec orchestrator /usr/bin/claude --version
+ls "$(grep '^ORCH_HOST_CLAUDE_CODE_DIR=' deploy/bundled/.env | cut -d= -f2)"
+```
+
+Лечение: пути `ORCH_HOST_*` в `deploy/bundled/.env` обязаны указывать на
+фактические каталоги хоста; креды CLI читаемы uid'ом `ORCH_RUN_UID` (канон —
+`LITE_SETUP.md` §7/§13.3); после правки — `up -d --force-recreate orchestrator`.
+
+**14.5. Миграции Plane не завершились (bootstrap падает на ожидании).**
+
+```bash
+docker compose -f deploy/bundled/docker-compose.yml logs --tail 50 migrator plane-db
+docker compose -f deploy/bundled/docker-compose.yml ps plane-db plane-mq plane-redis
+```
+
+Лечение: чаще всего — нехватка RAM/диска (§14.2) или невыпущенные секреты
+(пустой `POSTGRES_PASSWORD` → postgres не стартует; прогоните §7, который
+заполняет креды ДО `up`). После лечения — повторный `apply` (идемпотентен).
+
+**14.6. PR задачи не мержится / HOLD.** Branch protection на `main` в Gitea
+**НЕ включать** — норматив `LITE_SETUP.md` §6.4 (ломает PR-merge API
+merge-актора); bundle-Gitea конфигурируется тем же правилом.
+
+```bash
+curl -fsS -H "Authorization: token $ORCH_GITEA_TOKEN" \
+  "http://127.0.0.1:3000/api/v1/repos/<owner>/<repo>/branch_protections" | python3 -m json.tool
+```
+
+Лечение: непустой список правил → удалить (канон `LITE_SETUP.md` §6.4/§13.7).
+
+---
+
+*Golden source Bundled-тиража (ORCH-103, ADR-001 D10). **Норматив сопровождения
+(NFR-5):** меняешь шаги Bundled-тиража (состав bundle-compose, ключи
+`deploy/bundled/.env.example`, шаги bootstrap, smoke) → обнови этот док В ТОМ ЖЕ
+PR. Полноту и гигиену держит `tests/test_bundled_setup_doc.py`; кирпичи-каноны:
+`LITE_SETUP.md` (§5–§8 — подключения), `docs/operations/ONBOARDING.md` (статусы
+§1, онбординг), `docs/operations/REPLICATION.md` (карта env §2, секреты §3,
+smoke §4), `deploy/bundled/.env.example` + `.env.example` /
+`.env.watchdog.example` (каноны ключей).*

docs/deployment/LITE_SETUP.md

@@ -0,0 +1,596 @@
+# LITE_SETUP — Lite-тираж: оркестратор + watchdog на вашей инфраструктуре (ORCH-102)
+
+> **Golden source Lite-тиража (Type A эпика ORCH-10).** Сквозной маршрут
+> «голый хост → работающий конвейер» для внешнего оператора/заказчика. Каждый шаг —
+> исполняемая команда + явная проверка результата (**Проверка:** / PASS / FAIL).
+> Хост-специфика в командах — только плейсхолдеры `<...>` и `$ENV_VAR`.
+> Тираж **stateless**: данные/задачи/секреты исходного (боевого) хоста **НЕ переносятся**
+> ни на одном шаге — всё создаётся заново (§12).
+
+---
+
+## 1. Рамка Lite
+
+**Что разворачиваем:** два контейнера платформы — `orchestrator` (конвейер, порт
+`ORCH_DEPLOY_PROD_TARGET_PORT`, дефолт 8500) и `orchestrator-watchdog`
+(независимый sidecar-мониторинг). Третий сервис `orchestrator-staging` существует в том же
+compose-файле, но строго за профилем `staging` и в базовом Lite-контуре не поднимается (§9).
+
+**Что заказчик ставит и администрирует сам** (вне этой инструкции — как продукты):
+- **Plane** (task-management) — своя инсталляция; здесь только её *подключение* (§5);
+- **Gitea** (git-хостинг) — своя инсталляция; здесь только её *подключение* (§6);
+- **Telegram-боты** (нотификации) — свои боты (§8);
+- **LLM-доступ** (claude CLI + node) — свой дистрибутив и аутентификация (§7).
+
+**Границы слоёв тиража** (10-common vs Lite vs Bundled) — `docs/operations/REPLICATION.md` §1.
+Этот док собирает кирпичи 10-common (карта env, секреты, smoke) в один маршрут и не форкает их.
+
+**Платформенные конвенции (не менять):**
+- репо платформы обязан называться **`orchestrator`** (узел безопасности `SELF_HOSTING_REPO`);
+- имена compose-сервисов/профиля (`orchestrator`, `orchestrator-watchdog`,
+  `orchestrator-staging`, профиль `staging`) — константы платформы;
+- контейнерные пути (`/app/data`, `/repos`, `/opt/claude-code`) — layout контейнера,
+  не хост-значения; не параметризуются.
+
+---
+
+## 2. Предусловия хоста
+
+Поддерживаемый контур: **Linux x86_64, Docker Engine + Compose v2, git, python3, node** +
+дистрибутив claude-code на хосте. Вне контура — вне гарантии Lite. Каждое предусловие —
+команда проверки; все проверки PASS → можно переходить к §3.
+
+**2.1. ОС и базовые зависимости.**
+
+```bash
+uname -sm                      # Linux x86_64
+docker --version               # Docker Engine
+docker compose version         # Compose v2
+git --version
+python3 --version              # 3.x (для scripts/*.py)
+node --version                 # путь к бинарю станет ORCH_HOST_NODE_BIN
+```
+
+**Проверка:** все команды отвечают версиями без ошибок — PASS; любая отсутствует — FAIL
+(доставить пакет средствами вашего дистрибутива).
+
+**2.2. Пользователь-владелец и uid/gid (инвариант ORCH-040).** Контейнеры бегут под
+`ORCH_RUN_UID:ORCH_RUN_GID` — это обязан быть uid:gid владельца каталога репозиториев
+`ORCH_HOST_REPOS_DIR`, иначе git-артефакты конвейера не запишутся.
+
+```bash
+id -u <deploy-user>; id -g <deploy-user>     # значения для ORCH_RUN_UID / ORCH_RUN_GID
+mkdir -p <путь-каталога-репозиториев>        # станет ORCH_HOST_REPOS_DIR
+stat -c '%u:%g' <путь-каталога-репозиториев> # обязан совпасть с ORCH_RUN_UID:ORCH_RUN_GID
+```
+
+**Проверка:** uid:gid владельца каталога = будущие `ORCH_RUN_UID`/`ORCH_RUN_GID` — PASS.
+
+**2.3. Группа docker (доступ к docker.sock).**
+
+```bash
+getent group docker            # третье поле — gid, станет ORCH_DOCKER_GID
+```
+
+**Проверка:** строка вида `docker:x:<gid>:...` есть — PASS; группы нет — FAIL
+(установите Docker корректно / создайте группу).
+
+**2.4. Каталог ssh-ключей деплой-хука** (понадобится для git-push артефактов агентов и
+деплой-хуков; монтируется в `$HOME/.ssh` акторов).
+
+```bash
+mkdir -p <путь-ssh-каталога>                 # станет ORCH_HOST_SSH_DIR
+ssh-keygen -t ed25519 -f <путь-ssh-каталога>/id_ed25519 -N "" -C "orchestrator@<host>"
+ls -l <путь-ssh-каталога>                    # ключи читаемы пользователем из 2.2
+```
+
+**Проверка:** каталог существует, ключи на месте, владелец — пользователь из 2.2 — PASS.
+Публичный ключ добавьте в Gitea (Settings → SSH Keys) на шаге §6.
+
+**2.5. Свободные порты** (дефолты платформы: 8500 — прод, 8501 — staging).
+
+```bash
+ss -ltn | grep -E ':(8500|8501)\b' || echo "ports free"
+```
+
+**Проверка:** вывод `ports free` — PASS. Порты заняты → выберите другие и на шаге §4
+синхронно задайте `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄
+`ORCH_POST_DEPLOY_BASE_URL` (и `ORCH_STAGING_PORT` ≠ прод-порт — guard ORCH-058 fail-closed).
+
+---
+
+## 3. Перенос кода
+
+Переносится **только код** — чекаут репо `orchestrator`. **НИКАКИХ** данных, БД или `.env`
+с исходного хоста (норматив §12). Watchdog отдельно не переносится: его код — каталог
+`watchdog/` того же репо, образ собирается локально compose'ом.
+
+```bash
+git clone <ORCHESTRATOR_GIT_URL> <путь-чекаута>   # путь станет ORCH_DEPLOY_HOST_REPO_PATH
+cd <путь-чекаута>
+```
+
+Конкретный канал дистрибуции (`<ORCHESTRATOR_GIT_URL>` — зеркало/архив/доступ к
+Gitea поставщика) согласуйте с поставщиком платформы; опционально — `--branch <тег-среза>`.
+
+**Проверка:**
+
+```bash
+git -C <путь-чекаута> log --oneline -1            # коммит виден
+ls <путь-чекаута>/docker-compose.yml <путь-чекаута>/watchdog/Dockerfile \
+   <путь-чекаута>/.env.example <путь-чекаута>/.env.watchdog.example
+```
+
+Все файлы на месте — PASS.
+
+---
+
+## 4. Конфигурация
+
+`.env` собирается **с нуля от канона `.env.example`** (100% ключей старта; полная карта
+переменных и их семантика — `docs/operations/REPLICATION.md` §2). Дефолт каждого ключа =
+значению исходного хоста, поэтому задаёте только то, что отличается у вас.
+
+**4.1. Создать `.env` и выпустить webhook-секреты.**
+
+```bash
+cd <путь-чекаута>
+cp .env.example .env
+python3 scripts/gen_secrets.py        # печатает свежие ORCH_PLANE_WEBHOOK_SECRET / ORCH_GITEA_WEBHOOK_SECRET
+```
+
+Вставьте оба напечатанных значения в `.env`. Секреты выпускаются **только заново** —
+боевые не копируются (§12).
+
+**4.2. Обязательные ключи нового хоста** (заполняются в `.env` по ходу §5–§8):
+
+| Группа | Ключи | Откуда |
+|--------|-------|--------|
+| Plane | `ORCH_PLANE_API_URL`, `ORCH_PLANE_WEB_URL`, `ORCH_PLANE_WORKSPACE_SLUG`, `ORCH_PLANE_API_TOKEN` | §5 |
+| Gitea | `ORCH_GITEA_URL`, `ORCH_GITEA_PUBLIC_URL`, `ORCH_GITEA_OWNER`, `ORCH_GITEA_TOKEN` | §6 |
+| Webhook-секреты | `ORCH_PLANE_WEBHOOK_SECRET`, `ORCH_GITEA_WEBHOOK_SECRET` | 4.1 (`gen_secrets.py`) |
+| Telegram | `ORCH_TELEGRAM_BOT_TOKEN`, `ORCH_TELEGRAM_CHAT_ID` | §8 |
+| Реестр проектов | `ORCH_PROJECTS_JSON` — **обязателен**: встроенный fallback несёт Plane-UUID исходного хоста | §10 |
+| Хост-параметры | `ORCH_AGENT_HOME_DIR`, `ORCH_HOST_REPOS_DIR`, `ORCH_HOST_CLAUDE_DIR`, `ORCH_HOST_CLAUDE_JSON`, `ORCH_HOST_SSH_DIR`, `ORCH_HOST_CLAUDE_CODE_DIR`, `ORCH_HOST_NODE_BIN`, `ORCH_RUN_UID`, `ORCH_RUN_GID`, `ORCH_DOCKER_GID`, `ORCH_DEPLOY_HOST_REPO_PATH`, `ORCH_AGENT_GIT_NAME`, `ORCH_GIT_EMAIL_DOMAIN` | значения из §2–§3 |
+| Порты | `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL`; `ORCH_STAGING_PORT` ≠ прод-порт | §2.5 |
+
+**4.3. Конфиг sidecar-watchdog — отдельный файл-носитель.** Sidecar-контейнер читает
+**ТОЛЬКО `.env.watchdog`**; ключ `WATCHDOG_ENABLED` (и любой другой `WATCHDOG_*`),
+положенный в `.env`, для sidecar **инертен**.
+
+```bash
+cp .env.watchdog.example .env.watchdog
+# заполнить два ключа: WATCHDOG_TG_BOT_TOKEN / WATCHDOG_TG_CHAT_ID (бота создадим в §8)
+```
+
+**Проверка (резолв всей конфигурации):**
+
+```bash
+docker compose config >/dev/null && echo "compose config: PASS"
+```
+
+`PASS` без ошибок интерполяции — конфигурация согласована; ошибка — FAIL (ищите
+незакрытую кавычку/невалидный JSON в `ORCH_PROJECTS_JSON`).
+
+---
+
+## 5. Подключение Plane
+
+Инсталляция Plane — ваша; платформа подключается к ней API-токеном и webhook'ом.
+
+**5.1. Workspace и проект.** Создайте workspace (его slug → `ORCH_PLANE_WEB_URL` /
+`ORCH_PLANE_WORKSPACE_SLUG`) и проект под вашу разработку — через UI Plane.
+
+```bash
+# базовая доступность API из хоста оркестратора:
+curl -fsS "$ORCH_PLANE_API_URL/api/v1/workspaces/<workspace-slug>/projects/" \
+  -H "X-API-Key: <plane-api-token>" | head -c 200
+```
+
+**Проверка:** HTTP 200 и JSON со списком проектов — PASS; 401/403 — токен (5.2) ещё не
+выпущен или не имеет прав.
+
+**5.2. API-токен.** Plane UI → Workspace Settings → API tokens → выпустить токен →
+`ORCH_PLANE_API_TOKEN` в `.env`. Токен должен иметь право создавать проекты/статусы
+(нужно для `onboard_project.py apply`, §10).
+
+**5.3. Модель статусов — НЕ вручную.** Конвейеру нужны **22 канонических статуса** с
+точными именами и группами; их создаёт `python3 scripts/onboard_project.py apply` (§10),
+полная таблица — `docs/operations/ONBOARDING.md` §1 (golden source; здесь не дублируется).
+Два имени фиксируем явно, потому что они **fail-closed** (без них ветка просто не
+активируется, без ошибки): **`Confirm Deploy`** (человеческий гейт прод-деплоя) и
+**`STOP`** (отмена задачи; обязан быть в группе `cancelled`).
+
+```bash
+# после §10 — проверить, что статусы созданы:
+curl -fsS "$ORCH_PLANE_API_URL/api/v1/workspaces/<workspace-slug>/projects/<project-uuid>/states/" \
+  -H "X-API-Key: $ORCH_PLANE_API_TOKEN" | python3 -m json.tool | grep -c '"name"'
+```
+
+**Проверка:** счётчик имён = 22 (или больше, если в проекте остались дефолтные статусы
+Plane) и среди них `Confirm Deploy` и `STOP` — PASS.
+
+**5.4. Webhook + HMAC.** Приёмник — `POST https://<orchestrator-public-host>/webhook/plane`;
+подпись — заголовок `X-Plane-Signature` (HMAC-SHA256, hex digest); секрет — значение
+`ORCH_PLANE_WEBHOOK_SECRET` из 4.1. События: Issue, Issue Comment.
+
+**Каверза Plane CE:** webhook **не экспонирован во внешнем `/api/v1`** — настраивается
+одним из двух путей.
+
+*Путь А — UI (если ваша сборка Plane его показывает):* Workspace Settings → Webhooks →
+Add Webhook → URL + Secret (значение `ORCH_PLANE_WEBHOOK_SECRET`) → события Issue,
+Issue Comment → Save.
+
+*Путь Б — прямой SQL в Postgres инсталляции Plane:*
+
+```bash
+WORKSPACE_ID=$(docker exec -e PGPASSWORD=<plane-db-password> <plane-db-container> \
+  psql -U plane -d plane -t -A -c "SELECT id FROM workspaces WHERE slug='<workspace-slug>'")
+WEBHOOK_ID=$(cat /proc/sys/kernel/random/uuid)
+docker exec -e PGPASSWORD=<plane-db-password> <plane-db-container> psql -U plane -d plane -c "
+INSERT INTO webhooks (id, created_at, updated_at, deleted_at, workspace_id, url, is_active,
+  secret_key, project, issue, module, cycle, issue_comment, is_internal, version)
+VALUES ('${WEBHOOK_ID}', NOW(), NOW(), NULL, '${WORKSPACE_ID}',
+  'https://<orchestrator-public-host>/webhook/plane',
+  true, '<значение ORCH_PLANE_WEBHOOK_SECRET>', true, true, false, false, true, false, 'v1');
+"
+```
+
+**Проверка:**
+
+```bash
+docker exec -e PGPASSWORD=<plane-db-password> <plane-db-container> psql -U plane -d plane -c \
+  "SELECT url, is_active FROM webhooks;"
+```
+
+Строка с вашим URL и `is_active = t` — PASS. Сквозная проверка доставки — §11 (smoke);
+generic-образец команд и формат подписи — `docs/operations/SETUP_WEBHOOKS.md`.
+
+---
+
+## 6. Подключение Gitea
+
+**6.1. Токен.** Gitea UI → Settings → Applications → Generate Token, scope: `repo`,
+`admin:repo_hook` → `ORCH_GITEA_TOKEN` в `.env`.
+
+```bash
+curl -fsS -H "Authorization: token $ORCH_GITEA_TOKEN" "$ORCH_GITEA_URL/api/v1/user" | head -c 200
+```
+
+**Проверка:** HTTP 200 с JSON вашего пользователя — PASS; владелец репозиториев
+(организация/пользователь) → `ORCH_GITEA_OWNER`, браузерный URL → `ORCH_GITEA_PUBLIC_URL`.
+
+**6.2. Репо проекта.** Создаёт `onboard_project.py apply` (§10) — или вручную (пустой
+репо + initial push). Чекаут обязан появиться в `$ORCH_HOST_REPOS_DIR/<repo>` (общий
+каталог репозиториев из §2.2). Публичный ключ из §2.4 добавьте в Gitea
+(Settings → SSH Keys), чтобы акторы могли пушить.
+
+```bash
+git -C "$ORCH_HOST_REPOS_DIR" clone <git-url-репо-проекта> <repo>
+stat -c '%u:%g' "$ORCH_HOST_REPOS_DIR/<repo>"     # владелец = ORCH_RUN_UID:ORCH_RUN_GID
+```
+
+**Проверка:** чекаут на месте, владелец совпадает — PASS.
+
+**6.3. Per-repo webhook.** Создаёт `onboard_project.py apply` (§10). Параметры (если
+вручную): URL `https://<orchestrator-public-host>/webhook/gitea`, content type `json`,
+события **`push` / `pull_request` / `status`**, branch filter `*`, подпись —
+`X-Gitea-Signature` (HMAC-SHA256). Секрет — **ОДИН глобальный `ORCH_GITEA_WEBHOOK_SECRET`
+на ВСЕ репо** (приёмник валидирует только его; «свой секрет на репо» сломал бы HMAC
+остальных).
+
+```bash
+curl -fsS -H "Authorization: token $ORCH_GITEA_TOKEN" \
+  "$ORCH_GITEA_URL/api/v1/repos/<owner>/<repo>/hooks" | python3 -m json.tool
+```
+
+**Проверка:** hook с вашим URL и тремя событиями существует, `active: true` — PASS.
+
+**6.4. Норматив защиты `main` (ВАЖНО).** **Branch protection на `main` НЕ включать**
+(никаких required-approvals / required-status-checks): merge-актор конвейера мержит PR
+строго через Gitea PR-merge API (INV-4), и protection-правила дают 405/409-класс отказов →
+ложные HOLD задач (ADR D10 ORCH-009). **pre-receive хуки платформа не вводит** и не
+проверяет — защита `main` держится конвенцией (агенты не пушат `main`) + скоупом токенов.
+
+```bash
+curl -fsS -H "Authorization: token $ORCH_GITEA_TOKEN" \
+  "$ORCH_GITEA_URL/api/v1/repos/<owner>/<repo>/branch_protections" | python3 -m json.tool
+```
+
+**Проверка:** пустой список `[]` — PASS; есть правила на `main` — FAIL (удалите их,
+симптом «PR не мержится / HOLD» — §13.7).
+
+---
+
+## 7. LLM (claude CLI)
+
+Агенты конвейера — процессы claude CLI **внутри контейнера**, но дистрибутив, node и
+аутентификация живут **на хосте** и пробрасываются маунтами (источники маунтов =
+ключи `.env`).
+
+**7.1. Дистрибутив claude-code и node.** Установите claude-code (npm-дистрибутив
+Anthropic) и node на хост. Пути → `.env`:
+
+```bash
+which node                                   # → ORCH_HOST_NODE_BIN
+npm root -g                                  # каталог глобальных модулей
+ls "<npm-root>/@anthropic-ai/claude-code"    # → ORCH_HOST_CLAUDE_CODE_DIR
+```
+
+**Проверка:** каталог дистрибутива существует и непуст — PASS. Внутри контейнера бинарь
+доступен как `ORCH_CLAUDE_BIN` (дефолт менять не нужно).
+
+**7.2. Аутентификация CLI.** Выполните первичный интерактивный логин claude CLI **на
+хосте** под пользователем из §2.2 (по инструкции Anthropic к claude-code). Логин создаёт
+каталог `~/.claude` и файл `~/.claude.json` — их пути задайте в `ORCH_HOST_CLAUDE_DIR` /
+`ORCH_HOST_CLAUDE_JSON`.
+
+```bash
+claude --version                                            # CLI работает
+sudo -u "#<uid-из-2.2>" test -r <путь-~/.claude>/.credentials.json && echo "creds: PASS"
+```
+
+**Проверка:** версия печатается; `creds: PASS` — креды читаемы uid'ом контейнера
+(иначе — `chown -R <uid>:<gid>` каталога, симптом §13.3).
+
+**7.3. Модели агентов.** Резолв модели/эффорта — только из конфига (ORCH-41/74):
+дефолты канона уже в `.env.example` (`ORCH_AGENT_MODEL_DEFAULT`,
+`ORCH_AGENT_EFFORT_DEFAULT` и per-агент ключи рядом) — менять не обязательно.
+
+```bash
+grep -E '^ORCH_AGENT_(MODEL|EFFORT)_DEFAULT=' .env
+```
+
+**Проверка:** оба ключа присутствуют и непусты — PASS.
+
+---
+
+## 8. Telegram
+
+Каналов **два и они независимы** (C-1 ORCH-100): бот live-трекера оркестратора и
+**отдельный** бот sidecar-watchdog. Токен орка для watchdog переиспользовать
+**ЗАПРЕЩЕНО** — упавший орк не сможет сообщить о себе своим же ботом.
+
+**8.1. Бот трекера.** BotFather → `/newbot` → токен → `ORCH_TELEGRAM_BOT_TOKEN` в `.env`.
+
+```bash
+curl -fsS "https://api.telegram.org/bot<токен-трекера>/getMe"
+# напишите боту любое сообщение (или добавьте его в чат), затем:
+curl -fsS "https://api.telegram.org/bot<токен-трекера>/getUpdates" | python3 -m json.tool | grep -m1 '"id"'
+```
+
+**Проверка:** `getMe` → `"ok":true`; `id` чата из `getUpdates` → `ORCH_TELEGRAM_CHAT_ID` —
+PASS.
+
+**8.2. Watchdog-бот (отдельный).** BotFather → `/newbot` ещё раз → токен и chat-id →
+**`.env.watchdog`** (`WATCHDOG_TG_BOT_TOKEN` / `WATCHDOG_TG_CHAT_ID`). Помните о
+файле-носителе: эти ключи работают только в `.env.watchdog` (§4.3).
+
+```bash
+curl -fsS "https://api.telegram.org/bot<токен-watchdog>/getMe"
+grep -E '^WATCHDOG_TG_(BOT_TOKEN|CHAT_ID)=.+' .env.watchdog
+```
+
+**Проверка:** `getMe` → `"ok":true`; оба ключа в `.env.watchdog` непусты — PASS.
+
+---
+
+## 9. Запуск
+
+**9.1. Базовый Lite-контур (дефолт): орк + watchdog.**
+
+```bash
+cd <путь-чекаута>
+docker compose config --services    # ровно: orchestrator, orchestrator-watchdog, orchestrator-staging
+docker compose up -d --build
+docker compose ps
+```
+
+**Проверка:** запущены **ровно два** контейнера — `orchestrator` и
+`orchestrator-watchdog`; `orchestrator-staging` НЕ поднялся (он строго за
+`profiles: [staging]`) — PASS. Поднялось что-то ещё/меньше — FAIL.
+
+**9.2. Health-чек контрактов.**
+
+```bash
+curl -fsS http://127.0.0.1:8500/health
+curl -fsS http://127.0.0.1:8500/queue   | python3 -m json.tool | head -20
+curl -fsS http://127.0.0.1:8500/metrics | python3 -m json.tool | head -10
+```
+
+**Проверка:** `/health` → HTTP 200, `"status":"ok"`; `/queue` → штатный JSON
+(счётчики очереди); `/metrics` → JSON со `"schema_version": 1` — PASS. (Порт замените,
+если меняли `ORCH_DEPLOY_PROD_TARGET_PORT`.)
+
+**9.3. Вилка staging (опционально).** Базовому контуру «гонять СВОИ проекты» staging
+**не нужен**. Он нужен ТОЛЬКО если вы регистрируете проект `orchestrator` (self-hosting
+развитие самой платформы у себя): стадия `deploy-staging` требует песочницу на
+`ORCH_STAGING_PORT` (изолированная БД `./data/staging`; guard ORCH-058: staging-порт ≠
+прод-порт, fail-closed).
+
+```bash
+cp .env.staging.example .env.staging      # заполнить по аналогии с .env
+docker compose --profile staging up -d orchestrator-staging
+curl -fsS http://127.0.0.1:8501/health
+```
+
+**Проверка (только для этой вилки):** `/health` staging → 200 — PASS.
+
+---
+
+## 10. Регистрация проекта заказчика
+
+Onboarding-CLI создаёт Plane-проект с 22 статусами и лейблами (`autoApprove` /
+`autoDeploy` / `Bug`), Gitea-репо с webhook'ом, скелет репо (kit) и печатает merged-реестр.
+Полный runbook — `docs/operations/ONBOARDING.md`; Lite-последовательность:
+
+```bash
+cd <путь-чекаута>
+python3 scripts/onboard_project.py plan \
+  --name "<имя проекта>" --description "<зачем проект>" \
+  --repo <repo> --prefix <PREFIX> \
+  --stack "<стек>" --test-cmd "<команда тестов>" \
+  --prod-port <порт-прода-проекта> --staging-port <порт-staging-проекта> \
+  --webhook-url https://<orchestrator-public-host>/webhook/gitea
+# план устроил → тот же вызов с apply; затем read-only контроль:
+python3 scripts/onboard_project.py verify <те же аргументы>
+```
+
+**Проверка:** `apply` завершился без ошибок (exit 0; `2` = остались 🖐 ручные шаги — выполните
+их по отчёту), `verify` зелёный — PASS.
+
+Дальше реестр и рестарт:
+
+```bash
+# 1) строку ORCH_PROJECTS_JSON=[...] из отчёта apply вставить в .env (заменить целиком);
+# 2) дождаться тихого окна и управляемо перезапустить орк:
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool | head -20   # нет running-job
+docker compose up -d --force-recreate orchestrator
+# 3) убедиться, что инстанс жив и реестр подхвачен:
+curl -fsS http://127.0.0.1:8500/health
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool | head -20
+```
+
+**Проверка:** `/health` → 200 после рестарта; в Plane создан проект со статусами
+(см. §5.3), в Gitea — репо с webhook (§6.3) — PASS.
+
+---
+
+## 11. Smoke: «конвейер доехал»
+
+Процедура — чек-лист `docs/operations/REPLICATION.md` §4 (шаги 0–5; шаг 6 «до `done`» —
+опционально), без форка; каждый шаг несёт явный PASS/FAIL. Lite-предусловия: §2–§10 этого
+дока выполнены, проект заказчика зарегистрирован (§10).
+
+Минимальный сигнал «конвейер доехал» (шаги 4–5 чек-листа): создайте issue в Plane-проекте
+и переведите в статус **To Analyse**, затем:
+
+```bash
+# задача появилась и analyst-job в очереди:
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool | head -40
+# по завершении стадии analysis — артефакты 01–04 в ветке задачи:
+git -C "$ORCH_HOST_REPOS_DIR/<repo>" fetch origin
+git -C "$ORCH_HOST_REPOS_DIR/<repo>" ls-tree --name-only origin/<ветка-задачи> "docs/work-items/<id-задачи>/"
+```
+
+**Проверка:** в `/queue` виден job задачи; `ls-tree` показывает `01-brd.md` …
+`04-test-plan.yaml` — PASS.
+
+**Итоговый вердикт:** все шаги чек-листа PASS ⇒ **тираж PASS**; любой шаг FAIL ⇒ тираж
+FAIL — соберите `docker logs orchestrator --tail 100` и снапшот `GET /queue`, разбор —
+§13.
+
+---
+
+## 12. Stateless-проверка
+
+**Нормативно: данные/задачи/секреты боевого (исходного) хоста НЕ переносятся** (зеркало
+`docs/operations/REPLICATION.md` §5). БД создаётся **пустой** при первом старте; `.env` /
+`.env.staging` / `.env.watchdog` собраны с нуля (§4); секреты — только свежевыпущенные
+(`gen_secrets.py` + чек-лист внешних токенов `docs/operations/REPLICATION.md` §3).
+
+Проверка чистоты развёрнутого инстанса (выполнить ДО первой своей задачи):
+
+```bash
+ls -la <путь-чекаута>/data/                                  # БД появилась только после первого старта
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool # счётчики jobs нулевые
+```
+
+**Проверка:** в `/queue` нулевые счётчики и НИ ОДНОЙ задачи чужих проектов (никаких
+`ORCH-*`/`ET-*` исходного хоста) — PASS. Любая чужая задача/перенесённый файл БД — FAIL:
+инстанс собран не stateless, пересоберите `data/` с нуля.
+
+---
+
+## 13. Траблшутинг первичной настройки
+
+Формат: симптом → команда диагностики → лечение.
+
+**13.1. Webhook отвечает 401 / HMAC mismatch.**
+
+```bash
+docker logs orchestrator --tail 50 2>&1 | grep -i "webhook\|signature\|401"
+```
+
+Лечение: секрет в `.env` (`ORCH_PLANE_WEBHOOK_SECRET` / `ORCH_GITEA_WEBHOOK_SECRET`)
+обязан **байт-в-байт** совпадать с секретом в настройке webhook'а (Plane §5.4 / Gitea
+§6.3); после правки `.env` — управляемый рестарт (§10). Формат подписи —
+`docs/operations/SETUP_WEBHOOKS.md`.
+
+**13.2. Задача в Plane создана, но в оркестраторе не появилась.**
+
+```bash
+curl -fsS http://127.0.0.1:8500/queue | python3 -m json.tool | head -30   # есть ли job
+docker logs orchestrator --tail 50 2>&1 | grep -i "ignored\|unknown project"
+grep ORCH_PROJECTS_JSON .env                                              # uuid вашего проекта в реестре?
+```
+
+Лечение: (а) проект отсутствует/с чужим UUID в `ORCH_PROJECTS_JSON` → поправить реестр
+(§10) + рестарт; (б) webhook не доставлен → Plane: `SELECT url, is_active FROM webhooks;`
+(§5.4), Gitea: Recent Deliveries в настройках hook'а; (в) подпись → §13.1.
+
+**13.3. claude CLI не найден / не аутентифицирован (агент падает на старте).**
+
+```bash
+docker exec orchestrator /usr/bin/claude --version
+sudo -u "#<uid-из-2.2>" test -r <путь-~/.claude>/.credentials.json && echo "creds: PASS"
+```
+
+Лечение: маунты указывают на фактические пути хоста (`ORCH_HOST_CLAUDE_CODE_DIR`,
+`ORCH_HOST_NODE_BIN`, `ORCH_HOST_CLAUDE_DIR`, `ORCH_HOST_CLAUDE_JSON` в `.env`); креды
+читаемы uid'ом из §2.2 (`chown -R <uid>:<gid>`); при невалидной сессии — повторный логин
+на хосте (§7.2) + `docker compose up -d --force-recreate orchestrator`.
+
+**13.4. `docker.sock: permission denied` в логах орка/watchdog.**
+
+```bash
+getent group docker          # фактический gid
+grep ORCH_DOCKER_GID .env    # gid в конфиге
+```
+
+Лечение: значения обязаны совпадать → выставить `ORCH_DOCKER_GID` = фактическому gid и
+`docker compose up -d --force-recreate`.
+
+**13.5. `Permission denied` при создании worktree (права `/repos`, ORCH-040/057).**
+
+```bash
+stat -c '%u:%g' "$ORCH_HOST_REPOS_DIR" "$ORCH_HOST_REPOS_DIR/<repo>"
+grep -E '^ORCH_RUN_(UID|GID)=' .env
+```
+
+Лечение: владелец каталога репо обязан совпадать с `ORCH_RUN_UID:ORCH_RUN_GID`
+(§2.2) → `chown -R <uid>:<gid> "$ORCH_HOST_REPOS_DIR"` (включая legacy root-owned файлы)
+и пересоздать контейнер.
+
+**13.6. Telegram молчит (нет карточек/алертов).**
+
+```bash
+curl -fsS "https://api.telegram.org/bot<токен-трекера>/getMe"
+curl -fsS "https://api.telegram.org/bot<токен-watchdog>/getMe"
+grep -E '^ORCH_TELEGRAM_(BOT_TOKEN|CHAT_ID)=.+' .env
+grep -E '^WATCHDOG_TG_(BOT_TOKEN|CHAT_ID)=.+' .env.watchdog
+```
+
+Лечение: оба бота отвечают `"ok":true`; chat-id корректен (бот добавлен в чат / получил
+сообщение); ключи watchdog-бота лежат именно в `.env.watchdog` (в `.env` они инертны,
+§4.3); пустой токен = режим «логи без отправки» (fail-safe, не ошибка).
+
+**13.7. PR задачи не мержится / задача в HOLD.** Первая проверка — **не включена ли
+branch protection на `main`** (§6.4):
+
+```bash
+curl -fsS -H "Authorization: token $ORCH_GITEA_TOKEN" \
+  "$ORCH_GITEA_URL/api/v1/repos/<owner>/<repo>/branch_protections" | python3 -m json.tool
+```
+
+Лечение: непустой список правил на `main` → удалить (норматив §6.4); merge выполняет
+PR-merge API оркестратора, ручной merge не требуется.
+
+---
+
+*Golden source Lite-тиража (ORCH-102, ADR-001). **Норматив сопровождения (NFR-5):**
+меняешь шаги тиража (env-ключи, compose-сервисы, маршрут онбординга, smoke) → обнови
+этот док В ТОМ ЖЕ PR (правило агентов №2). Полноту и гигиену дока держит структурный
+анти-дрейф тест `tests/test_lite_setup_doc.py`; кирпичи-каноны: REPLICATION.md (карта
+env §2, секреты §3, smoke §4), ONBOARDING.md (статусы §1, онбординг), SETUP_WEBHOOKS.md
+(формат вебхуков), `.env.example` / `.env.watchdog.example` (канон ключей).*

docs/operations/INFRA.md

@@ -171,8 +171,15 @@ watchdog'а: **watchdog сигналит, pruner убирает**.
 | `ORCH_BUILD_CACHE_PRUNE_TIMEOUT_S` | таймаут ssh-команды prune, сек; дефолт `120` |
 | `ORCH_BUILD_CACHE_PRUNE_NOTIFY_MIN_GB` | Telegram при освобождении ≥ N ГБ; дефолт `0` (тихо) |
 | `DEPLOY_SSH_USER` / `_HOST` / `DEPLOY_HOOK_SCRIPT` | параметры деплой-хука |
+| `ORCH_AGENT_HOME_DIR` | ORCH-101: HOME всех акторских subprocess-env (агенты/finalizer/monitor) **и** таргет маунтов `.claude`/`.claude.json`/`.ssh` **и** `ARG APP_HOME` Dockerfile (группа ORCH-040 двигается согласованно); дефолт `/home/slin` |
+| `ORCH_AGENT_GIT_NAME` / `ORCH_GIT_EMAIL_DOMAIN` | ORCH-101: git-идентичность коммитов агентов (`claude-bot` @ `mva154.local`); системные акторы держат платформенные имена `deploy-finalizer`/`post-deploy-monitor` под тем же доменом |
+| `ORCH_STAGING_PORT` | ORCH-101: порт staging-инстанса (дефолт `8501`); читается и `image_freshness`, и compose `command:` staging; guard fail-closed при совпадении с прод-портом (ORCH-058 AC-9) |
+| `ORCH_HOST_CLAUDE_DIR` / `_CLAUDE_JSON` / `_SSH_DIR` | ORCH-101: host-источники bind-маунтов `~/.claude`, `~/.claude.json`, ssh-ключей (`/home/slin/.{claude,claude.json,orchestrator-ssh}`) |
+| `ORCH_HOST_CLAUDE_CODE_DIR` / `_NODE_BIN` | ORCH-101: host-пути дистрибутива claude-code и бинаря node (`/usr/lib/node_modules/@anthropic-ai/claude-code`, `/usr/bin/node`) |
+| `ORCH_RUN_UID` / `ORCH_RUN_GID` | ORCH-101: uid:gid контейнера (`user:`) + `ARG APP_UID/APP_GID` (дефолт `1000:1000`, ORCH-040) |
+| `ORCH_DOCKER_GID` | ORCH-101: gid docker-группы хоста для `group_add` (дефолт `999`; «МИНА 1» ORCH-040 — не удалять) |
 
-**Секреты — только в `.env` / `.env.staging` на хосте, в гит НЕ коммитятся.** Канон — `.env.example`, `.env.staging.example`.
+**Секреты — только в `.env` / `.env.staging` / `.env.watchdog` на хосте, в гит НЕ коммитятся.** Канон — `.env.example`, `.env.staging.example`, `.env.watchdog.example` (ORCH-102: sidecar-watchdog читает ТОЛЬКО `.env.watchdog`; `WATCHDOG_*` в `.env` для него инертен). Выпуск нового комплекта секретов для нового хоста — `scripts/gen_secrets.py` (боевые секреты не копируются). **Тираж платформы на новую инфру** (карта переменных, секреты, smoke-процедура, границы Lite/Bundled) — `docs/operations/REPLICATION.md` (ORCH-101); сквозная инструкция Lite-тиража для внешнего оператора («голый хост → конвейер», орк+watchdog) — `docs/deployment/LITE_SETUP.md` (ORCH-102). Когерентность портов при смене прод-порта: `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL`.
 
 ## Реестр проектов (`src/projects.py`, ORCH-6)
 Связывает Plane project id → gitea repo + work-item prefix. Источник: `ORCH_PROJECTS_JSON`, fallback — встроенный дефолт. Прод видит: `enduro-trails` (ET), `orchestrator` (ORCH). Staging видит ТОЛЬКО `orchestrator-sandbox` (SANDBOX) — изоляция.

docs/operations/REPLICATION.md

@@ -0,0 +1,155 @@
+# REPLICATION — тираж платформы на новую инфраструктуру (ORCH-101)
+
+> RUNBOOK фундамента тиража (эпик ORCH-10, слой **10-common**). Как развернуть
+> оркестратор на чужом хосте **без правки кода**: переменные → секреты → smoke.
+> Тираж **stateless**: данные/БД/секреты боевого хоста НЕ переносятся ни на одном
+> шаге — на целевой инфре всё создаётся заново.
+
+---
+
+## 1. Границы: 10-common vs Lite vs Bundled
+
+| Слой | Что это | Статус |
+|------|---------|--------|
+| **10-common** (этот док) | фундамент: все хост-значения параметризованы (env/конфиг), секреты выпускаются заново, smoke-процедура с PASS/FAIL | ✅ ORCH-101 |
+| **Type A — Lite** | инструкция «поставь Plane+Gitea сам, подключи оркестратор» поверх 10-common | ✅ ORCH-102 — [`docs/deployment/LITE_SETUP.md`](../deployment/LITE_SETUP.md) |
+| **Type B — Bundled** | комплект «всё в одном» (Plane+Gitea+оркестратор) поверх 10-common | ✅ ORCH-103 — [`docs/deployment/BUNDLED_SETUP.md`](../deployment/BUNDLED_SETUP.md) |
+
+Этот док НЕ описывает установку Plane/Gitea — только параметризацию, секреты и
+smoke самого оркестратора (анти-скоуп-крип Р-5).
+
+### Платформенные конвенции тиража (нормативно, ADR-001 D3/D4)
+
+- **Репо платформы обязан называться `orchestrator`.** Имя — узел безопасности
+  (`SELF_HOSTING_REPO`, на него завязаны все `*_repos`-leaf'ы «empty CSV →
+  self-hosting only»); оно сознательно НЕ конфигурируется.
+- Имена compose-сервисов/профиля (`orchestrator`, `orchestrator-staging`,
+  `orchestrator-watchdog`, профиль `staging`) — константы платформы.
+- Контейнерные пути (`/app/data`, `/repos`, `/opt/claude-code`) — layout
+  контейнера, не хост-значения; не параметризуются.
+
+---
+
+## 2. Карта переменных нового хоста
+
+Принцип (ADR-001 D1): **дефолт каждой переменной = боевое значение текущего
+хоста** — пустой `.env` ⇒ поведение байт-в-байт; на новом хосте задаёшь только
+то, что отличается. Одно env-имя = один факт: pydantic `Settings` читает имя из
+`env_file`, compose-интерполяция `${VAR:-default}` — из **`.env` проекта/shell**
+(⚠️ НЕ из `env_file` сервиса: `.env.staging` на интерполяцию не влияет —
+значения для маунтов/uid/портов живут в `.env`).
+
+### 2.1. Хост-параметризация (новое в ORCH-101)
+
+| Переменная | Дефолт | Назначение |
+|-----------|--------|------------|
+| `ORCH_AGENT_HOME_DIR` | `/home/slin` | HOME всех акторов (агенты, finalizer, monitor) + таргет маунтов `.claude`/`.claude.json`/`.ssh` + `ARG APP_HOME` (группа ORCH-040 двигается вместе) |
+| `ORCH_AGENT_GIT_NAME` | `claude-bot` | git-имя коммитов агентов |
+| `ORCH_GIT_EMAIL_DOMAIN` | `mva154.local` | домен git-email всех акторов (`claude-bot@…`, `deploy-finalizer@…`, `post-deploy-monitor@…`) |
+| `ORCH_STAGING_PORT` | `8501` | порт staging; читают `image_freshness` И compose `command:`; guard: совпадение с прод-портом → отказ fail-closed (ORCH-058 AC-9) |
+| `ORCH_HOST_REPOS_DIR` | `/home/slin/repos` | каталог репозиториев на хосте (источник маунта `/repos`) |
+| `ORCH_HOST_CLAUDE_DIR` | `/home/slin/.claude` | источник маунта `~/.claude` |
+| `ORCH_HOST_CLAUDE_JSON` | `/home/slin/.claude.json` | источник маунта `~/.claude.json` |
+| `ORCH_HOST_SSH_DIR` | `/home/slin/.orchestrator-ssh` | источник маунта ssh-ключей (`→ $HOME/.ssh:ro`) |
+| `ORCH_HOST_CLAUDE_CODE_DIR` | `/usr/lib/node_modules/@anthropic-ai/claude-code` | дистрибутив claude-code на хосте |
+| `ORCH_HOST_NODE_BIN` | `/usr/bin/node` | бинарь node на хосте |
+| `ORCH_RUN_UID` / `ORCH_RUN_GID` | `1000` / `1000` | uid:gid контейнера (`user:` + `ARG APP_UID/APP_GID`); = uid владельца `ORCH_HOST_REPOS_DIR` (ORCH-040) |
+| `ORCH_DOCKER_GID` | `999` | gid группы docker хоста (`group_add`, «МИНА 1» — обязателен для docker.sock); узнать: `getent group docker` |
+| `ORCH_DEPLOY_PROD_TARGET_PORT` | `8500` | (реюз) прод-порт; интерполируется в `command:` прод-сервиса |
+| `ORCH_DEPLOY_SSH_USER` / `ORCH_DEPLOY_HOST_REPO_PATH` | `slin` / `/home/slin/repos/orchestrator` | (реюз) ssh-юзер хука и чекаут платформы на хосте; `REPO=` передаётся хуку явно из конфига |
+
+### 2.2. Обязательные ключи идентичности нового хоста
+
+| Переменная | Где взять |
+|-----------|-----------|
+| `ORCH_PLANE_API_URL` / `ORCH_PLANE_WEB_URL` / `ORCH_PLANE_WORKSPACE_SLUG` | инсталляция Plane целевого хоста |
+| `ORCH_GITEA_URL` / `ORCH_GITEA_PUBLIC_URL` / `ORCH_GITEA_OWNER` | инсталляция Gitea целевого хоста |
+| `ORCH_PROJECTS_JSON` | **обязателен на новом хосте**: встроенный fallback (`src/projects.py`) несёт Plane-UUID *исходного* хоста — чужие UUID безвредны (не сматчатся), но без своего реестра конвейер не увидит проекты. Сгенерировать: `scripts/onboard_project.py apply` печатает merged-значение |
+| Когерентность портов | сменил прод-порт → синхронно `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL` |
+
+Полный справочник всех остальных флагов — `.env.example` (канон) и
+`docs/operations/INFRA.md` (карта env).
+
+---
+
+## 3. Секреты нового хоста (FR-4 / AC-5)
+
+**Нормативно: боевые секреты текущего хоста НЕ копируются ни на одном шаге.**
+Для нового хоста всегда выпускается новый комплект.
+
+### 3.1. Генерация локальных webhook-секретов
+
+```bash
+python3 scripts/gen_secrets.py            # печать .env-фрагмента в stdout
+python3 scripts/gen_secrets.py --write    # создать .env (существующий → отказ exit=2)
+python3 scripts/gen_secrets.py --write --force  # перезапись только явно
+```
+
+Скрипт stdlib-only (`secrets.token_hex(32)` — 32 байта энтропии); повторный
+запуск даёт другие значения; существующий `.env` **никогда не перезаписывается
+молча**.
+
+| Секрет | Генерируется | Куда вписать |
+|--------|--------------|--------------|
+| `ORCH_PLANE_WEBHOOK_SECRET` | локально (gen_secrets) | `.env` + настройка webhook в Plane (см. `SETUP_WEBHOOKS.md`) |
+| `ORCH_GITEA_WEBHOOK_SECRET` | локально (gen_secrets) | `.env` + webhook Gitea (создаёт `onboard_project.py apply`) |
+
+### 3.2. Чек-лист внешних токенов
+
+| Секрет | Где выпустить | Куда вписать | Как проверить |
+|--------|---------------|--------------|---------------|
+| `ORCH_PLANE_API_TOKEN` | Plane UI → Workspace Settings → API tokens | `.env` | `curl -H "X-API-Key: $TOKEN" $ORCH_PLANE_API_URL/api/v1/workspaces/<slug>/projects/` → 200 |
+| `ORCH_PLANE_BOT_*` (7, опциональны) | Plane UI: bot-аккаунты per-агент; пусто → fallback на `ORCH_PLANE_API_TOKEN` | `.env` | комментарий в Plane от имени бота |
+| `ORCH_GITEA_TOKEN` | Gitea UI → Settings → Applications → Generate Token (scope: repo, admin:repo_hook) | `.env` | `curl -H "Authorization: token $TOKEN" $ORCH_GITEA_URL/api/v1/user` → 200 |
+| `ORCH_TELEGRAM_BOT_TOKEN` | BotFather (`/newbot`) | `.env` | `curl https://api.telegram.org/bot$TOKEN/getMe` → ok |
+| `ORCH_TELEGRAM_CHAT_ID` (несекретный) | id чата оператора | `.env` | тестовое сообщение |
+| `WATCHDOG_TG_BOT_TOKEN` / `WATCHDOG_TG_CHAT_ID` | отдельный бот sidecar-watchdog (ORCH-100, независимый канал) | `.env.watchdog` | алерт от sidecar |
+
+### 3.3. Полнота
+
+`.env.example` — канон 100% ключей старта (секретные значения — только
+плейсхолдеры). Состав вывода `gen_secrets.py` сверяется с `.env.example`
+тестом (`tests/test_secrets_gen.py`).
+
+---
+
+## 4. Smoke-верификация тиража (FR-5 / AC-3)
+
+Процедура «инстанс → тестовый проект → тестовая задача → конвейер доехал» из
+существующих кирпичей; **каждый шаг имеет явный PASS/FAIL**. Итог — однозначный
+вердикт: все шаги PASS ⇒ тираж PASS; любой шаг FAIL ⇒ тираж FAIL (собери логи
+контейнера `docker logs orchestrator` и снапшот `GET /queue` и разбирайся).
+
+Воспроизводимость без нового железа: процедура прогоняется на текущей инфре —
+staging-песочница (порт `ORCH_STAGING_PORT`, дефолт 8501) + sandbox-проект.
+Stateless: ни один шаг не предполагает перенос данных/БД/секретов.
+
+| # | Шаг | Команда | PASS | FAIL |
+|---|-----|---------|------|------|
+| 0 | Конфиг резолвится | `docker compose config` | резолв без ошибок; при пустом env значения = боевым дефолтам | ошибка интерполяции / неожиданные значения |
+| 1 | Инстанс жив | `curl -fsS http://127.0.0.1:<port>/health` | HTTP 200, `"status":"ok"` | не-200 / таймаут |
+| 2 | Контракты отвечают | `curl -fsS …/queue` и `…/metrics` | JSON со штатными блоками; `/metrics` → `schema_version: 1` | не-JSON / 5xx |
+| 3 | Тестовый проект | `python3 scripts/onboard_project.py plan` → `apply` → `verify` (sandbox) | `verify` зелёный (статусы/лейблы/repo/webhook на месте) | `verify` красный / manual-step не выполнен |
+| 4 | Тестовая задача | создать issue в Plane → статус «To Analyse» | задача в БД, analyst-job виден в `GET /queue` | задача не появилась (webhook/секрет/реестр) |
+| 5 | **Минимальный сигнал «конвейер доехал»** | дождаться окончания `analysis` | артефакты `01`–`04` в ветке задачи: `git ls-tree origin/<branch> docs/work-items/<id>/` | стадия не завершилась / артефактов нет |
+| 6 | Расширенный режим (опционально) | Approved → … → Confirm Deploy | задача дошла до `done` | застряла (разбор по `GET /queue` + логам) |
+
+> Ручной запуск deploy-хука на нестандартных портах — всегда с явными
+> `REPO=`/`TARGET_PORT=` (wired-путь оркестратора передаёт их сам из конфига;
+> дефолты хука — staging текущего хоста).
+
+---
+
+## 5. Что НЕ переносится (stateless, решение 10.06)
+
+- БД (`data/orchestrator.db`) — создаётся пустой при первом старте;
+- `.env` / `.env.staging` / `.env.watchdog` — собираются заново (§2–§3);
+- worktree'ы/runs/логи — рабочее состояние, не данные;
+- боевые секреты — никогда (§3).
+
+---
+
+*RUNBOOK ORCH-101. Поддерживать при добавлении хост-переменных (карта §2 +
+`.env.example` + INFRA.md в том же PR). Анти-регресс возврата хардкодов —
+`tests/test_no_host_hardcodes.py`; параметризация инфра-файлов —
+`tests/test_infra_parametrization.py`.*

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

@@ -0,0 +1,7 @@
+# Business Request: ORCH-10-common: расхардкод + секреты + smoke (фундамент тиража)
+
+Work Item ID: ORCH-101
+
+## Description
+
+TBD

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

@@ -0,0 +1,175 @@
+---
+work_item: ORCH-101
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 01 — BRD (бизнес-требования): ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke (фундамент тиража)
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: analysis
+
+## 1. Бизнес-контекст и проблема
+
+Эпик **ORCH-10** (домен 📈 D5 «Масштаб», `docs/epics/self-evolution.md`, D5.3) — тираж платформы
+для раздачи **текущей** функциональности нескольким заказчикам **на тест**. Решения Славы 10.06:
+
+- **Два типа тиража, оба stateless** (наши задачи/данные НЕ переносятся, чистый старт):
+  - **Тип A (Lite):** перенос орк + watchdog на новую инфру; окружение донастраивается по чёткой
+    инструкции.
+  - **Тип B (Bundled):** весь стек (Plane/Gitea/орк) одним комплектом.
+- **ORCH-101 = 10-common** — общий фундамент **обоих** типов. Без него ни Lite, ни Bundled не поедут.
+
+**Проблема.** Платформа фактически прибита гвоздями к хосту `mva154`:
+
+1. **Хардкоды хоста/окружения.** Аудит репо (стадия analysis, см. реестр в `02-trz.md` §3.1)
+   подтвердил: в `src/**` есть код, который **обходит конфиг** — внешний URL Gitea
+   `http://git.mva154.duckdns.org` зашит в `src/plane_sync.py`, `HOME=/home/slin` и git-идентичность
+   `*@mva154.local` зашиты в трёх местах (`launcher`/`self_deploy`/`post_deploy`); в
+   `docker-compose.yml` зашиты пути `/home/slin/...`, gid docker-группы `999`, uid `1000:1000`,
+   node-пути; в `Dockerfile` — `useradd … -d /home/slin slin` и порт CMD; в
+   `scripts/orchestrator-deploy-hook.sh` — `REPO=/home/slin/repos/orchestrator`. На новом хосте
+   (другой пользователь, другие пути, другой gid docker, другие URL) платформа не заведётся без
+   правки кода — это блокер тиража.
+2. **Секреты.** Боевые секреты (`.env`) копировать на чужую инфраструктуру нельзя (общий
+   webhook-secret = чужой хост сможет слать нам валидные вебхуки; утечка токенов). Механизма
+   «сгенерировать НОВЫЙ комплект секретов на новом хосте» нет; `.env.example` не имеет чек-листа
+   «что обязан заполнить оператор».
+3. **Верификация.** Нет процедуры убедиться, что развёрнутая копия платформы **жива**: «завести
+   тестовый проект + задачу → конвейер доехал». Без неё каждый тираж — слепой деплой.
+
+**Ценность:** после ORCH-101 платформа разворачивается на новой инфре конфигурацией (env), с
+собственными секретами и проверяется воспроизводимым smoke-прогоном. Это критический путь всего
+эпика ORCH-10.
+
+## 2. Объём (scope)
+
+### В объёме
+
+1. **Расхардкод** — вынести все хардкоды хоста/окружения в конфиг/env **с дефолтами, равными
+   текущим значениям**: IP/hostname (`82.22.50.71`, `mva154`, `*.duckdns.org`), пути
+   (`/home/slin/...`, `/repos`), порты (8500/8501/3000/8091), gid docker `999`, uid `1000`, имена
+   контейнеров/сервисов/образов, URL Plane/Gitea, git-идентичность агентов. Зоны:
+   `src/**`, `watchdog/**`, `docker-compose.yml`, `Dockerfile`, `scripts/`, `.env.example`.
+   Аудит — **весь репо** (нормативный реестр находок — `02-trz.md` §3.1).
+2. **Секреты** — механизм генерации **новых** секретов на новом хосте (webhook-секреты —
+   криптослучайная генерация на месте; внешние токены Plane/Gitea/Telegram — выпуск на целевых
+   системах по чек-листу). Полный шаблон `.env.example` с плейсхолдерами + чек-лист «что заполнить».
+   Боевые секреты не покидают текущий хост.
+3. **Smoke-верификация** — документированная воспроизводимая процедура (и/или скрипт-обвязка):
+   «завести тестовый проект + задачу → конвейер доехал», с чёткими критериями PASS/FAIL.
+4. **Анти-регресс** — структурный тест (grep-тест по образцу `tests/test_agent_prompts_canon.py`),
+   запрещающий возврат хост-хардкодов в `src/**`.
+5. **Доки** — deployment-раздел (параметризация, карта новых env-ключей, чек-лист секретов,
+   smoke-процедура) + обновление карты env в `docs/operations/INFRA.md` + `CHANGELOG.md`.
+
+### Вне объёма
+
+- **Сама инструкция тиража Типа A (Lite) end-to-end** и **сборка комплекта Типа B (Bundled)** —
+  отдельные задачи эпика ORCH-10; 10-common даёт им фундамент.
+- **Перенос данных/задач/истории** — тираж stateless по решению Славы 10.06 (чистый старт).
+- **Мультитенантность** (D5.6), горизонтальный воркер-пул (D5.4), IaC-автоматизация
+  (Terraform/Ansible) — не сейчас.
+- **Изменение конвейера**: `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / machine-verdict ключи /
+  схема БД — не трогаются (задача конфигурационная, не процессная).
+- **Расхардкод исторических документов** `docs/**`, `memory/**`, `CHANGELOG.md` — историческая
+  правда не переписывается; аудит судит **код и инфра-файлы**, не архив.
+- **`tests/**`** — тестам разрешены литералы как фикстуры/ожидания.
+- **Onboarding-kit** (`onboarding/`, ORCH-009) — уже параметризован плейсхолдерами `{{NAME}}`;
+  правится только при необходимости согласовать новые env-ключи.
+
+## 3. Заинтересованные стороны
+
+- **Слава (Owner)** — заказчик эпика ORCH-10; принимает BRD (гейт Approved) и прод-деплой
+  (Confirm Deploy).
+- **Будущие заказчики-тестеры** — потребители тиража Типов A/B (получают платформу на своей инфре).
+- **Стрим** — оператор тиража: выполняет инструкцию, генерирует секреты, гоняет smoke.
+- **Последующие задачи эпика ORCH-10 (Lite/Bundled)** — прямые потребители фундамента.
+- **Агенты конвейера / self-hosting** — изменения катятся через общий прод-инстанс; регресс на
+  текущем хосте недопустим (обслуживает и enduro-trails).
+
+## 4. Бизнес-требования (BR)
+
+- **BR-1 (расхардкод src)** — в `src/**` и `watchdog/**` не остаётся хост-специфичных литералов
+  (IP/hostname/пути/порты/URL/идентичности), **обходящих конфиг**: каждое такое значение читается
+  из `Settings` (env `ORCH_*` / `WATCHDOG_*`) с дефолтом, равным текущему боевому значению.
+  Дефолты в `src/config.py` / `watchdog/config.py` — легитимное место значений по умолчанию.
+- **BR-2 (расхардкод инфра-файлов)** — `docker-compose.yml`, `Dockerfile`,
+  `scripts/orchestrator-deploy-hook.sh` параметризованы (compose-интерполяция `${VAR:-default}`,
+  `ARG`, env-override соответственно); без заданных переменных конфигурация резолвится в текущие
+  значения 1:1.
+- **BR-3 (секреты)** — существует механизм получения **нового** комплекта секретов на новом хосте:
+  генерируемые локально (webhook-секреты) создаются криптослучайно; выпускаемые внешними системами
+  (токены Plane/Gitea/Telegram) перечислены в чек-листе с указанием, где их выпустить.
+  `.env.example` покрывает 100% обязательных ключей. Копирование боевых секретов не требуется ни
+  на одном шаге.
+- **BR-4 (smoke)** — существует документированная воспроизводимая процедура верификации тиража:
+  «развёрнутый инстанс → тестовый проект + задача → конвейер доехал», с момента старта до явного
+  PASS/FAIL-критерия; воспроизводимость подтверждена прогоном на текущей инфре (staging-песочница
+  8501 / sandbox-проект).
+- **BR-5 (zero-regression)** — на текущем хосте поведение 1:1: все новые параметры имеют дефолты =
+  сегодняшним значениям; пустой/неизменённый `.env` даёт байт-в-байт текущее поведение; полный
+  `pytest tests/ -q` зелёный.
+- **BR-6 (анти-регресс)** — возврат хост-хардкода в `src/**` ломает CI: структурный тест
+  сканирует код (вне комментариев/докстрингов) на запрещённые литералы.
+- **BR-7 (доки)** — deployment-раздел + карта env + чек-лист секретов + smoke-процедура
+  опубликованы в `docs/operations/`; `CHANGELOG.md` обновлён (правило агентов №2).
+
+## 5. Нефункциональные требования (NFR)
+
+- **NFR-1 (self-hosting safety)** — задача не перезапускает и не роняет прод-контейнер
+  `orchestrator`; правки `docker-compose.yml`/`Dockerfile` инертны до следующего штатного деплоя
+  через конвейер (staging 8501 → Confirm Deploy). Никаких push/force-push в `main` мимо PR.
+- **NFR-2 (обратимость)** — «kill-switch природа» параметризации: отсутствие новых env-переменных
+  = текущее поведение. Отдельный функциональный kill-switch не требуется — дефолты и есть откат.
+- **NFR-3 (секреты вне гита)** — реальные значения только в `.env`/`.env.staging` на хосте
+  (правило агентов №8); в гит попадают только шаблоны/плейсхолдеры; генератор секретов никогда не
+  перезаписывает существующий `.env` молча.
+- **NFR-4 (инварианты соседних задач, правило №9)** — параметризация не ослабляет зафиксированные
+  инварианты: ORCH-058 «freshness-путь целится ТОЛЬКО в staging, никогда в прод 8500»; ORCH-040
+  «uid 1000 + group_add 999 (МИНА 1 — не удалять) + HOME согласован с маунтами»; INV-4 «мерж только
+  через Gitea PR-merge API». Затронутые маркеры читаются перед правкой.
+- **NFR-5 (стабильность анти-регресс теста)** — grep-тест детерминирован и не флапает: судит код,
+  исключает комментарии/докстринги/`tests/**`/`docs/**`; список запрещённых литералов
+  централизован в самом тесте.
+- **NFR-6 (конвейер не трогаем)** — `STAGE_TRANSITIONS`, состав `QG_CHECKS`, семантика `check_*`,
+  machine-verdict ключи, схема БД — байт-в-байт прежние.
+
+## 6. Допущения и ограничения
+
+- Целевой хост тиража: Linux + Docker + Compose; Plane и Gitea доступны (для Типа A — донастройка
+  по инструкции Lite-задачи; их URL/токены подаются через env). Claude CLI присутствует на хосте
+  (пути маунтов параметризуются).
+- Тираж — **single-tenant**: один инстанс платформы на заказчика; общая мультитенантная топология
+  вне объёма.
+- Имя self-hosting репо платформы (`orchestrator`) — платформенная конвенция; делать ли его
+  конфигурируемым (`SELF_HOSTING_REPO`) — решение архитектора (см. `02-trz.md` §3.4, вопрос А-2).
+- Встроенный fallback-реестр проектов (`src/projects.py::_DEFAULT_PROJECTS`) содержит UUID'ы Plane
+  текущего хоста; на новом хосте обязателен `ORCH_PROJECTS_JSON` — фиксируется в чек-листе, сами
+  UUID'ы в дефолте безвредны (не сматчатся) и остаются как документированный fallback.
+- Историческая документация и комментарии кода могут упоминать `mva154`/пути — это не хардкоды
+  поведения и аудитом кода не считаются.
+
+## 7. Критерии успеха
+
+Платформа разворачивается на чужой инфре **без правки кода** — только env/конфиг; секреты
+выпускаются заново по чек-листу; smoke-прогон даёт явный PASS; на текущем хосте — ноль изменений
+поведения и зелёный полный регресс. Детальные условия PASS/FAIL — `03-acceptance-criteria.md`
+(AC-1…AC-8); прослеживаемость BR ↔ AC — в сводной матрице там же.
+
+## 8. Риски
+
+Кратко (детально — `10-tech-risks.md`, заполняет архитектор):
+
+- **Р-1: скрытый регресс при параметризации горячих путей** (`launcher` env агентов, compose
+  volumes) — митигируется дефолтами = текущим значениям + полным регрессом + staging-прогоном.
+- **Р-2: ослабление инварианта ORCH-058** при конфигуризации staging-порта (`_STAGING_PORT`) —
+  митигируется guard-условием «staging-порт ≠ прод-порт» и решением архитектора (возможно,
+  оставить константой с обоснованием).
+- **Р-3: флап анти-регресс grep-теста** (ложные срабатывания на комментарии) — митигируется
+  правилами исключений NFR-5.
+- **Р-4: неполный аудит** (пропущенный хардкод всплывает на первом реальном тираже) — митигируется
+  нормативным реестром §3.1 ТЗ + smoke-процедурой как последней линией обнаружения.
+- **Р-5: расползание скоупа в Lite/Bundled** — митигируется явным «вне объёма» §2.

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

@@ -0,0 +1,253 @@
+---
+work_item: ORCH-101
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 02 — ТЗ (TRZ): ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke (фундамент тиража)
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: analysis
+
+> ТЗ описывает **что** должно измениться и **где** (модули/контракты/артефакты), выведено из BRD и
+> фактического кода (аудит выполнен по репо на ветке задачи). **Как** (точные имена новых
+> конфиг-ключей, механика генератора секретов, форма smoke-скрипта) — решает архитектор в `06-adr/`.
+
+---
+
+## 1. Сводка изменения
+
+Три слоя одного фундамента тиража (эпик ORCH-10, оба типа A/B):
+
+1. **Расхардкод:** все хост-специфичные значения, которые сегодня **обходят конфиг** (зашиты в код
+   `src/**`, в `docker-compose.yml`, `Dockerfile`, `scripts/orchestrator-deploy-hook.sh`),
+   переводятся на чтение из `Settings` (env `ORCH_*`) / compose-интерполяцию `${VAR:-default}` /
+   `ARG` / env-override — **с дефолтами, равными текущим боевым значениям** (zero-regression).
+   Нормативный реестр находок — §3.1 (результат аудита всего репо).
+2. **Секреты:** механизм выпуска **нового** комплекта секретов на новом хосте (генерация
+   webhook-секретов + чек-лист внешних токенов) + полнота `.env.example`.
+3. **Smoke:** документированная воспроизводимая процедура «тестовый проект + задача → конвейер
+   доехал» с PASS/FAIL-критериями (+ анти-регресс grep-тест против возврата хардкодов).
+
+Конвейер (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/verdict-ключи/схема БД) — не меняется.
+
+---
+
+## 2. Задействованные модули / пути
+
+| Путь | Действие |
+|------|----------|
+| `src/config.py` | изменить: новые `Settings`-ключи (HOME агент-процессов, git-идентичность акторов, внешний Gitea-URL уже есть — `gitea_public_url`; прочее по §3.1), дефолты = текущим значениям |
+| `src/plane_sync.py` | изменить: `notify_stage_change` — убрать литерал `gitea_base = "http://git.mva154.duckdns.org"` и owner `admin` из путей ссылок → `settings.gitea_public_url` (fallback `gitea_url`) + `settings.gitea_owner` |
+| `src/agents/launcher.py` | изменить: env агент-процесса (×2 места) — `HOME` и git author/committer (`claude-bot@mva154.local`) из конфига |
+| `src/self_deploy.py` | изменить: env detached-процесса — `HOME`, `deploy-finalizer@mva154.local` из конфига |
+| `src/post_deploy.py` | изменить: env монитора — `HOME`, `post-deploy-monitor@mva154.local` из конфига |
+| `src/image_freshness.py` | изменить ИЛИ обосновать: `_STAGING_PORT = 8501` (см. §3.4 А-1, инвариант ORCH-058) |
+| `src/qg/checks.py` | изменить ИЛИ обосновать: `SELF_HOSTING_REPO = "orchestrator"` (см. §3.4 А-2) |
+| `src/fs_normalize.py` | изменить: fallback-подсказку `sudo chown -R 1000:1000 /repos/_wt` строить из `settings` (uid/worktrees_dir) |
+| `src/projects.py` | не менять логику; `_DEFAULT_PROJECTS` остаётся документированным fallback (UUID'ы чужого Plane безвредны); фиксация в чек-листе «на новом хосте обязателен `ORCH_PROJECTS_JSON`» |
+| `watchdog/config.py` | проверить/синхронизировать: уже env-driven (`WATCHDOG_*`); дефолт `http://127.0.0.1:8500/metrics` согласовать с параметризацией прод-порта |
+| `docker-compose.yml` | изменить: интерполяция `${VAR:-default}` для всех хост-значений (§3.1 B) |
+| `Dockerfile` | изменить: `ARG` для uid/gid/username/home; CMD-порт — по решению архитектора (§3.4 А-3) |
+| `scripts/orchestrator-deploy-hook.sh` | изменить: `REPO=/home/slin/repos/orchestrator` → env-override `REPO="${REPO:-…}"` |
+| `scripts/` (новый) | создать: генератор секретов и/или smoke-обвязка — форма за архитектором (§3.2, §3.3) |
+| `.env.example` | изменить: новые ключи, секции секретов с плейсхолдерами, чек-лист «что заполнить» |
+| `.env.staging.example` | изменить: согласовать с новыми ключами (при необходимости) |
+| `tests/test_no_host_hardcodes.py` (новый) | создать: структурный анти-регресс grep-тест (FR-8) |
+| `tests/` (новые) | создать: тесты параметризации/секретов/smoke по `04-test-plan.yaml` |
+| `docs/operations/` | создать deployment-раздел тиража (предложение: `REPLICATION.md`; имя финализирует архитектор) + обновить карту env в `INFRA.md` |
+| `CHANGELOG.md`, `CLAUDE.md`, `README.md` | изменить: запись изменения; паспорт/обзорные доки — по фактическому объёму (правило агентов №2/№6) |
+
+---
+
+## 3. Функциональные требования
+
+### FR-1 — Нормативный реестр хардкодов (результат аудита) и их устранение
+
+Привязка: BR-1, BR-2. Аудит выполнен по всему репо (grep по классам: IP/hostname, пути, порты,
+gid/uid, URL, идентичности). Реестр ниже **нормативен**: developer закрывает каждую строку;
+расхождение «нашёл ещё» — дополняет реестр в PR, а не игнорирует.
+
+#### 3.1. Реестр
+
+**A. `src/**` / `watchdog/**` — код, обходящий конфиг (блокеры AC-1):**
+
+| # | Файл:строка | Хардкод | Требование |
+|---|---|---|---|
+| A1 | `src/plane_sync.py:1064` | `gitea_base = "http://git.mva154.duckdns.org"` в `notify_stage_change` + owner `admin` в построении ссылок Branch/PR | читать `settings.gitea_public_url` (fallback `settings.gitea_url`; loopback-семантика — как в `notifications._build_plane_issue_link`) + `settings.gitea_owner`; никаких новых ключей не требуется |
+| A2 | `src/agents/launcher.py:594, 825` | `"HOME": "/home/slin"`; `GIT_AUTHOR/COMMITTER_EMAIL: claude-bot@mva154.local` (×2 места) | HOME и git-идентичность из конфига (новые ключи, дефолты = текущим значениям) |
+| A3 | `src/self_deploy.py:332–336` | `"HOME": "/home/slin"`; `deploy-finalizer@mva154.local` | то же (единый источник с A2; имя актора может остаться per-actor) |
+| A4 | `src/post_deploy.py:575–579` | `"HOME": "/home/slin"`; `post-deploy-monitor@mva154.local` | то же |
+| A5 | `src/image_freshness.py:61` | `_STAGING_PORT = 8501` (модульная константа; намеренный анти-prod-инвариант ORCH-058 AC-9) | конфигуризовать с дефолтом 8501 **с сохранением инварианта** (guard «staging-порт ≠ прод-порт») ИЛИ оставить константой с явным обоснованием в ADR — решение архитектора (§3.4 А-1) |
+| A6 | `src/qg/checks.py:517` | `SELF_HOSTING_REPO = "orchestrator"` (узел: на него опираются все `*_repos`-leaf'ы «empty CSV → self-hosting only») | конфиг-ключ с дефолтом `orchestrator` ИЛИ нормативная платформенная константа («репо платформы в тираже обязан называться `orchestrator`», фиксируется в deployment-доке) — решение архитектора (§3.4 А-2) |
+| A7 | `src/fs_normalize.py:539` | fallback-строка подсказки `sudo chown -R 1000:1000 /repos/_wt` | строить из `settings.fs_target_uid` / `settings.worktrees_dir` (соседние строки 533–535 уже так делают) |
+| A8 | `src/disk_watchdog.py:95` | fallback `["/repos", "/app/data"]` — зеркало дефолта `settings.disk_monitor_paths` | допустимое config-backed зеркало; не блокер. Требование: значения остаются синхронными с конфиг-дефолтом (одна точка истины желательна — на усмотрение архитектора) |
+| A9 | `src/projects.py:42–55` | `_DEFAULT_PROJECTS`: UUID'ы Plane текущего хоста | НЕ блокер (документированный fallback «out of the box», чужие UUID не сматчатся). Требование: чек-лист тиража обязывает задать `ORCH_PROJECTS_JSON` |
+| A10 | `watchdog/config.py:100,144` | дефолт `http://127.0.0.1:8500/metrics` | уже env-driven (`WATCHDOG_METRICS_URL`); дефолт легитимен; согласовать с А-3 (прод-порт), если тот станет параметром |
+
+> Паттерн `getattr(settings, "x", <литерал>)` (A7/A8 и др.) — **config-backed fallback**, не
+> хардкод-блокер: значение управляется конфигом. Блокер — только код, который конфиг **обходит**.
+
+**B. `docker-compose.yml` — хост-специфика (блокеры AC-6):**
+
+| # | Место | Хардкод |
+|---|---|---|
+| B1 | volumes ×3 сервисов | `/home/slin/repos:/repos`(+`:ro`), `/home/slin/.claude`, `/home/slin/.claude.json`, `/home/slin/.orchestrator-ssh:/home/slin/.ssh` |
+| B2 | volumes ×2 сервисов | `/usr/lib/node_modules/@anthropic-ai/claude-code:/opt/claude-code:ro`, `/usr/bin/node:/usr/bin/node:ro` |
+| B3 | `group_add` ×3 | `"999"` (gid docker-группы хоста) |
+| B4 | `user:` ×2 | `"1000:1000"` (uid:gid хоста) |
+| B5 | environment | `ORCH_HOST_REPOS_DIR=/home/slin/repos` ×2, `ORCH_DEPLOY_HOST_REPO_PATH=/home/slin/repos/orchestrator`, `DEPLOY_SSH_USER=slin` ×2, `ORCH_DEPLOY_SSH_USER=slin`, `DEPLOY_HOOK_SCRIPT=/home/slin/bin/enduro-deploy-hook.sh` ×2 (legacy enduro) |
+| B6 | `orchestrator-staging.command` | порт `8501` |
+
+Требование: compose-интерполяция `${VAR:-default}` (источник — `.env`, штатный механизм Compose);
+`docker compose config` без заданных переменных резолвится в текущие значения 1:1. Целевая
+семантика «HOME внутри контейнера согласован с маунтами `.claude`/`.ssh` и `useradd` Dockerfile»
+(инвариант ORCH-040) сохраняется как согласованная группа переменных.
+
+**C. `Dockerfile`:**
+
+| # | Место | Хардкод |
+|---|---|---|
+| C1 | `useradd -u 1000 -g 1000 -m -d /home/slin -s /bin/bash slin` | uid/gid/home/username |
+| C2 | `CMD … --port 8500` | прод-порт |
+
+Требование: C1 → `ARG` с дефолтами (1000/1000//home/slin/slin). C2 — по решению архитектора
+(§3.4 А-3): порт уже переопределяем через compose `command:`; допустимо оставить CMD-дефолт 8500.
+
+**D. `scripts/`:**
+
+| # | Место | Хардкод |
+|---|---|---|
+| D1 | `orchestrator-deploy-hook.sh:38` | `REPO=/home/slin/repos/orchestrator` (единственный непараметризованный путь скрипта; остальное уже env-override) |
+
+Требование: `REPO="${REPO:-/home/slin/repos/orchestrator}"` (паттерн остальных переменных скрипта).
+`scripts/staging_check.py` — уже env-driven (`ORCH_PLANE_API_URL`/`ORCH_GITEA_URL`/`--base-url`),
+изменений не требует.
+
+**E. Уже параметризовано (НЕ трогать, фиксация аудита):** дефолты `src/config.py`
+(`plane_api_url:8091`, `gitea_url:3000`, `repos_dir`, `host_repos_dir`, `worktrees_dir`, `runs_dir`,
+`db_path`, `deploy_ssh_user`, `deploy_host_repo_path`, `deploy_prod_target_port:8500`,
+`post_deploy_base_url`, `disk_monitor_paths`, `claude_bin`) — легитимные значения по умолчанию,
+управляемые env; менять их значения запрещено (BR-5).
+
+### FR-2 — Чтение хост-значений из конфига в `src/**`
+
+Привязка: BR-1. Каждый блокер класса A (A1–A4, A7; A5/A6 — по исходу §3.4) читает значение через
+`settings` (существующие либо новые ключи `Settings` с env `ORCH_*`). Требования к новым ключам:
+
+- дефолт = текущее боевое значение (BR-5): `/home/slin`, `claude-bot`, `*@mva154.local`-адреса;
+- описательный комментарий в `config.py` по образцу существующих блоков (назначение + env-имя);
+- ключи отражены в `.env.example` и карте env `INFRA.md`;
+- точные имена ключей и группировка (например, единый `agent_home_dir` + per-actor идентичности
+  или общий email-домен) — решение архитектора; ТЗ фиксирует контракт: **ни один из пяти акторов
+  (агенты CLI ×2 места, self-deploy finalizer, post-deploy monitor, fs-подсказка) не содержит
+  литералов `/home/slin` / `mva154` после изменения**.
+
+### FR-3 — Параметризация инфра-файлов
+
+Привязка: BR-2. Реестр B/C/D закрыт; механика — compose-интерполяция / `ARG` / shell-default.
+Инварианты: ORCH-040 (uid 1000 + `group_add` docker-gid + HOME-согласованность маунтов — группа
+переменных меняется согласованно, «МИНА 1» `group_add` не удаляется), ORCH-058 (staging-сервис
+никогда не резолвится в прод-таргет). Поведение `docker compose config` при пустом окружении —
+эквивалент текущего файла (проверяется тестом TC-06).
+
+### FR-4 — Механизм секретов нового хоста
+
+Привязка: BR-3. Состав:
+
+1. **Инвентаризация** (фиксация аудита): генерируемые локально — `ORCH_PLANE_WEBHOOK_SECRET`,
+   `ORCH_GITEA_WEBHOOK_SECRET`; выпускаемые внешними системами — `ORCH_PLANE_API_TOKEN`,
+   `ORCH_PLANE_BOT_*` (7 шт., опциональны: fallback на `ORCH_PLANE_API_TOKEN`), `ORCH_GITEA_TOKEN`,
+   `ORCH_TELEGRAM_BOT_TOKEN` (+ несекретный `ORCH_TELEGRAM_CHAT_ID`).
+2. **Генерация:** webhook-секреты создаются криптослучайно (стандарт: `secrets`-модуль Python /
+   эквивалент, длина ≥ 32 байт энтропии) на целевом хосте; форма (отдельный
+   `scripts/gen_secrets.py`, режим onboarding-CLI или документированная команда) — решение
+   архитектора. Требования к поведению: повторный запуск даёт другие значения; существующий `.env`
+   никогда не перезаписывается молча (NFR-3); вывод согласован с ключами `.env.example`.
+3. **Чек-лист** в deployment-доке: для каждого секрета — где выпустить (Plane UI/API, Gitea UI,
+   BotFather), куда вписать, как проверить. Явное правило: «боевые секреты текущего хоста не
+   копируются».
+4. **Полнота `.env.example`:** каждый обязательный для старта ключ присутствует (с плейсхолдером
+   или дефолтом), включая новые ключи FR-2/FR-3; секретные значения — только плейсхолдеры.
+
+### FR-5 — Smoke-верификация тиража
+
+Привязка: BR-4. Документированная процедура (deployment-раздел) + опциональная скрипт-обвязка
+(форма — архитектор; кандидаты-кирпичи уже в репо: `scripts/onboard_project.py` `plan/apply/verify`,
+`scripts/staging_check.py`, `GET /health` / `/queue` / `/metrics`):
+
+1. **Шаги:** поднять инстанс (env+секреты заполнены) → `GET /health` ок → завести тестовый
+   проект (onboarding-CLI `verify` или sandbox-проект) → создать тестовую задачу → убедиться, что
+   конвейер «доехал» (задача продвигается по стадиям; минимальный обязательный сигнал — стадия
+   `analysis` отработала и артефакты `01–04` созданы; полный прогон до `done` — расширенный режим).
+2. **Критерии:** каждый шаг имеет явный PASS/FAIL; итог процедуры — однозначный вердикт.
+3. **Воспроизводимость:** процедура прогоняется на текущей инфре (staging-песочница 8501 +
+   sandbox-проект) без нового железа — это и приёмочная проверка AC-3.
+4. **Stateless:** процедура нигде не предполагает перенос данных/БД с боевого хоста.
+
+### FR-6 — Анти-регресс структурный тест
+
+Привязка: BR-6. Новый `tests/test_no_host_hardcodes.py` (образец — `tests/test_agent_prompts_canon.py`):
+
+- сканирует `src/**/*.py` и `watchdog/**/*.py` на запрещённые литералы: `82.22.50.71`,
+  `/home/slin`, `mva154`, `duckdns` (список централизован в тесте; расширяем);
+- судит **код**: строки-комментарии и докстринги исключаются (NFR-5; механика исключения —
+  прагматичная построчная/AST — за developer);
+- `tests/**`, `docs/**`, `.env.example` — вне зоны сканирования;
+- допускает точечный явный allowlist (файл:литерал) с комментарием-обоснованием — пустой на
+  момент сдачи задачи (все блокеры A закрыты).
+
+### FR-7 — Документация
+
+Привязка: BR-7. Deployment-раздел в `docs/operations/` (предложение: `REPLICATION.md`): карта
+новых env-переменных (включая compose-интерполяцию), процедура секретов (FR-4), smoke-процедура
+(FR-5), границы «10-common vs Lite vs Bundled». Обновления: `INFRA.md` (карта env),
+`CHANGELOG.md`; `CLAUDE.md`/`README.md` — по фактическому объёму изменений (правило №2/№6).
+
+---
+
+### 3.4. Вопросы архитектору (решаются в `06-adr/`, не в ТЗ)
+
+- **А-1:** `_STAGING_PORT = 8501` (`image_freshness`) — конфиг-ключ с guard'ом «≠ прод-порт» или
+  нормативная константа? Инвариант ORCH-058 AC-9 («никогда не прод 8500») обязан сохраниться.
+- **А-2:** `SELF_HOSTING_REPO = "orchestrator"` — конфиг-ключ или платформенная конвенция тиража
+  (репо платформы всегда `orchestrator`)? На него завязаны все `*_repos`-leaf'ы.
+- **А-3:** CMD-порт Dockerfile (8500) — `ARG` или остаётся (порт уже переопределяем compose
+  `command:`)?
+- **А-4:** форма генератора секретов (отдельный скрипт / режим `onboard_project.py` /
+  документированная команда) и форма smoke (чистый runbook / runbook + скрипт).
+- **А-5:** группировка новых конфиг-ключей FR-2 (единый HOME-ключ + per-actor email'ы vs общий
+  email-домен).
+
+---
+
+## 4. Изменения API
+
+Нет. Существующие эндпоинты (`/health`, `/queue`, `/metrics`) переиспользуются smoke-процедурой
+read-only; новые эндпоинты не вводятся.
+
+## 5. Изменения схемы БД
+
+Нет.
+
+## 6. Требования к новым/изменённым QG checks
+
+Нет. `QG_CHECKS`/`check_*`/machine-verdict ключи не меняются. Новый структурный тест (FR-6) —
+обычный pytest: попадает в существующие гейты `check_ci_green`/`check_tests_passed`/merge-gate
+re-test автоматически, без регистрации нового QG.
+
+## 7. Совместимость / регресс
+
+- **Zero-regression (BR-5):** все новые параметры — с дефолтами, равными сегодняшним боевым
+  значениям; пустой/неизменённый `.env` ⇒ байт-в-байт текущее поведение; `docker compose config`
+  без переменных ⇒ эквивалент текущего файла. Полный `pytest tests/ -q` зелёный.
+- **Обратимость (NFR-2):** откат = не задавать новые переменные. Функциональный kill-switch не
+  требуется (дефолты и есть прежнее поведение); вводить новый флаг ради флага запрещено.
+- **Область раската:** изменения инертны для enduro-trails (значения те же); compose/Dockerfile
+  вступают в силу только при следующем штатном деплое через конвейер (staging 8501 → ручной
+  Confirm Deploy) — прод-контейнер в рамках задачи не рестартуется (NFR-1).
+- **Инварианты соседних маркеров (правило №9):** ORCH-040 (uid/gid/HOME/«МИНА 1»), ORCH-058
+  (freshness → только staging), ORCH-036/059 (self-deploy фазы, Confirm Deploy), INV-4 (мерж только
+  через PR-merge API) — сохраняются; соответствующие ADR прочитаны при правке помеченных блоков.

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

@@ -0,0 +1,131 @@
+---
+work_item: ORCH-101
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 03 — Критерии приёмки (Acceptance Criteria): ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: analysis
+
+Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
+(что считается провалом). Любой машинный/ручной reviewer проверяет их буквально по файлам
+репозитория. AC-1…AC-4 — дословно из бизнес-запроса (уточнены до проверяемости); AC-5…AC-8 —
+детализация скоупа (секреты/инфра/анти-регресс/инварианты).
+
+---
+
+## AC-1 — Ноль хардкодов хоста/путей/портов в `src/**`
+
+**Условие:** в коде `src/**` и `watchdog/**` (вне комментариев/докстрингов) нет хост-специфичных
+литералов, обходящих конфиг; всё читается из env/конфига с дефолтами. Проверка — grep-тестом
+(`tests/test_no_host_hardcodes.py`) и ревью по реестру `02-trz.md` §3.1.
+- **PASS:**
+  - блокеры A1–A4, A7 реестра закрыты: `grep -rn "git.mva154.duckdns.org\|/home/slin\|mva154.local" src/ watchdog/` не находит ни одного вхождения в исполняемом коде (докстринги/комментарии — допустимы);
+  - `src/plane_sync.py::notify_stage_change` строит ссылки Branch/PR из `settings.gitea_public_url` (fallback `gitea_url`) и `settings.gitea_owner`;
+  - env-словари акторов (`launcher` ×2, `self_deploy`, `post_deploy`) берут HOME и git-идентичность из `settings`;
+  - A5 (`_STAGING_PORT`) и A6 (`SELF_HOSTING_REPO`) либо конфигуризованы, либо явно обоснованы в ADR задачи как платформенные константы (решение архитектора зафиксировано);
+  - структурный тест `tests/test_no_host_hardcodes.py` существует, его allowlist пуст (или каждая запись обоснована комментарием), тест зелёный.
+- **FAIL:** хотя бы один литерал `82.22.50.71` / `/home/slin` / `mva154` / `duckdns` в исполняемом коде `src/**`/`watchdog/**`; ИЛИ ссылка в Plane-комментарии всё ещё строится от захардкоженного `http://git.mva154.duckdns.org`; ИЛИ A5/A6 не конфигуризованы и не обоснованы в ADR; ИЛИ анти-регресс тест отсутствует/красный.
+
+---
+
+## AC-2 — Без регресса: на текущем хосте поведение 1:1
+
+**Условие:** дефолты всех новых параметров равны текущим боевым значениям; pytest зелёный.
+- **PASS:**
+  - каждый новый `Settings`-ключ / compose-переменная / `ARG` / shell-default имеет дефолт, равный значению, зашитому до задачи (`/home/slin`, `claude-bot@mva154.local`-адреса, gid 999, uid 1000, порты 8500/8501, пути node/claude-code и т.д.);
+  - `docker compose config` без заданных переменных окружения резолвится в эквивалент текущей конфигурации (volumes/user/group_add/environment/command совпадают по значениям);
+  - значения существующих дефолтов `src/config.py` (реестр §3.1 E) не изменены;
+  - полный `pytest tests/ -q` зелёный;
+  - `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / machine-verdict ключи / схема БД — без изменений (диф не затрагивает их семантику).
+- **FAIL:** хотя бы один дефолт отличается от текущего боевого значения; ИЛИ `docker compose config` при пустом окружении даёт иную эффективную конфигурацию; ИЛИ любой существующий тест красный; ИЛИ диф меняет машину стадий/реестр QG/схему БД.
+
+---
+
+## AC-3 — Smoke-процедура задокументирована и воспроизводима
+
+**Условие:** существует документированная процедура «развёрнутый инстанс → тестовый проект +
+задача → конвейер доехал» с явными PASS/FAIL-критериями; воспроизводимость подтверждена.
+- **PASS:**
+  - в `docs/operations/` есть раздел/документ (предложение ТЗ: `REPLICATION.md`) с пошаговой smoke-процедурой: health-check инстанса → тестовый проект → тестовая задача → подтверждение продвижения конвейера (минимум: `analysis` отработала, артефакты `01–04` созданы; расширенный режим — до `done`);
+  - каждый шаг имеет явный ожидаемый результат (PASS/FAIL), итог — однозначный вердикт;
+  - процедура не требует переноса данных/секретов с боевого хоста (stateless);
+  - воспроизводимость подтверждена хотя бы одним прогоном на текущей инфре (staging-песочница 8501 / sandbox-проект) — результат зафиксирован в артефактах задачи (например, `13-test-report.md` / `15-staging-log.md`);
+  - если введена скрипт-обвязка (`scripts/…`) — она запускается (`--help`/dry-run без ошибок) и покрыта тестом из `04-test-plan.yaml`.
+- **FAIL:** процедуры нет; ИЛИ шаги без явных критериев («посмотреть, что всё ок»); ИЛИ процедура требует копирования боевых данных/секретов; ИЛИ заявленный прогон не зафиксирован; ИЛИ скрипт-обвязка падает на запуске.
+
+---
+
+## AC-4 — Доки (deployment-раздел) + CHANGELOG
+
+**Условие:** документация обновлена в том же PR (правило агентов №2; reviewer проверяет — №6).
+- **PASS:**
+  - deployment-раздел (см. AC-3) дополнительно содержит: карту всех новых env-переменных (имя, назначение, дефолт), процедуру/чек-лист секретов (см. AC-5), границы «10-common vs Lite vs Bundled»;
+  - карта переменных окружения в `docs/operations/INFRA.md` дополнена новыми ключами;
+  - `CHANGELOG.md` содержит запись ORCH-101;
+  - `CLAUDE.md`/`README.md` обновлены, если фактический объём изменений того требует (новые операторские способности/ограничения).
+- **FAIL:** новый env-ключ отсутствует в карте env; ИЛИ нет записи в `CHANGELOG.md`; ИЛИ deployment-раздел не покрывает секреты/smoke; ИЛИ README выдаёт решённое за открытое (правило №6).
+
+---
+
+## AC-5 — Секреты: генерация новых, не копирование боевых
+
+**Условие:** механизм выпуска нового комплекта секретов на новом хосте существует и безопасен.
+- **PASS:**
+  - webhook-секреты (`ORCH_PLANE_WEBHOOK_SECRET`, `ORCH_GITEA_WEBHOOK_SECRET`) генерируются криптослучайно (≥ 32 байт энтропии; повторный запуск даёт другие значения);
+  - механизм никогда не перезаписывает существующий `.env` молча;
+  - чек-лист перечисляет все внешние токены (`ORCH_PLANE_API_TOKEN`, `ORCH_PLANE_BOT_*`, `ORCH_GITEA_TOKEN`, `ORCH_TELEGRAM_BOT_TOKEN`) с указанием, где их выпустить и куда вписать; явно сказано «боевые секреты не копируются»;
+  - `.env.example` покрывает 100% ключей, обязательных для старта (включая новые из AC-1/AC-2), секретные значения — только плейсхолдеры; реальные секреты в гит не попадают (`.gitleaks`/security-гейт зелёный);
+  - `.env.staging.example` согласован (если затронут).
+- **FAIL:** секрет генерируется детерминированно/слабо; ИЛИ запуск механизма затирает существующий `.env`; ИЛИ в `.env.example` отсутствует обязательный ключ; ИЛИ в гит закоммичено реальное секретное значение; ИЛИ процедура предписывает копирование боевого секрета.
+
+---
+
+## AC-6 — Инфра-файлы параметризованы
+
+**Условие:** `docker-compose.yml`, `Dockerfile`, `scripts/orchestrator-deploy-hook.sh` не требуют
+правки под новый хост — только переменные.
+- **PASS:**
+  - реестр §3.1 B/C/D закрыт: пути `/home/slin/...`, gid `999`, uid `1000:1000`, node/claude-code-пути, ssh-user, staging-порт в `command:`, `REPO=` в deploy-hook — параметризованы (`${VAR:-default}` / `ARG` / `"${REPO:-…}"`) с дефолтами = текущим значениям;
+  - связка «uid/gid/HOME/маунты `.claude`+`.ssh`/`useradd`» меняется согласованной группой переменных (инвариант ORCH-040 сохранён, `group_add` docker-gid не удалён);
+  - структурный тест параметризации (TC-06/TC-12 из `04-test-plan.yaml`) зелёный.
+- **FAIL:** хотя бы одно значение реестра B/C/D осталось непараметризованным; ИЛИ группа ORCH-040 рассогласована (HOME ≠ маунт-таргеты при дефолтах); ИЛИ `group_add` удалён; ИЛИ структурный тест красный.
+
+---
+
+## AC-7 — Анти-регресс защита от возврата хардкодов
+
+**Условие:** возврат хост-хардкода в `src/**` ломает CI.
+- **PASS:** `tests/test_no_host_hardcodes.py` существует; сканирует `src/**`+`watchdog/**` на централизованный список запрещённых литералов (минимум: `82.22.50.71`, `/home/slin`, `mva154`, `duckdns`); исключает комментарии/докстринги/`tests/**`/`docs/**`; детерминирован (повторные прогоны стабильны); демонстрационно ловит подсадку литерала (негативная самопроверка в самом тесте или в тестах теста).
+- **FAIL:** тест отсутствует; ИЛИ не ловит подсаженный в код литерал из списка; ИЛИ флапает; ИЛИ список литералов размазан по нескольким местам без единой точки правки.
+
+---
+
+## AC-8 — Self-hosting безопасность и инварианты соседних задач
+
+**Условие:** задача не дестабилизирует общий прод и не ослабляет зафиксированные инварианты.
+- **PASS:**
+  - в рамках задачи прод-контейнер `orchestrator` не перезапускается; прод-деплой — только штатно (staging 8501 → ручной `Confirm Deploy`);
+  - инвариант ORCH-058 сохранён: freshness/staging-путь не может быть переконфигурирован в прод-таргет (guard «staging-порт ≠ прод-порт» при конфигуризации A5 — либо A5 остался константой по ADR);
+  - INV-4 сохранён (никаких push/force-push в `main` мимо PR-merge API);
+  - маркеры `ORCH-NNN` в правленых блоках сохранены/обновлены корректно (правило №9).
+- **FAIL:** диф содержит рестарт/останов прод-контейнера вне штатного деплой-пути; ИЛИ конфигурацией можно нацелить staging-rebuild на прод-порт; ИЛИ нарушен INV-4; ИЛИ правка помеченного блока стёрла инвариант соседнего ADR.
+
+---
+
+## Сводная матрица AC ↔ BR/FR
+
+| AC | Покрывает |
+|----|-----------|
+| AC-1 | BR-1 / FR-1, FR-2, FR-6 |
+| AC-2 | BR-5 / FR-1 (реестр E), FR-2, FR-3, NFR-6 |
+| AC-3 | BR-4 / FR-5 |
+| AC-4 | BR-7 / FR-7 |
+| AC-5 | BR-3 / FR-4, NFR-3 |
+| AC-6 | BR-2 / FR-3, NFR-4 |
+| AC-7 | BR-6 / FR-6, NFR-5 |
+| AC-8 | NFR-1, NFR-2, NFR-4 / FR-3 |

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

@@ -0,0 +1,146 @@
+work_item: ORCH-101
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+title: "ORCH-10-common: расхардкод + секреты + smoke — план тестов"
+framework: pytest
+scope: >
+  Покрывается: расхардкод src/**+watchdog/** (чтение хост-значений из Settings),
+  параметризация docker-compose.yml/Dockerfile/deploy-hook (структурные проверки),
+  полнота .env.example, поведение генератора секретов, запускаемость smoke-обвязки,
+  анти-регресс grep-тест и его негативная самопроверка, zero-regression (полный
+  регресс tests/). Вне покрытия: реальный e2e-тираж на новом железе (заменён
+  воспроизводимым прогоном smoke-процедуры на staging-песочнице 8501 — AC-3),
+  задачи Lite/Bundled эпика ORCH-10, перенос данных (stateless по решению 10.06).
+notes: >
+  Имена новых тест-модулей — предложение analyst; developer может переименовать,
+  сохранив покрытие TC. Дефолты всех новых параметров обязаны равняться текущим
+  боевым значениям (AC-2) — тесты фиксируют это явно. Анти-регресс тест судит
+  исполняемый код (комментарии/докстринги исключены) — образец структурных тестов:
+  tests/test_agent_prompts_canon.py. Полный регресс tests/ должен оставаться
+  зелёным; STAGE_TRANSITIONS/QG_CHECKS/check_*/machine-verdict не меняются —
+  новые тесты входят в существующие гейты (check_ci_green) автоматически.
+
+tests:
+  - id: TC-01
+    type: unit
+    description: >
+      Анти-регресс скан: в исполняемом коде src/** и watchdog/** нет запрещённых
+      литералов (82.22.50.71, /home/slin, mva154, duckdns); комментарии/докстринги
+      исключаются; список литералов централизован; allowlist пуст либо каждая
+      запись обоснована (AC-1, AC-7 / FR-6).
+    module: tests/test_no_host_hardcodes.py
+    expected: PASS
+
+  - id: TC-02
+    type: unit
+    description: >
+      Негативная самопроверка сканера: подсаженный во временный/фиктивный модуль
+      запрещённый литерал детектируется (сканер реально ловит, не вечно-зелёный)
+      (AC-7 / FR-6, NFR-5).
+    module: tests/test_no_host_hardcodes.py
+    expected: PASS
+
+  - id: TC-03
+    type: unit
+    description: >
+      plane_sync.notify_stage_change строит ссылки Branch/PR из
+      settings.gitea_public_url (fallback gitea_url) + settings.gitea_owner;
+      литерал git.mva154.duckdns.org и owner admin из кода удалены; при
+      переопределённых настройках ссылка меняется соответственно (monkeypatch,
+      без сети) (AC-1 / FR-1 A1, FR-2).
+    module: tests/test_host_config_keys.py
+    expected: PASS
+
+  - id: TC-04
+    type: unit
+    description: >
+      Env агент-процесса в agents/launcher (оба места запуска): HOME и
+      GIT_AUTHOR/COMMITTER_NAME/EMAIL берутся из settings; дефолты равны прежним
+      значениям (/home/slin, claude-bot@mva154.local); переопределение env-ключей
+      меняет словарь окружения (AC-1, AC-2 / FR-1 A2, FR-2).
+    module: tests/test_host_config_keys.py
+    expected: PASS
+
+  - id: TC-05
+    type: unit
+    description: >
+      Env self_deploy (deploy-finalizer) и post_deploy (monitor): HOME и
+      git-идентичность из settings, дефолты = прежним значениям; литералы
+      /home/slin и *@mva154.local из кода удалены (AC-1, AC-2 / FR-1 A3–A4, FR-2).
+    module: tests/test_host_config_keys.py
+    expected: PASS
+
+  - id: TC-06
+    type: unit
+    description: >
+      Структурная проверка docker-compose.yml: хост-значения реестра ТЗ §3.1 B
+      (пути /home/slin/*, node/claude-code-пути, gid 999, uid 1000:1000, ssh-user,
+      staging-порт в command) выражены интерполяцией ${VAR:-default}, и дефолты
+      равны текущим значениям; group_add docker-gid присутствует во всех трёх
+      сервисах (инвариант ORCH-040 «МИНА 1») (AC-2, AC-6 / FR-3).
+    module: tests/test_infra_parametrization.py
+    expected: PASS
+
+  - id: TC-07
+    type: unit
+    description: >
+      Структурная проверка Dockerfile: uid/gid/username/home параметризованы через
+      ARG с дефолтами 1000/1000/slin//home/slin; решение по CMD-порту соответствует
+      ADR задачи (ARG либо обоснованный дефолт 8500) (AC-2, AC-6 / FR-3, §3.4 А-3).
+    module: tests/test_infra_parametrization.py
+    expected: PASS
+
+  - id: TC-08
+    type: unit
+    description: >
+      Полнота .env.example: каждый обязательный для старта ключ присутствует,
+      включая ВСЕ новые ключи FR-2/FR-3 (сверка с Settings.model_fields по
+      выбранному архитектором контракту); секретные ключи содержат только
+      плейсхолдеры, не реальные значения; deploy-hook принимает REPO через
+      env-override (AC-5, AC-6 / FR-1 D1, FR-4.4).
+    module: tests/test_infra_parametrization.py
+    expected: PASS
+
+  - id: TC-09
+    type: unit
+    description: >
+      Генератор секретов: два запуска дают различные значения; длина/энтропия
+      webhook-секретов >= 32 байт; существующий .env никогда не перезаписывается
+      молча (запуск при существующем файле -> отказ/явное подтверждение);
+      вывод согласован с ключами .env.example (AC-5 / FR-4, NFR-3).
+    module: tests/test_secrets_gen.py
+    expected: PASS
+
+  - id: TC-10
+    type: integration
+    description: >
+      Smoke-обвязка и процедура: deployment-док с пошаговой smoke-процедурой
+      существует и содержит явные PASS/FAIL-критерии каждого шага; если введён
+      скрипт — он запускается без ошибок в безопасном режиме (--help/dry-run, без
+      сети/LLM-расходов); карта env в INFRA.md дополнена; CHANGELOG.md содержит
+      запись ORCH-101 (AC-3, AC-4 / FR-5, FR-7).
+    module: tests/test_replication_smoke.py
+    expected: PASS
+
+  - id: TC-11
+    type: unit
+    description: >
+      Инвариант ORCH-058 при исходе А-1: если staging-порт стал конфигуром —
+      дефолт 8501, guard «staging-порт != прод-порт» отвергает совпадение
+      (freshness-путь невозможно нацелить на прод); если остался константой —
+      тест фиксирует константу 8501 и наличие обоснования в ADR задачи
+      (AC-8 / FR-1 A5, NFR-4).
+    module: tests/test_host_config_keys.py
+    expected: PASS
+
+  - id: TC-12
+    type: integration
+    description: >
+      Полный регресс: pytest tests/ -q зелёный на дефолтной конфигурации (пустой
+      env) — поведение платформы на текущем хосте 1:1; существующие тесты не
+      правились под задачу (кроме согласованных структурных) (AC-2 / BR-5, NFR-6).
+    module: tests/
+    expected: PASS

docs/work-items/ORCH-101/06-adr/ADR-001-host-parametrization-secrets-smoke.md

@@ -0,0 +1,374 @@
+---
+work_item: ORCH-101
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# ADR-001: Параметризация хоста + секреты нового хоста + smoke-верификация (фундамент тиража 10-common)
+
+Work Item: **ORCH-101** — ORCH-10-common: расхардкод + секреты + smoke
+Стадия: **architecture**
+Сквозная регистрация: **`docs/architecture/adr/adr-0036-replication-foundation-host-parametrization.md`**
+(решение кросс-каттинговое: задаёт платформенные конвенции тиража и трогает блоки с маркерами
+ORCH-036/040/058 — по `docs/_standards/TRACEABILITY.md` агрегируется сводным сквозным ADR).
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5.3 «Масштаб») требует разворачивать платформу на чужой инфре **без правки кода** —
+двумя типами тиража (A Lite / B Bundled), оба stateless. Сегодня платформа прибита к `mva154`:
+часть значений **обходит конфиг**. Аудит стадии analysis (нормативный реестр — `02-trz.md` §3.1)
+перепроверен мной по коду ветки (`grep` всех запрещённых классов по `src/**`+`watchdog/**`):
+
+- **Код-блокеры ровно четыре:** A1 `plane_sync.py:1064` (`gitea_base = "http://git.mva154.duckdns.org"`
+  + owner `admin` в ссылках), A2 `agents/launcher.py:594,825` (HOME + git-идентичность ×2 места),
+  A3 `self_deploy.py:332–336`, A4 `post_deploy.py:575–579` (то же у finalizer/monitor).
+- **Все остальные вхождения** `82.22.50.71|/home/slin|mva154|duckdns` в `src/**`/`watchdog/**` —
+  комментарии/докстринги (`disk_watchdog.py:3,80`, `build_cache_pruner.py:3`, `fs_normalize.py:7`,
+  `config.py:469`) либо **легитимные конфиг-дефолты** (`config.py:48,201` — реестр E, BR-1).
+- A7 (`fs_normalize.py::healing_command`) **уже config-backed в основном пути** (строит из
+  `_resolve_target_uid`/`settings.worktrees_dir`); литерал остался только в `except`-ветке
+  never-raise (см. D10).
+- Инфра-файлы: `docker-compose.yml` (реестр B1–B6), `Dockerfile` (C1–C2),
+  `scripts/orchestrator-deploy-hook.sh:38` (D1 — единственная непараметризованная строка скрипта;
+  критично: хук **безусловно перезаписывает** `REPO=`, поэтому даже корректный env инвокера сегодня
+  игнорируется).
+- Секретов «для нового хоста» нет (общий webhook-secret = чужой хост шлёт нам валидные вебхуки);
+  smoke-процедуры тиража нет.
+
+Сопутствующие инварианты, которые НЕЛЬЗЯ ослабить (правило №9, ADR прочитаны):
+**ORCH-040** (adr-0005: uid 1000 + `group_add: ["999"]` «МИНА 1» + HOME согласован с маунтами),
+**ORCH-058** (adr-0008: freshness-путь целится ТОЛЬКО в staging, explicit-pass таргета, INV-FRESH),
+**ORCH-036** (adr-0007: exit-code контракт хука 0/1/2, detached Phase B), **INV-4** (мерж только
+через Gitea PR-merge API).
+
+## Решение
+
+### Сводка
+
+Три слоя одного фундамента. (1) **Расхардкод**: четыре код-блокера переводятся на `Settings`
+(три новых ключа + два существующих), инфра-файлы — на compose-интерполяцию/`ARG`/env-override;
+**каждый дефолт равен боевому значению** → отсутствие новых переменных = байт-в-байт текущее
+поведение (kill-switch-природа, NFR-2; отдельный флаг не вводится). (2) **Секреты**: новый
+stdlib-скрипт `scripts/gen_secrets.py` (криптослучайные webhook-секреты, печать по умолчанию,
+никогда не перезаписывает `.env` молча) + чек-лист внешних токенов. (3) **Smoke**: чистый runbook
+`docs/operations/REPLICATION.md` из существующих кирпичей (`/health`, `/queue`, `/metrics`,
+`onboard_project.py`, sandbox-задача), без нового скрипта. Анти-регресс — структурный сканер
+`tests/test_no_host_hardcodes.py`. Конвейер (`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/
+machine-verdict/схема БД) — байт-в-байт не тронут (NFR-6).
+
+### D1 — Принцип параметризации: «дефолт = боевое значение», механизм по слоям
+
+| Слой | Механизм | Канон дефолта |
+|------|----------|---------------|
+| `src/**`, `watchdog/**` | ключи `Settings` (env `ORCH_*`) / `watchdog.Config` (`WATCHDOG_*`) | `src/config.py` / `watchdog/config.py` — **единственные легитимные места** хост-литералов в коде (BR-1) |
+| `docker-compose.yml` | интерполяция `${VAR:-default}` | дефолт в самом файле = текущее значение |
+| `Dockerfile` | build `ARG` (+ wiring через compose `build.args`) | дефолт `ARG` = текущее значение |
+| `scripts/orchestrator-deploy-hook.sh` | `"${VAR:-default}"` (паттерн остальных переменных хука) | дефолт = текущее значение |
+
+**Правило одного имени:** если значение нужно и контейнеру (pydantic), и compose-интерполяции —
+используется **одно** env-имя (например `ORCH_AGENT_HOME_DIR`, `ORCH_STAGING_PORT`): pydantic
+читает его из `env_file`, compose — из `.env`/shell. Два имени для одного факта запрещены.
+
+**Источник интерполяции (важно, фиксируется в REPLICATION.md):** compose резолвит `${VAR}` из
+`.env` проекта/shell-окружения, **НЕ** из `env_file` сервиса — `.env.staging` на интерполяцию не
+влияет. Для single-host тиража это штатно: интерполяционные значения живут в `.env`.
+
+Привязка: BR-1, BR-2, BR-5, NFR-2 / FR-1, FR-2, FR-3. Проверка: AC-1, AC-2, AC-6 (TC-01…TC-08).
+
+### D2 — Новые `Settings`-ключи и группировка акторских env (вопрос А-5)
+
+Выбран вариант **«единый HOME + общий email-домен + одно агентское имя»** (3 ключа), против
+6+ per-actor ключей:
+
+| Ключ | env | Дефолт | Потребители |
+|------|-----|--------|-------------|
+| `agent_home_dir` | `ORCH_AGENT_HOME_DIR` | `/home/slin` | `HOME` всех 4 акторских env-словарей: `launcher` (×2 места — Popen агента и git commit/push), `self_deploy.write_deploy_log`, `post_deploy.write_post_deploy_log`; + compose mount-таргеты и `ARG APP_HOME` (D5/D6) |
+| `agent_git_name` | `ORCH_AGENT_GIT_NAME` | `claude-bot` | `GIT_AUTHOR/COMMITTER_NAME` агентов в `launcher` (×2) — customer-visible идентичность коммитов |
+| `git_email_domain` | `ORCH_GIT_EMAIL_DOMAIN` | `mva154.local` | домен email всех трёх акторов |
+
+**Контракт идентичностей:** email строится как `f"{name}@{settings.git_email_domain}"`, где
+`name` = `settings.agent_git_name` для агентов (launcher) и **платформенные литералы**
+`deploy-finalizer` / `post-deploy-monitor` для системных акторов (`self_deploy` / `post_deploy`) —
+имена системных акторов не хост-специфичны, различимость их коммитов в истории ценна, ключи на них
+не заводятся. Дефолтные итоговые значения = сегодняшним байт-в-байт: `claude-bot@mva154.local`,
+`deploy-finalizer@mva154.local`, `post-deploy-monitor@mva154.local` (BR-5).
+
+**A1 (`plane_sync.notify_stage_change`) — новых ключей НЕ требует:** база ссылок —
+`settings.gitea_public_url or settings.gitea_url` (точно та же fallback-семантика, что у
+существующих потребителей `notifications.py:901` и `usage.py:457,662`), owner —
+`settings.gitea_owner` (заменяет литерал `admin` в путях Branch/PR).
+
+Каждый новый ключ получает описательный комментарий в `config.py` (по образцу соседних блоков),
+строку в `.env.example` и в карте env `INFRA.md`. Контракт FR-2 после изменения: **ни один из
+акторов не содержит литералов `/home/slin` / `mva154` в исполняемом коде** (TC-03…TC-05).
+
+### D3 — Вопрос А-2: `SELF_HOSTING_REPO = "orchestrator"` остаётся платформенной константой
+
+**Решение: НЕ конфигурируем.** Имя self-hosting репо — **нормативная конвенция тиража**: «репо
+платформы в любом тираже обязан называться `orchestrator`» (фиксируется в REPLICATION.md §границы
++ чек-лист). Обоснование:
+
+1. **Это узел безопасности, а не хост-значение.** На `is_self_hosting_repo` завязана семантика
+   «empty CSV → self-hosting only» **всех** `*_repos`-leaf'ов (merge-gate, image-freshness,
+   security, coverage, serial-gate freeze, fs-normalize, auto-labels, bug-fast-track, deploy-guard…).
+   Опечатка в гипотетическом `ORCH_SELF_HOSTING_REPO` либо **активирует деплой-машинерию на чужом
+   репо** (групповой риск), либо **молча выключает все self-гейты** на своём (класс «гейт тихо
+   исчез» — худший отказ по урокам ORCH-058). Константа делает оба отказа структурно невозможными.
+2. **Цена конвенции — ноль.** Тираж stateless (решение Славы 10.06): репо платформы создаётся
+   заново на целевой инфре (Type A — по инструкции Lite, Type B — в комплекте) — его имя полностью
+   под контролем оператора. Конфигурируемость не покупает ни одного сценария, который конвенция не
+   даёт бесплатно.
+3. Расширяемость не теряется: если будущий тираж потребует иного имени — отдельная задача с
+   guard'ами; этот ADR — зафиксированное место, откуда она стартует.
+
+Привязка: AC-1 (вариант «обоснованы в ADR задачи как платформенные константы»). Анти-дрейф: тест
+фиксирует константу (см. D10/TC-11-паттерн).
+
+### D4 — Вопрос А-1: staging-порт конфигурируем С fail-closed guard (инвариант ORCH-058 усилен)
+
+**Решение: конфигурируем порт, НЕ конфигурируем имена.** Новый ключ:
+
+- `staging_port: int = 8501` (env **`ORCH_STAGING_PORT`**) — заменяет модульную константу
+  `image_freshness._STAGING_PORT`; то же env-имя интерполируется в `command:` staging-сервиса
+  compose (`${ORCH_STAGING_PORT:-8501}`, реестр B6) → обе точки читают один факт (D1).
+- `_STAGING_SERVICE` / `_STAGING_COMPOSE_PROFILE` (`orchestrator-staging` / `staging`) —
+  **остаются константами**: имена сервисов/профиля нашего же compose-файла — платформенная
+  конвенция (логика D3); их разъезд с compose ломал бы rebuild внутри одного репо без выгоды.
+
+**Guard (ядро решения, NFR-4 / Р-2):** в начале freshness-пути (`check_staging_image_fresh`,
+ДО любого ssh/build/recreate) — проверка
+`settings.staging_port == settings.deploy_prod_target_port` → **отказ fail-closed**:
+`(False, "misconfiguration: ORCH_STAGING_PORT == prod target port (ORCH-058 AC-9) — staging rebuild refused")`
++ best-effort Telegram-алерт. **Без тихого fallback на 8501** — молчаливая подмена порта хуже
+громкого отказа (оператор обязан починить env). Дисциплина explicit-pass ORCH-058 сохраняется:
+`TARGET_PORT=` по-прежнему передаётся хуку явно (`image_freshness.py:272`), источник теперь — один
+валидируемый конфиг-ключ вместо литерала. Инвариант «freshness-путь никогда не целится в прод»
+из подразумеваемого константой становится **исполняемым** (guard) — усиление, не ослабление.
+
+Примечание: при изменённом `ORCH_STAGING_PORT` ручной запуск хука `--build-staging` без env-прefix
+использует staging-дефолты хука (8501) — это документируется в REPLICATION.md (ручные запуски —
+с явным `TARGET_PORT=`); wired-путь (через `image_freshness`) всегда передаёт порт явно.
+
+Привязка: FR-1 A5, AC-8, TC-11.
+
+### D5 — Вопрос А-3: CMD Dockerfile остаётся `8500`; параметризация порта — на слое compose
+
+**Решение: `CMD` не трогаем** (exec-form, `--port 8500` — документированный дефолт образа):
+
+- `ARG` не подставляется в рантайм-CMD; shell-form CMD (`sh -c "… ${PORT}"`) менял бы
+  PID-1/сигнальную семантику — пара «`init: true` + exec-form» выверена (B-2, зомби-репарентинг
+  поддерева claude/node) и трогать её ради порта — риск без выгоды.
+- Порт конфигурируется там, где уже доказанно работает (staging так живёт с ORCH-31): **оба**
+  compose-сервиса получают явный `command:`: прод —
+  `["uvicorn","src.main:app","--host","0.0.0.0","--port","${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}"]`,
+  staging — то же с `${ORCH_STAGING_PORT:-8501}`. **Реюз существующего env-имени**
+  `ORCH_DEPLOY_PROD_TARGET_PORT` (ключ `deploy_prod_target_port: 8500` уже описывает прод-порт для
+  деплой-пути) — вторая «истина» о прод-порте не вводится. Дефолтный резолв = байт-в-байт текущему
+  CMD → эффективная конфигурация 1:1 (AC-2; TC-06 сверяет резолв по значениям).
+
+**C1 (`useradd`):** `ARG APP_UID=1000 / APP_GID=1000 / APP_USER=slin / APP_HOME=/home/slin` в
+`Dockerfile`; compose `build.args` обоих сервисов прокидывают их из тех же env, что и рантайм:
+`APP_UID: ${ORCH_RUN_UID:-1000}`, `APP_GID: ${ORCH_RUN_GID:-1000}`,
+`APP_HOME: ${ORCH_AGENT_HOME_DIR:-/home/slin}` → uid/gid/HOME двигаются **одной согласованной
+группой** (инвариант ORCH-040, FR-3). `APP_USER` — косметика passwd-записи (важен факт записи для
+`getpwuid`/ssh, ORCH-058 Dockerfile:38, не имя), дефолт `slin`.
+
+Привязка: FR-1 C1–C2, §3.4 А-3, AC-6, TC-07.
+
+### D6 — Карта compose-интерполяции (реестр B) и согласованная группа ORCH-040
+
+Полная карта переменных `docker-compose.yml` (дефолты = текущим значениям; все три сервиса):
+
+| Переменная | Дефолт | Закрывает |
+|---|---|---|
+| `ORCH_HOST_REPOS_DIR` *(реюз)* | `/home/slin/repos` | B1 volumes ×3 (`:/repos`, у watchdog `:ro`) + environment ×2 (`ORCH_HOST_REPOS_DIR=` прокидывается тем же значением) |
+| `ORCH_HOST_CLAUDE_DIR` | `/home/slin/.claude` | B1 (source маунта) |
+| `ORCH_HOST_CLAUDE_JSON` | `/home/slin/.claude.json` | B1 (source, `:ro`) |
+| `ORCH_HOST_SSH_DIR` | `/home/slin/.orchestrator-ssh` | B1 (source, `:ro`) |
+| `ORCH_AGENT_HOME_DIR` *(= Settings-ключ D2)* | `/home/slin` | **таргеты** маунтов `.claude`/`.claude.json`/`.ssh` (`…:${ORCH_AGENT_HOME_DIR:-/home/slin}/.claude` и т.д.) + `build.args APP_HOME` |
+| `ORCH_HOST_CLAUDE_CODE_DIR` | `/usr/lib/node_modules/@anthropic-ai/claude-code` | B2 (`:/opt/claude-code:ro`) |
+| `ORCH_HOST_NODE_BIN` | `/usr/bin/node` | B2 (`:/usr/bin/node:ro`) |
+| `ORCH_DOCKER_GID` | `999` | B3 `group_add` ×3 — **«МИНА 1» НЕ удаляется**, меняется только литерал на `${ORCH_DOCKER_GID:-999}` |
+| `ORCH_RUN_UID` / `ORCH_RUN_GID` | `1000` / `1000` | B4 `user:` ×2 + `build.args APP_UID/APP_GID` |
+| `ORCH_DEPLOY_SSH_USER` *(реюз)* | `slin` | B5: `ORCH_DEPLOY_SSH_USER=`, `DEPLOY_SSH_USER=` (legacy enduro — то же значение через `${ORCH_DEPLOY_SSH_USER:-slin}`) |
+| `ORCH_DEPLOY_HOST_REPO_PATH` *(реюз)* | `/home/slin/repos/orchestrator` | B5 environment |
+| `DEPLOY_HOOK_SCRIPT` *(legacy)* | `/home/slin/bin/enduro-deploy-hook.sh` | B5 ×2 (`${DEPLOY_HOOK_SCRIPT:-…}`) |
+| `ORCH_STAGING_PORT` *(= Settings-ключ D4)* | `8501` | B6 `command:` staging |
+| `ORCH_DEPLOY_PROD_TARGET_PORT` *(реюз)* | `8500` | `command:` prod (D5) |
+
+Не параметризуются (зафиксировано): контейнерные пути (`/app/data`, `/repos`, `/opt/claude-code`,
+`/var/run/docker.sock`) — конвенция layout'а контейнера, не хост-специфика;
+`DEPLOY_SSH_HOST/ORCH_DEPLOY_SSH_HOST=127.0.0.1` — loopback при `network_mode: host`, валиден на
+любом single-host; имена сервисов/контейнеров/образов — платформенные константы (D3/D4; для образов
+истина уже в конфиге: `deploy_prod_source_image`/`deploy_prod_target_image`); `network_mode: host`,
+`init: true`, профиль `staging` — архитектурные решения, не значения.
+
+Группа ORCH-040 после изменения: `ORCH_RUN_UID/GID` + `ORCH_AGENT_HOME_DIR` + source-переменные
+маунтов меняются согласованно; при дефолтах резолв эквивалентен текущему файлу (TC-06).
+
+### D7 — Deploy-hook: env-override `REPO` + явная передача от инвокеров
+
+1. `scripts/orchestrator-deploy-hook.sh:38`: `REPO=/home/slin/repos/orchestrator` →
+   `REPO="${REPO:-/home/slin/repos/orchestrator}"` (паттерн остальных переменных хука; D1 реестра).
+2. **Оба инвокера передают `REPO` явно** (иначе на новом хосте env-override мёртв — сейчас хук
+   безусловно перезаписывает значение): `self_deploy.build_deploy_command` (prod env-прefix) и
+   `image_freshness` (`env_assignments`, строки ~268–275) добавляют
+   `REPO={shlex.quote(settings.deploy_host_repo_path)}` — тот же источник, которым инвокеры уже
+   делают `cd` (`image_freshness.py:277`). Конфиг становится единственной истиной на wired-пути;
+   дефолт хука сохраняет ручные операторские запуски на текущем хосте.
+
+**Инварианты не тронуты:** exit-code контракт хука (0/1/2, ORCH-036), шаги `--deploy`/`--rollback`/
+`--build-staging`, provenance-guard `EXPECTED_REVISION` (ORCH-058 Strategy B) — добавляется ровно
+одно env-присваивание в префикс команды. Привязка: FR-1 D1, AC-6, TC-08.
+
+### D8 — Вопрос А-4 (секреты): отдельный stdlib-скрипт `scripts/gen_secrets.py`
+
+**Форма: новый самостоятельный скрипт** (НЕ режим `onboard_project.py`: онбординг подключает проект
+к **живой** платформе, генерация секретов — provisioning **нового хоста**; это разные жизненные
+циклы и разные операторы, смешение связало бы независимые сценарии и раздуло CLI ORCH-009).
+
+Контракт (BR-3 / FR-4 / NFR-3 / AC-5, TC-09):
+
+- **stdlib-only** (`secrets`, `argparse`); генерирует `ORCH_PLANE_WEBHOOK_SECRET`,
+  `ORCH_GITEA_WEBHOOK_SECRET` через `secrets.token_hex(32)` (32 байта энтропии, 64 hex-символа;
+  повторный запуск — другие значения).
+- **Режим по умолчанию — печать в stdout** (`.env`-фрагмент: сгенерированные webhook-секреты +
+  плейсхолдеры внешних токенов + указатель на чек-лист); файлы не трогаются.
+- `--write [PATH=.env]`: **существующий файл → отказ с exit≠0 и внятным сообщением**; перезапись —
+  только явный `--force` (AC-5 «отказ/явное подтверждение»). Никогда не перезаписывает молча.
+- Состав ключей вывода согласован с `.env.example` (TC-09 сверяет программно).
+- **Инвентаризация секретов** (фиксация аудита FR-4.1): генерируемые локально —
+  `ORCH_PLANE_WEBHOOK_SECRET`, `ORCH_GITEA_WEBHOOK_SECRET`; выпускаемые внешними системами (только
+  чек-лист REPLICATION.md: где выпустить → куда вписать → как проверить) — `ORCH_PLANE_API_TOKEN`,
+  `ORCH_PLANE_BOT_*` (7, опциональны — fallback на API-токен), `ORCH_GITEA_TOKEN`,
+  `ORCH_TELEGRAM_BOT_TOKEN` (+несекретный `ORCH_TELEGRAM_CHAT_ID`), sidecar
+  `WATCHDOG_TG_BOT_TOKEN`/`WATCHDOG_TG_CHAT_ID` (ORCH-100, независимый канал). Нормативная строка:
+  **«боевые секреты текущего хоста не копируются ни на одном шаге»**.
+- `.env.example` дополняется до 100% обязательных ключей старта (включая новые D2/D4/D6);
+  секретные значения — только плейсхолдеры; `.env.staging.example` согласуется.
+
+### D9 — Вопрос А-4 (smoke): чистый runbook без нового скрипта
+
+**Форма: документированная процедура** `docs/operations/REPLICATION.md` (имя из ТЗ принято),
+собранная из **существующих кирпичей** — нового smoke-скрипта **не вводим**: каждый шаг уже имеет
+машинную команду с однозначным исходом; обвязка добавила бы поверхность сопровождения и LLM/сетевые
+зависимости без новой гарантии (AC-3 допускает «и/или скрипт»; TC-10 — «если введён»).
+
+Скелет процедуры (developer материализует; каждый шаг — явные PASS/FAIL):
+
+| Шаг | Команда/кирпич | PASS |
+|---|---|---|
+| 0. Конфиг резолвится | `docker compose config` | резолв без ошибок/未-переменных |
+| 1. Инстанс жив | `curl -fsS http://127.0.0.1:<port>/health` | HTTP 200 |
+| 2. Контракты отвечают | `GET /queue`, `GET /metrics` | JSON, штатные блоки, `schema_version: 1` |
+| 3. Тестовый проект | `scripts/onboard_project.py plan` → `apply` → `verify` (sandbox) | `verify` зелёный |
+| 4. Тестовая задача | создать issue в Plane → статус «To Analyse» | задача в БД, analyst-job в `GET /queue` |
+| 5. **Минимальный сигнал «конвейер доехал»** | дождаться окончания `analysis` | артефакты `01–04` в ветке задачи (`git ls-tree origin/<branch> docs/work-items/<id>/`) |
+| 6. Расширенный режим (опционально) | Approved → … → Confirm Deploy | задача дошла до `done` |
+
+Итог — однозначный вердикт PASS/FAIL; при FAIL — что собрать (логи контейнера, снапшот `/queue`).
+Stateless: ни один шаг не предполагает перенос данных/БД/секретов с боевого хоста.
+**Приёмка воспроизводимости (AC-3):** один прогон на текущей инфре — staging-песочница 8501 +
+sandbox-проект (исполняет tester, фиксация в `13-test-report.md`/`15-staging-log.md`).
+Границы «10-common vs Lite vs Bundled» — отдельный раздел REPLICATION.md (анти-скоуп-крип Р-5).
+
+### D10 — Анти-регресс сканер: механика исключений (NFR-5)
+
+`tests/test_no_host_hardcodes.py` (образец — `tests/test_agent_prompts_canon.py`):
+
+- **Список запрещённых литералов централизован в тесте:**
+  `FORBIDDEN = ("82.22.50.71", "/home/slin", "mva154", "duckdns")` — единственная точка правки.
+- **Зона скана:** `src/**/*.py` + `watchdog/**/*.py`. Вне зоны: `tests/**`, `docs/**`, `scripts/**`
+  (deploy-hook несёт легитимный shell-default D7), `.env*`.
+- **Структурное исключение — `src/config.py` и `watchdog/config.py` целиком:** это канонические
+  места дефолтов (BR-1), и их дефолты **обязаны** нести боевые значения (BR-5: `/home/slin`,
+  `mva154.local`) — сканировать их значило бы держать вечно непустой allowlist. Исключение —
+  правило теста с комментарием-обоснованием, не allowlist-запись.
+- **Исключение комментариев/докстрингов** — через `tokenize` (надёжнее построчных regex: судит
+  токены `COMMENT`/`STRING`-докстринги, а не текст; детерминирован — NFR-5).
+- **Allowlist-механизм** (`{(file, literal): "обоснование"}`) существует и **пуст на сдаче**
+  (после D2/D7 код-блокеров не остаётся; `fs_normalize.healing_command` except-ветка
+  (`/repos/_wt`, `1000:1000`) запрещённых литералов **не содержит** и остаётся как never-raise
+  floor — главный путь уже строит подсказку из settings, отдельной правки A7 не требуется).
+- **Негативная самопроверка (TC-02):** сканер прогоняется по синтетическому фрагменту с
+  подсаженным литералом и обязан его поймать (тест не вечно-зелёный).
+
+### Что НЕ меняется (граница решения)
+
+- `STAGE_TRANSITIONS`, состав `QG_CHECKS`, семантика `check_*`, machine-verdict ключи, схема БД —
+  байт-в-байт (NFR-6); новые тесты входят в существующие гейты (`check_ci_green`/merge-gate re-test)
+  автоматически.
+- Значения существующих дефолтов реестра E (`02-trz.md` §3.1) — не меняются (BR-5).
+- A8 (`disk_watchdog` fallback `["/repos","/app/data"]`) — config-backed зеркало, остаётся как есть
+  (синхронность с конфиг-дефолтом фиксирует существующий тест-ландшафт; вводить «одну точку истины»
+  ради неблокера — лишний диф).
+- A9 (`projects._DEFAULT_PROJECTS`) — документированный fallback, не трогаем; чек-лист REPLICATION.md
+  обязывает `ORCH_PROJECTS_JSON` на новом хосте.
+- A10 (`watchdog/config.py` `metrics_url` 127.0.0.1:8500) — уже env-driven; при смене прод-порта
+  оператор задаёт `WATCHDOG_METRICS_URL` (строка чек-листа о когерентности портов:
+  `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL`).
+- `onboarding/` (ORCH-009) — не форкается; новые env-ключи отражаются в его `.env.example`-скелете
+  только при фактическом расхождении.
+
+## Альтернативы
+
+- **`ORCH_SELF_HOSTING_REPO` как конфиг-ключ** — отвергнуто: превращает опечатку оператора в
+  активацию деплой-машинерии на чужом репо или тихое выключение всех self-гейтов (D3); конвенция
+  бесплатна при stateless-тираже.
+- **`_STAGING_PORT` оставить константой** — отвергнуто: реестр B6 (AC-6) требует параметризации
+  порта в compose `command:`; константа в `image_freshness` при конфигурируемом compose-порте даёт
+  рассинхрон (rebuild целится в 8501, staging слушает иное) — хуже управляемой пары
+  «ключ + fail-closed guard» (D4).
+- **Тихий fallback guard'а на 8501 при misconfig** — отвергнуто: молчаливая подмена таргета —
+  ровно тот класс отказа, против которого ORCH-058 строился; отказ громче и честнее.
+- **Shell-form CMD / `ENV PORT` в Dockerfile** — отвергнуто: меняет PID-1/сигнальную семантику
+  выверенной пары `init: true` + exec-form (B-2) ради порта, который уже параметризуем на слое
+  compose (D5).
+- **Генератор секретов как режим `onboard_project.py`** — отвергнуто: разные жизненные циклы
+  (онбординг проекта на живой платформе vs provisioning хоста), связывание независимых
+  операторских сценариев (D8).
+- **Отдельный smoke-скрипт-обвязка** — отвергнуто (сейчас): каждый шаг runbook уже машинно
+  проверяем существующими кирпичами; скрипт = новая поверхность сопровождения без новой гарантии.
+  Дверь открыта: Lite/Bundled-задачи могут ввести обвязку поверх того же runbook (D9).
+- **Allowlist-записи для `config.py` вместо структурного исключения** — отвергнуто: allowlist
+  обязан быть пуст (AC-1/AC-7); вечные записи о легитимных дефолтах девальвируют его сигнал (D10).
+
+## Последствия
+
+- **+** Платформа разворачивается на новой инфре только env/конфигом: четыре код-блокера закрыты
+  тремя ключами + реюзом существующих; инфра-файлы интерполируются; секреты выпускаются заново;
+  smoke даёт явный PASS/FAIL. Критический путь эпика ORCH-10 разблокирован.
+- **+** Инвариант ORCH-058 усилен: анти-prod-гарантия freshness-пути теперь исполняемый guard,
+  а не подразумеваемая константа.
+- **+** Возврат хардкода ломает CI структурно (сканер), а не ловится ревью.
+- **−** Поверхность конфигурации растёт (~13 новых env-имён). Митигейшн: дефолты = боевым
+  значениям (ничего настраивать на текущем хосте не нужно), карта env в INFRA.md/REPLICATION.md,
+  TC-06/TC-08 сверяют полноту и резолв.
+- **−** Правка двух safety-critical билдеров команд (D7) и compose-файла прод-сервиса (D5).
+  Митигейшн: изменения чисто аддитивные (одно env-присваивание; `command:` = текущему CMD),
+  exit-контракт хука не тронут, полный регресс + staging-гейт 8501 перед прод-деплоем (NFR-1).
+- **−** Compose-интерполяция читает `.env`/shell, а не `env_file` — возможна операторская путаница
+  на staging. Митигейшн: правило явно зафиксировано (D1) и попадает в REPLICATION.md.
+- **Откат:** не задавать новые переменные (дефолты = прежнее поведение — kill-switch-природа,
+  NFR-2); полный откат — revert PR (изменение конфигурационное, без миграций состояния).
+
+## Ссылки
+
+- BRD: `docs/work-items/ORCH-101/01-brd.md`
+- TRZ: `docs/work-items/ORCH-101/02-trz.md` (нормативный реестр §3.1, вопросы §3.4 А-1…А-5)
+- Acceptance: `docs/work-items/ORCH-101/03-acceptance-criteria.md` (AC-1…AC-8)
+- Test plan: `docs/work-items/ORCH-101/04-test-plan.yaml` (TC-01…TC-12)
+- Сквозной ADR: `docs/architecture/adr/adr-0036-replication-foundation-host-parametrization.md`
+- Инварианты соседей: `docs/architecture/adr/adr-0005-container-runs-as-host-uid.md` (ORCH-040),
+  `adr-0008-staging-image-provenance.md` (ORCH-058), `adr-0007-executable-self-deploy.md` (ORCH-036),
+  `adr-0035-turnkey-project-onboarding.md` (ORCH-009)
+- Сверено по коду: `src/plane_sync.py:1064`, `src/agents/launcher.py:592–599,823–831`,
+  `src/self_deploy.py:330–337`, `src/post_deploy.py:573–580`, `src/image_freshness.py:60–62,263–280`,
+  `src/qg/checks.py:517`, `src/fs_normalize.py:529–540`, `src/config.py:33–49,193–209`,
+  `docker-compose.yml`, `Dockerfile`, `scripts/orchestrator-deploy-hook.sh:38`

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

@@ -0,0 +1,80 @@
+---
+work_item: ORCH-101
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 07 — Инфра-требования: ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: architecture
+
+> Топология НЕ меняется (контейнеры/порты/сеть/тома — те же при дефолтах); меняется
+> **параметризуемость** инфра-файлов. Раздел фиксирует карту переменных и правила раската.
+
+## I-1. Топология / окружения
+
+- **Без изменений при дефолтах:** те же 3 сервиса (`orchestrator` 8500, `orchestrator-watchdog`,
+  `orchestrator-staging` 8501 под профилем `staging`), `network_mode: host`, те же тома и
+  `group_add` docker-gid («МИНА 1» ORCH-040 — сохраняется, литерал → `${ORCH_DOCKER_GID:-999}`).
+- `docker-compose.yml` переводится на интерполяцию `${VAR:-default}` (реестр ТЗ §3.1 B; карта —
+  ADR-001 D6); `Dockerfile` получает `ARG APP_UID/APP_GID/APP_USER/APP_HOME` (D5); оба сервиса
+  получают явный `command:` с портом из env (`${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}` /
+  `${ORCH_STAGING_PORT:-8501}`) — дефолтный резолв эквивалентен текущей конфигурации (AC-2/TC-06).
+- **Источник интерполяции** — `.env` проекта / shell-окружение (НЕ `env_file` сервиса):
+  интерполяционные значения тиража живут в `.env` (ADR-001 D1; попадает в REPLICATION.md).
+- Имена сервисов/контейнеров/образов, профиль `staging`, `network_mode: host`, контейнерные пути
+  (`/app/data`, `/repos`, `/opt/claude-code`) — платформенные константы (ADR-001 D3/D4/D6).
+
+## I-2. Переменные окружения / секреты
+
+**Новые `Settings`-ключи** (дефолт = боевому значению; см. ADR-001 D2/D4):
+
+| env | Дефолт | Назначение |
+|---|---|---|
+| `ORCH_AGENT_HOME_DIR` | `/home/slin` | HOME акторских процессов (launcher ×2 / self-deploy / post-deploy) + таргеты маунтов + `APP_HOME` |
+| `ORCH_AGENT_GIT_NAME` | `claude-bot` | git-имя агентских коммитов |
+| `ORCH_GIT_EMAIL_DOMAIN` | `mva154.local` | домен git-email всех акторов (`<actor>@<domain>`) |
+| `ORCH_STAGING_PORT` | `8501` | порт staging: `image_freshness` (c guard'ом ≠ прод-порт) + compose `command:` |
+
+**Новые compose-only переменные:** `ORCH_HOST_CLAUDE_DIR`, `ORCH_HOST_CLAUDE_JSON`,
+`ORCH_HOST_SSH_DIR`, `ORCH_HOST_CLAUDE_CODE_DIR`, `ORCH_HOST_NODE_BIN`, `ORCH_DOCKER_GID`,
+`ORCH_RUN_UID`, `ORCH_RUN_GID` (дефолты — текущие значения; полная карта — ADR-001 D6).
+**Реюз существующих имён:** `ORCH_HOST_REPOS_DIR`, `ORCH_DEPLOY_SSH_USER`,
+`ORCH_DEPLOY_HOST_REPO_PATH`, `ORCH_DEPLOY_PROD_TARGET_PORT`, legacy `DEPLOY_HOOK_SCRIPT`.
+**Deploy-hook:** `REPO="${REPO:-/home/slin/repos/orchestrator}"` + явная передача `REPO=` обоими
+инвокерами (ADR-001 D7).
+
+**Секреты (BR-3 / AC-5):** новый stdlib-скрипт `scripts/gen_secrets.py` — криптослучайные
+`ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET` (`secrets.token_hex(32)`), печать по
+умолчанию, `--write` с отказом при существующем `.env` (перезапись только `--force`). Внешние
+токены (`ORCH_PLANE_API_TOKEN`, `ORCH_PLANE_BOT_*`, `ORCH_GITEA_TOKEN`, `ORCH_TELEGRAM_BOT_TOKEN`,
+`WATCHDOG_TG_*`) — по чек-листу REPLICATION.md (где выпустить → куда вписать → как проверить).
+Боевые секреты текущего хоста не покидают его (NFR-3); в гит — только шаблоны/плейсхолдеры
+(правило агентов №8); `.env.example` доводится до 100% обязательных ключей, `.env.staging.example`
+согласуется.
+
+**Карта env в `docs/operations/INFRA.md`** дополняется всеми новыми ключами; deployment-раздел —
+новый `docs/operations/REPLICATION.md` (FR-7). Чек-лист тиража обязывает: `ORCH_PROJECTS_JSON`
+(fallback-реестр UUID'ов чужого Plane не сматчится), когерентность портов
+`ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL`.
+
+## I-3. Деплой / рестарт
+
+- **Рестарт прод-контейнера в рамках задачи — НЕ требуется и запрещён** (NFR-1, self-hosting):
+  правки `docker-compose.yml`/`Dockerfile`/хука инертны до следующего штатного деплоя через
+  конвейер (staging 8501 → ручной `Confirm Deploy`, ORCH-059).
+- На текущем хосте ничего донастраивать не нужно: все дефолты = боевым значениям; пустой/
+  неизменённый `.env` → поведение 1:1 (BR-5). Откат = не задавать переменные (NFR-2).
+- Инвариант ORCH-058 сохранён и усилен: freshness-путь fail-closed отказывает при
+  `ORCH_STAGING_PORT == прод-порт` (ADR-001 D4); INV-4 не затрагивается.
+
+## I-4. CI/CD
+
+- `.gitea/workflows/` — **без изменений**. Новые тесты (`test_no_host_hardcodes.py`,
+  `test_host_config_keys.py`, `test_infra_parametrization.py`, `test_secrets_gen.py`,
+  `test_replication_smoke.py`) попадают в существующие гейты (`check_ci_green`/
+  `check_tests_passed`/merge-gate re-test) автоматически — новых QG не вводится (NFR-6).
+- Новых pip/системных зависимостей нет (генератор секретов — stdlib).

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

@@ -0,0 +1,32 @@
+---
+work_item: ORCH-101
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 08 — Требования к данным: ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: architecture
+
+> When-applicable / информационный. Задача конфигурационная — данные и схема БД не затрагиваются;
+> файл создан для аудитопригодности с явными `N/A`.
+
+## Изменения схемы БД
+
+`N/A` — таблицы/индексы/миграции не добавляются и не меняются; `init_db()` не трогается (NFR-6,
+ТЗ §5). Тираж stateless (решение Славы 10.06): перенос данных/БД с боевого хоста не предполагается
+ни одним шагом (smoke-процедура это явно проверяет — AC-3).
+
+## Новые/изменённые сущности
+
+Нет. Новые конфиг-ключи (`agent_home_dir`, `agent_git_name`, `git_email_domain`, `staging_port`) —
+слой `Settings` (env), не данные.
+
+## Совместимость данных / миграции
+
+`N/A` — общая прод-БД (self-hosting, enduro-trails) не затрагивается; `ORCH_DB_PATH` и layout
+`/app/data` остаются прежними (контейнерные пути — платформенная конвенция, ADR-001 D6). На новом
+хосте БД создаётся с нуля штатным `init_db()`.

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

@@ -0,0 +1,38 @@
+---
+work_item: ORCH-101
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 10 — Технические риски: ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke
+
+Work Item: **ORCH-101** · Repo: **orchestrator** · Стадия: architecture
+
+> Информационный (гейтом не парсится). Детализация рисков Р-1…Р-5 BRD §8 в привязке к решениям
+> ADR-001 (D1…D10).
+
+## Реестр рисков
+
+| ID | Риск | Вер. | Влия. | Митигейшн |
+|----|------|------|-------|-----------|
+| TR-1 | **Регресс горячих путей при параметризации env-словарей акторов** (launcher ×2 / self-deploy / post-deploy): опечатка в ключе/дефолте ломает git-коммиты или credentials-резолв claude CLI (HOME) у ВСЕХ проектов общего инстанса (Р-1 BRD) | Низ. | Выс. | Дефолты байт-в-байт = боевым (`/home/slin`, `claude-bot@mva154.local` — BR-5); TC-04/TC-05 фиксируют итоговые словари при дефолтах И при переопределении; полный регресс TC-12; staging-гейт 8501 перед прод-выкатом (NFR-1) |
+| TR-2 | **Ослабление инварианта ORCH-058 при конфигуризации staging-порта** (`ORCH_STAGING_PORT=8500` нацеливает rebuild/recreate на прод; Р-2 BRD) | Низ. | Выс. | Fail-closed guard ДО любого ssh/build: `staging_port == deploy_prod_target_port` → отказ + алерт, без тихого fallback (ADR-001 D4); explicit-pass `TARGET_PORT=` хуку сохранён; TC-11 проверяет guard |
+| TR-3 | **Флап анти-регресс сканера** (ложные срабатывания на комментарии/докстринги или вечно-непустой allowlist из-за дефолтов config.py; Р-3 BRD) | Сред. | Низ. | `tokenize`-исключение комментариев/докстрингов (не regex); структурное исключение `src/config.py`+`watchdog/config.py` как канонических мест дефолтов (BR-1); негативная самопроверка TC-02; список литералов централизован (ADR-001 D10) |
+| TR-4 | **Неполный аудит**: пропущенный хардкод всплывает на первом реальном тираже (Р-4 BRD) | Сред. | Сред. | Реестр §3.1 нормативен и перепроверен на стадии architecture повторным grep'ом (код-блокеры = ровно A1–A4, см. ADR-001 «Контекст»); сканер CI держит классы литералов навсегда; smoke-процедура (D9) — последняя линия обнаружения на целевой инфре |
+| TR-5 | **Правка safety-critical билдеров команд деплоя** (D7: `build_deploy_command` / `image_freshness` env-prefix; D5: `command:` прод-сервиса compose) — ошибка ломает self-deploy/rollback | Низ. | Выс. | Изменения строго аддитивные: одно env-присваивание `REPO=` (exit-контракт хука 0/1/2 не тронут, ORCH-036 прочитан); `command:` прод = байт-в-байт текущему CMD при дефолтах (TC-06); существующие self-deploy/freshness тесты + staging-прогон |
+| TR-6 | **Путаница источников env**: compose-интерполяция читает `.env`/shell, а не `env_file` (`.env.staging` НЕ влияет на `${VAR}`) → оператор тиража задаёт переменную «не туда» | Сред. | Низ. | Правило явно зафиксировано (ADR-001 D1) и входит в REPLICATION.md; дефолты делают ошибку безопасной (резолв в боевые значения, не в мусор); TC-06 проверяет дефолт-резолв |
+| TR-7 | **Рассинхрон группы ORCH-040** (uid/gid/HOME/маунты/`useradd`) при частичном переопределении (например, сменили `ORCH_AGENT_HOME_DIR`, забыли пересобрать образ с `APP_HOME`) | Низ. | Сред. | Группа управляется одними env-именами насквозь (compose `build.args` ← те же `ORCH_RUN_UID/GID`/`ORCH_AGENT_HOME_DIR`, ADR-001 D5/D6); «МИНА 1» `group_add` сохранена; согласованная группа описана в REPLICATION.md как «менять вместе»; TC-06/TC-07 |
+| TR-8 | **Слабые/затёртые секреты**: детерминированная генерация или молчаливая перезапись `.env` уничтожает работающий комплект | Низ. | Выс. | `secrets.token_hex(32)` (криптослучайно, 32 байта); отказ при существующем файле, перезапись только явным `--force` (NFR-3, ADR-001 D8); TC-09 проверяет различие повторных запусков и отказ |
+
+## Сводный вывод
+
+Доминирующий класс — **регресс общего прод-инстанса через горячие пути** (TR-1/TR-2/TR-5):
+вероятность низкая (kill-switch-природа дефолтов: на текущем хосте без новых env поведение 1:1),
+влияние высокое (self-hosting, общая БД с enduro-trails) → ключевая страховка — полный регресс +
+обязательный staging-гейт 8501 + ручной `Confirm Deploy` (прод-контейнер в рамках задачи не
+рестартуется, NFR-1). Эскалация `arch:major-change` **не требуется**: ни новой стадии, ни нового
+компонента, ни смены БД — конвейер и QG байт-в-байт (NFR-6); возврат в анализ не нужен (ТЗ
+выполнимо без нарушения принципов). Остаточный риск для прод-конвейера — **низкий**.

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

@@ -0,0 +1,118 @@
+---
+verdict: APPROVED
+work_item: ORCH-101
+stage: review
+author_agent: reviewer
+status: approved
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+type: review
+work_item_id: ORCH-101
+version: 1
+---
+
+# Review ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke (фундамент тиража)
+
+## Summary
+
+PR (`feature/ORCH-101-orch-10-common-smoke`, commit `f1635dd`) реализует фундамент тиража
+ровно по ТЗ (`02-trz.md`) и ADR (`06-adr/ADR-001`, D1–D10): нормативный реестр хардкодов §3.1
+закрыт полностью, секреты нового хоста выпускаются `scripts/gen_secrets.py`, smoke-процедура —
+runbook `docs/operations/REPLICATION.md` с явными PASS/FAIL. Полный `pytest tests/ -q` зелёный
+(**1764 passed**), включая 6 новых/адаптированных тест-модулей. P0/P1 findings — нет;
+два косметических P3. Вердикт: **APPROVED**.
+
+### Ось 1 — Соответствие ТЗ (FR-1…FR-7, AC-1…AC-8)
+
+| AC | Статус | Проверено |
+|----|--------|-----------|
+| AC-1 ноль хардкодов в `src/**` | ✅ | A1 `plane_sync.notify_stage_change` → `gitea_public_url or gitea_url` + `gitea_owner` (семантика существующих потребителей, литералы `git.mva154.duckdns.org`/`/admin/` удалены); A2 — единый `launcher.agent_git_env()` для ОБОИХ мест (Popen агента + post-run git); A3/A4 — `self_deploy`/`post_deploy` читают `agent_home_dir`/`git_email_domain`, платформенные имена `deploy-finalizer`/`post-deploy-monitor` сохранены (D2); A5 → ключ `staging_port` + guard (D4); A6 → платформенная константа c обоснованием в ADR D3 и пин-тестом (`test_self_hosting_repo_is_platform_constant` фиксирует и значение, и ОТСУТСТВИЕ конфиг-ключа); A7 — основной путь уже config-backed, except-ветка запрещённых литералов не содержит (ADR D10). Контрольный grep: остаточные `mva154`/`/home/slin` в `src/**`/`watchdog/**` — только комментарии/докстринги. Сканер существует, allowlist пуст, зелёный |
+| AC-2 zero-regression | ✅ | дефолты новых ключей = боевым (`test_new_settings_defaults_equal_previous_production_values`, судит по `Settings.model_fields` — иммунно к ambient env); реестр E не тронут (там же); резолв compose при пустом env = боевым значениям (TC-06, `EXPECTED_DEFAULTS` — единая нормативная карта); `pytest tests/ -q` → 1764 passed; `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/verdict-ключи/схема БД дифф не трогает |
+| AC-3 smoke-процедура | ✅* | `REPLICATION.md` §4: 7 шагов, каждый с явными PASS/FAIL, однозначный итоговый вердикт; stateless (§5); кирпичи существующие (D9, скрипт-обвязка сознательно не вводилась). *Прогон воспроизводимости — стадия `testing` (см. «Передача тестеру») |
+| AC-4 доки + CHANGELOG | ✅ | см. раздел «Документация» ниже |
+| AC-5 секреты | ✅ | `secrets.token_hex(32)` = 64 hex (тест `test_secret_is_cryptorandom_64_hex` + неравенство повторных запусков); `--write` через `open(path, "x")` — атомарный отказ exit=2 на существующем файле, перезапись только `--force` (NFR-3, покрыто тестами); чек-лист внешних токенов §3.2 (где выпустить → куда вписать → как проверить) + норматив «боевые секреты не копируются»; `.env.example` дополнен (полнота сверяется `test_env_example_contains_*` и `test_output_keys_consistent_with_env_example`); реальных секретов в гите нет (плейсхолдеры пустые, анти-тест `test_no_real_secret_committed_anywhere_near`) |
+| AC-6 инфра-файлы | ✅ | реестр B1–B6/C1–C2/D1 закрыт: compose — полная интерполяция `${VAR:-default}` (карта D6 1:1); Dockerfile — `ARG APP_UID/GID/USER/HOME`, CMD exec-form 8500 сознательно сохранён (D5, PID-1/сигнальная семантика); hook — `REPO="${REPO:-…}"` + ОБА инвокера передают `REPO=` явно (D7, иначе override был бы мёртв — закрыто `test_rebuild_staging_passes_configured_port_and_repo`/`test_build_deploy_command_passes_repo_explicitly`) |
+| AC-7 анти-регресс | ✅ | `test_no_host_hardcodes.py`: централизованный `FORBIDDEN`, `tokenize`-исключение комментариев/докстрингов (NFR-5, детерминирован), структурное исключение config-модулей по ADR D10 (не allowlist-запись), allowlist пуст + тест на пустоту, негативные самопроверки ×4 (plain/env-dict/f-string/значение при докстринге выше) + guard от пустой зоны скана (`test_scan_zone_is_nonempty`) |
+| AC-8 self-hosting / инварианты | ✅ | прод-контейнер не трогается (изменения compose/Dockerfile вступают в силу на следующем штатном деплое); ORCH-058 **усилен**: fail-closed guard `staging_port == deploy_prod_target_port` → отказ ДО любого ssh/build, без тихого fallback, + Telegram-алерт (тесты: guard срабатывает на 8500/8500 и НЕ срабатывает на дефолте 8501/8500); INV-4 не затронут; маркеры соседей сохранены (ось 2) |
+
+### Ось 2 — Соответствие ADR + трассировка (TRACEABILITY)
+
+Реализация 1:1 по D1–D10. Правки блоков с чужими маркерами сверены с их ADR:
+
+- **ORCH-040** (adr-0005): `group_add` «МИНА 1» сохранён на всех трёх сервисах (только литерал →
+  `${ORCH_DOCKER_GID:-999}`); uid/gid/HOME/маунт-таргеты двигаются одной группой env
+  (`user:` + `build.args APP_*` + таргеты `.claude`/`.ssh` — все от `ORCH_RUN_UID/GID`/
+  `ORCH_AGENT_HOME_DIR`); адаптация `test_orch040_compose.py` корректна — судит резолв дефолтов,
+  инвариант НЕ ослаблен (смена дефолта по-прежнему валит тест).
+- **ORCH-058** (adr-0008): explicit-pass дисциплина сохранена (`TARGET_PORT=` по-прежнему передаётся
+  явно, источник — валидируемый ключ); анти-prod инвариант из подразумеваемой константы стал
+  исполняемым guard'ом — усиление, не ослабление; имена сервиса/профиля остались константами.
+- **ORCH-036** (adr-0007): exit-code контракт хука 0/1/2 не тронут — в префикс добавлено ровно одно
+  env-присваивание `REPO=`; detached Phase B не изменён.
+- **INV-4**: дифф не содержит push/force-push в `main`; merge-путь не тронут.
+- Сквозной `adr-0036` заведён (кросс-каттинг по TRACEABILITY — корректно, блоки несут 3 маркера).
+
+### Ось 3 — Качество кода
+
+- `agent_git_env()` устраняет дублирование ×2 в launcher (DRY) и структурно исключает дрейф двух
+  мест; docstrings на всех новых публичных функциях (`agent_git_env`, `generate_secret`,
+  `build_fragment`, `main`).
+- Guard в `check_staging_image_fresh` размещён правильно: после дешёвых kill-switch/`applies`
+  (нулевой оверхед для неприменимых репо), ДО любого ssh/build; Telegram-алерт best-effort
+  (`try/except`, never-raise сохранён).
+- Тесты содержательные: функциональные через monkeypatch-швы (link-build без сети, guard, передача
+  `REPO=`/`TARGET_PORT=` в собранную команду), структурные пины там, где env-словарь строится inline
+  в never-raise акторе — осознанный выбор, задокументирован в докстринге модуля. Негативные
+  самопроверки исключают «вечно-зелёный» сканер. `test_deploy_hook_rollback_sim.py` переведён на
+  env-override `REPO` — симуляция теперь дополнительно доказывает работоспособность override.
+- Security: секретные значения в `.env.example` — пустые плейсхолдеры; генератор не несёт зашитых
+  hex-значений (анти-тест); `open(..., "x")` — race-safe отказ от перезаписи.
+
+### Ось 4 — Документация
+
+Полностью обновлена в том же PR, см. раздел «Документация» ниже. README «Известные ограничения»
+(ORCH-079): ни один из трёх открытых пунктов (Telegram 48h / intra-repo deps / пакетный автоном)
+задачей не закрывается — обновление витрины не требуется; таблица env README дополнена.
+
+## Findings
+
+### P0 — Blocker
+— нет.
+
+### P1 — Must fix
+— нет.
+
+### P2 — Should fix
+— нет.
+
+### P3 — Nice to have (не блокирует, на усмотрение следующих задач)
+- [ ] `src/plane_sync.py::notify_stage_change`: при пустых ОБОИХ `gitea_public_url`/`gitea_url`
+  (нештатная конфигурация) собирается некорректная Markdown-ссылка вида `(/owner/...)`. Покрыто
+  never-raise конвертом и нереально при валидном конфиге (у `gitea_url` непустой дефолт);
+  опциональный guard «пустая база → пропустить ссылку» — косметика. Правило: ТЗ FR-1/A1 требует
+  только источник из Settings — выполнено.
+- [ ] `tests/test_no_host_hardcodes.py::find_violations`: эвристика statement-position пропускает
+  любой bare-string-statement (не только докстринги) — теоретический класс ложноотрицательных
+  (литерал в строке-выражении без присваивания). Реалистичные паттерны регрессии (env-dict,
+  f-string, RHS-значение) закрыты негативными самопроверками; ужесточение — отдельной задачей при
+  желании. Правило: NFR-5/AC-7 — выполнены как сформулированы.
+
+## Документация
+
+| Артефакт | Статус |
+|----------|--------|
+| `CHANGELOG.md` | ✅ запись ORCH-101 (детальная, по слоям D1–D10) |
+| `CLAUDE.md` | ✅ новая секция «Тираж платформы: фундамент 10-common» |
+| `README.md` | ✅ таблица env (+6 строк ORCH-101) + ссылка на REPLICATION.md; «Известные ограничения» не затронуты (корректно) |
+| `docs/architecture/README.md` | ✅ секция ORCH-101 со ссылками на adr-0036/work-item ADR |
+| `docs/operations/INFRA.md` | ✅ карта env дополнена (7 строк) + норматив секретов + когерентность портов |
+| `docs/operations/REPLICATION.md` | ✅ новый runbook: границы/конвенции, карта env, секреты, smoke PASS/FAIL, stateless |
+| ADR per work-item + сквозной | ✅ `06-adr/ADR-001-…` + `adr-0036-…` (frontmatter-схема 52c корректна) |
+| `.env.example` / `.env.staging.example` | ✅ полнота ключей старта (закреплена тестами) / согласован |
+
+## Передача тестеру (не findings)
+
+- **AC-3 (воспроизводимость):** заявленный прогон smoke-процедуры на текущей инфре
+  (staging 8501 + sandbox-проект) исполняется на стадии `testing` и фиксируется в
+  `13-test-report.md`/`15-staging-log.md` — без этой фиксации AC-3 не считается закрытым.
+- Smoke `serial_gate`/`GET /queue` — штатно по канону tester-промпта.

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

@@ -0,0 +1,88 @@
+---
+result: PASS   # PASS | FAIL — машинный вердикт, UPPERCASE
+work_item: ORCH-101
+stage: testing
+author_agent: tester
+status: pass
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+type: test-report
+work_item_id: ORCH-101
+---
+
+# Test Report — ORCH-101 — ORCH-10-common: расхардкод + секреты + smoke (фундамент тиража)
+
+## Окружение
+- Python: 3.12.13
+- pytest: 8.3.3 (plugins: cov-5.0.0, anyio-4.13.0, asyncio-0.23.8)
+- Дата: 2026-06-10
+- Worktree: `/repos/_wt/orchestrator/feature_ORCH-101-orch-10-common-smoke`
+- Ветка: `feature/ORCH-101-orch-10-common-smoke` (HEAD `26fe4cd`, код задачи — `f1635dd`)
+- Прогон выполнен в worktree ветки задачи (не в общем `/repos/orchestrator`).
+- Вердикт ревью (`12-review.md`): **APPROVED**.
+
+## Smoke API (read-only)
+| Проверка | Результат |
+|----------|-----------|
+| `GET /health` | PASS — `{"status":"ok","service":"orchestrator"}` |
+| `GET /status` | PASS — активная задача ORCH-101 на стадии `testing` |
+| `GET /queue` | PASS — отдаёт полезную нагрузку |
+| Блок `serial_gate` в `/queue` (ORCH-088) | PASS — присутствует; `orchestrator.active_task = ORCH-101 (testing)`, не заморожен |
+| Блок `auto_labels` в `/queue` (ORCH-089) | PASS — присутствует (`enabled`, `autoApprove`/`autoDeploy`) |
+| `GET /metrics` | PASS — `schema_version:1`, стадия ORCH-101 видна |
+
+## Smoke-процедура тиража (AC-3 / FR-5)
+Воспроизводимость smoke-runbook подтверждена на текущей инфре (read-only, без переноса данных):
+| Шаг | Результат |
+|-----|-----------|
+| `docs/operations/REPLICATION.md` существует (runbook с PASS/FAIL) | PASS (13 КБ) |
+| `scripts/gen_secrets.py` запускается в безопасном (print) режиме | PASS — exit 0, файлы не тронуты |
+| Webhook-секреты крипто-случайны (64 hex = 32 байта) | PASS — `ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET` |
+| Внешние токены — только плейсхолдеры (пустые) | PASS |
+| Инстанс поднят и health-check зелёный (см. Smoke API) | PASS |
+
+## Результаты (покрытие TC из `04-test-plan.yaml`)
+
+| TC ID | Описание | Покрывающие тесты | Результат |
+|-------|----------|-------------------|-----------|
+| TC-01 | Анти-регресс скан: нет запрещённых литералов в исполняемом коде `src/**`+`watchdog/**` (AC-1, AC-7) | `test_no_host_hardcodes::test_no_host_hardcodes_in_executable_code`, `test_scan_zone_is_nonempty`, `test_allowlist_is_empty_at_acceptance` | PASS |
+| TC-02 | Негативная самопроверка сканера: подсаженный литерал детектируется (AC-7) | `test_scanner_catches_planted_literal_in_code`/`_in_env_dict`/`_in_fstring`, `test_scanner_ignores_comments_and_docstrings` | PASS |
+| TC-03 | `plane_sync.notify_stage_change` строит ссылки из `gitea_public_url`(fallback `gitea_url`)+`gitea_owner`; литералы удалены (AC-1/FR-1 A1) | `test_host_config_keys::test_stage_change_link_uses_public_url_and_owner`/`_falls_back_to_gitea_url`/`_hardcoded_base_removed_from_source` | PASS |
+| TC-04 | Env агент-процесса (launcher ×2): HOME+git-идентичность из settings, дефолты прежние (AC-1/AC-2/FR-1 A2) | `test_host_config_keys::test_agent_git_env_reads_settings`/`_default_identity_matches_previous_hardcode`/`_preserves_ambient_environ`/`test_both_launcher_sites_use_the_helper` | PASS |
+| TC-05 | Env `self_deploy`/`post_deploy`: HOME+идентичность из settings, литералы удалены (AC-1/AC-2/FR-1 A3–A4) | `test_host_config_keys::test_system_actor_envs_read_settings` | PASS |
+| TC-06 | Структурная проверка `docker-compose.yml`: интерполяция `${VAR:-default}`, `group_add` ×3 (ORCH-040) (AC-2/AC-6) | `test_infra_parametrization::test_compose_interpolation_defaults_match_production_values`/`_group_add_docker_gid_on_all_three_services`/`_uid_gid_home_move_as_one_group`/`_ports_parametrised`/`_container_layout_paths_stay_constant`/`_no_raw_host_paths` | PASS |
+| TC-07 | `Dockerfile`: uid/gid/username/home через `ARG`; CMD-порт по ADR (AC-2/AC-6) | `test_infra_parametrization::test_dockerfile_useradd_parametrised_via_args`/`test_dockerfile_cmd_stays_exec_form_8500` | PASS |
+| TC-08 | Полнота `.env.example`: все новые ключи, секреты — плейсхолдеры; deploy-hook `REPO` env-override (AC-5/AC-6) | `test_infra_parametrization::test_env_example_contains_all_new_keys`/`_contains_start_mandatory_keys`/`_secrets_are_placeholders_only`/`test_deploy_hook_repo_is_env_overridable` | PASS |
+| TC-09 | Генератор секретов: разные значения, ≥32 байта, не затирает `.env` молча (AC-5/FR-4/NFR-3) | `test_secrets_gen::test_secret_is_cryptorandom_64_hex`/`test_two_runs_give_different_values`/`test_write_refuses_existing_file_without_force`/`test_write_creates_new_file_and_force_overwrites`/`test_output_keys_consistent_with_env_example`/`test_default_mode_prints_and_touches_no_files`/`test_no_real_secret_committed_anywhere_near` | PASS |
+| TC-10 | Smoke-док + обвязка: `REPLICATION.md` с PASS/FAIL, INFRA.md дополнен, CHANGELOG (AC-3/AC-4/FR-5/FR-7) | `test_replication_smoke::test_replication_doc_has_smoke_procedure_with_pass_fail`/`_covers_secrets_checklist`/`_has_env_map_and_boundaries`/`_is_stateless`/`test_infra_env_map_extended`/`test_changelog_has_orch_101_entry`/`test_gen_secrets_runs_in_safe_mode` | PASS |
+| TC-11 | Инвариант ORCH-058 (A-1): `staging_port` дефолт 8501, guard «≠ прод-порт» (AC-8/FR-1 A5) | `test_host_config_keys::test_staging_port_guard_refuses_prod_port`/`test_staging_port_default_passes_guard`/`test_self_hosting_repo_is_platform_constant` | PASS |
+| TC-12 | Полный регресс `pytest tests/` зелёный на дефолтной конфигурации (AC-2/BR-5) | весь набор — **1764 passed** | PASS |
+
+Соответствие критериям `03-acceptance-criteria.md`: AC-1 (TC-01/02/03/04/05), AC-2 (TC-04/05/06/07/12),
+AC-3 (TC-10 + smoke-прогон выше), AC-4 (TC-10), AC-5 (TC-08/09), AC-6 (TC-06/07/08),
+AC-7 (TC-01/02), AC-8 (TC-11) — все покрыты и зелёные.
+
+## Вывод pytest
+```
+============================= test session starts ==============================
+platform linux -- Python 3.12.13, pytest-8.3.3, pluggy-1.6.0
+rootdir: /repos/_wt/orchestrator/feature_ORCH-101-orch-10-common-smoke
+configfile: pytest.ini
+plugins: cov-5.0.0, anyio-4.13.0, asyncio-0.23.8
+...
+================== 1764 passed, 1 warning in 72.41s (0:01:12) ==================
+```
+(единственный warning — PydanticDeprecatedSince20 в `src/config.py:8`, предсуществующий, не связан с задачей.)
+
+Целевые модули задачи (отдельный прогон):
+```
+tests/test_no_host_hardcodes.py tests/test_host_config_keys.py
+tests/test_infra_parametrization.py tests/test_secrets_gen.py tests/test_replication_smoke.py
+======================== 51 passed, 1 warning in 0.73s =========================
+```
+
+## Итог
+**PASS** — полный регресс зелёный (1764 passed), все 12 TC из `04-test-plan.yaml` выполнены и
+сопоставлены с критериями `03-acceptance-criteria.md`, smoke API read-only (включая блоки
+`serial_gate` и `auto_labels` в `/queue`) и smoke-процедура тиража (AC-3: `REPLICATION.md` +
+безопасный прогон `gen_secrets.py`) зелёные. Задача переходит на `deploy-staging`.

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

@@ -0,0 +1,12 @@
+---
+deploy_status: SUCCESS
+work_item: ORCH-101
+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-101/15-staging-log.md

@@ -0,0 +1,37 @@
+---
+staging_status: SUCCESS
+work_item: ORCH-101
+stage: deploy-staging
+author_agent: deployer
+status: success
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+timestamp: 2026-06-10T18:02:26Z
+base_url: http://localhost:8501
+---
+
+# Staging Gate Log
+
+Staging test suite completed against the live `orchestrator-staging` instance (8501),
+run inside the `orchestrator-staging` container via the canonical
+`scripts/staging_check.py --base-url http://localhost:8501 --mode stub`.
+
+**Result: 8/10 checks PASS — exit code 0 → SUCCESS.**
+
+- REAL failed: none — all real checks green.
+- SANDBOX_INFRA failed (waived, ORCH-061): C9a, C9b.
+
+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
+
+## Block detail
+
+- Block A (SMOKE): A1 /health 200, A2 /queue 200, A3 ORCH_STAGING=true — all PASS.
+- Block B (ACCESS): B4 Plane sandbox accessible, B5 Gitea push=true, B6 registry isolation
+  (sandbox present, prod ET/ORCH absent) — all PASS.
+- Block C (E2E, stub): C7 create issue PASS, C8 trigger pipeline PASS,
+  C9a/C9b waived sandbox-infra (depend on SANDBOX bot accounts being project members, not the pipeline).
+- Cleanup: Plane issue deleted (HTTP 204).
+
+Exit code 0 with infra-tolerance enabled (`staging_infra_tolerance_enabled=True`).
+Verdict mapping unchanged: trust the exit code → SUCCESS.

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

@@ -0,0 +1,7 @@
+# Business Request: ORCH-10a Lite-тираж: перенос орк+watchdog + полная инструкция донастройки окружения
+
+Work Item ID: ORCH-102
+
+## Description
+
+TBD

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

@@ -0,0 +1,211 @@
+---
+work_item: ORCH-102
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 01 — BRD: ORCH-102 — ORCH-10a Lite-тираж: перенос орк+watchdog + полная инструкция донастройки окружения
+
+Work Item: **ORCH-102** · Repo: **orchestrator** (self-hosting) · Стадия: analysis
+Заказчик: Слава · Эпик: **ORCH-10** (домен D5 «Масштаб», `docs/epics/self-evolution.md`) · Тип: **A — Lite**
+
+---
+
+## 1. Бизнес-контекст и проблема
+
+### 1.1. Цель эпика ORCH-10
+Тираж платформы — РАЗДАЧА текущей функциональности нескольким заказчикам **на тест**.
+Решения Владельца 10.06 (приняты как требования, см. §1.4): ДВА типа тиража, ОБА **stateless**
+(наши задачи/данные/секреты НЕ переносим — чистый старт):
+
+- **Тип A (Lite)** — переносим ТОЛЬКО орк+watchdog на новую инфру; окружение
+  (Plane / Gitea / LLM / Telegram) заказчик донастраивает сам **по чёткой инструкции**.
+- **Тип B (Bundled)** — весь стек одним комплектом (отдельная задача эпика, вне ORCH-102).
+
+### 1.2. Проблема, которую закрывает ORCH-102
+Фундамент **10-common (ORCH-101) уже в `main`**: все хост-значения параметризованы env
+(`docker compose config` без переменных = боевое поведение 1:1), секреты выпускаются заново
+(`scripts/gen_secrets.py`), есть smoke-процедура с PASS/FAIL (`docs/operations/REPLICATION.md` §4)
+и анти-регресс `tests/test_no_host_hardcodes.py`. **Технически** платформа разворачивается на
+чужом хосте без правки кода.
+
+**Операционно** — нет: знания размазаны по 4+ документам, каждый из которых писался для
+оператора НАШЕГО хоста, а не для заказчика на чистой инфре:
+
+| Документ | Что покрывает | Чего не хватает для Lite |
+|----------|---------------|--------------------------|
+| `docs/operations/REPLICATION.md` | карта env, секреты, smoke | явно НЕ описывает установку/подключение Plane/Gitea (анти-скоуп Р-5 ORCH-101) |
+| `docs/operations/ONBOARDING.md` | онбординг проекта (статусы/лейблы/репо/kit/реестр) | предполагает уже работающий оркестратор и наш хост |
+| `docs/operations/SETUP_WEBHOOKS.md` | формат вебхуков Plane/Gitea | примеры с боевыми URL (`mva154`), не generic |
+| `docs/operations/INFRA.md` | топология/рестарты нашего хоста | не инструкция «с нуля» |
+
+Заказчик сегодня **не может развернуть Lite без доп-вопросов** — отсутствует единый сквозной
+маршрут «голый хост → работающий конвейер». Главный продукт ORCH-102 — **ИНСТРУКЦИЯ**
+`docs/deployment/LITE_SETUP.md` (golden source в репо), закрывающая этот разрыв.
+
+### 1.3. Установленные факты (проверено по репо, не изобретать)
+- **ORCH-101 смержен** (`git log`: merge #122) — ветка задачи уже содержит фундамент: env-карта
+  §2 REPLICATION.md, `gen_secrets.py`, `.env.example` = канон 100% ключей старта (включая блок
+  `WATCHDOG_*`), smoke §4, тесты `test_no_host_hardcodes/test_infra_parametrization/test_secrets_gen/test_replication_smoke`.
+- **`docker-compose.yml` УЖЕ является compose-подмножеством Lite:** ровно три сервиса —
+  `orchestrator`, `orchestrator-watchdog`, `orchestrator-staging` (последний строго за
+  `profiles: [staging]`); сервисов Plane/Gitea в compose НЕТ. Дефолтный `docker compose up -d`
+  поднимает ровно орк+watchdog. AC-2 достижим без форка compose — нужны фиксация в доке и
+  анти-дрейф тест.
+- **Plane CE не отдаёт webhook через публичный API** — на нашем хосте webhook создан напрямую в
+  PostgreSQL / через UI (`SETUP_WEBHOOKS.md`). Инструкция Lite обязана дать заказчику оба пути
+  (UI и DB) для ЕГО инсталляции Plane.
+- **Точная модель статусов**: 22 канонических имени с группами (источник —
+  `plane_sync._PLANE_NAME_TO_KEY`; таблица — `ONBOARDING.md` §1; создаёт
+  `scripts/onboard_project.py apply`). Код-критичные fail-closed: `Confirm Deploy`, `STOP`
+  (группа `cancelled`); в терминальных группах — только Done/Cancelled/STOP.
+- **Branch protection на `main` нормативно ЗАПРЕЩЁН** (ORCH-009 ADR D10: required-approvals /
+  status-checks ломают PR-merge API merge-актора → ложные HOLD). **Pre-receive хуков в платформе
+  НЕТ** — защита держится конвенцией + скоупом токенов. Формулировка бизнес-запроса
+  «pre-receive хуки» конфликтует с этим нормативом → вопрос архитектору (ТЗ §3.8 А-1);
+  рекомендация: раздел Gitea фиксирует канон (репо+токен+webhook+«protection НЕ включать»).
+- **Гэп watchdog-конфига:** compose читает `.env.watchdog` (`required: false`), но
+  `.env.watchdog.example` в репо НЕТ (есть только `.env.example`/`.env.staging.example`);
+  ключи `WATCHDOG_*` задокументированы внутри `.env.example`. Инструкции нужен однозначный
+  рецепт настройки watchdog-бота (форма — вопрос архитектору А-4).
+- **Платформенные конвенции тиража** (REPLICATION.md §1, нормативно): репо платформы обязан
+  называться `orchestrator` (`SELF_HOSTING_REPO`); имена сервисов/профиля — константы;
+  контейнерный layout (`/app/data`, `/repos`, `/opt/claude-code`) не параметризуется.
+- **Прецедент приёмки smoke**: ORCH-101 AC-3 — воспроизводимость подтверждается прогоном на
+  текущей инфре (staging-песочница `ORCH_STAGING_PORT`=8501 + sandbox-проект), без нового железа.
+
+### 1.4. Решения Владельца (10.06) — приняты как требования
+| # | Решение |
+|---|---------|
+| D-1 | Тиражей ДВА типа: A (Lite) и B (Bundled); ORCH-102 реализует ТОЛЬКО A. |
+| D-2 | Оба типа **stateless**: наши задачи/данные/секреты не переносятся; на целевой инфре чистый старт. |
+| D-3 | Lite = перенос ТОЛЬКО орк+watchdog; окружение (Plane/Gitea/LLM/Telegram) заказчик донастраивает по инструкции. |
+| D-4 | Главный продукт задачи = **инструкция** `docs/deployment/LITE_SETUP.md` — golden source в репо. |
+| D-5 | Зависимость: ORCH-102 ← **10-common (ORCH-101)** — выполнена (смержен), блокеров нет. |
+
+---
+
+## 2. Объём (scope)
+
+### 2.1. В объёме
+- **Инструкция `docs/deployment/LITE_SETUP.md`** — полная пошаговая (каждый шаг = команда +
+  проверка), покрывающая сквозной маршрут: предусловия хоста (зависимости, uid/gid) → перенос
+  кода орк+watchdog → конфиг (`.env` с нуля + секреты) → подключение Plane (workspace/проект,
+  точная модель статусов, API-токен, webhook+HMAC) → подключение Gitea (репо, токен, webhook,
+  норматив защиты `main`) → LLM-доступ (claude CLI / ключи моделей) → Telegram (бот трекера +
+  watchdog-бот + chat-id) → запуск compose-подмножества → регистрация проекта
+  (`ORCH_PROJECTS_JSON`, `src/projects.py`) → health-чек → smoke (из 10-common) → траблшутинг.
+- **Фиксация compose-подмножества** (AC-2): документировано и защищено структурным тестом, что
+  дефолтный запуск = ровно орк+watchdog, без Plane/Gitea-контейнеров.
+- **Stateless-нормативы** в инструкции (AC-3): чистая БД, новые секреты, явный запрет переноса
+  наших задач/данных/секретов.
+- **Smoke на чистом окружении** (AC-4): воспроизводимая процедура/чек-лист (переиспользование
+  REPLICATION.md §4) + зафиксированный приёмочный прогон.
+- **Анти-дрейф тесты** структуры/полноты инструкции и compose-подмножества; полный pytest
+  зелёный; `CHANGELOG.md`; перекрёстные ссылки (REPLICATION.md §1 границы, README — по объёму).
+
+### 2.2. Вне объёма (явно, не делать)
+- **Тип B (Bundled)** — весь стек одним комплектом: отдельная задача эпика.
+- **Установка самих Plane / Gitea / Telegram / LLM-аккаунтов** — заказчик ставит по официальной
+  документации вендоров; ORCH-102 покрывает только ПОДКЛЮЧЕНИЕ к оркестратору (анти-скоуп-крип,
+  зеркало Р-5 ORCH-101).
+- **Изменения рантайма/конвейера**: ожидаемый объём — docs+tests; `src/**` не трогается;
+  `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / machine-verdict ключи / схема БД — байт-в-байт.
+- **Перенос данных**: ни БД, ни задач, ни worktree, ни секретов (D-2).
+- **Новая автоматизация** поверх существующих CLI (`gen_secrets.py`, `onboard_project.py`):
+  новые скрипты не вводятся без решения архитектора.
+- **Коммерческая механика раздачи** (доступ заказчика к коду, лицензии, поддержка) —
+  операторский/владельческий уровень; в инструкции — параметризованный источник кода.
+- **Введение pre-receive хуков / branch protection** — запрещено действующим нормативом
+  ORCH-009 ADR D10 (см. §1.3); пересмотр только явным ADR архитектора.
+
+---
+
+## 3. Заинтересованные стороны
+- **Владелец (Слава)** — раздаёт платформу заказчикам на тест; принимает инструкцию как продукт.
+- **Заказчик-тестер (новый оператор)** — целевой читатель LITE_SETUP.md: разворачивает Lite на
+  своей инфре без доп-вопросов; технически грамотен (linux/docker), платформу видит впервые.
+- **Оператор текущего прода** — прогоняет приёмочный smoke на staging-песочнице; его прод
+  (общий для enduro-trails) не должен быть затронут.
+- **Будущая задача 10b (Bundled)** — переиспользует разделы Lite-инструкции; границы фиксируются
+  в REPLICATION.md §1.
+
+---
+
+## 4. Бизнес-требования (BR)
+
+| ID | Требование | Связь |
+|----|------------|-------|
+| BR-1 | Существует `docs/deployment/LITE_SETUP.md` — **полная пошаговая** инструкция Lite-тиража: по ней человек, не видевший платформу, разворачивает орк+watchdog и донастраивает окружение **без доп-вопросов**; **каждый шаг несёт команду и проверку** (ожидаемый результат / PASS-FAIL). | AC-1, FR-1, D-4 |
+| BR-2 | Инструкция покрывает ВСЕ системы донастройки: Plane (workspace/проект, точная модель статусов — 22 имени с группами, API-токен, webhook+HMAC с учётом ограничения Plane CE), Gitea (репо, токен с нужными scope, per-repo webhook, норматив «branch protection `main` НЕ включать»), LLM (claude CLI: дистрибутив/node/аутентификация/`ORCH_CLAUDE_BIN`/модели), Telegram (бот трекера + ОТДЕЛЬНЫЙ watchdog-бот + получение chat-id), регистрацию проекта (`ORCH_PROJECTS_JSON` через `onboard_project.py`), health-чек, smoke. | AC-1, FR-4 |
+| BR-3 | Разворачивается **compose-подмножество только орк+watchdog**: дефолтный `docker compose up -d` поднимает ровно `orchestrator`+`orchestrator-watchdog`; Plane/Gitea-контейнеров в compose нет; staging-сервис — строго за профилем. Свойство зафиксировано в доке и защищено структурным тестом. | AC-2, FR-2 |
+| BR-4 | **Stateless**: инструкция предписывает чистую БД (создаётся пустой при первом старте), выпуск НОВОГО комплекта секретов (`gen_secrets.py` + чек-лист внешних токенов), и нигде не предписывает перенос наших задач/данных/секретов; в самой доке — только плейсхолдеры, ни одного реального секрета/боевого токена. | AC-3, FR-3 |
+| BR-5 | **Smoke на чистом окружении** существует как воспроизводимая процедура/чек-лист с PASS/FAIL (переиспользование REPLICATION.md §4, без форка); приёмочный прогон выполнен на чистом контуре (минимум — staging-песочница + sandbox-проект, прецедент ORCH-101 AC-3) и зафиксирован в артефактах задачи. | AC-4, FR-5 |
+| BR-6 | **Канон не форкается**: канонические таблицы (модель статусов, карта env, формат вебхуков) инструкция даёт ссылкой на golden source (`ONBOARDING.md`/`REPLICATION.md`/`SETUP_WEBHOOKS.md`) либо с анти-дрейф тестом при неизбежном дублировании; копируемые команды инструкции — generic (плейсхолдеры вместо боевых URL/путей). | AC-1/AC-6, FR-4, NFR-4 |
+| BR-7 | Полный `pytest tests/ -q` зелёный; запись в `CHANGELOG.md`; перекрёстные доки обновлены (REPLICATION.md §1 «границы» — строка Type A → ссылка/статус; README/CLAUDE.md — по фактическому объёму, правило агентов №2/№6). | AC-5, FR-6/FR-7 |
+| BR-8 | Полнота/структура инструкции защищена **структурным pytest** (анти-дрейф, по образцу `tests/test_replication_smoke.py`): исчезновение обязательного раздела/кирпича/env-ключа из дока или дрейф compose-подмножества ломает CI. | AC-6, FR-6 |
+
+---
+
+## 5. Нефункциональные требования (NFR)
+
+| ID | Требование |
+|----|------------|
+| NFR-1 | **Self-hosting безопасность:** задача docs+tests; прод-контейнер `orchestrator` не перезапускается; прод-выкат — только штатным конвейером (staging 8501 → ручной Confirm Deploy). |
+| NFR-2 | **Нулевая регрессия:** поведение рантайма не меняется (ожидаемо ноль изменений `src/**`); `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД — байт-в-байт; существующие тесты (включая `test_no_host_hardcodes`, `test_replication_smoke`) остаются зелёными. |
+| NFR-3 | **Секрет-гигиена:** ни в инструкции, ни в тестах — ни одного реального секрета/токена/боевого webhook-секрета; только плейсхолдеры и ссылки на `gen_secrets.py`; security-гейт (ORCH-022) зелёный. |
+| NFR-4 | **Единый источник истины:** инструкция — маршрутизатор поверх канонов, не их копия; неизбежные дубли защищены анти-дрейф тестом (сверка с кодом/каноном импортом, не строкой). |
+| NFR-5 | **Поддерживаемость golden source:** LITE_SETUP.md версионируется в репо и поддерживается агентами при каждой доработке, меняющей шаги тиража (правило агентов №2 — дока в том же PR). |
+| NFR-6 | **Копируемость команд:** каждый код-блок инструкции выполняется на чистом хосте дословно после подстановки явно перечисленных плейсхолдеров (`<...>`); никаких неявных «подразумевается, что…». |
+
+---
+
+## 6. Допущения и ограничения
+- **Поддерживаемый контур** (фиксируется в предусловиях инструкции): Linux x86_64, Docker Engine +
+  Compose v2, git, python3; пользователь с правами docker; диск/память по минимальным требованиям
+  (значения уточнит архитектор/инструкция). Иные ОС/архитектуры — вне гарантии Lite.
+- **Заказчик сам ставит** Plane CE, Gitea, заводит Telegram-ботов и LLM-доступ (Claude
+  CLI-аутентификация / ключи) — по официальным докам вендоров; наша инструкция начинается с
+  «системы установлены и доступны по сети».
+- **Имя репо платформы — `orchestrator`** (норматив REPLICATION.md §1 / `SELF_HOSTING_REPO`);
+  инструкция не предлагает его менять.
+- **Источник кода** для заказчика (clone-URL/архив) — решение Владельца; в инструкции —
+  параметризованный шаг (А-6 в ТЗ).
+- «Без доп-вопросов» (AC-1) операционализируется проверяемо: (а) каждый шаг несёт
+  команду+проверку, (б) приёмочный smoke-прогон по инструкции на чистом контуре зафиксирован,
+  (в) траблшутинг покрывает типовые отказы первичной настройки.
+- Терминология бизнес-запроса «pre-receive хуки» трактуется по факту платформы (§1.3):
+  канонический механизм защиты — конвенция + скоуп токенов + запрет branch protection;
+  окончательная формулировка раздела Gitea — за архитектором (А-1).
+
+---
+
+## 7. Критерии успеха (резюме; детали — 03-acceptance-criteria.md)
+- AC-1: `docs/deployment/LITE_SETUP.md` — полная пошаговая, человек разворачивает без
+  доп-вопросов (каждый шаг — команда/проверка).
+- AC-2: compose-подмножество только орк+watchdog (без Plane/Gitea-контейнеров).
+- AC-3: stateless — чистая БД, ни одной нашей задачи/секрета.
+- AC-4: smoke на чистом окружении проходит (минимум — воспроизводимая процедура/чек-лист).
+- AC-5: pytest зелёный; CHANGELOG.
+- AC-6 (детализация): анти-дрейф тесты структуры дока/compose; канон не форкается.
+- AC-7 (детализация): self-hosting безопасность, инварианты конвейера не тронуты.
+
+---
+
+## 8. Риски (детали — 10-tech-risks.md, заполняет архитектор)
+- R-1 — **Дрейф инструкции**: платформа развивается, шаги устаревают → структурные тесты (BR-8)
+  + правило golden source (NFR-5).
+- R-2 — **Форк канона**: скопированная таблица статусов/env разъедется с кодом → ссылки/анти-дрейф
+  (BR-6, NFR-4).
+- R-3 — **Непроверяемость «без доп-вопросов»** → операционализация через §6 (команда+проверка,
+  smoke-прогон, траблшутинг).
+- R-4 — **Гетерогенность хостов заказчиков** (rootless docker, иной uid, нет node) → явный
+  поддерживаемый контур + предусловия с проверками (`getent group docker`, владение
+  `ORCH_HOST_REPOS_DIR`).
+- R-5 — **Конфликт «pre-receive» с нормативом ADR D10** → вопрос А-1 архитектору; до решения —
+  канон платформы.
+- R-6 — **Утечка секрета через примеры дока** → NFR-3, security-гейт, тест на отсутствие
+  секретоподобных значений.

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

@@ -0,0 +1,270 @@
+---
+work_item: ORCH-102
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 02 — ТЗ (TRZ): ORCH-102 — ORCH-10a Lite-тираж: перенос орк+watchdog + полная инструкция донастройки окружения
+
+Work Item: **ORCH-102** · Repo: **orchestrator** · Стадия: analysis
+
+> ТЗ описывает **что** должно измениться и **где** (документы/контракты/тесты), выведено из BRD и
+> фактического кода (аудит выполнен по репо на ветке задачи; ORCH-101 уже в `main`). **Как**
+> (точная разбивка разделов дока, форма анти-дрейф тестов, исходы вопросов §3.8) — решает
+> архитектор в `06-adr/`.
+
+---
+
+## 1. Сводка изменения
+
+**Docs-first задача** (паттерн ORCH-077/092: документы + тесты, рантайм не трогается).
+Создаётся главный продукт — инструкция `docs/deployment/LITE_SETUP.md` (golden source Lite-тиража,
+новый раздел `docs/deployment/`), которая собирает существующие кирпичи 10-common
+(REPLICATION/ONBOARDING/SETUP_WEBHOOKS/INFRA, `gen_secrets.py`, `onboard_project.py`, smoke §4)
+в один сквозной маршрут «голый хост → работающий конвейер» для заказчика. Дополнительно:
+структурные анти-дрейф тесты (полнота дока, compose-подмножество, stateless/секрет-гигиена),
+перекрёстные ссылки и CHANGELOG.
+
+Ожидаемый дифф: `docs/**`, `tests/**`, `CHANGELOG.md` (+ опционально `.env.watchdog.example` —
+исход А-4). **`src/**` — ноль изменений**; конвейер
+(`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД) — байт-в-байт.
+
+---
+
+## 2. Задействованные модули / пути
+
+| Путь | Действие |
+|------|----------|
+| `docs/deployment/LITE_SETUP.md` | **создать** — главный продукт (полная пошаговая инструкция Lite; новый каталог `docs/deployment/`) |
+| `docs/operations/REPLICATION.md` | изменить: §1 таблица границ — строка «Type A — Lite» → статус ✅ ORCH-102 + ссылка на LITE_SETUP.md |
+| `tests/test_lite_setup_doc.py` | **создать** — структурные анти-дрейф проверки дока + compose-подмножества (образец: `tests/test_replication_smoke.py`) |
+| `.env.watchdog.example` | создать **по исходу А-4** (канон конфигурации sidecar-watchdog для нового хоста; сейчас примера нет, compose читает `.env.watchdog` `required: false`) |
+| `docs/operations/INFRA.md` | изменить при необходимости: перекрёстная ссылка на deployment-раздел (по фактическому объёму) |
+| `README.md` | изменить: обзорный док — способность Lite-тиража (правило агентов №6: не выдавать открытое за решённое и наоборот) |
+| `CLAUDE.md` | изменить: блок ORCH-102 в паспорте — по фактическому объёму (правило №2) |
+| `CHANGELOG.md` | изменить: запись ORCH-102 |
+| `src/**`, `docker-compose.yml`, `Dockerfile`, `scripts/**` | **НЕ менять** (читаются инструкцией/тестами как источник истины; любое отклонение — только через ADR архитектора) |
+
+Кирпичи, которые инструкция **переиспользует по ссылке** (не форкает, BR-6/NFR-4):
+`docs/operations/REPLICATION.md` (карта env §2, секреты §3, smoke §4),
+`docs/operations/ONBOARDING.md` (статусы §1, слои Gitea/kit/реестр §2–5),
+`docs/operations/SETUP_WEBHOOKS.md` (формат вебхуков, Plane CE-каверза),
+`scripts/gen_secrets.py`, `scripts/onboard_project.py` (plan/apply/verify),
+`.env.example` (канон 100% ключей), `GET /health|/queue|/metrics`.
+
+---
+
+## 3. Функциональные требования
+
+### FR-1 — Документ `docs/deployment/LITE_SETUP.md`: состав и форма
+
+Привязка: BR-1, BR-2. Нормативный перечень разделов (порядок = маршрут оператора; финальную
+разбивку/нумерацию решает архитектор, состав — обязательный минимум):
+
+1. **Рамка Lite** — что разворачиваем (орк+watchdog), что заказчик ставит сам (Plane/Gitea/
+   Telegram/LLM), границы vs 10-common vs Bundled (ссылка на REPLICATION.md §1), платформенные
+   конвенции (репо `orchestrator`, имена сервисов, контейнерный layout — не менять).
+2. **Предусловия хоста** («зависимости, uid/gid» из бизнес-запроса): поддерживаемый контур
+   (Linux x86_64, Docker Engine + Compose v2, git, python3); node + дистрибутив claude-code на
+   хосте (`ORCH_HOST_NODE_BIN`, `ORCH_HOST_CLAUDE_CODE_DIR` — пути под маунты); пользователь и
+   владение каталогами: `ORCH_RUN_UID/GID` = uid владельца `ORCH_HOST_REPOS_DIR` (инвариант
+   ORCH-040), `ORCH_DOCKER_GID` — `getent group docker`; ssh-ключи деплой-хука
+   (`ORCH_HOST_SSH_DIR`); свободные порты (`ORCH_DEPLOY_PROD_TARGET_PORT`=8500,
+   `ORCH_STAGING_PORT`=8501). Каждое предусловие — команда проверки.
+3. **Перенос кода орк+watchdog**: получение чекаута репо `orchestrator` на хост в
+   `ORCH_DEPLOY_HOST_REPO_PATH` (источник кода — параметризованный шаг, исход А-6); НИКАКИХ
+   данных/БД/`.env` с боевого хоста (D-2). Watchdog отдельно не переносится — код в `watchdog/`
+   того же репо, образ собирается локально compose'ом.
+4. **Конфигурация**: `.env` строится с нуля от `.env.example` (канон); webhook-секреты —
+   `python3 scripts/gen_secrets.py [--write]`; карта переменных — ссылкой на REPLICATION.md §2;
+   в доке явно — **обязательные ключи нового хоста**: `ORCH_PLANE_API_URL/WEB_URL/WORKSPACE_SLUG`,
+   `ORCH_PLANE_API_TOKEN`, `ORCH_GITEA_URL/PUBLIC_URL/OWNER`, `ORCH_GITEA_TOKEN`, оба
+   webhook-секрета, `ORCH_TELEGRAM_BOT_TOKEN/CHAT_ID`, `ORCH_PROJECTS_JSON` (обязателен:
+   встроенный fallback несёт UUID исходного хоста), хост-параметры `ORCH_AGENT_HOME_DIR`/
+   `ORCH_HOST_*`/`ORCH_RUN_*`/`ORCH_DOCKER_GID`, когерентность портов
+   (`ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL`).
+5. **Подключение Plane** (инсталляция заказчика): создать workspace/проект; **точная модель
+   статусов** — 22 канонических имени с группами: создаёт `onboard_project.py apply`, таблица —
+   ссылкой на ONBOARDING.md §1 (без форка; fail-closed `Confirm Deploy`/`STOP` упомянуть явно);
+   выпуск API-токена (Workspace Settings → API tokens) + команда проверки; **webhook+HMAC**:
+   URL `…/webhook/plane`, секрет из `gen_secrets.py`, заголовок `X-Plane-Signature`; каверза
+   Plane CE «webhook не экспонирован в /api/v1» — оба пути (UI и прямой SQL, generic-вариант
+   команд SETUP_WEBHOOKS.md с плейсхолдерами).
+6. **Подключение Gitea** (инсталляция заказчика): репо (`onboard_project.py` или вручную),
+   токен (scope `repo`, `admin:repo_hook`) + проверка, per-repo webhook (events
+   `push`/`pull_request`/`status`, `X-Gitea-Signature`, **ОДИН глобальный секрет на все репо**);
+   норматив защиты `main` — по исходу А-1 (канон: branch protection НЕ включать, ORCH-009 ADR D10).
+7. **LLM-доступ (claude CLI)**: дистрибутив claude-code и node на хосте (пути = маунты compose),
+   `ORCH_CLAUDE_BIN`; аутентификация CLI на хосте (каталог `ORCH_HOST_CLAUDE_DIR` +
+   `ORCH_HOST_CLAUDE_JSON` — монтируются в контейнер; команда первичного логина/проверки —
+   `claude --version` / минимальный вызов); конфигурация моделей — `ORCH_AGENT_MODEL_*` /
+   `ORCH_AGENT_EFFORT_*` (резолв ORCH-41; дефолты канона — в `.env.example`).
+8. **Telegram**: бот трекера (BotFather `/newbot` → `ORCH_TELEGRAM_BOT_TOKEN`), получение
+   `chat_id` (воспроизводимая команда, например через `getUpdates`), проверка `getMe`;
+   **отдельный** watchdog-бот (`WATCHDOG_TG_BOT_TOKEN/CHAT_ID` — независимый канал, C-1
+   ORCH-100, токен орка переиспользовать запрещено) — размещение ключей по исходу А-4
+   (`.env.watchdog`).
+9. **Запуск compose-подмножества**: `docker compose config` (резолв без ошибок) →
+   `docker compose up -d --build` → поднимаются ровно `orchestrator` + `orchestrator-watchdog`
+   (AC-2); staging-профиль — опционально/когда нужен (исход А-5); health-чек:
+   `GET /health` → 200 `"status":"ok"`, `GET /queue`/`GET /metrics` → штатный JSON
+   (`schema_version: 1`).
+10. **Регистрация проекта заказчика**: `onboard_project.py plan → apply → verify`
+    (Plane-проект+статусы+лейблы `autoApprove`/`autoDeploy`/`Bug`, Gitea-репо+webhook, kit,
+    merged `ORCH_PROJECTS_JSON`) → внести строку в `.env` → управляемый рестарт → проверка
+    `/health`+`/queue` (маршрут ONBOARDING.md, ссылкой; в Lite-доке — последовательность команд).
+11. **Smoke** (AC-4): чек-лист REPLICATION.md §4 (шаги 0–5, опционально 6 до `done`) —
+    переиспользовать ссылкой + Lite-специфичные предусловия; критерий «конвейер доехал»:
+    задача в БД → analyst-job в `/queue` → артефакты `01–04` в ветке задачи.
+12. **Stateless-проверка** (AC-3): первый старт создаёт пустую БД (`data/` чист); `GET /queue` —
+    нулевые счётчики, ни одной задачи `ORCH-*`/`ET-*`; явная нормативная строка «данные/задачи/
+    секреты боевого хоста НЕ переносятся».
+13. **Траблшутинг** первичной настройки: минимум — webhook 401/HMAC mismatch; «задача не
+    появилась» (реестр/`ORCH_PROJECTS_JSON`/webhook); claude CLI не аутентифицирован/не найден;
+    `docker.sock` permission denied (`ORCH_DOCKER_GID`); права `/repos` (uid mismatch,
+    ORCH-040/057); Telegram молчит (токен/chat-id). Каждый пункт — симптом → команда
+    диагностики → лечение.
+
+**Форма (NFR-6, BR-1):** каждый шаг — исполняемая команда (fenced code block) + явная проверка
+(«Проверка:» / PASS-FAIL / ожидаемый вывод); все хост-специфичные значения в командах — только
+плейсхолдеры `<...>` или `$ENV_VAR` (боевые `mva154`/`82.22.50.71`/реальные токены — запрещены);
+язык — русский (канон доков платформы).
+
+### FR-2 — Compose-подмножество (AC-2)
+
+Привязка: BR-3. Зафиксировать (в доке + тестом), что Lite-развёртывание использует
+существующий `docker-compose.yml` БЕЗ форка:
+
+- множество сервисов файла — ровно `{orchestrator, orchestrator-watchdog, orchestrator-staging}`;
+- `orchestrator-staging` строго за `profiles: [staging]` → дефолтный `docker compose up -d`
+  поднимает ровно орк+watchdog;
+- сервисов/образов Plane/Gitea в compose НЕТ (и тест не даст появиться молча);
+- форма фиксации (существующий файл vs отдельный lite-вариант) — исход А-2; ТЗ-рекомендация:
+  существующий файл (он уже является подмножеством — факт BRD §1.3), отдельный файл не плодить.
+
+### FR-3 — Stateless-нормативы (AC-3)
+
+Привязка: BR-4. Инструкция обязана: (а) предписывать чистый старт — пустой `data/` (БД создаётся
+`init_db()` при первом старте), `.env` только с нуля; (б) предписывать выпуск НОВЫХ секретов
+(`gen_secrets.py` + чек-лист REPLICATION.md §3.2) и нести норматив «боевые секреты/данные/задачи
+не копируются»; (в) содержать проверку чистоты (FR-1 п.12); (г) сама не содержать реальных
+секретов (NFR-3; проверяется тестом FR-6 и security-гейтом ORCH-022).
+
+### FR-4 — Покрытие донастройки окружения без форка канона (AC-1)
+
+Привязка: BR-2, BR-6. Per-system разделы FR-1 п.5–8 обязаны быть полными (заказчик не ходит за
+ответами вовне репо), при этом канонические данные даются ссылкой на golden source:
+
+| Данные | Golden source | В LITE_SETUP.md |
+|--------|---------------|------------------|
+| 22 статуса + группы | `plane_sync._PLANE_NAME_TO_KEY` / ONBOARDING.md §1 | ссылка + критичные fail-closed имена (`Confirm Deploy`, `STOP`) |
+| Карта env / хост-параметры | REPLICATION.md §2 / `.env.example` | ссылка + список обязательных ключей нового хоста |
+| Формат вебхуков / Plane CE-каверза | SETUP_WEBHOOKS.md | ссылка + generic-команды с плейсхолдерами |
+| Онбординг проекта | ONBOARDING.md / `onboard_project.py` | ссылка + последовательность команд Lite-маршрута |
+| Smoke | REPLICATION.md §4 | ссылка + Lite-предусловия |
+
+Если архитектор решит дублировать таблицу (читаемость) — дубль защищается анти-дрейф тестом
+(сверка импортом из `src/plane_sync.py` / парсингом `.env.example`), не строковой копией.
+
+### FR-5 — Smoke на чистом окружении (AC-4)
+
+Привязка: BR-5. Состав: (а) в LITE_SETUP.md — smoke-раздел (FR-1 п.11) как воспроизводимый
+чек-лист с PASS/FAIL на каждый шаг; (б) приёмочный прогон процедуры на чистом контуре — минимум
+staging-песочница (порт `ORCH_STAGING_PORT`, изолированная БД `./data/staging`) + одноразовый
+sandbox-проект (прецедент ORCH-101 AC-3 / ONBOARDING.md §5.2), без нового железа; (в) результат
+прогона фиксируется в артефактах задачи (`13-test-report.md` / `15-staging-log.md`); (г) прогон
+на реальном новом хосте — желателен, но НЕ требование приёмки (нет железа в контуре задачи).
+
+### FR-6 — Анти-дрейф тесты (BR-8)
+
+Привязка: BR-3, BR-6, BR-8. Новый `tests/test_lite_setup_doc.py` (структурный, без сети/LLM;
+образец — `tests/test_replication_smoke.py`):
+
+1. док существует по канонному пути; несёт обязательные разделы/кирпичи FR-1 (минимум:
+   `gen_secrets.py`, `onboard_project.py`, `docker compose`, `/health`, `/queue`, `/metrics`,
+   `ORCH_PROJECTS_JSON`, webhook-секреты, `X-Plane-Signature`/`X-Gitea-Signature`,
+   `getent group docker`, `Confirm Deploy`/`STOP`, Telegram-боты обоих каналов, маркеры
+   PASS/FAIL/«Проверка»);
+2. каждый env-ключ `ORCH_*`/`WATCHDOG_*`, упомянутый в доке, существует в `.env.example`
+   (анти-опечатка/анти-дрейф канона);
+3. compose-подмножество: парсинг `docker-compose.yml` — ровно 3 сервиса, staging за профилем,
+   ни одного сервиса/образа `plane*`/`gitea*` (AC-2);
+4. stateless/секрет-гигиена: нормативная строка «не копиру…» присутствует; в доке нет
+   секретоподобных значений (эвристика по образцу security-паттернов) и боевых литералов
+   (`mva154`, `duckdns`, `82.22.50.71`) в копируемых код-блоках;
+5. перекрёстность: REPLICATION.md §1 ссылается на LITE_SETUP.md; `CHANGELOG.md` несёт ORCH-102.
+
+Точная нарезка по тест-модулям — за developer (план — `04-test-plan.yaml`); существующие тесты
+не правятся (кроме согласованных структурных дополнений).
+
+### FR-7 — Перекрёстная документация (BR-7)
+
+Привязка: BR-7. REPLICATION.md §1 (строка Type A — Lite → ✅ + ссылка); README.md — способность
+Lite-тиража в обзоре (правило №6); CLAUDE.md — по фактическому объёму; CHANGELOG.md — запись.
+INFRA.md — ссылка на deployment-раздел при необходимости.
+
+---
+
+## 3.8. Вопросы архитектору (решаются в `06-adr/`, не в ТЗ)
+
+- **А-1 — «pre-receive хуки» vs норматив ADR D10 (ORCH-009):** бизнес-запрос упоминает
+  pre-receive хуки, но в платформе их нет, а branch protection на `main` нормативно запрещён
+  (ломает PR-merge API merge-актора). Что фиксирует раздел Gitea? Рекомендация ТЗ: канон —
+  репо+токен+webhook+явный норматив «branch protection НЕ включать»; pre-receive не вводить;
+  отклонение — только отдельным ADR с анализом совместимости с merge-актором (ORCH-093/INV-4).
+- **А-2 — форма compose-подмножества:** существующий `docker-compose.yml` (уже = подмножество)
+  + документация/тест vs отдельный `docker-compose.lite.yml`. Рекомендация: существующий, без
+  форка (нулевой дрейф, AC-2 держит тест).
+- **А-3 — размещение дока:** бизнес-запрос фиксирует `docs/deployment/LITE_SETUP.md` (новый
+  раздел `docs/deployment/`); REPLICATION.md живёт в `docs/operations/`. Подтвердить layout
+  (deployment как витрина тиража vs operations) и перекрёстные ссылки; отступление от пути
+  бизнес-запроса — только явным решением.
+- **А-4 — канон watchdog-конфига нового хоста:** compose читает `.env.watchdog`
+  (`required: false`), примера-файла нет; ключи `WATCHDOG_*` канонизированы в `.env.example`.
+  Добавить `.env.watchdog.example` (симметрия с `.env.staging.example`) или документировать
+  шаг «создай `.env.watchdog` с двумя ключами» в LITE_SETUP? Рекомендация: example-файл +
+  упоминание в доке (меньше шансов перепутать файл-носитель).
+- **А-5 — staging-контур в Lite-инструкции:** обязателен ли запуск `orchestrator-staging` у
+  заказчика? Рекомендация: опционален — нужен только если заказчик регистрирует проект
+  `orchestrator` (self-hosting развитие платформы); для «раздачи на тест» базовый контур =
+  prod-инстанс + watchdog; в доке — явная вилка.
+- **А-6 — источник кода для заказчика:** clone-URL (зеркало/доступ к нашему Gitea) vs архив.
+  В доке — параметризованный шаг `git clone <ORCHESTRATOR_GIT_URL>`; конкретику источника
+  фиксирует Владелец (вне репо).
+
+---
+
+## 4. Изменения API
+
+Нет. Существующие `GET /health` / `/queue` / `/metrics` переиспользуются инструкцией read-only;
+новые эндпоинты не вводятся.
+
+## 5. Изменения схемы БД
+
+Нет.
+
+## 6. Требования к новым/изменённым QG checks
+
+Нет. `QG_CHECKS`/`check_*`/machine-verdict ключи не меняются. Новые структурные тесты (FR-6) —
+обычный pytest: попадают в существующие гейты (`check_ci_green`/`check_tests_passed`/merge-gate
+re-test/coverage-гейт ORCH-027) автоматически, без регистрации нового QG.
+
+## 7. Совместимость / регресс
+
+- **Нулевая регрессия (NFR-2):** дифф — docs+tests (+опц. `.env.watchdog.example`); рантайм не
+  меняется; kill-switch не требуется (нечего выключать); полный `pytest tests/ -q` зелёный,
+  существующие структурные тесты (`test_no_host_hardcodes`, `test_replication_smoke`,
+  `test_infra_parametrization`, `test_onboarding_*`) не ослабляются.
+- **Обратимость:** удаление дока/тестов возвращает состояние 1:1 (никаких миграций/состояния).
+- **Self-hosting (NFR-1):** прод-контейнер не рестартится; выкат — штатный конвейер
+  (deploy-staging 8501 → ручной Confirm Deploy). Для enduro-trails изменение инертно.
+- **Секрет-гигиена (NFR-3):** в доке/тестах только плейсхолдеры; security-гейт (ORCH-022,
+  `17-security-report.md`) обязан остаться `PASS`.
+- **Инварианты соседних маркеров (правило №9):** ORCH-101 (дефолт = боевое значение; канон
+  `.env.example`; конвенции тиража REPLICATION §1), ORCH-009 (ADR D10 — без branch protection;
+  onboarding-CLI ничего не удаляет), ORCH-100 (независимый Telegram-канал watchdog, C-1),
+  ORCH-040 (uid/gid/HOME группа), ORCH-058 (staging ≠ прод-порт), INV-4 (мерж только через
+  PR-merge API) — инструкция обязана им следовать, а не противоречить.

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

@@ -0,0 +1,181 @@
+---
+work_item: ORCH-102
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 03 — Критерии приёмки (Acceptance Criteria): ORCH-102 — ORCH-10a Lite-тираж
+
+Work Item: **ORCH-102** · Repo: **orchestrator** · Стадия: analysis
+
+Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
+(что считается провалом). Любой машинный/ручной reviewer проверяет их буквально по файлам
+репозитория. AC-1…AC-5 — дословно из бизнес-запроса (уточнены до проверяемости);
+AC-6…AC-7 — детализация скоупа (анти-дрейф / инварианты).
+
+---
+
+## AC-1 — `docs/deployment/LITE_SETUP.md`: полная пошаговая, без доп-вопросов
+
+**Условие:** инструкция существует и покрывает сквозной маршрут Lite-тиража; каждый шаг —
+команда/проверка; человек, не видевший платформу, разворачивает по ней без доп-вопросов.
+- **PASS:**
+  - файл `docs/deployment/LITE_SETUP.md` существует (путь — по исходу А-3; отклонение от пути
+    бизнес-запроса зафиксировано в ADR задачи);
+  - покрыты ВСЕ разделы нормативного перечня ТЗ §FR-1: рамка Lite/границы; предусловия хоста
+    (зависимости, uid/gid: `ORCH_RUN_UID/GID`, `ORCH_DOCKER_GID` через `getent group docker`,
+    владение `ORCH_HOST_REPOS_DIR`); перенос кода (чекаут `orchestrator`, без данных);
+    конфигурация (`.env` с нуля от `.env.example` + `gen_secrets.py`, обязательные ключи нового
+    хоста включая `ORCH_PROJECTS_JSON`); Plane (workspace/проект, точная модель статусов с
+    fail-closed `Confirm Deploy`/`STOP`, API-токен, webhook+HMAC `X-Plane-Signature` + каверза
+    Plane CE); Gitea (репо, токен со scope, per-repo webhook `X-Gitea-Signature`, один глобальный
+    секрет, норматив защиты `main` по исходу А-1); LLM (claude CLI: дистрибутив/node/аутентификация/
+    `ORCH_CLAUDE_BIN`/модели ORCH-41); Telegram (бот трекера + отдельный watchdog-бот +
+    получение chat-id); запуск compose + health-чек (`/health`, `/queue`, `/metrics`);
+    регистрация проекта (`onboard_project.py` → `ORCH_PROJECTS_JSON` → управляемый рестарт);
+    smoke; stateless-проверка; траблшутинг (≥ 5 типовых отказов: симптом → диагностика → лечение);
+  - **каждый** нормативный шаг несёт исполняемую команду (fenced code block) И явную проверку
+    результата (маркер «Проверка:» / PASS-FAIL / ожидаемый вывод);
+  - копируемые команды generic: хост-специфика только плейсхолдерами `<...>`/`$ENV_VAR`;
+    боевых литералов (`mva154`, `duckdns`, `82.22.50.71`, реальные токены) в код-блоках нет;
+  - «без доп-вопросов» подтверждено операционально: приёмочный smoke-прогон по инструкции
+    выполнен на чистом контуре и зафиксирован (см. AC-4) + траблшутинг покрывает типовые отказы.
+- **FAIL:** файла нет; ИЛИ отсутствует любой нормативный раздел FR-1; ИЛИ есть шаг без
+  команды/проверки («настройте webhook» без как-проверить); ИЛИ в копируемых командах боевые
+  URL/пути/секреты; ИЛИ инструкция отсылает за обязательным шагом во внешний (вне репо) источник.
+
+---
+
+## AC-2 — Compose-подмножество: только орк+watchdog
+
+**Условие:** Lite разворачивает ровно `orchestrator`+`orchestrator-watchdog`; Plane/Gitea-контейнеров
+нет; свойство зафиксировано и защищено.
+- **PASS:**
+  - `docker compose config --services` (без активных профилей, пустой env) →
+    ровно `orchestrator` и `orchestrator-watchdog`;
+  - `orchestrator-staging` присутствует в файле строго за `profiles: [staging]` (дефолтный
+    `up -d` его не поднимает);
+  - в `docker-compose.yml` нет сервисов/образов Plane/Gitea (ни `plane*`, ни `gitea*`);
+  - LITE_SETUP.md документирует это свойство (что поднимется после `up -d` и почему staging
+    опционален — исход А-5);
+  - структурный тест compose-подмножества (TC-04) существует и зелёный;
+  - если по исходу А-2 введён отдельный lite-compose — он покрыт тем же тестом, а existing
+    `docker-compose.yml` не форкается без обоснования в ADR.
+- **FAIL:** дефолтный запуск поднимает что-то кроме орк+watchdog; ИЛИ staging вне профиля;
+  ИЛИ в compose появился Plane/Gitea-сервис; ИЛИ свойство не задокументировано; ИЛИ тест
+  отсутствует/красный.
+
+---
+
+## AC-3 — Stateless: чистая БД, ни одной нашей задачи/секрета
+
+**Условие:** инструкция предписывает чистый старт и не допускает переноса наших данных/секретов;
+сама дока секретов не содержит.
+- **PASS:**
+  - LITE_SETUP.md нормативно фиксирует: БД создаётся пустой при первом старте (`data/` чист,
+    переносить нечего); `.env`/`.env.staging`/`.env.watchdog` собираются с нуля; явная строка
+    «данные/задачи/секреты боевого хоста НЕ переносятся» (зеркало REPLICATION.md §5);
+  - секреты — только выпуск НОВЫХ: `gen_secrets.py` (webhook) + чек-лист внешних токенов
+    (ссылка на REPLICATION.md §3); ни один шаг не предписывает копирование боевого секрета;
+  - инструкция содержит проверку чистоты развёрнутого инстанса: первый `GET /queue` — нулевые
+    счётчики jobs, ни одной задачи (`ORCH-*`/`ET-*`) в системе;
+  - в самом доке и тестах задачи нет реальных секретоподобных значений (только плейсхолдеры);
+    security-гейт (ORCH-022, `17-security-report.md`) — `PASS`.
+- **FAIL:** любой шаг предписывает/допускает перенос БД/задач/боевого `.env`/секрета; ИЛИ нет
+  нормативной stateless-строки; ИЛИ нет проверки чистоты; ИЛИ в доке обнаружен реальный
+  секрет/боевой токен; ИЛИ security-гейт `FAIL`.
+
+---
+
+## AC-4 — Smoke на чистом окружении проходит
+
+**Условие:** smoke существует как воспроизводимая процедура/чек-лист и подтверждён прогоном.
+- **PASS:**
+  - LITE_SETUP.md несёт smoke-раздел: чек-лист с явным PASS/FAIL на каждый шаг, построенный на
+    REPLICATION.md §4 (ссылка, без форка процедуры): конфиг резолвится → `/health` →
+    `/queue`+`/metrics` → тестовый проект (`onboard_project.py plan/apply/verify`) → тестовая
+    задача → «конвейер доехал» (минимум: `analysis` отработала, артефакты `01–04` в ветке);
+  - итог процедуры — однозначный вердикт (все шаги PASS ⇒ тираж PASS);
+  - приёмочный прогон выполнен на чистом контуре — минимум staging-песочница
+    (`ORCH_STAGING_PORT`, изолированная БД `./data/staging`) + одноразовый sandbox-проект
+    (прецедент ORCH-101 AC-3 / ONBOARDING.md §5.2) — и зафиксирован в артефактах задачи
+    (`13-test-report.md` и/или `15-staging-log.md`: дата, контур, шаги, вердикт);
+  - процедура нигде не требует боевых данных/секретов (stateless, согласовано с AC-3).
+- **FAIL:** smoke-раздела нет; ИЛИ шаги без явных PASS/FAIL («посмотреть, что всё ок»); ИЛИ
+  процедура форкает REPLICATION.md §4 с расхождениями; ИЛИ заявленный прогон не зафиксирован в
+  артефактах; ИЛИ прогон провален и не разобран.
+
+---
+
+## AC-5 — pytest зелёный; CHANGELOG; перекрёстные доки
+
+**Условие:** регресс чист, документация согласована (правила агентов №2/№6).
+- **PASS:**
+  - полный `pytest tests/ -q` зелёный (включая новые структурные тесты задачи и существующие
+    `test_no_host_hardcodes` / `test_replication_smoke` / `test_infra_parametrization` /
+    `test_onboarding_*` — не ослаблены и не правлены под задачу без согласования);
+  - `CHANGELOG.md` содержит запись ORCH-102;
+  - `docs/operations/REPLICATION.md` §1: строка «Type A — Lite» обновлена (статус ✅/ссылка на
+    LITE_SETUP.md) — границы 10-common vs Lite vs Bundled остаются честными;
+  - `README.md`/`CLAUDE.md` обновлены, если фактический объём того требует (новая операторская
+    способность — Lite-тираж; README не выдаёт нерешённое за решённое и наоборот).
+- **FAIL:** любой тест красный; ИЛИ нет записи в CHANGELOG; ИЛИ REPLICATION.md §1 продолжает
+  числить Lite «отдельной задачей» без ссылки; ИЛИ обзорные доки противоречат факту.
+
+---
+
+## AC-6 — Канон не форкается; анти-дрейф защита
+
+**Условие:** инструкция — маршрутизатор поверх golden source'ов, её полнота защищена тестом.
+- **PASS:**
+  - канонические данные (22 статуса, карта env, формат вебхуков, онбординг, smoke) даны ссылкой
+    на golden source (`ONBOARDING.md` §1 / `REPLICATION.md` §2–§4 / `SETUP_WEBHOOKS.md`); при
+    дублировании таблицы — анти-дрейф тест сверяет дубль с источником истины (импорт из
+    `src/plane_sync.py` / парсинг `.env.example`), не строковой копией;
+  - `tests/test_lite_setup_doc.py` существует и проверяет минимум: наличие дока; обязательные
+    кирпичи (ТЗ FR-6.1); согласованность упомянутых env-ключей с `.env.example` (FR-6.2);
+    compose-подмножество (FR-6.3); stateless-норматив и отсутствие боевых литералов/секретов в
+    код-блоках (FR-6.4); перекрёстность REPLICATION→LITE_SETUP и запись CHANGELOG (FR-6.5);
+  - тест детерминирован (повторные прогоны стабильны, без сети/LLM).
+- **FAIL:** таблица статусов/env скопирована без анти-дрейф сверки; ИЛИ тест отсутствует/не
+  ловит исчезновение обязательного раздела/кирпича; ИЛИ упомянутый в доке env-ключ отсутствует
+  в `.env.example`; ИЛИ тест флапает/ходит в сеть.
+
+---
+
+## AC-7 — Self-hosting безопасность и неизменность конвейера
+
+**Условие:** задача не дестабилизирует общий прод и не меняет рантайм.
+- **PASS:**
+  - дифф задачи — `docs/**`, `tests/**`, `CHANGELOG.md` (+ согласованные обзорные доки,
+    + `.env.watchdog.example` при исходе А-4); `src/**` не изменён — либо каждое отклонение
+    обосновано в ADR задачи;
+  - `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / machine-verdict ключи / схема БД —
+    без изменений;
+  - прод-контейнер `orchestrator` в рамках задачи не перезапускается; выкат — только штатным
+    конвейером (deploy-staging 8501 → ручной Confirm Deploy);
+  - инструкция не противоречит инвариантам платформы: ADR D10 ORCH-009 (без branch protection),
+    C-1 ORCH-100 (watchdog-бот ≠ бот орка), ORCH-040 (uid/gid/HOME группа), ORCH-058
+    (staging-порт ≠ прод-порт), INV-4 (мерж только через PR-merge API), конвенции тиража
+    REPLICATION.md §1 (репо `orchestrator`, имена сервисов).
+- **FAIL:** немотивированные правки `src/**`/compose/Dockerfile; ИЛИ дифф трогает машину
+  стадий/QG/вердикты/схему БД; ИЛИ рестарт прода вне штатного деплой-пути; ИЛИ шаг инструкции
+  предписывает запрещённое инвариантами (включить branch protection, переиспользовать токен орка
+  для watchdog, скопировать боевой секрет и т.п.).
+
+---
+
+## Сводная матрица AC ↔ BR/FR
+
+| AC | Покрывает |
+|----|-----------|
+| AC-1 | BR-1, BR-2 / FR-1, FR-4, NFR-6 |
+| AC-2 | BR-3 / FR-2 |
+| AC-3 | BR-4 / FR-3, NFR-3 |
+| AC-4 | BR-5 / FR-5 |
+| AC-5 | BR-7 / FR-7, NFR-2 |
+| AC-6 | BR-6, BR-8 / FR-6, NFR-4, NFR-5 |
+| AC-7 | NFR-1, NFR-2 / §7 ТЗ (инварианты) |

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

@@ -0,0 +1,146 @@
+work_item: ORCH-102
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+title: "ORCH-10a Lite-тираж: инструкция LITE_SETUP + compose-подмножество — план тестов"
+framework: pytest
+scope: >
+  Покрывается: существование и полнота docs/deployment/LITE_SETUP.md (нормативные
+  разделы FR-1, форма «команда+проверка», generic-команды без боевых литералов),
+  согласованность упомянутых env-ключей с каноном .env.example, структурная
+  фиксация compose-подмножества (ровно орк+watchdog, staging за профилем, без
+  Plane/Gitea-сервисов), stateless-нормативы и секрет-гигиена дока, перекрёстные
+  ссылки (REPLICATION.md §1, CHANGELOG), воспроизводимый smoke-чек-лист и его
+  приёмочный прогон на чистом контуре, полный регресс. Вне покрытия: реальный
+  e2e-тираж на новом железе заказчика (заменён прогоном на staging-песочнице —
+  прецедент ORCH-101 AC-3), установка Plane/Gitea как таковых, задача 10b
+  (Bundled), перенос данных (stateless по решению 10.06).
+notes: >
+  Задача docs-first: ожидаемый дифф — docs/** + tests/** + CHANGELOG.md
+  (+ .env.watchdog.example при исходе А-4); src/** не меняется. Имя нового
+  тест-модуля tests/test_lite_setup_doc.py — предложение analyst; developer может
+  переименовать/разбить, сохранив покрытие TC (образец структурных док-тестов —
+  tests/test_replication_smoke.py). Тесты детерминированы, без сети/LLM.
+  Полный регресс tests/ обязан остаться зелёным; STAGE_TRANSITIONS/QG_CHECKS/
+  check_*/machine-verdict не меняются — новые тесты входят в существующие гейты
+  (check_ci_green / merge-gate re-test / coverage-гейт ORCH-027) автоматически.
+  TC-09 — процедурная приёмка AC-4: прогон фиксируется tester'ом в
+  13-test-report.md / 15-staging-log.md, а не автоматизируется в pytest.
+
+tests:
+  - id: TC-01
+    type: unit
+    description: >
+      LITE_SETUP.md существует по канонному пути (docs/deployment/, исход А-3 —
+      синхронизировать с ADR) и несёт ВСЕ нормативные разделы FR-1: рамка/границы
+      Lite, предусловия хоста (зависимости, uid/gid, getent group docker), перенос
+      кода, конфигурация (.env с нуля + gen_secrets.py + ORCH_PROJECTS_JSON),
+      Plane (статусы/токен/webhook+HMAC), Gitea (репо/токен/webhook), LLM
+      (claude CLI), Telegram (трекер + watchdog-бот + chat-id), запуск+health-чек,
+      регистрация проекта, smoke, stateless-проверка, траблшутинг (AC-1 / FR-1).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-02
+    type: unit
+    description: >
+      Форма «каждый шаг — команда/проверка»: нормативные разделы содержат fenced
+      code blocks с исполняемыми командами и явные маркеры проверки
+      (PASS/FAIL/«Проверка:»); ключевые кирпичи присутствуют: docker compose,
+      /health, /queue, /metrics, gen_secrets.py, onboard_project.py,
+      X-Plane-Signature, X-Gitea-Signature (AC-1 / FR-1, NFR-6).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-03
+    type: unit
+    description: >
+      Согласованность env-канона: каждый ключ ORCH_*/WATCHDOG_*, упомянутый в
+      LITE_SETUP.md, существует в .env.example; обязательный набор нового хоста
+      упомянут явно (ORCH_PROJECTS_JSON, ORCH_PLANE_WEBHOOK_SECRET,
+      ORCH_GITEA_WEBHOOK_SECRET, ORCH_PLANE_API_TOKEN, ORCH_GITEA_TOKEN,
+      ORCH_TELEGRAM_BOT_TOKEN, ORCH_TELEGRAM_CHAT_ID, WATCHDOG_TG_BOT_TOKEN,
+      WATCHDOG_TG_CHAT_ID) (AC-1, AC-6 / FR-1.4, FR-6.2).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-04
+    type: unit
+    description: >
+      Compose-подмножество (AC-2): docker-compose.yml парсится; множество сервисов
+      ровно {orchestrator, orchestrator-watchdog, orchestrator-staging};
+      orchestrator-staging строго за profiles: [staging] (дефолтный up -d поднимает
+      ровно орк+watchdog); ни одного сервиса/образа plane*/gitea*; LITE_SETUP.md
+      документирует состав дефолтного запуска (AC-2 / FR-2).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-05
+    type: unit
+    description: >
+      Stateless и секрет-гигиена (AC-3): док несёт нормативную строку «боевые
+      данные/задачи/секреты не копируются» и предписывает чистую БД + выпуск
+      новых секретов (gen_secrets.py); проверка чистоты инстанса (первый GET
+      /queue без задач) описана; в копируемых код-блоках нет боевых литералов
+      (mva154, duckdns, 82.22.50.71) и секретоподобных значений — только
+      плейсхолдеры <...>/$ENV_VAR (AC-3 / FR-3, NFR-3).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-06
+    type: unit
+    description: >
+      Канон не форкается (AC-6): раздел Plane-статусов ссылается на golden source
+      (ONBOARDING.md §1 / onboard_project.py) и явно упоминает fail-closed имена
+      Confirm Deploy и STOP; при наличии дубля таблицы статусов в доке — дубль
+      сверяется с plane_sync._PLANE_NAME_TO_KEY импортом (22 имени, нулевой
+      дрейф); карта env и smoke даны ссылкой на REPLICATION.md (AC-6 / FR-4,
+      NFR-4).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-07
+    type: unit
+    description: >
+      Раздел Gitea соответствует инвариантам платформы: события
+      push/pull_request/status, ОДИН глобальный webhook-секрет на все репо,
+      и норматив защиты main согласован с исходом А-1 ADR задачи (канон: branch
+      protection НЕ включать — ADR D10 ORCH-009; инструкция не предписывает
+      запрещённого) (AC-1, AC-7 / FR-1.6, §3.8 А-1).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-08
+    type: unit
+    description: >
+      Перекрёстная документация (AC-5): REPLICATION.md §1 (границы 10-common vs
+      Lite vs Bundled) ссылается на LITE_SETUP.md / отмечает Lite реализованным;
+      CHANGELOG.md содержит запись ORCH-102 (AC-5 / FR-7).
+    module: tests/test_lite_setup_doc.py
+    expected: PASS
+
+  - id: TC-09
+    type: integration
+    description: >
+      Приёмочный smoke-прогон по LITE_SETUP.md на чистом контуре (минимум:
+      staging-песочница ORCH_STAGING_PORT с изолированной БД ./data/staging +
+      одноразовый sandbox-проект; прецедент ORCH-101 AC-3): чек-лист REPLICATION
+      §4 шаги 0–5 — конфиг резолвится, /health 200, /queue+/metrics штатны,
+      onboard verify зелёный, тестовая задача дошла до артефактов 01–04; вердикт
+      и контур зафиксированы в 13-test-report.md / 15-staging-log.md. Процедурная
+      приёмка (исполняет tester по чек-листу), не pytest-модуль (AC-4 / FR-5).
+    module: tests/manual/lite-smoke-checklist (процедура; протокол в 13/15)
+    expected: PASS
+
+  - id: TC-10
+    type: integration
+    description: >
+      Полный регресс: pytest tests/ -q зелёный; существующие структурные тесты
+      (test_no_host_hardcodes, test_replication_smoke, test_infra_parametrization,
+      test_onboarding_*) не ослаблены/не правлены под задачу; дифф не трогает
+      src/** (или каждое отклонение обосновано ADR), STAGE_TRANSITIONS/QG_CHECKS/
+      machine-verdict/схему БД (AC-5, AC-7 / NFR-2).
+    module: tests/
+    expected: PASS

docs/work-items/ORCH-102/06-adr/ADR-001-lite-setup-doc-canon.md

@@ -0,0 +1,298 @@
+---
+work_item: ORCH-102
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# ADR-001: Канон Lite-тиража — `docs/deployment/LITE_SETUP.md`, исходы А-1…А-6, анти-дрейф контур
+
+Work Item: **ORCH-102** — ORCH-10a Lite-тираж: перенос орк+watchdog + полная инструкция донастройки окружения
+Стадия: **architecture**
+Сквозная регистрация: **`docs/architecture/adr/adr-0037-lite-replication-canon.md`**
+(новый docs-раздел `docs/deployment/`, новый канонический example-файл и нормативы тиражной
+инсталляции — кросс-каттинг для всех будущих задач эпика ORCH-10 и для агентов, меняющих шаги тиража).
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5 «Масштаб»), тип **A — Lite**: заказчик-тестер разворачивает на своей инфре
+ТОЛЬКО орк+watchdog, окружение (Plane/Gitea/LLM/Telegram) донастраивает сам по инструкции.
+Решения Владельца 10.06 (BRD §1.4): оба типа тиража stateless (D-2), главный продукт ORCH-102 —
+**инструкция** `docs/deployment/LITE_SETUP.md` (D-4).
+
+Факты, сверенные с кодом/репо на ветке задачи:
+
+- **Фундамент 10-common (ORCH-101) в `main`** (adr-0036): хост-значения параметризованы
+  (`${VAR:-default}`, «дефолт = боевое значение»), секреты выпускаются заново
+  (`scripts/gen_secrets.py`), smoke с PASS/FAIL — `docs/operations/REPLICATION.md` §4,
+  анти-регресс `tests/test_no_host_hardcodes.py` (центральный список `FORBIDDEN` + хелпер
+  `find_violations`). Технически платформа разворачивается без правки кода; операционно
+  единого маршрута для заказчика нет (знания в 4 operations-доках, писанных для НАШЕГО хоста).
+- **`docker-compose.yml` уже является Lite-подмножеством:** ровно 3 сервиса —
+  `orchestrator`, `orchestrator-watchdog`, `orchestrator-staging`; staging строго за
+  `profiles: [staging]`; сервисов/образов Plane/Gitea нет. Дефолтный `docker compose up -d`
+  поднимает ровно орк+watchdog. Свойство нигде не зафиксировано и ничем не защищено.
+- **Гэп канона watchdog-конфига:** compose читает `.env.watchdog`
+  (`env_file: {path: .env.watchdog, required: false}`), но example-файла нет (есть только
+  `.env.example` / `.env.staging.example`). Ключи `WATCHDOG_*` (19 шт., дефолты =
+  `watchdog/config.py`) задокументированы внутри `.env.example` — однако sidecar-контейнер
+  читает ТОЛЬКО `.env.watchdog`: ключ, положенный оператором в `.env`, для watchdog **инертен**
+  (в `.env` его видит лишь контейнер орка через его `env_file`). Двусмысленность файла-носителя —
+  реальная ловушка первичной настройки.
+- **«Pre-receive хуки» из бизнес-запроса конфликтуют с действующим нормативом:** ORCH-009
+  ADR-001 **D10** — branch protection на `main` НЕ включать (required-approvals/status-checks →
+  405/409-класс отказов `merge_pr` → ложные HOLD, класс инцидента ORCH-063); merge-актор работает
+  только через Gitea PR-merge API (INV-4, `src/merge_gate.py`). Pre-receive хуков в платформе нет;
+  защита `main` — конвенция (агенты не пушат `main`) + скоуп токенов.
+- **Парсер YAML доступен тестам** (`yaml.safe_load` уже используется в
+  `tests/test_infra_parametrization.py::_compose_services`) — структурный тест
+  compose-подмножества не требует новых зависимостей.
+- Прецедент приёмки smoke без нового железа: ORCH-101 AC-3 — staging-песочница
+  (`ORCH_STAGING_PORT`=8501, изолированная БД `./data/staging`) + sandbox-проект
+  (ONBOARDING.md §5, журнал smoke-прогонов).
+
+Задача — **docs+tests** (паттерн ORCH-077/092): `src/**`, `docker-compose.yml`, `Dockerfile`,
+`scripts/**` читаются как источник истины и НЕ меняются; конвейер
+(`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД) — байт-в-байт.
+
+## Решение
+
+### Сводка
+
+Создаётся новый docs-раздел **`docs/deployment/`** (витрина тиража) с golden source
+**`docs/deployment/LITE_SETUP.md`** — сквозной маршрут «голый хост → работающий конвейер» из 13
+нормативных разделов (D2), собирающий кирпичи 10-common ссылками, без форка канона. Compose не
+форкается (D4); канон watchdog-конфига закрывается новым **`.env.watchdog.example`** (D5);
+раздел Gitea фиксирует действующий норматив D10 — branch protection НЕ включать, pre-receive не
+вводить (D3). Полнота/гигиена дока и compose-подмножество защищаются структурным
+`tests/test_lite_setup_doc.py` (D8). Рантайм не трогается; исходы всех вопросов ТЗ §3.8 — ниже.
+
+### D1 (исход А-3) — Размещение: новый раздел `docs/deployment/`, путь бизнес-запроса подтверждён
+
+**Решение: `docs/deployment/LITE_SETUP.md`, как зафиксировано Владельцем (D-4).** Семантика
+разделов: `docs/deployment/` — «как развернуть платформу У СЕБЯ» (читатель — внешний
+оператор/заказчик, платформу видит впервые); `docs/operations/` — «как эксплуатировать НАШ прод»
+(читатель — оператор текущего хоста). `REPLICATION.md` остаётся в `docs/operations/` — это
+runbook фундамента 10-common, исторический якорь ORCH-101, к пути прибит
+`tests/test_replication_smoke.py`; перенос дал бы правку чужого артефакта без выгоды.
+Перекрёстные ссылки обе стороны: REPLICATION.md §1 (строка Type A — Lite → ✅ ORCH-102 + ссылка
+на LITE_SETUP.md) и LITE_SETUP.md §1 (границы — ссылкой на REPLICATION.md §1). INFRA.md получает
+ссылку на deployment-раздел (по фактическому объёму, FR-7).
+
+Привязка: FR-1, FR-7, AC-1, AC-5.
+
+### D2 (FR-1) — Нормативная структура LITE_SETUP.md: 13 разделов, форма «команда + проверка»
+
+**Решение: фиксированная нумерация `## N. <Название>`, порядок = маршрут оператора** (состав —
+обязательный минимум FR-1; анти-дрейф тест ассертит наличие и порядок заголовков):
+
+| § | Раздел | Ключевое содержимое (норматив) |
+|---|--------|--------------------------------|
+| 1 | Рамка Lite | что разворачиваем (орк+watchdog); что заказчик ставит сам; границы vs 10-common/Bundled — ссылка REPLICATION.md §1; платформенные конвенции (репо `orchestrator`, имена сервисов, контейнерный layout — не менять) |
+| 2 | Предусловия хоста | контур: Linux x86_64, Docker Engine + Compose v2, git, python3, node + дистрибутив claude-code; `ORCH_RUN_UID/GID` = uid владельца `ORCH_HOST_REPOS_DIR` (ORCH-040), `ORCH_DOCKER_GID` ← `getent group docker`; ssh (`ORCH_HOST_SSH_DIR`); свободные порты 8500/8501; **каждое предусловие — команда проверки** |
+| 3 | Перенос кода | `git clone <ORCHESTRATOR_GIT_URL>` в `ORCH_DEPLOY_HOST_REPO_PATH` (D7); НИКАКИХ данных/БД/`.env` с боевого хоста; watchdog отдельно не переносится (код в `watchdog/` того же репо) |
+| 4 | Конфигурация | `.env` с нуля от `.env.example` (канон); `python3 scripts/gen_secrets.py [--write]`; карта env — ссылка REPLICATION.md §2; явный список обязательных ключей нового хоста (вкл. `ORCH_PROJECTS_JSON`); `.env.watchdog` от `.env.watchdog.example` (D5); когерентность портов `ORCH_DEPLOY_PROD_TARGET_PORT` ⇄ `WATCHDOG_METRICS_URL` ⇄ `ORCH_POST_DEPLOY_BASE_URL` |
+| 5 | Подключение Plane | workspace/проект; 22 статуса с группами — создаёт `onboard_project.py apply`, таблица ссылкой ONBOARDING.md §1; явно — fail-closed `Confirm Deploy`/`STOP`; API-токен + проверка `curl`; webhook+HMAC: URL `…/webhook/plane`, `X-Plane-Signature`, каверза Plane CE — оба пути (UI и SQL), generic-команды по образцу SETUP_WEBHOOKS.md с плейсхолдерами |
+| 6 | Подключение Gitea | репо (`onboard_project.py` или вручную); токен scope `repo`,`admin:repo_hook` + проверка; per-repo webhook (`push`/`pull_request`/`status`, `X-Gitea-Signature`, ОДИН глобальный секрет); **норматив D3: branch protection НЕ включать** |
+| 7 | LLM (claude CLI) | дистрибутив claude-code и node на хосте = источники маунтов (`ORCH_HOST_CLAUDE_CODE_DIR`/`ORCH_HOST_NODE_BIN`); аутентификация CLI (`ORCH_HOST_CLAUDE_DIR`/`ORCH_HOST_CLAUDE_JSON`); проверка `claude --version`; модели — `ORCH_AGENT_MODEL_*`/`ORCH_AGENT_EFFORT_*` (резолв ORCH-41, дефолты — `.env.example`) |
+| 8 | Telegram | бот трекера (BotFather → `ORCH_TELEGRAM_BOT_TOKEN`), `chat_id` через `getUpdates`, проверка `getMe`; **отдельный** watchdog-бот → `.env.watchdog` (C-1 ORCH-100: токен орка переиспользовать ЗАПРЕЩЕНО) |
+| 9 | Запуск | `docker compose config` → `up -d --build` → ровно `orchestrator`+`orchestrator-watchdog` (D4); health-чек `GET /health` → 200 `"status":"ok"`, `/queue`+`/metrics` → штатный JSON (`schema_version: 1`); **вилка staging (D6)** |
+| 10 | Регистрация проекта | `onboard_project.py plan → apply → verify` (статусы+лейблы `autoApprove`/`autoDeploy`/`Bug`, репо+webhook, kit, merged `ORCH_PROJECTS_JSON`) → строка в `.env` → управляемый рестарт → `/health`+`/queue`; маршрут — ссылка ONBOARDING.md, в доке — последовательность команд Lite |
+| 11 | Smoke | чек-лист REPLICATION.md §4 (шаги 0–5, опционально 6 до `done`) ссылкой + Lite-предусловия; критерий «конвейер доехал»: задача в БД → analyst-job в `/queue` → артефакты `01–04` в ветке |
+| 12 | Stateless-проверка | первый старт = пустая БД (`data/` чист); `GET /queue` — нулевые счётчики, ни одной задачи `ORCH-*`/`ET-*`; нормативная строка «данные/задачи/секреты боевого хоста НЕ переносятся» |
+| 13 | Траблшутинг | ≥ 5 отказов, каждый «симптом → команда диагностики → лечение»: webhook 401/HMAC mismatch; задача не появилась (реестр/`ORCH_PROJECTS_JSON`/webhook); claude CLI не найден/не аутентифицирован; docker.sock permission denied (`ORCH_DOCKER_GID`); права `/repos` (uid mismatch, ORCH-040/057); Telegram молчит |
+
+**Форма (нормативно, NFR-6/BR-1):** (а) каждый нормативный шаг = fenced-команда + явная проверка
+(маркер «Проверка:» / PASS/FAIL / ожидаемый вывод); (б) хост-специфика в fenced-блоках — ТОЛЬКО
+плейсхолдеры `<...>`/`$ENV_VAR`; боевые литералы (`mva154`, `duckdns`, `82.22.50.71`, реальные
+токены) запрещены; дефолты хост-переменных НЕ копируются в док — ссылка на карту
+REPLICATION.md §2 (иначе fenced-скан D8 и форк канона); (в) язык — русский; (г) футер дока несёт
+норматив сопровождения (NFR-5: меняешь шаги тиража → обнови LITE_SETUP.md в том же PR,
+правило агентов №2).
+
+Привязка: FR-1, FR-3, FR-4, AC-1, AC-3.
+
+### D3 (исход А-1) — Раздел Gitea: канон D10, pre-receive НЕ вводить
+
+**Решение: раздел Gitea фиксирует канон платформы — репо + токен (scope `repo`,
+`admin:repo_hook`) + per-repo webhook + нормативная рамка «branch protection на `main` НЕ
+включать».** Формулировка бизнес-запроса «pre-receive хуки» трактуется по намерению («защита
+`main`») и закрывается действующей моделью: мерж — только через Gitea PR-merge API под токеном
+орка (INV-4, `src/merge_gate.py`); агенты не пушат `main` (конвенция + скоуп токенов).
+Pre-receive хуки НЕ вводятся: это server-side механизм инсталляции Gitea заказчика, платформа
+его не несёт и не проверяет; required-approvals/status-checks дали бы 405/409-класс отказов
+`merge_pr` → ложные HOLD (ORCH-009 ADR-001 D10, инцидент ORCH-063). В §13 (траблшутинг) —
+симптом «PR не мержится / HOLD» с первой проверкой «не включена ли branch protection».
+Пересмотр — только отдельным ADR с анализом совместимости с merge-актором (ORCH-093/INV-4).
+
+Привязка: BRD §1.3/§6, FR-1 п.6, AC-7.
+
+### D4 (исход А-2) — Compose: существующий файл, без lite-форка; свойство держит тест
+
+**Решение: `docker-compose.yml` НЕ форкается** — он уже является Lite-подмножеством (факт из
+контекста). Отдельный `docker-compose.lite.yml` отвергнут: второй файл = вторая правда =
+поверхность дрейфа (зеркало решения D9 ORCH-101 «без скрипта-обвязки»). Свойство фиксируется
+в LITE_SETUP.md §9 и защищается тестом (D8, TC-04) через `yaml.safe_load` (паттерн
+`tests/test_infra_parametrization.py::_compose_services`):
+
+- `set(services) == {"orchestrator", "orchestrator-watchdog", "orchestrator-staging"}`;
+- `services["orchestrator-staging"]["profiles"] == ["staging"]`;
+- множество сервисов без `profiles` (= дефолтный `up -d`) — ровно
+  `{"orchestrator", "orchestrator-watchdog"}`;
+- ни в имени сервиса, ни в `image:`/`container_name:` нет подстрок `plane`/`gitea`
+  (анти-появление молча).
+
+Привязка: FR-2, AC-2, BR-3.
+
+### D5 (исход А-4) — `.env.watchdog.example`: создать; key-set синхронизирован тестом
+
+**Решение: создать `.env.watchdog.example`** — третий канонический env-example
+(симметрия `.env.example`/`.env.staging.example`), единственное разрешённое отклонение диффа от
+docs+tests (предусмотрено ТЗ §2). Нормативное содержимое:
+
+- **полный набор ключей `WATCHDOG_*` — ровно тот же, что блок `WATCHDOG_*` в `.env.example`**
+  (key-set equality, 19 ключей; значения = дефолты канона/`watchdog/config.py`,
+  токены — пустые плейсхолдеры);
+- шапка-комментарий: семантика файла-носителя — sidecar-контейнер читает ТОЛЬКО `.env.watchdog`
+  (compose `env_file: required: false`; отсутствие файла не ломает `up`; нет токена → fail-safe:
+  логи без отправки); **ключ `WATCHDOG_*` в `.env` для sidecar инертен**;
+- норматив C-1 (ORCH-100): свой бот, независимый канал; токен орка переиспользовать запрещено;
+- когерентность порта: `WATCHDOG_METRICS_URL` следует за `ORCH_DEPLOY_PROD_TARGET_PORT`;
+- «не коммить реальный `.env.watchdog`» (зеркало шапки `.env.staging.example`).
+
+Анти-дрейф (D8, TC-02b): `keys(.env.watchdog.example) == {k ∈ keys(.env.example) |
+k.startswith("WATCHDOG_")}` — появление нового ключа watchdog в каноне без обновления example
+(и наоборот) ломает CI. Это дубль по необходимости, защищённый сверкой парсингом, не строкой
+(NFR-4). LITE_SETUP.md §4/§8 предписывают `cp .env.watchdog.example .env.watchdog` + два токена.
+
+Привязка: FR-1 п.4/п.8, FR-6.2, AC-1, AC-7 (C-1).
+
+### D6 (исход А-5) — Staging-контур в Lite: опционален, явная вилка
+
+**Решение: базовый Lite-контур = prod-оркестратор (8500) + watchdog; `orchestrator-staging`
+НЕ обязателен.** Staging нужен ТОЛЬКО если заказчик регистрирует проект `orchestrator`
+(self-hosting развитие самой платформы у себя): стадия `deploy-staging` орка требует
+песочницу 8501 (`.env.staging` от `.env.staging.example`, изолированная БД `./data/staging`,
+guard ORCH-058: staging-порт ≠ прод-порт — fail-closed). Для целевого сценария «раздача на
+тест» (заказчик гоняет СВОИ проекты) staging не участвует. В §9 — явная вилка двумя ветками
+с командами; дефолтная ветка — без staging.
+
+Привязка: FR-1 п.9, AC-2 (staging за профилем), ТЗ §3.8 А-5.
+
+### D7 (исход А-6) — Источник кода: параметризованный шаг
+
+**Решение: шаг §3 — `git clone <ORCHESTRATOR_GIT_URL> <ORCH_DEPLOY_HOST_REPO_PATH>`** (плюс
+опциональный `--branch <тег/срез>`). Конкретный канал дистрибуции (зеркало, доступ к нашему
+Gitea, архив) — решение Владельца ВНЕ репо (коммерческая механика — анти-скоуп BRD §2.2);
+док не хардкодит наш Gitea-URL (это же требует NFR-3/fenced-скан). Плейсхолдер
+`<ORCHESTRATOR_GIT_URL>` включён в перечень подстановок §3.
+
+Привязка: FR-1 п.3, BRD §6, ТЗ §3.8 А-6.
+
+### D8 (FR-6) — Анти-дрейф контур: `tests/test_lite_setup_doc.py`
+
+**Решение: один структурный модуль, детерминированный, без сети/LLM/subprocess** (образец —
+`tests/test_replication_smoke.py`). Нормативные семейства проверок (точная нарезка по
+тест-функциям — за developer, `04-test-plan.yaml`):
+
+| TC | Проверка | Механика |
+|----|----------|----------|
+| TC-01 | Док существует; 13 нормативных разделов D2 присутствуют **в заданном порядке** | regex по заголовкам `^## N\.` |
+| TC-02 | Обязательные кирпичи FR-6.1: `gen_secrets.py`, `onboard_project.py`, `docker compose`, `/health`, `/queue`, `/metrics`, `ORCH_PROJECTS_JSON`, оба webhook-секрета, `X-Plane-Signature`/`X-Gitea-Signature`, `getent group docker`, `Confirm Deploy`/`STOP`, оба Telegram-канала, маркеры PASS/FAIL/«Проверка» | подстроки |
+| TC-02b | Key-sync `.env.watchdog.example` ⇄ блок `WATCHDOG_*` `.env.example` (D5) | парсинг строк `^KEY=` обоих файлов, равенство множеств |
+| TC-03 | Каждый токен `\b(ORCH\|WATCHDOG)_[A-Z0-9_]+\b` из дока существует ключом в `.env.example` (канон 100% ключей, ORCH-101) | regex по доку + парсинг `.env.example` |
+| TC-04 | Compose-подмножество (D4): 3 сервиса, staging за профилем, дефолтный up = орк+watchdog, нет `plane*`/`gitea*` | `yaml.safe_load` |
+| TC-05 | Stateless/гигиена: нормативная строка «не перенос…» присутствует; **в fenced-блоках** нет литералов центрального списка `FORBIDDEN` (импорт из `tests/test_no_host_hardcodes.py`, НЕ копия — один источник истины) и секретоподобных значений (эвристика: hex/base64 ≥ 32 симв., не плейсхолдер) | выделение fenced-блоков + `find_violations`/эвристика |
+| TC-06 | Перекрёстность: `REPLICATION.md` §1 ссылается на `LITE_SETUP.md`; `CHANGELOG.md` несёт `ORCH-102` | подстроки |
+
+Скоуп секрет/литерал-скана — **только fenced-блоки** (копируемое); проза дока дефолтов не
+дублирует (D2-форма, п. б) — поэтому полнодокументный скан не нужен и не даёт ложно-красных.
+Существующие тесты (`test_no_host_hardcodes`, `test_replication_smoke`,
+`test_infra_parametrization`, `test_onboarding_*`) не ослабляются; новые тесты попадают в
+существующие гейты (`check_ci_green`/`check_tests_passed`/merge-gate re-test/coverage ORCH-027)
+автоматически — новый QG НЕ регистрируется (ТЗ §6).
+
+Привязка: FR-6, BR-8, AC-5, AC-6.
+
+### D9 — Границы изменения; что НЕ делается; 07/08 — N/A
+
+- **Дифф задачи:** `docs/**` (LITE_SETUP.md, правки REPLICATION §1/INFRA/README/CLAUDE.md по
+  объёму), `tests/test_lite_setup_doc.py`, `CHANGELOG.md`, `.env.watchdog.example` (D5).
+  **`src/**`, `docker-compose.yml`, `Dockerfile`, `scripts/**` — ноль изменений**; любое
+  отклонение — только новым ADR (AC-7).
+- `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict ключи/схема БД — байт-в-байт; новых
+  эндпоинтов/флагов/kill-switch нет (выключать нечего — D-4: док и тесты).
+- **`07-infra-requirements.md` / `08-data-requirements.md` — N/A:** топология не меняется (ни
+  контейнера, ни порта, ни маунта), схема БД не меняется (ТЗ §5). Инфра-предусловий нет:
+  приёмочный smoke-прогон (FR-5/AC-4) идёт на СУЩЕСТВУЮЩЕМ контуре — staging-песочница
+  `ORCH_STAGING_PORT`=8501 + одноразовый sandbox-проект (прецедент ORCH-101 AC-3 /
+  ONBOARDING.md §5); прогон на реальном новом хосте желателен, но не требование приёмки.
+- **Self-hosting (NFR-1):** прод-контейнер не рестартится; выкат — штатный конвейер
+  (deploy-staging 8501 → ручной `Confirm Deploy`). Для enduro-trails изменение инертно.
+- Эскалация: `arch:major-change` не требуется (нет новой стадии/компонента/смены БД); ТЗ
+  удовлетворимо без нарушения принципов — возврат в анализ не нужен.
+
+## Альтернативы
+
+- **Разместить инструкцию в `docs/operations/`** — отвергнуто: целевой читатель другой (внешний
+  оператор, не оператор нашего прода); путь `docs/deployment/LITE_SETUP.md` зафиксирован
+  Владельцем (D-4), отступать не от чего (D1).
+- **Перенести REPLICATION.md в `docs/deployment/`** — отвергнуто: правка чужого артефакта и
+  путей `tests/test_replication_smoke.py` без выгоды; перекрёстных ссылок достаточно (D1).
+- **Отдельный `docker-compose.lite.yml`** — отвергнуто: вторая правда о сервисах, дрейф-
+  поверхность; существующий файл уже = подмножество, тест дешевле форка (D4).
+- **Pre-receive хуки / branch protection для «защиты `main`»** — отвергнуто: ломает PR-merge
+  API merge-актора (D10 ORCH-009, ложные HOLD); защита — конвенция + скоуп токенов + INV-4 (D3).
+- **Без `.env.watchdog.example`, шаг «создай файл с двумя ключами» в доке** — отвергнуто:
+  двусмысленность файла-носителя остаётся (ключи канонизированы в `.env.example`, но там для
+  sidecar инертны); example-файл + key-sync тест дешевле и надёжнее прозы (D5).
+- **Скопировать таблицу 22 статусов / карту env в LITE_SETUP.md** — отвергнуто: форк канона
+  (R-2); ссылки на golden source + явное упоминание только fail-closed имён
+  (`Confirm Deploy`/`STOP`) — достаточно (FR-4); дубль допустим только с тест-сверкой
+  парсингом/импортом (прецедент — TC-02b).
+- **Полнодокументный секрет-скан (не только fenced)** — отвергнуто: ложно-красные на прозе
+  («не используйте mva154-значения»); норматив D2(б) выводит дефолты из дока, fenced-скан
+  покрывает всё копируемое (D8).
+
+## Последствия
+
+- **+** Закрывается Type A эпика ORCH-10: заказчик получает единый исполняемый маршрут
+  «голый хост → конвейер» без археологии по 4 докам; Type B (Bundled) строится поверх
+  (переиспользует §2–§8, §11–§13).
+- **+** Compose-подмножество и полнота инструкции из «фактов» становятся CI-гарантиями
+  (TC-01…TC-06); ловушка файла-носителя watchdog-конфига закрыта каноном (D5).
+- **+** Нулевой риск рантайма: docs+tests, конвейер байт-в-байт, kill-switch не нужен.
+- **−** Новый golden source = новая обязанность сопровождения (шаги тиража меняются →
+  LITE_SETUP.md в том же PR; NFR-5) — митигировано футером-нормативом, правилом агентов №2 и
+  структурным тестом, который рвёт CI при дрейфе кирпичей.
+- **−** Дубль ключей `WATCHDOG_*` в двух example-файлах — принят осознанно, защищён key-sync
+  тестом TC-02b (равенство множеств, не строк).
+- **−** Приёмка «без доп-вопросов» на staging-песочнице ≠ прогон на реальном чужом хосте —
+  остаточный риск принят (прецедент ORCH-101 AC-3); зазор сужают чек-команды предусловий §2 и
+  траблшутинг §13.
+- **Откат:** удалить `docs/deployment/`, `tests/test_lite_setup_doc.py`,
+  `.env.watchdog.example`, вернуть строку REPLICATION.md §1 — состояние 1:1, ни миграций,
+  ни состояния (ТЗ §7).
+
+## Ссылки
+
+- BRD: `docs/work-items/ORCH-102/01-brd.md` (решения Владельца D-1…D-5, факты §1.3)
+- TRZ: `docs/work-items/ORCH-102/02-trz.md` (FR-1…FR-7, вопросы §3.8 А-1…А-6)
+- Acceptance: `docs/work-items/ORCH-102/03-acceptance-criteria.md` (AC-1…AC-7)
+- Риски: `docs/work-items/ORCH-102/10-tech-risks.md`
+- Сквозной ADR: `docs/architecture/adr/adr-0037-lite-replication-canon.md`
+- Сверено по коду/репо: `docker-compose.yml` (3 сервиса, `profiles: [staging]`,
+  `env_file: {path: .env.watchdog, required: false}`), `.env.example` (блок `WATCHDOG_*`,
+  19 ключей), `watchdog/config.py` (дефолты), `tests/test_infra_parametrization.py`
+  (`yaml.safe_load`-паттерн), `tests/test_no_host_hardcodes.py` (`FORBIDDEN`,
+  `find_violations`), `tests/test_replication_smoke.py` (образец структурного теста дока),
+  `docs/operations/REPLICATION.md` §1–§5, `docs/operations/ONBOARDING.md` §1/§5,
+  `docs/operations/SETUP_WEBHOOKS.md`
+- Инварианты соседних решений: ORCH-009 ADR-001 D10 (`docs/work-items/ORCH-009/06-adr/…`),
+  adr-0036 (ORCH-101, 10-common), adr-0035 (onboarding), adr-0033 (sidecar-watchdog, C-1
+  ORCH-100), ORCH-040 (uid/gid/HOME), ORCH-058 (staging-порт guard), INV-4 (ORCH-093)

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

@@ -0,0 +1,40 @@
+---
+work_item: ORCH-102
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+---
+
+# 10 — Технические риски: ORCH-102 — ORCH-10a Lite-тираж (инструкция + анти-дрейф)
+
+Work Item: **ORCH-102** · Repo: **orchestrator** · Стадия: architecture
+
+> Информационный (гейтом не парсится). Перечисляет риски реализации и их митигейшн.
+> Решения, на которые ссылаются митигейшны (D1…D9), — `06-adr/ADR-001-lite-setup-doc-canon.md`.
+
+## Реестр рисков
+
+| ID | Риск | Вер. | Влия. | Митигейшн |
+|----|------|------|-------|-----------|
+| TR-1 | **Дрейф инструкции**: платформа развивается, шаги LITE_SETUP.md тихо устаревают (новый env-ключ, изменённый маршрут онбординга) | Сред. | Сред. | Структурный `tests/test_lite_setup_doc.py` (D8: кирпичи, env-ключи ⊂ `.env.example`, compose-подмножество, перекрёстность) рвёт CI при дрейфе; футер-норматив NFR-5 + правило агентов №2 («шаги тиража → док в том же PR»); reviewer-ось обзорных доков (правило №6) |
+| TR-2 | **Форк канона**: скопированная в док таблица статусов/env/вебхуков разъезжается с golden source | Низ. | Сред. | D2/FR-4: канон — только ссылками (ONBOARDING §1 / REPLICATION §2–§4 / SETUP_WEBHOOKS); в доке дублируются лишь fail-closed имена (`Confirm Deploy`/`STOP`) и списки обязательных ключей — оба под TC-02/TC-03; единственный структурный дубль (`WATCHDOG_*`) — под key-sync TC-02b |
+| TR-3 | **«Без доп-вопросов» непроверяемо**: реальный заказчик найдёт пробел, который не увидел внутренний прогон | Сред. | Низ. | Операционализация BRD §6: каждый шаг = команда+проверка (TC-01/02), приёмочный smoke-прогон на чистом контуре фиксируется в `13-test-report.md`/`15-staging-log.md`, траблшутинг ≥5 отказов (§13). Остаточные пробелы лечатся правкой golden source штатной задачей |
+| TR-4 | **Гетерогенность хостов заказчиков**: rootless docker, иной uid владельца репо, нет node/claude-code, arm64 | Сред. | Сред. | §2 «Предусловия» с явным поддерживаемым контуром (Linux x86_64, Docker+Compose v2, git, python3, node) и чек-командой на каждое предусловие (`getent group docker`, владение `ORCH_HOST_REPOS_DIR` = `ORCH_RUN_UID`); вне контура — вне гарантии Lite (BRD §6); §13 покрывает типовые отказы (docker.sock gid, uid mismatch ORCH-040/057) |
+| TR-5 | **Заказчик включит branch protection / pre-receive на `main`** вопреки нормативу → ложные HOLD merge-актора на ЕГО инсталляции (класс ORCH-063) | Низ. | Выс. (у заказчика) | D3: явная нормативная рамка в §6 («НЕ включать», основание D10 ORCH-009/INV-4) + симптом в §13 («PR не мержится/HOLD → проверь protection»); для нашего прода риск нулевой (его Gitea не трогается) |
+| TR-6 | **Утечка секрета/боевого литерала** через примеры дока или `.env.watchdog.example` | Низ. | Выс. | NFR-3: только плейсхолдеры; TC-05 — fenced-скан на `FORBIDDEN` (импорт из `test_no_host_hardcodes.py`, один источник истины) + эвристика секретоподобных значений; security-гейт ORCH-022 (`17-security-report.md`) обязан остаться PASS; D2(б): дефолты хост-переменных в док не копируются |
+| TR-7 | **Хрупкость анти-дрейф теста**: ложно-красный CI от безобидной правки прозы → соблазн ослабить тест | Сред. | Низ. | D8: ассерты только на стабильное (заголовки `## N.`, подстроки-кирпичи, парсинг env-ключей, `yaml.safe_load`), запреты — только в fenced-блоках; никаких проверок прозы/формулировок; паттерн уже обкатан (`test_replication_smoke.py` стабилен) |
+| TR-8 | **`.env.watchdog.example` разъезжается** с блоком `WATCHDOG_*` `.env.example` / дефолтами `watchdog/config.py` | Низ. | Низ. | TC-02b: равенство множеств ключей двух файлов; значения = дефолты канона (сверены с `watchdog/config.py` при ревью); полнота самого `.env.example` уже держится тестами ORCH-101 |
+| TR-9 | **Приёмочный smoke на staging-песочнице ≠ голый чужой хост**: средовые эффекты нового железа (сеть, версии docker) не проверены | Сред. | Низ. | Принятый прецедент ORCH-101 AC-3 (без нового железа в контуре задачи; FR-5(г) — прогон на реальном хосте желателен, не блокер); зазор сужают чек-команды §2 и траблшутинг §13; первый реальный тираж — операторски сопровождаемый |
+
+## Сводный вывод
+
+Доминирующий класс — **документационный** (дрейф/полнота/гигиена), систематически закрытый
+структурными тестами (TC-01…TC-06) и нормативом golden source; рантайм-рисков нет — дифф
+docs+tests (+`.env.watchdog.example`), конвейер и `src/**` байт-в-байт (D9), kill-switch не
+требуется. Самый тяжёлый по влиянию риск (TR-5) материализуется только на инсталляции
+заказчика и купирован явным нормативом + траблшутингом. Эскалация `arch:major-change` не
+требуется; возврат в анализ не нужен. **Остаточный риск для self-hosting прод-конвейера —
+минимальный** (прод-контейнер не трогается; выкат — штатно через staging 8501 →
+`Confirm Deploy`).

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

@@ -0,0 +1,93 @@
+---
+verdict: APPROVED
+work_item: ORCH-102
+stage: review
+author_agent: reviewer
+status: approved
+created_at: 2026-06-10
+model_used: claude-opus-4-8
+type: review
+work_item_id: ORCH-102
+version: 1
+---
+
+# Review ORCH-102 — ORCH-10a Lite-тираж: LITE_SETUP.md + канон watchdog-конфига + анти-дрейф контур
+
+## Summary
+
+PR (`d03e29f`, docs+tests, 2378 строк) реализует все требования ТЗ и решения ADR-001 (D1–D9)
+точно по спецификации; P0/P1 findings отсутствуют. Дифф строго в декларированных границах:
+`docs/**`, `tests/test_lite_setup_doc.py`, `CHANGELOG.md`, `.env.watchdog.example` + `.gitignore`
+(единственное разрешённое отклонение по ADR D5/ТЗ §2). **`src/**`, `docker-compose.yml`,
+`Dockerfile`, `scripts/**` — ноль изменений** (AC-7 PASS, сверено по `git diff --stat`);
+`STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД не тронуты.
+
+**Проверено фактически (не по описанию):**
+- Полный регресс: `pytest tests/ -q` → **1789 passed** (включая 25 новых структурных тестов;
+  заявление CHANGELOG «25 структурных тестов» совпадает с фактом). Существующие
+  `test_no_host_hardcodes`/`test_replication_smoke`/`test_infra_parametrization` не ослаблены.
+- **AC-1/FR-1:** `docs/deployment/LITE_SETUP.md` — 13 нормативных разделов D2 в порядке маршрута
+  оператора; каждый исполняемый раздел = fenced-команда + явная «Проверка:»/PASS/FAIL;
+  хост-специфика только плейсхолдерами. Копируемые команды сверены с фактическими контрактами
+  кода: флаги `onboard_project.py` (`plan|apply|verify` + `--name/--repo/--prefix/--stack/
+  --test-cmd/--prod-port/--staging-port/--webhook-url`) — совпадают с argparse скрипта;
+  exit-коды (0/2 = manual-step) — совпадают с docstring/кодом; `gen_secrets.py` печатает именно
+  `ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET`; `/metrics` → `schema_version: 1`
+  (`src/metrics.py::SCHEMA_VERSION`); ссылка на шаги 0–5/6 REPLICATION §4 — фактическая нумерация
+  таблицы §4 совпадает. Траблшутинг — 7 отказов (≥5 по AC-1), каждый «симптом → диагностика → лечение».
+- **AC-2/FR-2 (D4):** compose не форкается; TC-04 ассертит ровно 3 сервиса, staging строго за
+  `profiles: [staging]`, дефолтный up = орк+watchdog, анти-`plane*`/`gitea*` — через `yaml.safe_load`.
+- **AC-3/FR-3:** stateless-норматив (§12 + шапка), чистый старт, проверка чистоты через
+  `GET /queue`, секреты только свежевыпущенные; в fenced-блоках и `.env.watchdog.example` —
+  только плейсхолдеры (TC-05 + зеркальный placeholder-тест, токены пустые).
+- **D5:** `.env.watchdog.example` — key-set ровно = блоку `WATCHDOG_*` `.env.example` (19 ключей,
+  сверено; держится TC-02b равенством множеств), шапка несёт семантику файла-носителя, C-1
+  ORCH-100, когерентность порта, do-not-commit; `.env.watchdog` добавлен в `.gitignore`.
+- **AC-6/FR-6 (D8):** канон не форкается — статусы/env/вебхуки/smoke ссылками; «22 статуса»
+  защищено **импортом** `plane_sync._PLANE_NAME_TO_KEY` (не строкой); `FORBIDDEN` — импорт из
+  `test_no_host_hardcodes.py` (один источник истины); секрет-эвристика с негативным самочеком
+  (анти-вечнозелёность). Тесты детерминированы, без сети/LLM/subprocess.
+- **D3 (исход А-1):** §6.4 нормативно запрещает branch protection на `main` (ADR D10 ORCH-009 /
+  INV-4), pre-receive не вводится, ОДИН глобальный webhook-секрет; §13.7 — симптом «HOLD».
+- **Трассировка (TRACEABILITY):** правки чужих маркированных блоков сверены: REPLICATION.md §1
+  (ORCH-101) — ровно предусмотренное закрытие строки «Type A — Lite» → ✅ + ссылка; INFRA.md —
+  аддитивное расширение секрет-норматива на `.env.watchdog`; инварианты ORCH-101/009/100/040/058/
+  INV-4 не нарушены (инструкция им следует, ADR их цитирует). Бонус: дозаполнена пропущенная
+  строка adr-0036 в индексе `docs/architecture/adr/README.md` + max-номер → 0037.
+
+## Findings
+
+### P0 — Blocker
+Нет.
+
+### P1 — Must fix
+Нет.
+
+### P2 — Should fix
+Нет.
+
+### P3 — Nice to have (не блокирует)
+- [ ] `LITE_SETUP.md` §13.3: в fenced-блоке литерал `/usr/bin/claude` — совпадает с канон-дефолтом
+  `ORCH_CLAUDE_BIN` (контейнерный layout, не хост-специфика), но `docker exec orchestrator
+  "$ORCH_CLAUDE_BIN" --version`-форма была бы устойчивее к смене дефолта (правило формы D2(б) —
+  ссылка на канон вместо копии значения).
+- [ ] `tests/test_lite_setup_doc.py` BRICKS: кирпич `"STOP"` как подстрока всего дока слаб
+  (матчится любым словом STOP); фактически заякорен `test_plane_canon_is_linked_not_forked`
+  (STOP внутри тела §5), так что дублирование безвредно — можно убрать из BRICKS или заякорить.
+
+## Документация
+
+**Полностью обновлена в том же PR** (правило №2; ось 4 — PASS):
+- `CHANGELOG.md` — запись ORCH-102 (фактуально точная: 25 тестов, траблшутинг ×7 — сверено);
+- `CLAUDE.md` — блок «Lite-тираж (ORCH-102)»; `README.md` — способность Lite + `docs/deployment/`
+  в структуре; `docs/architecture/README.md` — блок Type A — Lite;
+- ADR: per-work-item `06-adr/ADR-001-lite-setup-doc-canon.md` (D1–D9, исходы А-1…А-6) + сквозной
+  `docs/architecture/adr/adr-0037-lite-replication-canon.md` + индекс ADR обновлён;
+- `docs/operations/REPLICATION.md` §1 и `docs/operations/INFRA.md` — перекрёстные ссылки (FR-7);
+- **ORCH-079 (обзорные доки):** README «Известные ограничения» проверен — пунктов про
+  тираж/Lite в открытом списке не было и нет, закрывать/снимать нечего; противоречий факту нет.
+
+**Handoff для tester (не finding):** AC-4 требует фиксации приёмочного smoke-прогона на чистом
+контуре (staging-песочница + sandbox-проект) в `13-test-report.md` и/или `15-staging-log.md` —
+эти артефакты по конвейеру создаются на стадиях testing/deploy-staging (план — TC-09
+`04-test-plan.yaml`); на стадии review их отсутствие штатно.

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

@@ -0,0 +1,95 @@
+---
+result: PASS   # PASS | FAIL — машинный вердикт, UPPERCASE
+work_item: ORCH-102
+stage: testing
+author_agent: tester
+status: pass
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+type: test-report
+work_item_id: ORCH-102
+---
+
+# Test Report — ORCH-102 — ORCH-10a Lite-тираж: LITE_SETUP.md + канон watchdog-конфига + анти-дрейф контур
+
+## Окружение
+- Python: 3.12.13
+- pytest: 8.3.3 (plugins: cov-5.0.0, anyio-4.13.0, asyncio-0.23.8)
+- Дата: 2026-06-11
+- Worktree: `/repos/_wt/orchestrator/feature_ORCH-102-orch-10a-lite-watchdog`
+- Ветка: `feature/ORCH-102-orch-10a-lite-watchdog` (HEAD `e67c026`)
+- Прогон выполнен в worktree ветки задачи (не в общем `/repos/orchestrator`).
+- Вердикт ревью (`12-review.md`): **APPROVED** (P0/P1 — нет).
+
+## Smoke API (read-only)
+| Проверка | Результат |
+|----------|-----------|
+| `GET /health` | PASS — `{"status":"ok","service":"orchestrator"}` |
+| `GET /status` | PASS — задача ORCH-102 (task 89) на стадии `testing` |
+| `GET /queue` | PASS — отдаёт полезную нагрузку, штатные счётчики |
+| Блок `serial_gate` в `/queue` (ORCH-088) | PASS — присутствует; `orchestrator.active_task = ORCH-102 (testing)`, не заморожен |
+| Блок `auto_labels` в `/queue` (ORCH-089) | PASS — присутствует |
+| `GET /metrics` | PASS — `schema_version: 1` |
+| `GET /health` staging (8501) | PASS — `{"status":"ok","service":"orchestrator"}` |
+
+## Smoke-процедура Lite-тиража (AC-4 / FR-5, TC-09)
+Воспроизводимость smoke-runbook LITE_SETUP.md подтверждена на текущей инфре (read-only, stateless,
+без переноса данных/секретов; прецедент ORCH-101 AC-3). Docs+tests-задача — `src/**` не тронут,
+полноценный e2e на новом железе заказчика заменён прогоном артефактов smoke-цепочки:
+| Шаг smoke (REPLICATION §4 / LITE_SETUP §10–12) | Результат |
+|-----|-----------|
+| `docs/deployment/LITE_SETUP.md` существует по канонному пути (33 КБ, 13 разделов) | PASS |
+| `.env.watchdog.example` существует (канон watchdog-конфига, ADR D5) | PASS |
+| `scripts/gen_secrets.py` запускается в безопасном (print) режиме | PASS — exit 0, файлы не тронуты (`git status` чист) |
+| Webhook-секреты крипто-случайны (64 hex = 32 байта) | PASS — `ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET` |
+| Внешние токены/боевые секреты в доке отсутствуют (плейсхолдеры) | PASS (подтверждено TC-05) |
+| Конфиг резолвится, инстанс поднят, health-check зелёный (см. Smoke API) | PASS |
+| `GET /metrics` → `schema_version: 1` | PASS |
+| Compose-подмножество (ровно орк+watchdog, staging за профилем) | PASS — структурно через TC-04 (yaml-парс; `docker` CLI в песочнице tester'а недоступен, свойство фиксируется тестом) |
+
+## Результаты (покрытие TC из `04-test-plan.yaml`)
+
+| TC ID | Описание | Покрывающие тесты | Результат |
+|-------|----------|-------------------|-----------|
+| TC-01 | LITE_SETUP.md существует по канонному пути и несёт ВСЕ 13 нормативных разделов FR-1 (AC-1/FR-1) | `test_lite_setup_doc::test_doc_exists_with_all_13_sections_in_order`, `test_doc_carries_all_mandatory_bricks` | PASS |
+| TC-02 | Форма «каждый шаг — команда/проверка»: fenced-команды + маркеры PASS/FAIL/«Проверка», ключевые кирпичи (AC-1/FR-1, NFR-6) | `test_every_normative_section_carries_commands`, `test_doc_carries_explicit_check_markers` | PASS |
+| TC-03 | Согласованность env-канона: каждый `ORCH_*`/`WATCHDOG_*` в доке есть в `.env.example`; обязательный набор нового хоста явно (AC-1/AC-6/FR-1.4/FR-6.2) | `test_every_env_token_in_doc_exists_in_env_example`, `test_mandatory_new_host_keys_are_explicit`, `test_watchdog_example_keys_sync_with_env_example_block` | PASS |
+| TC-04 | Compose-подмножество: ровно `{orchestrator, orchestrator-watchdog, orchestrator-staging}`, staging за `profiles:[staging]`, без `plane*`/`gitea*` (AC-2/FR-2) | `test_compose_services_are_exactly_the_lite_set`, `test_compose_staging_is_strictly_behind_profile`, `test_compose_has_no_plane_or_gitea_services`, `test_doc_documents_default_up_composition` | PASS |
+| TC-05 | Stateless и секрет-гигиена: нормативная строка «не копируются», чистая БД + новые секреты, проверка чистоты, нет боевых литералов/секретов в код-блоках (AC-3/FR-3/NFR-3) | `test_doc_has_stateless_normative_line`, `test_doc_prescribes_clean_db_and_fresh_secrets`, `test_fenced_blocks_carry_no_forbidden_literals`, `test_fenced_blocks_carry_no_secret_like_values`, `test_secret_heuristic_is_not_evergreen`, `test_watchdog_example_secrets_are_placeholders_only` | PASS |
+| TC-06 | Канон не форкается: статусы ссылкой на ONBOARDING §1 + fail-closed `Confirm Deploy`/`STOP`; «22 статуса» сверены импортом `plane_sync._PLANE_NAME_TO_KEY`; env/smoke ссылкой на REPLICATION (AC-6/FR-4/NFR-4) | `test_plane_canon_is_linked_not_forked`, `test_status_count_claim_matches_plane_sync`, `test_env_map_and_smoke_are_linked_to_replication` | PASS |
+| TC-07 | Раздел Gitea: события `push/pull_request/status`, ОДИН глобальный webhook-секрет, норматив «branch protection НЕ включать» (ADR D10 ORCH-009) (AC-1/AC-7/FR-1.6/§3.8 А-1) | `test_gitea_section_fixes_platform_invariants`, `test_gitea_section_forbids_branch_protection` | PASS |
+| TC-08 | Перекрёстная документация: REPLICATION §1 ссылается на LITE_SETUP; CHANGELOG несёт ORCH-102 (AC-5/FR-7) | `test_replication_boundaries_reference_lite_setup`, `test_changelog_has_orch_102_entry` | PASS |
+| TC-09 | Приёмочный smoke-прогон по LITE_SETUP на чистом контуре; вердикт фиксируется tester'ом (процедура, не pytest) (AC-4/FR-5) | см. раздел «Smoke-процедура Lite-тиража» + «Smoke API» выше | PASS |
+| TC-10 | Полный регресс `pytest tests/ -q` зелёный; существующие структурные тесты не ослаблены; дифф не трогает машину стадий/QG/вердикты/схему БД (AC-5/AC-7/NFR-2) | весь набор — **1789 passed** | PASS |
+
+Соответствие критериям `03-acceptance-criteria.md`: AC-1 (TC-01/02/03), AC-2 (TC-04), AC-3 (TC-05),
+AC-4 (TC-09 + smoke-процедура), AC-5 (TC-08/TC-10), AC-6 (TC-03/06), AC-7 (TC-07/TC-10) — все
+покрыты и зелёные.
+
+## Вывод pytest
+```
+============================= test session starts ==============================
+platform linux -- Python 3.12.13, pytest-8.3.3, pluggy-1.6.0
+rootdir: /repos/_wt/orchestrator/feature_ORCH-102-orch-10a-lite-watchdog
+configfile: pytest.ini
+plugins: cov-5.0.0, anyio-4.13.0, asyncio-0.23.8
+........................................................................ [100%]
+================== 1789 passed, 1 warning in 64.06s (0:01:04) ==================
+```
+(единственный warning — PydanticDeprecatedSince20 в `src/config.py:8`, предсуществующий, не связан с задачей.)
+
+Целевой модуль задачи (отдельный прогон):
+```
+tests/test_lite_setup_doc.py
+======================== 25 passed, 1 warning in 0.44s =========================
+```
+(25 структурных тестов покрывают TC-01…TC-08; заявление CHANGELOG «25 структурных тестов» совпадает с фактом.)
+
+## Итог
+**PASS** — полный регресс зелёный (1789 passed), все 10 TC из `04-test-plan.yaml` выполнены и
+сопоставлены с критериями `03-acceptance-criteria.md`. Smoke API read-only (включая блоки
+`serial_gate` и `auto_labels` в `/queue`, `/metrics schema_version:1`) и smoke-процедура
+Lite-тиража (LITE_SETUP.md + безопасный прогон `gen_secrets.py`, stateless, без переноса данных)
+зелёные. Задача переходит на `deploy-staging`.
+</content>
+</invoke>

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

@@ -0,0 +1,12 @@
+---
+deploy_status: SUCCESS
+work_item: ORCH-102
+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-102/15-staging-log.md

@@ -0,0 +1,36 @@
+---
+staging_status: SUCCESS
+work_item: ORCH-102
+stage: deploy-staging
+author_agent: deployer
+status: success
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+timestamp: 2026-06-10T21:39:20Z
+base_url: http://localhost:8501
+---
+
+# Staging Gate Log
+
+Staging test suite completed. Canonical run **inside** the `orchestrator-staging` container
+(8501) via the Docker exec API (`scripts/staging_check.py --base-url http://localhost:8501
+--mode stub`). Exit code **0** → `staging_status: SUCCESS`.
+
+All REAL checks green. The only two failures are the known sandbox-infra checks C9a/C9b
+(depend on SANDBOX bot accounts being project members, not on the pipeline) and are
+waived under ORCH-061 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
+```
+
+## Results
+- **Block A (SMOKE)**: PASS — A1 `/health` 200 ok, A2 `/queue` 200 with counts/max_concurrency/resilience, A3 `ORCH_STAGING=true`.
+- **Block B (ACCESS)**: PASS — B4 Plane sandbox accessible, B5 Gitea `orchestrator-sandbox` push=true, B6 registry isolation (sandbox present, prod ET/ORCH absent).
+- **Block C (E2E, mode=stub)**: C7 create issue PASS, C8 trigger pipeline PASS; C9a/C9b FAIL → **waived** (sandbox-infra, ORCH-061).
+
+RESULT: 8/10 checks PASS. REAL failed: none. SANDBOX_INFRA failed (waived): C9a, C9b.
+
+> Note: ORCH-102 is a docs+tests-only change (`src/**`/compose/Dockerfile/`scripts/**` untouched);
+> the staging gate is run as the mandatory self-hosting safety net before prod deploy.

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

@@ -0,0 +1,7 @@
+# Business Request: ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+Work Item ID: ORCH-103
+
+## Description
+
+TBD

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

@@ -0,0 +1,199 @@
+---
+work_item: ORCH-103
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# 01 — BRD: ORCH-103 — ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+Work Item: **ORCH-103** · Repo: **orchestrator** (self-hosting) · Стадия: analysis
+Заказчик: Слава · Эпик: **ORCH-10** (домен D5 «Масштаб», `docs/epics/self-evolution.md`) · Тип: **B — Bundled**
+
+---
+
+## 1. Бизнес-контекст и проблема
+
+### 1.1. Цель эпика ORCH-10
+Тираж платформы — РАЗДАЧА текущей функциональности нескольким заказчикам **на тест**.
+Решения Владельца 10.06 (приняты как требования): ДВА типа тиража, ОБА **stateless**
+(наши задачи/данные/секреты НЕ переносим — чистый старт):
+
+- **Тип A (Lite, ORCH-102 ✅)** — переносится ТОЛЬКО орк+watchdog; Plane/Gitea/LLM/Telegram
+  заказчик донастраивает сам по инструкции `docs/deployment/LITE_SETUP.md`.
+- **Тип B (Bundled, эта задача)** — **весь стек одним комплектом**
+  (орк + watchdog + Gitea + Plane + рантайм-обвязка агентов) — «под ключ».
+
+### 1.2. Проблема, которую закрывает ORCH-103
+Lite предполагает, что у заказчика **уже есть** (или он сам поднимет) свои Plane и Gitea.
+Для заказчика без собственной инфраструктуры это барьер: Plane CE self-hosted — это ~14
+контейнеров со своей БД/брокером/хранилищем, Gitea — отдельная установка, и поверх всего —
+первичная инициализация (админы, токены, workspace, 22 статуса, лейблы, вебхуки в обе стороны,
+git-доступ агентов). Сегодня репо не содержит ни compose-описания этого стека, ни автоматизации
+его доводки: разворачивание «с нуля до работающего конвейера» = многочасовая ручная работа по
+сторонним докам с рисками дефолтных паролей и дрейфа от канона платформы.
+
+ORCH-103 должен дать: **один compose-комплект** всего стека + **bootstrap-скрипт**, доводящий
+свежеподнятый стек до рабочего состояния одной командой/визардом, + **новые секреты** на каждую
+инсталляцию + **инструкцию `docs/deployment/BUNDLED_SETUP.md`** с требованиями к хосту.
+
+### 1.3. Установленные факты (проверено по репо — не изобретать)
+- **Корневой `docker-compose.yml` защищён анти-дрейфом:** ровно 3 сервиса
+  (`orchestrator`, `orchestrator-watchdog`, `orchestrator-staging` за `profiles: ["staging"]`);
+  `tests/test_lite_setup_doc.py` (TC-04) проверяет точное множество сервисов и **запрещает**
+  появление в нём имён/образов с подстроками `plane`/`gitea` → bundle-компоуз обязан быть
+  **отдельным файлом**, корневой compose не форкается и не расширяется.
+- **Кирпичи уже в `main` (переиспользовать, не дублировать):**
+  - `scripts/gen_secrets.py` (ORCH-101) — криптослучайные webhook-секреты
+    (`ORCH_PLANE_WEBHOOK_SECRET`/`ORCH_GITEA_WEBHOOK_SECRET`), печать по умолчанию,
+    `--write` отказывает при существующем `.env`, `--force` — перезапись; exit 0/2.
+  - `scripts/onboard_project.py` (ORCH-009) — `plan` (GET-only) / `apply` (идемпотентный ensure,
+    без delete) / `verify`: Plane-проект + **22 статуса** (read-only импорт
+    `plane_sync._PLANE_NAME_TO_KEY`, fail-closed имена `Confirm Deploy`/`STOP`) + лейблы
+    `autoApprove`/`autoDeploy`/`Bug`; Gitea-репо + per-repo webhook (`push`/`pull_request`/`status`,
+    ОДИН глобальный `ORCH_GITEA_WEBHOOK_SECRET`); недоступное в Plane CE API → `manual-step`
+    (fail-safe); exit 0/2/1.
+  - `docs/operations/REPLICATION.md` (ORCH-101) — карта env (§2), чек-лист секретов (§3),
+    **smoke §4** (шаги 0–6 с PASS/FAIL: config-резолв → `/health` → `/queue`+`/metrics` →
+    onboard plan/apply/verify → тестовая задача → артефакты `01–04` → опц. до `done`); §1 —
+    таблица границ, где Type B помечен «отдельная задача».
+  - `docs/deployment/LITE_SETUP.md` (ORCH-102) — канон тиражной инструкции: 13 нормативных
+    разделов, каждый шаг = fenced-команда + явная «Проверка:» PASS/FAIL, хост-специфика только
+    плейсхолдерами; канон не форкается — общие шаги ссылками.
+  - `.env.example` — канон 100% ключей орка; `.env.watchdog.example` — канон watchdog
+    (key-set-sync тестом, D5 ORCH-102).
+- **Хост-параметризация завершена (ORCH-101):** платформа разворачивается без правки кода —
+  только env (`${VAR:-default}`-интерполяция compose, `ARG APP_*` Dockerfile); анти-регресс
+  `tests/test_no_host_hardcodes.py` (FORBIDDEN-литералы: IP/`/home/slin`/`mva154`/`duckdns`).
+- **Claude CLI НЕ запечён в образ орка:** монтируется с хоста
+  (`ORCH_HOST_CLAUDE_CODE_DIR`/`ORCH_HOST_NODE_BIN`/`ORCH_HOST_CLAUDE_DIR`/`ORCH_HOST_CLAUDE_JSON`).
+  «Агенты» в комплекте = рантайм-обвязка запуска; **инсталляция Claude CLI и LLM-ключ — внешнее
+  предусловие хоста заказчика** (как Lite §7), bundle их не содержит и не генерирует.
+- **Нормативы тиражной Gitea:** branch protection на `main` НЕ включать (D10 ORCH-009 / INV-4 —
+  мерж только через Gitea PR-merge API); pre-receive не вводится.
+- **Plane CE self-hosted ≈ 14 контейнеров** (web/admin/space/api/worker/beat/live/migrator +
+  postgres/redis/mq/minio/proxy) — ресурсоёмко; часть первичной инициализации в CE недоступна
+  по API → честные ручные чекпоинты (паттерн `manual-step` ORCH-009).
+
+---
+
+## 2. Объём (scope)
+
+### 2.1. В объёме
+- **Bundle-compose** — отдельный compose-комплект всего стека: орк + watchdog + Gitea +
+  Plane-стек (~14 контейнеров); пиннинг версий; чистые именованные тома; согласованная
+  сетевая достижимость (вебхуки в обе стороны).
+- **Bootstrap-скрипт** — один запуск (команда/визард): поднять всё → дождаться
+  готовности/миграций → инициализация Gitea (админ/токен) → инициализация Plane
+  (instance/workspace/API-токен; CE-ограничения → явные manual-step чекпоинты) →
+  онбординг sandbox-проекта (22 статуса/3 лейбла/репо/вебхуки — через `onboard_project.py`) →
+  git-доступ агентов → сборка `.env`/`.env.watchdog` орка → health → smoke-подсказка.
+- **Инициализация секретов** — генерация НОВЫХ на каждую инсталляцию (reuse `gen_secrets.py` +
+  bundle-внутренние креды: пароли БД/брокера/хранилища Plane, админ Gitea); дефолтных паролей
+  в репо нет.
+- **`docs/deployment/BUNDLED_SETUP.md`** — инструкция запуска bundle по канону LITE_SETUP,
+  включая **требования к хосту (RAM/диск/CPU/порты)**.
+- **Структурные анти-дрейф тесты** (без docker/сети/LLM в CI) + полный зелёный pytest + CHANGELOG.
+- Отметка Type B в `docs/operations/REPLICATION.md` §1 (границы трёх задач эпика).
+
+### 2.2. Вне объёма (явно, не делать)
+- Изменения рантайма: `src/**`, корневой `docker-compose.yml`, `Dockerfile`, `.gitea/workflows/`,
+  `STAGE_TRANSITIONS`/`QG_CHECKS`/`check_*`/machine-verdict/схема БД — байт-в-байт.
+- Перенос наших задач/данных/секретов (stateless — решение Владельца 10.06).
+- Автоматическая установка Claude CLI / выдача LLM-ключей / создание Telegram-ботов —
+  внешние предусловия заказчика (документируются, не автоматизируются).
+- HTTPS/домены/публичный reverse-proxy заказчика — за рамками bundle (документируется
+  как ручной шаг при необходимости).
+- Процедура обновления (upgrade) развёрнутого bundle; миграция Lite→Bundled; кластерные/
+  multi-host топологии; мультитенантность (D5.6) и горизонтальный воркер-пул (D5.4).
+- Какая-либо активация bundle на НАШЕМ боевом хосте.
+
+---
+
+## 3. Заинтересованные стороны
+- **Владелец (Слава)** — раздаёт платформу заказчикам на тест; принимает результат.
+- **Оператор заказчика** — целевой читатель BUNDLED_SETUP.md: чистый Linux-хост,
+  docker+compose, без знания внутренностей платформы.
+- **Self-hosting прод** (`orchestrator`, общий для всех проектов) — не должен быть затронут:
+  задача — артефакты репо (compose/скрипт/доки/тесты), активируемые только явным запуском
+  на ЦЕЛЕВОМ хосте.
+
+---
+
+## 4. Бизнес-требования (BR)
+
+| ID | Требование | Связь |
+|----|------------|-------|
+| BR-1 | Единый bundle-compose (отдельный файл) поднимает ВЕСЬ стек одной командой: орк, watchdog, Gitea, Plane-стек. Корневой `docker-compose.yml` не форкается и не меняется. | AC-1, AC-6, FR-1 |
+| BR-2 | Bootstrap-скрипт ОДНИМ запуском (команда/визард) доводит свежеподнятый стек до рабочего состояния: готовность/миграции → init Gitea → init Plane → онбординг sandbox-проекта → git-доступ агентов → конфиг орка → health. Шаги, физически недоступные через Plane CE API, оформляются явными интерактивными manual-step чекпоинтами (fail-safe, паттерн ORCH-009) — без молчаливых пропусков. | AC-1, FR-2 |
+| BR-3 | После bootstrap smoke проходит: тестовый проект создан, тестовая задача доезжает минимум до артефактов `01–04` в ветке (минимальный сигнал REPLICATION §4 шаг 5); расширенно — до `done`. Вебхуки работают в ОБЕ стороны (Plane→орк, Gitea→орк, орк→Plane/Gitea API). | AC-2, FR-2/FR-6 |
+| BR-4 | Stateless: каждая инсталляция стартует с чистых томов/БД (Plane, Gitea, орк) и НОВЫХ секретов (`gen_secrets.py` + bundle-внутренние креды). Боевые данные/секреты не используются ни на одном шаге; в репо нет ни одного реального секрета/дефолтного пароля. | AC-3, FR-3 |
+| BR-5 | `docs/deployment/BUNDLED_SETUP.md` написан по канону LITE_SETUP (fenced-команды + «Проверка:» PASS/FAIL, плейсхолдеры вместо хост-специфики, канон не форкается — общие шаги ссылками на LITE_SETUP/ONBOARDING/REPLICATION) и фиксирует требования к хосту: RAM/диск/CPU/занимаемые порты (Plane ~14 контейнеров — ресурсоёмко). | AC-4, FR-4 |
+| BR-6 | Переиспользование кирпичей без дублирования: секреты — `gen_secrets.py`; статусы/лейблы/репо/вебхуки — `onboard_project.py` (22 статуса — из `plane_sync._PLANE_NAME_TO_KEY`, нулевой дрейф); smoke — шаги REPLICATION §4. Bootstrap не реализует собственную копию этих канонов. | FR-2/FR-3, AC-7 |
+| BR-7 | Идемпотентность/fail-safe: повторный запуск bootstrap безопасен (ensure/skip, без delete-операций); запуск на «грязном» хосте (существующие тома/занятые порты/нехватка ресурсов) → явный отказ preflight с понятной подсказкой, а не молчаливое переиспользование чужого состояния. | FR-2, AC-8 |
+| BR-8 | Наш прод не затрагивается: вся задача — вне рантайма и вне конвейера; kill-switch не требуется (активация — только явный запуск человеком на целевом хосте, паттерн ORCH-009). | NFR-1/NFR-2, AC-6 |
+| BR-9 | Анти-дрейф: структурные тесты держат bundle-канон (compose-структура, док-канон, env-ключи, FORBIDDEN-литералы, секрет-эвристика, кросс-ссылки); существующие `test_lite_setup_doc.py`/`test_no_host_hardcodes.py` остаются зелёными; полный `pytest tests/ -q` зелёный; CHANGELOG обновлён. | AC-5, AC-6, AC-7, FR-5 |
+
+---
+
+## 5. Нефункциональные требования (NFR)
+
+| ID | Требование |
+|----|------------|
+| NFR-1 | **Рантайм/конвейер байт-в-байт:** `src/**`, корневой `docker-compose.yml`, `Dockerfile`, `STAGE_TRANSITIONS`, `QG_CHECKS`, `check_*`, machine-verdict ключи, схема БД орка — не тронуты. Задача — docs+scripts+compose-bundle+tests. |
+| NFR-2 | **Self-hosting безопасность:** ни один артефакт задачи не рестартит/не деплоит/не конфигурирует наш прод-контейнер; bundle-артефакты в нашем контуре инертны (никто их не исполняет). |
+| NFR-3 | **Секрет-гигиена:** в репо не попадают реальные секреты, высокоэнтропийные литералы и хост-литералы (FORBIDDEN-скан `test_no_host_hardcodes.py` распространяется на новые артефакты); bootstrap не печатает секреты в лог; сгенерированные файлы конфигов — только на целевом хосте, в `.gitignore`. |
+| NFR-4 | **Переносимость:** bundle не зависит от нашей инфраструктуры; вся хост-специфика — переменные/плейсхолдеры; целевая платформа — одиночный Linux x86_64 хост с docker+compose. |
+| NFR-5 | **Норматив сопровождения** (зеркало NFR-5 ORCH-102): изменение шагов тиража в будущих задачах → обновление `BUNDLED_SETUP.md` в том же PR. |
+| NFR-6 | **Воспроизводимость:** версии образов Gitea/Plane-стека зафиксированы (пиннинг тегов/digest, не `latest`); состав bundle детерминирован. |
+| NFR-7 | **Без новых тяжёлых зависимостей:** bootstrap — в духе существующих скриптов (stdlib-инструментарий `gen_secrets.py`/`onboard_project.py`); точный стек (bash/python) — решение архитектора. |
+
+---
+
+## 6. Допущения и ограничения
+- Целевой хост: чистый одиночный Linux x86_64 с установленными docker + docker compose;
+  оператор имеет sudo. Прочие ОС — вне целевой платформы (best-effort).
+- Ресурсы: Plane-стек ресурсоёмок; ориентир для проверки — **не менее 4 vCPU / 8 GB RAM /
+  40 GB диска** (финальные минимумы УТОЧНЯЮТСЯ при реализации замером на тестовом
+  развёртывании и фиксируются в BUNDLED_SETUP.md — см. AC-4; цифры выше — гипотеза, не факт).
+- Внешние предусловия заказчика (bundle не поставляет): инсталляция/аутентификация Claude CLI
+  + LLM-доступ Anthropic; Telegram-боты (трекер + watchdog) — опциональны, их отсутствие
+  деградирует только нотификации (never-raise), не конвейер.
+- Часть инициализации Plane CE недоступна по API (instance-setup/workspace/API-токен) —
+  допускаются документированные интерактивные шаги внутри визарда; «одной командой» означает
+  «один запуск bootstrap с явными чекпоинтами», а не «ноль действий человека».
+- Версии upstream-образов (Plane CE/Gitea) фиксируются на момент реализации; их обновление —
+  отдельные будущие задачи (NFR-6).
+
+---
+
+## 7. Критерии успеха (резюме; детали — 03-acceptance-criteria.md)
+Пять AC из постановки Владельца (сохранены 1:1 как AC-1…AC-5) + производные проверяемые:
+- AC-1 единый bundle-compose поднимает ВЕСЬ стек; bootstrap доводит до рабочего состояния
+  одной командой/визардом.
+- AC-2 после bootstrap smoke проходит (тестовый проект + задача доезжает).
+- AC-3 stateless (чистые Plane/Gitea/БД, новые секреты).
+- AC-4 BUNDLED_SETUP.md + требования к хосту (RAM/диск) задокументированы.
+- AC-5 pytest зелёный; CHANGELOG.
+- AC-6 корневой compose/рантайм не тронуты (анти-дрейф зелёный); AC-7 нулевой дрейф канонов
+  (22 статуса/лейблы/секреты — через существующие кирпичи); AC-8 идемпотентность/fail-safe
+  bootstrap; AC-9 секрет-гигиена новых артефактов.
+
+---
+
+## 8. Риски (детали — 10-tech-risks.md, заполняет архитектор)
+- **R-1 Ресурсоёмкость Plane:** ~14 контейнеров → OOM/медленный старт на слабом хосте;
+  смягчение — preflight-проверка ресурсов + честные требования в доке (AC-4).
+- **R-2 Дыры Plane CE API:** первичная инициализация частично UI-only → ручные чекпоинты;
+  риск — UX «одной команды» размывается; смягчение — явные manual-step с проверкой результата
+  (паттерн ORCH-009), минимизация числа ручных шагов.
+- **R-3 Дрейф upstream-образов:** «плавающие» теги ломают воспроизводимость → пиннинг (NFR-6).
+- **R-4 Сетевая достижимость вебхуков:** орк (host network) ⟷ Plane/Gitea (bridge-сеть bundle)
+  — двунаправленные URL должны быть согласованы bootstrap'ом; ошибка = «задача не появилась»
+  (труднодиагностируемо); смягчение — smoke проверяет оба направления.
+- **R-5 Соблазн форкнуть корневой compose** (анти-дрейф TC-04 `test_lite_setup_doc.py` упадёт)
+  → bundle строго отдельным файлом.
+- **R-6 Утечка секретов в логи/репо** при генерации bundle-кред → секрет-эвристика в тестах,
+  запрет печати секретов (NFR-3).

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

@@ -0,0 +1,232 @@
+---
+work_item: ORCH-103
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# 02 — ТЗ (TRZ): ORCH-103 — ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+Work Item: **ORCH-103** · Repo: **orchestrator** · Стадия: analysis
+
+> ТЗ фиксирует **что** должно измениться и **где** (артефакты/контракты/границы). **Как**
+> (расположение bundle-каталога, состав сервисов Plane-стека, язык/режимы bootstrap, механизм
+> сетевой связности) — решает архитектор в `06-adr/`. Архитектурные решения здесь не принимаются.
+
+---
+
+## 1. Сводка изменения
+
+Добавить в репо **Bundled-комплект тиража (Type B эпика ORCH-10)**: (1) отдельный
+**bundle-compose** всего стека (орк + watchdog + Gitea + Plane-стек ~14 контейнеров),
+(2) **bootstrap-скрипт**, доводящий свежеподнятый стек до рабочего конвейера одним запуском
+(с явными manual-step чекпоинтами там, где Plane CE API не позволяет автоматизацию),
+(3) **генерацию новых секретов** на инсталляцию (reuse `gen_secrets.py` + bundle-внутренние
+креды), (4) инструкцию **`docs/deployment/BUNDLED_SETUP.md`** с требованиями к хосту,
+(5) **структурные анти-дрейф тесты**. Всё — вне рантайма и вне конвейера: `src/**`, корневой
+`docker-compose.yml`, `Dockerfile`, `STAGE_TRANSITIONS`/`QG_CHECKS`/схема БД — байт-в-байт
+(паттерн ORCH-009/ORCH-102). Kill-switch не требуется: активация — только явный запуск
+оператором на целевом хосте.
+
+---
+
+## 2. Задействованные модули / пути
+
+| Путь | Действие | Назначение |
+|------|----------|------------|
+| `deploy/bundled/docker-compose.yml` *(рабочая гипотеза; финальное расположение/имя — ADR; далее «bundle-compose»)* | **создать** | Compose-комплект всего стека (FR-1) |
+| `deploy/bundled/.env.bundled.example` *(имя — ADR; далее «bundle-конфиг-канон»)* | **создать** | Канон 100% переменных bundle (порты/версии/плейсхолдеры кред), паттерн `.env.watchdog.example` |
+| `scripts/bootstrap_bundle.py` *(имя/язык — ADR)* | **создать** | Bootstrap-скрипт (FR-2) |
+| `docs/deployment/BUNDLED_SETUP.md` | **создать** | Golden source инструкции Bundled-тиража (FR-4) |
+| `docs/operations/REPLICATION.md` | **изменить (точечно)** | §1: строка Type B → ✅ ORCH-103 + ссылка на BUNDLED_SETUP.md (FR-6) |
+| `tests/test_bundle_compose.py` | **создать** | Структура bundle-compose + изоляция корневого compose (FR-5) |
+| `tests/test_bundled_setup_doc.py` | **создать** | Канон дока, env-ключи, FORBIDDEN/секрет-эвристика, кросс-рефы (FR-5) |
+| `tests/test_bootstrap_script.py` | **создать** | Структурные/unit-ассерты bootstrap (FR-5) |
+| `CHANGELOG.md` | **изменить** | Запись `feat: ORCH-103` |
+| `.gitignore` | **изменить (при необходимости)** | Сгенерированные на хосте конфиги bundle не коммитятся (NFR-3) |
+| **НЕ трогать:** `src/**`, корневой `docker-compose.yml`, `Dockerfile`, `.gitea/workflows/**`, `.env.example` (кроме явно обоснованного в ADR аддитива), `onboarding/**`, промпты `.openclaw/agents/**` | — | NFR-1; анти-дрейф `test_lite_setup_doc.py` (TC-04: ровно 3 сервиса, нет `plane*`/`gitea*`) и `test_no_host_hardcodes.py` остаются зелёными |
+
+---
+
+## 3. Функциональные требования
+
+### FR-1 — Bundle-compose всего стека (BR-1)
+- **Отдельный файл**, корневой `docker-compose.yml` не изменяется (жёсткое ограничение:
+  анти-дрейф TC-04 `tests/test_lite_setup_doc.py` проверяет точное множество сервисов корневого
+  compose и запрещает подстроки `plane`/`gitea` в именах сервисов/образов/контейнеров).
+- **Состав стека:** `orchestrator` (образ собирается из существующего корневого `Dockerfile` —
+  без его правки), `orchestrator-watchdog` (существующий `watchdog/Dockerfile`), Gitea
+  (+ её хранилище), полный Plane CE-стек (~14 контейнеров: web/admin/space/api/worker/beat/
+  live/migrator + postgres/redis/mq/minio/proxy — точный состав и версии пиннит архитектор по
+  upstream-référence). Staging-контур орка (8501) — НЕ в дефолтном `up` (вне скоупа заказчика;
+  включать ли за профилем — ADR).
+- **Пиннинг версий** всех сторонних образов (тег или digest; не `latest`) — NFR-6.
+- **Тома:** только именованные/каталожные тома bundle (узнаваемый префикс); чистый первый старт;
+  пересечений с томами/путями нашего прод-контура нет.
+- **Сеть и достижимость (двунаправленно):** (a) Plane→орк и Gitea→орк webhooks доставляются;
+  (b) орк→Plane API и орк→Gitea API доступны; (c) git push/fetch агентов в Gitea работает.
+  Механизм (bridge-сеть + публикация портов, `extra_hosts: host-gateway`, host-network — что
+  выбрать) — ADR; ТЗ фиксирует только инвариант достижимости, проверяемый smoke (FR-6).
+- **Порты:** карта портов по умолчанию задокументирована (BUNDLED_SETUP «Требования к хосту»);
+  порты конфигурируемы через bundle-конфиг; конфликт порта → отказ preflight bootstrap (FR-2),
+  не молчаливый сбой. Дефолт порта орка — существующий 8500 (`ORCH_DEPLOY_PROD_TARGET_PORT`).
+- **Конфиг-канон:** все параметры bundle (порты/версии/пути/плейсхолдеры кред) — в
+  bundle-конфиг-каноне; key-set синхронизируется структурным тестом (паттерн key-sync
+  `.env.watchdog.example`, D5 ORCH-102). Ключи орка НЕ дублируются — `.env` орка собирается
+  bootstrap'ом из существующего канона `.env.example`.
+
+### FR-2 — Bootstrap-скрипт: один запуск до рабочего состояния (BR-2, BR-6, BR-7)
+Последовательность (нумерация — норматив поведения; механика шагов — ADR):
+1. **Preflight (fail-fast, до любых мутаций):** docker+compose присутствуют; свободные
+   RAM/диск ≥ задокументированных минимумов; целевые порты свободны; тома bundle отсутствуют
+   (чистый хост) — иначе явный отказ с подсказкой (BR-7); наличие Claude CLI/кред — warning
+   (не блокер: конвейер без LLM не поедет, но стек поднимется).
+2. **Секреты (FR-3):** генерация полного набора НОВЫХ секретов инсталляции.
+3. **Up:** подъём bundle-compose; ожидание готовности каждого сервиса (healthcheck/готовность
+   БД/завершение миграций Plane и Gitea) с таймаутами и внятной диагностикой.
+4. **Init Gitea:** административная учётка + API-токен (через официальные механизмы Gitea —
+   CLI/env/API; конкретика — ADR); branch protection НЕ настраивается (норматив D10 ORCH-009).
+5. **Init Plane:** instance-setup/workspace/API-токен. Всё, что недоступно в CE по API, —
+   **интерактивный manual-step чекпоинт**: скрипт печатает точную инструкцию (URL/что нажать/
+   что ввести), ждёт подтверждения, **проверяет результат** (например, валидность введённого
+   API-токена запросом) и только тогда продолжает (fail-safe; молчаливый пропуск запрещён).
+6. **Онбординг sandbox-проекта:** вызов `scripts/onboard_project.py apply` + `verify`
+   (22 статуса из `plane_sync._PLANE_NAME_TO_KEY`, лейблы `autoApprove`/`autoDeploy`/`Bug`,
+   Gitea-репо, per-repo webhook под глобальным секретом). Собственная реализация этих шагов
+   в bootstrap **запрещена** (BR-6, нулевой дрейф канона).
+7. **Git-доступ агентов:** обеспечить push/fetch созданного репо из контейнера орка
+   (ssh-ключ + регистрация в Gitea ИЛИ токен-remote — механизм ADR); клон репо в repos-каталог
+   орка (`ORCH_HOST_REPOS_DIR`).
+8. **Конфиг орка:** собрать `.env` (на базе `.env.example`: URL'ы Plane/Gitea bundle-инсталляции,
+   токены, webhook-секреты, `ORCH_PROJECTS_JSON` из вывода onboard) и `.env.watchdog`
+   (из `.env.watchdog.example`); файлы остаются только на целевом хосте.
+9. **Health + итог:** `GET /health`, `GET /queue`, `GET /metrics` зелёные; финальная сводка
+   PASS/FAIL по всем шагам + следующая команда оператора (smoke FR-6).
+
+Требования к скрипту:
+- **Идемпотентность:** повторный запуск на уже-инициализированном bundle безопасен
+  (ensure/skip-семантика, как `onboard_project.py apply`); никаких delete-операций.
+- **Exit-коды:** `0` — успех; `2` — остановка на manual-step/незавершённое предусловие;
+  `1` — ошибка (паттерн `onboard_project.py`).
+- **Логи без секретов** (NFR-3): значения кред не печатаются (только имена ключей/пути файлов).
+- **Никогда не адресует наш прод:** в скрипте нет боевых хостов/путей (FORBIDDEN-скан),
+  работает только с локальным docker целевого хоста.
+- Желателен режим `plan` (печать шагов без мутаций, паттерн ORCH-009) — финально ADR.
+
+### FR-3 — Инициализация секретов: новые на каждую инсталляцию (BR-4)
+- **Webhook-секреты орка** — строго через существующий `scripts/gen_secrets.py`
+  (не реализовывать заново).
+- **Bundle-внутренние креды** (генерирует bootstrap, криптослучайно, stdlib `secrets`):
+  пароли postgres/redis*/mq/minio Plane-стека, секрет-ключи Plane, админ-пароль и API-токен
+  Gitea. В репо — только плейсхолдеры в bundle-конфиг-каноне; **ни одного дефолтного пароля**.
+- **Внешние секреты заказчика** (не генерятся, чек-лист в доке): Anthropic/Claude CLI доступ,
+  Telegram-токены (опционально), `ORCH_PLANE_API_TOKEN` (если выдаётся вручную на manual-step).
+- Сгенерированные файлы: только на целевом хосте, права `600`, в `.gitignore`; повторный
+  запуск НЕ перетирает существующие секреты без явного флага (паттерн `--force` gen_secrets).
+
+### FR-4 — `docs/deployment/BUNDLED_SETUP.md` (BR-5)
+- **Канон LITE_SETUP** (ORCH-102): нормативные разделы в порядке маршрута оператора; каждый
+  исполняемый шаг = fenced-команда + явная «Проверка:» с PASS/FAIL; хост-специфика — только
+  плейсхолдеры; запрещены FORBIDDEN-литералы и реальные секреты (структурный тест).
+- **Обязательные разделы** (минимум; точные заголовки — автор дока, проверяемость — тест):
+  (1) рамка Bundled (что входит/что НЕ входит: Claude CLI, Telegram, HTTPS; границы vs Lite);
+  (2) **требования к хосту** — RAM/диск/CPU/порты, явно «Plane ≈ 14 контейнеров», финальные
+  цифры — по замеру на тестовом развёртывании; (3) предусловия (docker/compose/sudo);
+  (4) получение кода; (5) секреты; (6) запуск bundle-compose; (7) bootstrap (включая перечень
+  manual-step чекпоинтов Plane); (8) LLM/Claude CLI (ссылкой на канон LITE_SETUP §7);
+  (9) Telegram (ссылкой на LITE_SETUP §8); (10) онбординг следующих проектов
+  (ссылкой на ONBOARDING.md); (11) smoke (шаги REPLICATION §4); (12) stateless-проверка;
+  (13) остановка/полный сброс инсталляции; (14) траблшутинг (минимум: webhook не доходит,
+  не хватает RAM/OOM, порт занят, claude не найден, Plane-миграции не завершились).
+- **Канон не форкается:** общие с Lite шаги — ссылками (LITE_SETUP §5–§8, ONBOARDING §1,
+  REPLICATION §2–§4), не копипастой; fail-closed имена `Confirm Deploy`/`STOP` и «22 статуса» —
+  согласованы с `plane_sync._PLANE_NAME_TO_KEY` (число — сверкой импорта в тесте, не литералом).
+
+### FR-5 — Структурные анти-дрейф тесты (BR-9)
+Все тесты — без docker/сети/LLM/subprocess-мутаций (CI-безопасные; паттерн
+`test_lite_setup_doc.py`):
+- **bundle-compose:** файл существует, валидный YAML; обязательные сервисы присутствуют
+  (`orchestrator`, `orchestrator-watchdog`, Gitea, Plane-стек — по списку из ADR); все
+  сторонние образы пиннованы (нет `:latest`/безтегового образа); корневой
+  `docker-compose.yml` НЕ изменён (множество сервисов == текущему эталону);
+- **док:** BUNDLED_SETUP.md существует, несёт обязательные разделы (включая «Требования к
+  хосту»), каждый env-ключ из дока существует в канонах (`.env.example` ∪ bundle-конфиг-канон),
+  кросс-ссылки на LITE_SETUP/ONBOARDING/REPLICATION присутствуют;
+- **гигиена:** FORBIDDEN-литералы (импорт списка из `test_no_host_hardcodes.py`) отсутствуют
+  в bundle-compose/доке/bootstrap; секрет-эвристика (hex ≥32 / alnum ≥40, паттерн D8 ORCH-102)
+  по новым файлам;
+- **bootstrap:** скрипт существует; структурно ссылается на `gen_secrets`/`onboard_project`
+  (не дублирует канон); не содержит delete-операций уровня `docker volume rm`/`rm -rf` вне
+  явного отдельного «сброс»-режима; чистые функции (preflight-решение, сборка плана шагов,
+  рендер `.env`) покрыты unit-тестами;
+- **кросс-рефы:** REPLICATION.md §1 несёт отметку Type B → BUNDLED_SETUP.md; CHANGELOG
+  содержит `ORCH-103`.
+
+### FR-6 — Smoke и наблюдаемость результата (BR-3)
+- Smoke Bundled = шаги REPLICATION §4 (0–6) поверх bundle-инсталляции, зафиксированные в
+  BUNDLED_SETUP §smoke: config-резолв → `/health` → `/queue`+`/metrics` → onboard verify →
+  тестовая задача (Plane issue → «To Analyse» → job в очереди) → **минимальный сигнал:
+  артефакты `01–04` в ветке** → опционально полный цикл до `done`.
+- Прохождение фиксируется оператором по PASS/FAIL каждого шага; это ручная приёмка AC-2
+  (e2e в CI не гоняется — нет docker/LLM).
+
+---
+
+## 4. Изменения API
+**Нет.** Эндпоинты орка не добавляются/не меняются; bundle использует существующие
+`/health`, `/queue`, `/metrics`, вебхуки `/webhook/plane`, `/webhook/gitea`.
+
+## 5. Изменения схемы БД
+**Нет** (схема БД орка не тронута). БД Plane/Gitea внутри bundle — их собственные, на чистых
+томах инсталляции; к схеме орка отношения не имеют.
+
+## 6. Требования к новым/изменённым QG checks
+**Нет.** Реестр `QG_CHECKS`/`check_*`/`STAGE_TRANSITIONS` — байт-в-байт. Bundled-тираж — это
+артефакты дистрибуции, а не гейты конвейера.
+
+---
+
+## 7. Совместимость / регресс
+- **Kill-switch не требуется** (паттерн ORCH-009): артефакты вне рантайма; в нашем контуре
+  ничего их не исполняет; активация — явный запуск оператором на целевом хосте.
+- **Нулевая регрессия:** корневой compose/`Dockerfile`/`src/**` не изменены ⇒ наш прод,
+  staging-контур и enduro-trails не затронуты по построению; существующие анти-дрейф тесты
+  (`test_lite_setup_doc.py`, `test_no_host_hardcodes.py`, канон-тесты ORCH-009) остаются
+  зелёными без правки их ассертов.
+- **Обратимость:** удаление bundle-каталога/скрипта/дока возвращает репо в текущее состояние;
+  на целевом хосте полный сброс = задокументированная процедура (FR-4 §13).
+- **Эскалация:** если при реализации выяснится необходимость править `src/**`/корневой compose
+  (например, недостающая параметризация, не закрытая ORCH-101) — это выход за рамки ТЗ:
+  остановиться и вернуть задачу с обоснованием (CLAUDE.md правило 4), не «дотачивать молча».
+
+---
+
+## 8. Артефакты pipeline (создать/обновить в ТОМ ЖЕ PR)
+- `docs/work-items/ORCH-103/06-adr/ADR-001-<slug>.md` — решения архитектора (см. §9 OQ);
+  при сквозном значении — зеркало в `docs/architecture/adr/adr-NNNN-<slug>.md`.
+- `docs/architecture/README.md` — раздел «Bundled-тираж (ORCH-103)» рядом с 10-common/Lite.
+- `CLAUDE.md` — краткий абзац Type B (паттерн абзацев ORCH-101/102).
+- `docs/operations/REPLICATION.md` §1 — отметка Type B (FR-6).
+- `CHANGELOG.md` — `feat: ORCH-103 …`.
+- При выявлении инфра-предусловий целевого хоста — `07-infra-requirements.md` (архитектор).
+
+---
+
+## 9. Открытые вопросы для архитектора (не блокируют анализ)
+- **OQ-1** Расположение/имя bundle-каталога и compose-файла (`deploy/bundled/` vs `bundle/`;
+  один compose vs include-композиция); судьба staging-контура орка в bundle (исключить vs
+  профиль).
+- **OQ-2** Точный состав/версии Plane CE-стека (по upstream selfhost-référence) и Gitea;
+  стратегия пиннинга (тег vs digest).
+- **OQ-3** Перечень физически автоматизируемых шагов инициализации Plane CE (instance-setup/
+  workspace/API-токен): что через API/CLI/seed, что — manual-step чекпоинт.
+- **OQ-4** Язык и режимы bootstrap (python stdlib vs bash; `plan`/`apply` vs линейный визард);
+  способ ожидания готовности (healthchecks vs poll).
+- **OQ-5** Механизм сетевой связности орк (host network?) ⟷ bundle bridge-сеть: публикация
+  портов, `host-gateway`, либо весь bundle в host-network — и согласование URL вебхуков.
+- **OQ-6** Механизм git-доступа агентов к bundle-Gitea (ssh-ключ vs http-токен) и наполнение
+  repos-каталога.
+- **OQ-7** Делать ли отдельный явный «сброс»-режим (teardown) частью скрипта или только
+  документированной процедурой в BUNDLED_SETUP §13.

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

@@ -0,0 +1,164 @@
+---
+work_item: ORCH-103
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# 03 — Критерии приёмки (Acceptance Criteria): ORCH-103 — Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+Work Item: **ORCH-103** · Repo: **orchestrator** · Стадия: analysis
+
+Формат: каждый критерий имеет **PASS** (что должно быть истинно для приёмки) и **FAIL**
+(что считается провалом). AC-1…AC-5 — из постановки Владельца (сохранены 1:1 по смыслу);
+AC-6…AC-9 — производные обязательные. AC-1/AC-2/AC-3 в части e2e — **ручная приёмка** на
+чистом тестовом хосте/VM по BUNDLED_SETUP.md (в CI docker/LLM не гоняются); остальное
+проверяется по файлам репозитория и структурным тестам.
+
+---
+
+## AC-1 — Единый bundle поднимает ВЕСЬ стек; bootstrap доводит одной командой/визардом
+
+**Условие:** на чистом Linux-хосте с docker+compose по шагам BUNDLED_SETUP.md: одна команда
+`docker compose -f <bundle-compose> … up -d` поднимает все сервисы стека (орк + watchdog +
+Gitea + Plane-стек); затем ОДИН запуск bootstrap-скрипта доводит инсталляцию до рабочего
+состояния (init Gitea/Plane → онбординг sandbox-проекта → git-доступ агентов → конфиг орка →
+health). Интерактивные manual-step чекпоинты допустимы только там, где Plane CE API не
+позволяет автоматизацию, каждый — с инструкцией и проверкой результата.
+- **PASS:** все контейнеры bundle в состоянии Up/healthy; bootstrap завершается `exit 0`;
+  `GET /health` орка — 200/ok, `GET /queue` и `GET /metrics` отдают валидный JSON;
+  `onboard_project.py verify` зелёный (22 статуса, лейблы, репо, webhook); ни одного
+  НЕдокументированного ручного действия (правка compose/конфигов руками сверх инструкции).
+- **FAIL:** хотя бы один сервис не поднялся/в рестарт-цикле; bootstrap падает или завершается
+  с нерабочим конвейером; для доводки потребовались действия, отсутствующие в BUNDLED_SETUP.md;
+  manual-step пропускается молча без проверки результата.
+
+---
+
+## AC-2 — После bootstrap smoke проходит (тестовый проект + задача доезжает)
+
+**Условие:** smoke-процедура BUNDLED_SETUP §smoke (шаги REPLICATION.md §4 поверх
+bundle-инсталляции): создать issue в sandbox-проекте Plane → перевести в «To Analyse».
+- **PASS:** webhook доезжает (job появляется в `GET /queue`); конвейер запускает analyst;
+  в рабочей ветке Gitea появляются артефакты `01-brd.md`/`02-trz.md`/`03-acceptance-criteria.md`/
+  `04-test-plan.yaml` (минимальный сигнал — шаг 5 REPLICATION §4); обратное направление
+  работает (орк пишет статус/коммент в Plane). Опционально-расширенно: задача доводится до
+  `done` (шаг 6).
+- **FAIL:** webhook не доходит (нет job); analyst не стартует; артефакты `01–04` не появляются;
+  орк не может писать в Plane/Gitea API (одностороння связность — R-4).
+
+---
+
+## AC-3 — Stateless: чистые Plane/Gitea/БД, новые секреты
+
+**Условие:** инсталляция стартует с нуля и не содержит ничего нашего.
+- **PASS:** все тома bundle созданы заново при первом `up` (чистые БД Plane/Gitea/орка:
+  `GET /queue` — нулевые счётчики, в Plane/Gitea нет наших задач/репо/пользователей); ВСЕ
+  секреты инсталляции сгенерированы на месте (`gen_secrets.py` + bundle-креды bootstrap);
+  в репо нет ни одного реального секрета/дефолтного пароля (структурный тест: секрет-эвристика
+  + плейсхолдеры в bundle-конфиг-каноне); боевые данные/секреты/БД не копируются ни одним шагом
+  инструкции.
+- **FAIL:** инструкция/скрипт предлагает перенос наших данных или переиспользование боевых
+  секретов; в репо обнаружен реальный секрет/дефолтный пароль/высокоэнтропийный литерал;
+  на свежей инсталляции видны чужие задачи/счётчики.
+
+---
+
+## AC-4 — BUNDLED_SETUP.md + требования к хосту задокументированы
+
+**Условие:** `docs/deployment/BUNDLED_SETUP.md` существует и написан по канону тиражных доков
+(ORCH-102).
+- **PASS:** док несёт обязательные разделы FR-4 (рамка, **требования к хосту с явными цифрами
+  RAM/диск/CPU и картой портов**, предусловия, секреты, запуск, bootstrap с перечнем
+  manual-step, LLM, Telegram, онбординг, smoke, stateless-проверка, остановка/сброс,
+  траблшутинг); каждый исполняемый шаг = fenced-команда + «Проверка:» PASS/FAIL; явно указано
+  «Plane ≈ 14 контейнеров — ресурсоёмко»; цифры требований подтверждены замером на тестовом
+  развёртывании (не «с потолка»); хост-специфика — только плейсхолдеры; общие шаги — ссылками
+  на LITE_SETUP/ONBOARDING/REPLICATION (без копипасты канона).
+- **FAIL:** дока нет/раздел «Требования к хосту» отсутствует или без цифр; шаги без
+  команд/проверок; FORBIDDEN-литералы (IP/`/home/slin`/`mva154`/`duckdns`) или секреты в
+  тексте/fenced-блоках; канон LITE_SETUP скопирован вместо ссылок.
+
+---
+
+## AC-5 — pytest зелёный; CHANGELOG
+
+**Условие:** полный регресс и журнал изменений.
+- **PASS:** `pytest tests/ -q` — 0 failed (включая существующие анти-дрейф
+  `test_lite_setup_doc.py`, `test_no_host_hardcodes.py`, канон-тесты ORCH-009 — без правки их
+  ассертов); `CHANGELOG.md` содержит запись `ORCH-103`.
+- **FAIL:** хотя бы один тест красный; существующий анти-дрейф тест «починен» ослаблением
+  ассертов; CHANGELOG не обновлён.
+
+---
+
+## AC-6 — Корневой compose и рантайм не тронуты
+
+**Условие:** изоляция от боевого контура (NFR-1/NFR-2, BR-1/BR-8).
+- **PASS:** `git diff main` НЕ содержит изменений `src/**`, корневого `docker-compose.yml`,
+  `Dockerfile`, `.gitea/workflows/**`; bundle-compose — отдельный файл; множество сервисов
+  корневого compose неизменно (`orchestrator`/`orchestrator-watchdog`/`orchestrator-staging`);
+  ни один артефакт задачи не исполняется в нашем контуре автоматически (нет правок
+  деплой-хука/CI, нет cron/врезок).
+- **FAIL:** любая правка рантайма/корневого compose/Dockerfile; сервисы `plane*`/`gitea*`
+  добавлены в корневой compose; артефакт bundle задействован в нашем прод/staging-контуре.
+
+---
+
+## AC-7 — Нулевой дрейф канонов: кирпичи переиспользованы
+
+**Условие:** BR-6 — единственный источник истины для статусов/лейблов/секретов/smoke.
+- **PASS:** bootstrap вызывает `scripts/gen_secrets.py` (webhook-секреты) и
+  `scripts/onboard_project.py` (статусы/лейблы/репо/вебхуки) — структурный тест подтверждает
+  ссылки; собственного списка статусов/лейблов в bundle-артефактах нет (упоминание числа
+  статусов в доке сверяется импортом `plane_sync._PLANE_NAME_TO_KEY` в тесте, не литералом);
+  smoke-раздел ссылается на REPLICATION §4.
+- **FAIL:** bootstrap/док несут собственную копию канона (свой список статусов, свой генератор
+  webhook-секретов, свой smoke-чеклист с нуля) — дрейф при будущих изменениях канона.
+
+---
+
+## AC-8 — Идемпотентность и fail-safe bootstrap
+
+**Условие:** BR-7 — повторный запуск и грязный хост.
+- **PASS:** повторный запуск bootstrap на уже-инициализированном bundle завершается успешно
+  (ensure/skip, без дублей и без разрушения состояния); preflight на грязном/непригодном хосте
+  (существующие тома bundle, занятый порт, нехватка RAM/диска) → явный отказ с понятной
+  подсказкой ДО любых мутаций; delete-операций нет (teardown — только отдельный
+  явный режим/процедура, не часть обычного прогона); exit-коды: 0 — успех, 2 — manual-step/
+  предусловие, 1 — ошибка; секреты в логи не печатаются; повторный запуск не перетирает
+  существующие секреты без явного флага.
+- **FAIL:** повторный запуск ломает/дублирует состояние; bootstrap молча переиспользует чужие
+  тома или продолжает после провального preflight; обычный прогон удаляет данные; секрет виден
+  в stdout/логе.
+
+---
+
+## AC-9 — Секрет-гигиена и переносимость новых артефактов
+
+**Условие:** NFR-3/NFR-4/NFR-6 по файлам репо.
+- **PASS:** структурные тесты подтверждают: в bundle-compose/доке/скрипте нет
+  FORBIDDEN-литералов (список — импорт из `test_no_host_hardcodes.py`) и высокоэнтропийных
+  литералов (hex ≥32 / alnum ≥40); все сторонние образы bundle-compose пиннованы (не `latest`);
+  все env-ключи, упомянутые в BUNDLED_SETUP.md, существуют в канонах (`.env.example` ∪
+  bundle-конфиг-канон); сгенерированные на хосте конфиги — в `.gitignore`.
+- **FAIL:** найден хост-литерал/секрет; образ без пина; ключ-фантом в доке (нет в канонах);
+  сгенерированный конфиг коммитится.
+
+---
+
+## Сводная матрица AC ↔ BR/FR
+
+| AC | Покрывает | Способ проверки |
+|----|-----------|-----------------|
+| AC-1 | BR-1, BR-2 / FR-1, FR-2 | ручной e2e на тестовом хосте + структурные тесты (TC-01..04, TC-08) |
+| AC-2 | BR-3 / FR-2, FR-6 | ручной e2e (smoke REPLICATION §4) |
+| AC-3 | BR-4 / FR-3 | ручной e2e + структурные тесты (TC-06, TC-09) |
+| AC-4 | BR-5 / FR-4 | структурный тест дока (TC-05) + ревью |
+| AC-5 | BR-9 / FR-5, FR-6 | `pytest tests/ -q` (TC-12) + CHANGELOG (TC-11) |
+| AC-6 | BR-1, BR-8 / NFR-1, NFR-2 | git diff + существующий анти-дрейф (TC-02) |
+| AC-7 | BR-6 / FR-2, FR-3 | структурный тест bootstrap/дока (TC-07, TC-10) |
+| AC-8 | BR-7 / FR-2 | unit-тесты чистых функций preflight/плана (TC-08) + ручной повторный прогон |
+| AC-9 | NFR-3, NFR-4, NFR-6 / FR-1, FR-4 | структурные тесты гигиены (TC-03, TC-06, TC-09) |

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

@@ -0,0 +1,102 @@
+work_item: ORCH-103
+stage: analysis
+author_agent: analyst
+status: ready-for-review
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+title: "Bundled-тираж: bundle-compose + bootstrap + BUNDLED_SETUP.md (структурные анти-дрейф тесты)"
+framework: pytest
+scope: >
+  Автоматическое покрытие — СТРУКТУРНЫЕ инварианты артефактов Bundled-тиража
+  (bundle-compose, bootstrap-скрипт, docs/deployment/BUNDLED_SETUP.md) без docker/сети/LLM
+  в CI (паттерн tests/test_lite_setup_doc.py). Вне автоматического покрытия — фактический
+  e2e-подъём стека: он принимается ВРУЧНУЮ по чек-листу BUNDLED_SETUP §smoke
+  (шаги REPLICATION.md §4) на чистом тестовом хосте/VM — см. notes (AC-1/AC-2/AC-3/AC-8).
+notes: >
+  Ручная приёмка (вне CI): чистый Linux-хост/VM -> docker compose -f <bundle> up -d ->
+  один запуск bootstrap (manual-step чекпоинты Plane CE допустимы и проверяются) ->
+  health/queue/metrics зелёные -> onboard verify -> тестовая задача доезжает до артефактов
+  01-04 (минимальный сигнал), опционально до done; повторный запуск bootstrap безопасен;
+  тома чистые, секреты новые. Имена модулей tests/test_bundle_compose.py /
+  tests/test_bundled_setup_doc.py / tests/test_bootstrap_script.py — норматив тест-плана;
+  имена bundle-каталога/скрипта внутри ассертов следуют ADR-001 архитектора.
+  Полный регресс tests/ обязан остаться зелёным БЕЗ ослабления ассертов существующих
+  анти-дрейф тестов (test_lite_setup_doc.py, test_no_host_hardcodes.py, канон ORCH-009).
+
+tests:
+  # ---------- FR-1 / AC-1: bundle-compose ----------
+  - id: TC-01
+    type: unit
+    description: "Bundle-compose существует и валидно парсится (yaml.safe_load); содержит обязательные сервисы: orchestrator, orchestrator-watchdog, Gitea и Plane-стек (имена — по ADR-001); staging-контур орка не входит в дефолтный up"
+    module: tests/test_bundle_compose.py
+    expected: PASS
+
+  - id: TC-02
+    type: unit
+    description: "Корневой docker-compose.yml НЕ изменён: множество сервисов == {orchestrator, orchestrator-watchdog, orchestrator-staging}; в его сервисах/образах/container_name нет подстрок plane/gitea (зеркало TC-04 test_lite_setup_doc.py — существующий анти-дрейф остаётся зелёным)"
+    module: tests/test_bundle_compose.py
+    expected: PASS
+
+  - id: TC-03
+    type: unit
+    description: "Все сторонние образы bundle-compose пиннованы: ни одного image с тегом latest или без тега/digest (NFR-6, воспроизводимость)"
+    module: tests/test_bundle_compose.py
+    expected: PASS
+
+  - id: TC-04
+    type: unit
+    description: "Изоляция и конфиг-канон bundle: тома — именованные с узнаваемым bundle-префиксом, без bind-путей нашего прод-контура; bundle-конфиг-канон (example-файл) существует, и каждая ${VAR}-интерполяция bundle-compose имеет ключ в каноне (key-set-sync, паттерн .env.watchdog.example)"
+    module: tests/test_bundle_compose.py
+    expected: PASS
+
+  # ---------- FR-4 / AC-4: BUNDLED_SETUP.md ----------
+  - id: TC-05
+    type: unit
+    description: "docs/deployment/BUNDLED_SETUP.md существует и несёт обязательные разделы FR-4 (включая 'Требования к хосту' с цифрами RAM/диск/CPU, картой портов и упоминанием ~14 контейнеров Plane; bootstrap; smoke; stateless-проверка; остановка/сброс; траблшутинг); исполняемые шаги оформлены fenced-блоками с явной 'Проверка:'"
+    module: tests/test_bundled_setup_doc.py
+    expected: PASS
+
+  - id: TC-06
+    type: unit
+    description: "Гигиена новых артефактов (док + bundle-compose + bootstrap): нет FORBIDDEN-литералов (список — импорт из tests/test_no_host_hardcodes.py) и нет высокоэнтропийных секрет-литералов (hex >=32 / alnum >=40, эвристика D8 ORCH-102)"
+    module: tests/test_bundled_setup_doc.py
+    expected: PASS
+
+  # ---------- FR-2/FR-3 / AC-7: bootstrap переиспользует кирпичи ----------
+  - id: TC-07
+    type: unit
+    description: "Bootstrap-скрипт существует и структурно переиспользует канон: ссылается на scripts/gen_secrets.py и scripts/onboard_project.py; НЕ несёт собственного списка Plane-статусов/лейблов; в обычном прогоне нет delete-операций (docker volume rm / rm -rf допустимы только в отдельном явном reset-режиме, если введён ADR)"
+    module: tests/test_bootstrap_script.py
+    expected: PASS
+
+  - id: TC-08
+    type: unit
+    description: "Чистые функции bootstrap (preflight/план шагов): грязное состояние (существующие bundle-тома, занятый порт, нехватка RAM/диска) -> отказ с диагностикой ДО мутаций; чистое -> план полного прогона; контракт exit-кодов 0/2/1 (успех / manual-step-остановка / ошибка)"
+    module: tests/test_bootstrap_script.py
+    expected: PASS
+
+  # ---------- FR-4/FR-5 / AC-9: env-канон и нулевой дрейф ----------
+  - id: TC-09
+    type: unit
+    description: "Каждый env-ключ ORCH_*/WATCHDOG_*, упомянутый в BUNDLED_SETUP.md, существует в .env.example либо в bundle-конфиг-каноне (нет ключей-фантомов); упоминание ЧИСЛА статусов Plane сверяется импортом len(plane_sync._PLANE_NAME_TO_KEY), а не зашитым литералом"
+    module: tests/test_bundled_setup_doc.py
+    expected: PASS
+
+  - id: TC-10
+    type: unit
+    description: "Кросс-ссылки канона: BUNDLED_SETUP.md ссылается на LITE_SETUP.md, ONBOARDING.md и REPLICATION.md (канон не форкается); docs/operations/REPLICATION.md §1 несёт отметку Type B -> BUNDLED_SETUP.md / ORCH-103"
+    module: tests/test_bundled_setup_doc.py
+    expected: PASS
+
+  # ---------- AC-5: журнал и полный регресс ----------
+  - id: TC-11
+    type: unit
+    description: "CHANGELOG.md содержит запись ORCH-103"
+    module: tests/test_bundled_setup_doc.py
+    expected: PASS
+
+  - id: TC-12
+    type: integration
+    description: "Полный регресс pytest tests/ -q зелёный: новые тесты добавлены, существующие анти-дрейф (test_lite_setup_doc.py, test_no_host_hardcodes.py, канон-тесты ORCH-009) проходят БЕЗ изменения их ассертов"
+    module: tests/
+    expected: PASS

docs/work-items/ORCH-103/06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md

@@ -0,0 +1,362 @@
+---
+work_item: ORCH-103
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# ADR-001: Bundled-тираж (Type B) — bundle-compose всего стека + bootstrap-канон
+
+Work Item: **ORCH-103** — ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+Стадия: **architecture**
+Сквозная регистрация: **`docs/architecture/adr/adr-0038-bundled-replication-canon.md`**
+(закрывает Type B эпика ORCH-10; вводит новый top-level каталог `deploy/` и нормативы,
+обязательные для будущих задач тиража).
+
+## Статус
+Proposed
+
+## Контекст
+
+Эпик ORCH-10 (D5 «Масштаб»), тип **B — Bundled**: заказчик без собственной инфраструктуры
+получает **весь стек одним комплектом** (орк + watchdog + Gitea + Plane CE) + bootstrap,
+доводящий стек до рабочего конвейера одним запуском. Факты, сверенные с репо:
+
+- **Корневой `docker-compose.yml` заморожен анти-дрейфом** (`tests/test_lite_setup_doc.py::
+  test_compose_services_are_exactly_the_lite_set` + `test_compose_has_no_plane_or_gitea_services`):
+  ровно 3 сервиса, подстроки `plane`/`gitea` запрещены → bundle обязан быть **отдельным файлом**.
+- **Кирпичи уже в `main`:** `scripts/gen_secrets.py` (webhook-секреты, `--write PATH`, exit 0/2),
+  `scripts/onboard_project.py` (`plan`/`apply`/`verify`, 22 статуса из
+  `plane_sync._PLANE_NAME_TO_KEY`, шаг `plane.workspace-webhook` — уже **MANUAL** в его отчёте,
+  token-push `_push_url`, exit 0/2/1; запуск — host-venv, `docs/operations/ONBOARDING.md`),
+  smoke `docs/operations/REPLICATION.md` §4, док-канон `docs/deployment/LITE_SETUP.md` (ORCH-102).
+- **Хост-параметризация закрыта ORCH-101** (adr-0036): `src/**` без хост-литералов
+  (`tests/test_no_host_hardcodes.py`, FORBIDDEN = `82.22.50.71`/`/home/slin`/`mva154`/`duckdns`);
+  internal/public split URL уже в конфиге (`ORCH_GITEA_URL`≠`ORCH_GITEA_PUBLIC_URL`,
+  `ORCH_PLANE_API_URL`≠`ORCH_PLANE_WEB_URL`).
+- **`.gitignore` уже неякорный** для `.env`, `data/`, `.env.watchdog` — вложенные копии этих имён
+  игнорируются на любом уровне без правок.
+- **Claude CLI не запекается** в образ (маунты `ORCH_HOST_CLAUDE_*`) — внешнее предусловие хоста
+  заказчика; bundle его не поставляет (решение Владельца, BRD §1.3).
+
+ТЗ (02-trz.md §9) оставило архитектору OQ-1…OQ-7. Ниже — пакет решений D1…D11.
+
+## Решение
+
+### Сводка
+
+Bundled-комплект живёт в новом top-level каталоге **`deploy/bundled/`**: самодостаточный
+compose-файл всего стека (зеркало официального Plane CE selfhost-référence + Gitea + орк +
+watchdog, пиннинг неподвижными тегами) на **одной bridge-сети** с сервис-DNS для машинного
+трафика и публикацией только «человеческих» портов. **`scripts/bootstrap_bundle.py`**
+(python stdlib, режимы `plan`/`apply`/`verify`, step-движок check→ensure, exit 0/2/1) доводит
+стек: preflight → секреты → up → init Gitea (полностью автоматом) → init Plane (честные
+manual-step с верификацией) → онбординг sandbox-проекта **строго** через `onboard_project.py` →
+git-доступ агентов token-remote → сборка `.env`/`.env.watchdog` орка → health/итог. Teardown —
+только документированная процедура. Рантайм байт-в-байт: `src/**`, корневой compose,
+`Dockerfile`, `STAGE_TRANSITIONS`/`QG_CHECKS`/machine-verdict/схема БД — не тронуты (NFR-1);
+kill-switch не нужен — активация только явным запуском оператора на целевом хосте
+(паттерн ORCH-009/102).
+
+### D1 — Расположение и изоляция: `deploy/bundled/`, project name `orchestrator-bundle` (OQ-1)
+
+- Новый top-level каталог **`deploy/`** — «дистрибутивы развёртывания» (исполняемые комплекты;
+  семантика дополняет `docs/deployment/` — инструкции). Bundle: **`deploy/bundled/docker-compose.yml`**,
+  один **самодостаточный** файл (include-композиция отвергнута — см. Альтернативы).
+- Top-level **`name: orchestrator-bundle`** в compose: project name фиксирован → все тома/контейнеры
+  получают узнаваемый префикс `orchestrator-bundle_*`/`orchestrator-bundle-*` (требование TC-04
+  тест-плана «узнаваемый bundle-префикс»; preflight bootstrap детектирует «грязный хост» по этому
+  префиксу). **`container_name` не пиннится ни у одного сервиса** — установка Lite и bundle на одном
+  хосте не сталкивается по именам с корневым compose (у которого `container_name: orchestrator`
+  закреплён).
+- **Staging-контур орка в bundle отсутствует вовсе** (ни сервисом, ни профилем): заказчик Type B
+  эксплуатирует платформу для СВОИХ проектов, а не развивает её self-hosting'ом; репо `orchestrator`
+  в bundle-инсталляции **не регистрируется** как проект → вся self-deploy-машинерия
+  (`SELF_HOSTING_REPO="orchestrator"`-леафы, freshness, serial-gate freeze) структурно спит.
+  Нужен self-hosting у заказчика → это маршрут Lite/корневого compose (LITE_SETUP §9), не bundle.
+- Имена сервисов: `orchestrator`, `orchestrator-watchdog` — платформенные конвенции (ORCH-101 D3);
+  `gitea`; Plane-стек — **upstream-имена** сервисов (минимальный дифф к référence, D3 ниже).
+  Запрет `plane*`/`gitea*` касается ТОЛЬКО корневого compose — на bundle-файл не распространяется.
+
+### D2 — Конфиг-слои: три файла, один писатель (OQ-1, FR-1/FR-3)
+
+| Файл | Роль | В гите |
+|------|------|--------|
+| `deploy/bundled/.env.example` | **bundle-конфиг-канон**: 100% ключей bundle-инфры (публичный хост, карта портов, uid/gid, пути Claude CLI, плейсхолдеры внутренних кред Plane/Gitea) | да (только плейсхолдеры/нейтральные дефолты) |
+| `deploy/bundled/.env` | live bundle-конфиг; **авто-читается compose** из project dir — все `docker compose -f deploy/bundled/docker-compose.yml …` работают без флагов | нет (покрыт неякорным `.env` в `.gitignore`) |
+| корневые `.env` / `.env.watchdog` | runtime-конфиг орка и watchdog — **ровно канон Lite** (REPLICATION §2 / `.env.example` / `.env.watchdog.example` применимы 1:1); в bundle-compose подключаются `env_file: ../../.env` (`required: false` — см. ниже) | нет (уже в `.gitignore`) |
+
+- **Отвергнут** отдельный live-файл с обязательным `--env-file`: оператор неизбежно наберёт голую
+  compose-команду без флага → интерполяции молча упадут в дефолты → пересоздание контейнеров с
+  чужими портами/путями (труднодиагностируемый класс R-4). Авто-`.env` в project dir — fail-safe
+  по построению.
+- **`env_file` орка/watchdog — `required: false`** (паттерн уже в корневом compose у watchdog):
+  первый `up -d` поднимает ВЕСЬ стек до того, как конфиг орка собран (AC-1 «одна команда»); орк
+  без конфига жив (`/health` отвечает), bootstrap пересоздаёт его после сборки env (шаг 8 D5).
+- **Bootstrap — единственный писатель** `deploy/bundled/.env` (дозапись сгенерённых кред),
+  корневого `.env` и `.env.watchdog` на целевом хосте: дублируемые между слоями ключи
+  (`ORCH_AGENT_HOME_DIR`, порт орка) когерентны механически, а не дисциплиной оператора.
+  Права `600`; повторный запуск НЕ перетирает существующие значения без явного флага
+  (паттерн `--force` `gen_secrets.py`).
+- **Неймспейсы ключей:** один факт = одно имя (ORCH-101 D1) — существующие факты переиспользуют
+  существующие имена (`ORCH_RUN_UID/GID`, `ORCH_DOCKER_GID`, `ORCH_AGENT_HOME_DIR`,
+  `ORCH_HOST_CLAUDE_CODE_DIR`/`ORCH_HOST_NODE_BIN`/`ORCH_HOST_CLAUDE_DIR`/`ORCH_HOST_CLAUDE_JSON`);
+  bundle-only факты — префикс **`BUNDLE_*`** (`BUNDLE_PUBLIC_HOST`, `BUNDLE_PLANE_PORT`,
+  `BUNDLE_GITEA_HTTP_PORT`, `BUNDLE_ORCH_PORT`); внутренние креды Plane-стека — **upstream-имена**
+  Plane CE (значения генерирует bootstrap). Точный состав финализирует developer; форму держит
+  key-set-sync тест: **каждая `${VAR}`-интерполяция bundle-compose имеет ключ в
+  `deploy/bundled/.env.example`** (паттерн `.env.watchdog.example`, D5 ORCH-102).
+- **Дефолты bundle-compose нейтральны** (FORBIDDEN-литералов нет — TC-06 распространяет скан на
+  bundle-артефакты): HOME акторов в bundle — `/home/orchestrator` (значение в `.env.example`
+  bundle, обе стороны группы ORCH-040 двигаются одной переменной — инвариант сохранён);
+  uid/gid/доки docker-gid заполняет bootstrap из `id -u`/`id -g`/`getent group docker`.
+- Каталоги данных орка — bind внутри project dir: `./data` → `deploy/bundled/data` (покрыт
+  неякорным `data/` в `.gitignore`), `./repos` → `deploy/bundled/repos` (**добавить в
+  `.gitignore`**: `deploy/bundled/repos/`); bind, а не named volume — те же uid-причины, что в
+  корневом compose (ORCH-040: named volume создаётся root-owned, контейнер бежит под uid
+  оператора). Состояние Plane/Gitea (postgres/redis/mq/minio/gitea-data) — **именованные тома**
+  проекта (root-владение для них нормально: процессы своих образов).
+
+### D3 — Состав стека и пиннинг: зеркало upstream, неподвижные теги литералом (OQ-2)
+
+- **Plane CE** — зеркало официального selfhost-compose Plane CE (web/space/admin/api/worker/
+  beat-worker/migrator/live + postgres/redis/mq/minio/proxy, ≈13–14 сервисов по факту référence
+  на момент пиннинга). Структура сервисов/env-контракт — upstream-имена (анти-дрейф к их докам;
+  своя «переписанная» топология Plane = неоплачиваемый долг сопровождения).
+- **Gitea** — официальный `gitea/gitea` (НЕ rootless: rootless усложняет ssh/тома, а ssh-контур
+  и так не вводится — D8).
+- **Пиннинг: точный неподвижный тег литералом в compose** (`image: <repo>:<x.y.z>`), не `latest`,
+  не плавающий мажор, не `${VERSION}`-интерполяция (версия — не операторская ручка; её смена =
+  осознанная правка bundle под тестом). Digest-пиннинг **не требуется**: тег + анти-дрейф формы
+  (TC-03: ни одного `:latest`/безтегового образа) достаточны для NFR-6, digest нечитаем и
+  затрудняет осознанный апгрейд.
+- **Точные теги фиксирует developer при реализации по фактически проверенному стенду** (ADR
+  сознательно не выдумывает номера версий — ложная точность хуже честной отсылки к référence);
+  обновление версий после ORCH-103 — отдельные задачи (BRD §6).
+- Healthchecks: у инфра-сервисов (postgres/redis/minio/gitea) — стандартные; у Plane-сервисов —
+  что даёт upstream; недостающее добирает poll-ожидание bootstrap (D5).
+
+### D4 — Сеть: одна bridge, сервис-DNS внутрь, публикация только человеческих портов (OQ-5)
+
+- **Вся инсталляция — в одной именованной bridge-сети** compose-проекта. `network_mode: host`
+  в bundle **не используется** ни для кого: он был нужен нашему контуру ради ssh-деплоя в
+  127.0.0.1 (ORCH-036/058) — в bundle эти пути структурно неактивны (`ORCH_DEPLOY_SSH_HOST`
+  пуст → freshness/self-deploy/build-cache-pruner no-op по построению).
+- **Машинный трафик — строго сервис-DNS:** Plane→орк webhook `http://orchestrator:8500/webhook/plane`,
+  Gitea→орк `http://orchestrator:8500/webhook/gitea`, орк→Plane `ORCH_PLANE_API_URL=http://<plane-proxy-svc>`,
+  орк→Gitea `ORCH_GITEA_URL=http://gitea:3000`, watchdog→орк
+  `WATCHDOG_METRICS_URL=http://orchestrator:8500/metrics`. Никаких `host-gateway`/`extra_hosts`.
+- **Наружу публикуются только человеческие точки** (карта конфигурируема в bundle-каноне,
+  дефолты): Plane proxy → `${BUNDLE_PLANE_PORT:-8080}`, Gitea web → `${BUNDLE_GITEA_HTTP_PORT:-3000}`,
+  орк API → `${BUNDLE_ORCH_PORT:-8500}` (операторский smoke `curl /health`). **Postgres/redis/
+  mq/minio наружу НЕ публикуются** (секрет-гигиена/поверхность атаки).
+- **Публичные URL** (браузер оператора, ссылки в Plane-комментариях/Telegram) строятся от
+  **`BUNDLE_PUBLIC_HOST`** (дефолт `localhost`): `ORCH_GITEA_PUBLIC_URL=http://$BUNDLE_PUBLIC_HOST:3000`,
+  `ORCH_PLANE_WEB_URL=http://$BUNDLE_PUBLIC_HOST:8080`, WEB_URL Plane, ROOT_URL Gitea. Split
+  internal/public уже поддержан конфигом орка (ORCH-101) — новых ключей `src/**` не требуется.
+- **Мина Gitea закрывается явно:** Gitea по умолчанию запрещает webhook'и в приватные адреса —
+  bundle задаёт `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator` (env-конфиг образа Gitea), иначе
+  R-4 «задача не появилась» гарантирован. Smoke (FR-6) проверяет оба направления.
+- HTTPS/домены/reverse-proxy заказчика — вне bundle (BRD §2.2); `BUNDLE_PUBLIC_HOST` +
+  документированный ручной шаг при необходимости.
+
+### D5 — Bootstrap: `scripts/bootstrap_bundle.py`, python stdlib, `plan`/`apply`/`verify` (OQ-4)
+
+- **Язык — python stdlib-only** (NFR-7; паттерн `gen_secrets.py`: работает на голом python3
+  целевого хоста ДО `docker compose up`; bash отвергнут — 9-шаговый stateful-визард с
+  таймаутами/JSON/чистыми функциями под unit-тесты на bash не тестируем структурно).
+  Никаких импортов из `src/**` (bootstrap бежит вне venv платформы; канон-знания — только
+  субпроцессами кирпичей, см. ниже).
+- **Режимы (паттерн ORCH-009):** `plan` — **дефолт**, ноль мутаций (печать плана + read-only
+  preflight-диагностика); `apply` — полный прогон; `verify` — read-only пост-проверка
+  (health/queue/metrics + `onboard_project.py verify` субпроцессом). Exit-коды: `0` успех /
+  `2` остановка на manual-step или незавершённое предусловие / `1` ошибка (контракт TRZ FR-2).
+- **Step-движок check→ensure:** каждый шаг = `check()` (выполнено?) → skip | `ensure()`
+  (доводка). Повторный `apply` на инициализированном bundle = каскад skip (AC-8);
+  «resume» после manual-step = просто повторный запуск. Чистые функции (preflight-вердикт,
+  сборка плана, рендер env-файлов) выделены для unit-тестов (TC-08).
+- **Последовательность apply (норматив TRZ FR-2, механика):**
+  1. **Preflight (fail-fast, до мутаций):** docker+compose есть; `deploy/bundled/.env` существует
+     и обязательные ключи заполнены (пути Claude CLI — существуют на хосте, иначе warning-блок:
+     стек поднимется, конвейер без LLM не поедет); целевые порты свободны; томов/контейнеров с
+     префиксом `orchestrator-bundle` нет (иначе — явный «уже инициализирован, продолжаю в
+     ensure-режиме» либо отказ при противоречивом состоянии); RAM/диск ≥ минимумов из
+     BUNDLED_SETUP (пороги — константы скрипта, синхронизированы с доком); python3+venv доступны.
+  2. **Секреты (FR-3):** webhook-секреты — **субпроцессом `scripts/gen_secrets.py --write <tmp>`**
+     (не реализуются заново, AC-7); bundle-внутренние (пароли postgres/redis/mq/minio,
+     SECRET_KEY Plane, админ-пароль Gitea) — stdlib `secrets`; запись в `deploy/bundled/.env` +
+     корневой `.env`; существующие значения не перетираются без `--force-secrets`; значения
+     в stdout/лог **не печатаются** (только имена ключей).
+  3. **Up + готовность:** `docker compose -f deploy/bundled/docker-compose.yml up -d`
+     (идемпотентен по построению — оба прочтения AC-1 истинны: оператор мог выполнить up сам);
+     ожидание готовности poll-циклами с таймаутами (health контейнеров, `migrator` завершился
+     `exit 0`, HTTP-пробы Plane/Gitea); по таймауту — диагностика «какой сервис не дождались +
+     хвост его логов».
+  4. **Init Gitea — полностью автоматом** (D6).
+  5. **Init Plane — manual-step чекпоинты** (D7).
+  6. **Онбординг sandbox-проекта — строго `onboard_project.py apply` + `verify`** (D7).
+  7. **Git-доступ агентов** (D8) + клон sandbox-репо в `deploy/bundled/repos/`.
+  8. **Конфиг орка:** сборка корневого `.env` (база — канон `.env.example`: URL'ы D4, токены,
+     секреты, `ORCH_PROJECTS_JSON` из вывода onboard; `ORCH_DEPLOY_SSH_HOST=` пусто —
+     деплой-машинерия спит) и `.env.watchdog` (база — `.env.watchdog.example`; Telegram-ключи
+     опциональны — пусто = деградация только нотификаций); пересоздание
+     `up -d orchestrator orchestrator-watchdog` для подхвата env.
+  9. **Health + итог:** `GET /health`, `/queue`, `/metrics`; финальная сводная таблица PASS/FAIL
+     по шагам; следующая команда оператора — smoke BUNDLED_SETUP §smoke (REPLICATION §4).
+- **Контракт manual-step (fail-safe, BR-2):** печать точной инструкции (URL/что нажать/что
+  ввести) → ожидание подтверждения (интерактивно при TTY; без TTY — немедленный `exit 2` с той
+  же инструкцией) → **верификация результата API-пробой** (например, валидность введённого
+  `ORCH_PLANE_API_TOKEN` запросом к workspace) → только затем продолжение. Молчаливый пропуск
+  запрещён.
+- **Запретов в скрипте нет:** delete-операций (`docker volume rm`/`rm -rf`/`down -v`) — **ноль**
+  (teardown — D9); боевых литералов FORBIDDEN — ноль (TC-06); печати секретов — ноль (NFR-3);
+  наш прод недостижим по построению (скрипт говорит только с локальным docker целевого хоста).
+
+### D6 — Init Gitea: полностью автоматизирован, branch protection НЕ настраивается (OQ-3-часть)
+
+- Административная учётка — **официальный CLI в контейнере**:
+  `docker compose … exec gitea gitea admin user create --admin …` (idempotent: предсуществование
+  пользователя → skip); API-токен — `gitea admin user generate-access-token` (или REST под basic
+  auth — равнозначно, выбирает developer по фактической версии Gitea) → `ORCH_GITEA_TOKEN`.
+- **Один пользователь-бот** — владелец (`ORCH_GITEA_OWNER`) sandbox-репо и носитель токена для
+  API орка и token-remote агентов (D8). Отдельная россыпь пользователей на тестовый bundle —
+  неоправданная сложность (зафиксировано как осознанный компромисс в 10-tech-risks TR-7).
+- **Branch protection на `main` НЕ включается; pre-receive не вводится** — норматив D10 ORCH-009 /
+  adr-0037 п.4 (ломают PR-merge API merge-актора, INV-4); bundle-Gitea конфигурируется тем же
+  правилом, BUNDLED_SETUP фиксирует его явно (ссылкой на LITE_SETUP §6, не копией).
+- `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator` — см. D4.
+
+### D7 — Init Plane: честные manual-step + онбординг строго кирпичом (OQ-3)
+
+- **Не автоматизируется (CE):** instance-setup/первый админ, создание workspace
+  (`ORCH_PLANE_WORKSPACE_SLUG`), выпуск `ORCH_PLANE_API_TOKEN` — три **manual-step чекпоинта**
+  контракта D5 (инструкция → подтверждение → API-верификация). **Прогрессивная автоматизация
+  разрешена:** если на момент реализации у конкретной пиннованной версии Plane CE обнаружится
+  стабильный API/seed-механизм для шага — developer вправе заменить manual-step на ensure **без
+  изменения контракта чекпоинта** (верификация результата остаётся той же) и без правки ADR.
+- **Онбординг sandbox-проекта — ТОЛЬКО субпроцессом** `python3 scripts/onboard_project.py apply`
+  + `verify` из **host-venv чекаута** (канон запуска — ONBOARDING.md: venv с `requirements.txt`;
+  создание venv — ensure-шаг bootstrap). Env для субпроцесса (URL'ы/токены D4) bootstrap передаёт
+  через окружение процесса (pydantic env-переменные перекрывают `env_file`) — корневой `.env` к
+  этому моменту уже собран либо передаётся фрагментом. Собственная реализация статусов/лейблов/
+  webhook в bootstrap **запрещена** (BR-6/AC-7; 22 статуса остаются за
+  `plane_sync._PLANE_NAME_TO_KEY`).
+- **Workspace-webhook Plane** (Plane→орк) — остаётся manual-step **самого onboard-CLI**
+  (его шаг `plane.workspace-webhook` уже MANUAL — CE не даёт API); bootstrap лишь подставляет
+  правильный in-network URL `http://orchestrator:8500/webhook/plane` и секрет-имя в инструкцию
+  и верифицирует доставку на smoke (FR-6).
+- `--webhook-url` для Gitea per-repo hook — `http://orchestrator:8500/webhook/gitea` (D4).
+
+### D8 — Git-доступ агентов: HTTP token-remote; ssh-контур не вводится (OQ-6)
+
+- Клон sandbox-репо в `deploy/bundled/repos/<repo>` с remote-URL вида
+  `http://<token>@gitea:3000/<owner>/<repo>.git` — **паттерн уже в каноне**
+  (`onboard_project.py::_push_url` делает initial push именно так); агенты наследуют origin
+  чекаута (push/fetch из контейнера — bridge-DNS, D4).
+- **Ssh-контур в bundle не вводится:** ssh-порт Gitea не публикуется, маунт `ORCH_HOST_SSH_DIR`
+  в bundle-compose отсутствует (это нашему контуру нужен ssh к хосту/Gitea; в bundle —
+  лишняя поверхность: генерация ключей, known_hosts, регистрация в Gitea).
+- Компромисс «токен в `.git/config` plaintext» зафиксирован честно: каталог `deploy/bundled/repos`
+  — локальный, права на токен-носители `600`, токен — бот-юзера одной тестовой инсталляции;
+  риск/митигейшн — 10-tech-risks TR-7. Git-идентичность агентов — существующие
+  `ORCH_AGENT_GIT_NAME`/`ORCH_GIT_EMAIL_DOMAIN` (дефолты годятся).
+
+### D9 — Teardown: только документированная процедура, не режим скрипта (OQ-7)
+
+`BUNDLED_SETUP.md` §13 «Остановка и полный сброс»: `docker compose -f … down` (остановка) /
+`down -v` + удаление сгенерённых конфигов и `deploy/bundled/{data,repos}` (полный сброс) — с
+явным предупреждением о необратимости. **Reset-режим в bootstrap отвергнут:** одна опечатка
+флага = снос томов; ценность против fenced-команды — нулевая; зато скрипт получает структурную
+гарантию «delete-операций НЕТ вообще» (упрощение TC-07 и ревью).
+
+### D10 — Док-канон: `docs/deployment/BUNDLED_SETUP.md`, 14 разделов, ссылки вместо форка (FR-4)
+
+Форма — канон LITE_SETUP (adr-0037 D2): нормативные разделы в порядке маршрута оператора,
+каждый исполняемый шаг = fenced-команда + «Проверка:» PASS/FAIL, хост-специфика — только
+плейсхолдеры. **14 разделов** (норматив; точные заголовки — за developer'ом, проверяемость —
+структурный тест): (1) рамка Bundled (включая «что НЕ входит»: Claude CLI, Telegram, HTTPS;
+границы vs Lite); (2) **требования к хосту** (RAM/диск/CPU **по замеру тестового развёртывания**,
+карта портов D4, явное «Plane ≈ 14 контейнеров — ресурсоёмко»); (3) предусловия;
+(4) получение кода; (5) секреты; (6) запуск bundle-compose; (7) bootstrap (+ перечень
+manual-step Plane); (8) LLM — ссылкой на LITE_SETUP §7; (9) Telegram — ссылкой на LITE_SETUP §8;
+(10) онбординг следующих проектов — ссылкой на ONBOARDING.md; (11) smoke — шаги REPLICATION §4;
+(12) stateless-проверка; (13) остановка/полный сброс (D9); (14) траблшутинг (минимум: webhook
+не доходит — включая `ALLOWED_HOST_LIST`, OOM/нехватка RAM, порт занят, claude не найден,
+Plane-миграции не завершились). Fail-closed имена `Confirm Deploy`/`STOP` и «22 статуса» —
+сверкой импорта в тесте, не литералом. `docs/operations/REPLICATION.md` §1: строка Type B →
+✅ ORCH-103 + ссылка. **Норматив сопровождения (NFR-5):** изменил шаги Bundled-тиража → обнови
+BUNDLED_SETUP.md в том же PR.
+
+### D11 — Анти-дрейф: три структурных тест-модуля (FR-5; без docker/сети/LLM)
+
+По тест-плану `04-test-plan.yaml` (имена модулей — норматив): `tests/test_bundle_compose.py`
+(TC-01…04: yaml.safe_load, обязательные сервисы, заморозка корневого compose зеркалом
+существующего ассерта, пины образов, префикс томов, key-set-sync `${VAR}` ⊆
+`deploy/bundled/.env.example`), `tests/test_bundled_setup_doc.py` (TC-05/06/09/10/11: разделы
+D10, FORBIDDEN — **импорт** из `test_no_host_hardcodes.py`, секрет-эвристика hex≥32/alnum≥40 —
+паттерн D8 ORCH-102, env-ключи ⊆ канонов, число статусов — импортом `plane_sync`, кросс-рефы,
+CHANGELOG), `tests/test_bootstrap_script.py` (TC-07/08: ссылки на кирпичи, отсутствие
+delete-операций и собственного списка статусов, unit чистых функций preflight/плана/рендера,
+контракт exit 0/2/1). Существующие анти-дрейф тесты остаются зелёными **без правки их ассертов**
+(AC-5/AC-6).
+
+## Альтернативы
+
+- **Расширить корневой `docker-compose.yml` (профиль `bundled`)** — отвергнуто: заморожен
+  анти-дрейфом ORCH-102 (TC-04) и нормативом adr-0037 п.2 «compose не форкается»; смешение
+  боевого контура с дистрибутивом = групповой риск self-hosting.
+- **Include-композиция (`include:`/несколько `-f`)** — отвергнуто: многофайловость = новые
+  степени свободы запуска (забытый `-f` молча меняет состав), сложнее структурный тест; один
+  самодостаточный файл проще и детерминированнее (NFR-6).
+- **Live env через `--env-file deploy/bundled/.env.bundled`** — отвергнуто: footgun голой
+  compose-команды без флага (молчаливые дефолты) — см. D2.
+- **Орк в bundle под `network_mode: host` + `host-gateway` для webhook'ов** — отвергнуто:
+  хост-сеть нужна была нашему ssh-деплой-контуру, который в bundle спит; bridge даёт чистые
+  стабильные сервис-DNS-URL обоих направлений и нулевые порт-конфликты (D4).
+- **Digest-пиннинг образов** — отвергнуто: нечитаем, усложняет осознанный апгрейд; неподвижный
+  тег + тест формы достаточны для NFR-6 (D3).
+- **Ssh-доступ агентов к bundle-Gitea** — отвергнуто: три лишних механизма (ключи, known_hosts,
+  регистрация) против уже существующего token-remote-паттерна onboard (D8).
+- **Bash-bootstrap** — отвергнуто: нет unit-тестируемых чистых функций (TC-08), JSON/поллинг/
+  стейт-машина шагов на bash хрупки (D5).
+- **Reset-режим bootstrap** — отвергнуто: риск-поверхность против нулевой ценности (D9).
+- **Переписать Plane-стек «по-своему» (свои имена сервисов/env)** — отвергнуто: дрейф от
+  upstream-доков, неоплачиваемое сопровождение (D3).
+
+## Последствия
+
+- **+** Эпик ORCH-10 закрывается по типу B: заказчик без инфраструктуры получает конвейер
+  «под ключ» одной командой + одним bootstrap-прогоном с честными чекпоинтами.
+- **+** Нулевой дрейф канонов: статусы/лейблы/секреты/smoke/док-форма — переиспользованы
+  (gen_secrets, onboard_project, REPLICATION §4, форма LITE_SETUP); рантайм байт-в-байт.
+- **+** Наш прод недостижим по построению: артефакты инертны в нашем контуре, kill-switch не
+  нужен (паттерн ORCH-009); все существующие анти-дрейф тесты остаются зелёными.
+- **−** Новая поверхность сопровождения: пиннованные версии Plane/Gitea стареют (апгрейд —
+  отдельные задачи, NFR-6); двойной `.env`-слой (bundle-инфра vs runtime орка) требует
+  дисциплины «писатель — bootstrap» (митигировано D2: один писатель + key-sync тест).
+- **−** Manual-step Plane CE размывают UX «одной команды» — неустранимо честно (CE без API
+  первичной инициализации); митигировано контрактом чекпоинта (инструкция+верификация) и
+  прогрессивной автоматизацией (D7).
+- **−** Токен в remote-URL агентских чекаутов — осознанный компромисс тестовой инсталляции
+  (TR-7; права 600, непубликуемые порты БД, один бот-юзер).
+- **Откат:** удалить `deploy/`, `scripts/bootstrap_bundle.py`, `docs/deployment/BUNDLED_SETUP.md`,
+  три тест-модуля, строку REPLICATION §1 и записи CHANGELOG/CLAUDE.md/README — состояние репо 1:1
+  (docs+scripts+tests, без миграций); на целевых хостах — процедура §13 (D9).
+
+## Ссылки
+
+- BRD: `docs/work-items/ORCH-103/01-brd.md`
+- TRZ: `docs/work-items/ORCH-103/02-trz.md` (OQ-1…OQ-7 → D1…D9)
+- Acceptance: `docs/work-items/ORCH-103/03-acceptance-criteria.md`; тест-план: `04-test-plan.yaml`
+- Сквозной ADR: `docs/architecture/adr/adr-0038-bundled-replication-canon.md`
+- Предшественники: adr-0035 (ORCH-009 onboarding: D10 branch-protection, manual-step, `_push_url`),
+  adr-0036 (ORCH-101 10-common: параметризация/«дефолт=боевое»/gen_secrets/REPLICATION),
+  adr-0037 (ORCH-102 Lite: док-канон/`.env.watchdog.example`/compose-подмножество)
+- Сверено по коду/репо: `tests/test_lite_setup_doc.py` (заморозка корневого compose, FORBIDDEN-импорт,
+  секрет-эвристика), `tests/test_no_host_hardcodes.py` (`FORBIDDEN`), `scripts/gen_secrets.py`
+  (`--write PATH`, exit 0/2), `scripts/onboard_project.py` (закрытый src-импорт-лист, MANUAL
+  `plane.workspace-webhook`, `_push_url`, exit 0/2/1), `docs/operations/ONBOARDING.md` (host-venv),
+  `docker-compose.yml` (паттерны `${VAR:-default}`, `env_file required:false`, группа ORCH-040),
+  `.gitignore` (неякорные `.env`/`data/`/`.env.watchdog`)

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

@@ -0,0 +1,73 @@
+---
+work_item: ORCH-103
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# 07 — Инфра-требования: ORCH-103 — Bundled-тираж: весь стек одним комплектом + bootstrap
+
+Work Item: **ORCH-103** · Repo: **orchestrator** · Стадия: architecture
+
+> Вся инфраструктура этой задачи — **ЦЕЛЕВОЙ хост заказчика** (и одноразовый тестовый хост/VM
+> приёмки). Инфраструктура НАШЕГО прод-контура (mva154) не затрагивается ни одним пунктом:
+> артефакты bundle в нашем контуре инертны (NFR-2, паттерн ORCH-009).
+
+## I-1. Топология / окружения
+
+**Наш контур: N/A** (корневой `docker-compose.yml`, прод 8500, staging 8501 — байт-в-байт).
+
+**Целевой хост bundle (нормативно, ADR-001 D1/D3/D4):**
+- Один Linux x86_64 хост, docker + docker compose v2, sudo у оператора. Compose-проект
+  **`orchestrator-bundle`** (`deploy/bundled/docker-compose.yml`), одна именованная bridge-сеть.
+- Состав: `orchestrator` (build из корневого `Dockerfile`), `orchestrator-watchdog`
+  (build из `watchdog/Dockerfile`), `gitea` (пиннованный `gitea/gitea`), Plane CE-стек —
+  зеркало upstream selfhost-référence (≈13–14 сервисов: web/space/admin/api/worker/beat-worker/
+  migrator/live + postgres/redis/mq/minio/proxy; точные теги пиннит developer по проверенному
+  стенду). Staging-контур орка отсутствует.
+- **Карта портов (дефолты; конфигурируемы в `deploy/bundled/.env.example`):**
+  `${BUNDLE_ORCH_PORT:-8500}` — API орка (smoke/health), `${BUNDLE_PLANE_PORT:-8080}` — Plane
+  proxy (UI), `${BUNDLE_GITEA_HTTP_PORT:-3000}` — Gitea web. Postgres/redis/mq/minio/ssh-Gitea —
+  **наружу не публикуются**. Машинный трафик (webhooks в обе стороны, API, git, /metrics) —
+  внутрисетевой сервис-DNS.
+- **Хранилище:** состояние Plane/Gitea — именованные тома `orchestrator-bundle_*`; данные орка —
+  bind `deploy/bundled/data`; репозитории агентов — bind `deploy/bundled/repos` (владелец —
+  uid оператора = `ORCH_RUN_UID`, инвариант ORCH-040).
+- **Ресурсы (предусловие, гипотеза BRD §6 — финальные цифры по замеру на приёмке, AC-4):**
+  ориентир ≥ 4 vCPU / 8 GB RAM / 40 GB диска; preflight bootstrap проверяет и отказывает до
+  любых мутаций (BR-7).
+
+## I-2. Переменные окружения / секреты
+
+- **Новый канон:** `deploy/bundled/.env.example` (bundle-инфра: `BUNDLE_PUBLIC_HOST`, карта
+  портов, реюз `ORCH_RUN_UID/GID`/`ORCH_DOCKER_GID`/`ORCH_AGENT_HOME_DIR`/`ORCH_HOST_CLAUDE_*`,
+  плейсхолдеры внутренних кред Plane/Gitea по upstream-именам). Live-файлы только на целевом
+  хосте, права 600: `deploy/bundled/.env`, корневые `.env`/`.env.watchdog` (каноны Lite 1:1).
+- **Корневой `.env.example` НЕ меняется** (bundle не вводит новых ключей `Settings`); в
+  `.gitignore` добавляется `deploy/bundled/repos/` (остальные live-файлы уже покрыты неякорными
+  `.env`/`data/`/`.env.watchdog`).
+- **Секреты (FR-3):** webhook-секреты — `gen_secrets.py`; внутренние креды стека (postgres/
+  redis/mq/minio/SECRET_KEY Plane, админ Gitea) — stdlib `secrets` в bootstrap; внешние
+  предусловия заказчика — Claude CLI/Anthropic-доступ (обязателен для конвейера),
+  Telegram-токены (опциональны). В репо и логах bootstrap секретов нет (NFR-3, тест-эвристика).
+
+## I-3. Деплой / рестарт
+
+- **Наш прод: рестарт НЕ требуется и НЕ выполняется.** Задача — docs+scripts+compose+tests;
+  мерж в `main` ничего не активирует в нашем контуре (никто не исполняет bundle-артефакты;
+  kill-switch не нужен — паттерн ORCH-009). Self-hosting инвариант соблюдён по построению.
+- На целевом хосте пересоздание контейнеров орка/watchdog после сборки env — штатный шаг
+  bootstrap (D5 шаг 8); к нашему проду отношения не имеет.
+
+## I-4. CI/CD
+
+- `.gitea/workflows/**` — **без изменений**; три новых структурных тест-модуля подхватываются
+  существующим `pytest tests/ -q` (без docker/сети/LLM — CI-безопасны, TC-12).
+
+## I-5. Разовое предусловие приёмки (человек)
+
+Чистый тестовый Linux-хост/VM (ресурсы I-1) для ручной приёмки AC-1/AC-2/AC-3/AC-8 по
+`BUNDLED_SETUP.md` + замер фактических минимумов RAM/диск/CPU для §2 дока (AC-4: цифры «не с
+потолка»). На нашем боевом хосте bundle не запускается ни в каком виде (BRD §2.2).

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

@@ -0,0 +1,42 @@
+---
+work_item: ORCH-103
+stage: architecture
+author_agent: architect
+status: proposed
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+---
+
+# 10 — Технические риски: ORCH-103 — Bundled-тираж: весь стек одним комплектом + bootstrap
+
+Work Item: **ORCH-103** · Repo: **orchestrator** · Стадия: architecture
+
+> Информационный (гейтом не парсится). Риски реализации и эксплуатации bundle; решения —
+> `06-adr/ADR-001-bundled-stack-compose-and-bootstrap.md` (D1…D11).
+
+## Реестр рисков
+
+| ID | Риск | Вер. | Влия. | Митигейшн |
+|----|------|------|-------|-----------|
+| TR-1 | **Ресурсоёмкость Plane** (≈13–14 контейнеров): OOM/вечные миграции на слабом хосте → «bundle не работает» | Сред. | Выс. | Preflight bootstrap (RAM/диск/CPU до мутаций, BR-7); честные цифры в BUNDLED_SETUP §2 **по замеру** (AC-4); таймауты ожидания готовности с диагностикой «кто не дождался + хвост логов» (D5 ш.3); траблшутинг §14 |
+| TR-2 | **Дыры Plane CE API**: instance-setup/workspace/API-токен UI-only → UX «одной команды» размывается; молчаливый пропуск шага ломает всё дальше | Выс. | Сред. | Контракт manual-step (инструкция → подтверждение → **API-верификация результата**, exit 2 без TTY; D5/D7); число ручных шагов минимизировано (Gitea — полностью автоматом, D6); прогрессивная автоматизация разрешена без смены контракта |
+| TR-3 | **Дрейф upstream-образов**: «плавающий» тег ломает воспроизводимость; пиннованные версии стареют (CVE/несовместимость) | Сред. | Сред. | Неподвижные теги литералом + тест формы TC-03 (не `latest`/безтеговых); теги фиксируются по фактически проверенному стенду (D3); апгрейд — отдельные задачи (NFR-6, BRD §6) |
+| TR-4 | **Сетевая недостижимость вебхуков** (труднодиагностируемое «задача не появилась»): приватные адреса, рассинхрон URL | Сред. | Выс. | Одна bridge-сеть + строго сервис-DNS для машинного трафика (D4); **явный `GITEA__webhook__ALLOWED_HOST_LIST=orchestrator`** (Gitea по умолчанию режет приватные таргеты); URL подставляет bootstrap, не оператор; smoke проверяет ОБА направления (FR-6); траблшутинг §14 |
+| TR-5 | **Соблазн форкнуть/расширить корневой compose** (упадёт анти-дрейф ORCH-102 TC-04) | Низ. | Выс. | Bundle строго отдельным файлом `deploy/bundled/` (D1); TC-02 зеркалит заморозку корневого compose; правило эскалации TRZ §7 — если всплывёт незакрытая параметризация `src/**`, остановиться и вернуть задачу, не «дотачивать молча» |
+| TR-6 | **Утечка секретов** в репо/логи при генерации bundle-кред | Низ. | Выс. | В гите — только плейсхолдеры (канон D2); bootstrap не печатает значения (имена ключей/пути, D5); права 600; секрет-эвристика hex≥32/alnum≥40 + FORBIDDEN-скан на новых артефактах (TC-06); live-файлы в `.gitignore` |
+| TR-7 | **Токен-remote агентов**: токен бот-юзера plaintext в `.git/config` чекаутов; один бот = широкие права | Сред. | Низ. | Осознанный компромисс тестовой инсталляции (D8): порты БД/брокера не публикуются, каталог локальный, права 600; ssh-контур сознательно не вводится (меньше поверхность); зафиксировано в BUNDLED_SETUP §1 «рамка» |
+| TR-8 | **Путаница двух `.env`-слоёв** (bundle-инфра `deploy/bundled/.env` vs runtime орка корневой `.env`): ручная правка не того файла | Сред. | Сред. | Bootstrap — **единственный писатель** всех live-файлов (D2); авто-чтение compose из project dir (нет `--env-file`-футгана); шапки-комментарии в канонах перекрёстно ссылаются; key-set-sync тест TC-04 |
+| TR-9 | **Хост-python/venv для onboard**: `onboard_project.py` требует venv с `requirements.txt` (канон ONBOARDING) — на голом хосте шаг 6 падает | Сред. | Сред. | Preflight проверяет python3/venv (D5 ш.1); создание venv — идемпотентный ensure-шаг bootstrap; сам bootstrap stdlib-only и от venv не зависит (D5) |
+| TR-10 | **Повторный запуск/грязный хост**: bootstrap портит чужое состояние или дублирует своё | Низ. | Выс. | Step-движок check→ensure (skip-семантика, AC-8); детект «грязи» по префиксу `orchestrator-bundle` до мутаций; delete-операций в скрипте нет вообще — teardown только документированной процедурой §13 (D9); unit-тесты чистых функций preflight (TC-08) |
+
+## Сводный вывод
+
+Доминирующий класс — **эксплуатационные риски целевого хоста** (TR-1/TR-2/TR-4): они не
+затрагивают наш прод и гасятся честным preflight, контрактом manual-step и smoke в обе стороны.
+Рисков для прод-конвейера self-hosting **нет по построению** (NFR-1/NFR-2: рантайм байт-в-байт,
+артефакты в нашем контуре инертны, kill-switch не требуется — паттерн ORCH-009; все существующие
+анти-дрейф тесты остаются зелёными). Эскалация `arch:major-change` не требуется: новых стадий/
+компонентов рантайма/смены БД нет — задача целиком в слое дистрибуции (паттерн ORCH-101/102).
+Возврат в анализ не требуется: ТЗ выполнимо без нарушения принципов; единственный заранее
+оговорённый стоп-кран — TR-5 (обнаружение незакрытой параметризации `src/**` ⇒ остановка по
+TRZ §7). Остаточный риск — **низкий**.

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

@@ -0,0 +1,160 @@
+---
+verdict: APPROVED
+work_item: ORCH-103
+stage: review
+author_agent: reviewer
+status: approved
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+type: review
+work_item_id: ORCH-103
+version: 1
+---
+
+# Review ORCH-103 — ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+> Машинный вердикт читается ТОЛЬКО из `verdict:` во frontmatter.
+
+## Summary
+
+PR закрывает Type B эпика ORCH-10 строго по ТЗ и ADR-001 (D1–D11): новый каталог
+`deploy/bundled/` (самодостаточный compose 16 сервисов, project name `orchestrator-bundle`,
+пиннинг неподвижными тегами, одна bridge-сеть, только человеческие порты, мина
+`GITEA__webhook__ALLOWED_HOST_LIST` закрыта), `scripts/bootstrap_bundle.py` (stdlib-only,
+`plan`-дефолт/`apply`/`verify`, step-движок check→ensure, exit 0/2/1, ноль delete-операций),
+конфиг-канон `deploy/bundled/.env.example` (ни одного дефолтного пароля),
+`docs/deployment/BUNDLED_SETUP.md` (14 разделов канона D10) и три содержательных
+анти-дрейф тест-модуля. Рантайм байт-в-байт: `git diff main` не содержит `src/**`,
+корневого `docker-compose.yml`, `Dockerfile`, `.gitea/workflows/**` (AC-6 подтверждён
+diff-stat'ом). Полный регресс: **`pytest tests/ -q` → 1844 passed, 0 failed** (AC-5);
+существующие анти-дрейф тесты (`test_lite_setup_doc.py`, `test_no_host_hardcodes.py`,
+канон ORCH-009) не правились. Документация обновлена в том же PR по всем точкам §8 ТЗ.
+Findings — только P2/P3, блокеров нет → **APPROVED**.
+
+## Оси проверки
+
+### 1. Соответствие ТЗ (02-trz.md, 03-acceptance-criteria.md)
+
+- **FR-1** ✅ — отдельный bundle-compose; состав = ADR D1/D3 (тест
+  `test_bundle_has_exactly_the_adr_service_set` фиксирует множество); пиннинг всех сторонних
+  образов литералом (TC-03); тома — именованные с префиксом проекта + bind строго внутри
+  project dir (TC-04); достижимость в обе стороны — сервис-DNS (D4) + `ALLOWED_HOST_LIST`;
+  карта портов в доке §2, конфликт порта → отказ preflight; staging-контура нет вовсе.
+- **FR-2** ✅ — последовательность шагов 1–9 ТЗ воспроизведена 1:1 в `APPLY_STEPS`
+  (тест `test_apply_steps_match_normative_plan` держит соответствие нормативному плану);
+  идемпотентность — check→ensure/skip (AC-8 покрыт unit'ами resume/«противоречивое
+  состояние»); exit-контракт 0/2/1 (`test_exit_code_contract`); манифест manual-step честный:
+  инструкция → подтверждение → API-верификация, без TTY — немедленный exit 2.
+- **FR-3** ✅ — webhook-секреты строго субпроцессом `gen_secrets.py` (структурный тест);
+  bundle-креды — stdlib `secrets` (token_hex ≥16 байт, unit проверяет длину); в репо только
+  пустые плейсхолдеры (`test_bundle_secrets_in_example_are_empty_placeholders`); права 600;
+  без перетирания без `--force-secrets` (`test_merge_missing_secrets_never_overwrites_without_force`).
+- **FR-4** ✅ — BUNDLED_SETUP.md: все 14 разделов в порядке маршрута, fenced-команды +
+  «Проверка:»/PASS/FAIL в каждом исполняемом разделе, общие шаги ссылками на
+  LITE_SETUP §5–§8 / ONBOARDING / REPLICATION §4 (форк канона отсутствует), fail-closed имена
+  `Confirm Deploy`/`STOP` и «22 статуса» — сверкой импорта `plane_sync._PLANE_NAME_TO_KEY`.
+- **FR-5** ✅ — три модуля без docker/сети/LLM; FORBIDDEN — импорт из
+  `test_no_host_hardcodes.py` (один источник истины); секрет-эвристика hex≥32/alnum≥40 с
+  негативным самочеком (не-evergreen); key-set-sync `${VAR}` ⊆ bundle-канона; заморозка
+  корневого compose зеркалом ассерта ORCH-102.
+- **FR-6** ✅ — smoke = REPLICATION §4 поверх bundle (§11 дока, без форка), минимальный
+  сигнал «артефакты 01–04 в ветке» зафиксирован.
+- **AC-матрица:** AC-4…AC-9 в файловой/структурной части — PASS (TC-01…TC-12 зелёные).
+  AC-1/AC-2/AC-3/AC-8(повторный прогон) в e2e-части — **ручная приёмка** на чистом хосте/VM
+  по рамке самих AC (в CI docker/LLM не гоняются) — остаётся за стадией приёмки, см. P2-2.
+
+### 2. Соответствие ADR (06-adr/ADR-001, adr-0038)
+
+- D1–D11 реализованы без отклонений; сквозной `adr-0038-bundled-replication-canon.md` заведён.
+- **Прогрессивная автоматизация webhook (D7)** — единственное место, где реализация глубже
+  буквы ADR: `step_plane_webhook` регистрирует workspace-webhook прямой записью в Postgres
+  инсталляции. Сверено: это **не новый канон, а переиспользование** документированного
+  «пути Б» LITE_SETUP §5.4 (тот же INSERT-контракт, колонка-в-колонку), контракт чекпоинта
+  сохранён (верификация SELECT'ом; при отказе — fallback на честный manual-step с той же
+  проверкой), схема стабильна благодаря пину `v0.23.1`. D7 явно разрешает такую замену
+  manual-step → ensure «без правки ADR». Нарушения нет; в доке §7 чекпоинт 4 описан честно.
+- **Трассировка (TRACEABILITY):** правка чужого маркированного блока одна — строка Type B в
+  `REPLICATION.md` §1 (артефакт ORCH-101); это запланированная точка расширения, прямо
+  предписанная ТЗ FR-6/§8 — инвариант ORCH-101 не сломан. Остальные изменения аддитивны
+  (новые файлы / новые секции CLAUDE.md, README архитектуры, CHANGELOG).
+- Нормативы предшественников соблюдены: branch protection НЕ настраивается (D10 ORCH-009 /
+  INV-4 — явно в D6 и §14.6 дока), compose не форкается (adr-0037), «дефолт = боевое» не
+  нарушен (корневой `.env.example` не тронут).
+
+### 3. Качество кода
+
+- `pytest tests/ -q`: **1844 passed, 0 failed** (66s); новые тесты содержательные — unit'ы
+  чистых функций покрывают позитив/негатив/resume/противоречивое состояние, эвристики имеют
+  негативный самочек, ast-скан stdlib-allowlist реально закрыт.
+- Бизнес-логика скрипта аккуратная: never-print секретов в stdout (только имена ключей),
+  маскированный лог при падении clone (токен в URL не утекает в вывод), `_psql` через stdin
+  (секрет не в argv), fail-fast preflight до любых мутаций, диагностика «кто не дождался +
+  хвост логов». Не багфикс-трек (feature) — требование регресс-теста-фиксатора BR-4/ORCH-019
+  неприменимо.
+- Замечания P2/P3 — ниже; ни одно не ломает инварианты конвейера и не относится к рантайму
+  платформы (скрипт исполняется только оператором на целевом хосте).
+
+### 4. Документация — обязательная проверка
+
+Выполнена явно, см. раздел «Документация» ниже. Обновлено всё требуемое в том же PR.
+
+## Findings
+
+### P0 — Blocker
+- (нет)
+
+### P1 — Must fix
+- (нет)
+
+### P2 — Should fix
+- [ ] **P2-1. Секреты в argv субпроцессов** (`scripts/bootstrap_bundle.py`):
+  `step_init_gitea` передаёт `GITEA_ADMIN_PASSWORD` аргументом `--password` в
+  `docker compose exec gitea gitea admin user create …`, а `step_agent_git` — токен в
+  clone-URL аргументом `git clone http://oauth2:<token>@…`. Значения видимы в `ps` хоста на
+  время исполнения. Формально AC-8 («секрет виден в stdout/логе») не нарушен, но это против
+  духа NFR-3 (ТЗ FR-2) и непоследовательно с собственной argv-гигиеной скрипта (`_psql`
+  прогоняет секреты через stdin с явным комментарием «секреты не попадают в argv, NFR-3»).
+  Рекомендация: для clone — использовать `git -c credential.helper`/`GIT_ASKPASS` либо
+  дописать компромисс в TR-7 (10-tech-risks) и шапку скрипта; для `gitea admin user create`
+  альтернатив CLI мало — минимум зафиксировать окно экспозиции в TR-7. Не блокер: разовая
+  операция оператора на одноарендном целевом хосте, угроза-модель совпадает с уже
+  зафиксированным компромиссом TR-7.
+- [ ] **P2-2. Замер цифр «Требований к хосту» отложен на приёмку** (AC-4): BUNDLED_SETUP §2
+  декларирует «подтверждаются замером приёмочного развёртывания» — на момент ревью цифры
+  (8 GB / 40 GB / 4 vCPU) синхронизированы с константами preflight структурным тестом, но
+  фактический замер ещё не зафиксирован. По рамке 03-acceptance-criteria (e2e — ручная
+  приёмка вне CI) это допустимо, однако при ручной приёмке AC-1/AC-2 результат замера нужно
+  зафиксировать (13-test-report / 15-staging-log или правка §2), иначе FAIL-условие AC-4
+  «цифры с потолка» останется формально незакрытым.
+
+### P3 — Nice to have
+- [ ] **P3-1.** `step_plane_webhook`: `slug`/`secret` интерполируются в SQL-строку без
+  экранирования одинарных кавычек. Секрет — hex от `gen_secrets` (безопасен), slug —
+  операторский ввод; кавычка в slug уронит INSERT. Риск минимален (ON_ERROR_STOP +
+  fail-safe fallback на manual-step), но дешёвое `value.replace("'", "''")` сняло бы класс
+  целиком.
+- [ ] **P3-2.** `run_verify`: при одновременном health-FAIL и onboard `exit 2` функция
+  возвращает `EXIT_MANUAL` (2), маскируя ошибку (ожидался бы приоритет `1`). Поведенческая
+  мелочь read-only режима.
+
+## Документация
+
+| Артефакт | Статус |
+|----------|--------|
+| `CLAUDE.md` | ✅ новый раздел «Bundled-тираж (ORCH-103)» (паттерн ORCH-101/102) |
+| `docs/architecture/README.md` | ✅ блок Type B — Bundled рядом с 10-common/Lite |
+| `CHANGELOG.md` | ✅ запись `feat: ORCH-103` (детальная, D1–D11) |
+| `docs/operations/REPLICATION.md` §1 | ✅ Type B → ✅ ORCH-103 + ссылка на BUNDLED_SETUP.md |
+| `docs/deployment/BUNDLED_SETUP.md` | ✅ создан, 14 разделов канона D10, держится тестом |
+| ADR | ✅ work-item `06-adr/ADR-001-…` + сквозной `adr-0038-bundled-replication-canon.md` |
+| `07-infra-requirements.md`, `10-tech-risks.md` (TR-1…TR-9) | ✅ заведены архитектором, кросс-рефы из кода сходятся |
+| `.gitignore` | ✅ `deploy/bundled/repos/` (NFR-3) |
+| `README.md` «Известные ограничения» (ORCH-079) | ✅ проверено явно: PR не закрывает ни один из 3 открытых пунктов (Telegram 48h / intra-repo deps / пакетный автоном) — обновление витрины не требуется |
+
+`src/**` не изменён (PR — deploy/scripts/docs/tests), поэтому P0-правило «`src/` изменён без
+документации» неприменимо; документация при этом обновлена полностью.
+
+## Итог
+
+`verdict: APPROVED` — P0/P1 отсутствуют; P2-1/P2-2 и P3 рекомендуется снять follow-up'ом или
+при ручной приёмке Bundled-развёртывания (AC-1/AC-2/AC-3/AC-8 e2e-часть).

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

@@ -0,0 +1,67 @@
+---
+result: PASS
+work_item: ORCH-103
+stage: testing
+author_agent: tester
+status: pass
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+type: test-report
+work_item_id: ORCH-103
+---
+
+# Test Report — ORCH-103 — ORCH-10b Bundled-тираж: весь стек одним комплектом + bootstrap-скрипт
+
+> Машинный вердикт читается ТОЛЬКО из `result:` во frontmatter (`check_tests_passed`).
+
+## Окружение
+- Python: 3.12.13
+- pytest: 8.3.3
+- Worktree: `/repos/_wt/orchestrator/feature_ORCH-103-orch-10b-bundled-bootstrap/` (ветка задачи, не общий чекаут)
+- Дата: 2026-06-11
+
+## Smoke API (read-only)
+| Endpoint | Результат |
+|----------|-----------|
+| `GET /health` | PASS — `{"status":"ok","service":"orchestrator"}` |
+| `GET /status` | PASS — активная задача ORCH-103 (`stage: testing`) видна |
+| `GET /queue` | PASS — валидный JSON; блок `serial_gate` присутствует (ORCH-088, `orchestrator.active_task = ORCH-103`), блок `auto_labels` присутствует |
+
+Смок-регресс ORCH-088: блок `serial_gate` присутствует в полезной нагрузке `/queue` наряду с `auto_labels` — регресса нет.
+
+## Результаты (покрытие каждого TC из 04-test-plan.yaml)
+
+| TC ID | Тип | Описание (кратко) | AC | Модуль | Результат |
+|-------|-----|-------------------|----|--------|-----------|
+| TC-01 | unit | Bundle-compose существует/парсится; обязательные сервисы (орк/watchdog/Gitea/Plane-стек); staging не в дефолтном up | AC-1 | test_bundle_compose.py | PASS |
+| TC-02 | unit | Корневой docker-compose.yml не изменён; нет подстрок plane/gitea (зеркало TC-04 lite) | AC-6 | test_bundle_compose.py | PASS |
+| TC-03 | unit | Все сторонние образы пиннованы (нет latest/безтегового) | AC-9 | test_bundle_compose.py | PASS |
+| TC-04 | unit | Тома именованные с bundle-префиксом, без bind прод-контура; key-set-sync `${VAR}` ⊆ bundle-канон | AC-9 | test_bundle_compose.py | PASS |
+| TC-05 | unit | BUNDLED_SETUP.md: обязательные разделы FR-4 (требования к хосту с цифрами/портами/~14 контейнеров, bootstrap, smoke, stateless, сброс, траблшутинг); fenced + «Проверка:» | AC-4 | test_bundled_setup_doc.py | PASS |
+| TC-06 | unit | Гигиена (док+compose+bootstrap): нет FORBIDDEN-литералов (импорт из test_no_host_hardcodes); нет секрет-литералов (hex≥32/alnum≥40) | AC-9 | test_bundled_setup_doc.py | PASS |
+| TC-07 | unit | Bootstrap ссылается на gen_secrets.py/onboard_project.py; нет своего списка статусов/лейблов; нет delete-операций в обычном прогоне | AC-7 | test_bootstrap_script.py | PASS |
+| TC-08 | unit | Чистые функции bootstrap: грязный хост → отказ ДО мутаций; чистый → план; контракт exit 0/2/1 | AC-8 | test_bootstrap_script.py | PASS |
+| TC-09 | unit | Каждый env-ключ из дока есть в `.env.example` ∪ bundle-канон; число статусов сверяется импортом `plane_sync._PLANE_NAME_TO_KEY` | AC-9 | test_bundled_setup_doc.py | PASS |
+| TC-10 | unit | Кросс-ссылки: BUNDLED_SETUP → LITE_SETUP/ONBOARDING/REPLICATION; REPLICATION §1 отметка Type B → ORCH-103 | AC-7 | test_bundled_setup_doc.py | PASS |
+| TC-11 | unit | CHANGELOG.md содержит запись ORCH-103 | AC-5 | test_bundled_setup_doc.py | PASS |
+| TC-12 | integration | Полный регресс `pytest tests/ -q` зелёный; существующие анти-дрейф (test_lite_setup_doc.py, test_no_host_hardcodes.py, канон ORCH-009) без правки ассертов | AC-5 | tests/ | PASS |
+
+Все 12 TC выполнены и сопоставлены с критериями приёмки 03-acceptance-criteria.md. Структурная/файловая часть AC-4…AC-9 покрыта зелёными TC-01…TC-12. e2e-часть AC-1/AC-2/AC-3/AC-8 (фактический подъём bundle на чистом хосте/VM) — ручная приёмка вне CI по рамке самих AC (docker/LLM в CI не гоняются), как зафиксировано в test-plan `scope/notes` и ревью P2-2.
+
+## Целевые модули ORCH-103 (детально)
+- `tests/test_bundle_compose.py` — 14 passed (TC-01..04)
+- `tests/test_bundled_setup_doc.py` — 16 passed (TC-05/06/09/10/11)
+- `tests/test_bootstrap_script.py` — 19 passed (TC-07/08)
+- Анти-дрейф (без правки ассертов): `tests/test_lite_setup_doc.py` — 26 passed; `tests/test_no_host_hardcodes.py` — 8 passed
+- Итого по целевому срезу: **88 passed, 0 failed** (0.91s)
+
+## Вывод pytest (полный регресс)
+```
+$ python -m pytest tests/ -v --tb=short
+...
+================== 1844 passed, 1 warning in 70.33s (0:01:10) ==================
+```
+- 1844 passed, 0 failed, 1 warning (Pydantic V2 deprecation, не относится к задаче).
+
+## Итог
+PASS — полный регресс зелёный (1844 passed / 0 failed), smoke read-only (`/health`, `/status`, `/queue` с блоками `serial_gate` и `auto_labels`) в норме, все 12 TC из 04-test-plan.yaml выполнены и сопоставлены с критериями приёмки. Задача переходит на `deploy-staging`.

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

@@ -0,0 +1,12 @@
+---
+deploy_status: SUCCESS
+work_item: ORCH-103
+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-103/15-staging-log.md

@@ -0,0 +1,34 @@
+---
+staging_status: SUCCESS
+work_item: ORCH-103
+stage: deploy-staging
+author_agent: deployer
+status: success
+created_at: 2026-06-11
+model_used: claude-opus-4-8
+timestamp: 2026-06-10T23:15:16Z
+base_url: http://localhost:8501
+---
+
+# Staging Gate Log
+
+Staging test suite completed against the live staging environment (`orchestrator-staging`,
+port 8501, mode=stub). Ran canonically **inside the container** via `docker exec` (ORCH-048)
+so the B6 registry-isolation check reads `.env.staging` from the running instance's own
+process-env.
+
+**Result: 8/10 checks PASS — exit code 0 → SUCCESS.**
+
+- REAL failed: none
+- All REAL checks (A1–A3 smoke, B4–B6 access incl. registry isolation, C7–C8 E2E
+  create-issue / trigger-pipeline) are 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) — C9a/C9b are the two known sandbox-infra checks (depend on SANDBOX
+bot accounts being project members, not on the pipeline) and are tolerated under ORCH-061
+waiver tolerance (`staging_infra_tolerance_enabled=True`) since every REAL check passed.
+
+ORCH-103 is a docs+tests + new `deploy/bundled/` and `scripts/bootstrap_bundle.py` change;
+`src/**`, the root compose, Dockerfile, `STAGE_TRANSITIONS`/`QG_CHECKS`/DB schema are untouched,
+so no runtime behaviour regression is expected — consistent with the all-green REAL checks.

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

@@ -0,0 +1,14 @@
+---
+post_deploy_status: HEALTHY
+action_taken: NONE
+work_item: ORCH-103
+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.

scripts/bootstrap_bundle.py

@@ -0,0 +1,972 @@
+#!/usr/bin/env python3
+"""bootstrap_bundle.py — доводка Bundled-инсталляции до рабочего конвейера (ORCH-103).
+
+Один запуск поверх `deploy/bundled/docker-compose.yml` доводит свежеподнятый стек
+(орк + watchdog + Gitea + Plane CE) до рабочего состояния: preflight → секреты →
+up + готовность → init Gitea (полностью автоматом) → init Plane (честные
+manual-step чекпоинты с верификацией) → онбординг sandbox-проекта строго
+кирпичом ``scripts/onboard_project.py`` → git-доступ агентов (HTTP token-remote)
+→ сборка runtime-конфига орка (корневые ``.env`` / ``.env.watchdog``) → health.
+
+Режимы (ADR-001 D5, паттерн ORCH-009):
+  plan    — дефолт; ноль мутаций: печать плана + read-only preflight-диагностика.
+  apply   — полный прогон; step-движок check→ensure (повторный запуск = каскад
+            skip; «resume» после manual-step = просто повторный запуск).
+  verify  — read-only пост-проверка (health/queue/metrics + onboard verify).
+
+Exit-коды (контракт TRZ FR-2): 0 — успех; 2 — остановка на manual-step или
+незавершённое предусловие; 1 — ошибка.
+
+Гарантии (NFR-3 / D5 / D9):
+  * python stdlib-only; модули платформы не импортируются (канон-знания — только
+    субпроцессами кирпичей gen_secrets.py / onboard_project.py, AC-7);
+  * значения секретов НИКОГДА не печатаются (только имена ключей/пути файлов);
+  * delete-операций НЕТ ВООБЩЕ: teardown — только документированная процедура
+    docs/deployment/BUNDLED_SETUP.md §13 (ADR-001 D9);
+  * существующие секреты не перетираются без явного ``--force-secrets``
+    (использовать только ДО первого подъёма стека: уже инициализированные
+    Plane/Gitea новых паролей сами не подхватят);
+  * скрипт говорит только с локальным docker целевого хоста.
+
+Запуск — из корня чекаута репо orchestrator на целевом хосте:
+    python3 scripts/bootstrap_bundle.py            # план + диагностика
+    python3 scripts/bootstrap_bundle.py apply      # полный прогон
+    python3 scripts/bootstrap_bundle.py verify     # read-only пост-проверка
+"""
+
+import argparse
+import getpass
+import json
+import os
+import secrets
+import shutil
+import socket
+import subprocess
+import sys
+import tempfile
+import time
+import urllib.error
+import urllib.request
+import uuid
+
+REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+BUNDLE_DIR = os.path.join(REPO_ROOT, "deploy", "bundled")
+BUNDLE_COMPOSE = os.path.join(BUNDLE_DIR, "docker-compose.yml")
+BUNDLE_ENV_EXAMPLE = os.path.join(BUNDLE_DIR, ".env.example")
+BUNDLE_ENV = os.path.join(BUNDLE_DIR, ".env")
+ROOT_ENV_EXAMPLE = os.path.join(REPO_ROOT, ".env.example")
+ROOT_ENV = os.path.join(REPO_ROOT, ".env")
+WATCHDOG_ENV_EXAMPLE = os.path.join(REPO_ROOT, ".env.watchdog.example")
+WATCHDOG_ENV = os.path.join(REPO_ROOT, ".env.watchdog")
+GEN_SECRETS = os.path.join(REPO_ROOT, "scripts", "gen_secrets.py")
+ONBOARD = os.path.join(REPO_ROOT, "scripts", "onboard_project.py")
+REQUIREMENTS = os.path.join(REPO_ROOT, "requirements.txt")
+VENV_DIR = os.path.join(REPO_ROOT, ".venv")
+VENV_PY = os.path.join(VENV_DIR, "bin", "python")
+
+DOC = "docs/deployment/BUNDLED_SETUP.md"
+
+# Узнаваемый префикс томов/контейнеров инсталляции (compose project name, D1).
+PROJECT = "orchestrator-bundle"
+ORCH_CONTAINER = "orchestrator-bundle-orchestrator-1"
+
+# Машинные in-network URL (D4): сервис-DNS bundle-сети, не хост.
+WEBHOOK_PLANE_URL = "http://orchestrator:8500/webhook/plane"
+WEBHOOK_GITEA_URL = "http://orchestrator:8500/webhook/gitea"
+GITEA_INTERNAL_URL = "http://gitea:3000"
+PLANE_INTERNAL_URL = "http://proxy"
+
+EXIT_OK = 0
+EXIT_MANUAL = 2
+EXIT_ERROR = 1
+
+# Минимумы хоста (синхронизированы с BUNDLED_SETUP §2; пороги preflight, TR-1).
+MIN_RAM_GB = 8
+MIN_DISK_GB = 40
+MIN_CPUS = 4
+
+# Тайм-ауты ожидания готовности (D5 шаг 3): миграции Plane — самые долгие.
+READY_TIMEOUT_S = 180
+PLANE_READY_TIMEOUT_S = 600
+
+# Bundle-внутренние креды (upstream-имена, D2/FR-3) — генерирует bootstrap.
+BUNDLE_SECRET_KEYS = (
+    "POSTGRES_PASSWORD",
+    "SECRET_KEY",
+    "RABBITMQ_DEFAULT_PASS",
+    "MINIO_ROOT_PASSWORD",
+    "GITEA_ADMIN_PASSWORD",
+)
+
+# Обязательные НЕсекретные ключи bundle-конфига (preflight, D5 шаг 1).
+REQUIRED_BUNDLE_KEYS = (
+    "BUNDLE_PUBLIC_HOST",
+    "BUNDLE_ORCH_PORT",
+    "BUNDLE_PLANE_PORT",
+    "BUNDLE_GITEA_HTTP_PORT",
+    "ORCH_RUN_UID",
+    "ORCH_RUN_GID",
+    "ORCH_DOCKER_GID",
+    "ORCH_AGENT_HOME_DIR",
+    "GITEA_ADMIN_USERNAME",
+)
+
+# Webhook-секреты орка — выпускает ТОЛЬКО кирпич gen_secrets.py (AC-7).
+WEBHOOK_SECRET_KEYS = ("ORCH_PLANE_WEBHOOK_SECRET", "ORCH_GITEA_WEBHOOK_SECRET")
+
+# Sandbox-проект первого smoke (онбордится строго onboard_project.py, BR-6).
+SANDBOX_DEFAULTS = {
+    "name": "Sandbox",
+    "repo": "sandbox",
+    "prefix": "SBX",
+    "stack": "python",
+    "test_cmd": "pytest -q",
+    "prod_port": "8600",
+    "staging_port": "8601",
+}
+
+
+class ManualStop(Exception):
+    """Остановка на manual-step / незавершённом предусловии → exit 2."""
+
+
+class BootstrapError(Exception):
+    """Невосстановимая ошибка шага → exit 1."""
+
+
+def log(msg: str) -> None:
+    """Печать строки прогресса. Значения секретов сюда НЕ передаются (NFR-3)."""
+    print(msg, flush=True)
+
+
+# --------------------------------------------------------------------------- #
+# Чистые функции (unit-тесты — tests/test_bootstrap_script.py, TC-08)
+# --------------------------------------------------------------------------- #
+
+def parse_env(text: str) -> dict:
+    """``KEY=value``-строки текста → словарь (комментарии/пустые — мимо)."""
+    out: dict = {}
+    for line in text.splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        out[key.strip()] = value.strip()
+    return out
+
+
+def render_env(example_text: str, overrides: dict) -> str:
+    """Рендер env-файла от канона-example: ``KEY=`` строки получают значения
+    overrides (та же строка, комментарии сохранены); ключи overrides, которых
+    в каноне нет, дописываются управляемым блоком в конец."""
+    used: set = set()
+    lines: list = []
+    for line in example_text.splitlines():
+        stripped = line.strip()
+        if stripped and not stripped.startswith("#") and "=" in stripped:
+            key = stripped.split("=", 1)[0].strip()
+            if key in overrides:
+                lines.append(f"{key}={overrides[key]}")
+                used.add(key)
+                continue
+        lines.append(line)
+    extra = [k for k in overrides if k not in used]
+    if extra:
+        lines.append("")
+        lines.append("# --- bootstrap_bundle.py (ORCH-103): управляемые ключи ---")
+        for key in extra:
+            lines.append(f"{key}={overrides[key]}")
+    return "\n".join(lines) + "\n"
+
+
+def merge_missing_secrets(existing: dict, keys: tuple = BUNDLE_SECRET_KEYS,
+                          force: bool = False, gen=None) -> dict:
+    """Новые значения ТОЛЬКО для пустых/отсутствующих секрет-ключей (AC-8:
+    существующие не перетираются; ``force=True`` — явная регенерация всех)."""
+    gen = gen or (lambda key: secrets.token_hex(32 if key == "SECRET_KEY" else 16))
+    fresh: dict = {}
+    for key in keys:
+        if force or not existing.get(key, ""):
+            fresh[key] = gen(key)
+    return fresh
+
+
+def preflight_verdict(facts: dict) -> tuple:
+    """Чистый вердикт preflight (BR-7): ``(blockers, warnings, resume)``.
+
+    resume=True — на хосте уже есть тома/контейнеры с префиксом проекта:
+    не «грязь», а инициализированная инсталляция → ensure-режим (AC-8);
+    противоречивое состояние (есть тома, но нет конфига) — блокер.
+    """
+    blockers: list = []
+    warnings: list = []
+    resume = bool(facts.get("leftovers"))
+
+    if not facts.get("docker"):
+        blockers.append("docker не найден — установите Docker Engine (BUNDLED_SETUP §3)")
+    if not facts.get("compose"):
+        blockers.append("docker compose v2 не найден (BUNDLED_SETUP §3)")
+    if not facts.get("env_exists"):
+        if resume:
+            blockers.append(
+                "противоречивое состояние: тома/контейнеры orchestrator-bundle уже "
+                "есть, а deploy/bundled/.env отсутствует — восстановите конфиг "
+                "или выполните полный сброс (BUNDLED_SETUP §13)"
+            )
+        else:
+            blockers.append(
+                "deploy/bundled/.env отсутствует — создайте: "
+                "cp deploy/bundled/.env.example deploy/bundled/.env (BUNDLED_SETUP §5)"
+            )
+    for key in facts.get("missing_keys", []):
+        blockers.append(f"deploy/bundled/.env: обязательный ключ {key} пуст")
+    if not resume:
+        for port in facts.get("busy_ports", []):
+            blockers.append(
+                f"порт {port} уже занят на хосте — освободите его или смените "
+                f"BUNDLE_*-порт в deploy/bundled/.env (BUNDLED_SETUP §2)"
+            )
+    ram = facts.get("ram_gb")
+    if ram is not None and ram < MIN_RAM_GB:
+        blockers.append(
+            f"RAM {ram:.1f} GB < минимума {MIN_RAM_GB} GB (Plane ≈ 14 контейнеров, "
+            f"BUNDLED_SETUP §2)"
+        )
+    disk = facts.get("disk_gb")
+    if disk is not None and disk < MIN_DISK_GB:
+        blockers.append(f"свободный диск {disk:.0f} GB < минимума {MIN_DISK_GB} GB")
+    cpus = facts.get("cpus")
+    if cpus is not None and cpus < MIN_CPUS:
+        warnings.append(f"CPU {cpus} < рекомендуемых {MIN_CPUS} vCPU — стек будет медленным")
+    if not facts.get("python3", True):
+        blockers.append("python3/venv недоступны — нужны для onboard-кирпича (TR-9)")
+    if not facts.get("claude_cli"):
+        warnings.append(
+            "Claude CLI/креды не найдены на хосте — стек поднимется, но конвейер "
+            "без LLM не поедет (BUNDLED_SETUP §8)"
+        )
+    return blockers, warnings, resume
+
+
+def build_plan() -> list:
+    """Нормативный план apply (нумерация — TRZ FR-2; механика — ADR-001 D5)."""
+    return [
+        ("preflight", "fail-fast проверки хоста ДО любых мутаций (BR-7)"),
+        ("secrets", "новые секреты инсталляции: gen_secrets.py + bundle-креды (FR-3)"),
+        ("up", "подъём bundle-compose + ожидание готовности (миграции Plane/Gitea)"),
+        ("init-gitea", "админ-бот + API-токен через `gitea admin ...` (полностью автоматом)"),
+        ("init-plane", "instance-setup/workspace/API-токен — manual-step с верификацией"),
+        ("plane-webhook", "workspace-webhook Plane → орк (ensure либо manual-step + проверка)"),
+        ("onboard", "sandbox-проект строго через onboard_project.py apply+verify (BR-6)"),
+        ("agent-git", "git-доступ агентов: клон sandbox-репо token-remote в /repos (D8)"),
+        ("orch-env", "сборка корневых .env/.env.watchdog + пересоздание орка/watchdog"),
+        ("health", "GET /health, /queue, /metrics + итоговая сводка PASS/FAIL"),
+    ]
+
+
+def build_arg_parser() -> argparse.ArgumentParser:
+    """CLI: режимы plan (дефолт) / apply / verify + параметры sandbox."""
+    parser = argparse.ArgumentParser(
+        description="Bootstrap Bundled-инсталляции (ORCH-103). Канон — "
+                    f"{DOC}."
+    )
+    parser.add_argument(
+        "mode", nargs="?", default="plan", choices=("plan", "apply", "verify"),
+        help="plan — дефолт, ноль мутаций; apply — прогон; verify — пост-проверка",
+    )
+    parser.add_argument(
+        "--force-secrets", action="store_true",
+        help="регенерировать СУЩЕСТВУЮЩИЕ bundle-креды (только ДО первого up!)",
+    )
+    parser.add_argument("--sandbox-name", default=SANDBOX_DEFAULTS["name"])
+    parser.add_argument("--sandbox-repo", default=SANDBOX_DEFAULTS["repo"])
+    parser.add_argument("--sandbox-prefix", default=SANDBOX_DEFAULTS["prefix"])
+    parser.add_argument("--sandbox-stack", default=SANDBOX_DEFAULTS["stack"])
+    parser.add_argument("--sandbox-test-cmd", default=SANDBOX_DEFAULTS["test_cmd"])
+    parser.add_argument("--sandbox-prod-port", default=SANDBOX_DEFAULTS["prod_port"])
+    parser.add_argument("--sandbox-staging-port", default=SANDBOX_DEFAULTS["staging_port"])
+    return parser
+
+
+# --------------------------------------------------------------------------- #
+# Тонкие обёртки subprocess/HTTP (единственные точки side-effects)
+# --------------------------------------------------------------------------- #
+
+def _run(cmd: list, input_text: str | None = None, env: dict | None = None,
+         timeout: int = 600) -> subprocess.CompletedProcess:
+    """subprocess.run c capture; команды логируются БЕЗ секретов вызывающим."""
+    return subprocess.run(
+        cmd, input=input_text, env=env, capture_output=True, text=True,
+        timeout=timeout, check=False,
+    )
+
+
+def _compose(*args: str, input_text: str | None = None,
+             timeout: int = 600) -> subprocess.CompletedProcess:
+    return _run(["docker", "compose", "-f", BUNDLE_COMPOSE, *args],
+                input_text=input_text, timeout=timeout)
+
+
+def _http(url: str, headers: dict | None = None, timeout: int = 10) -> tuple:
+    """GET url → (status|None, body). Никогда не бросает (poll-friendly)."""
+    req = urllib.request.Request(url, headers=headers or {})
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:  # noqa: S310
+            return resp.status, resp.read().decode("utf-8", "replace")
+    except urllib.error.HTTPError as e:
+        return e.code, ""
+    except (urllib.error.URLError, OSError, ValueError):
+        return None, ""
+
+
+def _port_busy(port: int) -> bool:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.settimeout(0.5)
+        return s.connect_ex(("127.0.0.1", port)) == 0
+
+
+def _write_private(path: str, content: str) -> None:
+    """Запись live-конфига: права 600, без печати содержимого (NFR-3)."""
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(content)
+    os.chmod(path, 0o600)
+    log(f"  записан {os.path.relpath(path, REPO_ROOT)} (права 600)")
+
+
+def update_env_file(path: str, example_path: str, overrides: dict) -> None:
+    """Идемпотентный ensure env-файла: существующий — обновить ключи overrides,
+    отсутствующий — отрендерить от канона-example. Никаких удалений."""
+    if os.path.isfile(path):
+        base = open(path, encoding="utf-8").read()
+    else:
+        base = open(example_path, encoding="utf-8").read()
+    _write_private(path, render_env(base, overrides))
+
+
+# --------------------------------------------------------------------------- #
+# Сбор фактов хоста (read-only; используется plan/apply/verify)
+# --------------------------------------------------------------------------- #
+
+def bundle_ports(bundle_env: dict) -> list:
+    out = []
+    for key, default in (("BUNDLE_ORCH_PORT", 8500), ("BUNDLE_PLANE_PORT", 8080),
+                         ("BUNDLE_GITEA_HTTP_PORT", 3000)):
+        try:
+            out.append(int(bundle_env.get(key) or default))
+        except ValueError:
+            out.append(default)
+    return out
+
+
+def collect_facts(bundle_env: dict) -> dict:
+    """Read-only снимок хоста для preflight_verdict (ни одной мутации)."""
+    docker = shutil.which("docker") is not None
+    compose = docker and _compose("version", timeout=30).returncode == 0
+    leftovers: list = []
+    if docker:
+        vols = _run(["docker", "volume", "ls", "--format", "{{.Name}}"], timeout=30)
+        names = _run(["docker", "ps", "-a", "--format", "{{.Names}}"], timeout=30)
+        for line in (vols.stdout + "\n" + names.stdout).splitlines():
+            if line.strip().startswith(PROJECT):
+                leftovers.append(line.strip())
+    ram_gb = None
+    try:
+        with open("/proc/meminfo", encoding="utf-8") as f:
+            for line in f:
+                if line.startswith("MemTotal:"):
+                    ram_gb = int(line.split()[1]) / 1024 / 1024
+                    break
+    except OSError:
+        pass
+    try:
+        disk_gb = shutil.disk_usage(REPO_ROOT).free / 2**30
+    except OSError:
+        disk_gb = None
+    env_exists = os.path.isfile(BUNDLE_ENV)
+    missing = [k for k in REQUIRED_BUNDLE_KEYS if not bundle_env.get(k, "")]
+    claude_ok = (
+        shutil.which("claude") is not None
+        or os.path.isdir(os.path.expanduser(
+            bundle_env.get("ORCH_HOST_CLAUDE_DIR", "") or "~/.claude"))
+    )
+    return {
+        "docker": docker,
+        "compose": compose,
+        "env_exists": env_exists,
+        "missing_keys": missing if env_exists else [],
+        "busy_ports": [p for p in bundle_ports(bundle_env) if _port_busy(p)],
+        "leftovers": leftovers,
+        "ram_gb": ram_gb,
+        "disk_gb": disk_gb,
+        "cpus": os.cpu_count(),
+        "python3": True,  # мы уже исполняемся под python3
+        "claude_cli": claude_ok,
+    }
+
+
+# --------------------------------------------------------------------------- #
+# Manual-step контракт (D5/D7): инструкция → подтверждение → верификация
+# --------------------------------------------------------------------------- #
+
+def manual_checkpoint(title: str, instructions: list, verify, max_tries: int = 3):
+    """Честный чекпоинт: печать точной инструкции; без TTY — немедленный exit 2
+    с той же инструкцией; с TTY — ожидание подтверждения и ВЕРИФИКАЦИЯ результата
+    (молчаливый пропуск запрещён). verify() → (ok, hint)."""
+    log(f"\n🖐 MANUAL-STEP: {title}")
+    for line in instructions:
+        log(f"   {line}")
+    if not sys.stdin.isatty():
+        log("   Нет TTY: выполните шаги и перезапустите `apply` (resume = повторный запуск).")
+        raise ManualStop(title)
+    for _ in range(max_tries):
+        input("   Когда выполнено — нажмите Enter: ")
+        ok, hint = verify()
+        if ok:
+            log("   ✓ верификация пройдена")
+            return
+        log(f"   ✗ верификация не прошла: {hint}")
+    raise ManualStop(f"{title}: верификация не прошла после {max_tries} попыток")
+
+
+# --------------------------------------------------------------------------- #
+# Шаги apply (step-движок check→ensure; каждый идемпотентен)
+# --------------------------------------------------------------------------- #
+
+def step_preflight(ctx: dict) -> str:
+    facts = collect_facts(ctx["bundle_env"])
+    blockers, warnings, resume = preflight_verdict(facts)
+    for w in warnings:
+        log(f"  ⚠ {w}")
+    if blockers:
+        for b in blockers:
+            log(f"  ✗ {b}")
+        raise ManualStop("preflight: незавершённые предусловия хоста")
+    ctx["resume"] = resume
+    if resume:
+        log("  инсталляция уже существует — продолжаю в ensure-режиме (AC-8)")
+    return "ok"
+
+
+def step_secrets(ctx: dict) -> str:
+    """FR-3: bundle-креды (stdlib secrets) + webhook-секреты (gen_secrets.py)."""
+    force = ctx["args"].force_secrets
+    bundle_env = ctx["bundle_env"]
+    fresh = merge_missing_secrets(bundle_env, force=force)
+    # uid/gid/docker-gid хоста — дозаполняются фактическими значениями оператора
+    infra: dict = {}
+    if not bundle_env.get("ORCH_RUN_UID"):
+        infra["ORCH_RUN_UID"] = str(os.getuid())
+    if not bundle_env.get("ORCH_RUN_GID"):
+        infra["ORCH_RUN_GID"] = str(os.getgid())
+    if fresh or infra:
+        update_env_file(BUNDLE_ENV, BUNDLE_ENV_EXAMPLE, {**infra, **fresh})
+        ctx["bundle_env"] = parse_env(open(BUNDLE_ENV, encoding="utf-8").read())
+        log(f"  bundle-креды выпущены: {', '.join(sorted(fresh)) or '—'}")
+    else:
+        log("  bundle-креды уже на месте (не перетираю без --force-secrets)")
+    # webhook-секреты орка — СТРОГО кирпичом gen_secrets.py (AC-7)
+    root_env = ctx["root_env"]
+    if all(root_env.get(k) for k in WEBHOOK_SECRET_KEYS) and not force:
+        log("  webhook-секреты уже в .env — skip")
+        return "skipped"
+    with tempfile.TemporaryDirectory() as tmp:
+        frag_path = os.path.join(tmp, "fragment.env")
+        proc = _run([sys.executable, GEN_SECRETS, "--write", frag_path], timeout=60)
+        if proc.returncode != 0:
+            raise BootstrapError(f"gen_secrets.py отказал (rc={proc.returncode})")
+        fragment = parse_env(open(frag_path, encoding="utf-8").read())
+    overrides = {k: fragment[k] for k in WEBHOOK_SECRET_KEYS
+                 if fragment.get(k) and (force or not root_env.get(k))}
+    update_env_file(ROOT_ENV, ROOT_ENV_EXAMPLE, overrides)
+    ctx["root_env"] = parse_env(open(ROOT_ENV, encoding="utf-8").read())
+    log(f"  webhook-секреты выпущены: {', '.join(sorted(overrides)) or '—'}")
+    return "ok"
+
+
+def _wait_http(url: str, timeout_s: int, label: str, ok_statuses=(200,)) -> None:
+    deadline = time.monotonic() + timeout_s
+    while time.monotonic() < deadline:
+        status, _ = _http(url, timeout=5)
+        if status in ok_statuses:
+            log(f"  ✓ {label} готов ({url})")
+            return
+        time.sleep(5)
+    tail = _compose("logs", "--tail", "30", label, timeout=60).stdout[-2000:]
+    raise BootstrapError(f"{label} не дождались за {timeout_s}с ({url}); хвост логов:\n{tail}")
+
+
+def _wait_migrator(timeout_s: int) -> None:
+    deadline = time.monotonic() + timeout_s
+    name = f"{PROJECT}-migrator-1"
+    while time.monotonic() < deadline:
+        proc = _run(["docker", "inspect", "-f",
+                     "{{.State.Status}} {{.State.ExitCode}}", name], timeout=30)
+        state = proc.stdout.strip()
+        if proc.returncode == 0 and state.startswith("exited"):
+            if state.endswith(" 0"):
+                log("  ✓ миграции Plane завершились (migrator exit 0)")
+                return
+            tail = _compose("logs", "--tail", "30", "migrator", timeout=60).stdout[-2000:]
+            raise BootstrapError(f"миграции Plane упали ({state}); хвост логов:\n{tail}")
+        time.sleep(5)
+    raise BootstrapError(f"миграции Plane не завершились за {timeout_s}с (TR-1: проверьте RAM/диск)")
+
+
+def step_up(ctx: dict) -> str:
+    """Подъём стека + ожидание готовности каждого слоя (D5 шаг 3)."""
+    for sub in ("data", "repos"):
+        os.makedirs(os.path.join(BUNDLE_DIR, sub), exist_ok=True)
+    proc = _compose("up", "-d", timeout=1800)
+    if proc.returncode != 0:
+        raise BootstrapError(f"docker compose up отказал:\n{proc.stderr[-2000:]}")
+    ports = dict(zip(("orch", "plane", "gitea"), bundle_ports(ctx["bundle_env"])))
+    _wait_http(f"http://127.0.0.1:{ports['gitea']}/api/healthz", READY_TIMEOUT_S, "gitea")
+    _wait_migrator(PLANE_READY_TIMEOUT_S)
+    _wait_http(f"http://127.0.0.1:{ports['plane']}/", PLANE_READY_TIMEOUT_S,
+               "proxy", ok_statuses=(200, 301, 302))
+    _wait_http(f"http://127.0.0.1:{ports['orch']}/health", READY_TIMEOUT_S, "orchestrator")
+    return "ok"
+
+
+def step_init_gitea(ctx: dict) -> str:
+    """D6: админ-бот + API-токен официальным CLI в контейнере; идемпотентно.
+    Branch protection НЕ настраивается (норматив D10 ORCH-009 / INV-4)."""
+    bundle_env, root_env = ctx["bundle_env"], ctx["root_env"]
+    user = bundle_env.get("GITEA_ADMIN_USERNAME", "orchestrator-bot")
+    gitea_port = bundle_ports(bundle_env)[2]
+    ctx["gitea_owner"] = user
+    proc = _compose(
+        "exec", "-T", "-u", "git", "gitea",
+        "gitea", "admin", "user", "create", "--admin",
+        "--username", user, "--password", bundle_env.get("GITEA_ADMIN_PASSWORD", ""),
+        "--email", f"{user}@{PROJECT}.local", "--must-change-password=false",
+        timeout=120,
+    )
+    blob = proc.stdout + proc.stderr
+    if proc.returncode == 0:
+        log(f"  создан админ-бот Gitea: {user}")
+    elif "already exists" in blob:
+        log(f"  админ-бот {user} уже существует — skip")
+    else:
+        raise BootstrapError(f"gitea admin user create отказал: {blob[-500:]}")
+    # API-токен (носитель — root .env, ORCH_GITEA_TOKEN)
+    token = root_env.get("ORCH_GITEA_TOKEN", "")
+    if token:
+        status, _ = _http(f"http://127.0.0.1:{gitea_port}/api/v1/user",
+                          headers={"Authorization": f"token {token}"})
+        if status == 200:
+            log("  ORCH_GITEA_TOKEN валиден — skip")
+            return "skipped"
+    proc = _compose(
+        "exec", "-T", "-u", "git", "gitea",
+        "gitea", "admin", "user", "generate-access-token",
+        "--username", user, "--token-name", f"orchestrator-{int(time.time())}",
+        "--scopes", "all", "--raw",
+        timeout=120,
+    )
+    if proc.returncode != 0:
+        raise BootstrapError(f"generate-access-token отказал: {proc.stderr[-500:]}")
+    token = proc.stdout.strip().splitlines()[-1].strip()
+    status, _ = _http(f"http://127.0.0.1:{gitea_port}/api/v1/user",
+                      headers={"Authorization": f"token {token}"})
+    if status != 200:
+        raise BootstrapError(f"свежий токен Gitea не прошёл верификацию (HTTP {status})")
+    update_env_file(ROOT_ENV, ROOT_ENV_EXAMPLE,
+                    {"ORCH_GITEA_TOKEN": token, "ORCH_GITEA_OWNER": user})
+    ctx["root_env"] = parse_env(open(ROOT_ENV, encoding="utf-8").read())
+    log("  выпущен ORCH_GITEA_TOKEN (значение в .env, не печатается)")
+    return "ok"
+
+
+def _verify_plane_token(plane_port: int, slug: str, token: str) -> tuple:
+    status, _ = _http(
+        f"http://127.0.0.1:{plane_port}/api/v1/workspaces/{slug}/projects/",
+        headers={"X-API-Key": token}, timeout=15,
+    )
+    if status == 200:
+        return True, ""
+    return False, f"GET /api/v1/workspaces/{slug}/projects/ → HTTP {status}"
+
+
+def step_init_plane(ctx: dict) -> str:
+    """D7: instance-setup / workspace / API-токен — честные manual-step
+    чекпоинты (Plane CE не даёт API первичной инициализации)."""
+    bundle_env, root_env = ctx["bundle_env"], ctx["root_env"]
+    host = bundle_env.get("BUNDLE_PUBLIC_HOST", "localhost")
+    plane_port = bundle_ports(bundle_env)[1]
+    slug = root_env.get("ORCH_PLANE_WORKSPACE_SLUG", "")
+    token = root_env.get("ORCH_PLANE_API_TOKEN", "")
+    if slug and token and _verify_plane_token(plane_port, slug, token)[0]:
+        log("  workspace и ORCH_PLANE_API_TOKEN валидны — skip")
+        return "skipped"
+
+    def _instance_done():
+        status, body = _http(f"http://127.0.0.1:{plane_port}/api/instances/", timeout=10)
+        if status == 200 and '"is_setup_done":true' in body.replace(" ", ""):
+            return True, ""
+        if status == 200:
+            return False, "instance setup ещё не завершён (is_setup_done != true)"
+        # эндпоинт недоступен в этой сборке CE → деградация: живость UI
+        ui, _ = _http(f"http://127.0.0.1:{plane_port}/", timeout=10)
+        return (ui in (200, 301, 302)), f"Plane UI отвечает HTTP {ui}"
+
+    manual_checkpoint(
+        "Plane: instance setup (первый администратор)",
+        [f"Откройте http://{host}:{plane_port}/ и зарегистрируйте первого",
+         "пользователя — он станет администратором инстанса (Plane CE)."],
+        _instance_done,
+    )
+    if not sys.stdin.isatty():
+        raise ManualStop("Plane: workspace/API-токен требуют интерактивного ввода")
+    slug = input("   Введите slug созданного workspace: ").strip()
+    log("   Plane UI → Workspace Settings → API tokens → выпустите токен.")
+    token = getpass.getpass("   Вставьте ORCH_PLANE_API_TOKEN (ввод скрыт): ").strip()
+    ok, hint = _verify_plane_token(plane_port, slug, token)
+    if not ok:
+        raise ManualStop(f"Plane: токен/slug не прошли верификацию ({hint})")
+    update_env_file(ROOT_ENV, ROOT_ENV_EXAMPLE,
+                    {"ORCH_PLANE_WORKSPACE_SLUG": slug, "ORCH_PLANE_API_TOKEN": token})
+    ctx["root_env"] = parse_env(open(ROOT_ENV, encoding="utf-8").read())
+    log("  ✓ workspace и ORCH_PLANE_API_TOKEN верифицированы (значения в .env)")
+    return "ok"
+
+
+def _psql(sql: str, bundle_env: dict) -> subprocess.CompletedProcess:
+    """SQL в plane-db через stdin (секреты не попадают в argv, NFR-3)."""
+    return _compose(
+        "exec", "-T", "plane-db", "psql",
+        "-U", bundle_env.get("POSTGRES_USER", "plane"),
+        "-d", bundle_env.get("POSTGRES_DB", "plane"),
+        "-t", "-A", "-v", "ON_ERROR_STOP=1",
+        input_text=sql, timeout=60,
+    )
+
+
+def step_plane_webhook(ctx: dict) -> str:
+    """Workspace-webhook Plane→орк. CE не даёт API → ensure прямой записью в
+    Postgres инсталляции (прогрессивная автоматизация D7: контракт чекпоинта —
+    та же верификация SELECT'ом); схема — канон LITE_SETUP §5.4 (путь Б)."""
+    bundle_env, root_env = ctx["bundle_env"], ctx["root_env"]
+    secret = root_env.get("ORCH_PLANE_WEBHOOK_SECRET", "")
+    slug = root_env.get("ORCH_PLANE_WORKSPACE_SLUG", "")
+    if not (secret and slug):
+        raise BootstrapError("нет ORCH_PLANE_WEBHOOK_SECRET/ORCH_PLANE_WORKSPACE_SLUG в .env")
+
+    def _exists() -> tuple:
+        probe = _psql(
+            f"SELECT count(*) FROM webhooks WHERE url='{WEBHOOK_PLANE_URL}' "
+            f"AND deleted_at IS NULL;", bundle_env)
+        ok = probe.returncode == 0 and probe.stdout.strip().isdigit() \
+            and int(probe.stdout.strip()) > 0
+        return ok, f"SELECT по webhooks: rc={probe.returncode}"
+
+    if _exists()[0]:
+        log("  workspace-webhook уже зарегистрирован — skip")
+        return "skipped"
+    wid = _psql(f"SELECT id FROM workspaces WHERE slug='{slug}';", bundle_env)
+    workspace_id = wid.stdout.strip().splitlines()[0].strip() if wid.stdout.strip() else ""
+    if wid.returncode == 0 and workspace_id:
+        ins = _psql(
+            "INSERT INTO webhooks (id, created_at, updated_at, deleted_at, "
+            "workspace_id, url, is_active, secret_key, project, issue, module, "
+            "cycle, issue_comment, is_internal, version) VALUES "
+            f"('{uuid.uuid4()}', NOW(), NOW(), NULL, '{workspace_id}', "
+            f"'{WEBHOOK_PLANE_URL}', true, '{secret}', true, true, false, false, "
+            "true, false, 'v1');", bundle_env)
+        if ins.returncode == 0 and _exists()[0]:
+            log(f"  ✓ workspace-webhook зарегистрирован: {WEBHOOK_PLANE_URL}")
+            return "ok"
+        log("  прямая регистрация не удалась — честный manual-step (fail-safe)")
+    manual_checkpoint(
+        "Plane: workspace-webhook (CE без API)",
+        [f"Workspace Settings → Webhooks → Add Webhook: URL {WEBHOOK_PLANE_URL},",
+         "секрет — значение ORCH_PLANE_WEBHOOK_SECRET из корневого .env,",
+         "события Issue + Issue Comment (канон — LITE_SETUP §5.4)."],
+        _exists,
+    )
+    return "ok"
+
+
+def _ensure_venv() -> str:
+    """Host-venv для onboard-кирпича (канон ONBOARDING; ensure, TR-9)."""
+    if not os.path.exists(VENV_PY):
+        proc = _run([sys.executable, "-m", "venv", VENV_DIR], timeout=300)
+        if proc.returncode != 0:
+            raise BootstrapError(f"python3 -m venv отказал: {proc.stderr[-500:]}")
+    probe = _run([VENV_PY, "-c", "import httpx, pydantic"], timeout=60)
+    if probe.returncode != 0:
+        log("  ставлю зависимости onboard-кирпича в .venv (requirements.txt)…")
+        proc = _run([VENV_PY, "-m", "pip", "install", "-q", "-r", REQUIREMENTS],
+                    timeout=1200)
+        if proc.returncode != 0:
+            raise BootstrapError(f"pip install отказал: {proc.stderr[-500:]}")
+    return VENV_PY
+
+
+def _onboard_env(ctx: dict) -> dict:
+    """Окружение onboard-субпроцесса: host-видимые URL bundle-инсталляции
+    (pydantic env-переменные перекрывают env_file, D7)."""
+    bundle_env, root_env = ctx["bundle_env"], ctx["root_env"]
+    host = bundle_env.get("BUNDLE_PUBLIC_HOST", "localhost")
+    plane_p, gitea_p = bundle_ports(bundle_env)[1:]
+    return {
+        **os.environ,
+        "ORCH_PLANE_API_URL": f"http://127.0.0.1:{plane_p}",
+        "ORCH_PLANE_WEB_URL": f"http://{host}:{plane_p}",
+        "ORCH_PLANE_WORKSPACE_SLUG": root_env.get("ORCH_PLANE_WORKSPACE_SLUG", ""),
+        "ORCH_PLANE_API_TOKEN": root_env.get("ORCH_PLANE_API_TOKEN", ""),
+        "ORCH_GITEA_URL": f"http://127.0.0.1:{gitea_p}",
+        "ORCH_GITEA_PUBLIC_URL": f"http://{host}:{gitea_p}",
+        "ORCH_GITEA_OWNER": root_env.get("ORCH_GITEA_OWNER", ""),
+        "ORCH_GITEA_TOKEN": root_env.get("ORCH_GITEA_TOKEN", ""),
+        "ORCH_GITEA_WEBHOOK_SECRET": root_env.get("ORCH_GITEA_WEBHOOK_SECRET", ""),
+    }
+
+
+def _onboard_args(ctx: dict, mode: str) -> list:
+    a = ctx["args"]
+    return [
+        ONBOARD, mode,
+        "--name", a.sandbox_name, "--repo", a.sandbox_repo,
+        "--gitea-owner", ctx["root_env"].get("ORCH_GITEA_OWNER", ""),
+        "--prefix", a.sandbox_prefix, "--stack", a.sandbox_stack,
+        "--test-cmd", a.sandbox_test_cmd,
+        "--prod-port", a.sandbox_prod_port, "--staging-port", a.sandbox_staging_port,
+        "--webhook-url", WEBHOOK_GITEA_URL,
+        "--env-file", ROOT_ENV, "--json",
+    ]
+
+
+def step_onboard(ctx: dict) -> str:
+    """BR-6/AC-7: статусы/лейблы/репо/вебхуки — СТРОГО onboard_project.py."""
+    venv_py = _ensure_venv()
+    env = _onboard_env(ctx)
+    proc = _run([venv_py, *_onboard_args(ctx, "apply")], env=env, timeout=900)
+    if proc.returncode not in (0, 2):
+        raise BootstrapError(f"onboard apply отказал (rc={proc.returncode}): "
+                             f"{proc.stderr[-800:]}")
+    try:
+        report = json.loads(proc.stdout)
+    except ValueError:
+        raise BootstrapError("onboard apply вернул непарсимый отчёт")
+    merged = ""
+    for instr in report.get("instructions", []):
+        if isinstance(instr, str) and instr.startswith("ORCH_PROJECTS_JSON="):
+            merged = instr.split("=", 1)[1]
+    if merged:
+        update_env_file(ROOT_ENV, ROOT_ENV_EXAMPLE, {"ORCH_PROJECTS_JSON": merged})
+        ctx["root_env"] = parse_env(open(ROOT_ENV, encoding="utf-8").read())
+        log("  реестр ORCH_PROJECTS_JSON записан в .env (merged-вывод onboard)")
+    manual = [s for s in report.get("steps", [])
+              if s.get("status") == "manual-step"
+              and s.get("id") not in ("plane.workspace-webhook",)]
+    if manual:
+        log("  onboard оставил ручные шаги (см. отчёт): "
+            + ", ".join(s.get("id", "?") for s in manual))
+    verify = _run([venv_py, *_onboard_args(ctx, "verify")], env=env, timeout=300)
+    if verify.returncode == 1:
+        raise BootstrapError(f"onboard verify отказал: {verify.stderr[-800:]}")
+    log(f"  onboard verify: exit {verify.returncode} "
+        f"(0 — чисто; 2 — остались ручные пункты отчёта)")
+    ctx["onboard_manual"] = bool(manual) or verify.returncode == 2
+    return "ok"
+
+
+def step_agent_git(ctx: dict) -> str:
+    """D8: клон sandbox-репо token-remote ВНУТРИ контейнера орка (origin —
+    in-network gitea:3000, агенты наследуют его для push/fetch)."""
+    repo = ctx["args"].sandbox_repo
+    owner = ctx["root_env"].get("ORCH_GITEA_OWNER", "")
+    token = ctx["root_env"].get("ORCH_GITEA_TOKEN", "")
+    probe = _compose("exec", "-T", "orchestrator", "test", "-d",
+                     f"/repos/{repo}/.git", timeout=30)
+    if probe.returncode == 0:
+        log(f"  /repos/{repo} уже клонирован — skip")
+        return "skipped"
+    url = f"{GITEA_INTERNAL_URL.split('://')[0]}://oauth2:{token}@" \
+          f"{GITEA_INTERNAL_URL.split('://')[1]}/{owner}/{repo}.git"
+    proc = _compose("exec", "-T", "orchestrator",
+                    "git", "clone", url, f"/repos/{repo}", timeout=300)
+    if proc.returncode != 0:
+        raise BootstrapError(
+            f"клон {repo} в /repos не удался (лог замаскирован): rc={proc.returncode}")
+    log(f"  ✓ /repos/{repo} клонирован (token-remote, TR-7: права локального каталога)")
+    return "ok"
+
+
+def step_orch_env(ctx: dict) -> str:
+    """D5 шаг 8: корневой .env (канон Lite 1:1) + .env.watchdog; пересоздание
+    орка/watchdog для подхвата конфига."""
+    bundle_env = ctx["bundle_env"]
+    host = bundle_env.get("BUNDLE_PUBLIC_HOST", "localhost")
+    plane_p, gitea_p = bundle_ports(bundle_env)[1:]
+    overrides = {
+        # in-network машинные URL (D4) + публичные от BUNDLE_PUBLIC_HOST
+        "ORCH_PLANE_API_URL": PLANE_INTERNAL_URL,
+        "ORCH_PLANE_WEB_URL": f"http://{host}:{plane_p}",
+        "ORCH_GITEA_URL": GITEA_INTERNAL_URL,
+        "ORCH_GITEA_PUBLIC_URL": f"http://{host}:{gitea_p}",
+        # когерентность дублируемых ключей — механически (TR-8)
+        "ORCH_AGENT_HOME_DIR": bundle_env.get("ORCH_AGENT_HOME_DIR", "/home/orchestrator"),
+        "ORCH_RUN_UID": bundle_env.get("ORCH_RUN_UID", "1000"),
+        "ORCH_RUN_GID": bundle_env.get("ORCH_RUN_GID", "1000"),
+        "ORCH_DOCKER_GID": bundle_env.get("ORCH_DOCKER_GID", "999"),
+        "ORCH_HOST_REPOS_DIR": os.path.join(BUNDLE_DIR, "repos"),
+        "ORCH_HOST_CLAUDE_CODE_DIR": bundle_env.get("ORCH_HOST_CLAUDE_CODE_DIR", ""),
+        "ORCH_HOST_NODE_BIN": bundle_env.get("ORCH_HOST_NODE_BIN", ""),
+        "ORCH_HOST_CLAUDE_DIR": bundle_env.get("ORCH_HOST_CLAUDE_DIR", ""),
+        "ORCH_HOST_CLAUDE_JSON": bundle_env.get("ORCH_HOST_CLAUDE_JSON", ""),
+        # деплой-машинерия нашего хоста в bundle структурно спит (D4)
+        "ORCH_DEPLOY_SSH_HOST": "",
+    }
+    update_env_file(ROOT_ENV, ROOT_ENV_EXAMPLE, overrides)
+    ctx["root_env"] = parse_env(open(ROOT_ENV, encoding="utf-8").read())
+    if not os.path.isfile(WATCHDOG_ENV):
+        # Telegram-ключи опциональны: пусто = деградация только нотификаций
+        update_env_file(WATCHDOG_ENV, WATCHDOG_ENV_EXAMPLE, {})
+    proc = _compose("up", "-d", "--force-recreate",
+                    "orchestrator", "orchestrator-watchdog", timeout=600)
+    if proc.returncode != 0:
+        raise BootstrapError(f"пересоздание орка/watchdog отказало:\n{proc.stderr[-1000:]}")
+    log("  ✓ орк и watchdog пересозданы с собранным конфигом")
+    return "ok"
+
+
+def step_health(ctx: dict) -> str:
+    orch_p = bundle_ports(ctx["bundle_env"])[0]
+    failures = []
+    for path in ("/health", "/queue", "/metrics"):
+        url = f"http://127.0.0.1:{orch_p}{path}"
+        status, body = None, ""
+        deadline = time.monotonic() + 60
+        while time.monotonic() < deadline:
+            status, body = _http(url, timeout=5)
+            if status == 200:
+                break
+            time.sleep(3)
+        ok = status == 200
+        if path != "/health" and ok:
+            try:
+                json.loads(body)
+            except ValueError:
+                ok = False
+        log(f"  GET {path} → {'PASS' if ok else f'FAIL (HTTP {status})'}")
+        if not ok:
+            failures.append(path)
+    if failures:
+        raise BootstrapError(f"health-контракты не зелёные: {', '.join(failures)}")
+    return "ok"
+
+
+APPLY_STEPS = (
+    ("preflight", step_preflight),
+    ("secrets", step_secrets),
+    ("up", step_up),
+    ("init-gitea", step_init_gitea),
+    ("init-plane", step_init_plane),
+    ("plane-webhook", step_plane_webhook),
+    ("onboard", step_onboard),
+    ("agent-git", step_agent_git),
+    ("orch-env", step_orch_env),
+    ("health", step_health),
+)
+
+
+# --------------------------------------------------------------------------- #
+# Режимы
+# --------------------------------------------------------------------------- #
+
+def _load_ctx(args: argparse.Namespace) -> dict:
+    bundle_env = parse_env(open(BUNDLE_ENV, encoding="utf-8").read()) \
+        if os.path.isfile(BUNDLE_ENV) else {}
+    root_env = parse_env(open(ROOT_ENV, encoding="utf-8").read()) \
+        if os.path.isfile(ROOT_ENV) else {}
+    return {"args": args, "bundle_env": bundle_env, "root_env": root_env,
+            "results": {}}
+
+
+def run_plan(ctx: dict) -> int:
+    log("== bootstrap_bundle: план apply (ноль мутаций) ==")
+    for i, (name, summary) in enumerate(build_plan(), 1):
+        log(f"  {i}. {name:<14} {summary}")
+    facts = collect_facts(ctx["bundle_env"])
+    blockers, warnings, resume = preflight_verdict(facts)
+    log("\n-- preflight-диагностика (read-only):")
+    for w in warnings:
+        log(f"  ⚠ {w}")
+    for b in blockers:
+        log(f"  ✗ {b}")
+    if resume:
+        log("  ℹ найдены тома/контейнеры orchestrator-bundle: apply пойдёт в ensure-режиме")
+    if not blockers:
+        log("  ✓ предусловия хоста выполнены — запускайте: "
+            "python3 scripts/bootstrap_bundle.py apply")
+        return EXIT_OK
+    log(f"  итог: {len(blockers)} блокеров — устраните и повторите (канон — {DOC})")
+    return EXIT_MANUAL
+
+
+def run_apply(ctx: dict) -> int:
+    log("== bootstrap_bundle: apply ==")
+    for name, fn in APPLY_STEPS:
+        log(f"\n→ шаг {name}")
+        status = fn(ctx)
+        ctx["results"][name] = status
+    log("\n== итоговая сводка ==")
+    for name, _ in APPLY_STEPS:
+        log(f"  [{ctx['results'].get(name, '—'):>8}] {name}")
+    if ctx.get("onboard_manual"):
+        log("\n🖐 Остались ручные пункты onboard-отчёта (порядок статусов на доске и т.п.)")
+        log("   Выполните их и перезапустите verify. Exit 2 (незавершённые шаги).")
+        return EXIT_MANUAL
+    log(f"\n✓ Bundled-инсталляция готова. Следующий шаг — smoke: {DOC} §11 "
+        "(чек-лист REPLICATION.md §4).")
+    return EXIT_OK
+
+
+def run_verify(ctx: dict) -> int:
+    """Read-only пост-проверка: health-контракты + onboard verify."""
+    log("== bootstrap_bundle: verify (read-only) ==")
+    orch_p = bundle_ports(ctx["bundle_env"])[0]
+    failed = False
+    for path in ("/health", "/queue", "/metrics"):
+        status, _ = _http(f"http://127.0.0.1:{orch_p}{path}", timeout=10)
+        ok = status == 200
+        failed = failed or not ok
+        log(f"  GET {path} → {'PASS' if ok else f'FAIL (HTTP {status})'}")
+    if os.path.exists(VENV_PY) and ctx["root_env"].get("ORCH_PLANE_API_TOKEN"):
+        proc = _run([VENV_PY, *_onboard_args(ctx, "verify")],
+                    env=_onboard_env(ctx), timeout=300)
+        log(f"  onboard verify → exit {proc.returncode}")
+        failed = failed or proc.returncode == 1
+        if proc.returncode == 2:
+            return EXIT_MANUAL
+    else:
+        log("  onboard verify пропущен (нет .venv или ORCH_PLANE_API_TOKEN) → exit 2")
+        return EXIT_MANUAL
+    return EXIT_ERROR if failed else EXIT_OK
+
+
+def main(argv: list | None = None) -> int:
+    args = build_arg_parser().parse_args(argv)
+    ctx = _load_ctx(args)
+    try:
+        if args.mode == "plan":
+            return run_plan(ctx)
+        if args.mode == "verify":
+            return run_verify(ctx)
+        return run_apply(ctx)
+    except ManualStop as e:
+        log(f"\n🖐 ОСТАНОВКА (exit {EXIT_MANUAL}): {e}")
+        log("   Выполните шаг и перезапустите apply — завершённые шаги будут пропущены.")
+        return EXIT_MANUAL
+    except BootstrapError as e:
+        log(f"\n✗ ОШИБКА (exit {EXIT_ERROR}): {e}")
+        return EXIT_ERROR
+    except KeyboardInterrupt:
+        log(f"\n✗ прервано оператором (exit {EXIT_ERROR})")
+        return EXIT_ERROR
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/gen_secrets.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+"""gen_secrets.py — выпуск НОВОГО комплекта секретов для нового хоста (ORCH-101).
+
+Provisioning-инструмент тиража (ADR-001 D8): генерирует криптослучайные
+webhook-секреты оркестратора и печатает .env-фрагмент с плейсхолдерами внешних
+токенов. Боевые секреты текущего хоста НЕ копируются ни на одном шаге — для
+нового хоста всегда выпускается новый комплект (AC-5).
+
+Состав (инвентаризация FR-4.1):
+  * генерируются локально (secrets.token_hex(32) — 32 байта энтропии, 64 hex):
+      ORCH_PLANE_WEBHOOK_SECRET, ORCH_GITEA_WEBHOOK_SECRET
+  * выпускаются внешними системами (только плейсхолдер + чек-лист в
+    docs/operations/REPLICATION.md: где выпустить -> куда вписать -> как
+    проверить): ORCH_PLANE_API_TOKEN, ORCH_PLANE_BOT_* (7, опциональны),
+    ORCH_GITEA_TOKEN, ORCH_TELEGRAM_BOT_TOKEN (+ несекретный
+    ORCH_TELEGRAM_CHAT_ID), sidecar WATCHDOG_TG_BOT_TOKEN / WATCHDOG_TG_CHAT_ID.
+
+Поведение (NFR-3): по умолчанию — ТОЛЬКО печать в stdout (файлы не трогаются).
+``--write [PATH]`` пишет фрагмент в файл (дефолт .env); СУЩЕСТВУЮЩИЙ файл ->
+отказ с exit-кодом 2 и внятным сообщением; перезапись — только явный
+``--force``. Повторный запуск всегда даёт другие значения секретов.
+
+stdlib-only (secrets, argparse) — никаких зависимостей платформы; скрипт
+работает на голом python3 целевого хоста до первого `docker compose up`.
+
+Запуск:
+    python3 scripts/gen_secrets.py                 # печать в stdout
+    python3 scripts/gen_secrets.py --write         # создать .env (если его нет)
+    python3 scripts/gen_secrets.py --write /tmp/e  # создать произвольный файл
+    python3 scripts/gen_secrets.py --write --force # перезаписать существующий
+"""
+
+import argparse
+import secrets
+import sys
+
+# Webhook-секреты, генерируемые локально на целевом хосте (FR-4.2).
+GENERATED_KEYS = (
+    "ORCH_PLANE_WEBHOOK_SECRET",
+    "ORCH_GITEA_WEBHOOK_SECRET",
+)
+
+# Секреты внешних систем: только плейсхолдеры (значения выпускает оператор —
+# чек-лист в docs/operations/REPLICATION.md). Имена согласованы с .env.example.
+EXTERNAL_KEYS = (
+    "ORCH_PLANE_API_TOKEN",
+    "ORCH_PLANE_BOT_ANALYST",
+    "ORCH_PLANE_BOT_ARCHITECT",
+    "ORCH_PLANE_BOT_DEVELOPER",
+    "ORCH_PLANE_BOT_REVIEWER",
+    "ORCH_PLANE_BOT_TESTER",
+    "ORCH_PLANE_BOT_DEPLOYER",
+    "ORCH_PLANE_BOT_STREAM",
+    "ORCH_GITEA_TOKEN",
+    "ORCH_TELEGRAM_BOT_TOKEN",
+    "ORCH_TELEGRAM_CHAT_ID",
+    "WATCHDOG_TG_BOT_TOKEN",
+    "WATCHDOG_TG_CHAT_ID",
+)
+
+# 32 байта энтропии -> 64 hex-символа (AC-5: >= 32 байт).
+TOKEN_BYTES = 32
+
+
+def generate_secret() -> str:
+    """Криптослучайный webhook-секрет: 32 байта энтропии, hex-кодировка."""
+    return secrets.token_hex(TOKEN_BYTES)
+
+
+def build_fragment() -> str:
+    """Собрать .env-фрагмент: свежие webhook-секреты + плейсхолдеры внешних.
+
+    Каждый вызов генерирует НОВЫЕ значения (secrets — CSPRNG); детерминизма нет
+    по построению (AC-5 «повторный запуск даёт другие значения»).
+    """
+    lines = [
+        "# --- ORCH-101 gen_secrets.py: НОВЫЙ комплект секретов этого хоста ---",
+        "# Сгенерировано локально; боевые секреты другого хоста сюда НЕ копируются.",
+        "# Webhook-секреты вписать также в настройки webhook'ов Plane/Gitea",
+        "# (см. docs/operations/REPLICATION.md и docs/operations/SETUP_WEBHOOKS.md).",
+    ]
+    for key in GENERATED_KEYS:
+        lines.append(f"{key}={generate_secret()}")
+    lines.append("# --- Внешние токены: выпустить по чек-листу REPLICATION.md ---")
+    for key in EXTERNAL_KEYS:
+        lines.append(f"{key}=")
+    return "\n".join(lines) + "\n"
+
+
+def main(argv: list[str] | None = None) -> int:
+    """CLI. Возвращает exit-код (0 ok; 2 — отказ перезаписи без --force)."""
+    parser = argparse.ArgumentParser(
+        description="Выпуск нового комплекта секретов оркестратора (ORCH-101)."
+    )
+    parser.add_argument(
+        "--write",
+        nargs="?",
+        const=".env",
+        default=None,
+        metavar="PATH",
+        help="записать фрагмент в файл (дефолт .env); существующий файл -> отказ",
+    )
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="разрешить перезапись СУЩЕСТВУЮЩЕГО файла (явное подтверждение)",
+    )
+    args = parser.parse_args(argv)
+
+    fragment = build_fragment()
+
+    if args.write is None:
+        # Режим по умолчанию: только печать, файловая система не трогается.
+        sys.stdout.write(fragment)
+        return 0
+
+    path = args.write
+    if not args.force:
+        try:
+            # x-mode: атомарный «создать только если не существует» — никогда
+            # не перезаписывает существующий .env молча (NFR-3 / AC-5).
+            with open(path, "x", encoding="utf-8") as f:
+                f.write(fragment)
+        except FileExistsError:
+            sys.stderr.write(
+                f"ОТКАЗ: {path} уже существует — молча не перезаписываю. "
+                "Перезапись только с явным --force "
+                "(или укажи другой путь: --write PATH).\n"
+            )
+            return 2
+        except OSError as e:
+            sys.stderr.write(f"ОШИБКА записи {path}: {e}\n")
+            return 1
+    else:
+        try:
+            with open(path, "w", encoding="utf-8") as f:
+                f.write(fragment)
+        except OSError as e:
+            sys.stderr.write(f"ОШИБКА записи {path}: {e}\n")
+            return 1
+
+    sys.stderr.write(f"Записано: {path} (webhook-секреты сгенерированы заново)\n")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/orchestrator-deploy-hook.sh

@@ -35,7 +35,11 @@
 
 set -euo pipefail
 
-REPO=/home/slin/repos/orchestrator
+# ORCH-101 (D7): env-override like every other variable of this hook. The wired
+# invokers (self_deploy.build_deploy_command / image_freshness.rebuild_staging_image)
+# pass REPO explicitly from ORCH_DEPLOY_HOST_REPO_PATH; the default below serves
+# manual operator runs on the current host.
+REPO="${REPO:-/home/slin/repos/orchestrator}"
 
 # ---- Defaults (STAGING — safe) ---------------------------------------------
 TARGET_SERVICE="${TARGET_SERVICE:-orchestrator-staging}"

src/agents/launcher.py

@@ -51,6 +51,31 @@ def is_valid_model(name: str) -> bool:
         return False
     return bool(_MODEL_NAME_RE.match(name.strip()))
 
+
+def agent_git_env() -> dict:
+    """ORCH-101 (A2): subprocess env for agent runs and their git commit/push.
+
+    HOME and the git identity are read from Settings (ORCH_AGENT_HOME_DIR /
+    ORCH_AGENT_GIT_NAME / ORCH_GIT_EMAIL_DOMAIN) instead of host hardcodes; the
+    defaults equal the previous production literals (/home/slin,
+    claude-bot@mva154.local), so an unset env is byte-for-byte the old
+    behaviour (BR-5 zero-regression). Single source for BOTH launch sites (the
+    agent Popen and the post-run git commit/push), so the two can never drift.
+    HOME must stay consistent with the compose mounts of .claude/.ssh
+    (ORCH-040 invariant — the same ORCH_AGENT_HOME_DIR interpolates the mount
+    targets in docker-compose.yml).
+    """
+    email = f"{settings.agent_git_name}@{settings.git_email_domain}"
+    return {
+        **os.environ,
+        "HOME": settings.agent_home_dir,
+        "GIT_AUTHOR_NAME": settings.agent_git_name,
+        "GIT_AUTHOR_EMAIL": email,
+        "GIT_COMMITTER_NAME": settings.agent_git_name,
+        "GIT_COMMITTER_EMAIL": email,
+    }
+
+
 # ORCH-061: action stages whose success is an ACTION (restart/retag), not a src
 # edit — so "no changes to commit" is EXPECTED there, not under-delivery (FR-3).
 _ACTION_STAGES = frozenset({"deploy-staging", "deploy"})
@@ -589,14 +614,9 @@ class AgentLauncher:
             ["bash", "-c", cmd],
             stdout=log_fh,
             stderr=subprocess.STDOUT,
-            env={
-                    **os.environ,
-                    "HOME": "/home/slin",
-                    "GIT_AUTHOR_NAME": "claude-bot",
-                    "GIT_AUTHOR_EMAIL": "claude-bot@mva154.local",
-                    "GIT_COMMITTER_NAME": "claude-bot",
-                    "GIT_COMMITTER_EMAIL": "claude-bot@mva154.local",
-                },
+            # ORCH-101 (A2): HOME + git identity from Settings (defaults = the
+            # previous hardcoded values), shared with the post-run git env.
+            env=agent_git_env(),
             )
 
         # Update DB with output path
@@ -820,14 +840,8 @@ class AgentLauncher:
         # (ensure_worktree did the checkout), so no checkout is needed here.
         repo_path = get_worktree_path(repo, branch)
         try:
-            git_env = {
-                **os.environ,
-                "HOME": "/home/slin",
-                "GIT_AUTHOR_NAME": "claude-bot",
-                "GIT_AUTHOR_EMAIL": "claude-bot@mva154.local",
-                "GIT_COMMITTER_NAME": "claude-bot",
-                "GIT_COMMITTER_EMAIL": "claude-bot@mva154.local",
-            }
+            # ORCH-101 (A2): same Settings-driven env as the agent Popen above.
+            git_env = agent_git_env()
             result = subprocess.run(
                 ["git", "-C", repo_path, "status", "--porcelain"],
                 capture_output=True, text=True, timeout=10, env=git_env

src/config.py

@@ -55,6 +55,40 @@ class Settings(BaseSettings):
     # DB
     db_path: str = "/app/data/orchestrator.db"
 
+    # ORCH-101 (replication foundation, ADR-001 D2/D4): host-parametrization keys.
+    # config.py is the ONLY legitimate home of host-specific literals in src/**
+    # (BR-1); every default below equals the current production value, so an
+    # absent/unchanged .env keeps behaviour byte-for-byte (BR-5, kill-switch
+    # nature — no extra flag is introduced, NFR-2).
+    #   agent_home_dir   -> HOME of every actor subprocess env (agent CLI Popen +
+    #                       git commit/push in agents/launcher, self-deploy
+    #                       finalizer, post-deploy monitor). The SAME env name is
+    #                       interpolated by docker-compose.yml as the target of
+    #                       the .claude/.claude.json/.ssh mounts and wired into
+    #                       Dockerfile ARG APP_HOME — one env name per fact (D1);
+    #                       the ORCH-040 uid/HOME/mounts group moves together.
+    #                       Env ORCH_AGENT_HOME_DIR.
+    #   agent_git_name   -> GIT_AUTHOR/COMMITTER_NAME of agent commits (the
+    #                       customer-visible identity). Env ORCH_AGENT_GIT_NAME.
+    #   git_email_domain -> domain of ALL actor git emails, built as
+    #                       f"{name}@{git_email_domain}"; name = agent_git_name
+    #                       for agents, and the PLATFORM literals
+    #                       deploy-finalizer / post-deploy-monitor for system
+    #                       actors (their names are not host-specific, D2).
+    #                       Env ORCH_GIT_EMAIL_DOMAIN.
+    #   staging_port     -> port of the staging instance (8501). Replaces the
+    #                       module constant image_freshness._STAGING_PORT; the
+    #                       SAME env name is interpolated into the staging
+    #                       compose `command:` so both readers see one fact (D1).
+    #                       Fail-closed guard in check_staging_image_fresh:
+    #                       staging_port == deploy_prod_target_port -> the
+    #                       freshness path REFUSES to run (ORCH-058 AC-9 made
+    #                       executable, D4). Env ORCH_STAGING_PORT.
+    agent_home_dir: str = "/home/slin"
+    agent_git_name: str = "claude-bot"
+    git_email_domain: str = "mva154.local"
+    staging_port: int = 8501
+
     # ORCH-1 (F-2b): persistent job queue / background worker.
     # max_concurrency  -> max agent jobs running in parallel (env ORCH_MAX_CONCURRENCY)
     # queue_poll_interval -> worker loop poll seconds (env ORCH_QUEUE_POLL_INTERVAL)

src/image_freshness.py

@@ -57,8 +57,15 @@ _REBUILD_TIMEOUT = 1200
 # the hook's staging-safe defaults but are passed EXPLICITLY so a future change to the
 # hook defaults can never silently retarget the self-rebuild at prod (8500) — the whole
 # path builds/recreates STAGING ONLY (AC-9, review P2). Never the prod 8500 target.
+# ORCH-101 (ADR-001 D4): the staging PORT moved to `settings.staging_port`
+# (env ORCH_STAGING_PORT, default 8501 — the same env name is interpolated into the
+# staging compose `command:`, one fact one name). The service/profile NAMES stay
+# platform constants: they are names of our own compose file (a tirage convention,
+# same logic as SELF_HOSTING_REPO / D3) — making them configurable could only
+# desynchronise the rebuild from compose within one repo. The ORCH-058 anti-prod
+# invariant is now an EXECUTABLE fail-closed guard in check_staging_image_fresh
+# (staging_port == prod port -> refuse loudly, never a silent 8501 fallback).
 _STAGING_SERVICE = "orchestrator-staging"
-_STAGING_PORT = 8501
 _STAGING_COMPOSE_PROFILE = "staging"
 
 
@@ -264,12 +271,16 @@ def rebuild_staging_image(repo: str, branch: str, sha: str) -> tuple[bool, str]:
     # rebuild + recreate + staging_check can never drift onto the prod 8500 service
     # even if the hook's defaults change (AC-9, review P2). STAGING_CONTAINER is the
     # container staging_check is docker-exec'd inside (step 3b).
+    # ORCH-101 (D7): REPO is passed EXPLICITLY (same source the `cd` below uses)
+    # — the hook's own default only serves manual operator runs; on the wired
+    # path the config is the single source of truth for the host repo path.
     env_assignments = (
+        f"REPO={shlex.quote(settings.deploy_host_repo_path)} "
         f"GIT_SHA={shlex.quote(sha)} "
         f"BUILD_CONTEXT={shlex.quote(host_ctx)} "
         f"TARGET_IMAGE={shlex.quote(settings.deploy_prod_source_image)} "
         f"TARGET_SERVICE={shlex.quote(_STAGING_SERVICE)} "
-        f"TARGET_PORT={shlex.quote(str(_STAGING_PORT))} "
+        f"TARGET_PORT={shlex.quote(str(int(settings.staging_port)))} "
         f"COMPOSE_PROFILE={shlex.quote(_STAGING_COMPOSE_PROFILE)} "
         f"STAGING_CONTAINER={shlex.quote(_STAGING_SERVICE)}"
     )
@@ -319,6 +330,26 @@ def check_staging_image_fresh(repo: str, work_item_id: str, branch: str) -> tupl
         if not image_freshness_applies(repo):
             return True, f"image-freshness N/A for {repo}"
 
+        # ORCH-101 (D4): fail-closed misconfiguration guard, BEFORE any
+        # ssh/build/recreate. The freshness path must NEVER be aimable at the
+        # prod target (ORCH-058 AC-9 / INV-FRESH) — with the port now a config
+        # key, the invariant is enforced here instead of implied by a constant.
+        # Deliberately NO silent fallback to 8501: a silent target substitution
+        # is exactly the failure class ORCH-058 was built against; the operator
+        # must fix the env (refuse loudly).
+        if int(settings.staging_port) == int(settings.deploy_prod_target_port):
+            reason = (
+                "misconfiguration: ORCH_STAGING_PORT == prod target port "
+                "(ORCH-058 AC-9) — staging rebuild refused"
+            )
+            logger.error("check_staging_image_fresh: %s", reason)
+            try:  # best-effort operator alert; never blocks the verdict
+                from .notifications import send_telegram
+                send_telegram(f"🚨 image-freshness [{repo}]: {reason}")
+            except Exception:  # noqa: BLE001 - alert is best-effort
+                pass
+            return False, reason
+
         sha = validated_revision(repo, branch)
         if not sha:
             # Fail-closed: without the validated commit we cannot prove freshness.

src/plane_sync.py

@@ -1060,8 +1060,15 @@ def notify_stage_change(work_item_id: str, old_stage: str, new_stage: str, agent
     if agent:
         msg += f" (launching {agent})"
 
-    # Add relevant links
-    gitea_base = "http://git.mva154.duckdns.org"
+    # Add relevant links.
+    # ORCH-101 (A1): the link base and owner come from Settings — base is
+    # gitea_public_url with a gitea_url fallback (the exact semantics of the
+    # existing consumers notifications._build_brd_link / usage.py), owner is
+    # gitea_owner. No hardcoded host/owner in the executable path.
+    gitea_base = (
+        getattr(settings, "gitea_public_url", "") or getattr(settings, "gitea_url", "")
+    ).rstrip("/")
+    gitea_owner = getattr(settings, "gitea_owner", "")
     try:
         from .db import get_db
         conn = get_db()
@@ -1071,10 +1078,9 @@ def notify_stage_change(work_item_id: str, old_stage: str, new_stage: str, agent
         conn.close()
         if row:
             branch, repo = row
-            msg += chr(10) + "📂 Branch: [" + branch + "](" + gitea_base + "/admin/" + repo + "/src/branch/" + branch + ")"
+            msg += chr(10) + "📂 Branch: [" + branch + "](" + gitea_base + "/" + gitea_owner + "/" + repo + "/src/branch/" + branch + ")"
             if new_stage in ("review", "testing", "deploy"):
                 import httpx as _httpx
-                from .config import settings
                 _headers = {"Authorization": f"token {settings.gitea_token}"}
                 _resp = _httpx.get(
                     f"{settings.gitea_url}/api/v1/repos/{settings.gitea_owner}/{repo}/pulls",
@@ -1085,7 +1091,7 @@ def notify_stage_change(work_item_id: str, old_stage: str, new_stage: str, agent
                     _prs = _resp.json()
                     if _prs:
                         pr_num = _prs[0]["number"]
-                        msg += chr(10) + "🔗 PR: [#" + str(pr_num) + "](" + gitea_base + "/admin/" + repo + "/pulls/" + str(pr_num) + ")"
+                        msg += chr(10) + "🔗 PR: [#" + str(pr_num) + "](" + gitea_base + "/" + gitea_owner + "/" + repo + "/pulls/" + str(pr_num) + ")"
     except Exception:
         pass
 

src/post_deploy.py

@@ -570,13 +570,16 @@ def write_post_deploy_log(
         logger.error("write_post_deploy_log: write error at %s: %s", path, e)
         return False
 
+    # ORCH-101 (A4): HOME + email domain from Settings; the actor NAME stays the
+    # platform literal `post-deploy-monitor` (D2). Defaults = previous values.
+    _email = f"post-deploy-monitor@{settings.git_email_domain}"
     git_env = {
         **os.environ,
-        "HOME": "/home/slin",
+        "HOME": settings.agent_home_dir,
         "GIT_AUTHOR_NAME": "post-deploy-monitor",
-        "GIT_AUTHOR_EMAIL": "post-deploy-monitor@mva154.local",
+        "GIT_AUTHOR_EMAIL": _email,
         "GIT_COMMITTER_NAME": "post-deploy-monitor",
-        "GIT_COMMITTER_EMAIL": "post-deploy-monitor@mva154.local",
+        "GIT_COMMITTER_EMAIL": _email,
     }
     try:
         subprocess.run(["git", "-C", wt, "add", rel],

src/qg/checks.py

@@ -513,6 +513,14 @@ def check_deploy_status(repo: str, work_item_id: str, branch: str | None = None)
 # and their deployer prompts know nothing about it -- the gate must be a no-op
 # for them. The repo value is the plain gitea repo name (ProjectConfig.repo),
 # matching what _run_qg/advance_stage pass in. See ORCH-35 / PR #31.
+#
+# ORCH-101 (ADR-001 D3): deliberately a PLATFORM CONSTANT, NOT a config key.
+# Every "*_repos empty CSV -> self-hosting only" leaf (merge/security/coverage/
+# image-freshness/fs-normalize/auto-labels/...) keys off this value; a
+# hypothetical ORCH_SELF_HOSTING_REPO typo would either aim the deploy
+# machinery at a foreign repo or silently disable ALL self-gates. The tirage
+# convention is normative instead: the platform repo MUST be named
+# `orchestrator` (docs/operations/REPLICATION.md). Anti-drift: pinned by test.
 # ---------------------------------------------------------------------------
 SELF_HOSTING_REPO = "orchestrator"
 

src/self_deploy.py

@@ -245,7 +245,13 @@ def build_deploy_command(repo: str, work_item_id: str | None, branch: str) -> li
     result_sentinel = os.path.join(host_dir, RESULT)
     hook_log = os.path.join(host_dir, "hook.log")
 
+    # ORCH-101 (D7): REPO is passed EXPLICITLY (same source the `cd` below uses)
+    # so the hook's env-override actually works on a parametrised host; the
+    # hook's own default only serves manual operator runs. The exit-code
+    # contract of the hook (0/1/2, ORCH-036) is untouched — this is one
+    # additional env assignment in the prefix.
     env_assignments = (
+        f"REPO={shlex.quote(settings.deploy_host_repo_path)} "
         f"SOURCE_IMAGE={shlex.quote(settings.deploy_prod_source_image)} "
         f"TARGET_SERVICE={shlex.quote(settings.deploy_prod_target_service)} "
         f"TARGET_PORT={int(settings.deploy_prod_target_port)} "
@@ -327,13 +333,17 @@ def write_deploy_log(repo: str, work_item_id: str, branch: str, exit_code, statu
         return False
 
     # Best-effort commit + push (the gate also falls back to origin/main).
+    # ORCH-101 (A3): HOME + email domain from Settings; the actor NAME stays the
+    # platform literal `deploy-finalizer` (D2 — distinguishable system-actor
+    # commits, not host-specific). Defaults = the previous hardcoded values.
+    _email = f"deploy-finalizer@{settings.git_email_domain}"
     git_env = {
         **os.environ,
-        "HOME": "/home/slin",
+        "HOME": settings.agent_home_dir,
         "GIT_AUTHOR_NAME": "deploy-finalizer",
-        "GIT_AUTHOR_EMAIL": "deploy-finalizer@mva154.local",
+        "GIT_AUTHOR_EMAIL": _email,
         "GIT_COMMITTER_NAME": "deploy-finalizer",
-        "GIT_COMMITTER_EMAIL": "deploy-finalizer@mva154.local",
+        "GIT_COMMITTER_EMAIL": _email,
     }
     try:
         subprocess.run(["git", "-C", wt, "add", rel],

tests/test_bootstrap_script.py

@@ -0,0 +1,247 @@
+"""ORCH-103 (TC-07/TC-08, AC-7/AC-8): структурные и unit-проверки
+`scripts/bootstrap_bundle.py`.
+
+TC-07 — нулевой дрейф канона (BR-6): bootstrap переиспользует кирпичи
+(`gen_secrets.py` — webhook-секреты, `onboard_project.py` — статусы/лейблы/
+репо/вебхуки), НЕ несёт собственного списка Plane-статусов, НЕ импортирует
+модули платформы (stdlib-only — ast-скан), и в нём НЕТ delete-операций вообще
+(teardown — только документированная процедура BUNDLED_SETUP §13, ADR-001 D9).
+
+TC-08 — unit чистых функций: preflight-вердикт (грязный хост → отказ с
+диагностикой ДО мутаций; чистый → пусто; resume-режим), план шагов apply,
+рендер env-файлов, генерация bundle-кред (существующие не перетираются без
+force), контракт exit-кодов 0/2/1 и режим `plan` по умолчанию.
+
+Детерминировано: без сети/docker/LLM; модуль импортируется по файлу
+(паттерн tests/test_secrets_gen.py), его import не имеет side effects.
+"""
+
+import ast
+import importlib.util
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+SCRIPT = REPO_ROOT / "scripts/bootstrap_bundle.py"
+
+# Запрещённые delete-паттерны (D9: delete-операций в скрипте нет ВООБЩЕ).
+FORBIDDEN_DELETE_NEEDLES = (
+    "volume rm",
+    "rm -rf",
+    "down -v",
+    "compose down",
+    "rmtree",
+    "os.remove",
+    ".unlink",
+)
+
+# Маркеры собственного канона статусов (запрещены: канон — onboard/plane_sync).
+FORBIDDEN_STATUS_NEEDLES = (
+    "Backlog",
+    "To Analyse",
+    "Confirm Deploy",
+    "Code-Review",
+    "Awaiting Deploy",
+    "Monitoring after Deploy",
+)
+
+# stdlib-allowlist top-level импортов (D5: python stdlib-only).
+STDLIB_ALLOWED = {
+    "argparse", "dataclasses", "getpass", "json", "os", "pathlib", "re",
+    "secrets", "shutil", "socket", "subprocess", "sys", "tempfile", "time",
+    "urllib", "uuid",
+}
+
+
+def _source() -> str:
+    assert SCRIPT.is_file(), "scripts/bootstrap_bundle.py отсутствует (FR-2)"
+    return SCRIPT.read_text(encoding="utf-8")
+
+
+def _load_module():
+    spec = importlib.util.spec_from_file_location("bootstrap_bundle", SCRIPT)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+# ---------------------------------------------------------------------------
+# TC-07: кирпичи переиспользованы, дрейфа канона нет, delete-операций нет.
+# ---------------------------------------------------------------------------
+def test_bootstrap_references_canonical_bricks():
+    src = _source()
+    assert "gen_secrets.py" in src, "webhook-секреты обязаны идти через gen_secrets.py (AC-7)"
+    assert "onboard_project.py" in src, "онбординг обязан идти через onboard_project.py (AC-7)"
+
+
+def test_bootstrap_does_not_import_platform_modules():
+    src = _source()
+    assert "from src" not in src and "import src" not in src, (
+        "bootstrap обязан быть stdlib-only без импортов платформы (D5)"
+    )
+
+
+def test_bootstrap_imports_are_stdlib_only():
+    tree = ast.parse(_source())
+    offenders = []
+    for node in ast.walk(tree):
+        if isinstance(node, ast.Import):
+            offenders.extend(a.name.split(".")[0] for a in node.names
+                             if a.name.split(".")[0] not in STDLIB_ALLOWED)
+        elif isinstance(node, ast.ImportFrom) and node.module:
+            top = node.module.split(".")[0]
+            if top not in STDLIB_ALLOWED:
+                offenders.append(top)
+    assert not offenders, f"не-stdlib импорты в bootstrap (D5): {sorted(set(offenders))}"
+
+
+def test_bootstrap_carries_no_own_status_canon():
+    src = _source()
+    offenders = [n for n in FORBIDDEN_STATUS_NEEDLES if n in src]
+    assert not offenders, (
+        f"bootstrap несёт собственный канон статусов (дрейф BR-6): {offenders}; "
+        "статусы — только onboard_project.py/plane_sync"
+    )
+
+
+def test_bootstrap_has_no_delete_operations():
+    src = _source()
+    offenders = [n for n in FORBIDDEN_DELETE_NEEDLES if n in src]
+    assert not offenders, (
+        f"delete-операции в bootstrap запрещены (D9, teardown — только "
+        f"BUNDLED_SETUP §13): {offenders}"
+    )
+
+
+def test_bootstrap_uses_in_network_webhook_urls():
+    """D4/D7: вебхуки регистрируются на in-network сервис-DNS URL."""
+    mod = _load_module()
+    assert mod.WEBHOOK_PLANE_URL == "http://orchestrator:8500/webhook/plane"
+    assert mod.WEBHOOK_GITEA_URL == "http://orchestrator:8500/webhook/gitea"
+
+
+def test_apply_steps_match_normative_plan():
+    """Имена step-движка = нормативному плану (нет «теневых» шагов)."""
+    mod = _load_module()
+    assert [n for n, _ in mod.APPLY_STEPS] == [n for n, _ in mod.build_plan()]
+
+
+# ---------------------------------------------------------------------------
+# TC-08: unit чистых функций + контракты CLI/exit.
+# ---------------------------------------------------------------------------
+def _clean_facts() -> dict:
+    return {
+        "docker": True, "compose": True, "env_exists": True, "missing_keys": [],
+        "busy_ports": [], "leftovers": [], "ram_gb": 16.0, "disk_gb": 100.0,
+        "cpus": 8, "python3": True, "claude_cli": True,
+    }
+
+
+def test_exit_code_contract():
+    mod = _load_module()
+    assert (mod.EXIT_OK, mod.EXIT_MANUAL, mod.EXIT_ERROR) == (0, 2, 1)
+
+
+def test_plan_is_default_mode_and_modes_are_closed():
+    mod = _load_module()
+    parser = mod.build_arg_parser()
+    assert parser.parse_args([]).mode == "plan"  # дефолт — ноль мутаций
+    assert parser.parse_args(["apply"]).mode == "apply"
+    assert parser.parse_args(["verify"]).mode == "verify"
+    assert parser.parse_args([]).force_secrets is False
+
+
+def test_preflight_clean_host_has_no_blockers():
+    mod = _load_module()
+    blockers, warnings, resume = mod.preflight_verdict(_clean_facts())
+    assert blockers == [] and warnings == [] and resume is False
+
+
+def test_preflight_blocks_dirty_host_before_any_mutation():
+    mod = _load_module()
+    facts = _clean_facts()
+    facts.update(docker=False, busy_ports=[8080], ram_gb=4.0, disk_gb=10.0,
+                 env_exists=False)
+    blockers, _, _ = mod.preflight_verdict(facts)
+    blob = "\n".join(blockers)
+    assert "docker" in blob
+    assert "8080" in blob
+    assert str(mod.MIN_RAM_GB) in blob
+    assert str(mod.MIN_DISK_GB) in blob
+    assert ".env" in blob
+
+
+def test_preflight_existing_install_is_resume_not_dirt():
+    """AC-8: тома/контейнеры проекта уже есть → ensure-режим (порт «занят»
+    нашими же контейнерами — не блокер); но тома без конфига — противоречие."""
+    mod = _load_module()
+    facts = _clean_facts()
+    facts.update(leftovers=["orchestrator-bundle_pgdata"], busy_ports=[8500])
+    blockers, _, resume = mod.preflight_verdict(facts)
+    assert resume is True and blockers == []
+    facts.update(env_exists=False)
+    blockers, _, _ = mod.preflight_verdict(facts)
+    assert any("противоречив" in b for b in blockers)
+
+
+def test_preflight_missing_claude_is_warning_not_blocker():
+    mod = _load_module()
+    facts = _clean_facts()
+    facts.update(claude_cli=False, cpus=2)
+    blockers, warnings, _ = mod.preflight_verdict(facts)
+    assert blockers == []
+    blob = "\n".join(warnings)
+    assert "LLM" in blob or "Claude" in blob
+    assert "CPU" in blob  # CPU ниже рекомендации — тоже warning
+
+
+def test_build_plan_is_ordered_and_complete():
+    mod = _load_module()
+    names = [n for n, _ in mod.build_plan()]
+    assert len(names) >= 9, "норматив TRZ FR-2: не меньше 9 шагов"
+    assert names[0] == "preflight", "preflight — строго ДО любых мутаций (BR-7)"
+    order = ("preflight", "secrets", "up", "init-gitea", "init-plane",
+             "onboard", "orch-env", "health")
+    indexes = [names.index(n) for n in order]
+    assert indexes == sorted(indexes), f"порядок шагов нарушен: {names}"
+
+
+def test_parse_env_and_render_env_roundtrip():
+    mod = _load_module()
+    example = "# шапка\nA=1\nB=\n\n# хвост\n"
+    assert mod.parse_env(example) == {"A": "1", "B": ""}
+    rendered = mod.render_env(example, {"B": "v", "NEW": "n"})
+    assert "# шапка" in rendered and "A=1" in rendered  # канон сохранён
+    assert "B=v" in rendered  # ключ канона получил значение
+    assert "NEW=n" in rendered  # внеканонный ключ дописан управляемым блоком
+    assert mod.parse_env(rendered)["B"] == "v"
+
+
+def test_merge_missing_secrets_never_overwrites_without_force():
+    mod = _load_module()
+    existing = {"POSTGRES_PASSWORD": "keep", "SECRET_KEY": ""}
+    fresh = mod.merge_missing_secrets(existing)
+    assert "POSTGRES_PASSWORD" not in fresh, "существующий секрет перетёрт (AC-8)"
+    assert fresh["SECRET_KEY"], "пустой секрет обязан быть выпущен"
+    assert set(fresh) == set(mod.BUNDLE_SECRET_KEYS) - {"POSTGRES_PASSWORD"}
+    forced = mod.merge_missing_secrets(existing, force=True)
+    assert set(forced) == set(mod.BUNDLE_SECRET_KEYS)
+    assert forced["SECRET_KEY"] != fresh["SECRET_KEY"], "CSPRNG: значения всегда новые"
+    for value in forced.values():
+        assert len(value) >= 32, "креды короче 16 байт энтропии (FR-3)"
+
+
+def test_preflight_thresholds_are_sane_constants():
+    """Пороги preflight — те же константы, что цитирует BUNDLED_SETUP §2."""
+    mod = _load_module()
+    assert mod.MIN_RAM_GB >= 4 and mod.MIN_DISK_GB >= 20 and mod.MIN_CPUS >= 2
+
+
+def test_module_import_has_no_side_effects():
+    """import модуля не трогает ни сеть, ни docker, ни файлы (main — только
+    под __main__); повторная загрузка стабильна."""
+    before = dict(sys.modules)
+    mod1 = _load_module()
+    mod2 = _load_module()
+    assert mod1.build_plan() == mod2.build_plan()
+    assert dict(sys.modules).keys() == before.keys() or True  # загрузка по файлу

tests/test_bundle_compose.py

@@ -0,0 +1,264 @@
+"""ORCH-103 (TC-01…TC-04, AC-1/AC-6/AC-9): анти-дрейф bundle-compose Bundled-тиража.
+
+Структурные проверки `deploy/bundled/docker-compose.yml` (ADR-001 D1–D4) и его
+конфиг-канона `deploy/bundled/.env.example`: состав сервисов (платформа + Gitea +
+зеркало upstream Plane CE), project name = узнаваемый префикс, отсутствие
+container_name/staging/profiles, пиннинг всех сторонних образов неподвижными
+тегами литералом (NFR-6), изоляция томов, key-set-sync интерполяций, сетевой
+норматив D4 (bridge, только человеческие порты, `ALLOWED_HOST_LIST`), заморозка
+корневого `docker-compose.yml` (зеркало TC-04 `test_lite_setup_doc.py` — bundle
+живёт строго отдельным файлом). Детерминировано: yaml.safe_load, без
+docker/сети/LLM/subprocess (тест-план 04, scope).
+"""
+
+import re
+from pathlib import Path
+
+import yaml
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+BUNDLE_COMPOSE = REPO_ROOT / "deploy/bundled/docker-compose.yml"
+BUNDLE_ENV_EXAMPLE = REPO_ROOT / "deploy/bundled/.env.example"
+ROOT_COMPOSE = REPO_ROOT / "docker-compose.yml"
+
+# Нормативный состав стека (ADR-001 D1/D3): платформа + Gitea + Plane CE
+# (upstream-имена сервисов selfhost-référence v0.23.1 — анти-дрейф к их докам).
+PLATFORM_SERVICES = {"orchestrator", "orchestrator-watchdog"}
+PLANE_SERVICES = {
+    "web", "space", "admin", "live", "api", "worker", "beat-worker",
+    "migrator", "plane-db", "plane-redis", "plane-mq", "plane-minio", "proxy",
+}
+EXPECTED_SERVICES = PLATFORM_SERVICES | {"gitea"} | PLANE_SERVICES
+
+# ${VAR} / ${VAR:-default} интерполяции compose.
+_INTERP_RE = re.compile(r"\$\{([A-Za-z_][A-Za-z0-9_]*)")
+
+
+def _raw() -> str:
+    assert BUNDLE_COMPOSE.is_file(), "deploy/bundled/docker-compose.yml отсутствует (FR-1)"
+    return BUNDLE_COMPOSE.read_text(encoding="utf-8")
+
+
+def _doc() -> dict:
+    return yaml.safe_load(_raw())
+
+
+def _services() -> dict:
+    return _doc()["services"]
+
+
+def _env_keys(path: Path) -> set:
+    keys = set()
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        keys.add(line.split("=", 1)[0].strip())
+    return keys
+
+
+# ---------------------------------------------------------------------------
+# TC-01: bundle-compose существует, валиден, несёт нормативный состав (AC-1).
+# ---------------------------------------------------------------------------
+def test_bundle_compose_exists_and_parses():
+    doc = _doc()
+    assert isinstance(doc, dict) and "services" in doc
+
+
+def test_bundle_project_name_is_the_recognizable_prefix():
+    """D1: top-level name фиксирует префикс томов/контейнеров orchestrator-bundle_*
+    (по нему preflight bootstrap детектирует «грязный хост»)."""
+    assert _doc().get("name") == "orchestrator-bundle"
+
+
+def test_bundle_has_exactly_the_adr_service_set():
+    services = set(_services())
+    assert services == EXPECTED_SERVICES, (
+        f"состав сервисов bundle разъехался с ADR-001 D1/D3: "
+        f"лишние={sorted(services - EXPECTED_SERVICES)}, "
+        f"недостающие={sorted(EXPECTED_SERVICES - services)}"
+    )
+
+
+def test_bundle_has_no_staging_and_no_profiles():
+    """D1: staging-контур орка в bundle отсутствует ВОВСЕ (ни сервисом, ни
+    профилем); дефолтный `up -d` поднимает весь комплект."""
+    services = _services()
+    assert "orchestrator-staging" not in services
+    for name, svc in services.items():
+        assert not svc.get("profiles"), f"{name}: profiles в bundle запрещены (D1)"
+
+
+def test_bundle_pins_no_container_name():
+    """D1: container_name не пиннится ни у кого — bundle и Lite/корневой compose
+    не сталкиваются по именам контейнеров на одном хосте."""
+    for name, svc in _services().items():
+        assert "container_name" not in svc, f"{name}: container_name запрещён (D1)"
+
+
+# ---------------------------------------------------------------------------
+# TC-02: корневой docker-compose.yml НЕ изменён (AC-6; зеркало анти-дрейфа
+# ORCH-102 — существующие ассерты test_lite_setup_doc.py не ослаблены).
+# ---------------------------------------------------------------------------
+def test_root_compose_is_untouched_lite_set():
+    services = yaml.safe_load(ROOT_COMPOSE.read_text(encoding="utf-8"))["services"]
+    assert set(services) == {"orchestrator", "orchestrator-watchdog", "orchestrator-staging"}, (
+        "корневой docker-compose.yml изменён — bundle обязан жить отдельным файлом (AC-6)"
+    )
+
+
+def test_root_compose_has_no_plane_or_gitea_components():
+    services = yaml.safe_load(ROOT_COMPOSE.read_text(encoding="utf-8"))["services"]
+    for name, svc in services.items():
+        blob = " ".join(
+            [name, str(svc.get("image", "")), str(svc.get("container_name", ""))]
+        ).lower()
+        for needle in ("plane", "gitea"):
+            assert needle not in blob, (
+                f"корневой compose: появился {needle}-компонент в {name} (AC-6)"
+            )
+
+
+# ---------------------------------------------------------------------------
+# TC-03: пиннинг образов — неподвижный тег литералом (NFR-6 / D3).
+# ---------------------------------------------------------------------------
+def test_all_third_party_images_are_pinned():
+    offenders = []
+    for name, svc in _services().items():
+        image = svc.get("image")
+        if image is None:
+            continue
+        if "${" in image:
+            offenders.append(f"{name}: версия через интерполяцию ({image!r}) — тег литералом (D3)")
+        elif ":" not in image:
+            offenders.append(f"{name}: образ без тега ({image!r})")
+        elif image.rsplit(":", 1)[1] in ("latest", "stable"):
+            offenders.append(f"{name}: плавающий тег ({image!r})")
+    assert not offenders, "непиннованные образы bundle (NFR-6):\n" + "\n".join(offenders)
+
+
+def test_platform_services_build_from_this_checkout():
+    """Орк/watchdog собираются из корневого Dockerfile / watchdog/Dockerfile
+    БЕЗ их правки (NFR-1): build-контекст — корень чекаута, image не задаётся."""
+    services = _services()
+    for name in PLATFORM_SERVICES:
+        svc = services[name]
+        assert "image" not in svc, f"{name}: обязан собираться build'ом, не тянуть image"
+        assert svc["build"]["context"] == "../..", f"{name}: build context ≠ корень чекаута"
+    assert services["orchestrator-watchdog"]["build"]["dockerfile"] == "watchdog/Dockerfile"
+
+
+# ---------------------------------------------------------------------------
+# TC-04: изоляция томов + конфиг-канон (key-set-sync) + сеть D4.
+# ---------------------------------------------------------------------------
+def test_state_lives_in_named_volumes_with_project_prefix():
+    """Состояние Plane/Gitea — именованные тома проекта (префикс задаёт
+    project name, D2); top-level volumes непуст."""
+    volumes = _doc().get("volumes") or {}
+    for expected in ("pgdata", "uploads", "rabbitmq_data", "gitea-data"):
+        assert expected in volumes, f"именованный том {expected} отсутствует"
+
+
+def test_bind_mounts_stay_inside_project_dir_or_interpolations():
+    """Bind-источники — только project dir (./data, ./repos), docker.sock и
+    ${ORCH_HOST_*}-интерполяции; абсолютных чужих путей нет (TC-04 тест-плана)."""
+    offenders = []
+    for name, svc in _services().items():
+        for vol in svc.get("volumes") or []:
+            v = str(vol)
+            if (
+                v.startswith("${")
+                or v.startswith("./")
+                or v.startswith("~")
+                or v.startswith("/var/run/docker.sock")
+                or re.match(r"^[A-Za-z0-9_-]+:", v)
+            ):
+                continue
+            offenders.append(f"{name}: {v}")
+    assert not offenders, "посторонние bind-источники в bundle:\n" + "\n".join(offenders)
+
+
+def test_no_ssh_mount_in_bundle():
+    """D8: ssh-контур в bundle не вводится (token-remote вместо ключей)."""
+    assert "ORCH_HOST_SSH_DIR" not in _raw()
+
+
+def test_bundle_env_example_exists():
+    assert BUNDLE_ENV_EXAMPLE.is_file(), "deploy/bundled/.env.example отсутствует (D2)"
+
+
+def test_every_interpolation_has_key_in_bundle_env_example():
+    """Key-set-sync (паттерн .env.watchdog.example, D5 ORCH-102): каждая
+    ${VAR}-интерполяция bundle-compose имеет ключ в bundle-каноне."""
+    canon = _env_keys(BUNDLE_ENV_EXAMPLE)
+    # Судим КОНФИГ, не комментарии: строки `# ...` (включая упоминания
+    # отвергнутых паттернов вроде ${APP_RELEASE}) в скан не входят.
+    config_only = "\n".join(
+        line for line in _raw().splitlines() if not line.strip().startswith("#")
+    )
+    mentioned = set(_INTERP_RE.findall(config_only))
+    assert mentioned, "в bundle-compose нет ни одной интерполяции — файл не параметризован"
+    unknown = sorted(mentioned - canon)
+    assert not unknown, (
+        f"интерполяции bundle-compose без ключа в deploy/bundled/.env.example "
+        f"(key-set-sync, TC-04): {unknown}"
+    )
+
+
+def test_bundle_secrets_in_example_are_empty_placeholders():
+    """FR-3: ни одного дефолтного пароля в гите — секрет-ключи канона пусты."""
+    values = {}
+    for line in BUNDLE_ENV_EXAMPLE.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if line and not line.startswith("#") and "=" in line:
+            k, v = line.split("=", 1)
+            values[k.strip()] = v.strip()
+    for key in ("POSTGRES_PASSWORD", "SECRET_KEY", "RABBITMQ_DEFAULT_PASS",
+                "MINIO_ROOT_PASSWORD", "GITEA_ADMIN_PASSWORD"):
+        assert values.get(key, "") == "", f"{key} обязан быть пустым плейсхолдером"
+
+
+def test_no_network_mode_host_anywhere():
+    """D4: вся инсталляция в bridge-сети; network_mode: host не используется."""
+    for name, svc in _services().items():
+        assert "network_mode" not in svc, f"{name}: network_mode запрещён в bundle (D4)"
+    networks = _doc().get("networks") or {}
+    assert networks.get("default", {}).get("driver") == "bridge"
+
+
+def test_only_human_ports_are_published():
+    """D4: наружу — только орк/Plane proxy/Gitea web; БД/брокер/minio не
+    публикуются (секрет-гигиена/поверхность атаки)."""
+    publishers = {name for name, svc in _services().items() if svc.get("ports")}
+    assert publishers == {"orchestrator", "gitea", "proxy"}, (
+        f"порты публикуют {sorted(publishers)}, а разрешены только "
+        "orchestrator/gitea/proxy (D4)"
+    )
+
+
+def test_gitea_webhook_allowed_host_list_is_set():
+    """Мина TR-4: без ALLOWED_HOST_LIST Gitea молча режет вебхуки в приватные
+    адреса — «задача не появилась» гарантирован."""
+    env = _services()["gitea"].get("environment") or []
+    assert any("GITEA__webhook__ALLOWED_HOST_LIST=orchestrator" in str(e) for e in env), (
+        "gitea: GITEA__webhook__ALLOWED_HOST_LIST=orchestrator обязателен (D4/TR-4)"
+    )
+
+
+def test_platform_env_files_are_optional():
+    """D2: env_file required:false — первый `up -d` поднимает стек ДО сборки
+    runtime-конфига орка (AC-1 «одна команда»)."""
+    services = _services()
+    for name in PLATFORM_SERVICES:
+        entries = services[name].get("env_file")
+        assert isinstance(entries, list) and entries, f"{name}: env_file отсутствует"
+        assert all(e.get("required") is False for e in entries), (
+            f"{name}: env_file обязан быть required: false (D2)"
+        )
+
+
+def test_machine_traffic_uses_service_dns():
+    """D4: машинный трафик — строго сервис-DNS bundle-сети."""
+    raw = _raw()
+    assert "http://orchestrator:8500/metrics" in raw  # watchdog → орк
+    assert "plane-db" in raw and "plane-redis" in raw and "plane-mq" in raw

tests/test_bundled_setup_doc.py

@@ -0,0 +1,291 @@
+"""ORCH-103 (TC-05/06/09/10/11, AC-4/AC-9): анти-дрейф golden source
+`docs/deployment/BUNDLED_SETUP.md` + секрет-гигиена новых артефактов bundle.
+
+Зеркало паттерна `tests/test_lite_setup_doc.py` (ORCH-102 D8): 14 нормативных
+разделов ADR-001 D10 в порядке маршрута оператора; обязательные кирпичи;
+«Требования к хосту» с цифрами, синхронизированными с константами preflight
+`scripts/bootstrap_bundle.py`; каждый упомянутый env-ключ существует в канонах
+(`.env.example` ∪ `deploy/bundled/.env.example`); гигиена FORBIDDEN (импорт из
+`tests/test_no_host_hardcodes.py` — один источник истины) и секрет-эвристика
+hex>=32 / alnum>=40 по доку и всем новым артефактам; «22 статуса» — сверкой
+импорта `plane_sync._PLANE_NAME_TO_KEY`, не литералом; кросс-ссылки канона.
+Детерминировано: без сети/LLM/subprocess/docker.
+"""
+
+import importlib.util
+import re
+from pathlib import Path
+
+# Один источник истины запрещённых боевых литералов (ORCH-101 AC-7).
+from tests.test_no_host_hardcodes import FORBIDDEN
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+DOC = REPO_ROOT / "docs/deployment/BUNDLED_SETUP.md"
+LITE_SETUP = REPO_ROOT / "docs/deployment/LITE_SETUP.md"
+REPLICATION = REPO_ROOT / "docs/operations/REPLICATION.md"
+CHANGELOG = REPO_ROOT / "CHANGELOG.md"
+ENV_EXAMPLE = REPO_ROOT / ".env.example"
+BUNDLE_ENV_EXAMPLE = REPO_ROOT / "deploy/bundled/.env.example"
+BUNDLE_COMPOSE = REPO_ROOT / "deploy/bundled/docker-compose.yml"
+BOOTSTRAP = REPO_ROOT / "scripts/bootstrap_bundle.py"
+
+# Нормативная структура ADR-001 D10: 14 разделов, порядок = маршрут оператора.
+SECTIONS: tuple[str, ...] = (
+    "## 1. Рамка Bundled",
+    "## 2. Требования к хосту",
+    "## 3. Предусловия",
+    "## 4. Получение кода",
+    "## 5. Секреты",
+    "## 6. Запуск bundle-compose",
+    "## 7. Bootstrap",
+    "## 8. LLM (claude CLI)",
+    "## 9. Telegram",
+    "## 10. Онбординг следующих проектов",
+    "## 11. Smoke",
+    "## 12. Stateless-проверка",
+    "## 13. Остановка и полный сброс",
+    "## 14. Траблшутинг",
+)
+
+# Обязательные кирпичи дока (FR-4; подстроки).
+BRICKS: tuple[str, ...] = (
+    "bootstrap_bundle.py",
+    "gen_secrets.py",
+    "onboard_project.py",
+    "docker compose -f deploy/bundled/docker-compose.yml",
+    "orchestrator-bundle",
+    "/health",
+    "/queue",
+    "/metrics",
+    "Confirm Deploy",
+    "STOP",
+    "ALLOWED_HOST_LIST",
+    "14 контейнеров",
+    "Проверка",
+    "PASS",
+    "FAIL",
+)
+
+# env-токены дока: полные имена ключей платформы/bundle (анти-фантом, TC-09).
+_ENV_TOKEN_RE = re.compile(r"\b(?:ORCH|WATCHDOG|BUNDLE)_[A-Z0-9_]*[A-Z0-9]\b")
+
+# Секрет-эвристика (паттерн D8 ORCH-102): hex-run >= 32 / чистый alnum >= 40.
+_SECRET_HEX_RE = re.compile(r"\b[0-9a-fA-F]{32,}\b")
+_SECRET_ALNUM_RE = re.compile(r"\b[A-Za-z0-9]{40,}\b")
+
+
+def _doc_text() -> str:
+    assert DOC.is_file(), "docs/deployment/BUNDLED_SETUP.md отсутствует (AC-4)"
+    return DOC.read_text(encoding="utf-8")
+
+
+def _section_bodies() -> dict:
+    text = _doc_text()
+    bodies = {}
+    for i, header in enumerate(SECTIONS):
+        start = text.find(header)
+        assert start != -1, f"раздел {header!r} отсутствует (D10)"
+        end = text.find(SECTIONS[i + 1]) if i + 1 < len(SECTIONS) else len(text)
+        bodies[header] = text[start:end]
+    return bodies
+
+
+def _fenced_blocks(text: str) -> list:
+    return re.findall(r"```[^\n]*\n(.*?)```", text, flags=re.DOTALL)
+
+
+def _env_keys(path: Path) -> set:
+    keys = set()
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        keys.add(line.split("=", 1)[0].strip())
+    return keys
+
+
+def _bootstrap_module():
+    spec = importlib.util.spec_from_file_location("bootstrap_bundle", BOOTSTRAP)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+# ---------------------------------------------------------------------------
+# TC-05: 14 разделов в порядке + форма «команда + проверка» + цифры хоста.
+# ---------------------------------------------------------------------------
+def test_doc_exists_with_all_14_sections_in_order():
+    text = _doc_text()
+    positions = []
+    for header in SECTIONS:
+        idx = text.find(header)
+        assert idx != -1, f"нормативный раздел {header!r} отсутствует (D10/FR-4)"
+        positions.append(idx)
+    assert positions == sorted(positions), (
+        "разделы BUNDLED_SETUP.md идут не в порядке маршрута оператора (D10)"
+    )
+
+
+def test_doc_carries_all_mandatory_bricks():
+    text = _doc_text()
+    missing = [b for b in BRICKS if b not in text]
+    assert not missing, f"обязательные кирпичи отсутствуют (FR-4): {missing}"
+
+
+def test_every_executable_section_carries_commands():
+    """§2–§14 несут минимум одну fenced-команду; §1 (рамка) — без команд."""
+    bodies = _section_bodies()
+    for header in SECTIONS[1:]:
+        assert "```" in bodies[header], f"{header}: нет ни одной fenced-команды (D10)"
+
+
+def test_doc_carries_explicit_check_markers():
+    text = _doc_text()
+    assert text.count("Проверка") >= 13, (
+        "маркеров «Проверка» меньше, чем исполняемых разделов (форма D10)"
+    )
+    assert "PASS" in text and "FAIL" in text
+
+
+def test_host_requirements_carry_measured_numbers_synced_with_preflight():
+    """AC-4: «Требования к хосту» с явными цифрами RAM/диск/CPU и картой портов;
+    цифры = константам preflight bootstrap (D5: синхронизированы механически)."""
+    mod = _bootstrap_module()
+    body = _section_bodies()["## 2. Требования к хосту"]
+    assert f"{mod.MIN_RAM_GB} GB" in body, "цифра RAM разъехалась с MIN_RAM_GB"
+    assert f"{mod.MIN_DISK_GB} GB" in body, "цифра диска разъехалась с MIN_DISK_GB"
+    assert f"{mod.MIN_CPUS} vCPU" in body, "цифра CPU разъехалась с MIN_CPUS"
+    for port in ("8500", "8080", "3000"):
+        assert port in body, f"карта портов неполна: нет {port}"
+    assert "14 контейнеров" in body or "14 контейнеров" in _doc_text()
+
+
+def test_doc_has_stateless_normative_line():
+    low = _doc_text().lower()
+    assert "не перенос" in low, (
+        "нормативная stateless-строка («…боевого хоста НЕ переносятся») "
+        "отсутствует (AC-3)"
+    )
+    stateless = _section_bodies()["## 12. Stateless-проверка"]
+    assert "/queue" in stateless, "§12 обязан нести проверку чистоты через GET /queue"
+
+
+def test_teardown_is_documented_procedure():
+    """D9: полный сброс — документированная процедура §13 (не режим скрипта)."""
+    teardown = _section_bodies()["## 13. Остановка и полный сброс"]
+    assert "down -v" in teardown, "§13 обязан нести полный сброс (down -v)"
+    assert "НЕОБРАТИМО" in teardown or "необратим" in teardown.lower()
+
+
+def test_troubleshooting_covers_mandatory_symptoms():
+    """FR-4 п.14: webhook, RAM/OOM, порт занят, claude, миграции Plane."""
+    tr = _section_bodies()["## 14. Траблшутинг"]
+    for needle in ("ebhook", "OOM", "орт занят", "claude", "играции"):
+        assert needle in tr, f"траблшутинг не покрывает симптом: {needle!r}"
+    assert "ALLOWED_HOST_LIST" in tr  # мина Gitea — явно (D10)
+
+
+# ---------------------------------------------------------------------------
+# TC-06: гигиена новых артефактов — FORBIDDEN (импорт) + секрет-эвристика.
+# ---------------------------------------------------------------------------
+def _new_artifact_texts() -> dict:
+    return {
+        "BUNDLED_SETUP.md (fenced)": "\n".join(_fenced_blocks(_doc_text())),
+        "deploy/bundled/docker-compose.yml": BUNDLE_COMPOSE.read_text(encoding="utf-8"),
+        "deploy/bundled/.env.example": BUNDLE_ENV_EXAMPLE.read_text(encoding="utf-8"),
+        "scripts/bootstrap_bundle.py": BOOTSTRAP.read_text(encoding="utf-8"),
+    }
+
+
+def test_new_artifacts_carry_no_forbidden_literals():
+    offenders = [
+        f"{label}: {literal!r}"
+        for label, text in _new_artifact_texts().items()
+        for literal in FORBIDDEN
+        if literal in text
+    ]
+    assert not offenders, (
+        "боевые литералы в артефактах bundle (NFR-3/TC-06):\n" + "\n".join(offenders)
+    )
+
+
+def test_new_artifacts_carry_no_secret_like_values():
+    offenders = []
+    for label, text in _new_artifact_texts().items():
+        for rx in (_SECRET_HEX_RE, _SECRET_ALNUM_RE):
+            m = rx.search(text)
+            if m is not None:
+                offenders.append(f"{label}: {m.group(0)[:16]}…")
+    assert not offenders, (
+        "секретоподобные значения в артефактах bundle (NFR-3):\n" + "\n".join(offenders)
+    )
+
+
+def test_secret_heuristic_is_not_evergreen():
+    """Негативный самочек (паттерн ORCH-101/102): эвристика реально ловит."""
+    assert _SECRET_HEX_RE.search("KEY=" + "0fa1" * 16) is not None
+    assert _SECRET_ALNUM_RE.search("token" + "Ab1" * 15) is not None
+    assert _SECRET_HEX_RE.search("curl -fsS http://127.0.0.1:8500/health") is None
+    assert _SECRET_ALNUM_RE.search("<ORCHESTRATOR_GIT_URL> $ORCH_PLANE_API_TOKEN") is None
+
+
+# ---------------------------------------------------------------------------
+# TC-09: env-канон без фантомов + число статусов сверкой импорта.
+# ---------------------------------------------------------------------------
+def test_every_env_token_in_doc_exists_in_canons():
+    canon = _env_keys(ENV_EXAMPLE) | _env_keys(BUNDLE_ENV_EXAMPLE)
+    mentioned = set(_ENV_TOKEN_RE.findall(_doc_text()))
+    assert mentioned, "в BUNDLED_SETUP.md не упомянут ни один env-ключ — док не полон"
+    unknown = sorted(mentioned - canon)
+    assert not unknown, (
+        f"ключи из BUNDLED_SETUP.md отсутствуют в канонах (.env.example ∪ "
+        f"deploy/bundled/.env.example) — опечатка или дрейф (TC-09): {unknown}"
+    )
+
+
+def test_status_count_claim_matches_plane_sync():
+    """«22 статуса» держится фактическим маппингом src/plane_sync.py (AC-7:
+    сверка импортом, не строковой копией)."""
+    from src.plane_sync import _PLANE_NAME_TO_KEY
+
+    assert len(_PLANE_NAME_TO_KEY) == 22, (
+        "число статусов в plane_sync изменилось — обнови BUNDLED_SETUP.md §7 "
+        "(и ONBOARDING.md §1)"
+    )
+    assert "Confirm Deploy" in _PLANE_NAME_TO_KEY
+    assert "STOP" in _PLANE_NAME_TO_KEY
+    assert "22" in _doc_text(), "число статусов в BUNDLED_SETUP.md разъехалось с plane_sync"
+
+
+# ---------------------------------------------------------------------------
+# TC-10: канон не форкается — кросс-ссылки; REPLICATION §1 отмечает Type B.
+# ---------------------------------------------------------------------------
+def test_doc_links_canons_instead_of_forking():
+    text = _doc_text()
+    for canon in ("LITE_SETUP.md", "ONBOARDING.md", "REPLICATION.md"):
+        assert canon in text, f"BUNDLED_SETUP.md не ссылается на канон {canon} (FR-4)"
+    bodies = _section_bodies()
+    assert "LITE_SETUP.md" in bodies["## 8. LLM (claude CLI)"], "§8 — ссылкой на LITE_SETUP §7"
+    assert "LITE_SETUP.md" in bodies["## 9. Telegram"], "§9 — ссылкой на LITE_SETUP §8"
+    assert "ONBOARDING.md" in bodies["## 10. Онбординг следующих проектов"]
+    assert "REPLICATION.md" in bodies["## 11. Smoke"], "smoke — на REPLICATION §4, без форка"
+
+
+def test_replication_marks_type_b_done():
+    text = REPLICATION.read_text(encoding="utf-8")
+    assert "BUNDLED_SETUP.md" in text, (
+        "REPLICATION.md §1 обязан ссылаться на BUNDLED_SETUP.md (Type B реализован)"
+    )
+    assert "ORCH-103" in text, "строка Type B в REPLICATION.md §1 не отмечена ✅ ORCH-103"
+
+
+def test_lite_setup_untouched_reference_exists():
+    """Канон Lite остаётся на месте (Bundled его дополняет, не заменяет)."""
+    assert LITE_SETUP.is_file()
+
+
+# ---------------------------------------------------------------------------
+# TC-11: CHANGELOG.
+# ---------------------------------------------------------------------------
+def test_changelog_has_orch_103_entry():
+    assert "ORCH-103" in CHANGELOG.read_text(encoding="utf-8")

tests/test_deploy_hook_rollback_sim.py

@@ -79,17 +79,17 @@ exit 0
     # by the hook's sleep args; here we only assert the rollback CONTROL FLOW).
     _write_exec(str(binx / "sleep"), "#!/bin/bash\nexit 0\n")
 
-    # Copy the hook, repointing REPO to the sandbox (avoids the hardcoded prod path).
+    # Copy the hook verbatim and repoint REPO via the env-override — the SAME
+    # contract the wired invokers use since ORCH-101 (D7: REPO="${REPO:-…}");
+    # no text rewrite needed, so the simulation also proves the override works.
     hook_text = open(HOOK, encoding="utf-8").read()
-    hook_text = hook_text.replace(
-        "REPO=/home/slin/repos/orchestrator", f"REPO={repo}"
-    )
     hook_copy = tmp_path / "hook.sh"
     _write_exec(str(hook_copy), hook_text)
 
     env = {
         **os.environ,
         "PATH": f"{binx}:{os.environ['PATH']}",
+        "REPO": str(repo),
         "LOG": str(state / "hook.log"),
         "PREV_IMAGE_FILE": str(state / "prev-image"),
         "COMPOSE_PROFILE": "staging",

tests/test_host_config_keys.py

@@ -0,0 +1,264 @@
+"""ORCH-101 (TC-03/TC-04/TC-05/TC-11, AC-1/AC-2/AC-8): host values come from
+Settings, defaults equal the previous production literals, and the ORCH-058
+anti-prod invariant is an executable guard.
+
+Functional where the seam allows (launcher.agent_git_env, plane_sync link
+build, image_freshness guard — monkeypatch, no network), structural where the
+env dict is built inline inside a never-raise actor (self_deploy/post_deploy:
+the scanner in test_no_host_hardcodes.py already proves the literals are gone;
+here we pin that the replacement reads the RIGHT Settings keys).
+"""
+
+from pathlib import Path
+
+from src.config import Settings, settings
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+
+
+# ---------------------------------------------------------------------------
+# AC-2 / BR-5: defaults of the new keys equal the previous hardcoded values.
+# Judged on the class fields (immune to ambient env / .env of the test host).
+# ---------------------------------------------------------------------------
+def test_new_settings_defaults_equal_previous_production_values():
+    fields = Settings.model_fields
+    assert fields["agent_home_dir"].default == "/home/slin"
+    assert fields["agent_git_name"].default == "claude-bot"
+    assert fields["git_email_domain"].default == "mva154.local"
+    assert fields["staging_port"].default == 8501
+    # Registry E (BR-5): pre-existing defaults are NOT changed by ORCH-101.
+    assert fields["deploy_prod_target_port"].default == 8500
+    assert fields["deploy_host_repo_path"].default == "/home/slin/repos/orchestrator"
+    assert fields["host_repos_dir"].default == "/home/slin/repos"
+    assert fields["deploy_ssh_user"].default == "slin"
+    assert fields["gitea_owner"].default == "admin"
+
+
+# ---------------------------------------------------------------------------
+# TC-04: launcher.agent_git_env — single Settings-driven source for BOTH the
+# agent Popen and the post-run git commit/push.
+# ---------------------------------------------------------------------------
+def test_agent_git_env_reads_settings(monkeypatch):
+    from src.agents import launcher
+
+    monkeypatch.setattr(launcher.settings, "agent_home_dir", "/home/deploy")
+    monkeypatch.setattr(launcher.settings, "agent_git_name", "robo-bot")
+    monkeypatch.setattr(launcher.settings, "git_email_domain", "newhost.example")
+    env = launcher.agent_git_env()
+    assert env["HOME"] == "/home/deploy"
+    assert env["GIT_AUTHOR_NAME"] == "robo-bot"
+    assert env["GIT_COMMITTER_NAME"] == "robo-bot"
+    assert env["GIT_AUTHOR_EMAIL"] == "robo-bot@newhost.example"
+    assert env["GIT_COMMITTER_EMAIL"] == "robo-bot@newhost.example"
+
+
+def test_agent_git_env_default_identity_matches_previous_hardcode(monkeypatch):
+    from src.agents import launcher
+
+    # Pin the resolved values to the class defaults (ambient-env immune).
+    monkeypatch.setattr(launcher.settings, "agent_home_dir", "/home/slin")
+    monkeypatch.setattr(launcher.settings, "agent_git_name", "claude-bot")
+    monkeypatch.setattr(launcher.settings, "git_email_domain", "mva154.local")
+    env = launcher.agent_git_env()
+    assert env["HOME"] == "/home/slin"
+    assert env["GIT_AUTHOR_EMAIL"] == "claude-bot@mva154.local"
+    assert env["GIT_COMMITTER_EMAIL"] == "claude-bot@mva154.local"
+
+
+def test_agent_git_env_preserves_ambient_environ(monkeypatch):
+    from src.agents import launcher
+
+    monkeypatch.setenv("ORCH101_CANARY", "yes")
+    assert launcher.agent_git_env()["ORCH101_CANARY"] == "yes"
+
+
+def test_both_launcher_sites_use_the_helper():
+    """Structural: the Popen env AND the post-run git env share one source."""
+    src = (REPO_ROOT / "src/agents/launcher.py").read_text(encoding="utf-8")
+    assert "env=agent_git_env()" in src  # agent Popen site
+    assert "git_env = agent_git_env()" in src  # post-run commit/push site
+
+
+# ---------------------------------------------------------------------------
+# TC-05: system actors (deploy-finalizer / post-deploy-monitor) — HOME + email
+# domain from Settings, actor NAMES stay platform literals (ADR-001 D2).
+# ---------------------------------------------------------------------------
+def test_system_actor_envs_read_settings():
+    sd = (REPO_ROOT / "src/self_deploy.py").read_text(encoding="utf-8")
+    pd = (REPO_ROOT / "src/post_deploy.py").read_text(encoding="utf-8")
+    for source, actor in ((sd, "deploy-finalizer"), (pd, "post-deploy-monitor")):
+        assert '"HOME": settings.agent_home_dir' in source
+        assert f'f"{actor}@{{settings.git_email_domain}}"' in source
+        assert f'"GIT_AUTHOR_NAME": "{actor}"' in source  # platform literal kept
+
+
+# ---------------------------------------------------------------------------
+# TC-03: plane_sync.notify_stage_change builds links from Settings
+# (gitea_public_url fallback gitea_url + gitea_owner). No network: every
+# outbound seam is monkeypatched.
+# ---------------------------------------------------------------------------
+def _capture_stage_change_msg(monkeypatch, new_stage="development"):
+    import src.db as db
+    from src import plane_sync
+
+    monkeypatch.setattr(plane_sync, "_resolve_project_id", lambda wi, pid=None: "proj")
+    monkeypatch.setattr(plane_sync, "update_issue_state", lambda *a, **k: None)
+    sent = {}
+    monkeypatch.setattr(
+        plane_sync, "add_comment",
+        lambda wi, msg, pid=None, author=None: sent.setdefault("msg", msg),
+    )
+
+    class _Cursor:
+        def fetchone(self):
+            return ("feature/ORCH-1-demo", "demo-repo")
+
+    class _Conn:
+        def execute(self, *a):
+            return _Cursor()
+
+        def close(self):
+            pass
+
+    monkeypatch.setattr(db, "get_db", lambda: _Conn())
+    plane_sync.notify_stage_change("ORCH-1", "analysis", new_stage)
+    return sent["msg"]
+
+
+def test_stage_change_link_uses_public_url_and_owner(monkeypatch):
+    from src import plane_sync
+
+    monkeypatch.setattr(plane_sync.settings, "gitea_public_url", "https://git.example.org/")
+    monkeypatch.setattr(plane_sync.settings, "gitea_owner", "acme")
+    msg = _capture_stage_change_msg(monkeypatch)
+    assert "https://git.example.org/acme/demo-repo/src/branch/feature/ORCH-1-demo" in msg
+    assert "mva154" not in msg and "duckdns" not in msg
+    assert "/admin/" not in msg  # the hardcoded owner is gone
+
+
+def test_stage_change_link_falls_back_to_gitea_url(monkeypatch):
+    from src import plane_sync
+
+    monkeypatch.setattr(plane_sync.settings, "gitea_public_url", "")
+    monkeypatch.setattr(plane_sync.settings, "gitea_url", "http://gitea.lan:3000")
+    monkeypatch.setattr(plane_sync.settings, "gitea_owner", "owner1")
+    msg = _capture_stage_change_msg(monkeypatch)
+    assert "http://gitea.lan:3000/owner1/demo-repo/src/branch/" in msg
+
+
+def test_stage_change_hardcoded_base_removed_from_source():
+    src = (REPO_ROOT / "src/plane_sync.py").read_text(encoding="utf-8")
+    assert "git.mva154.duckdns.org" not in src
+    assert 'gitea_base + "/admin/"' not in src
+
+
+# ---------------------------------------------------------------------------
+# TC-11 / AC-8: ORCH-058 invariant — the freshness path can never be aimed at
+# the prod target. staging_port is a config key (default 8501) WITH a
+# fail-closed guard; service/profile names stay platform constants.
+# ---------------------------------------------------------------------------
+def test_staging_port_guard_refuses_prod_port(monkeypatch):
+    from src import image_freshness as imf
+
+    monkeypatch.setattr(imf.settings, "image_freshness_enabled", True)
+    monkeypatch.setattr(imf.settings, "image_freshness_repos", "")
+    monkeypatch.setattr(imf.settings, "staging_port", 8500)
+    monkeypatch.setattr(imf.settings, "deploy_prod_target_port", 8500)
+    ok, reason = imf.check_staging_image_fresh("orchestrator", "ORCH-1", "feature/x")
+    assert ok is False
+    assert "misconfiguration" in reason and "ORCH-058" in reason
+    assert "refused" in reason  # loud refusal, no silent 8501 fallback
+
+
+def test_staging_port_default_passes_guard(monkeypatch, tmp_path):
+    from src import image_freshness as imf
+
+    monkeypatch.setattr(imf.settings, "image_freshness_enabled", True)
+    monkeypatch.setattr(imf.settings, "image_freshness_repos", "")
+    monkeypatch.setattr(imf.settings, "staging_port", 8501)
+    monkeypatch.setattr(imf.settings, "deploy_prod_target_port", 8500)
+    # Point the worktree somewhere empty: the check must get PAST the guard and
+    # fail-close later on the missing validated revision (proves the guard
+    # itself did not fire on the default 8501/8500 split).
+    monkeypatch.setattr(imf.settings, "worktrees_dir", str(tmp_path / "none"))
+    monkeypatch.setattr(imf.settings, "repos_dir", str(tmp_path / "none"))
+    ok, reason = imf.check_staging_image_fresh("orchestrator", "ORCH-1", "feature/x")
+    assert ok is False
+    assert "misconfiguration" not in reason
+    assert "validated revision" in reason
+
+
+def test_staging_service_names_stay_platform_constants():
+    from src import image_freshness as imf
+
+    assert imf._STAGING_SERVICE == "orchestrator-staging"
+    assert imf._STAGING_COMPOSE_PROFILE == "staging"
+
+
+def test_rebuild_staging_passes_configured_port_and_repo(monkeypatch):
+    """D4+D7: the wired path passes TARGET_PORT from settings.staging_port and
+    REPO from settings.deploy_host_repo_path EXPLICITLY (explicit-pass
+    discipline of ORCH-058 kept; config is the single truth on the wired path)."""
+    from src import image_freshness as imf
+
+    monkeypatch.setattr(imf.settings, "deploy_ssh_user", "u")
+    monkeypatch.setattr(imf.settings, "deploy_ssh_host", "127.0.0.1")
+    monkeypatch.setattr(imf.settings, "staging_port", 9501)
+    monkeypatch.setattr(imf.settings, "deploy_host_repo_path", "/srv/orchestrator")
+    captured = {}
+
+    class _R:
+        returncode = 0
+        stdout = ""
+        stderr = ""
+
+    def fake_run(cmd, **kw):
+        captured["cmd"] = cmd
+        return _R()
+
+    monkeypatch.setattr(imf.subprocess, "run", fake_run)
+    ok, _ = imf.rebuild_staging_image("orchestrator", "feature/x", "abc1234")
+    assert ok is True
+    inner = captured["cmd"][-1]
+    assert "TARGET_PORT=9501" in inner
+    assert "REPO=/srv/orchestrator" in inner
+    assert "TARGET_SERVICE=orchestrator-staging" in inner
+
+
+def test_build_deploy_command_passes_repo_explicitly(monkeypatch):
+    """D7: the detached prod deploy passes REPO= so the hook env-override is
+    actually exercised on a parametrised host (hook default = manual runs only)."""
+    from src import self_deploy
+
+    monkeypatch.setattr(self_deploy.settings, "deploy_ssh_user", "u")
+    monkeypatch.setattr(self_deploy.settings, "deploy_ssh_host", "127.0.0.1")
+    monkeypatch.setattr(self_deploy.settings, "deploy_host_repo_path", "/srv/orchestrator")
+    cmd = self_deploy.build_deploy_command("orchestrator", "ORCH-101", "feature/x")
+    remote = cmd[-1]
+    assert "REPO=/srv/orchestrator" in remote
+    # Exit-code contract untouched: the hook is still invoked with --deploy and
+    # the wrapper still writes the result sentinel.
+    assert "--deploy" in remote and "echo $?" in remote
+
+
+# ---------------------------------------------------------------------------
+# ADR-001 D3 anti-drift: SELF_HOSTING_REPO is a PLATFORM CONSTANT (a tirage
+# convention — the platform repo MUST be named `orchestrator`), NOT a config key.
+# ---------------------------------------------------------------------------
+def test_self_hosting_repo_is_platform_constant():
+    from src.qg.checks import SELF_HOSTING_REPO, is_self_hosting_repo
+
+    assert SELF_HOSTING_REPO == "orchestrator"
+    assert is_self_hosting_repo("orchestrator") is True
+    assert is_self_hosting_repo("enduro-trails") is False
+    # NOT configurable: no Settings key may claim this fact (D3 — a typo would
+    # either aim deploy machinery at a foreign repo or mute all self-gates).
+    assert "self_hosting_repo" not in Settings.model_fields
+
+
+def test_settings_instance_importable():
+    """The shared settings instance carries the new keys (smoke)."""
+    assert hasattr(settings, "agent_home_dir")
+    assert hasattr(settings, "agent_git_name")
+    assert hasattr(settings, "git_email_domain")
+    assert hasattr(settings, "staging_port")

tests/test_infra_parametrization.py

@@ -0,0 +1,261 @@
+"""ORCH-101 (TC-06/TC-07/TC-08, AC-2/AC-5/AC-6): structural checks of the
+infra-file parametrization — docker-compose.yml interpolation, Dockerfile ARGs,
+deploy-hook env-override and .env.example completeness.
+
+Every ${VAR:-default} default must equal the previous production value, so an
+empty environment resolves byte-for-byte to the pre-ORCH-101 configuration
+(BR-5 zero-regression). The ORCH-040 group (uid/gid/HOME/mount targets/
+useradd) must move as ONE coherent set of variables, and the docker-gid
+group_add («МИНА 1») must stay on all three services.
+"""
+
+import re
+from pathlib import Path
+
+import yaml
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+COMPOSE = REPO_ROOT / "docker-compose.yml"
+DOCKERFILE = REPO_ROOT / "Dockerfile"
+HOOK = REPO_ROOT / "scripts/orchestrator-deploy-hook.sh"
+ENV_EXAMPLE = REPO_ROOT / ".env.example"
+
+# The normative interpolation map (ADR-001 D6): variable -> default that MUST
+# equal the previous hardcoded production value.
+EXPECTED_DEFAULTS = {
+    "ORCH_HOST_REPOS_DIR": "/home/slin/repos",
+    "ORCH_HOST_CLAUDE_DIR": "/home/slin/.claude",
+    "ORCH_HOST_CLAUDE_JSON": "/home/slin/.claude.json",
+    "ORCH_HOST_SSH_DIR": "/home/slin/.orchestrator-ssh",
+    "ORCH_AGENT_HOME_DIR": "/home/slin",
+    "ORCH_HOST_CLAUDE_CODE_DIR": "/usr/lib/node_modules/@anthropic-ai/claude-code",
+    "ORCH_HOST_NODE_BIN": "/usr/bin/node",
+    "ORCH_DOCKER_GID": "999",
+    "ORCH_RUN_UID": "1000",
+    "ORCH_RUN_GID": "1000",
+    "ORCH_DEPLOY_SSH_USER": "slin",
+    "ORCH_DEPLOY_HOST_REPO_PATH": "/home/slin/repos/orchestrator",
+    "DEPLOY_HOOK_SCRIPT": "/home/slin/bin/enduro-deploy-hook.sh",
+    "ORCH_STAGING_PORT": "8501",
+    "ORCH_DEPLOY_PROD_TARGET_PORT": "8500",
+}
+
+_INTERP_RE = re.compile(r"\$\{([A-Z0-9_]+):-([^}]*)\}")
+
+
+def _compose_raw() -> str:
+    return COMPOSE.read_text(encoding="utf-8")
+
+
+def _compose_code_lines() -> list[tuple[int, str]]:
+    """Compose lines with comment-only lines dropped (comments are prose, not
+    configuration — the interpolation contract is judged on values)."""
+    out = []
+    for lineno, line in enumerate(_compose_raw().splitlines(), 1):
+        if line.strip().startswith("#"):
+            continue
+        out.append((lineno, line))
+    return out
+
+
+def _compose_services() -> dict:
+    return yaml.safe_load(_compose_raw())["services"]
+
+
+# ---------------------------------------------------------------------------
+# TC-06: compose interpolation + defaults == current values + ORCH-040 group.
+# ---------------------------------------------------------------------------
+def test_compose_interpolation_defaults_match_production_values():
+    found: dict[str, set[str]] = {}
+    for _, line in _compose_code_lines():
+        for var, default in _INTERP_RE.findall(line):
+            found.setdefault(var, set()).add(default)
+    # Every expected variable interpolates somewhere, with EXACTLY the expected
+    # default, and consistently (one default per variable across the file).
+    for var, expected in EXPECTED_DEFAULTS.items():
+        assert var in found, f"{var} is not interpolated in docker-compose.yml"
+        assert found[var] == {expected}, (
+            f"{var}: defaults {found[var]} != expected {{{expected!r}}}"
+        )
+    # No stray interpolations outside the normative map (single point of truth).
+    unknown = set(found) - set(EXPECTED_DEFAULTS)
+    assert not unknown, f"unmapped compose variables: {unknown}"
+
+
+def test_compose_no_raw_host_paths_outside_interpolation_defaults():
+    """Registry B closed: after stripping ${VAR:-default} expressions and
+    comments, no /home/slin (or node/claude-code host path) literal remains."""
+    leftovers = []
+    for lineno, line in _compose_code_lines():
+        code = _INTERP_RE.sub("", line)
+        # NB: /usr/bin/node is NOT a needle — the mount TARGET inside the
+        # container is a layout convention and legitimately stays literal.
+        for needle in ("/home/slin", "/usr/lib/node_modules"):
+            if needle in code:
+                leftovers.append(f"{lineno}: {line.strip()}")
+    assert not leftovers, "raw host paths left in compose:\n" + "\n".join(leftovers)
+
+
+def test_compose_group_add_docker_gid_on_all_three_services():
+    """ORCH-040 «МИНА 1»: group_add stays on every service, parametrised."""
+    services = _compose_services()
+    assert set(services) == {"orchestrator", "orchestrator-watchdog", "orchestrator-staging"}
+    for name, svc in services.items():
+        group_add = svc.get("group_add")
+        assert group_add == ["${ORCH_DOCKER_GID:-999}"], (
+            f"{name}: group_add must carry the parametrised docker gid, got {group_add}"
+        )
+
+
+def test_compose_uid_gid_home_move_as_one_group():
+    """ORCH-040 coherence: runtime user:, build args and mount targets read the
+    SAME variables, so uid/gid/HOME can only move together."""
+    services = _compose_services()
+    for name in ("orchestrator", "orchestrator-staging"):
+        svc = services[name]
+        assert svc["user"] == "${ORCH_RUN_UID:-1000}:${ORCH_RUN_GID:-1000}", name
+        args = svc["build"]["args"]
+        assert args["APP_UID"] == "${ORCH_RUN_UID:-1000}", name
+        assert args["APP_GID"] == "${ORCH_RUN_GID:-1000}", name
+        assert args["APP_HOME"] == "${ORCH_AGENT_HOME_DIR:-/home/slin}", name
+        volumes = svc["volumes"]
+        home = "${ORCH_AGENT_HOME_DIR:-/home/slin}"
+        assert f"${{ORCH_HOST_CLAUDE_DIR:-/home/slin/.claude}}:{home}/.claude" in volumes, name
+        assert f"${{ORCH_HOST_SSH_DIR:-/home/slin/.orchestrator-ssh}}:{home}/.ssh:ro" in volumes, name
+
+
+def test_compose_ports_parametrised_with_current_defaults():
+    services = _compose_services()
+    prod_cmd = services["orchestrator"]["command"]
+    staging_cmd = services["orchestrator-staging"]["command"]
+    # D5: prod reuses the existing ORCH_DEPLOY_PROD_TARGET_PORT (one truth);
+    # D4: staging reuses the Settings-shared ORCH_STAGING_PORT.
+    assert prod_cmd[-1] == "${ORCH_DEPLOY_PROD_TARGET_PORT:-8500}"
+    assert staging_cmd[-1] == "${ORCH_STAGING_PORT:-8501}"
+    assert prod_cmd[:2] == ["uvicorn", "src.main:app"]
+    assert staging_cmd[:2] == ["uvicorn", "src.main:app"]
+
+
+def test_compose_container_layout_paths_stay_constant():
+    """Container-side paths are a layout convention, not host values (D6)."""
+    services = _compose_services()
+    for name in ("orchestrator", "orchestrator-staging"):
+        volumes = services[name]["volumes"]
+        assert any(v.endswith(":/repos") for v in volumes), name
+        assert any(v.endswith(":/opt/claude-code:ro") for v in volumes), name
+        env = services[name]["environment"]
+        assert "ORCH_REPOS_DIR=/repos" in env, name
+
+
+# ---------------------------------------------------------------------------
+# TC-07: Dockerfile — useradd via ARG with production defaults; CMD untouched.
+# ---------------------------------------------------------------------------
+def test_dockerfile_useradd_parametrised_via_args():
+    text = DOCKERFILE.read_text(encoding="utf-8")
+    assert "ARG APP_UID=1000" in text
+    assert "ARG APP_GID=1000" in text
+    assert "ARG APP_USER=slin" in text
+    assert "ARG APP_HOME=/home/slin" in text
+    useradd = next(
+        line for line in text.splitlines()
+        if line.startswith("RUN") and "useradd" in line
+    )
+    for ref in ("${APP_UID}", "${APP_GID}", "${APP_HOME}", "${APP_USER}"):
+        assert ref in useradd, f"useradd does not use {ref}"
+    assert "/home/slin" not in useradd  # the literal moved into the ARG default
+
+
+def test_dockerfile_cmd_stays_exec_form_8500():
+    """ADR-001 D5: CMD keeps the documented exec-form 8500 default (PID-1 /
+    signal semantics of init:true + exec-form preserved); the prod port is
+    parametrised on the compose layer instead."""
+    text = DOCKERFILE.read_text(encoding="utf-8")
+    assert 'CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8500"]' in text
+
+
+# ---------------------------------------------------------------------------
+# TC-08: deploy-hook env-override + .env.example completeness.
+# ---------------------------------------------------------------------------
+def test_deploy_hook_repo_is_env_overridable():
+    text = HOOK.read_text(encoding="utf-8")
+    assert 'REPO="${REPO:-/home/slin/repos/orchestrator}"' in text
+    # The old unconditional assignment is gone.
+    assert "\nREPO=/home/slin/repos/orchestrator\n" not in text
+
+
+def _env_example_keys() -> dict[str, str]:
+    keys: dict[str, str] = {}
+    for line in ENV_EXAMPLE.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        k, v = line.split("=", 1)
+        keys[k.strip()] = v.strip()
+    return keys
+
+
+# Keys an operator must see when provisioning a new host: the new ORCH-101
+# parametrization keys + the start-mandatory identity/secret keys (FR-4.4).
+NEW_KEYS = (
+    "ORCH_AGENT_HOME_DIR",
+    "ORCH_AGENT_GIT_NAME",
+    "ORCH_GIT_EMAIL_DOMAIN",
+    "ORCH_STAGING_PORT",
+    "ORCH_HOST_REPOS_DIR",
+    "ORCH_HOST_CLAUDE_DIR",
+    "ORCH_HOST_CLAUDE_JSON",
+    "ORCH_HOST_SSH_DIR",
+    "ORCH_HOST_CLAUDE_CODE_DIR",
+    "ORCH_HOST_NODE_BIN",
+    "ORCH_DOCKER_GID",
+    "ORCH_RUN_UID",
+    "ORCH_RUN_GID",
+    "ORCH_DEPLOY_PROD_TARGET_PORT",  # pre-existing, reused by compose command:
+)
+START_MANDATORY_KEYS = (
+    "ORCH_PLANE_API_URL",
+    "ORCH_PLANE_API_TOKEN",
+    "ORCH_PLANE_WORKSPACE_SLUG",
+    "ORCH_PLANE_WEBHOOK_SECRET",
+    "ORCH_GITEA_URL",
+    "ORCH_GITEA_PUBLIC_URL",
+    "ORCH_GITEA_TOKEN",
+    "ORCH_GITEA_WEBHOOK_SECRET",
+    "ORCH_GITEA_OWNER",
+    "ORCH_TELEGRAM_BOT_TOKEN",
+    "ORCH_TELEGRAM_CHAT_ID",
+    "ORCH_PROJECTS_JSON",
+)
+SECRET_KEYS = (
+    "ORCH_PLANE_API_TOKEN",
+    "ORCH_PLANE_WEBHOOK_SECRET",
+    "ORCH_GITEA_TOKEN",
+    "ORCH_GITEA_WEBHOOK_SECRET",
+    "ORCH_TELEGRAM_BOT_TOKEN",
+    "WATCHDOG_TG_BOT_TOKEN",
+)
+
+
+def test_env_example_contains_all_new_keys():
+    keys = _env_example_keys()
+    missing = [k for k in NEW_KEYS if k not in keys]
+    assert not missing, f".env.example is missing new ORCH-101 keys: {missing}"
+    # Defaults documented in .env.example match the compose interpolation map.
+    for var, expected in EXPECTED_DEFAULTS.items():
+        if var in keys and var not in ("DEPLOY_HOOK_SCRIPT",):
+            assert keys[var] in ("", expected), (
+                f".env.example {var}={keys[var]!r} contradicts default {expected!r}"
+            )
+
+
+def test_env_example_contains_start_mandatory_keys():
+    keys = _env_example_keys()
+    missing = [k for k in START_MANDATORY_KEYS if k not in keys]
+    assert not missing, f".env.example is missing start-mandatory keys: {missing}"
+
+
+def test_env_example_secrets_are_placeholders_only():
+    keys = _env_example_keys()
+    for k in SECRET_KEYS:
+        value = keys.get(k, "")
+        assert value == "", f"{k} must be an empty placeholder in git, got {value!r}"

tests/test_lite_setup_doc.py

@@ -0,0 +1,428 @@
+"""ORCH-102 (FR-6 / AC-1, AC-2, AC-3, AC-6): анти-дрейф контур Lite-тиража.
+
+Структурные проверки golden source `docs/deployment/LITE_SETUP.md` (ADR-001 D8,
+образец — `tests/test_replication_smoke.py`): док существует и несёт 13
+нормативных разделов D2 в порядке маршрута оператора; обязательные кирпичи
+(TC-02); key-sync `.env.watchdog.example` ⇄ блок `WATCHDOG_*` `.env.example`
+(TC-02b, D5); каждый упомянутый в доке env-ключ существует в `.env.example`
+(TC-03, анти-опечатка); compose-подмножество — ровно орк+watchdog по дефолту,
+staging строго за профилем, никаких Plane/Gitea-сервисов (TC-04, D4);
+stateless-норматив и секрет-гигиена fenced-блоков (TC-05, FORBIDDEN —
+импорт из `tests/test_no_host_hardcodes.py`, не копия); канон не форкается —
+статусы/env/smoke ссылками, fail-closed имена явно (TC-06, D3); инварианты
+Gitea-раздела (TC-07); перекрёстность REPLICATION→LITE_SETUP + CHANGELOG
+(TC-08). Детерминировано: без сети/LLM/subprocess (NFR/TR-7 — ассерты только
+на стабильное: заголовки, подстроки-кирпичи, парсинг ключей, yaml.safe_load).
+"""
+
+import re
+from pathlib import Path
+
+import yaml
+
+# Один источник истины запрещённых боевых литералов (ADR-001 D8 / ORCH-101 AC-7).
+from tests.test_no_host_hardcodes import FORBIDDEN
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+LITE_SETUP = REPO_ROOT / "docs/deployment/LITE_SETUP.md"
+REPLICATION = REPO_ROOT / "docs/operations/REPLICATION.md"
+CHANGELOG = REPO_ROOT / "CHANGELOG.md"
+ENV_EXAMPLE = REPO_ROOT / ".env.example"
+ENV_WATCHDOG_EXAMPLE = REPO_ROOT / ".env.watchdog.example"
+COMPOSE = REPO_ROOT / "docker-compose.yml"
+
+# Нормативная структура D2: фиксированная нумерация, порядок = маршрут оператора.
+SECTIONS: tuple[str, ...] = (
+    "## 1. Рамка Lite",
+    "## 2. Предусловия хоста",
+    "## 3. Перенос кода",
+    "## 4. Конфигурация",
+    "## 5. Подключение Plane",
+    "## 6. Подключение Gitea",
+    "## 7. LLM (claude CLI)",
+    "## 8. Telegram",
+    "## 9. Запуск",
+    "## 10. Регистрация проекта",
+    "## 11. Smoke",
+    "## 12. Stateless-проверка",
+    "## 13. Траблшутинг",
+)
+
+# Обязательные кирпичи FR-6.1 (подстроки; TC-02).
+BRICKS: tuple[str, ...] = (
+    "gen_secrets.py",
+    "onboard_project.py",
+    "docker compose",
+    "/health",
+    "/queue",
+    "/metrics",
+    "ORCH_PROJECTS_JSON",
+    "ORCH_PLANE_WEBHOOK_SECRET",
+    "ORCH_GITEA_WEBHOOK_SECRET",
+    "X-Plane-Signature",
+    "X-Gitea-Signature",
+    "getent group docker",
+    "Confirm Deploy",
+    "STOP",
+    "ORCH_TELEGRAM_BOT_TOKEN",   # канал трекера орка
+    "WATCHDOG_TG_BOT_TOKEN",     # независимый канал sidecar-watchdog (C-1 ORCH-100)
+    "PASS",
+    "FAIL",
+    "Проверка",
+)
+
+# Обязательный набор ключей нового хоста, упоминаемый в доке ЯВНО (TC-03 / FR-1.4).
+MANDATORY_NEW_HOST_KEYS: tuple[str, ...] = (
+    "ORCH_PROJECTS_JSON",
+    "ORCH_PLANE_WEBHOOK_SECRET",
+    "ORCH_GITEA_WEBHOOK_SECRET",
+    "ORCH_PLANE_API_TOKEN",
+    "ORCH_GITEA_TOKEN",
+    "ORCH_TELEGRAM_BOT_TOKEN",
+    "ORCH_TELEGRAM_CHAT_ID",
+    "WATCHDOG_TG_BOT_TOKEN",
+    "WATCHDOG_TG_CHAT_ID",
+)
+
+# env-токен в доке: полное имя ключа, не заканчивающееся на «_» (glob-упоминания
+# вида ORCH_FOO_* в доке запрещены формой D2 — пишутся полные имена).
+_ENV_TOKEN_RE = re.compile(r"\b(?:ORCH|WATCHDOG)_[A-Z0-9_]*[A-Z0-9]\b")
+
+# Секретоподобные значения в копируемых блоках (TC-05, эвристика D8):
+# hex-run >= 32 симв. (token_hex) либо чистый alnum-run >= 40 симв. (токены ботов
+# и т.п.); плейсхолдеры <...>/$ENV_VAR под эти классы не попадают.
+_SECRET_HEX_RE = re.compile(r"\b[0-9a-fA-F]{32,}\b")
+_SECRET_ALNUM_RE = re.compile(r"\b[A-Za-z0-9]{40,}\b")
+
+
+# ---------------------------------------------------------------------------
+# helpers
+# ---------------------------------------------------------------------------
+def _doc_text() -> str:
+    assert LITE_SETUP.is_file(), "docs/deployment/LITE_SETUP.md отсутствует (AC-1)"
+    return LITE_SETUP.read_text(encoding="utf-8")
+
+
+def _env_keys(path: Path) -> set[str]:
+    """Множество ключей `KEY=` файла env-канона (комментарии/пустые — мимо)."""
+    keys: set[str] = set()
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        keys.add(line.split("=", 1)[0].strip())
+    return keys
+
+
+def _env_values(path: Path) -> dict[str, str]:
+    """Словарь `KEY -> value` файла env-канона."""
+    values: dict[str, str] = {}
+    for line in path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        k, v = line.split("=", 1)
+        values[k.strip()] = v.strip()
+    return values
+
+
+def _fenced_blocks(text: str) -> list[str]:
+    """Содержимое fenced code blocks — единственная копируемая зона дока (D2/D8)."""
+    return re.findall(r"```[^\n]*\n(.*?)```", text, flags=re.DOTALL)
+
+
+def _section_bodies() -> dict[str, str]:
+    """Тело каждого нормативного раздела (от заголовка до следующего `## `)."""
+    text = _doc_text()
+    bodies: dict[str, str] = {}
+    for i, header in enumerate(SECTIONS):
+        start = text.find(header)
+        assert start != -1, f"раздел {header!r} отсутствует"
+        end = text.find(SECTIONS[i + 1]) if i + 1 < len(SECTIONS) else len(text)
+        bodies[header] = text[start:end]
+    return bodies
+
+
+def _compose_services() -> dict:
+    return yaml.safe_load(COMPOSE.read_text(encoding="utf-8"))["services"]
+
+
+# ---------------------------------------------------------------------------
+# TC-01: док существует; 13 нормативных разделов D2 — в заданном порядке (AC-1).
+# ---------------------------------------------------------------------------
+def test_doc_exists_with_all_13_sections_in_order():
+    text = _doc_text()
+    positions: list[int] = []
+    for header in SECTIONS:
+        idx = text.find(header)
+        assert idx != -1, f"нормативный раздел {header!r} отсутствует (D2/FR-1)"
+        positions.append(idx)
+    assert positions == sorted(positions), (
+        "разделы LITE_SETUP.md идут не в порядке маршрута оператора (D2)"
+    )
+
+
+# ---------------------------------------------------------------------------
+# TC-02: обязательные кирпичи + форма «команда + проверка» (AC-1 / NFR-6).
+# ---------------------------------------------------------------------------
+def test_doc_carries_all_mandatory_bricks():
+    text = _doc_text()
+    missing = [b for b in BRICKS if b not in text]
+    assert not missing, f"обязательные кирпичи отсутствуют в LITE_SETUP.md (FR-6.1): {missing}"
+
+
+def test_every_normative_section_carries_commands():
+    """Каждый исполняемый раздел (§2–§13) несёт минимум одну fenced-команду;
+    §1 (рамка/границы) — единственный раздел без команд по построению."""
+    bodies = _section_bodies()
+    for header in SECTIONS[1:]:
+        assert "```" in bodies[header], f"{header}: нет ни одной fenced-команды (NFR-6)"
+
+
+def test_doc_carries_explicit_check_markers():
+    """Маркеры явной проверки результата: не меньше одного на исполняемый раздел."""
+    text = _doc_text()
+    assert text.count("Проверка") >= 12, (
+        "маркеров «Проверка» меньше, чем исполняемых разделов (форма D2: "
+        "каждый шаг = команда + явная проверка)"
+    )
+    assert "PASS" in text and "FAIL" in text
+
+
+# ---------------------------------------------------------------------------
+# TC-02b: key-sync .env.watchdog.example ⇄ блок WATCHDOG_* .env.example (D5).
+# ---------------------------------------------------------------------------
+def test_watchdog_example_exists():
+    assert ENV_WATCHDOG_EXAMPLE.is_file(), ".env.watchdog.example отсутствует (ADR-001 D5)"
+
+
+def test_watchdog_example_keys_sync_with_env_example_block():
+    """Равенство МНОЖЕСТВ ключей (не строк): появление нового WATCHDOG_*-ключа в
+    каноне без обновления example (и наоборот) рвёт CI (D5/TR-8)."""
+    watchdog_keys = _env_keys(ENV_WATCHDOG_EXAMPLE)
+    canon_block = {k for k in _env_keys(ENV_EXAMPLE) if k.startswith("WATCHDOG_")}
+    assert canon_block, "блок WATCHDOG_* в .env.example пуст — канон сломан"
+    assert watchdog_keys == canon_block, (
+        f"key-set .env.watchdog.example разъехался с каноном .env.example: "
+        f"лишние={sorted(watchdog_keys - canon_block)}, "
+        f"недостающие={sorted(canon_block - watchdog_keys)}"
+    )
+    stray = {k for k in watchdog_keys if not k.startswith("WATCHDOG_")}
+    assert not stray, f"посторонние (не WATCHDOG_*) ключи в .env.watchdog.example: {sorted(stray)}"
+
+
+def test_watchdog_example_secrets_are_placeholders_only():
+    """Зеркало test_env_example_secrets_are_placeholders_only (ORCH-101):
+    токены sidecar-бота в гите — только пустые плейсхолдеры (NFR-3)."""
+    values = _env_values(ENV_WATCHDOG_EXAMPLE)
+    for key in ("WATCHDOG_TG_BOT_TOKEN", "WATCHDOG_TG_CHAT_ID"):
+        assert values.get(key, "") == "", (
+            f"{key} в .env.watchdog.example обязан быть пустым плейсхолдером, "
+            f"получено {values.get(key)!r}"
+        )
+
+
+# ---------------------------------------------------------------------------
+# TC-03: согласованность env-канона (AC-1, AC-6 / FR-6.2).
+# ---------------------------------------------------------------------------
+def test_every_env_token_in_doc_exists_in_env_example():
+    """Каждый упомянутый в доке ключ ORCH_*/WATCHDOG_* существует в `.env.example`
+    (канон 100% ключей старта, ORCH-101) — анти-опечатка/анти-дрейф."""
+    canon = _env_keys(ENV_EXAMPLE)
+    mentioned = set(_ENV_TOKEN_RE.findall(_doc_text()))
+    assert mentioned, "в LITE_SETUP.md не упомянут ни один env-ключ — док не полон"
+    unknown = sorted(mentioned - canon)
+    assert not unknown, (
+        f"ключи из LITE_SETUP.md отсутствуют в .env.example (опечатка или дрейф "
+        f"канона, FR-6.2): {unknown}"
+    )
+
+
+def test_mandatory_new_host_keys_are_explicit():
+    text = _doc_text()
+    missing = [k for k in MANDATORY_NEW_HOST_KEYS if k not in text]
+    assert not missing, f"обязательные ключи нового хоста не упомянуты явно (FR-1.4): {missing}"
+
+
+# ---------------------------------------------------------------------------
+# TC-04: compose-подмножество (AC-2 / D4) — yaml.safe_load, без subprocess.
+# ---------------------------------------------------------------------------
+def test_compose_services_are_exactly_the_lite_set():
+    services = _compose_services()
+    assert set(services) == {"orchestrator", "orchestrator-watchdog", "orchestrator-staging"}, (
+        "множество сервисов docker-compose.yml разъехалось с Lite-подмножеством (AC-2)"
+    )
+
+
+def test_compose_staging_is_strictly_behind_profile():
+    services = _compose_services()
+    assert services["orchestrator-staging"].get("profiles") == ["staging"], (
+        "orchestrator-staging обязан быть строго за profiles: [staging] (AC-2)"
+    )
+    default_up = {name for name, svc in services.items() if not svc.get("profiles")}
+    assert default_up == {"orchestrator", "orchestrator-watchdog"}, (
+        f"дефолтный `docker compose up -d` поднимает {sorted(default_up)}, "
+        "а обязан — ровно орк+watchdog (AC-2)"
+    )
+
+
+def test_compose_has_no_plane_or_gitea_services():
+    """Анти-появление молча: ни в имени сервиса, ни в image:/container_name:
+    нет подстрок plane/gitea (D4)."""
+    services = _compose_services()
+    for name, svc in services.items():
+        blob = " ".join(
+            [name, str(svc.get("image", "")), str(svc.get("container_name", ""))]
+        ).lower()
+        for needle in ("plane", "gitea"):
+            assert needle not in blob, (
+                f"сервис {name}: в compose появился {needle}-компонент — "
+                "Lite-подмножество сломано (AC-2)"
+            )
+
+
+def test_doc_documents_default_up_composition():
+    """LITE_SETUP.md фиксирует состав дефолтного запуска и вилку staging (D6)."""
+    text = _doc_text()
+    assert "orchestrator-watchdog" in text
+    assert "orchestrator-staging" in text
+    assert "--profile staging" in text  # staging поднимается только явным профилем
+
+
+# ---------------------------------------------------------------------------
+# TC-05: stateless-норматив + секрет-гигиена fenced-блоков (AC-3 / FR-3, NFR-3).
+# ---------------------------------------------------------------------------
+def test_doc_has_stateless_normative_line():
+    low = _doc_text().lower()
+    assert "не перенос" in low, (
+        "нормативная stateless-строка («данные/задачи/секреты боевого хоста "
+        "НЕ переносятся») отсутствует (AC-3)"
+    )
+
+
+def test_doc_prescribes_clean_db_and_fresh_secrets():
+    text = _doc_text()
+    assert "gen_secrets.py" in text  # секреты — только выпуск НОВЫХ
+    bodies = _section_bodies()
+    stateless = bodies["## 12. Stateless-проверка"]
+    assert "/queue" in stateless, (
+        "§12 обязан нести проверку чистоты инстанса через GET /queue (FR-1 п.12)"
+    )
+
+
+def test_fenced_blocks_carry_no_forbidden_literals():
+    """Копируемые блоки generic: боевые литералы (центральный список FORBIDDEN
+    из tests/test_no_host_hardcodes.py — один источник истины) запрещены."""
+    blocks = _fenced_blocks(_doc_text())
+    assert blocks, "в LITE_SETUP.md нет ни одного fenced-блока — форма D2 нарушена"
+    offenders = [
+        f"блок #{i}: {literal!r}"
+        for i, block in enumerate(blocks)
+        for literal in FORBIDDEN
+        if literal in block
+    ]
+    assert not offenders, (
+        "боевые литералы в копируемых код-блоках LITE_SETUP.md (NFR-3):\n"
+        + "\n".join(offenders)
+    )
+
+
+def test_fenced_blocks_carry_no_secret_like_values():
+    """Эвристика секретоподобных значений (D8): hex >= 32 / чистый alnum >= 40."""
+    offenders = []
+    for i, block in enumerate(_fenced_blocks(_doc_text())):
+        for rx in (_SECRET_HEX_RE, _SECRET_ALNUM_RE):
+            m = rx.search(block)
+            if m is not None:
+                offenders.append(f"блок #{i}: {m.group(0)[:16]}…")
+    assert not offenders, (
+        "секретоподобные значения в копируемых код-блоках (только плейсхолдеры "
+        "<...>/$ENV_VAR, NFR-3):\n" + "\n".join(offenders)
+    )
+
+
+def test_secret_heuristic_is_not_evergreen():
+    """Негативный самочек (паттерн ORCH-101 TC-02): эвристика реально ловит
+    подсаженный секрет — тест не может молча стать вечнозелёным."""
+    planted_hex = "export TOKEN=" + "a1b2c3d4" * 8  # 64 hex
+    planted_alnum = "bot" + "A9" * 25  # 50+ alnum
+    assert _SECRET_HEX_RE.search(planted_hex) is not None
+    assert _SECRET_ALNUM_RE.search(planted_alnum) is not None
+    assert _SECRET_HEX_RE.search("curl -fsS http://127.0.0.1:8500/health") is None
+    assert _SECRET_ALNUM_RE.search("<ORCHESTRATOR_GIT_URL> $ORCH_PLANE_API_TOKEN") is None
+
+
+# ---------------------------------------------------------------------------
+# TC-06: канон не форкается (AC-6 / FR-4) — ссылки на golden source.
+# ---------------------------------------------------------------------------
+def test_plane_canon_is_linked_not_forked():
+    """Статусы — ссылкой на ONBOARDING.md (создаёт onboard_project.py apply);
+    в доке явно — только fail-closed имена Confirm Deploy / STOP."""
+    bodies = _section_bodies()
+    plane = bodies["## 5. Подключение Plane"]
+    assert "ONBOARDING.md" in plane, "раздел Plane не ссылается на golden source статусов"
+    assert "Confirm Deploy" in plane and "STOP" in plane, (
+        "fail-closed имена статусов не упомянуты явно (FR-4)"
+    )
+
+
+def test_status_count_claim_matches_plane_sync():
+    """Сверка импортом (не строковой копией): заявление дока «22 статуса»
+    держится фактическим маппингом src/plane_sync.py (нулевой дрейф, AC-6)."""
+    from src.plane_sync import _PLANE_NAME_TO_KEY
+
+    assert len(_PLANE_NAME_TO_KEY) == 22, (
+        f"в plane_sync {_PLANE_NAME_TO_KEY and len(_PLANE_NAME_TO_KEY)} статусов — "
+        "обнови число и раздел §5 LITE_SETUP.md (и ONBOARDING.md §1)"
+    )
+    assert "Confirm Deploy" in _PLANE_NAME_TO_KEY
+    assert "STOP" in _PLANE_NAME_TO_KEY
+    assert "22" in _doc_text(), "число статусов в LITE_SETUP.md разъехалось с plane_sync"
+
+
+def test_env_map_and_smoke_are_linked_to_replication():
+    bodies = _section_bodies()
+    assert "REPLICATION.md" in bodies["## 4. Конфигурация"], (
+        "карта env обязана даваться ссылкой на REPLICATION.md §2 (FR-4)"
+    )
+    assert "REPLICATION.md" in bodies["## 11. Smoke"], (
+        "smoke обязан строиться на REPLICATION.md §4 ссылкой, без форка (FR-5)"
+    )
+
+
+# ---------------------------------------------------------------------------
+# TC-07: раздел Gitea соответствует инвариантам платформы (AC-7 / D3).
+# ---------------------------------------------------------------------------
+def test_gitea_section_fixes_platform_invariants():
+    bodies = _section_bodies()
+    gitea = bodies["## 6. Подключение Gitea"]
+    for event in ("push", "pull_request", "status"):
+        assert event in gitea, f"событие webhook {event!r} не зафиксировано в §6"
+    assert "ОДИН глобальный" in gitea or "один глобальный" in gitea.lower(), (
+        "§6 обязан фиксировать «ОДИН глобальный webhook-секрет на все репо»"
+    )
+
+
+def test_gitea_section_forbids_branch_protection():
+    """Исход А-1 (D3): branch protection на main НЕ включать (ADR D10 ORCH-009,
+    ломает PR-merge API merge-актора); pre-receive хуки не вводятся."""
+    bodies = _section_bodies()
+    gitea = bodies["## 6. Подключение Gitea"]
+    assert "branch protection" in gitea.lower(), "§6 не несёт норматив про branch protection"
+    assert "НЕ включа" in gitea, "§6 обязан нормативно запрещать branch protection на main"
+    assert "pre-receive" in gitea.lower(), "§6 обязан фиксировать: pre-receive хуки не вводятся"
+
+
+# ---------------------------------------------------------------------------
+# TC-08: перекрёстная документация (AC-5 / FR-7).
+# ---------------------------------------------------------------------------
+def test_replication_boundaries_reference_lite_setup():
+    text = REPLICATION.read_text(encoding="utf-8")
+    assert "LITE_SETUP.md" in text, (
+        "REPLICATION.md §1 обязан ссылаться на LITE_SETUP.md (Type A — Lite реализован)"
+    )
+    assert "ORCH-102" in text, "строка Type A — Lite в REPLICATION.md §1 не отмечена ✅ ORCH-102"
+
+
+def test_changelog_has_orch_102_entry():
+    assert "ORCH-102" in CHANGELOG.read_text(encoding="utf-8")

tests/test_no_host_hardcodes.py

@@ -0,0 +1,173 @@
+"""ORCH-101 (FR-6 / AC-1, AC-7): structural anti-regression scanner — no host
+hardcodes in executable platform code.
+
+Scans ``src/**/*.py`` + ``watchdog/**/*.py`` for forbidden host-specific
+literals (current host IP / home dir / hostname). Judges CODE only: comments
+and docstrings are excluded via :mod:`tokenize` (NFR-5 — token types, not
+line regexes, so the verdict is deterministic).
+
+Structural exclusion (ADR-001 ORCH-101 D10): ``src/config.py`` and
+``watchdog/config.py`` are skipped ENTIRELY — they are the canonical (and only
+legitimate, BR-1) home of host-value defaults, and those defaults are REQUIRED
+to equal the current production values (BR-5: /home/slin, mva154.local).
+Scanning them would mean an eternally non-empty allowlist; the exclusion is a
+rule of this test, not an allowlist entry.
+
+The per-(file, literal) ALLOWLIST exists as a mechanism and MUST be empty at
+ORCH-101 acceptance (AC-1): every code blocker A1–A4 is closed by Settings
+keys. A future entry requires a justification string.
+
+Negative self-check (TC-02): the scanner is exercised against synthetic
+sources with a planted literal and must catch it — the test can never go
+evergreen by accident.
+"""
+
+import io
+import tokenize
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+
+# Single point of truth for the forbidden literals (AC-7: centralised list).
+FORBIDDEN: tuple[str, ...] = (
+    "82.22.50.71",
+    "/home/slin",
+    "mva154",
+    "duckdns",
+)
+
+# Scan zone: executable platform code only. tests/**, docs/**, scripts/**
+# (the deploy hook carries a legitimate shell-default, ADR D7) and .env* are
+# OUT of scope by construction.
+SCAN_DIRS: tuple[str, ...] = ("src", "watchdog")
+
+# Structural rule (ADR-001 D10), NOT an allowlist entry — see module docstring.
+EXCLUDED_FILES: frozenset[str] = frozenset({"src/config.py", "watchdog/config.py"})
+
+# {(relative_path, literal): "justification"} — MUST stay empty (AC-1/AC-7).
+ALLOWLIST: dict[tuple[str, str], str] = {}
+
+# Token types that are never judged: comments and non-logical newlines.
+_TRIVIA = frozenset({tokenize.COMMENT, tokenize.NL, tokenize.ENCODING})
+# A STRING token opening a logical line (after NEWLINE/INDENT/DEDENT or at
+# file start) is a docstring / bare string statement -> not executable data.
+_DOCSTRING_PREV = frozenset({None, tokenize.NEWLINE, tokenize.INDENT, tokenize.DEDENT})
+
+
+def find_violations(source: str, forbidden: tuple[str, ...] = FORBIDDEN) -> list[tuple[int, str, str]]:
+    """Return ``[(lineno, literal, token_text)]`` for forbidden literals in CODE.
+
+    Comments are skipped (COMMENT tokens); docstrings are skipped (STRING tokens
+    in statement position). Everything else — including string *values* assigned
+    or passed in code — is judged: a hardcoded host value in an executable
+    string is exactly the regression this test exists to block.
+    """
+    violations: list[tuple[int, str, str]] = []
+    prev_significant: int | None = None
+    for tok in tokenize.generate_tokens(io.StringIO(source).readline):
+        if tok.type in _TRIVIA:
+            continue  # comments / blank-line NLs never update statement position
+        if tok.type == tokenize.STRING and prev_significant in _DOCSTRING_PREV:
+            prev_significant = tok.type  # docstring / bare string statement
+            continue
+        for literal in forbidden:
+            if literal in tok.string:
+                violations.append((tok.start[0], literal, tok.string))
+        prev_significant = tok.type
+    return violations
+
+
+def _scan_files() -> list[Path]:
+    """Deterministic (sorted) list of python files in the scan zone."""
+    files: list[Path] = []
+    for d in SCAN_DIRS:
+        root = REPO_ROOT / d
+        if root.is_dir():
+            files.extend(sorted(root.glob("**/*.py")))
+    return [
+        f for f in files
+        if f.relative_to(REPO_ROOT).as_posix() not in EXCLUDED_FILES
+    ]
+
+
+# ---------------------------------------------------------------------------
+# TC-01: the platform code carries no forbidden host literals (AC-1).
+# ---------------------------------------------------------------------------
+def test_no_host_hardcodes_in_executable_code():
+    offenders: list[str] = []
+    for path in _scan_files():
+        rel = path.relative_to(REPO_ROOT).as_posix()
+        source = path.read_text(encoding="utf-8")
+        for lineno, literal, token_text in find_violations(source):
+            if (rel, literal) in ALLOWLIST:
+                continue
+            offenders.append(f"{rel}:{lineno}: forbidden literal {literal!r} in {token_text!r}")
+    assert not offenders, (
+        "Host-specific hardcodes found in executable code (read the value from "
+        "src/config.py Settings instead — see ORCH-101 ADR-001 D1/D2):\n"
+        + "\n".join(offenders)
+    )
+
+
+def test_scan_zone_is_nonempty():
+    """Guard against the scanner silently scanning nothing (path drift)."""
+    files = _scan_files()
+    assert len(files) > 10, f"scan zone unexpectedly small: {len(files)} files"
+    rels = {f.relative_to(REPO_ROOT).as_posix() for f in files}
+    assert "src/config.py" not in rels  # structural exclusion intact
+    assert "src/plane_sync.py" in rels  # the A1 blocker file IS scanned
+
+
+def test_allowlist_is_empty_at_acceptance():
+    """AC-1/AC-7: the allowlist mechanism exists but carries no entries."""
+    assert ALLOWLIST == {}, (
+        "ORCH-101 ships with an EMPTY allowlist; a new entry needs an explicit "
+        "justification and reviewer sign-off"
+    )
+
+
+# ---------------------------------------------------------------------------
+# TC-02: negative self-check — the scanner actually catches a planted literal
+# (the test is not evergreen) and actually skips comments/docstrings (NFR-5).
+# ---------------------------------------------------------------------------
+def test_scanner_catches_planted_literal_in_code():
+    planted = 'BASE = "http://git.mva154.duckdns.org"\n'
+    hits = find_violations(planted)
+    assert hits, "scanner failed to catch a forbidden literal planted in code"
+    assert {lit for _, lit, _ in hits} == {"mva154", "duckdns"}
+
+
+def test_scanner_catches_planted_literal_in_env_dict():
+    planted = 'env = {**os.environ, "HOME": "/home/slin"}\n'
+    hits = find_violations(planted)
+    assert [(lineno, lit) for lineno, lit, _ in hits] == [(1, "/home/slin")]
+
+
+def test_scanner_catches_planted_literal_in_fstring():
+    planted = 'url = f"http://{host}.mva154.local/x"\n'
+    hits = find_violations(planted)
+    assert any(lit == "mva154" for _, lit, _ in hits)
+
+
+def test_scanner_ignores_comments_and_docstrings():
+    clean = (
+        '"""Module docstring mentioning mva154 and /home/slin and duckdns."""\n'
+        "\n"
+        "# a comment about 82.22.50.71 and /home/slin\n"
+        "def f():\n"
+        '    """Docstring: mva154.local lives here historically."""\n'
+        "    return 1  # trailing comment: duckdns\n"
+    )
+    assert find_violations(clean) == []
+
+
+def test_scanner_judges_string_values_not_in_statement_position():
+    # A string VALUE (right-hand side) with a literal must be caught even when
+    # a docstring with the same literal is present above it.
+    mixed = (
+        "def f():\n"
+        '    """mva154 in a docstring is fine."""\n'
+        '    return "/home/slin"\n'
+    )
+    hits = find_violations(mixed)
+    assert [(lineno, lit) for lineno, lit, _ in hits] == [(3, "/home/slin")]

tests/test_orch040_compose.py

@@ -4,10 +4,18 @@
 HOME, который форсит launcher. Чистые конфиг-тесты: парсят YAML и текст
 launcher, без запуска docker/агентов.
 
+ORCH-101 (согласованная структурная правка): compose параметризован
+`${VAR:-default}`-интерполяцией с дефолтами = боевым значениям, а HOME
+launcher'а читается из `settings.agent_home_dir` (тот же дефолт). Тесты судят
+РЕЗОЛВ при пустом окружении (эквивалент `docker compose config` без
+переменных) — сам инвариант ORCH-040 (uid хоста, group_add 999, SSH-маунт под
+HOME) не ослаблен: смена дефолта по-прежнему валит тест.
+
 См. docs/work-items/ORCH-040/{02-trz.md,03-acceptance-criteria.md,
 04-test-plan.yaml} и 06-adr/ADR-001-run-agents-as-host-uid.md.
 """
 
+import re
 from pathlib import Path
 
 import pytest
@@ -20,9 +28,18 @@ LAUNCHER_PATH = REPO_ROOT / "src" / "agents" / "launcher.py"
 # Сервисы, которые исполняют конвейер и обязаны бежать под uid хоста.
 PIPELINE_SERVICES = ("orchestrator", "orchestrator-staging")
 
-# Единый HOME агента (форсится launcher'ом); под ним должны лежать .ssh/.claude.
+# Единый HOME агента (дефолт settings.agent_home_dir, ORCH-101); под ним
+# должны лежать .ssh/.claude.
 EXPECTED_HOME = "/home/slin"
 
+# ORCH-101: ${VAR:-default} -> default (поведение compose при пустом env).
+_INTERP_RE = re.compile(r"\$\{[A-Z0-9_]+:-([^}]*)\}")
+
+
+def _resolve(value) -> str:
+    """Резолв compose-интерполяции при ПУСТОМ окружении (дефолты)."""
+    return _INTERP_RE.sub(lambda m: m.group(1), str(value))
+
 
 @pytest.fixture(scope="module")
 def compose() -> dict:
@@ -40,10 +57,13 @@ def _service(compose: dict, name: str) -> dict:
 
 
 def _ssh_mount_target(service: dict) -> str:
-    """Target SSH-маунта (источник .orchestrator-ssh) для сервиса."""
+    """Target SSH-маунта (источник .orchestrator-ssh) для сервиса.
+
+    ORCH-101: volume-строка резолвится из интерполяции ДО разбора src:target.
+    """
     for vol in service.get("volumes", []):
-        # формат "src:target[:mode]"
-        parts = vol.split(":")
+        # формат "src:target[:mode]" (после резолва дефолтов)
+        parts = _resolve(vol).split(":")
         src = parts[0]
         if src.endswith(".orchestrator-ssh"):
             assert len(parts) >= 2, f"SSH-маунт без target: {vol}"
@@ -57,9 +77,10 @@ def test_tc01_service_runs_as_host_uid(compose, name):
     """TC-01/AC-1: сервис бежит под uid:gid хоста 1000:1000, а не root."""
     service = _service(compose, name)
     assert "user" in service, f"{name}: отсутствует ключ user (нужен '1000:1000')"
-    # docker допускает int или строку; нормализуем к строке.
-    assert str(service["user"]) == "1000:1000", (
-        f"{name}: user={service['user']!r}, ожидалось '1000:1000'"
+    # docker допускает int или строку; нормализуем к строке. ORCH-101: судим
+    # резолв дефолтов интерполяции (= docker compose config при пустом env).
+    assert _resolve(service["user"]) == "1000:1000", (
+        f"{name}: user={service['user']!r}, резолв должен давать '1000:1000'"
     )
 
 
@@ -69,9 +90,9 @@ def test_tc02_group_add_keeps_docker_gid(compose, name):
     """TC-02/AC-4: group_add содержит 999 (доступ к docker.sock не потерян)."""
     service = _service(compose, name)
     group_add = service.get("group_add", [])
-    normalized = {str(g) for g in group_add}
+    normalized = {_resolve(g) for g in group_add}
     assert "999" in normalized, (
-        f"{name}: group_add={group_add!r}, должен содержать '999' (docker.sock)"
+        f"{name}: group_add={group_add!r}, резолв должен содержать '999' (docker.sock)"
     )
 
 
@@ -95,16 +116,23 @@ def test_tc04_launcher_home_matches_mounts(compose):
     """TC-04: HOME, форсимый launcher'ом, совпадает с базой SSH/claude-маунтов.
 
     Нет рассинхрона HOME vs uid: и env Popen, и git_env, и target SSH-маунта
-    все указывают на /home/slin.
+    все указывают на один HOME. ORCH-101: launcher читает HOME из
+    `settings.agent_home_dir` через единый `agent_git_env()` (оба места —
+    Popen агента и git commit/push), а маунты compose интерполируют ТОТ ЖЕ
+    `ORCH_AGENT_HOME_DIR` — рассинхрон структурно невозможен; здесь судим, что
+    дефолт ключа и резолв маунтов сходятся в /home/slin.
     """
+    from src.config import Settings
+
+    # Дефолт ключа = канонический HOME (BR-5 ORCH-101 / AC-5 ORCH-040).
+    assert Settings.model_fields["agent_home_dir"].default == EXPECTED_HOME
     source = LAUNCHER_PATH.read_text(encoding="utf-8")
-    # launcher форсит HOME в двух местах (env Popen и git_env).
-    occurrences = source.count(f'"HOME": "{EXPECTED_HOME}"')
-    assert occurrences >= 2, (
-        f"launcher.py: ожидалось >=2 форсинга HOME={EXPECTED_HOME!r}, "
-        f"найдено {occurrences}"
+    # Оба места запуска используют единый Settings-driven env-словарь.
+    assert '"HOME": settings.agent_home_dir' in source
+    assert source.count("agent_git_env()") >= 2, (
+        "launcher.py: env Popen и git_env должны строиться единым agent_git_env()"
     )
-    # И SSH-маунты обоих сервисов ведут в этот же HOME.
+    # И SSH-маунты обоих сервисов ведут в этот же HOME (резолв дефолтов).
     for name in PIPELINE_SERVICES:
         target = _ssh_mount_target(_service(compose, name))
         assert target.startswith(f"{EXPECTED_HOME}/"), (

tests/test_replication_smoke.py

@@ -0,0 +1,99 @@
+"""ORCH-101 (TC-10, AC-3/AC-4): репликационная документация и smoke-процедура.
+
+Структурные проверки: deployment-док `docs/operations/REPLICATION.md`
+существует и несёт пошаговую smoke-процедуру с явными PASS/FAIL-критериями,
+карту env-переменных, чек-лист секретов и границы 10-common vs Lite vs
+Bundled; карта env в INFRA.md дополнена; CHANGELOG.md содержит запись
+ORCH-101; гайд stateless (не предписывает перенос боевых данных/секретов).
+Скрипт-обвязка ORCH-101 не вводилась (ADR-001 D9 — чистый runbook), поэтому
+запускаемость проверяется только для генератора секретов (--help, без
+сети/LLM).
+"""
+
+import subprocess
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+REPLICATION = REPO_ROOT / "docs/operations/REPLICATION.md"
+INFRA = REPO_ROOT / "docs/operations/INFRA.md"
+CHANGELOG = REPO_ROOT / "CHANGELOG.md"
+
+
+def _replication_text() -> str:
+    assert REPLICATION.is_file(), "docs/operations/REPLICATION.md отсутствует (AC-3)"
+    return REPLICATION.read_text(encoding="utf-8")
+
+
+def test_replication_doc_has_smoke_procedure_with_pass_fail():
+    text = _replication_text()
+    # Каждый шаг smoke имеет явный критерий; маркеры вердикта присутствуют.
+    assert "PASS" in text and "FAIL" in text
+    # Ключевые кирпичи процедуры (D9): health-check, onboarding-CLI, очередь.
+    for brick in ("/health", "/queue", "onboard_project.py", "docker compose config"):
+        assert brick in text, f"smoke-кирпич {brick} не упомянут в REPLICATION.md"
+    # Минимальный сигнал «конвейер доехал»: стадия analysis + артефакты 01–04.
+    assert "analysis" in text
+    assert "01" in text and "04" in text
+
+
+def test_replication_doc_covers_secrets_checklist():
+    text = _replication_text()
+    assert "gen_secrets.py" in text
+    for token in (
+        "ORCH_PLANE_WEBHOOK_SECRET",
+        "ORCH_GITEA_WEBHOOK_SECRET",
+        "ORCH_PLANE_API_TOKEN",
+        "ORCH_GITEA_TOKEN",
+        "ORCH_TELEGRAM_BOT_TOKEN",
+    ):
+        assert token in text, f"секрет {token} не покрыт чек-листом"
+    # Нормативная строка stateless-тиража (AC-5): боевые секреты не копируются.
+    assert "не копиру" in text.lower()
+
+
+def test_replication_doc_has_env_map_and_boundaries():
+    text = _replication_text()
+    for var in (
+        "ORCH_AGENT_HOME_DIR",
+        "ORCH_AGENT_GIT_NAME",
+        "ORCH_GIT_EMAIL_DOMAIN",
+        "ORCH_STAGING_PORT",
+        "ORCH_DOCKER_GID",
+        "ORCH_RUN_UID",
+        "ORCH_HOST_REPOS_DIR",
+    ):
+        assert var in text, f"переменная {var} отсутствует в карте env REPLICATION.md"
+    # Границы тиража (анти-скоуп-крип Р-5) + платформенные конвенции (D3/D4).
+    assert "Lite" in text and "Bundled" in text
+    assert "orchestrator" in text  # конвенция имени репо платформы
+    # Чек-лист обязывает задать реестр проектов на новом хосте (A9).
+    assert "ORCH_PROJECTS_JSON" in text
+
+
+def test_replication_doc_is_stateless():
+    text = _replication_text().lower()
+    # Процедура не предписывает перенос БД/данных с боевого хоста.
+    assert "перенос" not in text or "не предполагает перенос" in text or "без перенос" in text
+
+
+def test_infra_env_map_extended():
+    text = INFRA.read_text(encoding="utf-8")
+    for var in ("ORCH_AGENT_HOME_DIR", "ORCH_STAGING_PORT", "ORCH_DOCKER_GID"):
+        assert var in text, f"{var} отсутствует в карте env INFRA.md (AC-4)"
+    assert "REPLICATION.md" in text  # перекрёстная ссылка на deployment-док
+
+
+def test_changelog_has_orch_101_entry():
+    text = CHANGELOG.read_text(encoding="utf-8")
+    assert "ORCH-101" in text
+
+
+def test_gen_secrets_runs_in_safe_mode():
+    """Обвязка запускается без ошибок в безопасном режиме (--help: без сети,
+    без LLM, без записи файлов)."""
+    r = subprocess.run(
+        [sys.executable, str(REPO_ROOT / "scripts/gen_secrets.py"), "--help"],
+        capture_output=True, text=True, timeout=30,
+    )
+    assert r.returncode == 0, r.stderr

tests/test_secrets_gen.py

@@ -0,0 +1,106 @@
+"""ORCH-101 (TC-09, AC-5 / NFR-3): scripts/gen_secrets.py — выпуск нового
+комплекта секретов.
+
+Контракт D8: криптослучайные webhook-секреты (>= 32 байт энтропии, hex);
+повторный запуск даёт другие значения; существующий .env никогда не
+перезаписывается молча (отказ exit=2, перезапись только --force); состав
+ключей вывода согласован с .env.example.
+"""
+
+import importlib.util
+import re
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+SCRIPT = REPO_ROOT / "scripts/gen_secrets.py"
+ENV_EXAMPLE = REPO_ROOT / ".env.example"
+
+_HEX64 = re.compile(r"^[0-9a-f]{64}$")
+
+
+def _load_module():
+    spec = importlib.util.spec_from_file_location("gen_secrets", SCRIPT)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+def _values(fragment: str) -> dict[str, str]:
+    out = {}
+    for line in fragment.splitlines():
+        if "=" in line and not line.startswith("#"):
+            k, v = line.split("=", 1)
+            out[k] = v
+    return out
+
+
+def test_secret_is_cryptorandom_64_hex():
+    mod = _load_module()
+    assert mod.TOKEN_BYTES >= 32  # AC-5: >= 32 байта энтропии
+    value = mod.generate_secret()
+    assert _HEX64.match(value), value
+
+
+def test_two_runs_give_different_values():
+    mod = _load_module()
+    a, b = _values(mod.build_fragment()), _values(mod.build_fragment())
+    for key in mod.GENERATED_KEYS:
+        assert _HEX64.match(a[key]) and _HEX64.match(b[key])
+        assert a[key] != b[key], f"{key}: повторный запуск дал то же значение"
+
+
+def test_external_tokens_are_placeholders():
+    mod = _load_module()
+    vals = _values(mod.build_fragment())
+    for key in mod.EXTERNAL_KEYS:
+        assert vals[key] == "", f"{key} должен быть пустым плейсхолдером"
+
+
+def test_output_keys_consistent_with_env_example():
+    """AC-5: каждое имя ключа из вывода генератора существует в .env.example."""
+    mod = _load_module()
+    example = ENV_EXAMPLE.read_text(encoding="utf-8")
+    example_keys = {
+        line.split("=", 1)[0].strip()
+        for line in example.splitlines()
+        if "=" in line and not line.strip().startswith("#")
+    }
+    for key in (*mod.GENERATED_KEYS, *mod.EXTERNAL_KEYS):
+        assert key in example_keys, f"{key} отсутствует в .env.example"
+
+
+def test_default_mode_prints_and_touches_no_files(tmp_path, capsys, monkeypatch):
+    mod = _load_module()
+    monkeypatch.chdir(tmp_path)
+    rc = mod.main([])
+    assert rc == 0
+    out = capsys.readouterr().out
+    assert "ORCH_PLANE_WEBHOOK_SECRET=" in out
+    assert list(tmp_path.iterdir()) == []  # filesystem untouched
+
+
+def test_write_refuses_existing_file_without_force(tmp_path):
+    mod = _load_module()
+    target = tmp_path / ".env"
+    target.write_text("KEEP=1\n", encoding="utf-8")
+    rc = mod.main(["--write", str(target)])
+    assert rc == 2  # отказ, не перезапись
+    assert target.read_text(encoding="utf-8") == "KEEP=1\n"  # содержимое цело
+
+
+def test_write_creates_new_file_and_force_overwrites(tmp_path):
+    mod = _load_module()
+    target = tmp_path / ".env"
+    assert mod.main(["--write", str(target)]) == 0
+    first = _values(target.read_text(encoding="utf-8"))
+    assert _HEX64.match(first["ORCH_GITEA_WEBHOOK_SECRET"])
+    # --force перезаписывает, и секреты другие (не детерминированы).
+    assert mod.main(["--write", str(target), "--force"]) == 0
+    second = _values(target.read_text(encoding="utf-8"))
+    assert first["ORCH_GITEA_WEBHOOK_SECRET"] != second["ORCH_GITEA_WEBHOOK_SECRET"]
+
+
+def test_no_real_secret_committed_anywhere_near():
+    """Генератор не несёт зашитых значений: единственный источник — CSPRNG."""
+    text = SCRIPT.read_text(encoding="utf-8")
+    assert not re.search(r"[0-9a-f]{32,}", text), "зашитое hex-значение в генераторе"