doobidoo/mcp-memory-service v8.4.0

v8.4.0 - Memory Hooks Recency Optimization

on GitHub

🆕 Memory Hooks Recency Optimization

Comprehensive recency optimization for Claude Code memory hooks with enhanced scoring algorithm to prioritize recent development work.

✨ Key Features

Scoring Algorithm Improvements

• Weight Rebalancing:
  • timeDecay: 0.25 → 0.40 (+60% influence on recency)
  • tagRelevance: 0.35 → 0.25 (-29% to reduce tag dominance)
  • contentQuality: 0.25 → 0.20 (-20% to balance with time)
• Gentler Time Decay: 0.1 → 0.05 (preserves 30-day memories better)
• Stronger Git Context: 1.8x boost for git-derived memories
• Expanded Time Windows: Recent (last-month), Fallback (last-3-months)
• Higher Quality Bar: 0.4 minimum relevance score

New Recency Bonus System

• <7 days: +0.15 bonus (strong boost for last week)
• <14 days: +0.10 bonus (moderate boost for last 2 weeks)
• <30 days: +0.05 bonus (small boost for last month)

📊 Impact

Before: Top 3 memories averaged 45+ days old (July-Sept content)
After: All top 3 memories <7 days old ✅

80% higher likelihood of surfacing recent work!

🔍 Quality Assurance

• ✅ 7 rounds of Gemini Code Assist review
• ✅ Critical bugs fixed: config propagation, gitContextWeight implementation
• ✅ Security improvements: TLS validation, future timestamp handling
• ✅ Full test validation passed

📚 Documentation

• ✅ Comprehensive CONFIGURATION.md (450+ lines)
• ✅ Validation test suite (test-recency-scoring.js)
• ✅ Updated README and CLAUDE.md to remove ChromaDB references (post v8.0.0)
• ✅ Updated architecture to reflect current backends (SQLite-vec, Cloudflare, Hybrid)

🔗 Related

• PR: #155 - Memory hooks recency optimization
• Wiki: Natural Memory Triggers v7.1.0+
• Configuration Guide: claude-hooks/CONFIGURATION.md

📦 Installation

# Install/Update MCP Memory Service
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service && python install.py

# Install Natural Memory Triggers (includes recency optimization)
cd claude-hooks && python install_hooks.py --natural-triggers

# Verify recency scoring
node test-recency-scoring.js

🛠️ What's Changed

Full Changelog: v8.3.1...v8.4.0