इस प्रोजेक्ट के बारे में

लिंचपिन एक स्थानीय-प्रथम साक्ष्य और विश्लेषण मंच है जो एकल ऑपरेटर के लिए दीर्घकालिक स्थानीय डेटा लेक के साथ काम करता है। यह उस डेटा को पढ़ता है जो सामान्यतः अलग-अलग प्रणालियों में रहता है — गतिविधि कैप्चर, टर्मिनल इतिहास, Git और GitHub गतिविधि, AI-सत्र संग्रह, ब्राउज़र और संचार निर्यात, स्वास्थ्य रिकॉर्ड, और मशीन टेलीमेट्री — और उन्हें पुनरुत्पादनीय DuckDB डेटासेट, साक्ष्य ग्राफ़, विश्लेषण उत्पादों, और मनुष्यों व एजेंटों के लिए सीमित संदर्भ पैक में बदलता है। कच्चा डेटा उसी प्रणाली में रहता है जो उसका स्वामी है। लिंचपिन स्पष्ट कवरेज, ताज़गी, और उद्गम के साथ रीड मॉडल बनाता है, ताकि परिणामों को उन कैप्चर और निर्यात तक वापस ट्रेस किया जा सके जो उनका समर्थन करते हैं। यह एक होस्टेड सेवा नहीं है; सार्वजनिक ट्री में पुन: प्रयोज्य पार्सर, स्कीमा, विश्लेषण, क्वेरी उपकरण, परीक्षण, और तटस्थ फिक्स्चर शामिल हैं, जबकि निजी पहचान, शब्दावली, वर्गीकरण, निर्यात, और उत्पन्न आख्यान बाहरी कॉन्फ़िगरेशन के माध्यम से आपूर्ति किए जाते हैं। यह जिन विशिष्ट प्रश्नों का समाधान करता है उनमें शामिल हैं: किस AI सत्र और टर्मिनल कमांड ने एक कमिट से पहले काम किया, जब कोई बिल्ड या सेवा विफल हुई तो मशीन क्या कर रही थी, परियोजनाओं में समय और फोकस कैसे भिन्न थे, कार्य या स्वास्थ्य के बारे में किसी दावे का समर्थन कौन सा साक्ष्य करता है, कौन से स्रोत अनुपस्थित या पुराने हैं, और किसी परियोजना या समय विंडो के लिए एजेंट को कौन सा सीमित संदर्भ प्राप्त होना चाहिए। स्रोत-विशिष्ट उपकरण प्रामाणिक बने रहते हैं; लिंचपिन उनके रिकॉर्ड को स्रोत सीमाओं को मिटाए बिना जोड़ने योग्य बनाता है। पाइपलाइन कैप्चर, निर्यात, रिपॉजिटरी, और सेवा लेजर से टाइप्ड स्रोत अडैप्टर के माध्यम से कैनोनिकल डेटासेट और मैनिफेस्ट में चलती है, फिर DuckDB में, जहाँ से साक्ष्य ग्राफ़ और विश्लेषण उत्पाद प्राप्त होते हैं, जो संदर्भ पैक, एक CLI, और MCP को फीड करते हैं। एक मटेरियलाइज़ेशन प्लानर निर्धारित करता है कि कौन से डेटासेट अनुपस्थित या पुराने हैं, उन्हें निर्भरता क्रम में पुनर्निर्मित करता है, और प्रत्येक परिणाम के लिए एक मैनिफेस्ट रिकॉर्ड करता है। रीफ्रेश ID ग्राफ़ और रिपोर्ट को एक विशिष्ट DuckDB स्नैपशॉट से जोड़ते हैं, जिससे आख्यान आउटपुट साक्ष्य के डाउनस्ट्रीम रहता है। वर्तमान स्रोतों में ActivityWatch एप्लिकेशन और फोकस इवेंट; Atuin कमांड और asciinema रिकॉर्डिंग; Git रिपॉजिटरी, GitHub गतिविधि, कोड स्नैपशॉट, और PR समीक्षा विवरण; Polylogue सत्र प्रोफ़ाइल और कार्य इवेंट; ब्राउज़र इतिहास, बुकमार्क, क्लिपबोर्ड, और संचार निर्यात; पहनने योग्य स्वास्थ्य, नींद, और मीडिया निर्यात; और मशीन मेट्रिक्स, सेवा स्थिति, बेंचमार्क, और सिस्टम जनरेशन शामिल हैं। अडैप्टर स्रोत-विशिष्ट चेतावनियों को संरक्षित करते हैं: अनुपस्थित अवलोकन शून्य नहीं बनते, और निर्यात-सीमित डेटासेट निरंतर कैप्चर से अलग पहचाने योग्य रहते हैं। DuckDB परत कमिट, फ़ाइलों, प्रतीकों, और समीक्षा इतिहास के लिए सामान्य SQL और स्थिर रीडर प्रदान करती है; AI कार्य इवेंट और सत्र प्रोफ़ाइल; गतिविधि, फोकस, स्वास्थ्य, और संचार संकेत; मशीन स्थिति, दबाव, सेवाएँ, और प्रयोग; और साक्ष्य दावे, ग्राफ़ किनारे, और स्रोत तैयारी। यह एक जॉइन और त्वरण परत है, कच्चे डेटा का दूसरा संग्रह नहीं। ग्राफ़ परत परियोजनाओं, कमिट, फ़ाइलों, AI कार्य, टर्मिनल गतिविधि, फोकस स्पैन, GitHub आइटम, मशीन संदर्भ, व्यक्तिगत संकेत, और विश्लेषण दावों को जोड़ती है, जो परियोजना/दिन सहसंबंध, सत्र-से-कमिट सहसंबंध, issue/PR/commit क्लोज़र श्रृंखलाओं, फ़ाइल और प्रतीक ओवरलैप, स्रोत-तैयारी और विश्वास मैट्रिक्स, कालानुक्रमिक टाइमलाइन, और स्पष्ट कमज़ोर-साक्ष्य विकल्पों के साथ Markdown/JSON संदर्भ पैक का समर्थन करती है। विश्लेषण पैकेज कोड वेग, परिवर्तन सतहों, निर्भरता मानचित्रों, रिफैक्टर उम्मीदवारों, क्रॉस-प्रोजेक्ट तुलना, कार्य लय, फोकस विखंडन, AI-सत्र दक्षता, स्वास्थ्य और नींद संकेतों, मशीन दबाव, कार्यभार ओवरलैप, सेवा व्यवहार, और कैलिब्रेटेड एट्रिब्यूशन को कवर करता है। कैनोनिकल मेट्रिक्स में एक समयसीमा, इकाई या हर, और आर्टिफैक्ट पथ होता है। MCP सर्वर आठ सार्वजनिक उपकरण प्रदान करता है: lynchpin_status, lynchpin_catalog, lynchpin_query, lynchpin_evidence, lynchpin_project, lynchpin_personal, lynchpin_machine, और lynchpin_ops। पढ़ने के पथ केवल-पढ़ने योग्य हैं; स्थानीय स्थिति को मटेरियलाइज़ या हटाने वाले ऑपरेशन के लिए एक स्पष्ट निष्पादन निर्णय की आवश्यकता होती है और रसीदें उत्पन्न करते हैं। विकास 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 के अंतर्गत लाइसेंस प्राप्त।