@smyslenny/agent-memory 4.1.0-alpha.1 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 4.2.0 (2026-03-19)
+
+### 🛡️ Anti-Noise Hardening
+
+This release addresses the "heartbeat flood" problem where memory-sync cron
+ingested hundreds of low-value status observations (e.g. "HEARTBEAT_OK",
+"安静模式", "PR 无变化") into the curated memory store.
+
+#### Guard improvements
+- **Raised specificity threshold** for P2/P3 memories from 8 to 20 effective
+  characters
+- **CJK-aware length calculation**: CJK characters count as 3 effective chars
+  (reflecting their higher information density vs ASCII), preventing false
+  rejections of legitimate Chinese content
+
+#### Ingest noise filter
+- Added `isIngestNoise()` pre-filter in `extractIngestItems()` that skips lines
+  matching known noise patterns before they reach the Write Guard:
+  - Heartbeat status: `HEARTBEAT_OK`, `安静模式`, `不打扰`, `继续安静待命`
+  - Empty deltas: `无新 delta`, `无变化`, `无紧急`, `无新进展`
+  - System dumps: `openclaw status`, `openclaw gateway status`, `session_status`
+  - Stale PR observations: `PR #NNN 无变化`, `基线未变`, `轻量复查`
+  - Cron noise: `cron 会话`, `距上次心跳`, `危险区协议`
+
+#### Tidy expansion
+- `getDecayedMemories()` now includes **P2 (knowledge)** in cleanup candidates
+  (previously only P3 event). This means decayed low-vitality knowledge entries
+  will be cleaned up during sleep tidy, not just events.
+
+#### Govern env config
+- `maxMemories` can now be set via `AGENT_MEMORY_MAX_MEMORIES` environment
+  variable (default: 200)
+
+### ✅ Tests
+- 66 tests passing (19 files)
+- Added `tests/ingest/noise-filter.test.ts` covering heartbeat noise rejection,
+  meaningful content preservation, and mixed signal/noise handling
+
 ## 4.0.0-alpha.1 (2026-03-09)
 
 ### 🚀 Repositioning

package/dist/bin/agent-memory.js

@@ -2187,9 +2187,11 @@ function fourCriterionGate(input) {
   const content = input.content.trim();
   const failed = [];
   const priority = input.priority ?? (input.type === "identity" ? 0 : input.type === "emotion" ? 1 : input.type === "knowledge" ? 2 : 3);
-  const minLength = priority <= 1 ? 4 : 8;
-  const specificity = content.length >= minLength ? Math.min(1, content.length / 50) : 0;
-  if (specificity === 0) failed.push(`specificity (too short: ${content.length} < ${minLength} chars)`);
+  const cjkCount = (content.match(/[\u4e00-\u9fff\u3400-\u4dbf]/g) ?? []).length;
+  const effectiveLength = content.length + cjkCount * 2;
+  const minLength = priority <= 1 ? 4 : 20;
+  const specificity = effectiveLength >= minLength ? Math.min(1, effectiveLength / 50) : 0;
+  if (specificity === 0) failed.push(`specificity (too short: effective ${effectiveLength} < ${minLength} chars)`);
   const tokens = tokenize(content);
   const novelty = tokens.length >= 1 ? Math.min(1, tokens.length / 5) : 0;
   if (novelty === 0) failed.push("novelty (no meaningful tokens after filtering)");
@@ -2420,9 +2422,9 @@ function getDecayedMemories(db, threshold = 0.05, opts) {
   const agentId = opts?.agent_id;
   return db.prepare(
     agentId ? `SELECT id, content, vitality, priority FROM memories
-           WHERE vitality < ? AND priority >= 3 AND agent_id = ?
+           WHERE vitality < ? AND priority >= 2 AND agent_id = ?
            ORDER BY vitality ASC` : `SELECT id, content, vitality, priority FROM memories
-           WHERE vitality < ? AND priority >= 3
+           WHERE vitality < ? AND priority >= 2
            ORDER BY vitality ASC`
   ).all(...agentId ? [threshold, agentId] : [threshold]);
 }
@@ -2520,7 +2522,8 @@ function rankEvictionCandidates(db, opts) {
 }
 function runGovern(db, opts) {
   const agentId = opts?.agent_id;
-  const maxMemories = opts?.maxMemories ?? 200;
+  const envMax = Number.parseInt(process.env.AGENT_MEMORY_MAX_MEMORIES ?? "", 10);
+  const maxMemories = opts?.maxMemories ?? (Number.isFinite(envMax) && envMax > 0 ? envMax : 200);
   let orphanPaths = 0;
   let emptyMemories = 0;
   let evicted = 0;