MCP Memory Service

# MCP Memory Service v7.1.4 - Unified Cross-Platform Hook Installer ## 🚀 **Major Feature Release** This release introduces a **unified cross-platform Python installer** that consolidates 4+ separate installer scripts into a single, robust solution with enhanced features for Claude Code Memory Awareness Hooks. ## ✨ **What's New** ### 🔧 **Unified Installation Experience** - **Single installer**: `install_hooks.py` replaces all platform-specific scripts - **Cross-platform compatibility**: Works seamlessly on Windows, macOS, and Linux - **Intelligent configuration merging**: Preserves existing Claude Code hook configurations - **Dynamic path resolution**: Eliminates hardcoded paths and works in any location ### 🎯 **Enhanced Safety & Reliability** - **Atomic installations**: Automatic rollback on failure - **Comprehensive backups**: Timestamped restore points before changes - **Smart JSON merging**: Prevents settings.json overwrite and configuration loss - **Empty directory cleanup**: Proper uninstall process with orphaned folder removal ### ⚡ **Natural Memory Triggers v7.1.3** - **Advanced trigger detection**: 85%+ accuracy for intelligent memory injection - **Multi-tier performance**: Optimized response times (50ms/150ms/500ms) - **Mid-conversation hooks**: Real-time memory awareness during conversations - **CLI management tools**: Live configuration and performance tuning - **Git-aware context**: Repository integration for enhanced context ## 📋 **Installation Commands** ### New Unified Installation ```bash # Navigate to hooks directory cd claude-hooks # Install Natural Memory Triggers (recommended) python install_hooks.py --natural-triggers # Install basic memory awareness hooks python install_hooks.py --basic # Install everything python install_hooks.py --all # Test installation (dry-run) python install_hooks.py --dry-run --natural-triggers ``` ### Integrated with Main Installer ```bash # Install service + hooks together python scripts/installation/install.py --install-natural-triggers ``` ## 🔄 **Migration Guide** ### For Existing Users 1. **Backup existing installation** (automatic during upgrade) 2. **Run unified installer**: `python install_hooks.py --natural-triggers` 3. **Verify functionality**: Hooks preserve existing configurations ### From Legacy Scripts - ❌ `install.sh` → ✅ `python install_hooks.py --basic` - ❌ `install-natural-triggers.sh` → ✅ `python install_hooks.py --natural-triggers` - ❌ `install_claude_hooks_windows.bat` → ✅ `python install_hooks.py --all` **Complete migration guide**: See `claude-hooks/MIGRATION.md` ## 🛠 **Technical Improvements** ### Cross-Platform Enhancements - **Proper path quoting**: Handles spaces in Windows installation paths - **Platform-specific hooks directory detection**: Works across different OS configurations - **Consistent CLI interface**: Same commands work on all platforms ### Code Quality - **Type hints throughout**: Better maintainability and IDE support - **Comprehensive error handling**: Graceful degradation and detailed feedback - **Modular architecture**: Clear separation of concerns and extensibility - **Professional UX**: Enhanced output formatting and user guidance ## ⚠️ **Breaking Changes** - **Legacy shell scripts removed**: `install.sh`, `install-natural-triggers.sh`, `install_claude_hooks_windows.bat` - **Installation commands updated**: Must use unified Python installer - **Configuration structure**: Enhanced v7.1.3 dual protocol support ## 🧪 **Testing & Validation** ### Comprehensive Test Results - **Natural Memory Triggers**: 18/18 tests passing (100% success rate) - **Cross-platform compatibility**: Validated on Linux, macOS simulation, Windows paths - **Installation integrity**: All components verified with syntax validation - **Configuration merging**: Tested with various existing setups ### Performance Metrics - **Installation time**: ~30 seconds for complete Natural Memory Triggers setup - **Average test execution**: 3.3ms per test - **Memory footprint**: Minimal impact with intelligent caching ## 🎯 **Benefits Summary** This unified installer provides: - ✅ **Better reliability** across all platforms - ✅ **Safer installations** with intelligent configuration merging - ✅ **Consistent experience** regardless of operating system - ✅ **Advanced features** like Natural Memory Triggers v7.1.3 - ✅ **Professional tooling** with comprehensive testing and validation - ✅ **Future-proof architecture** with extensible Python design ## 📞 **Support & Documentation** - **Installation Guide**: `claude-hooks/MIGRATION.md` - **Troubleshooting**: Run with `--dry-run` flag to diagnose issues - **CLI Help**: `python install_hooks.py --help` - **Issues**: [GitHub Issues](https://github.com/doobidoo/mcp-memory-service/issues) ## 🙏 **Acknowledgments** Special thanks to **Gemini Code Assist** for comprehensive code review feedback that drove the safety and reliability improvements in this release. --- This release represents a significant milestone in the evolution of Claude Code Memory Awareness Hooks, providing a unified, cross-platform installation experience with enhanced safety and advanced features.