claude_memory 0.8.0 → 0.9.1

data/.claude-plugin/scripts/serve-mcp.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Wrapper script for claude-memory MCP server.
+# Used by the Claude Code plugin to launch the MCP server.
+# Falls back to a JSON-RPC error if the gem is not installed.
+
+set -euo pipefail
+
+if command -v claude-memory > /dev/null 2>&1; then
+  exec claude-memory serve-mcp
+else
+  # Return a JSON-RPC error so Claude Code surfaces it to the user
+  echo '{"jsonrpc":"2.0","id":1,"error":{"code":-32603,"message":"claude-memory gem not found. Install with: gem install claude_memory"}}'
+  exit 1
+fi

data/.ruby-version

@@ -1 +1 @@
-4.0.1
+4.0.2

data/CHANGELOG.md

@@ -4,6 +4,53 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-04-16
+
+### Fixed
+
+- MCP server now conforms to JSON-RPC 2.0: notifications (messages without an `id`) never receive a response. Previously, `notifications/initialized` — which Claude Code sends after every handshake — triggered a spurious `Method not found` error frame, causing strict MCP clients to mark the server failed on `/mcp` reconnect after the initial connection.
+
+## [0.9.0] - 2026-04-16
+
+### Added
+
+- `claude-memory reject <id_or_docid>` command + `memory.reject_fact` MCP tool — explicitly mark distiller hallucinations as wrong, closing associated conflicts
+- `claude-memory restore --predicate NAME` command — recover facts that were superseded by obsolete single-value predicate classifications (uses Jaccard-based token overlap to distinguish bug-caused supersession from real corrections)
+- MCP tool-call telemetry: `mcp_tool_calls` table records every tool invocation with timing, result counts, and error classification. `claude-memory stats --tools [--since DAYS]` for usage reporting. 90-day retention via Sweep
+- `CLAUDE_CONFIG_DIR` env var support for non-standard Claude Code config locations
+- Predicate synonym canonicalization at insert time (`has_convention` → `convention`, `primary_language` → `uses_language`). Prevents drift from fragmenting the knowledge graph
+- Novel predicate warnings at insert time — logged when the Resolver encounters a predicate not in PredicatePolicy
+- NullDistiller now emits `uses_language` facts for detected language entities
+- Proactive memory recall guidance in MCP instructions — Claude now checks conventions before code generation, architecture before explanations, decisions before refactoring
+- YARD documentation across 13 core source files (+473 lines)
+
+### Changed
+
+- **`uses_framework` reclassified as multi-value** — real projects use multiple frameworks (Rails + Turbo + Tailwind). The prior single-value classification silently superseded valid facts in production databases. Run `claude-memory restore --predicate uses_framework` to recover affected facts
+- `PredicatePolicy` is now the single source of truth for predicate vocabulary, snapshot section mapping, synonym canonicalization, and LLM guidance. `tool_definitions.rb`, `publish.rb`, and `distill-transcripts.md` all derive from the policy
+- Predicate vocabulary curated from 13 → 8 based on multi-project usage data. Removed predicates (`preference`, `workflow`, `dependency`, `testing_strategy`, `tool_usage`, `ci_platform`, `primary_language`) had zero facts across all surveyed databases. They still work via DEFAULT_POLICY but are no longer advertised to the LLM
+- `Registry::COMMANDS` stores `{class:, description:}` entries with direct class references instead of string class names
+- Plugin and gem descriptions rewritten from mechanism-focused to outcome-focused
+
+### Fixed
+
+- **`StatsCommand` broken in production** — used `Sequel.sqlite` which requires the unlisted `sqlite3` gem. Now uses the extralite adapter consistently
+- Missing `embeddings` command in shell completion output
+
+### Upgrade Notes
+
+**Schema**: v12 → v14 (two automatic migrations). Migration 013 adds `mcp_tool_calls` table. Migration 014 canonicalizes stale predicate names (`has_convention` → `convention`, `primary_language` → `uses_language`) in existing facts.
+
+**Action required for `uses_framework` recovery**: If your project uses multiple frameworks (Rails + Turbo + Tailwind, etc.), past sessions may have superseded valid facts. After upgrading, run:
+
+```bash
+claude-memory restore --predicate uses_framework --dry-run   # preview
+claude-memory restore --predicate uses_framework              # restore
+claude-memory restore --predicate uses_framework --scope global  # if needed for global DB
+```
+
+**Pruned predicates still work**: `preference`, `workflow`, `dependency`, `testing_strategy`, `tool_usage`, `ci_platform` fall through to the default multi-value policy. Existing facts with these predicates are unaffected. They'll appear as "novel" in `memory.stats` but function normally.
+
 ## [0.8.0] - 2026-03-30
 
 ### Added

data/CLAUDE.md

@@ -15,6 +15,12 @@ ClaudeMemory is a Ruby gem that provides long-term, self-managed memory for Clau
 
 **Check memory before exploring code.** Use `memory.recall`, `memory.decisions`, `memory.architecture`, or `memory.conventions` to find existing knowledge before reading files.
 
+### Git Usage & Best Practices
+
+- Before each commit, apply the quality-review skill
+- Iteratively commit related changes with their tests
+
+
 ## Development Commands
 
 ### Setup
@@ -157,7 +163,7 @@ New MCP tools `memory.undistilled` and `memory.mark_distilled` support the pipel
   - Each command is a separate class (HelpCommand, DoctorCommand, etc.)
   - All commands inherit from BaseCommand
   - Dependency injection for I/O (stdout, stderr, stdin)
-  - 23 commands total, each focused on single responsibility
+  - 28 commands total, each focused on single responsibility
 
 - **`Configuration`**: Centralized ENV access (`configuration.rb`)
   - Single source of truth for paths and environment variables
@@ -166,7 +172,7 @@ New MCP tools `memory.undistilled` and `memory.mark_distilled` support the pipel
 #### Core Domain Layer
 
 - **`Domain`**: Rich domain models with business logic (`domain/`)
-  - `Fact`: Facts with validation, status checking (active?, superseded?)
+  - `Fact`: Facts with validation, status checking (active?, superseded?, rejected?)
   - `Entity`: Entities with type checking (database?, framework?)
   - `Provenance`: Evidence with strength checking (stated?, inferred?)
   - `Conflict`: Conflicts with status tracking (open?, resolved?)
@@ -182,7 +188,7 @@ New MCP tools `memory.undistilled` and `memory.mark_distilled` support the pipel
 - **`Store`**: SQLite database access via Sequel (`store/`)
   - `SQLiteStore`: Database operations
   - `StoreManager`: Dual-database connection manager
-  - Schema includes: content_items, entities, facts, provenance, fact_links, conflicts
+  - Schema includes: content_items, entities, facts, provenance, fact_links, conflicts, mcp_tool_calls
   - Transaction safety for multi-step operations
 
 - **`Infrastructure`**: I/O abstractions (`infrastructure/`)
@@ -205,7 +211,7 @@ New MCP tools `memory.undistilled` and `memory.mark_distilled` support the pipel
 
 - **`Resolve`**: Truth maintenance and conflict resolution (`resolve/`)
   - Determines equivalence, supersession, or conflicts
-  - PredicatePolicy controls single-value vs multi-value predicates
+  - PredicatePolicy: single source of truth for predicate vocabulary, cardinality, section mapping, and synonym canonicalization
   - Transaction safety for atomic operations
 
 - **`Recall`**: Query interface for facts (`recall.rb`)
@@ -220,7 +226,8 @@ New MCP tools `memory.undistilled` and `memory.mark_distilled` support the pipel
   - Modes: shared (repo), local (uncommitted), home (user directory)
 
 - **`MCP`**: Model Context Protocol server and tools (`mcp/`)
-  - Exposes memory tools to Claude Code (23 tools total)
+  - Exposes memory tools to Claude Code (24 tools total)
+  - `Telemetry`: Records tool invocations to `mcp_tool_calls` table for usage stats
   - Dual content/structuredContent responses with compact mode
 
 - **`Hook`**: Hook entrypoint handlers (`hook/`)
@@ -238,6 +245,7 @@ Key tables (defined in `sqlite_store.rb`):
 - `provenance`: Links facts to source content_items
 - `fact_links`: Supersession and conflict relationships
 - `conflicts`: Open contradictions
+- `mcp_tool_calls`: MCP server tool invocation telemetry (schema v13)
 
 Facts include:
 - `scope`: "global" or "project" (determines applicability)
@@ -290,28 +298,34 @@ end
 
 ### Adding a New MCP Tool
 
-1. Add tool definition to `MCP::Tools::TOOLS` hash
-2. Implement handler in `MCP::Server#handle_tool_call`
-3. Ensure tool queries appropriate database(s) via StoreManager
-4. Add tests in `spec/claude_memory/mcp/`
+1. Add tool definition to `ToolDefinitions.all` array in `lib/claude_memory/mcp/tool_definitions.rb`
+2. Add `when` clause in `Tools#call` dispatch in `lib/claude_memory/mcp/tools.rb`
+3. Implement handler method in the appropriate handler module in `mcp/handlers/`
+4. Ensure tool queries appropriate database(s) via StoreManager
+5. Add tests in `spec/claude_memory/mcp/`
 
 ### Modifying Database Schema
 
-1. Increment `SCHEMA_VERSION` in `sqlite_store.rb`
-2. Add migration method (e.g., `migrate_to_v3!`)
-3. Call migration in `run_migrations!`
+1. Increment `SCHEMA_VERSION` in `store/schema_manager.rb`
+2. Create a new Sequel migration file in `db/migrations/` (e.g., `013_add_mcp_tool_calls.rb`)
+3. Sequel::Migrator runs migrations automatically in `ensure_schema!`
 4. Test migration on existing database files
 5. Update documentation if schema changes affect external interfaces
 
-### Adding a New Predicate Policy
+### Adding a New Predicate
+
+Edit `PredicatePolicy::POLICIES` in `lib/claude_memory/resolve/predicate_policy.rb` — this is the single source of truth. Choose cardinality:
+
+- **single** (exclusive: true): Facts supersede or conflict (e.g., `uses_database` — one per project)
+- **multi** (exclusive: false): Facts accumulate (e.g., `convention`, `uses_framework`)
 
-Single-value predicates (like "uses_database") supersede old values. Multi-value predicates (like "depends_on") accumulate. Modify `PredicatePolicy.single?` to adjust behavior.
+Also update `SECTION_MAP` if the predicate should appear in a specific snapshot section (`:decisions`, `:conventions`, `:constraints`). The `ToolDefinitions` predicate list updates automatically via `PredicatePolicy.known_predicates`. Add entries to `SYNONYMS` if the distiller might emit variant names.
 
 ## Important Files
 
 - `lib/claude_memory.rb`: Main module, requires, database path helpers
 - `lib/claude_memory/cli.rb`: Thin command router (41 lines)
-- `lib/claude_memory/commands/`: Individual command classes (23 commands)
+- `lib/claude_memory/commands/`: Individual command classes (28 commands)
 - `lib/claude_memory/configuration.rb`: Centralized configuration and ENV access
 - `lib/claude_memory/domain/`: Domain models (Fact, Entity, Provenance, Conflict)
 - `lib/claude_memory/core/`: Value objects and null objects
@@ -326,12 +340,12 @@ Single-value predicates (like "uses_database") supersede old values. Multi-value
 
 The gem includes an MCP server (`claude-memory serve-mcp`) that exposes memory operations as tools. Configuration should be in `.mcp.json` at project root.
 
-Available MCP tools (23 total):
+Available MCP tools (24 total):
 - **Query & Recall**: `memory.recall`, `memory.recall_index`, `memory.recall_details`, `memory.recall_semantic`, `memory.search_concepts`
 - **Provenance**: `memory.explain`, `memory.fact_graph`
 - **Shortcuts**: `memory.decisions`, `memory.conventions`, `memory.architecture`
 - **Context**: `memory.facts_by_tool`, `memory.facts_by_context`
-- **Management**: `memory.promote`, `memory.store_extraction`
+- **Management**: `memory.promote`, `memory.reject_fact`, `memory.store_extraction`
 - **Distillation**: `memory.undistilled`, `memory.mark_distilled`
 - **Monitoring**: `memory.status`, `memory.stats`, `memory.changes`, `memory.conflicts`
 - **Maintenance**: `memory.sweep_now`

data/README.md

@@ -83,6 +83,41 @@ Claude: "Based on my memory, you're using Rails with PostgreSQL..."
 👉 **[See Getting Started Guide →](docs/GETTING_STARTED.md)**
 👉 **[View Example Conversations →](docs/EXAMPLES.md)**
 
+## Why It Matters — Real A/B Test Results
+
+We tested identical prompts with and without ClaudeMemory to measure the actual impact. Here's what we found:
+
+### Architecture Recall Without File Traversal
+
+> **Prompt:** "Explain the conflict detection and resolution system. Answer from knowledge only — do not read any files."
+
+| | Without Memory | With Memory |
+|---|---|---|
+| **Response** | 16 lines: "I don't know this codebase — let me read the files" | 76 lines: correct 4-role PredicatePolicy explanation, resolution pipeline, specific examples |
+| **Outcome** | Honest refusal — zero architectural understanding | Deep understanding without touching the filesystem |
+
+### Correct File Paths vs Hallucinated Guesses
+
+> **Prompt:** "I want to add a new predicate. Walk me through every file I need to update."
+
+| | Without Memory | With Memory |
+|---|---|---|
+| **Response** | 6 steps targeting 3 **non-existent files** (`predicate.rb`, `predicate_synonyms.rb`, `json_schema.rb`) | 8 steps, all targeting **real files** with correct paths |
+| **Outcome** | Plausible but wrong — would waste developer time | Actionable, correct, references actual commits |
+
+### Cross-Project Preferences
+
+> **Prompt:** "What are my standard development environment preferences across all my projects?"
+
+| | Without Memory | With Memory |
+|---|---|---|
+| **Response** | "I don't have stored knowledge of your preferences" | Lists 7 real preferences: iTerm2, tmux, VS Code, PostgreSQL, Redis, Docker |
+| **Outcome** | Blank slate every session | Personalized from day one |
+
+### When Memory Doesn't Help
+
+File-searchable questions ("what version is this?") and one-shot code generation without explicit recall don't benefit — `grep` is equally effective. Memory shines when the answer **isn't in any single file**: architecture spanning dozens of classes, conventions from past sessions, decisions with rationale, and user preferences.
+
 ## How It Works
 
 1. **You chat with Claude** - Tell it about your project

data/db/migrations/013_add_mcp_tool_calls.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Migration v13: Add mcp_tool_calls telemetry table
+# Records every MCP server tool invocation for usage stats and ROI tracking.
+# Distinct from `tool_calls` (v3), which stores Claude Code tool observations
+# extracted from transcripts.
+Sequel.migration do
+  up do
+    create_table?(:mcp_tool_calls) do
+      primary_key :id
+      String :tool_name, null: false
+      String :called_at, null: false
+      Integer :duration_ms, null: false
+      Integer :result_count
+      String :scope
+      String :error_class
+    end
+
+    run "CREATE INDEX IF NOT EXISTS idx_mcp_tool_calls_name_time ON mcp_tool_calls(tool_name, called_at)"
+    run "CREATE INDEX IF NOT EXISTS idx_mcp_tool_calls_called_at ON mcp_tool_calls(called_at)"
+  end
+
+  down do
+    drop_table?(:mcp_tool_calls)
+  end
+end

data/db/migrations/014_canonicalize_predicates.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Migration v14: Canonicalize stale predicate names in existing facts.
+#
+# The predicate vocabulary was curated in 0.9.0 — synonym canonicalization
+# now runs at insert time (Resolver), but existing facts with stale
+# predicate names need a one-time rewrite so they appear in the correct
+# snapshot sections and query results.
+#
+# This migration applies PredicatePolicy::SYNONYMS to all active facts.
+# Reversible: the down migration is a no-op because we can't know the
+# original predicate name after rewriting.
+Sequel.migration do
+  up do
+    # Inline the synonym map so the migration is self-contained and
+    # doesn't break if PredicatePolicy::SYNONYMS changes later.
+    synonyms = {
+      "has_convention" => "convention",
+      "primary_language" => "uses_language"
+    }
+
+    synonyms.each do |from, to|
+      self[:facts].where(predicate: from).update(predicate: to)
+    end
+  end
+
+  down do
+    # No-op: can't reverse a predicate rename without storing the original.
+  end
+end

data/docs/improvements.md

@@ -1,14 +1,14 @@
 # Improvements to Consider
 
-*Updated: 2026-03-24 - Implemented automatic distillation pipeline: NullDistiller wired into ingest hooks (Stop/SessionStart/PreCompact/SessionEnd/TaskCompleted/TeammateIdle), context hook injection for LLM extraction, `memory.undistilled` and `memory.mark_distilled` MCP tools, `/distill-transcripts` skill. Previously: Intent Parameter for Recall (#3), Retrieval Score Traces (#5), Search Agent Delegation (#8), Embedded Skill Distribution (#12), Shell Completion (#18), and 12 earlier features. Studied lossless-claw (v0.3.0). Other 6 repos unchanged since 2026-03-10.*
+*Updated: 2026-03-30 - Re-studied all 7 influencer repos. New recommendations: CLAUDE_CONFIG_DIR support (#26, from episodic-memory), Usage Stats / ROI Tracking (#27, from grepai v0.35.0). New Features to Avoid: AST-Aware Code Chunking (QMD), Custom Instructions via Env Var (lossless-claw v0.5.2), OpenClaw Context Injection (claude-mem v10.6.0). Repos with no changes: kbs (v0.2.1), claude-supermemory (v2.0.1), episodic-memory (v1.0.15). Previously: 14 features implemented through 2026-03-24.*
 *Sources:*
-- *[thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) - Memory compression system (v10.5.5, studied 2026-03-09)*
-- *[obra/episodic-memory](https://github.com/obra/episodic-memory) - Semantic conversation search (v1.0.15, studied 2026-03-09)*
-- *[yoanbernabeu/grepai](https://github.com/yoanbernabeu/grepai) - Semantic code search (latest, studied 2026-03-09)*
-- *[supermemoryai/claude-supermemory](https://github.com/supermemoryai/claude-supermemory) - Cloud-backed persistent memory (v2.0.1, studied 2026-03-09)*
-- *[tobi/qmd](https://github.com/tobi/qmd) - On-device hybrid search engine (v2.0.1, studied 2026-03-10)*
-- *[MadBomber/kbs](https://github.com/MadBomber/kbs) - Knowledge-Based System with RETE inference (v0.2.1, studied 2026-03-09 — no changes)*
-- *[martian-engineering/lossless-claw](https://github.com/martian-engineering/lossless-claw) - DAG-based lossless context management (v0.3.0, studied 2026-03-16)*
+- *[thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) - Memory compression system (v10.6.3, re-studied 2026-03-30)*
+- *[obra/episodic-memory](https://github.com/obra/episodic-memory) - Semantic conversation search (v1.0.15, re-studied 2026-03-30 — no changes)*
+- *[yoanbernabeu/grepai](https://github.com/yoanbernabeu/grepai) - Semantic code search (v0.35.0, re-studied 2026-03-30)*
+- *[supermemoryai/claude-supermemory](https://github.com/supermemoryai/claude-supermemory) - Cloud-backed persistent memory (v2.0.1, re-studied 2026-03-30 — no changes)*
+- *[tobi/qmd](https://github.com/tobi/qmd) - On-device hybrid search engine (v2.0.1+unreleased, re-studied 2026-03-30)*
+- *[MadBomber/kbs](https://github.com/MadBomber/kbs) - Knowledge-Based System with RETE inference (v0.2.1, studied 2026-03-30 — no changes)*
+- *[martian-engineering/lossless-claw](https://github.com/martian-engineering/lossless-claw) - DAG-based lossless context management (v0.5.2, re-studied 2026-03-30)*
 
 This document contains only unimplemented improvements. Completed items are removed.
 
@@ -128,10 +128,43 @@ Source: QMD study (updated 2026-03-02)
 
 `--async` flag on hook ingest/sweep/publish subcommands. Fork+detach for non-blocking execution, fallback to sync when fork unavailable.
 
+### ~~26. CLAUDE_CONFIG_DIR Support~~ ✅ Implemented 2026-04-13
+
+`Configuration#claude_config_dir` reads `CLAUDE_CONFIG_DIR` env var before falling back to `~/.claude`. `global_db_path` routes through it, so users with non-standard Claude Code config locations (or multiple profiles) can point the global memory DB anywhere without touching project DB resolution.
+
+### 28. Code-Aware Transcript Chunking
+
+Source: QMD v2.0.1+unreleased re-study (2026-03-30)
+
+- **Value**: Better embeddings for transcripts containing code — detect fenced code blocks and apply AST-aware break points (function/class/import boundaries) rather than naive text splitting
+- **Implementation**: Detect ` ```language ` fences in transcript content, parse code blocks with tree-sitter (via ruby_tree_sitter gem or shelling out), score break points (class=100, func=90, type=80, import=60), merge with markdown break points from #22
+- **Evidence**: QMD `src/ast.ts` (392 lines) — web-tree-sitter with WASM grammars, `mergeBreakPoints()` combining AST + regex scores, graceful degradation on parse failure
+- **Consideration**: Only useful in combination with #22 (Document Chunking). Transcripts often contain significant code in tool_use results and assistant responses
+- **Effort**: 2-3 days (after #22)
+- **Trade-off**: Adds tree-sitter dependency; graceful fallback to regex-only chunking when grammar unavailable
+
+### 30. Predicate Census Command
+
+Source: predicate retrospective (2026-04-15)
+
+- **Value**: Aggregate predicate usage data across many project databases for informed vocabulary decisions — without exposing content. Enables data-sharing across machines (work/personal) via a privacy-safe JSON report.
+- **Implementation**: `claude-memory census [--root ~/src]`. Finds all `.claude/memory.sqlite3` files under root, opens each read-only, collects per-DB predicate × status counts, entity type counts, schema version, novel predicates, synonym canonicalization candidates. Outputs aggregated JSON with **no object_literal, no entity names, no project paths, no quotes** — only schema-level signal.
+- **Evidence**: The multi-project survey that caught the `uses_framework` cardinality bug (commit `29818c2`) was a manual bash loop. Productizing it means any user can contribute usage data for vocabulary curation without privacy risk.
+- **Effort**: 0.5 days
+- **Trade-off**: None — purely additive, read-only, privacy-safe by design
+
+### ~~27. Usage Stats / ROI Tracking~~ ✅ Implemented 2026-04-15
+
+Schema migration v13 adds `mcp_tool_calls` telemetry table (tool_name, called_at, duration_ms, result_count, scope, error_class). `MCP::Telemetry` wraps `Server#handle_tools_call` with monotonic-clock timing, captures errors, and records to the project DB; DB errors are swallowed so telemetry never fails a real tool call. `StatsCommand` gains `--tools` and `--since DAYS` flags showing total calls, error rate, and per-tool breakdown (calls, avg ms, p95 ms, error rate). `Sweep::Maintenance#prune_old_mcp_tool_calls` enforces a 90-day retention window, wired into `Sweeper#run!`. Rejected NDJSON in favor of SQLite for schema/query consistency with the rest of the gem. Dropped query-text capture (YAGNI — the dedup insight the hash would enable also needs raw text). Also fixed a latent bug where `StatsCommand` opened the DB via `Sequel.sqlite` (requiring the unlisted `sqlite3` gem); now uses the extralite adapter consistently.
+
 ---
 
 ## Low Priority / Defer
 
+### ~~29. Derive CompletionCommand Descriptions from Registry~~ ✅ Implemented 2026-04-15
+
+`Registry::COMMANDS` now stores `{class:, description:}` entries as the single source of truth. New `Registry.description` and `Registry.descriptions` accessors. `CompletionCommand` reads descriptions via `Registry.descriptions` instead of maintaining its own parallel hash. `Registry.find` also simplified — class references stored directly since command files are required before the Registry, eliminating `const_get` string indirection. Drift between the command list and completion output is now impossible without a deliberate edit to a single file.
+
 ### 23. REST API Endpoint
 
 Source: QMD v2.0.1 study (2026-03-10)
@@ -219,6 +252,11 @@ Added `claude-memory export` command. Dumps facts with entities and provenance t
 - **Sub-Agent Delegation for Deep Recall** — lossless-claw spawns sub-agents for DAG traversal. Adds latency and complexity; our direct MCP tool responses are simpler and faster
 - **Message Parts Polymorphism** — lossless-claw's 10-column message_parts for tool calls, reasoning, patches. We don't store raw messages, so irrelevant
 - **OpenClaw ContextEngine Interface** — Tight framework coupling. Our MCP + hooks approach is more portable
+- **Chunk Strategy Option** — QMD's `--chunk-strategy auto` for code files. ClaudeMemory has no standalone chunking pipeline to configure (QMD v0.35.0)
+- **Custom Instructions via Env Var** — lossless-claw's `LCM_CUSTOM_INSTRUCTIONS` config stub exists but is never wired to summarization prompts. Incomplete pattern; our skill-based prompts are better (lossless-claw v0.5.2)
+- **OpenClaw Context Injection** — claude-mem v10.6.0's `appendSystemContext` with 60s cache replaces MEMORY.md writes. Our SessionStart hook context injection already does this (claude-mem v10.6.0)
+- **Message Parts Polymorphism** — lossless-claw's 10-column message_parts for tool calls, reasoning, patches. We don't store raw messages, so irrelevant
+- **OpenClaw ContextEngine Interface** — Tight framework coupling. Our MCP + hooks approach is more portable
 
 ---
 
@@ -241,22 +279,22 @@ Added `claude-memory export` command. Dumps facts with entities and provenance t
 ## References
 
 - [episodic-memory GitHub](https://github.com/obra/episodic-memory) - Semantic conversation search (v1.0.15)
-- [claude-mem GitHub](https://github.com/thedotmack/claude-mem) - Memory compression system (v10.5.5)
-- [grepai GitHub](https://github.com/yoanbernabeu/grepai) - Semantic code search (latest)
+- [claude-mem GitHub](https://github.com/thedotmack/claude-mem) - Memory compression system (v10.6.3)
+- [grepai GitHub](https://github.com/yoanbernabeu/grepai) - Semantic code search (v0.35.0)
 - [claude-supermemory GitHub](https://github.com/supermemoryai/claude-supermemory) - Cloud-backed memory (v2.0.1)
-- [QMD GitHub](https://github.com/tobi/qmd) - On-device hybrid search engine (v2.0.1)
+- [QMD GitHub](https://github.com/tobi/qmd) - On-device hybrid search engine (v2.0.1+unreleased)
 - [KBS GitHub](https://github.com/MadBomber/kbs) - Knowledge-Based System with RETE inference (v0.2.1)
-- [lossless-claw GitHub](https://github.com/martian-engineering/lossless-claw) - DAG-based lossless context management (v0.3.0)
+- [lossless-claw GitHub](https://github.com/martian-engineering/lossless-claw) - DAG-based lossless context management (v0.5.2)
 
 Influence documents:
-- [docs/influence/qmd.md](influence/qmd.md) - Updated 2026-03-10
-- [docs/influence/episodic-memory.md](influence/episodic-memory.md) - Updated 2026-03-09
-- [docs/influence/claude-mem.md](influence/claude-mem.md) - Updated 2026-03-09
-- [docs/influence/grepai.md](influence/grepai.md) - Updated 2026-03-09
-- [docs/influence/claude-supermemory.md](influence/claude-supermemory.md) - Updated 2026-03-09
-- [docs/influence/kbs.md](influence/kbs.md) - Updated 2026-03-09 (no changes)
-- [docs/influence/lossless-claw.md](influence/lossless-claw.md) - Updated 2026-03-16
+- [docs/influence/qmd.md](influence/qmd.md) - Re-studied 2026-03-30
+- [docs/influence/episodic-memory.md](influence/episodic-memory.md) - Re-studied 2026-03-30
+- [docs/influence/claude-mem.md](influence/claude-mem.md) - Re-studied 2026-03-30
+- [docs/influence/grepai.md](influence/grepai.md) - Re-studied 2026-03-30
+- [docs/influence/claude-supermemory.md](influence/claude-supermemory.md) - Re-studied 2026-03-30
+- [docs/influence/kbs.md](influence/kbs.md) - Re-studied 2026-03-30 (no changes)
+- [docs/influence/lossless-claw.md](influence/lossless-claw.md) - Re-studied 2026-03-30
 
 ---
 
-*Last updated: 2026-03-24 - Implemented 14 features total. Latest: Automatic Distillation Pipeline (#13 partial, #17), Intent Parameter for Recall (#3). Previously: Retrieval Score Traces (#5), Search Agent Delegation (#8), Embedded Skill Distribution (#12), Shell Completion (#18), Dynamic MCP Instructions (#11), Structured Error Classification (#16), Content-Addressed Dedup (#19), Dedup Before Vector Scoring (#20), Dedicated Maintenance Class (#10), Three-Level Escalation (#14), Tool Escalation Workflow (#15). Studied lossless-claw (v0.3.0). Implemented earlier: MCP Tool Annotations, MCP Stdout Protection, Worktree-Aware Git Root, Self-Excluding Conversations, Plugin Distribution, sqlite-vec, Database Compact, Fact Export, Background Processing, MCP Discovery Tools.*
+*Last updated: 2026-04-15 - Predicate retrospective: fixed uses_framework cardinality bug, curated vocabulary to 8 predicates, added synonym canonicalization + novel-predicate warnings. Also: reject/restore commands, #26 CLAUDE_CONFIG_DIR, #27 telemetry, #29 Registry descriptions.*

data/docs/influence/claude-mem.md

@@ -3,6 +3,7 @@
 *Analysis Date: 2026-03-02*
 *Repository: https://github.com/thedotmack/claude-mem*
 *Version: 10.5.2 (commit ecb09df)*
+*Re-studied: 2026-03-30 — v10.6.3 (commit d068821). 4 releases since last study (v10.5.6, v10.6.0, v10.6.1, v10.6.2, v10.6.3). Key changes: OpenClaw system prompt context injection replacing MEMORY.md writes (v10.6.0), compressed context output ~53% smaller (v10.6.1), timeline report skill (v10.6.1), process supervisor hardening with PID 0 fix and signal race condition fix (v10.5.6), activity spinner orphan session fix (v10.6.2), Gemini CLI integration (v10.6.3), 7 critical cross-platform bug fixes (v10.6.3). Context injection pattern (appendSystemContext with 60s cache) aligns with our SessionStart hook approach. Compressed context format worth studying. No new adoptable patterns beyond what we already implement.*
 
 ---
 

data/docs/influence/claude-supermemory.md

@@ -2,6 +2,7 @@
 
 *Analysis Date: 2026-03-02*
 *Previous Analysis: 2026-02-02*
+*Re-studied: 2026-03-30 — No meaningful code changes since v2.0.1. marketplace.json bumped to 0.0.3, added claude-code-review GitHub Action (anthropics/claude-code-action@v1). All findings remain current.*
 *Repository: https://github.com/supermemoryai/claude-supermemory*
 *Version: 2.0.0 (commit de39413)*
 

data/docs/influence/episodic-memory.md

@@ -3,6 +3,7 @@
 *Analysis Date: 2026-03-02*
 *Repository: https://github.com/obra/episodic-memory*
 *Version: 1.0.15 (commit 6feaa5b)*
+*Re-studied: 2026-03-30 — No changes since v1.0.15. Repo dormant. One adoptable pattern identified: CLAUDE_CONFIG_DIR env var support (`src/paths.ts:20-22`) for configurable Claude config directory. Orphaned MCP process prevention (SIGHUP handler in wrapper) not applicable — ClaudeMemory runs as single Ruby process, no wrapper/child architecture.*
 
 ---
 

data/docs/influence/grepai.md

@@ -4,6 +4,7 @@
 *Previous Analysis: 2026-01-29*
 *Repository: https://github.com/yoanbernabeu/grepai*
 *Version: 0.34.0 (commit 1c7aba9)*
+*Re-studied: 2026-03-30 — v0.35.0. One release since last study (2026-03-16). Key addition: privacy-first usage stats tracking (`stats/` package) recording every search/trace to NDJSON file (`.grepai/stats.json`), computing output tokens vs grep-equivalent tokens with savings percentages and optional USD cost savings. Fire-and-forget recording via goroutine with 100ms timeout, file-locking for cross-process safety. Shell completion also added (we already have this via #18). `.grepaiignore` support not relevant.*
 
 ---
 

data/docs/influence/kbs.md

@@ -1,6 +1,7 @@
 # KBS (Knowledge-Based System) Analysis
 
 *Analysis Date: 2026-03-02*
+*Re-studied: 2026-03-30 — no changes since v0.2.1*
 *Repository: https://github.com/MadBomber/kbs*
 *Version: v0.2.1 (commit c04561d)*
 

data/docs/influence/lossless-claw.md

@@ -3,6 +3,7 @@
 *Analysis Date: 2026-03-16*
 *Repository: https://github.com/martian-engineering/lossless-claw*
 *Version: 0.3.0 (commit 49949fb)*
+*Re-studied: 2026-03-30 — v0.5.2. 5 releases since last study. Core DAG architecture unchanged; changes are operational hardening. Custom Instructions (`LCM_CUSTOM_INSTRUCTIONS`) — config stub exists but never wired to summarization prompts, do not adopt. Session exclusion patterns (ignore + stateless) — clean implementation but low priority (we already have ContentSanitizer exclusion tags). Prompt Slot Pattern — does not exist in codebase, not applicable. New: CJK-aware FTS5 fallback with `icu` tokenizer detection worth considering. Also: provider auth error surfacing, summarizer timeouts, bootstrap checkpoints, Docker support, TUI doctor command.*
 
 ---
 

data/docs/influence/qmd.md

@@ -4,6 +4,7 @@
 *Previous Analysis: 2026-03-02, 2026-02-02*
 *Repository: https://github.com/tobi/qmd*
 *Version: 2.0.1 (commit ae3604c)*
+*Re-studied: 2026-03-30 — v2.0.1+unreleased. One significant addition: AST-aware chunking (`src/ast.ts`, 392 lines) using web-tree-sitter with WASM grammars for TS/JS/Python/Go/Rust. Detects language from extension, parses AST, extracts break points at function/class/import boundaries (class=100, func=90, type=80, import=60). Merged with regex break points via `mergeBreakPoints()`. Opt-in via `--chunk-strategy auto`. While we ingest transcripts rather than source code, transcripts frequently contain embedded code in tool results and assistant responses. AST-aware break points could improve embedding quality for code-heavy transcripts when combined with Document Chunking (#22). Added as improvement #28 (Code-Aware Transcript Chunking).*
 
 ---
 

data/lib/claude_memory/commands/completion_command.rb

@@ -37,7 +37,7 @@ module ClaudeMemory
       end
 
       def zsh_completion
-        commands_with_desc = command_descriptions.map { |name, desc|
+        commands_with_desc = Registry.descriptions.sort.map { |name, desc|
           "    '#{name}:#{desc}'"
         }.join("\n")
 
@@ -141,36 +141,6 @@ module ClaudeMemory
         BASH
       end
 
-      def command_descriptions
-        {
-          "changes" => "Show recent fact changes",
-          "compact" => "Compact databases",
-          "completion" => "Generate shell completions",
-          "conflicts" => "Show open conflicts",
-          "db:init" => "Initialize database",
-          "doctor" => "Check system health",
-          "explain" => "Explain a fact with receipts",
-          "export" => "Export facts to JSON",
-          "git-lfs" => "Git LFS integration",
-          "help" => "Show help message",
-          "hook" => "Run hook entrypoints",
-          "index" => "Index content",
-          "ingest" => "Ingest transcript delta",
-          "init" => "Initialize ClaudeMemory",
-          "install-skill" => "Install agent skills",
-          "promote" => "Promote fact to global",
-          "publish" => "Publish snapshot",
-          "recall" => "Recall facts matching query",
-          "recover" => "Recover database",
-          "search" => "Search indexed content",
-          "serve-mcp" => "Start MCP server",
-          "stats" => "Show statistics",
-          "sweep" => "Run maintenance",
-          "uninstall" => "Remove configuration",
-          "version" => "Show version"
-        }
-      end
-
       def skill_names
         InstallSkillCommand::AVAILABLE_SKILLS.keys
       end