ابنِ على واقع الهندسة
اليوم (v1.0): شغّل واجهة API المحلية باستخدام contextmint serve وادمجها عبر REST. خارطة الطريق: أدوات MCP وواجهة سطر أوامر أكثر اكتمالاً لنطاق التأثير والحِزم وبوابات CI.
مرجع واجهة برمجة التطبيقات
خلفية FastAPI — الحالة (Health)، والمحادثة، والبحث، والحِزم، والجودة، والإجراءات. توثيق OpenAPI على /docs عند تشغيل الخادم.
v1.0 · خادم محليواجهة سطر الأوامر
contextmint serve يشغّل واجهة API اليوم. أوامر الفهرسة والحالة والرسم البياني مخطط لها للأتمتة في CI والمنصة.
أمر serve متاح المزيد من الأوامر ضمن خارطة الطريقخادم MCP
أدوات بروتوكول سياق النموذج (MCP) لنطاق التأثير والميزات والقرارات — عقود قراءة مُصمّمة للوكلاء الذكيين على الرسم البياني الهندسي.
خارطة الطريق · محرك التحققالبدء السريع (v1.0)
# أو من نسخة تطوير محلية:
contextmint serve
# تحقّق من الحالة
curl http://localhost:8000/api/health
الإعداد الكامل: البدء · توثيق المستخدم: التوثيق · المصطلحات: قائمة المصطلحات
شرح المصطلحات (بلغة مبسطة)
يستخدم ContextMint مصطلحات هندسية دقيقة. إليك ما تعنيه لفريقك — دون افتراض خلفية في نظرية الرسوم البيانية. المصطلحات الكاملة للإصدار 1.0: مسرد المستخدم.
- نطاق التأثير
- إذا غيّرت أو كسرت X، ماذا يتأثر أيضاً؟ يتتبع ContextMint روابط التبعية الحقيقية (الاستيرادات، استدعاءات الخدمات، الوحدات المشتركة) لسرد الملفات والخدمات والميزات المتأثرة في اتجاه المصب — مثل خريطة تموّج، وليس تخميناً من نموذج لغوي.
- محرك التحقق
- اتجاه المنتج المستقبلي بعد الإصدار 1.0: فحص كل طلب سحب أو تغيير من الذكاء الاصطناعي تلقائياً مقابل الملكية والتأثير وقواعد العمارة والسياسة قبل الدمج. يضع الإصدار 1.0 الأساس (خريطة الجودة، البوابات، المحادثة المحلية)؛ التحقق على مستوى طلب السحب بأكمله على خارطة الطريق.
- الرسم البياني الواقعي الهندسي (Fabric)
- خريطة حية لحقائق مستودعك ومؤسستك: من يملك أي ملفات، وكيف تعتمد الوحدات على بعضها، وقرارات العمارة المسجّلة (ADRs)، وقواعد السياسة. يمكن للمحادثة والوكلاء الاستشهاد بهذه الخريطة بدلاً من اختلاق الإجابات.
- الحمض النووي للمستودع
- ملخص صحي من صفحة واحدة لقاعدة الكود — البنية والملاك والنقاط الساخنة والاتفاقيات — بحيث يفهم مهندس جديد أو مراجع المستودع خلال دقائق بدلاً من أسابيع.
- رسم القرار البياني
- يربط سبب شكل الكود الحالي: سجلات قرارات العمارة (ADRs)، وطلبات السحب المعتمدة، والمشكلات المرتبطة بالملفات التي تؤثر عليها. يجيب عن سؤال «لماذا نفعل ذلك بهذه الطريقة؟» بالأدلة.
- الانحراف
- عندما ينحرف الكود الفعلي عن العمارة أو الاتفاقيات المتفق عليها. الانحراف السيئ هو مخالفة غير مقصودة؛ الانحراف المقبول هو تغيير معتمد تم تسجيله حتى لا تُطلق التنبيهات مرة أخرى.
- MCP (بروتوكول سياق النموذج)
- طريقة موحدة لأدوات الذكاء الاصطناعي (Cursor، Claude Desktop، الوكلاء المخصصة) لاستدعاء دوال قراءة فقط على بيانات الهندسة لديك — مثل get_blast_radius — بصيغة JSON منظمة بدلاً من استخراج نص المحادثة. مخطط لإصدار مستقبلي؛ غير قابل للاتصال في الإصدار 1.0.
- حوكمة الوكلاء
- قواعد لوكلاء الذكاء الاصطناعي الذين يتعاملون مع مستودعك: الأدوات التي يمكنهم استدعاءها، وما يمكنهم قراءته، وأن كل كتابة لا تزال تمر عبر معاينة تصحيح تراجعها مراجعة بشرية — بدون تطبيق تلقائي صامت.
- البوابة 1 / البوابة 2
- البوابة 1 = Context Lens — توافق على الأدلة قبل تشغيل النموذج. البوابة 2 = معاينة التصحيح — توافق على الفروقات قبل أي كتابة على القرص. تُشحن في الإصدار 1.0.
- خريطة الجودة
- نتائج فحص مخزّنة (كود مكرر، إشارات بنيوية، أنماط) تظهر في Context Lens وواجهة الحوكمة. تأتي الإجابات من نتائج على القرص، وليس من تخيل النموذج. تُشحن في الإصدار 1.0.
تحتاج دعماً في التكامل؟
يحصل شركاء التصميم على مساعدة في ربط واجهة API المحلية ومعاينة عقود MCP ضمن خارطة الطريق. يفتح باب التسجيل مع بداية سبتمبر 2026.