surfaces/.planning/ROADMAP.md

Roadmap — v1.0

Milestone: v1.0 — Production-ready surfaces

Phase 1: Matrix QA & Polish

Goal: Проверить Matrix адаптер в ручном режиме, зафиксировать и устранить все найденные баги — до уровня "приемлемо работает" как у Telegram.

Depends on: Telegram QA complete ✓

Deliverables:

• Ручной QA Matrix бота (invite flow, !new, !skills, !soul, !safety, room-per-chat)
• Все критические баги исправлены
• 96+ тестов зелёные

---

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 3: Production Hardening

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

Depends on: Phase 2

Deliverables:

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