عن المشروع

CodeCartographer هو إطار عمل لفهم قاعدة شيفرة غير مألوفة باستخدام وكيل برمجة بالذكاء الاصطناعي وإنتاج مواصفات إعادة تنفيذ مُتحقَّق منها ومحايدة لغويًا. يُوزَّع كإضافة Pi، أو خادم MCP، أو قالب جاهز `.codecarto/` من ملفات Markdown وYAML. كيف يعمل: "الشيفرة" عبارة عن Markdown منظَّم مع YAML داخل `.codecarto/`. ملف `GUIDE.md` هو نقطة دخول النموذج اللغوي، و`workflow/pipeline.yaml` يحدد المراحل والتبعيات، و`workflow/status.yaml` يحتفظ بحالة المشروع القابلة للتغيير، و`workflow/VALIDATE.md` يصف بروتوكول التحقق. تشكّل المراحل رسمًا بيانيًا موجَّهًا لا دوريًا — يمكن تشغيل العقود والبروتوكولات بالتوازي بعد المعمارية، وينتظر النقل كليهما، وتأتي مواصفات إعادة التنفيذ أخيرًا. يقرأ المضيف خط الأنابيب النشط، ويجد المرحلة التالية التي اكتملت تبعياتها، ويسلّم النموذج اللغوي تعليمات تلك المرحلة، ويتحقق من المخرجات، ويقدّم الحالة. الأدلة والتحقق: تكتب كل مرحلة أثرًا أصغر وقائمًا على قوالب وموسومًا بالأدلة تحت `.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 أوامر شرطة مائلة، وودجت وكلاء مباشر، وجلسات مراحل مدعومة بالملفات، وملخصات إكمال المراحل، ومطالبات بذرية موجَّهة بالنموذج اللغوي اختياريًا، وتتبع استخدام لكل مرحلة، واعتراض الأدوات (bash محظور؛ التحرير/الكتابة محصوران في `.codecarto/`). يعرض خادم MCP مطالبات المراحل والتحقق وعمليات نشر/سرد/إعادة فهرسة المكتبة التجريبية لوكلاء آخرين قادرين على MCP. تجمّع لوحة معلومات HTML أحادية الملف التقدم والروابط والاستخدام وملخصًا سرديًا اختياريًا. يجمع التوليف الأمامي رؤية منتج مع مواصفات مكتبة مؤكدة بشريًا في خطة مشروع مدعومة بالمصدر، مع فحوصات ما قبل التشغيل تتطلب تأكيدًا بشريًا صريحًا قبل الدمج أو الإنهاء.