Chimera Agent 0.45.1 исправляет сбой при запуске Docker в headless-режиме

Развертывание в Docker больше не завершается сбоем при запуске

В Chimera Agent 0.45.0 была обнаружена регрессия, при которой headless-контейнеры Docker, запускающие сервис шлюза, завершались сбоем сразу после старта. Проблема возникала из-за того, что путь cron начинал импортировать chimera.api.usage, что вызывало преждевременную загрузку зависимостей FastAPI — несмотря на то, что образ Docker намеренно не включал desktop extra.

Это не было обнаружено во время тестирования, так как в средах разработки FastAPI обычно установлен. Все 2,945 существующих тестов прошли успешно, поскольку они выполнялись в средах, где зависимость случайно присутствовала. Сбой проявлялся только в рабочих развертываниях с использованием минимальной установки .[full].

Ленивые импорты предотвращают скрытые зависимости

Исправление устраняет корневую причину, а не просто добавляет недостающие зависимости. Ранее пять CLI-доступных модулей в chimera/api незаметно подтягивали весь веб-стек через преждевременные реэкспорты в __init__.py. В v0.45.1 эти импорты стали ленивыми, поэтому они загружаются только тогда, когда действительно необходимы компонентам, связанным с вебом.

Это сохраняет документально зафиксированное разделение, при котором ядро CLI/шлюза не должно требовать веб-зависимостей, но при этом гарантирует, что chimera app четко завершится с ошибкой, если FastAPI отсутствует в законных случаях использования веба.

Новый тест предотвращает регрессию

Теперь добавлен специальный тест, который проверяет это поведение, запускаясь в подпроцессе, где fastapi намеренно сделан недоступным для импорта. Тест сначала подтверждает, что настройка среды работает, прежде чем переходить к другим проверкам — это позволяет выявить случаи, когда тесты молча проходили из-за загрязнения среды.

Исправление было проверено на всех этапах с чистой установкой .[full]. Headless-развертывания в Docker теперь могут запускать serve --cron, как и ожидалось.

Для существующих развертываний, затронутых этой проблемой, рекомендуется обновиться до v0.45.1. [Заметки о выпуске]Chimera Agent v0.45.1 содержат полную информацию об изменениях по сравнению с v0.45.0.