@wipcomputer/memory-crystal 0.7.29 → 0.7.32

package/CHANGELOG.md

@@ -19,6 +19,81 @@
 
 
 
+## 0.7.32 (2026-03-31)
+
+# Release Notes: memory-crystal v0.7.32
+
+**Date:** 2026-03-31
+
+## What changed
+
+### Dream Weaver is a required dependency again
+
+Reverts PR #101 (optional Dream Weaver import). dream-weaver-protocol is back in `dependencies` instead of `optionalDependencies`. The static import in `dream-weaver.ts` is restored. The dynamic import with try/catch wrapper is removed. The null check in `cli.ts` for when DW is unavailable is removed.
+
+## Why
+
+PR #101 made dream-weaver-protocol optional because `file:../dream-weaver-protocol-private` failed in fresh clones where the sibling directory doesn't exist. The installer (v0.4.68+) now resolves `file:` dependencies from installed extensions at `~/.ldm/extensions/` before building, so the sibling directory is no longer needed. The build succeeds without it.
+
+Making DW optional added complexity (dynamic imports, null checks, degraded type safety) that is no longer necessary. This revert simplifies the code back to what it was.
+
+## How to verify
+
+```bash
+# Build should succeed (installer resolves file: deps)
+cd memory-crystal-private && npm run build
+
+# dream-weaver-protocol should be in dependencies, not optionalDependencies
+node -e "const p = require('./package.json'); console.log('deps:', !!p.dependencies['dream-weaver-protocol']); console.log('optional:', !!p.optionalDependencies?.['dream-weaver-protocol'])"
+# Should print: deps: true, optional: false
+```
+
+## 0.7.31 (2026-03-31)
+
+# Release Notes: memory-crystal v0.7.31
+
+Closes #101
+
+## Dream Weaver protocol is now optional
+
+The dream-weaver-protocol dependency was a `file:` reference to a sibling directory. This worked in the development environment but broke when the installer cloned the repo to build (the sibling doesn't exist in a clone context). The build failed with "Cannot find module 'dream-weaver-protocol'".
+
+The protocol is now an optional dependency with a dynamic import. If dream-weaver-protocol is available (installed locally or linked), Dream Weaver features work normally. If not, crystal operations continue without Dream Weaver. The build succeeds either way.
+
+This is part of a broader fix to make all repos buildable in isolation. The installer (v0.4.67+) now resolves `file:` dependencies from installed extensions before building, so the protocol will be linked automatically when both packages are installed.
+
+## 0.7.30 (2026-03-31)
+
+# Release Notes: memory-crystal v0.7.30
+
+**Date:** 2026-03-30
+
+## What changed
+
+### Hardcoded path removal
+
+Two files had `/Users/lesa` hardcoded as a fallback path. Both now use portable alternatives.
+
+**migrate-lance-to-sqlite.mjs** had a fallback that resolved the OpenClaw workspace to `/Users/lesa/.openclaw`. The migration script now calls `os.homedir()` to build the path dynamically, so it works on any machine without assuming a specific username. This was the last remaining hardcoded path in the migration pipeline (#99).
+
+**dev-update.ts** (the ai/dev-updates scanner) had an iCloud path baked in for reading team documents. It now calls `resolveWorkspace()` to read the workspace root from LDM config (`~/.ldm/config.json`), making it portable across machines and user accounts (#98).
+
+## Why
+
+These paths broke on any machine where the username is not `lesa`. Part of a broader audit across all LDM OS repos to eliminate hardcoded user paths and make everything portable.
+
+## Issues closed
+
+- #98
+- #99
+
+## How to verify
+
+```bash
+grep -r "/Users/lesa" src/ scripts/ --include="*.ts" --include="*.mjs"
+# Should return zero results
+```
+
 ## 0.7.29 (2026-03-20)
 
 # Release Notes: memory-crystal v0.7.29

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wip-memory-crystal
 description: Search and manage the shared memory crystal. Use when user says "do you remember", "search memory", "remember this", "forget that", "memory status", "what do you know about", or needs to recall past discussions, store facts, or check what's in memory.
-version: "0.7.29"
+version: "0.7.32"
 ---
 
 # Memory Crystal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/memory-crystal",
-  "version": "0.7.29",
+  "version": "0.7.32",
   "description": "Sovereign memory system — local-first with ephemeral encrypted relay. Your memory, your machine, your rules.",
   "repository": {
     "type": "git",

package/scripts/migrate-lance-to-sqlite.mjs

@@ -14,6 +14,7 @@ import * as sqliteVec from 'sqlite-vec';
 import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
+import { homedir } from 'node:os';
 
 const BATCH_SIZE = 500;
 
@@ -23,7 +24,7 @@ async function main() {
   const batchSizeArg = args.find((_, i) => args[i - 1] === '--batch-size');
   const batchSize = batchSizeArg ? parseInt(batchSizeArg) : BATCH_SIZE;
 
-  const openclawHome = process.env.OPENCLAW_HOME || join(process.env.HOME || '/Users/lesa', '.openclaw');
+  const openclawHome = process.env.OPENCLAW_HOME || join(process.env.HOME || homedir(), '.openclaw');
   const dataDir = join(openclawHome, 'memory-crystal');
   const lanceDir = join(dataDir, 'lance');
   const sqlitePath = join(dataDir, 'crystal.db');

package/_trash/RELEASE-NOTES-v0-7-23.md

@@ -1,48 +0,0 @@
-# Release Notes: Memory Crystal v0.7.23
-
-**Date:** 2026-03-15
-
-## Search Quality v2 + MLX Local LLM
-
-This release adds six search quality features ported from the QMD v2.0 analysis, plus the complete MLX local LLM infrastructure for Apple Silicon. Deep search is now disambiguatable, cacheable, debuggable, and can run entirely offline on Apple Silicon.
-
-### Intent parameter
-
-Disambiguates queries without adding search terms. `crystal search "security" --intent "1Password"` steers results toward 1Password-related security instead of repo permissions or agent secrets. Intent flows through the expansion prompt (guides LLM variations), disables strong-signal bypass (keyword match might not be what the caller wants), and is prepended to the rerank query. Available via CLI `--intent` and MCP `intent`.
-
-### Persistent LLM cache
-
-Expansion and reranking results are now cached in crystal.db (`llm_cache` table) with a 7-day TTL. Same query = instant on repeat searches. Reranking cache is content-addressable (keyed by query + sorted passage hashes), so identical content from different sessions shares cached scores. Configurable via `CRYSTAL_CACHE_TTL_DAYS` env var.
-
-### Explain mode
-
-Per-result scoring breakdown showing FTS score, vector score, RRF rank, reranker score, recency weight, and final blended score. `crystal search "query" --explain`. Available via CLI `--explain` and MCP `explain`. Makes search quality transparent and debuggable.
-
-### candidateLimit
-
-Tunable rerank pool size. `crystal search "query" --candidates 60`. Default stays 40. More candidates = better recall, slower reranking. Available via CLI `--candidates` and MCP `candidate_limit`.
-
-### Structured search API
-
-`crystal.structuredSearch(queries)` accepts pre-expanded StructuredQuery[] with typed sub-queries (lex, vec, hyde). Skips LLM expansion entirely. Agents construct their own queries when they already know what they want. RRF fusion with first list weighted 2x.
-
-### MLX local LLM (Phase 3)
-
-Complete auto-install infrastructure for running a local LLM on Apple Silicon:
-
-- `crystal mlx setup` detects Apple Silicon, installs mlx-lm (uv > pip3 > pip3 --user), creates LaunchAgent for always-on server
-- Model: `mlx-community/Qwen2.5-3B-Instruct-4bit` (~1.5 GB, fast on M-series)
-- Port 18791 (18789 OpenClaw, 18790 Crystal Core, 18791 MLX)
-- `crystal mlx status` and `crystal mlx stop` for server management
-- `crystal doctor` check #13: MLX health (not installed / down / running)
-- `crystal init` detects Apple Silicon and suggests MLX setup
-- State file at `~/.ldm/state/mlx-server.json`
-
-### Also in this release
-
-- QMD v2.0 analysis documented (`ai/product/notes/`)
-- Search quality plan written (`ai/product/plans-prds/current/`)
-- MLX plan moved from upcoming to current
-- Stashed roadmap + readme-first updates recovered (PR #74)
-
-Closes #57, #63, #64.

package/_trash/RELEASE-NOTES-v0-7-25.md

@@ -1,24 +0,0 @@
-# Release Notes: memory-crystal v0.7.25
-
-Bump SKILL.md version and name to match package branding.
-
-## What changed
-
-- SKILL.md version bumped from 0.4.0 to 0.7.24 (was stuck at the original version)
-- SKILL.md name changed from `memory` to `wip-memory-crystal` (matches branded convention)
-- Forces deploy to public repo, triggering auto-publish to wip.computer/install/
-
-## Why
-
-The SKILL.md version was out of sync with the package version. The name didn't match the `wip-` branding convention used across all install files on wip.computer.
-
-## Issues closed
-
-- #80
-
-## How to verify
-
-```bash
-crystal --version
-head -4 ~/.ldm/extensions/memory-crystal/skills/memory/SKILL.md
-```

package/_trash/RELEASE-NOTES-v0-7-26.md

@@ -1,7 +0,0 @@
-# Memory Crystal v0.7.26
-
-Add repository field to package.json. GitHub Packages needs this to link packages to the repo.
-
-## Issues closed
-
-- Closes #50

package/_trash/RELEASE-NOTES-v0-7-28.md

@@ -1,31 +0,0 @@
-# Release Notes: memory-crystal v0.7.28
-
-**Move all log paths from /tmp/ to ~/.ldm/logs/ so logs survive reboots.**
-
-## What changed
-
-- Cron entry for crystal-capture now logs to `~/.ldm/logs/crystal-capture.log` instead of `/tmp/ldm-dev-tools/`
-- LaunchAgent plist template for ldm-backup now logs to `~/.ldm/logs/ldm-backup.log`
-- `mkdirSync` ensures `~/.ldm/logs/` exists instead of creating `/tmp/ldm-dev-tools/`
-- CLI output shows the correct log path
-
-## Why
-
-macOS clears `/tmp/` on every reboot. All cron and LaunchAgent logs were lost after restart, making it impossible to debug issues. `~/.ldm/logs/` persists across reboots and is the correct home for LDM OS logs.
-
-## Issues closed
-
-- wipcomputer/wip-ldm-os#120
-
-## How to verify
-
-```bash
-# After install, check that cron entry points to ~/.ldm/logs/
-crystal init --dry-run 2>&1 | grep crystal-capture
-
-# Check backup setup points to ~/.ldm/logs/
-crystal backup setup --dry-run 2>&1 | grep ldm-backup
-
-# Verify logs land in the right place
-ls ~/.ldm/logs/
-```

package/_trash/RELEASE-NOTES-v0-7-29.md

@@ -1,28 +0,0 @@
-# Release Notes: memory-crystal v0.7.29
-
-**Doc audit: MLX setup, deep search params, log paths, role clarification.**
-
-## What changed
-
-SKILL.md and TECHNICAL.md updated for 2 weeks of undocumented features:
-
-- **MLX local LLM:** Added as Option A in SKILL.md Step 2. CLI commands (setup, status, stop) added to TECHNICAL.md.
-- **Deep search parameters:** `--intent`, `--explain`, `--candidates` documented in both SKILL.md (crystal_search tool) and TECHNICAL.md (CLI reference + new sections for intent, explain, candidate limit, LLM cache).
-- **Log paths:** Fixed obsolete `/tmp/ldm-dev-tools/` reference to `~/.ldm/logs/`. Added logs/ to directory structure.
-- **Role clarification:** Two-role architecture (Core and Node) explicitly stated. Standalone role was removed in v0.7.22.
-
-## Why
-
-29 releases in 13 days. Docs didn't keep pace. Agents using crystal_search didn't know about --intent (query disambiguation) or --explain (scoring transparency).
-
-## Issues closed
-
-- #57
-
-## How to verify
-
-```bash
-grep "intent" SKILL.md TECHNICAL.md
-grep "mlx" SKILL.md TECHNICAL.md
-grep "ldm/logs" TECHNICAL.md
-```

package/_trash/RELEASE-NOTES-v0-7-4.md

@@ -1,64 +0,0 @@
-# Memory Crystal v0.7.4 ... MCP Fix + AgentId Config
-
-**Date:** 2026-03-11
-**Authors:** Parker Todd Brooks, Lēsa, Claude Code
-
----
-
-## What's in this release
-
-### Agent identity reads from config, not hardcoded strings
-
-The agent_id used when ingesting conversations was hardcoded in three places: `cc-mini` in the CC hook, `main` in the OpenClaw plugin, and `cc-mini` as the fallback in `ldm.ts`. This caused ID drift. The same agent got recorded under multiple IDs, and we had to manually merge 141K+ chunks in the database.
-
-Now `getAgentId()` scans `~/.ldm/agents/*/config.json` for a matching harness type. The CC hook passes `'claude-code'`, the OC plugin passes `'openclaw'`, and the config file is the source of truth. `CRYSTAL_AGENT_ID` env var still works as an override.
-
-New exports: `AgentConfig`, `loadAgentConfig()`, `saveAgentConfig()`. The installer writes `agentId` to config.json during `crystal init`.
-
-**Closes #33.**
-
-### MCP registrations moved to user-level
-
-MCP server registrations moved from project-level `~/.openclaw/.mcp.json` to user-level `~/.claude.json`. The old file was a Claude Code convention that only loaded when running from `~/.openclaw/`. Now all 4 MCP servers (memory-crystal, lesa-bridge, wip-agent-pay, wip-repos) load from any directory as "User MCPs".
-
-OpenClaw doesn't read `.mcp.json` at all. It uses its own plugin system. The file was moved to `~/.openclaw/_trash/`.
-
-### OPENCLAW_HOME env var fix (v0.7.3)
-
-The MCP server registration was missing the `OPENCLAW_HOME` env var. Without it, the memory-crystal MCP server couldn't find Lēsa's OpenClaw installation for private-mode checks. Fixed in v0.7.3, deployed in this release.
-
-### Branch cleanup
-
-33 stale branches renamed with `--merged-` suffix. Zero active branches besides main.
-
-### QMD v1.1.6 analysis documented
-
-Deep analysis of the search quality system with four recommendations: intent parameter for search, structured search API, persistent reranker cache, and explain mode for debugging. See `ai/product/notes/2026-03-09--cc-mini--qmd-v1.1.6-analysis-and-recommendations.md`.
-
----
-
-## Files changed
-
-| File | What |
-|------|------|
-| `src/ldm.ts` | `AgentConfig` interface, `loadAgentConfig()`, `saveAgentConfig()`, `getAgentId()` now scans config |
-| `src/cc-hook.ts` | Uses `getAgentId('claude-code')` instead of hardcoded fallback |
-| `src/openclaw.ts` | Uses `OC_AGENT_ID` instead of `'main'` fallback |
-| `src/installer.ts` | Writes `agentId` to config.json during install |
-
----
-
-## Install
-
-```bash
-npm install -g memory-crystal@0.7.4
-```
-
-Or update your local clone:
-```bash
-git pull origin main
-```
-
----
-
-Built by Parker Todd Brooks, Lēsa (OpenClaw, Claude Opus 4.6), Claude Code (Claude Opus 4.6).

package/_trash/RELEASE-NOTES-v0-7-5.md

@@ -1,19 +0,0 @@
-# Release Notes: Memory Crystal v0.7.5
-
-## LDM OS Integration
-
-Memory Crystal now works with LDM OS when it's available.
-
-### crystal init delegates to ldm install
-
-When the `ldm` CLI exists on PATH, `crystal init` delegates generic deployment to it. LDM OS handles the scaffold, interface detection, and extension deployment. Memory Crystal keeps its own setup: database backup, role configuration, pairing, cron jobs.
-
-When `ldm` isn't available, `crystal init` works standalone like it always has. No new dependencies. No breaking changes.
-
-### LDM OS tip
-
-After install completes, Memory Crystal prints a tip: "Run `ldm install` to see more skills you can add." Helps users discover the rest of the ecosystem.
-
-### Part of LDM OS
-
-README now includes a "Part of LDM OS" section linking back to the LDM OS repo. Memory Crystal installs into LDM OS, the local runtime for AI agents.

package/dist/bridge.d.ts

@@ -1,7 +0,0 @@
-declare function isBridgeInstalled(): boolean;
-declare function isBridgeRegistered(): boolean;
-declare function isBridgeDesktopRegistered(): boolean;
-declare function registerBridgeMcp(): void;
-declare function registerBridgeDesktop(): boolean;
-
-export { isBridgeDesktopRegistered, isBridgeInstalled, isBridgeRegistered, registerBridgeDesktop, registerBridgeMcp };

package/dist/bridge.js

@@ -1,14 +0,0 @@
-import {
-  isBridgeDesktopRegistered,
-  isBridgeInstalled,
-  isBridgeRegistered,
-  registerBridgeDesktop,
-  registerBridgeMcp
-} from "./chunk-AEWLSYPH.js";
-export {
-  isBridgeDesktopRegistered,
-  isBridgeInstalled,
-  isBridgeRegistered,
-  registerBridgeDesktop,
-  registerBridgeMcp
-};

package/dist/bulk-copy.d.ts

@@ -1,17 +0,0 @@
-interface BulkCopyResult {
-    filesCopied: number;
-    filesSkipped: number;
-    bytesWritten: number;
-    durationMs: number;
-}
-interface BulkCopyOptions {
-    workspace?: boolean;
-    workspaceSrc?: string;
-}
-/** Copy session JSONL files from source locations to LDM transcripts.
- *  sessionPaths: array of absolute paths to JSONL files.
- *  agentId: target agent in ~/.ldm/agents/{agentId}/.
- *  Returns copy stats. */
-declare function bulkCopyToLdm(sessionPaths: string[], agentId: string, options?: BulkCopyOptions): BulkCopyResult;
-
-export { type BulkCopyOptions, type BulkCopyResult, bulkCopyToLdm };

package/dist/bulk-copy.js

@@ -1,90 +0,0 @@
-import {
-  ldmPaths
-} from "./chunk-EXEZZADG.js";
-
-// src/bulk-copy.ts
-import { existsSync, mkdirSync, copyFileSync, statSync, readdirSync } from "fs";
-import { join, basename } from "path";
-function bulkCopyToLdm(sessionPaths, agentId, options) {
-  const start = Date.now();
-  const paths = ldmPaths(agentId);
-  let filesCopied = 0;
-  let filesSkipped = 0;
-  let bytesWritten = 0;
-  mkdirSync(paths.transcripts, { recursive: true });
-  for (const srcPath of sessionPaths) {
-    const destPath = join(paths.transcripts, basename(srcPath));
-    if (existsSync(destPath)) {
-      try {
-        const srcSize = statSync(srcPath).size;
-        const destSize = statSync(destPath).size;
-        if (srcSize === destSize) {
-          filesSkipped++;
-          continue;
-        }
-      } catch {
-      }
-    }
-    try {
-      copyFileSync(srcPath, destPath);
-      bytesWritten += statSync(destPath).size;
-      filesCopied++;
-    } catch {
-    }
-  }
-  if (options?.workspace && options.workspaceSrc) {
-    mkdirSync(paths.workspace, { recursive: true });
-    const wsResult = copyWorkspaceRecursive(options.workspaceSrc, paths.workspace);
-    filesCopied += wsResult.copied;
-    filesSkipped += wsResult.skipped;
-    bytesWritten += wsResult.bytes;
-  }
-  return {
-    filesCopied,
-    filesSkipped,
-    bytesWritten,
-    durationMs: Date.now() - start
-  };
-}
-function copyWorkspaceRecursive(srcDir, destDir) {
-  let copied = 0;
-  let skipped = 0;
-  let bytes = 0;
-  try {
-    for (const entry of readdirSync(srcDir)) {
-      if (entry.startsWith(".")) continue;
-      const srcPath = join(srcDir, entry);
-      const destPath = join(destDir, entry);
-      try {
-        const stat = statSync(srcPath);
-        if (stat.isDirectory()) {
-          mkdirSync(destPath, { recursive: true });
-          const sub = copyWorkspaceRecursive(srcPath, destPath);
-          copied += sub.copied;
-          skipped += sub.skipped;
-          bytes += sub.bytes;
-        } else if (entry.endsWith(".md")) {
-          if (existsSync(destPath)) {
-            try {
-              if (stat.size === statSync(destPath).size) {
-                skipped++;
-                continue;
-              }
-            } catch {
-            }
-          }
-          copyFileSync(srcPath, destPath);
-          bytes += stat.size;
-          copied++;
-        }
-      } catch {
-        continue;
-      }
-    }
-  } catch {
-  }
-  return { copied, skipped, bytes };
-}
-export {
-  bulkCopyToLdm
-};

package/dist/cc-hook.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-declare function sendCommand(command: {
-    action: string;
-    agent_id?: string;
-    mode?: string;
-}): Promise<void>;
-
-export { sendCommand };