context-vault 2.2.0 → 2.3.0

package/bin/cli.js

@@ -168,6 +168,9 @@ ${bold("Commands:")}
   ${cyan("ui")} [--port 3141]      Launch web dashboard
   ${cyan("reindex")}               Rebuild search index from knowledge files
   ${cyan("status")}                Show vault diagnostics
+  ${cyan("update")}                Check for and install updates
+  ${cyan("uninstall")}             Remove MCP configs and optionally data
+  ${cyan("migrate")}               Migrate vault between local and hosted
 
 ${bold("Options:")}
   --help                Show this help
@@ -185,6 +188,102 @@ async function runSetup() {
   console.log(dim("  Persistent memory for AI agents"));
   console.log();
 
+  // Check for existing installation
+  const existingConfig = join(HOME, ".context-mcp", "config.json");
+  if (existsSync(existingConfig) && !isNonInteractive) {
+    let existingVault = "(unknown)";
+    try {
+      const cfg = JSON.parse(readFileSync(existingConfig, "utf-8"));
+      existingVault = cfg.vaultDir || existingVault;
+    } catch {}
+
+    console.log(yellow(`  Existing installation detected`));
+    console.log(dim(`  Vault: ${existingVault}`));
+    console.log(dim(`  Config: ${existingConfig}`));
+    console.log();
+    console.log(`    1) Full reconfigure`);
+    console.log(`    2) Update tool configs only ${dim("(skip vault setup)")}`);
+    console.log(`    3) Cancel`);
+    console.log();
+    const choice = await prompt("  Select:", "1");
+
+    if (choice === "3") {
+      console.log(dim("  Cancelled."));
+      return;
+    }
+
+    if (choice === "2") {
+      // Skip vault setup, just reconfigure tools
+      console.log();
+      console.log(dim(`  [1/2]`) + bold(" Detecting tools...\n"));
+      const detected = [];
+      for (const tool of TOOLS) {
+        const found = tool.detect();
+        if (found) {
+          detected.push(tool);
+          console.log(`  ${green("+")} ${tool.name}`);
+        } else {
+          console.log(`  ${dim("-")} ${dim(tool.name)} ${dim("(not found)")}`);
+        }
+      }
+      console.log();
+
+      if (detected.length === 0) {
+        console.log(yellow("  No supported tools detected."));
+        return;
+      }
+
+      let selected;
+      console.log(bold("  Which tools should context-mcp connect to?\n"));
+      for (let i = 0; i < detected.length; i++) {
+        console.log(`    ${i + 1}) ${detected[i].name}`);
+      }
+      console.log();
+      const answer = await prompt(
+        `  Select (${dim("1,2,3")} or ${dim('"all"')}):`,
+        "all"
+      );
+      if (answer === "all" || answer === "") {
+        selected = detected;
+      } else {
+        const nums = answer.split(/[,\s]+/).map((n) => parseInt(n, 10) - 1).filter((n) => n >= 0 && n < detected.length);
+        selected = nums.map((n) => detected[n]);
+        if (selected.length === 0) selected = detected;
+      }
+
+      // Read vault dir from existing config
+      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 {}
+
+      console.log(`\n  ${dim("[2/2]")}${bold(" Configuring tools...\n")}`);
+      for (const tool of selected) {
+        try {
+          if (tool.configType === "cli") {
+            await configureClaude(tool, customVaultDir);
+          } else {
+            configureJsonTool(tool, customVaultDir);
+          }
+          console.log(`  ${green("+")} ${tool.name} — configured`);
+        } catch (e) {
+          console.log(`  ${red("x")} ${tool.name} — ${e.message}`);
+        }
+      }
+
+      console.log();
+      console.log(green("  ✓ Tool configs updated."));
+      console.log();
+      return;
+    }
+    // choice === "1" falls through to full setup below
+    console.log();
+  }
+
   // Detect tools
   console.log(dim(`  [1/5]`) + bold(" Detecting tools...\n"));
   const detected = [];
@@ -302,7 +401,7 @@ async function runSetup() {
   console.log(`\n  ${dim("[3/5]")}${bold(" Downloading embedding model...")}`);
   console.log(dim("  all-MiniLM-L6-v2 (~22MB, one-time download)\n"));
   try {
-    const { embed } = await import("../src/index/embed.js");
+    const { embed } = await import("@context-vault/core/index/embed");
     await embed("warmup");
     console.log(`  ${green("+")} Embedding model ready`);
   } catch (e) {
@@ -340,9 +439,9 @@ async function runSetup() {
   }
 
   // Seed entry
-  const seeded = createSeedEntry(resolvedVaultDir);
-  if (seeded) {
-    console.log(`\n  ${green("+")} Created starter entry in vault`);
+  const seeded = createSeedEntries(resolvedVaultDir);
+  if (seeded > 0) {
+    console.log(`\n  ${green("+")} Created ${seeded} starter ${seeded === 1 ? "entry" : "entries"} in vault`);
   }
 
   // Offer to launch UI
@@ -377,8 +476,15 @@ async function runSetup() {
   const boxLines = [
     `  ✓ Setup complete — ${passed}/${checks.length} checks passed`,
     ``,
-    `  Open ${toolName} and try:`,
+    `  ${bold("AI Tools")} — open ${toolName} and try:`,
     `  "Search my vault for getting started"`,
+    `  "Save an insight about [topic]"`,
+    `  "Show my vault status"`,
+    ``,
+    `  ${bold("CLI Commands:")}`,
+    `  context-mcp status    Show vault health`,
+    `  context-mcp ui        Launch web dashboard`,
+    `  context-mcp update    Check for updates`,
   ];
   const innerWidth = Math.max(...boxLines.map((l) => l.length)) + 2;
   const pad = (s) => s + " ".repeat(Math.max(0, innerWidth - s.length));
@@ -466,18 +572,21 @@ function configureJsonTool(tool, vaultDir) {
   writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 }
 
-// ─── Seed Entry ─────────────────────────────────────────────────────────────
-
-function createSeedEntry(vaultDir) {
-  const seedDir = join(vaultDir, "knowledge", "insights");
-  const seedPath = join(seedDir, "getting-started.md");
-  if (existsSync(seedPath)) return false;
-  mkdirSync(seedDir, { recursive: true });
-  const id = Date.now().toString(36).toUpperCase().padStart(10, "0");
-  const now = new Date().toISOString();
-  const content = `---
-id: ${id}
-tags: ["getting-started"]
+// ─── Seed Entries ────────────────────────────────────────────────────────────
+
+function createSeedEntries(vaultDir) {
+  let created = 0;
+
+  // Entry 1: Getting started (improved)
+  const insightDir = join(vaultDir, "knowledge", "insights");
+  const insightPath = join(insightDir, "getting-started.md");
+  if (!existsSync(insightPath)) {
+    mkdirSync(insightDir, { recursive: true });
+    const id1 = Date.now().toString(36).toUpperCase().padStart(10, "0");
+    const now = new Date().toISOString();
+    writeFileSync(insightPath, `---
+id: ${id1}
+tags: ["getting-started", "vault"]
 source: context-mcp-setup
 created: ${now}
 ---
@@ -486,16 +595,48 @@ Welcome to your context vault! This is a seed entry created during setup.
 Your vault stores knowledge as plain markdown files with YAML frontmatter.
 AI agents search it using hybrid full-text + semantic search.
 
-Try these commands in your AI tool:
-- "Search my vault for getting started"
-- "Save an insight: JavaScript Date objects are mutable"
-- "Show my vault status"
+**Quick start:**
+- "Search my vault for getting started" — find this entry
+- "Save an insight about [topic]" — add knowledge
+- "Show my vault status" — check health
+- "List my recent entries" — browse your vault
 
 You can edit or delete this file anytime — it lives at:
-${seedPath}
-`;
-  writeFileSync(seedPath, content);
-  return true;
+${insightPath}
+`);
+    created++;
+  }
+
+  // Entry 2: Example decision
+  const decisionDir = join(vaultDir, "knowledge", "decisions");
+  const decisionPath = join(decisionDir, "example-local-first-data.md");
+  if (!existsSync(decisionPath)) {
+    mkdirSync(decisionDir, { recursive: true });
+    const id2 = (Date.now() + 1).toString(36).toUpperCase().padStart(10, "0");
+    const now = new Date().toISOString();
+    writeFileSync(decisionPath, `---
+id: ${id2}
+tags: ["example", "architecture"]
+source: context-mcp-setup
+created: ${now}
+---
+Example decision: Use local-first data storage (SQLite + files) over cloud databases.
+
+**Context:** For personal knowledge management, local storage provides better privacy,
+offline access, and zero ongoing cost. The vault uses plain markdown files as the
+source of truth with a SQLite index for fast search.
+
+**Trade-offs:**
+- Pro: Full data ownership, git-versioned, human-editable
+- Pro: No cloud dependency, works offline
+- Con: No built-in sync across devices (use git or Syncthing)
+
+This is an example entry showing the decision format. Feel free to delete it.
+`);
+    created++;
+  }
+
+  return created;
 }
 
 // ─── UI Command ──────────────────────────────────────────────────────────────
@@ -517,10 +658,10 @@ function runUi() {
 async function runReindex() {
   console.log(dim("Loading vault..."));
 
-  const { resolveConfig } = await import("../src/core/config.js");
-  const { initDatabase, prepareStatements, insertVec, deleteVec } = await import("../src/index/db.js");
-  const { embed } = await import("../src/index/embed.js");
-  const { reindex } = await import("../src/index/index.js");
+  const { resolveConfig } = await import("@context-vault/core/core/config");
+  const { initDatabase, prepareStatements, insertVec, deleteVec } = await import("@context-vault/core/index/db");
+  const { embed } = await import("@context-vault/core/index/embed");
+  const { reindex } = await import("@context-vault/core/index");
 
   const config = resolveConfig();
   if (!config.vaultDirExists) {
@@ -555,9 +696,9 @@ async function runReindex() {
 // ─── Status Command ──────────────────────────────────────────────────────────
 
 async function runStatus() {
-  const { resolveConfig } = await import("../src/core/config.js");
-  const { initDatabase } = await import("../src/index/db.js");
-  const { gatherVaultStatus } = await import("../src/core/status.js");
+  const { resolveConfig } = await import("@context-vault/core/core/config");
+  const { initDatabase } = await import("@context-vault/core/index/db");
+  const { gatherVaultStatus } = await import("@context-vault/core/core/status");
 
   const config = resolveConfig();
   const db = initDatabase(config.dbPath);
@@ -620,6 +761,178 @@ async function runStatus() {
   console.log();
 }
 
+// ─── Update Command ─────────────────────────────────────────────────────────
+
+async function runUpdate() {
+  console.log();
+  console.log(`  ${bold("◇ context-vault")} ${dim(`v${VERSION}`)}`);
+  console.log();
+
+  let latest;
+  try {
+    latest = execSync("npm view context-vault version", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    console.error(red("  Could not check for updates. Verify your network connection."));
+    return;
+  }
+
+  if (latest === VERSION) {
+    console.log(green("  Already up to date."));
+    console.log();
+    return;
+  }
+
+  console.log(`  Current: ${dim(VERSION)}`);
+  console.log(`  Latest:  ${green(latest)}`);
+  console.log();
+
+  if (!isNonInteractive) {
+    const answer = await prompt(`  Update to v${latest}? (Y/n):`, "Y");
+    if (answer.toLowerCase() === "n") {
+      console.log(dim("  Cancelled."));
+      return;
+    }
+  }
+
+  console.log(dim("  Installing..."));
+  try {
+    execSync("npm install -g context-vault@latest", { stdio: "inherit" });
+    console.log();
+    console.log(green(`  ✓ Updated to v${latest}`));
+  } catch {
+    console.error(red("  Update failed. Try manually: npm install -g context-vault@latest"));
+  }
+  console.log();
+}
+
+// ─── Uninstall Command ──────────────────────────────────────────────────────
+
+async function runUninstall() {
+  console.log();
+  console.log(`  ${bold("◇ context-vault")} ${dim("uninstall")}`);
+  console.log();
+
+  // Remove from Claude Code
+  try {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    execSync("claude mcp remove context-mcp -s user", { stdio: "pipe", env });
+    console.log(`  ${green("+")} Removed from Claude Code`);
+  } catch {
+    console.log(`  ${dim("-")} Claude Code — not configured or not installed`);
+  }
+
+  // Remove from JSON-configured tools
+  for (const tool of TOOLS.filter((t) => t.configType === "json")) {
+    if (!existsSync(tool.configPath)) continue;
+    try {
+      const config = JSON.parse(readFileSync(tool.configPath, "utf-8"));
+      if (config[tool.configKey]?.["context-mcp"]) {
+        delete config[tool.configKey]["context-mcp"];
+        writeFileSync(tool.configPath, JSON.stringify(config, null, 2) + "\n");
+        console.log(`  ${green("+")} Removed from ${tool.name}`);
+      }
+    } catch {
+      console.log(`  ${dim("-")} ${tool.name} — could not update config`);
+    }
+  }
+
+  // Optionally remove data directory
+  const dataDir = join(HOME, ".context-mcp");
+  if (existsSync(dataDir)) {
+    console.log();
+    const answer = isNonInteractive
+      ? "n"
+      : await prompt(`  Remove data directory (${dataDir})? (y/N):`, "N");
+    if (answer.toLowerCase() === "y") {
+      const { rmSync } = await import("node:fs");
+      rmSync(dataDir, { recursive: true, force: true });
+      console.log(`  ${green("+")} Removed ${dataDir}`);
+    } else {
+      console.log(`  ${dim("Kept")} ${dataDir}`);
+    }
+  }
+
+  console.log();
+  console.log(dim("  Vault directory was not touched (your knowledge files are safe)."));
+  console.log(`  To fully remove: ${cyan("npm uninstall -g context-vault")}`);
+  console.log();
+}
+
+// ─── Migrate Command ─────────────────────────────────────────────────────────
+
+async function runMigrate() {
+  const direction = args.includes("--to-hosted") ? "to-hosted"
+    : args.includes("--to-local") ? "to-local"
+    : null;
+
+  if (!direction) {
+    console.log(`\n  ${bold("context-mcp migrate")}\n`);
+    console.log(`  Usage:`);
+    console.log(`    context-mcp migrate --to-hosted  Upload local vault to hosted service`);
+    console.log(`    context-mcp migrate --to-local   Download hosted vault to local files`);
+    console.log(`\n  Options:`);
+    console.log(`    --url <url>      Hosted server URL (default: https://vault.contextvault.dev)`);
+    console.log(`    --key <key>      API key (cv_...)`);
+    console.log();
+    return;
+  }
+
+  const hostedUrl = getFlag("--url") || "https://vault.contextvault.dev";
+  const apiKey = getFlag("--key");
+
+  if (!apiKey) {
+    console.error(red("  Error: --key <api_key> is required for migration."));
+    console.error(`  Get your API key at ${cyan(hostedUrl + "/dashboard")}`);
+    return;
+  }
+
+  const { resolveConfig } = await import("@context-vault/core/core/config");
+  const config = resolveConfig();
+
+  if (direction === "to-hosted") {
+    const { migrateToHosted } = await import("@context-vault/hosted/migration/migrate");
+    console.log(`\n  ${bold("Migrating to hosted")}...`);
+    console.log(dim(`  Vault: ${config.vaultDir}`));
+    console.log(dim(`  Target: ${hostedUrl}\n`));
+
+    const results = await migrateToHosted({
+      vaultDir: config.vaultDir,
+      hostedUrl,
+      apiKey,
+      log: (msg) => console.log(`  ${dim(msg)}`),
+    });
+
+    console.log(`\n  ${green("+")} ${results.uploaded} entries uploaded`);
+    if (results.failed > 0) {
+      console.log(`  ${red("-")} ${results.failed} failed`);
+      for (const err of results.errors.slice(0, 5)) {
+        console.log(`    ${dim(err)}`);
+      }
+    }
+    console.log(dim("\n  Your local vault was not modified (safe backup)."));
+  } else {
+    const { migrateToLocal } = await import("@context-vault/hosted/migration/migrate");
+    console.log(`\n  ${bold("Migrating to local")}...`);
+    console.log(dim(`  Source: ${hostedUrl}`));
+    console.log(dim(`  Target: ${config.vaultDir}\n`));
+
+    const results = await migrateToLocal({
+      vaultDir: config.vaultDir,
+      hostedUrl,
+      apiKey,
+      log: (msg) => console.log(`  ${dim(msg)}`),
+    });
+
+    console.log(`\n  ${green("+")} ${results.downloaded} entries restored`);
+    if (results.failed > 0) {
+      console.log(`  ${red("-")} ${results.failed} failed`);
+    }
+    console.log(dim("\n  Run `context-mcp reindex` to rebuild the search index."));
+  }
+  console.log();
+}
+
 // ─── Serve Command ──────────────────────────────────────────────────────────
 
 async function runServe() {
@@ -659,6 +972,15 @@ async function main() {
     case "status":
       await runStatus();
       break;
+    case "update":
+      await runUpdate();
+      break;
+    case "uninstall":
+      await runUninstall();
+      break;
+    case "migrate":
+      await runMigrate();
+      break;
     default:
       console.error(red(`Unknown command: ${command}`));
       console.error(`Run ${cyan("context-mcp --help")} for usage.`);

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

@@ -0,0 +1,36 @@
+{
+  "name": "@context-vault/core",
+  "version": "2.3.0",
+  "type": "module",
+  "description": "Shared core: capture, index, retrieve, tools, and utilities for context-vault",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./capture": "./src/capture/index.js",
+    "./capture/formatters": "./src/capture/formatters.js",
+    "./capture/file-ops": "./src/capture/file-ops.js",
+    "./index/db": "./src/index/db.js",
+    "./index/embed": "./src/index/embed.js",
+    "./index": "./src/index/index.js",
+    "./retrieve": "./src/retrieve/index.js",
+    "./server/tools": "./src/server/tools.js",
+    "./server/helpers": "./src/server/helpers.js",
+    "./core/categories": "./src/core/categories.js",
+    "./core/config": "./src/core/config.js",
+    "./core/files": "./src/core/files.js",
+    "./core/frontmatter": "./src/core/frontmatter.js",
+    "./core/status": "./src/core/status.js"
+  },
+  "files": ["src/"],
+  "license": "MIT",
+  "engines": { "node": ">=20" },
+  "author": "Felix Hellstrom",
+  "repository": { "type": "git", "url": "https://github.com/fellanH/context-mcp.git", "directory": "packages/core" },
+  "homepage": "https://github.com/fellanH/context-mcp",
+  "dependencies": {
+    "@huggingface/transformers": "^3.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "better-sqlite3": "^12.6.2",
+    "sqlite-vec": "^0.1.0"
+  }
+}

package/{src → node_modules/@context-vault/core/src}/core/categories.js

@@ -27,6 +27,7 @@ const KIND_CATEGORY = {
   session: "event",
   task: "event",
   log: "event",
+  feedback: "event",
 };
 
 /** Map category name → directory name on disk */

package/{src → node_modules/@context-vault/core/src}/core/files.js

@@ -56,6 +56,7 @@ const PLURAL_MAP = {
   message: "messages",
   session: "sessions",
   log: "logs",
+  feedback: "feedbacks",
 };
 
 const SINGULAR_MAP = Object.fromEntries(

package/{src → node_modules/@context-vault/core/src}/index/embed.js

@@ -2,7 +2,16 @@
  * embed.js — Text embedding via HuggingFace transformers
  */
 
-import { pipeline } from "@huggingface/transformers";
+import { pipeline, env } from "@huggingface/transformers";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync } from "node:fs";
+
+// Redirect model cache to ~/.context-mcp/models/ so it works when the
+// package is installed globally in a root-owned directory (e.g. /usr/lib/node_modules/).
+const modelCacheDir = join(homedir(), ".context-mcp", "models");
+mkdirSync(modelCacheDir, { recursive: true });
+env.cacheDir = modelCacheDir;
 
 let extractor = null;
 

package/node_modules/@context-vault/core/src/index.js

@@ -0,0 +1,29 @@
+/**
+ * @context-vault/core — Shared core for context-vault
+ *
+ * Re-exports all public APIs from capture, index, retrieve, server, and core layers.
+ */
+
+// Core utilities
+export { categoryFor, categoryDirFor, CATEGORY_DIRS } from "./core/categories.js";
+export { parseArgs, resolveConfig } from "./core/config.js";
+export { ulid, slugify, kindToDir, dirToKind, normalizeKind, kindToPath, safeJoin, walkDir } from "./core/files.js";
+export { formatFrontmatter, parseFrontmatter, extractCustomMeta, parseEntryFromMarkdown } from "./core/frontmatter.js";
+export { gatherVaultStatus } from "./core/status.js";
+
+// Capture layer
+export { writeEntry, updateEntryFile, captureAndIndex } from "./capture/index.js";
+export { writeEntryFile } from "./capture/file-ops.js";
+export { formatBody } from "./capture/formatters.js";
+
+// Index layer
+export { SCHEMA_DDL, initDatabase, prepareStatements, insertVec, deleteVec } from "./index/db.js";
+export { embed, embedBatch, resetEmbedPipeline } from "./index/embed.js";
+export { indexEntry, reindex } from "./index/index.js";
+
+// Retrieve layer
+export { hybridSearch } from "./retrieve/index.js";
+
+// Server tools & helpers
+export { registerTools } from "./server/tools.js";
+export { ok, err, ensureVaultExists, ensureValidKind } from "./server/helpers.js";