docs: clean up GSD planning state and remove outdated legacy phases
This commit is contained in:
parent
65445f516f
commit
9fc0b72ab1
12 changed files with 61 additions and 1386 deletions
|
|
@ -1,101 +1,32 @@
|
|||
# Roadmap — v1.0
|
||||
|
||||
## Milestone: v1.0 — Production-ready surfaces
|
||||
|
||||
### Phase 1: Matrix QA & Polish
|
||||
|
||||
**Goal:** Переработать Matrix адаптер с DM-first на Space+rooms, убрать реакции в пользу !yes/!no, довести до уровня "приемлемо работает" как Telegram.
|
||||
|
||||
**Depends on:** Telegram QA complete
|
||||
|
||||
**Plans:** 6 plans
|
||||
|
||||
Plans:
|
||||
- [x] 01-01-PLAN.md — Space+rooms infrastructure (store helpers, handle_invite rewrite, room_router)
|
||||
- [x] 01-02-PLAN.md — Chat command handlers (!new, !archive, !rename) Space-aware
|
||||
- [x] 01-03-PLAN.md — Reaction removal + !yes/!no confirmation + settings dashboard
|
||||
- [x] 01-04-PLAN.md — Test suite (fix 4 broken + 12 new MAT-01..MAT-12)
|
||||
- [x] 01-05-PLAN.md — Gap closure for Matrix `!yes` / `!no` pending-confirm scope
|
||||
- [x] 01-06-PLAN.md — Remaining Phase 01 gap closure work (completed 2026-04-03)
|
||||
## Milestone: v1.0 — Production-ready Matrix MVP
|
||||
|
||||
### Phase 01: Matrix QA & Polish
|
||||
**Goal:** Переработать Matrix адаптер с DM-first на Space+rooms, убрать реакции в пользу `!yes`/`!no`.
|
||||
**Status:** Completed
|
||||
**Deliverables:**
|
||||
- Space+rooms architecture for Matrix adapter
|
||||
- !yes/!no text-based confirmation (no reactions)
|
||||
- Read-only !settings dashboard
|
||||
- 96+ tests green
|
||||
|
||||
---
|
||||
|
||||
### Phase 01.1: Matrix restart reconciliation and dev reset workflow (INSERTED)
|
||||
|
||||
**Goal:** Сделать Matrix-адаптер пригодным для повторяемого локального рестарта и ручного QA: бот восстанавливает минимальный local state из существующих Space/rooms и даёт явный dev reset workflow вместо ручного ritual reset.
|
||||
**Requirements**: none explicitly mapped
|
||||
**Depends on:** Phase 1
|
||||
**Plans:** 3 plans
|
||||
|
||||
Plans:
|
||||
- [ ] 01.1-01-PLAN.md — Non-destructive Matrix reconciliation module and tests
|
||||
- [ ] 01.1-02-PLAN.md — Wire startup/bootstrap recovery into the Matrix runtime
|
||||
- [ ] 01.1-03-PLAN.md — Dev reset CLI and updated Matrix restart runbook
|
||||
|
||||
### Phase 2: SDK Integration
|
||||
|
||||
**Goal:** Заменить MockPlatformClient реальным Lambda SDK — бот начинает работать с настоящим AI-агентом.
|
||||
|
||||
**Depends on:** Phase 1, Lambda platform SDK готов
|
||||
- !yes/!no text-based confirmation
|
||||
- Test suite green
|
||||
|
||||
### Phase 04: Matrix MVP: Agent Integration
|
||||
**Goal:** Подключить реального агента через `AgentApi`, добавить команды управления контекстом (`!clear`).
|
||||
**Status:** Completed
|
||||
**Deliverables:**
|
||||
- `sdk/real.py` — реализация PlatformClient через реальный SDK
|
||||
- `bot.py` для обоих адаптеров переключается на реальный клиент через env var
|
||||
- `stream_message` работает с реальным стримингом
|
||||
- Интеграционные тесты с реальным SDK (или staging)
|
||||
|
||||
### Phase 4: Matrix MVP: shared agent context and context management commands
|
||||
|
||||
**Goal:** Привести Matrix-бот к рабочему состоянию для MVP-деплоя: заменить AgentSessionClient на AgentApi, добавить !save/!load/!reset/!context команды управления контекстом агента, упаковать в Docker.
|
||||
**Requirements**: Replace AgentSessionClient with AgentApi; Wire AgentApi lifecycle; Implement !save, !load, !reset, !context commands; Dockerfile + docker-compose
|
||||
**Depends on:** Phase 1 (Matrix adapter complete)
|
||||
**Plans:** 3 plans
|
||||
|
||||
Plans:
|
||||
- [x] 04-01-PLAN.md — Replace AgentSessionClient with AgentApi; update sdk/real.py, bot.py, broken tests
|
||||
- [x] 04-02-PLAN.md — !save, !load, !reset, !context handlers; PrototypeStateStore extensions; numeric interception
|
||||
- [x] 04-03-PLAN.md — Dockerfile + docker-compose.yml + .env.example update
|
||||
|
||||
---
|
||||
- `sdk/real.py` — реализация `PlatformClient` через реальный SDK (`AgentApi`).
|
||||
- Поддержка WebSocket стриминга.
|
||||
- Команды управления контекстом.
|
||||
- Обертка в Docker.
|
||||
|
||||
### Phase 05: MVP Deployment
|
||||
|
||||
**Goal:** Подготовить Matrix-бот к реальному деплою на lambda.coredump.ru без потери Space+rooms UX: закрепить per-room `platform_chat_id`, реальный `!clear`, reconciliation, file transfer через shared volume и разделение prod/fullstack compose.
|
||||
|
||||
**Depends on:** Phase 4
|
||||
|
||||
**Plans:** 4/4 plans complete
|
||||
|
||||
Plans:
|
||||
- [x] 05-01-PLAN.md — Startup reconciliation from authoritative Matrix Space topology before live sync
|
||||
- [x] 05-02-PLAN.md — Room-local `platform_chat_id` routing and real `!clear` semantics
|
||||
- [x] 05-03-PLAN.md — Shared-volume attachment path hardening for `/agents` deployment
|
||||
- [x] 05-04-PLAN.md — Split bot-only prod compose from internal fullstack compose and update docs
|
||||
|
||||
**Goal:** Подготовить Matrix-бот к реальному деплою на lambda.coredump.ru с маршрутизацией по агентам и передачей файлов.
|
||||
**Status:** Completed
|
||||
**Deliverables:**
|
||||
- Space+rooms onboarding remains the primary Matrix UX
|
||||
- Per-room `platform_chat_id` provides true context isolation and `!clear`
|
||||
- Reconciliation restores room metadata and routing after restart
|
||||
- File transfer uses shared `/agents/` volume with room-safe behavior
|
||||
- `docker-compose.prod.yml` is bot-only handoff; `docker-compose.fullstack.yml` is for internal E2E testing
|
||||
- Загрузка `matrix-agents.yaml` для маппинга пользователей к агентам.
|
||||
- Per-room `platform_chat_id` routing.
|
||||
- File transfer через shared `/agents/` volume.
|
||||
- Разделение `docker-compose.prod.yml` и `docker-compose.fullstack.yml`.
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: Production Hardening
|
||||
|
||||
**Goal:** Подготовить боты к реальному деплою — конфиг, логирование, мониторинг, обработка ошибок.
|
||||
|
||||
**Depends on:** Phase 2
|
||||
|
||||
**Deliverables:**
|
||||
- Docker / systemd конфиг для деплоя
|
||||
- Структурированное логирование в production формате
|
||||
- Health-check endpoint (если нужен)
|
||||
- Rate limiting и защита от спама
|
||||
- Graceful shutdown
|
||||
*Note: Легаси-фазы, связанные с Telegram, прототипами и Mock-платформой, были удалены из Roadmap после закрепления архитектуры MVP в ветке main.*
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue