npm - mcp-lab-agent - Versions diffs - 2.1.3 → 2.1.6 - Mend

mcp-lab-agent 2.1.3 → 2.1.6

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 (19) hide show

package/README.md +187 -227
package/dist/index.js +447 -19
package/dist/index.js.map +1 -1
package/learning-hub/README.md +66 -0
package/learning-hub/package.json +17 -0
package/learning-hub/src/dashboard.html +73 -0
package/learning-hub/src/server.js +129 -0
package/learning-hub/src/store.js +114 -0
package/package.json +7 -3
package/slack-bot/.env.example +17 -2
package/slack-bot/CREDENTIALS.md +23 -0
package/slack-bot/README.md +87 -16
package/slack-bot/TROUBLESHOOTING.md +73 -0
package/slack-bot/check-config.js +117 -0
package/slack-bot/package.json +2 -1
package/slack-bot/setup.js +14 -8
package/slack-bot/src/config.js +25 -9
package/slack-bot/src/index.js +46 -12
package/slack-bot/src/workers/qa-job.js +17 -10

package/learning-hub/README.md ADDED Viewed

@@ -0,0 +1,66 @@
+# QA Lab Learning Hub
+API centralizada para aprendizados do **mcp-lab-agent**. Permite acumular memória entre projetos e ver métricas em um dashboard.
+## Rodar
+```bash
+# Via npx (sem clonar)
+npx mcp-lab-agent learning-hub
+# Ou local
+npm run learning-hub
+# ou: node learning-hub/src/server.js
+```
+Porta padrão: **3847**. Acesse http://localhost:3847 para o dashboard.
+## Endpoints
+| Método | Rota | Descrição |
+|--------|------|-----------|
+| GET | `/` | Dashboard web (taxa de sucesso, padrões, recomendações) |
+| POST | `/learning` | Recebe learnings do agente |
+| GET | `/patterns` | Padrões agregados (`?framework=&projectId=&limit=`) |
+| GET | `/health` | Health check |
+## Configurar o agente para enviar ao Hub
+No `.env` do seu projeto:
+```env
+LEARNING_HUB_URL=http://localhost:3847
+LEARNING_HUB_PROJECT_ID=meu-projeto
+```
+O agente enviará automaticamente cada aprendizado para o Hub (assíncrono, não bloqueia).
+## Formato POST /learning
+```json
+{
+  "learnings": [
+    {
+      "type": "element_not_rendered",
+      "framework": "playwright",
+      "request": "login flow",
+      "fix": "await element.waitFor({ state: 'attached' })",
+      "success": false,
+      "timestamp": "2025-03-18T..."
+    }
+  ]
+}
+```
+## Armazenamento
+Por padrão, dados em `./data/learnings.json`. Configure:
+```env
+LEARNING_HUB_DATA=/caminho/para/data
+LEARNING_HUB_PORT=3847
+```
+## Escalar
+Para produção: troque `store.js` por SQLite ou Postgres. A API permanece a mesma.

package/learning-hub/package.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "name": "qa-lab-learning-hub",
+  "version": "1.0.0",
+  "description": "Learning Hub - API centralizada para aprendizados do mcp-lab-agent",
+  "type": "module",
+  "main": "src/server.js",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "node --watch src/server.js"
+  },
+  "keywords": ["qa", "mcp-lab-agent", "learning", "dashboard"],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/learning-hub/src/dashboard.html ADDED Viewed

@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>QA Lab - Learning Hub Dashboard</title>
+  <style>
+    * { box-sizing: border-box; }
+    body { font-family: system-ui, -apple-system, sans-serif; margin: 0; padding: 1.5rem; background: #0f172a; color: #e2e8f0; }
+    h1 { font-size: 1.5rem; margin: 0 0 0.5rem; }
+    .sub { color: #94a3b8; font-size: 0.875rem; margin-bottom: 1.5rem; }
+    .grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }
+    .card { background: #1e293b; border-radius: 8px; padding: 1rem; border: 1px solid #334155; }
+    .card h3 { margin: 0 0 0.5rem; font-size: 0.75rem; text-transform: uppercase; color: #94a3b8; }
+    .card .val { font-size: 1.75rem; font-weight: 700; }
+    .card.green .val { color: #22c55e; }
+    .card.yellow .val { color: #eab308; }
+    .card.red .val { color: #ef4444; }
+    .section { margin-top: 1.5rem; }
+    .section h2 { font-size: 1rem; margin: 0 0 0.75rem; }
+    ul { list-style: none; padding: 0; margin: 0; }
+    li { padding: 0.35rem 0; border-bottom: 1px solid #334155; display: flex; justify-content: space-between; }
+    li:last-child { border-bottom: none; }
+    .rec { background: #1e293b; border-radius: 8px; padding: 1rem; margin-top: 0.5rem; border-left: 4px solid #3b82f6; }
+    .error { color: #ef4444; }
+    .refresh { background: #3b82f6; color: white; border: none; padding: 0.5rem 1rem; border-radius: 6px; cursor: pointer; font-size: 0.875rem; }
+    .refresh:hover { background: #2563eb; }
+  </style>
+</head>
+<body>
+  <h1>QA Lab Learning Hub</h1>
+  <p class="sub">Dashboard centralizado de aprendizados</p>
+  <button class="refresh" onclick="load()">Atualizar</button>
+  <div class="grid" id="metrics"></div>
+  <div class="section">
+    <h2>Padrões por tipo</h2>
+    <ul id="byType"></ul>
+  </div>
+  <div class="section">
+    <h2>Recomendações</h2>
+    <div id="recs"></div>
+  </div>
+  <script>
+    const base = window.location.origin;
+    async function load() {
+      try {
+        const r = await fetch(base + '/patterns?limit=500');
+        const d = await r.json();
+        document.getElementById('metrics').innerHTML = [
+          { k: 'Taxa de sucesso (1ª tent.)', v: d.firstAttemptSuccessRate + '%', c: d.firstAttemptSuccessRate >= 70 ? 'green' : d.firstAttemptSuccessRate >= 50 ? 'yellow' : 'red' },
+          { k: 'Total de aprendizados', v: d.total, c: '' },
+          { k: 'Testes gerados', v: d.testGenerated, c: '' },
+        ].map(x => `<div class="card ${x.c}"><h3>${x.k}</h3><div class="val">${x.v}</div></div>`).join('');
+        const byType = Object.entries(d.byType || {}).filter(([,n]) => n > 0).sort((a,b) => b[1]-a[1]);
+        document.getElementById('byType').innerHTML = byType.length
+          ? byType.map(([t,n]) => `<li><span>${t}</span><strong>${n}</strong></li>`).join('')
+          : '<li class="error">Nenhum aprendizado ainda</li>';
+        document.getElementById('recs').innerHTML = (d.recommendations || [])
+          .map(r => `<div class="rec">${r}</div>`).join('') || '<div class="rec">Continue gerando testes.</div>';
+      } catch (e) {
+        document.getElementById('metrics').innerHTML = `<div class="card error"><h3>Erro</h3><div class="val">${e.message}</div></div>`;
+      }
+    }
+    load();
+    setInterval(load, 30000);
+  </script>
+</body>
+</html>

package/learning-hub/src/server.js ADDED Viewed

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * Learning Hub - API centralizada para aprendizados do mcp-lab-agent
+ *
+ * Endpoints:
+ *   POST /learning     — recebe learnings (body: { learnings: [...] } ou learnings: {...})
+ *   GET  /patterns    — retorna padrões agregados (?framework=playwright&projectId=xyz&limit=100)
+ *   GET  /health      — health check
+ *
+ * Uso:
+ *   LEARNING_HUB_DATA=./data node src/server.js
+ *   Porta padrão: 3847 (QA)
+ */
+import http from "node:http";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { addLearnings, getAggregatedPatterns } from "./store.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PORT = parseInt(process.env.LEARNING_HUB_PORT || "3847", 10);
+function parseBody(req) {
+  return new Promise((resolve, reject) => {
+    let body = "";
+    req.on("data", (c) => (body += c));
+    req.on("end", () => {
+      try {
+        resolve(body ? JSON.parse(body) : {});
+      } catch {
+        reject(new Error("Invalid JSON"));
+      }
+    });
+    req.on("error", reject);
+  });
+}
+function send(res, status, data) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
+}
+async function handler(req, res) {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+  if (req.method === "OPTIONS") {
+    res.writeHead(204);
+    res.end();
+    return;
+  }
+  const url = new URL(req.url || "/", `http://${req.headers.host}`);
+  const path = url.pathname;
+  try {
+    if (path === "/health") {
+      send(res, 200, { ok: true, service: "learning-hub", version: "1.0.0" });
+      return;
+    }
+    if (path === "/learning" && req.method === "POST") {
+      const body = await parseBody(req);
+      const learnings = body.learnings ?? (body.type ? body : null);
+      if (!learnings) {
+        send(res, 400, { error: "Missing learnings. Send { learnings: [...] } or a single learning object." });
+        return;
+      }
+      const entries = Array.isArray(learnings) ? learnings : [learnings];
+      const added = addLearnings(entries);
+      send(res, 201, { ok: true, added });
+      return;
+    }
+    if (path === "/patterns" && req.method === "GET") {
+      const framework = url.searchParams.get("framework");
+      const projectId = url.searchParams.get("projectId");
+      const limit = parseInt(url.searchParams.get("limit") || "500", 10);
+      const data = getAggregatedPatterns({ framework, projectId, limit });
+      send(res, 200, data);
+      return;
+    }
+    if (path === "/" || path === "") {
+      const dashboardPath = path.join(__dirname, "dashboard.html");
+      if (fs.existsSync(dashboardPath)) {
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end(fs.readFileSync(dashboardPath, "utf8"));
+      } else {
+        send(res, 200, {
+          name: "qa-lab-learning-hub",
+          endpoints: {
+            "GET /": "Dashboard",
+            "POST /learning": "Recebe learnings do agente",
+            "GET /patterns": "Padrões agregados (?framework=&projectId=&limit=)",
+            "GET /health": "Health check",
+          },
+        });
+      }
+      return;
+    }
+    if (path === "/api") {
+      send(res, 200, {
+        name: "qa-lab-learning-hub",
+        endpoints: {
+          "POST /learning": "Recebe learnings do agente",
+          "GET /patterns": "Padrões agregados (?framework=&projectId=&limit=)",
+          "GET /health": "Health check",
+        },
+      });
+      return;
+    }
+    send(res, 404, { error: "Not found" });
+  } catch (err) {
+    send(res, 500, { error: err.message || "Internal error" });
+  }
+}
+const server = http.createServer(handler);
+server.listen(PORT, () => {
+  console.log(`Learning Hub rodando em http://localhost:${PORT}`);
+  console.log("  GET  /         — Dashboard");
+  console.log("  POST /learning — envia learnings");
+  console.log("  GET  /patterns — padrões agregados");
+  console.log("  GET  /health   — health check");
+});

package/learning-hub/src/store.js ADDED Viewed

@@ -0,0 +1,114 @@
+/**
+ * Store para Learning Hub - persistência em JSON (como memory.js do agente).
+ * Escalável: troque por SQLite/Postgres se precisar.
+ */
+import fs from "node:fs";
+import path from "node:path";
+const DATA_DIR = process.env.LEARNING_HUB_DATA || path.join(process.cwd(), "data");
+const LEARNINGS_FILE = path.join(DATA_DIR, "learnings.json");
+const MAX_LEARNINGS = 5000;
+function ensureDir() {
+  if (!fs.existsSync(DATA_DIR)) {
+    fs.mkdirSync(DATA_DIR, { recursive: true });
+  }
+}
+function loadLearnings() {
+  ensureDir();
+  if (!fs.existsSync(LEARNINGS_FILE)) return [];
+  try {
+    const raw = fs.readFileSync(LEARNINGS_FILE, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return [];
+  }
+}
+function saveLearnings(learnings) {
+  ensureDir();
+  const trimmed = learnings.length > MAX_LEARNINGS ? learnings.slice(-MAX_LEARNINGS) : learnings;
+  fs.writeFileSync(LEARNINGS_FILE, JSON.stringify(trimmed, null, 2), "utf8");
+}
+export function addLearnings(entries) {
+  const learnings = loadLearnings();
+  const normalized = Array.isArray(entries) ? entries : [entries];
+  const withMeta = normalized.map((e) => ({
+    ...e,
+    id: `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    receivedAt: new Date().toISOString(),
+  }));
+  learnings.push(...withMeta);
+  saveLearnings(learnings);
+  return withMeta.length;
+}
+export function getAggregatedPatterns(filters = {}) {
+  const learnings = loadLearnings();
+  const { framework, projectId, limit = 100 } = filters;
+  let filtered = learnings;
+  if (framework) {
+    filtered = filtered.filter((l) => (l.framework || "").toLowerCase().includes(framework.toLowerCase()));
+  }
+  if (projectId) {
+    filtered = filtered.filter((l) => l.projectId === projectId);
+  }
+  filtered = filtered.slice(-(limit || 500));
+  const byType = {};
+  const byFramework = {};
+  const byFrameworkAndType = {};
+  let testGenerated = 0;
+  let firstAttemptSuccess = 0;
+  filtered.forEach((l) => {
+    const t = l.type || "unknown";
+    byType[t] = (byType[t] || 0) + 1;
+    const f = l.framework || "unknown";
+    byFramework[f] = (byFramework[f] || 0) + 1;
+    const key = `${f}::${t}`;
+    byFrameworkAndType[key] = (byFrameworkAndType[key] || 0) + 1;
+    if (t === "test_generated") {
+      testGenerated++;
+      if (l.passedFirstTime) firstAttemptSuccess++;
+    }
+  });
+  const successRate = testGenerated > 0 ? Math.round((firstAttemptSuccess / testGenerated) * 100) : 0;
+  return {
+    total: filtered.length,
+    byType,
+    byFramework,
+    byFrameworkAndType,
+    testGenerated,
+    firstAttemptSuccessRate: successRate,
+    recommendations: buildRecommendations(byType, successRate),
+  };
+}
+function buildRecommendations(byType, successRate) {
+  const recs = [];
+  if (byType.element_not_rendered > 0 || byType.element_not_visible > 0) {
+    recs.push("Use waits explícitos (waitForSelector, waitForDisplayed) antes de interagir com elementos.");
+  }
+  if (byType.timing_fix > 0 || byType.element_stale > 0) {
+    recs.push("Aumente timeouts e use re-localização de elementos em listas dinâmicas.");
+  }
+  if (byType.selector_fix > 0 || byType.mobile_mapping_invisible > 0) {
+    recs.push("Priorize data-testid, role e seletores estáveis; em mobile, use mapeamento visível.");
+  }
+  if (successRate < 70) {
+    recs.push("Taxa de sucesso baixa: aplique waits inteligentes + assert final em cada teste.");
+  }
+  if (recs.length === 0) {
+    recs.push("Continue gerando testes. O agente está evoluindo bem.");
+  }
+  return recs;
+}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "mcp-lab-agent",
-  "version": "2.1.3",
-  "description": "Autonomous QA agent: executor + intelligent consultant - analyzes, predicts, recommends and learns (modular)",
+  "version": "2.1.6",
+  "description": "Sistema de Inteligência em Qualidade de Software: executa, analisa, prevê, recomenda e aprende. Memória local + Learning Hub.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist",
+    "learning-hub",
     "slack-bot",
     "qa-lab-agent.config.json",
     "qa-lab-flows.json.example"
@@ -17,6 +18,8 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "slack-bot": "node slack-bot/src/index.js",
+    "slack-bot:check": "node slack-bot/check-config.js",
+    "learning-hub": "node learning-hub/src/server.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
@@ -42,7 +45,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Wesley-Gomes93/mcp-lab-agent"
+    "url": "git+https://github.com/Wesley-Gomes93/mcp-lab-agent.git"
   },
   "author": "Wesley Gomes",
   "license": "MIT",
@@ -51,6 +54,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@slack/bolt": "^3.21.0",
     "dotenv": "^16.4.5",
     "zod": "^3.25.0"
   },

package/slack-bot/.env.example CHANGED Viewed

@@ -1,6 +1,18 @@
-# === OBRIGATÓRIO (pegue em api.slack.com/apps) ===
+# === CREDENCIAIS (api.slack.com/apps → sua app) ===
+# Doc: https://docs.slack.dev/app-management/quickstart-app-settings
+# OBRIGATÓRIO: Bot User OAuth Token
+# Onde: OAuth & Permissions → OAuth Tokens → Bot User OAuth Token
 SLACK_BOT_TOKEN=xoxb-...
-SLACK_SIGNING_SECRET=...
+# Escolha UM modo:
+# A) Socket Mode — recomendado (PC corporativo, sem URL pública)
+#    Onde: Basic Information → App-Level Tokens → Generate (scope: connections:write)
+SLACK_APP_TOKEN=xapp-...
+# B) HTTP — precisa de ngrok
+#    Onde: Basic Information → App Credentials → Signing Secret (Show)
+# SLACK_SIGNING_SECRET=...
 # === REPO (se não configurou no qa-lab-agent.config.json) ===
 # REPO_URL=https://github.com/sua-empresa/projeto.git
@@ -8,3 +20,6 @@ SLACK_SIGNING_SECRET=...
 # === LLM (opcional - só para "crie testes") ===
 # GROQ_API_KEY=...
+# === AVANÇADO: caminho customizado do .env ===
+# QA_LAB_ENV=/caminho/para/.env

package/slack-bot/CREDENTIALS.md ADDED Viewed

@@ -0,0 +1,23 @@
+# Credenciais — QA Lab Slack Bot
+Referência rápida de onde obter cada credencial em [api.slack.com/apps](https://api.slack.com/apps).
+Baseado em [Creating an app from app settings](https://docs.slack.dev/app-management/quickstart-app-settings).
+## Tabela de credenciais
+| Credencial      | Chave no mcp.json | Chave no .env              | Onde obter em api.slack.com |
+|-----------------|-------------------|---------------------------|-----------------------------|
+| Bot User OAuth   | `botToken`        | `SLACK_BOT_TOKEN`         | OAuth & Permissions → OAuth Tokens → Bot User OAuth Token |
+| App-Level Token | `appToken`        | `SLACK_APP_TOKEN`         | Basic Information → App-Level Tokens → Generate (scope: `connections:write`) |
+| Signing Secret   | `signingSecret`   | `SLACK_SIGNING_SECRET`    | Basic Information → App Credentials → Signing Secret (Show) |
+## Formato dos tokens
+- **Bot Token:** começa com `xoxb-` (não use Client Secret nem User Token)
+- **App Token:** começa com `xapp-` (só para Socket Mode)
+- **Signing Secret:** string longa (HTTP mode)
+## Segurança
+Mantenha as credenciais em segredo. Use variáveis de ambiente ou `~/.cursor/mcp.json` fora do versionamento.

package/slack-bot/README.md CHANGED Viewed

@@ -2,31 +2,100 @@
 Bot Slack que analisa projetos e gera testes via **mcp-lab-agent**.
-## Configuração (3 passos)
+**Funciona em qualquer ambiente** — pessoal, corporativo, com ou sem firewall. Configure uma vez e rode em qualquer máquina.
-### 1. Crie o bot no Slack
+| Ambiente        | Modo recomendado | URL pública?     |
+|-----------------|------------------|------------------|
+| PC corporativo  | Socket Mode      | Não precisa      |
+| PC pessoal      | Socket ou HTTP   | Só se usar HTTP  |
+| CI / servidor   | Socket ou HTTP   | Conforme rede    |
-1. [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From scratch**
-2. **OAuth & Permissions** → Scopes: `app_mentions:read`, `chat:write`, `channels:history`, `channels:read`
-3. **Event Subscriptions** → Enable → URL: `https://SEU_DOMINIO/slack/events` → event: `app_mention`
-4. **Install to Workspace** → copie o token (`xoxb-...`)
-5. **Basic Information** → copie o **Signing Secret**
-### 2. Configure o .env
+## Rodar sem clonar o projeto
 ```bash
-cd slack-bot
-cp .env.example .env
+npx mcp-lab-agent slack-bot
 ```
-Edite `.env` e preencha:
+Não precisa baixar o repo — o comando instala e executa o bot. Configure `~/.cursor/mcp.json` (ver seção abaixo).
+## Configuração
+Seguindo [Creating an app from app settings](https://docs.slack.dev/app-management/quickstart-app-settings):
+### 1. Criar o app no Slack
+1. [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From scratch**
+2. **App Name** e **Workspace** → **Create App**
+### 2. Solicitar scopes (OAuth & Permissions)
+1. **OAuth & Permissions** → **Scopes** → **Bot Token Scopes** → **Add an OAuth Scope**
+2. Adicione:
+   - `app_mentions:read` — necessário para o evento `app_mention`
+   - `chat:write` — enviar mensagens
+   - `channels:read` — listar canais
+   - `channels:history` — ler histórico (para análise)
+### 3. Instalar e autorizar o app
+1. **OAuth & Permissions** → **Install to Workspace** → **Allow**
+2. Copie o **Bot User OAuth Token** (`xoxb-...`) em **OAuth Tokens**
+3. No canal desejado, digite: `/invite @NomeDoBot` — o bot precisa estar no canal para receber menções
+### 4. Configurar eventos (Event Subscriptions)
+1. **Event Subscriptions** → **Enable Events** → ON
+2. **Subscribe to bot events** → **Add Bot User Event** → `app_mention`
+3. Se alterou scopes/eventos: **Install App** → **Reinstall to Workspace**
+### 5. Escolher modo: Socket ou HTTP
+**A) Socket Mode** (recomendado — PC corporativo, sem URL pública):
+1. **Socket Mode** → **Enable Socket Mode** → ON
+2. **Basic Information** → **App-Level Tokens** → **Generate** → scope: `connections:write`
+3. Copie o token (`xapp-...`)
+**B) HTTP** (ngrok):
+1. **Event Subscriptions** → **Request URL**: `https://SEU_DOMINIO/slack/events`
+2. **Basic Information** → **App Credentials** → **Signing Secret** (Show)
+### 6. Configurar credenciais localmente
+**Socket Mode** — em `~/.cursor/mcp.json` ou `.env`:
+```json
+{
+  "qa-lab-agent": {
+    "slack": {
+      "botToken": "xoxb-...",
+      "appToken": "xapp-...",
+      "useLocal": true
+    }
+  }
+}
 ```
-SLACK_BOT_TOKEN=xoxb-seu-token
-SLACK_SIGNING_SECRET=seu-secret
-```
-### 3. Configure o repositório
+| Credencial   | Onde obter em api.slack.com |
+|-------------|-----------------------------|
+| `botToken`  | OAuth & Permissions → OAuth Tokens → Bot User OAuth Token |
+| `appToken`  | Basic Information → App-Level Tokens (scope: connections:write) |
+> Detalhes: [CREDENTIALS.md](./CREDENTIALS.md)
+**HTTP** — para ngrok:
+| Credencial      | Onde obter em api.slack.com |
+|-----------------|-----------------------------|
+| `botToken`      | OAuth & Permissions → OAuth Tokens → Bot User OAuth Token |
+| `signingSecret` | Basic Information → App Credentials → Signing Secret |
+**Via `.env`:** `SLACK_BOT_TOKEN`, `SLACK_APP_TOKEN` (Socket) ou `SLACK_SIGNING_SECRET` (HTTP). O `.env` pode ficar em `slack-bot/` ou na pasta atual.
+> **Importante:** Mantenha as credenciais em segredo. Use variáveis de ambiente ou `mcp.json` (fora do versionamento).
+### 7. Configure o repositório
 **Opção A** — No `qa-lab-agent.config.json` (raiz do projeto):
@@ -64,3 +133,5 @@ Local com ngrok: `ngrok http 3000` e use a URL em Event Subscriptions.
 @QA Lab Bot analise o projeto
 @QA Lab Bot crie testes para login
 ```
+**Bot não responde?** Veja [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) — em geral: `/invite @NomeDoBot` no canal e conferir **Subscribe to bot events** → `app_mention`.