docs: clean up GSD planning state and remove outdated legacy phases

.planning/PROJECT.md

@@ -2,56 +2,44 @@
 
 ## What This Is
 
-Telegram и Matrix боты для взаимодействия пользователя с AI-агентом Lambda. Каждый бот — тонкий адаптер поверх общего ядра (`core/`), изолирующего бизнес-логику от транспорта. Платформа подключается через `sdk/interface.py` Protocol; сейчас используется `MockPlatformClient`.
+Surfaces (поверхности) — это тонкие адаптеры-клиенты, соединяющие мессенджеры с агентами платформы Lambda. 
+Текущая и главная реализация — **Matrix MVP**. Бот работает как stateless-прослойка: преобразует события Matrix во внутренний протокол `core/` и маршрутизирует их на внешние контейнеры агентов (через `AgentApi` по WebSocket). 
 
 ## Core Value
 
-Пользователь может вести диалог с Lambda-агентом через любой из поддерживаемых мессенджеров без изменения ядра системы.
+Пользователь может бесшовно взаимодействовать с изолированными AI-агентами через нативные интерфейсы мессенджеров (с поддержкой пересылки файлов и работы в комнатах), в то время как сама платформа агентов не зависит от транспорта.
 
 ## Requirements
 
 ### Validated
 
-- ✓ core/ — унифицированный протокол событий, EventDispatcher, StateStore, ChatManager, AuthManager, SettingsManager — existing
-- ✓ adapter/telegram/ — forum-first адаптер (Threaded Mode), `/start`, `/new`, `/archive`, `/rename`, `/settings`, стриминг ответов — existing, QA passed
-- ✓ adapter/matrix/ — Space+rooms адаптер, invite flow, `!new`, `!archive`, `!rename`, `!settings`, room-per-chat — existing
-- ✓ sdk/mock.py — MockPlatformClient: `stream_message`, `get_or_create_user`, `get_settings`, `update_settings` — existing
+- ✓ `core/` — унифицированный протокол событий, EventDispatcher, StateStore, ChatManager.
+- ✓ `adapter/matrix/` — Space+rooms адаптер. Прием инвайтов, автосоздание иерархии комнат, команды `!new`, `!archive`, `!clear`, `!yes`/`!no`.
+- ✓ `sdk/real.py` — интеграция с AgentApi. Поддержка WebSocket для обмена сообщениями и передачи вложений в обе стороны.
+- ✓ Shared Volume — прямая передача файлов в локальные рабочие папки агентов (`/agents/`).
+- ✓ Dynamic Routing — маршрутизация чатов к агентам на основе `config/matrix-agents.yaml`.
+- ✓ Deployment — Разделение окружений на `docker-compose.prod.yml` (только бот) и `docker-compose.fullstack.yml` (бот + локальный агент для E2E).
 
-### Active
+### Out of Scope / Deferred
 
-- [ ] Matrix QA — ручное тестирование Matrix адаптера, фиксация багов
-- [ ] SDK integration — заменить MockPlatformClient реальным Lambda SDK (когда платформа готова)
-- [ ] Production hardening — конфиг для деплоя, логирование, мониторинг
-
-### Out of Scope
-
-- E2EE для Matrix (python-olm не собирается на macOS/ARM) — инфраструктурная задача, отдельный трек
-- Supergroup forum mode для Telegram — заменён Threaded Mode как основным режимом
-- Telegram DM-first режим — заменён forum-first (Threaded Mode)
+- E2EE для Matrix (отложено из-за сложностей сборки `python-olm` на кросс-платформенных средах).
+- Интеграция с Master-сервисом платформы (временно используется прямое соединение с `platform-agent` через AgentApi).
+- Telegram-адаптер (вынесен в легаси ветку `feat/telegram-adapter`, MVP фокусируется на Matrix).
 
 ## Context
 
-- Python 3.11+, aiogram 3.4+, matrix-nio 0.21+, SQLite, pytest-asyncio
-- Threaded Mode — Bot API 9.3, Mac клиент имеет известные баги (новые топики не сразу видны в сайдбаре)
-- Lambda platform SDK ещё не готов, всё работает через MockPlatformClient
-- Архитектура: Hexagonal / Ports-and-Adapters; `core/` не зависит от транспорта
-
-## Constraints
-
-- **Tech stack**: aiogram 3.x для Telegram, matrix-nio для Matrix — не менять без обсуждения
-- **Platform**: SDK подключается только через `sdk/interface.py` Protocol — core/ и adapters не трогаются при смене реализации
-- **Telegram**: Threaded Mode — единственный поддерживаемый режим; `closeForumTopic`/`deleteForumTopic` не работают в personal chat forums
-- **E2EE**: python-olm не собирается на текущей среде — Matrix работает только без шифрования
+- Стек: Python 3.11+, `matrix-nio`, `uv`, `pydantic`.
+- Бот хранит только локальную привязку (`room_id` <-> `platform_chat_id`) в SQLite. Вся долговременная память и история диалогов хранятся на стороне агента.
+- Жизненный цикл контейнеров агентов управляется платформой, а не ботом.
 
 ## Key Decisions
 
 | Decision | Rationale | Outcome |
 |----------|-----------|---------|
-| Forum-first (Threaded Mode) для Telegram | Bot API 9.3 позволяет личный чат как форум — чище, без суперпруппы | ✓ Good |
-| (user_id, thread_id) как PK в chats | Изоляция контекстов по топику | ✓ Good |
-| MockPlatformClient через sdk/interface.py | Не ждать SDK, разрабатывать независимо | ✓ Good |
-| Space+rooms для Matrix | Room-based UX и явные чаты важнее DM-first упрощений | ✓ Good |
-| Отказ от E2EE в Matrix | python-olm не собирается на macOS/ARM | — Pending |
+| Space+rooms для Matrix | Room-based UX и явные чаты (по одному на тред) удобнее, чем DM-каша | ✓ Good |
+| Прямая интеграция AgentApi | Master API не был готов, прямое WebSocket соединение позволяет передавать стейт и файлы | ✓ Good |
+| Shared Volume для файлов | Избавляет от необходимости гонять base64 по сети, быстрый прямой доступ к файлам | ✓ Good |
+| Stateless бот | Бот легко перезапускать и масштабировать, память изолирована в агентах | ✓ Good |
 
 ## Evolution
 
@@ -61,10 +49,5 @@ Telegram и Matrix боты для взаимодействия пользова
 3. New requirements emerged? → Add to Active
 4. Decisions to log? → Add to Key Decisions
 
-**After each milestone:**
-1. Full review of all sections
-2. Core Value check — still the right priority?
-3. Update Context with current state
-
 ---
-*Last updated: 2026-04-02 after initialization*
+*Last updated: 2026-05-03 after codebase consolidation*