memory-lucia 2.0.1 → 2.0.3

package/README.md

@@ -1,111 +1,111 @@
-# Memory Lucia
-
-[![npm version](https://img.shields.io/npm/v/memory-lucia.svg)](https://www.npmjs.com/package/memory-lucia)
-[![GitHub](https://img.shields.io/badge/github-memory--lucia-blue.svg)](https://github.com/wen521/memory-lucia-)
-[![License](https://img.shields.io/npm/l/memory-lucia.svg)](LICENSE)
-
-Advanced memory system for OpenClaw agents with priority analysis, learning tracking, decision recording, and skill evolution.
-
-## 📦 Installation
-
-```bash
-npm install memory-lucia
-```
-
-## 🚀 Quick Start
-
-```javascript
-const MemoryAPI = require('memory-lucia');
-
-const api = new MemoryAPI('./memory.db');
-await api.init();
-
-// Track learning progress
-await api.startLearning(msgId, convId, message);
-await api.updateLearningProgress(learningId, { progress: 50 });
-
-// Record a decision
-await api.recordDecision(msgId, convId, {
-  summary: 'Choose SQLite over PostgreSQL',
-  context: 'For local deployment',
-  expectedOutcome: 'Simpler setup'
-});
-
-// Get dashboard
-const dashboard = await api.getDashboard();
-console.log(dashboard);
-```
-
-## ✨ Features
-
-- 🎯 **Priority Analysis** - Analyze and store message priorities
-- 📚 **Learning Tracking** - Track learning progress and milestones
-- 🎯 **Decision Recording** - Record decisions with outcomes and reviews
-- 📈 **Skill Evolution** - Monitor skill usage and growth
-- 💾 **Version Management** - Automatic backups with rollback
-- 📊 **Dashboard** - Unified view of all memory data
-
-## 📖 Core Modules
-
-### 1. Priority Module
-Analyze and store message priorities.
-
-```javascript
-const analysis = await api.analyzePriority(message);
-await api.storePriority(msgId, convId, analysis);
-const highPriority = await api.getHighPriority(10);
-```
-
-### 2. Learning Module
-Track learning topics and progress.
-
-```javascript
-const learning = await api.startLearning(msgId, convId, message);
-await api.addMilestone(learning.id, { title: 'Completed Chapter 1' });
-const active = await api.getActiveLearning(5);
-```
-
-### 3. Decision Module
-Record and review decisions.
-
-```javascript
-await api.recordDecision(msgId, convId, decisionData);
-await api.updateDecisionOutcome(decisionId, { actualOutcome: 'Success' });
-const pending = await api.getPendingDecisions();
-```
-
-### 4. Evolution Module
-Monitor skill usage.
-
-```javascript
-await api.recordSkillUsage('skill-name', 'category', 'success');
-const topSkills = await api.getTopSkills(10);
-```
-
-## 📚 Documentation
-
-- [SKILL.md](SKILL.md) - Skill description and usage
-- [API Reference](references/API.md) - Complete API documentation
-- [Architecture](references/ARCHITECTURE.md) - System design
-
-## 🗄️ Database
-
-SQLite backend with tables:
-- `memory_priorities` - Priority analysis
-- `memory_learning` - Learning tracking
-- `memory_decisions` - Decision records
-- `memory_evolution` - Skill usage
-
-## 🔗 Links
-
-- **npm**: https://www.npmjs.com/package/memory-lucia
-- **GitHub**: https://github.com/wen521/memory-lucia-
-- **Issues**: https://github.com/wen521/memory-lucia-/issues
-
-## 📋 Version
-
-Current: 2.0.0
-
-## 📄 License
-
-MIT © Chief of Staff
+# Memory Lucia
+
+[![npm version](https://img.shields.io/npm/v/memory-lucia.svg)](https://www.npmjs.com/package/memory-lucia)
+[![GitHub](https://img.shields.io/badge/github-memory--lucia-blue.svg)](https://github.com/wen521/memory-lucia-)
+[![License](https://img.shields.io/npm/l/memory-lucia.svg)](LICENSE)
+
+Advanced memory system for OpenClaw agents with priority analysis, learning tracking, decision recording, and skill evolution.
+
+## 📦 Installation
+
+```bash
+npm install memory-lucia
+```
+
+## 🚀 Quick Start
+
+```javascript
+const MemoryAPI = require('memory-lucia');
+
+const api = new MemoryAPI('./memory.db');
+await api.init();
+
+// Track learning progress
+await api.startLearning(msgId, convId, message);
+await api.updateLearningProgress(learningId, { progress: 50 });
+
+// Record a decision
+await api.recordDecision(msgId, convId, {
+  summary: 'Choose SQLite over PostgreSQL',
+  context: 'For local deployment',
+  expectedOutcome: 'Simpler setup'
+});
+
+// Get dashboard
+const dashboard = await api.getDashboard();
+console.log(dashboard);
+```
+
+## ✨ Features
+
+- 🎯 **Priority Analysis** - Analyze and store message priorities
+- 📚 **Learning Tracking** - Track learning progress and milestones
+- 🎯 **Decision Recording** - Record decisions with outcomes and reviews
+- 📈 **Skill Evolution** - Monitor skill usage and growth
+- 💾 **Version Management** - Automatic backups with rollback
+- 📊 **Dashboard** - Unified view of all memory data
+
+## 📖 Core Modules
+
+### 1. Priority Module
+Analyze and store message priorities.
+
+```javascript
+const analysis = await api.analyzePriority(message);
+await api.storePriority(msgId, convId, analysis);
+const highPriority = await api.getHighPriority(10);
+```
+
+### 2. Learning Module
+Track learning topics and progress.
+
+```javascript
+const learning = await api.startLearning(msgId, convId, message);
+await api.addMilestone(learning.id, { title: 'Completed Chapter 1' });
+const active = await api.getActiveLearning(5);
+```
+
+### 3. Decision Module
+Record and review decisions.
+
+```javascript
+await api.recordDecision(msgId, convId, decisionData);
+await api.updateDecisionOutcome(decisionId, { actualOutcome: 'Success' });
+const pending = await api.getPendingDecisions();
+```
+
+### 4. Evolution Module
+Monitor skill usage.
+
+```javascript
+await api.recordSkillUsage('skill-name', 'category', 'success');
+const topSkills = await api.getTopSkills(10);
+```
+
+## 📚 Documentation
+
+- [SKILL.md](SKILL.md) - Skill description and usage
+- [API Reference](references/API.md) - Complete API documentation
+- [Architecture](references/ARCHITECTURE.md) - System design
+
+## 🗄️ Database
+
+SQLite backend with tables:
+- `memory_priorities` - Priority analysis
+- `memory_learning` - Learning tracking
+- `memory_decisions` - Decision records
+- `memory_evolution` - Skill usage
+
+## 🔗 Links
+
+- **npm**: https://www.npmjs.com/package/memory-lucia
+- **GitHub**: https://github.com/wen521/memory-lucia-
+- **Issues**: https://github.com/wen521/memory-lucia-/issues
+
+## 📋 Version
+
+Current: 2.0.3
+
+## 📄 License
+
+MIT © Chief of Staff

package/SKILL.md

@@ -1,120 +1,121 @@
----
-name: memory-v2
-description: |
-  Advanced memory system for OpenClaw agents with priority analysis, 
-  learning tracking, decision recording, and skill evolution.
-  Use when: (1) Tracking learning progress and milestones, (2) Recording decisions with outcomes, 
-  (3) Analyzing message priorities, (4) Monitoring skill usage and growth.
----
-
-# Memory V2 Skill
-
-## Overview
-
-Memory V2 is a comprehensive memory management system for OpenClaw agents, providing persistent storage and intelligent analysis capabilities.
-
-## Features
-
-- **Priority Analysis**: Analyze and store message priorities with reasoning
-- **Learning Tracking**: Track learning progress, milestones, and completion
-- **Decision Recording**: Record decisions with context, outcomes, and scheduled reviews
-- **Skill Evolution**: Monitor skill usage patterns and growth over time
-- **Version Management**: Backup and rollback capabilities
-- **Dashboard**: Unified view of all memory data
-
-## Installation
-
-```bash
-# Install dependencies
-npm install sqlite3
-
-# Initialize database
-node scripts/init-memory.js
-```
-
-## Quick Start
-
-```javascript
-const MemoryAPI = require('./api');
-
-const api = new MemoryAPI('./memory-v2.db');
-await api.init();
-
-// Track learning progress
-await api.startLearning(msgId, convId, message);
-await api.updateLearningProgress(learningId, { progress: 50 });
-
-// Record a decision
-await api.recordDecision(msgId, convId, {
-  summary: 'Choose SQLite over PostgreSQL',
-  context: 'For local deployment',
-  expectedOutcome: 'Simpler setup'
-});
-
-// Get dashboard
-const dashboard = await api.getDashboard();
-```
-
-## Core Modules
-
-### 1. Priority Module
-Analyze and store message priorities.
-
-```javascript
-const analysis = await api.analyzePriority(message);
-await api.storePriority(msgId, convId, analysis);
-const highPriority = await api.getHighPriority(10);
-```
-
-### 2. Learning Module
-Track learning topics and progress.
-
-```javascript
-const learning = await api.startLearning(msgId, convId, message);
-await api.addMilestone(learning.id, { title: 'Completed Chapter 1' });
-const active = await api.getActiveLearning(5);
-```
-
-### 3. Decision Module
-Record and review decisions.
-
-```javascript
-await api.recordDecision(msgId, convId, decisionData);
-await api.updateDecisionOutcome(decisionId, { actualOutcome: 'Success' });
-const pending = await api.getPendingDecisions();
-```
-
-### 4. Evolution Module
-Monitor skill usage.
-
-```javascript
-await api.recordSkillUsage('skill-name', 'category', 'success');
-const topSkills = await api.getTopSkills(10);
-```
-
-## API Reference
-
-See `references/API.md` for complete API documentation.
-
-## Database Schema
-
-SQLite database with tables:
-- `memory_priorities` - Priority analysis
-- `memory_learning` - Learning tracking
-- `memory_decisions` - Decision records
-- `memory_evolution` - Skill usage
-
-## Migration
-
-From V1 to V2:
-```bash
-node migrations/v1-to-v2.js old-memory.db
-```
-
-## Version
-
-Current: 2.0.0
-
-## License
-
-MIT
+---
+name: memory-v2
+version: 2.0.3
+description: |
+  Advanced memory system for OpenClaw agents with priority analysis, 
+  learning tracking, decision recording, and skill evolution.
+  Use when: (1) Tracking learning progress and milestones, (2) Recording decisions with outcomes, 
+  (3) Analyzing message priorities, (4) Monitoring skill usage and growth.
+---
+
+# Memory V2 Skill
+
+## Overview
+
+Memory V2 is a comprehensive memory management system for OpenClaw agents, providing persistent storage and intelligent analysis capabilities.
+
+## Features
+
+- **Priority Analysis**: Analyze and store message priorities with reasoning
+- **Learning Tracking**: Track learning progress, milestones, and completion
+- **Decision Recording**: Record decisions with context, outcomes, and scheduled reviews
+- **Skill Evolution**: Monitor skill usage patterns and growth over time
+- **Version Management**: Backup and rollback capabilities
+- **Dashboard**: Unified view of all memory data
+
+## Installation
+
+```bash
+# Install dependencies
+npm install sqlite3
+
+# Initialize database
+node scripts/init-memory.js
+```
+
+## Quick Start
+
+```javascript
+const MemoryAPI = require('./api');
+
+const api = new MemoryAPI('./memory-v2.db');
+await api.init();
+
+// Track learning progress
+await api.startLearning(msgId, convId, message);
+await api.updateLearningProgress(learningId, { progress: 50 });
+
+// Record a decision
+await api.recordDecision(msgId, convId, {
+  summary: 'Choose SQLite over PostgreSQL',
+  context: 'For local deployment',
+  expectedOutcome: 'Simpler setup'
+});
+
+// Get dashboard
+const dashboard = await api.getDashboard();
+```
+
+## Core Modules
+
+### 1. Priority Module
+Analyze and store message priorities.
+
+```javascript
+const analysis = await api.analyzePriority(message);
+await api.storePriority(msgId, convId, analysis);
+const highPriority = await api.getHighPriority(10);
+```
+
+### 2. Learning Module
+Track learning topics and progress.
+
+```javascript
+const learning = await api.startLearning(msgId, convId, message);
+await api.addMilestone(learning.id, { title: 'Completed Chapter 1' });
+const active = await api.getActiveLearning(5);
+```
+
+### 3. Decision Module
+Record and review decisions.
+
+```javascript
+await api.recordDecision(msgId, convId, decisionData);
+await api.updateDecisionOutcome(decisionId, { actualOutcome: 'Success' });
+const pending = await api.getPendingDecisions();
+```
+
+### 4. Evolution Module
+Monitor skill usage.
+
+```javascript
+await api.recordSkillUsage('skill-name', 'category', 'success');
+const topSkills = await api.getTopSkills(10);
+```
+
+## API Reference
+
+See `references/API.md` for complete API documentation.
+
+## Database Schema
+
+SQLite database with tables:
+- `memory_priorities` - Priority analysis
+- `memory_learning` - Learning tracking
+- `memory_decisions` - Decision records
+- `memory_evolution` - Skill usage
+
+## Migration
+
+From V1 to V2:
+```bash
+node migrations/v1-to-v2.js old-memory.db
+```
+
+## Version
+
+Current: 2.0.2
+
+## License
+
+MIT

package/database/schema.sql

@@ -0,0 +1,152 @@
+-- Memory V2.0 Database Schema
+-- SQLite database schema for OpenClaw Memory System
+
+-- Priority Analysis Table
+CREATE TABLE IF NOT EXISTS memory_priorities (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    msg_id TEXT NOT NULL,
+    conv_id TEXT,
+    priority_level TEXT CHECK(priority_level IN ('critical', 'high', 'medium', 'low')),
+    reasoning TEXT,
+    category TEXT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Learning Tracking Table
+CREATE TABLE IF NOT EXISTS memory_learning (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    msg_id TEXT NOT NULL,
+    conv_id TEXT,
+    topic TEXT,
+    description TEXT,
+    status TEXT CHECK(status IN ('active', 'paused', 'completed', 'abandoned')) DEFAULT 'active',
+    progress INTEGER DEFAULT 0 CHECK(progress >= 0 AND progress <= 100),
+    started_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    completed_at DATETIME
+);
+
+-- Learning Milestones Table
+CREATE TABLE IF NOT EXISTS memory_learning_milestones (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    learning_id INTEGER NOT NULL,
+    title TEXT NOT NULL,
+    description TEXT,
+    achieved_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (learning_id) REFERENCES memory_learning(id) ON DELETE CASCADE
+);
+
+-- Decision Records Table
+CREATE TABLE IF NOT EXISTS memory_decisions (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    msg_id TEXT NOT NULL,
+    conv_id TEXT,
+    summary TEXT NOT NULL,
+    context TEXT,
+    expected_outcome TEXT,
+    actual_outcome TEXT,
+    status TEXT CHECK(status IN ('pending', 'implemented', 'validated', 'rejected')) DEFAULT 'pending',
+    review_scheduled_at DATETIME,
+    reviewed_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Skill Evolution Table
+CREATE TABLE IF NOT EXISTS memory_evolution (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    skill_name TEXT NOT NULL,
+    category TEXT,
+    usage_count INTEGER DEFAULT 0,
+    success_count INTEGER DEFAULT 0,
+    last_used_at DATETIME,
+    first_used_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Database Version Tracking
+CREATE TABLE IF NOT EXISTS memory_schema_version (
+    version TEXT PRIMARY KEY,
+    applied_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Insert initial version
+INSERT OR IGNORE INTO memory_schema_version (version) VALUES ('2.0.0');
+
+-- Create indexes for performance
+CREATE INDEX IF NOT EXISTS idx_priorities_level ON memory_priorities(priority_level);
+CREATE INDEX IF NOT EXISTS idx_priorities_created ON memory_priorities(created_at);
+CREATE INDEX IF NOT EXISTS idx_learning_status ON memory_learning(status);
+CREATE INDEX IF NOT EXISTS idx_learning_topic ON memory_learning(topic);
+CREATE INDEX IF NOT EXISTS idx_decisions_status ON memory_decisions(status);
+CREATE INDEX IF NOT EXISTS idx_decisions_review ON memory_decisions(review_scheduled_at);
+CREATE INDEX IF NOT EXISTS idx_evolution_skill ON memory_evolution(skill_name);
+CREATE INDEX IF NOT EXISTS idx_evolution_category ON memory_evolution(category);
+
+-- Views for common queries
+
+-- View: Pending Decisions
+CREATE VIEW IF NOT EXISTS v_pending_decisions AS
+SELECT 
+    d.*,
+    CASE 
+        WHEN review_scheduled_at < CURRENT_TIMESTAMP THEN 'overdue'
+        WHEN review_scheduled_at <= datetime('now', '+7 days') THEN 'due_soon'
+        ELSE 'scheduled'
+    END as review_status
+FROM memory_decisions d
+WHERE status IN ('pending', 'implemented')
+    AND (review_scheduled_at IS NULL OR review_scheduled_at <= datetime('now', '+7 days'))
+ORDER BY review_scheduled_at ASC;
+
+-- View: Skill Summary
+CREATE VIEW IF NOT EXISTS v_skill_summary AS
+SELECT 
+    skill_name,
+    category,
+    usage_count,
+    success_count,
+    CASE 
+        WHEN usage_count > 0 THEN ROUND(100.0 * success_count / usage_count, 2)
+        ELSE 0
+    END as success_rate,
+    last_used_at,
+    first_used_at
+FROM memory_evolution
+ORDER BY usage_count DESC;
+
+-- View: Weekly Learning Report
+CREATE VIEW IF NOT EXISTS v_weekly_learning_report AS
+SELECT 
+    topic,
+    COUNT(*) as session_count,
+    AVG(progress) as avg_progress,
+    MAX(updated_at) as last_activity,
+    SUM(CASE WHEN status = 'completed' THEN 1 ELSE 0 END) as completed_count
+FROM memory_learning
+WHERE updated_at >= datetime('now', '-7 days')
+GROUP BY topic
+ORDER BY last_activity DESC;
+
+-- View: High Priority Items
+CREATE VIEW IF NOT EXISTS v_high_priority AS
+SELECT 
+    'priority' as type,
+    id,
+    msg_id,
+    priority_level as level,
+    category,
+    reasoning as details,
+    created_at
+FROM memory_priorities
+WHERE priority_level IN ('critical', 'high')
+UNION ALL
+SELECT 
+    'decision' as type,
+    id,
+    msg_id,
+    status as level,
+    'decision' as category,
+    summary as details,
+    created_at
+FROM memory_decisions
+WHERE status = 'pending' AND review_scheduled_at <= CURRENT_TIMESTAMP
+ORDER BY created_at DESC;