@cortex-context/cli 0.0.5 → 0.0.7

package/dist/index.js

@@ -5617,7 +5617,7 @@ var require_dist = __commonJS({
         });
       };
     }
-    var prompts3 = require_prompts();
+    var prompts5 = require_prompts();
     var passOn = ["suggest", "format", "onState", "validate", "onRender", "type"];
     var noop = () => {
     };
@@ -5668,7 +5668,7 @@ var require_dist = __commonJS({
             var _question2 = question;
             name = _question2.name;
             type = _question2.type;
-            if (prompts3[type] === void 0) {
+            if (prompts5[type] === void 0) {
               throw new Error(`prompt type (${type}) is not defined`);
             }
             if (override2[question.name] !== void 0) {
@@ -5679,7 +5679,7 @@ var require_dist = __commonJS({
               }
             }
             try {
-              answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : yield prompts3[type](question);
+              answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : yield prompts5[type](question);
               answers[name] = answer = yield getFormattedAnswer(question, answer, true);
               quit = yield onSubmit(question, answer, answers);
             } catch (err) {
@@ -5711,7 +5711,7 @@ var require_dist = __commonJS({
     }
     module2.exports = Object.assign(prompt, {
       prompt,
-      prompts: prompts3,
+      prompts: prompts5,
       inject,
       override
     });
@@ -7798,7 +7798,7 @@ var require_prompts2 = __commonJS({
 var require_lib = __commonJS({
   "node_modules/prompts/lib/index.js"(exports2, module2) {
     "use strict";
-    var prompts3 = require_prompts2();
+    var prompts5 = require_prompts2();
     var passOn = ["suggest", "format", "onState", "validate", "onRender", "type"];
     var noop = () => {
     };
@@ -7830,7 +7830,7 @@ var require_lib = __commonJS({
           throw new Error("prompt message is required");
         }
         ({ name, type } = question);
-        if (prompts3[type] === void 0) {
+        if (prompts5[type] === void 0) {
           throw new Error(`prompt type (${type}) is not defined`);
         }
         if (override2[question.name] !== void 0) {
@@ -7841,7 +7841,7 @@ var require_lib = __commonJS({
           }
         }
         try {
-          answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : await prompts3[type](question);
+          answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : await prompts5[type](question);
           answers[name] = answer = await getFormattedAnswer(question, answer, true);
           quit = await onSubmit(question, answer, answers);
         } catch (err) {
@@ -7864,7 +7864,7 @@ var require_lib = __commonJS({
     function override(answers) {
       prompt._override = Object.assign({}, answers);
     }
-    module2.exports = Object.assign(prompt, { prompt, prompts: prompts3, inject, override });
+    module2.exports = Object.assign(prompt, { prompt, prompts: prompts5, inject, override });
   }
 });
 
@@ -16901,7 +16901,7 @@ var source_default = chalk;
 // src/commands/init.ts
 var import_path8 = require("path");
 var import_fs8 = require("fs");
-var import_prompts = __toESM(require_prompts3());
+var import_prompts2 = __toESM(require_prompts3());
 
 // node_modules/ora/index.js
 var import_node_process7 = __toESM(require("process"), 1);
@@ -17840,7 +17840,10 @@ function writeConfig(config2) {
     (0, import_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
   }
   const current = readConfig();
-  (0, import_fs.writeFileSync)(CONFIG_FILE, JSON.stringify({ ...current, ...config2 }, null, 2));
+  (0, import_fs.writeFileSync)(
+    CONFIG_FILE,
+    JSON.stringify({ ...current, ...config2 }, null, 2)
+  );
 }
 function deleteConfig() {
   if ((0, import_fs.existsSync)(CONFIG_FILE)) {
@@ -17944,11 +17947,56 @@ function printInstallResult(label, result, dryRun) {
 var import_fs3 = require("fs");
 var import_path3 = require("path");
 var import_os2 = require("os");
-function getMcpConfigPath(workspacePath) {
-  return (0, import_path3.join)(workspacePath, ".vscode", "mcp.json");
+var import_prompts = __toESM(require_prompts3());
+async function detectWorkspaceTarget(workspacePath) {
+  const hasVscode = (0, import_fs3.existsSync)((0, import_path3.join)(workspacePath, ".vscode"));
+  const hasCursor = (0, import_fs3.existsSync)((0, import_path3.join)(workspacePath, ".cursor"));
+  const hasClaude = (0, import_fs3.existsSync)((0, import_path3.join)(workspacePath, ".claude"));
+  if (hasVscode) {
+    return {
+      target: "vscode",
+      mcpPath: (0, import_path3.join)(workspacePath, ".vscode", "mcp.json"),
+      isFallback: false
+    };
+  }
+  if (hasCursor) {
+    return {
+      target: "cursor",
+      mcpPath: (0, import_path3.join)(workspacePath, ".cursor", "mcp.json"),
+      isFallback: false
+    };
+  }
+  if (hasClaude) {
+    return {
+      target: "claude",
+      mcpPath: (0, import_path3.join)(workspacePath, ".claude", "mcp.json"),
+      isFallback: false
+    };
+  }
+  console.log(
+    source_default.yellow(
+      "  \u26A0 No IDE workspace detected (.vscode/, .cursor/, .claude/)"
+    )
+  );
+  console.log(
+    source_default.dim(
+      "    .agents/ is the emerging standard for IDE-agnostic AI config."
+    )
+  );
+  const { confirm } = await (0, import_prompts.default)({
+    type: "confirm",
+    name: "confirm",
+    message: "Install MCP config into .agents/mcp.json?",
+    initial: true
+  });
+  if (!confirm) return null;
+  return {
+    target: "agents",
+    mcpPath: (0, import_path3.join)(workspacePath, ".agents", "mcp.json"),
+    isFallback: true
+  };
 }
-function readMcpConfig(workspacePath) {
-  const mcpPath = getMcpConfigPath(workspacePath);
+function readMcpConfig(mcpPath) {
   if (!(0, import_fs3.existsSync)(mcpPath)) return { servers: {} };
   try {
     return JSON.parse((0, import_fs3.readFileSync)(mcpPath, "utf-8"));
@@ -17956,12 +18004,12 @@ function readMcpConfig(workspacePath) {
     return { servers: {} };
   }
 }
-function writeMcpConfig(workspacePath, config2) {
-  const mcpPath = getMcpConfigPath(workspacePath);
+function writeMcpConfig(mcpPath, config2) {
+  (0, import_fs3.mkdirSync)((0, import_path3.dirname)(mcpPath), { recursive: true });
   (0, import_fs3.writeFileSync)(mcpPath, JSON.stringify(config2, null, 2) + "\n");
 }
-function injectCortexMcpServer(workspacePath, cortexUrl, cortexToken) {
-  const config2 = readMcpConfig(workspacePath);
+function injectCortexMcpServer(mcpPath, cortexUrl, cortexToken) {
+  const config2 = readMcpConfig(mcpPath);
   const existed = "cortex" in config2.servers;
   config2.servers["cortex"] = {
     type: "stdio",
@@ -17972,74 +18020,63 @@ function injectCortexMcpServer(workspacePath, cortexUrl, cortexToken) {
       ...cortexToken ? { CORTEX_API_TOKEN: cortexToken } : {}
     }
   };
-  writeMcpConfig(workspacePath, config2);
+  writeMcpConfig(mcpPath, config2);
   return {
     added: !existed,
     updated: existed
   };
 }
-function removeCortexMcpServer(workspacePath) {
-  const config2 = readMcpConfig(workspacePath);
+function removeCortexMcpServer(mcpPath) {
+  const config2 = readMcpConfig(mcpPath);
   if (!("cortex" in config2.servers)) return { removed: false };
   delete config2.servers["cortex"];
-  writeMcpConfig(workspacePath, config2);
+  writeMcpConfig(mcpPath, config2);
   return { removed: true };
 }
-function hasCortexMcp(workspacePath) {
-  const config2 = readMcpConfig(workspacePath);
+function hasCortexMcp(mcpPath) {
+  const config2 = readMcpConfig(mcpPath);
   return "cortex" in config2.servers;
 }
 function printMcpStatus(workspacePath) {
-  const mcpPath = getMcpConfigPath(workspacePath);
-  if (!(0, import_fs3.existsSync)(mcpPath)) {
-    console.log(source_default.yellow("  \u26A0 No .vscode/mcp.json found"));
-    return;
+  const candidates = [
+    {
+      label: ".vscode/mcp.json",
+      path: (0, import_path3.join)(workspacePath, ".vscode", "mcp.json")
+    },
+    {
+      label: ".cursor/mcp.json",
+      path: (0, import_path3.join)(workspacePath, ".cursor", "mcp.json")
+    },
+    {
+      label: ".claude/mcp.json",
+      path: (0, import_path3.join)(workspacePath, ".claude", "mcp.json")
+    },
+    {
+      label: ".agents/mcp.json",
+      path: (0, import_path3.join)(workspacePath, ".agents", "mcp.json")
+    }
+  ];
+  let found = false;
+  for (const { label, path } of candidates) {
+    if (!(0, import_fs3.existsSync)(path)) continue;
+    const config2 = readMcpConfig(path);
+    if ("cortex" in config2.servers) {
+      const url = config2.servers["cortex"]?.env?.["CORTEX_URL"] ?? "(not set)";
+      console.log(
+        source_default.green(`  \u2713 MCP server "cortex" configured in ${label} \u2192 ${url}`)
+      );
+      found = true;
+    }
   }
-  const config2 = readMcpConfig(workspacePath);
-  if ("cortex" in config2.servers) {
-    const entry = config2.servers["cortex"];
-    const url = entry.env?.["CORTEX_URL"] ?? "(not set)";
-    console.log(source_default.green(`  \u2713 MCP server "cortex" configured \u2192 ${url}`));
-  } else {
+  if (!found) {
     console.log(
-      source_default.yellow('  \u26A0 MCP server "cortex" not found in .vscode/mcp.json')
+      source_default.yellow('  \u26A0 MCP server "cortex" not found in any known config')
     );
   }
 }
 function getCursorMcpPath(workspacePath) {
   return (0, import_path3.join)(workspacePath, ".cursor", "mcp.json");
 }
-function configureCursorMcp(workspacePath, cortexUrl, cortexToken) {
-  const cursorDir = (0, import_path3.join)(workspacePath, ".cursor");
-  if (!(0, import_fs3.existsSync)(cursorDir)) {
-    return {
-      configured: false,
-      skipped: true,
-      reason: ".cursor/ not found (Cursor not configured)"
-    };
-  }
-  const mcpPath = getCursorMcpPath(workspacePath);
-  let config2 = { servers: {} };
-  if ((0, import_fs3.existsSync)(mcpPath)) {
-    try {
-      config2 = JSON.parse((0, import_fs3.readFileSync)(mcpPath, "utf-8"));
-    } catch {
-      config2 = { servers: {} };
-    }
-  }
-  config2.servers["cortex"] = {
-    type: "stdio",
-    command: "npx",
-    args: ["-y", "@cortex-context/cli", "mcp-serve"],
-    env: {
-      CORTEX_URL: cortexUrl,
-      ...cortexToken ? { CORTEX_API_TOKEN: cortexToken } : {}
-    }
-  };
-  (0, import_fs3.mkdirSync)(cursorDir, { recursive: true });
-  (0, import_fs3.writeFileSync)(mcpPath, JSON.stringify(config2, null, 2) + "\n");
-  return { configured: true, skipped: false };
-}
 function removeCursorMcp(workspacePath) {
   const mcpPath = getCursorMcpPath(workspacePath);
   if (!(0, import_fs3.existsSync)(mcpPath)) return { removed: false };
@@ -18156,7 +18193,6 @@ function writeCortexConfig(workspacePath, force) {
   }
   const templatePath = (0, import_path4.join)(
     __dirname,
-    "..",
     "templates",
     "local",
     "cortex.config.template.yaml"
@@ -18173,10 +18209,10 @@ function writeCortexConfig(workspacePath, force) {
 var import_child_process = require("child_process");
 var import_fs5 = require("fs");
 var import_path5 = require("path");
+var import_os3 = require("os");
 async function deployLocalStack(workspacePath) {
   const templatePath = (0, import_path5.join)(
     __dirname,
-    "..",
     "templates",
     "local",
     "docker-compose.local.yml"
@@ -18189,10 +18225,13 @@ async function deployLocalStack(workspacePath) {
     (0, import_fs5.cpSync)(templatePath, destPath);
   }
   try {
-    (0, import_child_process.execSync)(`docker compose -f "${destPath}" up -d`, {
-      cwd: workspacePath,
-      stdio: "inherit"
-    });
+    (0, import_child_process.execSync)(
+      `docker compose --project-name cortex-local -f "${destPath}" up -d`,
+      {
+        cwd: workspacePath,
+        stdio: "inherit"
+      }
+    );
     return { started: true };
   } catch (err) {
     return {
@@ -18209,6 +18248,58 @@ function isDockerAvailable() {
     return false;
   }
 }
+async function installDocker() {
+  const os2 = (0, import_os3.platform)();
+  try {
+    if (os2 === "linux") {
+      console.log(
+        source_default.dim("  \u2192 Running Docker install script (curl | sh)...")
+      );
+      (0, import_child_process.execSync)("curl -fsSL https://get.docker.com | sh", { stdio: "inherit" });
+      const user = process.env["USER"] ?? process.env["LOGNAME"];
+      if (user) {
+        (0, import_child_process.spawnSync)("usermod", ["-aG", "docker", user], { stdio: "inherit" });
+      }
+      return { installed: true };
+    }
+    if (os2 === "darwin") {
+      console.log(source_default.dim("  \u2192 Installing Docker Desktop via Homebrew..."));
+      (0, import_child_process.execSync)("brew install --cask docker", { stdio: "inherit" });
+      return { installed: true };
+    }
+    if (os2 === "win32") {
+      console.log(source_default.dim("  \u2192 Installing Docker Desktop via winget..."));
+      (0, import_child_process.execSync)(
+        "winget install --id Docker.DockerDesktop -e --silent --accept-package-agreements --accept-source-agreements",
+        {
+          stdio: "inherit",
+          shell: "cmd.exe"
+        }
+      );
+      return { installed: true };
+    }
+    return { installed: false, reason: `Unsupported OS: ${os2}` };
+  } catch (err) {
+    return {
+      installed: false,
+      reason: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
+async function waitForCortexHealth(cortexUrl, maxWaitMs = 12e4) {
+  const deadline = Date.now() + maxWaitMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(`${cortexUrl}/health`, {
+        signal: AbortSignal.timeout(4e3)
+      });
+      if (res.ok) return { healthy: true };
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 5e3));
+  }
+  return { healthy: false };
+}
 
 // src/lib/hooks.ts
 var import_fs6 = require("fs");
@@ -18388,7 +18479,7 @@ async function initCommand(options) {
     cortexToken = "dev-token-local";
     console.log(source_default.dim("  Mode: local Docker stack"));
   } else {
-    const responses = await (0, import_prompts.default)(
+    const responses = await (0, import_prompts2.default)(
       [
         {
           type: options.url ? null : "text",
@@ -18518,23 +18609,34 @@ async function initCommand(options) {
   if (!options.skipMcp) {
     console.log("");
     console.log(source_default.bold("  Phase 2: MCP Server"));
-    const mcpStatus = injectCortexMcpServer(
-      workspacePath,
-      cortexUrl,
-      cortexToken
-    );
-    if (mcpStatus.added) {
-      console.log(source_default.green("  \u2713 .vscode/mcp.json \u2014 Cortex server added"));
-    } else {
-      console.log(source_default.cyan("  \u21BB .vscode/mcp.json \u2014 Cortex server updated"));
-    }
-    const cursorMcp = configureCursorMcp(workspacePath, cortexUrl, cortexToken);
-    if (cursorMcp.configured) {
+    const detected = await detectWorkspaceTarget(workspacePath);
+    if (!detected) {
       console.log(
-        source_default.green("  \u2713 .cursor/mcp.json \u2014 Cortex server configured")
+        source_default.yellow("  \u26A0 MCP config skipped \u2014 no target directory confirmed")
       );
-    } else if (!cursorMcp.skipped) {
-      console.log(source_default.yellow(`  \u26A0 .cursor/mcp.json \u2014 ${cursorMcp.reason}`));
+    } else {
+      const targetLabel = {
+        vscode: ".vscode/mcp.json",
+        cursor: ".cursor/mcp.json",
+        claude: ".claude/mcp.json",
+        agents: ".agents/mcp.json"
+      };
+      const label = targetLabel[detected.target] ?? detected.mcpPath;
+      if (detected.isFallback) {
+        console.log(
+          source_default.dim(`  \u2139  Installing into ${label} (IDE-agnostic standard)`)
+        );
+      }
+      const mcpStatus = injectCortexMcpServer(
+        detected.mcpPath,
+        cortexUrl,
+        cortexToken
+      );
+      if (mcpStatus.added) {
+        console.log(source_default.green(`  \u2713 ${label} \u2014 Cortex server added`));
+      } else {
+        console.log(source_default.cyan(`  \u21BB ${label} \u2014 Cortex server updated`));
+      }
     }
     const claudeMcp = configureClaudeDesktop(cortexUrl, cortexToken);
     if (claudeMcp.configured) {
@@ -27926,33 +28028,200 @@ async function serveCommand() {
   await runMcpServer();
 }
 
-// src/commands/uninstall.ts
-var import_path13 = require("path");
+// src/commands/server.ts
+var import_os4 = require("os");
 var import_fs12 = require("fs");
-var import_prompts2 = __toESM(require_prompts3());
+var import_path13 = require("path");
+var import_prompts3 = __toESM(require_prompts3());
+var CORTEX_URL2 = "http://localhost:8082";
+var NEO4J_URL = "http://localhost:7474";
+async function serverCommand(options) {
+  console.log("");
+  console.log(source_default.bold.cyan("  \u25C6 Cortex Context \u2014 Server"));
+  console.log(
+    source_default.dim(
+      "  Installs and starts the Cortex stack (Neo4j + Cortex API) via Docker."
+    )
+  );
+  console.log("");
+  const defaultDir = (0, import_path13.join)((0, import_os4.homedir)(), ".cortex-context");
+  const workDir = options.dir ?? defaultDir;
+  (0, import_fs12.mkdirSync)(workDir, { recursive: true });
+  console.log(source_default.bold("  Step 1: Docker"));
+  const dockerReady = isDockerAvailable();
+  if (dockerReady) {
+    console.log(source_default.green("  \u2713 Docker is available"));
+  } else {
+    console.log(source_default.yellow("  \u26A0 Docker not found on PATH"));
+    if (options.skipDockerInstall) {
+      console.error(
+        source_default.red(
+          "  \u2717 --skip-docker-install set but Docker is required. Install Docker manually and retry."
+        )
+      );
+      process.exit(1);
+    }
+    const os2 = (0, import_os4.platform)();
+    const installMethod = {
+      linux: "curl | sh (official script, may require sudo)",
+      darwin: "Homebrew (brew install --cask docker)",
+      win32: "winget (winget install Docker.DockerDesktop)"
+    };
+    const method = installMethod[os2] ?? `unsupported OS (${os2})`;
+    if (!installMethod[os2]) {
+      console.error(
+        source_default.red(`  \u2717 Automatic Docker install is not supported on ${os2}.`)
+      );
+      console.error(
+        source_default.dim(
+          "    Install Docker manually: https://docs.docker.com/get-docker/"
+        )
+      );
+      process.exit(1);
+    }
+    console.log("");
+    console.log(source_default.dim(`  Install method: ${method}`));
+    console.log(source_default.dim("  This will install Docker on your machine."));
+    console.log("");
+    const { confirm } = await (0, import_prompts3.default)({
+      type: "confirm",
+      name: "confirm",
+      message: "Install Docker now?",
+      initial: true
+    });
+    if (!confirm) {
+      console.log(
+        source_default.yellow("\n  Aborted. Install Docker manually and run again.")
+      );
+      process.exit(0);
+    }
+    console.log("");
+    const spinner = ora("  Installing Docker...").start();
+    const result = await installDocker();
+    if (!result.installed) {
+      spinner.fail(source_default.red(`  \u2717 Docker install failed: ${result.reason}`));
+      console.log(
+        source_default.dim(
+          "    Install Docker manually: https://docs.docker.com/get-docker/"
+        )
+      );
+      process.exit(1);
+    }
+    spinner.succeed(source_default.green("  \u2713 Docker installed"));
+    if (os2 === "win32") {
+      console.log(
+        source_default.yellow(
+          "  \u26A0 Docker Desktop was installed. Please start it manually, then re-run this command."
+        )
+      );
+      process.exit(0);
+    }
+    if (os2 === "linux") {
+      console.log(
+        source_default.dim(
+          "  \u2139  You may need to log out and back in for the docker group to take effect."
+        )
+      );
+    }
+    console.log("");
+  }
+  console.log("");
+  console.log(source_default.bold("  Step 2: Containers to start"));
+  console.log(source_default.dim("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+  console.log(source_default.dim("  \u2502  neo4j        \u2192 localhost:7474  (UI: 7474) \u2502"));
+  console.log(source_default.dim("  \u2502  cortex-api   \u2192 localhost:8082             \u2502"));
+  console.log(source_default.dim("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
+  console.log("");
+  console.log(source_default.dim(`  Working directory: ${workDir}`));
+  console.log("");
+  const { proceed } = await (0, import_prompts3.default)({
+    type: "confirm",
+    name: "proceed",
+    message: "Start the Cortex stack now?",
+    initial: true
+  });
+  if (!proceed) {
+    console.log(source_default.yellow("\n  Aborted."));
+    process.exit(0);
+  }
+  console.log("");
+  console.log(source_default.bold("  Step 3: Starting Cortex stack"));
+  const startSpinner = ora("  Running docker compose up -d...").start();
+  const startResult = await deployLocalStack(workDir);
+  if (!startResult.started) {
+    startSpinner.fail(
+      source_default.red(`  \u2717 Docker Compose failed: ${startResult.error}`)
+    );
+    process.exit(1);
+  }
+  startSpinner.succeed(source_default.green("  \u2713 Containers started"));
+  console.log("");
+  console.log(source_default.bold("  Step 4: Waiting for Cortex API..."));
+  const healthSpinner = ora(
+    "  Polling http://localhost:8082/health (up to 2 min)..."
+  ).start();
+  const { healthy } = await waitForCortexHealth(CORTEX_URL2);
+  if (!healthy) {
+    healthSpinner.warn(
+      source_default.yellow(
+        "  \u26A0 Cortex API did not respond in time \u2014 containers may still be starting."
+      )
+    );
+    console.log(source_default.dim(`    Check manually: curl ${CORTEX_URL2}/health`));
+    console.log(
+      source_default.dim("    Or: docker compose -f docker-compose.local.yml logs")
+    );
+  } else {
+    healthSpinner.succeed(source_default.green("  \u2713 Cortex API is healthy"));
+  }
+  console.log("");
+  console.log(source_default.bold.green("  \u2705 Cortex stack is running!"));
+  console.log("");
+  console.log(source_default.bold("  Services:"));
+  console.log(source_default.cyan(`    Cortex API  \u2192 ${CORTEX_URL2}`));
+  console.log(source_default.cyan(`    Neo4j UI    \u2192 ${NEO4J_URL}`));
+  console.log(source_default.dim("    Neo4j login \u2192 neo4j / cortex-local"));
+  console.log("");
+  console.log(source_default.bold("  Next steps:"));
+  console.log(source_default.dim("  1. Initialize your workspace:"));
+  console.log(source_default.cyan(`       cortex-context init --url ${CORTEX_URL2}`));
+  console.log(source_default.dim("  2. Check connectivity:"));
+  console.log(source_default.cyan("       cortex-context doctor"));
+  console.log("");
+  console.log(source_default.dim("  To stop the stack:"));
+  console.log(source_default.dim("    docker compose -f docker-compose.local.yml down"));
+  console.log("");
+}
+
+// src/commands/uninstall.ts
+var import_path14 = require("path");
+var import_fs13 = require("fs");
+var import_prompts4 = __toESM(require_prompts3());
 var CORTEX_SKILLS = [
   "cortex-research",
   "cortex-dimensions",
   "cortex-ingest",
-  "generate-spec"
+  "cortex-generate-spec"
 ];
 async function uninstallCommand(options) {
   console.log("");
   console.log(source_default.bold.cyan("  \u25C6 Cortex Context \u2014 Uninstall"));
   console.log(source_default.dim("  Removes Cortex Context from your workspace."));
   console.log("");
-  const workspacePath = (0, import_path13.resolve)(options.workspace ?? process.cwd());
+  const workspacePath = (0, import_path14.resolve)(options.workspace ?? process.cwd());
   console.log(source_default.dim(`  Workspace: ${workspacePath}`));
   console.log("");
-  const skillsPath = (0, import_path13.join)(workspacePath, ".github", "skills");
+  const skillsPath = (0, import_path14.join)(workspacePath, ".github", "skills");
   const skillsToRemove = CORTEX_SKILLS.filter(
-    (s) => (0, import_fs12.existsSync)((0, import_path13.join)(skillsPath, s))
+    (s) => (0, import_fs13.existsSync)((0, import_path14.join)(skillsPath, s))
+  );
+  const hasMcp = (0, import_fs13.existsSync)((0, import_path14.join)(workspacePath, ".vscode", "mcp.json"));
+  const hasCursorMcp = (0, import_fs13.existsSync)((0, import_path14.join)(workspacePath, ".cursor", "mcp.json"));
+  const hasHook = (0, import_fs13.existsSync)(
+    (0, import_path14.join)(workspacePath, ".git", "hooks", "post-commit")
   );
-  const hasMcp = (0, import_fs12.existsSync)((0, import_path13.join)(workspacePath, ".vscode", "mcp.json"));
-  const hasCursorMcp = (0, import_fs12.existsSync)((0, import_path13.join)(workspacePath, ".cursor", "mcp.json"));
-  const hasHook = (0, import_fs12.existsSync)((0, import_path13.join)(workspacePath, ".git", "hooks", "post-commit"));
-  const hasConfig = (0, import_fs12.existsSync)(
-    (0, import_path13.join)(process.env["HOME"] ?? "~", ".cortex-context", "config.json")
+  const hasConfig = (0, import_fs13.existsSync)(
+    (0, import_path14.join)(process.env["HOME"] ?? "~", ".cortex-context", "config.json")
   );
   console.log(source_default.bold("  Will remove:"));
   if (hasMcp) {
@@ -27967,7 +28236,9 @@ async function uninstallCommand(options) {
     }
   }
   if (!options.keepHook && hasHook) {
-    console.log(source_default.dim("  \xB7 .git/hooks/post-commit (cortex auto-sync hook)"));
+    console.log(
+      source_default.dim("  \xB7 .git/hooks/post-commit (cortex auto-sync hook)")
+    );
   }
   if (!options.keepConfig && hasConfig) {
     console.log(source_default.dim("  \xB7 ~/.cortex-context/config.json"));
@@ -27980,7 +28251,7 @@ async function uninstallCommand(options) {
   }
   console.log("");
   if (!options.yes) {
-    const { confirmed } = await (0, import_prompts2.default)({
+    const { confirmed } = await (0, import_prompts4.default)({
       type: "confirm",
       name: "confirmed",
       message: "Proceed with uninstall?",
@@ -27999,13 +28270,21 @@ async function uninstallCommand(options) {
     try {
       const result = removeCortexMcpServer(workspacePath);
       if (result.removed) {
-        console.log(source_default.green('  \u2713 .vscode/mcp.json \u2014 "cortex" entry removed'));
+        console.log(
+          source_default.green('  \u2713 .vscode/mcp.json \u2014 "cortex" entry removed')
+        );
         removed++;
       } else {
-        console.log(source_default.dim('  \xB7 .vscode/mcp.json \u2014 no "cortex" entry found'));
+        console.log(
+          source_default.dim('  \xB7 .vscode/mcp.json \u2014 no "cortex" entry found')
+        );
       }
     } catch (err) {
-      console.log(source_default.red(`  \u2717 .vscode/mcp.json \u2014 ${err instanceof Error ? err.message : err}`));
+      console.log(
+        source_default.red(
+          `  \u2717 .vscode/mcp.json \u2014 ${err instanceof Error ? err.message : err}`
+        )
+      );
       errors++;
     }
   }
@@ -28013,46 +28292,62 @@ async function uninstallCommand(options) {
     try {
       const result = removeCursorMcp(workspacePath);
       if (result.removed) {
-        console.log(source_default.green('  \u2713 .cursor/mcp.json \u2014 "cortex" entry removed'));
+        console.log(
+          source_default.green('  \u2713 .cursor/mcp.json \u2014 "cortex" entry removed')
+        );
         removed++;
       }
     } catch (err) {
-      console.log(source_default.red(`  \u2717 .cursor/mcp.json \u2014 ${err instanceof Error ? err.message : err}`));
+      console.log(
+        source_default.red(
+          `  \u2717 .cursor/mcp.json \u2014 ${err instanceof Error ? err.message : err}`
+        )
+      );
       errors++;
     }
   }
   try {
     const result = removeClaudeDesktopMcp();
     if (result.removed) {
-      console.log(source_default.green(`  \u2713 Claude Desktop \u2014 "cortex" entry removed (${result.path})`));
+      console.log(
+        source_default.green(
+          `  \u2713 Claude Desktop \u2014 "cortex" entry removed (${result.path})`
+        )
+      );
       removed++;
     }
   } catch {
   }
   if (!options.keepSkills) {
     for (const skill of skillsToRemove) {
-      const skillDir = (0, import_path13.join)(skillsPath, skill);
+      const skillDir = (0, import_path14.join)(skillsPath, skill);
       try {
-        (0, import_fs12.rmSync)(skillDir, { recursive: true, force: true });
+        (0, import_fs13.rmSync)(skillDir, { recursive: true, force: true });
         console.log(source_default.green(`  \u2713 .github/skills/${skill}/ \u2014 removed`));
         removed++;
       } catch (err) {
-        console.log(source_default.red(`  \u2717 .github/skills/${skill}/ \u2014 ${err instanceof Error ? err.message : err}`));
+        console.log(
+          source_default.red(
+            `  \u2717 .github/skills/${skill}/ \u2014 ${err instanceof Error ? err.message : err}`
+          )
+        );
         errors++;
       }
     }
   }
   if (!options.keepHook && hasHook) {
-    const hookPath = (0, import_path13.join)(workspacePath, ".git", "hooks", "post-commit");
+    const hookPath = (0, import_path14.join)(workspacePath, ".git", "hooks", "post-commit");
     try {
       const { readFileSync: readFileSync7 } = await import("fs");
       const hookContent = readFileSync7(hookPath, "utf-8");
       if (hookContent.includes("cortex-context")) {
-        (0, import_fs12.unlinkSync)(hookPath);
+        (0, import_fs13.unlinkSync)(hookPath);
         console.log(source_default.green("  \u2713 .git/hooks/post-commit \u2014 removed"));
         removed++;
       } else {
-        console.log(source_default.dim("  \xB7 .git/hooks/post-commit \u2014 not ours, skipped"));
+        console.log(
+          source_default.dim("  \xB7 .git/hooks/post-commit \u2014 not ours, skipped")
+        );
       }
     } catch {
     }
@@ -28063,26 +28358,42 @@ async function uninstallCommand(options) {
       console.log(source_default.green("  \u2713 ~/.cortex-context/config.json \u2014 removed"));
       removed++;
     } catch (err) {
-      console.log(source_default.red(`  \u2717 ~/.cortex-context/config.json \u2014 ${err instanceof Error ? err.message : err}`));
+      console.log(
+        source_default.red(
+          `  \u2717 ~/.cortex-context/config.json \u2014 ${err instanceof Error ? err.message : err}`
+        )
+      );
       errors++;
     }
   }
   console.log("");
   if (errors === 0) {
-    console.log(source_default.bold.green(`  \u2705 Uninstall complete (${removed} item${removed !== 1 ? "s" : ""} removed)`));
+    console.log(
+      source_default.bold.green(
+        `  \u2705 Uninstall complete (${removed} item${removed !== 1 ? "s" : ""} removed)`
+      )
+    );
     console.log("");
-    console.log(source_default.dim('  Reload VS Code (Cmd/Ctrl+Shift+P \u2192 "Reload Window") to deactivate the MCP server.'));
+    console.log(
+      source_default.dim(
+        '  Reload VS Code (Cmd/Ctrl+Shift+P \u2192 "Reload Window") to deactivate the MCP server.'
+      )
+    );
   } else {
-    console.log(source_default.bold.yellow(`  \u26A0 Uninstall finished with ${errors} error${errors !== 1 ? "s" : ""}`));
+    console.log(
+      source_default.bold.yellow(
+        `  \u26A0 Uninstall finished with ${errors} error${errors !== 1 ? "s" : ""}`
+      )
+    );
   }
   console.log("");
 }
 
 // src/cli.ts
-var import_fs13 = require("fs");
-var import_path14 = require("path");
+var import_fs14 = require("fs");
+var import_path15 = require("path");
 var pkg = JSON.parse(
-  (0, import_fs13.readFileSync)((0, import_path14.join)(__dirname, "..", "package.json"), "utf-8")
+  (0, import_fs14.readFileSync)((0, import_path15.join)(__dirname, "..", "package.json"), "utf-8")
 );
 function createCli() {
   const program3 = new Command();
@@ -28101,6 +28412,15 @@ function createCli() {
     "--local",
     "Deploy a local Cortex stack with Docker (mutually exclusive with --url)"
   ).option("--skip-mcp", "Skip MCP server configuration").option("--skip-skills", "Skip Skills installation").option("--skip-hooks", "Skip git hook installation").option("--skip-rules", "Skip Copilot/Cursor rules injection").option("--force", "Overwrite existing files without prompting").action(initCommand);
+  program3.command("server").description(
+    "Install Docker (if needed) and start the Cortex stack (Neo4j + Cortex API) locally"
+  ).option(
+    "--dir <path>",
+    "Directory to place docker-compose.local.yml (defaults to current directory)"
+  ).option(
+    "--skip-docker-install",
+    "Fail instead of auto-installing Docker when it is not found"
+  ).action(serverCommand);
   program3.command("sync").description("Ingest latest git diff into the Cortex Knowledge Graph").option("--repo <path>", "Repository path (defaults to current directory)").option("--dry-run", "Show diff without sending to Cortex API").action(syncCommand);
   program3.command("update").description(
     "Update Skills and MCP Server files to the latest bundled version"