surfaces/.planning/codebase/TESTING.md

Тестирование (TESTING.md)

Unit-тесты

Расположены в tests/. Покрытие сфокусировано на логике Matrix адаптера (пока он является основной поверхностью):

• Файловый контракт (test_files.py)
• Диспетчер и конвертация (test_dispatcher.py)
• Взаимодействие с PlatformClient (test_routed_platform.py)
• Работа с контекстными командами бота (test_context_commands.py)

E2E тестирование

Локально тестируется через запуск контейнеров из docker-compose.fullstack.yml, который поднимает один инстанс бота и один локальный platform-agent. Это позволяет имитировать полную цепочку взаимодействия (Matrix -> Бот -> Агент) с общим каталогом для файлов.

Запуск тестов

# Запуск юнит-тестов (только для Matrix адаптера)
pytest tests/adapter/matrix/ -v