context-vault 3.1.1 → 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

@@ -379,6 +379,45 @@ async function runSetup() {
         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;
     }
@@ -1195,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);
@@ -4729,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)) {
@@ -4738,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`);
@@ -4764,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.1",
+  "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.1",
+  "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.1",
+    "@context-vault/core": "^3.1.2",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "adm-zip": "^0.5.16",
     "sqlite-vec": "^0.1.0"