Workflow Engine — محرّك سير عمل حالات قابل للاستئناف (LangGraph-style أصيل)

بُني 2026-10-21 (أمر د. وائل، فجوة 2 من 3). إثراء فوق goap-planner (لا إحلال) — goap يخطّط التسلسل، وهذا ينفّذه بحالات قابلة للاستئناف:

• checkpoint: حفظ الحالة بعد كل خطوة → استئناف من آخر نقطة عند أي انقطاع (never-stop).
• branch: تفرّع حسب نتيجة الخطوة (on_success / on_fail → مسار مختلف).
• pause/resume: إيقاف عند human-approval gate → استئناف بعد الموافقة.
• recover: إعادة محاولة الخطوة الفاشلة (fallback per-step).

الاستخدام

python3 skills/workflow-engine/workflow_engine.py selftest
python3 skills/workflow-engine/workflow_engine.py create --id kcpc1 --steps '[{"name":"scope","on_success":"zoning","on_fail":"review"},...]'
python3 skills/workflow-engine/workflow_engine.py step --id kcpc1 --name scope --ok true
python3 skills/workflow-engine/workflow_engine.py status --id kcpc1
python3 skills/workflow-engine/workflow_engine.py resume --id kcpc1   # بعد gate

متى يُستخدم

مهام KCPC الطويلة متعددة المراحل: مناقصة → تحليل scope → zoning → P6 → تسليم، مع:

• تفرّع ذكي (نجاح/فشل) + نقاط موافقة بشرية (gate) قبل الخطوات الحرجة.
• استئناف مضمون من آخر checkpoint عند أي انقطاع (never-stop).

الخط الأحمر

إثراء التنفيذ المرحلي — يكمّل goap-planner + unified-arsenal. zero-dependency (JSON state). SELFTEST 7/7 (مُختبَر حيّاً: branch نجاح/فشل + pause/resume gate + استئناف من checkpoint بعد انقطاع).