@context-vault/core 2.15.0 → 2.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-vault/core",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "type": "module",
   "description": "Shared core: capture, index, retrieve, tools, and utilities for context-vault",
   "main": "src/index.js",

package/src/constants.js

@@ -14,8 +14,13 @@ export const MAX_SOURCE_LENGTH = 200;
 export const MAX_IDENTITY_KEY_LENGTH = 200;
 
 export const DEFAULT_GROWTH_THRESHOLDS = {
-  totalEntries: { warn: 1000, critical: 5000 },
-  eventEntries: { warn: 500, critical: 2000 },
+  totalEntries: { warn: 2000, critical: 5000 },
+  eventEntries: { warn: 1000, critical: 3000 },
   vaultSizeBytes: { warn: 50 * 1024 * 1024, critical: 200 * 1024 * 1024 },
   eventsWithoutTtl: { warn: 200 },
 };
+
+export const DEFAULT_LIFECYCLE = {
+  event: { archiveAfterDays: 90 },
+  ephemeral: { archiveAfterDays: 30 },
+};

package/src/core/config.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { homedir } from "node:os";
-import { DEFAULT_GROWTH_THRESHOLDS } from "../constants.js";
+import { DEFAULT_GROWTH_THRESHOLDS, DEFAULT_LIFECYCLE } from "../constants.js";
 
 export function parseArgs(argv) {
   const args = {};
@@ -27,7 +27,7 @@ export function resolveConfig() {
       join(HOME, ".context-mcp"),
   );
   const config = {
-    vaultDir: join(HOME, "vault"),
+    vaultDir: join(HOME, ".vault"),
     dataDir,
     dbPath: join(dataDir, "vault.db"),
     devDir: join(HOME, "dev"),
@@ -48,6 +48,7 @@ export function resolveConfig() {
       maxAgeDays: 7,
       autoConsolidate: false,
     },
+    lifecycle: structuredClone(DEFAULT_LIFECYCLE),
   };
 
   const configPath = join(dataDir, "config.json");
@@ -62,6 +63,12 @@ export function resolveConfig() {
       if (fc.dbPath) config.dbPath = fc.dbPath;
       if (fc.devDir) config.devDir = fc.devDir;
       if (fc.eventDecayDays != null) config.eventDecayDays = fc.eventDecayDays;
+      if (fc.growthWarningThreshold != null) {
+        config.thresholds.totalEntries = {
+          ...config.thresholds.totalEntries,
+          warn: Number(fc.growthWarningThreshold),
+        };
+      }
       if (fc.thresholds) {
         const t = fc.thresholds;
         if (t.totalEntries)

package/src/core/status.js

@@ -212,7 +212,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
  *
  * @param {object} status — result of gatherVaultStatus()
  * @param {object} thresholds — from config.thresholds
- * @returns {{ warnings: Array, hasCritical: boolean, hasWarnings: boolean, actions: string[] }}
+ * @returns {{ warnings: Array, hasCritical: boolean, hasWarnings: boolean, actions: string[], kindBreakdown: Array }}
  */
 export function computeGrowthWarnings(status, thresholds) {
   if (!thresholds)
@@ -221,6 +221,7 @@ export function computeGrowthWarnings(status, thresholds) {
       hasCritical: false,
       hasWarnings: false,
       actions: [],
+      kindBreakdown: [],
     };
 
   const t = thresholds;
@@ -235,12 +236,16 @@ export function computeGrowthWarnings(status, thresholds) {
     dbSizeBytes = 0,
   } = status;
 
+  let totalExceeded = false;
+
   if (t.totalEntries?.critical != null && total >= t.totalEntries.critical) {
+    totalExceeded = true;
     warnings.push({
       level: "critical",
       message: `Total entries: ${total.toLocaleString()} (exceeds critical limit of ${t.totalEntries.critical.toLocaleString()})`,
     });
   } else if (t.totalEntries?.warn != null && total >= t.totalEntries.warn) {
+    totalExceeded = true;
     warnings.push({
       level: "warn",
       message: `Total entries: ${total.toLocaleString()} (exceeds recommended ${t.totalEntries.warn.toLocaleString()})`,
@@ -320,5 +325,26 @@ export function computeGrowthWarnings(status, thresholds) {
     actions.push("Consider archiving events older than 90 days");
   }
 
-  return { warnings, hasCritical, hasWarnings: warnings.length > 0, actions };
+  const kindBreakdown = totalExceeded
+    ? buildKindBreakdown(status.kindCounts, total)
+    : [];
+
+  return {
+    warnings,
+    hasCritical,
+    hasWarnings: warnings.length > 0,
+    actions,
+    kindBreakdown,
+  };
+}
+
+function buildKindBreakdown(kindCounts, total) {
+  if (!kindCounts?.length || total === 0) return [];
+  return [...kindCounts]
+    .sort((a, b) => b.c - a.c)
+    .map(({ kind, c }) => ({
+      kind,
+      count: c,
+      pct: Math.round((c / total) * 100),
+    }));
 }

package/src/index/index.js

@@ -196,18 +196,20 @@ export async function indexEntry(
     );
   }
 
-  // Embeddings are always generated from plaintext (before encryption)
-  const embeddingText = [title, body].filter(Boolean).join(" ");
-  const embedding = await ctx.embed(embeddingText);
+  // Skip embedding generation for event entries — they are excluded from
+  // default semantic search and don't need vector representations
+  if (cat !== "event") {
+    const embeddingText = [title, body].filter(Boolean).join(" ");
+    const embedding = await ctx.embed(embeddingText);
 
-  // Upsert vec: delete old if exists, then insert new (skip if embedding unavailable)
-  if (embedding) {
-    try {
-      ctx.deleteVec(rowid);
-    } catch {
-      /* no-op if not found */
+    if (embedding) {
+      try {
+        ctx.deleteVec(rowid);
+      } catch {
+        /* no-op if not found */
+      }
+      ctx.insertVec(rowid, embedding);
     }
-    ctx.insertVec(rowid, embedding);
   }
 }
 
@@ -370,15 +372,17 @@ export async function reindex(ctx, opts = {}) {
             fmMeta.updated || created,
           );
           if (result.changes > 0) {
-            const rowidResult = ctx.stmts.getRowid.get(id);
-            if (rowidResult?.rowid) {
-              const embeddingText = [parsed.title, parsed.body]
-                .filter(Boolean)
-                .join(" ");
-              pendingEmbeds.push({
-                rowid: rowidResult.rowid,
-                text: embeddingText,
-              });
+            if (category !== "event") {
+              const rowidResult = ctx.stmts.getRowid.get(id);
+              if (rowidResult?.rowid) {
+                const embeddingText = [parsed.title, parsed.body]
+                  .filter(Boolean)
+                  .join(" ");
+                pendingEmbeds.push({
+                  rowid: rowidResult.rowid,
+                  text: embeddingText,
+                });
+              }
             }
             stats.added++;
           } else {
@@ -407,7 +411,7 @@ export async function reindex(ctx, opts = {}) {
             );
 
             // Queue re-embed if title or body changed (vector ops deferred to Phase 2)
-            if (bodyChanged || titleChanged) {
+            if ((bodyChanged || titleChanged) && category !== "event") {
               const rowid = ctx.stmts.getRowid.get(existing.id)?.rowid;
               if (rowid) {
                 const embeddingText = [parsed.title, parsed.body]

package/src/retrieve/index.js

@@ -74,6 +74,7 @@ export function recencyBoost(createdAt, category, decayDays = 30) {
  */
 export function buildFilterClauses({
   categoryFilter,
+  excludeEvents = false,
   since,
   until,
   userIdFilter,
@@ -94,6 +95,9 @@ export function buildFilterClauses({
     clauses.push("e.category = ?");
     params.push(categoryFilter);
   }
+  if (excludeEvents && !categoryFilter) {
+    clauses.push("e.category != 'event'");
+  }
   if (since) {
     clauses.push("e.created_at >= ?");
     params.push(since);
@@ -242,6 +246,7 @@ export async function hybridSearch(
   {
     kindFilter = null,
     categoryFilter = null,
+    excludeEvents = false,
     since = null,
     until = null,
     limit = 20,
@@ -258,6 +263,7 @@ export async function hybridSearch(
 
   const extraFilters = buildFilterClauses({
     categoryFilter,
+    excludeEvents,
     since,
     until,
     userIdFilter,
@@ -340,6 +346,7 @@ export async function hybridSearch(
             if (teamIdFilter && row.team_id !== teamIdFilter) continue;
             if (kindFilter && row.kind !== kindFilter) continue;
             if (categoryFilter && row.category !== categoryFilter) continue;
+            if (excludeEvents && row.category === "event") 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())

package/src/server/tools/context-status.js

@@ -146,6 +146,13 @@ export function handler(_args, ctx) {
     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) {

package/src/server/tools/get-context.js

@@ -316,6 +316,12 @@ export const inputSchema = {
     .describe(
       "If true, include ephemeral tier entries in results. Default: false — only working and durable tiers are returned.",
     ),
+  include_events: z
+    .boolean()
+    .optional()
+    .describe(
+      "If true, include event category entries in semantic search results. Default: false — events are excluded from query-based search but remain accessible via category/tag filters.",
+    ),
 };
 
 /**
@@ -339,6 +345,7 @@ export async function handler(
     max_tokens,
     pivot_count,
     include_ephemeral,
+    include_events,
   },
   ctx,
   { ensureIndexed, reindexFailed },
@@ -347,6 +354,7 @@ export async function handler(
   const userId = ctx.userId !== undefined ? ctx.userId : undefined;
 
   const hasQuery = query?.trim();
+  const shouldExcludeEvents = hasQuery && !include_events && !category;
   // Expand buckets to bucket: prefixed tags and merge with explicit tags
   const bucketTags = buckets?.length ? buckets.map((b) => `bucket:${b}`) : [];
   const effectiveTags = [...(tags ?? []), ...bucketTags];
@@ -413,6 +421,7 @@ export async function handler(
     const sorted = await hybridSearch(ctx, query, {
       kindFilter,
       categoryFilter: category || null,
+      excludeEvents: shouldExcludeEvents,
       since: effectiveSince,
       until: effectiveUntil,
       limit: fetchLimit,
@@ -490,6 +499,11 @@ export async function handler(
     filtered = filtered.filter((r) => r.tier !== "ephemeral");
   }
 
+  // Event category filter: exclude events from semantic search by default
+  if (shouldExcludeEvents) {
+    filtered = filtered.filter((r) => r.category !== "event");
+  }
+
   if (!filtered.length) {
     if (autoWindowed) {
       const days = config.eventDecayDays || 30;