Surfaces_team/surfaces
4
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions
surfaces/.planning/ROADMAP.md
Mikhail Putilovskij e73e13e758 docs(05-02): complete room-local clear plan 
- add execution summary for room-local clear and strict routing
- update roadmap and state with plan 05-02 completion metadata
2026-04-28 01:17:48 +03:00

5 KiB
Raw Permalink Blame History

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:

  • 01-01-PLAN.md — Space+rooms infrastructure (store helpers, handle_invite rewrite, room_router)
  • 01-02-PLAN.md — Chat command handlers (!new, !archive, !rename) Space-aware
  • 01-03-PLAN.md — Reaction removal + !yes/!no confirmation + settings dashboard
  • 01-04-PLAN.md — Test suite (fix 4 broken + 12 new MAT-01..MAT-12)
  • 01-05-PLAN.md — Gap closure for Matrix !yes / !no pending-confirm scope
  • 01-06-PLAN.md — Remaining Phase 01 gap closure work (completed 2026-04-03)

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 готов

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:

  • 04-01-PLAN.md — Replace AgentSessionClient with AgentApi; update sdk/real.py, bot.py, broken tests
  • 04-02-PLAN.md — !save, !load, !reset, !context handlers; PrototypeStateStore extensions; numeric interception
  • 04-03-PLAN.md — Dockerfile + docker-compose.yml + .env.example update

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:

  • 05-01-PLAN.md — Startup reconciliation from authoritative Matrix Space topology before live sync
  • 05-02-PLAN.md — Room-local platform_chat_id routing and real !clear semantics
  • 05-03-PLAN.md — Shared-volume attachment path hardening for /agents deployment
  • 05-04-PLAN.md — Split bot-only prod compose from internal fullstack compose and update docs

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

Phase 3: Production Hardening

Goal: Подготовить боты к реальному деплою — конфиг, логирование, мониторинг, обработка ошибок.

Depends on: Phase 2

Deliverables:

  • Docker / systemd конфиг для деплоя
  • Структурированное логирование в production формате
  • Health-check endpoint (если нужен)
  • Rate limiting и защита от спама
  • Graceful shutdown