@xdarkicex/openclaw-memory-libravdb 1.4.2 → 1.4.4

package/README.md

@@ -104,6 +104,78 @@ Expected healthy state:
 - the plugin is active as the memory provider
 - the runtime can report stored counts and model readiness
 
+## Markdown Ingestion
+
+LibraVDB Memory can watch markdown roots and sync changed notes into vector
+memory without changing the Go sidecar RPC contract.
+
+The two built-in source adapters are:
+
+- `generic`: for OpenClaw-owned markdown, including stock files like
+  `MEMORY.md`
+- `obsidian`: for Obsidian vault roots, with tag-aware defaults
+
+Configuration is driven through the plugin config fields in
+`openclaw.plugin.json`:
+
+- `markdownIngestionEnabled`
+- `markdownIngestionRoots`
+- `markdownIngestionInclude`
+- `markdownIngestionExclude`
+- `markdownIngestionDebounceMs`
+- `markdownIngestionObsidianEnabled`
+- `markdownIngestionObsidianRoots`
+- `markdownIngestionObsidianInclude`
+- `markdownIngestionObsidianExclude`
+- `markdownIngestionObsidianDebounceMs`
+
+Typical usage:
+
+- point `markdownIngestionRoots` at OpenClaw-owned markdown roots, such as
+  `.openclaw/skills/*/*.md` or a stock memory directory that contains
+  `MEMORY.md`
+- enable the Obsidian adapter separately with
+  `markdownIngestionObsidianEnabled: true` and one or more vault roots
+- use include/exclude globs to narrow what gets watched when needed
+
+By default, the Obsidian adapter only auto-ingests notes that look like memory
+notes, using frontmatter tags or inline tags like `#project`. The OpenClaw
+stock `MEMORY.md` file is always eligible through the generic adapter path.
+
+## Dream Promotion
+
+Dream promotion is a separate, opt-in path for promoting vetted dream diary
+entries directly into a dedicated `dream:{userId}` collection.
+
+It does not use `MEMORY.md`. Instead, it expects a dream diary markdown file
+that contains explicit candidate bullets under promotion-oriented headings such
+as `## Deep Sleep`. Each promoted bullet should include a trailing metadata
+block with the gating fields:
+
+```md
+- Preserve the recent tail buffer {score=0.82 recall=3 unique=2}
+```
+
+Only bullets that satisfy the sidecar gates are inserted. The dream collection
+is isolated from normal `user:` and `global` retrieval by default, and dream
+phrasing in chat or search queries routes there automatically.
+
+Configure automatic diary watching with:
+
+- `dreamPromotionEnabled`
+- `dreamPromotionDiaryPath`
+- `dreamPromotionUserId`
+- `dreamPromotionDebounceMs`
+
+For a manual run, use:
+
+```bash
+openclaw memory dream-promote --user-id <userId> --dream-file /path/to/DREAMS.md
+```
+
+The manual command and the automatic watcher both go through the same sidecar
+promotion RPC, so the admission gates and provenance metadata are identical.
+
 ## Install Model
 
 This plugin is intentionally **connect-only** at install time.
@@ -155,8 +227,7 @@ The main runtime split is:
   - compaction and summarization
   - stable local IPC endpoint
 
-For the implemented architecture map, read
-[docs/architecture.md](./docs/architecture.md).
+For the implemented architecture map, read [docs/architecture.md](./docs/architecture.md).
 
 ## Retrieval Model
 
@@ -178,12 +249,8 @@ The ranking model currently blends:
 - recency decay
 - summary quality attenuation
 
-The formal math lives in:
-
-- [docs/mathematics-v2.md](./docs/mathematics-v2.md)
-- [docs/continuity.md](./docs/continuity.md)
-- [docs/ast-v2.md](./docs/ast-v2.md)
-- [docs/elevated-guidance.md](./docs/elevated-guidance.md)
+The formal math and deeper design notes are kept out of the public index on
+purpose.
 
 ## LongMemEval Harness
 
@@ -273,7 +340,7 @@ Good entry points:
 - [docs/install.md](./docs/install.md)
 - [docs/installation.md](./docs/installation.md)
 - [docs/uninstall.md](./docs/uninstall.md)
-- [docs/implementation.md](./docs/implementation.md)
+- [docs/architecture.md](./docs/architecture.md)
 
 ## For Researchers And Builders
 
@@ -293,9 +360,6 @@ Start here:
 
 - [docs/problem.md](./docs/problem.md)
 - [docs/architecture.md](./docs/architecture.md)
-- [docs/mathematics-v2.md](./docs/mathematics-v2.md)
-- [docs/gating.md](./docs/gating.md)
-- [docs/continuity.md](./docs/continuity.md)
 
 ## Runtime Facts
 
@@ -316,10 +380,6 @@ Start here:
 - [docs/uninstall.md](./docs/uninstall.md): clean shutdown and removal
 - [docs/architecture.md](./docs/architecture.md): current implemented system
   architecture
-- [docs/implementation.md](./docs/implementation.md): important implementation
-  contracts
-- [docs/mathematics-v2.md](./docs/mathematics-v2.md): formal scoring and
-  optimization reference
 
 ## Current Constraint
 

package/docs/README.md

@@ -1,22 +1,13 @@
 # Documentation Index
 
-Versioned `*-v*` design docs are the reviewed authoritative references when a
-legacy non-versioned predecessor also exists. Older non-versioned docs are kept
-to preserve project history and design evolution.
+This index lists the public docs that remain in the main repo. Detailed math
+and private design notes are kept out of the public index on purpose.
 
 - [installation.md](./installation.md) - Complete install, activation, verification, and troubleshooting reference.
 - [install.md](./install.md) - Practical lifecycle guide for Homebrew, the OpenClaw plugin, and manual daemon management.
 - [uninstall.md](./uninstall.md) - Clean shutdown and removal guide for the plugin, daemon, and optional local data.
-- [architecture.md](./architecture.md) - End-to-end component model, turn lifecycle, compaction flow, and degraded behavior.
+- [architecture.md](./architecture.md) - Public system overview covering the plugin, daemon, storage, retrieval, and compaction flow.
 - [problem.md](./problem.md) - Technical argument for replacing the stock OpenClaw memory lifecycle in this use case.
-- [mathematics-v2.md](./mathematics-v2.md) - Formal reference for hybrid scoring, decay, token budgeting, Matryoshka retrieval, compaction, planned two-pass retrieval, and temporal-compositional projection.
-- [compaction-evaluation.md](./compaction-evaluation.md) - Real-model benchmark notes for T5 summary confidence, Nomic-space preservation, and the hard preservation gate.
-- [continuity.md](./continuity.md) - Continuity model for invariant context, preserved recent raw session tail, and retrieved older memory.
-- [ast-v2.md](./ast-v2.md) - Reviewed authoritative AST partitioning reference for authored Markdown hard invariants, soft invariants, and variant lore.
-- [elevated-guidance.md](./elevated-guidance.md) - Tier 1.5 protected-shard and elevated-guidance model for preserving shadow rules through compaction.
-- [ast.md](./ast.md) - Historical predecessor to `ast-v2.md`, kept to show design evolution and earlier bugs.
-- [gating.md](./gating.md) - Full derivation and calibration guide for the domain-adaptive gating scalar.
-- [implementation.md](./implementation.md) - Non-obvious implementation decisions and their rationale.
 - [dependencies.md](./dependencies.md) - Why LibraVDB and slab-based storage were chosen for this plugin.
 - [models.md](./models.md) - ONNX model strategy, latency trade-offs, and shipped model roles.
 - [security.md](./security.md) - Security model, untrusted-memory framing, isolation guarantees, and deletion boundaries.

package/docs/architecture.md

@@ -1,182 +1,97 @@
 # System Architecture
 
-This document describes the current implemented architecture, not just the
-design intent. Every component and data flow here maps to code in the
-repository as of the current `main` branch.
+This document describes the current implemented architecture at a public,
+operational level. It intentionally avoids implementation anchors and detailed
+internal sequencing.
 
-## 1. Component Map
+## Overview
+
+LibraVDB Memory is split into two cooperating pieces:
+
+- a TypeScript OpenClaw plugin that owns the `memory` and `contextEngine`
+  slots
+- a Go sidecar daemon that owns storage, retrieval, and compaction
+
+The plugin keeps the host integration light and stable. The daemon keeps the
+data path local-first and handles the expensive memory operations outside the
+main chat process.
+
+## Component Map
 
 ```mermaid
 flowchart LR
-  Host["OpenClaw host process\n(TypeScript plugin shell)"]
-  CE["Context engine factory\nbootstrap / ingest / assemble / compact"]
-  MPS["memoryPromptSection\nstatic header"]
-  Runtime["Plugin runtime\nlazy daemon connect + RPC client"]
-  Sidecar["Go daemon process"]
-  RPC["JSON-RPC over newline-delimited frames\nUnix socket or TCP loopback on Windows"]
-  Store["LibraVDB store on disk"]
-  Session["session:<sessionId>"]
-  Turns["turns:<userId>"]
-  User["user:<userId>"]
-  Global["global"]
-  Dirty["_tier_dirty"]
-  Embed["ONNX embedding engine"]
-  Extractive["Extractive summarizer"]
-  T5["Optional ONNX T5 summarizer"]
-  Ollama["Optional Ollama summarizer endpoint"]
-
-  Host --> CE
-  Host --> MPS
-  CE --> Runtime
-  Runtime --> RPC
-  RPC --> Sidecar
+  Host["OpenClaw host"]
+  Plugin["TypeScript plugin\nregistration + context engine"]
+  Runtime["Plugin runtime\nlazy daemon connect + RPC"]
+  MPS["memoryPromptSection\ncapability header"]
+  Sidecar["Go daemon"]
+  Store["LibraVDB store"]
+  Embed["Embedding engine"]
+  Summarizer["Summarizer(s)"]
+
+  Host --> Plugin
+  Plugin --> MPS
+  Plugin --> Runtime
+  Runtime --> Sidecar
   Sidecar --> Embed
-  Sidecar --> Extractive
-  Sidecar --> T5
-  Sidecar --> Ollama
+  Sidecar --> Summarizer
   Sidecar --> Store
-  Store --> Session
-  Store --> Turns
-  Store --> User
-  Store --> Global
-  Store --> Dirty
 ```
 
-Implementation anchors:
-
-- plugin entry: [`src/index.ts`](../src/index.ts)
-- lazy runtime startup: [`src/plugin-runtime.ts`](../src/plugin-runtime.ts)
-- daemon supervision and endpoint discovery: [`src/sidecar.ts`](../src/sidecar.ts)
-- transport listener: [`sidecar/server/transport.go`](../sidecar/server/transport.go)
-- RPC method table: [`sidecar/server/rpc.go`](../sidecar/server/rpc.go)
-- store: [`sidecar/store/libravdb.go`](../sidecar/store/libravdb.go)
-
-## 2. Single-Turn Data Flow
-
-### 2.1 `ingest`
-
-Implemented in [`src/context-engine.ts`](../src/context-engine.ts).
-
-For every non-heartbeat message:
-
-1. The host gets an RPC client from the plugin runtime. This lazily connects to
-   the configured daemon endpoint when the plugin is first used.
-2. The message is written to `session:<sessionId>` with `type: "turn"`.
-3. If `message.role === "user"`, the same text is written to `turns:<userId>`.
-4. The host calls `gating_scalar` with `{ userId, text }`.
-5. If `g >= ingestionGateThreshold`, the turn is promoted into
-   `user:<userId>` with the full gating decomposition in metadata.
-
-Important constraints from the current implementation:
-
-- session insertion is fire-and-forget
-- durable promotion is best-effort
-- gating failure does not fail the user turn
-- assistant turns are stored in session memory but are not promoted into
-  durable user memory
-
-### 2.2 `memoryPromptSection`
-
-Implemented in [`src/memory-provider.ts`](../src/memory-provider.ts).
-
-Before the main assembly path runs, the plugin returns a lightweight static
-header fragment that tells the host persistent memory is active.
-
-This path is intentionally synchronous and does not perform RPC retrieval.
-Durable recall now happens entirely inside `assemble`, which keeps embedded
-prompt construction compatible with OpenClaw's synchronous memory prompt hook.
-
-### 2.3 `assemble`
-
-Implemented in [`src/context-engine.ts`](../src/context-engine.ts).
-
-For the current query text (last message content), the host:
-
-1. builds an exclusion set from the most recent message ids
-2. searches `session:<sessionId>`, `user:<userId>`, and `global` in parallel
-3. hybrid-ranks the combined results using host-side scoring
-4. fits the ranked set to `tokenBudget * tokenBudgetFraction`
-5. prepends the selected memories as synthetic `system` messages
-6. returns both the expanded message array and a `systemPromptAddition`
+## Runtime Flow
 
-Current implementation details that matter:
+### `memoryPromptSection`
 
-- user/global hits are cached within `assemble` and reused on repeated queries
-- `assemble` falls back to the unmodified message list on RPC failure
-- `assemble` does not mutate the original `messages` array in place; it returns
-  a new array
+The memory prompt hook returns a small static capability header. It is not the
+main retrieval path.
 
-## 3. Compaction Data Flow
+### `ingest`
 
-Implemented primarily in [`src/context-engine.ts`](../src/context-engine.ts)
-and [`sidecar/compact/summarize.go`](../sidecar/compact/summarize.go).
+Session messages are written into the sidecar-backed store. User turns may also
+be promoted into durable user memory after gating.
 
-When compaction is triggered:
+### `assemble`
 
-1. the host calls `compact_session` with `{ sessionId, force, targetSize }`
-2. the daemon loads eligible non-summary turns from `session:<sessionId>`
-3. turns are sorted by `(ts, id)` and partitioned into deterministic
-   chronological clusters
-4. each cluster is routed to:
-   - extractive summarization by default
-   - optional abstractive summarization if `mean(gating_score) >= 0.60` and an
-     abstractive summarizer is ready
-5. the summary record is inserted back into the same session collection
-6. source turns are deleted only after summary insertion succeeds
+The context engine queries the relevant memory scopes, ranks the results, fits
+them to the current token budget, and injects the selected items as synthetic
+system messages.
 
-Current implementation facts:
+### `compact`
 
-- compaction only touches `session:<sessionId>`
-- raw source turns are preserved if summary insertion fails
-- delete failure logs and leaves the inserted summary in place
-- compaction logs `cluster_id`, `mean_gating_score`, and `summarizer_used`
+Compaction is explicit rather than background-only. The host can request a
+compaction pass, and the system then decides whether the current session is
+eligible. When it does compact, it preserves the newest working context, turns
+older content into smaller summaries, and keeps the raw recent tail intact.
 
-## 4. Failure Modes and Degraded Behavior
+If the input is too small or the compactable portion does not clear local
+thresholds, compaction declines instead of forcing a rewrite.
 
-The table below reflects current code behavior, with notes where it diverges
-from the original spec phrasing.
+## Current Boundaries
 
-| Failure | Current behavior | User impact |
-|---|---|---|
-| Daemon unavailable on first RPC use | `getRpc()` rejects when first connect or health check fails | That hook fails or falls back, but plugin registration itself does not crash eagerly |
-| Daemon connection closes mid-session | `SidecarSupervisor` retries with exponential backoff until retry budget is exhausted, then enters degraded mode | Memory becomes unavailable until the daemon is reachable again |
-| `memoryPromptSection` failure | returns a static header with no RPC dependency | Prompt section stays available and does not block the run |
-| `assemble` RPC failure | returns original messages, original token count, and empty `systemPromptAddition` | That turn gets no recall augmentation |
-| `ingest` gating or durable insert failure | session write already happened; durable promotion is skipped | Session memory survives, durable memory may miss that turn |
-| Compaction summarizer unavailable | extractive summarizer remains required; optional abstractive path is skipped | Compaction still runs extractively when extractive is healthy |
-| Disk full or insert error | Go RPC returns an error; TypeScript caller logs or degrades | New records are not stored, but chat continues |
-| Empty lower Matryoshka tiers | cascade search naturally falls through because empty tiers return `best = 0.0` | Retrieval degrades to higher tiers without returning false confident exits |
+- `memoryPromptSection` stays lightweight
+- retrieval happens in `assemble`
+- compaction is separate from prompt construction
+- lifecycle hints such as `before_reset` and `session_end` are advisory
+- the sidecar is the source of truth for stored memory state
 
-Relevant code:
+## Failure Handling
 
-- retry/degraded behavior: [`src/sidecar.ts`](../src/sidecar.ts)
-- lazy daemon connect and health gate: [`src/plugin-runtime.ts`](../src/plugin-runtime.ts)
-- compaction routing and insert/delete ordering:
-  [`sidecar/compact/summarize.go`](../sidecar/compact/summarize.go)
+The plugin is designed to degrade gracefully:
 
-## 5. Gating Decision Path
+- if the daemon is unavailable, prompt assembly continues without recall
+- if compaction fails, the active session is not blocked
+- if summarization is unavailable, the system falls back to the safer path
 
-The gating decision spans both layers:
+That keeps the chat usable even when the memory backend is temporarily down.
 
-1. `ingest` writes the user turn to `turns:<userId>`
-2. the host calls `gating_scalar`
-3. the Go daemon performs exactly two searches:
-   - `SearchText("turns:<userId>", text, 10, nil)`
-   - `SearchText("user:<userId>", text, 5, nil)`
-4. the daemon computes `GatingSignals` with [`compact.ComputeGating`](../sidecar/compact/gate.go)
-5. the host compares `g` to `ingestionGateThreshold`
-6. on pass, the host writes the turn into `user:<userId>` with all gating
-   metadata fields
-7. later, compaction computes the mean `gating_score` of a cluster and may route
-   high-value clusters to the abstractive summarizer
+## Why This Shape
 
-If the gate fails:
+This architecture keeps the host integration simple while still supporting:
 
-- the turn still exists in `session:<sessionId>`
-- the turn still exists in `turns:<userId>`
-- the turn is not promoted into `user:<userId>`
-- downstream durable recall and compaction routing cannot use that turn's
-  gating metadata because it was never promoted
+- separate session, durable-user, and global scopes
+- bounded prompt assembly
+- explicit compaction
+- local-first storage and retrieval
 
-That makes the gate a durable-memory admission control, not a full-ingestion
-blocker.
+In short, the plugin owns the lifecycle contract, and the sidecar owns the
+heavy lifting.

package/docs/contributing.md

@@ -73,8 +73,7 @@ Before opening a PR:
 - `pnpm check` must pass
 - `go test -race ./...` from `sidecar/` must pass
 - any new gating signal must come with calibration or invariant coverage
-- any retrieval math change must be reflected in [mathematics-v2.md](./mathematics-v2.md)
-- any gating change must be reflected in [gating.md](./gating.md)
+- any retrieval math or gating change must be reflected in the private design notes
 
 ## Release Versioning
 

package/docs/embedding-profiles.md

@@ -4,15 +4,14 @@ The plugin now supports a lightweight `embeddingProfile` setting for named local
 
 Default selection baseline as of `2026-03-28`:
 
-- default embedding profile: `nomic-embed-text-v1.5`
+- default embedding profile: `all-minilm-l6-v2`
 - bundled fallback profile: `all-minilm-l6-v2`
 
 Why:
 
-- MiniLM and Nomic are equivalent on the current lexical and paraphrase baseline.
-- Nomic materially outperforms MiniLM on cross-domain ranking quality.
-- Nomic is the only profile that clears the long-context baseline once sliding-window document embedding is applied.
-- Adversarial lexical traps remain reranker-window cases, but Nomic still narrows the relevant-vs-distractor margin materially.
+- MiniLM keeps the local LongMemEval retrieval slice inside the target memory envelope on macOS.
+- Nomic remains available as an explicit opt-in profile for long-context experiments.
+- Nomic ONNX on macOS is fragile with CoreML execution and can trigger multi-GB RSS, so it is no longer the safe bundled default.
 
 Current shipped profile names:
 
@@ -37,6 +36,6 @@ How it works:
 
 Recommended usage:
 
-- `bundled` for the shipped default path, which now prefers Nomic and falls back to MiniLM if the primary profile is unavailable.
+- `bundled` for the shipped default path, which now prefers MiniLM for local stability.
 - `onnx-local` plus `embeddingProfile` when a power user wants a known model family like Nomic with local assets.
 - treat remote/Ollama providers as future separate backend types, not as overloads of `custom-local`.

package/docs/installation.md

@@ -264,7 +264,7 @@ Expected output shape:
 │ Memories stored    │ 0                            │
 │ Gate threshold     │ 0.35                         │
 │ Abstractive model  │ ready | not provisioned      │
-│ Embedding profile  │ nomic-embed-text-v1.5        │
+│ Embedding profile  │ all-minilm-l6-v2             │
 │ Message            │ ok                           │
 └────────────────────┴──────────────────────────────┘
 ```

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.4.2",
+  "version": "1.4.4",
   "kind": ["memory", "context-engine"],
   "configSchema": {
     "type": "object",
@@ -15,7 +15,7 @@
       "embeddingBackend": { "type": "string", "enum": ["bundled", "onnx-local", "custom-local"] },
       "embeddingProfile": {
         "type": "string",
-        "default": "nomic-embed-text-v1.5"
+        "default": "all-minilm-l6-v2"
       },
       "fallbackProfile": {
         "type": "string",
@@ -41,6 +41,64 @@
         "type": "number",
         "default": 0.35
       },
+      "markdownIngestionEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "markdownIngestionRoots": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionObsidianEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "markdownIngestionObsidianRoots": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionObsidianInclude": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionObsidianExclude": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionObsidianDebounceMs": {
+        "type": "number",
+        "default": 150
+      },
+      "markdownIngestionInclude": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionExclude": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "markdownIngestionCollection": {
+        "type": "string",
+        "default": "global"
+      },
+      "markdownIngestionDebounceMs": {
+        "type": "number",
+        "default": 150
+      },
+      "dreamPromotionEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "dreamPromotionDiaryPath": {
+        "type": "string"
+      },
+      "dreamPromotionUserId": {
+        "type": "string"
+      },
+      "dreamPromotionDebounceMs": {
+        "type": "number",
+        "default": 150
+      },
       "gatingWeights": {
         "type": "object",
         "additionalProperties": false,
@@ -79,6 +137,11 @@
       "recencyLambdaGlobal": { "type": "number" },
       "tokenBudgetFraction": { "type": "number" },
       "compactThreshold": { "type": "number" },
+      "compactSessionTokenBudget": {
+        "type": "number",
+        "default": 2000,
+        "description": "Auto-trigger compaction when the session accumulates this many tokens since the last compaction. Set to 0 to disable auto-compaction."
+      },
       "ollamaUrl": { "type": "string" },
       "compactModel": { "type": "string" },
       "rpcTimeoutMs": { "type": "number", "default": 30000 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
   "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/host-flow.test.js .ts-build/test/integration/sidecar-lifecycle.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",

package/src/cli.ts

@@ -2,6 +2,7 @@ import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import { resolveDurableNamespace } from "./durable-namespace.js";
+import { promoteDreamDiaryFile } from "./dream-promotion.js";
 import type { PluginRuntime } from "./plugin-runtime.js";
 import type { LoggerLike, PluginConfig } from "./types.js";
 
@@ -26,6 +27,7 @@ type ExportResult = {
 };
 
 type CliOptionBag = {
+  dreamFile?: string;
   userId?: string;
   sessionKey?: string;
   sessionId?: string;
@@ -94,6 +96,17 @@ export function registerMemoryCli(
       journal.option("--session-id <sessionId>", "Restrict journal entries to one session id");
       journal.option("--limit <limit>", "Maximum journal entries to show");
       journal.action((opts) => void runJournal(runtime, opts, logger));
+
+      const dreamPromote = ensureCommand(root, "dream-promote")
+        .description("Promote vetted dream diary entries into the dedicated dream collection");
+      if (dreamPromote.requiredOption) {
+        dreamPromote.requiredOption("--user-id <userId>", "User id whose dream collection should receive the promotion");
+        dreamPromote.requiredOption("--dream-file <path>", "Dream diary markdown file to promote from");
+      } else {
+        dreamPromote.option("--user-id <userId>", "User id whose dream collection should receive the promotion");
+        dreamPromote.option("--dream-file <path>", "Dream diary markdown file to promote from");
+      }
+      dreamPromote.action((opts) => void runDreamPromote(runtime, opts, logger));
     },
     {
       descriptors: [
@@ -207,6 +220,27 @@ async function runJournal(runtime: PluginRuntime, opts: CliOptionBag | undefined
   }
 }
 
+async function runDreamPromote(runtime: PluginRuntime, opts: CliOptionBag | undefined, logger: LoggerLike): Promise<void> {
+  const userId = opts?.userId?.trim();
+  const dreamFile = opts?.dreamFile?.trim();
+  if (!userId || !dreamFile) {
+    logger.error("LibraVDB dream-promote requires --user-id <userId> and --dream-file <path>.");
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    const rpc = await runtime.getRpc();
+    const result = await promoteDreamDiaryFile(rpc, { userId, diaryPath: dreamFile });
+    console.log(
+      `Promoted ${result.promoted ?? 0} dream entr${(result.promoted ?? 0) === 1 ? "y" : "ies"}; rejected ${result.rejected ?? 0}.`,
+    );
+  } catch (error) {
+    logger.error(`LibraVDB dream promotion failed: ${formatError(error)}`);
+    process.exitCode = 1;
+  }
+}
+
 async function confirm(prompt: string): Promise<boolean> {
   const rl = createInterface({ input: stdin, output: stdout });
   try {