context-vault 3.1.7 → 3.2.0

package/bin/cli.js

@@ -34,7 +34,7 @@ const HOME = homedir();
 
 const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf-8'));
 const VERSION = pkg.version;
-const SERVER_PATH = resolve(ROOT, 'src', 'server.js');
+const SERVER_PATH = resolve(ROOT, 'dist', 'server.js');
 
 /** Detect if running as an npm-installed package (global or local) vs local dev clone */
 function isInstalledPackage() {
@@ -1707,7 +1707,7 @@ async function runMigrateDirs() {
     process.exit(1);
   }
 
-  const { planMigration, executeMigration } = await import('../src/migrate-dirs.js');
+  const { planMigration, executeMigration } = await import('../dist/migrate-dirs.js');
 
   const ops = planMigration(vaultDir);
 
@@ -1822,7 +1822,7 @@ async function runArchive() {
   const { resolveConfig } = await import('@context-vault/core/config');
   const { initDatabase, prepareStatements, insertVec, deleteVec } =
     await import('@context-vault/core/db');
-  const { findArchiveCandidates, archiveEntries } = await import('../src/archive.js');
+  const { findArchiveCandidates, archiveEntries } = await import('../dist/archive.js');
 
   const config = resolveConfig();
   if (!config.vaultDirExists) {
@@ -1899,7 +1899,7 @@ async function runRestore() {
 
   if (!entryId || entryId.startsWith('--')) {
     const { resolveConfig } = await import('@context-vault/core/config');
-    const { listArchivedEntries } = await import('../src/archive.js');
+    const { listArchivedEntries } = await import('../dist/archive.js');
 
     const config = resolveConfig();
 
@@ -1929,7 +1929,7 @@ async function runRestore() {
   const { initDatabase, prepareStatements, insertVec, deleteVec } =
     await import('@context-vault/core/db');
   const { embed } = await import('@context-vault/core/embed');
-  const { restoreEntry } = await import('../src/archive.js');
+  const { restoreEntry } = await import('../dist/archive.js');
 
   const config = resolveConfig();
   if (!config.vaultDirExists) {
@@ -1964,8 +1964,8 @@ async function runRestore() {
 async function runStatus() {
   const { resolveConfig } = await import('@context-vault/core/config');
   const { initDatabase } = await import('@context-vault/core/db');
-  const { gatherVaultStatus } = await import('../src/status.js');
-  const { errorLogPath, errorLogCount } = await import('../src/error-log.js');
+  const { gatherVaultStatus } = await import('../dist/status.js');
+  const { errorLogPath, errorLogCount } = await import('../dist/error-log.js');
 
   const config = resolveConfig();
 
@@ -4357,7 +4357,7 @@ ${bold('Commands:')}
 
 async function runDoctor() {
   const { resolveConfig } = await import('@context-vault/core/config');
-  const { errorLogPath, errorLogCount } = await import('../src/error-log.js');
+  const { errorLogPath, errorLogCount } = await import('../dist/error-log.js');
 
   console.log();
   console.log(`  ${bold('◇ context-vault doctor')} ${dim(`v${VERSION}`)}`);
@@ -4966,7 +4966,7 @@ async function runConsolidate() {
 
   const { resolveConfig } = await import('@context-vault/core/config');
   const { initDatabase } = await import('@context-vault/core/db');
-  const { findHotTags, findColdEntries } = await import('@context-vault/core/consolidation/index');
+  const { findHotTags, findColdEntries } = await import('../dist/consolidation.js');
 
   const config = resolveConfig();
 
@@ -5070,7 +5070,7 @@ async function runConsolidate() {
 
 async function runDebug() {
   const { resolveConfig } = await import('@context-vault/core/config');
-  const { errorLogPath, errorLogCount } = await import('../src/error-log.js');
+  const { errorLogPath, errorLogCount } = await import('../dist/error-log.js');
 
   let config;
   try {
@@ -5146,7 +5146,7 @@ async function runDebug() {
 }
 
 async function runServe() {
-  await import('../src/server.js');
+  await import('../dist/server.js');
 }
 
 async function main() {

package/dist/archive.d.ts

@@ -0,0 +1,23 @@
+import type { LocalCtx } from './types.js';
+export declare function findArchiveCandidates(ctx: LocalCtx): unknown[];
+export declare function archiveEntries(ctx: LocalCtx): Promise<{
+    archived: unknown[];
+    count: number;
+}>;
+export declare function restoreEntry(ctx: LocalCtx, entryId: string): Promise<{
+    restored: boolean;
+    reason?: string;
+    filePath?: string;
+    kind?: string;
+    id?: string;
+}>;
+export declare function countArchivedEntries(vaultDir: string): number;
+export declare function listArchivedEntries(vaultDir: string): Array<{
+    id: string | null;
+    kind: string;
+    title: string;
+    tags: unknown[];
+    created: string | null;
+    filePath: string;
+}>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc3C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,EAAE,CAmC9D;AAYD,wBAAsB,cAAc,CAClC,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA0CjD;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2EhG;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3D,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAgCD"}

package/dist/archive.js

@@ -0,0 +1,197 @@
+import { existsSync, mkdirSync, renameSync, readFileSync } from 'node:fs';
+import { join, dirname, relative } from 'node:path';
+import { categoryFor, defaultTierFor } from '@context-vault/core/categories';
+import { parseFrontmatter, parseEntryFromMarkdown } from '@context-vault/core/frontmatter';
+import { DEFAULT_LIFECYCLE } from '@context-vault/core/constants';
+import { walkDir } from '@context-vault/core/files';
+import { indexEntry } from '@context-vault/core/index';
+const VALID_TIERS = new Set(['ephemeral', 'working', 'durable']);
+const VALID_CATEGORIES = new Set(['knowledge', 'entity', 'event']);
+function resolveLifecycle(config) {
+    return config?.lifecycle ?? structuredClone(DEFAULT_LIFECYCLE);
+}
+function archiveDir(vaultDir) {
+    return join(vaultDir, '_archive');
+}
+export function findArchiveCandidates(ctx) {
+    const lifecycle = resolveLifecycle(ctx.config);
+    const now = new Date();
+    const candidates = [];
+    const seen = new Set();
+    for (const [key, rules] of Object.entries(lifecycle)) {
+        if (!rules?.archiveAfterDays)
+            continue;
+        const cutoff = new Date(now.getTime() - rules.archiveAfterDays * 86400000).toISOString();
+        const isTier = VALID_TIERS.has(key);
+        const isCategory = VALID_CATEGORIES.has(key);
+        if (!isTier && !isCategory)
+            continue;
+        const column = isTier ? 'tier' : 'category';
+        const rows = ctx.db
+            .prepare(`SELECT id, kind, category, title, tier, file_path, created_at, updated_at
+         FROM vault
+         WHERE ${column} = ? AND COALESCE(updated_at, created_at) <= ?
+         ORDER BY COALESCE(updated_at, created_at) ASC`)
+            .all(key, cutoff);
+        for (const row of rows) {
+            if (seen.has(row.id))
+                continue;
+            seen.add(row.id);
+            candidates.push({
+                ...row,
+                reason: `${column}=${key}, archiveAfterDays=${rules.archiveAfterDays}`,
+            });
+        }
+    }
+    return candidates;
+}
+function removeFromIndex(ctx, id) {
+    const rowidRow = ctx.stmts.getRowid.get(id);
+    if (rowidRow?.rowid) {
+        try {
+            ctx.deleteVec(Number(rowidRow.rowid));
+        }
+        catch { }
+    }
+    ctx.stmts.deleteEntry.run(id);
+}
+export async function archiveEntries(ctx) {
+    const candidates = findArchiveCandidates(ctx);
+    if (candidates.length === 0)
+        return { archived: candidates, count: 0 };
+    const vaultDir = ctx.config.vaultDir;
+    const archRoot = archiveDir(vaultDir);
+    let count = 0;
+    for (const entry of candidates) {
+        const filePath = entry.file_path;
+        if (!filePath) {
+            removeFromIndex(ctx, entry.id);
+            count++;
+            continue;
+        }
+        const rel = relative(vaultDir, filePath);
+        if (rel.startsWith('..') || rel.startsWith('_archive'))
+            continue;
+        const destPath = join(archRoot, rel);
+        const destDir = dirname(destPath);
+        try {
+            mkdirSync(destDir, { recursive: true });
+            renameSync(filePath, destPath);
+        }
+        catch (e) {
+            if (e.code === 'ENOENT' && !existsSync(filePath)) {
+                // File already gone — just remove from index
+            }
+            else {
+                throw e;
+            }
+        }
+        removeFromIndex(ctx, entry.id);
+        count++;
+    }
+    return { archived: candidates, count };
+}
+export async function restoreEntry(ctx, entryId) {
+    const vaultDir = ctx.config.vaultDir;
+    const archRoot = archiveDir(vaultDir);
+    if (!existsSync(archRoot)) {
+        return { restored: false, reason: 'no _archive directory' };
+    }
+    const mdFiles = walkDir(archRoot);
+    let targetFile = null;
+    for (const { filePath } of mdFiles) {
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            const { meta } = parseFrontmatter(raw);
+            if (meta.id === entryId) {
+                targetFile = filePath;
+                break;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!targetFile) {
+        return { restored: false, reason: `entry ${entryId} not found in _archive` };
+    }
+    const rel = relative(archRoot, targetFile);
+    const destPath = join(vaultDir, rel);
+    const destDir = dirname(destPath);
+    if (existsSync(destPath)) {
+        return { restored: false, reason: `destination already exists: ${destPath}` };
+    }
+    mkdirSync(destDir, { recursive: true });
+    renameSync(targetFile, destPath);
+    const raw = readFileSync(destPath, 'utf-8');
+    const { meta, body: rawBody } = parseFrontmatter(raw);
+    const relFromVault = relative(vaultDir, destPath);
+    const kindDir = relFromVault.split('/').filter(Boolean);
+    let kind = meta.kind ||
+        (kindDir.length >= 2 ? kindDir[kindDir.length - 2] : kindDir[0]) ||
+        'note';
+    const parsed = parseEntryFromMarkdown(kind, rawBody, meta);
+    const category = categoryFor(kind);
+    await indexEntry(ctx, {
+        id: meta.id || entryId,
+        kind,
+        category,
+        title: parsed.title,
+        body: parsed.body,
+        meta: parsed.meta ?? undefined,
+        tags: Array.isArray(meta.tags) ? meta.tags : null,
+        source: meta.source || 'archive-restore',
+        filePath: destPath,
+        createdAt: meta.created || new Date().toISOString(),
+        identity_key: meta.identity_key || null,
+        expires_at: meta.expires_at || null,
+        tier: meta.tier || defaultTierFor(kind),
+        source_files: null,
+    });
+    return {
+        restored: true,
+        filePath: destPath,
+        kind,
+        id: meta.id || entryId,
+    };
+}
+export function countArchivedEntries(vaultDir) {
+    const archRoot = archiveDir(vaultDir);
+    if (!existsSync(archRoot))
+        return 0;
+    try {
+        return walkDir(archRoot).length;
+    }
+    catch {
+        return 0;
+    }
+}
+export function listArchivedEntries(vaultDir) {
+    const archRoot = archiveDir(vaultDir);
+    if (!existsSync(archRoot))
+        return [];
+    const entries = [];
+    try {
+        const mdFiles = walkDir(archRoot);
+        for (const { filePath, relDir } of mdFiles) {
+            try {
+                const raw = readFileSync(filePath, 'utf-8');
+                const { meta, body } = parseFrontmatter(raw);
+                entries.push({
+                    id: meta.id || null,
+                    kind: relDir?.split('/').pop() || 'unknown',
+                    title: meta.title || body.slice(0, 80),
+                    tags: Array.isArray(meta.tags) ? meta.tags : [],
+                    created: meta.created || null,
+                    filePath,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch { }
+    return entries;
+}
+//# sourceMappingURL=archive.js.map

package/dist/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"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"}

package/dist/consolidation.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function findHotTags(db: DatabaseSync, opts?: {
+    tagThreshold?: number;
+    maxSnapshotAgeDays?: number;
+}): Array<{
+    tag: string;
+    entryCount: number;
+    lastSnapshotAge: number | null;
+}>;
+export declare function findColdEntries(db: DatabaseSync, opts?: {
+    maxAgeDays?: number;
+    maxHitCount?: number;
+}): string[];
+//# sourceMappingURL=consolidation.d.ts.map

package/dist/consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../src/consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,WAAW,CACzB,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GAChE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmD5E;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,MAAM,EAAE,CAgBV"}

package/dist/consolidation.js

@@ -0,0 +1,59 @@
+export function findHotTags(db, opts = {}) {
+    const tagThreshold = opts.tagThreshold ?? 10;
+    const maxSnapshotAgeDays = opts.maxSnapshotAgeDays ?? 7;
+    const cutoff = new Date(Date.now() - maxSnapshotAgeDays * 86400000).toISOString();
+    const rows = db
+        .prepare(`SELECT tags FROM vault
+       WHERE kind != 'brief'
+         AND superseded_by IS NULL
+         AND (expires_at IS NULL OR expires_at > datetime('now'))`)
+        .all();
+    const tagCounts = new Map();
+    for (const row of rows) {
+        if (!row.tags)
+            continue;
+        try {
+            const tags = JSON.parse(row.tags);
+            for (const tag of tags) {
+                tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    const results = [];
+    for (const [tag, count] of tagCounts) {
+        if (count < tagThreshold)
+            continue;
+        const recentBrief = db
+            .prepare(`SELECT created_at FROM vault
+         WHERE kind = 'brief'
+           AND tags LIKE ?
+         ORDER BY created_at DESC LIMIT 1`)
+            .get(`%"${tag}"%`);
+        let lastSnapshotAge = null;
+        if (recentBrief) {
+            const brief = recentBrief;
+            lastSnapshotAge = Math.round((Date.now() - new Date(brief.created_at).getTime()) / 86400000);
+            if (brief.created_at >= cutoff)
+                continue;
+        }
+        results.push({ tag, entryCount: count, lastSnapshotAge });
+    }
+    return results.sort((a, b) => b.entryCount - a.entryCount);
+}
+export function findColdEntries(db, opts = {}) {
+    const maxAgeDays = opts.maxAgeDays ?? 90;
+    const maxHitCount = opts.maxHitCount ?? 0;
+    const cutoff = new Date(Date.now() - maxAgeDays * 86400000).toISOString();
+    const rows = db
+        .prepare(`SELECT id FROM vault
+       WHERE created_at < ?
+         AND superseded_by IS NULL
+         AND COALESCE(hit_count, 0) <= ?
+         AND (expires_at IS NULL OR expires_at > datetime('now'))`)
+        .all(cutoff, maxHitCount);
+    return rows.map((r) => r.id);
+}
+//# sourceMappingURL=consolidation.js.map

package/dist/consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.js","sourceRoot":"","sources":["../src/consolidation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CACzB,EAAgB,EAChB,OAA+D,EAAE;IAEjE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7C,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,kBAAkB,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAElF,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;kEAG4D,CAC7D;SACA,GAAG,EAAE,CAAC;IAET,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAsC,EAAE,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,SAAS;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,YAAY;YAAE,SAAS;QAEnC,MAAM,WAAW,GAAG,EAAE;aACnB,OAAO,CACN;;;0CAGkC,CACnC;aACA,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAErB,IAAI,eAAe,GAAkB,IAAI,CAAC;QAC1C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,WAAqC,CAAC;YACpD,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC7F,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM;gBAAE,SAAS;QAC3C,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,EAAgB,EAChB,OAAsD,EAAE;IAExD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAE1E,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;;kEAI4D,CAC7D;SACA,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAE5B,OAAQ,IAA8B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/error-log.d.ts

@@ -0,0 +1,4 @@
+export declare function errorLogPath(dataDir: string): string;
+export declare function appendErrorLog(dataDir: string, entry: Record<string, unknown>): void;
+export declare function errorLogCount(dataDir: string): number;
+//# sourceMappingURL=error-log.d.ts.map

package/dist/error-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-log.d.ts","sourceRoot":"","sources":["../src/error-log.ts"],"names":[],"mappings":"AAYA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWpF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/error-log.js

@@ -0,0 +1,33 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+const MAX_LOG_SIZE = 1024 * 1024;
+export function errorLogPath(dataDir) {
+    return join(dataDir, 'error.log');
+}
+export function appendErrorLog(dataDir, entry) {
+    try {
+        mkdirSync(dataDir, { recursive: true });
+        const logPath = errorLogPath(dataDir);
+        if (existsSync(logPath) && statSync(logPath).size >= MAX_LOG_SIZE) {
+            writeFileSync(logPath, '');
+        }
+        appendFileSync(logPath, JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // intentionally swallowed
+    }
+}
+export function errorLogCount(dataDir) {
+    try {
+        const logPath = errorLogPath(dataDir);
+        if (!existsSync(logPath))
+            return 0;
+        return readFileSync(logPath, 'utf-8')
+            .split('\n')
+            .filter((l) => l.trim()).length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=error-log.js.map

package/dist/error-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-log.js","sourceRoot":"","sources":["../src/error-log.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjC,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAA8B;IAC5E,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,YAAY,EAAE,CAAC;YAClE,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,CAAC,CAAC;QACnC,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;aAClC,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,10 @@
+import type { VaultConfig } from '@context-vault/core/types';
+import type { ToolResult } from './types.js';
+declare const pkg: any;
+export declare function ok(text: string): ToolResult;
+export declare function err(text: string, code?: string, meta?: Record<string, unknown>): ToolResult;
+export declare function errWithHint(text: string, code: string, hint?: string): ToolResult;
+export declare function ensureVaultExists(config: VaultConfig): ToolResult | null;
+export declare function ensureValidKind(kind: string): ToolResult | null;
+export { pkg };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,QAAA,MAAM,GAAG,KAA2E,CAAC;AAErF,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE3C;AAED,wBAAgB,GAAG,CACjB,IAAI,EAAE,MAAM,EACZ,IAAI,SAAY,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,UAAU,CAaZ;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAKjF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CASxE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQ/D;AAED,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/helpers.js

@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+export function ok(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export function err(text, code = 'UNKNOWN', meta = {}) {
+    return {
+        content: [{ type: 'text', text }],
+        isError: true,
+        code,
+        _meta: {
+            cv_version: pkg.version,
+            node_version: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            ...meta,
+        },
+    };
+}
+export function errWithHint(text, code, hint) {
+    const prompt = hint
+        ? `\n\n**Debug with AI:** Paste this into Claude Code or your AI assistant:\n> "${hint}"`
+        : '';
+    return err(text + prompt, code);
+}
+export function ensureVaultExists(config) {
+    if (!config.vaultDirExists) {
+        return errWithHint(`Vault directory not found: ${config.vaultDir}. Run context-status for diagnostics.`, 'VAULT_NOT_FOUND', "My context-vault can't find the vault directory. Run `context-vault doctor` and help me fix it.");
+    }
+    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 null;
+}
+export { pkg };
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAErF,MAAM,UAAU,EAAE,CAAC,IAAY;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,IAAY,EACZ,IAAI,GAAG,SAAS,EAChB,OAAgC,EAAE;IAElC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,KAAK,EAAE;YACL,UAAU,EAAE,GAAG,CAAC,OAAO;YACvB,YAAY,EAAE,OAAO,CAAC,OAAO;YAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,IAAI;SACR;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa;IACnE,MAAM,MAAM,GAAG,IAAI;QACjB,CAAC,CAAC,gFAAgF,IAAI,GAAG;QACzF,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,GAAG,CAAC,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,WAAW,CAChB,8BAA8B,MAAM,CAAC,QAAQ,uCAAuC,EACpF,iBAAiB,EACjB,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,CACR,sEAAsE,EACtE,cAAc,CACf,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/linking.d.ts

@@ -0,0 +1,13 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function parseRelatedTo(raw: unknown): string[];
+export declare function resolveLinks(db: DatabaseSync, ids: string[]): any[];
+export declare function resolveBacklinks(db: DatabaseSync, entryId: string): any[];
+export declare function collectLinkedEntries(db: DatabaseSync, primaryEntries: Array<{
+    id: string;
+    related_to?: string | null;
+}>): {
+    forward: any[];
+    backward: any[];
+};
+export declare function validateRelatedTo(relatedTo: unknown): string | null;
+//# sourceMappingURL=linking.d.ts.map

package/dist/linking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.d.ts","sourceRoot":"","sources":["../src/linking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CASrD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,EAAE,CAgBnE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,EAAE,CAezE;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,cAAc,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAChE;IAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;CAAE,CAyBrC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYnE"}

package/dist/linking.js

@@ -0,0 +1,86 @@
+export function parseRelatedTo(raw) {
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((id) => typeof id === 'string' && id.trim());
+    }
+    catch {
+        return [];
+    }
+}
+export function resolveLinks(db, ids) {
+    if (!ids.length)
+        return [];
+    const unique = [...new Set(ids)];
+    const placeholders = unique.map(() => '?').join(',');
+    try {
+        return db
+            .prepare(`SELECT * FROM vault
+         WHERE id IN (${placeholders})
+           AND (expires_at IS NULL OR expires_at > datetime('now'))
+           AND superseded_by IS NULL`)
+            .all(...unique);
+    }
+    catch {
+        return [];
+    }
+}
+export function resolveBacklinks(db, entryId) {
+    if (!entryId)
+        return [];
+    const likePattern = `%"${entryId}"%`;
+    try {
+        return db
+            .prepare(`SELECT * FROM vault
+         WHERE related_to LIKE ?
+           AND (expires_at IS NULL OR expires_at > datetime('now'))
+           AND superseded_by IS NULL`)
+            .all(likePattern);
+    }
+    catch {
+        return [];
+    }
+}
+export function collectLinkedEntries(db, primaryEntries) {
+    const primaryIds = new Set(primaryEntries.map((e) => e.id));
+    const forwardIds = [];
+    for (const entry of primaryEntries) {
+        const ids = parseRelatedTo(entry.related_to);
+        for (const id of ids) {
+            if (!primaryIds.has(id))
+                forwardIds.push(id);
+        }
+    }
+    const forwardEntries = resolveLinks(db, forwardIds).filter((e) => !primaryIds.has(e.id));
+    const backwardSeen = new Set();
+    const backwardEntries = [];
+    for (const entry of primaryEntries) {
+        const backlinks = resolveBacklinks(db, entry.id);
+        for (const bl of backlinks) {
+            if (!primaryIds.has(bl.id) && !backwardSeen.has(bl.id)) {
+                backwardSeen.add(bl.id);
+                backwardEntries.push(bl);
+            }
+        }
+    }
+    return { forward: forwardEntries, backward: backwardEntries };
+}
+export function validateRelatedTo(relatedTo) {
+    if (relatedTo === undefined || relatedTo === null)
+        return null;
+    if (!Array.isArray(relatedTo))
+        return 'related_to must be an array of entry IDs';
+    for (const id of relatedTo) {
+        if (typeof id !== 'string' || !id.trim()) {
+            return 'each related_to entry must be a non-empty string ID';
+        }
+        if (id.length > 32) {
+            return `related_to ID too long (max 32 chars): "${id.slice(0, 32)}..."`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=linking.js.map

package/dist/linking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.js","sourceRoot":"","sources":["../src/linking.ts"],"names":[],"mappings":"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"}

package/dist/migrate-dirs.d.ts

@@ -0,0 +1,16 @@
+export declare const PLURAL_TO_SINGULAR: Record<string, string>;
+export interface MigrationOp {
+    action: 'rename' | 'merge';
+    pluralDir: string;
+    singularDir: string;
+    pluralName: string;
+    singularName: string;
+    fileCount: number;
+}
+export declare function planMigration(vaultDir: string): MigrationOp[];
+export declare function executeMigration(ops: MigrationOp[]): {
+    renamed: number;
+    merged: number;
+    errors: string[];
+};
+//# sourceMappingURL=migrate-dirs.d.ts.map