@theglitchking/semantic-memory 1.1.1 → 1.2.1

package/hooks/vault-context.js

@@ -12,7 +12,7 @@
 
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join, resolve, basename } from "node:path";
+import { join, resolve, basename, dirname } from "node:path";
 import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
 
@@ -172,27 +172,74 @@ function sessionSeedQuery(projectRoot) {
   return parts.join(" ");
 }
 
+// State file path resolution (Phase 1, v1.2):
+//
+// Each transient state file has TWO paths during the v1.x deprecation window:
+//   - new path (canonical, written by all v1.2+ writers): .claude/.semantic-memory/<file>
+//   - old path (legacy, still readable for backwards compat): .claude/.sidekick-<file>
+//
+// Reads check the new path first; if absent, fall back to old. Writes always go to
+// the new path. This means: as soon as ANY write happens for a given state file, the
+// new path takes over and the old path becomes a relic. The explicit
+// `bin/semantic-memory migrate-state` command does the move in one shot for users
+// who want the legacy files cleaned up immediately.
+//
+// In v2.0, the legacy fallback read is removed. Users have all of v1.x to migrate.
+const STATE_FILES = {
+  mode: { new: [".semantic-memory", "mode"], old: [".sidekick-mode"] },
+  fingerprints: { new: [".semantic-memory", "fingerprints.json"], old: [".sidekick-fingerprints.json"] },
+  "capture-pending": { new: [".semantic-memory", "capture-pending.json"], old: [".sidekick-capture-pending.json"] },
+};
+
+/**
+ * Resolve the read and write paths for a named state file.
+ * Returns { newPath, oldPath, resolvedRead, writePath }.
+ *  - resolvedRead is newPath if it exists, else oldPath (for backwards-compat reads)
+ *  - writePath is always newPath (writes always go to the new location)
+ */
+function statePath(projectRoot, name) {
+  const entry = STATE_FILES[name];
+  if (!entry) throw new Error(`unknown state file: ${name}`);
+  const newPath = join(projectRoot, ".claude", ...entry.new);
+  const oldPath = join(projectRoot, ".claude", ...entry.old);
+  return {
+    newPath,
+    oldPath,
+    resolvedRead: existsSync(newPath) ? newPath : oldPath,
+    writePath: newPath,
+  };
+}
+
+function ensureStateDir(writePath) {
+  try { mkdirSync(dirname(writePath), { recursive: true }); } catch {}
+}
+
 function fingerprintPath(projectRoot) {
-  const dir = join(projectRoot, ".claude");
-  try { mkdirSync(dir, { recursive: true }); } catch {}
-  return join(dir, ".sidekick-fingerprints.json");
+  // Returns the canonical write path (Phase 2, v1.2). Read sites that need the
+  // legacy-aware path use `statePath(projectRoot, "fingerprints").resolvedRead`.
+  const { writePath } = statePath(projectRoot, "fingerprints");
+  ensureStateDir(writePath);
+  return writePath;
 }
 
 function capturePendingPath(projectRoot) {
-  const dir = join(projectRoot, ".claude");
-  try { mkdirSync(dir, { recursive: true }); } catch {}
-  return join(dir, ".sidekick-capture-pending.json");
+  // Returns the canonical write path. Read sites that need legacy-aware reads use
+  // `statePath(projectRoot, "capture-pending").resolvedRead`.
+  const { writePath } = statePath(projectRoot, "capture-pending");
+  ensureStateDir(writePath);
+  return writePath;
 }
 
 const VALID_MODES = new Set(["vault-first", "research", "outage-silence"]);
 
 function modePath(projectRoot) {
-  return join(projectRoot, ".claude", ".sidekick-mode");
+  // Returns the canonical write path. Read sites use the legacy-aware resolver.
+  return statePath(projectRoot, "mode").writePath;
 }
 
 function readMode(projectRoot) {
   try {
-    const m = readFileSync(modePath(projectRoot), "utf8").trim();
+    const m = readFileSync(statePath(projectRoot, "mode").resolvedRead, "utf8").trim();
     if (VALID_MODES.has(m)) return m;
   } catch {}
   return "vault-first";
@@ -201,9 +248,9 @@ function readMode(projectRoot) {
 function writeMode(projectRoot, mode) {
   if (!VALID_MODES.has(mode)) return;
   try {
-    const dir = join(projectRoot, ".claude");
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(modePath(projectRoot), mode);
+    const { writePath } = statePath(projectRoot, "mode");
+    ensureStateDir(writePath);
+    writeFileSync(writePath, mode);
   } catch (e) {
     debug(`mode write failed: ${e.message}`);
   }
@@ -220,29 +267,46 @@ const CAPTURE_CUES = [
   /\bbecause\b/i,
   /\bdecided\b|\bwe chose\b|\bthe decision\b/i,
   /\bturned out to be\b|\bthe bug was\b|\bthe fix was\b/i,
-  /\bgotcha\b|\bworkaround\b|\bhack\b/i,
+  // "gotcha" is also a common acknowledgment ("Gotcha, ok…") — require noun-context
+  // (a/the gotcha, gotcha:, gotchas, gotcha is/was/here/with) so bare filler doesn't misfire.
+  /\b(?:a|the|one|another)\s+gotcha\b|\bgotcha[:s]\b|\bgotcha (?:is|was|here|with)\b|\bworkaround\b|\bhack\b/i,
   /\bnew convention\b|\bfrom now on\b|\bgoing forward\b/i,
 ];
 
+// Cue detection must scan the user's own prose, NOT quoted machinery. Pasting
+// tool output back into the prompt — especially this hook's own <vault-*> blocks,
+// which literally contain the words "gotcha"/"workaround"/"hack" and the cue
+// regexes themselves — would otherwise re-prime capture-pending in a self-
+// referential loop. Strip self-emitted blocks, fenced code, and inline-code spans
+// before matching. (Unterminated blocks/fences from truncated pastes strip to EOL.)
+function stripQuotedMachinery(prompt) {
+  return prompt
+    .replace(/<vault-[a-z-]+[\s\S]*?(?:<\/vault-[a-z-]+>|$)/gi, " ")
+    .replace(/```[\s\S]*?(?:```|$)/g, " ")
+    .replace(/`[^`]*`/g, " ");
+}
+
 function detectCaptureCue(prompt) {
+  const prose = stripQuotedMachinery(prompt);
   for (const re of CAPTURE_CUES) {
-    if (re.test(prompt)) return re.source;
+    if (re.test(prose)) return re.source;
   }
   return null;
 }
 
 function addCapturePending(projectRoot, prompt, cueSource) {
   try {
-    const p = capturePendingPath(projectRoot);
+    const { resolvedRead, writePath } = statePath(projectRoot, "capture-pending");
+    ensureStateDir(writePath);
     let state = { items: [] };
-    try { state = JSON.parse(readFileSync(p, "utf8")); } catch {}
+    try { state = JSON.parse(readFileSync(resolvedRead, "utf8")); } catch {}
     if (!Array.isArray(state.items)) state.items = [];
     state.items.push({
       ts: new Date().toISOString(),
       cue: cueSource,
       excerpt: prompt.slice(0, 200),
     });
-    writeFileSync(p, JSON.stringify(state));
+    writeFileSync(writePath, JSON.stringify(state));
   } catch (e) {
     debug(`capture pending write failed: ${e.message}`);
   }
@@ -250,15 +314,16 @@ function addCapturePending(projectRoot, prompt, cueSource) {
 
 function resetCapturePending(projectRoot) {
   try {
-    const p = capturePendingPath(projectRoot);
-    writeFileSync(p, JSON.stringify({ items: [] }));
+    const { writePath } = statePath(projectRoot, "capture-pending");
+    ensureStateDir(writePath);
+    writeFileSync(writePath, JSON.stringify({ items: [] }));
   } catch {}
 }
 
 function readCapturePending(projectRoot) {
   try {
-    const p = capturePendingPath(projectRoot);
-    const state = JSON.parse(readFileSync(p, "utf8"));
+    const path = statePath(projectRoot, "capture-pending").resolvedRead;
+    const state = JSON.parse(readFileSync(path, "utf8"));
     return Array.isArray(state.items) ? state.items : [];
   } catch {
     return [];
@@ -272,17 +337,20 @@ function normalizeFingerprint(prompt) {
     .slice(0, 16);
 }
 
-function loadFingerprints(path) {
+function loadFingerprints(projectRoot) {
   try {
+    const path = statePath(projectRoot, "fingerprints").resolvedRead;
     return JSON.parse(readFileSync(path, "utf8"));
   } catch {
     return { recent: [] };
   }
 }
 
-function saveFingerprints(path, state) {
+function saveFingerprints(projectRoot, state) {
   try {
-    writeFileSync(path, JSON.stringify(state));
+    const { writePath } = statePath(projectRoot, "fingerprints");
+    ensureStateDir(writePath);
+    writeFileSync(writePath, JSON.stringify(state));
   } catch (e) {
     debug(`fingerprint save failed: ${e.message}`);
   }
@@ -553,8 +621,7 @@ async function handlePrompt(projectRoot, vaultPath, cliBin, input) {
     emit("UserPromptSubmit", "");
     return;
   }
-  const fpPath = fingerprintPath(projectRoot);
-  const state = loadFingerprints(fpPath);
+  const state = loadFingerprints(projectRoot);
   const fp = normalizeFingerprint(prompt);
   const recent = Array.isArray(state.recent) ? state.recent : [];
   if (recent.includes(fp)) {
@@ -564,7 +631,7 @@ async function handlePrompt(projectRoot, vaultPath, cliBin, input) {
   }
   const hits = runSearchCli(cliBin, ["--notes", vaultPath, "--limit", "8", prompt], 30_000);
   state.recent = [fp, ...recent].slice(0, 10);
-  saveFingerprints(fpPath, state);
+  saveFingerprints(projectRoot, state);
   const cue = detectCaptureCue(prompt);
   if (cue) {
     addCapturePending(projectRoot, prompt, cue);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theglitchking/semantic-memory",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "Unified memory-layer plugin for Claude Code. One MCP server, multiple typed corpora (vault, code, plans, docs, research, project-map), unified cross-corpus knowledge graph, conditional tool registration, in-process drift detection, and human↔code translation. Rebrand of @theglitchking/semantic-sidekick at v1.0 — see CHANGELOG for migration.",
   "type": "module",
   "main": "./dist/core/index.js",
@@ -28,6 +28,7 @@
     "skills/outage-silence",
     "README.md",
     "CHANGELOG.md",
+    "ROADMAP.md",
     "LICENSE"
   ],
   "scripts": {

package/dist/chunk-CCSX3BHF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/healthcheck.ts"],"sourcesContent":["import { readFile, writeFile, mkdir, stat } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { join, basename } from \"node:path\";\nimport { createHash } from \"node:crypto\";\nimport { homedir } from \"node:os\";\nimport { lintVault } from \"./lint.js\";\nimport { deriveProjectRoot } from \"./session.js\";\n\nexport type Tier = \"fast\" | \"slow\" | \"all\";\nexport type Severity = \"ok\" | \"warn\" | \"error\";\n\nexport interface DriftFinding {\n  check: string;\n  severity: Severity;\n  summary: string;\n  detail?: string;\n  fixable_via?: \"skill-link\" | \"mcp-reconcile\" | \"regenerate-contract\" | \"reindex\" | \"none\";\n}\n\nexport interface HealthcheckResult {\n  tier_run: Tier;\n  ran_at: string;\n  duration_ms: number;\n  findings: DriftFinding[];\n  counts: { ok: number; warn: number; error: number };\n  cached?: boolean;\n}\n\nexport interface HealthcheckOptions {\n  projectRoot: string;\n  /** Vault path. When omitted, derived from projectRoot's .claude/.vault. */\n  vaultPath?: string;\n  tier?: Tier;\n  /** Cache file path. Default: <projectRoot>/.claude/.semantic-memory/healthcheck-cache.json */\n  cachePath?: string;\n  /** Force re-run even if cache is <5 minutes old. */\n  force?: boolean;\n  /** Override \"now\" — used by tests. */\n  nowMs?: number;\n}\n\nconst CACHE_TTL_MS = 5 * 60 * 1000;\n\n/**\n * Run the drift-detection healthcheck.\n *\n *  - Fast tier: cheap file-system probes (~ms each). Plugin version, skill manifests,\n *    .mcp.json registration, hook registration, index freshness, session staleness,\n *    AGENTS.md managed-block sha. All independent, run in parallel. Total budget: <100ms\n *    on a representative install.\n *  - Slow tier: full vault lint. Adds tens of seconds on large vaults — invoked by\n *    explicit /healthcheck, never by the SessionStart auto path.\n *  - Cache: when force=false and the cache file is <5min old, return the cached result.\n *\n * Fail-open: any individual check that throws produces a `severity: \"warn\"` finding\n * with the error message; never propagates.\n */\nexport async function runHealthcheck(opts: HealthcheckOptions): Promise<HealthcheckResult> {\n  const start = (opts.nowMs ?? Date.now());\n  const tier: Tier = opts.tier ?? \"fast\";\n  const cachePath = opts.cachePath ?? join(opts.projectRoot, \".claude\", \".semantic-memory\", \"healthcheck-cache.json\");\n\n  if (!opts.force && existsSync(cachePath)) {\n    try {\n      const raw = await readFile(cachePath, \"utf-8\");\n      const cached = JSON.parse(raw) as HealthcheckResult & { ran_at_ms: number };\n      if (cached.tier_run === tier && start - cached.ran_at_ms < CACHE_TTL_MS) {\n        return { ...cached, cached: true };\n      }\n    } catch {\n      // ignore corrupt cache; will overwrite below\n    }\n  }\n\n  const findings = tier === \"fast\" ? await runFastTier(opts) : tier === \"slow\" ? await runSlowTier(opts) : [...(await runFastTier(opts)), ...(await runSlowTier(opts))];\n\n  const counts = countBySeverity(findings);\n  const ranAt = new Date(start).toISOString();\n  const result: HealthcheckResult = {\n    tier_run: tier,\n    ran_at: ranAt,\n    duration_ms: Date.now() - start,\n    findings,\n    counts,\n  };\n\n  // Persist cache (best-effort; failure is non-fatal).\n  try {\n    await mkdir(join(opts.projectRoot, \".claude\", \".semantic-memory\"), { recursive: true });\n    await writeFile(cachePath, JSON.stringify({ ...result, ran_at_ms: start }, null, 2), \"utf-8\");\n  } catch {\n    // never let cache write block the result\n  }\n\n  return result;\n}\n\n/**\n * Surface filter — return findings with severity >= warn. Used by the SessionStart hook\n * to decide whether to emit anything at all.\n */\nexport function filterToDrift(result: HealthcheckResult): DriftFinding[] {\n  return result.findings.filter((f) => f.severity !== \"ok\");\n}\n\nfunction countBySeverity(findings: DriftFinding[]): { ok: number; warn: number; error: number } {\n  const counts = { ok: 0, warn: 0, error: 0 };\n  for (const f of findings) counts[f.severity]++;\n  return counts;\n}\n\nasync function runFastTier(opts: HealthcheckOptions): Promise<DriftFinding[]> {\n  const checks: Promise<DriftFinding | null>[] = [\n    checkPluginVersion(opts.projectRoot),\n    checkMcpJsonEntry(opts.projectRoot),\n    checkHookRegistration(opts.projectRoot),\n    checkIndexFreshness(opts.projectRoot, opts.vaultPath),\n    checkSessionStaleness(opts.projectRoot),\n    checkAgentsContract(opts.projectRoot),\n    ...(await skillManifestChecks(opts.projectRoot)),\n  ];\n  const results = await Promise.all(checks.map((p) => p.catch((err) => failOpenWarn(err))));\n  return results.filter((r): r is DriftFinding => r !== null);\n}\n\nasync function runSlowTier(opts: HealthcheckOptions): Promise<DriftFinding[]> {\n  const findings: DriftFinding[] = [];\n  if (opts.vaultPath && existsSync(opts.vaultPath)) {\n    try {\n      const report = await lintVault(opts.vaultPath);\n      const total = report.findings.length;\n      if (total === 0) {\n        findings.push({ check: \"lint_vault\", severity: \"ok\", summary: `vault lint clean (${report.counts.filesLinted} files)` });\n      } else {\n        findings.push({\n          check: \"lint_vault\",\n          severity: report.counts.errors > 0 ? \"error\" : \"warn\",\n          summary: `vault lint: ${total} findings (errors=${report.counts.errors}, warnings=${report.counts.warnings})`,\n          detail: `Run \\`lint_vault\\` for the full report. Many lint findings need human review (stale notes, broken wikilinks).`,\n        });\n      }\n    } catch (err: any) {\n      findings.push({ check: \"lint_vault\", severity: \"warn\", summary: `lint_vault threw: ${err?.message ?? err}` });\n    }\n  }\n  return findings;\n}\n\nfunction failOpenWarn(err: unknown): DriftFinding {\n  return {\n    check: \"internal\",\n    severity: \"warn\",\n    summary: `healthcheck internal error: ${err instanceof Error ? err.message : String(err)}`,\n  };\n}\n\n// --- individual checks ---\n\nasync function checkPluginVersion(projectRoot: string): Promise<DriftFinding | null> {\n  const pkgPaths = [\n    join(projectRoot, \"node_modules\", \"@theglitchking\", \"semantic-memory\", \"package.json\"),\n    join(projectRoot, \"node_modules\", \"@theglitchking\", \"semantic-sidekick\", \"package.json\"),\n  ];\n  for (const p of pkgPaths) {\n    if (!existsSync(p)) continue;\n    try {\n      const installed = JSON.parse(await readFile(p, \"utf-8\"));\n      if (typeof installed?.version === \"string\") {\n        return { check: \"plugin_version\", severity: \"ok\", summary: `installed=${installed.version}` };\n      }\n    } catch {\n      // continue to next candidate\n    }\n  }\n  return null; // no installation present — not a drift event for non-npm dev environments\n}\n\nasync function checkMcpJsonEntry(projectRoot: string): Promise<DriftFinding | null> {\n  const mcpPath = join(projectRoot, \".mcp.json\");\n  if (!existsSync(mcpPath)) return null; // no .mcp.json — fine for dev\n  const data = JSON.parse(await readFile(mcpPath, \"utf-8\"));\n  const servers = data?.mcpServers ?? {};\n  const hasEntry = Object.keys(servers).some((k) => k === \"semantic-vault\" || k === \"semantic-sidekick\" || k === \"semantic-memory\");\n  if (!hasEntry) {\n    return {\n      check: \"mcp_json_entry\",\n      severity: \"warn\",\n      summary: \".mcp.json present but no semantic-memory/sidekick/vault server entry\",\n      fixable_via: \"mcp-reconcile\",\n    };\n  }\n  return { check: \"mcp_json_entry\", severity: \"ok\", summary: \".mcp.json server entry present\" };\n}\n\nasync function checkHookRegistration(projectRoot: string): Promise<DriftFinding | null> {\n  const settings = join(projectRoot, \".claude\", \"settings.json\");\n  if (!existsSync(settings)) return null;\n  try {\n    const data = JSON.parse(await readFile(settings, \"utf-8\"));\n    const hooks = data?.hooks ?? {};\n    const required = [\"SessionStart\", \"UserPromptSubmit\", \"Stop\"];\n    const missing: string[] = [];\n    for (const event of required) {\n      const arr = hooks[event];\n      if (!Array.isArray(arr) || arr.length === 0) missing.push(event);\n    }\n    if (missing.length > 0) {\n      return {\n        check: \"hook_registration\",\n        severity: \"warn\",\n        summary: `missing hook registrations: ${missing.join(\", \")}`,\n        detail: `Run \\`/relink\\` or reinstall the plugin to refresh hook registrations.`,\n      };\n    }\n    return { check: \"hook_registration\", severity: \"ok\", summary: \"all 3 hook events registered\" };\n  } catch (err: any) {\n    return failOpenWarn(err);\n  }\n}\n\nasync function checkIndexFreshness(projectRoot: string, vaultPath?: string): Promise<DriftFinding | null> {\n  const vault = vaultPath ?? defaultVaultPath(projectRoot);\n  if (!vault || !existsSync(vault)) return null;\n  const indexDir = join(vault, \".semantic-sidekick-index\");\n  const meta = join(indexDir, \"meta.json\");\n  if (!existsSync(meta)) {\n    return {\n      check: \"index_freshness\",\n      severity: \"warn\",\n      summary: \"no index built yet\",\n      detail: \"Run `reindex` to build the vector index.\",\n      fixable_via: \"reindex\",\n    };\n  }\n  try {\n    const data = JSON.parse(await readFile(meta, \"utf-8\"));\n    if (typeof data.indexedAt === \"string\") {\n      return { check: \"index_freshness\", severity: \"ok\", summary: `last reindex ${data.indexedAt}` };\n    }\n  } catch {\n    // ignore\n  }\n  return null;\n}\n\nasync function checkSessionStaleness(projectRoot: string): Promise<DriftFinding | null> {\n  const sessionPath = join(projectRoot, \".claude\", \".semantic-memory\", \"session.json\");\n  if (!existsSync(sessionPath)) return null;\n  try {\n    const state = JSON.parse(await readFile(sessionPath, \"utf-8\"));\n    if (state?.closed_at) return null;\n    const last = state?.last_activity_at;\n    if (typeof last !== \"string\") return null;\n    const ageMs = Date.now() - new Date(last).getTime();\n    if (ageMs > 24 * 60 * 60 * 1000) {\n      return {\n        check: \"session_staleness\",\n        severity: \"warn\",\n        summary: `session ${state.id} stale (>${Math.round(ageMs / (60 * 60 * 1000))}h since activity)`,\n        detail: `Either resume the session (run session_run / session_finish) or remove .claude/.semantic-memory/session.json to abandon it.`,\n      };\n    }\n    return { check: \"session_staleness\", severity: \"ok\", summary: `session ${state.id} active` };\n  } catch {\n    return null;\n  }\n}\n\nasync function checkAgentsContract(projectRoot: string): Promise<DriftFinding | null> {\n  const path = join(projectRoot, \"AGENTS.md\");\n  if (!existsSync(path)) return null; // optional artifact\n  try {\n    const raw = await readFile(path, \"utf-8\");\n    const begin = raw.indexOf(\"<!-- semantic-memory:begin contract -->\");\n    const end = raw.indexOf(\"<!-- semantic-memory:end contract -->\");\n    if (begin === -1 || end === -1) {\n      return {\n        check: \"agents_contract\",\n        severity: \"warn\",\n        summary: \"AGENTS.md exists but lacks managed-block markers\",\n        detail: \"Either move custom content to a Local Notes section, or delete AGENTS.md and run `regenerate_contract` to bootstrap.\",\n        fixable_via: \"regenerate-contract\",\n      };\n    }\n    return { check: \"agents_contract\", severity: \"ok\", summary: \"AGENTS.md managed block intact\" };\n  } catch {\n    return null;\n  }\n}\n\nasync function skillManifestChecks(projectRoot: string): Promise<Promise<DriftFinding | null>[]> {\n  const home = homedir();\n  const targets = [\n    { agent: \"claude\", path: join(home, \".claude\", \"skills\") },\n    { agent: \"codex\", path: join(home, \".codex\", \"skills\") },\n    { agent: \"copilot\", path: join(home, \".copilot\", \"skills\") },\n    { agent: \"pi\", path: join(home, \".pi\", \"agent\", \"skills\") },\n    { agent: \"claude-local\", path: join(projectRoot, \".claude\", \"skills\") },\n  ];\n  const out: Promise<DriftFinding | null>[] = [];\n  for (const t of targets) {\n    out.push(checkOneSkillManifest(t.agent, t.path));\n  }\n  return out;\n}\n\nasync function checkOneSkillManifest(agentLabel: string, skillsRoot: string): Promise<DriftFinding | null> {\n  const manifestPath = join(skillsRoot, \".semantic-memory-skill-manifest.json\");\n  if (!existsSync(manifestPath)) return null; // not installed for this agent — fine\n  try {\n    const raw = await readFile(manifestPath, \"utf-8\");\n    const manifest = JSON.parse(raw);\n    if (typeof manifest?.installed_at !== \"string\") return null;\n    const age = Date.now() - new Date(manifest.installed_at).getTime();\n    // Manifest itself is the source of truth; deeper sha-recheck happens via slow tier\n    return {\n      check: `skill_manifest:${agentLabel}`,\n      severity: \"ok\",\n      summary: `${agentLabel} skills installed v${manifest.version} (${Math.round(age / (24 * 60 * 60 * 1000))}d ago)`,\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction defaultVaultPath(projectRoot: string): string {\n  return join(projectRoot, \".claude\", \".vault\");\n}\n\n/**\n * Format a drift summary for the SessionStart hook. Returns the text to inject as\n * additionalContext, or an empty string when there's nothing to surface.\n */\nexport function formatDriftBanner(result: HealthcheckResult): string {\n  const drift = filterToDrift(result);\n  if (drift.length === 0) return \"\";\n  const lines = [\n    `<vault-drift count=\"${drift.length}\">`,\n    `⚠️  semantic-memory: ${drift.length} drift issue${drift.length === 1 ? \"\" : \"s\"} detected`,\n  ];\n  for (const f of drift.slice(0, 5)) {\n    const sev = f.severity === \"error\" ? \"✗\" : \"⚠\";\n    lines.push(`  ${sev} ${f.check}: ${f.summary}`);\n  }\n  if (drift.length > 5) lines.push(`  …and ${drift.length - 5} more`);\n  lines.push(`Run /healthcheck for details, or /healthcheck --fix to auto-fix safe items.`);\n  lines.push(`</vault-drift>`);\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}