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

CodeCartographer एक ऐसा ढांचा है जो AI कोडिंग एजेंट के साथ किसी अपरिचित कोडबेस को समझने और एक सत्यापित, भाषा-निरपेक्ष पुनःकार्यान्वयन विनिर्देश तैयार करने में मदद करता है। यह Pi एक्सटेंशन, MCP सर्वर, या Markdown और YAML फ़ाइलों के ड्रॉप-इन `.codecarto/` टेम्पलेट के रूप में वितरित किया जाता है। यह कैसे काम करता है: "कोड" `.codecarto/` के भीतर संरचित Markdown और YAML है। `GUIDE.md` LLM प्रवेश बिंदु है, `workflow/pipeline.yaml` चरणों और निर्भरताओं को परिभाषित करता है, `workflow/status.yaml` प्रति-प्रोजेक्ट परिवर्तनशील स्थिति रखता है, और `workflow/VALIDATE.md` सत्यापन प्रोटोकॉल का वर्णन करता है। चरण एक DAG बनाते हैं — आर्किटेक्चर के बाद अनुबंध और प्रोटोकॉल समानांतर में चल सकते हैं, पोर्टिंग दोनों की प्रतीक्षा करती है, और पुनःकार्यान्वयन विनिर्देश अंतिम होता है। होस्ट सक्रिय पाइपलाइन पढ़ता है, वह अगला चरण ढूंढता है जिसकी निर्भरताएं पूरी हैं, LLM को उस चरण के निर्देश देता है, आउटपुट को सत्यापित करता है, और स्थिति को आगे बढ़ाता है। साक्ष्य और सत्यापन: प्रत्येक चरण `.codecarto/findings/` के अंतर्गत एक छोटा, टेम्पलेटेड, साक्ष्य-टैग किया गया आर्टिफैक्ट लिखता है, और बाद के चरण अपनी आवश्यक विशिष्ट अपस्ट्रीम फ़ाइलों को फिर से पढ़ते हैं। निष्कर्षों को देखे गए तथ्य, मजबूत अनुमान, पोर्टेबिलिटी जोखिम, बाहरी-व्यवहार दावा, या खुला प्रश्न के रूप में टैग किया जाता है। प्रत्येक चरण का आउटपुट एक `## Validation` तालिका के साथ समाप्त होता है जो प्रत्येक पूर्णता मानदंड को साक्ष्य के साथ PASS, PARTIAL, या FAIL चिह्नित करती है; सत्यापन उस तालिका को पार्स करता है और साक्ष्य/कार्रवाई युग्मन तथा घोषित द्वितीयक आउटपुट की क्रॉस-जांच करता है, FAIL, अनुपस्थित आउटपुट, या अपठनीय निर्णय पर आगे बढ़ने से इनकार करता है। उत्पादित आर्टिफैक्ट में आर्किटेक्चर मैप, दोष रिपोर्ट, दोष फिक्स ट्रैकर, व्यवहार अनुबंध, प्रोटोकॉल और स्थिति, एक पोर्टिंग बंडल, और मॉड्यूल, स्वीकृति परिदृश्यों और ज्ञात अज्ञातों के साथ अंतिम पुनःकार्यान्वयन विनिर्देश शामिल हैं। पाइपलाइन वेरिएंट: डिफ़ॉल्ट 7-चरणीय गहन-ऑडिट रन है जो दोष स्कैन को यांत्रिक और अर्थपूर्ण पास में विभाजित करता है। अन्य वेरिएंट में scout-first (8 चरण), full-with-audit (6), full (5), defect scan (2), lite (3), architecture-only (1), और synthesis (4) शामिल हैं। वेरिएंट को निष्कर्षों या प्रगति को हटाए बिना यथास्थान बदला जा सकता है। संदर्भ लचीलापन: फ़ाइलसिस्टम, बातचीत नहीं, टिकाऊ स्मृति है। प्रत्येक चरण को एक नया संदर्भ विंडो मिलता है; पूर्ण निष्कर्ष डिस्क पर रहते हैं; `status.yaml` प्रगति, खुले प्रश्न, कैरी-फॉरवर्ड आइटम, और पाइपलाइन के बाद का बैकलॉग रिकॉर्ड करता है। Pi चरण ट्रांसक्रिप्ट फ़ाइल-समर्थित हैं और `/resume`, `/tree`, और `/export` के माध्यम से उपलब्ध रहते हैं। चरण-जागरूक कॉम्पैक्शन सारांश `.codecarto/scratch/checkpoints/` के अंतर्गत चेकपॉइंट किए जाते हैं। README नोट करता है कि चरण के भीतर संदर्भ दबाव सीमित है, समाप्त नहीं। सतहें और विशेषताएं: Pi एक्सटेंशन स्लैश कमांड, एक लाइव एजेंट विजेट, फ़ाइल-समर्थित चरण सत्र, चरण-पूर्णता सारांश, ऑप्ट-इन LLM-निर्देशित सीड प्रॉम्प्ट, प्रति-चरण उपयोग ट्रैकिंग, और टूल इंटरसेप्शन (bash अवरुद्ध; edit/write `.codecarto/` तक सीमित) जोड़ता है। MCP सर्वर अन्य MCP-सक्षम एजेंटों के लिए चरण प्रॉम्प्ट, सत्यापन, और प्रायोगिक लाइब्रेरी publish/list/reindex संचालन प्रदान करता है। एक एकल-फ़ाइल HTML डैशबोर्ड प्रगति, लिंक, उपयोग, और एक वैकल्पिक कथात्मक सारांश को एकत्रित करता है। फॉरवर्ड सिंथेसिस एक उत्पाद दृष्टि को मानव-पुष्ट लाइब्रेरी विनिर्देशों के साथ जोड़कर एक provenance-समर्थित प्रोजेक्ट योजना बनाता है, जिसमें रनटाइम प्रीफ्लाइट जांच विलय या अंतिम रूप देने से पहले स्पष्ट मानव पुष्टि की आवश्यकता होती है।