@peppermint-mcp/wizard 0.2.3 → 0.4.0

package/dist/cli.js

@@ -69,7 +69,7 @@ async function detectClaudeDesktop() {
     try {
       const content = readFileSync(configPath, "utf-8");
       const parsed = jsonc.parse(content);
-      alreadyInstalled = !!parsed?.mcpServers?.peppermint;
+      alreadyInstalled = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
     } catch {
       warnings.push("Config file exists but could not be parsed");
     }
@@ -77,7 +77,7 @@ async function detectClaudeDesktop() {
   return {
     id: "claude-desktop",
     name: "Claude Desktop",
-    installMethod: "file-stdio-shim",
+    installMethod: "file-native-http",
     configPath,
     alreadyInstalled,
     needsRestart: true,
@@ -106,7 +106,7 @@ async function detectCursor() {
     try {
       const content = readFileSync2(configPath, "utf-8");
       const parsed = jsonc2.parse(content);
-      alreadyInstalled = !!parsed?.mcpServers?.peppermint;
+      alreadyInstalled = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
     } catch {
       warnings.push("Config file exists but could not be parsed");
     }
@@ -197,6 +197,12 @@ function saveCredentials(creds) {
     mode: 384
   });
 }
+function clearCredentials() {
+  const path = getCredentialsPath();
+  if (existsSync3(path)) {
+    writeFileSync(path, "{}", { encoding: "utf-8", mode: 384 });
+  }
+}
 
 // src/auth/localhost-oauth.ts
 import { createServer } from "http";
@@ -382,17 +388,20 @@ async function installClaudeCode(serverUrl, apiKey, dryRun) {
     };
   }
   try {
+    for (const name of ["peppermint-memory", "peppermint"]) {
+      try {
+        await exec3("claude", ["mcp", "remove", "--scope", "user", name], { timeout: 15e3 });
+      } catch {
+      }
+    }
     await exec3("claude", args, { timeout: 15e3 });
     return {
       success: true,
       message: "Added peppermint-memory via claude mcp add",
-      needsRestart: false
+      needsRestart: true
     };
   } catch (err) {
     const message = err instanceof Error ? err.message : "claude mcp add failed";
-    if (message.includes("already exists")) {
-      return { success: true, message: "peppermint-memory already configured", needsRestart: false };
-    }
     return { success: false, message, needsRestart: false };
   }
 }
@@ -458,6 +467,9 @@ Would create: ${filePath}`;
       `Config merge produced invalid JSON: ${errors.map((e) => jsonc3.printParseErrorCode(e.error)).join(", ")}`
     );
   }
+  if (content === updated) {
+    return null;
+  }
   if (dryRun) {
     return `Would write to ${filePath}:
 ${updated}`;
@@ -507,26 +519,23 @@ function getConfigPath3() {
 async function installClaudeDesktop(serverUrl, apiKey, dryRun) {
   const configPath = getConfigPath3();
   const serverConfig = {
-    command: "npx",
-    args: [
-      "-y",
-      "mcp-remote@latest",
-      serverUrl,
-      "--header",
-      "Authorization:${PEPPERMINT_AUTH_HEADER}"
-    ],
-    env: {
-      PEPPERMINT_AUTH_HEADER: `Bearer ${apiKey}`
+    url: serverUrl,
+    headers: {
+      Authorization: `Bearer ${apiKey}`
     }
   };
   try {
+    removeServerFromConfig(configPath, "mcpServers", "peppermint", dryRun);
     const result = writeServerToConfig({
       filePath: configPath,
       serverProperty: "mcpServers",
-      serverName: "peppermint",
+      serverName: "peppermint-memory",
       serverConfig,
       dryRun
     });
+    if (result === null) {
+      return { success: true, message: "Already up to date", needsRestart: false };
+    }
     return {
       success: true,
       message: dryRun ? result : `Wrote config to ${configPath}`,
@@ -542,7 +551,7 @@ async function removeClaudeDesktop(dryRun) {
   const removed = removeServerFromConfig(
     configPath,
     "mcpServers",
-    "peppermint",
+    "peppermint-memory",
     dryRun
   );
   return {
@@ -567,13 +576,17 @@ async function installCursor(serverUrl, apiKey, dryRun) {
     }
   };
   try {
+    removeServerFromConfig(configPath, "mcpServers", "peppermint", dryRun);
     const result = writeServerToConfig({
       filePath: configPath,
       serverProperty: "mcpServers",
-      serverName: "peppermint",
+      serverName: "peppermint-memory",
       serverConfig,
       dryRun
     });
+    if (result === null) {
+      return { success: true, message: "Already up to date", needsRestart: false };
+    }
     return {
       success: true,
       message: dryRun ? result : `Wrote config to ${configPath}`,
@@ -589,7 +602,7 @@ async function removeCursor(dryRun) {
   const removed = removeServerFromConfig(
     configPath,
     "mcpServers",
-    "peppermint",
+    "peppermint-memory",
     dryRun
   );
   return {
@@ -636,6 +649,10 @@ async function installCodex(serverUrl, apiKey, dryRun) {
     if (apiKey) {
       persistCodexEnvVar(apiKey);
     }
+    try {
+      await exec4("codex", ["mcp", "remove", "peppermint-memory"], { timeout: 15e3 });
+    } catch {
+    }
     const env = { ...process.env };
     if (apiKey) {
       env.PEPPERMINT_TOKEN = apiKey;
@@ -711,12 +728,12 @@ function checkHostConfig(hostId, configPath) {
   try {
     const content = readFileSync6(configPath, "utf-8");
     const parsed = jsonc4.parse(content);
-    const hasPeppermint = !!parsed?.mcpServers?.peppermint;
+    const hasPeppermint = !!parsed?.mcpServers?.["peppermint-memory"] || !!parsed?.mcpServers?.peppermint;
     if (!hasPeppermint) {
       return {
         hostId,
         status: "fail",
-        message: "peppermint entry not found in config"
+        message: "peppermint-memory entry not found in config"
       };
     }
     return {
@@ -734,13 +751,17 @@ function checkHostConfig(hostId, configPath) {
 }
 
 // src/skills/index.ts
+import { createHash as createHash2 } from "crypto";
 import {
   copyFileSync as copyFileSync2,
   existsSync as existsSync7,
   mkdirSync as mkdirSync4,
+  readFileSync as readFileSync7,
   readdirSync,
+  renameSync as renameSync2,
   rmSync,
-  statSync
+  statSync,
+  writeFileSync as writeFileSync4
 } from "fs";
 import { homedir as homedir7 } from "os";
 import { dirname as dirname3, join as join7, resolve } from "path";
@@ -751,12 +772,26 @@ var LEGACY_SKILLS = [
   "peppermint-capture",
   "peppermint-ask-twin"
 ];
+var HASH_FILE = ".wizard-hash";
 function getSkillsBundlePath() {
   return resolve(__dirname, "..", "skills-bundle", "peppermint");
 }
 function getTargetPath() {
   return join7(homedir7(), ".claude", "skills", "peppermint");
 }
+function hashDir(dir) {
+  const hash = createHash2("sha256");
+  const entries = readdirSync(dir).sort();
+  for (const entry of entries) {
+    const fullPath = join7(dir, entry);
+    if (statSync(fullPath).isDirectory()) {
+      hash.update(hashDir(fullPath));
+    } else {
+      hash.update(readFileSync7(fullPath));
+    }
+  }
+  return hash.digest("hex");
+}
 function copyDirRecursive(src, dest) {
   mkdirSync4(dest, { recursive: true });
   for (const entry of readdirSync(src)) {
@@ -786,27 +821,41 @@ function removeLegacySkills(dryRun) {
 function installSkills(dryRun) {
   const bundlePath = getSkillsBundlePath();
   const targetPath = getTargetPath();
+  const hashFile = join7(targetPath, HASH_FILE);
   const alreadyExists = existsSync7(join7(targetPath, "SKILL.md"));
   if (!existsSync7(bundlePath)) {
-    return { installed: false, updated: false, targetPath, error: "Skills bundle not found in package" };
+    return { installed: false, updated: false, skipped: false, backedUp: false, targetPath, error: "Skills bundle not found in package" };
+  }
+  const bundleHash = hashDir(bundlePath);
+  if (alreadyExists && existsSync7(hashFile)) {
+    const installedHash = readFileSync7(hashFile, "utf-8").trim();
+    if (installedHash === bundleHash) {
+      return { installed: true, updated: false, skipped: true, backedUp: false, targetPath };
+    }
   }
   if (dryRun) {
-    return { installed: true, updated: alreadyExists, targetPath };
+    return { installed: true, updated: alreadyExists, skipped: false, backedUp: false, targetPath };
+  }
+  let backedUp = false;
+  if (alreadyExists && !existsSync7(hashFile)) {
+    const backupPath = `${targetPath}.bak.${Date.now()}`;
+    renameSync2(targetPath, backupPath);
+    backedUp = true;
+  } else if (alreadyExists) {
+    rmSync(targetPath, { recursive: true, force: true });
   }
   try {
-    if (existsSync7(targetPath)) {
-      rmSync(targetPath, { recursive: true, force: true });
-    }
     copyDirRecursive(bundlePath, targetPath);
-    return { installed: true, updated: alreadyExists, targetPath };
+    writeFileSync4(join7(targetPath, HASH_FILE), bundleHash, "utf-8");
+    return { installed: true, updated: alreadyExists, skipped: false, backedUp, targetPath };
   } catch (err) {
     const message = err instanceof Error ? err.message : "Failed to install skills";
-    return { installed: false, updated: false, targetPath, error: message };
+    return { installed: false, updated: false, skipped: false, backedUp: false, targetPath, error: message };
   }
 }
 
 // src/skills/permissions.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
 import { homedir as homedir8 } from "os";
 import { dirname as dirname4, join as join8 } from "path";
 import * as jsonc5 from "jsonc-parser";
@@ -828,7 +877,7 @@ function installPermissions(dryRun) {
   try {
     let content = "";
     if (existsSync8(settingsPath)) {
-      content = readFileSync7(settingsPath, "utf-8");
+      content = readFileSync8(settingsPath, "utf-8");
     }
     const parsed = content ? jsonc5.parse(content) : {};
     const existingAllow = parsed?.permissions?.allow || [];
@@ -848,7 +897,7 @@ function installPermissions(dryRun) {
     if (!existsSync8(dir)) {
       mkdirSync5(dir, { recursive: true });
     }
-    writeFileSync4(settingsPath, updated, "utf-8");
+    writeFileSync5(settingsPath, updated, "utf-8");
     return { added: toAdd };
   } catch (err) {
     const message = err instanceof Error ? err.message : "Failed to update permissions";
@@ -891,60 +940,92 @@ async function removeHost(host, dryRun) {
   }
 }
 async function addCommand(options) {
-  p.intro(pc.green("\u{1F33F} Peppermint MCP Wizard"));
-  const s = p.spinner();
-  s.start("Detecting AI hosts...");
+  const nonInteractive = options.yes || options.host?.length || options.authToken || !process.stdin.isTTY;
+  if (!process.stdin.isTTY && !nonInteractive) {
+    console.error("Error: peppermint-mcp-wizard requires an interactive terminal.");
+    console.error("For non-interactive installs, use: --host claude-code --yes");
+    process.exit(1);
+  }
+  if (!nonInteractive) {
+    p.intro(pc.green("\u{1F33F} Peppermint MCP Wizard"));
+  }
   const hosts = await detectHosts();
-  s.stop("Detection complete");
-  if (hosts.length === 0) {
-    p.log.error(
-      "No supported AI hosts detected. Install Claude Code, Claude Desktop, Cursor, or Codex CLI and try again."
-    );
+  if (!nonInteractive) {
+    const s = p.spinner();
+    s.start("Detecting AI hosts...");
+    s.stop("Detection complete");
+    if (hosts.length === 0) {
+      p.log.error(
+        "No supported AI hosts detected. Install Claude Code, Claude Desktop, Cursor, or Codex CLI and try again."
+      );
+      process.exit(6);
+    }
+    for (const host of hosts) {
+      const status = host.alreadyInstalled ? pc.yellow("already configured") : pc.dim("not configured");
+      const version = host.version ? pc.dim(` (${host.version})`) : "";
+      p.log.info(`${host.alreadyInstalled ? "\u26A0" : "\u2713"} ${host.name}${version}  ${status}`);
+    }
+  } else if (hosts.length === 0) {
+    console.error("No supported AI hosts detected.");
     process.exit(6);
   }
-  for (const host of hosts) {
-    const status = host.alreadyInstalled ? pc.yellow("already configured") : pc.dim("not configured");
-    const version = host.version ? pc.dim(` (${host.version})`) : "";
-    p.log.info(`${host.alreadyInstalled ? "\u26A0" : "\u2713"} ${host.name}${version}  ${status}`);
-  }
-  const unconfigured = hosts.filter((h) => !h.alreadyInstalled);
-  const toInstall = unconfigured.length > 0 ? unconfigured : hosts;
-  const selected = await p.multiselect({
-    message: "Install Peppermint MCP into which hosts?",
-    options: toInstall.map((h) => ({
-      value: h.id,
-      label: h.name,
-      hint: h.alreadyInstalled ? "will reinstall" : void 0
-    })),
-    initialValues: toInstall.map((h) => h.id)
-  });
-  if (p.isCancel(selected)) {
-    p.cancel("Cancelled.");
-    process.exit(0);
+  let selectedHosts;
+  if (options.host?.length) {
+    const requestedIds = options.host;
+    selectedHosts = hosts.filter((h) => requestedIds.includes(h.id));
+    const missing = requestedIds.filter((id) => !hosts.find((h) => h.id === id));
+    if (missing.length > 0) {
+      const msg = `Host(s) not detected: ${missing.join(", ")}`;
+      nonInteractive ? console.error(msg) : p.log.error(msg);
+      process.exit(6);
+    }
+  } else if (nonInteractive) {
+    selectedHosts = hosts;
+  } else {
+    const unconfigured = hosts.filter((h) => !h.alreadyInstalled);
+    const toInstall = unconfigured.length > 0 ? unconfigured : hosts;
+    const selected = await p.multiselect({
+      message: "Install Peppermint MCP into which hosts?",
+      options: toInstall.map((h) => ({
+        value: h.id,
+        label: h.name,
+        hint: h.alreadyInstalled ? "will reinstall" : void 0
+      })),
+      initialValues: toInstall.map((h) => h.id)
+    });
+    if (p.isCancel(selected)) {
+      p.cancel("Cancelled.");
+      process.exit(0);
+    }
+    selectedHosts = hosts.filter(
+      (h) => selected.includes(h.id)
+    );
   }
-  const selectedHosts = hosts.filter(
-    (h) => selected.includes(h.id)
-  );
-  s.start(`Checking server at ${options.server}...`);
   const serverCheck = await checkServerReachable(options.server);
   if (!serverCheck.reachable) {
-    s.stop("Server unreachable");
-    p.log.error(
-      `Cannot reach ${options.server}: ${serverCheck.error}
-Check your internet connection and try again.`
-    );
+    const msg = `Cannot reach ${options.server}: ${serverCheck.error}`;
+    nonInteractive ? console.error(msg) : p.log.error(msg);
     process.exit(4);
   }
-  s.stop(
-    `Server reachable ${pc.dim(`(${serverCheck.latencyMs}ms)`)}`
-  );
+  if (!nonInteractive) {
+    p.log.success(`Server reachable ${pc.dim(`(${serverCheck.latencyMs}ms)`)}`);
+  }
   let apiKey;
-  if (needsAuth(selectedHosts)) {
+  const tokenFromFlag = options.authToken || process.env.PEPPERMINT_AUTH_TOKEN;
+  if (tokenFromFlag) {
+    apiKey = tokenFromFlag;
+    const msg = "Using provided auth token";
+    nonInteractive ? console.log(msg) : p.log.success(msg);
+  } else if (needsAuth(selectedHosts)) {
     const base = serverBase(options.server);
     const existing = loadCredentials(base);
     if (existing) {
       apiKey = existing.api_key;
-      p.log.success(`Authenticated as ${pc.bold(existing.email || "user")} (cached)`);
+      const msg = `Authenticated as ${existing.email || "user"} (cached)`;
+      nonInteractive ? console.log(msg) : p.log.success(pc.bold(msg));
+    } else if (nonInteractive) {
+      console.error("Error: non-interactive mode requires --auth-token or PEPPERMINT_AUTH_TOKEN, or cached credentials.");
+      process.exit(3);
     } else {
       p.log.info("Opening browser for authentication...");
       try {
@@ -975,9 +1056,12 @@ Check your internet connection and try again.`
       p.log.info(`  ${pc.green("\u2713")} Removed legacy skills: ${pc.dim(removed.join(", "))}`);
     }
     const skillResult = installSkills(options.dryRun);
-    if (skillResult.installed) {
+    if (skillResult.skipped) {
+      p.log.info(`  ${pc.green("\u2713")} Peppermint skill  ${pc.dim("up to date")}`);
+    } else if (skillResult.installed) {
       const verb = skillResult.updated ? "Updated" : "Installed";
-      p.log.info(`  ${pc.green("\u2713")} ${verb} Peppermint skill  ${pc.dim(skillResult.targetPath)}`);
+      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) {
       p.log.info(`  ${pc.red("\u2717")} Skill install failed: ${pc.dim(skillResult.error)}`);
     }
@@ -1039,38 +1123,93 @@ async function doctorCommand(options) {
   p.outro("Health check complete");
 }
 async function removeCommand(options) {
-  p.intro(pc.green("\u{1F33F} Peppermint MCP Wizard \u2014 Remove"));
+  const nonInteractive = options.yes || !process.stdin.isTTY;
+  if (!process.stdin.isTTY && !nonInteractive) {
+    console.error("Error: peppermint-mcp-wizard requires an interactive terminal.");
+    console.error("For non-interactive removes, use: --yes");
+    process.exit(1);
+  }
+  if (!nonInteractive) {
+    p.intro(pc.green("\u{1F33F} Peppermint MCP Wizard \u2014 Remove"));
+  }
   const hosts = await detectHosts();
   const installed = hosts.filter((h) => h.alreadyInstalled);
   if (installed.length === 0) {
-    p.log.info("Peppermint is not installed in any detected hosts.");
+    const msg = "Peppermint is not installed in any detected hosts.";
+    nonInteractive ? console.log(msg) : p.log.info(msg);
     process.exit(0);
   }
-  const selected = await p.multiselect({
-    message: "Remove Peppermint MCP from which hosts?",
-    options: installed.map((h) => ({
-      value: h.id,
-      label: h.name
-    })),
-    initialValues: installed.map((h) => h.id)
-  });
-  if (p.isCancel(selected)) {
-    p.cancel("Cancelled.");
-    process.exit(0);
+  let selectedHosts;
+  if (nonInteractive) {
+    selectedHosts = installed;
+  } else {
+    const selected = await p.multiselect({
+      message: "Remove Peppermint MCP from which hosts?",
+      options: installed.map((h) => ({
+        value: h.id,
+        label: h.name
+      })),
+      initialValues: installed.map((h) => h.id)
+    });
+    if (p.isCancel(selected)) {
+      p.cancel("Cancelled.");
+      process.exit(0);
+    }
+    selectedHosts = hosts.filter(
+      (h) => selected.includes(h.id)
+    );
   }
-  const selectedHosts = hosts.filter(
-    (h) => selected.includes(h.id)
-  );
   for (const host of selectedHosts) {
     const result = await removeHost(host, options.dryRun);
     const icon = result.success ? pc.green("\u2713") : pc.red("\u2717");
-    p.log.info(`${icon} ${host.name}  ${pc.dim(result.message)}`);
+    nonInteractive ? console.log(`${result.success ? "\u2713" : "\u2717"} ${host.name}  ${result.message}`) : p.log.info(`${icon} ${host.name}  ${pc.dim(result.message)}`);
+  }
+  if (options.revokeToken) {
+    const base = serverBase(options.server);
+    const creds = loadCredentials(base);
+    if (creds && !options.dryRun) {
+      try {
+        const res = await fetch(`${base}/auth/api-keys`, {
+          headers: { Authorization: `Bearer ${creds.api_key}` }
+        });
+        if (res.ok) {
+          const keys = await res.json();
+          for (const key of keys) {
+            if (key.name === "mcp-wizard") {
+              await fetch(`${base}/auth/api-keys/${key.id}`, {
+                method: "DELETE",
+                headers: { Authorization: `Bearer ${creds.api_key}` }
+              });
+            }
+          }
+        }
+        clearCredentials();
+        const msg = "Revoked API key and cleared credentials";
+        nonInteractive ? console.log(`\u2713 ${msg}`) : p.log.info(`${pc.green("\u2713")} ${msg}`);
+      } catch {
+        const msg = "Failed to revoke API key (credentials cleared locally)";
+        clearCredentials();
+        nonInteractive ? console.log(`\u26A0 ${msg}`) : p.log.info(`${pc.yellow("\u26A0")} ${msg}`);
+      }
+    } else if (creds && options.dryRun) {
+      const msg = "Would revoke API key and clear credentials";
+      nonInteractive ? console.log(msg) : p.log.info(msg);
+    }
+  }
+  if (!nonInteractive) {
+    p.outro("Removal complete");
   }
-  p.outro("Removal complete");
 }
 var program = new Command().name("peppermint-mcp-wizard").description("One-command installer for Peppermint MCP").version("0.1.0");
-program.command("add", { isDefault: true }).description("Detect hosts, authenticate, install MCP config").option("--server <url>", "MCP server URL", DEFAULT_SERVER).option("--dry-run", "Print changes without writing", false).option("--no-verify", "Skip post-install verification").action((opts) => addCommand({ server: opts.server, dryRun: opts.dryRun, verify: opts.verify }));
+program.command("add", { isDefault: true }).description("Detect hosts, authenticate, install MCP config").option("--server <url>", "MCP server URL", DEFAULT_SERVER).option("--dry-run", "Print changes without writing", false).option("--no-verify", "Skip post-install verification").option("--host <id...>", "Install to specific hosts (claude-code, claude-desktop, cursor, codex)").option("--yes", "Skip all prompts (non-interactive)", false).option("--auth-token <token>", "API key or token for auth (skips browser OAuth)").action((opts) => addCommand({
+  server: opts.server,
+  dryRun: opts.dryRun,
+  verify: opts.verify,
+  host: opts.host,
+  yes: opts.yes,
+  authToken: opts.authToken
+}));
 program.command("list").description("List detected AI hosts and their Peppermint status").option("--server <url>", "MCP server URL", DEFAULT_SERVER).action((opts) => listCommand({ server: opts.server }));
 program.command("doctor").description("Run health checks on existing installation").option("--server <url>", "MCP server URL", DEFAULT_SERVER).action((opts) => doctorCommand({ server: opts.server }));
-program.command("remove").description("Remove Peppermint MCP from selected hosts").option("--server <url>", "MCP server URL", DEFAULT_SERVER).option("--dry-run", "Print changes without writing", false).action((opts) => removeCommand({ server: opts.server, dryRun: opts.dryRun }));
+program.command("remove").description("Remove Peppermint MCP from selected hosts").option("--server <url>", "MCP server URL", DEFAULT_SERVER).option("--dry-run", "Print changes without writing", false).option("--yes", "Skip all prompts (non-interactive)", false).option("--revoke-token", "Revoke API key on the server", true).option("--no-revoke-token", "Keep API key for future re-installs").action((opts) => removeCommand({ server: opts.server, dryRun: opts.dryRun, yes: opts.yes, revokeToken: opts.revokeToken }));
 program.parse();

package/package.json

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