@hiveai/core 0.13.8 → 0.14.0

package/dist/index.js

@@ -791,6 +791,102 @@ function summarizeImpact(scores) {
   return summary;
 }
 
+// src/prevention.ts
+import { appendFile, mkdir as mkdir2, readFile as readFile4 } from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
+import path6 from "path";
+function preventionLogPath(paths) {
+  return path6.join(paths.haiveDir, ".cache", "prevention-log.jsonl");
+}
+async function appendPreventionEvent(paths, event) {
+  const file = preventionLogPath(paths);
+  await mkdir2(path6.dirname(file), { recursive: true });
+  await appendFile(file, JSON.stringify(event) + "\n", "utf8");
+}
+async function loadPreventionEvents(paths) {
+  const file = preventionLogPath(paths);
+  if (!existsSync4(file)) return [];
+  const raw = await readFile4(file, "utf8").catch(() => "");
+  const events = [];
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      const e = JSON.parse(trimmed);
+      if (e && typeof e.at === "string" && typeof e.id === "string") events.push(e);
+    } catch {
+    }
+  }
+  return events;
+}
+var MS_PER_DAY2 = 864e5;
+function computePreventionTrend(events, now = /* @__PURE__ */ new Date(), weeks = 6) {
+  const nowMs = now.getTime();
+  let last7 = 0;
+  let last30 = 0;
+  const weekly = new Array(weeks).fill(0);
+  for (const e of events) {
+    const t = Date.parse(e.at);
+    if (!Number.isFinite(t)) continue;
+    const ageDays = (nowMs - t) / MS_PER_DAY2;
+    if (ageDays < 0) continue;
+    if (ageDays <= 7) last7 += 1;
+    if (ageDays <= 30) last30 += 1;
+    const weekIdx = weeks - 1 - Math.floor(ageDays / 7);
+    if (weekIdx >= 0 && weekIdx < weeks) weekly[weekIdx] = (weekly[weekIdx] ?? 0) + 1;
+  }
+  return { last_7d: last7, last_30d: last30, weekly };
+}
+function computeRecurrence(events) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const e of events) {
+    const cur = byId.get(e.id) ?? { catches: 0, days: /* @__PURE__ */ new Set(), last: e.at };
+    cur.catches += 1;
+    cur.days.add(e.at.slice(0, 10));
+    if (e.at > cur.last) cur.last = e.at;
+    byId.set(e.id, cur);
+  }
+  const rows = [];
+  for (const [id, v] of byId) {
+    if (v.days.size >= 2) {
+      rows.push({ id, catches: v.catches, distinct_days: v.days.size, last_at: v.last });
+    }
+  }
+  rows.sort((a, b) => b.distinct_days - a.distinct_days || b.catches - a.catches);
+  return { recurring_count: rows.length, top: rows };
+}
+
+// src/context-throttle.ts
+import { createHash } from "crypto";
+import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync5 } from "fs";
+import path7 from "path";
+var PROJECT_CONTEXT_THROTTLE_MS = 8 * 60 * 1e3;
+function throttleMarkerPath(paths) {
+  return path7.join(paths.haiveDir, ".cache", "briefing-context.json");
+}
+function hashProjectContext(content) {
+  return createHash("sha1").update(content).digest("hex").slice(0, 16);
+}
+async function projectContextRecentlyEmitted(paths, hash, now = Date.now()) {
+  const file = throttleMarkerPath(paths);
+  if (!existsSync5(file)) return false;
+  try {
+    const m = JSON.parse(await readFile5(file, "utf8"));
+    if (m.hash !== hash || !m.at) return false;
+    return now - Date.parse(m.at) < PROJECT_CONTEXT_THROTTLE_MS;
+  } catch {
+    return false;
+  }
+}
+async function recordProjectContextEmission(paths, hash, now = Date.now()) {
+  const file = throttleMarkerPath(paths);
+  await mkdir3(path7.dirname(file), { recursive: true }).catch(() => {
+  });
+  await writeFile2(file, JSON.stringify({ hash, at: new Date(now).toISOString() }), "utf8").catch(() => {
+  });
+}
+
 // src/eval.ts
 function round32(n) {
   return Math.round(n * 1e3) / 1e3;
@@ -926,13 +1022,13 @@ var DEFAULT_CONFIDENCE_THRESHOLDS = {
   decayDays: 180,
   hardDecayDays: 365
 };
-var MS_PER_DAY2 = 24 * 60 * 60 * 1e3;
+var MS_PER_DAY3 = 24 * 60 * 60 * 1e3;
 function deriveConfidence(fm, usage, thresholds = DEFAULT_CONFIDENCE_THRESHOLDS, now = /* @__PURE__ */ new Date()) {
   if (fm.status === "stale" || fm.status === "deprecated" || fm.status === "rejected") return "stale";
   const baseLevel = baseConfidence(fm, usage, thresholds);
   if (baseLevel !== "authoritative" && baseLevel !== "trusted") return baseLevel;
   const anchor = usage.last_read_at ?? fm.created_at;
-  const ageDays = (now.getTime() - new Date(anchor).getTime()) / MS_PER_DAY2;
+  const ageDays = (now.getTime() - new Date(anchor).getTime()) / MS_PER_DAY3;
   if (Number.isNaN(ageDays) || ageDays <= 0) return baseLevel;
   if (ageDays >= thresholds.hardDecayDays) {
     return "low";
@@ -1226,10 +1322,10 @@ function allocateBudget(parts, maxTokens) {
 }
 
 // src/code-map.ts
-import { mkdir as mkdir2, readFile as readFile4, readdir as readdir3, writeFile as writeFile2 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { mkdir as mkdir4, readFile as readFile6, readdir as readdir3, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync6 } from "fs";
 import { spawnSync } from "child_process";
-import path6 from "path";
+import path8 from "path";
 var CODE_MAP_FILE = "code-map.json";
 var DEFAULT_INCLUDE = [
   ".ts",
@@ -1271,27 +1367,27 @@ var DEFAULT_EXCLUDE = [
 ];
 var TEST_FILE_RE = /\.(test|spec)\.[a-z]+$/i;
 function codeMapPath(paths) {
-  return path6.join(paths.haiveDir, CODE_MAP_FILE);
+  return path8.join(paths.haiveDir, CODE_MAP_FILE);
 }
 async function loadCodeMap(paths) {
   const file = codeMapPath(paths);
-  if (!existsSync4(file)) return null;
-  return JSON.parse(await readFile4(file, "utf8"));
+  if (!existsSync6(file)) return null;
+  return JSON.parse(await readFile6(file, "utf8"));
 }
 async function saveCodeMap(paths, map) {
   const file = codeMapPath(paths);
-  await mkdir2(path6.dirname(file), { recursive: true });
-  await writeFile2(file, JSON.stringify(map, null, 2), "utf8");
+  await mkdir4(path8.dirname(file), { recursive: true });
+  await writeFile3(file, JSON.stringify(map, null, 2), "utf8");
 }
 async function buildCodeMap(root, options = {}) {
   const include = new Set(options.includeExtensions ?? DEFAULT_INCLUDE);
   const exclude = new Set(options.excludeDirs ?? DEFAULT_EXCLUDE);
   const files = {};
   for await (const abs of collectSourceFiles(root, include, exclude, options.includeUntracked)) {
-    const rel = path6.relative(root, abs).replace(/\\/g, "/");
+    const rel = path8.relative(root, abs).replace(/\\/g, "/");
     if (rel.startsWith(".ai/")) continue;
-    const content = await readFile4(abs, "utf8");
-    const ext = path6.extname(abs).toLowerCase();
+    const content = await readFile6(abs, "utf8");
+    const ext = path8.extname(abs).toLowerCase();
     const entry = parseFile(content, ext);
     if (entry.exports.length > 0) files[rel] = entry;
   }
@@ -1305,7 +1401,7 @@ async function buildCodeMap(root, options = {}) {
 async function* collectSourceFiles(root, include, exclude, includeUntracked) {
   const gitFiles = gitSourceFiles(root, include, exclude, includeUntracked === true);
   if (gitFiles) {
-    for (const rel of gitFiles) yield path6.join(root, rel);
+    for (const rel of gitFiles) yield path8.join(root, rel);
     return;
   }
   yield* walkSourceFiles(root, include, exclude);
@@ -1332,11 +1428,11 @@ async function* walkSourceFiles(dir, include, exclude) {
       if (entry.isDirectory()) continue;
     }
     if (exclude.has(entry.name)) continue;
-    const full = path6.join(dir, entry.name);
+    const full = path8.join(dir, entry.name);
     if (entry.isDirectory()) {
       yield* walkSourceFiles(full, include, exclude);
     } else if (entry.isFile()) {
-      const ext = path6.extname(entry.name).toLowerCase();
+      const ext = path8.extname(entry.name).toLowerCase();
       if (include.has(ext) && !TEST_FILE_RE.test(entry.name)) yield full;
     }
   }
@@ -1347,7 +1443,7 @@ function isIncludedSourcePath(rel, include, exclude) {
   const parts = normalized.split("/");
   if (parts.some((part) => exclude.has(part))) return false;
   const base = parts.at(-1) ?? "";
-  const ext = path6.extname(base).toLowerCase();
+  const ext = path8.extname(base).toLowerCase();
   return include.has(ext) && !TEST_FILE_RE.test(base);
 }
 var EXPORT_RE = /^export\s+(?:default\s+)?(async\s+)?(function|class|interface|type|const|let|var|enum)\s+(\*?)\s*([A-Za-z_$][\w$]*)/gm;
@@ -1561,10 +1657,10 @@ function queryCodeMap(map, options) {
 }
 
 // src/config.ts
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import { readFileSync } from "fs";
-import { readFile as readFile5, writeFile as writeFile3 } from "fs/promises";
-import path7 from "path";
+import { readFile as readFile7, writeFile as writeFile4 } from "fs/promises";
+import path9 from "path";
 var CONFIG_FILE = "haive.config.json";
 var DEFAULT_CONFIG = {
   autopilot: false,
@@ -1636,13 +1732,13 @@ function antiPatternGateParams(gate) {
   }
 }
 function configPath(paths) {
-  return path7.join(paths.haiveDir, CONFIG_FILE);
+  return path9.join(paths.haiveDir, CONFIG_FILE);
 }
 async function loadConfig(paths) {
   const file = configPath(paths);
-  if (!existsSync5(file)) return { ...DEFAULT_CONFIG };
+  if (!existsSync7(file)) return { ...DEFAULT_CONFIG };
   try {
-    const raw = await readFile5(file, "utf8");
+    const raw = await readFile7(file, "utf8");
     const parsed = JSON.parse(raw);
     const merged = mergeConfig(DEFAULT_CONFIG, parsed);
     if (merged.autopilot) {
@@ -1655,7 +1751,7 @@ async function loadConfig(paths) {
 }
 function loadConfigSync(paths) {
   const file = configPath(paths);
-  if (!existsSync5(file)) return { ...DEFAULT_CONFIG };
+  if (!existsSync7(file)) return { ...DEFAULT_CONFIG };
   try {
     const parsed = JSON.parse(readFileSync(file, "utf8"));
     const merged = mergeConfig(DEFAULT_CONFIG, parsed);
@@ -1665,7 +1761,7 @@ function loadConfigSync(paths) {
   }
 }
 async function saveConfig(paths, config) {
-  await writeFile3(configPath(paths), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await writeFile4(configPath(paths), JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 function mergeConfig(base, override) {
   return {
@@ -1683,21 +1779,21 @@ function mergeConfig(base, override) {
 }
 
 // src/cross-repo.ts
-import { existsSync as existsSync6 } from "fs";
-import { mkdir as mkdir3, readFile as readFile6, writeFile as writeFile4 } from "fs/promises";
-import path8 from "path";
+import { existsSync as existsSync8 } from "fs";
+import { mkdir as mkdir5, readFile as readFile8, writeFile as writeFile5 } from "fs/promises";
+import path10 from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 async function loadImportMap(cacheDir) {
-  const mapPath = path8.join(cacheDir, "import-map.json");
-  if (!existsSync6(mapPath)) return {};
+  const mapPath = path10.join(cacheDir, "import-map.json");
+  if (!existsSync8(mapPath)) return {};
   try {
-    return JSON.parse(await readFile6(mapPath, "utf8"));
+    return JSON.parse(await readFile8(mapPath, "utf8"));
   } catch {
     return {};
   }
 }
 async function saveImportMap(cacheDir, map) {
-  await writeFile4(path8.join(cacheDir, "import-map.json"), JSON.stringify(map, null, 2) + "\n", "utf8");
+  await writeFile5(path10.join(cacheDir, "import-map.json"), JSON.stringify(map, null, 2) + "\n", "utf8");
 }
 async function pullCrossRepoSources(paths, config, projectRoot) {
   const sources = config.crossRepoSources ?? [];
@@ -1718,8 +1814,8 @@ async function pullFromSource(paths, source, projectRoot) {
   };
   let sourceRoot = null;
   if (source.path) {
-    const resolved = path8.resolve(projectRoot, source.path);
-    if (!existsSync6(resolved)) {
+    const resolved = path10.resolve(projectRoot, source.path);
+    if (!existsSync8(resolved)) {
       report.errors.push(`Path not found: ${resolved}`);
       return report;
     }
@@ -1732,7 +1828,7 @@ async function pullFromSource(paths, source, projectRoot) {
     return report;
   }
   const sourcePaths = resolveHaivePaths(sourceRoot);
-  if (!existsSync6(sourcePaths.memoriesDir)) {
+  if (!existsSync8(sourcePaths.memoriesDir)) {
     report.errors.push(`No .ai/memories/ found at ${sourceRoot}`);
     return report;
   }
@@ -1755,10 +1851,10 @@ async function pullFromSource(paths, source, projectRoot) {
     report.skipped.push("no shared memories found in source");
     return report;
   }
-  const destDir = path8.join(paths.memoriesDir, "shared", source.name);
-  await mkdir3(destDir, { recursive: true });
-  const cacheDir = path8.join(paths.haiveDir, ".cache", "cross-repo", source.name);
-  await mkdir3(cacheDir, { recursive: true });
+  const destDir = path10.join(paths.memoriesDir, "shared", source.name);
+  await mkdir5(destDir, { recursive: true });
+  const cacheDir = path10.join(paths.haiveDir, ".cache", "cross-repo", source.name);
+  await mkdir5(cacheDir, { recursive: true });
   const importMap = await loadImportMap(cacheDir);
   const mapDirty = false;
   let dirty = mapDirty;
@@ -1772,7 +1868,7 @@ async function pullFromSource(paths, source, projectRoot) {
 
 `;
     const existingLocalPath = importMap[sourceId];
-    if (existingLocalPath && existsSync6(existingLocalPath)) {
+    if (existingLocalPath && existsSync8(existingLocalPath)) {
       const existingFiles = await loadMemoriesFromDir(destDir);
       const existingEntry = existingFiles.find(({ filePath }) => filePath === existingLocalPath);
       const sourceBodyStripped = memory.body.trim();
@@ -1783,7 +1879,7 @@ async function pullFromSource(paths, source, projectRoot) {
       }
       const updatedBody = importedBodyPrefix + memory.body;
       if (existingEntry) {
-        await writeFile4(
+        await writeFile5(
           existingLocalPath,
           serializeMemory({ frontmatter: existingEntry.memory.frontmatter, body: updatedBody }),
           "utf8"
@@ -1807,8 +1903,8 @@ async function pullFromSource(paths, source, projectRoot) {
         topic: fm.topic ? `${source.name}:${fm.topic}` : void 0
       });
       const body = importedBodyPrefix + memory.body;
-      const destPath = path8.join(destDir, `${newFm.id}.md`);
-      await writeFile4(destPath, serializeMemory({ frontmatter: newFm, body }), "utf8");
+      const destPath = path10.join(destDir, `${newFm.id}.md`);
+      await writeFile5(destPath, serializeMemory({ frontmatter: newFm, body }), "utf8");
       importMap[sourceId] = destPath;
       dirty = true;
       report.imported.push(sourceId);
@@ -1818,9 +1914,9 @@ async function pullFromSource(paths, source, projectRoot) {
   return report;
 }
 async function cloneOrFetchGitSource(source, paths, report) {
-  const cacheDir = path8.join(paths.haiveDir, ".cache", "cross-repo", source.name);
-  await mkdir3(cacheDir, { recursive: true });
-  if (existsSync6(path8.join(cacheDir, ".git"))) {
+  const cacheDir = path10.join(paths.haiveDir, ".cache", "cross-repo", source.name);
+  await mkdir5(cacheDir, { recursive: true });
+  if (existsSync8(path10.join(cacheDir, ".git"))) {
     const result = spawnSync2("git", ["fetch", "--depth=1", "origin"], {
       cwd: cacheDir,
       encoding: "utf8"
@@ -1845,9 +1941,9 @@ async function cloneOrFetchGitSource(source, paths, report) {
 }
 
 // src/dep-tracker.ts
-import { existsSync as existsSync7 } from "fs";
-import { readFile as readFile7, writeFile as writeFile5, mkdir as mkdir4 } from "fs/promises";
-import path9 from "path";
+import { existsSync as existsSync9 } from "fs";
+import { readFile as readFile9, writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
+import path11 from "path";
 function parsePackageJson(content) {
   try {
     const pkg = JSON.parse(content);
@@ -1919,7 +2015,7 @@ var KNOWN_MANIFESTS = [
   { name: "pom.xml", parser: parsePomXml }
 ];
 function getParser(file) {
-  const base = path9.basename(file);
+  const base = path11.basename(file);
   return KNOWN_MANIFESTS.find((m) => m.name === base)?.parser ?? null;
 }
 function extractMajor(version) {
@@ -1937,32 +2033,32 @@ function isMajorBump(from, to) {
 }
 function resolveManifestFiles(projectRoot, configuredFiles) {
   if (configuredFiles !== void 0) {
-    return configuredFiles.map((f) => path9.resolve(projectRoot, f)).filter(existsSync7);
+    return configuredFiles.map((f) => path11.resolve(projectRoot, f)).filter(existsSync9);
   }
-  return KNOWN_MANIFESTS.map(({ name }) => path9.join(projectRoot, name)).filter(existsSync7);
+  return KNOWN_MANIFESTS.map(({ name }) => path11.join(projectRoot, name)).filter(existsSync9);
 }
 async function trackDependencies(projectRoot, haiveDir, manifestFiles) {
-  const contractsDir = path9.join(haiveDir, "contracts");
-  await mkdir4(contractsDir, { recursive: true });
+  const contractsDir = path11.join(haiveDir, "contracts");
+  await mkdir6(contractsDir, { recursive: true });
   const results = [];
   for (const manifestPath of manifestFiles) {
     const parser = getParser(manifestPath);
     if (!parser) continue;
-    const content = await readFile7(manifestPath, "utf8");
+    const content = await readFile9(manifestPath, "utf8");
     const currentDeps = parser(content);
-    const lockName = `deps-${path9.basename(manifestPath)}.lock`;
-    const lockPath = path9.join(contractsDir, lockName);
-    if (!existsSync7(lockPath)) {
+    const lockName = `deps-${path11.basename(manifestPath)}.lock`;
+    const lockPath = path11.join(contractsDir, lockName);
+    if (!existsSync9(lockPath)) {
       const snapshot2 = {
-        file: path9.relative(projectRoot, manifestPath),
-        format: path9.basename(manifestPath),
+        file: path11.relative(projectRoot, manifestPath),
+        format: path11.basename(manifestPath),
         captured_at: (/* @__PURE__ */ new Date()).toISOString(),
         deps: currentDeps
       };
-      await writeFile5(lockPath, JSON.stringify(snapshot2, null, 2) + "\n", "utf8");
+      await writeFile6(lockPath, JSON.stringify(snapshot2, null, 2) + "\n", "utf8");
       continue;
     }
-    const snapshot = JSON.parse(await readFile7(lockPath, "utf8"));
+    const snapshot = JSON.parse(await readFile9(lockPath, "utf8"));
     const changes = [];
     for (const [name, currentVer] of Object.entries(currentDeps)) {
       const prevVer = snapshot.deps[name];
@@ -1976,22 +2072,22 @@ async function trackDependencies(projectRoot, haiveDir, manifestFiles) {
       }
     }
     if (changes.length > 0) {
-      results.push({ file: path9.relative(projectRoot, manifestPath), changes });
+      results.push({ file: path11.relative(projectRoot, manifestPath), changes });
       const updated = {
         ...snapshot,
         captured_at: (/* @__PURE__ */ new Date()).toISOString(),
         deps: currentDeps
       };
-      await writeFile5(lockPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+      await writeFile6(lockPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
     }
   }
   return results;
 }
 
 // src/contract-watcher.ts
-import { existsSync as existsSync8 } from "fs";
-import { readFile as readFile8, writeFile as writeFile6, mkdir as mkdir5 } from "fs/promises";
-import path10 from "path";
+import { existsSync as existsSync10 } from "fs";
+import { readFile as readFile10, writeFile as writeFile7, mkdir as mkdir7 } from "fs/promises";
+import path12 from "path";
 import crypto from "crypto";
 function sha256(content) {
   return crypto.createHash("sha256").update(content).digest("hex");
@@ -2194,14 +2290,14 @@ function diffSnapshots(before, after) {
   return changes;
 }
 function contractLockPath(haiveDir, name) {
-  return path10.join(haiveDir, "contracts", `${name}.lock`);
+  return path12.join(haiveDir, "contracts", `${name}.lock`);
 }
 async function snapshotContract(projectRoot, haiveDir, contract) {
-  const filePath = path10.resolve(projectRoot, contract.path);
-  if (!existsSync8(filePath)) {
+  const filePath = path12.resolve(projectRoot, contract.path);
+  if (!existsSync10(filePath)) {
     throw new Error(`Contract file not found: ${filePath}`);
   }
-  const content = await readFile8(filePath, "utf8");
+  const content = await readFile10(filePath, "utf8");
   const parsed = parseByFormat(content, contract.format, filePath);
   const snapshot = {
     name: contract.name,
@@ -2211,23 +2307,23 @@ async function snapshotContract(projectRoot, haiveDir, contract) {
     hash: sha256(content),
     ...parsed
   };
-  const contractsDir = path10.join(haiveDir, "contracts");
-  await mkdir5(contractsDir, { recursive: true });
-  await writeFile6(contractLockPath(haiveDir, contract.name), JSON.stringify(snapshot, null, 2) + "\n", "utf8");
+  const contractsDir = path12.join(haiveDir, "contracts");
+  await mkdir7(contractsDir, { recursive: true });
+  await writeFile7(contractLockPath(haiveDir, contract.name), JSON.stringify(snapshot, null, 2) + "\n", "utf8");
   return snapshot;
 }
 async function diffContract(projectRoot, haiveDir, contract) {
-  const filePath = path10.resolve(projectRoot, contract.path);
-  if (!existsSync8(filePath)) {
+  const filePath = path12.resolve(projectRoot, contract.path);
+  if (!existsSync10(filePath)) {
     return { contract: contract.name, file: contract.path, changes: [], unchanged: true };
   }
   const lockPath = contractLockPath(haiveDir, contract.name);
-  if (!existsSync8(lockPath)) {
+  if (!existsSync10(lockPath)) {
     await snapshotContract(projectRoot, haiveDir, contract);
     return { contract: contract.name, file: contract.path, changes: [], unchanged: true };
   }
-  const content = await readFile8(filePath, "utf8");
-  const beforeSnapshot = JSON.parse(await readFile8(lockPath, "utf8"));
+  const content = await readFile10(filePath, "utf8");
+  const beforeSnapshot = JSON.parse(await readFile10(lockPath, "utf8"));
   const afterParsed = parseByFormat(content, contract.format, filePath);
   const afterSnapshot = {
     ...beforeSnapshot,
@@ -2237,7 +2333,7 @@ async function diffContract(projectRoot, haiveDir, contract) {
   };
   const changes = diffSnapshots(beforeSnapshot, afterSnapshot);
   if (changes.length > 0) {
-    await writeFile6(lockPath, JSON.stringify(afterSnapshot, null, 2) + "\n", "utf8");
+    await writeFile7(lockPath, JSON.stringify(afterSnapshot, null, 2) + "\n", "utf8");
   }
   return {
     contract: contract.name,
@@ -2255,27 +2351,27 @@ async function watchContracts(projectRoot, haiveDir, contractFiles) {
 }
 
 // src/usage-log.ts
-import { appendFile, mkdir as mkdir6, readFile as readFile9, stat as stat2 } from "fs/promises";
-import { existsSync as existsSync9 } from "fs";
-import path11 from "path";
+import { appendFile as appendFile2, mkdir as mkdir8, readFile as readFile11, stat as stat2 } from "fs/promises";
+import { existsSync as existsSync11 } from "fs";
+import path13 from "path";
 var USAGE_LOG_FILE = "tool-usage.jsonl";
 var USAGE_LOG_DIR = ".usage";
 function usageLogPath(paths) {
-  return path11.join(paths.haiveDir, USAGE_LOG_DIR, USAGE_LOG_FILE);
+  return path13.join(paths.haiveDir, USAGE_LOG_DIR, USAGE_LOG_FILE);
 }
 async function appendUsageEvent(paths, event) {
   try {
     const file = usageLogPath(paths);
-    const dir = path11.dirname(file);
-    if (!existsSync9(dir)) await mkdir6(dir, { recursive: true });
-    await appendFile(file, JSON.stringify(event) + "\n", "utf8");
+    const dir = path13.dirname(file);
+    if (!existsSync11(dir)) await mkdir8(dir, { recursive: true });
+    await appendFile2(file, JSON.stringify(event) + "\n", "utf8");
   } catch {
   }
 }
 async function readUsageEvents(paths) {
   const file = usageLogPath(paths);
-  if (!existsSync9(file)) return [];
-  const raw = await readFile9(file, "utf8");
+  if (!existsSync11(file)) return [];
+  const raw = await readFile11(file, "utf8");
   const out = [];
   for (const line of raw.split("\n")) {
     if (!line) continue;
@@ -2324,9 +2420,9 @@ function parseSince(input) {
 }
 async function usageLogSize(paths) {
   const file = usageLogPath(paths);
-  if (!existsSync9(file)) return { exists: false, size_bytes: 0, lines: 0 };
+  if (!existsSync11(file)) return { exists: false, size_bytes: 0, lines: 0 };
   const st = await stat2(file);
-  const raw = await readFile9(file, "utf8");
+  const raw = await readFile11(file, "utf8");
   return { exists: true, size_bytes: st.size, lines: raw.split("\n").filter((l) => l).length };
 }
 
@@ -2396,21 +2492,21 @@ function extractActionsBriefBody(markdown, maxChars = MAX_DEFAULT_CHARS) {
 }
 
 // src/resolve-project.ts
-import { existsSync as existsSync10 } from "fs";
-import path12 from "path";
+import { existsSync as existsSync12 } from "fs";
+import path14 from "path";
 var ROOT_MARKERS2 = [".ai", ".git", "package.json"];
 function markersAtRoot(root) {
   const found = [];
   for (const m of ROOT_MARKERS2) {
-    if (existsSync10(path12.join(root, m))) found.push(m);
+    if (existsSync12(path14.join(root, m))) found.push(m);
   }
   return found;
 }
 function resolveProjectInfo(opts = {}) {
   const env = opts.env ?? process.env;
-  const cwd = path12.resolve(opts.cwd ?? process.cwd());
+  const cwd = path14.resolve(opts.cwd ?? process.cwd());
   const raw = env.HAIVE_PROJECT_ROOT;
-  const explicit = raw !== void 0 && raw !== "" ? path12.resolve(raw) : null;
+  const explicit = raw !== void 0 && raw !== "" ? path14.resolve(raw) : null;
   const resolvedRoot = explicit ?? findProjectRoot(cwd);
   const paths = resolveHaivePaths(resolvedRoot);
   return {
@@ -2418,8 +2514,8 @@ function resolveProjectInfo(opts = {}) {
     resolved_root: resolvedRoot,
     haive_project_root_env: explicit,
     explicit_root: explicit != null,
-    haive_dir_exists: existsSync10(paths.haiveDir),
-    memories_dir_exists: existsSync10(paths.memoriesDir),
+    haive_dir_exists: existsSync12(paths.haiveDir),
+    memories_dir_exists: existsSync12(paths.memoriesDir),
     runtime_dir: paths.runtimeDir,
     markers_found: markersAtRoot(resolvedRoot)
   };
@@ -2674,16 +2770,16 @@ function findLexicalConflictPairs(memories, opts) {
 }
 
 // src/runtime-journal.ts
-import { mkdir as mkdir7, readFile as readFile10, appendFile as appendFile2 } from "fs/promises";
-import { existsSync as existsSync11 } from "fs";
-import path13 from "path";
+import { mkdir as mkdir9, readFile as readFile12, appendFile as appendFile3 } from "fs/promises";
+import { existsSync as existsSync13 } from "fs";
+import path15 from "path";
 var RUNTIME_JOURNAL_FILENAME = "session-journal.ndjson";
 function runtimeJournalPath(paths) {
-  return path13.join(paths.runtimeDir, RUNTIME_JOURNAL_FILENAME);
+  return path15.join(paths.runtimeDir, RUNTIME_JOURNAL_FILENAME);
 }
 async function appendRuntimeJournalEntry(paths, entry) {
   try {
-    await mkdir7(paths.runtimeDir, { recursive: true });
+    await mkdir9(paths.runtimeDir, { recursive: true });
     const line = {
       ts: entry.ts ?? (/* @__PURE__ */ new Date()).toISOString(),
       kind: entry.kind,
@@ -2691,7 +2787,7 @@ async function appendRuntimeJournalEntry(paths, entry) {
       ...entry.tool !== void 0 ? { tool: entry.tool } : {},
       ...entry.meta !== void 0 ? { meta: entry.meta } : {}
     };
-    await appendFile2(
+    await appendFile3(
       runtimeJournalPath(paths),
       JSON.stringify(line) + "\n",
       "utf8"
@@ -2701,9 +2797,9 @@ async function appendRuntimeJournalEntry(paths, entry) {
 }
 async function readRuntimeJournalTail(paths, limit) {
   const file = runtimeJournalPath(paths);
-  if (!existsSync11(file) || limit <= 0) return [];
+  if (!existsSync13(file) || limit <= 0) return [];
   try {
-    const raw = await readFile10(file, "utf8");
+    const raw = await readFile12(file, "utf8");
     const lines = raw.trim().split("\n").filter(Boolean);
     const parsed = [];
     for (const line of lines.slice(-limit)) {
@@ -2719,22 +2815,22 @@ async function readRuntimeJournalTail(paths, limit) {
 }
 
 // src/enforcement.ts
-import { mkdir as mkdir8, readdir as readdir4, readFile as readFile11, writeFile as writeFile7 } from "fs/promises";
-import { existsSync as existsSync12 } from "fs";
-import path14 from "path";
+import { mkdir as mkdir10, readdir as readdir4, readFile as readFile13, writeFile as writeFile8 } from "fs/promises";
+import { existsSync as existsSync14 } from "fs";
+import path16 from "path";
 var BRIEFING_MARKER_TTL_MS = 12 * 60 * 60 * 1e3;
 var SESSION_RECAP_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
 function enforcementDir(paths) {
-  return path14.join(paths.runtimeDir, "enforcement");
+  return path16.join(paths.runtimeDir, "enforcement");
 }
 function briefingMarkersDir(paths) {
-  return path14.join(enforcementDir(paths), "briefings");
+  return path16.join(enforcementDir(paths), "briefings");
 }
 function normalizeSessionId(sessionId) {
   return (sessionId?.trim() || "default").replace(/[^a-zA-Z0-9_.-]+/g, "-").slice(0, 120);
 }
 function briefingMarkerPath(paths, sessionId) {
-  return path14.join(briefingMarkersDir(paths), `${normalizeSessionId(sessionId)}.json`);
+  return path16.join(briefingMarkersDir(paths), `${normalizeSessionId(sessionId)}.json`);
 }
 async function writeBriefingMarker(paths, input) {
   const marker = {
@@ -2746,8 +2842,8 @@ async function writeBriefingMarker(paths, input) {
     created_at: (/* @__PURE__ */ new Date()).toISOString(),
     root: paths.root
   };
-  await mkdir8(briefingMarkersDir(paths), { recursive: true });
-  await writeFile7(
+  await mkdir10(briefingMarkersDir(paths), { recursive: true });
+  await writeFile8(
     briefingMarkerPath(paths, marker.session_id),
     JSON.stringify(marker, null, 2) + "\n",
     "utf8"
@@ -2758,18 +2854,18 @@ async function hasRecentBriefingMarker(paths, sessionId, ttlMs = BRIEFING_MARKER
   const now = Date.now();
   const candidates = [];
   const exact = briefingMarkerPath(paths, sessionId);
-  if (existsSync12(exact)) candidates.push(exact);
+  if (existsSync14(exact)) candidates.push(exact);
   try {
     const dir = briefingMarkersDir(paths);
     const files = await readdir4(dir);
     for (const file of files) {
-      if (file.endsWith(".json")) candidates.push(path14.join(dir, file));
+      if (file.endsWith(".json")) candidates.push(path16.join(dir, file));
     }
   } catch {
   }
   for (const file of new Set(candidates)) {
     try {
-      const marker = JSON.parse(await readFile11(file, "utf8"));
+      const marker = JSON.parse(await readFile13(file, "utf8"));
       const created = Date.parse(marker.created_at);
       if (Number.isFinite(created) && now - created <= ttlMs) return true;
     } catch {
@@ -2781,12 +2877,12 @@ async function readRecentBriefingMarker(paths, sessionId, ttlMs = BRIEFING_MARKE
   const now = Date.now();
   const candidates = [];
   const exact = briefingMarkerPath(paths, sessionId);
-  if (existsSync12(exact)) candidates.push(exact);
+  if (existsSync14(exact)) candidates.push(exact);
   try {
     const dir = briefingMarkersDir(paths);
     const files = await readdir4(dir);
     for (const file of files) {
-      if (file.endsWith(".json")) candidates.push(path14.join(dir, file));
+      if (file.endsWith(".json")) candidates.push(path16.join(dir, file));
     }
   } catch {
   }
@@ -2794,7 +2890,7 @@ async function readRecentBriefingMarker(paths, sessionId, ttlMs = BRIEFING_MARKE
   let freshestTs = 0;
   for (const file of new Set(candidates)) {
     try {
-      const marker = JSON.parse(await readFile11(file, "utf8"));
+      const marker = JSON.parse(await readFile13(file, "utf8"));
       const created = Date.parse(marker.created_at);
       if (!Number.isFinite(created) || now - created > ttlMs) continue;
       if (created > freshestTs) {
@@ -2847,10 +2943,10 @@ function isRetiredMemory(fm, body = "", now = /* @__PURE__ */ new Date()) {
 function normalizeProjectPath(value) {
   return value.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^[ab]\//, "").replace(/\/+$/g, "");
 }
-function sensorAppliesToPath(sensor, anchorPaths, path15) {
+function sensorAppliesToPath(sensor, anchorPaths, path17) {
   const scopes = sensor.paths.length > 0 ? sensor.paths : anchorPaths;
   if (scopes.length === 0) return true;
-  const target = normalizeProjectPath(path15);
+  const target = normalizeProjectPath(path17);
   return scopes.some((rawScope) => {
     const scope = normalizeProjectPath(rawScope);
     if (!scope) return false;
@@ -3124,8 +3220,8 @@ function normalizeFindingSeverity(raw) {
       return "info";
   }
 }
-function findingKey(tool, ruleId, path15) {
-  return `${tool}:${ruleId}:${path15}`;
+function findingKey(tool, ruleId, path17) {
+  return `${tool}:${ruleId}:${path17}`;
 }
 function coerceJson(input) {
   if (typeof input === "string") {
@@ -3159,8 +3255,8 @@ function parseSarif(input) {
       const physical = asRecord(location.physicalLocation);
       const artifact = asRecord(physical.artifactLocation);
       const region = asRecord(physical.region);
-      const path15 = typeof artifact.uri === "string" ? normalizeUri(artifact.uri) : "";
-      if (!path15) continue;
+      const path17 = typeof artifact.uri === "string" ? normalizeUri(artifact.uri) : "";
+      if (!path17) continue;
       const line = typeof region.startLine === "number" ? region.startLine : void 0;
       const snippet = typeof asRecord(region.snippet).text === "string" ? asRecord(region.snippet).text.trim() : void 0;
       findings.push({
@@ -3168,10 +3264,10 @@ function parseSarif(input) {
         ruleId,
         message: message.trim(),
         severity,
-        path: path15,
+        path: path17,
         ...line !== void 0 ? { line } : {},
         ...snippet ? { snippet } : {},
-        key: findingKey(tool, ruleId, path15)
+        key: findingKey(tool, ruleId, path17)
       });
     }
   }
@@ -3190,17 +3286,17 @@ function parseSonar(input) {
       (typeof issue.severity === "string" ? issue.severity : void 0) ?? impactSeverity
     );
     const component = typeof issue.component === "string" ? issue.component : "";
-    const path15 = componentToPath(component);
-    if (!path15) continue;
+    const path17 = componentToPath(component);
+    if (!path17) continue;
     const line = typeof issue.line === "number" ? issue.line : void 0;
     findings.push({
       tool: "sonar",
       ruleId,
       message,
       severity,
-      path: path15,
+      path: path17,
       ...line !== void 0 ? { line } : {},
-      key: findingKey("sonar", ruleId, path15)
+      key: findingKey("sonar", ruleId, path17)
     });
   }
   return findings;
@@ -3278,7 +3374,7 @@ function filterNewDrafts(drafts, existingTopics) {
 }
 
 // src/dashboard.ts
-var MS_PER_DAY3 = 24 * 60 * 60 * 1e3;
+var MS_PER_DAY4 = 24 * 60 * 60 * 1e3;
 function isAnchorless(fm) {
   if (!["decision", "gotcha", "architecture"].includes(fm.type)) return false;
   if (fm.status !== "validated") return false;
@@ -3372,7 +3468,7 @@ function buildDashboard(memories, usage, options = {}) {
     if (isDecaying(memUsage, fm.created_at)) decaying += 1;
     if (impact.tier === "dormant") {
       const anchor = memUsage.last_read_at ?? fm.created_at;
-      const ageDays = Math.floor((now.getTime() - new Date(anchor).getTime()) / MS_PER_DAY3);
+      const ageDays = Math.floor((now.getTime() - new Date(anchor).getTime()) / MS_PER_DAY4);
       dormantRows.push({ id: fm.id, last_read_at: memUsage.last_read_at, age_days: ageDays });
     }
   }
@@ -3411,7 +3507,12 @@ function buildDashboard(memories, usage, options = {}) {
     prevention: {
       total_events: preventionEvents,
       memories_with_catches: preventionRows.length,
-      top: preventionRows.sort((a, b) => b.prevented_count - a.prevented_count).slice(0, top)
+      top: preventionRows.sort((a, b) => b.prevented_count - a.prevented_count).slice(0, top),
+      trend: computePreventionTrend(options.preventionEvents ?? [], now),
+      recurrence: {
+        ...computeRecurrence(options.preventionEvents ?? []),
+        top: computeRecurrence(options.preventionEvents ?? []).top.slice(0, top)
+      }
     },
     corpus: {
       memory_files: inventory.total,
@@ -3446,6 +3547,7 @@ export {
   MemoryTypeSchema,
   PREVENTION_DEBOUNCE_MS,
   PROJECT_CONTEXT_FILE,
+  PROJECT_CONTEXT_THROTTLE_MS,
   RUNTIME_JOURNAL_FILENAME,
   SESSION_RECAP_TTL_MS,
   STACK_PACK_TAG,
@@ -3459,6 +3561,7 @@ export {
   aggregateUsage,
   allocateBudget,
   antiPatternGateParams,
+  appendPreventionEvent,
   appendRuntimeJournalEntry,
   appendUsageEvent,
   briefingMarkerPath,
@@ -3475,6 +3578,8 @@ export {
   compareImpact,
   compileRegexSensor,
   computeImpact,
+  computePreventionTrend,
+  computeRecurrence,
   configPath,
   contractLockPath,
   deriveConfidence,
@@ -3499,6 +3604,7 @@ export {
   getUsage,
   globToRegExp,
   hasRecentBriefingMarker,
+  hashProjectContext,
   inferModulesFromPaths,
   isAutoPromoteEligible,
   isDecaying,
@@ -3518,6 +3624,7 @@ export {
   loadConfigSync,
   loadMemoriesFromDir,
   loadMemory,
+  loadPreventionEvents,
   loadUsageIndex,
   memoryFilePath,
   memoryMatchesAnchorPaths,
@@ -3532,6 +3639,8 @@ export {
   parseSonar,
   pathsOverlap,
   pickSnippetNeedle,
+  preventionLogPath,
+  projectContextRecentlyEmitted,
   pullCrossRepoSources,
   queryCodeMap,
   rankMemoriesLexical,
@@ -3540,6 +3649,7 @@ export {
   readUsageEvents,
   recordApplied,
   recordPrevention,
+  recordProjectContextEmission,
   recordRejection,
   relPathFrom,
   resolveBriefingBudget,