clawvault 3.1.0 → 3.2.1

package/openclaw.plugin.json

@@ -1,56 +1,261 @@
 {
   "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",
-  "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
-    }
-  },
   "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."
+      },
+      "agentVaults": {
+        "type": "object",
+        "description": "Mapping of agent names to vault paths. Falls back to vaultPath if agent not found.",
+        "additionalProperties": {
+          "type": "string"
+        }
       },
       "collection": {
-        "type": "string"
+        "type": "string",
+        "description": "qmd collection name",
+        "default": "clawvault"
       },
       "autoRecall": {
         "type": "boolean",
+        "description": "Enable automatic memory recall on session start",
         "default": true
       },
       "autoCapture": {
         "type": "boolean",
+        "description": "Enable automatic observation capture from conversations",
         "default": true
       },
       "recallLimit": {
-        "type": "number",
+        "type": "integer",
         "minimum": 1,
         "maximum": 20,
+        "description": "Maximum number of memories to recall per query",
         "default": 5
+      },
+      "templatesDir": {
+        "type": "string",
+        "description": "Custom path to template schema directory"
+      },
+      "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
+      },
+      "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
+  },
+  "uiHints": {
+    "vaultPath": {
+      "label": "Vault Path",
+      "placeholder": "~/my-vault",
+      "description": "Path to your ClawVault memory vault"
+    },
+    "agentVaults": {
+      "label": "Agent Vaults",
+      "description": "Per-agent vault paths"
+    },
+    "autoRecall": {
+      "label": "Auto Recall",
+      "description": "Automatically recall relevant memories on session start"
+    },
+    "autoCapture": {
+      "label": "Auto Capture",
+      "description": "Automatically capture observations from conversations"
+    },
+    "recallLimit": {
+      "label": "Recall Limit",
+      "description": "Max memories to recall per query"
+    },
+    "defaultScope": {
+      "label": "Default Scope",
+      "description": "Default memory scope (global, agent:<id>, project:<name>, user:<id>)"
+    },
+    "retrieval": {
+      "label": "Retrieval Pipeline",
+      "description": "Configure hybrid search, reranking, recency, and diversity settings"
+    },
+    "noise": {
+      "label": "Noise Filter",
+      "description": "Filter low-quality content from capture and retrieval"
+    },
+    "adaptive": {
+      "label": "Adaptive Retrieval",
+      "description": "Skip memory retrieval for greetings, commands, and acknowledgments"
     }
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clawvault",
-  "version": "3.1.0",
-  "description": "Structured memory for AI agents. Typed markdown primitives, hybrid search, auto-capture, and Obsidian-native views. OpenClaw plugin + standalone CLI.",
+  "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. 🐘",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -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,16 +19,19 @@
   "files": [
     "dist",
     "bin",
+    "dashboard",
     "templates",
+    "hooks",
     "openclaw.plugin.json"
   ],
   "openclaw": {
-    "extensions": [
-      "./dist/plugin/index.js"
+    "plugin": "./openclaw.plugin.json",
+    "hooks": [
+      "./hooks/clawvault"
     ]
   },
   "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/task.ts src/commands/template.ts src/commands/wake.ts src/cli/index.ts src/index.ts src/lib/auto-linker.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/task-utils.ts src/lib/template-engine.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/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",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
@@ -47,13 +45,13 @@
     "knowledge-graph",
     "obsidian",
     "markdown",
+    "task-management",
+    "context-death",
     "openclaw",
-    "openclaw-plugin",
     "llm",
     "agent-memory",
-    "semantic-search",
-    "hybrid-search",
-    "bm25"
+    "canvas-dashboard",
+    "semantic-search"
   ],
   "author": "Versatly",
   "license": "MIT",
@@ -69,13 +67,17 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.48",
+    "@huggingface/transformers": "^3.8.1",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
     "commander": "^12.0.0",
+    "express": "^5.2.1",
+    "force-graph": "^1.51.1",
     "glob": "^10.3.10",
     "gray-matter": "^4.0.3",
-    "natural": "^6.10.4"
+    "natural": "^6.10.4",
+    "ws": "^8.19.0",
+    "yaml": "^2.8.2"
   },
   "peerDependencies": {
     "qmd": "*"
@@ -88,11 +90,9 @@
   "devDependencies": {
     "@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
-};