Starstruk Logo MarkStarstruk

v11.0.0

thedotmack/claude-memv11.0.0Apr 5, 2026by thedotmack

AI Summary

claude-mem v11.0.0 is a major release consolidating v10.7.0 through v11.0.0, introducing semantic context injection using ChromaDB for relevance-based search, tier routing that reduces SDK agent costs by ~52%, and a new multi-machine sync CLI. The release also fixes orphaned messages and includes 3 upstream production bugs.

Key Highlights

  • Semantic Context Injection replaces recency-based observation retrieval with ChromaDB-powered relevance search
  • Tier Routing by Queue Complexity achieves ~52% cost reduction by routing simple tool-only queues to Haiku
  • Multi-Machine Observation Sync via new `claude-mem-sync` CLI enables bidirectional SSH/SCP sync between servers
  • Orphaned Message Drain fixes messages stuck in pending status when deleteSession() aborts
  • 3 upstream production bugs fixed: summarize.ts empty transcript, ChromaSync.ts ID conflicts, HealthMonitor.ts TOCTOU race

Breaking Changes

  • Strict Observer Response Contract - Memory agent must return `<observation>` XML blocks or empty response; prose-style skip responses like 'Skipping — no substantive tool executions' are no longer allowed to prevent silent data loss

New Features

  • Semantic Context Injection (#1568) - ChromaDB queries for top-N relevant past observations on each UserPromptSubmit
  • Tier Routing by Queue Complexity - Model selection based on queue complexity with new observation_feedback table
  • Multi-Machine Observation Sync (#1570) - New claude-mem-sync CLI with push, pull, sync, status commands
  • Orphaned Message Drain (#1567) - Pending messages marked abandoned on SIGTERM instead of stuck in pending
  • Installer Regression Fixed (v10.7.1) - Restores full installer for non-Claude-Code IDEs
  • 3 Upstream Production Bugs Fixed (#1566) - summarize.ts, ChromaSync.ts, and HealthMonitor.ts fixes
  • Concept-type cleanup log downgraded from error to debug

Full Release Notes

## claude-mem v11.0.0

**4 releases today** · 21 commits · 6,051 insertions · 34 files changed

### Features

#### Semantic Context Injection (#1568)
Every `UserPromptSubmit` now queries ChromaDB for the top-N most relevant past observations and injects them as context. Replaces recency-based "last N observations" with relevance-based semantic search. Survives `/clear`, skips trivial prompts (<20 chars), and degrades gracefully when Chroma is unavailable.

#### Tier Routing by Queue Complexity
The SDK agent now inspects pending queue complexity before selecting a model. Simple tool-only queues (Read, Glob, Grep) route to Haiku; mixed/complex queues use the default model. Production result: **~52% cost reduction** on SDK agent usage with quality indistinguishable from Sonnet. Includes a new `observation_feedback` table for future Thompson Sampling optimization.

#### Multi-Machine Observation Sync (#1570)
New `claude-mem-sync` CLI with `push`, `pull`, `sync`, and `status` commands. Bidirectional sync of observations and session summaries between machines via SSH/SCP with deduplication by `(created_at, title)`. Tested syncing 3,400+ observations between two physical servers — a session on the remote machine used transferred memory to deliver a real feature PR.

#### Orphaned Message Drain (#1567)
When `deleteSession()` aborts the SDK agent via SIGTERM, pending messages are now marked abandoned instead of remaining in `pending` status forever. Production evidence: 15 orphaned messages found before fix → 0 orphaned messages over 23 days after fix.

### Bug Fixes

#### Installer Regression Fixed (v10.7.0 → v10.7.1)
The install simplification in v10.7.0 over-applied scope — it replaced the entire `runInstallCommand` with just two `claude` CLI commands, gutting the interactive IDE multi-select, `--ide` flag, and all 13 IDE-specific setup dispatchers. v10.7.1 restores the full installer for all non-Claude-Code IDEs while keeping the native plugin delegation for Claude Code.

#### 3 Upstream Production Bugs (#1566)
Found via analysis of 543K log lines over 17 days across two servers:
- **summarize.ts**: Skip summary when transcript has no assistant message (was causing ~30 errors/day)
- **ChromaSync.ts**: Fallback to `chroma_update_documents` when add fails with "IDs already exist"
- **HealthMonitor.ts**: Replace HTTP-based port check with atomic socket bind (eliminates TOCTOU race on simultaneous session starts)

#### Other Fixes
- Concept-type cleanup log downgraded from error to debug (reduces log noise)

### Breaking Change

**Strict Observer Response Contract** — The memory agent can no longer return prose-style skip responses like "Skipping — no substantive tool executions." `buildObservationPrompt` now requires `<observation>` XML blocks or an empty response. `ResponseProcessor` warns when non-XML content is received. This prevents silent data loss from the observer deciding on its own that tool output isn't worth recording.

### Community

Features in this release were contributed by **Alessandro Costa** ([@alessandropcostabr](https://github.com/alessandropcostabr)) — semantic injection, tier routing, multi-machine sync, orphan drain, and the 3-bug production fix. All PRs include production data from real multi-server deployments.

### Release History

This release consolidates v10.7.0 through v11.0.0, all shipped on April 4, 2026. For the full v10.x era (267 commits, 39 releases), see [v10.7.0](https://github.com/thedotmack/claude-mem/releases/tag/v10.7.0) and earlier.