komplian 0.4.6 → 0.4.7

package/komplian-mcp-tools.mjs

@@ -0,0 +1,238 @@
+#!/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).
+ *
+ * No incluye secretos: tokens vacíos; rellena en Cursor o vía KOMPLIAN_MCP_SECRETS.env (local, gitignored).
+ *
+ * Uso: npx komplian mcp-tools --yes
+ */
+
+import { mkdirSync, readFileSync, existsSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+
+const c = {
+  reset: "\x1b[0m",
+  dim: "\x1b[2m",
+  bold: "\x1b[1m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  red: "\x1b[31m",
+  yellow: "\x1b[33m",
+};
+
+function log(s = "") {
+  console.log(s);
+}
+
+/** Preset Komplian: solo claves KOMPLIAN-* para no pisar servidores del dev. */
+const KOMPLIAN_MCP_PRESET = {
+  mcpServers: {
+    "KOMPLIAN-github": {
+      command: "npx",
+      args: ["-y", "@modelcontextprotocol/server-github"],
+      env: {
+        GITHUB_PERSONAL_ACCESS_TOKEN: "",
+      },
+    },
+    "KOMPLIAN-sentry": {
+      command: "npx",
+      args: ["-y", "@sentry/mcp-server@latest"],
+      env: {},
+    },
+    "KOMPLIAN-stripe": {
+      command: "npx",
+      args: ["-y", "@stripe/mcp"],
+      env: {
+        STRIPE_SECRET_KEY: "",
+      },
+    },
+  },
+};
+
+const SETUP_MD = `# KOMPLIAN — MCP en 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.
+
+## 1. Servidores en \`.cursor/mcp.json\` (stdio / npx)
+
+| ID | Qué es | Rellena |
+|----|--------|---------|
+| **KOMPLIAN-github** | GitHub API (issues, PRs) | \`GITHUB_PERSONAL_ACCESS_TOKEN\` en el bloque \`env\` del servidor (PAT con scopes repo/workflow según necesidad). El paquete npm está deprecado a favor del servidor oficial; si falla, sustituye por la config que indique [github/github-mcp-server](https://github.com/github/github-mcp-server). |
+| **KOMPLIAN-sentry** | Sentry (issues, trazas) | Primera vez: login por navegador (device code). **Komplian:** \`organizationSlug\` = \`komplian\`, \`regionUrl\` = \`https://de.sentry.io\`. Proyectos: \`komplian-api\`, \`komplian-app\`. |
+| **KOMPLIAN-stripe** | Stripe API | \`STRIPE_SECRET_KEY\` en \`env\` (mejor **Restricted key** / test en dev). Modo test vs live según [docs Stripe MCP](https://docs.stripe.com/mcp). |
+
+## 2. Solo en Cursor (plugins / integraciones)
+
+Estos **no** se instalan con npx en este JSON; actívalos en **Cursor → Settings → MCP** (o integraciones) e inicia sesión:
+
+| Integración | Uso en Komplian |
+|-------------|-----------------|
+| **Atlassian** (Jira + Confluence) | Site \`komplian.atlassian.net\`, proyecto Jira **KAPP**. Plugin \`plugin-atlassian-atlassian\` / \`user-mcp-atlassian\`. |
+| **Chrome DevTools** | Depuración del navegador (\`user-chrome-devtools\`). |
+
+## 3. Reinicio
+
+Tras editar \`mcp.json\`, **reinicia Cursor** (o recarga ventana) para cargar MCP.
+
+## 4. Referencia interna
+
+Ver \`.cursor/rules/mcp-integrations.mdc\` en el monorepo (org Sentry, Stripe, reglas KAPP).
+`;
+
+function findWorkspaceRoot(start) {
+  let dir = resolve(start);
+  for (let i = 0; i < 8; i++) {
+    if (
+      existsSync(join(dir, "api", "package.json")) &&
+      existsSync(join(dir, "app", "package.json"))
+    ) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return resolve(start);
+}
+
+function mergeKomplianPreset(existing, preset, force) {
+  const base =
+    existing && typeof existing === "object" ? structuredClone(existing) : {};
+  if (!base.mcpServers || typeof base.mcpServers !== "object") {
+    base.mcpServers = {};
+  }
+  for (const [name, cfg] of Object.entries(preset.mcpServers)) {
+    if (!name.startsWith("KOMPLIAN-")) continue;
+    if (!force && base.mcpServers[name]) continue;
+    base.mcpServers[name] = structuredClone(cfg);
+  }
+  return base;
+}
+
+function parseMcpArgs(argv) {
+  const opts = {
+    yes: false,
+    force: false,
+    dryRun: false,
+    global: false,
+    help: false,
+    workspace: "",
+  };
+  const rest = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--yes" || a === "-y") opts.yes = true;
+    else if (a === "--force") opts.force = true;
+    else if (a === "--dry-run") opts.dryRun = true;
+    else if (a === "--global") opts.global = true;
+    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}`);
+      process.exit(1);
+    } else rest.push(a);
+  }
+  if (rest[0]) opts.workspace = rest[0];
+  return opts;
+}
+
+function usageMcpTools() {
+  log(`Uso: npx komplian mcp-tools [opciones] [carpeta-monorepo]`);
+  log(``);
+  log(`  Añade servidores MCP KOMPLIAN-* en .cursor/mcp.json (GitHub, Sentry, Stripe)`);
+  log(`  y genera .cursor/KOMPLIAN_MCP_SETUP.md (Atlassian + Chrome DevTools = solo Cursor).`);
+  log(``);
+  log(`  ${c.dim}Secretos: vacíos en JSON; no se publican en el paquete npm komplian.${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(`  -h, --help`);
+}
+
+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} `
+  );
+  rl.close();
+  return /^y(es)?$/i.test((ans || "").trim());
+}
+
+export async function runMcpTools(argv) {
+  const opts = parseMcpArgs(argv);
+  if (opts.help) {
+    usageMcpTools();
+    return;
+  }
+
+  const workspaceRoot = opts.workspace.trim()
+    ? resolve(opts.workspace.replace(/^~(?=$|[/\\])/, homedir()))
+    : findWorkspaceRoot(process.cwd());
+
+  const cursorDir = opts.global
+    ? join(homedir(), ".cursor")
+    : join(workspaceRoot, ".cursor");
+  const mcpPath = join(cursorDir, "mcp.json");
+  const setupPath = join(cursorDir, "KOMPLIAN_MCP_SETUP.md");
+
+  let existing = {};
+  if (existsSync(mcpPath)) {
+    try {
+      existing = JSON.parse(readFileSync(mcpPath, "utf8"));
+    } catch {
+      log(`${c.red}✗${c.reset} JSON inválido: ${mcpPath}`);
+      process.exit(1);
+    }
+  }
+
+  const hadKomplian = Object.keys(existing.mcpServers || {}).some((k) =>
+    k.startsWith("KOMPLIAN-")
+  );
+  if (opts.force && hadKomplian && !opts.yes) {
+    const ok = await confirmForceOverwrite(opts.yes);
+    if (!ok) {
+      log(`${c.yellow}○${c.reset} Cancelado.`);
+      return;
+    }
+  }
+
+  const merged = mergeKomplianPreset(existing, KOMPLIAN_MCP_PRESET, opts.force);
+  const json = JSON.stringify(merged, null, 2);
+
+  if (opts.dryRun) {
+    log(`${c.cyan}━━ dry-run ━━${c.reset} ${mcpPath}`);
+    log(json);
+    log("");
+    log(SETUP_MD);
+    return;
+  }
+
+  mkdirSync(cursorDir, { recursive: true });
+  const prevStr = existsSync(mcpPath) ? readFileSync(mcpPath, "utf8") : "";
+  const changed = prevStr.trim() !== json.trim();
+  if (changed) {
+    writeFileSync(mcpPath, json + "\n", "utf8");
+  }
+  writeFileSync(setupPath, SETUP_MD, "utf8");
+
+  log("");
+  const mcpMark = changed ? `${c.green}✓${c.reset}` : `${c.dim}○${c.reset}`;
+  const mcpNote = changed ? "" : ` ${c.dim}(sin cambios)${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("");
+  log(`${c.dim}Paquete npm komplian solo incluye *.mjs — nunca sube tu mcp.json.${c.reset}`);
+}

package/komplian-onboard.mjs

@@ -394,11 +394,12 @@ function npmInstallEach(workspace) {
 }
 
 function usage() {
-  log(`Uso: komplian onboard [opciones] [carpeta]  |  komplian postman [opciones]  |  komplian localhost [opciones]`);
+  log(`Uso: komplian onboard | postman | localhost | mcp-tools [opciones]`);
   log(`  npx komplian onboard --yes`);
   log(`  npx komplian postman login   ${c.dim}(una vez · guarda API key)${c.reset}`);
   log(`  npx komplian postman --yes    ${c.dim}(email @komplian.com)${c.reset}`);
   log(`  npx komplian localhost --yes  ${c.dim}(env local + api app web admin docs)${c.reset}`);
+  log(`  npx komplian mcp-tools --yes  ${c.dim}(.cursor/mcp.json + guía MCP Komplian)${c.reset}`);
   log(``);
   log(`  Antes (una vez): gh auth login -h github.com -s repo -s read:org -w`);
   log(`  Requisitos: Node 18+, git, GitHub CLI (gh)`);
@@ -492,6 +493,11 @@ async function main() {
     await runLocalhost(rawArgv.slice(1));
     return;
   }
+  if (rawArgv[0] === "mcp-tools") {
+    const { runMcpTools } = await import("./komplian-mcp-tools.mjs");
+    await runMcpTools(rawArgv.slice(1));
+    return;
+  }
 
   const configPath = join(__dirname, "komplian-team-repos.json");
   const { argv, fromOnboardSubcommand } = normalizeArgv(rawArgv);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "komplian",
-  "version": "0.4.6",
-  "description": "Komplian CLI: clone repos (onboard), Postman sync, localhost (.env.local + dev servers). Node 18+. No env files in the published package.",
+  "version": "0.4.7",
+  "description": "Komplian CLI: onboard, Postman, localhost, mcp-tools (Cursor MCP). Node 18+. Published tarball has no .env / secrets.",
   "type": "module",
   "engines": {
     "node": ">=18"
@@ -13,6 +13,7 @@
     "komplian-onboard.mjs",
     "komplian-postman.mjs",
     "komplian-localhost.mjs",
+    "komplian-mcp-tools.mjs",
     "komplian-team-repos.json",
     "README.md"
   ],
@@ -20,7 +21,7 @@
     "access": "public"
   },
   "scripts": {
-    "prepublishOnly": "node --check komplian-onboard.mjs && node --check komplian-postman.mjs && node --check komplian-localhost.mjs"
+    "prepublishOnly": "node --check komplian-onboard.mjs && node --check komplian-postman.mjs && node --check komplian-localhost.mjs && node --check komplian-mcp-tools.mjs"
   },
   "keywords": [
     "komplian",