context-vault 3.1.6 → 3.1.7

package/src/status.js

@@ -1,11 +1,11 @@
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { walkDir } from "@context-vault/core/files";
-import { isEmbedAvailable } from "@context-vault/core/embed";
-import { KIND_STALENESS_DAYS } from "@context-vault/core/categories";
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { walkDir } from '@context-vault/core/files';
+import { isEmbedAvailable } from '@context-vault/core/embed';
+import { KIND_STALENESS_DAYS } from '@context-vault/core/categories';
 
 function countArchivedEntries(vaultDir) {
-  const archRoot = join(vaultDir, "_archive");
+  const archRoot = join(vaultDir, '_archive');
   if (!existsSync(archRoot)) return 0;
   try {
     return walkDir(archRoot).length;
@@ -37,9 +37,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
 
   let kindCounts = [];
   try {
-    kindCounts = db
-      .prepare(`SELECT kind, COUNT(*) as c FROM vault GROUP BY kind`)
-      .all();
+    kindCounts = db.prepare(`SELECT kind, COUNT(*) as c FROM vault GROUP BY kind`).all();
   } catch (e) {
     errors.push(`Kind count query failed: ${e.message}`);
   }
@@ -53,7 +51,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
     errors.push(`Category count query failed: ${e.message}`);
   }
 
-  let dbSize = "n/a";
+  let dbSize = 'n/a';
   let dbSizeBytes = 0;
   try {
     if (existsSync(config.dbPath)) {
@@ -71,9 +69,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
   let staleCount = 0;
   try {
     const result = db
-      .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE file_path NOT LIKE ? || '%'`,
-      )
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE file_path NOT LIKE ? || '%'`)
       .get(config.vaultDir);
     staleCount = result.c;
     stalePaths = staleCount > 0;
@@ -85,7 +81,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
   try {
     expiredCount = db
       .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE expires_at IS NOT NULL AND expires_at <= datetime('now')`,
+        `SELECT COUNT(*) as c FROM vault WHERE expires_at IS NOT NULL AND expires_at <= datetime('now')`
       )
       .get().c;
   } catch (e) {
@@ -94,9 +90,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
 
   let eventCount = 0;
   try {
-    eventCount = db
-      .prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event'`)
-      .get().c;
+    eventCount = db.prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event'`).get().c;
   } catch (e) {
     errors.push(`Event count failed: ${e.message}`);
   }
@@ -104,9 +98,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
   let eventsWithoutTtlCount = 0;
   try {
     eventsWithoutTtlCount = db
-      .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE category = 'event' AND expires_at IS NULL`,
-      )
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event' AND expires_at IS NULL`)
       .get().c;
   } catch (e) {
     errors.push(`Events without TTL count failed: ${e.message}`);
@@ -116,9 +108,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
   try {
     const total = db.prepare(`SELECT COUNT(*) as c FROM vault`).get().c;
     const indexed = db
-      .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE rowid IN (SELECT rowid FROM vault_vec)`,
-      )
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE rowid IN (SELECT rowid FROM vault_vec)`)
       .get().c;
     embeddingStatus = { indexed, total, missing: total - indexed };
   } catch (e) {
@@ -131,7 +121,7 @@ export function gatherVaultStatus(ctx, opts = {}) {
   try {
     autoCapturedFeedbackCount = db
       .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE kind = 'feedback' AND tags LIKE '%"auto-captured"%'`,
+        `SELECT COUNT(*) as c FROM vault WHERE kind = 'feedback' AND tags LIKE '%"auto-captured"%'`
       )
       .get().c;
   } catch (e) {
@@ -152,12 +142,12 @@ export function gatherVaultStatus(ctx, opts = {}) {
       const kindClauses = stalenessKinds
         .map(
           ([kind, days]) =>
-            `(kind = '${kind}' AND COALESCE(updated_at, created_at) <= datetime('now', '-${days} days'))`,
+            `(kind = '${kind}' AND COALESCE(updated_at, created_at) <= datetime('now', '-${days} days'))`
         )
-        .join(" OR ");
+        .join(' OR ');
       staleKnowledge = db
         .prepare(
-          `SELECT kind, title, COALESCE(updated_at, created_at) as last_updated FROM vault WHERE category = 'knowledge' AND (${kindClauses}) AND (expires_at IS NULL OR expires_at > datetime('now')) ORDER BY last_updated ASC LIMIT 10`,
+          `SELECT kind, title, COALESCE(updated_at, created_at) as last_updated FROM vault WHERE category = 'knowledge' AND (${kindClauses}) AND (expires_at IS NULL OR expires_at > datetime('now')) ORDER BY last_updated ASC LIMIT 10`
         )
         .all();
     }
@@ -202,84 +192,62 @@ export function computeGrowthWarnings(status, thresholds) {
   const actions = [];
 
   const total = status.embeddingStatus?.total ?? 0;
-  const {
-    eventCount = 0,
-    eventsWithoutTtlCount = 0,
-    expiredCount = 0,
-    dbSizeBytes = 0,
-  } = status;
+  const { eventCount = 0, eventsWithoutTtlCount = 0, expiredCount = 0, dbSizeBytes = 0 } = status;
 
   let totalExceeded = false;
 
   if (t.totalEntries?.critical != null && total >= t.totalEntries.critical) {
     totalExceeded = true;
     warnings.push({
-      level: "critical",
+      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",
+      level: 'warn',
       message: `Total entries: ${total.toLocaleString()} (exceeds recommended ${t.totalEntries.warn.toLocaleString()})`,
     });
   }
 
-  if (
-    t.eventEntries?.critical != null &&
-    eventCount >= t.eventEntries.critical
-  ) {
+  if (t.eventEntries?.critical != null && eventCount >= t.eventEntries.critical) {
     warnings.push({
-      level: "critical",
+      level: 'critical',
       message: `Event entries: ${eventCount.toLocaleString()} (exceeds critical limit of ${t.eventEntries.critical.toLocaleString()})`,
     });
-  } else if (
-    t.eventEntries?.warn != null &&
-    eventCount >= t.eventEntries.warn
-  ) {
+  } else if (t.eventEntries?.warn != null && eventCount >= t.eventEntries.warn) {
     const ttlNote =
-      eventsWithoutTtlCount > 0
-        ? ` (${eventsWithoutTtlCount.toLocaleString()} without TTL)`
-        : "";
+      eventsWithoutTtlCount > 0 ? ` (${eventsWithoutTtlCount.toLocaleString()} without TTL)` : '';
     warnings.push({
-      level: "warn",
+      level: 'warn',
       message: `Event entries: ${eventCount.toLocaleString()}${ttlNote} (exceeds recommended ${t.eventEntries.warn.toLocaleString()})`,
     });
   }
 
-  if (
-    t.vaultSizeBytes?.critical != null &&
-    dbSizeBytes >= t.vaultSizeBytes.critical
-  ) {
+  if (t.vaultSizeBytes?.critical != null && dbSizeBytes >= t.vaultSizeBytes.critical) {
     warnings.push({
-      level: "critical",
+      level: 'critical',
       message: `Database size: ${(dbSizeBytes / 1024 / 1024).toFixed(1)}MB (exceeds critical limit of ${(t.vaultSizeBytes.critical / 1024 / 1024).toFixed(0)}MB)`,
     });
-  } else if (
-    t.vaultSizeBytes?.warn != null &&
-    dbSizeBytes >= t.vaultSizeBytes.warn
-  ) {
+  } else if (t.vaultSizeBytes?.warn != null && dbSizeBytes >= t.vaultSizeBytes.warn) {
     warnings.push({
-      level: "warn",
+      level: 'warn',
       message: `Database size: ${(dbSizeBytes / 1024 / 1024).toFixed(1)}MB (exceeds recommended ${(t.vaultSizeBytes.warn / 1024 / 1024).toFixed(0)}MB)`,
     });
   }
 
-  if (
-    t.eventsWithoutTtl?.warn != null &&
-    eventsWithoutTtlCount >= t.eventsWithoutTtl.warn
-  ) {
+  if (t.eventsWithoutTtl?.warn != null && eventsWithoutTtlCount >= t.eventsWithoutTtl.warn) {
     warnings.push({
-      level: "warn",
+      level: 'warn',
       message: `Event entries without expires_at: ${eventsWithoutTtlCount.toLocaleString()} (exceeds recommended ${t.eventsWithoutTtl.warn.toLocaleString()})`,
     });
   }
 
-  const hasCritical = warnings.some((w) => w.level === "critical");
+  const hasCritical = warnings.some((w) => w.level === 'critical');
 
   if (expiredCount > 0) {
     actions.push(
-      `Run \`context-vault prune\` to remove ${expiredCount} expired event entr${expiredCount === 1 ? "y" : "ies"}`,
+      `Run \`context-vault prune\` to remove ${expiredCount} expired event entr${expiredCount === 1 ? 'y' : 'ies'}`
     );
   }
   if (
@@ -287,14 +255,10 @@ export function computeGrowthWarnings(status, thresholds) {
     (eventCount >= (t.eventEntries?.warn ?? Infinity) ||
       eventsWithoutTtlCount >= (t.eventsWithoutTtl?.warn ?? Infinity))
   ) {
-    actions.push(
-      "Add `expires_at` to event/session entries to enable automatic cleanup",
-    );
+    actions.push('Add `expires_at` to event/session entries to enable automatic cleanup');
   }
   if (total >= (t.totalEntries?.warn ?? Infinity)) {
-    actions.push(
-      "Run `context-vault archive` to move old ephemeral/event entries to _archive/",
-    );
+    actions.push('Run `context-vault archive` to move old ephemeral/event entries to _archive/');
   }
 
   const kindBreakdown =

package/src/telemetry.js

@@ -1,18 +1,14 @@
-import { existsSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import {
-  API_URL,
-  MARKETING_URL,
-  GITHUB_ISSUES_URL,
-} from "@context-vault/core/constants";
+import { existsSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { API_URL, MARKETING_URL, GITHUB_ISSUES_URL } from '@context-vault/core/constants';
 
 const TELEMETRY_ENDPOINT = `${API_URL}/telemetry`;
-const NOTICE_MARKER = ".telemetry-notice-shown";
-const FEEDBACK_PROMPT_MARKER = ".feedback-prompt-shown";
+const NOTICE_MARKER = '.telemetry-notice-shown';
+const FEEDBACK_PROMPT_MARKER = '.feedback-prompt-shown';
 
 export function isTelemetryEnabled(config) {
   const envVal = process.env.CONTEXT_VAULT_TELEMETRY;
-  if (envVal !== undefined) return envVal === "1" || envVal === "true";
+  if (envVal !== undefined) return envVal === '1' || envVal === 'true';
   return config?.telemetry === true;
 }
 
@@ -31,8 +27,8 @@ export function sendTelemetryEvent(config, payload) {
   };
 
   fetch(TELEMETRY_ENDPOINT, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify(event),
     signal: AbortSignal.timeout(5000),
   }).catch(() => {});
@@ -42,21 +38,21 @@ export function maybeShowTelemetryNotice(dataDir) {
   try {
     const markerPath = join(dataDir, NOTICE_MARKER);
     if (existsSync(markerPath)) return;
-    writeFileSync(markerPath, new Date().toISOString() + "\n");
+    writeFileSync(markerPath, new Date().toISOString() + '\n');
   } catch {
     return;
   }
 
   const lines = [
-    "[context-vault] Telemetry: disabled by default.",
-    "[context-vault] To help improve context-vault, you can opt in to anonymous error reporting.",
-    "[context-vault] Reports contain only: event type, error code, tool name, version, node version, platform, arch, timestamp.",
-    "[context-vault] No vault content, file paths, or personal data is ever sent.",
+    '[context-vault] Telemetry: disabled by default.',
+    '[context-vault] To help improve context-vault, you can opt in to anonymous error reporting.',
+    '[context-vault] Reports contain only: event type, error code, tool name, version, node version, platform, arch, timestamp.',
+    '[context-vault] No vault content, file paths, or personal data is ever sent.',
     '[context-vault] Opt in: set "telemetry": true in ~/.context-mcp/config.json or set CONTEXT_VAULT_TELEMETRY=1.',
     `[context-vault] Full payload schema: ${MARKETING_URL}/telemetry`,
   ];
   for (const line of lines) {
-    process.stderr.write(line + "\n");
+    process.stderr.write(line + '\n');
   }
 }
 
@@ -64,17 +60,17 @@ export function maybeShowFeedbackPrompt(dataDir) {
   try {
     const markerPath = join(dataDir, FEEDBACK_PROMPT_MARKER);
     if (existsSync(markerPath)) return;
-    writeFileSync(markerPath, new Date().toISOString() + "\n");
+    writeFileSync(markerPath, new Date().toISOString() + '\n');
   } catch {
     return;
   }
 
   const lines = [
-    "[context-vault] First entry saved — nice work!",
-    "[context-vault] Got feedback, a bug, or a feature request?",
+    '[context-vault] First entry saved — nice work!',
+    '[context-vault] Got feedback, a bug, or a feature request?',
     `[context-vault] Open an issue: ${GITHUB_ISSUES_URL}`,
   ];
   for (const line of lines) {
-    process.stderr.write(line + "\n");
+    process.stderr.write(line + '\n');
   }
 }

package/src/temporal.js

@@ -7,12 +7,12 @@ function startOfToday(now) {
 }
 
 export function resolveTemporalShortcut(role, value, now = new Date()) {
-  if (!value || typeof value !== "string") return value;
-  const trimmed = value.trim().toLowerCase().replace(/\s+/g, "_");
+  if (!value || typeof value !== 'string') return value;
+  const trimmed = value.trim().toLowerCase().replace(/\s+/g, '_');
 
-  if (trimmed === "today") {
+  if (trimmed === 'today') {
     const start = startOfToday(now);
-    if (role === "until") {
+    if (role === 'until') {
       const end = new Date(start);
       end.setUTCDate(end.getUTCDate() + 1);
       return end.toISOString();
@@ -20,42 +20,40 @@ export function resolveTemporalShortcut(role, value, now = new Date()) {
     return start.toISOString();
   }
 
-  if (trimmed === "yesterday") {
+  if (trimmed === 'yesterday') {
     const todayStart = startOfToday(now);
     const yesterdayStart = new Date(todayStart);
     yesterdayStart.setUTCDate(yesterdayStart.getUTCDate() - 1);
-    if (role === "since") return yesterdayStart.toISOString();
+    if (role === 'since') return yesterdayStart.toISOString();
     return todayStart.toISOString();
   }
 
-  if (trimmed === "this_week") {
+  if (trimmed === 'this_week') {
     const todayStart = startOfToday(now);
     const dayOfWeek = todayStart.getUTCDay();
     const daysFromMonday = (dayOfWeek + 6) % 7;
     const monday = new Date(todayStart);
     monday.setUTCDate(monday.getUTCDate() - daysFromMonday);
-    if (role === "since") return monday.toISOString();
+    if (role === 'since') return monday.toISOString();
     const endOfToday = new Date(todayStart);
     endOfToday.setUTCDate(endOfToday.getUTCDate() + 1);
     return endOfToday.toISOString();
   }
 
-  if (trimmed === "this_month") {
+  if (trimmed === 'this_month') {
     const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1));
-    if (role === "since") return d.toISOString();
-    const endOfMonth = new Date(
-      Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1),
-    );
+    if (role === 'since') return d.toISOString();
+    const endOfMonth = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1));
     return endOfMonth.toISOString();
   }
 
   const m = SHORTCUT_RE.exec(trimmed);
   if (m) {
     const n = parseInt(m[1], 10);
-    const unit = m[2].replace(/s$/, "");
+    const unit = m[2].replace(/s$/, '');
     let ms;
-    if (unit === "day") ms = n * 86400000;
-    else if (unit === "week") ms = n * 7 * 86400000;
+    if (unit === 'day') ms = n * 86400000;
+    else if (unit === 'week') ms = n * 7 * 86400000;
     else ms = n * 30 * 86400000;
     const target = new Date(now.getTime() - ms);
     target.setUTCHours(0, 0, 0, 0);
@@ -68,23 +66,14 @@ export function resolveTemporalShortcut(role, value, now = new Date()) {
 export function resolveTemporalParams(params, now = new Date()) {
   let { since, until } = params;
 
-  if (
-    since?.trim().toLowerCase() === "yesterday" &&
-    (until === undefined || until === null)
-  ) {
-    since = resolveTemporalShortcut("since", since, now);
-    until = resolveTemporalShortcut("until", "yesterday", now);
+  if (since?.trim().toLowerCase() === 'yesterday' && (until === undefined || until === null)) {
+    since = resolveTemporalShortcut('since', since, now);
+    until = resolveTemporalShortcut('until', 'yesterday', now);
     return { since, until };
   }
 
   return {
-    since:
-      since !== undefined
-        ? resolveTemporalShortcut("since", since, now)
-        : since,
-    until:
-      until !== undefined
-        ? resolveTemporalShortcut("until", until, now)
-        : until,
+    since: since !== undefined ? resolveTemporalShortcut('since', since, now) : since,
+    until: until !== undefined ? resolveTemporalShortcut('until', until, now) : until,
   };
 }

package/src/tools/clear-context.js

@@ -1,17 +1,17 @@
-import { z } from "zod";
-import { ok } from "../helpers.js";
+import { z } from 'zod';
+import { ok } from '../helpers.js';
 
-export const name = "clear_context";
+export const name = 'clear_context';
 
 export const description =
-  "Reset active in-memory session context without deleting vault entries. Call this when switching projects or topics mid-session. With `scope`, all subsequent get_context calls should filter to that tag/project. Vault data is never modified.";
+  'Reset active in-memory session context without deleting vault entries. Call this when switching projects or topics mid-session. With `scope`, all subsequent get_context calls should filter to that tag/project. Vault data is never modified.';
 
 export const inputSchema = {
   scope: z
     .string()
     .optional()
     .describe(
-      "Optional tag or project name to focus on going forward. When provided, treat subsequent get_context calls as if filtered to this tag.",
+      'Optional tag or project name to focus on going forward. When provided, treat subsequent get_context calls as if filtered to this tag.'
     ),
 };
 
@@ -21,27 +21,24 @@ export const inputSchema = {
  */
 export function handler({ scope } = {}) {
   const lines = [
-    "## Context Reset",
-    "",
-    "Active session context has been cleared. All previous context from this session should be disregarded.",
-    "",
-    "Vault entries are unchanged — no data was deleted.",
+    '## Context Reset',
+    '',
+    'Active session context has been cleared. All previous context from this session should be disregarded.',
+    '',
+    'Vault entries are unchanged — no data was deleted.',
   ];
 
   if (scope?.trim()) {
     const trimmed = scope.trim();
     lines.push(
-      "",
+      '',
       `### Active Scope: \`${trimmed}\``,
-      "",
-      `Going forward, treat \`get_context\` calls as scoped to the tag or project **"${trimmed}"** unless the user explicitly requests a different scope or passes their own tag filters.`,
+      '',
+      `Going forward, treat \`get_context\` calls as scoped to the tag or project **"${trimmed}"** unless the user explicitly requests a different scope or passes their own tag filters.`
     );
   } else {
-    lines.push(
-      "",
-      "No scope set. Use `get_context` normally — all vault entries are accessible.",
-    );
+    lines.push('', 'No scope set. Use `get_context` normally — all vault entries are accessible.');
   }
 
-  return ok(lines.join("\n"));
+  return ok(lines.join('\n'));
 }