@memoraone/mcp 0.1.32 → 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.32",
+      version: "0.1.34",
       type: "module",
       main: "dist/index.cjs",
       bin: {
@@ -562,8 +562,8 @@ var StdioLineReader = class {
     if (this.closed) {
       return null;
     }
-    return new Promise((resolve8) => {
-      this.waiters.push(resolve8);
+    return new Promise((resolve9) => {
+      this.waiters.push(resolve9);
     });
   }
   /** Re-queue lines read during an intermediate protocol step (e.g. roots/list) for the main bridge loop. */
@@ -822,9 +822,9 @@ function summarizeJsonRpcMethod(line) {
   }
 }
 function connectWithRetry(socketPath, log, maxRetries, retryDelayMs, connect2) {
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const tryConnect = (attempt) => {
-      connect2(socketPath).then(resolve8).catch((err) => {
+      connect2(socketPath).then(resolve9).catch((err) => {
         if (attempt >= maxRetries) {
           reject(err);
           return;
@@ -897,8 +897,8 @@ var BridgeDaemonRouter = class {
     this.maxRetries = options.maxRetries ?? 5;
     this.retryDelayMs = options.retryDelayMs ?? 200;
     this.lineReader = options.lineReader ?? null;
-    this.connectImpl = options.connect ?? ((socketPath) => new Promise((resolve8, reject) => {
-      const socket = net.connect(socketPath, () => resolve8(socket));
+    this.connectImpl = options.connect ?? ((socketPath) => new Promise((resolve9, reject) => {
+      const socket = net.connect(socketPath, () => resolve9(socket));
       socket.on("error", reject);
     }));
     this.spawnDaemonImpl = options.spawnDaemon ?? (async (binding) => {
@@ -1142,9 +1142,9 @@ async function runBridgeProxy(options) {
 }
 
 // src/setupIdeFiles.ts
-var fs7 = __toESM(require("fs/promises"), 1);
+var fs8 = __toESM(require("fs/promises"), 1);
 var os4 = __toESM(require("os"), 1);
-var path9 = __toESM(require("path"), 1);
+var path10 = __toESM(require("path"), 1);
 
 // src/cleanup.ts
 var fs5 = __toESM(require("fs/promises"), 1);
@@ -1163,17 +1163,36 @@ var import_node_util = require("util");
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process2.execFile);
 var MEMORAONE_PROD_API_URL = "https://api.memoraone.com";
 var MEMORAONE_LOCAL_API_URL = "http://localhost:3001";
+var MEMORAONE_STAGING_API_URL = "https://memora-api-staging-phbtrzocjq-uk.a.run.app";
 var MEMORAONE_STAGING_API_URL_PREFIX = "https://memora-api-staging-";
-function buildMemoraoneCursorMcpServer(npxPath, workspaceRoot) {
+function cursorMcpApiUrl(environment) {
+  if (environment === "local") return MEMORAONE_LOCAL_API_URL;
+  if (environment === "staging") return MEMORAONE_STAGING_API_URL;
+  return MEMORAONE_PROD_API_URL;
+}
+function buildMemoraoneCursorMcpServer(options) {
   const env = {
-    MEMORAONE_API_URL: MEMORAONE_PROD_API_URL,
+    MEMORAONE_API_URL: cursorMcpApiUrl(options.environment),
     MEMORAONE_IDE_TYPE: "cursor"
   };
-  if (workspaceRoot !== void 0) {
-    env[MEMORAONE_WORKSPACE_ROOT_ENV] = path6.resolve(workspaceRoot);
+  if (options.workspaceRoot !== void 0) {
+    env[MEMORAONE_WORKSPACE_ROOT_ENV] = path6.resolve(options.workspaceRoot);
+  }
+  if (options.environment === "local") {
+    if (!options.cliPath) {
+      throw new Error("[setup-ide-files] Local Cursor MCP config requires a built CLI path.");
+    }
+    return {
+      command: "node",
+      args: [options.cliPath],
+      env
+    };
+  }
+  if (!options.npxPath) {
+    throw new Error("[setup-ide-files] Cursor MCP config requires a resolved npx path.");
   }
   return {
-    command: npxPath,
+    command: options.npxPath,
     args: ["-y", "@memoraone/mcp@latest"],
     env
   };
@@ -1272,10 +1291,16 @@ async function resolveNpxPath() {
   }
   return null;
 }
-function mergeCursorRepoMcpConfigObject(existing, npxPath, repoRoot) {
+function mergeCursorRepoMcpConfigObject(existing, writeOptions) {
+  const environment = writeOptions.environment ?? "production";
   const base = existing && typeof existing === "object" ? { ...existing } : { mcpServers: {} };
   const mcpServers = typeof base.mcpServers === "object" && base.mcpServers !== null && !Array.isArray(base.mcpServers) ? { ...base.mcpServers } : {};
-  mcpServers.memoraone = buildMemoraoneCursorMcpServer(npxPath, repoRoot);
+  mcpServers.memoraone = buildMemoraoneCursorMcpServer({
+    environment,
+    npxPath: writeOptions.npxPath,
+    cliPath: writeOptions.cliPath,
+    workspaceRoot: writeOptions.repoRoot
+  });
   return { ...base, mcpServers };
 }
 function isMemoraoneManagedApiUrl(url) {
@@ -1394,23 +1419,30 @@ function logCursorMcpConfigAudit(prefix, audit) {
     );
   }
 }
-function logCursorMcpCliSummary(info, dryRun) {
-  const { repoConfigPath, repoOutcome, npxPath, repoBackupPath, globalConfigPath, globalMemoraoneRemoved, globalBackupPath } = info;
+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}`);
-  console.log(`[setup-ide-files] Resolved npx: ${npxPath}`);
+  if (cliPath) {
+    console.log(`[setup-ide-files] Resolved local CLI: ${cliPath}`);
+  } else if (npxPath) {
+    console.log(`[setup-ide-files] Resolved npx: ${npxPath}`);
+  }
   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(
@@ -1427,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
@@ -2094,7 +2128,7 @@ async function buildJetBrainsMemoraoneServer(options) {
 async function verifyJetBrainsMcpHandshake(options) {
   const timeoutMs = options.timeoutMs ?? 15e3;
   const { server } = options;
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     let settled = false;
     const finish = (ok, detail) => {
       if (settled) return;
@@ -2104,7 +2138,7 @@ async function verifyJetBrainsMcpHandshake(options) {
         child.kill();
       } catch {
       }
-      resolve8({ ok, detail });
+      resolve9({ ok, detail });
     };
     const child = (0, import_node_child_process4.spawn)(server.command, [...server.args], {
       env: { ...process.env, ...server.env },
@@ -2308,6 +2342,288 @@ function logJetBrainsMcpCliSummary(info, dryRun) {
   );
 }
 
+// src/resolveBuiltCliPath.ts
+var fs7 = __toESM(require("fs/promises"), 1);
+var path9 = __toESM(require("path"), 1);
+var MONOREPO_CLI_REL = path9.join("packages", "mcp", "dist", "cli.cjs");
+async function pathExists3(filePath) {
+  try {
+    await fs7.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findMonorepoCliFrom(startDir) {
+  let current = path9.resolve(startDir);
+  const root = path9.parse(current).root;
+  while (true) {
+    const candidate = path9.join(current, MONOREPO_CLI_REL);
+    if (await pathExists3(candidate)) {
+      return path9.resolve(candidate);
+    }
+    if (current === root) break;
+    current = path9.dirname(current);
+  }
+  return null;
+}
+async function resolveBuiltCliPathAsync(options) {
+  const searchDirs = [];
+  if (options?.searchFrom !== void 0) {
+    const dirs = Array.isArray(options.searchFrom) ? options.searchFrom : [options.searchFrom];
+    searchDirs.push(...dirs);
+  }
+  searchDirs.push(process.cwd());
+  const seen = /* @__PURE__ */ new Set();
+  for (const dir of searchDirs) {
+    const key = path9.resolve(dir);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    const found = await findMonorepoCliFrom(key);
+    if (found) return found;
+  }
+  const here = process.argv[1] ? path9.dirname(path9.resolve(process.argv[1])) : process.cwd();
+  const candidates = [
+    path9.join(here, "cli.cjs"),
+    path9.join(here, "..", "dist", "cli.cjs"),
+    path9.join(here, "..", "..", "dist", "cli.cjs")
+  ];
+  for (const candidate of candidates) {
+    if (await pathExists3(candidate)) {
+      return path9.resolve(candidate);
+    }
+  }
+  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";
@@ -2323,15 +2639,15 @@ function buildMemoraoneMcpServer(ideType, command = "npx") {
   };
 }
 function assertUnderRepoRoot(repoRoot, absPath) {
-  const normRoot = path9.resolve(repoRoot) + path9.sep;
-  const normPath = path9.resolve(absPath);
-  if (normPath !== path9.resolve(repoRoot) && !normPath.startsWith(normRoot)) {
+  const normRoot = path10.resolve(repoRoot) + path10.sep;
+  const normPath = path10.resolve(absPath);
+  if (normPath !== path10.resolve(repoRoot) && !normPath.startsWith(normRoot)) {
     throw new Error(`[setup-ide-files] Refusing to write outside repo root: ${absPath}`);
   }
 }
-async function pathExists3(filePath) {
+async function pathExists4(filePath) {
   try {
-    await fs7.access(filePath);
+    await fs8.access(filePath);
     return true;
   } catch {
     return false;
@@ -2352,12 +2668,12 @@ ${GITIGNORE_MEMORAONE_ENTRY}
 }
 async function ensureGitignoreMemoraone(repoRoot, opts) {
   if (opts.noGitignore) return "skipped";
-  const abs = path9.join(repoRoot, ".gitignore");
+  const abs = path10.join(repoRoot, ".gitignore");
   assertUnderRepoRoot(repoRoot, abs);
   let prior = "";
   let existed = false;
   try {
-    prior = await fs7.readFile(abs, "utf8");
+    prior = await fs8.readFile(abs, "utf8");
     existed = true;
   } catch (err) {
     const code = err && typeof err === "object" && "code" in err ? err.code : void 0;
@@ -2368,22 +2684,22 @@ async function ensureGitignoreMemoraone(repoRoot, opts) {
   const separator = existed && prior.length > 0 ? prior.endsWith("\n") ? "\n" : "\n\n" : "";
   const next = (existed ? prior : "") + separator + block;
   if (opts.dryRun) return existed ? "updated" : "created";
-  await fs7.writeFile(abs, next, "utf8");
+  await fs8.writeFile(abs, next, "utf8");
   return existed ? "updated" : "created";
 }
 async function findRepoRoot(startDir) {
-  let current = path9.resolve(startDir);
-  const root = path9.parse(current).root;
+  let current = path10.resolve(startDir);
+  const root = path10.parse(current).root;
   while (true) {
-    const gitPath = path9.join(current, ".git");
-    const m1Path = path9.join(current, "memoraone.m1");
-    if (await pathExists3(gitPath) || await pathExists3(m1Path)) {
+    const gitPath = path10.join(current, ".git");
+    const m1Path = path10.join(current, "memoraone.m1");
+    if (await pathExists4(gitPath) || await pathExists4(m1Path)) {
       return current;
     }
     if (current === root) {
       return null;
     }
-    current = path9.dirname(current);
+    current = path10.dirname(current);
   }
 }
 function stripLeadingLineComments3(text) {
@@ -2436,47 +2752,47 @@ function buildVscodeMcpJsonBody(existing) {
   const merged = { ...base, servers };
   return mcpJsonHeader() + JSON.stringify(merged, null, 2) + "\n";
 }
-function buildCursorMcpJsonBody(existing, npxPath, repoRoot) {
-  const merged = mergeCursorRepoMcpConfigObject(existing, npxPath, repoRoot);
+function buildCursorMcpJsonBody(existing, writeOptions) {
+  const merged = mergeCursorRepoMcpConfigObject(existing, writeOptions);
   return mcpJsonHeader() + JSON.stringify(merged, null, 2) + "\n";
 }
 async function writeManagedMarkdown(repoRoot, relPath, fullContent, opts) {
-  const abs = path9.join(repoRoot, relPath);
+  const abs = path10.join(repoRoot, relPath);
   assertUnderRepoRoot(repoRoot, abs);
   let prior = "";
   let existed = false;
   try {
-    prior = await fs7.readFile(abs, "utf8");
+    prior = await fs8.readFile(abs, "utf8");
     existed = true;
   } catch (err) {
     if (err?.code !== "ENOENT") throw err;
   }
   if (!existed) {
     if (opts.dryRun) return "created";
-    await fs7.mkdir(path9.dirname(abs), { recursive: true });
-    await fs7.writeFile(abs, fullContent, "utf8");
+    await fs8.mkdir(path10.dirname(abs), { recursive: true });
+    await fs8.writeFile(abs, fullContent, "utf8");
     return "created";
   }
   if (prior.includes(MANAGED_MARKER)) {
     if (prior === fullContent) return "skipped";
     if (opts.dryRun) return "updated";
-    await fs7.mkdir(path9.dirname(abs), { recursive: true });
-    await fs7.writeFile(abs, fullContent, "utf8");
+    await fs8.mkdir(path10.dirname(abs), { recursive: true });
+    await fs8.writeFile(abs, fullContent, "utf8");
     return "updated";
   }
   if (!opts.force) return "skipped-untracked";
   if (opts.dryRun) return "updated";
-  await fs7.mkdir(path9.dirname(abs), { recursive: true });
-  await fs7.writeFile(abs, fullContent, "utf8");
+  await fs8.mkdir(path10.dirname(abs), { recursive: true });
+  await fs8.writeFile(abs, fullContent, "utf8");
   return "updated";
 }
 async function writeIdeMcpJson(repoRoot, relPath, buildBody, opts) {
-  const abs = path9.join(repoRoot, relPath);
+  const abs = path10.join(repoRoot, relPath);
   assertUnderRepoRoot(repoRoot, abs);
   let raw = "";
   let existed = false;
   try {
-    raw = await fs7.readFile(abs, "utf8");
+    raw = await fs8.readFile(abs, "utf8");
     existed = true;
   } catch (err) {
     if (err?.code !== "ENOENT") throw err;
@@ -2484,8 +2800,8 @@ async function writeIdeMcpJson(repoRoot, relPath, buildBody, opts) {
   if (!existed) {
     const body = buildBody(null);
     if (opts.dryRun) return "created";
-    await fs7.mkdir(path9.dirname(abs), { recursive: true });
-    await fs7.writeFile(abs, body, "utf8");
+    await fs8.mkdir(path10.dirname(abs), { recursive: true });
+    await fs8.writeFile(abs, body, "utf8");
     return "created";
   }
   const managed = raw.includes(MANAGED_MARKER);
@@ -2500,8 +2816,8 @@ async function writeIdeMcpJson(repoRoot, relPath, buildBody, opts) {
   const next = buildBody(parsed);
   if (managed && next === raw) return "skipped";
   if (opts.dryRun) return "updated";
-  await fs7.mkdir(path9.dirname(abs), { recursive: true });
-  await fs7.writeFile(abs, next, "utf8");
+  await fs8.mkdir(path10.dirname(abs), { recursive: true });
+  await fs8.writeFile(abs, next, "utf8");
   return "updated";
 }
 function parseSetupIdeFlags(argv) {
@@ -2515,6 +2831,8 @@ function parseSetupIdeFlags(argv) {
   let cleanup = false;
   let devMode = false;
   let repair = false;
+  let local = false;
+  let staging = false;
   const unknown = [];
   for (const a of argv) {
     if (a === "--cursor") cursor = true;
@@ -2527,6 +2845,8 @@ function parseSetupIdeFlags(argv) {
     else if (a === "--cleanup") cleanup = true;
     else if (a === "--dev") devMode = true;
     else if (a === "--repair") repair = true;
+    else if (a === "--local") local = true;
+    else if (a === "--staging") staging = true;
     else if (a.startsWith("-")) unknown.push(a);
   }
   const specific = cursor || vscode || jetbrains;
@@ -2536,7 +2856,30 @@ function parseSetupIdeFlags(argv) {
   } else {
     targets = { cursor, vscode, jetbrains };
   }
-  return { targets, force, dryRun, noGitignore, cleanup, devMode, repair, unknown };
+  let flagError;
+  if (local && staging) {
+    flagError = "[setup-ide-files] --local and --staging are mutually exclusive.";
+  }
+  return {
+    targets,
+    force,
+    dryRun,
+    noGitignore,
+    cleanup,
+    devMode,
+    repair,
+    local,
+    staging,
+    all,
+    explicitCursor: cursor,
+    unknown,
+    flagError
+  };
+}
+function cursorEnvironmentFromFlags(local, staging) {
+  if (local) return "local";
+  if (staging) return "staging";
+  return "production";
 }
 function summarizeOutcomes(outcomes) {
   const created = [];
@@ -2737,20 +3080,44 @@ description: MemoraOne MCP \u2014 IDE agent instructions
 
 ` + cursorRuleBody();
   if (o.targets.cursor) {
-    let npxPath;
-    if (o.npxPathOverride !== void 0) {
-      npxPath = o.npxPathOverride;
+    const cursorEnvironment = o.cursorEnvironment ?? "production";
+    let npxPath = null;
+    let cliPath;
+    if (cursorEnvironment === "local") {
+      let resolvedCliPath = o.cursorLocalCliPathOverride;
+      if (resolvedCliPath === void 0) {
+        resolvedCliPath = await resolveBuiltCliPathAsync({ searchFrom: [repoRoot, o.cwd] });
+      }
+      if (!resolvedCliPath) {
+        return {
+          exitCode: 1,
+          repoRoot,
+          outcomes,
+          error: "[setup-ide-files] Local mode requires a built CLI at packages/mcp/dist/cli.cjs. Run pnpm build first."
+        };
+      }
+      cliPath = resolvedCliPath;
     } else {
-      npxPath = await resolveNpxPath();
-    }
-    if (!npxPath) {
-      return {
-        exitCode: 1,
-        repoRoot,
-        outcomes,
-        error: "[setup-ide-files] Could not resolve a working npx executable. Install Node.js/npm or ensure npx is on PATH before configuring Cursor MCP."
-      };
+      if (o.npxPathOverride !== void 0) {
+        npxPath = o.npxPathOverride;
+      } else {
+        npxPath = await resolveNpxPath();
+      }
+      if (!npxPath) {
+        return {
+          exitCode: 1,
+          repoRoot,
+          outcomes,
+          error: "[setup-ide-files] Could not resolve a working npx executable. Install Node.js/npm or ensure npx is on PATH before configuring Cursor MCP."
+        };
+      }
     }
+    const cursorWriteOptions = {
+      environment: cursorEnvironment,
+      npxPath: npxPath ?? void 0,
+      cliPath,
+      repoRoot
+    };
     outcomes[".cursor/rules/memoraone-mcp.mdc"] = await writeManagedMarkdown(
       repoRoot,
       ".cursor/rules/memoraone-mcp.mdc",
@@ -2760,7 +3127,7 @@ description: MemoraOne MCP \u2014 IDE agent instructions
     outcomes[".cursor/mcp.json"] = await writeIdeMcpJson(
       repoRoot,
       ".cursor/mcp.json",
-      (existing) => buildCursorMcpJsonBody(existing, npxPath, repoRoot),
+      (existing) => buildCursorMcpJsonBody(existing, cursorWriteOptions),
       { force: o.force, dryRun: o.dryRun }
     );
     const repoConfigPath = getCursorRepoMcpConfigPath(repoRoot);
@@ -2772,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,
@@ -2804,7 +3171,7 @@ description: MemoraOne MCP \u2014 IDE agent instructions
     cursorMcp = {
       repoConfigPath,
       repoOutcome,
-      npxPath,
+      ...cursorEnvironment === "local" ? { cliPath } : { npxPath },
       globalConfigPath,
       globalMemoraoneRemoved,
       globalBackupPath
@@ -2871,20 +3238,51 @@ 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, unknown } = 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;
+  }
   if (unknown.length) {
     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
+    repair,
+    cursorEnvironment: cursorEnvironmentFromFlags(local, staging),
+    ...options.setupOverrides
   });
   if (result.error) {
     console.error(result.error);
@@ -2901,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
@@ -2939,7 +3359,7 @@ if (args.includes("--version") || args.includes("-v")) {
 }
 if (args.includes("--help") || args.includes("-h")) {
   console.log(
-    "Usage: memoraone-mcp [--version] [--help] [--daemon --project-id <uuid> [--ide cursor|copilot-vscode|jetbrains]]\n       memoraone-mcp setup-ide-files [--all|--cursor|--vscode|--jetbrains] [--force] [--dry-run] [--no-gitignore] [--cleanup] [--dev] [--repair]\n       memoraone-mcp cleanup [--project-id <uuid>] [--ide cursor|copilot-vscode|jetbrains] [--dry-run] [--all-projects] [--yes]"
+    "Usage: memoraone-mcp [--version] [--help] [--daemon --project-id <uuid> [--ide cursor|copilot-vscode|jetbrains]]\n       memoraone-mcp setup-ide-files [--all|--cursor|--vscode|--jetbrains] [--force] [--dry-run] [--no-gitignore] [--cleanup] [--dev] [--repair]\n         Cursor API environment (with --cursor or --all): --local (node + built cli.cjs + localhost) | --staging (npx + staging API)\n       memoraone-mcp cleanup [--project-id <uuid>] [--ide cursor|copilot-vscode|jetbrains] [--dry-run] [--all-projects] [--yes]"
   );
   process.exit(0);
 }

package/package.json

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