engrm 0.4.5 → 0.4.7

package/dist/hooks/post-tool-use.js

@@ -1537,6 +1537,80 @@ function findDuplicate(newTitle, candidates) {
   return bestMatch;
 }
 
+// src/capture/facts.ts
+var FACT_ELIGIBLE_TYPES = new Set([
+  "bugfix",
+  "decision",
+  "discovery",
+  "pattern",
+  "feature",
+  "refactor",
+  "change"
+]);
+function buildStructuredFacts(input) {
+  const seedFacts = dedupeFacts(input.facts ?? []);
+  if (!FACT_ELIGIBLE_TYPES.has(input.type)) {
+    return seedFacts;
+  }
+  const derived = [...seedFacts];
+  if (seedFacts.length === 0 && looksMeaningful(input.title)) {
+    derived.push(input.title.trim());
+  }
+  for (const sentence of extractNarrativeFacts(input.narrative)) {
+    derived.push(sentence);
+  }
+  const fileFact = buildFilesFact(input.filesModified);
+  if (fileFact) {
+    derived.push(fileFact);
+  }
+  return dedupeFacts(derived).slice(0, 4);
+}
+function extractNarrativeFacts(narrative) {
+  if (!narrative)
+    return [];
+  const cleaned = narrative.replace(/\s+/g, " ").trim();
+  if (cleaned.length < 24)
+    return [];
+  const parts = cleaned.split(/(?<=[.!?;])\s+/).map((part) => part.trim().replace(/[.!?;]+$/, "")).filter(Boolean).filter(looksMeaningful);
+  return parts.slice(0, 2);
+}
+function buildFilesFact(filesModified) {
+  if (!filesModified || filesModified.length === 0)
+    return null;
+  const cleaned = filesModified.map((file) => file.trim()).filter(Boolean).slice(0, 3);
+  if (cleaned.length === 0)
+    return null;
+  if (cleaned.length === 1) {
+    return `Touched ${cleaned[0]}`;
+  }
+  return `Touched ${cleaned.join(", ")}`;
+}
+function dedupeFacts(facts) {
+  const seen = new Set;
+  const result = [];
+  for (const fact of facts) {
+    const cleaned = fact.trim().replace(/\s+/g, " ");
+    if (!looksMeaningful(cleaned))
+      continue;
+    const key = cleaned.toLowerCase().replace(/\([^)]*\)/g, "").replace(/\s+/g, " ").trim();
+    if (!key || seen.has(key))
+      continue;
+    seen.add(key);
+    result.push(cleaned);
+  }
+  return result;
+}
+function looksMeaningful(value) {
+  const cleaned = value.trim();
+  if (cleaned.length < 12)
+    return false;
+  if (/^[A-Za-z0-9_.\-\/]+\.[A-Za-z0-9]+$/.test(cleaned))
+    return false;
+  if (/^(updated|modified|edited|changed|touched)\s+[A-Za-z0-9_.\-\/]+$/i.test(cleaned))
+    return false;
+  return true;
+}
+
 // src/storage/projects.ts
 import { execSync } from "node:child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
@@ -1917,10 +1991,17 @@ async function saveObservation(db, config, input) {
   const customPatterns = config.scrubbing.enabled ? config.scrubbing.custom_patterns : [];
   const title = config.scrubbing.enabled ? scrubSecrets(input.title, customPatterns) : input.title;
   const narrative = input.narrative ? config.scrubbing.enabled ? scrubSecrets(input.narrative, customPatterns) : input.narrative : null;
-  const factsJson = input.facts ? config.scrubbing.enabled ? scrubSecrets(JSON.stringify(input.facts), customPatterns) : JSON.stringify(input.facts) : null;
   const conceptsJson = input.concepts ? JSON.stringify(input.concepts) : null;
   const filesRead = input.files_read ? input.files_read.map((f) => toRelativePath(f, cwd)) : null;
   const filesModified = input.files_modified ? input.files_modified.map((f) => toRelativePath(f, cwd)) : null;
+  const structuredFacts = buildStructuredFacts({
+    type: input.type,
+    title: input.title,
+    narrative: input.narrative,
+    facts: input.facts,
+    filesModified
+  });
+  const factsJson = structuredFacts.length > 0 ? config.scrubbing.enabled ? scrubSecrets(JSON.stringify(structuredFacts), customPatterns) : JSON.stringify(structuredFacts) : null;
   const filesReadJson = filesRead ? JSON.stringify(filesRead) : null;
   const filesModifiedJson = filesModified ? JSON.stringify(filesModified) : null;
   let sensitivity = input.sensitivity ?? config.scrubbing.default_sensitivity;

package/dist/hooks/pre-compact.js

@@ -1343,13 +1343,40 @@ function findStaleDecisionsGlobal(db, options) {
   return stale.slice(0, 5);
 }
 
-// src/context/inject.ts
+// src/intelligence/observation-priority.ts
 var RECENCY_WINDOW_SECONDS = 30 * 86400;
 function computeBlendedScore(quality, createdAtEpoch, nowEpoch) {
   const age = nowEpoch - createdAtEpoch;
   const recencyNorm = Math.max(0, Math.min(1, 1 - age / RECENCY_WINDOW_SECONDS));
   return quality * 0.6 + recencyNorm * 0.4;
 }
+function observationTypeBoost(type) {
+  switch (type) {
+    case "decision":
+      return 0.2;
+    case "pattern":
+      return 0.18;
+    case "bugfix":
+      return 0.14;
+    case "feature":
+      return 0.12;
+    case "discovery":
+      return 0.1;
+    case "refactor":
+      return 0.05;
+    case "digest":
+      return 0.03;
+    case "change":
+      return 0;
+    default:
+      return 0;
+  }
+}
+function computeObservationPriority(obs, nowEpoch) {
+  return computeBlendedScore(obs.quality, obs.created_at_epoch, nowEpoch) + observationTypeBoost(obs.type);
+}
+
+// src/context/inject.ts
 function estimateTokens(text) {
   if (!text)
     return 0;
@@ -1442,10 +1469,8 @@ function buildSessionContext(db, cwd, options = {}) {
   }
   const nowEpoch = Math.floor(Date.now() / 1000);
   const sorted = [...deduped].sort((a, b) => {
-    const boostA = a.type === "digest" ? 0.15 : 0;
-    const boostB = b.type === "digest" ? 0.15 : 0;
-    const scoreA = computeBlendedScore(a.quality, a.created_at_epoch, nowEpoch) + boostA;
-    const scoreB = computeBlendedScore(b.quality, b.created_at_epoch, nowEpoch) + boostB;
+    const scoreA = computeObservationPriority(a, nowEpoch);
+    const scoreB = computeObservationPriority(b, nowEpoch);
     return scoreB - scoreA;
   });
   const projectName = project?.name ?? detected.name;

package/dist/hooks/session-start.js

@@ -322,13 +322,40 @@ function findStaleDecisionsGlobal(db, options) {
   return stale.slice(0, 5);
 }
 
-// src/context/inject.ts
+// src/intelligence/observation-priority.ts
 var RECENCY_WINDOW_SECONDS = 30 * 86400;
 function computeBlendedScore(quality, createdAtEpoch, nowEpoch) {
   const age = nowEpoch - createdAtEpoch;
   const recencyNorm = Math.max(0, Math.min(1, 1 - age / RECENCY_WINDOW_SECONDS));
   return quality * 0.6 + recencyNorm * 0.4;
 }
+function observationTypeBoost(type) {
+  switch (type) {
+    case "decision":
+      return 0.2;
+    case "pattern":
+      return 0.18;
+    case "bugfix":
+      return 0.14;
+    case "feature":
+      return 0.12;
+    case "discovery":
+      return 0.1;
+    case "refactor":
+      return 0.05;
+    case "digest":
+      return 0.03;
+    case "change":
+      return 0;
+    default:
+      return 0;
+  }
+}
+function computeObservationPriority(obs, nowEpoch) {
+  return computeBlendedScore(obs.quality, obs.created_at_epoch, nowEpoch) + observationTypeBoost(obs.type);
+}
+
+// src/context/inject.ts
 function estimateTokens(text) {
   if (!text)
     return 0;
@@ -421,10 +448,8 @@ function buildSessionContext(db, cwd, options = {}) {
   }
   const nowEpoch = Math.floor(Date.now() / 1000);
   const sorted = [...deduped].sort((a, b) => {
-    const boostA = a.type === "digest" ? 0.15 : 0;
-    const boostB = b.type === "digest" ? 0.15 : 0;
-    const scoreA = computeBlendedScore(a.quality, a.created_at_epoch, nowEpoch) + boostA;
-    const scoreB = computeBlendedScore(b.quality, b.created_at_epoch, nowEpoch) + boostB;
+    const scoreA = computeObservationPriority(a, nowEpoch);
+    const scoreB = computeObservationPriority(b, nowEpoch);
     return scoreB - scoreA;
   });
   const projectName = project?.name ?? detected.name;
@@ -2497,17 +2522,22 @@ function formatSplashScreen(data) {
 function formatVisibleStartupBrief(context) {
   const lines = [];
   const latest = pickBestSummary(context);
+  const observationFallbacks = buildObservationFallbacks(context);
   if (latest) {
     const sections = [
-      ["Investigated", latest.investigated],
-      ["Learned", latest.learned],
-      ["Completed", latest.completed],
-      ["Next Steps", latest.next_steps]
+      ["Request", chooseRequest(latest.request, observationFallbacks.request), 1],
+      ["Investigated", chooseSection(latest.investigated, observationFallbacks.investigated, "Investigated"), 2],
+      ["Learned", latest.learned, 2],
+      ["Completed", chooseSection(latest.completed, observationFallbacks.completed, "Completed"), 2],
+      ["Next Steps", latest.next_steps, 2]
     ];
-    for (const [label, value] of sections) {
-      const formatted = toSplashBullet(value, label === "Next Steps" ? 140 : 180);
-      if (formatted) {
-        lines.push(`${c2.cyan}${label}:${c2.reset} ${formatted}`);
+    for (const [label, value, maxItems] of sections) {
+      const formatted = toSplashLines(value, maxItems ?? 2);
+      if (formatted.length > 0) {
+        lines.push(`${c2.cyan}${label}:${c2.reset}`);
+        for (const item of formatted) {
+          lines.push(`  ${item}`);
+        }
       }
     }
   }
@@ -2516,21 +2546,19 @@ function formatVisibleStartupBrief(context) {
     lines.push(`${c2.yellow}Watch:${c2.reset} ${truncateInline(`Decision still looks unfinished: ${stale.title}`, 170)}`);
   }
   if (lines.length === 0 && context.observations.length > 0) {
-    const top = context.observations.slice(0, 2);
+    const top = context.observations.filter((obs) => obs.type !== "digest").filter((obs) => !looksLikeFileOperationTitle(obs.title)).slice(0, 2);
     for (const obs of top) {
       lines.push(`${c2.cyan}${capitalize(obs.type)}:${c2.reset} ${truncateInline(obs.title, 170)}`);
     }
   }
-  return lines.slice(0, 5);
+  return lines.slice(0, 10);
 }
-function toSplashBullet(value, maxLen) {
+function toSplashLines(value, maxItems) {
   if (!value)
-    return null;
-  const cleaned = dedupeFragments(value.split(`
-`).map((line) => line.trim().replace(/^[-*]\s*/, "")).filter(Boolean).join("; "));
-  if (!cleaned)
-    return null;
-  return truncateInline(cleaned, maxLen);
+    return [];
+  const lines = value.split(`
+`).map((line) => line.trim()).filter(Boolean).map((line) => line.replace(/^[-*]\s*/, "")).map((line) => stripInlineSectionLabel(line)).map((line) => dedupeFragments(line)).filter(Boolean).sort((a, b) => scoreSplashLine(b) - scoreSplashLine(a)).slice(0, maxItems).map((line) => `- ${truncateInline(line, 140)}`);
+  return dedupeFragmentsInLines(lines);
 }
 function pickBestSummary(context) {
   const summaries = context.summaries || [];
@@ -2572,6 +2600,83 @@ function dedupeFragments(text) {
   }
   return deduped.join("; ");
 }
+function dedupeFragmentsInLines(lines) {
+  const seen = new Set;
+  const deduped = [];
+  for (const line of lines) {
+    const normalized = stripInlineSectionLabel(line).toLowerCase().replace(/\s+/g, " ").trim();
+    if (!normalized || seen.has(normalized))
+      continue;
+    seen.add(normalized);
+    deduped.push(line);
+  }
+  return deduped;
+}
+function chooseRequest(primary, fallback) {
+  if (primary && !looksLikeFileOperationTitle(primary))
+    return primary;
+  return fallback;
+}
+function chooseSection(primary, fallback, label) {
+  if (!primary)
+    return fallback;
+  if (label === "Completed" && isWeakCompletedSection(primary))
+    return fallback || primary;
+  if (label === "Investigated" && sectionItemCount(primary) === 0)
+    return fallback;
+  return primary;
+}
+function isWeakCompletedSection(value) {
+  const items = value.split(`
+`).map((line) => line.trim().replace(/^[-*]\s*/, "")).filter(Boolean);
+  if (!items.length)
+    return true;
+  const weakCount = items.filter((item) => looksLikeFileOperationTitle(item)).length;
+  return weakCount === items.length;
+}
+function looksLikeFileOperationTitle(value) {
+  return /^(modified|updated|edited|touched|changed|extended|refactored|redesigned)\s+[A-Za-z0-9_.\-\/]+(?:\s*\([^)]*\))?$/i.test(value.trim());
+}
+function scoreSplashLine(value) {
+  let score = 0;
+  if (!looksLikeFileOperationTitle(value))
+    score += 2;
+  if (/[:;]/.test(value))
+    score += 1;
+  if (value.length > 30)
+    score += 0.5;
+  return score;
+}
+function buildObservationFallbacks(context) {
+  const request = context.observations.find((obs) => !looksLikeFileOperationTitle(obs.title))?.title ?? null;
+  const investigated = collectObservationTitles(context, (obs) => obs.type === "discovery", 2);
+  const completed = collectObservationTitles(context, (obs) => ["feature", "refactor", "change"].includes(obs.type) && !looksLikeFileOperationTitle(obs.title), 2);
+  return {
+    request,
+    investigated,
+    completed
+  };
+}
+function collectObservationTitles(context, predicate, limit) {
+  const seen = new Set;
+  const picked = [];
+  for (const obs of context.observations) {
+    if (!predicate(obs))
+      continue;
+    const normalized = stripInlineSectionLabel(obs.title).toLowerCase().replace(/\s+/g, " ").trim();
+    if (!normalized || seen.has(normalized))
+      continue;
+    seen.add(normalized);
+    picked.push(`- ${stripInlineSectionLabel(obs.title)}`);
+    if (picked.length >= limit)
+      break;
+  }
+  return picked.length ? picked.join(`
+`) : null;
+}
+function stripInlineSectionLabel(value) {
+  return value.replace(/^(request|investigated|learned|completed|next steps|digest|summary):\s*/i, "").trim();
+}
 function pickRelevantStaleDecision(context, summary) {
   const stale = context.staleDecisions || [];
   if (!stale.length)