عن المشروع

NovaFabric هي أداة واجهة سطر أوامر مستضافة ذاتياً لجعل عمليات تشغيل الذاء الاصطناعي (AI) والحوسبة عالية الأداء (HPC) قابلة للتكرار والمقارنة والتدقيق. وحدة القيمة الأساسية فيها هي "الكبسولة" (capsule): وهي عبارة عن دليل يحمل اسماً بتنسيق ULID يتم كتابته تحت المسار ~/.novafabric/capsules/، ويحتوي على الحقائق الملحوظة لتنفيذ واحد، بدلاً من أن يكون مجرد صف تتبع في قاعدة بيانات مستضافة. يتم التثبيت عبر `pip install novafabric` (Python 3.12+)؛ وتضيف الإضافات الاختيارية دعماً للوحة التحكم (dashboard)، والاستعلام (query)، والخادم (server)، والامتثال (compliance)، وSigstore، بينما يقوم الأمر `nova doctor --check-extras` بالإبلاغ عما هو مفقود. الالتقاط: يعمل الأمر `nova capture python my_agent.py --dataset data.csv` مع أي أمر ولا يتطلب أي تغييرات في التطبيق. يقوم بحقن محمل sitecustomize.py عبر PYTHONPATH ويثبت رقعات (monkey-patches) لـ SDKs الخاصة بـ OpenAI وAnthropic وMCP، بالإضافة إلى خطافات (hooks) على مستوى الشبكة لـ httpx وrequests وaiohttp وurllib3، مع وجود حارس طبقي لضمان أن المكالمات المتداخلة تنتج سجلاً واحداً. يتم استخراج حقول الاتفاقات الدلالية لـ OpenTelemetry GenAI (مثل temperature وtop_p وmax_tokens وseed وأسباب الانتهاء وغيرها). بالنسبة للعملاء غير المعتمدين على Python مثل Claude Code أو Cursor أو وكلاء Node/Go، يوجد وكيلان شفافان — `nova api-proxy` و `nova mcp-proxy` — يلتقطان حركة مرور LLM وMCP دون المساس بالعميل. يتم كتابة الكبسولات عند النجاح والفشل على حد سواء، لذا يتم تسجيل الانهيار كدليل مع الحالة ورمز الخروج وكتلة الخطأ. محتويات الكبسولة: بيان capsule.yaml، ونطاقات trace.jsonl، وmodel-calls.jsonl، وtool-calls.jsonl، وenv.lock، وreplay.yaml، والمدخلات والمخرجات (stdout/stderr)، وredaction-proof.json. يتم تشغيل فحص الأسرار ضد كل أثر قبل الاعتماد النهائي؛ والكبسولة التي تفتقر إلى إثبات التنقية (redaction proof) تعتبر غير صالحة لـ `nova validate` ولا يمكن تصديرها. إعادة التشغيل والمقارنة: يوفر `nova replay` أربعة أوضاع — الجنائي (forensic) للفحص للقراءة فقط دون شبكة أو عمليات فرعية، والمحاكى (mocked) الذي يعيد تشغيل الأمر مع تقديم مكالمات النموذج والأدوات من ذاكرة تخزين الكبسولة المؤقتة، والدلالي (semantic) الذي يحكم على المعنى بدلاً من الرموز (تشابه من 0.0 إلى 1.0)، والمطابق (exact) الذي يتطلب بيئة حتمية وبذرة (seed) لكل مكالمة. لا يدعي ملف README صراحةً إعادة التشغيل المطابق لمكالمات LLM البعيدة. يقوم `nova diff` بمقارنة عمليتين، ويخرج `nova diff --assert-no-regressions` بقيمة غير صفرية عند حدوث تغيير سلوكي، ليكون بمثابة بوابة CI للوكلاء الذين عملوا بالأمس وفشلوا اليوم. الحوكمة والنسب: يقوم سجل أصول (Asset Registry) محلي يعتمد على SQLite بتخزين أصول ذات إصدارات من سبعة أنواع (نموذج، وكيل، مطالبة، أداة، مجموعة بيانات، تقييم، نشر)، ويتم عنونتها بصيغة name@version مع دورة حياة تمتد من التطوير إلى الأرشفة؛ ويكون الترقية مجرد بيانات وصفية للحوكمة ولا تقوم بنشر أي شيء. تصدر طبقة النسب (lineage) حواف ميكانيكية مثل consumed وproduced_by وreplayed_from مع ثقة ملحوظة مقابل مستنتجة، وتدعم استعلامات المصدر ونطاق التأثير وسلسلة إعادة التشغيل، ويمكنها إصدار أحداث OpenLineage بالإضافة إلى تصدير W3C PROV-N. توجد خلفيات اختيارية تجريبية للرسوم البيانية الأكبر. يقوم `nova export-evidence` ببناء ملف ZIP موقع يحتوي على الكبسولة، ورسم بياني فرعي للنسب، وتصديقات in-toto DSSE وتواقيع ed25519، قابلة للتحقق باستخدام sha256sum ومحقق ed25519 دون الحاجة إلى بيئة تشغيل NovaFabric. الملاءمة: يذكر المشروع أنه ليس منسقاً (orchestrator)، ولا مدرب نماذج، ولا خادم استدلال، ولا قاعدة بيانات متجهية، ولا بوابة LLM، ولا مشغل CI، وأن منصة ملاحظة SaaS مدارة ستكون أقل جهداً عندما تكون لوحات التحكم في الوقت الفعلي والتنبيهات والتحليلات متعددة المستخدمين هي الهدف. تم وضع وضع الخادم ولوحة التحكم المباشرة كنسخ تجريبية، والكبسولات ليست مجمدة حتى تجميد مخطط v1.0 المخطط له، وتنتج الأداة أدلة تدعم سير عمل الامتثال بدلاً من اعتمادها. تشمل الجماهير المستهدفة المذكورة في README مهندسي ML/المنصات، وفرق HPC والبحث، ومسؤولي الامتثال، والمستجيبين للحوادث، ومؤلفي إطارات عمل الوكلاء.