# Статус проекта: Мультиагентная разработка ПО

**Дата обновления:** 2026-06-04 10:35 UTC  
**Ревьюер:** Стрим

---

## 📌 Свежее (2026-06-04) — observability, живой ТГ-трекер, баги на боевом ET-013

| Работа | Статус |
|--------|--------|
| **PR #20** observability: токены (input+cache_read+cache_creation, `15.1M in`), merge-gate `current_stage==deploy`, Plane→Done (`set_issue_done`), артефакты от всех агентов | 🟢 смержен (`2801983d`), на проде |
| **PR #21** живой Telegram-трекер B+ (одно editMessageText-сообщение, умные пинги только на алерты) | 🟢 смержен (`3e5c74ce`), на проде |
| **PR #22** фикс трекера: дубли (`not modified`=успех, send только при `gone`) + `🔄 Review · попытка N` | 🟢 смержен (`b222d7af`), на проде |
| **PR #23** фикс деплой-гейта (ложный FAILED, рассинхрон путей `14-deploy-log.md`; fallback на `origin/main`) | 🟢 смержен (`34894f46`), на проде |
| **PR #24** фикс гейта тестов: `check_tests_passed` читал substring "PASS" вместо машинного вердикта → BLOCKED-задачи уезжали в Done | 🟢 смержен (`83f5020f`), на проде |
| **ET-8 переоткрыта** (фича НЕ работает на проде — нет тайлов hillshade z8-z9) → Backlog | 🔴 в работе (нужна генерация тайлов) |
| **Доска ET** (5 Done + ET-4 Cancelled + ET-8 Backlog + ET-9 Done) | 🟢 синхронизирована |

**Детали:** `🐛 Известные баги` ниже + `memory/2026-06-04.md` + reports `dev-2026-06-04-*`.

---

## 🐛 Известные баги (живой трекер + деплой + гейт тестов, 2026-06-04)

### ✅ Баг C — гейт тестов пропускал BLOCKED (substring "PASS", ИСПРАВЛЕН PR #24)
- **Симптом:** ET-8/ET-013 «по-прежнему мелко» на проде — недоделанная фича уехала в Done.
- **Корень:** `check_tests_passed` (qg/checks.py:139) делал `if "PASS" in content`. Тестер выставил `verdict: BLOCKED` / `status: blocked` (провал P1 AC-19: нет hillshade z9), но в теле отчёта были слова «23 passed» / «✅ PASS» → substring нашёлся → True → deploy → Done. Подрывал автономность: любой BLOCKED-отчёт со словом PASS проезжал до прода.
- **Фикс (PR #24, `83f5020f`):** `check_tests_passed` читает машинный `verdict:`/`status:` из frontmatter (зеркало check_reviewer_verdict / check_deploy_status). Набор токенов (вердикты тестера неединообразны по истории): negative (BLOCKED/FAILED/FAIL/REQUEST_CHANGES/REJECT/RED) — authoritative, перебивают positive (PASS/PASSED/READY-TO-DEPLOY/GREEN/APPROVED). 285 passed / 9 off-limits. ET-013 → False (BLOCKED), все 9 прошедших WI → True.


### ✅ Баг A — трекер плодит дубли сообщений (ИСПРАВЛЕН, PR #22)
- **Симптом:** вместо одного редактируемого сообщения — новые на каждом цикле. На ET-013: 21 editMessageText / 7 sendMessage = 7 дублей.
- **Корень:** `edit_telegram` (src/notifications.py) возвращал `False` на ЛЮБОМ 400, включая Telegram-ответ `"message is not modified"` (текст трекера не менялся). `update_task_tracker` трактовал False как «edit упал» → новое сообщение + перезапись tracker_message_id (старый трекер осиротевал, отставал).
- **Фикс (PR #22, `b222d7af`):** `edit_telegram` → `ok|not_modified|gone|failed`. Новое сообщение ТОЛЬКО при `gone`. `render_task_tracker` показывает `🔄 Review · попытка N` на повторных циклах. 272 passed / 9 off-limits.

### ✅ Баг B — ложный FAILED деплоя (РАССИНХРОН ПУТЕЙ, ИСПРАВЛЕН PR #23)
- **Симптом:** ET-013 РЕАЛЬНО задеплоен (тег v0.0.5, deploy-hook RC=0, healthcheck 200, фича живая), но QG завернул в FAILED → откат deploy→development.
- **Корень:** deployer пишет `14-deploy-log.md` (deploy_status: SUCCESS) и мержит артефакты в **main** через отдельный PR (#27). А QG `check_deploy_status` (src/qg/checks.py ~284) читает этот файл через `_repo_path(repo, branch)` из **worktree ветки фичи**, где его нет → «not found» → ложный FAILED. Бьёт по КАЖДОМУ успешному деплою.
- **Важно:** merge-gate из PR #20 (`current_stage==deploy`) СРАБОТАЛ ПРАВИЛЬНО (без него был бы фейк-done) — НЕ трогать.
- **Фикс (PR #23, `34894f46`, на проде):** новые `_deploy_log_from_main` + `_parse_deploy_status` в qg/checks.py. Порядок поиска: worktree → `git fetch origin main` + `git show origin/main:.../14-deploy-log.md` на shared-клоне → not found. Любая git-ошибка → деградация (None, не исключение), таймауты 30s/15s. 277 passed / 9 off-limits. merge-gate gitea.py НЕ тронут.
- **ET-013 (=Plane ET-8)** доведена до Done вручную (код реально на проде) + коммент с объяснением.

---

## 📌 Предыдущее (2026-06-03) — сессия багов входа/выхода analyst

| Работа | Статус |
|--------|--------|
| **PR #12** status-only verdict model (вердикт по статусу, не комменту; фикс Баг 3 эхо-самоудар) | 🟢 смержен, на проде |
| **PR #13** Баги A/B/C: `description`→`.task.md`, `name`→ветка, коммент analyst + ссылки | 🟢 смержен, боевой прогон чистый |
| **PR #14** `gitea_public_url` — внешние кликабельные ссылки в комментах | 🟢 смержен, env прописан на проде |
| **PR #15** Баг 4 (блокер): Approved-вердикт двигает analysis→architecture | 🟢 смержен, боевой прогон ✅ |
| 🎉 Конвейер analysis→architecture end-to-end через живой Approved | 🟢 впервые пройден на ET-011 (#6, task 29) |

**Дальше:** architect отработал (ADR-014/015 + infra-req) → дождаться финала + QG architecture → Development. Проверить Rejected-путь живьём.
**Детали:** `tasks/orchestrator/ORCHESTRATOR_DOCS.md` → раздел «🐛 Баги входа/выхода analyst» + `memory/2026-06-03.md`.

### Предыдущая сессия (2026-06-02)
- ORCH-6 multi-repo (PR #2), ORCH-1 очередь (PR #3), Plane-webhook включён с HMAC+project-filter — всё на проде. Подробности: `PROGRESS_2026-06-02.md`.

---

## Общая зрелость

| Фаза (из BRD) | Статус | Комментарий |
|----------------|--------|-------------|
| **Фаза 0: Инфраструктура** | ✅ Завершена | Всё установлено и работает |
| **Фаза 1: Ручной конвейер** | ✅ Завершена | ET-001 прошёл полный цикл |
| **Фаза 2: Orchestrator MVP** | ✅ Завершена (21.05) | QG реальные, автозапуск Claude CLI, 27 тестов |
| **Фаза 3: Plane интеграция** | ✅ Завершена (21.05) | Webhooks + обратная связь (state sync, comments) |
| **Фаза 4: Полный конвейер** | ✅ Первый прогон (21.05) | ET-002 прошёл полный автоматический цикл! |
| **Фаза 5: Оптимизация** | 🟡 В работе | Analyst полностью интегрирован как первая стадия (31.05), 27 тестов green |

---

## 🎉 MILESTONE: Первый полный автоматический прогон (21.05.2026)

**ET-002 "Чекбокс POI в попапе рельефа"** прошёл весь пайплайн автоматически:

```
analysis → architecture → development → review → testing → deploy → done ✅
```

| Стадия | Агент | Результат | Время |
|--------|-------|-----------|-------|
| architecture | Architect (Claude CLI, Opus) | ADR + infra-requirements | ~5 мин |
| development | Developer (Claude CLI, Sonnet) | feat commit + тесты | ~55 мин (docker build) |
| review | Reviewer (Claude CLI, Opus) | APPROVED (0 P0/P1) | ~3 мин |
| testing | Tester (Claude CLI, Sonnet) | PASS (pytest 14/14, JS 7/7) | ~5 мин |
| deploy | Merge PR #5 → main | Merged | — |

**Коммиты на ветке:**
```
c36ee9d test(ET-002): test report PASS - all tests green, ready to deploy
a4a0aab docs(ET-002): code review APPROVED - no P0/P1 findings
8c17a4f feat(web): add POI visibility checkbox to terrain popup
af579f7 docs(ET-002): add ADR-0001 and infra requirements for POI toggle
73c9dc4 docs(ET-002): status → approved
f1f4d5f docs(ET-002): BRD, ТЗ, AC, Test Plan
```

---

## Баги и фиксы (21.05.2026)

| # | Баг | Статус | Фикс |
|---|-----|--------|------|
| 1 | `/repos` mounted as `:ro` | ✅ Исправлен | Убрал `:ro` из docker-compose.yml |
| 2 | `check_review_approved` — PR not found | ✅ Исправлен | Lookup PR по branch + file-based fallback |
| 3 | `git` не установлен в контейнере | ✅ Исправлен | Уже был в Dockerfile (git v2.47.3) |
| 4 | Коммиты от root ломают permissions | ✅ Исправлен | GIT_AUTHOR_NAME/EMAIL = claude-bot в launcher.py |
| 5 | `task_id=NULL` в agent_runs | ✅ Исправлен | task_id передаётся в launch() |
| 6 | Нет timeout для агентов | ✅ Исправлен | Watchdog 30 мин, kill -9 |
| 7 | Нет auto-advance после CI green | ✅ Исправлен | gitea.py: CI green → review, PR approved → testing |
| 8 | Orchestrator не пишет в Plane | ✅ Исправлен | plane_sync.py: state update + comments |
| 9 | `dismiss_stale_approvals` + duplicate CI statuses | ⚠️ Workaround | Временно отключал status check для merge |
| 10 | Developer застревает на `docker build` (~55 мин) | 🔴 Не исправлен | Для frontend-only фич docker build избыточен |

## Баги входа/выхода analyst (03.06.2026) — PR #12–#15

Цепочка из 4 багов, вскрытых при переходе на status-only verdict и боевом прогоне ET-011 (#6, task 29). Полный разбор: `ORCHESTRATOR_DOCS.md`.

| # | PR | Баг | Статус |
|---|----|----|--------|
| Баг 3 | #12 | Эхо-самоудар: собственный коммент analyst сбивал стадию → status-only verdict model | ✅ Смержен |
| Баг A | #13 | `description` из Plane не попадал в `.task.md` (пустышка) | ✅ Смержен |
| Баг B | #13 | `name` не дотягивался → ветка `untitled` | ✅ Смержен |
| Баг C | #13 | Устаревший коммент «Жду :approved:» + нет ссылок на доки | ✅ Смержен |
| — | #14 | Ссылки в комменте на `localhost:3000` (не кликались) → `gitea_public_url` | ✅ Смержен + env |
| **Баг 4** | #15 | **БЛОКЕР:** ручной Approved не двигал конвейер (task застревал в analysis) → развёл `check_analysis_approved` по `finished_agent` | ✅ Смержен, боевой прогон ✅ |

**Baseline тестов:** 210 passed + 9 pre-existing failed (test_webhooks.py, HMAC/401 — off-limits).

---

## Инфраструктура на mva154 (82.22.50.71)

### Контейнеры (docker ps на 21.05.2026)

| Контейнер | Образ | Статус | Порт |
|-----------|-------|--------|------|
| `orchestrator` | orchestrator-orchestrator (self-built) | Up | 127.0.0.1:8500 |
| `openclaw-gateway` | ghcr.io/openclaw/openclaw:latest | Up (healthy) | 127.0.0.1:18789 |
| `enduro-trails-app-1` | enduro-trails-app (self-built) | Up | 0.0.0.0:5558 |
| `gitea` | gitea/gitea:latest | Up | 127.0.0.1:3000, 0.0.0.0:2222 |
| `claude-cli-proxy` | eceasy/cli-proxy-api:latest | Up | 127.0.0.1:8317 |
| `xray` | ghcr.io/xtls/xray-core:latest | Up | — |
| `plane-*` (8 контейнеров) | makeplane/* | Up (healthy) | 0.0.0.0:8091, 0.0.0.0:8443 |

### Установленное ПО на хосте

| Компонент | Версия | Путь |
|-----------|--------|------|
| Claude Code CLI | 2.1.142 | `/usr/bin/claude` (+ mount в orchestrator) |
| Node.js | v24.14.0 | — |
| Docker + Compose | — | — |
| Nginx | — | reverse proxy |
| Gitea Actions Runner | `act_runner` | `/home/slin/act_runner` (online, self-hosted) |

---

## Orchestrator — детальный статус

**Репо:** `/home/slin/repos/orchestrator/`  
**Контейнер:** `orchestrator` (порт 8500, network_mode: host)  
**Конфиг:** `.env`

### Архитектура

```
src/
├── main.py              # FastAPI app
├── config.py            # Settings from env
├── db.py                # SQLite connection
├── stages.py            # Stage machine (8 stages)
├── notifications.py     # Structured logging
├── plane_sync.py        # ← NEW: Plane API sync (state + comments)
├── webhooks/
│   ├── plane.py         # Plane webhook handler + QG orchestration + plane_sync calls
│   └── gitea.py         # Gitea webhook handler (push, PR, CI status) + plane_sync calls
├── qg/
│   └── checks.py        # 6 QG checks (filesystem + Gitea API + Plane API)
└── agents/
    └── launcher.py      # Claude CLI launcher (subprocess.Popen + timeout watchdog)
```

### Stage Machine

```
created → analysis → architecture → development → review → testing → deploy → done
            ↑ QG: files    ↑ QG: ADR      ↑ QG: CI green  ↑ QG: PR approved  ↑ QG: test report
            ↑ Agent: analyst↑ Agent: arch   ↑ Agent: dev    ↑ Agent: reviewer   ↑ Agent: tester
```

### Auto-advance (добавлено 21.05, расширено 31.05)

| Триггер | Действие |
|---------|----------|
| **work_item.created в Plane** | **created → analysis, launch Analyst** |
| **:approved: comment + QG analysis** | **analysis → architecture, launch Architect** |
| Push с ADR файлами | architecture → development, launch Developer |
| CI status = success | development → review, launch Reviewer |
| PR review = approved | review → testing, launch Tester |
| PR review = request_changes | back-to development, relaunch Developer (max 3x) |
| Test report PASS | testing → deploy |

### Plane Sync (добавлено 21.05, расширено 31.05)

| Событие | Действие в Plane |
|---------|-----------------|
| Stage change | PATCH issue state (Todo/In Progress/Done) + comment |
| QG failure | Comment с причиной |
| Task done | State → Done + closing comment |
| Task created (webhook) | Сохраняет `plane_issue_id` для маппинга |
| **Analyst запущен** | **Comment: "🔍 Analyst запущен. BRD/ТЗ/AC/TestPlan в работе..."** |
| **Analyst завершил (exit 0)** | **Comment: "📋 BRD/ТЗ/AC/TestPlan готовы. Прошу :approved:"** |

### Данные в БД (на 21.05.2026)

- events: 40+
- tasks: 6 (ET-001..ET-004 + smoke tests)
- agent_runs: 8 (architect x4, developer x1, reviewer x1, tester x1)
- Таблица tasks: добавлена колонка `plane_issue_id` (UUID из Plane)

### Docker-compose.yml

```yaml
services:
  orchestrator:
    build: .
    container_name: orchestrator
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./data:/app/data
      - /home/slin/repos:/repos          # БЕЗ :ro
      - /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
    env_file: .env
    environment:
      - ORCH_REPOS_DIR=/repos
      - ORCH_HOST_REPOS_DIR=/home/slin/repos
    group_add:
      - "999"
```

---

## Analyst agent (OpenClaw) — статус

| Параметр | Значение |
|----------|----------|
| ID | `analyst` |
| Модель | `vibecode/claude-sonnet-4.6` |
| Workspace | `/home/node/.openclaw/workspace-analyst/` |
| Telegram binding | ✅ account `analyst` (отдельный бот) |
| Статус | ✅ **Полностью зарегистрирован и работает** |
| Orchestrator интеграция | ✅ **Полностью интегрирован** (31.05): автозапуск, QG, :approved: → architecture |

---

## Gitea — статус

| Параметр | Значение |
|----------|----------|
| URL | `https://git.mva154.duckdns.org` |
| Repos | `enduro-trails`, `orchestrator` |
| CI Runner | ✅ `mva154-runner` (online, self-hosted) |
| Branch protection | ✅ main: require 1 approval + CI green |
| Webhooks → Orchestrator | ✅ Работают (push, PR, status events) |
| Service accounts | `admin`, `claude-bot`, `stream` |
| claude-bot token | `38c6fa88...` (write:repository) |

---

## Plane — статус

| Параметр | Значение |
|----------|----------|
| URL | `https://plane.mva154.duckdns.org` |
| Workspace | `ag_proj` |
| Проект | "Enduro Trails" (identifier: ET) |
| Project ID | `7a79f0a9-5278-49cd-9007-9a338f238f9c` |
| Issues | ET-1 (POI checkbox) — **Done** ✅ |
| Webhook → Orchestrator | ✅ Через PostgreSQL trigger (HMAC-SHA256) |
| Orchestrator → Plane | ✅ State sync + comments (plane_sync.py) |

### States в Plane

| ID | Name | Group |
|----|------|-------|
| `113b24f6-...` | Backlog | backlog |
| `2c7d3df3-...` | Todo | unstarted |
| `b873d9eb-...` | In Progress | started |
| `381a2833-...` | Done | completed |
| `b1cae7f9-...` | Cancelled | cancelled |

---

## Репозиторий enduro-trails

**Ветки:** main (актуальная с ET-001 + ET-002 merged)

### Work Items

| ID | Название | Статус |
|----|----------|--------|
| ET-001 | Исключить шлагбаумы и тротуары из OSRM | ✅ Done (ручной цикл) |
| ET-002 | Чекбокс POI в попапе рельефа | ✅ Done (автоматический цикл!) |

---

## Следующие шаги (приоритет)

### Оставшиеся баги

1. **`dismiss_stale_approvals` + duplicate CI statuses** — Gitea создаёт duplicate pending statuses, блокирует merge. Нужно: либо отключить dismiss_stale_approvals, либо чистить stale statuses через API.
2. **Developer застревает на docker build** — для frontend-only фич нужен skip docker build или определение scope по git diff.

### Улучшения для полной автономности

3. **Deploy stage** — автоматический merge PR + deploy (сейчас ручной)
4. **Notifications в Telegram** — отправлять Славе статус при смене stage
5. **Custom fields в Plane** — qg_status, stage, tokens_spent
6. **Лейблы в Plane** — stage:*, back-to:*, escalation:*
7. **Параллельные задачи** — FIFO-очередь (F2-6 из BRD)

---

## Доступ к mva154

**Из OpenClaw контейнера:**
```bash
/home/node/.openclaw/skills/installer/scripts/ssh_exec.sh --host mva154 --cmd "<command>"
```
- Тип: `ssh-direct`, Хост: `82.22.50.71:22`, User: `slin`

---

## Документация проекта

| Файл | Описание |
|------|----------|
| `tasks/multi-agent/BRD.md` | Полный BRD с архитектурой, QG, roadmap |
| `tasks/multi-agent/BACKLOG.md` | Бэклог + решения по Analyst |
| `tasks/multi-agent/STATUS.md` | **Этот файл** — актуальный статус |
| `tasks/multi-agent/DEV_TASK_ORCHESTRATOR_QG.md` | ТЗ: QG + автозапуск (выполнено) |
| `tasks/multi-agent/DEV_TASK_ORCHESTRATOR_FIXES.md` | ТЗ: 5 критических фиксов (выполнено) |
| `tasks/multi-agent/DEV_TASK_PLANE_SYNC.md` | ТЗ: Plane sync (выполнено) |
| `tasks/multi-agent/DEV_TASK_WEBHOOKS.md` | ТЗ: Webhooks (выполнено) |