@smyslenny/agent-memory 2.0.0 → 2.2.0

package/.github/workflows/test.yml

@@ -0,0 +1,22 @@
+name: test
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  vitest:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - run: npm ci
+      - run: npm test
+

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 2.1.2 (2026-02-22)
+
+### 🔗 OpenClaw Integration V1 (Cron Synchronization)
+
+- **Capture → Consolidate → Surface closed loop** — agent-memory now integrates seamlessly with OpenClaw's built-in memory cron jobs (`memory-sync`, `memory-tidy`, `memory-surface`) with zero code changes ([DD-0004](docs/design/0004-agent-memory-integration.md))
+- **memory-sync** (14:00 & 22:00): Each new journal bullet is auto-synced to agent-memory via `mcporter call agent-memory.remember` with keyword-based type classification and URI dedup
+- **memory-tidy** (03:00): Triggers `agent-memory.reflect phase=all` (Ebbinghaus decay + tidy + govern) after Markdown consolidation, with consistency spot-check
+- **memory-surface** (14:05 & 22:05): Generates structured `RECENT.md` (≤80 lines) from high-vitality agent-memory entries, with fallback to raw journal reading
+- **Design principle**: Markdown remains source of truth; agent-memory is a derived index layer with best-effort sync
+- **README updated** with full OpenClaw Integration guide
+
+## 2.1.1 (2026-02-21)
+
+### 📝 Documentation
+
+- **Memory-janitor integration guide** — New `examples/openclaw-setup.md` section explaining what a memory janitor is and how to wire it to agent-memory (decay trigger + consistency check) ([PR #2](https://github.com/smysle/agent-memory/pull/2))
+- **Phase 5 prompt template** — New `examples/memory-janitor-phase5.md` with full prompt template for appending decay + consistency phases to an existing janitor cron job
+- Covers Gap 1 (Ebbinghaus decay never fires without external trigger) and Gap 2 (two-store divergence between agent-memory and canonical memory files)
+- Includes configurable conflict resolution strategies (canonical wins / agent-memory wins / manual review)
+
 ## 2.0.0 (2026-02-20)
 
 ### 🎉 Complete Rewrite

package/README.md

@@ -37,8 +37,8 @@ Inspired by how human brains consolidate memories during sleep, AgentMemory mana
 | 🕸️ **Knowledge Graph** | Multi-hop traversal across memory associations | PowerMem |
 | 📸 **Snapshots** | Auto-snapshot before every change, one-click rollback | nocturne + Memory Palace |
 | 🔍 **Intent-Aware Search** | Factual / temporal / causal / exploratory query routing | Memory Palace |
-| 🌙 **Sleep Cycle** | Automated sync → decay → tidy → govern pipeline | **Our original design** |
-| 💚 **Priority System** | P0 identity (never decays) → P3 event (14-day half-life) | **Our original design** |
+| 🌙 **Sleep Cycle** | Automated sync → decay → tidy → govern pipeline | - |
+| 💚 **Priority System** | P0 identity (never decays) → P3 event (14-day half-life) | - |
 | 🤝 **Multi-Agent** | Agent isolation via `agent_id` scope | PowerMem |
 | 🔌 **MCP Server** | 9 tools, works with Claude Code / Cursor / OpenClaw | Standard MCP |
 
@@ -47,7 +47,7 @@ Inspired by how human brains consolidate memories during sleep, AgentMemory mana
 ### Install
 
 ```bash
-npm install agent-memory
+npm install @smyslenny/agent-memory
 ```
 
 ### CLI
@@ -79,7 +79,7 @@ agent-memory status
 ### Library
 
 ```typescript
-import { openDatabase, syncOne, searchBM25, boot, runDecay } from 'agent-memory';
+import { openDatabase, syncOne, searchBM25, boot, runDecay } from '@smyslenny/agent-memory';
 
 const db = openDatabase({ path: './memory.db' });
 
@@ -106,9 +106,9 @@ runDecay(db);
 ```json
 {
   "mcpServers": {
-    "agent-memory": {
+    "@smyslenny/agent-memory": {
       "command": "node",
-      "args": ["node_modules/agent-memory/dist/mcp/server.js"],
+      "args": ["node_modules/@smyslenny/agent-memory/dist/mcp/server.js"],
       "env": {
         "AGENT_MEMORY_DB": "./memory.db"
       }
@@ -119,6 +119,46 @@ runDecay(db);
 
 **9 MCP Tools:** `remember` · `recall` · `recall_path` · `boot` · `forget` · `link` · `snapshot` · `reflect` · `status`
 
+## 🔗 OpenClaw Integration
+
+AgentMemory works **out of the box** with [OpenClaw](https://github.com/smysle/openclaw)'s built-in memory cron jobs — no code changes required. The integration implements a **Capture → Consolidate → Surface** closed loop that keeps Markdown journals and the structured memory DB in sync automatically.
+
+### How It Works
+
+```
+  Capture (memory-sync)          Consolidate (memory-tidy)        Surface (memory-surface)
+  ─────────────────────          ─────────────────────────        ───────────────────────
+  14:00 & 22:00                  03:00                            14:05 & 22:05
+  Session → daily journal        Compress old dailies             Recall top memories
+  + remember each bullet         Distill → MEMORY.md             → generate RECENT.md
+    into agent-memory DB         + reflect phase=all              (≤80 lines, 3 sections)
+```
+
+| Phase | Cron Job | What Happens | agent-memory Integration |
+|-------|----------|-------------|--------------------------|
+| **Capture** | `memory-sync` | Scans sessions, appends bullets to `memory/YYYY-MM-DD.md` | Each new bullet is also written via `mcporter call agent-memory.remember` with auto-classified type and URI-based dedup |
+| **Consolidate** | `memory-tidy` | Compresses old dailies → weekly summaries, distills `MEMORY.md` | Triggers `agent-memory.reflect phase=all` (decay + tidy + govern) + consistency spot-check |
+| **Surface** | `memory-surface` | Generates short-term context for new sessions | Reads high-vitality memories from agent-memory, outputs structured `RECENT.md` with emotion/knowledge/event sections |
+
+### Key Design Principles
+
+- **Markdown is source of truth** — agent-memory is a derived index layer; all data flows Markdown → DB, never the reverse.
+- **Best-effort sync** — If `mcporter` or agent-memory is unavailable, Markdown operations proceed normally. Failures only log warnings.
+- **URI-based idempotency** — Each journal bullet maps to a unique URI (`event://journal/2026-02-21#2200-1`), so re-runs are safe.
+- **Keyword-based classification** — Bullets are auto-classified as `knowledge`, `emotion`, or `event` using simple keyword rules (no extra model calls).
+
+### Setup
+
+If you're running OpenClaw with the standard memory cron suite (`memory-sync`, `memory-tidy`, `memory-surface`), the integration is **already active** — the cron prompts include agent-memory sync steps. Just make sure:
+
+1. **agent-memory is installed and initialized** — `agent-memory init`
+2. **mcporter bridge is configured** — agent-memory MCP server registered in your mcporter config
+3. **Cron jobs are enabled** — check with `openclaw cron list`
+
+For detailed setup and prompt templates, see:
+- [`examples/openclaw-setup.md`](examples/openclaw-setup.md) — Full setup walkthrough
+- [`docs/design/0004-agent-memory-integration.md`](docs/design/0004-agent-memory-integration.md) — Design document (DD-0004)
+
 ## 🏗️ Architecture
 
 ```

package/README.zh-CN.md

@@ -36,8 +36,8 @@ AI Agent 每次会话都会遗忘一切。上下文窗口有限，对话历史
 | 🕸️ **知识图谱** | 记忆关联的多跳遍历 | PowerMem |
 | 📸 **快照系统** | 每次修改前自动快照，一键回滚 | nocturne + Memory Palace |
 | 🔍 **意图感知搜索** | 事实型/时间型/因果型/探索型查询路由 | Memory Palace |
-| 🌙 **睡眠周期** | 自动化 sync → decay → tidy → govern 流水线 | **我们的原创设计** |
-| 💚 **优先级系统** | P0 身份（永不衰减）→ P3 事件（14天半衰期） | **我们的原创设计** |
+| 🌙 **睡眠周期** | 自动化 sync → decay → tidy → govern 流水线 | - |
+| 💚 **优先级系统** | P0 身份（永不衰减）→ P3 事件（14天半衰期） | - |
 | 🤝 **多 Agent** | 通过 `agent_id` 实现记忆隔离 | PowerMem |
 | 🔌 **MCP Server** | 9 个工具，支持 Claude Code / Cursor / OpenClaw | 标准 MCP |
 
@@ -46,7 +46,7 @@ AI Agent 每次会话都会遗忘一切。上下文窗口有限，对话历史
 ### 安装
 
 ```bash
-npm install agent-memory
+npm install @smyslenny/agent-memory
 ```
 
 ### 命令行
@@ -78,7 +78,7 @@ agent-memory status
 ### 作为库使用
 
 ```typescript
-import { openDatabase, syncOne, searchBM25, boot, runDecay } from 'agent-memory';
+import { openDatabase, syncOne, searchBM25, boot, runDecay } from '@smyslenny/agent-memory';
 
 const db = openDatabase({ path: './memory.db' });
 
@@ -105,9 +105,9 @@ runDecay(db);
 ```json
 {
   "mcpServers": {
-    "agent-memory": {
+    "@smyslenny/agent-memory": {
       "command": "node",
-      "args": ["node_modules/agent-memory/dist/mcp/server.js"],
+      "args": ["node_modules/@smyslenny/agent-memory/dist/mcp/server.js"],
       "env": {
         "AGENT_MEMORY_DB": "./memory.db"
       }