surfaces/.planning/codebase/STACK.md

Технологический стек (STACK.md)

Язык и Runtime

• Python: 3.11-slim (используется в Docker-образах)
• Пакетный менеджер: uv (используется для быстрой и строгой установки зависимостей, frozen lockfiles).

Ключевые библиотеки

• matrix-nio: Асинхронный клиент для Matrix (события, синхронизация, отправка).
• pydantic: Для валидации структур данных (события из AgentApi).
• structlog: Структурированное логирование (json/console).

Инфраструктура

• Docker / Docker Compose: Используется для локального (fullstack) и продакшн развертывания.
• SQLite: Легковесная локальная база данных для хранения маппингов пользователей/комнат (adapter/matrix/store.py).