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

# Generar configuración
crucible init --target URL --provider openai --key sk-xxx

# Ejecutar un escaneo estándar
crucible scan \
  --target https://my-agent.com/api/chat \
  --name "My ChatBot" \
  --header "Authorization: Bearer sk-xxx" \
  --timeout 30 \
  --concurrency 5

# Ejecutar con mutación de cargas útiles (evasión de WAF/guardarraíles)
crucible scan --target URL --mutate

# Estrategia de ataque multi-turn (multivuelta)
crucible scan --target URL --strategy multi-turn

# Usar perfil de agente para dirigir ataques
crucible profile --target URL --output agent_profile.json
crucible scan --target URL --profile agent_profile.json

# Auditoría de integridad conductual (detección de deriva multivuelta)
crucible behavioral-audit \
  --target https://my-agent.com/api/chat \
  --baseline-turns 5 \
  --probe-turns 15

# Generar informe de cumplimiento de la Ley de IA de la UE a partir de resultados de escaneo
crucible scan --target URL --output json > results.json
crucible compliance-report --results results.json --output compliance.md

# Salida JSON para CI/CD
crucible scan --target URL --output json > report.json

# Escaneo de modelo local (Ollama, LM Studio, HuggingFace TGI)
crucible scan --target http://localhost:11434 --format-preset ollama --model llama3

# Límite de tasa global (2 solicitudes por segundo)
crucible scan --target URL --rate-limit 2

# Aplicación de alcance mediante archivo YAML
crucible scan --target URL --scope-file scope.yaml

# Auditar un servidor MCP en busca de envenenamiento de herramientas, inyección de comandos y abuso de alcance OAuth
crucible mcp-scan --server https://my-mcp.example.com

# Con cabecera de autenticación y salida JSON
crucible mcp-scan --server http://localhost:3000 \
  --header "Authorization: Bearer sk-xxx" \
  --output mcp-report.json

# Volver a renderizar un informe guardado
crucible report report.json

# Ejecutar escaneo con intervalos de confianza estadísticos bootstrap (calcular IC del 95% con 10 ejecuciones por ataque)
crucible scan --target URL --confidence --confidence-runs 10

# Validar un archivo YAML de política de traza
crucible trace validate-policy policy.yaml

# Iniciar el proxy de traza de intercepción y auditoría MCP (HTTP simple)
crucible trace start --listen 8080 --upstream http://localhost:8001 --policy policy.yaml --log audit.jsonl

# Iniciar el proxy con terminación TLS nativa (certificado de desarrollo autofirmado generado automáticamente)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls-self-signed

# Iniciar el proxy con terminación TLS nativa (usando archivos de certificado/clave personalizados)
crucible trace start --listen 9443 --upstream http://localhost:8001 --policy policy.yaml --tls --tls-cert cert.pem --tls-key key.pem

# Renderizar un informe resumido a partir de un archivo de registro de auditoría de traza
crucible trace report audit.jsonl

# Plantar un documento envenenado mediante inyección de ancla semántica (Técnica 1)
crucible poison-test plant --topic "secretos de la empresa" --technique 1 --output secret.txt

# Ejecutar ciclo de vida automatizado de plantado y consulta de envenenamiento RAG
crucible poison-test rag --ingest-url http://api/ingest --query-url http://api/query --topic "finanzas"

# Listar sesiones activas de evaluación de envenenamiento
crucible poison-test list

# Verificar el estado de una sesión de envenenamiento específica
crucible poison-test status <session-id>

# Listar los 12 objetivos de referencia (6 vulnerables, 6 reforzados)
crucible target list

# Iniciar un objetivo de referencia específico (ej. sql_vulnerable) en el puerto 9000
crucible target start --name sql_vulnerable --port 9000

# Levantar los 12 objetivos, ejecutar validación de salud y verdad fundamental, escribir informe 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 # Fallo del flujo si la calificación es C, D o F

crucible/
  models.py                    # Modelos de datos Pydantic
  cli.py                       # CLI Typer (scan, behavioral-audit, profile, compliance-report)
  attacks/
    base.py                    # Clase base ABC Attack
    prompt_injection.py        # 50 vectores de ataque
    goal_hijacking.py          # 20 vectores de ataque
    jailbreaks.py              # 20 vectores de ataque
    enterprise_graph.py        # Ataques de confianza entre agentes
    memory_poisoning.py        # Ataques de estado persistente
    behavioral_escalation.py   # Secuencias de escalada multivuelta (v0.3)
    multi_turn_strategies.py   # Crescendo y Confusión de Contexto (v0.3)
    profile_templates/         # Plantillas de detección de tipo de agente (v0.3)
    multi_agent_contagion.py   # Ataques de confianza entre agentes (v0.4)
    dynamic_generator.py       # Generación de ataques basada en investigación (v0.4)
    hallucination.py           # 15 ataques de alucinación/sobreconfianza (v0.5)
    toxicity.py                # 20 ataques de toxicidad/seguridad (v0.5)
  modules/
    base.py                    # Clase base ABC Module
    security.py                # Registro de módulos
  core/
    runner.py                  # Motor de escaneo paralelo asíncrono (anyio)
    scorer.py                  # Puntuación basada en deducciones + calificación
    mutation_engine.py         # Ofuscación de cargas útiles (6 estrategias)
    behavioral_engine.py       # Motor de deriva conductual multivuelta (v0.3)
    multi_turn_engine.py       # Ejecutor de ataques multivuelta (v0.3)
    profiler.py                # Perfilador de capacidades de agente (v0.3)
    compliance_engine.py       # Motor de mapeo de la Ley de IA de la UE (v0.3)
    reporter.py                # Generador de informes de bug bounty
    cache.py                   # Caché de resultados de escaneo basado en TTL
    research_engine.py         # Orquestador de investigación autónoma (v0.4)
    patcher.py                 # Motor de remediación automática (v0.4)
    canary.py                  # Canarios de engaño activo (v0.4)
    statistics.py              # Motor de confianza bootstrap sin dependencias (v0.6.1)
  reporters/
    base.py                    # Clase base ABC Reporter
    terminal.py                # Renderizador de terminal Rich
    json_reporter.py           # Exportador de archivos JSON
    html_reporter.py           # Informe HTML interactivo
    slack.py                   # Reportero de webhook Slack
    compliance_reporter.py     # Reportero de cumplimiento Markdown/JSON (v0.3)
    huntr_reporter.py          # Reportero de envío de bug bounty (v0.4)
    sarif_reporter.py          # Exportar resultados a SARIF 2.1.0 (v0.5)
    atlas_reporter.py          # Mapeador de cumplimiento MITRE ATLAS (v0.6)
    nist_reporter.py           # Mapeador de cumplimiento NIST AI RMF (v0.6)
  poison/                      # Paquete de envenenamiento de memoria y RAG con estado (v0.8.0)
    session_store.py           # Almacén de sesiones de envenenamiento JSON atómico
    document_generator.py      # Implementa 4 técnicas de plantado adversarial
  trace/                       # Paquete de intercepción de llamadas a herramientas MCP y proxy de políticas (v0.7.0)
    models.py                  # Modelos de traza Pydantic
    policy.py                  # Motor de evaluación basado en reglas YAML
    audit_log.py               # Registrador JSONL seguro para subprocesos y solo anexión
    proxy.py                   # Proxy inverso TCP asíncrono usando anyio y h11
  targets/                     # Suite de objetivos de referencia para validación de verdad fundamental (v0.18.0)
    base_target.py             # Objetivo HTTP base abstracto usando la biblioteca estándar de Python
    registry.py                # Registro central de objetivos que mapea nombres a clases
    runner.py                  # Gestor de contexto para iniciar y detener objetivos limpiamente

✗ Preflight failed: Target returned 405 Method Not Allowed.
  You specified --method GET but this endpoint requires POST.
  Re-run without --method GET or use --skip-preflight to bypass this check.