memory-lucia 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chief of Staff
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NPM-PUBLISH-GUIDE.md

@@ -0,0 +1,169 @@
+# Memory V2 Skill - NPM 发布指南
+
+> 将 Memory V2 发布为 npm 包，供 ClawHub Skill 使用
+
+---
+
+## 📋 发现：ClawHub Skill 格式
+
+**ClawHub 上的 Skill 只有 SKILL.md**，代码通过 npm 安装。
+
+### 标准结构
+
+```
+clawhub-skill/
+└── SKILL.md          # 只有描述文件
+```
+
+### npm 包结构
+
+```
+memory-v2/            # npm 包
+├── package.json
+├── README.md
+├── LICENSE
+├── api/
+│   └── index.js      # 主入口
+├── modules/          # 核心模块
+└── ...
+```
+
+---
+
+## 🚀 发布流程
+
+### 步骤 1: 准备 npm 包
+
+```bash
+cd memory-v2-skill
+
+# 1. 确保 package.json 正确
+# 2. 更新版本号
+npm version 2.0.0
+
+# 3. 创建 .npmignore
+echo "tests/" > .npmignore
+echo "backups/" >> .npmignore
+echo "*.db" >> .npmignore
+
+# 4. 发布到 npm
+npm publish
+```
+
+### 步骤 2: 创建 ClawHub Skill
+
+创建 `clawhub-memory-v2/` 目录，只包含 SKILL.md：
+
+```yaml
+---
+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.
+  Requires: npm install memory-v2-skill
+---
+
+# Memory V2
+
+## Installation
+
+```bash
+npm install memory-v2-skill
+```
+
+## Usage
+
+```javascript
+const MemoryAPI = require('memory-v2-skill');
+
+const api = new MemoryAPI('./memory-v2.db');
+await api.init();
+
+// Track learning
+await api.startLearning(msgId, convId, message);
+
+// Record decision
+await api.recordDecision(msgId, convId, decisionData);
+
+// Get dashboard
+const dashboard = await api.getDashboard();
+```
+
+## API
+
+See: https://github.com/YOUR_USERNAME/memory-v2-skill#api
+```
+
+### 步骤 3: 打包并提交
+
+```bash
+# 打包 ClawHub Skill
+cd clawhub-memory-v2
+zip ../memory-v2.skill SKILL.md
+
+# 提交到 ClawHub
+# 上传 memory-v2.skill 文件
+```
+
+---
+
+## 📦 两种发布方式对比
+
+| 方式 | 适用场景 | 复杂度 |
+|------|---------|--------|
+| **npm + ClawHub** | 正式发布，用户易安装 | 高 |
+| **GitHub 直接安装** | 快速分享，开发者使用 | 低 |
+
+---
+
+## 🎯 推荐方案：GitHub 直接安装
+
+对于 Memory V2，推荐直接 GitHub 安装：
+
+### 用户使用
+
+```bash
+# 克隆到 skills 目录
+cd ~/.openclaw/skills
+git clone https://github.com/YOUR_USERNAME/memory-v2-skill.git memory-v2
+
+# 安装依赖
+cd memory-v2
+npm install
+
+# 使用
+const MemoryAPI = require('memory-v2');
+```
+
+### 优点
+- 无需 npm 账号
+- 无需打包
+- 用户可直接修改
+- 适合自用和分享
+
+---
+
+## ✅ 当前状态
+
+您的 `memory-v2-skill/` 已经可以直接使用：
+
+```bash
+# 本地测试
+cd memory-v2-skill
+npm install
+node -e "const M = require('./api'); console.log('OK')"
+
+# 打包 (zip 格式)
+zip -r memory-v2.skill . -x "*.db" "node_modules/*"
+```
+
+**用户安装后可以直接使用！**
+
+---
+
+## 📚 参考
+
+- npm 发布: https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry
+- ClawHub: https://clawhub.com

package/PUBLISH-STEPS.md

@@ -0,0 +1,102 @@
+# Memory Lucia 发布步骤
+
+## 🚀 一键发布
+
+在 `memory-v2-skill` 目录下执行：
+
+### Windows
+```bash
+publish.bat
+```
+
+### Linux/Mac
+```bash
+bash publish.sh
+```
+
+---
+
+## 📋 手动发布步骤
+
+### 步骤 1: 进入目录
+```bash
+cd C:\Users\snowya\.openclaw\workspace-chief_of_staff\memory-v2-skill
+```
+
+### 步骤 2: 登录 npm
+```bash
+npm login --auth-type=legacy
+```
+
+**输入信息：**
+- Username: `712724810@qq.com`
+- Password: `Q6Ymk#x_4dqM#T@`
+- Email: `712724810@qq.com`
+- Enter one-time password: (如果开启 2FA，输入验证码)
+
+### 步骤 3: 发布
+```bash
+npm publish --access=public
+```
+
+---
+
+## ✅ 验证发布
+
+发布成功后，访问：
+https://www.npmjs.com/package/memory-lucia
+
+---
+
+## 📦 用户使用
+
+发布后，用户可以直接安装：
+
+```bash
+npm install memory-lucia
+```
+
+```javascript
+const MemoryAPI = require('memory-lucia');
+const api = new MemoryAPI('./memory.db');
+await api.init();
+```
+
+---
+
+## 🔧 如果发布失败
+
+### 错误 1: 包名已存在
+```bash
+# 修改 package.json 中的 name
+# 或者使用 scoped name: @yourname/memory-lucia
+```
+
+### 错误 2: 未登录
+```bash
+npm login --auth-type=legacy
+# 重新登录
+```
+
+### 错误 3: 版本已存在
+```bash
+# 更新版本号
+npm version patch  # 2.0.0 -> 2.0.1
+npm publish
+```
+
+---
+
+## 📊 发布信息
+
+| 属性 | 值 |
+|------|-----|
+| 包名 | `memory-lucia` |
+| 版本 | `2.0.0` |
+| 大小 | 14.4 KB |
+| 主入口 | `api/index.js` |
+| 依赖 | `sqlite3` |
+
+---
+
+**执行 `publish.bat` 或 `publish.sh` 即可发布！**

package/README.md

@@ -0,0 +1,64 @@
+# Memory Lucia
+
+[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/YOUR_USERNAME/memory-lucia/releases)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Advanced memory system for OpenClaw agents with priority analysis, learning tracking, decision recording, and skill evolution.
+
+## 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
+
+## Quick Start
+
+```bash
+# Install
+npm install memory-lucia
+```
+
+```javascript
+const MemoryAPI = require('memory-lucia');
+
+const api = new MemoryAPI('./memory-v2.db');
+await api.init();
+
+// Track learning
+await api.startLearning(msgId, convId, message);
+
+// Get dashboard
+const dashboard = await api.getDashboard();
+```
+
+## Core Modules
+
+- **Priority** - Message priority analysis
+- **Learning** - Learning progress tracking
+- **Decision** - Decision recording and review
+- **Evolution** - Skill usage monitoring
+- **Version** - Backup and rollback
+
+## Documentation
+
+- [SKILL.md](SKILL.md) - Skill description and usage
+- [API Reference](references/API.md) - Complete API documentation
+
+## Database
+
+SQLite backend with tables:
+- `memory_priorities`
+- `memory_learning`
+- `memory_decisions`
+- `memory_evolution`
+
+## Version
+
+Current: 2.0.0
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,120 @@
+---
+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