Skip to content

v0.6.0

Choose a tag to compare

@codenamev codenamev released this 06 Mar 15:56
· 209 commits to main since this release
Immutable release. Only release title and notes can be modified.

What's New

Native Vector Storage (sqlite-vec)

  • Integrated 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

Bug Fixes

  • 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.
  • 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.
  • 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.

Stats

  • 21 MCP tools, 22 CLI commands
  • 1316 test examples, 0 failures
  • Full changelog: CHANGELOG.md