surfaces/.planning/STATE.md

gsd_state_version	milestone	milestone_name	status	last_updated	progress
1.0	v1.0	— Production-ready surfaces	MVP Deployed	2026-05-03T23:00:00Z	total_phases completed_phases total_plans completed_plans 3 3 13 13

State

Project Reference

See: .planning/PROJECT.md (updated 2026-05-03)

Core value: Пользователь бесшовно взаимодействует с изолированными агентами через нативные интерфейсы (Matrix), в то время как платформа агентов не зависит от транспорта. Current focus: Итерационное развитие текущей архитектуры, добавление новых фич и поверхностей (по мере необходимости).

Current Phase

Текущий MVP успешно завершен. Все базовые механизмы внедрены и работают:

• Маршрутизация к AgentApi
• Shared Volume файловый обмен (/agents/)
• Dynamic config через matrix-agents.yaml
• Изоляция контекстов через platform_chat_id

Проект находится в чистом состоянии для начала нового планирования. Неактуальные легаси фазы и прототипы (Telegram, MockPlatformClient) удалены из Roadmap и трекинга.

Decisions

• Space+rooms для Matrix: Разделение тредов на отдельные Matrix-комнаты, собранные в едином Space пользователя.
• AgentApi: Прямая интеграция с локальным агентом без Master-прослойки по WebSocket.
• Shared Volume: Файлы кладутся напрямую в рабочую папку агента, избавляя от необходимости гонять их по сети в Base64.
• Статическая маршрутизация: На данном этапе пользователи маппятся на агентов жестко через YAML.

Blockers

• Отсутствуют. Проект готов к деплою (см. docker-compose.prod.yml).

Accumulated Context

Roadmap Evolution

• Изначальный Roadmap включал множество ответвлений (прототипы Telegram, локальный mock-клиент). После закрепления MVP в main Roadmap был очищен, чтобы отражать только актуальный путь продукта.
• Следующие фазы будут добавляться по мере возникновения новых задач (например, переход от YAML-конфига к БД для реестра агентов).