engrm 0.4.25 → 0.4.27

package/README.md

@@ -212,8 +212,8 @@ The MCP server exposes tools that supported agents can call directly:
 | `memory_stats` | View high-level capture and sync health |
 | `capture_status` | Check whether local hooks are registered and raw prompt/tool chronology is actually being captured |
 | `activity_feed` | Inspect one chronological local feed across prompts, tools, chat, handoffs, observations, and summaries |
-| `memory_console` | Show a high-signal local memory console for the current project |
-| `project_memory_index` | Show typed local memory by project, including hot files and recent sessions |
+| `memory_console` | Show a high-signal local memory console for the current project, including continuity state |
+| `project_memory_index` | Show typed local memory by project, including hot files, recent sessions, and continuity state |
 | `workspace_memory_index` | Show cross-project local memory coverage across the whole workspace |
 | `tool_memory_index` | Show which source tools and plugins are creating durable memory |
 | `session_tool_memory` | Show which tools in one session produced reusable memory and which produced none |
@@ -228,6 +228,7 @@ The MCP server exposes tools that supported agents can call directly:
 | `refresh_chat_recall` | Rehydrate the separate chat lane from a Claude transcript when a long session feels under-captured |
 | `recent_chat` | Inspect the separate synced chat lane without mixing it into durable memory |
 | `search_chat` | Search recent chat recall separately from reusable memory observations |
+| `search_recall` | Search durable memory and chat recall together when you do not want to guess the right lane |
 | `plugin_catalog` | Inspect Engrm plugin manifests for memory-aware integrations |
 | `save_plugin_memory` | Save reduced plugin output with stable Engrm provenance |
 | `capture_git_diff` | Reduce a git diff into a durable memory object and save it |
@@ -357,14 +358,18 @@ Recommended flow:
 What each tool is good for:
 
 - `capture_status` tells you whether prompt/tool hooks are live on this machine
-- `memory_console` gives the quickest project snapshot
+- `capture_quality` shows whether chat recall is transcript-backed or still hook-only across the workspace
+- `memory_console` gives the quickest project snapshot, including whether continuity is `fresh`, `thin`, or `cold`
+- `memory_console`, `project_memory_index`, and `session_context` now also show whether project chat recall is transcript-backed or only hook-captured
+- when chat continuity is only hook-captured, the workbench and startup hints now prefer `refresh_chat_recall`
 - `activity_feed` shows the merged chronology across prompts, tools, chat, handoffs, observations, and summaries
 - `recent_sessions` helps you pick a session worth opening
 - `session_story` reconstructs one session in detail, including handoffs and chat recall
 - `tool_memory_index` shows which tools and plugins are actually producing durable memory
 - `session_tool_memory` shows which tool calls in one session turned into reusable memory and which did not
-- `project_memory_index` shows typed memory by repo
+- `project_memory_index` shows typed memory by repo, including continuity state and hot files
 - `workspace_memory_index` shows coverage across all repos on the machine
+- `recent_chat` / `search_chat` now report transcript-vs-hook coverage too, so weak OpenClaw recall is easier to diagnose and refresh
 
 ### Thin Tool Workflow
 

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

@@ -3831,6 +3831,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -3928,6 +3930,12 @@ function collectProvenanceSummary(observations) {
   }
   return Array.from(counts.entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
 }
+function summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function upsertRollingHandoff(db, config, input) {

package/dist/hooks/pre-compact.js

@@ -2154,6 +2154,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -2251,6 +2253,12 @@ function collectProvenanceSummary(observations) {
   }
   return Array.from(counts.entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
 }
+function summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";
@@ -3225,6 +3233,7 @@ function compactLine(value) {
 }
 
 // src/context/inject.ts
+var FRESH_CONTINUITY_WINDOW_DAYS = 3;
 function tokenizeProjectHint(text) {
   return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
 }
@@ -3364,20 +3373,21 @@ function buildSessionContext(db, cwd, options = {}) {
   const canonicalId = project?.canonical_id ?? detected.canonical_id;
   if (maxCount !== undefined) {
     const remaining = Math.max(0, maxCount - pinned.length - dedupedRecent.length);
-    const all = [...pinned, ...dedupedRecent, ...sorted.slice(0, remaining)];
-    const recentPrompts2 = db.getRecentUserPrompts(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
-    const recentToolEvents2 = db.getRecentToolEvents(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
+    let all = [...pinned, ...dedupedRecent, ...sorted.slice(0, remaining)];
+    const recentPrompts2 = isNewProject ? [] : db.getRecentUserPrompts(projectId, 6, opts.userId);
+    const recentToolEvents2 = isNewProject ? [] : db.getRecentToolEvents(projectId, 6, opts.userId);
     const recentSessions2 = isNewProject ? [] : db.getRecentSessions(projectId, 5, opts.userId);
     const projectTypeCounts2 = isNewProject ? undefined : getProjectTypeCounts(db, projectId, opts.userId);
     const recentOutcomes2 = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions2);
-    const recentHandoffs2 = getRecentHandoffs(db, {
+    const recentHandoffs2 = isNewProject ? [] : getRecentHandoffs(db, {
       cwd,
-      project_scoped: !isNewProject,
+      project_scoped: true,
       user_id: opts.userId,
       current_device_id: opts.currentDeviceId,
       limit: 3
     }).handoffs;
     const recentChatMessages2 = !isNewProject && project ? db.getRecentChatMessages(project.id, 4, opts.userId) : [];
+    all = filterAutoLoadedObservationsForContinuity(all, pinned, isNewProject, recentPrompts2, recentToolEvents2, recentSessions2, recentHandoffs2, recentChatMessages2, summariesFromRecentSessions(db, projectId, recentSessions2));
     return {
       project_name: projectName,
       canonical_id: canonicalId,
@@ -3413,19 +3423,20 @@ function buildSessionContext(db, cwd, options = {}) {
     selected.push(obs);
   }
   const summaries = isNewProject ? [] : db.getRecentSummaries(projectId, 5);
-  const recentPrompts = db.getRecentUserPrompts(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
-  const recentToolEvents = db.getRecentToolEvents(isNewProject ? null : projectId, isNewProject ? 8 : 6, opts.userId);
+  const recentPrompts = isNewProject ? [] : db.getRecentUserPrompts(projectId, 6, opts.userId);
+  const recentToolEvents = isNewProject ? [] : db.getRecentToolEvents(projectId, 6, opts.userId);
   const recentSessions = isNewProject ? [] : db.getRecentSessions(projectId, 5, opts.userId);
   const projectTypeCounts = isNewProject ? undefined : getProjectTypeCounts(db, projectId, opts.userId);
   const recentOutcomes = isNewProject ? undefined : getRecentOutcomes(db, projectId, opts.userId, recentSessions);
-  const recentHandoffs = getRecentHandoffs(db, {
+  const recentHandoffs = isNewProject ? [] : getRecentHandoffs(db, {
     cwd,
-    project_scoped: !isNewProject,
+    project_scoped: true,
     user_id: opts.userId,
     current_device_id: opts.currentDeviceId,
     limit: 3
   }).handoffs;
   const recentChatMessages = !isNewProject ? db.getRecentChatMessages(projectId, 4, opts.userId) : [];
+  const filteredSelected = filterAutoLoadedObservationsForContinuity(selected, pinned, isNewProject, recentPrompts, recentToolEvents, recentSessions, recentHandoffs, recentChatMessages, summaries);
   let securityFindings = [];
   if (!isNewProject) {
     try {
@@ -3473,8 +3484,8 @@ function buildSessionContext(db, cwd, options = {}) {
   return {
     project_name: projectName,
     canonical_id: canonicalId,
-    observations: selected.map(toContextObservation),
-    session_count: selected.length,
+    observations: filteredSelected.map(toContextObservation),
+    session_count: filteredSelected.length,
     total_active: totalActive,
     summaries: summaries.length > 0 ? summaries : undefined,
     securityFindings: securityFindings.length > 0 ? securityFindings : undefined,
@@ -3489,6 +3500,39 @@ function buildSessionContext(db, cwd, options = {}) {
     recentChatMessages: recentChatMessages.length > 0 ? recentChatMessages : undefined
   };
 }
+function filterAutoLoadedObservationsForContinuity(observations, pinned, isNewProject, recentPrompts, recentToolEvents, recentSessions, recentHandoffs, recentChatMessages, summaries) {
+  if (isNewProject)
+    return observations;
+  if (hasFreshProjectContinuity(recentPrompts, recentToolEvents, recentSessions, recentHandoffs, recentChatMessages, summaries)) {
+    return observations;
+  }
+  const pinnedIds = new Set(pinned.map((obs) => obs.id));
+  return observations.filter((obs) => {
+    if (pinnedIds.has(obs.id))
+      return true;
+    return observationAgeDays(obs.created_at_epoch) <= FRESH_CONTINUITY_WINDOW_DAYS;
+  });
+}
+function hasFreshProjectContinuity(recentPrompts, recentToolEvents, recentSessions, recentHandoffs, recentChatMessages, summaries) {
+  const freshEnough = (epoch) => typeof epoch === "number" && observationAgeDays(epoch) <= FRESH_CONTINUITY_WINDOW_DAYS;
+  return recentPrompts.some((item) => freshEnough(item.created_at_epoch)) || recentToolEvents.some((item) => freshEnough(item.created_at_epoch)) || recentSessions.some((item) => freshEnough(item.completed_at_epoch ?? item.started_at_epoch)) || recentHandoffs.some((item) => freshEnough(item.created_at_epoch)) || recentChatMessages.some((item) => freshEnough(item.created_at_epoch)) || summaries.some((item) => freshEnough(item.created_at_epoch));
+}
+function summariesFromRecentSessions(db, projectId, recentSessions) {
+  const seen = new Set;
+  const rows = [];
+  for (const session of recentSessions) {
+    if (seen.has(session.session_id))
+      continue;
+    seen.add(session.session_id);
+    const summary = db.getSessionSummary(session.session_id);
+    if (summary && summary.project_id === projectId)
+      rows.push(summary);
+  }
+  return rows;
+}
+function observationAgeDays(createdAtEpoch) {
+  return Math.max(0, (Math.floor(Date.now() / 1000) - createdAtEpoch) / 86400);
+}
 function estimateObservationTokens(obs, index) {
   const DETAILED_THRESHOLD = 5;
   const titleCost = estimateTokens(`- **[${obs.type}]** ${obs.title} (2026-01-01, q=0.5)`);