clawvault 3.2.0 → 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,14 +1,14 @@
 {
   "id": "clawvault",
   "name": "ClawVault",
-  "version": "2.6.5",
+  "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. Used as fallback when agentVaults is not set or agent not found."
+        "description": "Path to the ClawVault vault directory. Used as fallback when agentVaults is not set or agent not found."
       },
       "agentVaults": {
         "type": "object",
@@ -18,10 +18,78 @@
           "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
+      },
+      "observeOnHeartbeat": {
+        "type": "boolean",
+        "description": "Deprecated alias for enableHeartbeatObservation.",
+        "default": false
+      },
+      "weeklyReflection": {
+        "type": "boolean",
+        "description": "Deprecated alias for enableWeeklyReflection.",
+        "default": false
       },
       "contextProfile": {
         "type": "string",
@@ -35,16 +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
       }
     },
     "additionalProperties": false
@@ -59,9 +117,57 @@
       "label": "Agent Vaults",
       "description": "Per-agent vault paths (e.g., {\"agent1\": \"/path/to/vault1\", \"agent2\": \"/path/to/vault2\"})"
     },
-    "autoCheckpoint": {
+    "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",
@@ -72,12 +178,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "3.2.0",
+  "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",
@@ -34,7 +34,7 @@
     ]
   },
   "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/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",
+    "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",