engrm 0.4.3 → 0.4.5

package/README.md

@@ -1,6 +1,6 @@
 # Engrm
 
-**Cross-device memory for AI coding agents.** Every session remembers what you learned yesterday — on any machine, for every team member.
+**Shared memory and delivery review for AI coding agents.** Engrm keeps context, decisions, and project state moving across your machines, your team, and the agents you switch between.
 
 For npm users, Engrm runs on Node.js 18+ and does not require Bun to be installed.
 
@@ -8,17 +8,18 @@ For npm users, Engrm runs on Node.js 18+ and does not require Bun to be installe
 npx engrm init
 ```
 
-Public beta. The current source of truth for agent capability differences is [AGENT_SUPPORT.md](AGENT_SUPPORT.md).
+Public beta. Engrm is built for Claude Code, Codex, OpenClaw skills, and other MCP-native coding workflows. The current source of truth for agent capability differences is [AGENT_SUPPORT.md](AGENT_SUPPORT.md).
 
 ---
 
 ## What It Does
 
-Your AI agent forgets everything between sessions. Engrm fixes that.
+Your AI agent forgets everything between sessions. Engrm fixes that, and helps you check whether the work really matched the brief.
 
-- **Captures automatically** — hooks into Claude Code, and into Codex where its public hook surface allows
+- **Works across agents** — Claude Code and Codex integrate directly, and OpenClaw can use Engrm through published skill bundles
 - **Remembers across devices** — fix a bug on your laptop, continue on your desktop with full context
 - **Shares with your team** — one developer's hard-won insight becomes everyone's knowledge
+- **Reviews delivery** — tie plans, decisions, and sessions together so you can see what actually shipped
 - **Works offline** — local SQLite is the source of truth; syncs when connected
 - **Guards your code** — Sentinel audits changes in real-time before they land
 
@@ -34,7 +35,7 @@ Visit [engrm.dev](https://engrm.dev) and create an account.
 npx engrm init
 ```
 
-This opens your browser for authentication, writes config to `~/.engrm/`, and registers Engrm in both Claude Code and Codex when those configs are available. Takes about 30 seconds.
+This opens your browser for authentication, writes config to `~/.engrm/`, and registers Engrm in Claude Code and Codex when those configs are available. OpenClaw support is provided through the packaged skills in [`openclaw/`](openclaw/). Takes about 30 seconds.
 
 **Alternative methods:**
 ```bash
@@ -54,7 +55,7 @@ That's it. Engrm works in the background:
 
 - **Session start** — injects relevant project memory into context
 - **While you work** — captures observations from tool use where the agent exposes that hook surface
-- **Session end** — generates a session digest, syncs to cloud, shows summary
+- **Session end** — generates a session digest, syncs to cloud, and turns recent work into a denser project brief
 
 ```
 ━━━ Engrm Session Summary ━━━
@@ -80,7 +81,7 @@ Engrm Status
   User:        david
   Email:       david@example.com
   Device:      macbook-a1b2c3d4
-  Plan:        Pro ($15/mo)
+  Plan:        Pro (£9.99/mo)
   Candengo:    https://www.candengo.com
   MCP server:  registered
   Codex MCP:   registered
@@ -135,19 +136,21 @@ Codex session
 
 ### Agent Support
 
-| Capability | Claude Code | Codex |
-|---|---|---|
-| MCP server tools | ✓ | ✓ |
-| Session-start context injection | ✓ | ✓ |
-| Stop/session summary hook | ✓ | ✓ |
-| Per-tool automatic capture | ✓ | Partial via MCP/manual flows only |
-| Pre-write Sentinel hook | ✓ | Not yet exposed by Codex public hooks |
-| Pre-compact reinjection | ✓ | Not exposed |
-| ElicitationResult capture | ✓ | Not exposed |
+| Capability | Claude Code | Codex | OpenClaw |
+|---|---|---|---|
+| MCP server tools | ✓ | ✓ | Via skills / MCP |
+| Session-start context injection | ✓ | ✓ | Via skill-guided workflow |
+| Stop/session summary hook | ✓ | ✓ | Via skill-guided workflow |
+| Per-tool automatic capture | ✓ | Partial via MCP/manual flows only | Manual / skill-guided |
+| Pre-write Sentinel hook | ✓ | Not yet exposed by Codex public hooks | Not exposed |
+| Pre-compact reinjection | ✓ | Not exposed | Not exposed |
+| ElicitationResult capture | ✓ | Not exposed | Not exposed |
+
+OpenClaw support is packaged in [`openclaw/`](openclaw/) as `engrm-memory`, `engrm-delivery-review`, and `engrm-sentinel` skills for ClawHub-style distribution.
 
 ### MCP Tools
 
-The MCP server exposes tools that Claude can call directly:
+The MCP server exposes tools that supported agents can call directly:
 
 | Tool | Purpose |
 |------|---------|
@@ -217,9 +220,9 @@ Observations age gracefully: **active** (30 days, full weight) → **aging** (0.
 
 | | Free | Vibe | Pro | Team |
 |---|---|---|---|---|
-| **Price** | $0 | $9/mo | $15/mo | £19/seat/mo |
-| **Observations** | 5,000 | 25,000 | Unlimited | Unlimited |
-| **Devices** | 1 | 3 | Unlimited | Unlimited |
+| **Price** | £0 | £5.99/mo | £9.99/mo | £12.99/seat/mo |
+| **Observations** | 5,000 | 25,000 | 100,000 | Unlimited |
+| **Devices** | 2 | 3 | 5 | Unlimited |
 | **Cloud sync** | ✓ | ✓ | ✓ | ✓ |
 | **Sentinel** | — | Advisory (50/day) | Advisory (200/day) | Blocking (unlimited) |
 | **Retention** | 30 days | 90 days | 1 year | Unlimited |

package/dist/hooks/session-start.js

@@ -2413,7 +2413,8 @@ async function main() {
         available: remaining,
         securityFindings: context.securityFindings?.length ?? 0,
         unreadMessages: msgCount,
-        synced: syncedCount
+        synced: syncedCount,
+        context
       });
       let packLine = "";
       try {
@@ -2481,8 +2482,180 @@ function formatSplashScreen(data) {
   }
   lines.push("");
   lines.push(`  ${c2.dim}Dashboard: https://engrm.dev/dashboard${c2.reset}`);
+  const brief = formatVisibleStartupBrief(data.context);
+  if (brief.length > 0) {
+    lines.push("");
+    lines.push(`  ${c2.bold}Startup brief${c2.reset}`);
+    for (const line of brief) {
+      lines.push(`  ${line}`);
+    }
+  }
   lines.push("");
   return lines.join(`
 `);
 }
+function formatVisibleStartupBrief(context) {
+  const lines = [];
+  const latest = pickBestSummary(context);
+  if (latest) {
+    const sections = [
+      ["Investigated", latest.investigated],
+      ["Learned", latest.learned],
+      ["Completed", latest.completed],
+      ["Next Steps", latest.next_steps]
+    ];
+    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}`);
+      }
+    }
+  }
+  const stale = pickRelevantStaleDecision(context, latest);
+  if (stale) {
+    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);
+    for (const obs of top) {
+      lines.push(`${c2.cyan}${capitalize(obs.type)}:${c2.reset} ${truncateInline(obs.title, 170)}`);
+    }
+  }
+  return lines.slice(0, 5);
+}
+function toSplashBullet(value, maxLen) {
+  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);
+}
+function pickBestSummary(context) {
+  const summaries = context.summaries || [];
+  if (!summaries.length)
+    return null;
+  return [...summaries].sort((a, b) => scoreSummary(b) - scoreSummary(a))[0] ?? null;
+}
+function scoreSummary(summary) {
+  let score = 0;
+  if (summary.request)
+    score += 3;
+  if (summary.investigated)
+    score += 4;
+  if (summary.learned)
+    score += 5;
+  if (summary.completed)
+    score += 5;
+  if (summary.next_steps)
+    score += 4;
+  score += Math.min(4, sectionItemCount(summary.completed) + sectionItemCount(summary.learned));
+  return score;
+}
+function sectionItemCount(value) {
+  if (!value)
+    return 0;
+  return value.split(`
+`).map((line) => line.trim()).filter(Boolean).length;
+}
+function dedupeFragments(text) {
+  const parts = text.split(";").map((part) => part.trim()).filter(Boolean);
+  const seen = new Set;
+  const deduped = [];
+  for (const part of parts) {
+    const normalized = part.toLowerCase();
+    if (seen.has(normalized))
+      continue;
+    seen.add(normalized);
+    deduped.push(part);
+  }
+  return deduped.join("; ");
+}
+function pickRelevantStaleDecision(context, summary) {
+  const stale = context.staleDecisions || [];
+  if (!stale.length)
+    return null;
+  const summaryText = [
+    summary?.request,
+    summary?.investigated,
+    summary?.learned,
+    summary?.completed,
+    summary?.next_steps
+  ].filter(Boolean).join(" ");
+  let best = null;
+  let bestScore = 0;
+  for (const item of stale) {
+    if ((item.days_ago ?? 999) > 21)
+      continue;
+    const overlap = keywordOverlap(item.title || "", summaryText);
+    const similarity = item.best_match_similarity ?? 0;
+    const score = overlap * 4 + similarity;
+    if (score > bestScore && overlap > 0) {
+      best = item;
+      bestScore = score;
+    }
+  }
+  return best;
+}
+function keywordOverlap(a, b) {
+  if (!a || !b)
+    return 0;
+  const stop = new Set([
+    "the",
+    "and",
+    "for",
+    "with",
+    "from",
+    "into",
+    "this",
+    "that",
+    "was",
+    "were",
+    "have",
+    "has",
+    "had",
+    "but",
+    "not",
+    "you",
+    "your",
+    "our",
+    "their",
+    "about",
+    "added",
+    "fixed",
+    "created",
+    "updated",
+    "modified",
+    "changed",
+    "investigate",
+    "next",
+    "steps",
+    "decision",
+    "still",
+    "looks",
+    "unfinished"
+  ]);
+  const wordsA = new Set(a.toLowerCase().match(/[a-z0-9_+-]{4,}/g)?.filter((w) => !stop.has(w)) || []);
+  const wordsB = new Set(b.toLowerCase().match(/[a-z0-9_+-]{4,}/g)?.filter((w) => !stop.has(w)) || []);
+  if (!wordsA.size || !wordsB.size)
+    return 0;
+  let overlap = 0;
+  for (const word of wordsA) {
+    if (wordsB.has(word))
+      overlap++;
+  }
+  return overlap / Math.max(1, Math.min(wordsA.size, wordsB.size));
+}
+function truncateInline(text, maxLen) {
+  const compact = text.replace(/\s+/g, " ").trim();
+  if (compact.length <= maxLen)
+    return compact;
+  return `${compact.slice(0, maxLen - 1).trimEnd()}\u2026`;
+}
+function capitalize(value) {
+  if (!value)
+    return value;
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
 runHook("session-start", main);

package/dist/hooks/stop.js

@@ -1475,10 +1475,14 @@ function buildSummaryVectorDocument(summary, config, project) {
   const parts = [];
   if (summary.request)
     parts.push(`Request: ${summary.request}`);
+  if (summary.investigated)
+    parts.push(`Investigated: ${summary.investigated}`);
   if (summary.learned)
     parts.push(`Learned: ${summary.learned}`);
   if (summary.completed)
     parts.push(`Completed: ${summary.completed}`);
+  if (summary.next_steps)
+    parts.push(`Next Steps: ${summary.next_steps}`);
   return {
     site_id: config.site_id,
     namespace: config.namespace,
@@ -1492,6 +1496,11 @@ function buildSummaryVectorDocument(summary, config, project) {
       project_name: project.name,
       user_id: summary.user_id,
       session_id: summary.session_id,
+      request: summary.request,
+      investigated: summary.investigated,
+      learned: summary.learned,
+      completed: summary.completed,
+      next_steps: summary.next_steps,
       created_at_epoch: summary.created_at_epoch,
       local_id: summary.id
     }

package/dist/server.js

@@ -16508,10 +16508,14 @@ function buildSummaryVectorDocument(summary, config2, project) {
   const parts = [];
   if (summary.request)
     parts.push(`Request: ${summary.request}`);
+  if (summary.investigated)
+    parts.push(`Investigated: ${summary.investigated}`);
   if (summary.learned)
     parts.push(`Learned: ${summary.learned}`);
   if (summary.completed)
     parts.push(`Completed: ${summary.completed}`);
+  if (summary.next_steps)
+    parts.push(`Next Steps: ${summary.next_steps}`);
   return {
     site_id: config2.site_id,
     namespace: config2.namespace,
@@ -16525,6 +16529,11 @@ function buildSummaryVectorDocument(summary, config2, project) {
       project_name: project.name,
       user_id: summary.user_id,
       session_id: summary.session_id,
+      request: summary.request,
+      investigated: summary.investigated,
+      learned: summary.learned,
+      completed: summary.completed,
+      next_steps: summary.next_steps,
       created_at_epoch: summary.created_at_epoch,
       local_id: summary.id
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Cross-device, team-shared memory layer for AI coding agents",
   "type": "module",
   "main": "dist/server.js",