saga

S.A.G.A. (Story Analysis, Generation, and Archives)는 분석, 검색, 타임라인 및 스토리 생성을 위한 캐논 인식(canon-aware) 서사 지능으로 설명됩니다. 이 프로젝트는 단일한 모놀리식 애플리케이션이 아니라, 재사용 가능한 런타임들의 계약 기반 컬렉션으로 구성되어 있습니다. 주요 기능 README에 따르면 S.A.G.A.는 소스 북을 분석하여 증거 기반의 캐논을 구축하고, 근거가 확실한 스토리와 시각적 자산을 생성하며, 검증된 오디오북을 합성하고 릴리스 아티팩트를 패키징합니다. 프로덕션 오케스트레이션 경로는 다음과 같은 순서로 문서화되어 있습니다: 소스 수집 및 분석 기반 구축; Modal XCore LitBank ID 해소; 캐논 추출; 캐릭터 및 세계관 모델링; 생성 계획; 서사 생성 및 시맨틱 지원; 시각적 생성 및 이미지 QA; 오디오북 합성 및 전사 QA; 마지막으로 EPUB, 매니페스트, 리니지 및 자격 보고서 생성 순입니다. 아키텍처 활성 소스 트리는 네 가지 주요 표면으로 구성됩니다: - packages/ — 에이전트, 추론, 검색, 지속성, 실행, ID, 미디어 생성, 관찰 가능성, 리니지, 자격 증명 및 배포를 담당하는 독립적인 런타임 패키지들입니다. - integrations/ — ComfyUI, Kokoro TTS 및 Modal 상의 XCore LitBank를 위한 제공자 구현체입니다. - 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 대시보드 개발은 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 수집기는 다이제스트(digest)로 고정됩니다. CI는 main 브랜치에서 런타임 및 대시보드 이미지를 게시하며, 기존 버전 태그 사용을 거부하고, 출처 증명을 생성하며, 커밋 및 이미지 다이제스트가 포함된 릴리스 매니페스트를 저장합니다. 프로덕션 승격은 배포 매니페스트에 깨끗하게 커밋된 소스 출처가 없는 한 실패하도록 설계되었습니다. 문서 인덱스 README는 구현 및 자격 상태를 위해 docs/system_agent_roadmap.md와 docs/production_qualification.md를 가리키며, 배포(빌드, 롤아웃, 롤백, 백업, 복구), 런타임 비밀 소유권, 스토리지 계약 및 제공자 경계, 엔드-투-엔드 오케스트레이션, 허용된 실제 도서 자격 증거 및 아키텍처 무결성 감사에 대한 운영 참조를 제공합니다. 평가 이 저장소는 근거 기반의 캐논 인식 스토리 제작을 위한 인프라로 이해하는 것이 가장 적절합니다. 소스 북에 대한 검색 및 ID 해소를 텍스트, 이미지, 오디오 생성 단계와 결합하고, 릴리스 패키징 및 출처 중심의 CI로 마무리합니다. README는 아키텍처와 운영 계약 세부 사항에 집중하고 있으며 벤치마크나 품질 주장을 게시하지 않습니다. 기능 진술은 참조된 자격 문서와 대조하여 읽어야 합니다.