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

لِنچپِن ایک مقامی-اول شواہد اور تجزیہ پلیٹ فارم ہے جو ایک واحد آپریٹر کے لیے طویل المدتی مقامی ڈیٹا جھیل کے ساتھ کام کرتا ہے۔ یہ ایسا ڈیٹا پڑھتا ہے جو عام طور پر الگ الگ نظاموں میں رہتا ہے — ایکٹیویٹی کیپچرز، ٹرمینل ہسٹری، Git اور GitHub ایکٹیویٹی، AI-سیشن آرکائیوز، براؤزر اور مواصلاتی ایکسپورٹس، ہیلتھ ریکارڈز، اور مشین ٹیلی میٹری — اور انہیں قابلِ تولید DuckDB ڈیٹاسیٹس، شواہد گراف، تجزیاتی مصنوعات، اور انسانوں اور ایجنٹس کے لیے محدود کانٹیکسٹ پیک میں بدلتا ہے۔ خام ڈیٹا اُسی نظام میں رہتا ہے جو اُس کا مالک ہے۔ لِنچپِن واضح کوریج، تازگی، اور ماخذ کے ساتھ ریڈ ماڈلز بناتا ہے، تاکہ نتائج کو اُن کیپچرز اور ایکسپورٹس تک واپس ٹریس کیا جا سکے جو اُن کی تائید کرتی ہیں۔ یہ کوئی ہوسٹڈ سروس نہیں ہے؛ عوامی درخت میں دوبارہ استعمال کے قابل پارسرز، اسکیمے، تجزیے، کوئری ٹولز، ٹیسٹس، اور غیر جانبدار فکسچرز شامل ہیں، جبکہ نجی شناختیں، ذخیرہ الفاظ، درجہ بندیاں، ایکسپورٹس، اور تیار کردہ بیانیے بیرونی کنفیگریشن کے ذریعے فراہم کیے جاتے ہیں۔ یہ عام طور پر جن سوالات کو حل کرتا ہے اُن میں شامل ہیں: کون سے AI سیشنز اور ٹرمینل کمانڈز کسی کمٹ سے پہلے تھے، جب کوئی بلڈ یا سروس ناکام ہوئی تو مشین کیا کر رہی تھی، مختلف پروجیکٹس میں وقت اور توجہ کیسے مختلف تھی، کام یا صحت کے بارے میں کسی دعوے کی تائید کون سے شواہد کرتے ہیں، کون سے ذرائع غائب یا پرانے ہیں، اور کسی پروجیکٹ یا وقت کی ونڈو کے لیے ایجنٹ کو کون سا محدود کانٹیکسٹ ملنا چاہیے۔ ماخذ کے مخصوص ٹولز ہی مستند رہتے ہیں؛ لِنچپِن اُن کے ریکارڈز کو ماخذ کی حدود کو مٹائے بغیر جوڑنے کے قابل بناتا ہے۔ پائپ لائن کیپچرز، ایکسپورٹس، ریپوزٹریز، اور سروس لیجرز سے ٹائپ شدہ سورس اڈاپٹرز کے ذریعے کینونیکل ڈیٹاسیٹس اور مینی فیسٹس میں، پھر DuckDB میں چلتی ہے، جہاں سے شواہد گراف اور تجزیاتی مصنوعات اخذ ہوتی ہیں، جو کانٹیکسٹ پیک، ایک CLI، اور MCP کو فیڈ کرتی ہیں۔ ایک میٹیریالائزیشن پلانر طے کرتا ہے کہ کون سے ڈیٹاسیٹس غائب یا پرانے ہیں، اُنہیں انحصار کی ترتیب میں دوبارہ بناتا ہے، اور ہر نتیجے کے لیے ایک مینی فیسٹ ریکارڈ کرتا ہے۔ ریفریش IDs گراف اور رپورٹس کو ایک مخصوص DuckDB اسنیپ شاٹ سے جوڑتے ہیں، جس سے بیانیہ آؤٹ پٹ شواہد کے بعد کے مرحلے میں رہتا ہے۔ موجودہ ذرائع میں شامل ہیں: ActivityWatch ایپلیکیشن اور فوکس ایونٹس؛ Atuin کمانڈز اور asciinema ریکارڈنگز؛ Git ریپوزٹریز، GitHub ایکٹیویٹی، کوڈ اسنیپ شاٹس، اور PR ریویو تفصیلات؛ Polylogue سیشن پروفائلز اور ورک ایونٹس؛ براؤزر ہسٹری، بُک مارکس، کلپ بورڈ، اور مواصلاتی ایکسپورٹس؛ پہننے کے قابل ہیلتھ، نیند، اور میڈیا ایکسپورٹس؛ اور مشین میٹرکس، سروس اسٹیٹ، بینچ مارکس، اور سسٹم جنریشنز۔ اڈاپٹرز ماخذ کے مخصوص تحفظات برقرار رکھتے ہیں: غائب مشاہدات صفر نہیں بنتے، اور ایکسپورٹ سے محدود ڈیٹاسیٹس مسلسل کیپچر سے الگ قابلِ تمیز رہتے ہیں۔ DuckDB پرت عام SQL اور کمٹس، فائلوں، علامات، اور ریویو ہسٹری کے لیے مستحکم ریڈرز پیش کرتی ہے؛ AI ورک ایونٹس اور سیشن پروفائلز؛ ایکٹیویٹی، فوکس، ہیلتھ، اور مواصلاتی سگنلز؛ مشین اسٹیٹ، پریشر، سروسز، اور تجربات؛ اور شواہد کے دعوے، گراف ایجز، اور سورس ریڈی نیس۔ یہ ایک جوائن اور ایکسیلیریشن پرت ہے، خام ڈیٹا کا دوسرا آرکائیو نہیں۔ گراف پرت پروجیکٹس، کمٹس، فائلوں، AI ورک، ٹرمینل ایکٹیویٹی، فوکس اسپینز، GitHub آئٹمز، مشین کانٹیکسٹ، ذاتی سگنلز، اور تجزیاتی دعووں کو جوڑتی ہے، اور پروجیکٹ/دن کے باہمی تعلق، سیشن سے کمٹ کے باہمی تعلق، ایشو/PR/کمٹ کلوزر چینز، فائل اور علامت کے اوورلیپ، سورس-ریڈی نیس اور اعتماد میٹرکس، زمانی ٹائم لائنز، اور واضح کمزور-شواہد اختیارات کے ساتھ Markdown/JSON کانٹیکسٹ پیک کی تائید کرتی ہے۔ تجزیہ پیکیج کوڈ کی رفتار، تبدیلی کی سطحوں، انحصار کے نقشوں، ری فیکٹر امیدواروں، کراس-پروجیکٹ موازنہ، کام کی تال، فوکس کی تقسیم، AI-سیشن کی کارکردگی، ہیلتھ اور نیند کے سگنلز، مشین پریشر، ورک لوڈ اوورلیپ، سروس کے رویے، اور کیلیبریٹڈ انتساب کا احاطہ کرتا ہے۔ کینونیکل میٹرکس میں ایک ٹائم فریم، یونٹ یا ڈینومینیٹر، اور آرٹیفیکٹ پاتھ ہوتا ہے۔ MCP سرور آٹھ عوامی ٹولز پیش کرتا ہے: lynchpin_status، lynchpin_catalog، lynchpin_query، lynchpin_evidence، lynchpin_project، lynchpin_personal، lynchpin_machine، اور lynchpin_ops۔ ریڈ پاتھز صرف-پڑھنے کے لیے ہیں؛ مقامی اسٹیٹ کو میٹیریالائز یا ہٹانے والے آپریشنز کے لیے واضح execute فیصلہ درکار ہوتا ہے اور وہ رسیدیں پیدا کرتے ہیں۔ ڈیولپمنٹ Nix-اول ہے (direnv allow یا nix develop)، ٹیسٹس pytest -q کے ساتھ چلتے ہیں، اور CLI انٹری پوائنٹس مصنوعات میٹیریالائز کرتے ہیں، وقت کی ونڈوز کو پروموٹ کرتے ہیں، موجودہ-اسٹیٹ کانٹیکسٹ پیک رینڈر کرتے ہیں، اور stdio MCP سرور شروع کرتے ہیں۔ کمانڈز LynchpinConfig اور ماحولیاتی متغیرات کے ذریعے ڈیٹا روٹس دریافت کرتے ہیں؛ نجی پروفائل کے بغیر ایک چیک آؤٹ پھر بھی ٹیسٹ چلا سکتا ہے، اسکیمے اور ٹول کیٹلاگ دیکھ سکتا ہے، اور غیر جانبدار فکسچرز استعمال کر سکتا ہے۔ ریپوزٹری core، sources، ingest، substrate، graph، analysis، mcp، اور cli پیکجز میں منظم ہے، جس میں ٹیسٹس اور ایک نظرانداز شدہ .lynchpin/ مقامی اسٹیٹ ڈائریکٹری شامل ہے۔ ڈیٹا کی حدود سورس اڈاپٹرز کو خام ایکسپورٹس میں تبدیلی سے روکتی ہیں، آپریٹر کنفیگریشن کو ریپوزٹری سے باہر رکھتی ہیں، اور AI-سیشن انجیشن کی ملکیت Polylogue، ایونٹ کیپچر کی Sinex، اور ہوسٹ کنفیگریشن کی Sinnix کو تفویض کرتی ہیں۔ MIT کے تحت لائسنس یافتہ۔