@holdyapp/install 0.5.0 → 0.6.0

package/README.md

@@ -8,7 +8,7 @@ CLI de instalação do Holdy SDK. Detecta seu framework e wira o SDK em 1 passo.
 npx @holdyapp/install
 ```
 
-Abre o navegador pra você entrar na Holdy (ou criar a conta), conferir o código e autorizar. A chave chega sozinha no terminal, sem copiar nada. Com `--instrument`, a Holdy também lê seu código e propõe os eventos do produto, usando uma chave secreta que vale 1 hora.
+Abre o navegador pra você entrar na Holdy (ou criar a conta), conferir o código e autorizar. A chave chega sozinha no terminal, sem copiar nada. O instalador coloca o SDK no lugar certo, liga o MCP da Holdy no Claude Code e no Cursor se você quiser, e no fim espera o primeiro evento do seu app chegar. Com `--instrument`, a Holdy também lê seu código e propõe os eventos do produto.
 
 Prefere colar a chave?
 
@@ -23,6 +23,8 @@ npx @holdyapp/install --paste-key
 npx @holdyapp/install <apiKey> [opções]
 
   --instrument          Lê o código e propõe os eventos do produto
+  --mcp / --no-mcp      Liga (ou não) a Holdy no Claude Code e no Cursor sem perguntar
+  --wait / --no-wait    Espera (ou não) o primeiro evento no fim
   --paste-key           Pede a chave no terminal em vez de abrir o navegador
   --account <id>        Account ID padrão pro Holdy.init
   --no-auto-capture     Desabilita captura automática de page views

package/dist/cli.js

@@ -2,9 +2,8 @@
 "use strict";
 
 // src/cli.ts
-var import_node_fs5 = require("node:fs");
-var import_node_readline2 = require("node:readline");
-var import_node_path5 = require("node:path");
+var import_node_fs6 = require("node:fs");
+var import_node_path6 = require("node:path");
 
 // src/detect.ts
 var import_node_fs = require("node:fs");
@@ -158,7 +157,7 @@ function injectNextApp(file, opts) {
     };
   }
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} + criado ${displayPath(scriptPath)}` };
+  return { ok: true, modified: true, file, message: `Ligado em ${displayPath(file)} + criado ${displayPath(scriptPath)}` };
 }
 function buildHoldyScriptComponent(opts) {
   return `'use client'
@@ -238,7 +237,7 @@ function injectNextPages(file, opts) {
   if (typeof window !== 'undefined' && !window.__holdyInit) { initHoldy({ apiKey: '${opts.apiKey}', ${opts.accountId ? `accountKey: '${opts.accountId}', ` : ""}autoCapture: ${opts.autoCapture} }); (window as unknown as { __holdyInit?: boolean }).__holdyInit = true }`
   );
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Ligado em ${displayPath(file)}` };
 }
 function injectViteReact(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -259,7 +258,7 @@ initHoldy({ apiKey: '${opts.apiKey}', ${opts.accountId ? `accountKey: '${opts.ac
 
 ${original}`;
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Ligado em ${displayPath(file)}` };
 }
 function injectViteVue(file, opts) {
   return injectViteReact(file, opts);
@@ -281,7 +280,7 @@ export default defineNuxtPlugin(() => {
 })
 `;
   (0, import_node_fs2.writeFileSync)(file, content);
-  return { ok: true, modified: true, file, message: `Criado ${displayPath(file)} \xB7 rode npm install @holdyapp/sdk` };
+  return { ok: true, modified: true, file, message: `Criado ${displayPath(file)}` };
 }
 function injectRemix(file, opts) {
   if (!file || !(0, import_node_fs2.existsSync)(file)) {
@@ -328,7 +327,7 @@ function injectHtml(file, opts) {
   }
   const patched = original.slice(0, headEnd) + snippet + original.slice(headEnd);
   (0, import_node_fs2.writeFileSync)(file, patched);
-  return { ok: true, modified: true, file, message: `Patched ${displayPath(file)}` };
+  return { ok: true, modified: true, file, message: `Ligado em ${displayPath(file)}` };
 }
 function injectHtmlOrAstro(file, opts) {
   if (!file) {
@@ -739,6 +738,105 @@ function confirm(question) {
 
 // src/login.ts
 var import_node_child_process = require("node:child_process");
+
+// src/ui.ts
+var import_node_readline2 = require("node:readline");
+var isTTY = Boolean(process.stdout.isTTY) && !process.env.CI;
+var color = isTTY && !process.env.NO_COLOR;
+var wrap = (open, close = "\x1B[0m") => (s) => color ? `${open}${s}${close}` : s;
+var bold = wrap("\x1B[1m");
+var dim = wrap("\x1B[2m");
+var cyan = wrap("\x1B[36m");
+var green = wrap("\x1B[32m");
+var yellow = wrap("\x1B[33m");
+var red = wrap("\x1B[31m");
+var coral = wrap("\x1B[38;2;232;107;76m");
+var visible = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+function box(lines) {
+  const width = Math.max(...lines.map((l) => visible(l).length)) + 4;
+  console.log();
+  console.log(dim(`  \u256D${"\u2500".repeat(width)}\u256E`));
+  for (const line of ["", ...lines, ""]) {
+    console.log(`  ${dim("\u2502")}  ${line}${" ".repeat(width - 2 - visible(line).length)}${dim("\u2502")}`);
+  }
+  console.log(dim(`  \u2570${"\u2500".repeat(width)}\u256F`));
+  console.log();
+}
+var LABEL_WIDTH = 9;
+function done(label, msg) {
+  console.log(`  ${green("\u25C7")} ${bold(label.padEnd(LABEL_WIDTH))} ${msg}`);
+}
+function active(label, msg) {
+  console.log(`  ${coral("\u25C6")} ${bold(label.padEnd(LABEL_WIDTH))} ${msg}`);
+}
+function note(msg) {
+  console.log(`  ${dim("\u2502")} ${" ".repeat(LABEL_WIDTH)} ${msg}`);
+}
+function fail(label, msg) {
+  console.log(`  ${red("\u25A0")} ${bold(label.padEnd(LABEL_WIDTH))} ${msg}`);
+}
+function rule() {
+  console.log();
+  console.log(dim(`  ${"\u2500".repeat(52)}`));
+  console.log();
+}
+var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function spinner(text) {
+  if (!isTTY) {
+    console.log(`  ${dim("\u2026")} ${text}`);
+    return { update: () => void 0, stop: () => void 0 };
+  }
+  let i = 0;
+  let current = text;
+  const draw = () => process.stdout.write(`\r\x1B[2K  ${coral(FRAMES[i++ % FRAMES.length])} ${current}`);
+  draw();
+  const timer = setInterval(draw, 80);
+  return {
+    update(next) {
+      current = next;
+    },
+    stop() {
+      clearInterval(timer);
+      process.stdout.write("\r\x1B[2K");
+    }
+  };
+}
+function confirm2(question, fallback) {
+  if (!isTTY || !process.stdin.isTTY) return Promise.resolve(fallback);
+  return new Promise((resolve) => {
+    const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, output: process.stdout });
+    rl.question(`  ${coral("\u25C6")} ${question} ${dim(fallback ? "(S/n)" : "(s/N)")} `, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      resolve(a === "" ? fallback : a.startsWith("s") || a.startsWith("y"));
+    });
+  });
+}
+function ask(question) {
+  return new Promise((resolve) => {
+    const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, output: process.stdout });
+    rl.question(`  ${coral("\u25C6")} ${question} `, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+var FRAMEWORK_LABEL = {
+  "next-app": "Next.js (App Router)",
+  "next-pages": "Next.js (Pages Router)",
+  "vite-react": "Vite + React",
+  "vite-vue": "Vite + Vue",
+  "vite-svelte": "Vite + Svelte",
+  nuxt: "Nuxt",
+  remix: "Remix",
+  astro: "Astro",
+  "react-cra": "Create React App",
+  angular: "Angular",
+  vanilla: "HTML",
+  unknown: "n\xE3o identificado"
+};
+
+// src/login.ts
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function openBrowser(url) {
   if (process.env.CI || process.env.HOLDY_NO_BROWSER) return false;
@@ -752,71 +850,159 @@ function openBrowser(url) {
   }
 }
 async function loginWithBrowser(opts) {
-  const { ui } = opts;
   let session;
   try {
     const res = await fetch(`${opts.apiUrl}/cli/sessions`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ instrument: opts.instrument, client: opts.client })
+      body: JSON.stringify({ instrument: opts.instrument, read: opts.read, client: opts.client })
     });
     if (!res.ok) {
-      ui.error(`A Holdy n\xE3o abriu a sess\xE3o de login (HTTP ${res.status}).`);
+      fail("Conta", `A Holdy n\xE3o abriu a sess\xE3o de login (HTTP ${res.status}).`);
       return null;
     }
     session = await res.json();
   } catch (err) {
-    ui.error(`N\xE3o consegui falar com a Holdy: ${err instanceof Error ? err.message : String(err)}`);
+    fail("Conta", `N\xE3o consegui falar com a Holdy: ${err instanceof Error ? err.message : String(err)}`);
     return null;
   }
-  console.log();
-  console.log(`      Seu c\xF3digo: ${ui.bold(session.user_code)}`);
   const opened = openBrowser(session.verification_url);
-  console.log(
-    `      ${opened ? "Abri o navegador. Se n\xE3o abriu, acesse:" : "Abra no navegador:"} ${ui.cyan(session.verification_url)}`
-  );
-  console.log(`      ${ui.dim("Entre ou crie sua conta, confira o c\xF3digo e clique em Autorizar.")}`);
-  console.log();
+  active("Conta", `${opened ? "Abri o navegador pra voc\xEA entrar na Holdy." : "Abra no navegador pra entrar na Holdy:"}`);
+  note(cyan(session.verification_url));
+  note(`C\xF3digo ${bold(session.user_code)} ${dim("\xB7 confira se \xE9 o mesmo na p\xE1gina e clique em Autorizar")}`);
+  const spin = spinner("Esperando voc\xEA autorizar no navegador\u2026");
   const deadline = Date.now() + session.expires_in * 1e3;
   let interval = Math.max(1, session.interval) * 1e3;
-  while (Date.now() < deadline) {
-    await sleep(interval);
-    let res;
-    try {
-      res = await fetch(`${opts.apiUrl}/cli/sessions/poll`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ device_code: session.device_code })
-      });
-    } catch {
-      continue;
-    }
-    if (res.status === 202) continue;
-    if (res.status === 429) {
-      interval = Math.min(interval * 2, 1e4);
-      continue;
-    }
-    if (res.status === 403) {
-      ui.error("Autoriza\xE7\xE3o cancelada no navegador.");
-      return null;
-    }
-    if (res.status === 410) break;
-    if (res.ok) {
-      const body = await res.json();
-      if (!body.public_key) break;
-      return {
-        publicKey: body.public_key,
-        secretKey: body.secret_key ?? null,
-        organizationName: body.organization_name ?? null
-      };
+  try {
+    while (Date.now() < deadline) {
+      await sleep(interval);
+      let res;
+      try {
+        res = await fetch(`${opts.apiUrl}/cli/sessions/poll`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ device_code: session.device_code })
+        });
+      } catch {
+        continue;
+      }
+      if (res.status === 202) continue;
+      if (res.status === 429) {
+        interval = Math.min(interval * 2, 1e4);
+        continue;
+      }
+      if (res.status === 403) {
+        spin.stop();
+        fail("Conta", "Autoriza\xE7\xE3o cancelada no navegador.");
+        return null;
+      }
+      if (res.status === 410) break;
+      if (res.ok) {
+        const body = await res.json();
+        if (!body.public_key) break;
+        spin.stop();
+        return {
+          publicKey: body.public_key,
+          secretKey: body.secret_key ?? null,
+          organizationName: body.organization_name ?? null
+        };
+      }
     }
+  } finally {
+    spin.stop();
   }
-  ui.error("O c\xF3digo expirou antes da autoriza\xE7\xE3o. Rode o comando de novo.");
+  fail("Conta", "O c\xF3digo expirou antes da autoriza\xE7\xE3o. Rode o comando de novo.");
   return null;
 }
 
+// src/editors.ts
+var import_node_child_process2 = require("node:child_process");
+var import_node_fs5 = require("node:fs");
+var import_node_os = require("node:os");
+var import_node_path5 = require("node:path");
+var EDITOR_LABEL = { "claude-code": "Claude Code", cursor: "Cursor" };
+function mcpUrl(apiUrl) {
+  return apiUrl.replace(/\/api\/v1\/?$/, "") + "/api/mcp";
+}
+function hasClaudeCli() {
+  try {
+    return (0, import_node_child_process2.spawnSync)("claude", ["--version"], { stdio: "ignore", timeout: 5e3 }).status === 0;
+  } catch {
+    return false;
+  }
+}
+function detectEditors() {
+  const found = [];
+  if (hasClaudeCli()) found.push("claude-code");
+  if ((0, import_node_fs5.existsSync)((0, import_node_path5.join)((0, import_node_os.homedir)(), ".cursor"))) found.push("cursor");
+  return found;
+}
+function configureEditor(editor, url, key) {
+  if (editor === "claude-code") {
+    (0, import_node_child_process2.spawnSync)("claude", ["mcp", "remove", "holdy", "-s", "user"], { stdio: "ignore", timeout: 1e4 });
+    const res = (0, import_node_child_process2.spawnSync)(
+      "claude",
+      ["mcp", "add", "--transport", "http", "-s", "user", "holdy", url, "--header", `Authorization: Bearer ${key}`],
+      { encoding: "utf8", timeout: 15e3 }
+    );
+    return res.status === 0 ? { ok: true, detail: "claude mcp add holdy (escopo do usu\xE1rio)" } : { ok: false, detail: (res.stderr || res.stdout || "claude mcp add falhou").trim().split("\n")[0] };
+  }
+  const dir = (0, import_node_path5.join)((0, import_node_os.homedir)(), ".cursor");
+  const file = (0, import_node_path5.join)(dir, "mcp.json");
+  try {
+    let config = {};
+    if ((0, import_node_fs5.existsSync)(file)) config = JSON.parse((0, import_node_fs5.readFileSync)(file, "utf8") || "{}");
+    config.mcpServers = { ...config.mcpServers ?? {}, holdy: { url, headers: { Authorization: `Bearer ${key}` } } };
+    (0, import_node_fs5.mkdirSync)(dir, { recursive: true });
+    (0, import_node_fs5.writeFileSync)(file, JSON.stringify(config, null, 2) + "\n", { mode: 384 });
+    return { ok: true, detail: "~/.cursor/mcp.json" };
+  } catch (err) {
+    return { ok: false, detail: err instanceof Error ? err.message : "n\xE3o consegui escrever ~/.cursor/mcp.json" };
+  }
+}
+
+// src/first-event.ts
+function keyPrefixOf(publicKey) {
+  const m = publicKey.match(/^hol_(?:live|test)_([A-HJKMNP-TV-Z2-9]{4})/);
+  return m ? m[1] : null;
+}
+async function readStatus(apiUrl, key, since, installKeyPrefix = null) {
+  try {
+    const params = new URLSearchParams();
+    if (since) params.set("since", since);
+    if (installKeyPrefix) params.set("key_prefix", installKeyPrefix);
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    const res = await fetch(`${apiUrl}/setup/status${qs}`, { headers: { Authorization: `Bearer ${key}` } });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
+async function waitForFirstEvent(opts) {
+  const started = Date.now();
+  let stop = false;
+  const onSigint = () => {
+    stop = true;
+  };
+  process.once("SIGINT", onSigint);
+  try {
+    while (!stop && Date.now() - started < opts.timeoutMs) {
+      const status = await readStatus(opts.apiUrl, opts.key, opts.since, opts.installKeyPrefix);
+      if (status?.firstSince) return { status, elapsedS: Math.round((Date.now() - started) / 1e3) };
+      opts.onTick?.(Math.round((Date.now() - started) / 1e3));
+      await sleep2(2500);
+    }
+    return null;
+  } finally {
+    process.removeListener("SIGINT", onSigint);
+  }
+}
+
 // src/cli.ts
-var VERSION = "0.5.0";
+var import_node_child_process3 = require("node:child_process");
+var VERSION = "0.6.0";
 var DEFAULT_API_URL = "https://holdy.chat/api/v1";
 async function main() {
   const argv = process.argv.slice(2);
@@ -830,51 +1016,61 @@ async function main() {
     process.exit(0);
   }
   const args = parseArgs(argv);
-  log.banner();
-  log.step("1", "Detectando seu projeto\u2026");
+  const project = projectName(cwd);
+  box([
+    `${coral("\u25C6")} ${bold("holdy")} ${dim(`\xB7 instala\xE7\xE3o \xB7 v${VERSION}`)}`,
+    dim("Do primeiro evento \xE0 primeira a\xE7\xE3o no seu produto.")
+  ]);
   const detection = detectFramework(cwd);
-  log.detection(detection);
+  done("Projeto", `${FRAMEWORK_LABEL[detection.framework] ?? detection.framework} ${dim(`\xB7 ${project}`)}`);
   if (detection.framework === "unknown") {
-    log.warn('N\xE3o consegui identificar o framework. Sigo no modo "vanilla" (script tag).');
+    note(yellow("N\xE3o identifiquei o framework. Sigo no modo script tag."));
   }
   let apiKey = args.apiKey;
-  let instrumentKey = null;
-  if (!apiKey && args.pasteKey) {
-    apiKey = await promptApiKey();
-  } else if (!apiKey) {
-    log.step("2", "Entrando na Holdy pelo navegador\u2026");
-    const login = await loginWithBrowser({
-      apiUrl: args.apiUrl,
-      instrument: args.instrument,
-      client: { framework: detection.framework, project: projectName(cwd), cli_version: VERSION },
-      ui: { ...log, bold, dim, cyan }
-    });
-    if (!login) {
-      log.info(`Prefere colar a chave? ${bold("npx @holdyapp/install --paste-key")}`);
-      process.exit(1);
+  let readKey = null;
+  let organizationName = null;
+  let editors = [];
+  if (!apiKey) {
+    if (args.mcp !== false) {
+      const found = detectEditors();
+      if (found.length > 0) {
+        const names = found.map((e) => EDITOR_LABEL[e]).join(" e ");
+        const yes = args.mcp === true || await confirm2(`Ligar a Holdy no ${names}? Seu agente passa a ler as oportunidades.`, true);
+        if (yes) editors = found;
+      }
+    }
+    if (args.pasteKey) {
+      apiKey = await ask(`API key ${dim("(hol_live_\u2026 ou hol_test_\u2026)")}:`);
+    } else {
+      const login = await loginWithBrowser({
+        apiUrl: args.apiUrl,
+        instrument: args.instrument,
+        read: true,
+        client: { framework: detection.framework, project, cli_version: VERSION, mcp: editors.length > 0 }
+      });
+      if (!login) {
+        note(`Prefere colar a chave? ${bold("npx @holdyapp/install --paste-key")}`);
+        process.exit(1);
+      }
+      apiKey = login.publicKey;
+      readKey = login.secretKey;
+      organizationName = login.organizationName;
+      done("Conta", organizationName ? `Conectado em ${bold(organizationName)}` : "Conectado");
     }
-    log.success(login.organizationName ? `Autorizado em ${bold(login.organizationName)}` : "Autorizado");
-    apiKey = login.publicKey;
-    instrumentKey = login.secretKey;
   }
   if (!apiKey || !apiKey.startsWith("hol_")) {
-    log.error("API key inv\xE1lida. Use formato hol_live_\u2026 ou hol_test_\u2026 \xB7 gere em holdy.chat/settings.");
+    fail("Conta", "Chave inv\xE1lida. Use hol_live_\u2026 ou hol_test_\u2026, gerada em holdy.chat/settings.");
     process.exit(1);
   }
-  log.step("3", "Aplicando snippet no(s) arquivo(s)\u2026");
-  const result = inject(detection, {
-    apiKey,
-    accountId: args.accountId,
-    autoCapture: args.autoCapture
-  });
-  if (result.ok) {
-    if (result.modified) {
-      log.success(result.message);
-    } else {
-      log.info(result.message);
-    }
-  } else {
-    log.error(result.message);
+  const before = readKey ? await readStatus(args.apiUrl, readKey, null) : null;
+  if (before?.topOpportunity) {
+    note(
+      `${coral("\u2605")} A Holdy j\xE1 tem ${before.openOpportunities} ${before.openOpportunities === 1 ? "oportunidade aberta" : "oportunidades abertas"}. A principal: ${bold(before.topOpportunity.title)}`
+    );
+  }
+  const result = inject(detection, { apiKey, accountId: args.accountId, autoCapture: args.autoCapture });
+  if (!result.ok) {
+    fail("SDK", result.message);
     if (result.manualSnippet) {
       console.log();
       console.log(result.manualSnippet);
@@ -882,36 +1078,113 @@ async function main() {
     }
     process.exit(2);
   }
+  done("SDK", result.modified ? result.message : `${result.message} ${dim("(j\xE1 estava instalado)")}`);
   if (detection.usePackage && detection.framework !== "next-app") {
-    log.step("4", "Falta instalar o pacote npm:");
-    console.log();
-    console.log("   npm install @holdyapp/sdk");
-    console.log();
-  } else {
-    log.step("4", "Sem npm install necess\xE1rio \xB7 script tag via CDN.");
+    const pm = packageManager(cwd);
+    const cmd = pm === "npm" ? ["install", "@holdyapp/sdk"] : ["add", "@holdyapp/sdk"];
+    const spin = spinner(`${pm} ${cmd.join(" ")}`);
+    const res = (0, import_node_child_process3.spawnSync)(pm, cmd, { cwd, stdio: "ignore", shell: process.platform === "win32" });
+    spin.stop();
+    if (res.status === 0) done("Pacote", `@holdyapp/sdk instalado com ${pm}`);
+    else fail("Pacote", `Rode voc\xEA: ${bold(`${pm} ${cmd.join(" ")}`)}`);
+  }
+  const mcpReady = [];
+  if (editors.length > 0 && readKey) {
+    const url = mcpUrl(args.apiUrl);
+    for (const editor of editors) {
+      const res = configureEditor(editor, url, readKey);
+      if (res.ok) mcpReady.push(editor);
+      else fail("Editor", `${EDITOR_LABEL[editor]}: ${res.detail}`);
+    }
+    if (mcpReady.length > 0) {
+      done("Editor", `MCP da Holdy ligado no ${mcpReady.map((e) => EDITOR_LABEL[e]).join(" e ")}`);
+    }
   }
   if (args.instrument) {
     console.log();
-    log.step("5", "Instrumentando eventos de produto\u2026");
     const code = await runInstrument({
       cwd,
-      apiKey: instrumentKey ?? apiKey,
+      apiKey: readKey ?? apiKey,
       baseUrl: args.apiUrl,
       framework: detection.framework,
       sdkStyle: detection.usePackage ? "npm" : "script",
       maxEvents: args.maxEvents,
       dryRun: args.dryRun,
       yes: args.yes,
-      ui: { ...log, bold, dim, green, yellow, cyan }
+      ui: {
+        step: (n, msg) => console.log(`  ${cyan(`[${n}]`)} ${msg}`),
+        success: (msg) => note(`${green("\u2713")} ${msg}`),
+        info: (msg) => note(dim(msg)),
+        warn: (msg) => note(yellow(msg)),
+        error: (msg) => note(red(msg)),
+        bold,
+        dim,
+        green,
+        yellow,
+        cyan
+      }
     });
     if (code !== 0) process.exit(code);
+  }
+  rule();
+  const shouldWait = readKey !== null && args.wait !== false && (isTTY || args.wait === true);
+  if (shouldWait && readKey) {
+    const since = new Date(Date.now() - 5e3).toISOString();
+    console.log(`  ${bold("Agora rode o seu app")} ${dim(`(${devCommand(cwd)})`)} ${bold("e abra qualquer tela.")}`);
+    console.log(`  ${dim("Fico de olho e te mostro o primeiro evento. Ctrl+C pula.")}`);
     console.log();
-    log.step("6", "Pronto! Suba o app, use o produto e veja os eventos chegando em holdy.chat.");
-    process.exit(0);
+    const spin = spinner("Esperando o primeiro evento\u2026");
+    const got = await waitForFirstEvent({
+      apiUrl: args.apiUrl,
+      key: readKey,
+      since,
+      installKeyPrefix: keyPrefixOf(apiKey),
+      timeoutMs: 10 * 60 * 1e3,
+      onTick: (s) => spin.update(`Esperando o primeiro evento\u2026 ${dim(`${s}s`)}`)
+    });
+    spin.stop();
+    if (got) {
+      const first = got.status.firstSince;
+      const what = first.name ? `: ${cyan(first.name)}${first.path ? ` em ${bold(first.path)}` : ""}` : "";
+      console.log(`  ${green("\u2713")} ${bold("Primeiro evento do seu app chegou")} ${dim(`em ${got.elapsedS}s`)}${what}`);
+      console.log(`    ${dim("A Holdy j\xE1 est\xE1 lendo o comportamento do seu produto.")}`);
+    } else {
+      console.log(`  ${dim("Sem evento por enquanto. Quando o app rodar com o SDK, ele aparece em holdy.chat/overview.")}`);
+    }
+    rule();
+  }
+  console.log(`  ${bold("O que vem agora")}`);
+  console.log();
+  const steps = [
+    `Ligue ${cyan("identify(userId)")} e ${cyan("group(contaId, { name, plan, mrr, status })")} depois do login. Sem group() a Holdy n\xE3o sabe de qual empresa \xE9 cada evento; com mrr e status ela mede quanto MRR cada mudan\xE7a converteu.`,
+    `Abra ${cyan("https://holdy.chat/overview")}: a Holdy sugere comportamentos e abre oportunidades conforme as contas usam o produto.`
+  ];
+  if (mcpReady.length > 0) {
+    steps.push(`No ${mcpReady.map((e) => EDITOR_LABEL[e]).join(" ou ")}, pergunte: ${bold('"quais oportunidades a Holdy encontrou?"')} ${dim("(reinicie o editor se ele j\xE1 estava aberto)")}`);
+  }
+  if (!args.instrument) {
+    steps.push(`Quer que a Holdy proponha os eventos do seu produto? ${bold("npx @holdyapp/install --instrument")}`);
   }
-  log.step("5", "Pronto! Inicie o app e abra holdy.chat/overview \xB7 o primeiro evento aparece em segundos.");
+  steps.forEach((step, i) => console.log(`  ${coral(`${i + 1}.`)} ${step}`));
+  console.log();
   process.exit(0);
 }
+function packageManager(cwd) {
+  if ((0, import_node_fs6.existsSync)((0, import_node_path6.join)(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if ((0, import_node_fs6.existsSync)((0, import_node_path6.join)(cwd, "yarn.lock"))) return "yarn";
+  if ((0, import_node_fs6.existsSync)((0, import_node_path6.join)(cwd, "bun.lockb")) || (0, import_node_fs6.existsSync)((0, import_node_path6.join)(cwd, "bun.lock"))) return "bun";
+  return "npm";
+}
+function devCommand(cwd) {
+  try {
+    const pkg = JSON.parse((0, import_node_fs6.readFileSync)((0, import_node_path6.join)(cwd, "package.json"), "utf8"));
+    const pm = packageManager(cwd);
+    if (pkg.scripts?.dev) return `${pm} run dev`;
+    if (pkg.scripts?.start) return `${pm} start`;
+  } catch {
+  }
+  return "npm run dev";
+}
 function parseArgs(argv) {
   const out = {
     apiKey: null,
@@ -922,7 +1195,9 @@ function parseArgs(argv) {
     yes: false,
     maxEvents: 12,
     apiUrl: process.env.HOLDY_API_URL ?? DEFAULT_API_URL,
-    pasteKey: false
+    pasteKey: false,
+    mcp: null,
+    wait: null
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -942,6 +1217,14 @@ function parseArgs(argv) {
     } else if (a === "--max-events") {
       const parsed = Number(argv[++i]);
       if (Number.isFinite(parsed)) out.maxEvents = Math.min(20, Math.max(3, Math.trunc(parsed)));
+    } else if (a === "--mcp") {
+      out.mcp = true;
+    } else if (a === "--no-mcp") {
+      out.mcp = false;
+    } else if (a === "--wait") {
+      out.wait = true;
+    } else if (a === "--no-wait") {
+      out.wait = false;
     } else if (a === "--paste-key") {
       out.pasteKey = true;
     } else if (a === "--api-url") {
@@ -957,20 +1240,11 @@ function parseArgs(argv) {
 }
 function projectName(cwd) {
   try {
-    const pkg = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path5.join)(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse((0, import_node_fs6.readFileSync)((0, import_node_path6.join)(cwd, "package.json"), "utf8"));
     if (pkg.name) return pkg.name;
   } catch {
   }
-  return (0, import_node_path5.basename)(cwd);
-}
-function promptApiKey() {
-  return new Promise((resolve) => {
-    const rl = (0, import_node_readline2.createInterface)({ input: process.stdin, output: process.stdout });
-    rl.question(`${dim("API key")} (hol_live_\u2026 ou hol_test_\u2026): `, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
+  return (0, import_node_path6.basename)(cwd);
 }
 function printHelp() {
   const isLive = readPackageName();
@@ -993,6 +1267,8 @@ ${bold("Op\xE7\xF5es:")}
   --dry-run             S\xF3 lista os eventos propostos \xB7 n\xE3o escreve nada (implica --instrument)
   --max-events <n>      Teto de eventos propostos \xB7 3 a 20 \xB7 default 12
   --yes, -y             Aplica o diff sem perguntar
+  --mcp / --no-mcp      Liga (ou n\xE3o) a Holdy no Claude Code e no Cursor sem perguntar
+  --wait / --no-wait    Espera (ou n\xE3o) o primeiro evento no fim
   --paste-key           Pede a chave no terminal em vez de abrir o navegador
   --api-url <url>       Override da API (default https://holdy.chat/api/v1)
   --version, -v         Mostra vers\xE3o
@@ -1010,7 +1286,7 @@ ${bold("Exemplos:")}
 
 ${bold("Sobre --instrument:")}
   Manda trechos do seu c\xF3digo pra Holdy, que devolve onde inserir cada track().
-  Pelo navegador, a Holdy entrega uma chave secreta que vale 1 hora s\xF3 pra isso.
+  Pelo navegador, a Holdy entrega uma chave de leitura pra isso (24 horas, ou sem validade se for pro MCP).
   Com chave colada, exige key SECRETA (n\xE3o a p\xFAblica do browser). Voc\xEA v\xEA o diff antes de aplicar,
   e nada \xE9 escrito sem confirma\xE7\xE3o. Pageview e rota j\xE1 s\xE3o autom\xE1ticos \u2014 o
   planner s\xF3 prop\xF5e momentos em que a conta avan\xE7a no produto.
@@ -1018,66 +1294,12 @@ ${bold("Sobre --instrument:")}
 }
 function readPackageName() {
   try {
-    const pkg = JSON.parse((0, import_node_fs5.readFileSync)((0, import_node_path5.join)(__dirname, "..", "package.json"), "utf8"));
+    const pkg = JSON.parse((0, import_node_fs6.readFileSync)((0, import_node_path6.join)(__dirname, "..", "package.json"), "utf8"));
     return pkg.description ?? null;
   } catch {
     return null;
   }
 }
-var COLORS = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  dim: "\x1B[2m",
-  cyan: "\x1B[36m",
-  green: "\x1B[32m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m"
-};
-function bold(s) {
-  return `${COLORS.bold}${s}${COLORS.reset}`;
-}
-function dim(s) {
-  return `${COLORS.dim}${s}${COLORS.reset}`;
-}
-function cyan(s) {
-  return `${COLORS.cyan}${s}${COLORS.reset}`;
-}
-function green(s) {
-  return `${COLORS.green}${s}${COLORS.reset}`;
-}
-function red(s) {
-  return `${COLORS.red}${s}${COLORS.reset}`;
-}
-function yellow(s) {
-  return `${COLORS.yellow}${s}${COLORS.reset}`;
-}
-var log = {
-  banner() {
-    console.log();
-    console.log(`  ${bold("Holdy")} ${dim("\xB7 behavioral operating layer")}`);
-    console.log();
-  },
-  step(n, msg) {
-    console.log(`  ${cyan(`[${n}]`)} ${msg}`);
-  },
-  detection(d) {
-    const label = d.framework === "unknown" ? "?" : d.framework;
-    const file = d.targetFile ? dim(` \u2192 ${d.targetFile.replace(process.cwd() + "/", "")}`) : "";
-    console.log(`      ${dim("framework:")} ${bold(label)}${file}`);
-  },
-  success(msg) {
-    console.log(`      ${green("\u2713")} ${msg}`);
-  },
-  info(msg) {
-    console.log(`      ${dim("\xB7")} ${msg}`);
-  },
-  warn(msg) {
-    console.log(`      ${yellow("!")} ${msg}`);
-  },
-  error(msg) {
-    console.log(`      ${red("\u2717")} ${msg}`);
-  }
-};
 main().catch((err) => {
   console.error(red("[holdy-install] erro inesperado:"), err instanceof Error ? err.message : err);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyapp/install",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Holdy install CLI · detects your framework, wires the SDK and instruments product events",
   "license": "MIT",
   "homepage": "https://holdy.chat",