عن المشروع

dejavu-gates هي طبقة ذاكرة عابرة للجلسات لوكلاء البرمجة بالذكاء الاصطناعي. يكرر الوكلاء الأخطاء نفسها لأنهم ينسون بين الجلسات، وقواعد markdown لا تصلح ذلك. تكتشف هذه الأداة آلياً حالات فشل استدعاء الأدوات المتكررة (bash، read، edit، write، glob، grep) وتحوّلها إلى بوابات مفروضة: تذكير عند المحاولة التالية، وحظر صارم عند تكرار المخالفة في الجلسة نفسها. محرك واحد، مضيفات متعددة. يعمل كإضافة OpenCode وكأداة CLI لمعالجة الخطافات لـ Claude Code وCodex CLI وGemini CLI وCursor وCopilot CLI وCrush. مكتوب بـ TypeScript ويُشغَّل بـ Bun، ويُشحن كمصدر دون خطوة بناء. كيف يعمل: يحصل استدعاء الأداة الفاشل على بصمة موحّدة (تُزال منها المسارات والأرقام والتجزئات)، ويُعدّ مفتاح النمط عبر الجلسات، وبعد 3 حالات فشل عبر جلستين مختلفتين تُرقّى بوابة. تتلقى المحاولة التالية تذكيراً [dejavu] مع إجهاض الاستدعاء؛ وإعادة المحاولة التي تفشل مجدداً تُفعّل حظراً صارماً. تبقى الأوامر التشخيصية على وضع التذكير فقط، فيُنفَّذ الاستدعاء ويرافق التذكير المخرجات الفاشلة كملاحظة NOTE مرة واحدة لكل جلسة. تشمل خيارات التصميم: التذكير أولاً والحظر فقط عند التكرار (الحظر المحض يستدعي تجاوزات مثل تبديل مديري الحزم)؛ رسائل البوابة تحمل CORRECTION وEVIDENCE بدلاً من منع مجرد؛ مفاتيح أنماط آلية فقط، دون تصنيف LLM في المسار الساخن؛ نطاقان، بوابات خاصة بالمستودع في المستودع وعادات على مستوى الوكيل في إعدادات المستخدم؛ تنتهي صلاحية البوابات بعد 60 يوماً دون تكرار؛ ومقياس التكرار بعد البوابة للتحقق مما إذا كانت البوابات تقلل التكرارات فعلاً. للفرض تغذية راجعة سلبية. البوابة التي تتكرر باستمرار أو يجري تجاوزها صراحةً باستمرار تخفّض نفسها إلى المراقبة ولا تُرقّى آلياً مجدداً؛ ويمكن لإنسان إعادة فرضها. كما تتعافى البوابات: ثلاث نجاحات متتالية تطابق بوابة مفروضة تُحيلها إلى المراقبة، وبوابة ذُكِّرت مرات كثيرة دون مخالفة جديدة تُحال كـ taught. تفاصيل السلامة والمتانة: فقط أوامر bash غير التشخيصية يمكن أن تصبح بوابات حاجزة؛ تبقى فحوص الملفات في المراقبة؛ البصمات التي لا تحتفظ بهوية متبقية يمكنها المراقبة فقط؛ أداة CLI للخطافات تفشل مفتوحة، فتعيد قراراً فارغاً ورمز خروج 0 عند الحمولات المشوهة أو الأخطاء الداخلية. تُنقّى الأسرار قبل الحفظ، وتُزال أحرف التحكم الطرفية، وتُوفَّق المخازن وتُصلَّح عند التهيئة مع عزل الملفات التالفة. تستخدم التزامن ملفات قفل مع كتابات tmp+rename وإعادة المحاولة عند أخطاء Windows، وتُحفظ سلسلة التصعيد من التذكير إلى الحظر على البوابة بحيث تتشاركها نوافذ وأُطر متعددة. التثبيت متاح عبر npx، وقنوات الإضافات الأصلية لعدة أُطر، وGitHub Packages، أو من نسخة مستنسخة مع سكربت مثبّت يدمج إدخالات الخطافات بشكل عديم الأثر في إعدادات كل إطار. تشمل القابلية للملاحظة سكربت doctor، وسكربت analyze، وأمر /dejavu status، ومتغير بيئة debug.