komplian 0.7.0 → 0.7.2

package/README.md

@@ -26,7 +26,7 @@ Opcional: `export POSTMAN_API_KEY=…` solo para la sesión actual (tiene priori
 
 El comando llama a `GET https://api.getpostman.com/me` y **solo continúa** si el email de la cuenta es `@komplian.com`. **Si ya existen** la colección **Komplian API** y los entornos con el mismo nombre en ese workspace, se **actualizan**; si no, se crean.
 
-**Variables de la API Komplian** (`apiKey`, `adminApiKey`, `workspaceId`, …) se rellenan en Postman automáticamente si están en `process.env` o en archivos `.env` (busca `api/.env`, `.env`, etc.; o `KOMPLIAN_DOTENV` / `--dotenv ruta`). Nombres típicos: `API_KEY`, `ADMIN_API_KEY`, `KOMPLIAN_WORKSPACE_ID`. Los JSON exportados en `./komplian-postman/` **no** incluyen secretos (para no commitearlos).
+**Variables de la API Komplian** (`apiKey`, `adminApiKey`, `workspaceId`, …) se rellenan en Postman automáticamente si están en `process.env` o en archivos `.env` (busca `api/.env`, `.env`, etc.; o `KOMPLIAN_DOTENV` / `--dotenv ruta`). Nombres típicos: `API_KEY`, `ADMIN_API_KEY`, `KOMPLIAN_WORKSPACE_ID`. Los JSON exportados en `~/.komplian/postman-export/` (o `--out`) **no** incluyen secretos (para no commitearlos).
 
 - Solo exportar archivos (sin subir por API): `npx komplian postman --yes --export-only`
 - Otro workspace: `POSTMAN_WORKSPACE_ID=<id>`

package/komplian-db-all-dev.mjs

@@ -42,6 +42,7 @@ const c = {
 };
 
 function log(s = "") {
+  if (process.env.KOMPLIAN_CLI_QUIET === "1") return;
   console.log(s);
 }
 
@@ -148,9 +149,9 @@ function collectUrlsFromEnv() {
 
 async function collectUrlsInteractive(rl) {
   log(`  ${c.dim}postgresql://… desde Neon (rama development) u homólogo.${c.reset}`);
-  const app = (await rl.question(`${c.bold}URL APP${c.reset} (app + API): `)).trim();
-  const admin = (await rl.question(`${c.bold}URL ADMIN${c.reset}: `)).trim();
-  const web = (await rl.question(`${c.bold}URL WEB${c.reset} (pilot): `)).trim();
+  const app = (await rl.question(`${c.bold}APP URL${c.reset} (app + API): `)).trim();
+  const admin = (await rl.question(`${c.bold}ADMIN URL${c.reset}: `)).trim();
+  const web = (await rl.question(`${c.bold}WEB URL${c.reset}: `)).trim();
   return { app, admin, web };
 }
 
@@ -178,15 +179,16 @@ function parseArgs(argv) {
 }
 
 function usage() {
-  log(`Uso: npx komplian db:all:dev [opciones] [monorepo]`);
-  log(``);
-  log(`  Tras ${c.bold}npx komplian postman login${c.reset}: verifica @komplian.com y configura las 3 bases de desarrollo.`);
-  log(`  Guarda en ${c.dim}~/.komplian/dev-databases.json${c.reset} y actualiza ${c.dim}app|api|web|admin/.env.local${c.reset}.`);
-  log(``);
-  log(`  Sin prompts: ${c.dim}KOMPLIAN_DEV_APP_DATABASE_URL${c.reset}, ${c.dim}_ADMIN_${c.reset}, ${c.dim}_WEB_${c.reset} + ${c.bold}--yes${c.reset}`);
-  log(`  ${c.bold}--force${c.reset}     Volver a pedir URLs (o usar env) aunque exista el JSON`);
-  log(`  -w, --workspace  Raíz del monorepo`);
-  log(`  -h, --help`);
+  const p = (s) => console.log(s);
+  p(`Usage: npx komplian db:all:dev [options] [monorepo]`);
+  p(``);
+  p(`  Verifies @komplian.com (Postman) and writes 3 dev DB URLs.`);
+  p(`  Saves ${c.dim}~/.komplian/dev-databases.json${c.reset} and updates app|api|web|admin ${c.dim}.env.local${c.reset}.`);
+  p(``);
+  p(`  Non-interactive: ${c.dim}KOMPLIAN_DEV_*_DATABASE_URL${c.reset} + ${c.bold}--yes${c.reset}`);
+  p(`  ${c.bold}--force${c.reset}     Re-prompt / re-read env even if JSON exists`);
+  p(`  -w, --workspace  Monorepo root`);
+  p(`  -h, --help`);
 }
 
 export async function runDbAllDev(argv) {
@@ -201,11 +203,11 @@ export async function runDbAllDev(argv) {
     : findWorkspaceRoot(process.cwd());
 
   if (!existsSync(join(workspaceRoot, "api", "package.json"))) {
-    log(`${c.red}✗${c.reset} No parece un monorepo Komplian: ${workspaceRoot}`);
+    console.error(`${c.red}✗${c.reset} Not a Komplian monorepo.`);
     process.exit(1);
   }
 
-  log(`${c.cyan}━━ Komplian — bases de datos (development) ━━${c.reset}`);
+  log(`${c.cyan}━━ dev databases ━━${c.reset}`);
   await assertKomplianEmployeePostman();
 
   const fromEnv = collectUrlsFromEnv();
@@ -218,27 +220,25 @@ export async function runDbAllDev(argv) {
 
   if (envOk) {
     data = fromEnv;
-    log(`${c.green}✓${c.reset} URLs desde variables de entorno (KOMPLIAN_DEV_*_DATABASE_URL).`);
+    log(`${c.green}✓${c.reset} URLs from env.`);
   } else if (savedOk && !opts.force && !envOk) {
     data = saved;
-    log(
-      `${c.dim}○${c.reset} Usando ${c.bold}~/.komplian/dev-databases.json${c.reset} (${c.dim}--force${c.reset} para cambiar).`
-    );
+    log(`${c.dim}○${c.reset} Using saved ${c.bold}dev-databases.json${c.reset} (${c.dim}--force${c.reset} to replace).`);
   } else if (opts.yes && !envOk) {
-    log(
-      `${c.red}✗${c.reset} Con ${c.bold}--yes${c.reset} define las tres variables ${c.dim}KOMPLIAN_DEV_APP_DATABASE_URL${c.reset}, ${c.dim}_ADMIN_${c.reset}, ${c.dim}_WEB_${c.reset}, o ejecuta sin ${c.bold}--yes${c.reset} para modo interactivo.`
+    console.error(
+      `${c.red}✗${c.reset} With ${c.bold}--yes${c.reset} set ${c.dim}KOMPLIAN_DEV_*_DATABASE_URL${c.reset} or run without ${c.bold}--yes${c.reset}.`
     );
     process.exit(1);
   } else {
     const rl = createInterface({ input, output });
     log(``);
-    log(`${c.bold}Introduce las connection strings de desarrollo (3).${c.reset}`);
+    log(`${c.bold}Enter 3 development connection strings.${c.reset}`);
     data = await collectUrlsInteractive(rl);
     rl.close();
   }
 
   if (!isValidTriplet(data)) {
-    log(`${c.red}✗${c.reset} Las tres URLs deben ser postgres:// o postgresql:// válidas (sin placeholder).`);
+    console.error(`${c.red}✗${c.reset} All three URLs must be valid postgres:// or postgresql:// (no placeholders).`);
     process.exit(1);
   }
 
@@ -246,11 +246,14 @@ export async function runDbAllDev(argv) {
   propagateToMonorepo(workspaceRoot, data);
 
   log(``);
-  log(`${c.green}✓${c.reset} Guardado ${c.dim}~/.komplian/${DEV_DB_NAME}${c.reset} y .env.local en app, api, web, admin.`);
-  log(`  ${c.dim}APP${c.reset}   ${maskDatabaseUrl(data.app)}`);
-  log(`  ${c.dim}ADMIN${c.reset} ${maskDatabaseUrl(data.admin)}`);
-  log(`  ${c.dim}WEB${c.reset}   ${maskDatabaseUrl(data.web)}`);
-  log(``);
-  log(`${c.dim}Siguiente: ${c.reset}${c.cyan}npx komplian localhost --yes${c.reset}`);
-  log(`${c.dim}psql: ${c.reset}${c.cyan}npx komplian db:app:development${c.reset} …`);
+  if (process.env.KOMPLIAN_CLI_QUIET === "1") {
+    console.log(`${c.green}✓${c.reset} dev databases`);
+  } else {
+    log(`${c.green}✓${c.reset} Saved ${c.dim}~/.komplian/${DEV_DB_NAME}${c.reset} and repo ${c.dim}.env.local${c.reset} files.`);
+    log(`  ${c.dim}APP${c.reset}   ${maskDatabaseUrl(data.app)}`);
+    log(`  ${c.dim}ADMIN${c.reset} ${maskDatabaseUrl(data.admin)}`);
+    log(`  ${c.dim}WEB${c.reset}   ${maskDatabaseUrl(data.web)}`);
+    log(``);
+    log(`${c.dim}Next: ${c.reset}${c.cyan}npx komplian localhost --yes${c.reset}`);
+  }
 }

package/komplian-localhost.mjs

@@ -35,7 +35,16 @@ const c = {
   yellow: "\x1b[33m",
 };
 
+function cliQuiet() {
+  return process.env.KOMPLIAN_CLI_QUIET === "1";
+}
+
 function log(s = "") {
+  if (cliQuiet()) return;
+  console.log(s);
+}
+
+function logAlways(s = "") {
   console.log(s);
 }
 
@@ -292,7 +301,7 @@ function envFromOverridesOnly(overrides) {
 
 function writeAppEnv(root, s, db, opts) {
   const p = join(root, "app", ".env.local");
-  if (existsSync(p) && !opts.force) return { path: p, skipped: true };
+  if (existsSync(p) && !opts.force) return { path: p, skipped: true, label: "app" };
   const examplePath = join(root, "app", ".env.example");
   const overrides = buildAppOverrides(s, db, opts);
   let body;
@@ -302,12 +311,12 @@ function writeAppEnv(root, s, db, opts) {
     body = envFromOverridesOnly(overrides);
   }
   writeAtomic(p, header("app") + body);
-  return { path: p, skipped: false };
+  return { path: p, skipped: false, label: "app" };
 }
 
 function writeApiEnv(root, s, db, opts) {
   const p = join(root, "api", ".env.local");
-  if (existsSync(p) && !opts.force) return { path: p, skipped: true };
+  if (existsSync(p) && !opts.force) return { path: p, skipped: true, label: "api" };
   const examplePath = join(root, "api", ".env.example");
   const overrides = buildApiOverrides(s, db);
   let body;
@@ -317,12 +326,12 @@ function writeApiEnv(root, s, db, opts) {
     body = envFromOverridesOnly(overrides);
   }
   writeAtomic(p, header("api") + body);
-  return { path: p, skipped: false };
+  return { path: p, skipped: false, label: "api" };
 }
 
 function writeWebEnv(root, s, db, opts) {
   const p = join(root, "web", ".env.local");
-  if (existsSync(p) && !opts.force) return { path: p, skipped: true };
+  if (existsSync(p) && !opts.force) return { path: p, skipped: true, label: "web" };
   const examplePath = join(root, "web", ".env.example");
   const overrides = buildWebOverrides(s, db);
   let body;
@@ -332,12 +341,12 @@ function writeWebEnv(root, s, db, opts) {
     body = envFromOverridesOnly(overrides);
   }
   writeAtomic(p, header("web") + body);
-  return { path: p, skipped: false };
+  return { path: p, skipped: false, label: "web" };
 }
 
 function writeAdminEnv(root, s, db, opts) {
   const p = join(root, "admin", ".env.local");
-  if (existsSync(p) && !opts.force) return { path: p, skipped: true };
+  if (existsSync(p) && !opts.force) return { path: p, skipped: true, label: "admin" };
   const examplePath = join(root, "admin", ".env.example");
   const overrides = buildAdminOverrides(s, db);
   let body;
@@ -347,41 +356,47 @@ function writeAdminEnv(root, s, db, opts) {
     body = envFromOverridesOnly(overrides);
   }
   writeAtomic(p, header("admin") + body);
-  return { path: p, skipped: false };
+  return { path: p, skipped: false, label: "admin" };
 }
 
 function writeDocsEnv(root, opts) {
   const p = join(root, "docs", ".env.local");
-  if (existsSync(p) && !opts.force) return { path: p, skipped: true };
+  if (existsSync(p) && !opts.force) return { path: p, skipped: true, label: "docs" };
   const examplePath = join(root, "docs", ".env.example");
   if (!existsSync(examplePath)) {
     writeAtomic(
       p,
       `${header("docs")}# Sin variables obligatorias para next dev.\n`
     );
-    return { path: p, skipped: false };
+    return { path: p, skipped: false, label: "docs" };
   }
   const overrides = buildDocsOverrides();
   let content = readFileSync(examplePath, "utf8");
   content = applyOverridesToEnvContent(content, overrides);
   writeAtomic(p, header("docs") + content);
-  return { path: p, skipped: false };
+  return { path: p, skipped: false, label: "docs" };
 }
 
 function printLocalUrls(minimal) {
+  if (cliQuiet()) {
+    logAlways(
+      `${c.dim}dev ·${c.reset} ${!minimal ? "4000 " : ""}3001${!minimal ? " 3002 3003" : " 3003"} 3004`
+    );
+    return;
+  }
   log("");
-  log(`${c.bold}Local — abre en el navegador${c.reset}`);
+  log(`${c.bold}Local${c.reset}`);
   if (!minimal) {
-    log(`  ${c.cyan}API${c.reset}   http://localhost:4000   ${c.dim}(/health)${c.reset}`);
+    log(`  ${c.cyan}api${c.reset}   http://localhost:4000`);
   }
-  log(`  ${c.cyan}App${c.reset}   http://localhost:3001`);
+  log(`  ${c.cyan}app${c.reset}   http://localhost:3001`);
   if (!minimal) {
-    log(`  ${c.cyan}Admin${c.reset} http://localhost:3002`);
-    log(`  ${c.cyan}Web${c.reset}   http://localhost:3003`);
+    log(`  ${c.cyan}admin${c.reset} http://localhost:3002`);
+    log(`  ${c.cyan}web${c.reset}   http://localhost:3003`);
   } else {
-    log(`  ${c.cyan}Web${c.reset}   http://localhost:3003`);
+    log(`  ${c.cyan}web${c.reset}   http://localhost:3003`);
   }
-  log(`  ${c.cyan}Docs${c.reset}  http://localhost:3004`);
+  log(`  ${c.cyan}docs${c.reset}  http://localhost:3004`);
   log("");
 }
 
@@ -389,7 +404,7 @@ async function confirmOverwrite(yes) {
   if (yes) return true;
   const rl = createInterface({ input, output });
   const ans = await rl.question(
-    `\n${c.bold}Sobrescribir .env.local existentes? [y/N]${c.reset} `
+    `\n${c.bold}Overwrite existing .env.local files? [y/N]${c.reset} `
   );
   rl.close();
   return /^y(es)?$/i.test((ans || "").trim());
@@ -414,7 +429,7 @@ function parseLocalhostArgs(argv) {
     else if (a === "-h" || a === "--help") opts.help = true;
     else if (a === "--workspace" || a === "-w") opts.workspace = argv[++i] || "";
     else if (a.startsWith("-")) {
-      log(`${c.red}✗${c.reset} Opción desconocida: ${a}`);
+      logAlways(`${c.red}✗${c.reset} Unknown option: ${a}`);
       process.exit(1);
     } else rest.push(a);
   }
@@ -423,17 +438,17 @@ function parseLocalhostArgs(argv) {
 }
 
 function usageLocalhost() {
-  log(`Uso: npx komplian localhost [opciones] [carpeta-monorepo]`);
-  log(``);
-  log(`  Genera .env.local completos (desde cada .env.example + secretos KOMPLIAN) y arranca todos los dev servers.`);
-  log(`  ${c.dim}DBs: npx komplian db:all:dev antes (o ~/.komplian/dev-databases.json / variables en sesión).${c.reset}`);
-  log(``);
-  log(`  -y, --yes       Sin confirmación`);
-  log(`  --force         Regenerar .env.local`);
-  log(`  --minimal       Solo app + web + docs`);
-  log(`  --env-only      Solo escribir .env.local`);
-  log(`  -w, --workspace Ruta al monorepo`);
-  log(`  -h, --help`);
+  logAlways(`Usage: npx komplian localhost [options] [monorepo-dir]`);
+  logAlways(``);
+  logAlways(`  Writes .env.local from each .env.example + generated secrets, then runs dev servers.`);
+  logAlways(`  ${c.dim}DBs: run db:all:dev first (or use ~/.komplian/dev-databases.json / env).${c.reset}`);
+  logAlways(``);
+  logAlways(`  -y, --yes       No overwrite prompt`);
+  logAlways(`  --force         Regenerate .env.local`);
+  logAlways(`  --minimal       app + web + docs only`);
+  logAlways(`  --env-only      Write .env.local only`);
+  logAlways(`  -w, --workspace Monorepo root`);
+  logAlways(`  -h, --help`);
 }
 
 function checkNodeModules(root, names) {
@@ -456,7 +471,7 @@ export async function runLocalhost(argv) {
     : findWorkspaceRoot(process.cwd());
 
   if (!existsSync(join(workspaceRoot, "api", "package.json"))) {
-    log(`${c.red}✗${c.reset} No parece un monorepo Komplian (falta api/package.json): ${workspaceRoot}`);
+    logAlways(`${c.red}✗${c.reset} Not a Komplian monorepo (missing api/package.json).`);
     process.exit(1);
   }
 
@@ -481,7 +496,7 @@ export async function runLocalhost(argv) {
   if (hasAnyEnv && !opts.force) {
     const ok = await confirmOverwrite(opts.yes);
     if (!ok) {
-      log(`${c.yellow}○${c.reset} Cancelado. Usa ${c.bold}--force${c.reset} para regenerar.`);
+      logAlways(`${c.yellow}○${c.reset} Cancelled. Use ${c.bold}--force${c.reset} to regenerate.`);
       return;
     }
     opts.force = true;
@@ -501,23 +516,30 @@ export async function runLocalhost(argv) {
   written.push(writeDocsEnv(workspaceRoot, opts));
 
   log("");
-  log(`${c.cyan}━━ .env.local ━━${c.reset} ${c.dim}(600, no se publican en npm)${c.reset}`);
+  if (!cliQuiet()) {
+    log(`${c.cyan}━━ .env.local ━━${c.reset}`);
+  }
   for (const w of written) {
-    const st = w.skipped ? `${c.dim}sin cambios${c.reset}` : `${c.green}ok${c.reset}`;
-    log(`  ${st} ${w.path}`);
+    const st = w.skipped ? `${c.dim}skip${c.reset}` : `${c.green}ok${c.reset}`;
+    const name = w.label || "?";
+    if (cliQuiet()) {
+      logAlways(`  ${st} ${name}`);
+    } else {
+      log(`  ${st} ${name}`);
+    }
   }
 
   printLocalUrls(opts.minimal);
 
   if (!db.hasReal && !opts.minimal) {
-    log(
-      `${c.yellow}⚠${c.reset} Sin URLs de desarrollo reales. Ejecuta ${c.bold}npx komplian db:all:dev${c.reset} y luego vuelve a lanzar localhost (o ${c.bold}--minimal${c.reset}).`
+    logAlways(
+      `${c.yellow}⚠${c.reset} No dev database URLs. Run ${c.bold}npx komplian db:all:dev${c.reset} then localhost again (or ${c.bold}--minimal${c.reset}).`
     );
-    log("");
+    logAlways("");
   }
 
   if (opts.envOnly) {
-    log(`${c.green}✓${c.reset} Entorno listo. Arranca: ${c.bold}npx komplian localhost --yes${c.reset}`);
+    logAlways(`${c.green}✓${c.reset} env files written.`);
     return;
   }
 
@@ -526,9 +548,9 @@ export async function runLocalhost(argv) {
     : ["api", "app", "web", "admin", "docs"];
   const missing = checkNodeModules(workspaceRoot, services);
   if (missing.length) {
-    log("");
-    log(`${c.red}✗${c.reset} Falta node_modules en: ${missing.join(", ")}`);
-    log(`  ${c.dim}Ejecuta npm install en cada carpeta (o npx komplian onboard --yes --install).${c.reset}`);
+    logAlways("");
+    logAlways(`${c.red}✗${c.reset} Missing node_modules: ${missing.join(", ")}`);
+    logAlways(`  ${c.dim}npm install per repo or npx komplian onboard --yes${c.reset}`);
     process.exit(1);
   }
 
@@ -542,19 +564,22 @@ export async function runLocalhost(argv) {
     return `npm run dev --prefix ${dir}`;
   });
 
-  log(`${c.cyan}━━ Arranque (${services.length}) ━━${c.reset} ${c.dim}Ctrl+C detiene todo${c.reset}`);
-  log("");
+  if (cliQuiet()) {
+    logAlways(`${c.cyan}━━ dev servers ━━${c.reset}`);
+  } else {
+    log(`${c.cyan}━━ dev servers (${services.length}) ━━${c.reset} ${c.dim}Ctrl+C stop${c.reset}`);
+    log("");
+  }
 
-  // shell: false — con shell:true Node concatena args para /bin/sh -c y concurrently
-  // recibe un número de comandos/names incoherente → TypeError en logger (prev.replace).
   const npx = process.platform === "win32" ? "npx.cmd" : "npx";
+  const useShell = process.platform === "win32";
   const child = spawn(
     npx,
     ["--yes", "concurrently@9", "-c", colors, "-n", names, ...scripts],
     {
       cwd: workspaceRoot,
       stdio: "inherit",
-      shell: false,
+      shell: useShell,
       windowsHide: true,
       env: { ...process.env },
     }

package/komplian-mcp-tools.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 /**
- * Komplian MCP — escribe `.cursor/mcp.json` con servidores MCP por stdio (prefijo KOMPLIAN-*)
- * y genera `.cursor/KOMPLIAN_MCP_SETUP.md` (plugins de Cursor que no van en JSON).
+ * Komplian MCP — writes `.cursor/mcp.json` with stdio MCP servers (KOMPLIAN-* prefix)
+ * and generates `.cursor/KOMPLIAN_MCP_SETUP.md` (Cursor-only notes not expressible in JSON).
  *
- * No incluye secretos: tokens vacíos; rellena en Cursor o vía KOMPLIAN_MCP_SECRETS.env (local, gitignored).
+ * No secrets in repo: empty env; fill in Cursor or via KOMPLIAN_MCP_SECRETS.env (local, gitignored).
  *
- * Uso: npx komplian mcp-tools --yes
+ * Usage: npx komplian mcp-tools --yes
  */
 
 import { mkdirSync, readFileSync, existsSync, writeFileSync } from "node:fs";
@@ -25,10 +25,11 @@ const c = {
 };
 
 function log(s = "") {
+  if (process.env.KOMPLIAN_CLI_QUIET === "1") return;
   console.log(s);
 }
 
-/** Preset Komplian: solo claves KOMPLIAN-* para no pisar servidores del dev. */
+/** Komplian preset: only KOMPLIAN-* keys so we do not overwrite the dev's own servers. */
 const KOMPLIAN_MCP_PRESET = {
   mcpServers: {
     "KOMPLIAN-github": {
@@ -67,33 +68,33 @@ const KOMPLIAN_MCP_PRESET = {
   },
 };
 
-const SETUP_MD = `# KOMPLIAN — MCP en Cursor
+const SETUP_MD = `# KOMPLIAN — MCP in Cursor
 
-Este archivo lo genera \`npx komplian mcp-tools\`. **No commitees** tokens; \`.cursor/mcp.json\` puede llevar env vacíos que rellenas solo en local.
+Generated by \`npx komplian mcp-tools\`. **Do not commit** tokens; \`.cursor/mcp.json\` may keep empty env you fill only locally.
 
-## 1. Servidores en \`.cursor/mcp.json\` (stdio / npx)
+## 1. Servers in \`.cursor/mcp.json\` (stdio / npx)
 
-Activa cada fila en **Cursor → Settings → MCP** (interruptor). Rellena \`env\` según la tabla.
+Enable each row in **Cursor → Settings → MCP**. Fill \`env\` per the table.
 
-| ID | Paquete | Qué es | Rellena / notas |
-|----|---------|--------|-----------------|
-| **KOMPLIAN-github** | \`@modelcontextprotocol/server-github\` | GitHub API | \`GITHUB_PERSONAL_ACCESS_TOKEN\` (PAT). El paquete npm está deprecado; alternativa: [github/github-mcp-server](https://github.com/github/github-mcp-server). |
-| **KOMPLIAN-atlassian** | \`mcp-atlassian\` | Jira + Confluence (Cloud) | \`ATLASSIAN_EMAIL\` + \`ATLASSIAN_API_TOKEN\` ([crear token](https://id.atlassian.com/manage-profile/security/api-tokens)). \`ATLASSIAN_BASE_URL\` ya apunta a \`https://komplian.atlassian.net\`. Jira proyecto **KAPP**. |
-| **KOMPLIAN-sentry** | \`@sentry/mcp-server\` | Sentry | Primera vez: login en navegador. **Komplian:** org \`komplian\`, \`regionUrl\` \`https://de.sentry.io\`, proyectos \`komplian-api\` / \`komplian-app\`. |
-| **KOMPLIAN-stripe** | \`@stripe/mcp\` | Stripe API | \`STRIPE_SECRET_KEY\` (restricted key / test en dev). [Docs Stripe MCP](https://docs.stripe.com/mcp). |
-| **KOMPLIAN-chrome-devtools** | \`chrome-devtools-mcp\` | Chrome (red, consola, screenshots) | Requiere **Node 20.19+** y Chrome estable. Ver [Chrome DevTools MCP](https://developer.chrome.com/blog/chrome-devtools-mcp). |
+| ID | Package | What | Fill / notes |
+|----|---------|------|--------------|
+| **KOMPLIAN-github** | \`@modelcontextprotocol/server-github\` | GitHub API | \`GITHUB_PERSONAL_ACCESS_TOKEN\` (PAT). npm package is deprecated; alternative: [github/github-mcp-server](https://github.com/github/github-mcp-server). |
+| **KOMPLIAN-atlassian** | \`mcp-atlassian\` | Jira + Confluence (Cloud) | \`ATLASSIAN_EMAIL\` + \`ATLASSIAN_API_TOKEN\` ([create token](https://id.atlassian.com/manage-profile/security/api-tokens)). \`ATLASSIAN_BASE_URL\` is \`https://komplian.atlassian.net\`. Jira project **KAPP**. |
+| **KOMPLIAN-sentry** | \`@sentry/mcp-server\` | Sentry | First time: browser login. **Komplian:** org \`komplian\`, \`regionUrl\` \`https://de.sentry.io\`, projects \`komplian-api\` / \`komplian-app\`. |
+| **KOMPLIAN-stripe** | \`@stripe/mcp\` | Stripe API | \`STRIPE_SECRET_KEY\` (restricted / test in dev). [Stripe MCP docs](https://docs.stripe.com/mcp). |
+| **KOMPLIAN-chrome-devtools** | \`chrome-devtools-mcp\` | Chrome (network, console, screenshots) | Needs **Node 20.19+** and stable Chrome. [Chrome DevTools MCP](https://developer.chrome.com/blog/chrome-devtools-mcp). |
 
-## 2. Opcional: integraciones nativas de Cursor
+## 2. Optional: Cursor native connectors
 
-Si además quieres los conectores de Cursor (OAuth / UI): **Settings → MCP** y busca **Atlassian**, **Sentry**, **Stripe**, **Chrome DevTools** — pueden coexistir con las entradas **KOMPLIAN-***; evita duplicar la misma acción en dos servidores.
+For Cursor OAuth/UI connectors: **Settings → MCP** → **Atlassian**, **Sentry**, **Stripe**, **Chrome DevTools**. They can coexist with **KOMPLIAN-*** entries; avoid duplicating the same capability twice.
 
-## 3. Reinicio
+## 3. Restart
 
-Tras editar \`mcp.json\`, **reinicia Cursor** para cargar MCP.
+After editing \`mcp.json\`, **restart Cursor** to load MCP.
 
-## 4. Referencia interna
+## 4. Internal reference
 
-\`.cursor/rules/mcp-integrations.mdc\` (org Sentry, Stripe, KAPP).
+\`.cursor/rules/mcp-integrations.mdc\` (Sentry org, Stripe, KAPP).
 `;
 
 function findWorkspaceRoot(start) {
@@ -145,7 +146,7 @@ function parseMcpArgs(argv) {
     else if (a === "-h" || a === "--help") opts.help = true;
     else if (a === "--workspace" || a === "-w") opts.workspace = argv[++i] || "";
     else if (a.startsWith("-")) {
-      log(`${c.red}✗${c.reset} Opción desconocida: ${a}`);
+      console.error(`${c.red}✗${c.reset} Unknown option: ${a}`);
       process.exit(1);
     } else rest.push(a);
   }
@@ -154,18 +155,18 @@ function parseMcpArgs(argv) {
 }
 
 function usageMcpTools() {
-  log(`Uso: npx komplian mcp-tools [opciones] [carpeta-monorepo]`);
+  log(`Usage: npx komplian mcp-tools [options] [monorepo-root]`);
   log(``);
-  log(`  Añade servidores MCP KOMPLIAN-* en .cursor/mcp.json (GitHub, Atlassian, Sentry, Stripe, Chrome).`);
-  log(`  y genera .cursor/KOMPLIAN_MCP_SETUP.md.`);
+  log(`  Adds KOMPLIAN-* MCP servers to .cursor/mcp.json (GitHub, Atlassian, Sentry, Stripe, Chrome)`);
+  log(`  and writes .cursor/KOMPLIAN_MCP_SETUP.md.`);
   log(``);
-  log(`  ${c.dim}Secretos: vacíos en JSON; no se publican en el paquete npm komplian.${c.reset}`);
+  log(`  ${c.dim}Secrets stay empty in JSON; the komplian npm package never ships your values.${c.reset}`);
   log(``);
-  log(`  -y, --yes       Sin confirmación`);
-  log(`  --force         Sobreescribe entradas KOMPLIAN-* existentes`);
-  log(`  --dry-run       Imprime JSON sin escribir`);
-  log(`  --global        Fusiona en ~/.cursor/mcp.json (toda la máquina)`);
-  log(`  -w, --workspace Raíz del monorepo (por defecto: cwd)`);
+  log(`  -y, --yes       Non-interactive`);
+  log(`  --force         Overwrite existing KOMPLIAN-* entries`);
+  log(`  --dry-run       Print JSON without writing`);
+  log(`  --global        Merge into ~/.cursor/mcp.json (machine-wide)`);
+  log(`  -w, --workspace Monorepo root (default: cwd)`);
   log(`  -h, --help`);
 }
 
@@ -173,7 +174,7 @@ async function confirmForceOverwrite(yes) {
   if (yes) return true;
   const rl = createInterface({ input, output });
   const ans = await rl.question(
-    `\n${c.bold}¿Sobrescribir entradas KOMPLIAN-* existentes? [y/N]${c.reset} `
+    `\n${c.bold}Overwrite existing KOMPLIAN-* entries? [y/N]${c.reset} `
   );
   rl.close();
   return /^y(es)?$/i.test((ans || "").trim());
@@ -201,7 +202,7 @@ export async function runMcpTools(argv) {
     try {
       existing = JSON.parse(readFileSync(mcpPath, "utf8"));
     } catch {
-      log(`${c.red}✗${c.reset} JSON inválido: ${mcpPath}`);
+      log(`${c.red}✗${c.reset} Invalid JSON: ${mcpPath}`);
       process.exit(1);
     }
   }
@@ -212,7 +213,7 @@ export async function runMcpTools(argv) {
   if (opts.force && hadKomplian && !opts.yes) {
     const ok = await confirmForceOverwrite(opts.yes);
     if (!ok) {
-      log(`${c.yellow}○${c.reset} Cancelado.`);
+      log(`${c.yellow}○${c.reset} Cancelled.`);
       return;
     }
   }
@@ -236,16 +237,20 @@ export async function runMcpTools(argv) {
   }
   writeFileSync(setupPath, SETUP_MD, "utf8");
 
+  if (process.env.KOMPLIAN_CLI_QUIET === "1") {
+    console.log(`${changed ? c.green : c.dim}${changed ? "✓" : "○"}${c.reset} mcp`);
+    return;
+  }
   log("");
   const mcpMark = changed ? `${c.green}✓${c.reset}` : `${c.dim}○${c.reset}`;
-  const mcpNote = changed ? "" : ` ${c.dim}(sin cambios)${c.reset}`;
+  const mcpNote = changed ? "" : ` ${c.dim}(unchanged)${c.reset}`;
   log(`${mcpMark} ${c.bold}mcp.json${c.reset}  ${c.dim}${mcpPath}${c.reset}${mcpNote}`);
   log(`${c.green}✓${c.reset} ${c.bold}KOMPLIAN_MCP_SETUP.md${c.reset}  ${c.dim}${setupPath}${c.reset}`);
   log("");
-  log(`${c.bold}Siguiente${c.reset}`);
-  log(`  1. Rellena tokens vacíos en Cursor (Settings → MCP) o edita ${c.bold}mcp.json${c.reset} en local.`);
-  log(`  2. Activa en Cursor: ${c.dim}Atlassian + Chrome DevTools${c.reset} (ver guía arriba).`);
-  log(`  3. Reinicia Cursor.`);
+  log(`${c.bold}Next${c.reset}`);
+  log(`  1. Fill empty tokens in Cursor (Settings → MCP) or edit ${c.bold}mcp.json${c.reset} locally.`);
+  log(`  2. Enable Atlassian + Chrome DevTools (see guide above).`);
+  log(`  3. Restart Cursor.`);
   log("");
-  log(`${c.dim}Paquete npm komplian solo incluye *.mjs — nunca sube tu mcp.json.${c.reset}`);
+  log(`${c.dim}The komplian npm package only ships *.mjs — it never uploads your mcp.json.${c.reset}`);
 }