الانتقال إلى المحتوى الرئيسي
نمطان من الإخفاق تُوجد هذه الطبقة لتقتلهما: العمل الجزئي (تغييرات في الشيفرة دون القطع التي تعتمد عليها) وفقدان ذاكرة الجلسة (الجلسة التالية تعيد افتراض ما عرفته هذه الجلسة). التعليمات ترفع احتمال السلوك الصحيح؛ والخطّافات الحتمية تضمن حدًّا أدنى.

تثبيت الجلسة

عند SessionStart (src/session.js)، يسجل Forge HEAD مرة واحدة لكل جلسة، ويُقلّم قطع الجلسات الأقدم من أسبوع، ويحقن توجيهًا طازجًا:

الدروس المتعلَّمة

دروس Cortex المستنبطة من التصحيحات الماضية.

الهدف المُثبَّت

الهدف المُعلن، بحيث يمكن قياس الانحراف مقابله.

لقطة التسليم

ملف .forge/state.md المحدود الذي كتبته الجلسة السابقة.

أحدث الالتزامات + التغييرات

أحدث الالتزامات والتغييرات غير المُلتزَم بها — أدلة لا افتراضات.
تتوجّه الجلسة الجديدة بالأدلة، لا بالافتراضات المسبقة.

بوّابة الإكمال

الحاجز الوحيد الذي قد يُجيب على مسار Stop هو completion-gate.sh (src/gate.js). يعمل بشكل متزامن؛ يظل cortex.sh stop الخاص بتنقيب الدروس منفصلًا ولا يستطيع الحجب أبدًا. مجموعة التغييرات محدودة بالجلسة: الملفات من الالتزامات التي زمن مُلتزمها عند بداية الجلسة أو بعدها، إضافةً إلى تغييرات شجرة العمل ناقصًا الأوساخ المُلتقطة عند SessionStart — بحيث لا تُلصَق التعديلات السابقة، وتبديل الفروع، وgit pull بالوكيل.
إذا تحرّكت الشيفرة دون أن يتبعها توثيق أو أثر حالة، تحجب البوّابة مرة واحدة مع قائمة إصلاح كسبب. كل حالة أخرى تسمح، وكل خطأ داخلي يسمح (فشل بلطف). FORGE_STOPGATE=0 يوقفه.
قائمة الإصلاح تُشير إلى الأدوات التي تُنهي العمل:

التسليم والقرارات

مخزنان يحفظان المعرفة عبر الجلسات: كلاهما يرفض الأسرار عند الكتابة. يُعاد حقن state.md عند بداية كل جلسة؛ ويُقرأ decisions.md قبل إعادة تقرير أي شيء استقرّت عليه جلسة سابقة.

مسح التوثيق المدفوع بالفرق

يُجيب forge docs sync عن السؤال ذي الشكل الفرقي: المعرِّفات المُغيَّرة (المسارات، والتعاريف، والرموز المُستدعاة، من الأسطر المضافة والمحذوفة) مقابل كل قطعة توثيق → UPDATED / STALE (مع إصابات file:line) / VERIFIED-UNAFFECTED، مع تسجيل السبب. هو مُبلِّغ محض؛ بوّابة الإكمال توفر الأسنان.
recall وcortex ذاكرة ملفات وطلبات فقط — ليست تعلمًا على مستوى الأوزان. التجميع مُلخِّص قد يُهلوس، لذا يبقى إرشاديًا وقابلًا لمراجعة الإنسان وخاليًا من الأسرار.