context-vault 3.1.6 → 3.1.8

package/src/{status.js → status.ts}

@@ -1,11 +1,13 @@
-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';
+import type { LocalCtx } from './types.js';
+import type { GrowthThresholds } from '@context-vault/core/types';
 
-function countArchivedEntries(vaultDir) {
-  const archRoot = join(vaultDir, "_archive");
+function countArchivedEntries(vaultDir: string): number {
+  const archRoot = join(vaultDir, '_archive');
   if (!existsSync(archRoot)) return 0;
   try {
     return walkDir(archRoot).length;
@@ -14,12 +16,13 @@ function countArchivedEntries(vaultDir) {
   }
 }
 
-export function gatherVaultStatus(ctx, opts = {}) {
+export function gatherVaultStatus(ctx: LocalCtx, opts: Record<string, unknown> = {}): any {
+  void opts;
   const { db, config } = ctx;
-  const errors = [];
+  const errors: string[] = [];
 
   let fileCount = 0;
-  const subdirs = [];
+  const subdirs: Array<{ name: string; count: number }> = [];
   try {
     if (existsSync(config.vaultDir)) {
       for (const d of readdirSync(config.vaultDir, { withFileTypes: true })) {
@@ -32,28 +35,26 @@ export function gatherVaultStatus(ctx, opts = {}) {
       }
     }
   } catch (e) {
-    errors.push(`File scan failed: ${e.message}`);
+    errors.push(`File scan failed: ${(e as Error).message}`);
   }
 
-  let kindCounts = [];
+  let kindCounts: unknown[] = [];
   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}`);
+    errors.push(`Kind count query failed: ${(e as Error).message}`);
   }
 
-  let categoryCounts = [];
+  let categoryCounts: unknown[] = [];
   try {
     categoryCounts = db
       .prepare(`SELECT category, COUNT(*) as c FROM vault GROUP BY category`)
       .all();
   } catch (e) {
-    errors.push(`Category count query failed: ${e.message}`);
+    errors.push(`Category count query failed: ${(e as Error).message}`);
   }
 
-  let dbSize = "n/a";
+  let dbSize = 'n/a';
   let dbSizeBytes = 0;
   try {
     if (existsSync(config.dbPath)) {
@@ -64,105 +65,107 @@ export function gatherVaultStatus(ctx, opts = {}) {
           : `${(dbSizeBytes / 1024).toFixed(1)}KB`;
     }
   } catch (e) {
-    errors.push(`DB size check failed: ${e.message}`);
+    errors.push(`DB size check failed: ${(e as Error).message}`);
   }
 
   let stalePaths = false;
   let staleCount = 0;
   try {
     const result = db
-      .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE file_path NOT LIKE ? || '%'`,
-      )
-      .get(config.vaultDir);
-    staleCount = result.c;
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE file_path NOT LIKE ? || '%'`)
+      .get(config.vaultDir) as { c: number } | undefined;
+    staleCount = result?.c ?? 0;
     stalePaths = staleCount > 0;
   } catch (e) {
-    errors.push(`Stale path check failed: ${e.message}`);
+    errors.push(`Stale path check failed: ${(e as Error).message}`);
   }
 
   let expiredCount = 0;
   try {
-    expiredCount = db
+    const row = 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;
+      .get() as { c: number } | undefined;
+    expiredCount = row?.c ?? 0;
   } catch (e) {
-    errors.push(`Expired count failed: ${e.message}`);
+    errors.push(`Expired count failed: ${(e as Error).message}`);
   }
 
   let eventCount = 0;
   try {
-    eventCount = db
-      .prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event'`)
-      .get().c;
+    const row = db.prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event'`).get() as
+      | { c: number }
+      | undefined;
+    eventCount = row?.c ?? 0;
   } catch (e) {
-    errors.push(`Event count failed: ${e.message}`);
+    errors.push(`Event count failed: ${(e as Error).message}`);
   }
 
   let eventsWithoutTtlCount = 0;
   try {
-    eventsWithoutTtlCount = db
-      .prepare(
-        `SELECT COUNT(*) as c FROM vault WHERE category = 'event' AND expires_at IS NULL`,
-      )
-      .get().c;
+    const row = db
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE category = 'event' AND expires_at IS NULL`)
+      .get() as { c: number } | undefined;
+    eventsWithoutTtlCount = row?.c ?? 0;
   } catch (e) {
-    errors.push(`Events without TTL count failed: ${e.message}`);
+    errors.push(`Events without TTL count failed: ${(e as Error).message}`);
   }
 
-  let embeddingStatus = null;
+  let embeddingStatus: { indexed: number; total: number; missing: number } | null = null;
   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)`,
-      )
-      .get().c;
+    const totalRow = db.prepare(`SELECT COUNT(*) as c FROM vault`).get() as
+      | { c: number }
+      | undefined;
+    const indexedRow = db
+      .prepare(`SELECT COUNT(*) as c FROM vault WHERE rowid IN (SELECT rowid FROM vault_vec)`)
+      .get() as { c: number } | undefined;
+    const total = totalRow?.c ?? 0;
+    const indexed = indexedRow?.c ?? 0;
     embeddingStatus = { indexed, total, missing: total - indexed };
   } catch (e) {
-    errors.push(`Embedding status check failed: ${e.message}`);
+    errors.push(`Embedding status check failed: ${(e as Error).message}`);
   }
 
   const embedModelAvailable = isEmbedAvailable();
 
   let autoCapturedFeedbackCount = 0;
   try {
-    autoCapturedFeedbackCount = db
+    const row = 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;
+      .get() as { c: number } | undefined;
+    autoCapturedFeedbackCount = row?.c ?? 0;
   } catch (e) {
-    errors.push(`Auto-captured feedback count failed: ${e.message}`);
+    errors.push(`Auto-captured feedback count failed: ${(e as Error).message}`);
   }
 
   let archivedCount = 0;
   try {
     archivedCount = countArchivedEntries(config.vaultDir);
   } catch (e) {
-    errors.push(`Archived count failed: ${e.message}`);
+    errors.push(`Archived count failed: ${(e as Error).message}`);
   }
 
-  let staleKnowledge = [];
+  let staleKnowledge: unknown[] = [];
   try {
     const stalenessKinds = Object.entries(KIND_STALENESS_DAYS);
     if (stalenessKinds.length > 0) {
       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();
     }
   } catch (e) {
-    errors.push(`Stale knowledge check failed: ${e.message}`);
+    errors.push(`Stale knowledge check failed: ${(e as Error).message}`);
   }
 
   return {
@@ -187,7 +190,16 @@ export function gatherVaultStatus(ctx, opts = {}) {
   };
 }
 
-export function computeGrowthWarnings(status, thresholds) {
+export function computeGrowthWarnings(
+  status: Record<string, any>,
+  thresholds: GrowthThresholds | null | undefined
+): {
+  warnings: Array<{ level: string; message: string }>;
+  hasCritical: boolean;
+  hasWarnings: boolean;
+  actions: string[];
+  kindBreakdown: Array<{ kind: string; count: number; pct: number }>;
+} {
   if (!thresholds)
     return {
       warnings: [],
@@ -198,88 +210,66 @@ export function computeGrowthWarnings(status, thresholds) {
     };
 
   const t = thresholds;
-  const warnings = [];
-  const actions = [];
+  const warnings: Array<{ level: string; message: string }> = [];
+  const actions: string[] = [];
 
-  const total = status.embeddingStatus?.total ?? 0;
-  const {
-    eventCount = 0,
-    eventsWithoutTtlCount = 0,
-    expiredCount = 0,
-    dbSizeBytes = 0,
-  } = status;
+  const total: number = status.embeddingStatus?.total ?? 0;
+  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,19 +277,15 @@ 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 =
+  const kindBreakdown: Array<{ kind: string; count: number; pct: number }> =
     totalExceeded && status.kindCounts?.length
-      ? [...status.kindCounts]
+      ? [...(status.kindCounts as Array<{ kind: string; c: number }>)]
           .sort((a, b) => b.c - a.c)
           .map(({ kind, c }) => ({
             kind,

package/src/telemetry.ts

@@ -0,0 +1,80 @@
+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 type { VaultConfig } from '@context-vault/core/types';
+
+const TELEMETRY_ENDPOINT = `${API_URL}/telemetry`;
+const NOTICE_MARKER = '.telemetry-notice-shown';
+const FEEDBACK_PROMPT_MARKER = '.feedback-prompt-shown';
+
+export function isTelemetryEnabled(config: VaultConfig | null | undefined): boolean {
+  const envVal = process.env.CONTEXT_VAULT_TELEMETRY;
+  if (envVal !== undefined) return envVal === '1' || envVal === 'true';
+  return config?.telemetry === true;
+}
+
+export function sendTelemetryEvent(
+  config: VaultConfig | null | undefined,
+  payload: Record<string, unknown>
+): void {
+  if (!isTelemetryEnabled(config)) return;
+
+  const event = {
+    event: payload.event,
+    code: payload.code || null,
+    tool: payload.tool || null,
+    cv_version: payload.cv_version,
+    node_version: process.version,
+    platform: process.platform,
+    arch: process.arch,
+    ts: new Date().toISOString(),
+  };
+
+  fetch(TELEMETRY_ENDPOINT, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(event),
+    signal: AbortSignal.timeout(5000),
+  }).catch(() => {});
+}
+
+export function maybeShowTelemetryNotice(dataDir: string): void {
+  try {
+    const markerPath = join(dataDir, NOTICE_MARKER);
+    if (existsSync(markerPath)) return;
+    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] 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');
+  }
+}
+
+export function maybeShowFeedbackPrompt(dataDir: string): void {
+  try {
+    const markerPath = join(dataDir, FEEDBACK_PROMPT_MARKER);
+    if (existsSync(markerPath)) return;
+    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] Open an issue: ${GITHUB_ISSUES_URL}`,
+  ];
+  for (const line of lines) {
+    process.stderr.write(line + '\n');
+  }
+}

package/src/{temporal.js → temporal.ts}

@@ -1,18 +1,22 @@
 const SHORTCUT_RE = /^last[_ ](\d+)[_ ](day|days|week|weeks|month|months)$/i;
 
-function startOfToday(now) {
+function startOfToday(now: Date): Date {
   const d = new Date(now);
   d.setUTCHours(0, 0, 0, 0);
   return d;
 }
 
-export function resolveTemporalShortcut(role, value, now = new Date()) {
-  if (!value || typeof value !== "string") return value;
-  const trimmed = value.trim().toLowerCase().replace(/\s+/g, "_");
+export function resolveTemporalShortcut(
+  role: 'since' | 'until',
+  value: string,
+  now: Date = new Date()
+): string {
+  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 +24,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);
@@ -65,26 +67,20 @@ export function resolveTemporalShortcut(role, value, now = new Date()) {
   return value;
 }
 
-export function resolveTemporalParams(params, now = new Date()) {
+export function resolveTemporalParams(
+  params: { since?: string; until?: string },
+  now: Date = new Date()
+): { since?: string; until?: string } {
   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.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { ok } from '../helpers.js';
+import type { ToolResult } from '../types.js';
+
+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.';
+
+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.'
+    ),
+};
+
+export function handler({ scope }: { scope?: string } = {}): ToolResult {
+  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.',
+  ];
+
+  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.`
+    );
+  } else {
+    lines.push('', 'No scope set. Use `get_context` normally — all vault entries are accessible.');
+  }
+
+  return ok(lines.join('\n'));
+}