context-vault 3.1.6 → 3.1.7

package/src/tools/list-context.js

@@ -1,40 +1,22 @@
-import { z } from "zod";
-import { normalizeKind } from "@context-vault/core/files";
-import { categoryFor } from "@context-vault/core/categories";
-import { ok, err, errWithHint } from "../helpers.js";
-import { resolveTemporalParams } from "../temporal.js";
+import { z } from 'zod';
+import { normalizeKind } from '@context-vault/core/files';
+import { categoryFor } from '@context-vault/core/categories';
+import { ok, err, errWithHint } from '../helpers.js';
+import { resolveTemporalParams } from '../temporal.js';
 
-export const name = "list_context";
+export const name = 'list_context';
 
 export const description =
-  "Browse vault entries without a search query. Returns id, title, kind, category, tags, created_at, updated_at. Use get_context with a query for semantic search. Use this to browse by tags or find recent entries.";
+  'Browse vault entries without a search query. Returns id, title, kind, category, tags, created_at, updated_at. Use get_context with a query for semantic search. Use this to browse by tags or find recent entries.';
 
 export const inputSchema = {
-  kind: z
-    .string()
-    .optional()
-    .describe("Filter by kind (e.g. 'insight', 'decision', 'pattern')"),
-  category: z
-    .enum(["knowledge", "entity", "event"])
-    .optional()
-    .describe("Filter by category"),
-  tags: z
-    .array(z.string())
-    .optional()
-    .describe("Filter by tags (entries must match at least one)"),
-  since: z
-    .string()
-    .optional()
-    .describe("ISO date, return entries created after this"),
-  until: z
-    .string()
-    .optional()
-    .describe("ISO date, return entries created before this"),
-  limit: z
-    .number()
-    .optional()
-    .describe("Max results to return (default 20, max 100)"),
-  offset: z.number().optional().describe("Skip first N results for pagination"),
+  kind: z.string().optional().describe("Filter by kind (e.g. 'insight', 'decision', 'pattern')"),
+  category: z.enum(['knowledge', 'entity', 'event']).optional().describe('Filter by category'),
+  tags: z.array(z.string()).optional().describe('Filter by tags (entries must match at least one)'),
+  since: z.string().optional().describe('ISO date, return entries created after this'),
+  until: z.string().optional().describe('ISO date, return entries created before this'),
+  limit: z.number().optional().describe('Max results to return (default 20, max 100)'),
+  offset: z.number().optional().describe('Skip first N results for pagination'),
 };
 
 /**
@@ -45,7 +27,7 @@ export const inputSchema = {
 export async function handler(
   { kind, category, tags, since, until, limit, offset },
   ctx,
-  { ensureIndexed, reindexFailed },
+  { ensureIndexed, reindexFailed }
 ) {
   const { config } = ctx;
 
@@ -56,11 +38,10 @@ export async function handler(
   until = resolved.until;
 
   const kindFilter = kind ? normalizeKind(kind) : null;
-  const effectiveCategory =
-    category || (kindFilter ? categoryFor(kindFilter) : null);
+  const effectiveCategory = category || (kindFilter ? categoryFor(kindFilter) : null);
   let effectiveSince = since || null;
   let autoWindowed = false;
-  if (effectiveCategory === "event" && !since && !until) {
+  if (effectiveCategory === 'event' && !since && !until) {
     const decayMs = (config.eventDecayDays || 30) * 86400000;
     effectiveSince = new Date(Date.now() - decayMs).toISOString();
     autoWindowed = true;
@@ -70,24 +51,24 @@ export async function handler(
   const params = [];
 
   if (kindFilter) {
-    clauses.push("kind = ?");
+    clauses.push('kind = ?');
     params.push(kindFilter);
   }
   if (category) {
-    clauses.push("category = ?");
+    clauses.push('category = ?');
     params.push(category);
   }
   if (effectiveSince) {
-    clauses.push("created_at >= ?");
+    clauses.push('created_at >= ?');
     params.push(effectiveSince);
   }
   if (until) {
-    clauses.push("created_at <= ?");
+    clauses.push('created_at <= ?');
     params.push(until);
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
 
-  const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+  const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
   const effectiveLimit = Math.min(limit || 20, 100);
   const effectiveOffset = offset || 0;
   // When tag-filtering, over-fetch to compensate for post-filter reduction
@@ -97,21 +78,19 @@ export async function handler(
   let total;
   let rows;
   try {
-    total = ctx.db
-      .prepare(`SELECT COUNT(*) as c FROM vault ${where}`)
-      .get(...countParams).c;
+    total = ctx.db.prepare(`SELECT COUNT(*) as c FROM vault ${where}`).get(...countParams).c;
 
     params.push(fetchLimit, effectiveOffset);
     rows = ctx.db
       .prepare(
-        `SELECT id, title, kind, category, tags, created_at, updated_at, SUBSTR(body, 1, 120) as preview FROM vault ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+        `SELECT id, title, kind, category, tags, created_at, updated_at, SUBSTR(body, 1, 120) as preview FROM vault ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`
       )
       .all(...params);
   } catch (e) {
     return errWithHint(
       e.message,
-      "DB_ERROR",
-      "context-vault list_context DB_ERROR. Check `cat ~/.context-mcp/error.log | tail -5` and help me debug.",
+      'DB_ERROR',
+      'context-vault list_context DB_ERROR. Check `cat ~/.context-mcp/error.log | tail -5` and help me debug.'
     );
   }
 
@@ -129,45 +108,43 @@ export async function handler(
     if (autoWindowed) {
       const days = config.eventDecayDays || 30;
       return ok(
-        `No entries found matching the given filters in events (last ${days} days).\nTry with \`since: "YYYY-MM-DD"\` to search older events.`,
+        `No entries found matching the given filters in events (last ${days} days).\nTry with \`since: "YYYY-MM-DD"\` to search older events.`
       );
     }
-    return ok("No entries found matching the given filters.");
+    return ok('No entries found matching the given filters.');
   }
 
   const lines = [];
   if (reindexFailed)
     lines.push(
-      `> **Warning:** Auto-reindex failed. Results may be stale. Run \`context-vault reindex\` to fix.\n`,
+      `> **Warning:** Auto-reindex failed. Results may be stale. Run \`context-vault reindex\` to fix.\n`
     );
   lines.push(`## Vault Entries (${filtered.length} shown, ${total} total)\n`);
   if (autoWindowed) {
     const days = config.eventDecayDays || 30;
     lines.push(
-      `> ℹ Event search limited to last ${days} days. Use \`since\` parameter for older results.\n`,
+      `> ℹ Event search limited to last ${days} days. Use \`since\` parameter for older results.\n`
     );
   }
   for (const r of filtered) {
     const entryTags = r.tags ? JSON.parse(r.tags) : [];
-    const tagStr = entryTags.length ? entryTags.join(", ") : "none";
+    const tagStr = entryTags.length ? entryTags.join(', ') : 'none';
     const dateStr =
       r.updated_at && r.updated_at !== r.created_at
         ? `${r.created_at} (updated ${r.updated_at})`
         : r.created_at;
     lines.push(
-      `- **${r.title || "(untitled)"}** [${r.kind}/${r.category}] — ${tagStr} — ${dateStr} — \`${r.id}\``,
+      `- **${r.title || '(untitled)'}** [${r.kind}/${r.category}] — ${tagStr} — ${dateStr} — \`${r.id}\``
     );
     if (r.preview)
-      lines.push(
-        `  ${r.preview.replace(/\n+/g, " ").trim()}${r.preview.length >= 120 ? "…" : ""}`,
-      );
+      lines.push(`  ${r.preview.replace(/\n+/g, ' ').trim()}${r.preview.length >= 120 ? '…' : ''}`);
   }
 
   if (effectiveOffset + effectiveLimit < total) {
     lines.push(
-      `\n_Page ${Math.floor(effectiveOffset / effectiveLimit) + 1}. Use offset: ${effectiveOffset + effectiveLimit} for next page._`,
+      `\n_Page ${Math.floor(effectiveOffset / effectiveLimit) + 1}. Use offset: ${effectiveOffset + effectiveLimit} for next page._`
     );
   }
 
-  return ok(lines.join("\n"));
+  return ok(lines.join('\n'));
 }