@icex-labs/openclaw-memory-engine 5.1.1 → 5.2.1

package/extras/auto-consolidation-crons.json

@@ -32,6 +32,14 @@
       "message": "Run memory_dashboard to regenerate the HTML dashboard. Do NOT output anything to the main chat.",
       "model": "anthropic/claude-sonnet-4-6",
       "description": "Daily dashboard refresh at 9:30am"
+    },
+    {
+      "id": "memory-graph-weekly",
+      "schedule": "0 5 * * 0",
+      "agent": "main",
+      "message": "Review the last 50 archival records via archival_search. For any that describe clear relationships between entities (person owns thing, person works at place, person has condition, etc.), add them via graph_add. Only add relationships you are confident about. Do NOT output anything to the main chat. Send summary to notify bot.",
+      "model": "anthropic/claude-sonnet-4-6",
+      "description": "Weekly: LLM-based graph triple extraction from recent archival"
     }
   ]
 }

package/index.js

@@ -323,13 +323,32 @@ export default definePluginEntry({
         const old = records[idx].content;
         records[idx].content = params.content;
         records[idx].updated_at = new Date().toISOString();
-        if (params.entity !== undefined) records[idx].entity = params.entity;
+
+        // Re-classify if entity not explicitly provided
+        if (params.entity !== undefined) {
+          records[idx].entity = params.entity;
+        } else {
+          const { classify } = await import("./lib/classifier.js");
+          const cls = await classify(params.content, wsp);
+          if (cls.entity !== "general") records[idx].entity = cls.entity;
+          records[idx].importance = cls.importance;
+          // Reuse embedding for indexing
+          if (cls.embedding) {
+            const embCache = loadEmbeddingCache(wsp);
+            embCache[params.id] = cls.embedding;
+            saveEmbeddingCache(wsp);
+          }
+        }
         if (params.tags !== undefined) records[idx].tags = params.tags;
         rewriteArchival(wsp, records);
-        const embCache = loadEmbeddingCache(wsp);
-        delete embCache[params.id];
-        saveEmbeddingCache(wsp);
-        indexEmbedding(wsp, records[idx]).catch(() => {});
+
+        // Re-embed if classify didn't already do it
+        if (params.entity !== undefined) {
+          const embCache = loadEmbeddingCache(wsp);
+          delete embCache[params.id];
+          saveEmbeddingCache(wsp);
+          indexEmbedding(wsp, records[idx]).catch(() => {});
+        }
         return text(`OK: Updated ${params.id}. Old: "${old.slice(0, 60)}..." → New: "${params.content.slice(0, 60)}..."`);
       },
     })));

package/lib/consolidate.js

@@ -4,7 +4,7 @@
  */
 
 import { loadArchival, appendRecord } from "./archival.js";
-import { loadEmbeddingCache, saveEmbeddingCache } from "./embedding.js";
+import { loadEmbeddingCache, saveEmbeddingCache, cosineSimilarity } from "./embedding.js";
 import { classify } from "./classifier.js";
 
 /** Split text into sentence-level fact candidates. */
@@ -54,6 +54,12 @@ export async function consolidateText(ws, text, defaultEntity = "", defaultTags
   const inserted = [];
   const skipped = [];
 
+  // Load embedding cache for semantic dedup
+  const embCache = loadEmbeddingCache(ws);
+  const recentEmbeddings = existing.slice(-100)
+    .map((r) => embCache[r.id])
+    .filter(Boolean);
+
   for (const fact of candidates) {
     const factLower = fact.toLowerCase();
     if (isDuplicate(factLower, existingTexts)) {
@@ -62,6 +68,17 @@ export async function consolidateText(ws, text, defaultEntity = "", defaultTags
     }
 
     const { entity, importance, embedding } = await classify(fact, ws);
+
+    // Semantic dedup: skip if cosine similarity > 0.92 with any recent record
+    if (embedding && recentEmbeddings.length > 0) {
+      const isSemDupe = recentEmbeddings.some(
+        (emb) => cosineSimilarity(embedding, emb) > 0.92,
+      );
+      if (isSemDupe) {
+        skipped.push(fact.slice(0, 60));
+        continue;
+      }
+    }
     const finalEntity = (entity !== "general") ? entity : defaultEntity || "general";
 
     const record = appendRecord(ws, {

package/lib/reflection.js

@@ -9,6 +9,7 @@
 import { loadArchival } from "./archival.js";
 import { loadEpisodes } from "./episodes.js";
 import { loadGraph } from "./graph.js";
+import { readCore } from "./core.js";
 
 /**
  * Analyze recent memory for patterns and trends.
@@ -132,9 +133,27 @@ export function analyzePatterns(ws, windowDays = 7) {
       neglected_entities: neglected.slice(0, 10),
       forgetting_candidates: forgettingCandidates.length,
     },
+    // Core memory focus age check
+    stale_focus: checkStaleFocus(ws),
   };
 }
 
+/**
+ * Check if current_focus items in core memory are stale (>14 days since last update).
+ */
+function checkStaleFocus(ws) {
+  try {
+    const core = readCore(ws);
+    const updatedAt = core._meta?.updated_at;
+    if (!updatedAt) return [];
+    const daysSinceUpdate = (Date.now() - new Date(updatedAt).getTime()) / 86400000;
+    if (daysSinceUpdate > 14 && Array.isArray(core.current_focus) && core.current_focus.length > 0) {
+      return core.current_focus;
+    }
+  } catch { /* ignore */ }
+  return [];
+}
+
 /**
  * Format analysis into a human-readable report for the agent.
  */
@@ -182,6 +201,14 @@ export function formatReflection(analysis) {
     lines.push(``, `⚠️ ${analysis.health.forgetting_candidates} facts below forgetting threshold — consider archival_deduplicate or cleanup`);
   }
 
+  if (analysis.stale_focus && analysis.stale_focus.length > 0) {
+    lines.push(``, `⚠️ Core memory current_focus not updated in >14 days. Review these items:`);
+    for (const item of analysis.stale_focus) {
+      lines.push(`  - ${item}`);
+    }
+    lines.push(`  Use core_memory_replace to update or remove completed items.`);
+  }
+
   lines.push(``, `Totals: ${analysis.health.total_archival} facts, ${analysis.health.total_episodes} episodes, ${analysis.health.total_graph} graph triples`);
 
   return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icex-labs/openclaw-memory-engine",
-  "version": "5.1.1",
+  "version": "5.2.1",
   "description": "MemGPT-style hierarchical memory plugin for OpenClaw — core memory block + archival storage with semantic search",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -384,22 +384,53 @@ except:
 
   echo "  Agents found: $AGENTS"
 
-  # Register main agent crons (shared across all agents using default workspace)
-  register_cron "memory-reflect-daily" "0 9 * * *" "main" \
-    "Run memory_reflect with window_days=7. If you notice patterns, store via archival_insert with tags=['reflection']. Do NOT output to main chat." \
-    "Daily reflection: analyze memory patterns"
-
-  register_cron "memory-consolidate-6h" "0 */6 * * *" "main" \
-    "Read today's daily log. If it has content not in archival, run memory_consolidate. Then archival_stats. Do NOT output to main chat." \
-    "Auto-consolidate daily logs every 6 hours"
-
-  register_cron "memory-dedup-weekly" "0 4 * * 0" "main" \
-    "Run archival_deduplicate with apply=true. Then archival_stats. Do NOT output to main chat." \
-    "Weekly dedup: clean near-duplicate records"
-
-  register_cron "memory-dashboard-daily" "30 9 * * *" "main" \
-    "Run memory_dashboard to regenerate the HTML dashboard. Do NOT output to main chat." \
-    "Daily dashboard refresh for main agent" 30000
+  # Register crons from JSON definition file (single source of truth)
+  CRON_JSON="$PLUGIN_DIR/extras/auto-consolidation-crons.json"
+  if [ -f "$CRON_JSON" ] && command -v python3 &>/dev/null; then
+    python3 -c "
+import json, subprocess, sys
+
+with open('$CRON_JSON') as f:
+    crons = json.load(f).get('crons', [])
+
+existing = '''$EXISTING_CRONS'''
+tz = '''$TZ_IANA'''
+
+for c in crons:
+    name = c['id']
+    if name in existing:
+        print(f'⏭️  Cron \"{name}\" already exists')
+        continue
+    agent = c.get('agent', 'main')
+    cmd = [
+        'openclaw', 'cron', 'add',
+        '--name', name,
+        '--cron', c['schedule'],
+        '--tz', tz,
+        '--agent', agent,
+        '--session', 'isolated',
+        '--model', c.get('model', 'anthropic/claude-sonnet-4-6'),
+        '--message', c['message'],
+        '--description', c.get('description', ''),
+        '--timeout', '60000',
+    ]
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    if result.returncode == 0:
+        print(f'✅ Cron \"{name}\" ({agent}) registered')
+    else:
+        print(f'⚠️  Cron \"{name}\" failed (gateway not running?)')
+" 2>/dev/null
+  else
+    echo "⚠️  Cron JSON not found or python3 missing — registering defaults manually"
+    register_cron "memory-reflect-daily" "0 9 * * *" "main" \
+      "Run memory_reflect. Do NOT output to main chat." "Daily reflection"
+    register_cron "memory-consolidate-6h" "0 */6 * * *" "main" \
+      "Run memory_consolidate on today's daily log. Do NOT output to main chat." "Auto-consolidate"
+    register_cron "memory-dedup-weekly" "0 4 * * 0" "main" \
+      "Run archival_deduplicate with apply=true. Do NOT output to main chat." "Weekly dedup"
+    register_cron "memory-dashboard-daily" "30 9 * * *" "main" \
+      "Run memory_dashboard. Do NOT output to main chat." "Dashboard refresh" 30000
+  fi
 
   # Register per-agent crons for agents with separate workspaces
   STAGGER=0
@@ -441,7 +472,22 @@ else
   echo "⚠️  openclaw CLI not found — skipping cron registration"
 fi
 
-# --- 9. Validate config ---
+# --- 9. Track installed version ---
+INSTALLED_VERSION=$(python3 -c "
+import json
+with open('$PLUGIN_DIR/package.json') as f: print(json.load(f).get('version','unknown'))
+" 2>/dev/null || echo "unknown")
+PREV_VERSION=""
+VERSION_FILE="$MEMORY_DIR/.memory-engine-version"
+[ -f "$VERSION_FILE" ] && PREV_VERSION=$(cat "$VERSION_FILE")
+echo "$INSTALLED_VERSION" > "$VERSION_FILE"
+
+if [ -n "$PREV_VERSION" ] && [ "$PREV_VERSION" != "$INSTALLED_VERSION" ]; then
+  echo ""
+  echo "📦 Upgraded: $PREV_VERSION → $INSTALLED_VERSION"
+fi
+
+# --- 10. Validate config ---
 echo ""
 if command -v openclaw &>/dev/null; then
   openclaw config validate 2>&1 && echo "✅ Config valid" || echo "❌ Config validation failed"