From 6dde5be17d74277b51fd0397b14f311710e60fe5 Mon Sep 17 00:00:00 2001 From: Mikhail Putilovskij Date: Sun, 3 May 2026 00:11:01 +0300 Subject: [PATCH] docs: simplify testing section in new surface guide --- docs/new-surface-guide.md | 41 +-------------------------------------- 1 file changed, 1 insertion(+), 40 deletions(-) diff --git a/docs/new-surface-guide.md b/docs/new-surface-guide.md index f3b72b0..7ebdc2a 100644 --- a/docs/new-surface-guide.md +++ b/docs/new-surface-guide.md @@ -252,37 +252,7 @@ Matrix surface поддерживает staged attachments: --- -## 8. Тестирование и валидация - -### 8.1. Юнит-тесты - -В ветке есть покрытие для Matrix surface: - -- `tests/adapter/matrix/test_files.py` -- `tests/adapter/matrix/test_dispatcher.py` -- `tests/adapter/matrix/test_routed_platform.py` -- `tests/adapter/matrix/test_reconciliation.py` -- `tests/adapter/matrix/test_context_commands.py` - -Для Платформа создайте аналогичные тесты: - -- проверка загрузки вложений -- проверка маршрутизации по `agent_id` -- проверка восстановления `platform_chat_id` -- проверка конвертации команд - -### 8.2. Smoke-проверка deployment - -Для Matrix surface есть `docker-compose.prod.yml` и `docker-compose.fullstack.yml`. - -Для New surface должно быть достаточно: - -- bot-only production deployment -- shared volume `/agents` -- независимая проверка `config/-agents.yaml` -- проверка, что surface запускается без локального агента - -### 8.3. Локальное E2E тестирование (fullstack) +## 8. Локальное тестирование Для тестирования новой поверхности вместе с одним локальным агентом используйте паттерн `docker-compose.fullstack.yml`. В этом режиме: @@ -294,15 +264,6 @@ Matrix surface поддерживает staged attachments: Это самый быстрый способ проверить интеграцию новой платформы без внешнего бэкенда. -### 8.4. Проверка контрактов - -Особое внимание: - -- `agent_registry` должен загружать `workspace_path` -- file flow должен поддерживать `workspace_path` в `Attachment` -- отправка файлов должна использовать `resolve_workspace_attachment_path()` -- `platform_chat_id` должен существовать до вызова агента - --- ## 9. Реализация шаг за шагом