mcp-lab-agent 2.1.6 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +105 -21
  2. package/dist/index.js +1067 -287
  3. package/dist/index.js.map +1 -1
  4. package/package.json +3 -2
  5. package/slack-bot/README.md +4 -1
  6. package/slack-bot/TROUBLESHOOTING.md +41 -5
  7. package/slack-bot/check-config.js +11 -3
  8. package/slack-bot/src/config.js +22 -5
package/README.md CHANGED
@@ -4,46 +4,127 @@
4
4
  [![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org)
5
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
6
6
 
7
- **Sistema de inteligência em qualidade de software.** Executa testes, analisa causas de falha, corrige automaticamente e aprende padrões que melhoram as próximas gerações. Não é ferramenta de QA — é um sistema que entende qualidade. Integra ao Cursor, Cline, Windsurf ou Slack.
7
+ **PT-BR** | [English](#english)
8
+
9
+ ---
10
+
11
+ ## Português (PT-BR)
12
+
13
+ **Sistema de QA autônomo com IA.** Reduz tempo de debug de testes, elimina flaky e mantém seletores estáveis — com um sistema de aprendizado que melhora a cada correção.
14
+
15
+ > **TL;DR para recrutadores:** QA autônomo que explica *por que* os testes falharam em linguagem clara e aplica correções automaticamente. Testes que se autocorrigem e aprendem a cada fix. Integra com IDE (Cursor) e Slack. Feito para QA Engineers, SDETs e roles de Automação/IA.
16
+
17
+ ### Por que isso importa
18
+
19
+ | Problema real | Impacto no mercado | O que o mcp-lab-agent faz |
20
+ |---------------|--------------------|---------------------------|
21
+ | **Testes flaky** | Times gastam 5–10h/semana. Microsoft: ~25% das falhas em CI são flaky; Slack tinha 56% antes de remediar. | Detecta padrões flaky, sugere correções, retry automático com fixes |
22
+ | **"Por que falhou?"** | QAs e devs perdem horas lendo stack traces e logs. "Teste falhou" genérico não ajuda. | **Causa + correção em 30 segundos.** Diagnóstico em linguagem clara: o que aconteceu, por que e como corrigir |
23
+ | **Seletores quebrados** | Refactors de UI quebram testes. Seletores frágeis (classes CSS, XPath longo) exigem manutenção manual. | Auto-fix de seletores, sugere `data-testid`, aplica correções e tenta de novo |
24
+
25
+ ### O WOW: Testes que se autocorrigem e aprendem
26
+
27
+ **Quando um teste falha, você recebe a causa e a correção em 30 segundos. Sem cavar em stack traces.**
28
+
29
+ Cada correção bem-sucedida é salva e reutilizada. Na próxima falha similar, o agente aplica o padrão aprendido automaticamente. **A taxa de sucesso na primeira tentativa melhora ao longo do tempo** — mensurável via `mcp-lab-agent stats`.
8
30
 
9
31
  ```bash
10
32
  npx mcp-lab-agent auto "login flow" --max-retries 5
11
33
  ```
12
34
 
13
- **1 comando. Análise completa.**
35
+ *Um comando. Análise completa. Autocorreção. Aprendizado.*
14
36
 
15
- > Testes falham e você não sabe por quê? Executores rodam mas não aprendem. O mcp-lab-agent analisa causas, corrige e acumula conhecimento.
37
+ ### Principais resultados
16
38
 
17
- ---
39
+ - **Reduz tempo de debug** — "Por que falhou?" em linguagem clara, não stack traces
40
+ - **Corta manutenção de flaky** — Detecção, diagnóstico e sugestões de correção
41
+ - **Escala QA sem escalar headcount** — Agente no IDE + Slack bot; funciona com Cypress, Playwright, Appium, Jest e 11+ frameworks
42
+ - **Pronto para enterprise** — Socket Mode (sem URL pública), Ollama (offline), Learning Hub para times
18
43
 
19
- ## O que é
44
+ ### Como funciona
20
45
 
21
- O **mcp-lab-agent** é um sistema de inteligência em qualidade de software — não uma ferramenta de teste isolada. Ele entende o seu projeto, identifica frameworks (Cypress, Playwright, Jest, Appium, Robot, pytest e outros), gera testes com base em contexto e memória, executa, analisa falhas e aplica correções automaticamente. O valor central está no **learning**: cada correção bem-sucedida é salva e usada nas próximas gerações, aumentando a taxa de sucesso na primeira tentativa.
46
+ **🤖 Agente no IDE (Cursor, Cline, Windsurf)** — Pergunte no chat: *"Gere teste para login"*, *"Por que o teste falhou?"*, *"Roda o teste X"*. O agente detecta o projeto, executa testes, analisa falhas, aplica correções e aprende.
22
47
 
23
- Com o **Learning Hub**, os aprendizados são centralizados e agregados entre projetos e — em deploy compartilhado — entre times e empresas, formando uma base de conhecimento em qualidade que escala além do repositório.
48
+ **💬 Slack Bot** — Mencione o bot em qualquer canal — ele executa testes e posta o relatório. Funciona em ambiente corporativo (Socket Mode, sem ngrok). QA no fluxo da conversa.
24
49
 
25
- ---
26
-
27
- ## Para quem
50
+ ### Para quem é
28
51
 
29
52
  | Perfil | Benefício |
30
53
  |--------|-----------|
31
- | **QAs e SDETs** | Geração assistida de testes, análise de falhas com sugestões de correção, detecção de flakiness |
32
- | **Desenvolvedores** | "Por que falhou?", análise de arquivos e métodos, integração direta no IDE |
54
+ | **QAs e SDETs** | Geração assistida de testes, análise de falhas com sugestões de correção, detecção de flaky |
55
+ | **Desenvolvedores** | "Por que falhou?" em segundos, análise de arquivos/métodos, integração direta no IDE |
33
56
  | **Tech leads** | Visão de risco por área, métricas de estabilidade, relatórios para decisão |
34
- | **Empresas** | Learning Hub centralizado, escala entre squads e organizações, CI/CD, Ollama (offline), Slack para QA via chat |
57
+ | **Times** | Learning Hub, Slack bot para QA no chat, CI/CD, Ollama (offline) |
35
58
 
36
- ---
37
-
38
- ## Comparação
59
+ ### Como é diferente
39
60
 
40
61
  | Outras ferramentas | mcp-lab-agent |
41
62
  |--------------------|---------------|
42
- | Só executam testes | Executa, analisa causa da falha e sugere correção |
43
- | Saída genérica "teste falhou" | Diagnóstico: "login falha 30% das vezes (timing)" |
44
- | Sem visão de risco | Identifica áreas sem testes e classifica risco (alto/médio/baixo) |
45
- | Sem memória entre execuções | Learning system: cada padrão de falha vira correção aplicada nas próximas gerações |
46
- | Uma ferramenta por tarefa | Sistema de inteligência: geração, execução, análise, relatórios, predição, learning |
63
+ | Só executam testes | Executa, analisa causa, sugere fix, aplica correção |
64
+ | "Teste falhou" genérico | Linguagem clara: "Login falha 30% das vezes (timing). Adicione waitForDisplayed." |
65
+ | Sem memória entre execuções | Learning system: cada fix melhora as próximas gerações |
66
+ | Uma ferramenta por tarefa | End-to-end: gera, executa, analisa, reporta, aprende |
67
+
68
+ ---
69
+
70
+ <a name="english"></a>
71
+
72
+ ## English
73
+
74
+ **AI-powered autonomous QA system.** Reduces test debugging time, eliminates flaky tests, and keeps selectors stable — with a learning system that gets smarter with every fix.
75
+
76
+ > **TL;DR for recruiters:** Autonomous QA that explains *why* tests fail in plain language and applies fixes automatically. Self-healing tests that learn from each fix. Integrates with IDE (Cursor) and Slack. Built for QA Engineers, SDETs, and AI/Automation roles.
77
+
78
+ ### Why this matters
79
+
80
+ | Real problem | Industry impact | What mcp-lab-agent does |
81
+ |--------------|-----------------|-------------------------|
82
+ | **Flaky tests** | Teams spend 5–10h/week. Microsoft: ~25% of CI failures are flaky; Slack had 56% before remediation. | Detects flaky patterns, suggests fixes, auto-retries with corrections |
83
+ | **"Why did it fail?"** | QAs and devs lose hours reading stack traces and logs. Generic "test failed" doesn't help. | **Cause + fix in 30 seconds.** Plain-language diagnosis: what happened, why, and how to fix |
84
+ | **Broken selectors** | UI refactors break tests. Fragile selectors (CSS classes, long XPath) require manual maintenance. | Auto-fix selectors, suggests `data-testid`, applies corrections and retries |
85
+
86
+ ### The WOW: Self-healing tests that learn
87
+
88
+ **When a test fails, you get the cause and fix in 30 seconds. No more digging through stack traces.**
89
+
90
+ Each successful fix is saved and reused. The next time a similar failure happens, the agent applies the learned pattern automatically. **First-attempt success rate improves over time** — measurable via `mcp-lab-agent stats`.
91
+
92
+ ```bash
93
+ npx mcp-lab-agent auto "login flow" --max-retries 5
94
+ ```
95
+
96
+ *One command. Full analysis. Self-correction. Learning.*
97
+
98
+ ### Key outcomes
99
+
100
+ - **Reduce debugging time** — "Why did it fail?" in plain language, not stack traces
101
+ - **Cut flaky test maintenance** — Detection, diagnosis, and suggested fixes
102
+ - **Scale QA without scaling headcount** — IDE agent + Slack bot; works with Cypress, Playwright, Appium, Jest, and 11+ frameworks
103
+ - **Enterprise-ready** — Socket Mode (no public URL), Ollama (offline), Learning Hub for teams
104
+
105
+ ### How it works
106
+
107
+ **🤖 IDE Agent (Cursor, Cline, Windsurf)** — Ask in chat: *"Generate a test for login"*, *"Why did the test fail?"*, *"Run test X"*. The agent detects your project, runs tests, analyzes failures, applies fixes, and learns.
108
+
109
+ **💬 Slack Bot** — Mention the bot in any channel — it runs tests and posts the report. Works in corporate environments (Socket Mode, no ngrok). QA in the flow of conversation.
110
+
111
+ ### Who it's for
112
+
113
+ | Role | Benefit |
114
+ |------|---------|
115
+ | **QAs & SDETs** | Assisted test generation, failure analysis with fix suggestions, flaky detection |
116
+ | **Developers** | "Why did it fail?" in seconds, file/method analysis, direct IDE integration |
117
+ | **Tech leads** | Risk visibility by area, stability metrics, decision-ready reports |
118
+ | **Teams** | Learning Hub, Slack bot for QA in chat, CI/CD integration, Ollama (offline) |
119
+
120
+ ### How it's different
121
+
122
+ | Other tools | mcp-lab-agent |
123
+ |-------------|---------------|
124
+ | Run tests only | Run, analyze cause, suggest fix, apply correction |
125
+ | Generic "test failed" | Plain-language: "Login fails 30% of the time (timing). Add waitForDisplayed." |
126
+ | No memory between runs | Learning system: each fix improves future generations |
127
+ | One tool per task | End-to-end: generate, run, analyze, report, learn |
47
128
 
48
129
  ---
49
130
 
@@ -106,6 +187,8 @@ Adicione ao `~/.cursor/mcp.json`:
106
187
 
107
188
  Use no chat: *"Detecte a estrutura do meu projeto"*, *"Gere teste para login"*, *"Por que o teste falhou?"*, *"Avalie http://localhost:3000 no browser"*.
108
189
 
190
+ **run_tests com device e auto-fix:** Ao pedir *"Roda o teste X"*, o agente detecta o device (de `qa-lab-agent.config.json`, `wdio.conf` ou `.detoxrc`), executa o fluxo e, se falhar por seletor, aplica correção automaticamente e tenta novamente.
191
+
109
192
  ### Slack Bot
110
193
 
111
194
  ```bash
@@ -295,6 +378,7 @@ npm install playwright
295
378
  - [CHANGELOG.md](CHANGELOG.md) — Histórico de versões
296
379
  - [slack-bot/README.md](slack-bot/README.md) — Slack Bot
297
380
  - [learning-hub/README.md](learning-hub/README.md) — Learning Hub
381
+ - [docs/PORTFOLIO_COPY_PT-BR.md](docs/PORTFOLIO_COPY_PT-BR.md) — Copy em PT-BR para portfólio (Vercel)
298
382
 
299
383
  ---
300
384