প্রকল্প সম্পর্কে

লিঞ্চপিন হলো একটি লোকাল-ফার্স্ট এভিডেন্স ও অ্যানালাইসিস প্ল্যাটফর্ম, যা দীর্ঘমেয়াদী লোকাল ডেটা লেকসহ একজন অপারেটরের জন্য তৈরি। এটি সাধারণত আলাদা আলাদা সিস্টেমে থাকা ডেটা পড়ে — অ্যাক্টিভিটি ক্যাপচার, টার্মিনাল হিস্ট্রি, Git ও GitHub অ্যাক্টিভিটি, AI-সেশন আর্কাইভ, ব্রাউজার ও কমিউনিকেশন এক্সপোর্ট, হেলথ রেকর্ড এবং মেশিন টেলিমেট্রি — এবং সেগুলোকে পুনরুৎপাদনযোগ্য DuckDB ডেটাসেট, এভিডেন্স গ্রাফ, অ্যানালাইসিস প্রোডাক্ট এবং মানুষ ও এজেন্টের জন্য সীমিত কনটেক্সট প্যাকে রূপান্তর করে। কাঁচা ডেটা তার মালিক সিস্টেমেই থাকে। লিঞ্চপিন স্পষ্ট কভারেজ, ফ্রেশনেস ও প্রোভেন্যান্সসহ রিড মডেল তৈরি করে, যাতে ফলাফলগুলোকে সমর্থনকারী ক্যাপচার ও এক্সপোর্ট পর্যন্ত ট্রেস করা যায়। এটি কোনো হোস্টেড সার্ভিস নয়; পাবলিক ট্রি-তে পুনঃব্যবহারযোগ্য পার্সার, স্কিমা, অ্যানালাইসিস, কোয়েরি টুল, টেস্ট ও নিরপেক্ষ ফিক্সচার থাকে, আর ব্যক্তিগত পরিচয়, ভোকাবুলারি, ক্লাসিফিকেশন, এক্সপোর্ট ও জেনারেটেড ন্যারেটিভ বাইরের কনফিগারেশনের মাধ্যমে সরবরাহ করা হয়। এটি সাধারণত যে প্রশ্নগুলোর উত্তর দেয় সেগুলোর মধ্যে আছে: একটি কমিটের আগে কোন AI সেশন ও টার্মিনাল কমান্ড ছিল, বিল্ড বা সার্ভিস ব্যর্থ হওয়ার সময় মেশিন কী করছিল, প্রকল্পভেদে সময় ও ফোকাস কীভাবে ভিন্ন ছিল, কাজ বা স্বাস্থ্য সম্পর্কে কোনো দাবির পক্ষে কোন এভিডেন্স আছে, কোন সোর্স অনুপস্থিত বা পুরনো, এবং একটি প্রকল্প বা সময়-উইন্ডোর জন্য একজন এজেন্ট কী সীমিত কনটেক্সট পাওয়া উচিত। সোর্স-নির্দিষ্ট টুলগুলোই প্রামাণিক থাকে; লিঞ্চপিন সোর্সের সীমানা মুছে না ফেলেই তাদের রেকর্ডগুলোকে জয়েনযোগ্য করে। পাইপলাইনটি ক্যাপচার, এক্সপোর্ট, রিপোজিটরি ও সার্ভিস লেজার থেকে টাইপড সোর্স অ্যাডাপ্টারের মাধ্যমে ক্যানোনিকাল ডেটাসেট ও ম্যানিফেস্টে যায়, তারপর DuckDB-তে, যা থেকে এভিডেন্স গ্রাফ ও অ্যানালাইসিস প্রোডাক্ট তৈরি হয় এবং কনটেক্সট প্যাক, একটি CLI ও MCP-তে feeds করে। একটি মেটেরিয়ালাইজেশন প্ল্যানার নির্ধারণ করে কোন ডেটাসেট অনুপস্থিত বা পুরনো, ডিপেন্ডেন্সি ক্রমে সেগুলো রিবিল্ড করে এবং প্রতিটি ফলাফলের জন্য একটি ম্যানিফেস্ট রেকর্ড করে। রিফ্রেশ আইডি গ্রাফ ও রিপোর্টকে একটি নির্দিষ্ট 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 লাইসেন্সের অধীনে লাইসেন্সকৃত।