OrangePro

Encontre os comportamentos que seus testes não cobrem. Gere testes fundamentados que realmente executam.

O OrangePro mapeia cada comportamento público no seu código, pontua cada um com base em evidências reais de teste e mostra os pontos cegos estruturais antes que seus usuários os encontrem. Executa localmente. Seu código nunca sai da sua máquina.

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

Sumário

• O que você obtém
• Níveis de evidência
• Início rápido
• Uso com seu agente de codificação
• Como funciona
• Suporte a linguagens
• Privacidade
• Referência da CLI
• Ferramentas MCP
• Plataforma
• Contribuindo

O que você obtém

Um único comando produz um relatório HTML interativo:

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

O relatório tem dois modos: Simples (pontos cegos em nível de integração, em linguagem clara) e Especialista (lista completa de comportamentos, níveis de evidência, fluxos, mapa do sistema). Alterne com o botão no topo.

→ Exemplo ao vivo: Twenty CRM (5.237 comportamentos mapeados)

Mapa do sistema — faixas de entrada (GraphQL, HTTP, Jobs) fluindo para serviços, dimensionadas por tráfego, coloridas por nível de evidência, com anel vermelho por risco.

Lacunas prioritárias de outro projeto open source HONO — os 20 principais comportamentos não comprovados classificados por raio de impacto, com rascunhos de testes gerados.

Níveis de evidência

Cada comportamento recebe exatamente um nível. Nada é rotulado como "testado" por suposição.

"Comprovado Dinamicamente 0" é normal na primeira execução. A prova exige executar testes contra mutações direcionadas. Esse é o modelo de confiança.

Início 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

Nenhuma chave de API é necessária. O relatório mostra seu mapa do sistema, níveis de evidência, lacunas prioritárias e o delta desde a última execução.

Quer geração de testes? Adicione uma chave de modelo (BYOK):

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

A saída da IA nunca altera os níveis de evidência. Somente o oráculo de eliminação por mutação pode conceder o status Comprovado Dinamicamente.

Saída:

.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 nova execução mostra um banner de delta: o que entrou no código, o que subiu em risco, o que foi resolvido.

Uso com seu agente de codificação

O OrangePro executa como um servidor MCP. Adicione à configuração do seu cliente:

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

O fluxo de trabalho: Diga ao seu agente:

"Use orangepro_start, depois orangepro_generate_tests com base_ref=main. Escreva cada teste no suggested_path, execute-o e relate pass/fail."

O agente escreve o teste, executa, chama orangepro_prove, e o comportamento se torna Comprovado Dinamicamente. Um prompt, ciclo completo.

Funciona com

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

Qualquer agente compatível com MCP pode usar o OrangePro. Sem dependência de fornecedor.

Como funciona

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

Mesmo código = mesma pontuação. Determinístico. Sempre.

Suporte a linguagens

O mapeamento estático funciona em muitas linguagens via tree-sitter. A prova dinâmica é deliberadamente mais restrita — cada linguagem precisa de um executor, localizador de mutações e perfil de sandbox.

Execução local de maior valor

Use primeiro os comandos de configuração e teste do próprio repositório e mantenha a cobertura de unidade e integração em artefatos separados. Depois execute opro start; ele realiza a análise, ingere os artefatos, tenta a prova direcionada, gera rascunhos visíveis no relatório e escreve o relatório final. Um opro analyze separado é desnecessário quando opro start o segue.

# 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"
    }
  }
}

Sem este manifesto, o OrangePro infere conservadoramente nomes claros de unit/integration e rotula todo o resto como unclassified; ele nunca adivinha que um perfil agregado é apenas de unidade. O relatório mostra unidade, integração, a sobreposição entre eles, cobertura não classificada e a união combinada separadamente. --proof-limit controla as tentativas de prova dinâmica (que podem rascunhar um teste para prova); --generate-limit controla independentemente a faixa adicional de rascunho de lacunas de risco visível no relatório. Uma execução de geração também registra seu status terminal e o motivo exato, para que uma falha de compilador/importação não seja relatada erroneamente como um problema genérico de dependência.

Privacidade

• Nenhum código armazenado. Lê o código em processo. Nunca envia para um servidor OrangePro.
• Nenhuma mutação do código existente. Nunca edita seus arquivos de código ou teste.
• Suas chaves permanecem suas. Lidas do ambiente no momento da chamada, nunca persistidas.
• BYOK é direto. O contexto do código vai para o provedor de modelo que você configurar. O OrangePro não está nesse caminho.

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

O que há na plataforma hospedada

Este repositório é a ferramenta local gratuita. A plataforma OrangePro adiciona:

• Grafo de conhecimento persistente entre PRs e repositórios
• Portões de política de PR/CI sobre níveis de evidência e deltas de risco
• Enriquecimento com Jira / Confluence / TestRail / OpenAPI
• Inteligência entre repositórios e memória de fluxos recorrentes
• Correlação de incidentes de produção e direcionamento de regressão
• Painéis de equipe e gerenciamento do ciclo de vida de testes

Contribuindo

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

PRs são bem-vindos. Abra uma issue primeiro para mudanças grandes.

Licença MIT · orangepro.ai