doobidoo/mcp-memory-service v8.68.1

v8.68.1 - Critical Data Integrity Bug Fix (Hybrid Backend)

on GitHub

🔴 CRITICAL: Soft-Deleted Memories Syncing from Cloudflare

Issue: Soft-deleted memories from Cloudflare were incorrectly syncing back to local SQLite databases, causing "ghost memories" to reappear in hybrid backend deployments.

Impact: Users with hybrid backend experienced data integrity issues where deleted memories would resurface after synchronization.

Key Fixes

Cloudflare Backend (5 Method Fixes)

Added deleted_at IS NULL filter to all query methods:

• search_memories()
• search_by_tag()
• search_by_timeframe()
• list_memories()
• get_all_memories()

Hybrid Backend (Defense-in-Depth)

• Added validation in hybrid.py sync logic to filter soft-deleted records
• Prevents ghost memories even if Cloudflare query filters fail

Test Updates

• Fixed test_cleanup_duplicates to verify soft-delete behavior
• Ensures cleanup operations correctly handle tombstone records

Additional Improvements

Update Scripts

• HTTPS Support: Health checks now work with both HTTP and HTTPS endpoints
• Better UX: Improved progress messages and error handling
• CUDA Optimization: Prevent unnecessary CUDA package downloads

PowerShell Script (Windows)

• SSH Agent Integration: Automatic Git authentication via SSH agent
• Unicode → ASCII Conversion: Compatibility fixes for special characters
• Better Error Handling: Improved network operation resilience

Files Changed

Core Fixes:

• src/mcp_memory_service/storage/cloudflare.py (5 methods)
• src/mcp_memory_service/storage/hybrid.py (sync validation)
• tests/test_storage.py (soft-delete test updates)

Scripts:

• scripts/update_and_restart.sh (HTTPS support)
• scripts/service/windows/update_and_restart.ps1 (SSH agent, Unicode fixes)

Documentation:

• CHANGELOG.md (v8.68.1 entry)
• README.md (Latest Release section)
• CLAUDE.md (version callout)

Upgrade Instructions

All Users (Recommended):

# Quick update (macOS/Linux)
./scripts/update_and_restart.sh

# Quick update (Windows PowerShell)
.\scripts\service\windows\update_and_restart.ps1

Manual Update:

git pull origin main
pip install -e .
# Restart your MCP memory service

Hybrid Backend Users: This fix is critical for data integrity. Please update immediately.

SQLite-Vec Only Users: Update recommended for script improvements, but not critical.

PyPI Publication

This release will be automatically published to PyPI via GitHub Actions workflow:

• Workflow: "Publish and Test (Tags)"
• Timeline: ~5-10 minutes after tag push
• Verification: Check https://pypi.org/project/mcp-memory-service/

Related Issues

• Commit: 2be7e10 - Primary fix for Cloudflare sync issue
• Commit: aaae9a9 - Test updates for soft-delete behavior
• Commit: 9bff59a - HTTPS support in update scripts

Full CHANGELOG: https://github.com/doobidoo/mcp-memory-service/blob/main/CHANGELOG.md#8681---2026-01-03