@xdarkicex/openclaw-memory-libravdb 1.6.11 → 1.6.13

package/dist/context-engine.js

@@ -2,6 +2,7 @@ import { resolveIdentity } from "./identity.js";
 import { resolveUserCollection } from "./memory-scopes.js";
 const APPROX_CHARS_PER_TOKEN = 4;
 const ASSEMBLE_BUDGET_HEADROOM_TOKENS = 256;
+const ASSEMBLE_BUDGET_HEADROOM_FRACTION = 0.2;
 const DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
 const STRUCTURED_MARKER_RE = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+){2,}_\d{6,}\b/g;
 const DISTINCTIVE_IDENTIFIER_RE = /\b([A-Za-z][A-Za-z0-9]*(?:[_-][A-Za-z0-9]+){1,})\b/g;
@@ -138,7 +139,9 @@ function normalizeTokenBudget(tokenBudget) {
 }
 function resolveEffectiveAssembleBudget(tokenBudget) {
     const normalized = normalizeTokenBudget(tokenBudget) ?? 1;
-    return Math.max(1, normalized - ASSEMBLE_BUDGET_HEADROOM_TOKENS);
+    const proportionalHeadroom = Math.max(1, Math.floor(normalized * ASSEMBLE_BUDGET_HEADROOM_FRACTION));
+    const headroom = Math.min(ASSEMBLE_BUDGET_HEADROOM_TOKENS, proportionalHeadroom);
+    return Math.max(1, normalized - headroom);
 }
 function normalizeThresholdFraction(fraction) {
     if (typeof fraction !== "number" || !Number.isFinite(fraction)) {

package/dist/dream-promotion.js

@@ -279,7 +279,7 @@ function parseHeading(value) {
     return normalizeSectionName(match[2] ?? "");
 }
 function isPromotionSection(section) {
-    return section.includes("deep sleep") || section.includes("promot") || section.includes("dream");
+    return /^(?:deep sleep|dream promotion(?: candidates?)?|promotion candidates?|promote candidates?)$/.test(section);
 }
 function parseBulletCandidate(line) {
     const match = /^\s*[-*+]\s+(.+)$/.exec(line);

package/dist/index.js

@@ -25601,7 +25601,7 @@ function parseHeading(value) {
   return normalizeSectionName(match[2] ?? "");
 }
 function isPromotionSection(section) {
-  return section.includes("deep sleep") || section.includes("promot") || section.includes("dream");
+  return /^(?:deep sleep|dream promotion(?: candidates?)?|promotion candidates?|promote candidates?)$/.test(section);
 }
 function parseBulletCandidate(line) {
   const match = /^\s*[-*+]\s+(.+)$/.exec(line);
@@ -26504,6 +26504,7 @@ function resolveCliMemoryOperationScope(opts) {
 // src/context-engine.ts
 var APPROX_CHARS_PER_TOKEN = 4;
 var ASSEMBLE_BUDGET_HEADROOM_TOKENS = 256;
+var ASSEMBLE_BUDGET_HEADROOM_FRACTION = 0.2;
 var DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
 var STRUCTURED_MARKER_RE = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+){2,}_\d{6,}\b/g;
 var DISTINCTIVE_IDENTIFIER_RE = /\b([A-Za-z][A-Za-z0-9]*(?:[_-][A-Za-z0-9]+){1,})\b/g;
@@ -26656,7 +26657,9 @@ function normalizeTokenBudget(tokenBudget) {
 }
 function resolveEffectiveAssembleBudget(tokenBudget) {
   const normalized = normalizeTokenBudget(tokenBudget) ?? 1;
-  return Math.max(1, normalized - ASSEMBLE_BUDGET_HEADROOM_TOKENS);
+  const proportionalHeadroom = Math.max(1, Math.floor(normalized * ASSEMBLE_BUDGET_HEADROOM_FRACTION));
+  const headroom = Math.min(ASSEMBLE_BUDGET_HEADROOM_TOKENS, proportionalHeadroom);
+  return Math.max(1, normalized - headroom);
 }
 function normalizeThresholdFraction(fraction) {
   if (typeof fraction !== "number" || !Number.isFinite(fraction)) {

package/docs/configuration.md

@@ -15,6 +15,8 @@ CPU when a provider is unavailable.
 | `grpcEndpoint` | string | — | gRPC kernel endpoint. See `grpcEndpointTlsMode` for credential control. |
 | `grpcEndpointTlsCa` | string | — | Path to CA certificate PEM file. Only needed for self-signed or private CA certs. Omit when using Let's Encrypt or cert-manager. |
 | `grpcEndpointTlsMode` | string | `"auto"` | gRPC credential mode. `"auto"`: loopback/unix → plaintext, remote → TLS. `"tls"`: always TLS. `"insecure"`: always plaintext. |
+| `grpcEndpointTlsClientCert` | string | — | Path to client certificate PEM for mTLS. Must be paired with `grpcEndpointTlsClientKey`. |
+| `grpcEndpointTlsClientKey` | string | — | Path to client private key PEM for mTLS. Must be paired with `grpcEndpointTlsClientCert`. |
 | `rpcTimeoutMs` | number | `30000` | Per-call timeout for service RPC (ms) |
 | `dbPath` | string | auto-named | Explicit DB path; when set bypasses model-specific naming |
 
@@ -56,6 +58,19 @@ Set `grpcEndpointTlsCa` to the path of the CA certificate PEM file:
 The daemon must be configured with matching TLS cert and key via
 `LIBRAVDB_GRPC_TLS_CERT` and `LIBRAVDB_GRPC_TLS_KEY`.
 
+**Remote daemon with mTLS (mutual TLS):**
+When the daemon requires client certificate authentication, set both
+`grpcEndpointTlsClientCert` and `grpcEndpointTlsClientKey` (they must both
+be present or both be omitted):
+```json
+{
+  "grpcEndpoint": "tcp:yourdaemon.internal:50051",
+  "grpcEndpointTlsCa": "/etc/certs/ca.pem",
+  "grpcEndpointTlsClientCert": "/etc/certs/client-cert.pem",
+  "grpcEndpointTlsClientKey": "/etc/certs/client-key.pem"
+}
+```
+
 **Local daemon with TLS enabled:**
 If the daemon has `LIBRAVDB_GRPC_TLS_CERT`/`LIBRAVDB_GRPC_TLS_KEY` set on a loopback
 address, explicitly set `grpcEndpointTlsMode: "tls"` to match:
@@ -147,11 +162,49 @@ The plugin exposes `ingestionGateThreshold` for host-side gating decisions:
 | `markdownIngestionObsidianInclude` | string[] | — | Obsidian glob include patterns |
 | `markdownIngestionObsidianExclude` | string[] | same defaults as above | Obsidian glob exclude patterns; defaults to the same set as generic markdown ingestion |
 | `markdownIngestionObsidianDebounceMs` | number | `150` | Obsidian debounce window |
+| `markdownIngestionSnapshotPath` | string | — | Path to snapshot file for generic markdown ingestion state |
+| `markdownIngestionObsidianSnapshotPath` | string | — | Path to snapshot file for Obsidian ingestion state |
 
 Configured markdown roots are ignored unless the matching enable flag is set to
 `true`. Set `markdownIngestionEnabled: true` for generic roots and
 `markdownIngestionObsidianEnabled: true` for Obsidian vault roots.
 
+## Continuity
+
+| Key | Type | Default | Notes |
+|---|---|---|---|
+| `continuityMinTurns` | number | — | Minimum conversation turns before continuity retrieval activates |
+| `continuityPriorContextTokens` | number | — | Token budget allocated to prior context in continuity retrieval |
+| `continuityTailBudgetTokens` | number | — | Token budget for tail-end context in continuity retrieval |
+
+## Recovery
+
+| Key | Type | Default | Notes |
+|---|---|---|---|
+| `recoveryFloorScore` | number | — | Minimum score floor for recovery-phase retrieval |
+| `recoveryMinConfidenceMean` | number | — | Minimum mean confidence threshold for recovery candidates |
+| `recoveryMinTopK` | number | — | Minimum number of top-K results required for recovery |
+
+## Section 7 scoring
+
+Two-pass retrieval scoring subsystem. These keys control the authority-weighted
+and recency-adjusted scoring pass that runs after the initial vector search.
+
+| Key | Type | Default | Notes |
+|---|---|---|---|
+| `section7Theta1` | number | — | Primary theta parameter for first-pass scoring |
+| `section7Kappa` | number | — | Kappa scaling factor for authority scoring |
+| `section7HopEta` | number | — | Eta decay for hop-distance scoring |
+| `section7HopThreshold` | number | — | Hop distance threshold for second-pass eligibility |
+| `section7CoarseTopK` | number | — | Top-K for coarse (first-pass) retrieval |
+| `section7SecondPassTopK` | number | — | Top-K for second-pass refined retrieval |
+| `section7AuthorityRecencyLambda` | number | — | Lambda for recency decay in authority scoring (commented out in code) |
+| `section7AuthorityRecencyWeight` | number | — | Weight for authority recency in combined score |
+| `section7AuthorityFrequencyWeight` | number | — | Weight for authority frequency in combined score |
+| `section7AuthorityAuthoredWeight` | number | — | Weight for authority authored signal in combined score |
+| `section7AuthoritySalienceWeight` | number | — | Weight for authority salience in combined score |
+| `section7RecencyAccessLambda` | number | — | Lambda for access-based recency decay |
+
 ## Dream promotion
 
 | Key | Type | Default | Notes |

package/docs/embedding-profiles.md

@@ -35,6 +35,34 @@ How it works:
 - The sidecar store persists an embedding fingerprint, so reopening an existing store with a different effective model profile will fail instead of silently mixing vector spaces.
 - `onnxDevice` is passed through as `LIBRAVDB_ONNX_DEVICE` for daemon versions that support execution-provider selection (`auto`, `cpu`, `cuda`, `coreml`, `directml`, `openvino`).
 
+## Store Compatibility and Upgrades
+
+The persisted embedding fingerprint is part of the database compatibility check.
+That is intentional: if a daemon opens a store with a different effective model
+profile, the safest outcome is to stop before mixing vector spaces.
+
+When updating `libravdbd`, keep the same effective embedding profile unless you
+intend to rebuild the store. The effective profile includes the profile family,
+dimensions, normalization setting, and any metadata supplied by the model
+manifest or daemon defaults.
+
+Legacy local setups can be more fragile than the current packaged profiles. For
+example, older `all-minilm-l6-v2` stores may fail to reopen after a daemon update
+if the daemon now computes different metadata for that local profile. This does
+not imply that current packaged `nomic-embed-text-v1.5` or
+`bge-small-en-v1.5` stores are incompatible; it means the old local profile must
+be treated as a separate vector space unless a migration path is provided.
+
+If a daemon update reports that the database format or embedding profile is
+incompatible:
+
+1. back up both the `.libravdb` file and its `.embedding.json` metadata file;
+2. either downgrade to the previous daemon that created the store, or move the
+   old store aside and let the new daemon initialize a fresh database;
+3. rebuild/reingest memories with the new effective embedding profile.
+
+Do not delete the old store until the replacement has been verified.
+
 Recommended usage:
 
 - `bundled` for the shipped default path, which uses `nomic-embed-text-v1.5`.

package/docs/installation.md

@@ -171,6 +171,30 @@ For foreground debugging:
 libravdbd serve
 ```
 
+### Incompatible database or embedding profile
+
+If the daemon exits with `database format is incompatible` or `database
+embedding profile is incompatible`, it is refusing to open a store whose saved
+format or embedding fingerprint differs from the current daemon settings. This
+fail-closed behavior protects the store from mixing incompatible vector spaces.
+
+Before changing anything, back up both files for the affected store:
+
+- the database file, such as `$HOME/.libravdbd/data_nomic-embed-text-v1_5.libravdb`
+- the adjacent `.embedding.json` metadata file
+
+Then choose one recovery path:
+
+- downgrade to the daemon version that created the store; or
+- move the old store aside, start the new daemon so it creates a fresh store,
+  and rebuild/reingest memories with the current embedding profile.
+
+This can affect legacy local profiles such as older `all-minilm-l6-v2` setups
+when daemon defaults or model metadata change across releases. It is not
+expected for stores that stay on the current packaged profiles and assets. See
+[Embedding Profiles](./embedding-profiles.md#store-compatibility-and-upgrades)
+for more detail.
+
 ### Hash mismatch
 
 Do not bypass a checksum mismatch. Delete the corrupt or stale asset and rerun

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
   "description": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.6.11",
+  "version": "1.6.13",
   "kind": [
     "memory",
     "context-engine"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.6.11",
+  "version": "1.6.13",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",