@vedtechsolutions/engram-mcp 1.0.5 → 1.0.7

package/dist/{chunk-FQ4MRL3Q.js → chunk-V5TTXT4V.js}

@@ -491,6 +491,29 @@ var SCHEMA_SURFACING = {
   /** Maximum instances to sample when generating a description */
   INSTANCE_SAMPLE_COUNT: 5
 };
+var PROCEDURAL_WORKFLOW = {
+  /** Minimum successful commands in sequence to form a workflow */
+  MIN_COMMANDS: 3,
+  /** Maximum commands to track in recent_commands buffer */
+  MAX_TRACKED_COMMANDS: 20,
+  /** Maximum procedural workflows to encode per session */
+  MAX_PER_SESSION: 5,
+  /** Minimum time gap (ms) between workflow encodings to avoid bursts */
+  MIN_ENCODE_GAP_MS: 12e4,
+  /** Workflow pattern keywords — commands matching these form workflow candidates */
+  WORKFLOW_PATTERNS: {
+    build: ["build", "compile", "tsup", "tsc", "webpack", "vite", "esbuild", "rollup", "make"],
+    test: ["test", "vitest", "jest", "pytest", "mocha", "cargo test"],
+    deploy: ["deploy", "publish", "release", "push", "npm publish", "yarn publish", "pnpm publish"],
+    install: ["install", "npm install", "pnpm install", "yarn", "pip install", "cargo add"],
+    lint: ["lint", "eslint", "prettier", "black", "ruff", "clippy"],
+    db: ["migrate", "migration", "seed", "prisma", "alembic", "knex"],
+    docker: ["docker", "compose", "podman"],
+    git: ["git commit", "git push", "git tag", "git merge", "git rebase"]
+  },
+  /** Minimum confidence for encoding */
+  MIN_CONFIDENCE: 0.65
+};
 var CODE_CONTEXT_RECALL = {
   /** Maximum code identifiers to extract from content */
   MAX_CODE_KEYWORDS: 15,
@@ -12379,6 +12402,7 @@ export {
   PROACTIVE_RECALL,
   MEMORY_SURFACE,
   RETRIEVAL_FEEDBACK,
+  PROCEDURAL_WORKFLOW,
   CODE_CONTEXT_RECALL,
   DEDUP,
   SCHEMA_LIFECYCLE,
@@ -12630,4 +12654,4 @@ export {
   composeProjectUnderstanding,
   formatMentalModelInjection
 };
-//# sourceMappingURL=chunk-FQ4MRL3Q.js.map
+//# sourceMappingURL=chunk-V5TTXT4V.js.map

package/dist/hook.js

@@ -28,6 +28,7 @@ import {
   PREWRITE_BLOCKING,
   PRE_COMPACTION,
   PROACTIVE_RECALL,
+  PROCEDURAL_WORKFLOW,
   REASONING_CHAIN,
   REASONING_TRACE,
   RETRIEVAL_FEEDBACK,
@@ -173,7 +174,7 @@ import {
   updateReasoningChain,
   updateSelfModelFromSession,
   updateTask
-} from "./chunk-FQ4MRL3Q.js";
+} from "./chunk-V5TTXT4V.js";
 
 // src/hook.ts
 import { readFileSync, writeFileSync, existsSync, renameSync, statSync, readdirSync, unlinkSync, appendFileSync, openSync, readSync, closeSync } from "fs";
@@ -1792,8 +1793,18 @@ function extractGoal(params) {
     const topFiles = params.session_files.slice(-3).map((f) => f.split(/[/\\]/).pop() ?? f).join(", ");
     return `${params.cognitive_state.recent_discovery} (${topFiles})`;
   }
+  if (params.session_files && params.session_files.length > 0) {
+    const topFiles = params.session_files.slice(-5).map((f) => f.split(/[/\\]/).pop() ?? f).join(", ");
+    return `modifying ${topFiles}`;
+  }
   if (params.conversation.topic_history.length > 0) {
-    return params.conversation.topic_history[0].topic;
+    const topic = params.conversation.topic_history[0].topic;
+    const commaCount = (topic.match(/,/g) || []).length;
+    const wordCount = topic.split(/\s+/).length;
+    const isVagueKeywordList = commaCount >= 2 && wordCount <= commaCount + 2;
+    if (!isVagueKeywordList) {
+      return topic;
+    }
   }
   return null;
 }
@@ -3124,7 +3135,11 @@ function loadWatcherState() {
         recall_misses: raw.recall_misses ?? 0,
         last_status_turn: raw.last_status_turn ?? 0,
         offload_message_sent: raw.offload_message_sent ?? false,
-        summary_injection_mode: raw.summary_injection_mode ?? false
+        summary_injection_mode: raw.summary_injection_mode ?? false,
+        recent_commands: raw.recent_commands ?? [],
+        procedural_encoded_count: raw.procedural_encoded_count ?? 0,
+        recent_actions: raw.recent_actions ?? [],
+        continuation_brief: raw.continuation_brief ?? null
       };
     }
   } catch {
@@ -3186,7 +3201,11 @@ function loadWatcherState() {
     recall_misses: 0,
     last_status_turn: 0,
     offload_message_sent: false,
-    summary_injection_mode: false
+    summary_injection_mode: false,
+    recent_commands: [],
+    procedural_encoded_count: 0,
+    recent_actions: [],
+    continuation_brief: null
   };
 }
 function saveWatcherState(state) {
@@ -3623,6 +3642,14 @@ Output: ${truncate(toolOutput, 500)}`,
   if (state.recent_tool_names.length > 10) {
     state.recent_tool_names = state.recent_tool_names.slice(-10);
   }
+  state.recent_actions.push({
+    tool: "Bash",
+    target: truncate(cmd, 120),
+    time: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (state.recent_actions.length > 15) {
+    state.recent_actions = state.recent_actions.slice(-15);
+  }
   stateChanged = true;
   let testRun = null;
   if (isTestCommand(cmd)) {
@@ -4026,6 +4053,77 @@ Output: ${truncate(toolOutput, 500)}`,
     } catch {
     }
   }
+  try {
+    const cmdLower = cmd.toLowerCase();
+    const exitCode = stdinJson?.tool_response_metadata;
+    const cmdSuccess = !isError;
+    state.recent_commands.push({ cmd: truncate(cmd, 200), success: cmdSuccess, time: (/* @__PURE__ */ new Date()).toISOString() });
+    if (state.recent_commands.length > PROCEDURAL_WORKFLOW.MAX_TRACKED_COMMANDS) {
+      state.recent_commands = state.recent_commands.slice(-PROCEDURAL_WORKFLOW.MAX_TRACKED_COMMANDS);
+    }
+    stateChanged = true;
+    if (cmdSuccess && state.procedural_encoded_count < PROCEDURAL_WORKFLOW.MAX_PER_SESSION) {
+      const successCmds = state.recent_commands.filter((c) => c.success);
+      if (successCmds.length >= PROCEDURAL_WORKFLOW.MIN_COMMANDS) {
+        for (const [workflowName, keywords] of Object.entries(PROCEDURAL_WORKFLOW.WORKFLOW_PATTERNS)) {
+          const matching = successCmds.filter((c) => {
+            const cl = c.cmd.toLowerCase();
+            return keywords.some((kw) => cl.includes(kw));
+          });
+          if (matching.length >= PROCEDURAL_WORKFLOW.MIN_COMMANDS) {
+            const steps = matching.slice(-6).map((c, i) => `${i + 1}. ${truncate(c.cmd, 120)}`).join("\n");
+            const content = `${workflowName} workflow (${matching.length} steps):
+${steps}`;
+            const domains = state.active_domain ? [state.active_domain] : [];
+            const existing = findDuplicate(content, "procedural", domains);
+            if (!existing) {
+              createMemory({
+                type: "procedural",
+                content,
+                summary: `${workflowName} workflow: ${matching.slice(-3).map((c) => truncate(c.cmd, 40)).join(" \u2192 ")}`,
+                encoding_strength: 0.7,
+                reinforcement: 1.2,
+                confidence: PROCEDURAL_WORKFLOW.MIN_CONFIDENCE,
+                storage_tier: "short_term",
+                pinned: false,
+                tags: ["workflow", `workflow-${workflowName}`, "auto-encoded"],
+                domains,
+                version: state.active_version,
+                encoding_context: {
+                  project: state.active_project,
+                  project_path: state.active_project_path,
+                  framework: state.active_domain,
+                  version: state.active_version,
+                  files: state.session_files.slice(-5),
+                  task_type: workflowName === "build" ? "building" : null,
+                  error_context: null,
+                  session_id: sessionId,
+                  significance_score: 0.7
+                },
+                type_data: {
+                  kind: "procedural",
+                  steps: matching.map((c) => c.cmd),
+                  preconditions: [],
+                  postconditions: [],
+                  practice_count: 1,
+                  automaticity: 0.3,
+                  variants: [],
+                  skill_metadata: null
+                }
+              });
+              state.procedural_encoded_count++;
+              stateChanged = true;
+              log.info("Auto-encoded procedural workflow", { type: workflowName, steps: matching.length });
+              const matchedTimes = new Set(matching.map((c) => c.time));
+              state.recent_commands = state.recent_commands.filter((c) => !matchedTimes.has(c.time));
+            }
+            break;
+          }
+        }
+      }
+    }
+  } catch {
+  }
   if (stateChanged) {
     saveWatcherState(state);
   }
@@ -4035,6 +4133,14 @@ function handlePostWrite(toolInput, argFallback) {
   const filePath = input?.file_path ?? input?.path ?? "";
   if (!filePath) return;
   const state = loadWatcherState();
+  state.recent_actions.push({
+    tool: "Edit",
+    target: filePath,
+    time: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (state.recent_actions.length > 15) {
+    state.recent_actions = state.recent_actions.slice(-15);
+  }
   if (typeof filePath === "string" && !state.session_files.includes(filePath)) {
     state.session_files.push(filePath);
     if (state.session_files.length > 50) {
@@ -4178,6 +4284,16 @@ function handlePostToolGeneric(stdinJson) {
   if (state.recent_tool_names.length > 10) {
     state.recent_tool_names = state.recent_tool_names.slice(-10);
   }
+  if (toolName !== "Read" && toolName !== "Glob" && toolName !== "Grep") {
+    state.recent_actions.push({
+      tool: toolName,
+      target: call.input_summary ?? "",
+      time: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (state.recent_actions.length > 15) {
+      state.recent_actions = state.recent_actions.slice(-15);
+    }
+  }
   state.reasoning_buffer.push(call);
   if (state.reasoning_buffer.length > REASONING_TRACE.MAX_BUFFER_SIZE) {
     state.reasoning_buffer = state.reasoning_buffer.slice(-REASONING_TRACE.MAX_BUFFER_SIZE);
@@ -4862,7 +4978,11 @@ function handleSessionStart(stdinJson, argFallback) {
     recall_misses: isPostCompact ? prevState?.recall_misses ?? 0 : 0,
     last_status_turn: 0,
     offload_message_sent: false,
-    summary_injection_mode: false
+    summary_injection_mode: false,
+    recent_commands: isPostCompact ? prevState?.recent_commands ?? [] : [],
+    procedural_encoded_count: isPostCompact ? prevState?.procedural_encoded_count ?? 0 : 0,
+    recent_actions: isPostCompact ? prevState?.recent_actions ?? [] : [],
+    continuation_brief: isPostCompact ? prevState?.continuation_brief ?? null : null
   });
   const source = metadata.source;
   if (!source || source === "startup") {
@@ -5462,6 +5582,50 @@ function handleEngramUsed(stdinJson, argFallback) {
   }
   saveWatcherState(state);
 }
+function buildContinuationBrief(state) {
+  const cog = state.cognitive_state;
+  const task = state.active_task ?? cog.current_approach ?? (state.session_files.length > 0 ? `Working on ${state.session_files.slice(-3).map((f) => f.split(/[/\\]/).pop() ?? f).join(", ")}` : "unknown task");
+  const lastActions = state.recent_actions.slice(-8).map((a) => {
+    const fileName = a.target.includes("/") ? a.target.split(/[/\\]/).pop() ?? a.target : a.target;
+    return `${a.tool}: ${truncate(fileName, 80)}`;
+  });
+  const nextSteps = [];
+  if (cog.search_intent && !nextSteps.some((s) => s.includes(cog.search_intent))) {
+    nextSteps.push(`Investigate: ${cog.search_intent}`);
+  }
+  const lastAction = state.recent_actions[state.recent_actions.length - 1];
+  if (lastAction && nextSteps.length === 0) {
+    if (lastAction.tool === "Edit" || lastAction.tool === "Write") {
+      nextSteps.push("Run tests to verify changes");
+    } else if (lastAction.tool === "Bash" && lastAction.target.includes("test")) {
+      nextSteps.push("Review test results and commit if passing");
+    }
+  }
+  if (state.recent_errors.length > 0 && nextSteps.length < 3) {
+    nextSteps.push(`Fix: ${truncate(state.recent_errors[state.recent_errors.length - 1], 120)}`);
+  }
+  const decisions = [];
+  for (const id of state.decision_memory_ids.slice(-5)) {
+    try {
+      const mem = getMemory(id);
+      if (mem) decisions.push(truncate(mem.content, 150));
+    } catch {
+    }
+  }
+  const triedFailed = (state.session_outcomes ?? []).filter((o) => o.includes("\u2192 fail") || o.includes("\u2192 dead end") || o.includes("\u2192 blocked")).slice(-5).map((o) => truncate(o, 120));
+  const editActions = state.recent_actions.filter((a) => a.tool === "Edit" || a.tool === "Write");
+  const keyFiles = [...new Set(editActions.map((a) => a.target))].slice(-10);
+  return {
+    task: truncate(task, 300),
+    phase: cog.session_phase ?? "unknown",
+    last_actions: lastActions,
+    next_steps: nextSteps.slice(0, 5),
+    decisions,
+    tried_failed: triedFailed,
+    key_files: keyFiles.length > 0 ? keyFiles : state.session_files.slice(-10),
+    blockers: state.recent_errors.slice(-3).map((e) => truncate(e, 150))
+  };
+}
 function handlePreCompact() {
   const state = loadWatcherState();
   if (!state.active_project) {
@@ -5704,6 +5868,10 @@ ${summaryParts.join(". ")}` : `Pre-compaction session summary: ${summaryParts.jo
       });
       process.stdout.write(output + "\n");
     }
+    try {
+      state.continuation_brief = buildContinuationBrief(state);
+    } catch {
+    }
     state.recovery_context = recovery;
     state.understanding_snapshot = understanding;
     saveWatcherState(state);
@@ -6095,6 +6263,7 @@ ${distillLines}`
     budget.append("antipatterns", warnings);
     state.pending_error_warnings = [];
   }
+  const surfacedIds = /* @__PURE__ */ new Set();
   try {
     const surfaceDomain = state.active_domain;
     if (surfaceDomain && surfaceDomain.length >= MEMORY_SURFACE.MIN_DOMAIN_LENGTH) {
@@ -6127,6 +6296,7 @@ ${distillLines}`
           }
           state.surface_injection_turns[mem.id] = state.total_turns;
           state.proactive_injection_turns[mem.id] = state.total_turns;
+          surfacedIds.add(mem.id);
         }
         budget.append("surface", surfaceLines.join("\n"));
       }
@@ -6194,6 +6364,7 @@ ${distillLines}`
           );
           for (const m of result.memories) {
             if (somaticIds.has(m.memory.id)) continue;
+            if (surfacedIds.has(m.memory.id)) continue;
             if (isRecallNoise(m.memory.content, m.memory.type, m.memory.tags)) continue;
             if (m.memory.tags.includes("pre-compact")) continue;
             if (m.memory.tags.includes("session_narrative")) continue;
@@ -6841,38 +7012,54 @@ function handlePostCompact(stdinJson) {
     if (!recovery) return;
     const budget = new OutputBudget(OUTPUT_BUDGET.POST_COMPACT_MAX_BYTES);
     const lines = [];
-    const cog = state.cognitive_state;
-    const cogCtx = recovery.working_state?.cognitive_context;
-    const hasAnyCognitive = cog?.current_approach || cog?.active_hypothesis || cog?.recent_discovery || cogCtx?.planned_next_step || recovery.continuation_hint;
-    if (hasAnyCognitive) {
-      const mindLines = ["[Engram] Before compaction, you were:"];
-      if (state.active_task) mindLines.push(`  Task: ${truncate(state.active_task, 200)}`);
-      if (cog?.session_phase) mindLines.push(`  Phase: ${cog.session_phase}`);
-      if (cog?.current_approach) mindLines.push(`  Approach: ${truncate(cog.current_approach, 300)}`);
-      if (cog?.active_hypothesis) mindLines.push(`  Hypothesis: ${truncate(cog.active_hypothesis, 300)}`);
-      if (cog?.recent_discovery) mindLines.push(`  Discovery: ${truncate(cog.recent_discovery, 300)}`);
-      if (cogCtx?.planned_next_step) mindLines.push(`  Next step: ${truncate(cogCtx.planned_next_step, 200)}`);
-      if (cog?.search_intent) mindLines.push(`  Investigating: ${truncate(cog.search_intent, 200)}`);
-      const ruledOut = (state.session_outcomes ?? []).filter((o) => o.includes("\u2192 fail") || o.includes("\u2192 dead end") || o.includes("\u2192 blocked"));
-      if (ruledOut.length > 0) {
+    const brief = state.continuation_brief;
+    if (brief) {
+      const mindLines = ["[Engram] Continue from where you left off:"];
+      mindLines.push(`  Task: ${brief.task}`);
+      mindLines.push(`  Phase: ${brief.phase}`);
+      if (brief.last_actions.length > 0) {
+        mindLines.push(`  Last actions:`);
+        for (const a of brief.last_actions.slice(-5)) mindLines.push(`    - ${a}`);
+      }
+      if (brief.next_steps.length > 0) {
+        mindLines.push(`  Next steps:`);
+        for (const s of brief.next_steps) mindLines.push(`    - ${s}`);
+      }
+      if (brief.decisions.length > 0) {
+        mindLines.push(`  Decisions made:`);
+        for (const d of brief.decisions) mindLines.push(`    - ${d}`);
+      }
+      if (brief.tried_failed.length > 0) {
         mindLines.push(`  Already tried (didn't work):`);
-        for (const o of ruledOut.slice(-3)) mindLines.push(`    - ${truncate(o, 150)}`);
-      }
-      const blockers = recovery.working_state?.active_blockers ?? [];
-      if (blockers.length > 0) {
-        mindLines.push(`  Blockers: ${blockers.slice(0, 3).map((b) => truncate(b, 100)).join("; ")}`);
+        for (const t of brief.tried_failed) mindLines.push(`    - ${t}`);
       }
-      if (state.recent_errors.length > 0) {
-        mindLines.push(`  Recent errors: ${state.recent_errors.slice(-2).map((e) => truncate(e, 100)).join("; ")}`);
+      if (brief.blockers.length > 0) {
+        mindLines.push(`  Blockers: ${brief.blockers.join("; ")}`);
       }
-      if (state.session_files.length > 0) {
-        const files = state.session_files.slice(-8).map((f) => f.split(/[/\\]/).pop() ?? f);
+      if (brief.key_files.length > 0) {
+        const files = brief.key_files.map((f) => f.split(/[/\\]/).pop() ?? f);
         mindLines.push(`  Files: ${files.join(", ")}`);
       }
-      if (recovery.continuation_hint) {
-        mindLines.push(`  Continue: ${truncate(recovery.continuation_hint, 300)}`);
-      }
       lines.push(mindLines.join("\n"));
+    } else {
+      const cog = state.cognitive_state;
+      const cogCtx = recovery.working_state?.cognitive_context;
+      const hasAnyCognitive = cog?.current_approach || cog?.active_hypothesis || cog?.recent_discovery || cogCtx?.planned_next_step || recovery.continuation_hint;
+      if (hasAnyCognitive) {
+        const mindLines = ["[Engram] Before compaction, you were:"];
+        if (state.active_task) mindLines.push(`  Task: ${truncate(state.active_task, 200)}`);
+        if (cog?.session_phase) mindLines.push(`  Phase: ${cog.session_phase}`);
+        if (cog?.current_approach) mindLines.push(`  Approach: ${truncate(cog.current_approach, 300)}`);
+        if (cog?.active_hypothesis) mindLines.push(`  Hypothesis: ${truncate(cog.active_hypothesis, 300)}`);
+        if (cog?.recent_discovery) mindLines.push(`  Discovery: ${truncate(cog.recent_discovery, 300)}`);
+        if (cogCtx?.planned_next_step) mindLines.push(`  Next step: ${truncate(cogCtx.planned_next_step, 200)}`);
+        if (recovery.continuation_hint) mindLines.push(`  Continue: ${truncate(recovery.continuation_hint, 300)}`);
+        if (state.session_files.length > 0) {
+          const files = state.session_files.slice(-8).map((f) => f.split(/[/\\]/).pop() ?? f);
+          mindLines.push(`  Files: ${files.join(", ")}`);
+        }
+        lines.push(mindLines.join("\n"));
+      }
     }
     try {
       const transcriptPath = stdinJson?.transcript_path ?? null;

package/dist/index.js

@@ -154,7 +154,7 @@ import {
   vaccinate,
   vacuumDatabase,
   validateMultiPerspective
-} from "./chunk-FQ4MRL3Q.js";
+} from "./chunk-V5TTXT4V.js";
 
 // src/index.ts
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vedtechsolutions/engram-mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Cognitive memory system for AI — persistent, cross-session learning via MCP",
   "type": "module",
   "main": "dist/index.js",