@bamdra/bamdra-memory-vector 0.1.11 → 0.1.13

package/README.md

@@ -6,6 +6,8 @@ The local knowledge and semantic recall layer for the Bamdra suite.
 
 It can run independently, and it becomes most powerful when paired with `bamdra-openclaw-memory`.
 
+Tested with OpenClaw `v2026.3.23`.
+
 Install directly:
 
 ```bash
@@ -34,6 +36,11 @@ It indexes:
 
 and helps OpenClaw search that local knowledge before falling back to the web.
 
+Recent compatibility improvements:
+
+- npm installs on OpenClaw `v2026.3.23` now backfill `plugins.installs` metadata for the standalone vector plugin
+- vector storage paths that use `~/.openclaw/...` are now resolved against the active user home instead of being treated as literal directories
+
 ## Why it matters
 
 The weakest part of many memory systems is the knowledge layer:

package/README.zh-CN.md

@@ -6,6 +6,8 @@ Bamdra 套件中的本地知识库与语义召回层。
 
 它可以独立运行，和 `bamdra-openclaw-memory` 配合时效果最好。
 
+已验证适配 OpenClaw `v2026.3.23`。
+
 单独安装：
 
 ```bash
@@ -34,6 +36,11 @@ openclaw plugins install @bamdra/bamdra-memory-vector
 
 并尽量让 OpenClaw 在上网之前先查本地知识。
 
+这轮兼容性修复还包括：
+
+- 在 OpenClaw `v2026.3.23` 下通过 npm 单独安装时，会自动补齐 `plugins.installs` 元数据
+- 使用 `~/.openclaw/...` 的向量存储路径现在会正确解析到当前用户目录，而不是被当成字面目录名
+
 ## 为什么重要
 
 很多记忆系统最弱的一层，其实就是知识库层：

package/dist/index.js

@@ -230,16 +230,28 @@ function exposeVectorApi(runtime) {
 }
 function normalizeConfig(input) {
   const root = (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "memory", "vector");
-  const markdownRoot = input?.markdownRoot ?? (0, import_node_path.join)(root, "markdown");
+  const markdownRoot = expandHomePath(input?.markdownRoot) ?? (0, import_node_path.join)(root, "markdown");
   return {
     enabled: input?.enabled ?? true,
     markdownRoot,
-    privateMarkdownRoot: input?.privateMarkdownRoot ?? (0, import_node_path.join)(markdownRoot, "private"),
-    sharedMarkdownRoot: input?.sharedMarkdownRoot ?? (0, import_node_path.join)(markdownRoot, "shared"),
-    indexPath: input?.indexPath ?? (0, import_node_path.join)(root, "index.json"),
+    privateMarkdownRoot: expandHomePath(input?.privateMarkdownRoot) ?? (0, import_node_path.join)(markdownRoot, "private"),
+    sharedMarkdownRoot: expandHomePath(input?.sharedMarkdownRoot) ?? (0, import_node_path.join)(markdownRoot, "shared"),
+    indexPath: expandHomePath(input?.indexPath) ?? (0, import_node_path.join)(root, "index.json"),
     dimensions: input?.dimensions ?? 64
   };
 }
+function expandHomePath(value) {
+  if (!value) {
+    return null;
+  }
+  if (value === "~") {
+    return (0, import_node_os.homedir)();
+  }
+  if (value.startsWith("~/")) {
+    return (0, import_node_path.join)((0, import_node_os.homedir)(), value.slice(2));
+  }
+  return value;
+}
 function bootstrapOpenClawHost() {
   const currentFile = (0, import_node_url.fileURLToPath)(importMetaUrl);
   const runtimeDir = (0, import_node_path.dirname)(currentFile);
@@ -259,17 +271,58 @@ function bootstrapOpenClawHost() {
   }
   const original = (0, import_node_fs.readFileSync)(configPath, "utf8");
   const config = JSON.parse(original);
-  const changed = ensureHostConfig(config);
+  const changed = ensureHostConfig(config, packageRoot);
   if (!changed) {
     return;
   }
   (0, import_node_fs.writeFileSync)(configPath, `${JSON.stringify(config, null, 2)}
 `, "utf8");
 }
-function ensureHostConfig(config) {
+function readPluginInstallMetadata(pluginId, packageRoot, installPath) {
+  try {
+    const pkg = JSON.parse((0, import_node_fs.readFileSync)((0, import_node_path.join)(packageRoot, "package.json"), "utf8"));
+    const packageName = typeof pkg.name === "string" ? pkg.name : pluginId;
+    const version = typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      source: "npm",
+      spec: packageName,
+      installPath,
+      version,
+      resolvedName: packageName,
+      resolvedVersion: version,
+      resolvedSpec: `${packageName}@${version}`,
+      resolvedAt: now,
+      installedAt: now
+    };
+  } catch {
+    return null;
+  }
+}
+function ensureInstallMetadata(installs, pluginId, metadata) {
+  if (!metadata) {
+    return false;
+  }
+  const current = installs[pluginId];
+  if (current && typeof current === "object" && !Array.isArray(current)) {
+    const install = current;
+    let changed = false;
+    for (const [key, value] of Object.entries(metadata)) {
+      if (typeof install[key] !== "string" || install[key] === "") {
+        install[key] = value;
+        changed = true;
+      }
+    }
+    return changed;
+  }
+  installs[pluginId] = metadata;
+  return true;
+}
+function ensureHostConfig(config, packageRoot) {
   let changed = false;
   const plugins = ensureObject(config, "plugins");
   const entries = ensureObject(plugins, "entries");
+  const installs = ensureObject(plugins, "installs");
   const load = ensureObject(plugins, "load");
   const tools = ensureObject(config, "tools");
   const skills = ensureObject(config, "skills");
@@ -280,6 +333,11 @@ function ensureHostConfig(config) {
   changed = ensureArrayIncludes(plugins, "allow", PLUGIN_ID) || changed;
   changed = ensureArrayIncludes(load, "paths", (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "extensions")) || changed;
   changed = ensureArrayIncludes(skillsLoad, "extraDirs", (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "skills")) || changed;
+  changed = ensureInstallMetadata(
+    installs,
+    PLUGIN_ID,
+    readPluginInstallMetadata(PLUGIN_ID, packageRoot, (0, import_node_path.join)((0, import_node_os.homedir)(), ".openclaw", "extensions", PLUGIN_ID))
+  ) || changed;
   changed = ensureArrayIncludes(tools, "allow", SEARCH_TOOL_NAME) || changed;
   changed = ensureArrayIncludes(tools, "allow", REINDEX_TOOL_NAME) || changed;
   if (typeof entry.enabled !== "boolean") {

package/dist/openclaw.plugin.json

@@ -3,10 +3,13 @@
   "type": "tool",
   "name": "Bamdra Memory Vector",
   "description": "Local vector-style semantic retrieval enhancement for Bamdra memory.",
-  "version": "0.1.0",
+  "version": "0.1.13",
   "main": "./index.js",
+  "skills": [
+    "./skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": true
   }
-}
+}

package/dist/package.json

@@ -1,12 +1,41 @@
 {
   "name": "@bamdra/bamdra-memory-vector",
-  "version": "0.1.0",
-  "private": true,
+  "version": "0.1.13",
+  "description": "Lightweight local semantic retrieval enhancement for the Bamdra OpenClaw memory suite.",
+  "license": "MIT",
+  "homepage": "https://www.bamdra.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bamdra/bamdra-memory-vector.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bamdra/bamdra-memory-vector/issues"
+  },
   "type": "commonjs",
   "main": "./index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "vector-search",
+    "semantic-search",
+    "memory",
+    "markdown"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
-    "bundle": "node ../../scripts/run-local-bin.mjs tsup && node ../../scripts/prepare-plugin-dist.mjs bamdra-memory-vector"
+    "bundle": "node ../bamdra-openclaw-memory/scripts/run-local-bin.mjs tsup && node ./scripts/prepare-plugin-dist.mjs",
+    "prepublishOnly": "pnpm run bundle",
+    "package:release": "node ./scripts/package-release.mjs"
   },
   "openclaw": {
     "id": "bamdra-memory-vector",
@@ -22,10 +51,11 @@
       "default": "./dist/index.js"
     }
   },
-  "dependencies": {
-    "@openclaw-enhanced/memory-core": "workspace:*"
+  "publishConfig": {
+    "access": "public"
   },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "^24.5.2"
   }
-}
+}

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "type": "tool",
   "name": "Bamdra Memory Vector",
   "description": "Local vector-style semantic retrieval enhancement for Bamdra memory.",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "main": "./dist/index.js",
   "skills": ["./skills"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamdra/bamdra-memory-vector",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Lightweight local semantic retrieval enhancement for the Bamdra OpenClaw memory suite.",
   "license": "MIT",
   "homepage": "https://www.bamdra.com",
@@ -33,7 +33,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "bundle": "node ../bamdra-openclaw-memory/scripts/run-local-bin.mjs tsup",
+    "bundle": "node ../bamdra-openclaw-memory/scripts/run-local-bin.mjs tsup && node ./scripts/prepare-plugin-dist.mjs",
     "prepublishOnly": "pnpm run bundle",
     "package:release": "node ./scripts/package-release.mjs"
   },