OrangePro

Encuentra los comportamientos que tus pruebas pasan por alto. Genera pruebas fundamentadas que realmente se ejecutan.

OrangePro mapea cada comportamiento público en tu código, puntúa cada uno con evidencia real de pruebas y te muestra los puntos ciegos estructurales antes de que tus usuarios los encuentren. Se ejecuta localmente. Tu código nunca sale de tu máquina.

npx -y @orangepro/mcp-server@latest start .

Tabla de contenidos

• Qué obtienes
• Niveles de evidencia
• Inicio rápido
• Uso con tu agente de codificación
• Cómo funciona
• Soporte de lenguajes
• Privacidad
• Referencia de CLI
• Herramientas MCP
• Plataforma
• Contribuciones

Qué obtienes

Un solo comando produce un informe HTML interactivo:

npx -y @orangepro/mcp-server@latest start .
open .orangepro/behavior-coverage.html

El informe tiene dos modos: Simple (puntos ciegos a nivel de integración, en lenguaje sencillo) y Experto (lista completa de comportamientos, niveles de evidencia, flujos, mapa del sistema). Alterna con el interruptor de píldora en la parte superior.

→ Ejemplo en vivo: Twenty CRM (5,237 comportamientos mapeados)

Mapa del sistema — carriles de entrada (GraphQL, HTTP, Jobs) que fluyen hacia los servicios, dimensionados por tráfico, coloreados por nivel de evidencia, con anillo rojo por riesgo.

Brechas prioritarias de otro proyecto de código abierto HONO — los 20 comportamientos no probados más importantes clasificados por radio de impacto, con borradores de pruebas generados.

Niveles de evidencia

Cada comportamiento recibe exactamente un nivel. Nada se etiqueta como "probado" por fe.

"Probado dinámicamente 0" es normal en la primera ejecución. La prueba requiere ejecutar pruebas contra mutaciones dirigidas. Ese es el modelo de confianza.

Inicio rápido

cd /path/to/your/repo
npm install          # install the repo's own dependencies first

npx -y @orangepro/mcp-server@latest start .
open .orangepro/behavior-coverage.html

No se necesita clave API. El informe muestra tu mapa del sistema, niveles de evidencia, brechas prioritarias y el delta desde la última ejecución.

¿Quieres generación de pruebas? Agrega una clave de modelo (BYOK):

export ANTHROPIC_API_KEY="..."   # or OPENAI_API_KEY / OLLAMA_BASE_URL
npx -y @orangepro/mcp-server@latest start .

La salida de IA nunca cambia los niveles de evidencia. Solo el oráculo de eliminación de mutaciones puede otorgar "Probado dinámicamente".

Salida:

.orangepro/
├── behavior-coverage.html   ← open this
├── graph.json               ← deterministic evidence graph
├── COVERAGE_REPORT.md       ← coverage and gap summary
└── ai/                      ← candidate flows (when a key is configured)

orangepro_generated/         ← generated tests; your source files are never touched

Cada nueva ejecución muestra un banner de delta: qué entró al código, qué subió en riesgo, qué se resolvió.

Uso con tu agente de codificación

OrangePro se ejecuta como servidor MCP. Agrégalo a la configuración de tu cliente:

{
  "mcpServers": {
    "orangepro-local": {
      "command": "npx",
      "args": ["-y", "@orangepro/mcp-server@latest", "mcp"]
    }
  }
}

El flujo de trabajo: Dile a tu agente:

"Usa orangepro_start, luego orangepro_generate_tests con base_ref=main. Escribe cada prueba en su suggested_path, ejecútala e informa aprobado/fallido."

El agente escribe la prueba, la ejecuta, llama a orangepro_prove y el comportamiento se convierte en "Probado dinámicamente". Un solo prompt, ciclo completo.

Compatible con

Claude Code · Cursor · GitHub Copilot · Codex · Windsurf · OpenCode · VS Code

Cualquier agente compatible con MCP puede manejar OrangePro. Sin bloqueo de proveedor.

Cómo funciona

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Your Code  │ ──► │  Knowledge   │ ──► │  Evidence   │
│  (any lang) │     │    Graph     │     │   Tiers     │
└─────────────┘     └──────────────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    ▼             ▼
             ┌───────────┐  ┌──────────┐
             │ Gap Report│  │ Generate │
             │ + Risks   │  │  Tests   │
             └───────────┘  └──────────┘

Mismo código = misma puntuación. Determinista. Siempre.

Soporte de lenguajes

El mapeo estático funciona en muchos lenguajes mediante tree-sitter. La prueba dinámica es deliberadamente más limitada — cada lenguaje necesita un ejecutor, un localizador de mutaciones y un perfil de sandbox.

Ejecución local de mayor valor

Usa primero los comandos de configuración y prueba del propio repositorio, y mantén la cobertura de unidades e integración en artefactos separados. Luego ejecuta opro start; realiza el análisis, ingiere los artefactos, intenta la prueba dirigida, genera borradores visibles en el informe y escribe el informe final. Un opro analyze separado es innecesario cuando opro start lo sigue.

# 1. Install/build exactly as the repository documents.
# 2. Run the repository's unit and integration coverage commands separately.
# 3. Record artifact provenance (example paths and commands):
mkdir -p .orangepro
# create .orangepro/coverage-suites.json using the schema below

opro coverage .                    # optional preflight: discover/generate artifacts
opro start . --proof-limit 5 --generate-limit 20

{
  "artifacts": {
    ".orangepro/coverage/unit.coverprofile": {
      "suite": "unit",
      "command": "make unit-test-coverage"
    },
    ".orangepro/coverage/integration.coverprofile": {
      "suite": "integration",
      "command": "make integration-test-coverage"
    }
  }
}

Sin este manifiesto, OrangePro infiere de forma conservadora nombres claros de unit/integration y etiqueta todo lo demás como unclassified; nunca adivina que un perfil agregado es solo de unidades. El informe muestra unidades, integración, su superposición, cobertura no clasificada y la unión combinada por separado. --proof-limit controla los intentos de prueba dinámica (que pueden redactar una prueba para verificación); --generate-limit controla de forma independiente el carril adicional de redacción de brechas de riesgo visible en el informe. Una ejecución de generación también registra su estado terminal y la razón exacta, de modo que un fallo de compilador/importación no se informe erróneamente como un problema genérico de dependencias.

Privacidad

• Sin almacenamiento de código fuente. Lee el código en proceso. Nunca lo sube a un servidor de OrangePro.
• Sin mutación de código existente. Nunca edita tus archivos fuente o de prueba.
• Tus claves siguen siendo tuyas. Se leen del entorno en el momento de la llamada, nunca se persisten.
• BYOK es directo. El contexto del código va al proveedor de modelo que configures. OrangePro no está en esa ruta.

opro                          # analyze + report + agent next actions
opro start --base main        # same, scoped to a branch diff
opro analyze                  # build the evidence graph
opro score                    # graph readiness (0–100)
opro gaps --limit 10          # top 10 untested behaviors
opro generate --base main     # tests for PR diff
opro generate --single        # top gap, whole repo
opro prove                    # mutation-kill oracle
opro rtm                      # traceability matrix
opro export                   # metadata-only evidence pack
opro mcp                      # run as MCP server (stdio)
opro doctor                   # what evidence to add next
opro coverage                 # discover/generate artifacts; analyze or start ingests them

opro generate --base main              # tests for what this branch changed
opro generate --pr 1234                # checks out PR #1234
opro generate --changed                # current branch diff vs main

Qué hay en la plataforma alojada

Este repositorio es la herramienta local gratuita. La plataforma OrangePro agrega:

• Grafo de conocimiento persistente entre PRs y repositorios
• Puertas de política de PR/CI sobre niveles de evidencia y deltas de riesgo
• Enriquecimiento con Jira / Confluence / TestRail / OpenAPI
• Inteligencia entre repositorios y memoria de flujos recurrentes
• Correlación de incidentes de producción y orientación de regresión
• Paneles de equipo y gestión del ciclo de vida de pruebas

Contribuciones

git clone https://github.com/OrangeproAI/orangepro-mcp.git
cd orangepro-mcp && npm ci && npm run build
npm test

Se aceptan PRs. Abre un issue primero para cambios grandes.

Licencia MIT · orangepro.ai