engrm 0.4.6 → 0.4.7

package/dist/cli.js

@@ -1072,6 +1072,31 @@ function getOutboxStats(db) {
   return stats;
 }
 
+// src/intelligence/value-signals.ts
+var LESSON_TYPES = new Set(["bugfix", "decision", "pattern"]);
+function computeSessionValueSignals(observations, securityFindings = []) {
+  const decisionsCount = observations.filter((o) => o.type === "decision").length;
+  const lessonsCount = observations.filter((o) => LESSON_TYPES.has(o.type)).length;
+  const discoveriesCount = observations.filter((o) => o.type === "discovery").length;
+  const featuresCount = observations.filter((o) => o.type === "feature").length;
+  const refactorsCount = observations.filter((o) => o.type === "refactor").length;
+  const repeatedPatternsCount = observations.filter((o) => o.type === "pattern").length;
+  const hasRequestSignal = observations.some((o) => ["feature", "decision", "change", "bugfix", "discovery"].includes(o.type));
+  const hasCompletionSignal = observations.some((o) => ["feature", "change", "refactor", "bugfix"].includes(o.type));
+  return {
+    decisions_count: decisionsCount,
+    lessons_count: lessonsCount,
+    discoveries_count: discoveriesCount,
+    features_count: featuresCount,
+    refactors_count: refactorsCount,
+    repeated_patterns_count: repeatedPatternsCount,
+    security_findings_count: securityFindings.length,
+    critical_security_findings_count: securityFindings.filter((f) => f.severity === "critical").length,
+    delivery_review_ready: hasRequestSignal && hasCompletionSignal,
+    vibe_guardian_active: securityFindings.length > 0
+  };
+}
+
 // src/storage/migrations.ts
 var MIGRATIONS2 = [
   {
@@ -2104,6 +2129,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 existsSync3, readFileSync as readFileSync3 } from "node:fs";
@@ -2495,10 +2594,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;
@@ -3195,6 +3301,27 @@ function handleStatus() {
       } catch {}
       const summaryCount = db.db.query("SELECT COUNT(*) as count FROM session_summaries").get()?.count ?? 0;
       console.log(`    Sessions:      ${summaryCount} summarised`);
+      try {
+        const activeObservations = db.db.query(`SELECT * FROM observations
+             WHERE lifecycle IN ('active', 'aging', 'pinned') AND superseded_by IS NULL`).all();
+        const securityFindings = db.db.query(`SELECT * FROM security_findings
+             ORDER BY created_at_epoch DESC
+             LIMIT 500`).all();
+        const signals = computeSessionValueSignals(activeObservations, securityFindings);
+        const signalParts = [
+          `lessons: ${signals.lessons_count}`,
+          `decisions: ${signals.decisions_count}`,
+          `discoveries: ${signals.discoveries_count}`,
+          `features: ${signals.features_count}`
+        ];
+        if (signals.repeated_patterns_count > 0) {
+          signalParts.push(`patterns: ${signals.repeated_patterns_count}`);
+        }
+        console.log(`    Value:         ${signalParts.join(", ")}`);
+        if (signals.security_findings_count > 0 || signals.delivery_review_ready) {
+          console.log(`    Review/Safety: ${signals.delivery_review_ready ? "delivery-ready" : "not ready"}, ` + `${signals.security_findings_count} finding${signals.security_findings_count === 1 ? "" : "s"}`);
+        }
+      } catch {}
       try {
         const lastSummary = db.db.query(`SELECT request, created_at_epoch FROM session_summaries
              ORDER BY created_at_epoch DESC LIMIT 1`).get();

package/dist/hooks/elicitation-result.js

@@ -250,6 +250,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, readFileSync } from "node:fs";
@@ -630,10 +704,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/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;
@@ -2521,7 +2546,7 @@ 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.filter((obs) => !looksLikeFileOperationTitle(obs.title)).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)}`);
     }
@@ -2532,7 +2557,7 @@ function toSplashLines(value, maxItems) {
   if (!value)
     return [];
   const lines = value.split(`
-`).map((line) => line.trim()).filter(Boolean).map((line) => line.replace(/^[-*]\s*/, "")).map((line) => dedupeFragments(line)).filter(Boolean).sort((a, b) => scoreSplashLine(b) - scoreSplashLine(a)).slice(0, maxItems).map((line) => `- ${truncateInline(line, 140)}`);
+`).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) {
@@ -2579,7 +2604,7 @@ function dedupeFragmentsInLines(lines) {
   const seen = new Set;
   const deduped = [];
   for (const line of lines) {
-    const normalized = line.toLowerCase().replace(/\s+/g, " ").trim();
+    const normalized = stripInlineSectionLabel(line).toLowerCase().replace(/\s+/g, " ").trim();
     if (!normalized || seen.has(normalized))
       continue;
     seen.add(normalized);
@@ -2625,7 +2650,7 @@ function scoreSplashLine(value) {
 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", "digest"].includes(obs.type) && !looksLikeFileOperationTitle(obs.title), 2);
+  const completed = collectObservationTitles(context, (obs) => ["feature", "refactor", "change"].includes(obs.type) && !looksLikeFileOperationTitle(obs.title), 2);
   return {
     request,
     investigated,
@@ -2638,17 +2663,20 @@ function collectObservationTitles(context, predicate, limit) {
   for (const obs of context.observations) {
     if (!predicate(obs))
       continue;
-    const normalized = obs.title.toLowerCase().replace(/\s+/g, " ").trim();
+    const normalized = stripInlineSectionLabel(obs.title).toLowerCase().replace(/\s+/g, " ").trim();
     if (!normalized || seen.has(normalized))
       continue;
     seen.add(normalized);
-    picked.push(`- ${obs.title}`);
+    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)