openclaw-cortex-memory 0.1.0-Alpha.3 → 0.1.0-Alpha.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-cortex-memory",
-  "version": "0.1.0-Alpha.3",
+  "version": "0.1.0-Alpha.31",
   "description": "Long-term memory system for OpenClaw AI Agent",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,9 +9,21 @@
   },
   "scripts": {
     "build": "tsc && node -e \"require('fs').copyFileSync('openclaw.plugin.json','dist/openclaw.plugin.json')\"",
+    "typecheck": "tsc --noEmit",
+    "check:version": "node scripts/check-version.js",
+    "test:compat": "node scripts/compat-regression.js",
+    "test:model": "node scripts/model-regression.js",
+    "test:graph": "node scripts/graph-eval.js",
+    "test:graph-quality": "node scripts/graph-quality-eval.js",
+    "test:graph-quality-zh": "node scripts/graph-quality-eval.js --gold eval/graph_quality_gold.zh.jsonl --pred eval/graph_quality_predictions.zh.sample.jsonl --thresholds eval/graph_quality_thresholds.json",
+    "test:m1-ingest-regression": "node scripts/m1-ingest-regression.js",
+    "test:m5-cross-store": "node scripts/m5-cross-store-regression.js",
+    "test:lengthnorm": "node scripts/lengthnorm-regression.js",
+    "test:all": "npm run test:compat && npm run test:model && npm run test:graph && npm run test:graph-quality && npm run test:graph-quality-zh && npm run test:lengthnorm",
+    "release:check": "node scripts/release-pipeline.js",
     "dev": "tsc --watch",
-    "prepublishOnly": "npm run build",
-    "postinstall": "node scripts/install.js"
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check:version && npm run build && npm run test:all"
   },
   "keywords": [
     "openclaw",
@@ -20,34 +32,73 @@
     "agent",
     "rag"
   ],
-  "author": "",
+  "author": "deki18",
   "license": "MIT",
   "dependencies": {
     "undici": "^6.21.0"
   },
+  "optionalDependencies": {
+    "@lancedb/lancedb": "^0.22.0"
+  },
   "devDependencies": {
     "@types/node": "^22.19.15",
     "typescript": "^5.7.2"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.3.8"
+    "openclaw": ">=2026.4.5"
   },
   "engines": {
     "node": ">=22.0.0"
   },
   "files": [
     "dist/",
-    "index.ts",
     "scripts/cli.js",
     "scripts/install.js",
     "scripts/uninstall.js",
+    "scripts/repair-memory.js",
+    "schema/",
     "openclaw.plugin.json",
-    "SKILL.md"
+    "SIGNATURE.md",
+    "SKILL.md",
+    "skills/cortex-memory/"
   ],
   "openclaw": {
     "plugin": true,
     "requiresPython": false,
     "cli": "cortex-memory",
+    "requires": {
+      "credentials": true,
+      "network": true,
+      "env": [
+        "EMBEDDING_API_KEY",
+        "LLM_API_KEY",
+        "RERANKER_API_KEY"
+      ],
+      "config": [
+        "embedding.apiKey",
+        "llm.apiKey",
+        "reranker.apiKey",
+        "embedding.baseURL",
+        "llm.baseURL",
+        "reranker.baseURL"
+      ],
+      "externalEndpoints": [
+        "embedding API endpoint (OpenAI-compatible /embeddings)",
+        "LLM API endpoint (OpenAI-compatible /chat/completions)",
+        "reranker API endpoint (/rerank)"
+      ]
+    },
+    "build": {
+      "openclawVersion": "2026.4.5",
+      "pluginSdkVersion": "2026.4.5"
+    },
+    "install": {
+      "minHostVersion": ">=2026.4.5"
+    },
+    "compat": {
+      "pluginApi": ">=2026.4.5",
+      "minGatewayVersion": "2026.4.5"
+    },
     "extensions": [
       "./dist/index.js"
     ]

package/schema/graph.schema.yaml

@@ -0,0 +1,330 @@
+{
+  "eventTypes": [
+    "decision",
+    "issue",
+    "fix",
+    "preference",
+    "plan",
+    "risk",
+    "insight",
+    "action_item",
+    "conversation_summary",
+    "constraint",
+    "requirement",
+    "milestone",
+    "blocker",
+    "dependency",
+    "assumption",
+    "retrospective",
+    "follow_up"
+  ],
+  "eventTypeAliases": {
+    "problem": "issue",
+    "error": "issue",
+    "bug": "issue",
+    "solution": "fix",
+    "workaround": "fix",
+    "todo": "action_item",
+    "next_step": "action_item",
+    "limitation": "constraint",
+    "guardrail": "constraint",
+    "spec": "requirement",
+    "acceptance_criteria": "requirement",
+    "deadline": "milestone",
+    "target": "milestone",
+    "roadblock": "blocker",
+    "stuck": "blocker",
+    "depends_on": "dependency",
+    "upstream": "dependency",
+    "hypothesis": "assumption",
+    "lesson": "retrospective",
+    "postmortem": "retrospective",
+    "followup": "follow_up",
+    "next_action": "follow_up"
+  },
+  "entityTypes": [
+    "Person",
+    "FamilyMember",
+    "Friend",
+    "Team",
+    "Project",
+    "Task",
+    "Plan",
+    "Milestone",
+    "Location",
+    "Event",
+    "Schedule",
+    "Habit",
+    "HealthItem",
+    "FinanceItem",
+    "Issue",
+    "Fix",
+    "Decision",
+    "Action",
+    "Risk",
+    "Blocker",
+    "Assumption",
+    "Concept",
+    "Resource",
+    "Document",
+    "ConfigFile",
+    "Preference",
+    "Case",
+    "Pattern",
+    "Date"
+  ],
+  "entityAliases": {
+    "OpenClaw": ["openclaw", "插件", "该项目", "本项目"],
+    "FamilyMember": ["家人", "家庭成员", "亲人"],
+    "Friend": ["朋友", "好友"],
+    "Team": ["团队", "小组", "组", "班组"],
+    "Location": ["地点", "位置", "住址", "地址"],
+    "Event": ["活动", "事情", "事项"],
+    "Schedule": ["日程", "安排", "计划表"],
+    "Habit": ["习惯", "作息"],
+    "HealthItem": ["健康", "体检", "药物", "锻炼"],
+    "FinanceItem": ["账单", "支出", "收入", "预算"],
+    "Plan": ["计划", "方案", "路线图"],
+    "Preference": ["偏好", "习惯选择"],
+    "Document": ["文档", "说明文档", "手册", "wiki", "README", "PRD", "方案文档"],
+    "Resource": ["资源", "物品", "物件", "设备", "工具", "素材", "资产"],
+    "ConfigFile": ["配置文件", "config", "配置"],
+    "Decision": ["决策", "决定", "拍板"],
+    "Action": ["动作", "操作", "执行"],
+    "Risk": ["风险", "隐患"],
+    "Blocker": ["阻塞", "卡点", "障碍"],
+    "Assumption": ["假设", "前提"],
+    "Concept": ["概念", "术语"],
+    "Case": ["案例", "case"],
+    "Pattern": ["模式", "pattern"],
+    "Date": ["日期", "时间", "时间点"],
+    "Person": ["我", "自己", "本人", "同事", "客户", "用户", "姓名", "名字", "人名", "成员", "联系人"],
+    "Project": ["项目", "工程", "项目线"],
+    "Task": ["任务", "待办", "todo", "工单", "事项"],
+    "Milestone": ["里程碑", "节点"],
+    "Issue": ["问题", "故障", "报错"],
+    "Fix": ["修复", "解决方案"]
+  },
+  "relationTypes": [
+    "depends_on",
+    "blocks",
+    "unblocks",
+    "causes",
+    "impacts",
+    "resolves",
+    "encountered_bug",
+    "solved_with",
+    "uses_tech",
+    "integrates_with",
+    "migrates_to",
+    "replaced_by",
+    "has_subtask",
+    "belongs_to",
+    "owned_by",
+    "implements",
+    "requires",
+    "plans_to",
+    "planned_for",
+    "scheduled_for",
+    "references",
+    "documents",
+    "defined_in",
+    "configured_in",
+    "supports",
+    "conflicts_with",
+    "duplicates",
+    "supersedes",
+    "assigned_to",
+    "reviewed_by",
+    "approved_by",
+    "rejected_by",
+    "reported_by",
+    "lives_in",
+    "cares_for",
+    "pays_for",
+    "prefers",
+    "has_spouse",
+    "has_child",
+    "birthday_on",
+    "anniversary_on"
+  ],
+  "relationTypeAliases": {
+    "dependency": "depends_on",
+    "blocked_by": "blocks",
+    "unblock": "unblocks",
+    "impact": "impacts",
+    "plan_to": "plans_to",
+    "plan_for": "planned_for",
+    "schedule_for": "scheduled_for",
+    "located_in": "lives_in",
+    "care_for": "cares_for",
+    "pay_for": "pays_for",
+    "support": "supports",
+    "conflict_with": "conflicts_with",
+    "use_tech": "uses_tech",
+    "tech_stack": "uses_tech",
+    "integrate_with": "integrates_with",
+    "migrate_to": "migrates_to",
+    "replace_by": "replaced_by",
+    "replace_with": "replaced_by",
+    "bug": "encountered_bug",
+    "bug_on": "encountered_bug",
+    "fix_with": "solved_with",
+    "solve_with": "solved_with",
+    "solved_by": "solved_with",
+    "subtask_of": "has_subtask",
+    "child_task": "has_subtask",
+    "documented_by": "documents",
+    "defined_by": "defined_in",
+    "config_in": "configured_in",
+    "duplicate_of": "duplicates",
+    "superseded_by": "supersedes",
+    "assign_to": "assigned_to",
+    "review_by": "reviewed_by",
+    "approve_by": "approved_by",
+    "reject_by": "rejected_by",
+    "report_by": "reported_by",
+    "依赖于": "depends_on",
+    "依赖": "depends_on",
+    "取决于": "depends_on",
+    "阻塞": "blocks",
+    "卡住": "blocks",
+    "解除阻塞": "unblocks",
+    "导致": "causes",
+    "引起": "causes",
+    "影响": "impacts",
+    "解决": "resolves",
+    "修复": "resolves",
+    "遇到报错": "encountered_bug",
+    "通过": "solved_with",
+    "使用技术": "uses_tech",
+    "集成": "integrates_with",
+    "迁移到": "migrates_to",
+    "被替代": "replaced_by",
+    "子任务": "has_subtask",
+    "属于": "belongs_to",
+    "归属": "belongs_to",
+    "负责": "owned_by",
+    "由": "owned_by",
+    "实现": "implements",
+    "需要": "requires",
+    "计划做": "plans_to",
+    "打算": "plans_to",
+    "计划于": "planned_for",
+    "安排在": "scheduled_for",
+    "约在": "scheduled_for",
+    "参考": "references",
+    "引用": "references",
+    "记录": "documents",
+    "定义于": "defined_in",
+    "配置于": "configured_in",
+    "支持": "supports",
+    "冲突": "conflicts_with",
+    "矛盾": "conflicts_with",
+    "重复": "duplicates",
+    "取代": "supersedes",
+    "分配给": "assigned_to",
+    "评审": "reviewed_by",
+    "批准": "approved_by",
+    "拒绝": "rejected_by",
+    "报告": "reported_by",
+    "住在": "lives_in",
+    "居住在": "lives_in",
+    "照顾": "cares_for",
+    "看护": "cares_for",
+    "支付": "pays_for",
+    "付款": "pays_for",
+    "偏好": "prefers",
+    "更喜欢": "prefers",
+    "配偶": "has_spouse",
+    "孩子": "has_child",
+    "生日": "birthday_on",
+    "纪念日": "anniversary_on",
+    "belongs": "belongs_to",
+    "owner_of": "owned_by",
+    "refer_to": "references",
+    "preference_for": "prefers",
+    "implement": "implements",
+    "need": "requires",
+    "technology": "uses_tech",
+    "encountered_issue": "encountered_bug",
+    "spouse": "has_spouse",
+    "wife_of": "has_spouse",
+    "husband_of": "has_spouse",
+    "child_of": "has_child",
+    "parent_of": "has_child",
+    "birthday": "birthday_on",
+    "born_on": "birthday_on",
+    "anniversary": "anniversary_on",
+    "married_on": "anniversary_on"
+  },
+  "relationRules": [
+    { "type": "depends_on", "fromTypes": ["Task", "Plan", "Milestone", "Issue"], "toTypes": ["Task", "Plan", "Milestone", "Issue", "Resource"], "allowSelfLoop": false },
+    { "type": "blocks", "fromTypes": ["Issue", "Task", "Risk", "Blocker"], "toTypes": ["Task", "Plan", "Milestone"], "allowSelfLoop": false },
+    { "type": "unblocks", "fromTypes": ["Fix", "Action", "Decision"], "toTypes": ["Task", "Issue", "Blocker"], "allowSelfLoop": false },
+    { "type": "causes", "fromTypes": ["Issue", "Risk", "Assumption"], "toTypes": ["Issue", "Risk", "Blocker"], "allowSelfLoop": false },
+    { "type": "impacts", "fromTypes": ["Issue", "Risk", "Task", "Project", "Event"], "toTypes": ["Task", "Project", "Issue", "Milestone", "Event"], "allowSelfLoop": false },
+    { "type": "resolves", "fromTypes": ["Fix", "Decision", "Action"], "toTypes": ["Issue", "Blocker", "Risk"], "allowSelfLoop": false },
+    { "type": "encountered_bug", "fromTypes": ["Project", "Task", "Action"], "toTypes": ["Issue", "Blocker"], "allowSelfLoop": false },
+    { "type": "solved_with", "fromTypes": ["Issue", "Blocker", "Task"], "toTypes": ["Fix", "Action", "Decision", "Resource", "Document"], "allowSelfLoop": false },
+    { "type": "uses_tech", "fromTypes": ["Project", "Task", "Fix", "Action"], "toTypes": ["Resource", "Document", "ConfigFile", "Project"], "allowSelfLoop": false },
+    { "type": "integrates_with", "fromTypes": ["Project", "Task", "Resource"], "toTypes": ["Project", "Resource"], "allowSelfLoop": false },
+    { "type": "migrates_to", "fromTypes": ["Project", "Task", "Resource", "ConfigFile"], "toTypes": ["Project", "Resource", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "replaced_by", "fromTypes": ["Project", "Task", "Resource", "Fix"], "toTypes": ["Project", "Task", "Resource", "Fix"], "allowSelfLoop": false },
+    { "type": "has_subtask", "fromTypes": ["Project", "Plan", "Milestone", "Task"], "toTypes": ["Task"], "allowSelfLoop": false },
+    { "type": "belongs_to", "fromTypes": ["Task", "Issue", "Fix", "Decision", "Document"], "toTypes": ["Project", "Plan", "Milestone", "Event"], "allowSelfLoop": false },
+    { "type": "owned_by", "fromTypes": ["Task", "Plan", "Project", "Issue", "Resource"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "implements", "fromTypes": ["Task", "Fix", "Project", "Document"], "toTypes": ["Plan", "Milestone", "Concept"], "allowSelfLoop": false },
+    { "type": "requires", "fromTypes": ["Task", "Fix", "Project", "Issue", "Plan"], "toTypes": ["Task", "Resource", "Document", "ConfigFile", "Date"], "allowSelfLoop": false },
+    { "type": "planned_for", "fromTypes": ["Task", "Plan", "Milestone"], "toTypes": ["Date", "Schedule", "Milestone"], "allowSelfLoop": false },
+    { "type": "scheduled_for", "fromTypes": ["Task", "Event", "Plan"], "toTypes": ["Date", "Schedule"], "allowSelfLoop": false },
+    { "type": "references", "fromTypes": ["Task", "Issue", "Fix", "Document", "Project"], "toTypes": ["Document", "Resource", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "documents", "fromTypes": ["Document", "Project", "Task"], "toTypes": ["Issue", "Fix", "Decision", "Event", "Case", "Pattern"], "allowSelfLoop": false },
+    { "type": "defined_in", "fromTypes": ["Task", "Issue", "Fix", "Pattern", "Case"], "toTypes": ["Document", "ConfigFile"], "allowSelfLoop": false },
+    { "type": "configured_in", "fromTypes": ["Task", "Fix", "Resource", "Project"], "toTypes": ["ConfigFile", "Document"], "allowSelfLoop": false },
+    { "type": "supports", "fromTypes": ["Resource", "Project", "Task", "Fix"], "toTypes": ["Task", "Project", "Issue", "Fix"], "allowSelfLoop": false },
+    { "type": "conflicts_with", "fromTypes": ["Task", "Plan", "Resource", "ConfigFile", "Issue"], "toTypes": ["Task", "Plan", "Resource", "ConfigFile", "Issue"], "allowSelfLoop": false },
+    { "type": "duplicates", "fromTypes": ["Issue", "Task", "Fix", "Document"], "toTypes": ["Issue", "Task", "Fix", "Document"], "allowSelfLoop": false },
+    { "type": "supersedes", "fromTypes": ["Fix", "Decision", "Document", "Plan", "Task"], "toTypes": ["Fix", "Decision", "Document", "Plan", "Task"], "allowSelfLoop": false },
+    { "type": "assigned_to", "fromTypes": ["Task", "Issue", "Fix", "Action"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "reviewed_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "approved_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "rejected_by", "fromTypes": ["Fix", "Task", "Document", "Decision"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "reported_by", "fromTypes": ["Issue", "Risk", "Blocker"], "toTypes": ["Person", "Team"], "allowSelfLoop": false },
+    { "type": "lives_in", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Location"], "allowSelfLoop": false },
+    { "type": "cares_for", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "pays_for", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember", "FinanceItem"], "allowSelfLoop": false },
+    { "type": "prefers", "fromTypes": ["Person", "Team"], "toTypes": ["Preference", "Resource", "Project", "Location", "Pattern"], "allowSelfLoop": false },
+    { "type": "has_spouse", "fromTypes": ["Person"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "has_child", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Person", "FamilyMember"], "allowSelfLoop": false },
+    { "type": "birthday_on", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Date"], "allowSelfLoop": false },
+    { "type": "anniversary_on", "fromTypes": ["Person", "FamilyMember"], "toTypes": ["Date"], "allowSelfLoop": false }
+  ],
+  "highValueRelationTypes": [
+    "depends_on",
+    "blocks",
+    "unblocks",
+    "causes",
+    "impacts",
+    "resolves",
+    "encountered_bug",
+    "solved_with",
+    "uses_tech",
+    "integrates_with",
+    "migrates_to",
+    "replaced_by",
+    "has_subtask",
+    "belongs_to",
+    "owned_by",
+    "implements",
+    "requires",
+    "planned_for",
+    "scheduled_for"
+  ],
+  "relatedToMaxRatio": 0,
+  "relatedToMaxAbsolute": 0,
+  "minRelationConfidence": 0.35,
+  "evidenceSpanRequired": true,
+  "endpointMentionRequired": true,
+  "defaultEntityType": "Concept"
+}

package/scripts/cli.js

@@ -2,16 +2,17 @@
 
 const fs = require('fs');
 const path = require('path');
-const { spawn } = require('child_process');
 
 const PLUGIN_NAME = 'openclaw-cortex-memory';
 
 function findOpenClawConfig() {
   const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || '';
+  const stateDir = process.env.OPENCLAW_STATE_DIR || '';
   const basePath = process.env.OPENCLAW_BASE_PATH || '';
   const homePath = process.env.USERPROFILE || process.env.HOME || '';
   const possiblePaths = [
     explicitConfigPath,
+    stateDir ? path.join(stateDir, 'openclaw.json') : '',
     basePath ? path.join(basePath, 'openclaw.json') : '',
     path.join(process.cwd(), 'openclaw.json'),
     homePath ? path.join(homePath, '.openclaw', 'openclaw.json') : '',
@@ -53,7 +54,10 @@ function enablePlugin() {
   const configPath = findOpenClawConfig();
   
   if (!configPath) {
-    const defaultPath = path.join(process.env.USERPROFILE || process.env.HOME || '', '.openclaw', 'openclaw.json');
+    const defaultPath = process.env.OPENCLAW_CONFIG_PATH
+      || (process.env.OPENCLAW_STATE_DIR ? path.join(process.env.OPENCLAW_STATE_DIR, 'openclaw.json') : '')
+      || (process.env.OPENCLAW_BASE_PATH ? path.join(process.env.OPENCLAW_BASE_PATH, 'openclaw.json') : '')
+      || path.join(process.env.USERPROFILE || process.env.HOME || '', '.openclaw', 'openclaw.json');
     console.log(`No config file found. Creating: ${defaultPath}`);
     
     const config = {
@@ -170,21 +174,22 @@ function getStatus() {
 }
 
 function runUninstall(args) {
-  const uninstallScript = path.join(__dirname, 'uninstall.js');
-  
-  if (!fs.existsSync(uninstallScript)) {
+  const uninstallScriptPath = path.join(__dirname, 'uninstall.js');
+  if (!fs.existsSync(uninstallScriptPath)) {
     console.error('Uninstall script not found.');
     process.exit(1);
   }
-  
-  const child = spawn(process.execPath, [uninstallScript, 'uninstall', ...args], {
-    stdio: 'inherit',
-    cwd: process.cwd()
-  });
-  
-  child.on('exit', (code) => {
-    process.exit(code || 0);
-  });
+  try {
+    const uninstallModule = require(uninstallScriptPath);
+    if (!uninstallModule || typeof uninstallModule.uninstall !== 'function') {
+      console.error('Invalid uninstall script export.');
+      process.exit(1);
+    }
+    uninstallModule.uninstall(args);
+  } catch (error) {
+    console.error(`Failed to run uninstall: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
+  }
 }
 
 function showHelp() {