منصوبے کے بارے میں

TESSERA (Temporal Evolving State Synthesis with Explicit Relations and Atomic Memories) AI ایجنٹس کے لیے ایک ٹیکسٹ-فرسٹ میموری اور شواہد کی تہہ (evidence layer) ہے۔ اسے tessera-agent-memory کے طور پر شائع کیا گیا ہے، جبکہ Python import اور CLI کے لیے tessera استعمال ہوتا ہے۔ اس کے لیے Python 3.9+ درکار ہے اور یہ MIT لائسنس کے تحت دستیاب ہے۔ موجودہ ورژن 0.0.1 ہے۔ یہ پروجیکٹ خود کو حتمی ریزننگ ایجنٹ کے بجائے میموری انفراسٹرکچر کے طور پر پیش کرتا ہے۔ Markdown اور ٹیکسٹ ذرائع مستند رہتے ہیں؛ انڈیکس، گراف، کیش اور شواہد کے ریکارڈ اخذ کیے جاتے ہیں اور انہیں دوبارہ بنایا جا سکتا ہے۔ ریٹریول (Retrieval) کسی تیار شدہ جواب کے بجائے منظم شواہد فراہم کرتا ہے۔ README کے مطابق، متعلقہ ہونے (relevance) کو سچائی، اعتماد یا اتھارٹی کے طور پر نہیں دیکھا جاتا، انڈیکسنگ کے دوران ذرائع کو خاموشی سے تبدیل نہیں کیا جاتا، اور بنیادی ریٹریول راستے کے لیے جنریٹو 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، مکمل میموری باڈی، سورس پاتھ، مستحکم سورس-ڈاکیومنٹ شناخت، سورس ورژن ہیشز، ایویڈنس اسپین اور متعلقہ میموری IDs جیسے فیلڈز واپس کرتا ہے۔ - MCP: ایک اختیاری tessera[mcp] ایکسٹرا MCP ٹرانسپورٹ (SDK v1.30+, Python 3.10+, 3.12 پر تصدیق شدہ) کا اضافہ کرتا ہے، جس کے لیے tessera-mcp --project /absolute/project استعمال ہوتا ہے؛ ایک اختیاری tessera[llm] ایکسٹرا HTTP LLM برج کا اضافہ کرتا ہے۔ میموری ماڈل اور اسٹوریج - تین مخصوص سیمیٹک دراز (drawers) محفوظ رکھے جاتے ہیں: حقائق (facts)، ترجیحات (preferences) اور بصیرتیں (insights)۔ - شناخت (Identity) کو فائل کی لوکیشن اور مواد کے ورژن سے الگ رکھا گیا ہے، لہذا دستاویز کو منتقل کرنے سے خود بخود نئی میموری یا سورس شناخت نہیں بنتی۔ - کنفیگریشن انسانی طور پر پڑھنے کے قابل schema v2 ہے: store.path جنریٹڈ-میموری کی منزل ہے، sources.roots ایک واضح ریڈ/انڈیکس اجازت فہرست ہے، اور index.path پروجیکٹ کے اندر عارضی اخذ شدہ حالت ہے۔ ایک یوزر-گلوبل رجسٹری نامزد اسٹورز کو ان کی میموری کاپی یا مرج کیے بغیر یاد رکھ سکتی ہے۔ - اسٹوریج ریزولوشن کی ترتیب واضح پاتھ، TESSERA_STORAGE_DIR، میٹ شدہ LAO_MEM_DIR، قریب ترین پروجیکٹ کنفیگ، اور پھر ایک نامزد گلوبل انٹری ہے۔ اگر کوئی منتخب نہ ہو تو CLI آپریشنز ایک قابل عمل غلطی (actionable error) کے ساتھ ناکام ہو جاتے ہیں۔ - Markdown واحد مستند قابل تحریر فارمیٹ ہے؛ غیر معاون فارمیٹس اور من مانی JSON ان جسٹشن کو اسٹوریج، رجسٹری، گراف، انڈیکس یا Evidence Ledger کی تبدیلی سے پہلے مسترد کر دیا جاتا ہے۔ - تحریر (Writes) ایک متعین معاہدے پر عمل کرتی ہے: پاتھ ویلیڈیشن، ڈیٹیکشن، اختیاری ٹرانسفارمیشن، ایڈمیشن، اور پرسسٹنس۔ محفوظ مواد کو بغیر تبدیلی کے قبول کیا جاتا ہے؛ خالی ان پٹ اور براہ راست معلوم دشمنانہ ہدایات کو مسترد کر دیا جاتا ہے؛ نقل کردہ مثالیں اور مشکوک ٹیگ والے ان پٹ بغیر کسی اثر کے ریویو کے لیے بھیجے جاتے ہیں۔ - ایک اختیاری .tessera-ignore فائل نظر انداز کرنے کے سنٹیکس کے ایک دستاویزی سب سیٹ (تبصرے، *، ?، **، ڈائریکٹری سفیکس، ترتیب وار ! ری-انکلوزن) کو سپورٹ کرتی ہے؛ لازمی اخراجات جیسے .git، اخذ شدہ انڈیکس اور کریڈنشل آرٹفیکٹس کو دوبارہ شامل نہیں کیا جا سکتا۔ تشخیص اور صورتحال ایک مختصر، غیر حساس لیجر ایک متعین LongMemEval V1 dev-50 ریٹریول پروفائل کے ورژن رکھتا ہے، جو مجموعی ریٹریول میٹرکس، منجمد ان پٹس، کنفیگریشن، کمٹ پروویننس، لاگت اور ہیشز کو ریکارڈ کرتا ہے بغیر ڈیٹا سیٹ یا گراؤنڈ-ٹروتھ میپنگ کو کمٹ کیے بغیر۔ ہر پل ریکویسٹ (PR) بینچ مارک کی اطلاق کی घोषणा کرتی ہے؛ ہر PR کے لیے آف لائن رپورٹنگ چیکز چلتے ہیں اور منجمد 50-کوئری پروفائل کو PR بیس SHA کے خلاف گیٹ کیا جاتا ہے۔ README نوٹ کرتا ہے کہ یہ اسکورز شواہد کی بازیابی (evidence retrieval) کی پیمائش کرتے ہیں، نہ کہ حتمی جواب کی درستگی کی۔ TESSERA کو ایک ارتقائی بنیاد (Foundation) کے طور پر بیان کیا گیا ہے۔ آج دستیاب خصوصیات میں کینونیکل میٹا ڈیٹا اور دستاویز کی درجہ بندی، مستحکم میموری اور سورس شناخت، قابل وضاحت مقامی ریٹریول، کوئری کے مطابق متعلقہ شواہد، Evidence Ledger اور پروویننس، ریلیشن پارسنگ/نیویگیشن، Python/CLI/MCP سرفسز، اور سینیٹی ایویلیویشن کے ساتھ متعین CI شامل ہیں۔ ایسی چیزیں جو ابھی ٹیسٹ کی جا رہی ہیں ان میں انکریمنٹل اور آئیڈیمپوٹنٹ انڈیکسنگ، وسیع تر ٹیکسٹ ان جسٹشن اور سیگمنٹیشن، ایک LongMemEval بیس لائن، کوئری کے مطابق گراف ایکسپینشن، ٹیمپورل اسٹیٹ، متضاد شواہد کی ثالثی، اور اڈاپٹیو ریٹریول شامل ہیں۔ دستاویزات میں آرکیٹیکچر، تصورات، کوئری مثالیں، ریٹریول آؤٹ پٹ کنٹریکٹ، روڈ میپ، تحقیقی حوالہ جات اور تبدیلی کی پالیسی شامل ہے؛ اس ریپوزٹری کی دیکھ بھال فی الحال Luigi Ferronatto کر رہے ہیں۔