context-vault 3.1.0 → 3.1.2

package/README.md

@@ -10,13 +10,16 @@ Persistent memory for AI agents — saves and searches knowledge across sessions
 ## Quick Start
 
 ```bash
-npx context-vault
+npm install -g context-vault
+context-vault setup
 ```
 
-One command — no global install required. Setup detects your AI tools (Claude Code, Codex, Claude Desktop, Cursor, Windsurf, Cline, and more), downloads the embedding model (~22MB), seeds your vault, and configures MCP.
+Setup detects your AI tools (Claude Code, Codex, Claude Desktop, Cursor, Windsurf, Cline, and more), downloads the embedding model (~22MB), seeds your vault, and configures MCP.
 
 Then open your AI tool and try: **"Search my vault for getting started"**
 
+> **Quick try without installing?** `npx context-vault` works too, but a global install is recommended for reliable MCP server startup.
+
 ## What It Does
 
 - **Save** — insights, decisions, patterns, contacts. Your AI agent writes them as you work.
@@ -73,7 +76,7 @@ Claude Code exposes shell hooks that fire on session events. context-vault integ
         "hooks": [
           {
             "type": "command",
-            "command": "npx context-vault flush",
+            "command": "context-vault flush",
             "timeout": 10
           }
         ]

package/bin/cli.js

@@ -375,30 +375,49 @@ async function runSetup() {
     } catch {}
 
     if (latestVersion === VERSION) {
-      // Even when "up to date", ensure the launcher points to a valid server
-      const dataDir = join(HOME, ".context-mcp");
-      const launcherPath = join(dataDir, "server.mjs");
-      let launcherOk = false;
-      if (existsSync(launcherPath)) {
-        const content = readFileSync(launcherPath, "utf-8");
-        const m = content.match(/import "(.+?)"/);
-        if (m && existsSync(m[1])) launcherOk = true;
-      }
-      if (!launcherOk && !isNpx()) {
-        mkdirSync(dataDir, { recursive: true });
-        writeFileSync(launcherPath, `import "${SERVER_PATH}";\n`);
-        console.log(
-          green(`  ✓ context-vault v${VERSION} is up to date`) +
-            dim(`  (vault: ${existingVault})`),
-        );
-        console.log(dim(`  ↳ Repaired server launcher → ${SERVER_PATH}`));
-        console.log();
-        return;
-      }
       console.log(
         green(`  ✓ context-vault v${VERSION} is up to date`) +
           dim(`  (vault: ${existingVault})`),
       );
+
+      // Check for stale tool configs using hardcoded node paths
+      const staleConfigs = findStaleToolConfigs();
+      if (staleConfigs.length > 0) {
+        console.log();
+        console.log(
+          yellow(`  ! ${staleConfigs.length} tool config(s) using legacy hardcoded paths`),
+        );
+        for (const s of staleConfigs) {
+          console.log(dim(`    ${s.name}: ${s.command}`));
+        }
+        console.log();
+        const fix = await prompt(
+          `  Auto-fix to use context-vault binary? (Y/n):`,
+          "Y",
+        );
+        if (fix.toLowerCase() !== "n") {
+          let customVaultDir = null;
+          try {
+            const cfg = JSON.parse(readFileSync(existingConfig, "utf-8"));
+            const defaultVDir = join(HOME, "vault");
+            if (cfg.vaultDir && resolve(cfg.vaultDir) !== resolve(defaultVDir)) {
+              customVaultDir = cfg.vaultDir;
+            }
+          } catch {}
+          for (const s of staleConfigs) {
+            try {
+              repairToolConfig(s, customVaultDir);
+              console.log(`  ${green("+")} ${s.name} — fixed`);
+            } catch (e) {
+              console.log(`  ${red("x")} ${s.name} — ${e.message}`);
+            }
+          }
+          console.log();
+          console.log(green("  ✓ Tool configs updated."));
+          console.log(dim("  Restart your AI tools to apply the changes."));
+        }
+      }
+
       console.log();
       return;
     }
@@ -513,12 +532,12 @@ async function runSetup() {
   if (detected.length === 0) {
     console.log(yellow("  No supported tools detected.\n"));
     console.log("  To manually configure, add to your tool's MCP config:\n");
-    if (isInstalledPackage()) {
+    if (isInstalledPackage() || isNpx()) {
       console.log(`  ${dim("{")}
     ${dim('"mcpServers": {')}
       ${dim('"context-vault": {')}
-        ${dim('"command": "npx",')}
-        ${dim(`"args": ["-y", "context-vault", "serve", "--vault-dir", "/path/to/vault"]`)}
+        ${dim('"command": "context-vault",')}
+        ${dim(`"args": ["serve", "--vault-dir", "/path/to/vault"]`)}
       ${dim("}")}
     ${dim("}")}
   ${dim("}")}\n`);
@@ -665,11 +684,6 @@ async function runSetup() {
   const dataDir = join(HOME, ".context-mcp");
   mkdirSync(dataDir, { recursive: true });
 
-  // Keep server.mjs launcher up to date so it always resolves to the current installation
-  if (isInstalledPackage()) {
-    writeFileSync(join(dataDir, "server.mjs"), `import "${SERVER_PATH}";\n`);
-  }
-
   // Write config.json to data dir (persistent, survives reinstalls)
   const configPath = join(dataDir, "config.json");
   const vaultConfig = {};
@@ -1137,11 +1151,25 @@ async function configureClaude(tool, vaultDir) {
         ],
         { stdio: "pipe", env },
       );
+    } else if (isInstalledPackage()) {
+      const serverArgs = ["serve"];
+      if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
+      execFileSync(
+        "claude",
+        [
+          "mcp",
+          "add",
+          "-s",
+          "user",
+          "context-vault",
+          "--",
+          "context-vault",
+          ...serverArgs,
+        ],
+        { stdio: "pipe", env },
+      );
     } else {
-      const serverPath = isInstalledPackage()
-        ? join(HOME, ".context-mcp", "server.mjs")
-        : SERVER_PATH;
-      const nodeArgs = [serverPath];
+      const nodeArgs = [SERVER_PATH];
       if (vaultDir) nodeArgs.push("--vault-dir", vaultDir);
       execFileSync(
         "claude",
@@ -1183,11 +1211,16 @@ async function configureCodex(tool, vaultDir) {
         ["mcp", "add", "context-vault", "--", "npx", ...serverArgs],
         { stdio: "pipe" },
       );
+    } else if (isInstalledPackage()) {
+      const serverArgs = ["serve"];
+      if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
+      execFileSync(
+        "codex",
+        ["mcp", "add", "context-vault", "--", "context-vault", ...serverArgs],
+        { stdio: "pipe" },
+      );
     } else {
-      const serverPath = isInstalledPackage()
-        ? join(HOME, ".context-mcp", "server.mjs")
-        : SERVER_PATH;
-      const nodeArgs = [serverPath];
+      const nodeArgs = [SERVER_PATH];
       if (vaultDir) nodeArgs.push("--vault-dir", vaultDir);
       execFileSync(
         "codex",
@@ -1201,6 +1234,77 @@ async function configureCodex(tool, vaultDir) {
   }
 }
 
+function findStaleToolConfigs() {
+  const stale = [];
+
+  // Check Claude Code (~/.claude.json)
+  const claudePath = join(HOME, ".claude.json");
+  if (existsSync(claudePath)) {
+    try {
+      const cfg = JSON.parse(readFileSync(claudePath, "utf-8"));
+      const srv = cfg?.mcpServers?.["context-vault"];
+      if (srv && srv.command !== "context-vault" && srv.command !== "npx") {
+        stale.push({
+          name: "Claude Code",
+          id: "claude-code",
+          configType: "cli",
+          configPath: claudePath,
+          command: [srv.command, ...(srv.args || [])].join(" "),
+        });
+      }
+    } catch {}
+  }
+
+  // Check JSON-configured tools
+  for (const tool of TOOLS.filter((t) => t.configType === "json")) {
+    const cfgPath = tool.configPath;
+    if (!cfgPath || !existsSync(cfgPath)) continue;
+    try {
+      const cfg = JSON.parse(readFileSync(cfgPath, "utf-8"));
+      const srv = cfg?.[tool.configKey]?.["context-vault"];
+      if (srv && srv.command !== "context-vault" && srv.command !== "npx") {
+        stale.push({
+          name: tool.name,
+          id: tool.id,
+          configType: "json",
+          configPath: cfgPath,
+          configKey: tool.configKey,
+          command: [srv.command, ...(srv.args || [])].join(" "),
+        });
+      }
+    } catch {}
+  }
+
+  return stale;
+}
+
+function repairToolConfig(staleEntry, vaultDir) {
+  const serverArgs = ["serve"];
+  if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
+  const newConfig = { command: "context-vault", args: serverArgs };
+
+  if (staleEntry.id === "claude-code") {
+    // Use `claude mcp remove` + `claude mcp add`
+    try {
+      execFileSync("claude", ["mcp", "remove", "context-vault"], {
+        stdio: "pipe",
+      });
+    } catch {}
+    execFileSync(
+      "claude",
+      ["mcp", "add", "context-vault", "--", "context-vault", ...serverArgs],
+      { stdio: "pipe" },
+    );
+    return;
+  }
+
+  // JSON config tools
+  const cfgPath = staleEntry.configPath;
+  const cfg = JSON.parse(readFileSync(cfgPath, "utf-8"));
+  cfg[staleEntry.configKey]["context-vault"] = newConfig;
+  writeFileSync(cfgPath, JSON.stringify(cfg, null, 2) + "\n");
+}
+
 function configureJsonTool(tool, vaultDir) {
   const configPath = tool.configPath;
   const configDir = dirname(configPath);
@@ -1237,13 +1341,11 @@ function configureJsonTool(tool, vaultDir) {
       env: { NODE_OPTIONS: "--no-warnings=ExperimentalWarning" },
     };
   } else if (isInstalledPackage()) {
-    const launcherPath = join(HOME, ".context-mcp", "server.mjs");
-    const serverArgs = [];
+    const serverArgs = ["serve"];
     if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
     config[tool.configKey]["context-vault"] = {
-      command: process.execPath,
-      args: [launcherPath, ...serverArgs],
-      env: { NODE_OPTIONS: "--no-warnings=ExperimentalWarning" },
+      command: "context-vault",
+      args: serverArgs,
     };
   } else {
     const serverArgs = [SERVER_PATH];
@@ -1598,13 +1700,6 @@ async function runSwitch() {
   const { detected } = await detectAllTools();
 
   if (target === "local") {
-    const launcherPath = join(dataDir, "server.mjs");
-    if (!existsSync(launcherPath)) {
-      const serverAbs = resolve(ROOT, "src", "server.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");
@@ -1636,7 +1731,7 @@ async function runSwitch() {
     }
     console.log();
     console.log(green("  ✓ Switched to local mode."));
-    console.log(dim(`  Server: node ${launcherPath}`));
+    console.log(dim(`  Server: context-vault serve`));
     console.log();
   } else {
     const hostedUrl = getFlag("--url") || vaultConfig.hostedUrl || API_URL;
@@ -2044,8 +2139,7 @@ async function runStatus() {
         const email = raw.email ? ` · ${raw.email}` : "";
         modeDetail = ` (${raw.hostedUrl}${email})`;
       } else {
-        const launcherPath = join(HOME, ".context-mcp", "server.mjs");
-        modeDetail = ` (node ${launcherPath})`;
+        modeDetail = ` (context-vault serve)`;
       }
     } catch {}
   }
@@ -4687,35 +4781,34 @@ async function runDoctor() {
       db?.close();
     } catch {}
 
-    // ── Launcher (server.mjs) ─────────────────────────────────────────────
-    const launcherPath = join(HOME, ".context-mcp", "server.mjs");
-    if (existsSync(launcherPath)) {
-      const launcherContent = readFileSync(launcherPath, "utf-8");
-      const match = launcherContent.match(/import "(.+?)"/);
-      if (match) {
-        const serverEntryPath = match[1];
-        if (existsSync(serverEntryPath)) {
-          console.log(
-            `  ${green("✓")} Launcher ${dim(`→ ${serverEntryPath}`)}`,
-          );
-        } else {
-          console.log(
-            `  ${red("✘")} Launcher points to missing server: ${serverEntryPath}`,
-          );
-          console.log(
-            `    ${dim("Fix: run context-vault setup to reinstall")}`,
-          );
-          allOk = false;
-        }
-      } else {
-        console.log(`  ${green("✓")} Launcher exists ${dim(launcherPath)}`);
-      }
-    } else {
-      console.log(`  ${yellow("!")} Launcher not found at ${launcherPath}`);
-      console.log(`    ${dim("Fix: run context-vault setup")}`);
+    // ── CLI binary ──────────────────────────────────────────────────────
+    try {
+      const binVersion = execSync("context-vault --version", {
+        encoding: "utf-8",
+        timeout: 5000,
+      }).trim();
+      console.log(
+        `  ${green("✓")} CLI binary ${dim(`(${binVersion})`)}`,
+      );
+    } catch {
+      console.log(
+        `  ${red("✘")} CLI binary not found in PATH`,
+      );
+      console.log(
+        `    ${dim("Fix: npm install -g context-vault")}`,
+      );
       allOk = false;
     }
 
+    // Clean up legacy launcher if it exists
+    const legacyLauncher = join(HOME, ".context-mcp", "server.mjs");
+    if (existsSync(legacyLauncher)) {
+      try {
+        unlinkSync(legacyLauncher);
+        console.log(`  ${green("✓")} Removed legacy launcher ${dim(legacyLauncher)}`);
+      } catch {}
+    }
+
     // ── Error log ─────────────────────────────────────────────────────────
     const logPath = errorLogPath(config.dataDir);
     const logCount = errorLogCount(config.dataDir);
@@ -4746,6 +4839,8 @@ async function runDoctor() {
   console.log(bold("  Tool Configurations"));
   let anyToolConfigured = false;
 
+  const isStaleCmd = (cmd) => cmd !== "context-vault" && cmd !== "npx";
+
   // Check Claude Code
   const claudeConfigPath = join(HOME, ".claude.json");
   if (existsSync(claudeConfigPath)) {
@@ -4755,7 +4850,13 @@ async function runDoctor() {
       if (servers["context-vault"]) {
         const srv = servers["context-vault"];
         const cmd = [srv.command, ...(srv.args || [])].join(" ");
-        console.log(`  ${green("+")} Claude Code: ${dim(cmd)}`);
+        if (isStaleCmd(srv.command)) {
+          console.log(`  ${yellow("!")} Claude Code: ${dim(cmd)}`);
+          console.log(`    ${dim("Fix: run context-vault setup to update")}`);
+          allOk = false;
+        } else {
+          console.log(`  ${green("+")} Claude Code: ${dim(cmd)}`);
+        }
         anyToolConfigured = true;
       } else {
         console.log(`  ${dim("-")} Claude Code: not configured`);
@@ -4781,7 +4882,13 @@ async function runDoctor() {
       if (servers["context-vault"]) {
         const srv = servers["context-vault"];
         const cmd = [srv.command, ...(srv.args || [])].join(" ");
-        console.log(`  ${green("+")} ${tool.name}: ${dim(cmd)}`);
+        if (isStaleCmd(srv.command)) {
+          console.log(`  ${yellow("!")} ${tool.name}: ${dim(cmd)}`);
+          console.log(`    ${dim("Fix: run context-vault setup to update")}`);
+          allOk = false;
+        } else {
+          console.log(`  ${green("+")} ${tool.name}: ${dim(cmd)}`);
+        }
         anyToolConfigured = true;
       } else if (servers["context-mcp"]) {
         console.log(

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

@@ -1,6 +1,6 @@
 {
   "name": "@context-vault/core",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "type": "module",
   "description": "Pure local engine: capture, index, search, and utilities for context-vault",
   "main": "dist/main.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-vault",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
@@ -57,7 +57,7 @@
     "@context-vault/core"
   ],
   "dependencies": {
-    "@context-vault/core": "^3.1.0",
+    "@context-vault/core": "^3.1.2",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "adm-zip": "^0.5.16",
     "sqlite-vec": "^0.1.0"

package/scripts/postinstall.js

@@ -6,11 +6,11 @@
  * 1. Installs @huggingface/transformers with --ignore-scripts to avoid sharp's
  *    broken install lifecycle in global contexts.  Semantic search degrades
  *    gracefully if this step fails.
- * 2. Writes local server launcher (global installs only).
+ * 2. Ensures data directory exists.
  */
 
 import { execSync } from "node:child_process";
-import { existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { existsSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
@@ -51,18 +51,9 @@ async function main() {
     }
   }
 
-  // ── 2. Write local server launcher (global installs only) ────────────
-  // Under npx the path would be stale after cache eviction — configs use
-  // `npx context-vault serve` instead, so skip writing the launcher.
-  const isNpx = PKG_ROOT.includes("/_npx/") || PKG_ROOT.includes("\\_npx\\");
-  if (!isNpx) {
-    const SERVER_ABS = join(PKG_ROOT, "src", "server.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);
-  }
+  // ── 2. Ensure data dir exists ────────────────────────────────────────
+  const DATA_DIR = join(homedir(), ".context-mcp");
+  mkdirSync(DATA_DIR, { recursive: true });
 }
 
 main().catch(() => {});