context-vault 3.1.3 → 3.1.5

package/node_modules/@context-vault/core/src/capture.ts

@@ -1,13 +1,28 @@
-import { existsSync, readFileSync, unlinkSync, writeFileSync, mkdirSync } from "node:fs";
+import {
+  existsSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+  mkdirSync,
+} from "node:fs";
 import { resolve, relative } from "node:path";
 import { ulid, slugify, kindToPath } from "./files.js";
 import { categoryFor, defaultTierFor } from "./categories.js";
 import { parseFrontmatter, formatFrontmatter } from "./frontmatter.js";
 import { formatBody } from "./formatters.js";
-import type { BaseCtx, CaptureInput, CaptureResult, IndexEntryInput } from "./types.js";
+import type {
+  BaseCtx,
+  CaptureInput,
+  CaptureResult,
+  IndexEntryInput,
+} from "./types.js";
 import { indexEntry } from "./index.js";
 
-function safeFolderPath(vaultDir: string, kind: string, folder?: string | null): string {
+function safeFolderPath(
+  vaultDir: string,
+  kind: string,
+  folder?: string | null,
+): string {
   const base = resolve(vaultDir, kindToPath(kind));
   if (!folder) return base;
   const resolved = resolve(base, folder);
@@ -44,7 +59,9 @@ function writeEntryFile(
   try {
     mkdirSync(dir, { recursive: true });
   } catch (e) {
-    throw new Error(`Failed to create directory "${dir}": ${(e as Error).message}`);
+    throw new Error(
+      `Failed to create directory "${dir}": ${(e as Error).message}`,
+    );
   }
 
   const created = params.createdAt || new Date().toISOString();
@@ -91,7 +108,9 @@ function writeEntryFile(
   try {
     writeFileSync(filePath, md);
   } catch (e) {
-    throw new Error(`Failed to write entry file "${filePath}": ${(e as Error).message}`);
+    throw new Error(
+      `Failed to write entry file "${filePath}": ${(e as Error).message}`,
+    );
   }
 
   return filePath;
@@ -190,7 +209,10 @@ export function updateEntryFile(
     related_to?: string[] | null;
     source_files?: Array<{ path: string; hash: string }> | null;
   },
-): IndexEntryInput & { supersedes?: string[] | null; related_to?: string[] | null } {
+): IndexEntryInput & {
+  supersedes?: string[] | null;
+  related_to?: string[] | null;
+} {
   const raw = readFileSync(existing.file_path as string, "utf-8");
   const { meta: fmMeta } = parseFrontmatter(raw);
 
@@ -200,18 +222,35 @@ export function updateEntryFile(
     ? JSON.parse(existing.related_to as string)
     : (fmMeta.related_to as string[]) || null;
 
-  const title = updates.title !== undefined ? updates.title : (existing.title as string | null);
-  const body = updates.body !== undefined ? (updates.body as string) : (existing.body as string);
+  const title =
+    updates.title !== undefined
+      ? updates.title
+      : (existing.title as string | null);
+  const body =
+    updates.body !== undefined
+      ? (updates.body as string)
+      : (existing.body as string);
   const tags = updates.tags !== undefined ? updates.tags : existingTags;
-  const source = updates.source !== undefined ? updates.source : (existing.source as string | null);
-  const expires_at = updates.expires_at !== undefined ? updates.expires_at : (existing.expires_at as string | null);
-  const supersedes = updates.supersedes !== undefined ? updates.supersedes : (fmMeta.supersedes as string[] || null);
-  const related_to = updates.related_to !== undefined ? updates.related_to : existingRelatedTo;
-  const source_files = updates.source_files !== undefined
-    ? updates.source_files
-    : existing.source_files
-      ? JSON.parse(existing.source_files as string)
-      : null;
+  const source =
+    updates.source !== undefined
+      ? updates.source
+      : (existing.source as string | null);
+  const expires_at =
+    updates.expires_at !== undefined
+      ? updates.expires_at
+      : (existing.expires_at as string | null);
+  const supersedes =
+    updates.supersedes !== undefined
+      ? updates.supersedes
+      : (fmMeta.supersedes as string[]) || null;
+  const related_to =
+    updates.related_to !== undefined ? updates.related_to : existingRelatedTo;
+  const source_files =
+    updates.source_files !== undefined
+      ? updates.source_files
+      : existing.source_files
+        ? JSON.parse(existing.source_files as string)
+        : null;
 
   let mergedMeta: Record<string, unknown>;
   if (updates.meta !== undefined) {
@@ -232,7 +271,8 @@ export function updateEntryFile(
   if (related_to?.length) fmFields.related_to = related_to;
   fmFields.tags = tags;
   fmFields.source = source || "claude-code";
-  fmFields.created = (fmMeta.created as string) || (existing.created_at as string);
+  fmFields.created =
+    (fmMeta.created as string) || (existing.created_at as string);
   if (now !== fmFields.created) fmFields.updated = now;
 
   const mdBody = formatBody(existing.kind as string, {
@@ -266,7 +306,11 @@ export function updateEntryFile(
   };
 }
 
-export async function captureAndIndex(ctx: BaseCtx, data: CaptureInput, precomputedEmbedding?: Float32Array | null): Promise<CaptureResult> {
+export async function captureAndIndex(
+  ctx: BaseCtx,
+  data: CaptureInput,
+  precomputedEmbedding?: Float32Array | null,
+): Promise<CaptureResult> {
   let previousContent: string | null = null;
   if (categoryFor(data.kind) === "entity" && data.identity_key) {
     const identitySlug = slugify(data.identity_key);

package/node_modules/@context-vault/core/src/config.ts

@@ -7,14 +7,10 @@ import type { VaultConfig } from "./types.js";
 export function parseArgs(argv: string[]): Record<string, string | number> {
   const args: Record<string, string | number> = {};
   for (let i = 2; i < argv.length; i++) {
-    if (argv[i] === "--vault-dir" && argv[i + 1])
-      args.vaultDir = argv[++i];
-    else if (argv[i] === "--data-dir" && argv[i + 1])
-      args.dataDir = argv[++i];
-    else if (argv[i] === "--db-path" && argv[i + 1])
-      args.dbPath = argv[++i];
-    else if (argv[i] === "--dev-dir" && argv[i + 1])
-      args.devDir = argv[++i];
+    if (argv[i] === "--vault-dir" && argv[i + 1]) args.vaultDir = argv[++i];
+    else if (argv[i] === "--data-dir" && argv[i + 1]) args.dataDir = argv[++i];
+    else if (argv[i] === "--db-path" && argv[i + 1]) args.dbPath = argv[++i];
+    else if (argv[i] === "--dev-dir" && argv[i + 1]) args.devDir = argv[++i];
     else if (argv[i] === "--event-decay-days" && argv[i + 1])
       args.eventDecayDays = Number(argv[++i]);
   }

package/node_modules/@context-vault/core/src/constants.ts

@@ -20,10 +20,8 @@ export const DEFAULT_GROWTH_THRESHOLDS = {
   eventsWithoutTtl: { warn: 200 },
 };
 
-export const DEFAULT_LIFECYCLE: Record<
-  string,
-  { archiveAfterDays?: number }
-> = {
-  event: { archiveAfterDays: 90 },
-  ephemeral: { archiveAfterDays: 30 },
-};
+export const DEFAULT_LIFECYCLE: Record<string, { archiveAfterDays?: number }> =
+  {
+    event: { archiveAfterDays: 90 },
+    ephemeral: { archiveAfterDays: 30 },
+  };

package/node_modules/@context-vault/core/src/db.ts

@@ -117,7 +117,9 @@ export async function initDatabase(dbPath: string): Promise<DatabaseSync> {
   }
 
   const db = createDb(dbPath);
-  const version = (db.prepare("PRAGMA user_version").get() as { user_version: number }).user_version;
+  const version = (
+    db.prepare("PRAGMA user_version").get() as { user_version: number }
+  ).user_version;
 
   if (version > 0 && version < 15) {
     console.error(
@@ -146,13 +148,17 @@ export async function initDatabase(dbPath: string): Promise<DatabaseSync> {
     if (!backupSucceeded) {
       throw new Error(
         `[context-vault] Aborting schema migration: backup failed for ${dbPath}. ` +
-        `Fix the backup issue or manually back up the file before upgrading.`,
+          `Fix the backup issue or manually back up the file before upgrading.`,
       );
     }
 
     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);
@@ -179,9 +185,7 @@ export function prepareStatements(db: DatabaseSync): PreparedStatements {
       ),
       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 = ?`,
-      ),
+      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 = ?`,

package/node_modules/@context-vault/core/src/embed.ts

@@ -60,7 +60,9 @@ export async function embed(text: string): Promise<Float32Array | null> {
   return new Float32Array(result.data);
 }
 
-export async function embedBatch(texts: string[]): Promise<(Float32Array | null)[]> {
+export async function embedBatch(
+  texts: string[],
+): Promise<(Float32Array | null)[]> {
   if (!texts.length) return [];
   const ext = await ensurePipeline();
   if (!ext) return texts.map(() => null);

package/node_modules/@context-vault/core/src/formatters.ts

@@ -22,10 +22,7 @@ const FORMATTERS: Record<string, (input: FormatInput) => string> = {
 const DEFAULT_FORMATTER = ({ title, body }: FormatInput): string =>
   title ? "\n# " + title + "\n\n" + body + "\n" : "\n" + body + "\n";
 
-export function formatBody(
-  kind: string,
-  input: FormatInput,
-): string {
+export function formatBody(kind: string, input: FormatInput): string {
   const fn = FORMATTERS[kind] || DEFAULT_FORMATTER;
   return fn(input);
 }

package/node_modules/@context-vault/core/src/frontmatter.ts

@@ -84,15 +84,17 @@ export function parseEntryFromMarkdown(
   kind: string,
   body: string,
   fmMeta: Record<string, unknown>,
-): { title: string | null; body: string; meta: Record<string, unknown> | null } {
+): {
+  title: string | null;
+  body: string;
+  meta: Record<string, unknown> | null;
+} {
   if (kind === "insight") {
     return { title: null, body, meta: extractCustomMeta(fmMeta) };
   }
 
   if (kind === "decision") {
-    const titleMatch = body.match(
-      /^## Decision\s*\n+([\s\S]*?)(?=\n## |\n*$)/,
-    );
+    const titleMatch = body.match(/^## Decision\s*\n+([\s\S]*?)(?=\n## |\n*$)/);
     const rationaleMatch = body.match(/## Rationale\s*\n+([\s\S]*?)$/);
     const title = titleMatch ? titleMatch[1].trim() : body.slice(0, 100);
     const rationale = rationaleMatch ? rationaleMatch[1].trim() : body;

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

@@ -12,12 +12,27 @@ const EMBED_BATCH_SIZE = 32;
 
 export async function indexEntry(
   ctx: BaseCtx,
-  entry: IndexEntryInput & { supersedes?: string[] | null; related_to?: string[] | null },
+  entry: IndexEntryInput & {
+    supersedes?: string[] | null;
+    related_to?: string[] | null;
+  },
   precomputedEmbedding?: Float32Array | null,
 ): Promise<void> {
   const {
-    id, kind, category, title, body, meta, tags, source,
-    filePath, createdAt, identity_key, expires_at, source_files, tier,
+    id,
+    kind,
+    category,
+    title,
+    body,
+    meta,
+    tags,
+    source,
+    filePath,
+    createdAt,
+    identity_key,
+    expires_at,
+    source_files,
+    tier,
   } = entry;
 
   if (expires_at && new Date(expires_at) <= new Date()) return;
@@ -31,13 +46,22 @@ export async function indexEntry(
   let wasUpdate = false;
 
   if (cat === "entity" && identity_key) {
-    const existing = ctx.stmts.getByIdentityKey.get(kind, identity_key) as Record<string, unknown> | undefined;
+    const existing = ctx.stmts.getByIdentityKey.get(kind, identity_key) as
+      | Record<string, unknown>
+      | undefined;
     if (existing) {
       ctx.stmts.upsertByIdentityKey.run(
-        title || null, body, metaJson, tagsJson,
-        source || "claude-code", cat, filePath,
-        expires_at || null, sourceFilesJson,
-        kind, identity_key,
+        title || null,
+        body,
+        metaJson,
+        tagsJson,
+        source || "claude-code",
+        cat,
+        filePath,
+        expires_at || null,
+        sourceFilesJson,
+        kind,
+        identity_key,
       );
       wasUpdate = true;
     }
@@ -46,20 +70,39 @@ export async function indexEntry(
   if (!wasUpdate) {
     try {
       ctx.stmts.insertEntry.run(
-        id, kind, cat, title || null, body, metaJson, tagsJson,
-        source || "claude-code", filePath,
-        identity_key || null, expires_at || null,
-        createdAt, createdAt, sourceFilesJson, effectiveTier,
+        id,
+        kind,
+        cat,
+        title || null,
+        body,
+        metaJson,
+        tagsJson,
+        source || "claude-code",
+        filePath,
+        identity_key || null,
+        expires_at || null,
+        createdAt,
+        createdAt,
+        sourceFilesJson,
+        effectiveTier,
       );
     } catch (e) {
       if ((e as Error).message.includes("UNIQUE constraint")) {
         ctx.stmts.updateEntry.run(
-          title || null, body, metaJson, tagsJson,
-          source || "claude-code", cat,
-          identity_key || null, expires_at || null, filePath,
+          title || null,
+          body,
+          metaJson,
+          tagsJson,
+          source || "claude-code",
+          cat,
+          identity_key || null,
+          expires_at || null,
+          filePath,
         );
         if (sourceFilesJson !== null && ctx.stmts.updateSourceFiles) {
-          const entryRow = ctx.stmts.getRowidByPath.get(filePath) as { rowid: number } | undefined;
+          const entryRow = ctx.stmts.getRowidByPath.get(filePath) as
+            | { rowid: number }
+            | undefined;
           if (entryRow) {
             const idRow = ctx.db
               .prepare("SELECT id FROM vault WHERE file_path = ?")
@@ -76,8 +119,8 @@ export async function indexEntry(
   }
 
   const rowidResult = wasUpdate
-    ? ctx.stmts.getRowidByPath.get(filePath) as { rowid: number } | undefined
-    : ctx.stmts.getRowid.get(id) as { rowid: number } | undefined;
+    ? (ctx.stmts.getRowidByPath.get(filePath) as { rowid: number } | undefined)
+    : (ctx.stmts.getRowid.get(id) as { rowid: number } | undefined);
 
   if (!rowidResult || rowidResult.rowid == null) {
     throw new Error(
@@ -100,12 +143,18 @@ export async function indexEntry(
       try {
         embedding = await ctx.embed([title, body].filter(Boolean).join(" "));
       } catch (embedErr) {
-        console.warn(`[context-vault] embed() failed for entry ${id} — skipping vec insert: ${(embedErr as Error).message}`);
+        console.warn(
+          `[context-vault] embed() failed for entry ${id} — skipping vec insert: ${(embedErr as Error).message}`,
+        );
       }
     }
 
     if (embedding) {
-      try { ctx.deleteVec(rowid); } catch { /* no-op */ }
+      try {
+        ctx.deleteVec(rowid);
+      } catch {
+        /* no-op */
+      }
       ctx.insertVec(rowid, embedding);
     }
   }
@@ -120,11 +169,17 @@ export async function pruneExpired(ctx: BaseCtx): Promise<number> {
 
   for (const row of expired) {
     if (row.file_path) {
-      try { unlinkSync(row.file_path); } catch {}
+      try {
+        unlinkSync(row.file_path);
+      } catch {}
     }
-    const vRowid = (ctx.stmts.getRowid.get(row.id) as { rowid: number } | undefined)?.rowid;
+    const vRowid = (
+      ctx.stmts.getRowid.get(row.id) as { rowid: number } | undefined
+    )?.rowid;
     if (vRowid) {
-      try { ctx.deleteVec(Number(vRowid)); } catch {}
+      try {
+        ctx.deleteVec(Number(vRowid));
+      } catch {}
     }
     ctx.stmts.deleteEntry.run(row.id);
   }
@@ -137,7 +192,12 @@ export async function reindex(
   opts: { fullSync?: boolean } = {},
 ): Promise<ReindexStats> {
   const { fullSync = true } = opts;
-  const stats: ReindexStats = { added: 0, updated: 0, removed: 0, unchanged: 0 };
+  const stats: ReindexStats = {
+    added: 0,
+    updated: 0,
+    removed: 0,
+    unchanged: 0,
+  };
 
   if (!existsSync(ctx.config.vaultDir)) return stats;
 
@@ -224,20 +284,32 @@ export async function reindex(
         if (!existing) {
           const id = (fmMeta.id as string) || ulid();
           const tagsJson = fmMeta.tags ? JSON.stringify(fmMeta.tags) : null;
-          const created = (fmMeta.created as string) || new Date().toISOString();
+          const created =
+            (fmMeta.created as string) || new Date().toISOString();
 
           const result = upsertEntry.run(
-            id, kind, category, parsed.title || null, parsed.body,
-            metaJson, tagsJson, (fmMeta.source as string) || "file",
-            filePath, identity_key, expires_at,
-            created, (fmMeta.updated as string) || created,
+            id,
+            kind,
+            category,
+            parsed.title || null,
+            parsed.body,
+            metaJson,
+            tagsJson,
+            (fmMeta.source as string) || "file",
+            filePath,
+            identity_key,
+            expires_at,
+            created,
+            (fmMeta.updated as string) || created,
           );
           if ((result as { changes: number }).changes > 0) {
             if (relatedToJson && ctx.stmts.updateRelatedTo) {
               ctx.stmts.updateRelatedTo.run(relatedToJson, id);
             }
             if (category !== "event") {
-              const rowidResult = ctx.stmts.getRowid.get(id) as { rowid: number } | undefined;
+              const rowidResult = ctx.stmts.getRowid.get(id) as
+                | { rowid: number }
+                | undefined;
               if (rowidResult?.rowid) {
                 const embeddingText = [parsed.title, parsed.body]
                   .filter(Boolean)
@@ -254,24 +326,45 @@ export async function reindex(
           }
         } else if (fullSync) {
           const tagsJson = fmMeta.tags ? JSON.stringify(fmMeta.tags) : null;
-          const titleChanged = (parsed.title || null) !== ((existing.title as string) || null);
+          const titleChanged =
+            (parsed.title || null) !== ((existing.title as string) || null);
           const bodyChanged = (existing.body as string) !== parsed.body;
           const tagsChanged = tagsJson !== ((existing.tags as string) || null);
           const metaChanged = metaJson !== ((existing.meta as string) || null);
-          const relatedToChanged = relatedToJson !== ((existing.related_to as string) || null);
-
-          if (bodyChanged || titleChanged || tagsChanged || metaChanged || relatedToChanged) {
+          const relatedToChanged =
+            relatedToJson !== ((existing.related_to as string) || null);
+
+          if (
+            bodyChanged ||
+            titleChanged ||
+            tagsChanged ||
+            metaChanged ||
+            relatedToChanged
+          ) {
             ctx.stmts.updateEntry.run(
-              parsed.title || null, parsed.body, metaJson, tagsJson,
-              (fmMeta.source as string) || "file", category,
-              identity_key, expires_at, filePath,
+              parsed.title || null,
+              parsed.body,
+              metaJson,
+              tagsJson,
+              (fmMeta.source as string) || "file",
+              category,
+              identity_key,
+              expires_at,
+              filePath,
             );
             if (relatedToChanged && ctx.stmts.updateRelatedTo) {
-              ctx.stmts.updateRelatedTo.run(relatedToJson, existing.id as string);
+              ctx.stmts.updateRelatedTo.run(
+                relatedToJson,
+                existing.id as string,
+              );
             }
 
             if ((bodyChanged || titleChanged) && category !== "event") {
-              const rowid = (ctx.stmts.getRowid.get(existing.id as string) as { rowid: number } | undefined)?.rowid;
+              const rowid = (
+                ctx.stmts.getRowid.get(existing.id as string) as
+                  | { rowid: number }
+                  | undefined
+              )?.rowid;
               if (rowid) {
                 const embeddingText = [parsed.title, parsed.body]
                   .filter(Boolean)
@@ -291,9 +384,15 @@ export async function reindex(
       if (fullSync) {
         for (const [dbPath, row] of dbByPath) {
           if (!diskPaths.has(dbPath)) {
-            const vRowid = (ctx.stmts.getRowid.get(row.id as string) as { rowid: number } | undefined)?.rowid;
+            const vRowid = (
+              ctx.stmts.getRowid.get(row.id as string) as
+                | { rowid: number }
+                | undefined
+            )?.rowid;
             if (vRowid) {
-              try { ctx.deleteVec(vRowid); } catch {}
+              try {
+                ctx.deleteVec(vRowid);
+              } catch {}
             }
             ctx.stmts.deleteEntry.run(row.id as string);
             stats.removed++;
@@ -313,7 +412,9 @@ export async function reindex(
             .prepare("SELECT id, rowid FROM vault WHERE kind = ?")
             .all(kind) as { id: string; rowid: number }[];
           for (const row of orphaned) {
-            try { ctx.deleteVec(row.rowid); } catch {}
+            try {
+              ctx.deleteVec(row.rowid);
+            } catch {}
             ctx.stmts.deleteEntry.run(row.id);
             stats.removed++;
           }
@@ -329,11 +430,17 @@ export async function reindex(
 
     for (const row of expired) {
       if (row.file_path) {
-        try { unlinkSync(row.file_path); } catch {}
+        try {
+          unlinkSync(row.file_path);
+        } catch {}
       }
-      const vRowid = (ctx.stmts.getRowid.get(row.id) as { rowid: number } | undefined)?.rowid;
+      const vRowid = (
+        ctx.stmts.getRowid.get(row.id) as { rowid: number } | undefined
+      )?.rowid;
       if (vRowid) {
-        try { ctx.deleteVec(Number(vRowid)); } catch {}
+        try {
+          ctx.deleteVec(Number(vRowid));
+        } catch {}
       }
       ctx.stmts.deleteEntry.run(row.id);
       stats.removed++;
@@ -350,7 +457,9 @@ export async function reindex(
     const embeddings = await embedBatch(batch.map((e) => e.text));
     for (let j = 0; j < batch.length; j++) {
       if (embeddings[j]) {
-        try { ctx.deleteVec(batch[j].rowid); } catch {}
+        try {
+          ctx.deleteVec(batch[j].rowid);
+        } catch {}
         ctx.insertVec(batch[j].rowid, embeddings[j]!);
       }
     }