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

diffctx একটি CLI টুল এবং MCP সার্ভার যা একটি LLM-কে git diff পর্যালোচনা করার জন্য প্রয়োজনীয় ন্যূনতম কোড কনটেক্সট নির্বাচন করে। সম্পূর্ণ ফাইল পেস্ট করার পরিবর্তে, এটি ৫০+ ফাইল টাইপ জুড়ে একটি কোড গ্রাফ (ইমপোর্ট, সহ-পরিবর্তন, টাইপ রেফারেন্স) তৈরি করে, পরিবর্তিত লাইন থেকে বাইরের দিকে প্রাসঙ্গিকতা বিস্তার করে, এবং প্রাসঙ্গিকতা একটি থ্রেশহোল্ডের নিচে নেমে গেলে বা টোকেন বাজেটের সীমা পৌঁছালে থামে। মূল ক্ষমতা: - ডিফ কনটেক্সট মোড: একটি git রেঞ্জ (HEAD~1..HEAD, main..feature) বা একটি সময়কাল উইন্ডো (24h, 8d, 90min) গ্রহণ করে যা উইন্ডোর আগে শেষ কমিটের বিপরীতে ওয়ার্কিং ট্রি ডিফ করে। আউটপুট Markdown, JSON, বা YAML। - একাধিক স্কোরিং অ্যালগরিদম: ego (সীমিত বিস্তার), PPR (পার্সোনালাইজড পেজর্যাংক), BM25 (লেক্সিকাল রিট্রিভাল), RRF (রেসিপ্রোকাল-র্যাংক ফিউশন), এবং PIT (পার্সেন্টাইল ফিউশন)। - o200k_base টোকেনাইজার সহ টোকেন বাজেটিং; বাজেট রেন্ডার করা আর্টিফ্যাক্টকে সীমাবদ্ধ করে, প্রতিটি পরিবর্তিত ফাইলের একটি উইটনেস ফ্র্যাগমেন্ট পাওয়ার পর প্রাসঙ্গিকতা অবশিষ্ট স্থান পূরণ করে। - graph সাবকমান্ড: Mermaid, JSON, বা GraphML আউটপুটের মাধ্যমে সরাসরি ডিপেন্ডেন্সি গ্রাফ অন্বেষণ; সাইকেল, হটস্পট এবং কাপলিং মেট্রিক্স অন্তর্ভুক্ত। - সম্পূর্ণ কোডবেস এক্সপোর্ট মোড: কনফিগারযোগ্য গভীরতা, ইগনোর প্যাটার্ন এবং ক্লিপবোর্ড সমর্থন সহ Markdown/JSON ট্রি আউটপুট। - MCP সার্ভার: AI সহায়কদের (Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, VS Code) জন্য কোড রিভিউ চলাকালীন কল করার জন্য একটি diffctx_context টুল প্রকাশ করে। অফিসিয়াল MCP রেজিস্ট্রিতে প্রকাশিত। - Python API: প্রোগ্রাম্যাটিক ব্যবহারের জন্য build_diff_context() এবং map_directory() ফাংশন। ইনস্টলেশন uvx, pipx, pip, cargo, npm, Docker এবং Windows-এ Scoop এর মাধ্যমে উপলব্ধ। প্রি-বিল্ট বাইনারি Linux (x86_64/aarch64), macOS (arm64/x86_64) এবং Windows (x64/arm64) কভার করে। নেটিভ বাইনারি এবং Docker ইমেজ YAML/JSON আউটপুট সহ ডিফ মোড পরিচালনা করে; ট্রি মোড, Markdown আউটপুট, graph সাবকমান্ড এবং MCP সার্ভারের জন্য Python প্যাকেজ প্রয়োজন। টুলটি .gitignore এবং .diffctx/ignore শ্রেণিবদ্ধভাবে সম্মান করে, স্বয়ংক্রিয়ভাবে গোপনীয়-সদৃশ পাথ ফিল্টার করে, প্রতি-ব্লব টোকেনাইজেশন ক্যাশ করে এবং stderr-এ টোকেন গণনা রিপোর্ট করে। এক্সিট কোড সাফল্য, রানটাইম ত্রুটি, ব্যবহার ত্রুটি, পরিবেশ ত্রুটি এবং খালি-ডিফ পরিস্থিতি আলাদা করে। Apache 2.0 এর অধীনে লাইসেন্সকৃত।