engrm 0.4.13 → 0.4.15

package/dist/hooks/session-start.js

@@ -1154,7 +1154,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
 var STATE_PATH = join3(homedir(), ".engrm", "config-fingerprint.json");
-var CLIENT_VERSION = "0.4.13";
+var CLIENT_VERSION = "0.4.15";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -3135,7 +3135,7 @@ function formatSplashScreen(data) {
   const brief = formatVisibleStartupBrief(data.context);
   if (brief.length > 0) {
     lines.push("");
-    lines.push(`  ${c2.bold}Startup context${c2.reset}`);
+    lines.push(`  ${c2.bold}Handoff${c2.reset}`);
     for (const line of brief) {
       lines.push(`  ${line}`);
     }
@@ -3147,6 +3147,20 @@ function formatSplashScreen(data) {
       lines.push(`  ${line}`);
     }
   }
+  const legend = formatLegend();
+  if (legend.length > 0) {
+    lines.push("");
+    for (const line of legend) {
+      lines.push(`  ${line}`);
+    }
+  }
+  const contextIndex = formatContextIndex(data.context);
+  if (contextIndex.length > 0) {
+    lines.push("");
+    for (const line of contextIndex) {
+      lines.push(`  ${line}`);
+    }
+  }
   const inspectHints = formatInspectHints(data.context);
   if (inspectHints.length > 0) {
     lines.push("");
@@ -3172,7 +3186,7 @@ function formatVisibleStartupBrief(context) {
   const projectSignals = buildProjectSignalLine(context);
   const shownItems = new Set;
   if (promptLines.length > 0) {
-    lines.push(`${c2.cyan}Recent Requests:${c2.reset}`);
+    lines.push(`${c2.cyan}Asked recently:${c2.reset}`);
     for (const item of promptLines) {
       lines.push(`  - ${truncateInline(item, 160)}`);
       rememberShownItem(shownItems, item);
@@ -3204,13 +3218,13 @@ function formatVisibleStartupBrief(context) {
       }
     }
   } else if (currentRequest && !duplicatesPromptLine(currentRequest, latestPromptLine)) {
-    lines.push(`${c2.cyan}Current Request:${c2.reset}`);
+    lines.push(`${c2.cyan}What you're on:${c2.reset}`);
     lines.push(`  - ${truncateInline(currentRequest, 160)}`);
     rememberShownItem(shownItems, currentRequest);
     if (toolFallbacks.length > 0) {
       const additiveTools = filterAdditiveToolFallbacks(toolFallbacks, shownItems);
       if (additiveTools.length > 0) {
-        lines.push(`${c2.cyan}Recent Tools:${c2.reset}`);
+        lines.push(`${c2.cyan}Tool trail:${c2.reset}`);
         for (const item of additiveTools) {
           lines.push(`  - ${truncateInline(item, 160)}`);
           rememberShownItem(shownItems, item);
@@ -3219,12 +3233,12 @@ function formatVisibleStartupBrief(context) {
     }
   }
   if (latest && currentRequest && !hasRequestSection(lines) && !duplicatesPromptLine(currentRequest, latestPromptLine)) {
-    lines.push(`${c2.cyan}Current Request:${c2.reset}`);
+    lines.push(`${c2.cyan}What you're on:${c2.reset}`);
     lines.push(`  - ${truncateInline(currentRequest, 160)}`);
     rememberShownItem(shownItems, currentRequest);
   }
   if (recentOutcomeLines.length > 0) {
-    lines.push(`${c2.cyan}Recent Work:${c2.reset}`);
+    lines.push(`${c2.cyan}What's moved:${c2.reset}`);
     for (const item of recentOutcomeLines) {
       lines.push(`  - ${truncateInline(item, 160)}`);
       rememberShownItem(shownItems, item);
@@ -3233,7 +3247,7 @@ function formatVisibleStartupBrief(context) {
   if (toolFallbacks.length > 0 && latest) {
     const additiveTools = filterAdditiveToolFallbacks(toolFallbacks, shownItems);
     if (additiveTools.length > 0) {
-      lines.push(`${c2.cyan}Recent Tools:${c2.reset}`);
+      lines.push(`${c2.cyan}Tool trail:${c2.reset}`);
       for (const item of additiveTools) {
         lines.push(`  - ${truncateInline(item, 160)}`);
         rememberShownItem(shownItems, item);
@@ -3241,13 +3255,13 @@ function formatVisibleStartupBrief(context) {
     }
   }
   if (sessionFallbacks.length > 0) {
-    lines.push(`${c2.cyan}Recent Sessions:${c2.reset}`);
+    lines.push(`${c2.cyan}Recent threads:${c2.reset}`);
     for (const item of sessionFallbacks) {
       lines.push(`  - ${truncateInline(item, 160)}`);
     }
   }
   if (projectSignals) {
-    lines.push(`${c2.cyan}Project Signals:${c2.reset}`);
+    lines.push(`${c2.cyan}Signal mix:${c2.reset}`);
     lines.push(`  - ${truncateInline(projectSignals, 160)}`);
   }
   const stale = pickRelevantStaleDecision(context, latest);
@@ -3271,10 +3285,31 @@ function formatContextEconomics(data) {
   if (data.estimatedReadTokens > 0) {
     parts.push(`read now ~${data.estimatedReadTokens.toLocaleString()}t`);
   }
+  if (data.context.observations.length > 0) {
+    parts.push(`${data.context.observations.length} observations loaded`);
+  }
   if (parts.length === 0)
     return [];
   return [`${c2.dim}Context economics:${c2.reset} ${parts.join(" \xB7 ")}`];
 }
+function formatLegend() {
+  return [
+    `${c2.dim}Legend:${c2.reset} #id | \u25A0 bugfix | \u25B2 feature | \u2248 refactor | \u25CF change | \u25A1 discovery | \u25C7 decision`
+  ];
+}
+function formatContextIndex(context) {
+  const rows = context.observations.filter((obs) => obs.type !== "digest").slice(0, 6).map((obs) => {
+    const icon = observationIcon(obs.type);
+    const fileHint = extractPrimaryFileHint(obs);
+    return `${icon} #${obs.id} ${truncateInline(obs.title, 110)}${fileHint ? ` ${c2.dim}(${fileHint})${c2.reset}` : ""}`;
+  });
+  if (rows.length === 0)
+    return [];
+  return [
+    `${c2.dim}Handoff index:${c2.reset} use IDs when you want the deeper thread`,
+    ...rows
+  ];
+}
 function formatInspectHints(context) {
   const hints = [];
   if ((context.recentSessions?.length ?? 0) > 0) {
@@ -3290,7 +3325,12 @@ function formatInspectHints(context) {
   const unique = Array.from(new Set(hints)).slice(0, 4);
   if (unique.length === 0)
     return [];
-  return [`${c2.dim}Inspect:${c2.reset} ${unique.join(" \xB7 ")}`];
+  const ids = context.observations.slice(0, 5).map((obs) => obs.id);
+  const fetchHint = ids.length > 0 ? `get_observations([${ids.join(", ")}])` : null;
+  return [
+    `${c2.dim}Next look:${c2.reset} ${unique.join(" \xB7 ")}`,
+    ...fetchHint ? [`${c2.dim}Pull detail:${c2.reset} ${fetchHint}`] : []
+  ];
 }
 function rememberShownItem(shown, value) {
   if (!value)
@@ -3412,9 +3452,60 @@ function chooseMeaningfulSessionSummary(request, completed) {
 function buildProjectSignalLine(context) {
   if (!context.projectTypeCounts)
     return null;
-  const top = Object.entries(context.projectTypeCounts).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 4).map(([type, count]) => `${type} ${count}`).join("; ");
+  const top = Object.entries(context.projectTypeCounts).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 4).map(([type, count]) => `${signalGlyph(type)} ${type} ${count}`).join("; ");
   return top || null;
 }
+function signalGlyph(type) {
+  switch (type) {
+    case "bugfix":
+      return "\u25A0";
+    case "feature":
+      return "\u25B2";
+    case "refactor":
+      return "\u2248";
+    case "change":
+      return "\u25CF";
+    case "discovery":
+      return "\u25A1";
+    case "decision":
+      return "\u25C7";
+    default:
+      return "\xB7";
+  }
+}
+function observationIcon(type) {
+  switch (type) {
+    case "bugfix":
+      return "\u25A0";
+    case "feature":
+      return "\u25B2";
+    case "refactor":
+      return "\u2248";
+    case "change":
+      return "\u25CF";
+    case "discovery":
+      return "\u25A1";
+    case "decision":
+      return "\u25C7";
+    default:
+      return "\u2022";
+  }
+}
+function extractPrimaryFileHint(obs) {
+  const firstRead = parseJsonArraySafe(obs.files_read)[0];
+  const firstModified = parseJsonArraySafe(obs.files_modified)[0];
+  return firstModified ?? firstRead ?? null;
+}
+function parseJsonArraySafe(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function toSplashLines(value, maxItems) {
   if (!value)
     return [];

package/dist/hooks/stop.js

@@ -2535,7 +2535,7 @@ function buildBeacon(db, config, sessionId, metrics) {
     sentinel_used: valueSignals.security_findings_count > 0,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.13",
+    client_version: "0.4.15",
     context_observations_injected: metrics?.contextObsInjected ?? 0,
     context_total_available: metrics?.contextTotalAvailable ?? 0,
     recall_attempts: metrics?.recallAttempts ?? 0,

package/dist/server.js

@@ -19764,7 +19764,7 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.13"
+  version: "0.4.15"
 });
 server.tool("save_observation", "Save an observation to memory", {
   type: exports_external.enum([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "Shared memory across devices, sessions, and coding agents",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",