engrm 0.4.36 → 0.4.38

package/README.md

@@ -288,6 +288,25 @@ How to use it:
 - `load_recall_item` opens an exact handoff, thread, chat, or memory key returned by the index
 - `repair_recall` is the repair step when continuity is still thin, hook-only, or under-captured
 
+### Explicit Save Protocol
+
+When something should be remembered on purpose, do not wait for an end-of-session
+digest if an explicit write is more appropriate.
+
+Use:
+
+- `save_observation`
+  - direct durable memory write for a bugfix, decision, discovery, pattern,
+    feature, or change
+- `create_handoff` / `refresh_handoff`
+  - preserve the active thread for another device or a later session
+- `capture_openclaw_content`
+  - save OpenClaw-style research, posting, outcomes, and next actions as
+    reusable memory
+
+Automatic session digests are a safety net.
+They are not the only path for preserving important work.
+
 ### Thin Tools, Thick Memory
 
 Engrm now has a real thin-tool layer, not just a plugin spec.

package/dist/hooks/session-start.js

@@ -3225,7 +3225,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.36";
+var CLIENT_VERSION = "0.4.38";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))

package/dist/hooks/stop.js

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

package/dist/server.js

@@ -16329,7 +16329,14 @@ async function searchObservations(db, input) {
     }
   }
   const safeQuery = sanitizeFtsQuery(query);
-  const ftsResults = safeQuery ? db.searchFts(safeQuery, projectId, undefined, limit * 2, input.user_id) : [];
+  let ftsResults = [];
+  if (safeQuery) {
+    try {
+      ftsResults = db.searchFts(safeQuery, projectId, undefined, limit * 2, input.user_id);
+    } catch {
+      ftsResults = [];
+    }
+  }
   let vecResults = [];
   const queryEmbedding = await embedText(query);
   if (queryEmbedding && db.vecAvailable) {
@@ -16392,11 +16399,13 @@ function mergeResults(ftsResults, vecResults, limit) {
   return Array.from(scores.entries()).map(([id, score]) => ({ id, score })).sort((a, b) => b.score - a.score).slice(0, limit);
 }
 function sanitizeFtsQuery(query) {
-  let safe = query.replace(/[{}()[\]^~*:]/g, " ");
-  safe = safe.replace(/\s+/g, " ").trim();
-  if (!safe)
+  const normalized = String(query ?? "").normalize("NFKC").replace(/[^\p{L}\p{N}_\s]+/gu, " ").replace(/\s+/g, " ").trim();
+  if (!normalized)
+    return "";
+  const terms = normalized.split(" ").map((term) => term.trim()).filter(Boolean).slice(0, 16);
+  if (terms.length === 0)
     return "";
-  return safe;
+  return terms.map((term) => `"${term}"`).join(" ");
 }
 
 // src/tools/recent-chat.ts
@@ -22871,9 +22880,9 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.36"
+  version: "0.4.38"
 });
-server.tool("save_observation", "Save an observation to memory", {
+server.tool("save_observation", "Directly save a durable memory item now. Use this when something should be remembered on purpose instead of waiting for an end-of-session digest.", {
   type: exports_external.enum([
     "bugfix",
     "discovery",
@@ -23170,7 +23179,7 @@ Findings: ${findingSummary}` : ""}`
     ]
   };
 });
-server.tool("capture_openclaw_content", "Capture OpenClaw content, research, and follow-up work as durable memory. Best for preserving posted outcomes, discoveries, and next actions.", {
+server.tool("capture_openclaw_content", "Directly save OpenClaw content, research, and follow-up work as durable memory. Best for preserving posted outcomes, discoveries, and next actions during or right after the run.", {
   title: exports_external.string().optional().describe("Short content, campaign, or research title."),
   posted: exports_external.array(exports_external.string()).optional().describe("Concrete posted items or shipped content outcomes."),
   researched: exports_external.array(exports_external.string()).optional().describe("Research or discovery items worth retaining."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.36",
+  "version": "0.4.38",
   "description": "Shared memory across devices, sessions, and agents, with thin MCP tools for durable capture and live continuity",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",