@icex-labs/openclaw-memory-engine 5.0.2 → 5.1.0

package/extras/migrate-legacy.mjs

@@ -140,9 +140,26 @@ for (const { path, tag } of files) {
       continue;
     }
 
+    // Infer date from filename (e.g., 2026-03-28.md → 2026-03-28, 2026-W13.md → week date)
+    const dateMatch = basename(path).match(/^(\d{4}-\d{2}-\d{2})/);
+    const weekMatch = basename(path).match(/^(\d{4})-W(\d{2})/);
+    let inferredTs;
+    if (dateMatch) {
+      inferredTs = dateMatch[1] + "T12:00:00Z";
+    } else if (weekMatch) {
+      // Approximate: week number × 7 days from Jan 1
+      const year = parseInt(weekMatch[1]);
+      const week = parseInt(weekMatch[2]);
+      const jan1 = new Date(year, 0, 1);
+      const weekDate = new Date(jan1.getTime() + (week - 1) * 7 * 86400000);
+      inferredTs = weekDate.toISOString();
+    } else {
+      inferredTs = new Date().toISOString();
+    }
+
     const record = {
       id: `arch-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
-      ts: new Date().toISOString(),
+      ts: inferredTs,
       last_accessed: null,
       access_count: 0,
       importance: 5,

package/index.js

@@ -702,7 +702,7 @@ export default definePluginEntry({
       async execute(_id, params) {
         const wsp = ws(agentId, params);
         try {
-          const result = runQualityPass(wsp, {
+          const result = await runQualityPass(wsp, {
             skipGraph: params.skip_graph || false,
             skipEpisodes: params.skip_episodes || false,
           });

package/lib/quality.js

@@ -67,12 +67,18 @@ export async function runQualityPass(ws, options = {}) {
 }
 
 /**
- * Generate episode summaries from clusters of records on the same day.
+ * Generate episode summaries from records.
+ * Strategy 1: group by date (works when ts reflects original dates)
+ * Strategy 2: group by entity/topic (fallback when all ts are same day, e.g., after migration)
  */
 function generateEpisodesFromRecords(ws, records) {
   const episodes = loadEpisodes(ws);
+  const existingTopics = new Set(episodes.flatMap((e) => e.topics || []));
   const existingDates = new Set(episodes.map((e) => e.ts?.slice(0, 10)));
 
+  let generated = 0;
+
+  // Strategy 1: by date
   const byDate = {};
   for (const r of records) {
     if (!r.ts) continue;
@@ -81,14 +87,15 @@ function generateEpisodesFromRecords(ws, records) {
     byDate[date].push(r);
   }
 
-  let generated = 0;
   for (const [date, dayRecords] of Object.entries(byDate)) {
     if (existingDates.has(date) || dayRecords.length < 3) continue;
+    // Skip if most records share the same date (migration artifact)
+    if (dayRecords.length > records.length * 0.5) continue;
 
     const topics = [...new Set(dayRecords.map((r) => r.entity).filter((e) => e && e !== "general"))];
     const topContent = dayRecords
       .sort((a, b) => (b.importance || 5) - (a.importance || 5))
-      .slice(0, 5)
+      .slice(0, 3)
       .map((r) => r.content.slice(0, 80))
       .join("; ");
 
@@ -103,6 +110,35 @@ function generateEpisodesFromRecords(ws, records) {
     generated++;
   }
 
+  // Strategy 2: by entity (fallback for migration data with same-day ts)
+  const byEntity = {};
+  for (const r of records) {
+    const e = r.entity || "general";
+    if (e === "general") continue;
+    if (!byEntity[e]) byEntity[e] = [];
+    byEntity[e].push(r);
+  }
+
+  for (const [entity, recs] of Object.entries(byEntity)) {
+    if (recs.length < 5) continue;
+    if (existingTopics.has(entity)) continue;
+
+    const top = recs
+      .sort((a, b) => (b.importance || 5) - (a.importance || 5))
+      .slice(0, 3)
+      .map((r) => r.content.slice(0, 80));
+
+    saveEpisode(ws, {
+      summary: `[${entity}] ${top.join("; ")}`,
+      decisions: [],
+      mood: "",
+      topics: [entity],
+      participants: [],
+      source: "topic-summary",
+    });
+    generated++;
+  }
+
   return generated;
 }
 

package/package.json

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

package/setup.sh

@@ -149,6 +149,25 @@ if command -v node &>/dev/null && [ -f "$PLUGIN_DIR/extras/migrate-legacy.mjs" ]
   fi
 fi
 
+# --- 3c. Upgrade: run v5.0 embedding classification if not done yet ---
+if [ -f "$MEMORY_DIR/archival.jsonl" ] && [ ! -f "$MEMORY_DIR/classifier-anchors.json" ]; then
+  archival_count=$(wc -l < "$MEMORY_DIR/archival.jsonl" | tr -d ' ')
+  if [ "$archival_count" -gt 0 ]; then
+    echo ""
+    echo "📊 Upgrade detected: running v5.0 embedding-based classification..."
+    echo "   This replaces keyword-based entity/importance with semantic classification."
+    if command -v openclaw &>/dev/null; then
+      # Use the agent to run memory_quality (needs gateway running)
+      openclaw agent --agent main -m "memory_quality" --timeout 120 2>&1 | tail -3 || {
+        echo "⚠️  Quality pass via agent failed (gateway may not be running)."
+        echo "   Run manually after restart: openclaw agent -m 'memory_quality'"
+      }
+    else
+      echo "⚠️  openclaw CLI not found. Run after install: openclaw agent -m 'memory_quality'"
+    fi
+  fi
+fi
+
 # --- 4. Install memory-maintenance.sh ---
 SCRIPTS_DIR="$WORKSPACE/scripts"
 mkdir -p "$SCRIPTS_DIR"