@xdarkicex/openclaw-memory-libravdb 1.4.6 → 1.4.7

package/dist/types.d.ts

@@ -0,0 +1,163 @@
+export interface PluginConfig {
+    dbPath?: string;
+    sidecarPath?: string;
+    useSessionRecallProjection?: boolean;
+    useSessionSummarySearchExperiment?: boolean;
+    embeddingRuntimePath?: string;
+    embeddingBackend?: "bundled" | "onnx-local" | "custom-local";
+    embeddingProfile?: string;
+    fallbackProfile?: string;
+    embeddingModelPath?: string;
+    embeddingTokenizerPath?: string;
+    embeddingDimensions?: number;
+    embeddingNormalize?: boolean;
+    summarizerBackend?: "bundled" | "onnx-local" | "ollama-local" | "custom-local";
+    summarizerProfile?: string;
+    summarizerRuntimePath?: string;
+    summarizerModelPath?: string;
+    summarizerTokenizerPath?: string;
+    summarizerModel?: string;
+    summarizerEndpoint?: string;
+    sessionTTL?: number;
+    topK?: number;
+    alpha?: number;
+    beta?: number;
+    gamma?: number;
+    ingestionGateThreshold?: number;
+    markdownIngestionEnabled?: boolean;
+    markdownIngestionRoots?: string[];
+    markdownIngestionObsidianEnabled?: boolean;
+    markdownIngestionObsidianRoots?: string[];
+    markdownIngestionObsidianInclude?: string[];
+    markdownIngestionObsidianExclude?: string[];
+    markdownIngestionObsidianDebounceMs?: number;
+    markdownIngestionInclude?: string[];
+    markdownIngestionExclude?: string[];
+    markdownIngestionCollection?: string;
+    markdownIngestionDebounceMs?: number;
+    dreamPromotionEnabled?: boolean;
+    dreamPromotionDiaryPath?: string;
+    dreamPromotionUserId?: string;
+    dreamPromotionDebounceMs?: number;
+    gatingWeights?: {
+        w1c?: number;
+        w2c?: number;
+        w3c?: number;
+        w1t?: number;
+        w2t?: number;
+        w3t?: number;
+    };
+    gatingTechNorm?: number;
+    gatingCentroidK?: number;
+    lifecycleJournalMaxEntries?: number;
+    compactionQualityWeight?: number;
+    recencyLambdaSession?: number;
+    recencyLambdaUser?: number;
+    recencyLambdaGlobal?: number;
+    tokenBudgetFraction?: number;
+    authoredHardBudgetFraction?: number;
+    authoredSoftBudgetFraction?: number;
+    elevatedGuidanceBudgetFraction?: number;
+    section7StartupTokenBudgetTokens?: number;
+    continuityMinTurns?: number;
+    continuityTailBudgetTokens?: number;
+    continuityPriorContextTokens?: number;
+    compactThreshold?: number;
+    compactSessionTokenBudget?: number;
+    section7CoarseTopK?: number;
+    section7SecondPassTopK?: number;
+    section7Theta1?: number;
+    section7Kappa?: number;
+    section7HopEta?: number;
+    section7HopThreshold?: number;
+    section7AuthorityRecencyLambda?: number;
+    section7AuthorityRecencyWeight?: number;
+    section7AuthorityFrequencyWeight?: number;
+    section7AuthorityAuthoredWeight?: number;
+    summaryExpansionConfidenceThreshold?: number;
+    summaryExpansionDepth?: number;
+    summaryExpansionTokenBudget?: number;
+    summaryExpansionPenaltyFactor?: number;
+    recoveryFloorScore?: number;
+    recoveryMinTopK?: number;
+    recoveryMinConfidenceMean?: number;
+    ollamaUrl?: string;
+    compactModel?: string;
+    rpcTimeoutMs?: number;
+    maxRetries?: number;
+    logLevel?: "debug" | "info" | "warn" | "error";
+    grpcEndpoint?: string;
+}
+export interface SearchResult {
+    id: string;
+    score: number;
+    text: string;
+    metadata: {
+        ts?: number;
+        sessionId?: string;
+        userId?: string;
+        role?: string;
+        source_doc?: string;
+        node_kind?: string;
+        ordinal?: number;
+        position?: number;
+        tier?: number;
+        authored?: boolean;
+        authority?: number;
+        access_count?: number;
+        collection?: string;
+        hop_targets?: string[] | string;
+        token_estimate?: number;
+        continuity_tail?: boolean;
+        continuity_base?: boolean;
+        continuity_bundle_id?: string;
+        elevated_guidance?: boolean;
+        source_turn_id?: string;
+        source_turn_ts?: number;
+        provenance_class?: string;
+        stability_weight?: number;
+        expanded_from_summary?: boolean;
+        parent_summary_id?: string;
+        expansion_depth?: number;
+        cascade_tier?: number;
+        [key: string]: unknown;
+    };
+    finalScore?: number;
+}
+export interface SidecarSocket {
+    setEncoding(encoding: string): void;
+    on(event: "data", handler: (chunk: Buffer) => void): void;
+    on(event: "close", handler: () => void): void;
+    on(event: "error", handler: (error: Error) => void): void;
+    once(event: "connect", handler: () => void): void;
+    once(event: "error", handler: (error: Error) => void): void;
+    write(chunk: Buffer | string): void;
+    destroy(err?: Error): void;
+}
+export interface LoggerLike {
+    error(message: string): void;
+    info?(message: string): void;
+    warn?(message: string): void;
+}
+export interface SidecarHandle {
+    socket: SidecarSocket;
+    isDegraded(): boolean;
+    shutdown(): Promise<void>;
+}
+export interface RpcCallOptions {
+    timeoutMs: number;
+}
+export interface RecallCacheEntry<T = unknown> {
+    userId: string;
+    queryText: string;
+    durableVariantHits: T[];
+    userHits?: T[];
+    globalHits?: T[];
+    authoredVariantHits?: T[];
+}
+export interface RecallCache<T = unknown> {
+    put(entry: RecallCacheEntry<T>): void;
+    get(key: Pick<RecallCacheEntry<T>, "userId" | "queryText">): RecallCacheEntry<T> | undefined;
+    take(key: Pick<RecallCacheEntry<T>, "userId" | "queryText">): RecallCacheEntry<T> | undefined;
+    clearUser(userId: string): void;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/docs/contributing.md

@@ -3,7 +3,6 @@
 ## Prerequisites
 
 - Node.js `>= 22`
-- Go `>= 1.22` for daemon development and release builds
 - `pnpm`
 - OpenClaw CLI for end-to-end plugin testing
 
@@ -21,12 +20,10 @@ Integration tests:
 npm run test:integration
 ```
 
-Go daemon tests:
+Plugin integration tests:
 
 ```bash
-cd sidecar
-env GOCACHE=/tmp/openclaw-memory-libravdb-gocache go test ./...
-env GOCACHE=/tmp/openclaw-memory-libravdb-gocache go test -race ./...
+npm run test:integration
 ```
 
 ## Local Daemon Build
@@ -35,12 +32,19 @@ env GOCACHE=/tmp/openclaw-memory-libravdb-gocache go test -race ./...
 bash scripts/build-daemon.sh
 ```
 
-This creates `.daemon-bin/libravdbd` and copies locally available bundled assets into `.daemon-bin/`.
-That includes the embedding models, ONNX Runtime, and the bundled T5 summarizer assets when they are present under `.models/`.
+This prepares `.daemon-bin/libravdbd` for local plugin testing and copies locally available bundled assets into `.daemon-bin/`.
+
+Supported inputs:
+
+- installed daemon on `PATH` such as `brew install libravdbd`
+- `LIBRAVDBD_BINARY_PATH=/path/to/libravdbd`
+- `LIBRAVDBD_SOURCE_DIR=/path/to/libravdbd` to build from your private local daemon repo
+
+For daemon-internal Go development and release work, use the separate `libravdbd` repository.
 
 ## Gating Invariants
 
-Do not weaken the gate invariants casually. The tests in `sidecar/compact/gate_test.go` check structural properties:
+Do not weaken the gate invariants casually. The daemon-owned tests in `libravdbd/compact/gate_test.go` check structural properties:
 
 - empty-memory novelty
 - saturation veto
@@ -55,7 +59,7 @@ If you add a new signal, it must preserve those invariants.
 
 There is not yet a dedicated `gate_calibration_test.go` golden set in the
 repository. Current gating correctness is enforced by the invariant suite in
-[`sidecar/compact/gate_test.go`](../sidecar/compact/gate_test.go).
+`libravdbd/compact/gate_test.go`.
 
 If you introduce new signals or change weighting behavior, do not only update
 the implementation. Add one of:
@@ -71,7 +75,7 @@ Do not rewrite expectations just to make regressions disappear.
 Before opening a PR:
 
 - `pnpm check` must pass
-- `go test -race ./...` from `sidecar/` must pass
+- plugin integration coverage must pass against a running daemon or a prepared local daemon binary
 - any new gating signal must come with calibration or invariant coverage
 - any retrieval math or gating change must be reflected in the private design notes
 
@@ -82,6 +86,3 @@ Before opening a PR:
 The release automation syncs `openclaw.plugin.json` from `package.json` during the
 auto-bump/tag flow, and the publish workflow refuses to publish if the Git tag,
 `package.json`, and `openclaw.plugin.json` versions do not all match.
-
-The daemon release workflow enforces the same alignment before generating the
-Homebrew formula, so package, manifest, tag, and formula versioning stay in lockstep.

package/docs/install.md

@@ -12,7 +12,7 @@ For deeper operational detail, use the full
 On macOS, the shortest supported path is:
 
 ```bash
-brew tap xDarkicex/openclaw-libravdb-memory
+brew tap xDarkicex/homebrew-openclaw-libravdb-memory
 brew install libravdbd
 brew services start libravdbd
 openclaw plugins install @xdarkicex/openclaw-memory-libravdb
@@ -85,7 +85,7 @@ Default data path:
 Homebrew is the preferred daemon lifecycle on macOS:
 
 ```bash
-brew tap xDarkicex/openclaw-libravdb-memory
+brew tap xDarkicex/homebrew-openclaw-libravdb-memory
 brew install libravdbd
 brew services start libravdbd
 ```
@@ -105,20 +105,18 @@ If you are not using Homebrew, manage the daemon explicitly.
 Linux user service from the repo template:
 
 ```bash
-# Replace vX.Y.Z with the latest tag from:
-# https://github.com/xDarkicex/openclaw-memory-libravdb/releases
+# Replace vX.Y.Z with the published libravdbd release you want to install.
 mkdir -p ~/.local/bin ~/.config/systemd/user
-curl -L -o ~/.local/bin/libravdbd https://github.com/xDarkicex/openclaw-memory-libravdb/releases/download/vX.Y.Z/libravdbd-linux-amd64
+# Download the matching published libravdbd binary and service template.
+curl -L -o ~/.local/bin/libravdbd <published-libravdbd-binary-url>
 chmod +x ~/.local/bin/libravdbd
-curl -L -o ~/.config/systemd/user/libravdbd.service \
-  https://raw.githubusercontent.com/xDarkicex/openclaw-memory-libravdb/main/packaging/systemd/libravdbd.service
+curl -L -o ~/.config/systemd/user/libravdbd.service <published-libravdbd-service-template-url>
 systemctl --user enable --now libravdbd.service
 ```
 
 macOS LaunchAgent from the repo template:
 
-1. Download `com.xdarkicex.libravdbd.plist` from:
-   `https://raw.githubusercontent.com/xDarkicex/openclaw-memory-libravdb/main/packaging/launchd/com.xdarkicex.libravdbd.plist`
+1. Download the published `com.xdarkicex.libravdbd.plist` template for your release.
 2. Replace `__HOME__` with your home directory.
 3. Save it to `~/Library/LaunchAgents/com.xdarkicex.libravdbd.plist`.
 4. Load it with `launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xdarkicex.libravdbd.plist`.

package/docs/installation.md

@@ -120,7 +120,7 @@ extractive compaction. The only optional runtime network path is:
 ### Fastest Path on macOS
 
 ```bash
-brew tap xDarkicex/openclaw-libravdb-memory
+brew tap xDarkicex/homebrew-openclaw-libravdb-memory
 brew install libravdbd
 brew services start libravdbd
 openclaw plugins install @xdarkicex/openclaw-memory-libravdb
@@ -134,7 +134,7 @@ This is the preferred install flow for macOS users. It gives you a managed `libr
 openclaw plugins install @xdarkicex/openclaw-memory-libravdb
 ```
 
-The plugin package installs as normal OpenClaw source without daemon bootstrap hooks.
+The plugin package installs as compiled OpenClaw runtime code without daemon bootstrap hooks.
 
 ## Daemon Install
 
@@ -153,9 +153,9 @@ Recommended layout:
 
 ```bash
 mkdir -p ~/.local/bin ~/.config/systemd/user
-curl -L -o ~/.local/bin/libravdbd https://github.com/xDarkicex/openclaw-memory-libravdb/releases/download/vX.Y.Z/libravdbd-linux-amd64
+curl -L -o ~/.local/bin/libravdbd <published-libravdbd-binary-url>
 chmod +x ~/.local/bin/libravdbd
-cp packaging/systemd/libravdbd.service ~/.config/systemd/user/libravdbd.service
+cp <published-libravdbd-service-template> ~/.config/systemd/user/libravdbd.service
 systemctl --user enable --now libravdbd.service
 ```
 
@@ -171,12 +171,12 @@ openclaw memory status
 Homebrew users should normally install from the published tap:
 
 ```bash
-brew tap xDarkicex/openclaw-libravdb-memory
+brew tap xDarkicex/homebrew-openclaw-libravdb-memory
 brew install libravdbd
 brew services start libravdbd
 ```
 
-The release workflow generates a publish-ready `libravdbd.rb` formula asset from [`packaging/homebrew/libravdbd.rb.tmpl`](../packaging/homebrew/libravdbd.rb.tmpl). It is designed for GitHub release assets named:
+The daemon release pipeline generates a publish-ready `libravdbd.rb` formula asset for release assets named:
 
 - `libravdbd-darwin-arm64`
 - `libravdbd-darwin-amd64`
@@ -187,8 +187,7 @@ The generated Homebrew formula also stages the bundled ONNX Runtime archive, the
 
 If your GitHub Actions configuration includes:
 
-- repository variable `HOMEBREW_TAP_REPO`, for example `xDarkicex/homebrew-openclaw-libravdb-memory`
-- repository secret `HOMEBREW_TAP_TOKEN`
+- public tap repository `xDarkicex/homebrew-openclaw-libravdb-memory`
 
 then tagged releases also push the generated formula into `Formula/libravdbd.rb` in that tap repository automatically.
 
@@ -220,7 +219,7 @@ Installed plugin: libravdb-memory
 
 ## Activation
 
-The plugin declares `kind: ["memory", "context-engine"]` and is intended to own both the `memory` and `contextEngine` slots together. Treat partial slot assignment as a misconfiguration.
+The manifest declares `kind: "context-engine"` and the runtime registers the memory prompt and memory runtime surfaces in code. It is still intended to own both the `memory` and `contextEngine` slots together. Treat partial slot assignment as a misconfiguration.
 
 Add this to `~/.openclaw/openclaw.json`:
 
@@ -281,30 +280,38 @@ For contributors working from a clone:
 
 ```bash
 pnpm check
-cd sidecar && env GOCACHE=/tmp/openclaw-memory-libravdb-gocache go test -race ./... && cd ..
 bash scripts/build-daemon.sh
 ```
 
-This produces a local daemon binary in `.daemon-bin/libravdbd` (or `.exe` on Windows) and copies any locally available model/runtime assets there for testing.
+This prepares a local daemon binary in `.daemon-bin/libravdbd` (or `.exe` on Windows) and copies any locally available model/runtime assets there for testing.
+
+Contributor default:
+
+- install `libravdbd` separately with Homebrew or release assets, then run `bash scripts/build-daemon.sh`
+
+Private local daemon development:
+
+- set `LIBRAVDBD_SOURCE_DIR=/path/to/libravdbd` to build from your local daemon repo
+- or set `LIBRAVDBD_BINARY_PATH=/path/to/libravdbd` to use a prebuilt local daemon binary
 
 ## User-Service Templates
 
-Phase 2 packaging assets are included in-repo:
+Published daemon installs include matching user-service templates:
 
-- Linux user service: [`packaging/systemd/libravdbd.service`](../packaging/systemd/libravdbd.service)
-- macOS LaunchAgent: [`packaging/launchd/com.xdarkicex.libravdbd.plist`](../packaging/launchd/com.xdarkicex.libravdbd.plist)
+- Linux user service: `libravdbd.service`
+- macOS LaunchAgent: `com.xdarkicex.libravdbd.plist`
 
 Linux example:
 
 ```bash
 mkdir -p ~/.config/systemd/user
-cp packaging/systemd/libravdbd.service ~/.config/systemd/user/libravdbd.service
+cp <published-libravdbd-service-template> ~/.config/systemd/user/libravdbd.service
 systemctl --user enable --now libravdbd.service
 ```
 
 macOS example:
 
-1. Copy `packaging/launchd/com.xdarkicex.libravdbd.plist`
+1. Copy the published `com.xdarkicex.libravdbd.plist`
 2. Replace `__LIBRAVDBD_PATH__` and `__HOME__`
 3. Save it to `~/Library/LaunchAgents/com.xdarkicex.libravdbd.plist`
 4. Load it with `launchctl load ~/Library/LaunchAgents/com.xdarkicex.libravdbd.plist`

package/docs/uninstall.md

@@ -64,7 +64,7 @@ longer assigned to an active slot.
 
 ```bash
 brew uninstall libravdbd
-brew untap xDarkicex/openclaw-libravdb-memory
+brew untap xDarkicex/homebrew-openclaw-libravdb-memory
 ```
 
 ### Manual Daemon Install

package/index.js

@@ -0,0 +1,2 @@
+export { default } from "./dist/index.js";
+export * from "./dist/index.js";

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
   "description": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.4.6",
-  "kind": ["memory", "context-engine"],
+  "version": "1.4.7",
+  "kind": "context-engine",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,44 +1,67 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./openclaw.plugin.json": "./openclaw.plugin.json",
+    "./HOOK.md": "./HOOK.md"
+  },
   "publishConfig": {
     "access": "public"
   },
   "files": [
     "README.md",
+    "HOOK.md",
+    "index.js",
     "openclaw.plugin.json",
     "package.json",
-    "packaging/",
-    "src/",
     "docs/",
-    "tsconfig.json",
-    "tsconfig.tests.json"
+    "dist/"
   ],
   "engines": {
     "node": ">=22"
   },
   "openclaw": {
     "extensions": [
-      "./src/index.ts"
-    ]
+      "./dist/index.js"
+    ],
+    "install": {
+      "minHostVersion": ">=2026.3.22"
+    }
   },
   "scripts": {
-    "check": "./.ts-toolchain/node_modules/.bin/tsc --noEmit && pnpm run test:ts",
-    "test:ts": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && node --test .ts-build/test/unit/*.test.js",
-    "test:integration": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/checklist-validation.test.js .ts-build/test/integration/dream-promotion.test.js .ts-build/test/integration/host-flow.test.js .ts-build/test/integration/markdown-ingest.test.js .ts-build/test/integration/sidecar-lifecycle.test.js",
-    "benchmark:session_search_mid": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
-    "gate:assemble_optimization": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 OPENCLAW_ENFORCE_ASSEMBLE_EVIDENCE_GATE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
-    "probe:session_recall": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
-    "probe:session_recall_threshold": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar session_recall index threshold probe\" .ts-build/test/integration/host-flow.test.js",
-    "benchmark:longmemeval": "./.ts-toolchain/node_modules/.bin/tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/longmemeval-benchmark.test.js",
+    "build": "pnpm run generate:contracts && tsc -p tsconfig.build.json && mkdir -p dist/proto && cp -rf api/proto/. dist/proto/",
+    "check": "tsc --noEmit && pnpm run test:ts",
+    "test:ts": "tsc -p tsconfig.tests.json && node --test .ts-build/test/unit/*.test.js",
+    "test:integration": "tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/checklist-validation.test.js .ts-build/test/integration/dream-promotion.test.js .ts-build/test/integration/host-flow.test.js .ts-build/test/integration/markdown-ingest.test.js .ts-build/test/integration/sidecar-lifecycle.test.js",
+    "benchmark:session_search_mid": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
+    "gate:assemble_optimization": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 OPENCLAW_ENFORCE_ASSEMBLE_EVIDENCE_GATE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
+    "probe:session_recall": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
+    "probe:session_recall_threshold": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar session_recall index threshold probe\" .ts-build/test/integration/host-flow.test.js",
+    "benchmark:longmemeval": "tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/longmemeval-benchmark.test.js",
     "benchmark:longmemeval:score": "node scripts/longmemeval-score.mjs",
     "benchmark:longmemeval:diagnose": "node scripts/longmemeval-diagnose.mjs",
-    "build:daemon": "bash scripts/build-daemon.sh"
+    "prepack": "npm run build",
+    "build:daemon": "bash scripts/build-daemon.sh",
+    "generate:contracts": "cd ../libravdb-contracts && pnpm run build && cp -r gen/js/. ../openclaw-memory-libravdb/src/generated/"
   },
   "dependencies": {
+    "@bufbuild/protobuf": "1.7.2",
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@xdarkicex/libravdb-contracts": "file:../libravdb-contracts",
     "openclaw": "*"
   },
+  "devDependencies": {
+    "@types/node": "^20.11.0"
+  },
   "peerDependencies": {
     "openclaw": ">=2026.3.22"
   }

package/packaging/README.md

@@ -1,71 +0,0 @@
-# Packaging Assets
-
-This directory contains Phase 2 daemon-distribution assets for `libravdbd`.
-
-- `systemd/libravdbd.service`: user-service template for Linux.
-- `launchd/com.xdarkicex.libravdbd.plist`: LaunchAgent template for macOS.
-- `homebrew/libravdbd.rb.tmpl`: source template used to generate a publish-ready Homebrew formula.
-
-The templates assume the default daemon endpoint contract used by the plugin:
-
-- macOS/Linux: `unix:$HOME/.clawdb/run/libravdb.sock`
-- Windows: `tcp:127.0.0.1:37421`
-
-## LaunchAgent plist
-
-Before loading the macOS plist, replace:
-
-- `__LIBRAVDBD_PATH__` with the absolute path to the `libravdbd` binary
-- `__HOME__` with the current user's home directory
-- `__ONNX_RUNTIME_LIB__` with the absolute path to the ONNX runtime shared library (e.g. `/path/to/onnxruntime/onnxruntime-osx-arm64-1.23.0/lib/libonnxruntime.dylib`)
-
-## Provisioning models and runtime
-
-**Primary install path:** The Homebrew formula (`brew install libravdbd`)
-provisions all required assets — ONNX Runtime, nomic-embed-text-v1.5,
-all-minilm-l6-v2, and t5-small — inline during `brew install`.  No
-additional steps are needed for a clean install.
-
-**Repair / recovery:** If assets are deleted or corrupted after install,
-`scripts/provision.sh` can rebuild them.  This is an operator tool, not
-the normal install path.
-
-```bash
-bash scripts/provision.sh                     # provisions into .daemon-bin/
-bash scripts/provision.sh --target /opt/libravdbd/assets  # custom target
-bash scripts/provision.sh --skip-summarizer   # skip optional t5-small model
-```
-
-The script downloads models from HuggingFace and the ONNX runtime from
-GitHub Releases, verifies SHA-256 checksums, and writes the `embedding.json`
-manifests that `libravdbd` needs at startup.  It is idempotent — existing
-verified assets are left in place.
-
-The npm package does not include `provision.sh` or any install-time
-provisioning hooks.  The `scripts/` directory is excluded from the
-published npm tarball via the `files` whitelist in `package.json`.
-
-## Homebrew formula
-
-The release workflow now generates `dist/libravdbd.rb` from this template using
-the release version and SHA-256 files. If `HOMEBREW_TAP_REPO` and
-`HOMEBREW_TAP_TOKEN` are configured in GitHub Actions, the workflow also updates
-the tap automatically.
-
-The Homebrew formula stages the bundled ONNX Runtime archive, the shipped
-embedding profile assets, and the T5 summarizer bundle into the install prefix
-so the daemon can boot without an extra asset-unpack step.
-
-Expected GitHub configuration:
-
-- repository variable `HOMEBREW_TAP_REPO`, for example `xDarkicex/homebrew-openclaw-libravdb-memory`
-- repository secret `HOMEBREW_TAP_TOKEN` with push access to that tap repo
-
-Template placeholders:
-
-- `__VERSION__`
-- `__SHA256_DARWIN_ARM64__`
-- `__SHA256_DARWIN_AMD64__`
-- `__SHA256_LINUX_ARM64__`
-- `__SHA256_LINUX_AMD64__`
-- `__SHA256_PROVISION__`