clawvault 3.2.1 → 3.3.0

package/hooks/clawvault/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "clawvault",
   "name": "ClawVault",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "Structured memory system for AI agents with context death resilience",
   "kind": "memory",
   "configSchema": {
@@ -9,12 +9,78 @@
     "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."
+        "description": "Path to the ClawVault vault directory. Used as fallback when agentVaults is not set or agent not found."
+      },
+      "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"
+        }
+      },
+      "allowClawvaultExec": {
+        "type": "boolean",
+        "description": "Security gate for all child_process execution from the plugin. Must be true to run clawvault CLI commands.",
+        "default": false
+      },
+      "clawvaultBinaryPath": {
+        "type": "string",
+        "description": "Optional absolute path to the clawvault executable. When omitted, the plugin resolves clawvault from PATH."
+      },
+      "clawvaultBinarySha256": {
+        "type": "string",
+        "description": "Optional SHA-256 checksum for clawvaultBinaryPath (or resolved clawvault executable) to enforce binary integrity verification."
+      },
+      "allowEnvAccess": {
+        "type": "boolean",
+        "description": "Allow reading OPENCLAW_* and CLAWVAULT_PATH environment variables for vault and agent discovery.",
+        "default": false
+      },
+      "enableStartupRecovery": {
+        "type": "boolean",
+        "description": "Enable recovery checks on gateway startup.",
+        "default": false
+      },
+      "enableSessionContextInjection": {
+        "type": "boolean",
+        "description": "Enable recap/context injection on session start.",
+        "default": false
+      },
+      "enableAutoCheckpoint": {
+        "type": "boolean",
+        "description": "Enable automatic checkpointing on /new.",
+        "default": false
+      },
+      "enableObserveOnNew": {
+        "type": "boolean",
+        "description": "Enable observer flush on /new.",
+        "default": false
+      },
+      "enableHeartbeatObservation": {
+        "type": "boolean",
+        "description": "Enable observation threshold checks on heartbeat.",
+        "default": false
+      },
+      "enableCompactionObservation": {
+        "type": "boolean",
+        "description": "Enable forced observer flush on compaction events.",
+        "default": false
+      },
+      "enableWeeklyReflection": {
+        "type": "boolean",
+        "description": "Enable weekly reflection on Sunday midnight UTC.",
+        "default": false
+      },
+      "enableFactExtraction": {
+        "type": "boolean",
+        "description": "Enable extraction of structured facts from observed text during hook events.",
+        "default": false
       },
       "autoCheckpoint": {
         "type": "boolean",
-        "description": "Enable automatic checkpointing on session events",
-        "default": true
+        "description": "Deprecated alias for enableAutoCheckpoint.",
+        "default": false
       },
       "contextProfile": {
         "type": "string",
@@ -31,13 +97,13 @@
       },
       "observeOnHeartbeat": {
         "type": "boolean",
-        "description": "Enable observation threshold checks on gateway heartbeat",
-        "default": true
+        "description": "Deprecated alias for enableHeartbeatObservation.",
+        "default": false
       },
       "weeklyReflection": {
         "type": "boolean",
-        "description": "Enable weekly reflection on Sunday midnight UTC",
-        "default": true
+        "description": "Deprecated alias for enableWeeklyReflection.",
+        "default": false
       }
     },
     "additionalProperties": false
@@ -46,11 +112,63 @@
     "vaultPath": {
       "label": "Vault Path",
       "placeholder": "~/my-vault",
-      "description": "Path to your ClawVault memory vault"
+      "description": "Path to your ClawVault memory vault (fallback when agentVaults not set)"
     },
-    "autoCheckpoint": {
+    "agentVaults": {
+      "label": "Agent Vaults",
+      "description": "Per-agent vault paths (e.g., {\"agent1\": \"/path/to/vault1\", \"agent2\": \"/path/to/vault2\"})"
+    },
+    "allowClawvaultExec": {
+      "label": "Allow CLI Execution",
+      "description": "Required opt-in to run child_process calls from the plugin."
+    },
+    "clawvaultBinaryPath": {
+      "label": "ClawVault Binary Path",
+      "description": "Absolute path to clawvault executable for stricter execution controls."
+    },
+    "clawvaultBinarySha256": {
+      "label": "ClawVault Binary SHA-256",
+      "description": "Optional checksum to verify executable integrity before execution."
+    },
+    "allowEnvAccess": {
+      "label": "Allow Environment Access",
+      "description": "Allow OPENCLAW_* and CLAWVAULT_PATH reads for fallback discovery."
+    },
+    "enableStartupRecovery": {
+      "label": "Startup Recovery",
+      "description": "Run recovery checks on gateway startup."
+    },
+    "enableSessionContextInjection": {
+      "label": "Session Context Injection",
+      "description": "Inject recap and memory context on session start."
+    },
+    "enableAutoCheckpoint": {
       "label": "Auto Checkpoint",
-      "description": "Automatically checkpoint before session resets"
+      "description": "Automatically checkpoint before /new."
+    },
+    "enableObserveOnNew": {
+      "label": "Observe On /new",
+      "description": "Run observer flush on /new."
+    },
+    "enableHeartbeatObservation": {
+      "label": "Observe On Heartbeat",
+      "description": "Check observation thresholds during heartbeat events."
+    },
+    "enableCompactionObservation": {
+      "label": "Observe On Compaction",
+      "description": "Force observer flush during compaction events."
+    },
+    "enableWeeklyReflection": {
+      "label": "Weekly Reflection",
+      "description": "Run weekly reflection on Sunday midnight UTC."
+    },
+    "enableFactExtraction": {
+      "label": "Fact Extraction",
+      "description": "Extract structured facts from hook event payloads."
+    },
+    "autoCheckpoint": {
+      "label": "Auto Checkpoint (Legacy Alias)",
+      "description": "Deprecated alias for enableAutoCheckpoint."
     },
     "contextProfile": {
       "label": "Context Profile",
@@ -61,12 +179,12 @@
       "description": "Number of vault memories to inject"
     },
     "observeOnHeartbeat": {
-      "label": "Observe on Heartbeat",
-      "description": "Check observation thresholds during heartbeat events"
+      "label": "Observe on Heartbeat (Legacy Alias)",
+      "description": "Deprecated alias for enableHeartbeatObservation."
     },
     "weeklyReflection": {
-      "label": "Weekly Reflection",
-      "description": "Run weekly reflection on Sunday midnight UTC"
+      "label": "Weekly Reflection (Legacy Alias)",
+      "description": "Deprecated alias for enableWeeklyReflection."
     }
   }
 }

package/openclaw.plugin.json

@@ -1,53 +1,95 @@
 {
   "id": "clawvault",
   "name": "ClawVault",
-  "version": "4.0.0",
-  "description": "Structured memory system for AI agents with hybrid retrieval, cross-encoder reranking, adaptive capture, and multi-scope support",
-  "kind": "memory",
+  "version": "2.7.0",
+  "description": "Structured memory system for AI agents with context death resilience",
   "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."
+        "description": "Path to the ClawVault vault directory. Used as fallback when agentVaults is not set or agent not found."
       },
       "agentVaults": {
         "type": "object",
-        "description": "Mapping of agent names to vault paths. Falls back to vaultPath if agent not found.",
+        "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"
+          "type": "string",
+          "description": "Path to the vault directory for this agent"
         }
       },
-      "collection": {
+      "allowClawvaultExec": {
+        "type": "boolean",
+        "description": "Security gate for all child_process execution from the plugin. Must be true to run clawvault CLI commands.",
+        "default": false
+      },
+      "clawvaultBinaryPath": {
+        "type": "string",
+        "description": "Optional absolute path to the clawvault executable. When omitted, the plugin resolves clawvault from PATH."
+      },
+      "clawvaultBinarySha256": {
         "type": "string",
-        "description": "qmd collection name",
-        "default": "clawvault"
+        "description": "Optional SHA-256 checksum for clawvaultBinaryPath (or resolved clawvault executable) to enforce binary integrity verification."
       },
-      "autoRecall": {
+      "allowEnvAccess": {
         "type": "boolean",
-        "description": "Enable automatic memory recall on session start",
-        "default": true
+        "description": "Allow reading OPENCLAW_* and CLAWVAULT_PATH environment variables for vault and agent discovery.",
+        "default": false
       },
-      "autoCapture": {
+      "enableStartupRecovery": {
         "type": "boolean",
-        "description": "Enable automatic observation capture from conversations",
-        "default": true
+        "description": "Enable recovery checks on gateway startup.",
+        "default": false
       },
-      "recallLimit": {
-        "type": "integer",
-        "minimum": 1,
-        "maximum": 20,
-        "description": "Maximum number of memories to recall per query",
-        "default": 5
+      "enableSessionContextInjection": {
+        "type": "boolean",
+        "description": "Enable recap/context injection on session start.",
+        "default": false
       },
-      "templatesDir": {
-        "type": "string",
-        "description": "Custom path to template schema directory"
+      "enableAutoCheckpoint": {
+        "type": "boolean",
+        "description": "Enable automatic checkpointing on /new.",
+        "default": false
+      },
+      "enableObserveOnNew": {
+        "type": "boolean",
+        "description": "Enable observer flush on /new.",
+        "default": false
+      },
+      "enableHeartbeatObservation": {
+        "type": "boolean",
+        "description": "Enable observation threshold checks on heartbeat.",
+        "default": false
+      },
+      "enableCompactionObservation": {
+        "type": "boolean",
+        "description": "Enable forced observer flush on compaction events.",
+        "default": false
+      },
+      "enableWeeklyReflection": {
+        "type": "boolean",
+        "description": "Enable weekly reflection on Sunday midnight UTC.",
+        "default": false
+      },
+      "enableFactExtraction": {
+        "type": "boolean",
+        "description": "Enable extraction of structured facts from observed text during hook events.",
+        "default": false
       },
       "autoCheckpoint": {
         "type": "boolean",
-        "description": "Enable automatic checkpointing on session events",
-        "default": true
+        "description": "Deprecated alias for enableAutoCheckpoint.",
+        "default": false
+      },
+      "observeOnHeartbeat": {
+        "type": "boolean",
+        "description": "Deprecated alias for enableHeartbeatObservation.",
+        "default": false
+      },
+      "weeklyReflection": {
+        "type": "boolean",
+        "description": "Deprecated alias for enableWeeklyReflection.",
+        "default": false
       },
       "contextProfile": {
         "type": "string",
@@ -61,160 +103,6 @@
         "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
-      },
-      "defaultScope": {
-        "type": "string",
-        "description": "Default memory scope. Use 'global' for shared, or 'agent:<id>', 'project:<name>', 'user:<id>' for scoped.",
-        "default": "global"
-      },
-      "retrieval": {
-        "type": "object",
-        "description": "Hybrid retrieval pipeline configuration",
-        "properties": {
-          "bm25Weight": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "BM25 weight in RRF fusion",
-            "default": 0.5
-          },
-          "semanticWeight": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Semantic search weight in RRF fusion",
-            "default": 0.5
-          },
-          "rrfK": {
-            "type": "integer",
-            "minimum": 1,
-            "description": "RRF k parameter (higher = more weight to lower-ranked items)",
-            "default": 60
-          },
-          "topK": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 100,
-            "description": "Maximum results to return",
-            "default": 10
-          },
-          "minScore": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Minimum score threshold for results",
-            "default": 0.01
-          },
-          "recencyHalfLifeDays": {
-            "type": "number",
-            "minimum": 0,
-            "description": "Recency boost half-life in days (0 = disabled)",
-            "default": 14
-          },
-          "recencyWeight": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Recency boost weight (additive)",
-            "default": 0.10
-          },
-          "decayHalfLifeDays": {
-            "type": "number",
-            "minimum": 0,
-            "description": "Time decay half-life in days (0 = disabled)",
-            "default": 60
-          },
-          "lengthNormAnchor": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Length normalization anchor in characters (0 = disabled)",
-            "default": 500
-          },
-          "mmrLambda": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "MMR diversity lambda (1.0 = no diversity, lower = more diverse)",
-            "default": 0.7
-          },
-          "rerankProvider": {
-            "type": "string",
-            "enum": ["jina", "voyage", "siliconflow", "pinecone"],
-            "description": "Cross-encoder reranker API provider (optional)"
-          },
-          "rerankApiKey": {
-            "type": "string",
-            "description": "API key for the reranker service"
-          },
-          "rerankModel": {
-            "type": "string",
-            "description": "Reranker model name (auto-selected per provider if omitted)"
-          },
-          "rerankEndpoint": {
-            "type": "string",
-            "description": "Custom reranker endpoint URL"
-          },
-          "rerankWeight": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Weight of reranker score vs fused score (0.6 = 60% reranker)",
-            "default": 0.6
-          }
-        },
-        "additionalProperties": false
-      },
-      "noise": {
-        "type": "object",
-        "description": "Noise filtering configuration for write and read paths",
-        "properties": {
-          "enabled": {
-            "type": "boolean",
-            "description": "Enable noise filtering",
-            "default": true
-          },
-          "minLength": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Minimum text length to accept",
-            "default": 15
-          },
-          "maxLength": {
-            "type": "integer",
-            "minimum": 100,
-            "description": "Maximum text length to accept",
-            "default": 5000
-          }
-        },
-        "additionalProperties": false
-      },
-      "adaptive": {
-        "type": "object",
-        "description": "Adaptive retrieval configuration — skip retrieval for low-value queries",
-        "properties": {
-          "enabled": {
-            "type": "boolean",
-            "description": "Enable adaptive retrieval skipping",
-            "default": true
-          },
-          "skipPatterns": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "Additional regex patterns that should skip retrieval",
-            "default": []
-          }
-        },
-        "additionalProperties": false
       }
     },
     "additionalProperties": false
@@ -223,39 +111,79 @@
     "vaultPath": {
       "label": "Vault Path",
       "placeholder": "~/my-vault",
-      "description": "Path to your ClawVault memory vault"
+      "description": "Path to your ClawVault memory vault (fallback when agentVaults not set)"
     },
     "agentVaults": {
       "label": "Agent Vaults",
-      "description": "Per-agent vault paths"
+      "description": "Per-agent vault paths (e.g., {\"agent1\": \"/path/to/vault1\", \"agent2\": \"/path/to/vault2\"})"
+    },
+    "allowClawvaultExec": {
+      "label": "Allow CLI Execution",
+      "description": "Required opt-in to run child_process calls from the plugin."
+    },
+    "clawvaultBinaryPath": {
+      "label": "ClawVault Binary Path",
+      "description": "Absolute path to clawvault executable for stricter execution controls."
+    },
+    "clawvaultBinarySha256": {
+      "label": "ClawVault Binary SHA-256",
+      "description": "Optional checksum to verify executable integrity before execution."
+    },
+    "allowEnvAccess": {
+      "label": "Allow Environment Access",
+      "description": "Allow OPENCLAW_* and CLAWVAULT_PATH reads for fallback discovery."
+    },
+    "enableStartupRecovery": {
+      "label": "Startup Recovery",
+      "description": "Run recovery checks on gateway startup."
+    },
+    "enableSessionContextInjection": {
+      "label": "Session Context Injection",
+      "description": "Inject recap and memory context on session start."
+    },
+    "enableAutoCheckpoint": {
+      "label": "Auto Checkpoint",
+      "description": "Automatically checkpoint before /new."
+    },
+    "enableObserveOnNew": {
+      "label": "Observe On /new",
+      "description": "Run observer flush on /new."
+    },
+    "enableHeartbeatObservation": {
+      "label": "Observe On Heartbeat",
+      "description": "Check observation thresholds during heartbeat events."
+    },
+    "enableCompactionObservation": {
+      "label": "Observe On Compaction",
+      "description": "Force observer flush during compaction events."
     },
-    "autoRecall": {
-      "label": "Auto Recall",
-      "description": "Automatically recall relevant memories on session start"
+    "enableWeeklyReflection": {
+      "label": "Weekly Reflection",
+      "description": "Run weekly reflection on Sunday midnight UTC."
     },
-    "autoCapture": {
-      "label": "Auto Capture",
-      "description": "Automatically capture observations from conversations"
+    "enableFactExtraction": {
+      "label": "Fact Extraction",
+      "description": "Extract structured facts from hook event payloads."
     },
-    "recallLimit": {
-      "label": "Recall Limit",
-      "description": "Max memories to recall per query"
+    "autoCheckpoint": {
+      "label": "Auto Checkpoint (Legacy Alias)",
+      "description": "Deprecated alias for enableAutoCheckpoint."
     },
-    "defaultScope": {
-      "label": "Default Scope",
-      "description": "Default memory scope (global, agent:<id>, project:<name>, user:<id>)"
+    "contextProfile": {
+      "label": "Context Profile",
+      "description": "Profile used for context injection at session start"
     },
-    "retrieval": {
-      "label": "Retrieval Pipeline",
-      "description": "Configure hybrid search, reranking, recency, and diversity settings"
+    "maxContextResults": {
+      "label": "Max Context Results",
+      "description": "Number of vault memories to inject"
     },
-    "noise": {
-      "label": "Noise Filter",
-      "description": "Filter low-quality content from capture and retrieval"
+    "observeOnHeartbeat": {
+      "label": "Observe on Heartbeat (Legacy Alias)",
+      "description": "Deprecated alias for enableHeartbeatObservation."
     },
-    "adaptive": {
-      "label": "Adaptive Retrieval",
-      "description": "Skip memory retrieval for greetings, commands, and acknowledgments"
+    "weeklyReflection": {
+      "label": "Weekly Reflection (Legacy Alias)",
+      "description": "Deprecated alias for enableWeeklyReflection."
     }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clawvault",
-  "version": "3.2.1",
-  "description": "Structured memory system for AI agents — typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. 🐘",
+  "version": "3.3.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",
   "module": "dist/index.js",
@@ -26,17 +26,20 @@
   ],
   "openclaw": {
     "plugin": "./openclaw.plugin.json",
+    "extensions": [
+      "./dist/openclaw-plugin.js"
+    ],
     "hooks": [
       "./hooks/clawvault"
     ]
   },
   "scripts": {
-    "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/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/workgraph/index.ts src/workgraph/types.ts src/workgraph/registry.ts src/workgraph/ledger.ts src/workgraph/store.ts src/workgraph/thread.ts src/plugin/index.ts --format esm --dts --clean",
+    "build": "tsup src/commands/archive.ts src/commands/backlog.ts src/commands/benchmark.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/inbox.ts src/commands/inject.ts src/commands/kanban.ts src/commands/link.ts src/commands/maintain.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/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 --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": [
@@ -67,7 +70,6 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@huggingface/transformers": "^3.8.1",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
     "commander": "^12.0.0",
@@ -88,6 +90,7 @@
     }
   },
   "devDependencies": {
+    "@huggingface/transformers": "^3.8.1",
     "@types/node": "^20.11.0",
     "ajv": "^8.17.1",
     "puppeteer": "^24.37.2",
@@ -95,4 +98,4 @@
     "typescript": "^5.3.3",
     "vitest": "^1.2.0"
   }
-}
+}