इस प्रोजेक्ट के बारे में

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, और 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 के साथ हैंडल किया जाता है। Supabase एनवायरनमेंट को कॉन्फ़िगर करने के बाद API को 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 आर्किटेक्चर और ऑपरेशनल कॉन्ट्रैक्ट विवरण पर केंद्रित है और कोई बेंचमार्क या क्वालिटी दावे पब्लिश नहीं करता है; क्षमता विवरणों को इसके द्वारा संदर्भित क्वालिफिकेशन दस्तावेज़ों के संदर्भ में पढ़ा जाना चाहिए।