saga

S.A.G.A. (Story Analysis, Generation, and Archives) は、分析、検索、タイムライン管理、およびストーリー生成のための、カノン（正典）を認識するナラティブ・インテリジェンスとして記述されています。単一のモノリシックなアプリケーションではなく、このプロジェクトは再利用可能なランタイムのコントラクト駆動型コレクションとして構成されています。 機能 READMEによると、S.A.G.A.はソース本を根拠に基づいたカノンへと分析し、根拠のあるストーリーと視覚的アセットを生成し、監査済みのオーディオブックを合成し、リリースアーティファクトをパッケージ化します。プロダクションのオーケストレーションパスは、以下のシーケンスとして文書化されています：ソースの取り込みと分析基盤、Modal XCore LitBankによるアイデンティティ解決、カノン抽出、キャラクターおよびワールドモデリング、生成プランニング、ナラティブ生成とセマンティックサポート、視覚的生成と画像QA、オーディオブック合成と文字起こしQA、そして最終的にEPUB、マニフェスト、リネージ、および適格性レポートの作成です。 アーキテクチャ アクティブなソースツリーには、主に4つのサーフェスがあります： - packages/ — エージェント、推論、検索、永続化、実行、アイデンティティ、メディア生成、オブザーバビリティ、リネージ、適格性、およびデプロイメントをカバーする独立したランタイムパッケージ。 - integrations/ — ComfyUI、Kokoro TTS、およびModal上のXCore LitBankのプロバイダー実装。 - apps/dashboard_api/ — ステートレスな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 ダッシュボードの開発は、apps/dashboard_pro内でnpm ci、npm test -- --run、およびnpm run buildを使用して行われます。APIは、Supabase環境を構成した後、uv run saga-runtime-apiで起動します。 プロダクションおよび運用 プロダクションのトポロジーと運用はdeploy/production/に配置され、docs/deployment_operations.mdに文書化されています。デプロイメントは、API、ワーカー、スケジューラ、オブザーバビリティ、フロントエンド、マイグレーション、およびテレメトリコレクターの個別のプロセスに分割されています。構成の検証と起動のためにdocker composeワークフローが提供されています。 コンテナのベースイメージとOpenTelemetryコレクターはダイジェストで固定されています。CIはメインブランチからランタイムおよびダッシュボードイメージを公開し、既存のバージョンタグを拒否し、プロバナンス証明を作成し、コミットとイメージダイジェストを含むリリースマニフェストを保存します。プロダクションへの昇格は、デプロイメントマニフェストにクリーンにコミットされたソースプロバナンスがない限り、フェイルクローズ（拒否）されるように記述されています。 ドキュメントインデックス READMEは、実装および適格性のステータスについてはdocs/system_agent_roadmap.mdおよびdocs/production_qualification.mdを、またデプロイメント（ビルド、ロールアウト、ロールバック、バックアップ、リカバリ）、ランタイムシークレットの所有権、ストレージコントラクトとプロバイダー境界、エンドツーエンドのオーケストレーション、承認された実本適格性の根拠、およびアーキテクチャ整合性監査に関する運用リファレンスを指し示しています。 評価 このリポジトリは、根拠に基づいたカノン認識ストーリー制作のためのインフラストラクチャとして理解するのが最適です。ソース本に対する検索とアイデンティティ解決を、テキスト、画像、オーディオの生成ステージと組み合わせ、最終的にリリースパッケージングとプロバナンス指向のCIで締めくくります。READMEはアーキテクチャと運用のコントラクト詳細に重点を置いており、ベンチマークや品質に関する主張は公開していません。機能に関する記述は、参照されている適格性ドキュメントと照らし合わせて読み取る必要があります。