@wipcomputer/memory-crystal 0.7.29 → 0.7.30

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-23.md

@@ -0,0 +1,48 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-25.md

@@ -0,0 +1,24 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-26.md

@@ -0,0 +1,7 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-28.md

@@ -0,0 +1,31 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-29.md

@@ -0,0 +1,28 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-4.md

@@ -0,0 +1,64 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/_trash/RELEASE-NOTES-v0-7-5.md

@@ -0,0 +1,19 @@
+# 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/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/cloud/README.md

@@ -0,0 +1,116 @@
+# Memory Crystal Cloud
+
+Remote MCP server for ChatGPT + Claude. Persistent memory across sessions on all six surfaces (macOS, iOS, web for both ChatGPT and Claude).
+
+## Architecture
+
+One MCP server, two tiers:
+
+**Tier 1 (Sovereign):** Write-only relay. Memories are encrypted (AES-256-GCM) and relayed to your home machine. The cloud cannot read your data. Search is available only on local devices.
+
+**Tier 2 (Convenience):** Cloud search enabled. A mirror of your memory database is pushed to Cloudflare D1 + Vectorize. ChatGPT/Claude can search your memories directly. Privacy trade-off is clearly disclosed.
+
+## Data Flow
+
+Every conversation turn, attachment, and explicit memory flows to the Mini:
+
+```
+ChatGPT/Claude → memory_log (every turn)     → [encrypt] → R2 relay → Mini poller → crystal.db
+                 memory_remember (explicit)   → [encrypt] → R2 relay → Mini poller → crystal.db
+                 memory_upload (files/media)   → [encrypt] → R2 relay → Mini poller → attachments/
+                 memory_forget (deprecation)   → [encrypt] → R2 relay → Mini poller → crystal.db
+```
+
+The Mini receives the same data it would have if this was a local Claude Code or OpenClaw session:
+- Full conversation JSON (raw messages, tool calls, results)
+- Inline images and file references
+- Binary attachments (images, audio, video, documents)
+- Explicit memories and deprecations
+
+## Setup
+
+```bash
+# From the memory-crystal-private root:
+
+# 1. Create D1 database
+cd cloud && npx wrangler d1 create memory-crystal-cloud
+# Copy the database_id into cloud/wrangler.toml
+
+# 2. Run migrations
+npm run cloud:db:migrate
+
+# 3. Set secrets
+cd cloud
+npx wrangler secret put CRYSTAL_RELAY_KEY     # base64, 32 bytes (same as relay)
+npx wrangler secret put OAUTH_SIGNING_SECRET  # any random string
+npx wrangler secret put OPENAI_API_KEY        # for Tier 2 embeddings
+
+# 4. Deploy
+npm run cloud:deploy
+```
+
+## Development
+
+```bash
+npm run cloud:dev          # local dev server
+npm run cloud:db:migrate   # apply D1 migrations locally
+```
+
+## Endpoints
+
+| Path | Method | Auth | Description |
+|------|--------|------|-------------|
+| `/health` | GET | No | Health check |
+| `/.well-known/oauth-protected-resource` | GET | No | OAuth resource metadata |
+| `/.well-known/oauth-authorization-server` | GET | No | OAuth server metadata |
+| `/oauth/register` | POST | No | Dynamic Client Registration |
+| `/oauth/authorize` | GET/POST | No | Authorization + consent page |
+| `/oauth/token` | POST | No | Token exchange (PKCE S256) |
+| `/mcp` | POST | Bearer | MCP JSON-RPC endpoint |
+
+## MCP Tools
+
+| Tool | Description | Annotation |
+|------|-------------|-----------|
+| `memory_search` | Search memories | readOnly |
+| `memory_remember` | Store a memory (fact, preference, event, opinion, skill) | write |
+| `memory_forget` | Deprecate a memory by ID | destructive |
+| `memory_status` | Show status, pending drops, tier info | readOnly |
+| `memory_log` | Log a conversation turn (call every exchange) | write, idempotent |
+| `memory_upload` | Upload a file attachment (image, audio, video, doc) | write |
+
+### memory_log
+
+This is the key tool for full data capture. The system prompt instructs the AI to call `memory_log` after every exchange with:
+- `role` + `content` (the text)
+- `raw_json` (the complete message object as JSON string)
+- `tool_calls` (any tools called in the turn)
+- `attachments` (inline images, files, audio)
+- `session_id` + `turn_index` (for conversation grouping)
+
+The Mini processes these through the same chunking and embedding pipeline used for local sessions.
+
+### memory_upload
+
+Handles binary files. The AI encodes the file as base64 and calls this tool. The file is encrypted (AES-256-GCM) and stored as a separate R2 object. A metadata drop references the blob. The Mini poller picks up both.
+
+Supports: images (png, jpg, webp, gif), audio (mp3, mp4, wav, ogg), video (mp4, webm, mov), documents (pdf, txt, csv).
+
+Max file size: 100MB (R2 single-put limit).
+
+## Files
+
+```
+cloud/
+  wrangler.toml           -- Cloudflare Worker config
+  migrations/
+    0001_init.sql          -- D1 schema (OAuth + users)
+  README.md               -- this file
+
+src/cloud/
+  index.ts                -- Worker entry point, request router
+  auth.ts                 -- OAuth 2.1 (DCR, authorize, token)
+  mcp.ts                  -- MCP tool definitions + handlers (6 tools)
+  relay.ts                -- Encrypt + drop to relay (Web Crypto)
+  types.ts                -- Shared types
+```

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/cloud/docs/gpt-system-instructions.md

@@ -0,0 +1,69 @@
+# Memory Crystal - System Instructions
+
+These instructions are for the Custom GPT / Claude connector that uses the Memory Crystal MCP server.
+
+---
+
+## Identity
+
+You are Memory Crystal, a persistent memory layer for your conversations. Every message in this conversation is captured and sent to the user's home machine, where it becomes part of their searchable memory.
+
+## Core Behavior
+
+### 1. Log Every Turn
+
+After EVERY user message and EVERY assistant response, call `memory_log` with:
+
+- `role`: "user" or "assistant"
+- `content`: the full message text
+- `session_id`: generate a unique ID at the start of each conversation (e.g. UUID) and reuse it for all turns
+- `turn_index`: increment from 0 for each message in the conversation
+- `model`: your model name (assistant turns only, e.g. "gpt-4o")
+
+If the user's message includes images, files, or audio:
+- Include them in the `attachments` array with `type`, `filename`, and `mime_type`
+- For small files (under 64KB), include `data_base64`
+- For larger files, note the reference in `context`
+
+If your response includes tool calls:
+- Include them in the `tool_calls` array with `tool_name`, `arguments`, and `result`
+
+### 2. Remember When Asked
+
+When the user says things like "remember this", "save this", "note that":
+- Call `memory_remember` with the specific fact/preference/observation
+- Choose the right category: fact, preference, event, opinion, skill
+
+### 3. Forget When Asked
+
+When the user says "forget that" or "remove that memory":
+- Call `memory_forget` with the memory ID
+
+### 4. Search When Asked
+
+When the user asks "do you remember...", "what did I say about...", "find my notes on...":
+- Call `memory_search` with their query
+- If in Sovereign mode, explain that search is available on their local devices
+
+### 5. Upload Files
+
+When the user shares images, documents, audio, or video:
+- Call `memory_upload` with the file data (base64 encoded)
+- Include `filename`, `mime_type`, and optional `context`
+- This ensures all media gets saved to their home machine
+
+## Important Rules
+
+- ALWAYS log both sides of the conversation. Never skip a turn.
+- The `session_id` must be consistent within a single conversation.
+- Do not mention the logging process unless the user asks about it.
+- When Memory Crystal is in Sovereign mode, search returns a guidance message. This is by design. The user's data stays on their hardware.
+- Be concise. The memory system captures everything automatically.
+
+## Status
+
+Call `memory_status` when the user asks about their memory system, connection health, or tier information.
+
+## Privacy
+
+All data is encrypted in transit (AES-256-GCM). In Sovereign mode, the cloud cannot read any data. Memories flow to the user's home machine and are deleted from the relay after pickup.

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/cloud/migrations/0001_init.sql

@@ -0,0 +1,52 @@
+-- Memory Crystal Cloud: initial schema
+-- OAuth tables for auth + user accounts
+-- Tier 1: relay-only (sovereign)
+-- Tier 2: adds chunks + memories tables (separate migration)
+
+-- ── OAuth Clients (Dynamic Client Registration) ──
+CREATE TABLE IF NOT EXISTS oauth_clients (
+  client_id TEXT PRIMARY KEY,
+  redirect_uris TEXT NOT NULL DEFAULT '[]',
+  client_name TEXT,
+  created_at TEXT NOT NULL,
+  last_used_at TEXT
+);
+
+-- ── Authorization Codes (PKCE flow) ──
+CREATE TABLE IF NOT EXISTS authorization_codes (
+  code TEXT PRIMARY KEY,
+  client_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  code_challenge TEXT NOT NULL,
+  code_challenge_method TEXT NOT NULL DEFAULT 'S256',
+  redirect_uri TEXT NOT NULL,
+  scope TEXT,
+  expires_at TEXT NOT NULL,
+  used INTEGER DEFAULT 0
+);
+
+-- ── Access Tokens ──
+CREATE TABLE IF NOT EXISTS access_tokens (
+  token_hash TEXT PRIMARY KEY,
+  client_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  scope TEXT,
+  tier TEXT NOT NULL DEFAULT 'sovereign',
+  expires_at TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+-- ── Users ──
+CREATE TABLE IF NOT EXISTS users (
+  user_id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  tier TEXT NOT NULL DEFAULT 'sovereign',
+  relay_token TEXT,
+  created_at TEXT NOT NULL
+);
+
+-- ── Indexes ──
+CREATE INDEX IF NOT EXISTS idx_auth_codes_client ON authorization_codes(client_id);
+CREATE INDEX IF NOT EXISTS idx_tokens_user ON access_tokens(user_id);
+CREATE INDEX IF NOT EXISTS idx_tokens_expires ON access_tokens(expires_at);
+CREATE INDEX IF NOT EXISTS idx_clients_last_used ON oauth_clients(last_used_at);

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/migrations/0001_init.sql

@@ -0,0 +1,51 @@
+-- Memory Crystal Cloud: OAuth + User tables
+-- Applied to D1 database: memory-crystal-cloud
+
+-- OAuth dynamic client registration
+CREATE TABLE IF NOT EXISTS oauth_clients (
+  client_id TEXT PRIMARY KEY,
+  client_secret_hash TEXT,
+  redirect_uris TEXT NOT NULL,
+  client_name TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_used_at TEXT
+);
+
+-- Authorization codes (short-lived, PKCE)
+CREATE TABLE IF NOT EXISTS authorization_codes (
+  code TEXT PRIMARY KEY,
+  client_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  code_challenge TEXT NOT NULL,
+  code_challenge_method TEXT NOT NULL DEFAULT 'S256',
+  redirect_uri TEXT NOT NULL,
+  scope TEXT,
+  expires_at TEXT NOT NULL,
+  used INTEGER DEFAULT 0,
+  FOREIGN KEY (client_id) REFERENCES oauth_clients(client_id)
+);
+
+-- Access tokens (hashed, never stored raw)
+CREATE TABLE IF NOT EXISTS access_tokens (
+  token_hash TEXT PRIMARY KEY,
+  client_id TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  scope TEXT,
+  tier TEXT NOT NULL DEFAULT 'sovereign',
+  expires_at TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (client_id) REFERENCES oauth_clients(client_id)
+);
+
+-- Users
+CREATE TABLE IF NOT EXISTS users (
+  user_id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  tier TEXT NOT NULL DEFAULT 'sovereign',
+  relay_token TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Index for token lookup
+CREATE INDEX IF NOT EXISTS idx_access_tokens_expires ON access_tokens(expires_at);
+CREATE INDEX IF NOT EXISTS idx_authorization_codes_expires ON authorization_codes(expires_at);

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/migrations/0002_cloud_storage.sql

@@ -0,0 +1,49 @@
+-- Memory Crystal Cloud: Tier 2 cloud storage tables
+-- Chunks and memories for cloud search (D1 + Vectorize)
+
+CREATE TABLE IF NOT EXISTS chunks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id TEXT NOT NULL,
+  text TEXT NOT NULL,
+  role TEXT NOT NULL DEFAULT 'user',
+  source_type TEXT NOT NULL DEFAULT 'chatgpt',
+  source_id TEXT NOT NULL DEFAULT '',
+  agent_id TEXT NOT NULL DEFAULT 'gpt',
+  token_count INTEGER DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS memories (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id TEXT NOT NULL,
+  text TEXT NOT NULL,
+  category TEXT NOT NULL DEFAULT 'fact',
+  confidence REAL NOT NULL DEFAULT 1.0,
+  source_ids TEXT DEFAULT '[]',
+  status TEXT NOT NULL DEFAULT 'active',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- FTS5 for BM25 text search
+CREATE VIRTUAL TABLE IF NOT EXISTS chunks_fts USING fts5(
+  text,
+  content='chunks',
+  content_rowid='id'
+);
+
+-- Triggers to keep FTS in sync
+CREATE TRIGGER IF NOT EXISTS chunks_ai AFTER INSERT ON chunks BEGIN
+  INSERT INTO chunks_fts(rowid, text) VALUES (new.id, new.text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS chunks_ad AFTER DELETE ON chunks BEGIN
+  INSERT INTO chunks_fts(chunks_fts, rowid, text) VALUES ('delete', old.id, old.text);
+END;
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_chunks_user ON chunks(user_id);
+CREATE INDEX IF NOT EXISTS idx_chunks_agent ON chunks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_chunks_created ON chunks(created_at);
+CREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);
+CREATE INDEX IF NOT EXISTS idx_memories_status ON memories(status);

package/.worktrees/memory-crystal-private--cc-mini-fix-home-fallback/openclaw.plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "memory-crystal",
+  "name": "Memory Crystal",
+  "description": "Sovereign memory system — search, remember, forget across all agent conversations and files.",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}