--- name: onec-onescript-and-autumn description: "Разрабатывает и тестирует приложения, CLI-утилиты, библиотеки и MCP-серверы на OneScript (oscript, opm, packagedef, OneUnit, 1testrunner, фреймворк Autumn DI). Используй для пакетов .os/.opm, консольных инструментов экосистемы 1С и компонентной архитектуры Autumn." --- # Разработка пакетов, тестов и сервисов на OneScript и Autumn Используй навык, когда задача относится не к конфигурации внутри платформы 1С:Предприятие, а к скриптам, библиотекам, CLI-инструментам или серверам на **OneScript (`oscript`)**, пакетному менеджеру **`opm`** и DI-фреймворку **`Autumn`**. ## Контракт пакета OneScript и `packagedef` - Проверь структуру пакета по файлу `packagedef`: имя пакета, семантическая версия, поддерживаемая версия движка `oscript` (учитывай различия линейки 1.x и 2.x), точки входа исполняемых команд, экспортируемые классы/модули и список зависимостей (`Зависимость(...)`). - Не полагайся на глобально установленные на машине разработчика пакеты, не объявленные в `packagedef`, и не хардкодь локальные пути к `oscript_modules` вне стандартного разрешения библиотек (`oscript.cfg` / `lib.system` / `lib.additional`). - **Проверка чистоты поставки**: собранный пакет `.ospx` должен устанавливаться и запускаться в чистом временном каталоге без доступа к исходному репозиторию разработки (чтобы вовремя обнаружить забытые файлы, регистрозависимые пути на Linux/macOS против Windows и неуказанные транзитивные зависимости). - Для консольных и `stdio`-протоколов (например, JSON-RPC / MCP поверх `Консоль`) строго разделяй стандартный поток вывода `stdout` (только валидные сообщения протокола без отладочных `Сообщить(...)` и BOM) и поток ошибок/диагностики `stderr`. ## Модульное и сценарное тестирование (`OneUnit` и `1testrunner`) - Установи, какой именно тестовый раннер использует репозиторий (`oneunit` с аннотациями `&Тест` / `&ПередКаждым` или `1testrunner` с `ЗагрузитьИПроверить` / экспортными процедурами тест-кейсов), и следуй его контракту жизненного цикла — не смешивай соглашения двух фреймворков в одном тестовом модуле. - Обеспечивай **полную изоляцию фикстур**: временные файлы, каталоги, дочерние процессы и переменные окружения создавай в уникальной временной директории теста и гарантированно очищай в блоке `Попытка ... Исключение ... КонецПопытки` / `&ПослеКаждого`. Падение одного теста не должно оставлять заблокированный порт, висящий дочерний процесс или мусор для следующего теста. - Тестируй как штатный путь, так и граничные отказы (невалидный JSON/аргумент CLI, отсутствующий файл, ненулевой код возврата внешней команды). ## Компонентные границы во фреймворке Autumn При использовании контейнера внедрения зависимостей **Autumn** (`Поделка`, `Деталь`, `Фабрика`, аннотации жизненного цикла): - Чётко разделяй компоненты инфраструктуры (транспорт, логгер, работа с ФС/процессами) и компоненты предметной логики; передавай зависимости через внедряемые поля/сеттеры контейнера, а не через скрытые глобальные синглтоны. - Проверяй область жизни компонента (одиночка на процесс или новый экземпляр на запрос/команду): изменяемое состояние конкретного запроса не должно храниться в полях разделяемого компонента-одиночки. - При расширении сторонних библиотек экосистемы (например, `autumn-mcp`, `logos`, `cli`) локальные исправления до принятия апстримом оформляй воспроизводимым патчем поверх зафиксированной версии в `opm` / `mise.toml`, а не ручным редактированием каталога `oscript_modules` без фиксации.