@peppermint-mcp/wizard 0.4.1 → 0.4.3

package/dist/cli.js

@@ -68,8 +68,8 @@ async function detectClaudeDesktop() {
   if (existsSync(configPath)) {
     try {
       const content = readFileSync(configPath, "utf-8");
-      const parsed = jsonc.parse(content);
-      alreadyInstalled = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
+      const parsed2 = jsonc.parse(content);
+      alreadyInstalled = !!parsed2?.mcpServers?.["peppermint-memory"] || !!parsed2?.mcpServers?.peppermint;
     } catch {
       warnings.push("Config file exists but could not be parsed");
     }
@@ -105,8 +105,8 @@ async function detectCursor() {
   if (configExists) {
     try {
       const content = readFileSync2(configPath, "utf-8");
-      const parsed = jsonc2.parse(content);
-      alreadyInstalled = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
+      const parsed2 = jsonc2.parse(content);
+      alreadyInstalled = !!parsed2?.mcpServers?.["peppermint-memory"] || !!parsed2?.mcpServers?.peppermint;
     } catch {
       warnings.push("Config file exists but could not be parsed");
     }
@@ -207,7 +207,7 @@ function clearCredentials() {
 // src/auth/localhost-oauth.ts
 import { createServer } from "http";
 import { randomBytes, createHash } from "crypto";
-import { URL, URLSearchParams } from "url";
+import { URL as URL2, URLSearchParams } from "url";
 import open from "open";
 var AUTH_TIMEOUT_MS = 5 * 60 * 1e3;
 function generatePKCE() {
@@ -279,7 +279,7 @@ function waitForCallback(port, expectedState) {
       reject(new Error("Authentication timed out (5 minutes). Please try again."));
     }, AUTH_TIMEOUT_MS);
     const server = createServer((req, res) => {
-      const url = new URL(req.url, `http://127.0.0.1:${port}`);
+      const url = new URL2(req.url, `http://127.0.0.1:${port}`);
       if (url.pathname !== "/callback") {
         res.writeHead(404);
         res.end("Not found");
@@ -488,9 +488,14 @@ function removeServerFromConfig(filePath, serverProperty, serverName, dryRun) {
     return false;
   }
   const content = readFileSync4(filePath, "utf-8");
-  const edits = jsonc3.modify(content, [serverProperty, serverName], void 0, {
-    formattingOptions: { tabSize: 2, insertSpaces: true }
-  });
+  let edits;
+  try {
+    edits = jsonc3.modify(content, [serverProperty, serverName], void 0, {
+      formattingOptions: { tabSize: 2, insertSpaces: true }
+    });
+  } catch {
+    return false;
+  }
   if (edits.length === 0) {
     return false;
   }
@@ -518,12 +523,10 @@ function getConfigPath3() {
 }
 async function installClaudeDesktop(serverUrl, apiKey, dryRun) {
   const configPath = getConfigPath3();
-  const serverConfig = {
-    url: serverUrl,
-    headers: {
-      Authorization: `Bearer ${apiKey}`
-    }
-  };
+  const serverConfig = { url: serverUrl };
+  if (apiKey) {
+    serverConfig.headers = { Authorization: `Bearer ${apiKey}` };
+  }
   try {
     removeServerFromConfig(configPath, "mcpServers", "peppermint", dryRun);
     const result = writeServerToConfig({
@@ -569,12 +572,10 @@ function getConfigPath4() {
 }
 async function installCursor(serverUrl, apiKey, dryRun) {
   const configPath = getConfigPath4();
-  const serverConfig = {
-    url: serverUrl,
-    headers: {
-      Authorization: `Bearer ${apiKey}`
-    }
-  };
+  const serverConfig = { url: serverUrl };
+  if (apiKey) {
+    serverConfig.headers = { Authorization: `Bearer ${apiKey}` };
+  }
   try {
     removeServerFromConfig(configPath, "mcpServers", "peppermint", dryRun);
     const result = writeServerToConfig({
@@ -727,8 +728,8 @@ function checkHostConfig(hostId, configPath) {
   }
   try {
     const content = readFileSync6(configPath, "utf-8");
-    const parsed = jsonc4.parse(content);
-    const hasPeppermint = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
+    const parsed2 = jsonc4.parse(content);
+    const hasPeppermint = !!parsed2?.mcpServers?.["peppermint-memory"] || !!parsed2?.mcpServers?.peppermint;
     if (!hasPeppermint) {
       return {
         hostId,
@@ -879,8 +880,8 @@ function installPermissions(dryRun) {
     if (existsSync8(settingsPath)) {
       content = readFileSync8(settingsPath, "utf-8");
     }
-    const parsed = content ? jsonc5.parse(content) : {};
-    const existingAllow = parsed?.permissions?.allow || [];
+    const parsed2 = content ? jsonc5.parse(content) : {};
+    const existingAllow = parsed2?.permissions?.allow || [];
     const toAdd = REQUIRED_PERMISSIONS.filter((p2) => !existingAllow.includes(p2));
     if (toAdd.length === 0) {
       return { added: [] };
@@ -905,12 +906,95 @@ function installPermissions(dryRun) {
   }
 }
 
+// src/telemetry.ts
+var SENTRY_DSN = process.env.PEPPERMINT_WIZARD_SENTRY_DSN || "https://ee35ace1116aadd55a0ac5dc2226f5b2@o4510957452197888.ingest.us.sentry.io/4511341954203648";
+var parsed = null;
+function parseDSN() {
+  if (parsed) return parsed;
+  try {
+    const url = new URL(SENTRY_DSN);
+    const projectId = url.pathname.replace(/\//g, "");
+    if (!url.username || !projectId) return null;
+    parsed = { publicKey: url.username, host: `${url.protocol}//${url.host}`, projectId };
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+var wizardVersion = "unknown";
+try {
+  const { readFileSync: readFileSync9 } = await import("fs");
+  const { resolve: resolve2, dirname: dirname5 } = await import("path");
+  const { fileURLToPath: fileURLToPath2 } = await import("url");
+  const pkgPath = resolve2(dirname5(fileURLToPath2(import.meta.url)), "..", "package.json");
+  const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+  wizardVersion = pkg.version ?? "unknown";
+} catch {
+}
+function uuid4() {
+  return "xxxxxxxxxxxx4xxxyxxxxxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    return (c === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+function captureException(error, context) {
+  const dsn = parseDSN();
+  if (!dsn) return;
+  const err = error instanceof Error ? error : new Error(String(error));
+  const stack = err.stack;
+  const frames = (stack?.split("\n").slice(1) ?? []).map((line) => {
+    const m = line.match(/at\s+(.+?)\s+\((.+?):(\d+):\d+\)/) ?? line.match(/at\s+(.+?):(\d+):\d+/);
+    if (!m) return null;
+    return m.length === 4 ? { function: m[1], filename: m[2], lineno: Number(m[3]) } : { filename: m[1], lineno: Number(m[2]) };
+  }).filter(Boolean);
+  const event = {
+    event_id: uuid4(),
+    timestamp: Date.now() / 1e3,
+    platform: "node",
+    level: "error",
+    release: `peppermint-mcp-wizard@${wizardVersion}`,
+    exception: {
+      values: [
+        {
+          type: err.name,
+          value: err.message,
+          stacktrace: frames.length > 0 ? { frames: frames.reverse() } : void 0
+        }
+      ]
+    },
+    tags: context?.tags,
+    extra: context?.extra,
+    contexts: {
+      runtime: { name: "node", version: process.version },
+      os: { name: process.platform, version: process.arch }
+    }
+  };
+  const envelope = [
+    JSON.stringify({ event_id: event.event_id, dsn: SENTRY_DSN, sent_at: (/* @__PURE__ */ new Date()).toISOString() }),
+    JSON.stringify({ type: "event", length: 0 }),
+    JSON.stringify(event)
+  ].join("\n");
+  const envelopeUrl = `${dsn.host}/api/${dsn.projectId}/envelope/`;
+  fetch(envelopeUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-sentry-envelope", "X-Sentry-Auth": `Sentry sentry_key=${dsn.publicKey}, sentry_version=7` },
+    body: envelope
+  }).catch(() => {
+  });
+}
+async function flush(timeoutMs = 2e3) {
+  await new Promise((resolve2) => setTimeout(resolve2, Math.min(timeoutMs, 2e3)));
+}
+
 // src/cli.ts
 var DEFAULT_SERVER = "https://api.peppermint.com/mcp/";
 function serverBase(serverUrl) {
   return serverUrl.replace(/\/mcp\/?$/, "");
 }
-function needsAuth(_hosts) {
+function needsAuth(serverUrl) {
+  if (serverUrl && (serverUrl.includes("localhost") || serverUrl.includes("127.0.0.1"))) {
+    return false;
+  }
   return true;
 }
 async function installHost(host, serverUrl, apiKey, dryRun) {
@@ -918,10 +1002,8 @@ async function installHost(host, serverUrl, apiKey, dryRun) {
     case "claude-code":
       return installClaudeCode(serverUrl, apiKey, dryRun);
     case "claude-desktop":
-      if (!apiKey) throw new Error("API key required for Claude Desktop");
       return installClaudeDesktop(serverUrl, apiKey, dryRun);
     case "cursor":
-      if (!apiKey) throw new Error("API key required for Cursor");
       return installCursor(serverUrl, apiKey, dryRun);
     case "codex":
       return installCodex(serverUrl, apiKey, dryRun);
@@ -1004,7 +1086,9 @@ async function addCommand(options) {
   const serverCheck = await checkServerReachable(options.server);
   if (!serverCheck.reachable) {
     const msg = `Cannot reach ${options.server}: ${serverCheck.error}`;
+    captureException(new Error(msg), { tags: { command: "add", phase: "server_check" } });
     nonInteractive ? console.error(msg) : p.log.error(msg);
+    await flush();
     process.exit(4);
   }
   if (!nonInteractive) {
@@ -1016,7 +1100,7 @@ async function addCommand(options) {
     apiKey = tokenFromFlag;
     const msg = "Using provided auth token";
     nonInteractive ? console.log(msg) : p.log.success(msg);
-  } else if (needsAuth(selectedHosts)) {
+  } else if (needsAuth(options.server)) {
     const base = serverBase(options.server);
     const existing = loadCredentials(base);
     if (existing) {
@@ -1034,7 +1118,9 @@ async function addCommand(options) {
         p.log.success(`Authenticated as ${pc.bold(creds.email || "user")}`);
       } catch (err) {
         const msg = err instanceof Error ? err.message : "Authentication failed";
+        captureException(err, { tags: { command: "add", phase: "auth" } });
         p.log.error(msg);
+        await flush();
         process.exit(3);
       }
     }
@@ -1045,6 +1131,11 @@ async function addCommand(options) {
     const result = await installHost(host, options.server, apiKey, options.dryRun);
     const icon = result.success ? pc.green("\u2713") : pc.red("\u2717");
     p.log.info(`  ${icon} ${host.name}  ${pc.dim(result.message)}`);
+    if (!result.success) {
+      captureException(new Error(result.message), {
+        tags: { host: host.id, command: "add", phase: "install" }
+      });
+    }
     results.push({ host, result });
   }
   const hasClaudeHost = hosts.some(
@@ -1063,10 +1154,16 @@ async function addCommand(options) {
       const backup = skillResult.backedUp ? pc.dim(" (previous version backed up)") : "";
       p.log.info(`  ${pc.green("\u2713")} ${verb} Peppermint skill${backup}  ${pc.dim(skillResult.targetPath)}`);
     } else if (skillResult.error) {
+      captureException(new Error(skillResult.error), {
+        tags: { command: "add", phase: "skills" }
+      });
       p.log.info(`  ${pc.red("\u2717")} Skill install failed: ${pc.dim(skillResult.error)}`);
     }
     const permsResult = installPermissions(options.dryRun);
     if (permsResult.error) {
+      captureException(new Error(permsResult.error), {
+        tags: { command: "add", phase: "permissions" }
+      });
       p.log.info(`  ${pc.red("\u2717")} Permissions: ${pc.dim(permsResult.error)}`);
     } else if (permsResult.added.length > 0) {
       p.log.info(`  ${pc.green("\u2713")} Added ${permsResult.added.length} tool permissions to Claude Code settings`);
@@ -1077,6 +1174,11 @@ async function addCommand(options) {
     for (const { host } of results) {
       const check = checkHostConfig(host.id, host.configPath);
       const icon = check.status === "pass" ? pc.green("\u2713") : check.status === "warn" ? pc.yellow("\u26A0") : pc.red("\u2717");
+      if (check.status === "fail") {
+        captureException(new Error(check.message), {
+          tags: { host: host.id, command: "add", phase: "verify" }
+        });
+      }
       p.log.info(`  ${icon} ${host.name}  ${pc.dim(check.message)}`);
     }
   }
@@ -1085,7 +1187,10 @@ async function addCommand(options) {
   p.outro(
     failed.length > 0 ? pc.red(`${failed.length} host(s) failed. Check the output above.`) : hasClaudeHost ? pc.green("Done!") + (needRestart.length > 0 ? pc.dim(` Restart ${needRestart.map((r) => r.host.name).join(", ")} to finish.`) : "") + "\n\n  " + pc.cyan("Peppermint skill installed. Start a new Claude Code session and type") + "\n  " + pc.cyan("@pep or /peppermint to begin onboarding.") : needRestart.length > 0 ? pc.green("Done!") + pc.dim(` Restart ${needRestart.map((r) => r.host.name).join(", ")} to finish.`) : pc.green("Done! Peppermint MCP is ready.")
   );
-  if (failed.length > 0) process.exit(2);
+  if (failed.length > 0) {
+    await flush();
+    process.exit(2);
+  }
 }
 async function listCommand(options) {
   p.intro(pc.green("\u{1F33F} Peppermint MCP Wizard \u2014 List"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peppermint-mcp/wizard",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "One-command installer for Peppermint MCP across AI coding hosts",
   "type": "module",
   "bin": {