mcp-lab-agent 2.0.0 → 2.1.1

package/README.md

@@ -4,9 +4,16 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-**Agente autônomo de QA que aprende com os próprios erros.**
+**Executor + Consultor Inteligente de QA.**
 
-Não é só um assistente: é um agente que **lê seu projeto, gera testes, executa, corrige falhas automaticamente e aprende** para cada vez acertar mais na primeira tentativa.
+Não é só um executor de testes. É um agente que:
+- **Executa:** Roda testes, gera, corrige
+- **Analisa:** "login falha 30% das vezes"
+- **Prevê:** "checkout vai ficar flaky"
+- **Recomenda:** "faça isso agora: 1, 2, 3"
+- **Aprende:** Taxa de sucesso aumenta com o tempo
+
+**1 comando. Análise completa.**
 
 ---
 
@@ -14,11 +21,11 @@ Não é só um assistente: é um agente que **lê seu projeto, gera testes, exec
 
 | Outras ferramentas | **mcp-lab-agent** |
 |-------------------|-------------------|
-| Geram testes | **Gera, roda, corrige e aprende** |
-| Você corrige erros | **Auto-correção com retry inteligente** |
-| Sem memória | **Aprende com erros passados** |
-| Configuração complexa | **Zero config: detecta 15+ frameworks** |
-| Sem métricas | **Taxa de sucesso, correções, aprendizados** |
+| Só executam | **Executa + Analisa + Recomenda** |
+| "teste falhou" | **"login falha 30% das vezes (timing)"** |
+| Sem contexto | **"src/payment/ sem testes (RISCO ALTO)"** |
+| Você decide o que fazer | **"Faça isso agora: 1, 2, 3"** |
+| Sem aprendizado | **Taxa de sucesso aumenta com o tempo** |
 
 **Modo autônomo:**
 
@@ -39,17 +46,17 @@ O agente:
 
 ## Quick Start
 
-### Modo autônomo (CLI)
+### Análise Completa (CLI)
 
 ```bash
-# Gera, roda, corrige e aprende automaticamente
+# Análise completa: executa, analisa, prevê e recomenda
+npx mcp-lab-agent analyze
+
+# Modo autônomo: gera, roda, corrige e aprende
 npx mcp-lab-agent auto "login flow" --max-retries 5
 
 # Ver métricas de aprendizado
 npx mcp-lab-agent stats
-
-# Detectar estrutura do projeto
-npx mcp-lab-agent detect
 ```
 
 ### Integração com IDE (Cursor/Cline/Windsurf)
@@ -254,15 +261,54 @@ Referência completa do CLI: `mcp-lab-agent --help`
 
 ## Configuração
 
-### Variáveis de ambiente (opcional)
+### Opção 1: APIs Externas (Groq, Gemini, OpenAI)
+
+```bash
+# .env
+GROQ_API_KEY=sua-key  # Gratuito: https://console.groq.com/keys
+```
+
+### Opção 2: Ollama (Local, Sem Internet) ⭐ Recomendado para empresas
+
+```bash
+# 1. Instale o Ollama
+brew install ollama  # macOS
+# ou: curl -fsSL https://ollama.com/install.sh | sh  # Linux
+
+# 2. Baixe o modelo
+ollama pull llama3.1:8b
+
+# 3. Inicie
+ollama serve
+
+# 4. Pronto! O agente detecta automaticamente
+npx mcp-lab-agent auto "login flow"
+```
+
+**100% offline. Sem APIs externas. Ideal para ambientes corporativos.**
+
+### Opção 3: LLM Interno da Empresa
+
+```bash
+# .env
+QA_LAB_LLM_BASE_URL=https://llm-interno.empresa.com/v1
+QA_LAB_LLM_API_KEY=sua-key-interna
+```
+
+**Guia completo:** [CONFIGURACAO_CORPORATIVA.md](CONFIGURACAO_CORPORATIVA.md)
+
+### Variáveis de ambiente (todas opcionais)
 
 | Variável | Uso |
 |----------|-----|
 | `GROQ_API_KEY` | Groq (gratuito, rápido) |
 | `GEMINI_API_KEY` | Google Gemini |
 | `OPENAI_API_KEY` | OpenAI |
-| `QA_LAB_LLM_SIMPLE` | Modelo para tarefas simples (ex: gemini-1.5-flash) |
-| `QA_LAB_LLM_COMPLEX` | Modelo para tarefas complexas (ex: gpt-4o) |
+| `OLLAMA_BASE_URL` | Ollama customizado (default: http://localhost:11434) |
+| `QA_LAB_LLM_BASE_URL` | Endpoint LLM customizado (empresa) |
+| `QA_LAB_LLM_API_KEY` | API key para LLM customizado |
+| `QA_LAB_LLM_SIMPLE` | Modelo para tarefas simples |
+| `QA_LAB_LLM_COMPLEX` | Modelo para tarefas complexas |
 
 ### Modo browser (opcional)