@memoraone/mcp 0.1.33 → 0.1.34

package/dist/cli.cjs

@@ -30,7 +30,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@memoraone/mcp",
-      version: "0.1.33",
+      version: "0.1.34",
       type: "module",
       main: "dist/index.cjs",
       bin: {
@@ -1419,8 +1419,9 @@ function logCursorMcpConfigAudit(prefix, audit) {
     );
   }
 }
-function logCursorMcpCliSummary(info, dryRun) {
+function logCursorMcpCliSummary(info, dryRun, opts) {
   const { repoConfigPath, repoOutcome, npxPath, cliPath, repoBackupPath, globalConfigPath, globalMemoraoneRemoved, globalBackupPath } = info;
+  const interactive = opts?.forInteractivePostSetup === true;
   console.log(`[setup-ide-files] Cursor repo MCP config: ${repoConfigPath}`);
   if (cliPath) {
     console.log(`[setup-ide-files] Resolved local CLI: ${cliPath}`);
@@ -1430,16 +1431,18 @@ function logCursorMcpCliSummary(info, dryRun) {
   if (repoBackupPath) {
     console.log(`[setup-ide-files] Cursor repo MCP config backup: ${repoBackupPath}`);
   }
-  if (repoOutcome === "created") {
-    console.log(
-      dryRun ? `[setup-ide-files] Cursor repo MCP config would be created: ${repoConfigPath}` : `[setup-ide-files] Cursor repo MCP config created: ${repoConfigPath}`
-    );
-  } else if (repoOutcome === "updated") {
-    console.log(
-      dryRun ? `[setup-ide-files] Cursor repo MCP config would be updated: ${repoConfigPath}` : `[setup-ide-files] Cursor repo MCP config updated: ${repoConfigPath}`
-    );
-  } else if (repoOutcome === "skipped") {
-    console.log(`[setup-ide-files] Cursor repo MCP config unchanged: ${repoConfigPath}`);
+  if (!interactive) {
+    if (repoOutcome === "created") {
+      console.log(
+        dryRun ? `[setup-ide-files] Cursor repo MCP config would be created: ${repoConfigPath}` : `[setup-ide-files] Cursor repo MCP config created: ${repoConfigPath}`
+      );
+    } else if (repoOutcome === "updated") {
+      console.log(
+        dryRun ? `[setup-ide-files] Cursor repo MCP config would be updated: ${repoConfigPath}` : `[setup-ide-files] Cursor repo MCP config updated: ${repoConfigPath}`
+      );
+    } else if (repoOutcome === "skipped") {
+      console.log(`[setup-ide-files] Cursor repo MCP config unchanged: ${repoConfigPath}`);
+    }
   }
   if (globalMemoraoneRemoved && globalConfigPath) {
     console.log(
@@ -1456,9 +1459,11 @@ function logCursorMcpCliSummary(info, dryRun) {
   console.log(
     "[setup-ide-files] Each Cursor window uses this repo\u2019s .cursor/mcp.json (separate MCP process per repo)."
   );
-  console.log(
-    "[setup-ide-files] Fully quit Cursor and reopen this repo for MCP changes to take effect."
-  );
+  if (!interactive) {
+    console.log(
+      "[setup-ide-files] Fully quit Cursor and reopen this repo for MCP changes to take effect."
+    );
+  }
 }
 
 // src/cleanup.ts
@@ -2391,6 +2396,234 @@ async function resolveBuiltCliPathAsync(options) {
   return null;
 }
 
+// src/openCursorMcpSettings.ts
+var import_node_child_process5 = require("child_process");
+var readline4 = __toESM(require("readline/promises"), 1);
+var import_node_util3 = require("util");
+
+// src/terminalPresentation.ts
+var ANSI = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m"
+};
+function isCiLikeEnv(env = process.env) {
+  if (env.CI === "true" || env.CI === "1") return true;
+  if (env.GITHUB_ACTIONS === "true" || env.GITHUB_ACTIONS === "1") return true;
+  if (env.GITLAB_CI === "true" || env.GITLAB_CI === "1") return true;
+  if (env.CIRCLECI === "true" || env.CIRCLECI === "1") return true;
+  if (env.BUILDKITE === "true" || env.BUILDKITE === "1") return true;
+  if (typeof env.CI === "string" && env.CI.trim() !== "" && env.CI !== "0" && env.CI !== "false") {
+    return true;
+  }
+  return false;
+}
+function shouldEnableAnsiColor(opts = {}) {
+  if (typeof opts.color === "boolean") return opts.color;
+  const env = opts.env ?? process.env;
+  if (env.NO_COLOR !== void 0) return false;
+  if (isCiLikeEnv(env)) return false;
+  const tty = opts.stdoutIsTty ?? process.stdout.isTTY === true;
+  return tty;
+}
+function shouldUseUnicodeSymbols(opts = {}) {
+  if (typeof opts.unicode === "boolean") return opts.unicode;
+  const env = opts.env ?? process.env;
+  const tty = opts.stdoutIsTty ?? process.stdout.isTTY === true;
+  if (!tty) return false;
+  if (env.TERM === "dumb") return false;
+  if (process.platform === "win32") {
+    return Boolean(
+      env.WT_SESSION || env.WT_PROFILE_ID || env.ConEmuANSI === "ON" || env.TERM_PROGRAM === "vscode" || env.TERM_PROGRAM === "cursor" || typeof env.TERM === "string" && env.TERM !== "" && env.TERM !== "dumb"
+    );
+  }
+  return true;
+}
+function paint(enabled, code, text) {
+  if (!enabled || text === "") return text;
+  return `${code}${text}${ANSI.reset}`;
+}
+function createTerminalPresentation(opts = {}) {
+  const color = shouldEnableAnsiColor(opts);
+  const unicode = shouldUseUnicodeSymbols(opts);
+  const successSymbol = unicode ? "\u2713" : "[OK]";
+  const warningSymbol = unicode ? "\u26A0" : "[WARN]";
+  const nextActionPrefix = unicode ? "\u2192" : "Next:";
+  return {
+    color,
+    unicode,
+    bold: (text) => paint(color, ANSI.bold, text),
+    green: (text) => paint(color, ANSI.green, text),
+    cyan: (text) => paint(color, ANSI.cyan, text),
+    yellow: (text) => paint(color, ANSI.yellow, text),
+    dim: (text) => paint(color, ANSI.dim, text),
+    successSymbol,
+    warningSymbol,
+    nextActionPrefix,
+    successLine: (message) => paint(color, ANSI.green, `${successSymbol} ${message}`),
+    warningLine: (message) => paint(color, ANSI.yellow, `${warningSymbol} ${message}`),
+    nextActionLine: (message) => `${nextActionPrefix} ${message}`,
+    heading: (text) => paint(color, ANSI.bold, text),
+    indent: (text) => `  ${text}`
+  };
+}
+
+// src/openCursorMcpSettings.ts
+var execFileAsync3 = (0, import_node_util3.promisify)(import_node_child_process5.execFile);
+var OPEN_CURSOR_MCP_SETTINGS_PROMPT = "Open Cursor MCP settings now? [Y/n] ";
+function resolvePresentation(deps) {
+  if (deps.presentation) return deps.presentation;
+  const opts = {
+    env: deps.env ?? process.env,
+    stdoutIsTty: deps.stdoutIsTty ?? process.stdout.isTTY === true,
+    color: deps.color,
+    unicode: deps.unicode
+  };
+  return createTerminalPresentation(opts);
+}
+function shouldPromptOpenCursorMcpSettings(opts) {
+  if (!opts.explicitCursor) return false;
+  if (opts.all) return false;
+  if (opts.dryRun) return false;
+  if (!opts.stdinIsTty) return false;
+  if (isCiLikeEnv(opts.env ?? process.env)) return false;
+  return true;
+}
+function isYesDefaultAnswer(answer) {
+  const trimmed = answer.trim();
+  if (trimmed === "") return true;
+  if (/^y(es)?$/i.test(trimmed)) return true;
+  if (/^n(o)?$/i.test(trimmed)) return false;
+  return false;
+}
+async function confirmYesDefault(question, deps = {}) {
+  if (deps.ask) {
+    return isYesDefaultAnswer(await deps.ask(question));
+  }
+  const input2 = deps.input ?? process.stdin;
+  const output2 = deps.output ?? process.stdout;
+  if (!("isTTY" in input2) || !input2.isTTY) {
+    return false;
+  }
+  const rl = readline4.createInterface({ input: input2, output: output2 });
+  try {
+    const answer = await rl.question(question.endsWith(" ") ? question : `${question} `);
+    return isYesDefaultAnswer(answer);
+  } finally {
+    rl.close();
+  }
+}
+function collectOutcomePaths(outcomes) {
+  const created = [];
+  const updated = [];
+  for (const [file, outcome] of Object.entries(outcomes)) {
+    if (outcome === "created") created.push(file);
+    else if (outcome === "updated") updated.push(file);
+  }
+  return { created, updated };
+}
+function formatCursorSetupCompletedSummary(opts, presentation = createTerminalPresentation({ color: false, unicode: false })) {
+  const { created, updated } = collectOutcomePaths(opts.outcomes);
+  const tp = presentation;
+  const lines = [
+    tp.successLine("MemoraOne setup completed for Cursor"),
+    "",
+    tp.heading("Repository"),
+    tp.indent(tp.cyan(opts.repoRoot)),
+    "",
+    tp.heading("Changes")
+  ];
+  if (created.length === 0 && updated.length === 0) {
+    lines.push(tp.indent(tp.dim("No file changes needed")));
+  } else {
+    if (created.length) {
+      lines.push(tp.indent(`Created: ${created.join(", ")}`));
+    }
+    if (updated.length) {
+      lines.push(tp.indent(`Updated: ${updated.join(", ")}`));
+    }
+  }
+  return lines;
+}
+function printCursorSetupCompletedSummary(opts, println = console.log, presentation) {
+  const tp = presentation ?? createTerminalPresentation();
+  for (const line of formatCursorSetupCompletedSummary(opts, tp)) {
+    println(line);
+  }
+}
+function macosOpenCursorMcpSettingsAppleScript() {
+  return [
+    'tell application "Cursor" to activate',
+    "delay 0.5",
+    'tell application "System Events"',
+    'keystroke "p" using {command down, shift down}',
+    "delay 0.4",
+    'keystroke "View: Open MCP Settings"',
+    "delay 0.4",
+    "key code 36",
+    "end tell"
+  ].join("\n");
+}
+async function openCursorMcpSettingsViaOsascript(execFileImpl = execFileAsync3) {
+  await execFileImpl("osascript", ["-e", macosOpenCursorMcpSettingsAppleScript()], {
+    timeout: 3e4
+  });
+}
+function manualCursorMcpSettingsSteps(platform) {
+  const chord = platform === "darwin" ? "Command + Shift + P" : "Ctrl + Shift + P";
+  return [
+    "To finish setup manually:",
+    "1. Open this repository in Cursor.",
+    `2. Press ${chord}.`,
+    '3. Run "View: Open MCP Settings".',
+    '4. Find "memoraone" and enable it.',
+    "5. Confirm it turns green.",
+    "6. Return to MemoraOne Studio and refresh Sources."
+  ];
+}
+function printManualCursorMcpSettingsSteps(platform, println = console.log) {
+  for (const line of manualCursorMcpSettingsSteps(platform)) {
+    println(line);
+  }
+}
+function formatOpenCursorMcpSettingsPrompt(presentation = createTerminalPresentation({ color: false, unicode: false })) {
+  return `${presentation.indent(OPEN_CURSOR_MCP_SETTINGS_PROMPT.trimEnd())} `;
+}
+async function runOpenCursorMcpSettingsFlow(deps = {}) {
+  const platform = deps.platform ?? process.platform;
+  const println = deps.println ?? console.log;
+  const tp = resolvePresentation(deps);
+  const confirm = deps.confirm ?? ((question) => confirmYesDefault(question));
+  println("");
+  println(tp.heading("Next"));
+  const yes = await confirm(formatOpenCursorMcpSettingsPrompt(tp));
+  if (!yes) {
+    printManualCursorMcpSettingsSteps(platform, println);
+    return;
+  }
+  if (platform === "darwin") {
+    println(tp.warningLine("macOS may request Automation or Accessibility permission."));
+    try {
+      const open = deps.openViaOsascript ?? (() => openCursorMcpSettingsViaOsascript(deps.execFile ?? execFileAsync3));
+      await open();
+      println(tp.successLine('Confirm "memoraone" is enabled and green'));
+      println(tp.nextActionLine("Return to MemoraOne Studio and refresh Sources"));
+    } catch (err) {
+      const detail = err instanceof Error ? err.message : String(err);
+      println(tp.warningLine(`Could not open Cursor MCP settings automatically (${detail}).`));
+      println(
+        "Permission may be required at: System Settings \u2192 Privacy & Security \u2192 Accessibility"
+      );
+      printManualCursorMcpSettingsSteps("darwin", println);
+    }
+    return;
+  }
+  printManualCursorMcpSettingsSteps(platform, println);
+}
+
 // src/setupIdeFiles.ts
 var MANAGED_MARKER = "<!-- MemoraOne managed IDE helper -->";
 var GITIGNORE_MEMORAONE_COMMENT = "# MemoraOne local project binding / API key";
@@ -2627,7 +2860,21 @@ function parseSetupIdeFlags(argv) {
   if (local && staging) {
     flagError = "[setup-ide-files] --local and --staging are mutually exclusive.";
   }
-  return { targets, force, dryRun, noGitignore, cleanup, devMode, repair, local, staging, all, unknown, flagError };
+  return {
+    targets,
+    force,
+    dryRun,
+    noGitignore,
+    cleanup,
+    devMode,
+    repair,
+    local,
+    staging,
+    all,
+    explicitCursor: cursor,
+    unknown,
+    flagError
+  };
 }
 function cursorEnvironmentFromFlags(local, staging) {
   if (local) return "local";
@@ -2892,7 +3139,7 @@ description: MemoraOne MCP \u2014 IDE agent instructions
       homeDir: o.homeDir,
       explicitPath: o.cursorGlobalMcpConfigPath
     });
-    if (!globalDetection.ok) {
+    if (globalDetection.ok === false) {
       return {
         exitCode: 1,
         repoRoot,
@@ -2991,8 +3238,22 @@ description: MemoraOne MCP \u2014 IDE agent instructions
   }
   return { exitCode: 0, repoRoot, outcomes, cursorMcp, jetbrainsMcp, daemonCleanup };
 }
-async function cliSetupIdeFiles(argv) {
-  const { targets, force, dryRun, noGitignore, cleanup, devMode, repair, local, staging, unknown, flagError } = parseSetupIdeFlags(argv);
+async function cliSetupIdeFiles(argv, options = {}) {
+  const {
+    targets,
+    force,
+    dryRun,
+    noGitignore,
+    cleanup,
+    devMode,
+    repair,
+    local,
+    staging,
+    all,
+    explicitCursor,
+    unknown,
+    flagError
+  } = parseSetupIdeFlags(argv);
   if (flagError) {
     console.error(flagError);
     return 1;
@@ -3001,15 +3262,27 @@ async function cliSetupIdeFiles(argv) {
     console.error(`[setup-ide-files] Unknown option(s): ${unknown.join(", ")}`);
     return 1;
   }
+  const cwd = options.cwd ?? process.cwd();
+  const openDeps = options.openCursorMcpSettings ?? {};
+  const stdinIsTty = openDeps.stdinIsTty ?? process.stdin.isTTY === true;
+  const env = openDeps.env ?? process.env;
+  const promptOpenCursorSettings = shouldPromptOpenCursorMcpSettings({
+    explicitCursor,
+    all,
+    dryRun,
+    stdinIsTty,
+    env
+  });
   const result = await runSetupIdeFiles({
-    cwd: process.cwd(),
+    cwd,
     targets,
     force,
     dryRun,
-    noGitignore,
+    noGitignore: options.setupOverrides?.noGitignore ?? noGitignore,
     devMode,
     repair,
-    cursorEnvironment: cursorEnvironmentFromFlags(local, staging)
+    cursorEnvironment: cursorEnvironmentFromFlags(local, staging),
+    ...options.setupOverrides
   });
   if (result.error) {
     console.error(result.error);
@@ -3026,23 +3299,45 @@ async function cliSetupIdeFiles(argv) {
     logSetupIdeCleanupSummary(result.daemonCleanup);
   }
   if (targets.cursor && result.cursorMcp) {
-    logCursorMcpCliSummary(result.cursorMcp, dryRun);
+    logCursorMcpCliSummary(result.cursorMcp, dryRun, {
+      forInteractivePostSetup: promptOpenCursorSettings
+    });
   }
   if (targets.jetbrains && result.jetbrainsMcp) {
     logJetBrainsMcpCliSummary(result.jetbrainsMcp, dryRun);
   }
-  summarizeOutcomes(result.outcomes);
-  if (dryRun) {
-    console.log("[setup-ide-files] Dry run: no files written.");
-    if (result.daemonCleanup && !result.daemonCleanup.skipped) {
-      console.log("[setup-ide-files] Dry run: no daemons stopped, no sockets removed.");
+  if (promptOpenCursorSettings && result.repoRoot) {
+    const presentation = openDeps.presentation ?? createTerminalPresentation({
+      env,
+      stdoutIsTty: openDeps.stdoutIsTty ?? process.stdout.isTTY === true,
+      color: openDeps.color,
+      unicode: openDeps.unicode
+    });
+    printCursorSetupCompletedSummary(
+      { repoRoot: result.repoRoot, outcomes: result.outcomes },
+      openDeps.println,
+      presentation
+    );
+    await runOpenCursorMcpSettingsFlow({
+      ...openDeps,
+      stdinIsTty,
+      env,
+      presentation
+    });
+  } else {
+    summarizeOutcomes(result.outcomes);
+    if (dryRun) {
+      console.log("[setup-ide-files] Dry run: no files written.");
+      if (result.daemonCleanup && !result.daemonCleanup.skipped) {
+        console.log("[setup-ide-files] Dry run: no daemons stopped, no sockets removed.");
+      }
     }
+    console.log(`[setup-ide-files] ${restartIdeInstruction(targets)}`);
   }
-  console.log(`[setup-ide-files] ${restartIdeInstruction(targets)}`);
   if (cleanup) {
     console.log("[setup-ide-files] Running additional full-project cleanup (--cleanup)...");
     const cleanupResult = await runCleanup({
-      cwd: process.cwd(),
+      cwd,
       dryRun,
       allProjects: false,
       assumeYes: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoraone/mcp",
-  "version": "0.1.33",
+  "version": "0.1.34",
   "type": "module",
   "main": "dist/index.cjs",
   "bin": {