crucible

   ██████╗██████╗ ██╗   ██╗ ██████╗██╗██████╗ ██╗     ███████╗
  ██╔════╝██╔══██╗██║   ██║██╔════╝██║██╔══██╗██║     ██╔════╝
  ██║     ██████╔╝██║   ██║██║     ██║██████╔╝██║     █████╗
  ██║     ██╔══██╗██║   ██║██║     ██║██╔══██╗██║     ██╔══╝
  ╚██████╗██║  ██║╚██████╔╝╚██████╗██║██████╔╝███████╗███████╗
   ╚═════╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝╚═╝╚═════╝ ╚══════╝╚══════╝
  

pip install crucible-security

crucible init --target https://my-agent.com/api/chat
crucible scan --target https://my-agent.com/api/chat
crucible report crucible-report.json

python examples/test_langchain_agent.py

python examples/test_openai_assistant.py

# إنشاء التكوين
crucible init --target URL --provider openai --key sk-xxx

# تشغيل فحص قياسي
crucible scan \
  --target https://my-agent.com/api/chat \
  --name "My ChatBot" \
  --header "Authorization: Bearer sk-xxx" \
  --timeout 30 \
  --concurrency 5

# تشغيل مع تحوير الحمولة (تجاوز جدران الحماية/الحواجز)
crucible scan --target URL --mutate

# استراتيجية هجوم متعددة الجولات
crucible scan --target URL --strategy multi-turn

# استخدام ملف تعريف وكيل لتوجيه الهجمات
crucible profile --target URL --output agent_profile.json
crucible scan --target URL --profile agent_profile.json

# تدقيق السلامة السلوكية (كشف الانجراف متعدد الجولات)
crucible behavioral-audit \
  --target https://my-agent.com/api/chat \
  --baseline-turns 5 \
  --probe-turns 15

# إنشاء تقرير امتثال لقانون الذكاء الاصطناعي الأوروبي من نتائج الفحص
crucible scan --target URL --output json > results.json
crucible compliance-report --results results.json --output compliance.md

# مخرجات JSON لـ CI/CD
crucible scan --target URL --output json > report.json

# فحص النموذج المحلي (Ollama, LM Studio, HuggingFace TGI)
crucible scan --target http://localhost:11434 --format-preset ollama --model llama3

# تحديد المعدل العالمي (طلبيّن في الثانية)
crucible scan --target URL --rate-limit 2

# فرض النطاق عبر ملف YAML
crucible scan --target URL --scope-file scope.yaml

# تدقيق خادم MCP بحثاً عن تسميم الأدوات، حقن الأوامر، وإساءة استخدام نطاق OAuth
crucible mcp-scan --server https://my-mcp.example.com

# مع رأس المصادقة ومخرجات JSON
crucible mcp-scan --server http://localhost:3000 \
  --header "Authorization: Bearer sk-xxx" \
  --output mcp-report.json

# إعادة عرض تقرير محفوظ
crucible report report.json

# تشغيل الفحص مع فترات ثقة إحصائية bootstrap (حساب 95% CI مع 10 مرات لكل هجوم)
crucible scan --target URL --confidence --confidence-runs 10

# التحقق من صحة ملف سياسة التتبع YAML
crucible trace validate-policy policy.yaml

# بدء وكيل اعتراض وتدقيق تتبع MCP (HTTP عادي)
crucible trace start --listen 8080 --upstream http://localhost:8001 --policy policy.yaml --log audit.jsonl

# بدء الوكيل مع إنهاء TLS أصلي (شهادة تطوير ذاتية التوقيع مولدة تلقائياً)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls-self-signed

# بدء الوكيل مع إنهاء TLS أصلي (باستخدام ملفات الشهادة/المفتاح المخصصة)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls --tls-cert cert.pem --tls-key key.pem

# عرض تقرير ملخص من ملف سجل تدقيق التتبع
crucible trace report audit.jsonl

# زرع مستند مسموم باستخدام حقن المرساة الدلالي (التقنية 1)
crucible poison-test plant --topic "company secrets" --technique 1 --output secret.txt

# تشغيل دورة حياة زرع واستعلام RAG للتسميم من البداية إلى النهاية
crucible poison-test rag --ingest-url http://api/ingest --query-url http://api/query --topic "finances"

# سرد جلسات تقييم التسميم النشطة
crucible poison-test list

# التحقق من حالة جلسة تسميم محددة
crucible poison-test status <session-id>

# سرد جميع الأهداف المرجعية الـ 12 (6 ضعيفة، 6 محصنة)
crucible target list

# بدء هدف مرجعي محدد (مثال: sql_vulnerable) على المنفذ 9000
crucible target start --name sql_vulnerable --port 9000

# تشغيل جميع الأهداف الـ 12، تشغيل التحقق من الصحة والحقيقة المرجعية، كتابة تقرير JSON
crucible target validate --output ground_truth_report.json

# .github/workflows/security.yml
- uses: actions/checkout@v4
- run: pip install crucible-security
- run: crucible scan --target ${{ secrets.AGENT_URL }} --fail-on CRITICAL

- name: Crucible Security Scan
  uses: crucible-security/[email protected]
  with:
    target: ${{ secrets.AGENT_URL }}
    format_preset: openai
    model: gpt-4o
    headers: '{"Authorization": "Bearer ${{ secrets.OPENAI_API_KEY }}"}'
    fail_on_grade: C # يفشل سير العمل إذا كانت الدرجة C أو D أو F

crucible/
  models.py                    # نماذج بيانات Pydantic
  cli.py                       # واجهة سطر أوامر Typer (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # BaseAttack ABC
    prompt_injection.py        # 50 متجه هجوم
    goal_hijacking.py          # 20 متجه هجوم
    jailbreaks.py              # 20 متجه هجوم
    enterprise_graph.py        # هجمات الثقة بين الوكلاء
    memory_poisoning.py        # هجمات الحالة المستمرة
    behavioral_escalation.py   # تسلسلات تصعيد متعددة الجولات (v0.3)
    multi_turn_strategies.py   # Crescendo & Context Confusion (v0.3)
    profile_templates/         # قوالب اكتشاف نوع الوكيل (v0.3)
    multi_agent_contagion.py   # هجمات الثقة بين الوكلاء (v0.4)
    dynamic_generator.py       # توليد هجمات موجه بالبحث (v0.4)
    hallucination.py           # 15 هجوم هلوسة/اعتماد مفرط (v0.5)
    toxicity.py                # 20 هجوم سمية/سلامة (v0.5)
  modules/
    base.py                    # BaseModule ABC
    security.py                # سجل الوحدات
  core/
    runner.py                  # محرك فحص متوازٍ غير متزامن (anyio)
    scorer.py                  # تسجيل النقاط بالخصم + التقدير
    mutation_engine.py         # إبهام الحمولة (6 استراتيجيات)
    behavioral_engine.py       # محرك الانجراف السلوكي متعدد الجولات (v0.3)
    multi_turn_engine.py       # مشغل الهجمات متعددة الجولات (v0.3)
    profiler.py                # محلل قدرات الوكيل (v0.3)
    compliance_engine.py       # محرك رسم خرائط قانون الذكاء الاصطناعي الأوروبي (v0.3)
    reporter.py                # مولد تقارير مكافآت الثغرات
    cache.py                   # ذاكرة تخزين مؤقت لنتائج الفحص مع TTL
    research_engine.py         # منظم البحث المستقل (v0.4)
    patcher.py                 # محرك الإصلاح التلقائي (v0.4)
    canary.py                  # طيور الكناري الخادعة النشطة (v0.4)
    statistics.py              # محرك ثقة bootstrap بدون تبعيات (v0.6.1)
  reporters/
    base.py                    # BaseReporter ABC
    terminal.py                # عارض طرفية Rich
    json_reporter.py           # مصدر ملف JSON
    html_reporter.py           # تقرير HTML تفاعلي
    slack.py                   # مراسل Slack webhook
    compliance_reporter.py     # مراسل الامتثال Markdown/JSON (v0.3)
    huntr_reporter.py          # مراسل تقديم مكافآت الثغرات (v0.4)
    sarif_reporter.py          # تصدير النتائج إلى SARIF 2.1.0 (v0.5)
    atlas_reporter.py          # مراسل رسم خرائط الامتثال MITRE ATLAS (v0.6)
    nist_reporter.py           # مراسل رسم خرائط الامتثال NIST AI RMF (v0.6)
  poison/                      # حزمة تسميم الذاكرة و RAP ذات الحالة (v0.8.0)
    session_store.py           # مخزن جلسات تسميم JSON ذري
    document_generator.py      # تنفيذ 4 تقنيات زرع خصومة
  trace/                       # اعتراض استدعاء أدوات MCP ووكيل السياسات (v0.7.0)
    models.py                  # نماذج تتبع Pydantic
    policy.py                  # محرك تقييم قائم على قواعد YAML
    audit_log.py               # مسجل JSONL آمن للخيط مع إلحاق فقط
    proxy.py                   # وكيل عكسي غير متزامن لـ TCP باستخدام anyio و h11
  targets/                     # مجموعة الأهداف المرجعية لتقييم الحقيقة المرجعية (v0.18.0)
    base_target.py             # هدف HTTP أساسي مجرد باستخدام مكتبة Python القياسية
    registry.py                # سجل الأهداف المركزي لربط الأسماء بالفئات
    runner.py                  # مدير سياق لبدء وإيقاف الأهداف بشكل نظيف

✗ فشل الفحص المسبق: أعاد الهدف 405 Method Not Allowed.
  لقد حددت --method GET ولكن نقطة النهاية هذه تتطلب POST.
  أعد التشغيل بدون --method GET أو استخدم --skip-preflight لتجاوز هذا الفحص.