Skip to content
This repository was archived by the owner on Dec 27, 2025. It is now read-only.

v1.2.3: Queue-Based Architecture + MCP Validation

Latest
Latest

Choose a tag to compare

View all tags
@a3fckx a3fckx released this 21 Nov 15:50
· 2 commits to main since this release
v1.2.3
6cec6ce

🎉 What's New in v1.2.3

Major architecture improvement: Replaced broken signal-based approach with reliable queue-based system for memory tracking.

✨ New Features

🔄 Queue-Based Memory Architecture

  • Producer-Consumer Pattern: Hooks write to .memory-queue.jsonl, skill processes automatically
  • File-Based Communication: Bypasses hook additionalContext visibility limitation
  • Reliable & Persistent: Queue survives Claude Code restarts, no data loss
  • Platform Compatible: Works perfectly on macOS and Linux

✅ MCP Connection Validation at Session Start

  • Immediate Feedback: Session start shows MCP configuration status
    • ✅ "Memory Store MCP: Connected" when working
    • ⚠️ "Memory Store MCP: Not configured" with setup command
    • ℹ️ "Status unknown" when Claude CLI unavailable
  • Proactive Guidance: Displays exact command to fix configuration issues
  • Reduces Support: Users know immediately if setup is needed

💬 User Transparency

  • Memory confirmations: "💾 Saved to Memory Store: File created..."
  • Brief, non-intrusive: Confirms storage without disrupting workflow
  • Automatic reporting: Know what's being tracked without asking

🐛 Bug Fixes

macOS Compatibility

  • Fixed sed syntax: Replaced sed ':a;N;$!ba;s/\n/\\n/g' with tr '\n' ' '
  • No more errors: Queue writing works flawlessly on macOS
  • Cross-platform: Same behavior on macOS and Linux

Broken MCP CLI Commands (v1.2.0-1.2.1)

  • Problem: Used claude mcp call which doesn't exist in CLI
  • Impact: All memory storage silently failed despite appearing to work
  • Solution: Queue-based architecture with direct MCP tool invocation

📚 Documentation Updates

  • README.md: Complete queue-based architecture diagram and flow
  • QUICKSTART.md: Added session start MCP check as Test 1
  • Troubleshooting: Quick MCP status reference guide
  • Architecture explanation: Why queue-based is more reliable

🔧 Technical Details

Architecture Evolution:

  • v1.2.0-1.2.1: Used broken claude mcp call command ❌
  • v1.2.2: Attempted signal-based approach (failed - signals not visible) ❌
  • v1.2.3: Queue-based approach (works reliably) ✅

How Queue System Works:

1. Hook fires (PreToolUse on Write/Edit)
2. Hook writes JSON to .memory-queue.jsonl
3. memory-queue-processor skill reads queue
4. Skill invokes mcp__memory-store__record
5. User sees: "💾 Saved to Memory Store..."
6. Queue cleared

Files Changed (6 commits):

  • scripts/session-start.sh - MCP validation + queue integration
  • scripts/session-end.sh - Queue integration
  • scripts/track-changes.sh - Queue integration + macOS sed fix
  • scripts/queue-memory.sh - New queue writer helper
  • skills/memory-queue-processor/skill.md - New automatic queue processor
  • Documentation: README.md, QUICKSTART.md, CHANGELOG.md

📊 Known Limitations

Proactive Skill Activation: The memory-queue-processor skill may not fire on every message due to Claude Code's proactive skill reliability (~20-30%). Queue items persist and will be processed when skill activates. This is a Claude Code limitation, not a plugin issue.

🚀 Installation

New Installation

```bash
claude plugin marketplace add julep-ai/memory-store-plugin
claude plugin install memory-store
claude mcp add memory-store -t http https://beta.memory.store/mcp
```

Upgrading from v1.2.0-1.2.1

```bash

Restart Claude Code - plugin auto-updates from marketplace

claude

Verify version

/plugin

Should show: ✔ memory-store · v1.2.3 · Installed

Check MCP status at session start

Should show: ✅ Memory Store MCP: Connected

```

🎯 What Works Now

✅ Session tracking: Session ID, start time, file counts
✅ File change tracking: Every Write/Edit captured
✅ MCP validation: Immediate feedback at session start
✅ Queue-based storage: Reliable, persistent, auditable
✅ macOS compatibility: No more sed errors
✅ User transparency: Know what's being saved
✅ Cross-platform: Works on macOS and Linux

📝 Commits

```
6cec6ce feat: add MCP connection validation at session start
b40575d docs: update documentation for queue-based architecture
136dda8 fix: replace incompatible sed syntax with macOS-compatible version
81135c9 feat: add user reporting to queue processor
b2f46d1 fix: replace signal-based with queue-based architecture
fc7c025 fix: replace broken MCP CLI calls with signal-based architecture
```

💡 Testing

Verify it works:

  1. Start Claude Code in any project
  2. Look for: "✅ Memory Store MCP: Connected"
  3. Run: `/memory-store:memory-status`
  4. Edit a file
  5. Counter should increment in status

🙏 Acknowledgments

Thanks to all users who reported issues with v1.2.0-1.2.1! Your feedback helped us discover the fundamental architecture flaw and build a better, more reliable solution.

Full changelog: v1.2.1...v1.2.3

Assets 2
Loading