context-vault 2.8.4 → 2.8.5

package/bin/cli.js

@@ -222,6 +222,7 @@ ${bold("Usage:")}
 ${bold("Commands:")}
   ${cyan("setup")}                 Interactive MCP server installer
   ${cyan("connect")} --key cv_...  Connect AI tools to hosted vault
+  ${cyan("switch")} local|hosted      Switch between local and hosted MCP modes
   ${cyan("serve")}                 Start the MCP server (used by AI clients)
   ${cyan("ui")} [--port 3141]      Launch web dashboard
   ${cyan("reindex")}               Rebuild search index from knowledge files
@@ -451,6 +452,7 @@ async function runSetup() {
   vaultConfig.dataDir = dataDir;
   vaultConfig.dbPath = join(dataDir, "vault.db");
   vaultConfig.devDir = join(HOME, "dev");
+  vaultConfig.mode = "local";
   writeFileSync(configPath, JSON.stringify(vaultConfig, null, 2) + "\n");
   console.log(`\n  ${green("+")} Wrote ${configPath}`);
 
@@ -635,10 +637,11 @@ async function configureClaude(tool, vaultDir) {
 
   try {
     if (isInstalledPackage()) {
-      const cmdArgs = ["serve"];
+      const launcherPath = join(HOME, ".context-mcp", "server.mjs");
+      const cmdArgs = [`"${launcherPath}"`];
       if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
       execSync(
-        `claude mcp add -s user context-vault -- context-vault ${cmdArgs.join(" ")}`,
+        `claude mcp add -s user context-vault -- node ${cmdArgs.join(" ")}`,
         { stdio: "pipe", env },
       );
     } else {
@@ -667,12 +670,12 @@ async function configureCodex(tool, vaultDir) {
 
   try {
     if (isInstalledPackage()) {
-      const cmdArgs = ["serve"];
+      const launcherPath = join(HOME, ".context-mcp", "server.mjs");
+      const cmdArgs = [`"${launcherPath}"`];
       if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
-      execSync(
-        `codex mcp add context-vault -- context-vault ${cmdArgs.join(" ")}`,
-        { stdio: "pipe" },
-      );
+      execSync(`codex mcp add context-vault -- node ${cmdArgs.join(" ")}`, {
+        stdio: "pipe",
+      });
     } else {
       const cmdArgs = [`"${SERVER_PATH}"`];
       if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
@@ -715,11 +718,12 @@ function configureJsonTool(tool, vaultDir) {
   delete config[tool.configKey]["context-mcp"];
 
   if (isInstalledPackage()) {
-    const serverArgs = ["serve"];
+    const launcherPath = join(HOME, ".context-mcp", "server.mjs");
+    const serverArgs = [];
     if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
     config[tool.configKey]["context-vault"] = {
-      command: "context-vault",
-      args: serverArgs,
+      command: "node",
+      args: [launcherPath, ...serverArgs],
     };
   } else {
     const serverArgs = [SERVER_PATH];
@@ -948,6 +952,19 @@ async function runConnect() {
     }
   }
 
+  // Persist mode in config
+  const modeConfigPath = join(HOME, ".context-mcp", "config.json");
+  let modeConfig = {};
+  if (existsSync(modeConfigPath)) {
+    try {
+      modeConfig = JSON.parse(readFileSync(modeConfigPath, "utf-8"));
+    } catch {}
+  }
+  modeConfig.mode = "hosted";
+  modeConfig.hostedUrl = hostedUrl;
+  mkdirSync(join(HOME, ".context-mcp"), { recursive: true });
+  writeFileSync(modeConfigPath, JSON.stringify(modeConfig, null, 2) + "\n");
+
   console.log();
   console.log(
     green("  ✓ Connected! Your AI tools can now access your hosted vault."),
@@ -1033,31 +1050,136 @@ function configureJsonToolHosted(tool, apiKey, hostedUrl) {
   writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 }
 
-function runUi() {
-  // Try bundled path first (npm install), then workspace path (local dev)
-  const bundledDist = resolve(ROOT, "app-dist");
-  const workspaceDist = resolve(ROOT, "..", "app", "dist");
-  const appDist = existsSync(join(bundledDist, "index.html"))
-    ? bundledDist
-    : existsSync(join(workspaceDist, "index.html"))
-      ? workspaceDist
-      : null;
+async function runSwitch() {
+  const target = args[1];
+  if (target !== "local" && target !== "hosted") {
+    console.log(`\n  ${bold("context-vault switch")} <local|hosted>\n`);
+    console.log(`  Switch between local and hosted MCP modes.\n`);
+    console.log(
+      `  ${cyan("switch local")}    Use local vault (SQLite + files on this device)`,
+    );
+    console.log(
+      `  ${cyan("switch hosted")}   Use hosted vault (requires API key)\n`,
+    );
+    console.log(`  Options:`);
+    console.log(`    --key <key>   API key for hosted mode (cv_...)`);
+    console.log(
+      `    --url <url>   Hosted server URL (default: https://api.context-vault.com)\n`,
+    );
+    return;
+  }
 
-  if (!appDist) {
-    const cloudUrl = "https://app.context-vault.com";
-    console.log(`Opening ${cloudUrl}`);
-    const open =
-      PLATFORM === "darwin"
-        ? "open"
-        : PLATFORM === "win32"
-          ? "start"
-          : "xdg-open";
+  const dataDir = join(HOME, ".context-mcp");
+  const configPath = join(dataDir, "config.json");
+  let vaultConfig = {};
+  if (existsSync(configPath)) {
     try {
-      execSync(`${open} ${cloudUrl}`, { stdio: "ignore" });
+      vaultConfig = JSON.parse(readFileSync(configPath, "utf-8"));
     } catch {}
-    return;
   }
 
+  const { detected } = await detectAllTools();
+
+  if (target === "local") {
+    const launcherPath = join(dataDir, "server.mjs");
+    if (!existsSync(launcherPath)) {
+      const serverAbs = resolve(ROOT, "src", "server", "index.js");
+      mkdirSync(dataDir, { recursive: true });
+      writeFileSync(launcherPath, `import "${serverAbs}";\n`);
+    }
+
+    vaultConfig.mode = "local";
+    mkdirSync(dataDir, { recursive: true });
+    writeFileSync(configPath, JSON.stringify(vaultConfig, null, 2) + "\n");
+
+    console.log();
+    console.log(`  ${bold("◇ context-vault")} ${dim("switch → local")}`);
+    console.log();
+
+    const defaultVDir = join(HOME, "vault");
+    const customVaultDir =
+      vaultConfig.vaultDir &&
+      resolve(vaultConfig.vaultDir) !== resolve(defaultVDir)
+        ? vaultConfig.vaultDir
+        : null;
+
+    for (const tool of detected) {
+      try {
+        if (tool.configType === "cli" && tool.id === "codex") {
+          await configureCodex(tool, customVaultDir);
+        } else if (tool.configType === "cli") {
+          await configureClaude(tool, customVaultDir);
+        } else {
+          configureJsonTool(tool, customVaultDir);
+        }
+        console.log(`  ${green("+")} ${tool.name} — switched to local`);
+      } catch (e) {
+        console.log(`  ${red("x")} ${tool.name} — ${e.message}`);
+      }
+    }
+    console.log();
+    console.log(green("  ✓ Switched to local mode."));
+    console.log(dim(`  Server: node ${launcherPath}`));
+    console.log();
+  } else {
+    const hostedUrl =
+      getFlag("--url") ||
+      vaultConfig.hostedUrl ||
+      "https://api.context-vault.com";
+    const apiKey = getFlag("--key") || vaultConfig.apiKey;
+
+    if (!apiKey) {
+      console.error(
+        red(`  --key <api_key> required. Get yours at ${hostedUrl}/dashboard`),
+      );
+      process.exit(1);
+    }
+
+    console.log();
+    console.log(`  ${bold("◇ context-vault")} ${dim("switch → hosted")}`);
+    console.log();
+    console.log(dim("  Verifying API key..."));
+
+    try {
+      const response = await fetch(`${hostedUrl}/api/me`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+      });
+      if (!response.ok) throw new Error(`HTTP ${response.status}`);
+      const user = await response.json();
+      console.log(`  ${green("+")} Verified — ${user.email}\n`);
+    } catch (e) {
+      console.error(red(`  Verification failed: ${e.message}`));
+      process.exit(1);
+    }
+
+    vaultConfig.mode = "hosted";
+    vaultConfig.hostedUrl = hostedUrl;
+    vaultConfig.apiKey = apiKey;
+    mkdirSync(dataDir, { recursive: true });
+    writeFileSync(configPath, JSON.stringify(vaultConfig, null, 2) + "\n");
+
+    for (const tool of detected) {
+      try {
+        if (tool.configType === "cli" && tool.id === "codex") {
+          configureCodexHosted(apiKey, hostedUrl);
+        } else if (tool.configType === "cli") {
+          configureClaudeHosted(apiKey, hostedUrl);
+        } else {
+          configureJsonToolHosted(tool, apiKey, hostedUrl);
+        }
+        console.log(`  ${green("+")} ${tool.name} — switched to hosted`);
+      } catch (e) {
+        console.log(`  ${red("x")} ${tool.name} — ${e.message}`);
+      }
+    }
+    console.log();
+    console.log(green("  ✓ Switched to hosted mode."));
+    console.log(dim(`  Endpoint: ${hostedUrl}/mcp`));
+    console.log();
+  }
+}
+
+function runUi() {
   const port = parseInt(getFlag("--port") || "3141", 10);
   const localServer = join(ROOT, "scripts", "local-server.js");
   if (!existsSync(localServer)) {
@@ -1088,20 +1210,9 @@ function launchServer(port, localServer) {
   const child = fork(localServer, [`--port=${port}`], { stdio: "inherit" });
   child.on("exit", (code) => process.exit(code ?? 0));
 
-  // Open browser after a short delay — prefer hosted UI if reachable
-  setTimeout(async () => {
+  setTimeout(() => {
     try {
-      let url = `http://localhost:${port}`;
-      try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 3000);
-        await fetch("https://context-vault.com", {
-          method: "HEAD",
-          signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        url = `https://context-vault.com?local=${port}`;
-      } catch {}
+      const url = `https://app.context-vault.com?local=${port}`;
       console.log(`Opening ${url}`);
       const open =
         PLATFORM === "darwin"
@@ -1157,6 +1268,24 @@ async function runStatus() {
   const { gatherVaultStatus } = await import("@context-vault/core/core/status");
 
   const config = resolveConfig();
+
+  let mode = "local";
+  let modeDetail = "";
+  const rawConfigPath = join(HOME, ".context-mcp", "config.json");
+  if (existsSync(rawConfigPath)) {
+    try {
+      const raw = JSON.parse(readFileSync(rawConfigPath, "utf-8"));
+      mode = raw.mode || "local";
+      if (mode === "hosted" && raw.hostedUrl) {
+        const email = raw.email ? ` · ${raw.email}` : "";
+        modeDetail = ` (${raw.hostedUrl}${email})`;
+      } else {
+        const launcherPath = join(HOME, ".context-mcp", "server.mjs");
+        modeDetail = ` (node ${launcherPath})`;
+      }
+    } catch {}
+  }
+
   const db = await initDatabase(config.dbPath);
 
   const status = gatherVaultStatus({ db, config });
@@ -1166,6 +1295,7 @@ async function runStatus() {
   console.log();
   console.log(`  ${bold("◇ context-vault")} ${dim(`v${VERSION}`)}`);
   console.log();
+  console.log(`  Mode:      ${mode}${dim(modeDetail)}`);
   console.log(
     `  Vault:     ${config.vaultDir} ${dim(`(${config.vaultDirExists ? status.fileCount + " files" : "missing"})`)}`,
   );
@@ -1916,6 +2046,9 @@ async function main() {
     case "connect":
       await runConnect();
       break;
+    case "switch":
+      await runSwitch();
+      break;
     case "serve":
       await runServe();
       break;

package/node_modules/@context-vault/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-vault/core",
-  "version": "2.8.4",
+  "version": "2.8.5",
   "type": "module",
   "description": "Shared core: capture, index, retrieve, tools, and utilities for context-vault",
   "main": "src/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-vault",
-  "version": "2.8.4",
+  "version": "2.8.5",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
@@ -20,7 +20,6 @@
     "bin/",
     "src/",
     "scripts/",
-    "app-dist/",
     "README.md",
     "LICENSE"
   ],
@@ -56,7 +55,7 @@
     "@context-vault/core"
   ],
   "dependencies": {
-    "@context-vault/core": "^2.8.4",
+    "@context-vault/core": "^2.8.5",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "better-sqlite3": "^12.6.2",
     "sqlite-vec": "^0.1.0"

package/scripts/local-server.js

@@ -46,13 +46,7 @@ import {
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const LOCAL_ROOT = resolve(__dirname, "..");
-
-// Try bundled path first (npm install), then workspace path (local dev)
-const bundledDist = resolve(LOCAL_ROOT, "app-dist");
-const workspaceDist = resolve(LOCAL_ROOT, "..", "app", "dist");
-const APP_DIST = existsSync(join(bundledDist, "index.html"))
-  ? bundledDist
-  : workspaceDist;
+const APP_DIST = resolve(LOCAL_ROOT, "app-dist");
 
 const MIME = {
   ".html": "text/html",

package/scripts/postinstall.js

@@ -10,9 +10,10 @@
  */
 
 import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, writeFileSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = join(__dirname, "..");
@@ -88,6 +89,14 @@ async function main() {
       );
     }
   }
+
+  // ── 3. Write local server launcher ───────────────────────────────────
+  const SERVER_ABS = join(PKG_ROOT, "src", "server", "index.js");
+  const DATA_DIR = join(homedir(), ".context-mcp");
+  const LAUNCHER = join(DATA_DIR, "server.mjs");
+  mkdirSync(DATA_DIR, { recursive: true });
+  writeFileSync(LAUNCHER, `import "${SERVER_ABS}";\n`);
+  console.log("[context-vault] Local server launcher written to " + LAUNCHER);
 }
 
 main().catch(() => {});

package/scripts/prepack.js

@@ -6,7 +6,6 @@ import {
   mkdirSync,
   readFileSync,
   writeFileSync,
-  existsSync,
 } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -16,8 +15,6 @@ const LOCAL_ROOT = join(__dirname, "..");
 const NODE_MODULES = join(LOCAL_ROOT, "node_modules");
 const CORE_SRC = join(LOCAL_ROOT, "..", "core");
 const CORE_DEST = join(NODE_MODULES, "@context-vault", "core");
-const APP_SRC = join(LOCAL_ROOT, "..", "app", "dist");
-const APP_DEST = join(LOCAL_ROOT, "app-dist");
 
 // Clean node_modules to prevent workspace deps from leaking into the tarball.
 // Only @context-vault/core should be bundled.
@@ -44,16 +41,3 @@ delete corePkg.dependencies;
 writeFileSync(corePkgPath, JSON.stringify(corePkg, null, 2) + "\n");
 
 console.log("[prepack] Bundled @context-vault/core into node_modules");
-
-// Copy pre-built web dashboard into app-dist/ (optional — UI falls back to cloud)
-if (!existsSync(join(APP_SRC, "index.html"))) {
-  console.warn(
-    "[prepack] WARNING: Web dashboard not built — app-dist/ will not be bundled.\n" +
-      "[prepack] `context-vault ui` will open app.context-vault.com instead.\n" +
-      "[prepack] To bundle locally: build packages/app first.",
-  );
-} else {
-  rmSync(APP_DEST, { recursive: true, force: true });
-  cpSync(APP_SRC, APP_DEST, { recursive: true });
-  console.log("[prepack] Bundled web dashboard into app-dist/");
-}