claude-mem/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog.

[4.0.2] - 2025-10-19

Changed

• PM2 bundled as dependency: Moved pm2 from devDependencies to dependencies for out-of-the-box functionality
• Worker scripts use local PM2: All npm worker scripts now use npx pm2 to ensure local binary is used
• Worker startup uses local PM2: Worker auto-start now uses node_modules/.bin/pm2 instead of global pm2

Fixed

• Fail loudly on missing dependencies: Worker startup now throws explicit errors when bundled pm2 is missing instead of silently falling back
• Better error messages: Clear actionable error messages guide users to run npm install when dependencies are missing
• Removed silent fallback: Eliminated silent degradation that masked "works on my machine" installation failures

Documentation

• Updated README system requirements to reflect pm2 is bundled with plugin (no global install required)

[4.0.0] - 2025-10-18

BREAKING CHANGES

• Data directory moved to plugin location: Database and worker files now stored in ${CLAUDE_PLUGIN_ROOT}/data/ instead of ~/.claude-mem/
• Fresh start required: No automatic migration from v3.x databases. Users must start fresh with v4.0.0
• Worker auto-starts: Worker service now starts automatically on SessionStart hook, no manual PM2 commands needed

Added

• MCP Search Server: 6 specialized search tools with FTS5 full-text search capabilities
  • search_observations - Full-text search across observation titles, narratives, facts, and concepts
  • search_sessions - Full-text search across session summaries, requests, and learnings
  • find_by_concept - Find observations tagged with specific concepts
  • find_by_file - Find observations and sessions that reference specific file paths
  • find_by_type - Find observations by type (decision, bugfix, feature, refactor, discovery, change)
  • advanced_search - Combined search with filters across observations and sessions
• Citation support: All search results include claude-mem:// URI citations for referencing specific observations and sessions
• Automatic worker startup: Worker service now starts automatically in SessionStart hook
• Plugin data directory: Full integration with Claude Code plugin system using CLAUDE_PLUGIN_ROOT

Changed

• Worker service architecture: HTTP REST API with PM2 management for long-running background service
• Data directory priority: CLAUDE_PLUGIN_ROOT/data > CLAUDE_MEM_DATA_DIR > ~/.claude-mem (fallback for dev)
• Port file location: Worker port file now stored in plugin data directory
• Session continuity: Automatic context injection from last 3 sessions on startup
• Package structure: Reorganized to properly distribute plugin/, dist/, and src/ directories

Fixed

• Context hook now uses proper hookSpecificOutput JSON format for SessionStart
• Added missing process.exit(0) calls in all hook entry points
• Worker service now ensures data directory exists before writing port file
• Improved error handling and graceful degradation across all components

[3.7.1] - 2025-09-17

Added

• SQLite storage backend with session, memory, overview, and diagnostics management
• Mintlify documentation site with searchable interface and comprehensive guides
• Context7 MCP integration for documentation retrieval

Changed

• Session-start overviews to display chronologically from oldest to newest

Fixed

• Migration index parsing bug that prevented JSONL records from importing to SQLite

[3.6.10] - 2025-09-16

Added

• Claude Code statusline integration for real-time memory status
• MCP memory tools server providing compress, stats, search, and overview commands
• Concept documentation explaining memory compression and context loading

Fixed

• Corrected integration architecture to use hooks instead of MCP SDK

[3.6.9] - 2025-09-14

Added

• Display current date and time at the top of session-start hook output for better temporal context

Changed

• Enhanced session-start hook formatting with emoji icons and separator lines for improved readability

[3.6.8] - 2025-09-14

Fixed

• Fixed publish command failing when no version-related memories exist for changelog generation

[3.6.6] - 2025-09-14

Fixed

• Resolved compaction errors when processing large conversation histories by reducing chunk size limits to stay within Claude's context window

[3.6.5] - 2025-09-14

Changed

• Session groups now display in chronological order (most recent first)

Fixed

• Improved CLI path detection for cross-platform compatibility

[3.6.4] - 2025-09-13

Changed

• Update save documentation to include allowed-tools and description metadata fields

Removed

• Remove deprecated markdown to JSONL migration script

[3.6.3] - 2025-09-11

Changed

• Updated changelog generation prompts to use date strings in query text for temporal filtering

Fixed

• Resolved changelog timestamp filtering by using semantic search instead of metadata queries, enabling proper date-based searches
• Corrected install.ts search instructions to remove misleading metadata filtering guidance that caused 'Error finding id' errors

[3.6.2] - 2025-09-10

Added

• Visual feedback to changelog command showing current version, next version, and number of overviews being processed
• Generate changelog for specific versions using --generate flag with npm publish time boundaries
• Introduce 'Who Wants To Be a Memoryonaire?' trivia game that generates personalized questions from your stored memories
• Add interactive terminal UI with lifelines (50:50, Phone-a-Friend, Audience Poll) and cross-platform audio support
• Implement permanent question caching with --regenerate flag for instant game loading
• Enable hybrid vector search to discover related memory chains during question generation

Changed

• Changelog regeneration automatically removes old entries from JSONL file when using --generate or --historical flags
• Switch to direct JSONL file loading for instant memory access without API calls
• Optimize AI generation with faster 'sonnet' model for improved performance
• Reduce memory query limit from 100 to 50 to prevent token overflow

Fixed

• Changelog command now uses npm publish timestamps exclusively for accurate version time ranges
• Resolved timestamp filtering issues with Chroma database by leveraging semantic search with embedded dates
• Resolve game hanging at startup due to confirmation loop
• Fix memory integration bypass that prevented questions from using actual stored memories
• Consolidate 500+ lines of duplicate code for better maintainability

[3.6.1] - 2025-09-10

Changed

• Refactored pre-compact hook to work independently without status line updates

Removed

• Removed status line integration and ccstatusline configuration support

[3.5.5] - 2025-09-10

Changed

• Standardized GitHub release naming to lowercase 'claude-mem vX.X.X' format for consistent branding