context-vault 2.8.0 → 2.8.4

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

@@ -1,11 +1,5 @@
-/**
- * db.js — Database schema, initialization, and prepared statements
- */
-
 import { unlinkSync, copyFileSync, existsSync } from "node:fs";
 
-// ─── Native Module Error ────────────────────────────────────────────────────
-
 export class NativeModuleError extends Error {
   constructor(originalError) {
     const diagnostic = formatNativeModuleError(originalError);
@@ -18,7 +12,7 @@ export class NativeModuleError extends Error {
 function formatNativeModuleError(err) {
   const msg = err.message || "";
   const versionMatch = msg.match(
-    /was compiled against a different Node\.js version using\s+NODE_MODULE_VERSION (\d+)\. This version of Node\.js requires\s+NODE_MODULE_VERSION (\d+)/
+    /was compiled against a different Node\.js version using\s+NODE_MODULE_VERSION (\d+)\. This version of Node\.js requires\s+NODE_MODULE_VERSION (\d+)/,
   );
 
   const lines = [
@@ -44,13 +38,12 @@ function formatNativeModuleError(err) {
   return lines.join("\n");
 }
 
-// ─── Lazy Native Module Loading ─────────────────────────────────────────────
-
 let _Database = null;
 let _sqliteVec = null;
 
 async function loadNativeModules() {
-  if (_Database && _sqliteVec) return { Database: _Database, sqliteVec: _sqliteVec };
+  if (_Database && _sqliteVec)
+    return { Database: _Database, sqliteVec: _sqliteVec };
 
   try {
     const dbMod = await import("better-sqlite3");
@@ -69,8 +62,6 @@ async function loadNativeModules() {
   return { Database: _Database, sqliteVec: _sqliteVec };
 }
 
-// ─── Schema DDL (v7 — teams) ────────────────────────────────────────────────
-
 export const SCHEMA_DDL = `
   CREATE TABLE IF NOT EXISTS vault (
     id              TEXT PRIMARY KEY,
@@ -126,8 +117,6 @@ export const SCHEMA_DDL = `
   CREATE VIRTUAL TABLE IF NOT EXISTS vault_vec USING vec0(embedding float[384]);
 `;
 
-// ─── Database Init ───────────────────────────────────────────────────────────
-
 export async function initDatabase(dbPath) {
   const { Database, sqliteVec } = await loadNativeModules();
 
@@ -148,7 +137,9 @@ export async function initDatabase(dbPath) {
 
   // Enforce fresh-DB-only — old schemas get a full rebuild (with backup)
   if (version > 0 && version < 5) {
-    console.error(`[context-vault] Schema v${version} is outdated. Rebuilding database...`);
+    console.error(
+      `[context-vault] Schema v${version} is outdated. Rebuilding database...`,
+    );
 
     // Backup old DB before destroying it
     const backupPath = `${dbPath}.v${version}.backup`;
@@ -156,15 +147,23 @@ export async function initDatabase(dbPath) {
       db.close();
       if (existsSync(dbPath)) {
         copyFileSync(dbPath, backupPath);
-        console.error(`[context-vault] Backed up old database to: ${backupPath}`);
+        console.error(
+          `[context-vault] Backed up old database to: ${backupPath}`,
+        );
       }
     } catch (backupErr) {
-      console.error(`[context-vault] Warning: could not backup old database: ${backupErr.message}`);
+      console.error(
+        `[context-vault] Warning: could not backup old database: ${backupErr.message}`,
+      );
     }
 
     unlinkSync(dbPath);
-    try { unlinkSync(dbPath + "-wal"); } catch {}
-    try { unlinkSync(dbPath + "-shm"); } catch {}
+    try {
+      unlinkSync(dbPath + "-wal");
+    } catch {}
+    try {
+      unlinkSync(dbPath + "-shm");
+    } catch {}
 
     const freshDb = createDb(dbPath);
     freshDb.exec(SCHEMA_DDL);
@@ -180,7 +179,9 @@ export async function initDatabase(dbPath) {
     // Wrapped in transaction with duplicate-column guards for idempotent retry
     const migrate = db.transaction(() => {
       const addColumnSafe = (sql) => {
-        try { db.exec(sql); } catch (e) {
+        try {
+          db.exec(sql);
+        } catch (e) {
           if (!e.message.includes("duplicate column")) throw e;
         }
       };
@@ -193,14 +194,18 @@ export async function initDatabase(dbPath) {
       db.exec(`CREATE INDEX IF NOT EXISTS idx_vault_user ON vault(user_id)`);
       db.exec(`CREATE INDEX IF NOT EXISTS idx_vault_team ON vault(team_id)`);
       db.exec(`DROP INDEX IF EXISTS idx_vault_identity`);
-      db.exec(`CREATE UNIQUE INDEX IF NOT EXISTS idx_vault_identity ON vault(user_id, kind, identity_key) WHERE identity_key IS NOT NULL`);
+      db.exec(
+        `CREATE UNIQUE INDEX IF NOT EXISTS idx_vault_identity ON vault(user_id, kind, identity_key) WHERE identity_key IS NOT NULL`,
+      );
       db.pragma("user_version = 7");
     });
     migrate();
   } else if (version === 6) {
     // v6 -> v7 migration: add team_id column
     const migrate = db.transaction(() => {
-      try { db.exec(`ALTER TABLE vault ADD COLUMN team_id TEXT`); } catch (e) {
+      try {
+        db.exec(`ALTER TABLE vault ADD COLUMN team_id TEXT`);
+      } catch (e) {
         if (!e.message.includes("duplicate column")) throw e;
       }
       db.exec(`CREATE INDEX IF NOT EXISTS idx_vault_team ON vault(team_id)`);
@@ -212,34 +217,42 @@ export async function initDatabase(dbPath) {
   return db;
 }
 
-// ─── Prepared Statements Factory ─────────────────────────────────────────────
-
 export function prepareStatements(db) {
   try {
     return {
-      insertEntry: db.prepare(`INSERT INTO vault (id, user_id, kind, category, title, body, meta, tags, source, file_path, identity_key, expires_at, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
-      insertEntryEncrypted: db.prepare(`INSERT INTO vault (id, user_id, kind, category, title, body, meta, tags, source, file_path, identity_key, expires_at, created_at, body_encrypted, title_encrypted, meta_encrypted, iv) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
-      updateEntry: db.prepare(`UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, identity_key = ?, expires_at = ? WHERE file_path = ?`),
+      insertEntry: db.prepare(
+        `INSERT INTO vault (id, user_id, kind, category, title, body, meta, tags, source, file_path, identity_key, expires_at, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      ),
+      insertEntryEncrypted: db.prepare(
+        `INSERT INTO vault (id, user_id, kind, category, title, body, meta, tags, source, file_path, identity_key, expires_at, created_at, body_encrypted, title_encrypted, meta_encrypted, iv) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      ),
+      updateEntry: db.prepare(
+        `UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, identity_key = ?, expires_at = ? WHERE file_path = ?`,
+      ),
       deleteEntry: db.prepare(`DELETE FROM vault WHERE id = ?`),
       getRowid: db.prepare(`SELECT rowid FROM vault WHERE id = ?`),
       getRowidByPath: db.prepare(`SELECT rowid FROM vault WHERE file_path = ?`),
       getEntryById: db.prepare(`SELECT * FROM vault WHERE id = ?`),
-      getByIdentityKey: db.prepare(`SELECT * FROM vault WHERE kind = ? AND identity_key = ? AND user_id IS ?`),
-      upsertByIdentityKey: db.prepare(`UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, file_path = ?, expires_at = ? WHERE kind = ? AND identity_key = ? AND user_id IS ?`),
-      insertVecStmt: db.prepare(`INSERT INTO vault_vec (rowid, embedding) VALUES (?, ?)`),
+      getByIdentityKey: db.prepare(
+        `SELECT * FROM vault WHERE kind = ? AND identity_key = ? AND user_id IS ?`,
+      ),
+      upsertByIdentityKey: db.prepare(
+        `UPDATE vault SET title = ?, body = ?, meta = ?, tags = ?, source = ?, category = ?, file_path = ?, expires_at = ? WHERE kind = ? AND identity_key = ? AND user_id IS ?`,
+      ),
+      insertVecStmt: db.prepare(
+        `INSERT INTO vault_vec (rowid, embedding) VALUES (?, ?)`,
+      ),
       deleteVecStmt: db.prepare(`DELETE FROM vault_vec WHERE rowid = ?`),
     };
   } catch (e) {
     throw new Error(
       `Failed to prepare database statements. The database may be corrupted.\n` +
-      `Try deleting and rebuilding: rm "${db.name}" && context-vault reindex\n` +
-      `Original error: ${e.message}`
+        `Try deleting and rebuilding: rm "${db.name}" && context-vault reindex\n` +
+        `Original error: ${e.message}`,
     );
   }
 }
 
-// ─── Vector Helpers (parameterized rowid via cached statements) ──────────────
-
 export function insertVec(stmts, rowid, embedding) {
   // sqlite-vec requires BigInt for primary key — better-sqlite3 binds Number as REAL,
   // but vec0 virtual tables only accept INTEGER rowids

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

@@ -30,14 +30,20 @@ async function ensurePipeline() {
     mkdirSync(modelCacheDir, { recursive: true });
     env.cacheDir = modelCacheDir;
 
-    console.error("[context-vault] Loading embedding model (first run may download ~22MB)...");
+    console.error(
+      "[context-vault] Loading embedding model (first run may download ~22MB)...",
+    );
     extractor = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
     embedAvailable = true;
     return extractor;
   } catch (e) {
     embedAvailable = false;
-    console.error(`[context-vault] Failed to load embedding model: ${e.message}`);
-    console.error(`[context-vault] Semantic search disabled. Full-text search still works.`);
+    console.error(
+      `[context-vault] Failed to load embedding model: ${e.message}`,
+    );
+    console.error(
+      `[context-vault] Semantic search disabled. Full-text search still works.`,
+    );
     return null;
   }
 }
@@ -74,9 +80,13 @@ export async function embedBatch(texts) {
   }
   const dim = result.data.length / texts.length;
   if (!Number.isInteger(dim) || dim <= 0) {
-    throw new Error(`Unexpected embedding dimension: ${result.data.length} / ${texts.length} = ${dim}`);
+    throw new Error(
+      `Unexpected embedding dimension: ${result.data.length} / ${texts.length} = ${dim}`,
+    );
   }
-  return texts.map((_, i) => new Float32Array(result.data.buffer, i * dim * 4, dim));
+  return texts.map(
+    (_, i) => new Float32Array(result.data.buffer, i * dim * 4, dim),
+  );
 }
 
 /** Force re-initialization on next embed call. */

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

@@ -5,19 +5,47 @@
  */
 
 // Core utilities
-export { categoryFor, categoryDirFor, CATEGORY_DIRS } from "./core/categories.js";
+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 {
+  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 {
+  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 {
+  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";
 
@@ -26,4 +54,9 @@ export { hybridSearch } from "./retrieve/index.js";
 
 // Server tools & helpers
 export { registerTools } from "./server/tools.js";
-export { ok, err, ensureVaultExists, ensureValidKind } from "./server/helpers.js";
+export {
+  ok,
+  err,
+  ensureVaultExists,
+  ensureValidKind,
+} from "./server/helpers.js";

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

@@ -38,7 +38,13 @@ export function recencyBoost(createdAt, category, decayDays = 30) {
  * Build additional WHERE clauses for category/time filtering.
  * Returns { clauses: string[], params: any[] }
  */
-export function buildFilterClauses({ categoryFilter, since, until, userIdFilter, teamIdFilter }) {
+export function buildFilterClauses({
+  categoryFilter,
+  since,
+  until,
+  userIdFilter,
+  teamIdFilter,
+}) {
   const clauses = [];
   const params = [];
   if (userIdFilter !== undefined) {
@@ -76,10 +82,26 @@ export function buildFilterClauses({ categoryFilter, since, until, userIdFilter,
 export async function hybridSearch(
   ctx,
   query,
-  { kindFilter = null, categoryFilter = null, since = null, until = null, limit = 20, offset = 0, decayDays = 30, userIdFilter, teamIdFilter = null } = {}
+  {
+    kindFilter = null,
+    categoryFilter = null,
+    since = null,
+    until = null,
+    limit = 20,
+    offset = 0,
+    decayDays = 30,
+    userIdFilter,
+    teamIdFilter = null,
+  } = {},
 ) {
   const results = new Map();
-  const extraFilters = buildFilterClauses({ categoryFilter, since, until, userIdFilter, teamIdFilter });
+  const extraFilters = buildFilterClauses({
+    categoryFilter,
+    since,
+    until,
+    userIdFilter,
+    teamIdFilter,
+  });
 
   // FTS5 search
   const ftsQuery = buildFtsQuery(query);
@@ -126,10 +148,16 @@ export async function hybridSearch(
       if (queryVec) {
         // Increase limits in hosted mode to compensate for post-filtering
         const hasPostFilter = userIdFilter !== undefined || teamIdFilter;
-        const vecLimit = hasPostFilter ? (kindFilter ? 60 : 30) : (kindFilter ? 30 : 15);
+        const vecLimit = hasPostFilter
+          ? kindFilter
+            ? 60
+            : 30
+          : kindFilter
+            ? 30
+            : 15;
         const vecRows = ctx.db
           .prepare(
-            `SELECT v.rowid, v.distance FROM vault_vec v WHERE embedding MATCH ? ORDER BY distance LIMIT ${vecLimit}`
+            `SELECT v.rowid, v.distance FROM vault_vec v WHERE embedding MATCH ? ORDER BY distance LIMIT ${vecLimit}`,
           )
           .all(queryVec);
 
@@ -138,7 +166,9 @@ export async function hybridSearch(
           const rowids = vecRows.map((vr) => vr.rowid);
           const placeholders = rowids.map(() => "?").join(",");
           const hydrated = ctx.db
-            .prepare(`SELECT rowid, * FROM vault WHERE rowid IN (${placeholders})`)
+            .prepare(
+              `SELECT rowid, * FROM vault WHERE rowid IN (${placeholders})`,
+            )
             .all(...rowids);
 
           const byRowid = new Map();
@@ -147,13 +177,15 @@ export async function hybridSearch(
           for (const vr of vecRows) {
             const row = byRowid.get(vr.rowid);
             if (!row) continue;
-            if (userIdFilter !== undefined && row.user_id !== userIdFilter) continue;
+            if (userIdFilter !== undefined && row.user_id !== userIdFilter)
+              continue;
             if (teamIdFilter && row.team_id !== teamIdFilter) continue;
             if (kindFilter && row.kind !== kindFilter) continue;
             if (categoryFilter && row.category !== categoryFilter) continue;
             if (since && row.created_at < since) continue;
             if (until && row.created_at > until) continue;
-            if (row.expires_at && new Date(row.expires_at) <= new Date()) continue;
+            if (row.expires_at && new Date(row.expires_at) <= new Date())
+              continue;
 
             const { rowid: _rowid, ...cleanRow } = row;
             // sqlite-vec returns L2 distance [0, 2] for normalized vectors.

package/node_modules/@context-vault/core/src/server/helpers.js

@@ -2,8 +2,6 @@
  * helpers.js — Shared MCP response helpers and validation
  */
 
-// ─── MCP Response Helpers ────────────────────────────────────────────────────
-
 export function ok(text) {
   return { content: [{ type: "text", text }] };
 }
@@ -12,18 +10,22 @@ export function err(text, code = "UNKNOWN") {
   return { content: [{ type: "text", text }], isError: true, code };
 }
 
-// ─── Validation Helpers ──────────────────────────────────────────────────────
-
 export function ensureVaultExists(config) {
   if (!config.vaultDirExists) {
-    return err(`Vault directory not found: ${config.vaultDir}. Run context_status for diagnostics.`, "VAULT_NOT_FOUND");
+    return err(
+      `Vault directory not found: ${config.vaultDir}. Run context_status for diagnostics.`,
+      "VAULT_NOT_FOUND",
+    );
   }
   return null;
 }
 
 export function ensureValidKind(kind) {
   if (!/^[a-z][a-z0-9_-]*$/.test(kind)) {
-    return err("Required: kind (lowercase alphanumeric, e.g. 'insight', 'reference')", "INVALID_KIND");
+    return err(
+      "Required: kind (lowercase alphanumeric, e.g. 'insight', 'reference')",
+      "INVALID_KIND",
+    );
   }
   return null;
 }

package/node_modules/@context-vault/core/src/server/tools/context-status.js

@@ -18,7 +18,7 @@ export function handler(_args, ctx) {
 
   const status = gatherVaultStatus(ctx, { userId });
 
-  const hasIssues = status.stalePaths || (status.embeddingStatus?.missing > 0);
+  const hasIssues = status.stalePaths || status.embeddingStatus?.missing > 0;
   const healthIcon = hasIssues ? "⚠" : "✓";
 
   const lines = [
@@ -39,13 +39,17 @@ export function handler(_args, ctx) {
     lines.push(`Embeddings: ${indexed}/${total} (${pct}%)`);
   }
   if (status.embedModelAvailable === false) {
-    lines.push(`Embed model: unavailable (semantic search disabled, FTS still works)`);
+    lines.push(
+      `Embed model: unavailable (semantic search disabled, FTS still works)`,
+    );
   } else if (status.embedModelAvailable === true) {
     lines.push(`Embed model: loaded`);
   }
   lines.push(`Decay:     ${config.eventDecayDays} days (event recency window)`);
   if (status.expiredCount > 0) {
-    lines.push(`Expired:   ${status.expiredCount} entries (pruned on next reindex)`);
+    lines.push(
+      `Expired:   ${status.expiredCount} entries (pruned on next reindex)`,
+    );
   }
 
   lines.push(``, `### Indexed`);
@@ -59,28 +63,38 @@ export function handler(_args, ctx) {
   if (status.categoryCounts.length) {
     lines.push(``);
     lines.push(`### Categories`);
-    for (const { category, c } of status.categoryCounts) lines.push(`- ${category}: ${c}`);
+    for (const { category, c } of status.categoryCounts)
+      lines.push(`- ${category}: ${c}`);
   }
 
   if (status.subdirs.length) {
     lines.push(``);
     lines.push(`### Disk Directories`);
-    for (const { name, count } of status.subdirs) lines.push(`- ${name}/: ${count} files`);
+    for (const { name, count } of status.subdirs)
+      lines.push(`- ${name}/: ${count} files`);
   }
 
   if (status.stalePaths) {
     lines.push(``);
     lines.push(`### ⚠ Stale Paths`);
-    lines.push(`DB contains ${status.staleCount} paths not matching current vault dir.`);
+    lines.push(
+      `DB contains ${status.staleCount} paths not matching current vault dir.`,
+    );
     lines.push(`Auto-reindex will fix this on next search or save.`);
   }
 
   // Suggested actions
   const actions = [];
-  if (status.stalePaths) actions.push("- Run `context-vault reindex` to fix stale paths");
-  if (status.embeddingStatus?.missing > 0) actions.push("- Run `context-vault reindex` to generate missing embeddings");
-  if (!config.vaultDirExists) actions.push("- Run `context-vault setup` to create the vault directory");
-  if (status.kindCounts.length === 0 && config.vaultDirExists) actions.push("- Use `save_context` to add your first entry");
+  if (status.stalePaths)
+    actions.push("- Run `context-vault reindex` to fix stale paths");
+  if (status.embeddingStatus?.missing > 0)
+    actions.push(
+      "- Run `context-vault reindex` to generate missing embeddings",
+    );
+  if (!config.vaultDirExists)
+    actions.push("- Run `context-vault setup` to create the vault directory");
+  if (status.kindCounts.length === 0 && config.vaultDirExists)
+    actions.push("- Use `save_context` to add your first entry");
 
   if (actions.length) {
     lines.push("", "### Suggested Actions", ...actions);

package/node_modules/@context-vault/core/src/server/tools/delete-context.js

@@ -19,7 +19,8 @@ export const inputSchema = {
 export async function handler({ id }, ctx, { ensureIndexed }) {
   const userId = ctx.userId !== undefined ? ctx.userId : undefined;
 
-  if (!id?.trim()) return err("Required: id (non-empty string)", "INVALID_INPUT");
+  if (!id?.trim())
+    return err("Required: id (non-empty string)", "INVALID_INPUT");
   await ensureIndexed();
 
   const entry = ctx.stmts.getEntryById.get(id);
@@ -32,13 +33,17 @@ export async function handler({ id }, ctx, { ensureIndexed }) {
 
   // Delete file from disk first (source of truth)
   if (entry.file_path) {
-    try { unlinkSync(entry.file_path); } catch {}
+    try {
+      unlinkSync(entry.file_path);
+    } catch {}
   }
 
   // Delete vector embedding
   const rowidResult = ctx.stmts.getRowid.get(id);
   if (rowidResult?.rowid) {
-    try { ctx.deleteVec(Number(rowidResult.rowid)); } catch {}
+    try {
+      ctx.deleteVec(Number(rowidResult.rowid));
+    } catch {}
   }
 
   // Delete DB row (FTS trigger handles FTS cleanup)