engrm 0.4.13 → 0.4.14

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.14";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -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("");
@@ -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 | \uD83D\uDD34 bugfix | \uD83D\uDFE3 feature | \uD83D\uDD04 refactor | \u2705 change | \uD83D\uDD35 discovery | \u2696\uFE0F 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}Context index:${c2.reset} use IDs to fetch deeper detail when needed`,
+    ...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}Inspect:${c2.reset} ${unique.join(" \xB7 ")}`,
+    ...fetchHint ? [`${c2.dim}Fetch by ID:${c2.reset} ${fetchHint}`] : []
+  ];
 }
 function rememberShownItem(shown, value) {
   if (!value)
@@ -3415,6 +3455,39 @@ function buildProjectSignalLine(context) {
   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("; ");
   return top || null;
 }
+function observationIcon(type) {
+  switch (type) {
+    case "bugfix":
+      return "\uD83D\uDD34";
+    case "feature":
+      return "\uD83D\uDFE3";
+    case "refactor":
+      return "\uD83D\uDD04";
+    case "change":
+      return "\u2705";
+    case "discovery":
+      return "\uD83D\uDD35";
+    case "decision":
+      return "\u2696\uFE0F";
+    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.14",
     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.14"
 });
 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.14",
   "description": "Shared memory across devices, sessions, and coding agents",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",