@psiclawops/hypermem 0.8.0 → 0.8.1

package/ARCHITECTURE.md

@@ -267,7 +267,7 @@ For open and deferred items, see [docs/ROADMAP.md](docs/ROADMAP.md).
 | `rate-limiter.ts` | ~230 | L3 | Token-bucket for embedding API |
 | `schema.ts` | ~200 | L2 | Messages schema + migrations |
 | `episode-store.ts` | ~180 | L4 | Significant event tracking |
-| `preference-store.ts` | ~170 | L4 | operator behavioral patterns |
+| `preference-store.ts` | ~170 | L4 | Operator behavioral patterns |
 | `topic-store.ts` | ~160 | L4 | Cross-session thread tracking |
 | `plugin/src/index.ts` | ~590 | - | `hypercompositor` context engine plugin + window invalidation |
 | `memory-plugin/src/index.ts` | ~290 | - | `hypermem` memory slot plugin (memory_search via hybrid retrieval) |

package/README.md

@@ -32,6 +32,8 @@ The difference isn't intelligence. It's what was in the prompt. Two failure mode
 
 **Compaction crunch.** Long sessions fill the context window. The runtime summarizes to make room. Specifics (tool output, exact decisions, file paths) are lost in the summary. The agent keeps running, but degraded.
 
+**Bloated context.** 128k tokens doesn't mean 128k of useful prompt. Without active curation, agents fill the window with stale history, redundant instructions, and memory that isn't relevant to this turn. A bigger context window just means more room to waste. The information is in the prompt somewhere, buried under content irrelevant to this turn.
+
 ---
 
 ## What OpenClaw provides today
@@ -104,10 +106,10 @@ What's in storage, not in this prompt:
   Change the topic, and the next turn pulls different content from the same storage.
 ```
 
-### Standard context engine vs. hypercompositor
+### OpenClaw default vs. hypercompositor
 
 ```
-Standard                                hypercompositor
+OpenClaw default                        hypercompositor
 ────────────────────────────────        ────────────────────────────────
 message → append to transcript          message → detect active topic
 transcript full → trim oldest           query 4 storage layers in parallel
@@ -125,7 +127,7 @@ When it fills:                          When budget is exceeded:
   no recovery path                        change topic back → retrieved again
 ```
 
-| | Standard | hypercompositor |
+| | OpenClaw default | hypercompositor |
 |---|---|---|
 | Context source | Growing transcript only | Transcript + 3 additional storage layers |
 | When context fills | Trim + summarize (lossy) | Budget allocation (lossless storage) |
@@ -164,9 +166,9 @@ Different models have different default behaviors. GPT-5.4 tends toward 2x verbo
 
 Adaptation entries are stored in the `model_output_directives` table and matched by model ID using exact match, then glob pattern (longest wins), then wildcard fallback. Each entry contains:
 
-- **Calibration** — known model tendencies and specific adjustments (e.g., "2x verbosity: cut first drafts in half")
-- **Corrections** — hard/medium/soft severity rules applied in order (e.g., "No preamble before the answer")
-- **Task overrides** — per-task-type adjustments
+- **Calibration:** known model tendencies and specific adjustments (e.g., "2x verbosity: cut first drafts in half")
+- **Corrections:** hard/medium/soft severity rules applied in order (e.g., "No preamble before the answer")
+- **Task overrides:** per-task-type adjustments
 
 Model adaptation is only active at the `full` tier. At `light` and `standard`, model-specific corrections are suppressed.
 
@@ -196,7 +198,7 @@ Would you like me to go deeper on any of these?
 WITH outputProfile: "light":
 For a 128k window: reserve 14k for identity/system, target 46k for history, 10k for recent
 tool context, and leave ~30k as allocator reserve. hypermem handles slot competition
-automatically — set `reserveFraction` to your preferred floor and let the compositor fill.
+automatically. Set `reserveFraction` to your preferred floor and let the compositor fill.
 ```
 
 **Confabulation resistance** checks output against stored facts before claims are recorded. No LLM call. Pattern matching against the fact corpus, with confidence scoring and contradiction detection. Unsupported claims are flagged, contradictions surface in diagnostics, and a confabulation risk score is attached to the stored episode.
@@ -241,16 +243,7 @@ SQL queries that interpolate datetime values are fully parameterized. FTS5 trigg
 
 ## Pressure management
 
-hypermem composes context fresh on every turn, but a long-running session still accumulates history in its JSONL transcript. When that grows large enough, incoming tool results have nowhere to land and get silently stripped. Four automatic paths handle this:
-
-| Path | Trigger | Action |
-|---|---|---|
-| **Pressure-tiered tool-loop trim** | Any tool-loop turn | Measures projected occupancy before results land; trims large results at 80%+ and truncates the messages[] array for the current turn |
-| **AfterTurn trim** | Every turn at >80% | Pre-emptive headroom cut after the assistant replies, before the next turn arrives |
-| **Deep compaction** | compact() at >85% | Cuts in-memory cache to 25% budget and truncates JSONL to ~20% depth. Bypasses the normal reshape guard |
-| **Reshape guard** | Structured tool history on downshift | `canPersistReshapedHistory()` blocks a lower-context snapshot from overwriting the full JSONL history |
-
-**The one thing these paths cannot fix:** a session whose JSONL transcript on disk is already at 98% when the gateway restarts. The JSONL loads into runtime context before any compaction runs. Check `session_status` on startup. If you're above 85%, start a fresh session.
+hypermem manages context pressure automatically through four escalating paths. Most sessions never need manual intervention. For trigger thresholds and path details, see [Pressure management](#pressure-management-1) below.
 
 ---
 
@@ -332,7 +325,7 @@ FTS5 queries use compound indexes on `agentId + sort key` and prefix optimizatio
 | Knowledge | Domain/key/value structured data with full-text search |
 | Episodes | Significant events with impact scores and participant tracking |
 | Topics | Cross-session thread tracking and synthesized wiki pages |
-| Preferences | operator behavioral patterns |
+| Preferences | Operator behavioral patterns |
 | Fleet Registry | Agent registry with tier, org, and capability metadata |
 | System Registry | Service state and lifecycle |
 | Work Items | Work queue with status transitions and FTS5 |
@@ -383,7 +376,7 @@ Slot-level budget allocation is shown in the [hypercompositor diagram](#what-the
 
 ## Requirements
 
-**Current release: hypermem 0.8.0.** Changelog: [CHANGELOG.md](./CHANGELOG.md)
+**Current release: hypermem 0.8.1.** Changelog: [CHANGELOG.md](./CHANGELOG.md)
 
 | Requirement | Version | Notes |
 |---|---|---|
@@ -396,7 +389,7 @@ SQLite is a library, not a service. All four layers run in-process with no exter
 **Runtime version constants** (importable from the package):
 ```typescript
 import {
-  ENGINE_VERSION,        // '0.8.0'
+  ENGINE_VERSION,        // '0.8.1'
   MIN_NODE_VERSION,      // '22.0.0'
   SQLITE_VEC_VERSION,    // '0.1.9'
   MAIN_SCHEMA_VERSION,   // 10 (messages.db)
@@ -410,29 +403,63 @@ Schema versions are stamped into each database on startup and checked on open. A
 
 ## Installation
 
+**Requirements:** Node.js 22+, OpenClaw with context engine plugin support. No standalone SQLite install needed (uses Node 22 built-in `node:sqlite`). Embedding provider is optional for first install.
+
+### From source
+
 ```bash
-git clone https://github.com/PsiClawOps/hypermem.git ~/.openclaw/workspace/repo/hypermem
-cd ~/.openclaw/workspace/repo/hypermem
+git clone https://github.com/PsiClawOps/hypermem.git
+cd hypermem
 npm install && npm run build
 npm --prefix plugin install && npm --prefix plugin run build
 npm --prefix memory-plugin install && npm --prefix memory-plugin run build
+npm run install:runtime
+```
+
+`install:runtime` stages the runtime payload into `~/.openclaw/plugins/hypermem` and prints the exact config commands to wire the plugins. Before running them, create the data directory and config:
+
+```bash
+mkdir -p ~/.openclaw/hypermem
+cat > ~/.openclaw/hypermem/config.json <<'JSON'
+{
+  "embedding": {
+    "provider": "none"
+  }
+}
+JSON
+```
+
+This sets lightweight mode (FTS5 keyword search, no embedding provider needed). Add an embedding provider later for semantic search without losing stored data. See [INSTALL.md](./INSTALL.md#embedding-providers) for options.
 
+Wire the plugins into OpenClaw:
+
+```bash
+openclaw config set plugins.load.paths "[\"$HOME/.openclaw/plugins/hypermem/plugin\",\"$HOME/.openclaw/plugins/hypermem/memory-plugin\"]" --strict-json
 openclaw config set plugins.slots.contextEngine hypercompositor
 openclaw config set plugins.slots.memory hypermem
-openclaw config set plugins.load.paths '["~/.openclaw/workspace/repo/hypermem/plugin","~/.openclaw/workspace/repo/hypermem/memory-plugin"]' --strict-json
 openclaw config set plugins.allow '["hypercompositor","hypermem"]' --strict-json
 openclaw gateway restart
 ```
 
-Or use the one-line installer:
+Verify (run from the repo clone directory):
+
+```bash
+openclaw plugins list                    # hypercompositor and hypermem should show as loaded
+node bin/hypermem-status.mjs --health    # confirms database initialization
+openclaw logs --limit 50 | grep hypermem # should show "hypermem initialized"
+```
+
+If you see `falling back to default engine "legacy"` in the logs, the install is not active. Check [INSTALL.md troubleshooting](./INSTALL.md#troubleshooting-clean-installs).
+
+### One-line installer
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/PsiClawOps/hypermem/main/install.sh | bash
 ```
 
-**Requirements:** Node.js 22+, OpenClaw with context engine plugin support, and either Ollama (local) or an OpenRouter API key (hosted) for embeddings. No standalone SQLite install is required for the documented repo install: hypermem uses the SQLite bundled with Node 22 via `node:sqlite`, and `sqlite-vec` provides the platform-specific extension through npm dependencies.
+Interactive: detects hardware, selects embedding tier, writes config, registers plugins.
 
-Full guide with deployment-specific options: **[INSTALL.md](./INSTALL.md)**
+Full guide with embedding tiers, reranker setup, fleet config, and tuning: **[INSTALL.md](./INSTALL.md)**
 
 ### Agent-assisted install
 
@@ -440,7 +467,7 @@ If you prefer, hand the install to your OpenClaw agent:
 
 > "Install hypermem following INSTALL.md. I'm running a [solo / multi-agent] setup."
 
-### operator guides
+### Operator guides
 
 - **[docs/MEMORY_MD_AUTHORING.md](./docs/MEMORY_MD_AUTHORING.md)**, how to keep `MEMORY.md` compact, durable, and reviewable
 - **[docs/TUNING.md](./docs/TUNING.md)**, context assembly and output shaping profiles
@@ -448,7 +475,7 @@ If you prefer, hand the install to your OpenClaw agent:
 
 ### Tuning
 
-Two independent surfaces: **context assembly** (what fills the context window) and **output shaping** (how the model writes). Pick a profile first — most deployments adjust one or two settings on top.
+Two independent surfaces: **context assembly** (what fills the context window) and **output shaping** (how the model writes). Pick a profile first. Most deployments adjust one or two settings on top.
 
 | Profile | Target window | Best for |
 |---|---|---|
@@ -499,7 +526,7 @@ Full reference: **[docs/TUNING.md](./docs/TUNING.md)**
 
 ## API
 
-> **Note:** The examples below use placeholder agent names (`my-agent`, `alice`, etc.). Replace these with your actual agent IDs from your OpenClaw config. Single-agent installs typically use `main`. Multi-agent fleets use whatever IDs you've configured. See [INSTALL.md § "Configure your fleet"](./INSTALL.md#step-5--configure-your-fleet-multi-agent-only) for details.
+> **Note:** The examples below use placeholder agent names (`my-agent`, `agent1`, etc.). Replace these with your actual agent IDs from your OpenClaw config. Single-agent installs typically use `main`. Multi-agent fleets use whatever IDs you've configured. See [INSTALL.md § "Configure your fleet"](./INSTALL.md#step-5--configure-your-fleet-multi-agent-only) for details.
 
 ```typescript
 import { HyperMem } from '@psiclawops/hypermem';
@@ -556,6 +583,21 @@ node bin/hypermem-status.mjs --health        # health checks only (exit 1 on fai
 
 ---
 
+## Pressure management
+
+hypermem composes context fresh on every turn, but a long-running session still accumulates history in its JSONL transcript. When that grows large enough, incoming tool results have nowhere to land and get silently stripped. Four automatic paths handle this:
+
+| Path | Trigger | Action |
+|---|---|---|
+| **Pressure-tiered tool-loop trim** | Any tool-loop turn | Measures projected occupancy before results land; trims large results at 80%+ and truncates the messages[] array for the current turn |
+| **AfterTurn trim** | Every turn at >80% | Pre-emptive headroom cut after the assistant replies, before the next turn arrives |
+| **Deep compaction** | compact() at >85% | Cuts in-memory cache to 25% budget and truncates JSONL to ~20% depth. Bypasses the normal reshape guard |
+| **Reshape guard** | Structured tool history on downshift | `canPersistReshapedHistory()` blocks a lower-context snapshot from overwriting the full JSONL history |
+
+**The one thing these paths cannot fix:** a session whose JSONL transcript on disk is already at 98% when the gateway restarts. The JSONL loads into runtime context before any compaction runs. Check `session_status` on startup. If you're above 85%, start a fresh session.
+
+---
+
 ## Data directory
 
 ```text
@@ -578,7 +620,7 @@ The migration guide includes worked examples showing how to bring data from Open
 
 All examples default to dry-run. Nothing is written until you add `--apply`.
 
-operator guide: **[docs/MIGRATION_GUIDE.md](./docs/MIGRATION_GUIDE.md)**
+Operator guide: **[docs/MIGRATION_GUIDE.md](./docs/MIGRATION_GUIDE.md)**
 
 
 ---

package/bin/hypermem-status.mjs

@@ -4,7 +4,7 @@
  *
  * Usage:
  *   node bin/hypermem-status.mjs              # full dashboard
- *   node bin/hypermem-status.mjs --agent carol # scoped to one agent
+ *   node bin/hypermem-status.mjs --agent forge # scoped to one agent
  *   node bin/hypermem-status.mjs --json        # machine-readable output
  *   node bin/hypermem-status.mjs --health      # health checks only (exit 1 on failure)
  *

package/dist/background-indexer.js

@@ -37,27 +37,27 @@ import { isSafeForSharedVisibility } from './secret-scanner.js';
 // returns results. New agents default to 'general'.
 //
 // ── EXAMPLE DATA ──────────────────────────────────────────────────
-// The agent names below (alice, director1, etc.) are PLACEHOLDERS.
+// The agent names below (agent1, director1, etc.) are PLACEHOLDERS.
 // Replace them with your own agent IDs and domain labels to match
 // your fleet. Single-agent installs don't need to edit this:
 // unknown agents fall through to 'general' automatically.
 // See INSTALL.md § "Configure your fleet" for details.
 // ─────────────────────────────────────────────────────────────────
 const AGENT_DOMAIN_MAP = {
-    alice: 'infrastructure',
+    agent1: 'infrastructure',
     director2: 'infrastructure',
     director1: 'infrastructure',
     director3: 'infrastructure',
-    bob: 'product',
+    agent2: 'product',
     director4: 'product',
     director5: 'product',
     director6: 'product',
-    dave: 'security',
+    agent3: 'security',
     director7: 'security',
     director8: 'security',
     agent4: 'ux',
-    carol: 'governance',
-    oscar: 'strategy',
+    agent6: 'governance',
+    agent5: 'strategy',
     specialist1: 'development',
     specialist2: 'communications',
     main: 'general',
@@ -94,7 +94,7 @@ function extractFactCandidates(content) {
     // Preference patterns — medium confidence (0.60)
     const preferencePatterns = [
         /(?:prefer|always use|never use|don't use|avoid) (.{10,150})/gi,
-        /(?:operator) (?:wants|prefers|likes|hates|dislikes) (.{10,150})/gi,
+        /(?:operator|operator) (?:wants|prefers|likes|hates|dislikes) (.{10,150})/gi,
     ];
     // Operational patterns: deployments, incidents, fixes — high confidence (0.70)
     const operationalPatterns = [
@@ -148,7 +148,7 @@ const OPERATIONAL_BOILERPLATE = [
     /still\s*waiting/i,
     /will\s*pick\s*(it\s*)?up\s*(on\s*(next|the))?/i,
     /message\s*is\s*in\s*(his|her|their|the)\s*queue/i,
-    /sent\s+to\s+(carol|bob|agent4|dave|oscar|alice)/i,
+    /sent\s+to\s+(agent6|agent2|agent4|agent3|agent5|agent1)/i,
     /dispatched\s+(it\s+)?to/i,
     /timed\s*out\s*after/i,
     /\bNO_REPLY\b/,
@@ -393,7 +393,7 @@ function detectTopic(content) {
     if (!content || content.length < 50)
         return null;
     // Product/project name detection
-    const productMatch = content.match(/\b(HyperMem|ClawText|dashboard|canvas|council|automation|OpenClaw|dispatch)\b/i);
+    const productMatch = content.match(/\b(HyperMem|ClawText|ClawDash|ClawCanvas|ClawCouncil|ClawTomation|OpenClaw|ClawDispatch)\b/i);
     if (productMatch)
         return productMatch[1];
     // Infrastructure topic detection

package/dist/cross-agent.d.ts

@@ -27,7 +27,7 @@ export interface OrgRegistry {
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is

package/dist/cross-agent.js

@@ -21,7 +21,7 @@ import { FleetStore } from './fleet-store.js';
  * Default fleet org structure.
  *
  * ── EXAMPLE DATA ──────────────────────────────────────────────────────────
- * The agent names below (alice, bob, director1, etc.) are PLACEHOLDERS.
+ * The agent names below (agent1, agent2, director1, etc.) are PLACEHOLDERS.
  * Replace them with your own agent IDs to match your fleet configuration.
  *
  * Single-agent installs: you don't need to edit this. Your agent ID is
@@ -34,27 +34,27 @@ import { FleetStore } from './fleet-store.js';
  */
 export function defaultOrgRegistry() {
     const agents = {
-        alice: { agentId: 'alice', tier: 'council' },
-        bob: { agentId: 'bob', tier: 'council' },
+        agent1: { agentId: 'agent1', tier: 'council' },
+        agent2: { agentId: 'agent2', tier: 'council' },
         agent4: { agentId: 'agent4', tier: 'council' },
-        dave: { agentId: 'dave', tier: 'council' },
-        carol: { agentId: 'carol', tier: 'council' },
-        oscar: { agentId: 'oscar', tier: 'council' },
-        director1: { agentId: 'director1', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director2: { agentId: 'director2', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director3: { agentId: 'director3', tier: 'director', org: 'alice-org', councilLead: 'alice' },
-        director4: { agentId: 'director4', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director5: { agentId: 'director5', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director6: { agentId: 'director6', tier: 'director', org: 'bob-org', councilLead: 'bob' },
-        director7: { agentId: 'director7', tier: 'director', org: 'dave-org', councilLead: 'dave' },
-        director8: { agentId: 'director8', tier: 'director', org: 'dave-org', councilLead: 'dave' },
+        agent3: { agentId: 'agent3', tier: 'council' },
+        agent6: { agentId: 'agent6', tier: 'council' },
+        agent5: { agentId: 'agent5', tier: 'council' },
+        director1: { agentId: 'director1', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director2: { agentId: 'director2', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director3: { agentId: 'director3', tier: 'director', org: 'agent1-org', councilLead: 'agent1' },
+        director4: { agentId: 'director4', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director5: { agentId: 'director5', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director6: { agentId: 'director6', tier: 'director', org: 'agent2-org', councilLead: 'agent2' },
+        director7: { agentId: 'director7', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
+        director8: { agentId: 'director8', tier: 'director', org: 'agent3-org', councilLead: 'agent3' },
         specialist1: { agentId: 'specialist1', tier: 'specialist' },
         specialist2: { agentId: 'specialist2', tier: 'specialist' },
     };
     const orgs = {
-        'alice-org': ['alice', 'director1', 'director2', 'director3'],
-        'bob-org': ['bob', 'director4', 'director5', 'director6'],
-        'dave-org': ['dave', 'director7', 'director8'],
+        'agent1-org': ['agent1', 'director1', 'director2', 'director3'],
+        'agent2-org': ['agent2', 'director4', 'director5', 'director6'],
+        'agent3-org': ['agent3', 'director7', 'director8'],
     };
     return { orgs, agents };
 }

package/dist/dreaming-promoter.d.ts

@@ -67,7 +67,7 @@ export interface DreamerResult {
 }
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace/{agentId}/
+ * Council agents live at ~/.openclaw/workspace-council/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export declare function resolveAgentWorkspacePath(agentId: string): Promise<string | null>;

package/dist/dreaming-promoter.js

@@ -31,12 +31,12 @@ export const DEFAULT_DREAMER_CONFIG = {
 // ─── Workspace path resolution ───────────────────────────────────────────────
 /**
  * Resolve the workspace directory for an agent.
- * Council agents live at ~/.openclaw/workspace/{agentId}/
+ * Council agents live at ~/.openclaw/workspace-council/{agentId}/
  * Other agents at ~/.openclaw/workspace/{agentId}/
  */
 export async function resolveAgentWorkspacePath(agentId) {
     const home = os.homedir();
-    const councilPath = path.join(home, '.openclaw', 'workspace', agentId);
+    const councilPath = path.join(home, '.openclaw', 'workspace-council', agentId);
     const workspacePath = path.join(home, '.openclaw', 'workspace', agentId);
     try {
         await fs.access(councilPath);

package/dist/index.d.ts

@@ -126,8 +126,8 @@ export interface StartupFleetSeedResult {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
+ *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
  */
 export declare class HyperMem {
     readonly dbManager: DatabaseManager;
@@ -185,7 +185,7 @@ export declare class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * operator-safe enumeration path. This is the approved archived-context
+     * Operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId: string, opts?: {

package/dist/index.js

@@ -97,7 +97,7 @@ const DEFAULT_CONFIG = {
     cache: {
         keyPrefix: 'hm:',
         sessionTTL: 14400, // 4 hours — system/identity/meta slots
-        historyTTL: 604800, // 7 days — extended for canvas display
+        historyTTL: 604800, // 7 days — extended for ClawCanvas display
     },
     compositor: {
         // TUNE-010 (2026-04-02): Raised from 65000 → 90000.
@@ -217,7 +217,7 @@ function mergeStartupCandidate(target, partial) {
 function discoverStartupFleetCandidates(dbManager, opts = {}) {
     const homeDir = process.env.HOME || os.homedir();
     const workspaceRoots = opts.workspaceRoots ?? [
-        path.join(homeDir, '.openclaw', 'workspace'),
+        path.join(homeDir, '.openclaw', 'workspace-council'),
         path.join(homeDir, '.openclaw', 'workspace'),
     ];
     const candidates = new Map();
@@ -331,8 +331,8 @@ function discoverStartupFleetCandidates(dbManager, opts = {}) {
  *
  * Usage:
  *   const hm = await hypermem.create({ dataDir: '~/.openclaw/hypermem' });
- *   await hm.record('alice', 'agent:alice:webchat:main', userMsg);
- *   const result = await hm.compose({ agentId: 'alice', sessionKey: '...', ... });
+ *   await hm.record('agent1', 'agent:agent1:webchat:main', userMsg);
+ *   const result = await hm.compose({ agentId: 'agent1', sessionKey: '...', ... });
  */
 export class HyperMem {
     dbManager;
@@ -531,7 +531,7 @@ export class HyperMem {
     /**
      * List archived or forked contexts for an agent.
      *
-     * operator-safe enumeration path. This is the approved archived-context
+     * Operator-safe enumeration path. This is the approved archived-context
      * listing surface. Active composition remains separate.
      */
     listArchivedContexts(agentId, opts) {

package/dist/open-domain.js

@@ -61,7 +61,7 @@ export function buildOpenDomainFtsQuery(query) {
         .split(/\s+/)
         .filter(w => w.length >= 3 && !STOP_WORDS.has(w))
         .slice(0, 6)
-        .map(w => `${w}*`);
+        .map(w => `"${w}"*`);
     if (terms.length === 0)
         return null;
     return terms.join(' OR ');

package/dist/seed.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/seed.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const seeder = new WorkspaceSeeder(hypermem);
- *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'alice' });
+ *   const result = await seeder.seedWorkspace('/path/to/workspace', { agentId: 'agent1' });
  *
  * Idempotent: skips files whose source hash hasn't changed since last index.
  * Atomic: each file's chunks are swapped in a single transaction.

package/dist/session-flusher.d.ts

@@ -33,8 +33,8 @@ export interface FlushSessionResult {
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "alice")
- * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export declare function flushSession(cache: CacheLayer, agentId: string, sessionKey: string, opts?: FlushSessionOptions): Promise<FlushSessionResult>;

package/dist/session-flusher.js

@@ -18,8 +18,8 @@
  * from those stores naturally.
  *
  * @param cache   Connected CacheLayer instance
- * @param agentId Agent identifier (e.g. "alice")
- * @param sessionKey  Full session key (e.g. "agent:alice:webchat:scratchpad")
+ * @param agentId Agent identifier (e.g. "agent1")
+ * @param sessionKey  Full session key (e.g. "agent:agent1:webchat:scratchpad")
  * @param opts    Optional flags
  */
 export async function flushSession(cache, agentId, sessionKey, opts = {}) {

package/dist/spawn-context.d.ts

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:alice:webchat:main',
+ *     parentSessionKey: 'agent:agent1:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/spawn-context.js

@@ -6,7 +6,7 @@
  *
  * Usage:
  *   const ctx = await buildSpawnContext(messageStore, docChunkStore, agentId, {
- *     parentSessionKey: 'agent:alice:webchat:main',
+ *     parentSessionKey: 'agent:agent1:webchat:main',
  *     workingSnapshot: 10,
  *     documents: ['/path/to/spec.md'],
  *   });

package/dist/temporal-store.js

@@ -59,11 +59,11 @@ export class TemporalStore {
         const limit = opts.limit ?? 20;
         const order = opts.order ?? 'DESC';
         const minConf = opts.minConfidence ?? 0;
-        const params = [];
+        const params = [minConf];
         const conditions = [
             'f.superseded_by IS NULL',
             'f.decay_score < 0.8',
-            `t.confidence >= ${minConf}`,
+            't.confidence >= ?',
         ];
         if (opts.agentId) {
             conditions.push('t.agent_id = ?');

package/dist/topic-store.js

@@ -12,12 +12,12 @@
 const KNOWN_NAMES = {
     hypermem: 'HyperMem',
     hyperbuilder: 'HyperBuilder',
-    clawcanvas: 'canvas',
-    clawdash: 'dashboard',
-    clawdispatch: 'dispatch',
+    clawcanvas: 'ClawCanvas',
+    clawdash: 'ClawDash',
+    clawdispatch: 'ClawDispatch',
     clawtext: 'ClawText',
-    clawtomation: 'automation',
-    clawcouncil: 'council',
+    clawtomation: 'ClawTomation',
+    clawcouncil: 'ClawCouncil',
     openclaw: 'OpenClaw',
     clawhub: 'ClawHub',
 };

package/dist/topic-synthesizer.js

@@ -35,7 +35,7 @@ function keystoneScore(msg) {
     const backtickMatches = text.match(/`[^`]+`/g) || [];
     score += backtickMatches.length * 0.2;
     // Agent mentions (known patterns)
-    const agentMentions = text.match(/\b(alice|bob|agent4|dave|oscar|carol|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
+    const agentMentions = text.match(/\b(agent1|agent2|agent4|agent3|agent5|agent6|director1|director2|director7|specialist2|specialist1)\b/gi) || [];
     score += agentMentions.length * 0.25;
     // Quoted content
     const quotedMatches = text.match(/"[^"]{10,}"/g) || [];

package/dist/trigger-registry.d.ts

@@ -39,7 +39,7 @@ export interface CollectionTrigger {
 export declare const TRIGGER_REGISTRY_VERSION = "1.0.0";
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from carol's spec.
+ * Covers the core ACA offload use case from agent6's spec.
  */
 export declare const TRIGGER_REGISTRY: CollectionTrigger[];
 /** Backward-compat alias — same reference as TRIGGER_REGISTRY */

package/dist/trigger-registry.js

@@ -13,7 +13,7 @@ import { createHash } from 'node:crypto';
 export const TRIGGER_REGISTRY_VERSION = '1.0.0';
 /**
  * Default trigger registry for standard ACA collections.
- * Covers the core ACA offload use case from carol's spec.
+ * Covers the core ACA offload use case from agent6's spec.
  */
 export const TRIGGER_REGISTRY = [
     {
@@ -61,7 +61,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 800,
         maxChunks: 2,
-        owner: 'alice',
+        owner: 'agent1',
         category: 'operations',
         description: 'Agent operational procedures: boot sequence, heartbeat, work queue, session startup',
     },
@@ -98,7 +98,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1500,
         maxChunks: 4,
-        owner: 'alice',
+        owner: 'agent1',
         category: 'memory',
         description: 'Decision history: past choices, previously agreed approaches, recalled context',
     },
@@ -124,7 +124,7 @@ export const TRIGGER_REGISTRY = [
         ],
         maxTokens: 1200,
         maxChunks: 3,
-        owner: 'alice',
+        owner: 'agent1',
         category: 'operations',
         description: 'Agent tooling reference: CLI commands, config paths, deployment procedures, quick reference',
     },

package/dist/types.d.ts

@@ -70,7 +70,7 @@ export type FactScope = 'agent' | 'session' | 'user';
 /**
  * Memory visibility levels:
  * - private:  Only the owning agent can read. Identity, SOUL, personal reflections.
- * - org:      Agents in the same org (e.g., alice's directors: Hank, Jack, Irene).
+ * - org:      Agents in the same org (e.g., agent1's directors: Pylon, Vigil, Plane).
  * - council:  All council seats can read.
  * - fleet:    Any agent in the fleet can read.
  */
@@ -400,7 +400,7 @@ export interface ProviderMessage {
  * to identify high-signal unprocessed messages.
  *
  * Stored in Redis (hm:{a}:s:{s}:cursor) with dual-write to SQLite for
- * durability across Redis eviction (bob Gate 2).
+ * durability across Redis eviction (agent2 Gate 2).
  */
 export interface SessionCursor {
     /** StoredMessage.id of the newest message included in the last window */

package/dist/version.d.ts

@@ -1,5 +1,5 @@
 /** Release version — matches package.json and is stamped into library.db on every startup. */
-export declare const ENGINE_VERSION = "0.8.0";
+export declare const ENGINE_VERSION = "0.8.1";
 /** Minimum Node.js version required — matches package.json engines field. */
 export declare const MIN_NODE_VERSION = "22.0.0";
 /** @deprecated No longer used — Redis was replaced with SQLite :memory: CacheLayer. */
@@ -19,15 +19,15 @@ export declare const LIBRARY_SCHEMA_VERSION_EXPORT = 19;
 /**
  * Compatibility version — the single number operators and consumers check.
  * Maps to: messages.db schema v10, library schema v19.
- * Matches ENGINE_VERSION for the 0.8.0 release.
+ * Matches ENGINE_VERSION for the 0.8.1 release.
  */
-export declare const HYPERMEM_COMPAT_VERSION = "0.8.0";
+export declare const HYPERMEM_COMPAT_VERSION = "0.8.1";
 /**
  * Schema compatibility map — machine-readable version requirements.
  * Use this to verify DB schemas match the running engine.
  */
 export declare const SCHEMA_COMPAT: {
-    readonly compatVersion: "0.8.0";
+    readonly compatVersion: "0.8.1";
     readonly mainSchema: 10;
     readonly librarySchema: 19;
 };

package/dist/version.js

@@ -1,5 +1,5 @@
 /** Release version — matches package.json and is stamped into library.db on every startup. */
-export const ENGINE_VERSION = '0.8.0';
+export const ENGINE_VERSION = '0.8.1';
 /** Minimum Node.js version required — matches package.json engines field. */
 export const MIN_NODE_VERSION = '22.0.0';
 /** @deprecated No longer used — Redis was replaced with SQLite :memory: CacheLayer. */
@@ -19,15 +19,15 @@ export const LIBRARY_SCHEMA_VERSION_EXPORT = 19;
 /**
  * Compatibility version — the single number operators and consumers check.
  * Maps to: messages.db schema v10, library schema v19.
- * Matches ENGINE_VERSION for the 0.8.0 release.
+ * Matches ENGINE_VERSION for the 0.8.1 release.
  */
-export const HYPERMEM_COMPAT_VERSION = '0.8.0';
+export const HYPERMEM_COMPAT_VERSION = '0.8.1';
 /**
  * Schema compatibility map — machine-readable version requirements.
  * Use this to verify DB schemas match the running engine.
  */
 export const SCHEMA_COMPAT = {
-    compatVersion: '0.8.0',
+    compatVersion: '0.8.1',
     mainSchema: 10,
     librarySchema: 19,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@psiclawops/hypermem",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Agent-centric memory and context composition engine for OpenClaw",
   "type": "module",
   "main": "dist/index.js",