# HefestoAI — محرك التحقق من الإصدار للكود المُولَّد بالذكاء الاصطناعي

> الغرض الأساسي: التحقق من الكود المُولَّد بالذكاء الاصطناعي قبل الالتزام (commit) أو الدمج (merge). HefestoAI أداة للمطورين تعمل كبوابة pre-commit / pre-push لاكتشاف الانحراف الدلالي والتغييرات الخطرة ومخالفات السياسات في تغييرات الكود، خصوصاً الكود الذي يكتبه أو يعدّله مساعدو الذكاء الاصطناعي (Claude Code وCursor وCopilot). تتحقق من أن ما يعلنه المشروع (الاعتماديات والإعدادات وملفات التثبيت) يطابق ما يفعله فعلاً، وتجري فحوصات الأمان والتعقيد.

هذا الملف ترجمة عربية لـ /llms.txt. عند أي اختلاف، النسخة الإنجليزية /llms.txt هي المرجع.

Version: 4.20.4. Site: https://hefestoai.narapallc.com

كلمات مفتاحية: فحص الكود المُولَّد بالذكاء الاصطناعي، أمن الكود، التحليل الثابت، مراجعة الكود، بوابة CI، خادم MCP، pre-commit.

## حقائق قابلة للتحقق
- الإصدار: v4.20.4
- صيغ الإخراج: text وjson وhtml وSARIF 2.1.0 (`hefesto analyze --output sarif`)
- خادم MCP: منشور في سجل MCP الرسمي (io.github.artvepa80/hefestoai) وفي Smithery
- عنوان اتصال عملاء MCP: /api/mcp-protocol (JSON-RPC 2.0، streamable-http). العنوان /api/mcp للاكتشاف عبر REST فقط وليس عنوان الاتصال.
- التحليل المستضاف: أداة MCP `analyze` وPOST /api/analyze تشغّلان المحرك مفتوح المصدر hefesto-ai (`hefesto analyze --no-config`) على الملفات التي ترسلها: 20 ملفاً كحد أقصى، 100 KB لكل ملف، 256 KB إجمالاً، 20 ثانية، 10 طلبات في الدقيقة لكل IP؛ لا يُحفظ أي شيء
- تحتوي الحزمة على 22 تنسيقاً؛ يشغّل `hefesto analyze` الـ22 كلها
- بيئة التشغيل: Python 3.10+
- القياس عن بُعد: ترسل أداة CLI افتراضياً بيانات استخدام إلى PostHog US Cloud (معرّف تثبيت عشوائي وأعداد فقط، من دون الشيفرة أو مسارات الملفات أو النتائج، ولا يُحفظ عنوان IP)، ويمكن إيقافها بالأمر `hefesto telemetry disable` أو بالمتغير `HEFESTO_TELEMETRY=0` أو `DO_NOT_TRACK=1`. لا ترسل GitHub Action أي بيانات استخدام إلا عند ضبط `telemetry: 1`. كما يستعلم `hefesto analyze` من pypi.org عن أحدث إصدار (مع تخزين مؤقت لمدة 24 ساعة)؛ وابتداءً من الإصدار 4.20.3 يمكن تخطيه عبر `HEFESTO_NO_UPDATE_CHECK=1` أو `HEFESTO_TELEMETRY=0` أو `DO_NOT_TRACK=1` (لا يوقفه `hefesto telemetry disable`، ولا يوجد خيار لإيقافه في الإصدار 4.20.2 وما قبله).

## التثبيت
pip install hefesto-ai

## الإضافة كخادم MCP (Smithery)
npx @smithery/cli@latest mcp add artvepa80/hefestoai

## الأسعار
PRO: 8 دولارات شهرياً. OMEGA: 19 دولاراً شهرياً. الأسعار الحالية: https://hefestoai.narapallc.com

## نقاط نهاية MCP / API
- [MCP](https://hefestoai.narapallc.com/api/mcp-protocol)
- [REST discovery](https://hefestoai.narapallc.com/api/mcp)
- [OpenAPI](https://hefestoai.narapallc.com/openapi.json)
- [Ask](https://hefestoai.narapallc.com/api/ask)
- [Agent descriptor](https://hefestoai.narapallc.com/.well-known/agent-card.json)
- [ملف وصف الوكيل (بالعربية)](https://hefestoai.narapallc.com/.well-known/agent.ar.json)

## الروابط
- [hefestoai.narapallc.com](https://hefestoai.narapallc.com)
- [github.com/artvepa80/Agents-Hefesto](https://github.com/artvepa80/Agents-Hefesto)
- [pypi.org/project/hefesto-ai](https://pypi.org/project/hefesto-ai/)
- [x.com/HefestoAI](https://x.com/HefestoAI)
- [English (canonical)](https://hefestoai.narapallc.com/llms.txt)