v0.5.4 - SmartRouter, Multi-Agent Namespaces & vesper init

What's New

v0.5.4

• Fix version references across README and docs for npm display

v0.5.3

• New vesper init command to install Claude Code rules into any project

v0.5.2

• New delete_memory MCP tool — removes memories across all layers (SQLite, Qdrant, Redis) and cleans up orphaned facts
• Activate SmartRouter for intelligent query routing in retrieve_memory (6 specialized handlers)
• 14 MCP tools total

v0.5.0 — Multi-Agent Namespace Isolation

• Namespace isolation across all memory layers (Redis, SQLite, Qdrant)
• Agent attribution with agent_id, agent_role, task_id on all memories
• share_context tool for cross-namespace memory handoffs
• store_decision tool with reduced temporal decay and conflict detection
• list_namespaces and namespace_stats discovery tools
• 958 tests passing (100%)

v0.4.0 — Lazy Loading & Performance

• Token-efficient lazy skill loading (90% reduction)
• Relational skill embeddings
• Security fixes for skill embeddings
• Benchmark visualizations and performance dashboard
• Consolidation scheduler (3 AM daily backups)

Performance

Metric	Result	Target	Status
P50 Latency	0.4ms	<30ms	✅
P95 Latency	0.6ms	<200ms	✅
P99 Latency	1.2ms	<500ms	✅

Install

npm install -g vesper-memory
vesper init  # Set up Claude Code rules

Full Changelog: v0.4.0...v0.5.4

v0.4.0 - User-Level Storage Migration

⚠️ BREAKING CHANGES

User-Level Storage Migration
All data now stored at ~/.vesper/ (user-level) instead of project directories.

Migration Required:

# Automatic migration from v0.3.x
vesper migrate

# Or manually:
mkdir -p ~/.vesper/data
cp ./data/memory.db ~/.vesper/data/memory.db
docker-compose down
docker-compose up -d

✨ Major Changes

User-Level Storage

• SQLite database: ~/.vesper/data/memory.db (was ./data/memory.db)
• Docker volumes: ~/.vesper/docker-data/ (were named volumes)
• Memories now persist across all projects
• Simple backup: just copy ~/.vesper/

CLI Enhancements

• vesper migrate command for automatic data migration
• VESPER_HOME environment variable for custom storage location
• Improved vesper status showing data directory and database size
• Detection of old data needing migration

Security Improvements

• ✅ Fixed command injection vulnerability in CLI uninstall
• ✅ Restrictive directory permissions (owner-only: 0o700)
• ✅ Path traversal warnings for system directories
• ✅ Secrets excluded from version control

Testing

• 62 new tests for path utilities, CLI migration, and Docker config
• Total: 632 tests passing (up from 570)
• 7 functional tests validating end-to-end behavior
• 100% test coverage for migration logic

📦 Installation

npm install vesper-memory

🔗 Links

• NPM Package: https://www.npmjs.com/package/vesper-memory
• Full Changelog: See CHANGELOG.md
• Documentation: See CLAUDE.md and README.md

🤖 Generated with Claude Code

v0.3.0 - Performance Optimizations & Multi-hop Reasoning

Added

Performance Optimizations

• Preference query handler with direct SQLite lookup (31% faster: 204ms → 142ms)
• Temporal decay weighting for preference ranking
• LRU embedding cache (1000 entries, 1hr TTL) eliminates redundant HTTP calls
• Working memory integration in smart router for fast-path retrieval
• Optimized SQL index for preference queries

Multi-hop Reasoning

• personalizedPageRankWithFacts() method for knowledge graph traversal
• Fact retrieval along traversal paths for multi-hop query answering
• Chain tracking with intermediary entities for explainability
• Path information showing relationship types between entities
• Support for inferring A→C connections via A→B→C chains

Testing & Validation

• 6 new preference handler tests (edge cases, performance, scaling)
• 8 new multi-hop fact chaining tests
• All 529 tests passing (100% pass rate)

Performance

• Preference queries: -31% latency (204.4ms → 141.8ms)
• Multi-hop queries: -11% latency (173.4ms → 154.2ms)
• Overall accuracy: 98.5% F1 score
• P50 latency: 4.4ms (target: <30ms) ✅
• P95 latency: 5.3ms (target: <200ms) ✅

Install: `npm install vesper-memory`

NPM Package: https://www.npmjs.com/package/vesper-memory