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

Stageflow ایک اوپن سورس رن ٹائم ہے جو کنفیگر ایبل ملٹی اسٹیج ایجنٹ ورک فلو کے لیے ہے۔ پائپ لائنز پروجیکٹ کی ملکیت والی YAML فائلوں (`*.pipeline.yaml`, `*.task.yaml`, اختیاری `stageflow.yaml` مینی فیسٹ) کے طور پر تحریر کی جاتی ہیں، اور ہر اسٹیج ایک نئی ایجنٹ سیشن میں چلتا ہے، ٹائپڈ لفافوں اور آرٹیفیکٹس کے ذریعے سیاق و سباق آگے منتقل کرتا ہے۔ Pi موجودہ ایجنٹ ایگزیکیوشن بیک اینڈ ہے۔ پیکج `sf` اور `stageflow` بائنریز انسٹال کرتا ہے اور Node.js 20 یا اس سے نئے ورژن کی ضرورت ہوتی ہے۔ یہ پروجیکٹ اسٹیجز کو کمپوزیشن کی اکائی کے طور پر رکھتا ہے، ایجنٹس کو نہیں۔ ایک شیڈیولر آرکیسٹریشن سیمنٹکس کا مالک ہے: DAG تیاری، محدود متوازی پن، فین آؤٹ اور جوائن، مشروط روٹنگ، ریٹرائیز، اسکیپڈ برانچز، اور قابل تجدید ہیومن گیٹس۔ ایجنٹ ایگزیکیوشن `AgentPort` تجرید کے پیچھے ہے، جبکہ Stageflow پائپ لائن اسٹیٹ، اسٹیج ورک اسپیسز، ہینڈ آف توثیق، اور CLI، کنسول، MCP، اور CI کے ذریعے استعمال ہونے والے انٹرفیس کا مالک ہے۔ رن اسٹیٹ SQLite میں `<git-root>/.stageflow/` کے تحت محفوظ ہوتی ہے، جس میں فی رن ورک اسپیسز `.stageflow/runs/` کے تحت ہیں؛ عالمی کنفیگریشن اور اسناد `~/.stageflow/` کے تحت ہیں۔ README میں بیان کردہ قابل ذکر صلاحیتوں میں `write_stage_artifact` اور `emit_stage_envelope` کے ذریعے ٹائپڈ لفافہ ہینڈ آف، بعد کے مرحلے کے `verify` چیکس اور `on_verify_fail` مرمت یا دستی بحالی کے ساتھ تصدیق شدہ اسٹیج ایگزیکیوشن، اور ہیومن-ان-دی-لوپ گیٹس شامل ہیں جہاں CI رن کے انتظار کے دوران کوڈ 2 کے ساتھ باہر نکلتا ہے۔ `http://127.0.0.1:3847` پر ایک لوکل آپریٹر کنسول رنز کی ٹرائیج، پرووائیڈر کنکشن، گیٹ جوابات، اور ٹرانسکرپٹ معائنہ کی حمایت کرتا ہے۔ ایک MCP اینڈ پوائنٹ Streamable HTTP پر `/mcp` پر ظاہر ہوتا ہے جب `sf ui` یا `sf mcp` چل رہا ہو، جس میں HITL سے آگاہ ٹولز جیسے `wait_run`, `answer_gate`, `list_waiting`, اور `decide_feedback_loop` شامل ہیں۔ ہیڈ لیس اور CI استعمال `sf validate --strict --json` اور `sf run --json` کے ذریعے سپورٹ کیا جاتا ہے، جس میں دستاویزی ایگزٹ کوڈز ہیں: 0 کامیابی کے لیے، 1 ناکامی یا مصروفیت کے لیے، اور 2 انتظار کے لیے۔ پرووائیڈر تصدیق کنسول یا `sf providers` کمانڈز کے ذریعے ترتیب دی جا سکتی ہے، جس میں اسناد یا تو Pi کی مشترکہ آٹھ فائل (`pi_home`) یا Stageflow کے اپنے اسٹور (`sf_owned`) میں محفوظ ہوتی ہیں۔ README واضح طور پر نوٹ کرتا ہے کہ Stageflow ایک SDLC ٹول نہیں ہے؛ سافٹ ویئر ڈیلیوری ایک عام مثال پیٹرن ہے، لیکن اسٹیجز صارف کے تحریر کردہ اور ڈومین سے غیر متعلق ہیں۔ ریپوزٹری میں Microsoft Conductor کے ساتھ موازنہ شامل ہے، جس میں Stageflow کو اسٹیج سے منسلک Pi رنز کے طور پر پیش کیا گیا ہے جس میں قابل جائزہ لفافے اور صارف کے تحریر کردہ ورک فلو کے لیے آپریٹر کنسول ہے، بمقابلہ Conductor کا بہت سے ایجنٹس میں قطعی YAML روٹنگ۔ مثال پائپ لائنز میں ہیلو-ورلڈ، آپریٹر گیٹ کے ساتھ پلان-ریویو، مشروط فورک روٹنگ، اسٹیج MCP، Playwright MCP، Context7 MCP، GitHub ریلیز ڈرافٹنگ، MCP-فرسٹ HITL ٹور، اور CI توثیق شامل ہیں۔ دستاویزات میں آرکیٹیکچر، کوئیک اسٹارٹ، YAML اسکیما، CLI حوالہ، لفافے، HITL، CI، MCP، پرووائیڈرز، اور آپریٹر کنسول شامل ہیں۔ یہ پروجیکٹ MIT لائسنس یافتہ ہے۔