saga

S.A.G.A. (Story Analysis, Generation, and Archives) описывается как обладающий знанием канона нарративный интеллект для анализа, поиска, построения временных шкал и генерации историй. Вместо одного монолитного приложения проект организован как коллекция многоразовых рантаймов, управляемых контрактами. Что он делает В README указано, что S.A.G.A. анализирует исходные книги для создания подтвержденного доказательствами канона, генерирует обоснованные истории и визуальные активы, синтезирует проверенные аудиокниги и упаковывает артефакты релизов. Путь оркестрации производства задокументирован как последовательность: прием исходных данных и основа анализа; разрешение идентичности Modal XCore LitBank; извлечение канона; моделирование персонажей и мира; планирование генерации; генерация повествования и семантическая поддержка; визуальная генерация и QA изображений; синтез аудиокниг и QA транскрипции; и, наконец, отчетность по EPUB, манифесту, происхождению и квалификации. Архитектура Активное дерево исходного кода имеет четыре основные поверхности: - packages/ — независимые пакеты рантаймов, охватывающие агентов, рассуждения, поиск, персистентность, исполнение, идентичность, генерацию медиа, наблюдаемость, происхождение, квалификацию и развертывание. - integrations/ — реализации провайдеров для ComfyUI, Kokoro TTS и XCore LitBank на Modal. - apps/dashboard_api/ — интерфейс управления и запросов на базе stateless FastAPI. - apps/dashboard_pro/ — панель оператора на React. Supabase Postgres, pgvector и объектное хранилище выступают в качестве провайдеров персистентности за packages/persistence_runtime. Исполнение LangGraph закреплено за packages/agent_runtime. Учетные данные провайдеров хранятся в хранилищах секретов персистентности или развертывания и внедряются в рантаймы, а не фиксируются в системе контроля версий. Заметным проектным решением является сохранение более ранней реализации в качестве инертного справочного материала в backup/reference/. Активному коду запрещено импортировать его, и эта граница обеспечивается автоматизированным тестом архитектурных границ. Дополнительные файлы документации охватывают архитектуру хранения и аудит укрепления архитектуры. Рабочий процесс разработки Зависимости Python зафиксированы с помощью uv, задокументированные команды: uv sync --frozen --extra dev uv run pytest -q Разработка панели управления осуществляется с помощью npm ci, npm test -- --run и npm run build внутри apps/dashboard_pro. API запускается командой uv run saga-runtime-api после настройки среды Supabase. Производство и операции Топология производства и операции находятся в deploy/production/ и задокументированы в docs/deployment_operations.md. Развертывание разделено на отдельные процессы для API, воркеров, планировщика, наблюдаемости, фронтенда, миграций и коллектора телеметрии. Для проверки конфигурации и запуска предоставляется рабочий процесс docker compose. Базовые образы контейнеров и коллектор OpenTelemetry зафиксированы по дайджесту. CI публикует образы рантайма и панели управления из основной ветки, отклоняет существующие теги версий, создает аттестации происхождения и хранит манифест релиза, содержащий коммит и дайджесты образов. Продвижение в продакшн описывается как «закрытое при сбое» (fail closed), если манифест развертывания не имеет чистых подтвержденных данных о происхождении исходного кода. Индекс документации README ссылается на docs/system_agent_roadmap.md и docs/production_qualification.md для статуса реализации и квалификации, а также на операционные справочники по развертыванию (сборка, развертывание, откат, резервное копирование, восстановление), владению секретами рантайма, контрактам хранения и границам провайдеров, сквозной оркестрации, принятым доказательствам квалификации реальных книг и аудиту целостности архитектуры. Оценка Репозиторий лучше всего понимать как инфраструктуру для обоснованного, учитывающего канон производства историй: он объединяет поиск и разрешение идентичности по исходным книгам с этапами генерации текста, изображений и аудио, и завершается упаковкой релиза и CI, ориентированным на происхождение. README делает упор на архитектуру и детали операционных контрактов и не публикует заявлений о бенчмарках или качестве; заявления о возможностях следует рассматривать вместе с документацией по квалификации, на которую он ссылается.