AR
Geodi، شخصية البكسل الرسمية لـ GEODE
العودة إلى القاعة

GEODE

Autonomous Agent Harness

من الملاحظة إلى الإجراء التالي.

إطار تشغيل محلي لوكيل مستقل يمكن أن تُسند إليه الأبحاث والعمل على الملفات والمهام المجدولة.

2026.02.21 — present

التصميم والحكم والتحقق: Author · التطبيق: Claude · المراجعة: Codex

  • CLIمنشور · PyPI
  • خادم MCPمُطبَّق

لا يصبح اقتراح النموذج بالتوقف اكتمالًا إلا عبر التحقق.

في التوقف القابل للتسليم، حتى طلب النموذج التوقفَ يمر بالتحقق من الاكتمال. والنتيجة إما الإنجاز، أو المتابعة ضمن الميزانية، أو انتظار المراجعة، أما حدود التنفيذ والإلغاء والأخطاء فتنتهي في حالة توقف منفصلة.

خريطة الاكتمال · مرسومة من مسارات الشيفرة عند الإيداع المثبّت 9e2c041
خريطة الاكتمال في GEODEكيف يصبح اقتراح النموذج بالتوقف اكتمالًا. لا تمر إلا التوقفات القابلة للتسليم (natural وforced_text وactionable_partial) عبر PreVerify hook، وفحص بنيوي، والحَكَم المختار (LLM judge افتراضيًا، وJev عند اختياره)، ثم PostVerify hook وStop hook. يُحفظ النجاح بوصفه completed، ويواصل الإخفاقُ القابل للإصلاح الطلبَ نفسه ضمن ميزانية افتراضية من محاولتين. أما الحكم غير الصالح للاستخدام، أو محاولة تحويل الإخفاق إلى نجاح، أو نفاد الميزانية، فيحجب المرشح ويوقف الجلسة مؤقتًا. وتُحفظ توقفات الإلغاء والحدود والبنية التحتية وتشغيلات control workflow دون تحقق.IPC · مستدعٍ عبر CLIالاستجابة · حالة الجلسةمُراجِع خارجيpending · دون تواصلالنموذج الحَكَمLLM judge · Jev Choiceipc_server/poller.pycontrol workflow · تخطّي التحقق العامloop/agent_loop.pyarun · دور النموذج_arun_once · متابعة الإصلاحloop/_guards.py · models.pyتوقف قابل للتسليم · natural وغيرهتوقف بسبب إخفاق · حد · إلغاءloop/_lifecycle.pyfinalize_and_return_asyncpolicy_action · قراءة الحكمميزانية continuation · افتراضيًا 2core/hooks/public.pyPreVerify · STRENGTHENPostVerify · ACCEPT · REVISE · ESCALATEStop · CONTINUEmemory · observabilitycheckpoint · حالة الجلسةtimeline · صفوف قرارات ledgercore/agent/verify.pyفحص بنيوي · empty_turnحكم دلالي · LLM أو Jevverification_error · يُغلق عند الإخفاقعملية بيئة تشغيل GEODEنهاية دور واحد من AgenticLoopالحلقة · مرشحو التوقفfinalization · الحكم1 اقتراح التوقف · arun · دور النموذج → توقف قابل للتسليم · natural وغيره12مرشح الاكتمال3 PreVerify · finalize_and_return_async → PreVerify · STRENGTHEN34verify_turn_async5طلب حكم6passed · rubric_misses7 قرار PostVerify · policy_action · قراءة الحكم → PostVerify · ACCEPT · REVISE · ESCALATE78Stop · CONTINUE9completed · محفوظ10الاستجابة1passed · rubric_misses2 قرار PostVerify · policy_action · قراءة الحكم → PostVerify · ACCEPT · REVISE · ESCALATE23Stop · CONTINUE4إصلاح · محاولة +11verification_error2 قرار PostVerify · policy_action · قراءة الحكم → PostVerify · ACCEPT · REVISE · ESCALATE23ESCALATE · pending4الحكم · صفوف الأدلة1 الحراسات · الحدود · arun · دور النموذج → توقف بسبب إخفاق · حد · إلغاء12توقف بسبب إخفاق · إلغاء3تخطّي التحقق العام4حفظ فقط · بلا تحقق5الاستجابة

التحقق → الاكتمال

لا يمر إلا التوقف القابل للتسليم عبر PreVerify → الحكم → PostVerify → Stop. ولا يُعد اقتراح النموذج بالتوقف ولا تعليمة hook اكتمالًا في حد ذاته.

  1. arun · دور النموذجloop/agent_loop.pyاقتراح التوقفتوقف قابل للتسليم · natural وغيرهloop/_guards.py · models.py

    حين يجيب النموذج نصًّا دون استدعاء أداة، يصبح الدور مرشحًا لتوقف natural (وforced_text في آخر جولة مسموح بها). واقتراح النموذج بالتوقف ليس اكتمالًا بعد.

  2. توقف قابل للتسليم · natural وغيرهloop/_guards.py · models.pyمرشح الاكتمالfinalize_and_return_asyncloop/_lifecycle.py

    لا تُعد توقفات قابلة للتسليم إلا natural وforced_text وactionable_partial، وهي وحدها تنتقل إلى التحقق العام.

  3. finalize_and_return_asyncloop/_lifecycle.pyPreVerifyPreVerify · STRENGTHENcore/hooks/public.py

    لا يستطيع PreVerify hook عبر STRENGTHEN إلا إضافة متطلبات ورموز نقص. فيمكنه جعل الحكم أشد صرامة، لا تمريره أبدًا.

  4. finalize_and_return_asyncloop/_lifecycle.pyverify_turn_asyncفحص بنيوي · empty_turncore/agent/verify.py

    يأتي الفحص البنيوي أولًا (دور فارغ، model_action_required)، والإخفاق البنيوي غير القابل للإصلاح يتخطى الحكم الدلالي. وتُفسَّر الإعدادات القديمة مثل off أو rule_based على أنها llm_judge، فلا يمكنها تعطيل الحكم.

  5. حكم دلالي · LLM أو Jevcore/agent/verify.pyطلب حكمالنموذج الحَكَم

    يُستدعى الحَكَم المختار (LLM judge افتراضيًا، وJev Choice عند اختياره) مرة واحدة دون أدوات، لمدة أقصاها 120 ثانية ودون تجاوز ميزانية الوقت المتبقية. ولا يُرسَل المرشح الذي قد يحمل ملاحظات شخصية إلى حَكَم مساعد.

  6. حكم دلالي · LLM أو Jevcore/agent/verify.pypassed · rubric_missespolicy_action · قراءة الحكمloop/_lifecycle.py

    يحمل الحكم النجاح أو الإخفاق، ورموز النقص، وreflection للمحاولة التالية، وما إذا كانت إعادة المحاولة مفيدة. ولا يغطي النجاح الدلالي أبدًا فحصًا بنيويًا أخفق.

  7. policy_action · قراءة الحكمloop/_lifecycle.pyقرار PostVerifyPostVerify · ACCEPT · REVISE · ESCALATEcore/hooks/public.py

    يقرر PostVerify hook أحد ACCEPT أو REVISE أو ESCALATE. ويتحول ACCEPT لمرشح أخفق في التحقق إلى escalate. وعند غياب القرار تنطبق القيمة الافتراضية لبيئة التشغيل (نجاح → accept، قابل لإعادة المحاولة → revise، وإلا escalate).

  8. policy_action · قراءة الحكمloop/_lifecycle.pyStop · CONTINUEStop · CONTINUEcore/hooks/public.py

    لا يمكن لتعليمة CONTINUE من Stop hook أن تطلب متابعة الإصلاح إلا في غير حالة escalate. وتعليمة hook مُدخلٌ للمحاولة التالية، لا سلطة.

  9. policy_action · قراءة الحكمloop/_lifecycle.pycompleted · محفوظcheckpoint · حالة الجلسةmemory · observability

    عند النجاح وaccept، تُدمج المحاولات المتابَعة، وتُحفظ النتيجة، وتُسجَّل الجلسة بوصفها completed.

  10. finalize_and_return_asyncloop/_lifecycle.pyالاستجابةIPC · مستدعٍ عبر CLI

    يعيد الإجابة النهائية عند الاكتمال، وإجابةً فارغة مع EXTERNAL_VERIFICATION_REQUIRED عند انتظار المراجعة، وسببَ التوقف في التوقف بلا تحقق.

إصلاح ضمن الميزانية

يواصل الإخفاقُ القابل للإصلاح الطلبَ نفسه. الميزانية الافتراضية محاولتان، وعند نفادها ينتظر المرشح المراجعة.

  1. حكم دلالي · LLM أو Jevcore/agent/verify.pypassed · rubric_missespolicy_action · قراءة الحكمloop/_lifecycle.py

    يحمل الحكم النجاح أو الإخفاق، ورموز النقص، وreflection للمحاولة التالية، وما إذا كانت إعادة المحاولة مفيدة. ولا يغطي النجاح الدلالي أبدًا فحصًا بنيويًا أخفق.

  2. policy_action · قراءة الحكمloop/_lifecycle.pyقرار PostVerifyPostVerify · ACCEPT · REVISE · ESCALATEcore/hooks/public.py

    يقرر PostVerify hook أحد ACCEPT أو REVISE أو ESCALATE. ويتحول ACCEPT لمرشح أخفق في التحقق إلى escalate. وعند غياب القرار تنطبق القيمة الافتراضية لبيئة التشغيل (نجاح → accept، قابل لإعادة المحاولة → revise، وإلا escalate).

  3. policy_action · قراءة الحكمloop/_lifecycle.pyStop · CONTINUEStop · CONTINUEcore/hooks/public.py

    لا يمكن لتعليمة CONTINUE من Stop hook أن تطلب متابعة الإصلاح إلا في غير حالة escalate. وتعليمة hook مُدخلٌ للمحاولة التالية، لا سلطة.

  4. ميزانية continuation · افتراضيًا 2loop/_lifecycle.pyإصلاح · محاولة +1_arun_once · متابعة الإصلاحloop/agent_loop.py

    مع وجود تعليمة إصلاح، وما دام رقم المحاولة دون الميزانية (اثنتان افتراضيًا) فقط، يستمر الطلب نفسه. وعند بلوغ الميزانية يصبح escalate_budget_exhausted وينتظر المراجعة.

بانتظار المراجعة

الحكم غير الصالح للاستخدام، أو محاولة تحويل الإخفاق إلى نجاح، أو نفاد الميزانية، يحجب المرشح ويوقف الجلسة مؤقتًا.

  1. verification_error · يُغلق عند الإخفاقcore/agent/verify.pyverification_errorpolicy_action · قراءة الحكمloop/_lifecycle.py

    غياب الحَكَم أو انقضاء المهلة أو الاستجابة غير الصالحة يصبح verification_error: لا نجاحًا ولا إشارة إصلاح. والحكم غير الصالح للاستخدام لا يحل محل النجاح أبدًا.

  2. policy_action · قراءة الحكمloop/_lifecycle.pyقرار PostVerifyPostVerify · ACCEPT · REVISE · ESCALATEcore/hooks/public.py

    يقرر PostVerify hook أحد ACCEPT أو REVISE أو ESCALATE. ويتحول ACCEPT لمرشح أخفق في التحقق إلى escalate. وعند غياب القرار تنطبق القيمة الافتراضية لبيئة التشغيل (نجاح → accept، قابل لإعادة المحاولة → revise، وإلا escalate).

  3. policy_action · قراءة الحكمloop/_lifecycle.pyESCALATE · pendingمُراجِع خارجي

    يُحتفظ بالمرشح بوصفه pending_text ويُحجب عن الاستجابات العادية، ويُحفظ checkpoint وتُوقف الجلسة مؤقتًا. ولا يُتواصل مع أي مُراجِع خارجي تلقائيًا.

  4. policy_action · قراءة الحكمloop/_lifecycle.pyالحكم · صفوف الأدلةtimeline · صفوف قرارات ledgermemory · observability

    يتلقى timeline صفوف القرار والأدلة وpending، ويتلقى evidence ledger صف verification_policy. وهذه سجلات best-effort، لا دليل على أثر خارجي.

توقفات بلا تحقق

تُحفظ توقفات الإلغاء والحدود والبنية التحتية وتشغيلات control workflow دون تحقق عام.

  1. arun · دور النموذجloop/agent_loop.pyالحراسات · الحدودتوقف بسبب إخفاق · حد · إلغاءloop/_guards.py · models.py

    تُنهي حراساتٌ مثل حدود الجولات والوقت والتكلفة والسياق، والإلغاء، وكشف الإخفاق المتكرر، الدورَ بعنصر واحد من مجموعة TerminationReason المغلقة. والحدّ المعطَّل في الإعدادات لا يُفرض دائمًا.

  2. توقف بسبب إخفاق · حد · إلغاءloop/_guards.py · models.pyتوقف بسبب إخفاق · إلغاءfinalize_and_return_asyncloop/_lifecycle.py

    لا مرشح للتحقق في توقفات الإلغاء والبنية التحتية والحدود، لذا تُحفظ دون تحقق عام.

  3. control workflow · تخطّي التحقق العامipc_server/poller.pyتخطّي التحقق العامfinalize_and_return_asyncloop/_lifecycle.py

    حين يطلب استدعاء IPC تخطّي التحقق العام أو يكون control workflow نشطًا، يُعطَّل التحقق العام لذلك التشغيل وحده، ثم تُستعاد القيمة السابقة بعده.

  4. finalize_and_return_asyncloop/_lifecycle.pyحفظ فقط · بلا تحققcheckpoint · حالة الجلسةmemory · observability

    التوقف بلا تحقق يحفظ مع ذلك نتيجته وcheckpoint ويُطلق أحداث نهاية الجلسة.

  5. finalize_and_return_asyncloop/_lifecycle.pyالاستجابةIPC · مستدعٍ عبر CLI

    يعيد الإجابة النهائية عند الاكتمال، وإجابةً فارغة مع EXTERNAL_VERIFICATION_REQUIRED عند انتظار المراجعة، وسببَ التوقف في التوقف بلا تحقق.

كل الروابط بالسماكة نفسها. اختر مسارًا لإبراز طريقه وحده، مع خطوات مرقّمة.

  • خط متصل · اتجاه تدفق الطلبات والمرشحين والنتائج
  • خط متقطع · تشغيل، حكم، تفويض، تهيئة
  • شرطة طويلة ونقطة · السجلات والملاحظة، بمعزل عن الحكم
  • شرطة قصيرة · إخفاق أو حكم غير صالح للاستخدام
  • خط أسود سميك · المسار المختار، والأرقام تبيّن الترتيب
  • مربع · حدّ شيفرة أو سجل، ومساره في الترويسة
  • شريحة داخلية · مكوّن ضمن ذلك الحد
  • مربع متقطع · خارج ذلك الحد
  • الحلقة · finalization
  • التوقفات · hooks · الحكم
  • الحفظ · السجلات
  • دخول IPC

لا تُرسم إلا مسارات الاستدعاء في الإيداع المثبّت 9e2c041. ونجاح الحَكَم منفصل عن نجاح مُتحقِّق معيار قياس خارجي، والاكتمال هنا قرار داخل بيئة التشغيل.

محرّك الحكم
الافتراضي هو LLM judge، ولا يحكم Jev Choice إلا حين يُضبط judgment_engine على jev. وفي الحالتين، يعطي الحَكَم غير الصالح للاستخدام verification_error، لا نجاحًا أبدًا.
ما يحق لـ hooks فعله
لا يستطيع PreVerify إلا تشديد الحكم، ولا يستطيع PostVerify تمرير مرشح أخفق، ولا يطلب Stop المتابعة إلا في غير حالة escalate.
بانتظار المراجعة
يسجّل انتظار المراجعة أن قرارًا خارجيًا مطلوب. ولا يُبلغ أحدًا، ولا يعني أن النتيجة أُقرّت.