context-vault 3.1.6 → 3.1.7

package/src/tools/session-start.js

@@ -1,45 +1,43 @@
-import { z } from "zod";
-import { execSync } from "node:child_process";
-import { ok, err, ensureVaultExists } from "../helpers.js";
+import { z } from 'zod';
+import { execSync } from 'node:child_process';
+import { ok, err, ensureVaultExists } from '../helpers.js';
 
 const DEFAULT_MAX_TOKENS = 4000;
 const RECENT_DAYS = 7;
 const MAX_BODY_PER_ENTRY = 400;
-const PRIORITY_KINDS = ["decision", "insight", "pattern"];
-const SESSION_SUMMARY_KIND = "session";
+const PRIORITY_KINDS = ['decision', 'insight', 'pattern'];
+const SESSION_SUMMARY_KIND = 'session';
 
-export const name = "session_start";
+export const name = 'session_start';
 
 export const description =
-  "Auto-assemble a context brief for the current project on session start. Pulls recent entries, last session summary, and active decisions/blockers into a token-budgeted capsule formatted for agent consumption.";
+  'Auto-assemble a context brief for the current project on session start. Pulls recent entries, last session summary, and active decisions/blockers into a token-budgeted capsule formatted for agent consumption.';
 
 export const inputSchema = {
   project: z
     .string()
     .optional()
     .describe(
-      "Project name or tag to scope the brief. Auto-detected from cwd/git remote if not provided.",
+      'Project name or tag to scope the brief. Auto-detected from cwd/git remote if not provided.'
     ),
   max_tokens: z
     .number()
     .optional()
-    .describe(
-      "Token budget for the capsule (rough estimate: 1 token ~ 4 chars). Default: 4000.",
-    ),
+    .describe('Token budget for the capsule (rough estimate: 1 token ~ 4 chars). Default: 4000.'),
   buckets: z
     .array(z.string())
     .optional()
     .describe(
-      "Bucket names to scope the session brief. Each name expands to a 'bucket:<name>' tag filter. When provided, the brief only includes entries from these buckets.",
+      "Bucket names to scope the session brief. Each name expands to a 'bucket:<name>' tag filter. When provided, the brief only includes entries from these buckets."
     ),
 };
 
 function detectProject() {
   try {
-    const remote = execSync("git remote get-url origin 2>/dev/null", {
-      encoding: "utf-8",
+    const remote = execSync('git remote get-url origin 2>/dev/null', {
+      encoding: 'utf-8',
       timeout: 3000,
-      stdio: ["pipe", "pipe", "pipe"],
+      stdio: ['pipe', 'pipe', 'pipe'],
     }).trim();
     if (remote) {
       const match = remote.match(/\/([^/]+?)(?:\.git)?$/);
@@ -57,31 +55,27 @@ function detectProject() {
 }
 
 function truncateBody(body, maxLen = MAX_BODY_PER_ENTRY) {
-  if (!body) return "(no body)";
+  if (!body) return '(no body)';
   if (body.length <= maxLen) return body;
-  return body.slice(0, maxLen) + "...";
+  return body.slice(0, maxLen) + '...';
 }
 
 function estimateTokens(text) {
-  return Math.ceil((text || "").length / 4);
+  return Math.ceil((text || '').length / 4);
 }
 
 function formatEntry(entry) {
   const tags = entry.tags ? JSON.parse(entry.tags) : [];
-  const tagStr = tags.length ? tags.join(", ") : "none";
-  const date = entry.updated_at || entry.created_at || "unknown";
+  const tagStr = tags.length ? tags.join(', ') : 'none';
+  const date = entry.updated_at || entry.created_at || 'unknown';
   return [
-    `- **${entry.title || "(untitled)"}** [${entry.kind}]`,
+    `- **${entry.title || '(untitled)'}** [${entry.kind}]`,
     `  tags: ${tagStr} | ${date} | id: \`${entry.id}\``,
-    `  ${truncateBody(entry.body).replace(/\n+/g, " ").trim()}`,
-  ].join("\n");
+    `  ${truncateBody(entry.body).replace(/\n+/g, ' ').trim()}`,
+  ].join('\n');
 }
 
-export async function handler(
-  { project, max_tokens, buckets },
-  ctx,
-  { ensureIndexed },
-) {
+export async function handler({ project, max_tokens, buckets }, ctx, { ensureIndexed }) {
   const { config } = ctx;
 
   const vaultErr = ensureVaultExists(config);
@@ -93,35 +87,25 @@ export async function handler(
   const tokenBudget = max_tokens || DEFAULT_MAX_TOKENS;
 
   const bucketTags = buckets?.length ? buckets.map((b) => `bucket:${b}`) : [];
-  const effectiveTags = bucketTags.length
-    ? bucketTags
-    : effectiveProject
-      ? [effectiveProject]
-      : [];
+  const effectiveTags = bucketTags.length ? bucketTags : effectiveProject ? [effectiveProject] : [];
 
   const sinceDate = new Date(Date.now() - RECENT_DAYS * 86400000).toISOString();
 
   const sections = [];
   let tokensUsed = 0;
 
+  sections.push(`# Session Brief${effectiveProject ? ` — ${effectiveProject}` : ''}`);
+  const bucketsLabel = buckets?.length ? ` | buckets: ${buckets.join(', ')}` : '';
   sections.push(
-    `# Session Brief${effectiveProject ? ` — ${effectiveProject}` : ""}`,
-  );
-  const bucketsLabel = buckets?.length
-    ? ` | buckets: ${buckets.join(", ")}`
-    : "";
-  sections.push(
-    `_Generated ${new Date().toISOString().slice(0, 10)} | budget: ${tokenBudget} tokens${bucketsLabel}_\n`,
+    `_Generated ${new Date().toISOString().slice(0, 10)} | budget: ${tokenBudget} tokens${bucketsLabel}_\n`
   );
-  tokensUsed += estimateTokens(sections.join("\n"));
+  tokensUsed += estimateTokens(sections.join('\n'));
 
   const lastSession = queryLastSession(ctx, effectiveTags);
   if (lastSession) {
-    const sessionBlock = [
-      "## Last Session Summary",
-      truncateBody(lastSession.body, 600),
-      "",
-    ].join("\n");
+    const sessionBlock = ['## Last Session Summary', truncateBody(lastSession.body, 600), ''].join(
+      '\n'
+    );
     const sessionTokens = estimateTokens(sessionBlock);
     if (tokensUsed + sessionTokens <= tokenBudget) {
       sections.push(sessionBlock);
@@ -134,10 +118,10 @@ export async function handler(
     PRIORITY_KINDS,
     sinceDate,
 
-    effectiveTags,
+    effectiveTags
   );
   if (decisions.length > 0) {
-    const header = "## Active Decisions, Insights & Patterns\n";
+    const header = '## Active Decisions, Insights & Patterns\n';
     const headerTokens = estimateTokens(header);
     if (tokensUsed + headerTokens <= tokenBudget) {
       const entryLines = [];
@@ -150,7 +134,7 @@ export async function handler(
         tokensUsed += lineTokens;
       }
       if (entryLines.length > 0) {
-        sections.push(header + entryLines.join("\n") + "\n");
+        sections.push(header + entryLines.join('\n') + '\n');
       }
     }
   }
@@ -174,7 +158,7 @@ export async function handler(
         tokensUsed += lineTokens;
       }
       if (entryLines.length > 0) {
-        sections.push(header + entryLines.join("\n") + "\n");
+        sections.push(header + entryLines.join('\n') + '\n');
       }
     }
   }
@@ -187,12 +171,12 @@ export async function handler(
       return true;
     }).length;
 
-  sections.push("---");
+  sections.push('---');
   sections.push(
-    `_${tokensUsed} / ${tokenBudget} tokens used | project: ${effectiveProject || "unscoped"}_`,
+    `_${tokensUsed} / ${tokenBudget} tokens used | project: ${effectiveProject || 'unscoped'}_`
   );
 
-  const result = ok(sections.join("\n"));
+  const result = ok(sections.join('\n'));
   result._meta = {
     project: effectiveProject || null,
     buckets: buckets || null,
@@ -214,9 +198,9 @@ function queryLastSession(ctx, effectiveTags) {
   if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
-  clauses.push("superseded_by IS NULL");
+  clauses.push('superseded_by IS NULL');
 
-  const where = `WHERE ${clauses.join(" AND ")}`;
+  const where = `WHERE ${clauses.join(' AND ')}`;
   const rows = ctx.db
     .prepare(`SELECT * FROM vault ${where} ORDER BY created_at DESC LIMIT 5`)
     .all(...params);
@@ -232,19 +216,19 @@ function queryLastSession(ctx, effectiveTags) {
 }
 
 function queryByKinds(ctx, kinds, since, effectiveTags) {
-  const kindPlaceholders = kinds.map(() => "?").join(",");
+  const kindPlaceholders = kinds.map(() => '?').join(',');
   const clauses = [`kind IN (${kindPlaceholders})`];
   const params = [...kinds];
 
-  clauses.push("created_at >= ?");
+  clauses.push('created_at >= ?');
   params.push(since);
 
   if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
-  clauses.push("superseded_by IS NULL");
+  clauses.push('superseded_by IS NULL');
 
-  const where = `WHERE ${clauses.join(" AND ")}`;
+  const where = `WHERE ${clauses.join(' AND ')}`;
   const rows = ctx.db
     .prepare(`SELECT * FROM vault ${where} ORDER BY created_at DESC LIMIT 50`)
     .all(...params);
@@ -260,15 +244,15 @@ function queryByKinds(ctx, kinds, since, effectiveTags) {
 }
 
 function queryRecent(ctx, since, effectiveTags) {
-  const clauses = ["created_at >= ?"];
+  const clauses = ['created_at >= ?'];
   const params = [since];
 
   if (false) {
   }
   clauses.push("(expires_at IS NULL OR expires_at > datetime('now'))");
-  clauses.push("superseded_by IS NULL");
+  clauses.push('superseded_by IS NULL');
 
-  const where = `WHERE ${clauses.join(" AND ")}`;
+  const where = `WHERE ${clauses.join(' AND ')}`;
   const rows = ctx.db
     .prepare(`SELECT * FROM vault ${where} ORDER BY created_at DESC LIMIT 50`)
     .all(...params);