openclaw-cortex-memory 0.1.0-Alpha.8 → 0.1.0

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,9 +2,9 @@
 
 const fs = require('fs');
 const path = require('path');
-const { spawn } = require('child_process');
 
 const PLUGIN_NAME = 'openclaw-cortex-memory';
+const EXCLUSIVE_MEMORY_PLUGINS = ['memory-core', 'memory-lancedb'];
 
 function findOpenClawConfig() {
   const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || '';
@@ -51,6 +51,41 @@ function saveConfig(configPath, config) {
   console.log(`Configuration saved to: ${configPath}`);
 }
 
+function ensureExclusiveMemoryMode(config) {
+  let changed = false;
+
+  if (!config.plugins) {
+    config.plugins = {};
+    changed = true;
+  }
+  if (!config.plugins.entries) {
+    config.plugins.entries = {};
+    changed = true;
+  }
+
+  for (const pluginId of EXCLUSIVE_MEMORY_PLUGINS) {
+    const current = config.plugins.entries[pluginId] || {};
+    if (current.enabled !== false) {
+      config.plugins.entries[pluginId] = {
+        ...current,
+        enabled: false
+      };
+      changed = true;
+    }
+  }
+
+  if (!config.plugins.slots) {
+    config.plugins.slots = {};
+    changed = true;
+  }
+  if (config.plugins.slots.memory !== 'none') {
+    config.plugins.slots.memory = 'none';
+    changed = true;
+  }
+
+  return changed;
+}
+
 function enablePlugin() {
   const configPath = findOpenClawConfig();
   
@@ -65,9 +100,15 @@ function enablePlugin() {
       plugins: {
         allow: [PLUGIN_NAME],
         slots: {
-          memory: PLUGIN_NAME
+          memory: 'none'
         },
         entries: {
+          'memory-core': {
+            enabled: false
+          },
+          'memory-lancedb': {
+            enabled: false
+          },
           [PLUGIN_NAME]: {
             enabled: true
           }
@@ -93,24 +134,26 @@ function enablePlugin() {
   if (!config.plugins.entries) {
     config.plugins.entries = {};
   }
-  
-  if (config.plugins.entries[PLUGIN_NAME]?.enabled === true) {
-    console.log(`Plugin '${PLUGIN_NAME}' is already enabled.`);
-    return;
-  }
-  
+
+  const wasEnabled = config.plugins.entries[PLUGIN_NAME]?.enabled === true;
   config.plugins.entries[PLUGIN_NAME] = {
     ...config.plugins.entries[PLUGIN_NAME],
     enabled: true
   };
-  
-  if (!config.plugins.slots) {
-    config.plugins.slots = {};
+
+  const exclusiveUpdated = ensureExclusiveMemoryMode(config);
+  if (wasEnabled && !exclusiveUpdated) {
+    console.log(`Plugin '${PLUGIN_NAME}' is already enabled.`);
+    return;
   }
-  config.plugins.slots.memory = PLUGIN_NAME;
-  
+
   saveConfig(configPath, config);
-  console.log(`Plugin '${PLUGIN_NAME}' has been enabled.`);
+  if (wasEnabled) {
+    console.log(`Plugin '${PLUGIN_NAME}' is already enabled.`);
+    console.log('Exclusive memory mode config has been refreshed (slots.memory=none, memory-core/memory-lancedb disabled).');
+  } else {
+    console.log(`Plugin '${PLUGIN_NAME}' has been enabled.`);
+  }
   console.log('The plugin will be activated on the next OpenClaw restart or config reload.');
 }
 
@@ -175,21 +218,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() {
@@ -221,13 +265,23 @@ Configuration:
   {
     "plugins": {
       "allow": ["openclaw-cortex-memory"],
+      "slots": {
+        "memory": "none"
+      },
       "entries": {
+        "memory-core": {
+          "enabled": false
+        },
+        "memory-lancedb": {
+          "enabled": false
+        },
         "openclaw-cortex-memory": {
           "enabled": true/false
         }
       }
     }
   }
+  Note: do not set plugins.slots.memory to "openclaw-cortex-memory".
 
 Fallback Behavior:
   When disabled, the plugin will fall back to OpenClaw's builtin