عن المشروع

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 عبر 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 مرتبطة بالمراحل مع مغلفات قابلة للمراجعة ووحدة تحكم مشغل لسير العمل الذي يؤلفه المستخدم، مقابل توجيه YAML الحتمي لـ Conductor عبر العديد من الوكلاء. تغطي خطوط الأنابيب المثال hello-world، ومراجعة الخطة مع بوابة مشغل، وتوجيه التفرع الشرطي، ومرحلة MCP، وPlaywright MCP، وContext7 MCP، وصياغة إصدار GitHub، وجولة HITL أولاً بـ MCP، والتحقق من CI. تغطي الوثائق البنية، والبدء السريع، ومخطط YAML، ومرجع CLI، والمغلفات، وHITL، وCI، وMCP، والمزودين، ووحدة تحكم المشغل. المشروع مرخص بموجب MIT.