منصوبے کے بارے میں

S.A.G.A. (Story Analysis, Generation, and Archives) کو تجزیہ، بازیابی، ٹائم لائنز اور کہانی کی تخلیق کے لیے کینن-آگاہ بیانیہ ذہانت (canon-aware narrative intelligence) کے طور پر بیان کیا گیا ہے۔ ایک واحد مونو لیتک ایپلی کیشن کے بجائے، اس پروجیکٹ کو قابل استعمال رن ٹائمز کے ایک کنٹریکٹ ڈریون مجموعے کے طور پر ترتیب دیا گیا ہے۔ یہ کیا کرتا ہے README کے مطابق، S.A.G.A. سورس بکس کا تجزیہ کر کے انہیں شواہد پر مبنی کینن میں تبدیل کرتا ہے، بنیاد پر مبنی کہانیاں اور بصری اثاثے (visual assets) تیار کرتا ہے، آڈٹ شدہ آڈیو بکس کی ترتیب (synthesize) کرتا ہے، اور ریلیز آرٹفیکٹس کو پیکج کرتا ہے۔ پروڈکشن آرکیسٹریشن کے راستے کو ایک ترتیب کے طور پر دستاویز کیا گیا ہے: سورس انجکشن اور تجزیاتی بنیاد؛ Modal XCore LitBank شناخت کی قرارداد (identity resolution)؛ کینن نکالنا؛ کردار اور دنیا کی ماڈلنگ؛ جنریشن پلاننگ؛ بیانیہ کی تخلیق اور سیمیٹک سپورٹ؛ بصری تخلیق اور امیج QA؛ آڈیو بک سنتھیسز اور ٹرانسکرپشن QA؛ اور آخر میں EPUB، مینی فیسٹ، لینیج اور کوالیفکیشن رپورٹنگ۔ آرکیٹیکچر ایکٹو سورس ٹری کی چار بنیادی سطحیں ہیں: - packages/ — آزاد رن ٹائم پیکجز جو ایجنٹس، استدلال (reasoning)، بازیابی، استحکام (persistence)، ایگزیکیوشن، شناخت، میڈیا جنریشن، آبزرو ایبلٹی، لینیج، کوالیفکیشن اور تعیناتی (deployment) کا احاطہ کرتے ہیں۔ - integrations/ — ComfyUI، Kokoro TTS، اور Modal پر XCore LitBank کے لیے فراہم کنندہ (provider) کے نفاذ۔ - apps/dashboard_api/ — ایک اسٹیٹ لیس FastAPI کنٹرول اور کوئری سطح۔ - apps/dashboard_pro/ — ایک React آپریٹر ڈیش بورڈ۔ Supabase Postgres، pgvector، اور آبجیکٹ اسٹوریج packages/persistence_runtime کے پیچھے استحکام فراہم کرنے والوں کے طور پر کام کرتے ہیں۔ LangGraph ایگزیکیوشن packages/agent_runtime کی ملکیت ہے۔ فراہم کنندہ کے کریڈنشلز استحکام یا تعیناتی کے خفیہ اسٹورز میں رہتے ہیں اور رن ٹائمز میں انجیکٹ کیے جاتے ہیں، بجائے اس کے کہ انہیں سورس کنٹرول میں شامل کیا جائے۔ ایک قابل ذکر ڈیزائن فیصلہ یہ ہے کہ پچھلے نفاذ (implementation) کو 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 کلیکٹر کو ڈائجسٹ (digest) کے ذریعے پن کیا گیا ہے۔ CI مین برانچ سے رن ٹائم اور ڈیش بورڈ امیجز شائع کرتا ہے، موجودہ ورژن ٹیگز کو مسترد کرتا ہے، پروویننس اٹیسٹیشنز بناتا ہے، اور ایک ریلیز مینی فیسٹ اسٹور کرتا ہے جس میں کمیٹ اور امیج ڈائجسٹ شامل ہوتے ہیں۔ پروڈکشن پروموشن کو اس طرح بیان کیا گیا ہے کہ یہ تب تک ناکام رہے گا جب تک کہ تعیناتی مینی فیسٹ میں صاف کمیٹڈ سورس پروویننس نہ ہو۔ دستاویزات کا انڈیکس README نفاذ اور کوالیفکیشن اسٹیٹس کے لیے docs/system_agent_roadmap.md اور docs/production_qualification.md کی طرف اشارہ کرتا ہے، پلس تعیناتی (بلڈ، رول آؤٹ، رول بیک، بیک اپ، ریکوری)، رن ٹائم سیکریٹ ملکیت، اسٹوریج کنٹریکٹس اور فراہم کنندہ کی حدود، اینڈ ٹو اینڈ آرکیسٹریشن، قبول شدہ حقیقی کتاب کوالیفکیشن شواہد، اور آرکیٹیکچر انٹیگریٹی آڈٹ پر آپریشنل حوالے فراہم کرتا ہے۔ تشخیص اس ریپوزٹری کو بنیاد پر مبنی، کینن-آگاہ کہانی کی پروڈکشن کے لیے انفراسٹرکچر کے طور پر بہتر طور پر سمجھا جا سکتا ہے: یہ سورس بکس پر بازیابی اور شناخت کی قرارداد کو متن، تصاویر اور آڈیو کے لیے جنریشن مراحل کے ساتھ جوڑتا ہے، اور ریلیز پیکیجنگ اور پروویننس-اورینٹڈ CI کے ساتھ ختم ہوتا ہے۔ README آرکیٹیکچر اور آپریشنل کنٹریکٹ کی تفصیلات پر زیادہ زور دیتا ہے اور بینچ مارک یا معیار کے دعوے شائع نہیں کرتا؛ صلاحیت کے بیانات کو اس کوالیفکیشن دستاویزات کے تناظر میں پڑھا جانا چاہیے جن کا یہ حوالہ دیتا ہے۔