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

lore ایک مقامی کمانڈ لائن ٹول اور ویب ایکسپلورر ہے جو ان تمام چیزوں کے لیے ہے جو Claude Code ایک مشین پر لکھتا ہے۔ Claude Code سیشن ٹرانسکرپٹس، میموری اور پرامپٹ ہسٹری کو ایک ڈیٹا ڈائریکٹری میں رکھتا ہے، جو ہر پروجیکٹ کے لیے الگ ہوتی ہے، اور اس کی ڈیفالٹ ریٹینشن تقریباً 30 دنوں کے بعد ٹرانسکرپٹس کو حذف کر دیتی ہے۔ lore اس خام ڈیٹا کا ایک ایڈٹیو مرر (additive mirror) رکھتا ہے، اسے انڈیکس کرتا ہے، اور اپنی سیشن ہسٹری پر ایک کوئری سطح فراہم کرتا ہے۔ انسٹالیشن اور پلیٹ فارمز: اس پروجیکٹ کے لیے صرف Bun کی ضرورت ہے، کسی rsync یا ٹول چین ڈیپینڈینسی کی ضرورت نہیں ہے۔ اس کی کنٹینیوئس انٹیگریشن ٹیسٹ سویٹ چلاتی ہے اور macOS، Linux اور Windows پر بائنری انسٹال کرتی ہے۔ ایکسپلورر سمیت تمام ورब्स تینوں پلیٹ فارمز پر کام کرتے ہیں۔ استثنیٰ lore سرور سپروائزر ہے، جو launchd یوزر ایجنٹ کے ذریعے ایکسپلورر کو بیک گراؤنڈ میں چلاتا ہے، اس لیے یہ صرف macOS کے لیے ہے اور بصورتِ دیگر صارفین کو lore serve کی طرف رہنمائی کرتا ہے۔ انسٹال اسکرپٹ ایک فروزن بائنری بناتا ہے، ڈرٹی ورکنگ ٹری کو مسترد کرتا ہے، اور ہر کال stderr پر اپنا ورژن اور کمٹ رپورٹ کرتی ہے۔ ایک harness-corpus اسکرپٹ Claude Code اپ ڈیٹ کے بعد ڈیمن کی شکلوں کو ٹیسٹ فکسچرز میں محفوظ کرتا ہے۔ ڈیٹا ماڈل اور انڈیکسنگ: ایک well، Claude پروجیکٹس پاتھ کے تحت ایک ڈائریکٹری کا اسٹور ہے، جس کا نام اس کے مطلق پاتھ سے لیا جاتا ہے جس میں غیر الفبائی-عددی حروف کو ہموار (flatten) کر دیا جاتا ہے، اس لیے نامکالرن نقصان دہ (lossy) ہے۔ ہر سیشن ایک چیٹ لاگ کے بجائے JSONL ایونٹ لاگ ہے، جس میں زیادہ تر ٹول ٹریفک، تھنکنگ اینولپس اور ہارنس ایونٹس ہوتے ہیں، ساتھ ہی سبلنگ سب ایجنٹ ٹرانسکرپٹس اور ورک فلو اسکرپٹس ہوتے ہیں۔ index کمانڈ wells کو اسکین کرتی ہے، JSONL کو پارس کرتی ہے اور ترمیم کے وقت اور سائز کے مطابق incrementally، spawns اور workflows لینز کے ساتھ ایک SQLite FTS5 انڈیکس بناتی ہے۔ انڈیکس ایک ڈیریوڈ، دوبارہ بننے والا آرٹفیکٹ ہے جو مائیگریشن کے بجائے ورژن بمپ کرتا ہے اور کسی نئے lore کے ذریعے لکھے گئے ڈیٹا بیس کو کھولنے سے انکار کرتا ہے۔ کمانڈز: archive، Claude ڈیٹا ڈائریکٹری کو lore آرکائیو میں مرر کرتا ہے بغیر اپ اسٹریم ڈیلیشنز کو پھیلائے؛ wells، ڈی-سلگڈ حقیقی راستوں اور جھنڈوں کے ساتھ اسٹورز کی فہرست دیتا ہے؛ sessions اور session، ایک well کے ترتیب وار آرک یا ایک سیشن کو لین کے مطابق ڈمپ کرتے ہیں؛ search، لینز میں FTS5 کو کوئری کرتا ہے اور اس میں پرامپٹ ہسٹری اسپائن شامل ہو سکتی ہے؛ spawns، ہر سب ایجنٹ ماڈل کے لیے تصدیق شدہ بمقابلہ مطلوبہ رپورٹ کرتا ہے جس میں ڈرفٹ جھنڈے اور بوٹ کاسٹ شامل ہوتے ہیں؛ workflows، آرکیسٹریشن رنز کا خلاصہ کرتا ہے؛ polls، ان سیشنز کو جھنڈا لگاتا ہے جو ہر باری میں بیک گراؤنڈ ٹاسک آؤٹ پٹ فائل کو دوبارہ پڑھتے ہیں، جس کی قیمت لگائی جاتی ہے؛ tools، ٹول، اسکل اور کمانڈ انووکیشنز کی گنتی کرتا ہے؛ usage، well، سیشن، ماڈل، دن، ہفتے یا مہینے کے مطابق بلڈ ٹوکن کلاسز اور تھنکنگ کا پروفائل بناتا ہے جس میں تاریخ کے ساتھ لسٹ-پرائس کے برابر قیمت ہوتی ہے؛ trace، ایک سیشن کو ٹرانزیکشنز، اسٹیپس، ٹول کالز اور اینوٹیشنز کے طور پر پیش کرتا ہے؛ agents، لائیو روسٹر کو انڈیکس کے ساتھ جوڑتا ہے؛ stats، کارپس ٹوٹلز، لینز اور وارننگز رپورٹ کرتا ہے۔ ہر کمانڈ ہیلپ آؤٹ پٹ کو سپورٹ کرتی ہے، اور بہت سی کمانڈز ایک well فلٹر قبول کرتی ہیں جو سب اسٹرنگز سے میچ کرتا ہے اور مکمل ویلیو میچنگ کے لیے ایک جھنڈا فراہم کرتا ہے۔ ایکسپلورر: lore serve انڈیکس کو حالیہ سیشنز اور wells، ٹوکن کے استعمال، انفرادی wells اور سیشنز، سرچ رزلٹس اور کمٹ میسجز میں لکھے گئے سیشن ٹریلرز کے لیے سرور-رینڈرڈ HTML صفحات کے طور پر پیش کرتا ہے۔ ہر صفحہ JSON کا جواب بھی دے سکتا ہے، ریڈ ورब्स کو OpenAPI اسپیک کے ساتھ ایک کمانڈ پاتھ کے تحت ماؤنٹ کیا گیا ہے، اور api ورب وہی ہینڈلرز ظاہر کرتا ہے جو کمانڈز کرتے ہیں۔ ڈیفالٹ پورٹ 4949 ہے اور ہوسٹ آپشنز بائنڈنگ کو کنٹرول کرتے ہیں، بشمول Tailscale ایڈریس اگر موجود ہو۔ ججمنٹ لیئر: ڈیٹرمینسٹک، ماڈل-فری CLI کے اوپر ایک اختیاری ویکی ورک فلو موجود ہے۔ wiki init ایک بلٹ ان ٹیمپلیٹ سے مارک ڈاؤن کی git ریپوزٹری بناتا ہے اور skills add ہر کمانڈ کے لیے اسکلز انسٹال کرتا ہے تاکہ Claude Code سیشنز CLI کو دریافت کر سکیں۔ ویکی میں خام مواد کو شامل کرنا، ویکی صفحات کو git-committed دستاویزات میں تبدیل کرنا، اور پرانے کینن کے لیے لنٹ کرنا وہ پروٹوکولز ہیں جو ایک انٹرایکٹو Claude سیشن CLI چلا کر انجام دیتا ہے؛ یہ ڈیزائن نوٹس میں دستاویزی ہیں نہ کہ کمانڈز کے طور پر فراہم کیے گئے ہیں، اس لیے ٹول کو کسی API کی کی ضرورت نہیں ہے۔ ایک docs ورب ریپوزٹریز میں کمٹ کیے گئے مارک ڈاؤن کو انڈیکس کرتا ہے، جسے ورکنگ ٹریز کے بجائے git آبجیکٹس سے پڑھا جاتا ہے۔ ڈیٹا ہینڈلنگ: یہ Claude ڈیٹا ڈائریکٹری کو پڑھتا ہے اور docs کے لیے، کوڈ روٹ کے تحت git آبجیکٹ اسٹورز کو پڑھتا ہے؛ یہ lore ہوم ڈائریکٹری، ایک اختیاری ویکی ریپو اور صرف macOS سپروائزر کے لیے ایک launchd plist لکھتا ہے۔ دستاویزات کی انڈیکسنگ کے لیے درخواست پر واضح git fetch اور وہ پورٹ جس پر ایکسپلورر سنتا ہے، اس کے علاوہ کوئی نیٹ ورک سرگرمی نہیں ہے؛ کچھ بھی اپ لوڈ نہیں کیا جاتا اور کوئی ماڈل کالز، ٹیلی میٹری یا اکاؤنٹس نہیں ہیں۔ کنفیگریشن تصدیق شدہ انوائرمنٹ ویری ایبلز کے ذریعے ہوتی ہے جیسے کہ Claude dir، lore home، code dir، wiki dir اور docs exclude اور assisted لسٹس۔ ایک علیحدہ ڈیپینڈینسی-فری Python اسکرپٹ براہ راست ٹرانسکرپٹ JSONL کو پڑھتا ہے اور وجہ اور سیشن کے اگلے اقدام کے لحاظ سے منکاری ٹول کالز کی رپورٹ کرتا ہے، جس کے ساتھ ایک رن بک ہوتی ہے جو بتاتی ہے کہ ان کا جائزہ کیسے لیا جائے۔ اسٹیٹس: ایک ابتدائی ذاتی ٹول جسے جیسا ہے ویسا ہی شائع کیا گیا ہے، صرف مقامی، MIT لائسنس کے تحت، اور اسے پروڈکٹ بنانے کا کوئی منصوبہ نہیں ہے۔