clawvault 3.0.0 → 3.2.0

package/hooks/clawvault/handler.test.js

@@ -46,8 +46,6 @@ async function loadHandler() {
 afterEach(() => {
   vi.clearAllMocks();
   delete process.env.CLAWVAULT_PATH;
-  delete process.env.OPENCLAW_MEMORY_PATH;
-  delete process.env.OPENCLAW_VAULT_PATH;
   delete process.env.OPENCLAW_STATE_DIR;
   delete process.env.OPENCLAW_HOME;
   delete process.env.OPENCLAW_AGENT_ID;
@@ -107,28 +105,6 @@ describe('clawvault hook handler', () => {
     fs.rmSync(vaultPath, { recursive: true, force: true });
   });
 
-  it('supports slash-prefixed command actions for /new', async () => {
-    const vaultPath = makeVaultFixture();
-    process.env.CLAWVAULT_PATH = vaultPath;
-    execFileSyncMock.mockReturnValue('');
-
-    const handler = await loadHandler();
-    await handler({
-      type: 'command',
-      action: '/new',
-      sessionKey: 'agent:clawdious:main',
-      context: { commandSource: 'slash' }
-    });
-
-    expect(execFileSyncMock).toHaveBeenCalledWith(
-      'clawvault',
-      expect.arrayContaining(['checkpoint', '--working-on']),
-      expect.objectContaining({ shell: false })
-    );
-
-    fs.rmSync(vaultPath, { recursive: true, force: true });
-  });
-
   it('injects recap and memory context on session start alias event', async () => {
     const vaultPath = makeVaultFixture();
     process.env.CLAWVAULT_PATH = vaultPath;
@@ -265,90 +241,270 @@ describe('clawvault hook handler', () => {
     fs.rmSync(vaultPath, { recursive: true, force: true });
   });
 
-  it('supports compaction action separator variants', async () => {
+  it('runs weekly reflection on cron.weekly at Sunday midnight', async () => {
     const vaultPath = makeVaultFixture();
     process.env.CLAWVAULT_PATH = vaultPath;
     execFileSyncMock.mockReturnValue('');
 
     const handler = await loadHandler();
     await handler({
-      type: 'compaction',
-      action: 'memory_flush',
-      sessionKey: 'agent:clawdious:main'
+      eventName: 'cron.weekly',
+      timestamp: '2026-02-15T00:00:00.000Z'
     });
 
     expect(execFileSyncMock).toHaveBeenCalledWith(
       'clawvault',
-      expect.arrayContaining(['observe', '--cron', '--min-new', '1']),
+      expect.arrayContaining(['reflect', '-v', vaultPath]),
       expect.objectContaining({ shell: false })
     );
 
     fs.rmSync(vaultPath, { recursive: true, force: true });
   });
 
-  it('discovers canonical ~/memory vault when env and cwd do not provide one', async () => {
-    const fakeHome = fs.mkdtempSync(path.join(os.tmpdir(), 'clawvault-home-'));
-    const vaultPath = path.join(fakeHome, 'memory');
-    fs.mkdirSync(vaultPath, { recursive: true });
-    fs.writeFileSync(path.join(vaultPath, '.clawvault.json'), JSON.stringify({ name: 'home' }), 'utf-8');
-    const originalHome = process.env.HOME;
-    const originalClawvaultPath = process.env.CLAWVAULT_PATH;
-    const originalOpenclawMemory = process.env.OPENCLAW_MEMORY_PATH;
-    const originalOpenclawVault = process.env.OPENCLAW_VAULT_PATH;
-    process.env.HOME = fakeHome;
-    delete process.env.CLAWVAULT_PATH;
-    delete process.env.OPENCLAW_MEMORY_PATH;
-    delete process.env.OPENCLAW_VAULT_PATH;
-    // Mock cwd to a temp dir without a vault so walk-up doesn't find one
-    const fakeCwd = fs.mkdtempSync(path.join(os.tmpdir(), 'clawvault-cwd-'));
-    const originalCwd = process.cwd;
-    process.cwd = () => fakeCwd;
-    try {
-      execFileSyncMock.mockReturnValue('');
-
-      const handler = await loadHandler();
-      await handler({
-        eventName: 'compaction:memoryFlush',
-        sessionKey: 'agent:main:main'
-      });
-
-      expect(execFileSyncMock).toHaveBeenCalledWith(
-        'clawvault',
-        expect.arrayContaining(['observe', '--cron', '-v', vaultPath]),
-        expect.objectContaining({ shell: false })
-      );
-    } finally {
-      if (originalHome === undefined) {
-        delete process.env.HOME;
-      } else {
-        process.env.HOME = originalHome;
+  it('uses vaultPath from plugin config when provided in event', async () => {
+    const vaultPath = makeVaultFixture();
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
       }
-      if (originalClawvaultPath !== undefined) process.env.CLAWVAULT_PATH = originalClawvaultPath;
-      if (originalOpenclawMemory !== undefined) process.env.OPENCLAW_MEMORY_PATH = originalOpenclawMemory;
-      if (originalOpenclawVault !== undefined) process.env.OPENCLAW_VAULT_PATH = originalOpenclawVault;
-      process.cwd = originalCwd;
-      fs.rmSync(fakeHome, { recursive: true, force: true });
-      fs.rmSync(fakeCwd, { recursive: true, force: true });
-    }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      pluginConfig: {
+        vaultPath
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', vaultPath]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
   });
 
-  it('runs weekly reflection on cron.weekly at Sunday midnight', async () => {
+  it('uses vaultPath from context.pluginConfig when provided', async () => {
     const vaultPath = makeVaultFixture();
-    process.env.CLAWVAULT_PATH = vaultPath;
-    execFileSyncMock.mockReturnValue('');
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
+    });
 
     const handler = await loadHandler();
-    await handler({
-      eventName: 'cron.weekly',
-      timestamp: '2026-02-15T00:00:00.000Z'
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      context: {
+        pluginConfig: {
+          vaultPath
+        }
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', vaultPath]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(vaultPath, { recursive: true, force: true });
+  });
+
+  it('uses vaultPath from OPENCLAW_PLUGIN_CLAWVAULT_VAULTPATH env var', async () => {
+    const vaultPath = makeVaultFixture();
+    process.env.OPENCLAW_PLUGIN_CLAWVAULT_VAULTPATH = vaultPath;
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
     });
 
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      messages: []
+    };
+
+    await handler(event);
+
     expect(execFileSyncMock).toHaveBeenCalledWith(
       'clawvault',
-      expect.arrayContaining(['reflect', '-v', vaultPath]),
+      expect.arrayContaining(['recover', '--clear', '-v', vaultPath]),
       expect.objectContaining({ shell: false })
     );
 
+    delete process.env.OPENCLAW_PLUGIN_CLAWVAULT_VAULTPATH;
     fs.rmSync(vaultPath, { recursive: true, force: true });
   });
+
+  it('uses per-agent vault path from agentVaults config', async () => {
+    const agent1Vault = makeVaultFixture();
+    const agent2Vault = makeVaultFixture();
+    const fallbackVault = makeVaultFixture();
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      sessionKey: 'agent:agent1:main',
+      pluginConfig: {
+        vaultPath: fallbackVault,
+        agentVaults: {
+          agent1: agent1Vault,
+          agent2: agent2Vault
+        }
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', agent1Vault]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(agent1Vault, { recursive: true, force: true });
+    fs.rmSync(agent2Vault, { recursive: true, force: true });
+    fs.rmSync(fallbackVault, { recursive: true, force: true });
+  });
+
+  it('falls back to vaultPath when agent not in agentVaults', async () => {
+    const agent1Vault = makeVaultFixture();
+    const fallbackVault = makeVaultFixture();
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      sessionKey: 'agent:unknown-agent:main',
+      pluginConfig: {
+        vaultPath: fallbackVault,
+        agentVaults: {
+          agent1: agent1Vault
+        }
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', fallbackVault]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(agent1Vault, { recursive: true, force: true });
+    fs.rmSync(fallbackVault, { recursive: true, force: true });
+  });
+
+  it('uses agentVaults from context.pluginConfig', async () => {
+    const agent1Vault = makeVaultFixture();
+    const fallbackVault = makeVaultFixture();
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      sessionKey: 'agent:agent1:main',
+      context: {
+        pluginConfig: {
+          vaultPath: fallbackVault,
+          agentVaults: {
+            agent1: agent1Vault
+          }
+        }
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', agent1Vault]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(agent1Vault, { recursive: true, force: true });
+    fs.rmSync(fallbackVault, { recursive: true, force: true });
+  });
+
+  it('uses OPENCLAW_AGENT_ID env var for agent resolution when session key not available', async () => {
+    const agent1Vault = makeVaultFixture();
+    const fallbackVault = makeVaultFixture();
+    process.env.OPENCLAW_AGENT_ID = 'agent1';
+
+    execFileSyncMock.mockImplementation((_command, args) => {
+      if (args[0] === 'recover') {
+        return 'Clean startup';
+      }
+      return '';
+    });
+
+    const handler = await loadHandler();
+    const event = {
+      type: 'gateway',
+      action: 'startup',
+      pluginConfig: {
+        vaultPath: fallbackVault,
+        agentVaults: {
+          agent1: agent1Vault
+        }
+      },
+      messages: []
+    };
+
+    await handler(event);
+
+    expect(execFileSyncMock).toHaveBeenCalledWith(
+      'clawvault',
+      expect.arrayContaining(['recover', '--clear', '-v', agent1Vault]),
+      expect.objectContaining({ shell: false })
+    );
+
+    fs.rmSync(agent1Vault, { recursive: true, force: true });
+    fs.rmSync(fallbackVault, { recursive: true, force: true });
+  });
 });

package/hooks/clawvault/openclaw.plugin.json

@@ -0,0 +1,72 @@
+{
+  "id": "clawvault",
+  "name": "ClawVault",
+  "version": "2.6.1",
+  "description": "Structured memory system for AI agents with context death resilience",
+  "kind": "memory",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "vaultPath": {
+        "type": "string",
+        "description": "Path to the ClawVault vault directory. If not set, auto-discovered from CLAWVAULT_PATH or by walking up from cwd."
+      },
+      "autoCheckpoint": {
+        "type": "boolean",
+        "description": "Enable automatic checkpointing on session events",
+        "default": true
+      },
+      "contextProfile": {
+        "type": "string",
+        "enum": ["default", "planning", "incident", "handoff", "auto"],
+        "description": "Default context profile for session start injection",
+        "default": "auto"
+      },
+      "maxContextResults": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 20,
+        "description": "Maximum number of context results to inject on session start",
+        "default": 4
+      },
+      "observeOnHeartbeat": {
+        "type": "boolean",
+        "description": "Enable observation threshold checks on gateway heartbeat",
+        "default": true
+      },
+      "weeklyReflection": {
+        "type": "boolean",
+        "description": "Enable weekly reflection on Sunday midnight UTC",
+        "default": true
+      }
+    },
+    "additionalProperties": false
+  },
+  "uiHints": {
+    "vaultPath": {
+      "label": "Vault Path",
+      "placeholder": "~/my-vault",
+      "description": "Path to your ClawVault memory vault"
+    },
+    "autoCheckpoint": {
+      "label": "Auto Checkpoint",
+      "description": "Automatically checkpoint before session resets"
+    },
+    "contextProfile": {
+      "label": "Context Profile",
+      "description": "Profile used for context injection at session start"
+    },
+    "maxContextResults": {
+      "label": "Max Context Results",
+      "description": "Number of vault memories to inject"
+    },
+    "observeOnHeartbeat": {
+      "label": "Observe on Heartbeat",
+      "description": "Check observation thresholds during heartbeat events"
+    },
+    "weeklyReflection": {
+      "label": "Weekly Reflection",
+      "description": "Run weekly reflection on Sunday midnight UTC"
+    }
+  }
+}

package/openclaw.plugin.json

@@ -1,56 +1,83 @@
 {
   "id": "clawvault",
-  "kind": "memory",
-  "uiHints": {
-    "vaultPath": {
-      "label": "Vault Path",
-      "placeholder": "~/clawvault",
-      "help": "Path to your ClawVault vault directory"
-    },
-    "collection": {
-      "label": "QMD Collection",
-      "placeholder": "clawvault",
-      "help": "Name of the qmd search collection",
-      "advanced": true
-    },
-    "autoRecall": {
-      "label": "Auto-Recall",
-      "help": "Automatically inject relevant memories before each agent turn"
-    },
-    "autoCapture": {
-      "label": "Auto-Capture",
-      "help": "Automatically observe and capture important information from conversations"
-    },
-    "recallLimit": {
-      "label": "Recall Limit",
-      "help": "Max memories to inject per turn (default: 5)",
-      "advanced": true
-    }
-  },
+  "name": "ClawVault",
+  "version": "2.6.5",
+  "description": "Structured memory system for AI agents with context death resilience",
   "configSchema": {
     "type": "object",
-    "additionalProperties": false,
     "properties": {
       "vaultPath": {
-        "type": "string"
+        "type": "string",
+        "description": "Path to the ClawVault vault directory. If not set, auto-discovered from CLAWVAULT_PATH or by walking up from cwd. Used as fallback when agentVaults is not set or agent not found."
       },
-      "collection": {
-        "type": "string"
+      "agentVaults": {
+        "type": "object",
+        "description": "Mapping of agent names to vault paths. Allows each agent to have its own vault. Falls back to vaultPath if agent not found.",
+        "additionalProperties": {
+          "type": "string",
+          "description": "Path to the vault directory for this agent"
+        }
       },
-      "autoRecall": {
+      "autoCheckpoint": {
         "type": "boolean",
+        "description": "Enable automatic checkpointing on session events",
         "default": true
       },
-      "autoCapture": {
-        "type": "boolean",
-        "default": true
+      "contextProfile": {
+        "type": "string",
+        "enum": ["default", "planning", "incident", "handoff", "auto"],
+        "description": "Default context profile for session start injection",
+        "default": "auto"
       },
-      "recallLimit": {
-        "type": "number",
+      "maxContextResults": {
+        "type": "integer",
         "minimum": 1,
         "maximum": 20,
-        "default": 5
+        "description": "Maximum number of context results to inject on session start",
+        "default": 4
+      },
+      "observeOnHeartbeat": {
+        "type": "boolean",
+        "description": "Enable observation threshold checks on gateway heartbeat",
+        "default": true
+      },
+      "weeklyReflection": {
+        "type": "boolean",
+        "description": "Enable weekly reflection on Sunday midnight UTC",
+        "default": true
       }
+    },
+    "additionalProperties": false
+  },
+  "uiHints": {
+    "vaultPath": {
+      "label": "Vault Path",
+      "placeholder": "~/my-vault",
+      "description": "Path to your ClawVault memory vault (fallback when agentVaults not set)"
+    },
+    "agentVaults": {
+      "label": "Agent Vaults",
+      "description": "Per-agent vault paths (e.g., {\"agent1\": \"/path/to/vault1\", \"agent2\": \"/path/to/vault2\"})"
+    },
+    "autoCheckpoint": {
+      "label": "Auto Checkpoint",
+      "description": "Automatically checkpoint before session resets"
+    },
+    "contextProfile": {
+      "label": "Context Profile",
+      "description": "Profile used for context injection at session start"
+    },
+    "maxContextResults": {
+      "label": "Max Context Results",
+      "description": "Number of vault memories to inject"
+    },
+    "observeOnHeartbeat": {
+      "label": "Observe on Heartbeat",
+      "description": "Check observation thresholds during heartbeat events"
+    },
+    "weeklyReflection": {
+      "label": "Weekly Reflection",
+      "description": "Run weekly reflection on Sunday midnight UTC"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Structured memory system for AI agents \u2014 typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. \ud83d\udc18",
   "type": "module",
   "main": "dist/index.cjs",
@@ -11,11 +11,6 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    },
-    "./plugin": {
-      "types": "./dist/plugin/index.d.ts",
-      "import": "./dist/plugin/index.js",
-      "require": "./dist/plugin/index.cjs"
     }
   },
   "bin": {
@@ -24,23 +19,27 @@
   "files": [
     "dist",
     "bin",
+    "dashboard",
     "templates",
     "hooks",
     "openclaw.plugin.json"
   ],
   "openclaw": {
+    "plugin": "./openclaw.plugin.json",
+    "extensions": [
+      "./dist/openclaw-plugin.js"
+    ],
     "hooks": [
       "./hooks/clawvault"
-    ],
-    "plugin": "./openclaw.plugin.json"
+    ]
   },
   "scripts": {
-    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/blocked.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/rebuild.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts src/plugin/index.ts src/plugin/types.ts src/plugin/vault.ts src/plugin/observe.ts src/plugin/inject.ts src/plugin/templates.ts --format esm,cjs --dts --clean",
+    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/blocked.ts src/commands/canvas.ts src/commands/checkpoint.ts src/commands/compat.ts src/commands/context.ts src/commands/doctor.ts src/commands/embed.ts src/commands/entities.ts src/commands/graph.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/migrate-observations.ts src/commands/observe.ts src/commands/project.ts src/commands/rebuild.ts src/commands/rebuild-embeddings.ts src/commands/recover.ts src/commands/reflect.ts src/commands/repair-session.ts src/commands/replay.ts src/commands/session-recap.ts src/commands/setup.ts src/commands/shell-init.ts src/commands/sleep.ts src/commands/status.ts src/commands/sync-bd.ts src/commands/tailscale.ts src/commands/task.ts src/commands/template.ts src/commands/wake.ts src/commands/workgraph.ts src/cli/index.ts src/index.ts src/openclaw-plugin.ts src/lib/auto-linker.ts src/lib/canvas-layout.ts src/lib/config.ts src/lib/entity-index.ts src/lib/project-utils.ts src/lib/session-repair.ts src/lib/session-utils.ts src/lib/tailscale.ts src/lib/task-utils.ts src/lib/template-engine.ts src/lib/webdav.ts src/workgraph/index.ts src/workgraph/types.ts src/workgraph/registry.ts src/workgraph/ledger.ts src/workgraph/store.ts src/workgraph/thread.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "ci": "npm run typecheck && npm test && npm run build",
+    "test": "npm run build && vitest run",
+    "ci": "npm run typecheck && npm test",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -71,7 +70,6 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.48",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
     "commander": "^12.0.0",
@@ -80,7 +78,8 @@
     "glob": "^10.3.10",
     "gray-matter": "^4.0.3",
     "natural": "^6.10.4",
-    "ws": "^8.19.0"
+    "ws": "^8.19.0",
+    "yaml": "^2.8.2"
   },
   "peerDependencies": {
     "qmd": "*"
@@ -91,14 +90,12 @@
     }
   },
   "devDependencies": {
+    "@huggingface/transformers": "^3.8.1",
     "@types/node": "^20.11.0",
     "ajv": "^8.17.1",
     "puppeteer": "^24.37.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
-  },
-  "workspaces": [
-    "packages/*"
-  ]
-}
+  }
+}

package/dist/chunk-3RG5ZIWI.js

@@ -1,10 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export {
-  __require
-};