@memoraone/mcp 0.1.32 → 0.1.33

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.33",
       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) {
@@ -1395,9 +1420,13 @@ function logCursorMcpConfigAudit(prefix, audit) {
   }
 }
 function logCursorMcpCliSummary(info, dryRun) {
-  const { repoConfigPath, repoOutcome, npxPath, repoBackupPath, globalConfigPath, globalMemoraoneRemoved, globalBackupPath } = info;
+  const { repoConfigPath, repoOutcome, npxPath, cliPath, repoBackupPath, globalConfigPath, globalMemoraoneRemoved, globalBackupPath } = info;
   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}`);
   }
@@ -2094,7 +2123,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 +2133,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 +2337,60 @@ 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/setupIdeFiles.ts
 var MANAGED_MARKER = "<!-- MemoraOne managed IDE helper -->";
 var GITIGNORE_MEMORAONE_COMMENT = "# MemoraOne local project binding / API key";
@@ -2323,15 +2406,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 +2435,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 +2451,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 +2519,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 +2567,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 +2583,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 +2598,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 +2612,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 +2623,16 @@ 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, unknown, flagError };
+}
+function cursorEnvironmentFromFlags(local, staging) {
+  if (local) return "local";
+  if (staging) return "staging";
+  return "production";
 }
 function summarizeOutcomes(outcomes) {
   const created = [];
@@ -2737,20 +2833,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 +2880,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);
@@ -2804,7 +2924,7 @@ description: MemoraOne MCP \u2014 IDE agent instructions
     cursorMcp = {
       repoConfigPath,
       repoOutcome,
-      npxPath,
+      ...cursorEnvironment === "local" ? { cliPath } : { npxPath },
       globalConfigPath,
       globalMemoraoneRemoved,
       globalBackupPath
@@ -2872,7 +2992,11 @@ 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);
+  const { targets, force, dryRun, noGitignore, cleanup, devMode, repair, local, staging, 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;
@@ -2884,7 +3008,8 @@ async function cliSetupIdeFiles(argv) {
     dryRun,
     noGitignore,
     devMode,
-    repair
+    repair,
+    cursorEnvironment: cursorEnvironmentFromFlags(local, staging)
   });
   if (result.error) {
     console.error(result.error);
@@ -2939,7 +3064,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.33",
   "type": "module",
   "main": "dist/index.cjs",
   "bin": {