عن المشروع

TESSERA (Temporal Evolving State Synthesis with Explicit Relations and Atomic Memories) هي طبقة ذاكرة وأدلة تعتمد على النصوص لوكلاء الذكاء الاصطناعي. يتم نشرها تحت اسم tessera-agent-memory، بينما يظل استيراد Python وواجهة CLI باسم tessera، وتتطلب Python 3.9+، وهي مرخصة بموجب MIT. الإصدار الحالي هو 0.0.1. يطرح المشروع نفسه كبنية تحتية للذاكرة بدلاً من أن يكون وكيل استدلال نهائي. تظل مصادر Markdown والنصوص هي المرجعية المعتمدة؛ بينما تكون الفهارس والرسوم البيانية والذاكرة المخبئية وسجلات الأدلة مشتقة وقابلة لإعادة البناء. يعيد الاسترجاع أدلة مهيكلة بدلاً من إجابة مولدة، ويذكر ملف README أن الصلة لا تُعامل كحقيقة أو ثقة أو سلطة، وأنه لا يتم إعادة كتابة المصادر بصمت أثناء الفهرسة، ولا يلزم وجود LLM توليدي لمسار الاسترجاع الأساسي. الواجهات والاستخدام - واجهة CLI: تشمل tessera init، write، index، query، بالإضافة إلى config show/list/doctor/unregister. يتطلب الأمر init غير التفاعلي سياسة --sources صريحة، ويجب فحص التغييرات الجوهرية في التكوين الحالي باستخدام --dry-run ثم السماح بها عبر --update-existing. - واجهة Python API: توفر TesseraEngine(storage_dir=...).build_index() و retrieve_context(query, top_n=...)، والتي تعيد حقولاً مثل id، و score مع score_explain، و relevant_evidence، وجسم الذاكرة الكامل، ومسار المصدر، وهوية مستند المصدر المستقرة، وhashes إصدار المصدر، ونطاق الدليل ومعرفات الذاكرة ذات الصلة. - MCP: تضيف إضافة tessera[mcp] الاختيارية نقل MCP (SDK v1.30+، Python 3.10+، معتمدة على 3.12)، عبر tessera-mcp --project /absolute/project؛ كما تضيف إضافة tessera[llm] الاختيارية جسراً لـ LLM عبر HTTP. نموذج الذاكرة والتخزين - يتم الحفاظ على ثلاثة أدراج دلالية بالضبط: الحقائق (facts)، والتفضيلات (preferences)، والرؤى (insights). - يتم فصل الهوية عن موقع الملف وإصدار المحتوى، لذا فإن نقل المستند لا يؤدي تلقائياً إلى إنشاء ذاكرة جديدة أو هوية مصدر جديدة. - التكوين هو schema v2 مقروءة بشرياً: store.path هو وجهة الذاكرة المولدة، و sources.roots هي قائمة مسموح بها صراحة للقراءة/الفهرسة، و index.path هي حالة مشتقة قابلة للتخلص منها داخل المشروع. يمكن لسجل عالمي للمستخدم تذكر المتاجر المسماة دون نسخ أو دمج ذاكرتها. - ترتيب دقة التخزين هو: المسار الصريح، ثم TESSERA_STORAGE_DIR، ثم LAO_MEM_DIR (المهجور)، ثم أقرب تكوين للمشروع، ثم إدخال عالمي مسمى؛ وتفشل عمليات CLI بخطأ قابل للتنفيذ إذا لم يتم اختيار أي منها. - Markdown هو التنسيق الكتابي المعتمد الوحيد؛ ويتم رفض التنسيقات غير المدعومة واستيعاب JSON العشوائي قبل أي تغيير في التخزين أو السجل أو الرسم البياني أو فهرس Evidence Ledger. - تتبع عمليات الكتابة عقداً حتمياً: التحقق من المسار، الكشف، التحويل الاختياري، القبول، والاستمرارية. يتم قبول المحتوى الآمن دون تغيير؛ ويتم رفض المدخلات الفارغة والتعليمات المعادية المعروفة مباشرة؛ أما الأمثلة المقتبسة والمدخلات التي تحتوي على علامات مشبوهة فقط فتذهب للمراجعة دون آثار جانبية على الاستمرارية. - يدعم ملف .tessera-ignore الاختياري مجموعة فرعية موثقة من صيغة التجاهل (التعليقات، *، ?، **، لاحقة الدليل، وإعادة الإدراج المرتبة !). لا يمكن إعادة إدراج الاستثناءات الإلزامية مثل .git والفهرس المشتق وأدوات الاعتماد. التقييم والحالة يقوم سجل مدمج وغير حساس بإصدار ملف تعريف استرجاع حتمي LongMemEval V1 dev-50، حيث يسجل مقاييس الاسترجاع الإجمالية، والمدخلات المجمدة، والتكوين، ومنشأ الالتزام (commit provenance)، والتكلفة و hashes دون إرسال مجموعة البيانات أو خرائط الحقيقة الأرضية. يعلن كل طلب سحب (PR) عن قابلية تطبيق المعيار؛ وتعمل تقارير الفحص غير المتصلة بالإنترنت لكل PR، ويتم حظر ملف تعريف الـ 50 استعلاماً المجمد مقابل SHA الأساسي لطلب السحب. يشير ملف README إلى أن هذه الدرجات تقيس استرجاع الأدلة، وليس صحة الإجابة النهائية. يتم وصف TESSERA بأنها أساس يتطور. الميزات المتاحة اليوم تشمل البيانات الوصفية المعتمدة وتصنيف المستندات، وهوية الذاكرة والمصدر المستقرة، والاسترجاع المحلي القابل للتفسير، والأدلة ذات الصلة المدركة للاستعلام، و Evidence Ledger والمنشأ، وتحليل/تنقل العلاقات، وواجهات Python/CLI/MCP، و CI حتمي مع تقييم السلامة. العناصر التي لا تزال تحت الاختبار تشمل الفهرسة التزايدية والمتكررة (idempotent)، واستيعاب وتقسيم نصوص أوسع، وخط أساس LongMemEval، وتوسيع الرسم البياني المدرك للاستعلام، والحالة الزمنية، والتحكيم في الأدلة المتعارضة، والاسترجاع التكيفي. تغطي الوثائق الهندسة المعمارية، والمفاهيم، وأمثلة الاستعلام، وعقد مخرجات الاسترجاع، وخارطة الطريق، والمراجع البحثية، وسياسة التغيير؛ ويتم حالياً صيانة المستودع بواسطة Luigi Ferronatto.