عن المشروع

يعمل TraceDecay كخدمة محلية تُدار عبر خادم خفي (daemon) تُغني وكلاء البرمجة بالذكاء الاصطناعي عن تكرار تشغيل عمليات grep وglob وقراءة الملفات الخام عند العمل على قاعدة برمجية. يبني رسماً بيانياً دلالياً منظماً للمستودع المستهدف، ويخزّن البيانات المفهرسة عبر بيئة تشغيل SQLite مملوكة للخادم الخفي ومخزن رسوم بيانية مضمّن، مع كون التشغيل المحلي هو السلوك الافتراضي. توفّر الأداة مجموعة من أدوات بروتوكول سياق النموذج (MCP) المصنّفة موزّعة على مسارات العمل البرمجية الشائعة: أدوات الاستكشاف لاسترجاع السياق والبحث عن الرموز والاطلاع على مخططات المصدر؛ أدوات اجتياز الرسم البياني لتخطيط المستدعين والمستدَعين ونطاق التأثير والملفات المتأثرة؛ أدوات صحة الكود لقياس التعقيد واكتشاف الكود الميت وتحديد الملفات غير المركّبة وتقييم الاقتران ورصد مخاطر الاختبار؛ أدوات سير عمل git لسحب سياق الفروقات وسياق طلبات السحب وسجلات التغيير وخرائط الاختبار؛ أدوات التحرير المرسّخة لملف واحد التي تُطلق إعادة فهرسة تلقائية بعد التغييرات؛ وأدوات ذاكرة المشروع الدائمة لتخزين حقائق المشروع والبحث فيها وإدارتها عبر الفروع وأشجار عمل git المرتبطة. تأتي الأداة بتكاملات أصلية مع مجموعة من بيئات البرمجة بالذكاء الاصطناعي الشائعة بما في ذلك Claude Code وCodex وCursor وأدوات عائلة Cline وKiro وKimi Code وOpenCode وHermes، مع خيارات تثبيت عامة ومحلية للمشروع. يدير الخادم الخفي الخلفي حداثة الفهرس والتقارب الخلفي وتتبّع الأصول الثابتة للإنشاءات عبر أشجار العمل والفروع والالتزامات، ويبلّغ عن حالة صريحة لتغطية الفهرس سواء كانت قيد التسخين أو تتطلب التحديث أو جزئية أو غير متاحة، بدلاً من تنفيذ مزامنات خفية أو استخدام بيانات فهرس قديمة بصمت. تشمل الميزات الداعمة لوحة تحكم ويب محلية لاستكشاف الرسم البياني ومراجعة ذاكرة المشروع والبحث في جلسات LCM وتتبّع توفير الرموز وتحليلات التكلفة، إضافة إلى واجهة طرفية للمراقبة الحية لتوفير استدعاءات MCP وتكاليفها. التثبيت مدعوم على macOS وLinux وWindows، مع أرشيفات إصدارات مبنية مسبقاً، ونص تثبيت يتحقق من أصل البناء عبر شهادة GitHub، وأوامر ترقية ذاتية مدمجة. ضوابط الخصوصية مدمجة في التصميم: تعمل وظائف الفهرسة والاستعلام والذاكرة ولوحة التحكم الأساسية محلياً افتراضياً، مع ميزات شبكية اختيارية (عدّاد توفير الرموز التجميعي، وفحوصات الإصدارات، وتنزيلات نماذج دلالية من Hugging Face، ونسخ السلطة عن بُعد) تتطلب موافقة صريحة وتفشل بشكل آمن إذا فشلت بيانات الاعتماد أو فحوصات السياسة. المشروع منفّذ بلغة Rust، مع مستخرجات لغات مبنية على tree-sitter متاحة في مستويات ميزات قابلة للتهيئة، ويُصدر بموجب رخصة MIT.