mcp-lab-agent 2.1.2 → 2.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-lab-agent",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "Autonomous QA agent: executor + intelligent consultant - analyzes, predicts, recommends and learns (modular)",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,8 @@
     "zod": "^3.25.0"
   },
   "optionalDependencies": {
-    "playwright": "^1.49.0"
+    "playwright": "^1.49.0",
+    "@slack/bolt": "^3.21.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^2.1.0",

package/slack-bot/README.md

@@ -2,6 +2,14 @@
 
 Bot Slack que analisa projetos e gera testes via **mcp-lab-agent**.
 
+## Rodar sem clonar o projeto
+
+```bash
+npx mcp-lab-agent slack-bot
+```
+
+Não precisa baixar o repo — o comando instala e executa o bot. Configure `~/.cursor/mcp.json` (ver seção abaixo).
+
 ## Configuração (3 passos)
 
 ### 1. Crie o bot no Slack
@@ -12,18 +20,26 @@ Bot Slack que analisa projetos e gera testes via **mcp-lab-agent**.
 4. **Install to Workspace** → copie o token (`xoxb-...`)
 5. **Basic Information** → copie o **Signing Secret**
 
-### 2. Configure o .env
+### 2. Configure tokens
 
-```bash
-cd slack-bot
-cp .env.example .env
+**Opção A** — No `~/.cursor/mcp.json` (recomendado):
+
+```json
+{
+  "qa-lab-agent": {
+    "slack": {
+      "botToken": "xoxb-seu-token",
+      "signingSecret": "seu-secret"
+    }
+  }
+}
 ```
 
-Edite `.env` e preencha:
+**Opção B** — Via `.env` (se rodar da pasta slack-bot):
 
-```
-SLACK_BOT_TOKEN=xoxb-seu-token
-SLACK_SIGNING_SECRET=seu-secret
+```bash
+cd slack-bot && cp .env.example .env
+# Edite .env com SLACK_BOT_TOKEN e SLACK_SIGNING_SECRET
 ```
 
 ### 3. Configure o repositório

package/slack-bot/check-config.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Verifica se a config do Slack está correta.
+ * Rode: node check-config.js
+ */
+import { readFileSync, existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const home = process.env.HOME || process.env.USERPROFILE;
+const mcpPath = home ? path.join(home, ".cursor", "mcp.json") : null;
+
+console.log("\n🔧 QA Lab Slack Bot - Diagnóstico\n");
+console.log("1. mcp.json:");
+if (!mcpPath || !existsSync(mcpPath)) {
+  console.log("   ❌ Não encontrado em", mcpPath || "(HOME não definido)");
+  process.exit(1);
+}
+console.log("   ✅ Encontrado:", mcpPath);
+
+let mcp;
+try {
+  mcp = JSON.parse(readFileSync(mcpPath, "utf8"));
+} catch (e) {
+  console.log("   ❌ Erro ao ler JSON:", e.message);
+  process.exit(1);
+}
+
+const slack = mcp?.["qa-lab-agent"]?.slack;
+if (!slack) {
+  console.log("   ❌ Seção 'qa-lab-agent.slack' não encontrada");
+  console.log("   Estrutura esperada:");
+  console.log('   { "qa-lab-agent": { "slack": { "botToken": "xoxb-...", "signingSecret": "..." } } }');
+  process.exit(1);
+}
+console.log("   ✅ Config slack encontrada");
+
+console.log("\n2. botToken:");
+const token = slack.botToken || slack.SLACK_BOT_TOKEN;
+if (!token) {
+  console.log("   ❌ Ausente. Adicione 'botToken' ou 'SLACK_BOT_TOKEN'");
+} else if (!token.startsWith("xoxb-")) {
+  console.log("   ⚠️  Deve começar com 'xoxb-'. Você usou o Client Secret?");
+  console.log("   Use: OAuth & Permissions → Bot User OAuth Token (depois de Install to Workspace)");
+} else {
+  console.log("   ✅ OK (xoxb-...)");
+}
+
+console.log("\n3. signingSecret:");
+const secret = slack.signingSecret || slack.SLACK_SIGNING_SECRET;
+if (!secret) {
+  console.log("   ❌ Ausente. Adicione 'signingSecret'");
+  console.log("   Onde: Basic Information → App Credentials → Signing Secret (Show)");
+} else if (secret === "..." || secret.length < 20) {
+  console.log("   ⚠️  Parece placeholder ou inválido. Use o valor real do Signing Secret.");
+} else {
+  console.log("   ✅ OK");
+}
+
+console.log("\n4. Event Subscriptions (api.slack.com):");
+console.log("   • Request URL deve ser: https://SEU_DOMINIO/slack/events");
+console.log("   • Se local: use ngrok → ngrok http 3000");
+console.log("   • Bot event: app_mention");
+
+console.log("\n5. Bot no canal:");
+console.log("   • Mencione o bot no canal ou use /invite @NomeDoBot");
+
+if (token && secret && token.startsWith("xoxb-")) {
+  console.log("\n✅ Config parece OK. Rode: npm start");
+} else {
+  console.log("\n❌ Corrija os itens acima e tente novamente.");
+}
+console.log("");

package/slack-bot/package.json

@@ -7,7 +7,8 @@
   "scripts": {
     "start": "node src/index.js",
     "dev": "node --watch src/index.js",
-    "setup": "node setup.js"
+    "setup": "node setup.js",
+    "check": "node check-config.js"
   },
   "keywords": ["slack", "qa", "mcp-lab-agent", "testing", "bot"],
   "author": "",

package/slack-bot/src/config.js

@@ -9,37 +9,86 @@ const SLACK_BOT_DIR = path.dirname(__dirname);
 
 config({ path: path.join(SLACK_BOT_DIR, ".env") });
 
-function loadSlackConfig() {
-  const configPath = process.env.QA_LAB_CONFIG || path.join(ROOT, "qa-lab-agent.config.json");
-  if (!existsSync(configPath)) {
-    return null;
-  }
+function getMcpJsonPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (!home) return null;
+  return path.join(home, ".cursor", "mcp.json");
+}
+
+function loadMcpConfig() {
+  const mcpPath = process.env.QA_LAB_MCP_CONFIG || getMcpJsonPath();
+  if (!mcpPath || !existsSync(mcpPath)) return null;
   try {
-    const data = JSON.parse(readFileSync(configPath, "utf8"));
-    return data.slack || data;
+    return JSON.parse(readFileSync(mcpPath, "utf8"));
   } catch {
     return null;
   }
 }
 
+function getSlackConfigFromMcp() {
+  const mcp = loadMcpConfig();
+  const qa = mcp?.["qa-lab-agent"];
+  const slack = qa?.slack;
+  if (!slack) return null;
+  return {
+    id: slack.id || slack.channelId,
+    botToken: slack.botToken || slack.SLACK_BOT_TOKEN,
+    signingSecret: slack.signingSecret || slack.SLACK_SIGNING_SECRET,
+    repo: slack.repo || slack.REPO_URL,
+    branch: slack.branch || slack.REPO_BRANCH || "main",
+    useLocal: !!slack.useLocal,
+    workDir: slack.workDir,
+  };
+}
+
+function loadSlackConfig() {
+  const configPath = process.env.QA_LAB_CONFIG || path.join(ROOT, "qa-lab-agent.config.json");
+  if (existsSync(configPath)) {
+    try {
+      const data = JSON.parse(readFileSync(configPath, "utf8"));
+      return data.slack || data;
+    } catch {}
+  }
+  return null;
+}
+
+function getSlackTokens() {
+  const fromMcp = getSlackConfigFromMcp();
+  if (fromMcp?.botToken && fromMcp?.signingSecret) {
+    return { token: fromMcp.botToken, signingSecret: fromMcp.signingSecret };
+  }
+  return {
+    token: process.env.SLACK_BOT_TOKEN,
+    signingSecret: process.env.SLACK_SIGNING_SECRET,
+  };
+}
+
 function getRepoForChannel() {
+  const fromMcp = getSlackConfigFromMcp();
+  if (fromMcp?.useLocal) {
+    const workDir = fromMcp.workDir || process.env.WORK_DIR || process.cwd();
+    return { useLocal: true, workDir };
+  }
+  if (fromMcp?.repo) {
+    return { url: fromMcp.repo, branch: fromMcp.branch || "main" };
+  }
   const repoUrl = process.env.REPO_URL;
-  const repoBranch = process.env.REPO_BRANCH || "main";
   if (repoUrl) {
-    return { url: repoUrl, branch: repoBranch };
+    return { url: repoUrl, branch: process.env.REPO_BRANCH || "main" };
   }
   const cfg = loadSlackConfig();
   const repo = cfg?.repo || cfg?.defaultRepo?.url;
   const branch = cfg?.branch || cfg?.defaultRepo?.branch || "main";
   if (!repo) {
-    throw new Error("Configure REPO_URL no .env ou 'repo' no qa-lab-agent.config.json");
+    return { useLocal: true, workDir: process.env.WORK_DIR || process.cwd() };
   }
   return { url: repo, branch };
 }
 
 function getMcpLabAgentCmd() {
+  const fromMcp = loadMcpConfig()?.["qa-lab-agent"]?.mcpLabAgent;
   const cfg = loadSlackConfig();
-  const mcp = cfg?.mcpLabAgent || { command: "npx", args: ["-y", "mcp-lab-agent@latest"] };
+  const mcp = fromMcp || cfg?.mcpLabAgent || { command: "npx", args: ["-y", "mcp-lab-agent@latest"] };
   return { command: mcp.command, args: mcp.args || [] };
 }
 
@@ -47,4 +96,11 @@ function getCloneBaseDir() {
   return process.env.CLONE_BASE_DIR || path.join(process.cwd(), ".qa-lab-clones");
 }
 
-export { loadSlackConfig, getRepoForChannel, getMcpLabAgentCmd, getCloneBaseDir };
+export {
+  loadSlackConfig,
+  getRepoForChannel,
+  getMcpLabAgentCmd,
+  getCloneBaseDir,
+  getSlackConfigFromMcp,
+  getSlackTokens,
+};

package/slack-bot/src/index.js

@@ -3,23 +3,16 @@
  * QA Lab Slack Bot
  * Recebe @mentions no Slack, executa mcp-lab-agent e posta relatório.
  *
- * Config: qa-lab-agent.config.json (slack section)
- * Secrets: .env (SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET)
+ * Config: ~/.cursor/mcp.json (qa-lab-agent.slack) ou .env
  */
 import { App } from "@slack/bolt";
-import { config } from "dotenv";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { getSlackTokens } from "./config.js";
 import { registerAppMention } from "./handlers/app-mention.js";
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-config({ path: path.join(__dirname, "..", ".env") });
-
-const token = process.env.SLACK_BOT_TOKEN;
-const signingSecret = process.env.SLACK_SIGNING_SECRET;
+const { token, signingSecret } = getSlackTokens();
 
 if (!token || !signingSecret) {
-  console.error("Configure SLACK_BOT_TOKEN e SLACK_SIGNING_SECRET no .env");
+  console.error("Configure no ~/.cursor/mcp.json:\n  \"qa-lab-agent\": { \"slack\": { \"botToken\": \"xoxb-...\", \"signingSecret\": \"...\" } }\n\nOu use .env (SLACK_BOT_TOKEN, SLACK_SIGNING_SECRET)");
   process.exit(1);
 }
 

package/slack-bot/src/workers/qa-job.js

@@ -70,12 +70,17 @@ export async function runQaJob({ channelId, userMessage }) {
 
   const outputs = [];
   let lastError = null;
+  let cwd = workDir;
 
-  try {
-    await ensureRepo(repo.url, repo.branch, workDir);
-  } catch (err) {
-    lastError = `Erro ao clonar repositório: ${err.message}`;
-    return { ok: false, output: lastError, error: err.message };
+  if (repo.useLocal) {
+    cwd = repo.workDir;
+  } else {
+    try {
+      await ensureRepo(repo.url, repo.branch, workDir);
+    } catch (err) {
+      lastError = `Erro ao clonar repositório: ${err.message}`;
+      return { ok: false, output: lastError, error: err.message };
+    }
   }
 
   const intent = parseUserIntent(userMessage);
@@ -83,7 +88,7 @@ export async function runQaJob({ channelId, userMessage }) {
   try {
     if (intent.runAuto) {
       const autoArgs = [...args, "auto", intent.autoDescription];
-      const res = await runCommand(command, autoArgs, workDir);
+      const res = await runCommand(command, autoArgs, cwd);
       outputs.push("=== mcp-lab-agent auto ===\n" + res.stdout);
       if (res.stderr) outputs.push(res.stderr);
       if (res.code !== 0) {
@@ -93,7 +98,7 @@ export async function runQaJob({ channelId, userMessage }) {
 
     if (intent.runAnalyze) {
       const analyzeArgs = [...args, "analyze"];
-      const res = await runCommand(command, analyzeArgs, workDir);
+      const res = await runCommand(command, analyzeArgs, cwd);
       outputs.push("=== mcp-lab-agent analyze ===\n" + res.stdout);
       if (res.stderr) outputs.push(res.stderr);
     }
@@ -101,9 +106,11 @@ export async function runQaJob({ channelId, userMessage }) {
     lastError = err.message;
     outputs.push(`Erro: ${err.message}`);
   } finally {
-    try {
-      if (fs.existsSync(workDir)) fs.rmSync(workDir, { recursive: true });
-    } catch {}
+    if (!repo.useLocal) {
+      try {
+        if (fs.existsSync(workDir)) fs.rmSync(workDir, { recursive: true });
+      } catch {}
+    }
   }
 
   const output = outputs.join("\n\n").trim() || lastError || "Nenhum output.";