meta(tasks): migrate .tasks to v2 (global numbering 87 tasks)

This commit is contained in:
2026-08-23 10:18:28 +03:00
parent 83986e0589
commit 3f4d7474b3
28 changed files with 176 additions and 89 deletions

View File

@@ -0,0 +1,70 @@
# agents-task-runner-vds-deploy
> Slug legacy-named `-vds-deploy`; scope corrected 2026-06-08 — VDS-as-worker DROPPED.
> Per-machine federation: each WORKER runs its own `agents-task-runner`, claims from the
> SHARED Gitea board, runs the agent LOCALLY, commits/pushes. VDS hosts the Gitea board
> ONLY (already up) — not a worker, nothing deploys on it.
## Goal
Поднять `agents-task-runner` (the poller) на первой worker-машине, нацелив на shared
Gitea-board. Машина клеймит только то, что умеет (capability-filter), `.admin` исключён
из автономного клейма до governance L2/L3. Сначала DRY_RUN на prod-board, затем один
живой цикл на реальной non-`.admin` таске: spawn → commit → push, verified.
## Key files
- `~/projects/.common/lib/agents-task-runner/` — runtime (plain JS, `type:module`, v0.16.2)
- `server.js` — reconcile loop entry (`npm start`)
- `task-runner/server.js` — task-runner entry (`npm run task-runner`)
- `lib/cross-project-poller.js` — claim loop, requirements-filter, confirm-gate
- `lib/consult-backend/` — execution-policy governance (consult_policy + needs-human gate)
- `docker-compose.yml` / `docker-compose.host.yml` / `Dockerfile`
- `secrets.env.example` — секреты-шаблон (ANTHROPIC_API_KEY / Gitea token / projects-meta)
- `config/` — node-config overlays
- `~/projects/.common/lib/projects-meta-mcp/dist/` — уже собран (build-prereq для НЕГО, не для раннера)
## Decisions log
- 2026-06-08: Взята в работу из ⚪ ready. **Build-prereq в Next action неточен** — раннер
это чистый JS (нет tsconfig / `npm run build`, запускается `node server.js`), собирать
нечего; `npm run build` релевантен только `projects-meta-mcp`, а его `dist/` уже есть.
Источник заблуждения — общий BUILD-prereq из consult-execution-policy-governance review,
где TS-only касался projects-meta-mcp.
- 2026-06-08: Re-scoped (из STATUS-блока): VDS = board-host only, VDS-as-worker dropped.
Poller живёт на worker-машинах (workstation / factory Linux).
- 2026-06-08: guard `.admin/.tasks/policy.toml` (default_weight=needs-human) **запушен**
(`94972472`) + **верифицирован**: прогон dist-модулей claim-gate на реальном `.admin` board
→ все 4 claimable `.admin`-таски скипаются `reason=needs-human`, ноль проскочивших.
- 2026-06-08: always-on bring-up НАЧАТ (`.env` RECONCILER_ENABLED=true, secrets.env, docker
build + `mongo`+`reconciler` up через host-override) — затем **ОСТАНОВЛЕН и снесён** (`compose
down`) по запрету user'а "не запускай поллеров без разрешения". host task-runner так и НЕ
стартовал → ни одного claim/spawn не было. Конфиг (.env/secrets.env) остался на диске, готов.
- 2026-06-08: **находка, валидирующая gating** — DRY_RUN-кандидат
`OpeItcLoc03/MoreThenCms/cms-maljarka-https-mode-bug-fix` был ⚪ ready, хотя баг починен сегодня
(cross-board stale: фикс жил в `.admin`, таска — на MoreThenCms board, никто не закрыл). Без
паузы always-on заспавнил бы агента «чинить» уже починенное. Таска закрыта user-confirmed
(MoreThenCms `890eae27`). Урок: до always-on нужен sweep board'ов на stale-claimable.
## Open questions
- [ ] **GATE: запуск поллеров требует явного разрешения user'а** (2026-06-08 — "не запускай
поллеров без моего разрешения"). До гранта — НЕ стартовать host task-runner и НЕ поднимать
reconciler с RECONCILER_ENABLED=true.
- [x] Первая worker-машина → **эта workstation** (user-решение 2026-06-08).
- [x] Headless-auth → `claude login` достаточно (spawn наследует env хост-процесса; API-key не нужен).
- [x] Capability-filter → `AGENT_CAPABILITIES=needs-internet` (минимально), `AGENT_RUNTIME=claude-opus`.
## Completed steps
- [x] 2026-06-08: orientation — раннер локализован (`~/projects/.common/lib/agents-task-runner`,
v0.16.2, JS), build-prereq разобран (фантом для раннера), common pull актуален (`e7b1143`).
- [x] 2026-06-08: prereq-чек на workstation зелёный — node v22.22, docker 29.3.1 up,
`projects-meta-mcp/dist/tasks-cli.js` собран, runner `node_modules` есть, `auth.toml` есть.
- [x] 2026-06-08: **DRY_RUN-смок прошёл end-to-end.** Хост-процесс `task-runner` (PORT 3000,
`DRY_RUN=1 AGENT_RUNTIME=claude-opus AGENT_CAPABILITIES=needs-internet SPAWN_MODE=local`),
один тик через `POST /tasks/crossProjectAgentPoller` + `GET /runs/:id` (curl `--noproxy "*"`).
Результат: `{dryRun:true, claimed:false, candidate:{project:"OpeItcLoc03/MoreThenCms",
slug:"cms-maljarka-https-mode-bug-fix"}}`. Полный cross-boundary путь
(reconciler→runner→CLI→реальный shared-board read) работает; claim-token НЕ записан, spawn НЕ
вызван. Capability-фильтр (`needs-internet`) отработал — кандидат non-`.admin`. Процесс заглушён.
## Notes
- HARD: `.admin` исключён из автономного клейма до governance L2/L3 (см. STATUS-блок § blocker).
- anti-self-review: distinct machine-id на каждый worker.
- Секреты per-machine: 600 root, не в git.