context-vault 2.2.0 → 2.4.0

package/bin/cli.js

@@ -20,7 +20,7 @@ import {
   unlinkSync,
 } from "node:fs";
 import { join, resolve, dirname } from "node:path";
-import { homedir } from "node:os";
+import { homedir, platform } from "node:os";
 import { execSync, fork } from "node:child_process";
 import { fileURLToPath } from "node:url";
 
@@ -73,6 +73,36 @@ function prompt(question, defaultVal) {
   });
 }
 
+// ─── Platform Helpers ────────────────────────────────────────────────────────
+
+const PLATFORM = platform();
+
+/** Get the platform-specific application data directory */
+function appDataDir() {
+  switch (PLATFORM) {
+    case "win32":
+      return process.env.APPDATA || join(HOME, "AppData", "Roaming");
+    case "darwin":
+      return join(HOME, "Library", "Application Support");
+    case "linux":
+    default:
+      return process.env.XDG_CONFIG_HOME || join(HOME, ".config");
+  }
+}
+
+/** Get the platform-specific VS Code extensions directory */
+function vscodeDataDir() {
+  switch (PLATFORM) {
+    case "win32":
+      return join(appDataDir(), "Code", "User", "globalStorage");
+    case "darwin":
+      return join(appDataDir(), "Code", "User", "globalStorage");
+    case "linux":
+    default:
+      return join(HOME, ".config", "Code", "User", "globalStorage");
+  }
+}
+
 // ─── Tool Detection ──────────────────────────────────────────────────────────
 
 const TOOLS = [
@@ -81,7 +111,8 @@ const TOOLS = [
     name: "Claude Code",
     detect: () => {
       try {
-        execSync("which claude", { stdio: "pipe" });
+        const cmd = PLATFORM === "win32" ? "where claude" : "which claude";
+        execSync(cmd, { stdio: "pipe" });
         return true;
       } catch {
         return false;
@@ -92,16 +123,9 @@ const TOOLS = [
   {
     id: "claude-desktop",
     name: "Claude Desktop",
-    detect: () =>
-      existsSync(join(HOME, "Library", "Application Support", "Claude")),
+    detect: () => existsSync(join(appDataDir(), "Claude")),
     configType: "json",
-    configPath: join(
-      HOME,
-      "Library",
-      "Application Support",
-      "Claude",
-      "claude_desktop_config.json"
-    ),
+    configPath: join(appDataDir(), "Claude", "claude_desktop_config.json"),
     configKey: "mcpServers",
   },
   {
@@ -124,26 +148,10 @@ const TOOLS = [
     id: "cline",
     name: "Cline (VS Code)",
     detect: () =>
-      existsSync(
-        join(
-          HOME,
-          "Library",
-          "Application Support",
-          "Code",
-          "User",
-          "globalStorage",
-          "saoudrizwan.claude-dev",
-          "settings"
-        )
-      ),
+      existsSync(join(vscodeDataDir(), "saoudrizwan.claude-dev", "settings")),
     configType: "json",
     configPath: join(
-      HOME,
-      "Library",
-      "Application Support",
-      "Code",
-      "User",
-      "globalStorage",
+      vscodeDataDir(),
       "saoudrizwan.claude-dev",
       "settings",
       "cline_mcp_settings.json"
@@ -168,6 +176,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 +196,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 +409,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 +447,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 +484,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 +580,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 +603,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 +666,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) {
@@ -531,7 +680,7 @@ async function runReindex() {
     process.exit(1);
   }
 
-  const db = initDatabase(config.dbPath);
+  const db = await initDatabase(config.dbPath);
   const stmts = prepareStatements(db);
   const ctx = {
     db,
@@ -555,12 +704,12 @@ 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);
+  const db = await initDatabase(config.dbPath);
 
   const status = gatherVaultStatus({ db, config });
 
@@ -620,6 +769,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 +980,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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felix Hellstrom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,36 @@
+{
+  "name": "@context-vault/core",
+  "version": "2.4.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": "git+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}/capture/index.js

@@ -15,7 +15,7 @@ import { parseFrontmatter, formatFrontmatter } from "../core/frontmatter.js";
 import { formatBody } from "./formatters.js";
 import { writeEntryFile } from "./file-ops.js";
 
-export function writeEntry(ctx, { kind, title, body, meta, tags, source, folder, identity_key, expires_at }) {
+export function writeEntry(ctx, { kind, title, body, meta, tags, source, folder, identity_key, expires_at, userId }) {
   if (!kind || typeof kind !== "string") {
     throw new Error("writeEntry: kind is required (non-empty string)");
   }
@@ -59,7 +59,7 @@ export function writeEntry(ctx, { kind, title, body, meta, tags, source, folder,
     category, identity_key, expires_at,
   });
 
-  return { id, filePath, kind, category, title, body, meta, tags, source, createdAt, identity_key, expires_at };
+  return { id, filePath, kind, category, title, body, meta, tags, source, createdAt, identity_key, expires_at, userId: userId || null };
 }
 
 /**
@@ -123,6 +123,7 @@ export function updateEntryFile(ctx, existing, updates) {
     createdAt: fmMeta.created || existing.created_at,
     identity_key: existing.identity_key,
     expires_at,
+    userId: existing.user_id || null,
   };
 }
 

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 */