architect(ET): auto-commit from architect run_id=491

docs/operations/INFRA.md

@@ -74,10 +74,30 @@ ADR `docs/work-items/ORCH-040/06-adr/ADR-001-run-agents-as-host-uid.md` и гл
   `disk_monitor.enabled=false`; поведение 1:1 как сейчас). Наблюдаемость — блок `disk_monitor` в
   `GET /queue` (последний замер: `used_pct`/`free_gb`/`alerting`/`last_alert_at` по каждому пути).
 - **Что делать при алерте:** watchdog **только сигнализирует** — он не трогает диск/контейнер и не
-  рестартит прод (self-hosting безопасность). Освобождение места — **ручная** операция оператора:
-  типовые «пожиратели» — старые worktree-каталоги `/home/slin/repos/_wt/*` завершённых задач,
-  логи, dangling Docker-образы/слои (`docker image prune`, `docker builder prune`). Авто-очистка —
-  вне объёма ORCH-063 (отдельная задача).
+  рестартит прод (self-hosting безопасность). Освобождение **docker build cache** автоматизировано
+  отдельным демоном (ORCH-062, см. ниже); прочие «пожиратели» — старые worktree-каталоги
+  `/home/slin/repos/_wt/*` завершённых задач, логи, dangling-образы (`docker image prune`) —
+  по-прежнему **ручная** операция оператора (авто-уборка этих категорий — вне объёма ORCH-062/063).
+
+### Build-cache-pruner: авто-prune docker build cache на mva154 (ORCH-062)
+Доминирующий «пожиратель» в инциденте 07.06.2026 — **docker build cache** (≈11 ГБ от частых
+пересборок прод/staging-образов). Чтобы он не мог снова заполнить диск **без оператора**, работает
+фоновый daemon-поток `src/build_cache_pruner.py` (каркас `disk_watchdog`) — «вторая половина»
+watchdog'а: **watchdog сигналит, pruner убирает**.
+- **Что делает:** каждые `ORCH_BUILD_CACHE_PRUNE_INTERVAL_S` (дефолт 21600с = 6ч) выполняет
+  **строго `docker builder prune -f --filter until=<until>`** (BuildKit GC; дефолт `until=24h` —
+  удаляется build cache старше суток, тёплый свежий кэш сохраняется). Команда затрагивает **только
+  build cache** — НЕ образы/контейнеры запущенных сервисов; рестарт docker daemon/прода НЕ
+  выполняется (self-hosting безопасность).
+- **Как исполняется:** в контейнере нет `docker` CLI (образ несёт только `openssh-client git`),
+  поэтому уборка идёт **на хосте через ssh** тем же каналом `ORCH_DEPLOY_SSH_USER@_HOST`, что
+  деплой/`image_freshness`. **Пустой `ORCH_DEPLOY_SSH_HOST` → тик no-op** (фича активна только на
+  self-host, где ssh настроен).
+- **Как отключить:** `ORCH_BUILD_CACHE_PRUNE_ENABLED=false` (демон не стартует; поведение 1:1 как
+  до ORCH-062). Наблюдаемость — блок `build_cache_prune` в `GET /queue` (`enabled`/`interval_s`/
+  `until`/`last_run_ts`/`last_reclaimed`/`last_error`); never-raise; in-memory учёт (без миграции).
+- **Ручной fallback** (если ssh-канал недоступен) — host-cron на mva154:
+  `0 */6 * * * docker builder prune -f --filter until=24h` (off-git, процедура Owner).
 
 ## Переменные окружения (карта; значения — в `.env`)
 
@@ -117,6 +137,12 @@ ADR `docs/work-items/ORCH-040/06-adr/ADR-001-run-agents-as-host-uid.md` и гл
 | `ORCH_DISK_MONITOR_THRESHOLD_PCT` | порог заполнения для алерта, %; дефолт `85` (валидация 1..100, иначе → дефолт) |
 | `ORCH_DISK_MONITOR_REALERT_S` | cooldown повторного алерта, пока выше порога, сек; дефолт `21600` (~6 ч) |
 | `ORCH_DISK_MONITOR_PATHS` | CSV отслеживаемых **хост**-bind-путей; пусто → `/repos,/app/data` |
+| `ORCH_BUILD_CACHE_PRUNE_ENABLED` | kill-switch build-cache-pruner (ORCH-062); дефолт `true`. `false` → демон не стартует, поведение 1:1 как до задачи |
+| `ORCH_BUILD_CACHE_PRUNE_INTERVAL_S` | период тика авто-prune, сек; дефолт `21600` (~6 ч); валидация >0, иначе → дефолт |
+| `ORCH_BUILD_CACHE_PRUNE_UNTIL` | возраст удержания тёплого кэша (`docker builder prune --filter until=`); дефолт `24h`; валидация `^\d+[smhdw]?$`, иначе → `24h` |
+| `ORCH_BUILD_CACHE_PRUNE_ALL` | добавить `-a` к prune (только в паре с `until`); дефолт `false` |
+| `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` | параметры деплой-хука |
 
 **Секреты — только в `.env` / `.env.staging` на хосте, в гит НЕ коммитятся.** Канон — `.env.example`, `.env.staging.example`.