[Release] Bump version to 0.6.0

Update version across all manifests (version.rb, plugin.json,
marketplace.json, CLAUDE.md marker). Add CHANGELOG entry covering
sqlite-vec native vector storage, SessionStart context injection,
compact/export commands, DualQueryTemplate recall fix, and
SchemaValidator vec0 crash fix. Update README key features and
CLAUDE.md with current tool/command counts and architecture notes.

Author: codenamev

.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   "plugins": [
     {
       "name": "claude-memory",
-      "version": "0.5.1",
+      "version": "0.6.0",
       "source": "./",
       "description": "Long-term self-managed memory for Claude Code with fact extraction, truth maintenance, and provenance tracking",
       "repository": "https://github.com/codenamev/claude_memory"

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Long-term self-managed memory for Claude Code with fact extraction, truth maintenance, and provenance tracking",
   "author": {
     "name": "Valentino Stoll",

.claude/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- ClaudeMemory v0.5.1 -->
+<!-- ClaudeMemory v0.6.0 -->
 # Project Memory
 
 @.claude/rules/claude_memory.generated.md

.claude/settings.local.json

@@ -35,7 +35,8 @@
       "Bash(qmd search:*)",
       "Skill(study-repo)",
       "WebFetch(domain:www.rubydoc.info)",
-      "Bash(git status:*)"
+      "Bash(git status:*)",
+      "WebFetch(domain:github.com)"
     ]
   },
   "enableAllProjectMcpServers": true

CHANGELOG.md

@@ -4,6 +4,61 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-03-06
+
+### Added
+
+**Native Vector Storage (sqlite-vec)**
+- Integrated [sqlite-vec](https://github.com/asg017/sqlite-vec) for native KNN vector search
+  - `VectorIndex` class with vec0 virtual table for cosine similarity search
+  - Dual-write: embeddings stored in both JSON column and vec0 index
+  - `claude-memory index --vec` flag for backfilling existing embeddings into vec0
+  - Fast path in `Recall` uses sqlite-vec KNN when available, falls back to JSON + Ruby
+  - Sweeper cleans up vec0 entries for superseded/expired facts
+  - Doctor and MCP status/stats report vec0 availability and coverage
+  - Cross-platform support with platform-specific gem installation
+
+**Database Maintenance**
+- `compact` command for database maintenance (VACUUM + integrity check)
+- `export` command for fact backup and migration to JSON
+
+**Hook Enhancements**
+- SessionStart context injection via `hookSpecificOutput.additionalContext`
+  - Injects recent facts and project context at session start
+- Tool-specific observation compression for reduced token usage
+- `--async` flag for non-blocking hook execution
+- Hook error classification for graceful degradation
+- Conversation exclusion markers for session-level opt-out
+
+**MCP Discovery**
+- `memory.list_projects` MCP tool for discovering all project databases
+
+**Developer Experience**
+- Dynamic MCP server instructions with progressive disclosure documentation
+- Comparative benchmark suite with QMD and grepai adapters
+  - `bin/setup-competitors` for installing competitor tools
+  - `bin/run-evals --comparative` for side-by-side benchmarks
+
+### Fixed
+
+- **Recall returned no results**: `DualQueryTemplate` accessed stores before initializing them,
+  causing all recall queries to silently return empty results. Refactored to use existing
+  `store_for_scope` method which handles initialization and access atomically.
+- **Doctor crashed on sqlite-vec tables**: `SchemaValidator` iterated all tables including vec0
+  virtual tables, which require the sqlite-vec extension. Now skips `facts_vec*` tables using
+  prefix match to handle future partition tables.
+- **Forward-migrated databases**: Older gem versions now gracefully handle databases migrated
+  by newer versions instead of crashing.
+- **Hybrid retrieval ordering**: Preserved BM25 scores and RRF ordering in hybrid search results
+  instead of re-sorting by source/time.
+- Fork-based concurrency tests skipped on Ruby 4.0+ (Extralite incompatibility)
+- Real eval tests now run in tmpdir with fixture database
+
+### Internal
+- Refactored publish to avoid unnecessary rewrites from timestamp churn
+- Skip quality-review hook when running inside Claude Code session
+- Influence studies for claude-mem, episodic-memory, kbs repositories
+
 ## [0.5.1] - 2026-02-04
 
 ### Fixed

CLAUDE.md

@@ -170,7 +170,9 @@ Transcripts → Ingest → Index (FTS5)
 - **`Ingest`**: Transcript reading and delta-based ingestion (`ingest/`)
   - Tracks cursor position per session to avoid re-processing
 
-- **`Index`**: Full-text search using SQLite FTS5 (`index/`)
+- **`Index`**: Full-text search and vector indexing (`index/`)
+  - `LexicalFTS`: SQLite FTS5 full-text search
+  - `VectorIndex`: sqlite-vec native KNN search with vec0 virtual tables
   - Optimized with batch queries to eliminate N+1 issues
 
 - **`Distill`**: Fact extraction interface (`distill/`)
@@ -194,8 +196,8 @@ Transcripts → Ingest → Index (FTS5)
   - Modes: shared (repo), local (uncommitted), home (user directory)
 
 - **`MCP`**: Model Context Protocol server and tools (`mcp/`)
-  - Exposes memory tools to Claude Code
-  - Tools: recall, explain, promote, status, conflicts, changes, sweep_now
+  - Exposes memory tools to Claude Code (21 tools total)
+  - Dual content/structuredContent responses with compact mode
 
 - **`Hook`**: Hook entrypoint handlers (`hook/`)
   - Reads stdin JSON from Claude Code hooks
@@ -284,7 +286,7 @@ Single-value predicates (like "uses_database") supersede old values. Multi-value
 
 - `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 (20 commands)
+- `lib/claude_memory/commands/`: Individual command classes (22 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
@@ -299,31 +301,33 @@ 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 (18 total):
+Available MCP tools (21 total):
 - **Query & Recall**: `memory.recall`, `memory.recall_index`, `memory.recall_details`, `memory.recall_semantic`, `memory.search_concepts`
-- **Provenance**: `memory.explain`
+- **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`
 - **Monitoring**: `memory.status`, `memory.stats`, `memory.changes`, `memory.conflicts`
 - **Maintenance**: `memory.sweep_now`
-- **Setup**: `memory.check_setup`
+- **Discovery**: `memory.check_setup`, `memory.list_projects`
 
 ## Hook Integration
 
 ClaudeMemory integrates with Claude Code via hooks in `.claude/settings.json`:
 
-- **Ingest hook**: Triggers on Stop/SessionStart/PreCompact events
+- **Ingest hook**: Triggers on Stop/SessionStart/PreCompact/SessionEnd events
   - Calls `claude-memory hook ingest` with stdin JSON
   - Reads transcript delta and updates both global and project databases
 
-- **Sweep hook**: Triggers on idle_prompt and safety events
-  - Runs time-bounded maintenance on both databases
+- **Context hook**: Triggers on SessionStart
+  - Calls `claude-memory hook context`
+  - Injects recent facts via `hookSpecificOutput.additionalContext`
 
-- **Publish hook**: Optional, on SessionEnd/PreCompact
-  - Publishes curated snapshot to `.claude/rules/`
+- **Sweep hook**: Triggers on PreCompact/SessionEnd events
+  - Runs time-bounded maintenance on both databases
+  - Cleans up vec0 entries for superseded/expired facts
 
-Hook commands read JSON payloads from stdin for robustness.
+Hook commands read JSON payloads from stdin for robustness. Supports `--async` flag for non-blocking execution.
 
 ## Code Style
 

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    claude_memory (0.5.1)
+    claude_memory (0.6.0)
       extralite (~> 2.14)
       sequel (~> 5.0)
       sqlite-vec (~> 0.1)
@@ -137,7 +137,7 @@ DEPENDENCIES
 CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
-  claude_memory (0.5.1)
+  claude_memory (0.6.0)
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5

README.md

@@ -95,12 +95,16 @@ Claude: "Based on my memory, you're using Rails with PostgreSQL..."
 ## Key Features
 
 - **Dual Scope**: Project-specific + global user preferences
+- **Hybrid Search**: FTS5 full-text + semantic vector search with Reciprocal Rank Fusion
+- **Native Vector Storage**: [sqlite-vec](https://github.com/asg017/sqlite-vec) for fast KNN search with local embeddings ([fastembed-rb](https://github.com/khasinski/fastembed-rb), no API key)
+- **Session Context**: Automatic context injection at session start with recent facts
 - **Privacy First**: `<private>` tags exclude sensitive data
 - **Progressive Disclosure**: Lightweight queries before full details
 - **Semantic Shortcuts**: Quick access to decisions, conventions, architecture
 - **Truth Maintenance**: Automatic conflict resolution
 - **Claude-Powered**: Uses Claude's intelligence to extract facts (no API key needed)
 - **Token Efficient**: 10x reduction in memory queries with progressive disclosure
+- **Database Maintenance**: Compact, export, and backup commands
 
 ## Privacy Control
 
@@ -169,10 +173,10 @@ claude-memory doctor
 This checks:
 - Database existence and integrity
 - Schema version compatibility
+- sqlite-vec availability and index coverage
 - Hooks configuration
 - Snapshot status
 - Stuck operations
-- Orphaned hooks (hooks without MCP configuration)
 
 ### Uninstalling
 
@@ -253,7 +257,7 @@ The benchmark dataset draws from real CLAUDE.md patterns and is designed specifi
 
 - **Language:** Ruby 3.2+
 - **Storage:** SQLite3 (no external services)
-- **Testing:** 985 examples, 100% core coverage
+- **Testing:** 1316 examples, 100% core coverage
 - **Code Style:** Standard Ruby
 
 ```bash

lib/claude_memory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeMemory
-  VERSION = "0.5.1"
+  VERSION = "0.6.0"
 end