context-vault 3.1.7 → 3.1.8

package/dist/tools/context-status.js

@@ -0,0 +1,160 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { gatherVaultStatus, computeGrowthWarnings } from '../status.js';
+import { errorLogPath, errorLogCount } from '../error-log.js';
+import { ok, err } from '../helpers.js';
+function relativeTime(ts) {
+    const secs = Math.floor((Date.now() - ts) / 1000);
+    if (secs < 60)
+        return `${secs}s ago`;
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)
+        return `${mins} minute${mins === 1 ? '' : 's'} ago`;
+    const hrs = Math.floor(mins / 60);
+    return `${hrs} hour${hrs === 1 ? '' : 's'} ago`;
+}
+export const name = 'context_status';
+export const description = 'Show vault health: resolved config, file counts per kind, database size, and any issues. Use to verify setup or troubleshoot. Call this when a user asks about their vault or to debug search issues.';
+export const inputSchema = {};
+export function handler(_args, ctx) {
+    try {
+        const { config } = ctx;
+        const status = gatherVaultStatus(ctx);
+        const hasIssues = status.stalePaths || (status.embeddingStatus?.missing ?? 0) > 0;
+        const healthIcon = hasIssues ? '⚠' : '✓';
+        const lines = [
+            `## ${healthIcon} Vault Status (connected)`,
+            ``,
+            `Vault:     ${config.vaultDir} (${config.vaultDirExists ? status.fileCount + ' files' : 'missing'})`,
+            `Database:  ${config.dbPath} (${status.dbSize})`,
+            `Dev dir:   ${config.devDir}`,
+            `Data dir:  ${config.dataDir}`,
+            `Config:    ${config.configPath}`,
+            `Resolved via: ${status.resolvedFrom}`,
+            `Schema:    v9 (updated_at, superseded_by)`,
+        ];
+        if (status.embeddingStatus) {
+            const { indexed, total, missing } = status.embeddingStatus;
+            const pct = total > 0 ? Math.round((indexed / total) * 100) : 100;
+            lines.push(`Embeddings: ${indexed}/${total} (${pct}%)`);
+        }
+        if (status.embedModelAvailable === false) {
+            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 pending prune (run \`context-vault prune\` to remove now)`);
+        }
+        lines.push(``, `### Indexed`);
+        if (status.kindCounts.length) {
+            for (const { kind, c } of status.kindCounts)
+                lines.push(`- ${c} ${kind}s`);
+        }
+        else {
+            lines.push(`- (empty)`);
+        }
+        if (status.categoryCounts.length) {
+            lines.push(``);
+            lines.push(`### Categories`);
+            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`);
+        }
+        if (status.stalePaths) {
+            lines.push(``);
+            lines.push(`### ⚠ Stale Paths`);
+            lines.push(`DB contains ${status.staleCount} paths not matching current vault dir.`);
+            lines.push(`Auto-reindex will fix this on next search or save.`);
+        }
+        if (status.staleKnowledge?.length > 0) {
+            lines.push(``);
+            lines.push(`### ⚠ Potentially Stale Knowledge`);
+            lines.push(`Not updated within kind staleness window (pattern: 180d, decision: 365d, reference: 90d):`);
+            for (const entry of status.staleKnowledge) {
+                const lastUpdated = entry.last_updated ? entry.last_updated.split('T')[0] : 'unknown';
+                lines.push(`- "${entry.title}" (${entry.kind}) — last updated ${lastUpdated}`);
+            }
+            lines.push(`Use save_context to refresh or add expires_at to retire stale entries.`);
+        }
+        // Error log
+        const logPath = errorLogPath(config.dataDir);
+        const logCount = errorLogCount(config.dataDir);
+        if (logCount > 0) {
+            lines.push(``, `### Startup Error Log`);
+            lines.push(`- Path: ${logPath}`);
+            lines.push(`- Entries: ${logCount} (share this file for support)`);
+        }
+        // Last startup error
+        const lastErrorPath = join(config.dataDir, '.last-error');
+        if (existsSync(lastErrorPath)) {
+            try {
+                const lastError = readFileSync(lastErrorPath, 'utf-8').trim();
+                lines.push(``, `### Last Startup Error`);
+                lines.push(`\`\`\``);
+                lines.push(lastError);
+                lines.push(`\`\`\``);
+            }
+            catch { }
+        }
+        // Health: session-level tool call stats
+        const ts = ctx.toolStats;
+        if (ts) {
+            lines.push(``, `### Health`);
+            lines.push(`- Tool calls (session): ${ts.ok} ok, ${ts.errors} errors`);
+            if (ts.lastError) {
+                const { tool, code, timestamp } = ts.lastError;
+                lines.push(`- Last error: ${tool ?? 'unknown'} — ${code} (${relativeTime(timestamp)})`);
+            }
+            if (status.autoCapturedFeedbackCount > 0) {
+                lines.push(`- Auto-captured feedback entries: ${status.autoCapturedFeedbackCount} (run get_context with kind:feedback tags:auto-captured)`);
+            }
+        }
+        // Growth warnings
+        const growth = computeGrowthWarnings(status, config.thresholds);
+        if (growth.hasWarnings) {
+            lines.push('', '### ⚠ Vault Growth Warning');
+            for (const w of growth.warnings) {
+                lines.push(`  ${w.message}`);
+            }
+            if (growth.kindBreakdown.length) {
+                lines.push('');
+                lines.push('  Breakdown by kind:');
+                for (const { kind, count, pct } of growth.kindBreakdown) {
+                    lines.push(`    ${kind}: ${count.toLocaleString()} (${pct}%)`);
+                }
+            }
+            if (growth.actions.length) {
+                lines.push('', 'Suggested growth actions:');
+                for (const a of growth.actions) {
+                    lines.push(`  • ${a}`);
+                }
+            }
+        }
+        // Suggested actions
+        const actions = [];
+        if (status.stalePaths)
+            actions.push('- Run `context-vault reindex` to fix stale paths');
+        if ((status.embeddingStatus?.missing ?? 0) > 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);
+        }
+        return ok(lines.join('\n'));
+    }
+    catch (e) {
+        return err(e instanceof Error ? e.message : String(e), 'STATUS_FAILED');
+    }
+}
+//# sourceMappingURL=context-status.js.map

package/dist/tools/context-status.js.map

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

package/dist/tools/create-snapshot.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { LocalCtx, SharedCtx, ToolResult } from '../types.js';
+export declare const name = "create_snapshot";
+export declare const description = "Pull all relevant vault entries matching a topic, deduplicate, and save them as a structured context brief (kind: 'brief'). Entries are formatted as markdown \u2014 no external API or LLM call required. The calling agent can synthesize the gathered content directly. Retrieve with: get_context(kind: 'brief', identity_key: '<key>').";
+export declare const inputSchema: {
+    topic: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    buckets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    identity_key: z.ZodOptional<z.ZodString>;
+};
+export declare function handler({ topic, tags, buckets, kinds, identity_key }: Record<string, any>, ctx: LocalCtx, { ensureIndexed }: SharedCtx): Promise<ToolResult>;
+//# sourceMappingURL=create-snapshot.d.ts.map

package/dist/tools/create-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-snapshot.d.ts","sourceRoot":"","sources":["../../src/tools/create-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMnE,eAAO,MAAM,IAAI,oBAAoB,CAAC;AAEtC,eAAO,MAAM,WAAW,iVACmT,CAAC;AAE5U,eAAO,MAAM,WAAW;;;;;;CAsBvB,CAAC;AA+CF,wBAAsB,OAAO,CAC3B,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClE,GAAG,EAAE,QAAQ,EACb,EAAE,aAAa,EAAE,EAAE,SAAS,GAC3B,OAAO,CAAC,UAAU,CAAC,CA2GrB"}

package/dist/tools/create-snapshot.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { hybridSearch } from '@context-vault/core/search';
+import { captureAndIndex } from '@context-vault/core/capture';
+import { normalizeKind } from '@context-vault/core/files';
+import { ok, err, ensureVaultExists } from '../helpers.js';
+const NOISE_KINDS = new Set(['prompt-history', 'task-notification']);
+const MAX_ENTRIES_FOR_GATHER = 40;
+const MAX_BODY_PER_ENTRY = 600;
+export const name = 'create_snapshot';
+export const description = "Pull all relevant vault entries matching a topic, deduplicate, and save them as a structured context brief (kind: 'brief'). Entries are formatted as markdown — no external API or LLM call required. The calling agent can synthesize the gathered content directly. Retrieve with: get_context(kind: 'brief', identity_key: '<key>').";
+export const inputSchema = {
+    topic: z.string().describe('The topic or project name to snapshot'),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe('Optional tag filters — entries must match at least one'),
+    buckets: z
+        .array(z.string())
+        .optional()
+        .describe("Filter by project-scoped buckets. Each name expands to a 'bucket:<name>' tag. Composes with 'tags' via OR (entries matching any tag or any bucket are included)."),
+    kinds: z
+        .array(z.string())
+        .optional()
+        .describe('Optional kind filters to restrict which entry types are pulled'),
+    identity_key: z
+        .string()
+        .optional()
+        .describe('Deterministic key for the saved brief (defaults to slugified topic). Use the same key to overwrite a previous snapshot.'),
+};
+function formatGatheredEntries(topic, entries) {
+    const header = [
+        `# ${topic} — Context Brief`,
+        '',
+        `*Gathered from ${entries.length} vault ${entries.length === 1 ? 'entry' : 'entries'}. Synthesize the content below to extract key decisions, patterns, and constraints.*`,
+        '',
+        '---',
+        '',
+    ].join('\n');
+    const body = entries
+        .map((e, i) => {
+        const tags = e.tags ? JSON.parse(e.tags) : [];
+        const tagStr = tags.length ? tags.join(', ') : 'none';
+        const updated = e.updated_at || e.created_at || 'unknown';
+        const bodyText = e.body
+            ? e.body.slice(0, MAX_BODY_PER_ENTRY) + (e.body.length > MAX_BODY_PER_ENTRY ? '…' : '')
+            : '(no body)';
+        const title = e.title || `Entry ${i + 1}`;
+        return [
+            `## ${i + 1}. [${e.kind}] ${title}`,
+            '',
+            `**Tags:** ${tagStr}`,
+            `**Updated:** ${updated}`,
+            `**ID:** \`${e.id}\``,
+            '',
+            bodyText,
+            '',
+            '---',
+            '',
+        ].join('\n');
+    })
+        .join('');
+    return header + body;
+}
+function slugifyTopic(topic) {
+    return topic
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 120);
+}
+export async function handler({ topic, tags, buckets, kinds, identity_key }, ctx, { ensureIndexed }) {
+    const { config } = ctx;
+    const vaultErr = ensureVaultExists(config);
+    if (vaultErr)
+        return vaultErr;
+    if (!topic?.trim()) {
+        return err('Required: topic (non-empty string)', 'INVALID_INPUT');
+    }
+    await ensureIndexed();
+    const normalizedKinds = kinds?.map(normalizeKind) ?? [];
+    const bucketTags = buckets?.length ? buckets.map((b) => `bucket:${b}`) : [];
+    const effectiveTags = [...(tags ?? []), ...bucketTags];
+    let candidates = [];
+    try {
+        if (normalizedKinds.length > 0) {
+            for (const kindFilter of normalizedKinds) {
+                const rows = await hybridSearch(ctx, topic, {
+                    kindFilter,
+                    limit: Math.ceil(MAX_ENTRIES_FOR_GATHER / normalizedKinds.length),
+                    includeSuperseeded: false,
+                });
+                candidates.push(...rows);
+            }
+            const seen = new Set();
+            candidates = candidates.filter((r) => {
+                if (seen.has(r.id))
+                    return false;
+                seen.add(r.id);
+                return true;
+            });
+        }
+        else {
+            candidates = await hybridSearch(ctx, topic, {
+                limit: MAX_ENTRIES_FOR_GATHER,
+                includeSuperseeded: false,
+            });
+        }
+    }
+    catch (e) {
+        return err(e instanceof Error ? e.message : String(e), 'SEARCH_FAILED');
+    }
+    if (effectiveTags.length) {
+        candidates = candidates.filter((r) => {
+            const entryTags = r.tags ? JSON.parse(r.tags) : [];
+            return effectiveTags.some((t) => entryTags.includes(t));
+        });
+    }
+    const noiseIds = candidates.filter((r) => NOISE_KINDS.has(r.kind)).map((r) => r.id);
+    const gatherEntries = candidates.filter((r) => !NOISE_KINDS.has(r.kind));
+    if (gatherEntries.length === 0) {
+        return err(`No entries found for topic "${topic}". Try a broader topic or different tags.`, 'NO_ENTRIES');
+    }
+    const briefBody = formatGatheredEntries(topic, gatherEntries);
+    const effectiveIdentityKey = identity_key ?? `snapshot-${slugifyTopic(topic)}`;
+    const briefTags = ['snapshot', ...(tags ?? []), ...(normalizedKinds.length > 0 ? [] : [])];
+    const supersedes = noiseIds.length > 0 ? noiseIds : undefined;
+    let entry;
+    try {
+        entry = await captureAndIndex(ctx, {
+            kind: 'brief',
+            title: `${topic} — Context Brief`,
+            body: briefBody,
+            tags: briefTags,
+            source: 'create_snapshot',
+            identity_key: effectiveIdentityKey,
+            supersedes,
+            meta: {
+                topic,
+                entry_count: gatherEntries.length,
+                noise_superseded: noiseIds.length,
+                synthesized_from: gatherEntries.map((e) => e.id),
+            },
+        });
+    }
+    catch (e) {
+        return err(e instanceof Error ? e.message : String(e), 'SAVE_FAILED');
+    }
+    const parts = [
+        `✓ Snapshot created → id: ${entry.id}`,
+        `  title: ${entry.title}`,
+        `  identity_key: ${effectiveIdentityKey}`,
+        `  synthesized from: ${gatherEntries.length} entries`,
+        noiseIds.length > 0 ? `  noise superseded: ${noiseIds.length} entries` : null,
+        '',
+        "_Retrieve with: get_context(kind: 'brief', identity_key: '" + effectiveIdentityKey + "')_",
+    ]
+        .filter((l) => l !== null)
+        .join('\n');
+    return ok(parts);
+}
+//# sourceMappingURL=create-snapshot.js.map

package/dist/tools/create-snapshot.js.map

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

package/dist/tools/delete-context.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { LocalCtx, SharedCtx, ToolResult } from '../types.js';
+export declare const name = "delete_context";
+export declare const description = "Delete an entry from your vault by its ULID id. Removes the file from disk and cleans up the search index.";
+export declare const inputSchema: {
+    id: z.ZodString;
+};
+export declare function handler({ id }: Record<string, any>, ctx: LocalCtx, { ensureIndexed }: SharedCtx): Promise<ToolResult>;
+//# sourceMappingURL=delete-context.d.ts.map

package/dist/tools/delete-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-context.d.ts","sourceRoot":"","sources":["../../src/tools/delete-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEnE,eAAO,MAAM,IAAI,mBAAmB,CAAC;AAErC,eAAO,MAAM,WAAW,+GACsF,CAAC;AAE/G,eAAO,MAAM,WAAW;;CAEvB,CAAC;AAEF,wBAAsB,OAAO,CAC3B,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,QAAQ,EACb,EAAE,aAAa,EAAE,EAAE,SAAS,GAC3B,OAAO,CAAC,UAAU,CAAC,CAkCrB"}

package/dist/tools/delete-context.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { unlinkSync } from 'node:fs';
+import { ok, err } from '../helpers.js';
+export const name = 'delete_context';
+export const description = 'Delete an entry from your vault by its ULID id. Removes the file from disk and cleans up the search index.';
+export const inputSchema = {
+    id: z.string().describe('The entry ULID to delete'),
+};
+export async function handler({ id }, ctx, { ensureIndexed }) {
+    if (!id?.trim())
+        return err('Required: id (non-empty string)', 'INVALID_INPUT');
+    await ensureIndexed();
+    const entry = ctx.stmts.getEntryById.get(id);
+    if (!entry)
+        return err(`Entry not found: ${id}`, 'NOT_FOUND');
+    try {
+        // Delete DB record first — if this fails, the file stays and no orphan is created
+        const rowidResult = ctx.stmts.getRowid.get(id);
+        if (rowidResult?.rowid) {
+            try {
+                ctx.deleteVec(Number(rowidResult.rowid));
+            }
+            catch { }
+        }
+        ctx.stmts.deleteEntry.run(id);
+        // Delete file from disk after successful DB delete
+        let fileWarning = null;
+        if (entry.file_path) {
+            try {
+                unlinkSync(entry.file_path);
+            }
+            catch (e) {
+                if (e.code !== 'ENOENT') {
+                    fileWarning = `file could not be removed from disk (${e.code}): ${entry.file_path}`;
+                }
+            }
+        }
+        const msg = `Deleted ${entry.kind}: ${entry.title || '(untitled)'} [${id}]`;
+        return ok(fileWarning ? `${msg}\nWarning: ${fileWarning}` : msg);
+    }
+    catch (e) {
+        return err(e instanceof Error ? e.message : String(e), 'DELETE_FAILED');
+    }
+}
+//# sourceMappingURL=delete-context.js.map

package/dist/tools/delete-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-context.js","sourceRoot":"","sources":["../../src/tools/delete-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGxC,MAAM,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GACtB,4GAA4G,CAAC;AAE/G,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACpD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAAE,EAAE,EAAuB,EAC3B,GAAa,EACb,EAAE,aAAa,EAAa;IAE5B,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC,iCAAiC,EAAE,eAAe,CAAC,CAAC;IAChF,MAAM,aAAa,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,oBAAoB,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,kFAAkF;QAClF,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE9B,mDAAmD;QACnD,IAAI,WAAW,GAAG,IAAI,CAAC;QACvB,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,UAAU,CAAC,KAAK,CAAC,SAAmB,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACxB,WAAW,GAAG,wCAAwC,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,WAAW,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,IAAI,YAAY,KAAK,EAAE,GAAG,CAAC;QAC5E,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,cAAc,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/tools/get-context.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import type { LocalCtx, SharedCtx, ToolResult } from '../types.js';
+/**
+ * Truncate a body string to ~SKELETON_BODY_CHARS, breaking at sentence or
+ * word boundary. Returns the truncated string with "..." appended.
+ */
+export declare function skeletonBody(body: string | null | undefined): string;
+/**
+ * Detect conflicts among a set of search result entries.
+ *
+ * Two checks are performed:
+ *   1. Supersession: if entry A's `superseded_by` points to any entry B in the
+ *      result set, A is stale and should be discarded in favour of B.
+ *   2. Stale duplicate: two entries share the same kind and at least one common
+ *      tag, but their `updated_at` timestamps differ by more than
+ *      STALE_DUPLICATE_DAYS days — suggesting the older one may be outdated.
+ *
+ * No LLM calls, no new dependencies — pure in-memory set operations on the
+ * rows already fetched from the DB.
+ *
+ * @param {Array} entries - Result rows (as returned by hybridSearch / filter-only mode)
+ * @param {import('@context-vault/core/types').BaseCtx} _ctx
+ * @returns {Array<{entry_a_id: string, entry_b_id: string, reason: string, recommendation: string}>}
+ */
+export declare function detectConflicts(entries: any[], _ctx: any): Array<{
+    entry_a_id: string;
+    entry_b_id: string;
+    reason: string;
+    recommendation: string;
+}>;
+/**
+ * Detect tag clusters that would benefit from consolidation via create_snapshot.
+ * A suggestion is emitted when a tag appears on threshold+ entries in the full
+ * vault AND no recent brief (kind='brief') exists for that tag within the
+ * staleness window.
+ *
+ * Tag counts are derived from the full vault (not just the search result set)
+ * so the check reflects the true size of the knowledge cluster. Only tags that
+ * appear in the current search results are evaluated — this keeps the check
+ * targeted to what the user is actually working with.
+ *
+ * @param {Array} entries - Search result rows (used to select candidate tags)
+ * @param {import('node:sqlite').DatabaseSync} db - Database handle for vault-wide counts and brief lookups
+ * @param {{ tagThreshold?: number, maxAgeDays?: number }} opts - Configurable thresholds
+ * @returns {Array<{tag: string, entry_count: number, last_snapshot_age_days: number|null}>}
+ */
+export declare function detectConsolidationHints(entries: any[], db: any, opts?: {
+    tagThreshold?: number;
+    maxAgeDays?: number;
+}): Array<{
+    tag: string;
+    entry_count: number;
+    last_snapshot_age_days: number | null;
+}>;
+export declare const name = "get_context";
+export declare const description = "Search your knowledge vault. Returns entries ranked by relevance using hybrid full-text + semantic search. Use this to find insights, decisions, patterns, or any saved context. Each result includes an `id` you can use with save_context or delete_context.";
+export declare const inputSchema: {
+    query: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<{
+        knowledge: "knowledge";
+        entity: "entity";
+        event: "event";
+    }>>;
+    identity_key: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    buckets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    include_superseded: z.ZodOptional<z.ZodBoolean>;
+    detect_conflicts: z.ZodOptional<z.ZodBoolean>;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    pivot_count: z.ZodOptional<z.ZodNumber>;
+    include_ephemeral: z.ZodOptional<z.ZodBoolean>;
+    include_events: z.ZodOptional<z.ZodBoolean>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        events: "events";
+        hot: "hot";
+        all: "all";
+    }>>;
+    follow_links: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function handler({ query, kind, category, identity_key, tags, buckets, since, until, limit, include_superseded, detect_conflicts, max_tokens, pivot_count, include_ephemeral, include_events, scope, follow_links, }: Record<string, any>, ctx: LocalCtx, { ensureIndexed, reindexFailed }: SharedCtx): Promise<ToolResult>;
+//# sourceMappingURL=get-context.d.ts.map

package/dist/tools/get-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASnE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAapE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,GAAG,EAAE,EACd,IAAI,EAAE,GAAG,GACR,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D3F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,GAAG,EAAE,EACd,EAAE,EAAE,GAAG,EACP,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACxD,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAyDpF;AAyCD,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,mQAC0O,CAAC;AAEnQ,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFvB,CAAC;AAEF,wBAAsB,OAAO,CAC3B,EACE,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,KAAK,EACL,KAAK,EACL,KAAK,EACL,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,KAAK,EACL,YAAY,GACb,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtB,GAAG,EAAE,QAAQ,EACb,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,SAAS,GAC1C,OAAO,CAAC,UAAU,CAAC,CA2VrB"}