diff --git a/CHANGELOG.md b/CHANGELOG.md index 76eebcfb..3166b1e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,10 +4,21 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). -## [12.1.4] - 2026- -✅ CHANGELOG.md generated successfully! - 229 releases processed -or Claude instance inserted `$CMEM` token branding into the context injection header during a compression refactor. Reverted back to the original descriptive format: `# [project] recent context, datetime` +## [12.1.5] - 2026-04-15 + +## Forced update to ship --setting-sources fix + +Users on v12.1.3 experience 100% observation failure due to empty-string arg filtering corrupting `--setting-sources` on Claude Code 2.1.109+. The fix landed in v12.1.4 (commit 3d92684 — `fix: filter empty string args before Bun spawn()`). This release forces the update to propagate across npm and the marketplace. + +Also shipped earlier today: the April 2026 backlog consolidation merged 93 PRs and 147 issues into 138 clean tracking issues (95 bugs, 43 feature requests). + +**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v12.1.4...v12.1.5 + +## [12.1.4] - 2026-04-15 + +A Claude instance inserted `$CMEM` token branding into the context injection header during a compression refactor. Reverted back to the original descriptive format: `# [project] recent context, datetime` + +**Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v12.1.3...v12.1.4 ## [12.1.3] - 2026-04-15 @@ -2345,98 +2356,98 @@ Huge thanks to **Alexander Knigge** ([@AlexanderKnigge](https://x.com/AlexanderK ## [8.1.0] - 2025-12-25 -## The 3-Month Battle Against Complexity - -**TL;DR:** For three months, Claude's instinct to add code instead of delete it caused the same bugs to recur. What should have been 5 lines of code became ~1000 lines, 11 useless methods, and 7+ failed "fixes." The timestamp corruption that finally broke things was just a symptom. The real achievement: **984 lines of code deleted.** - ---- - -## What Actually Happened - -Every Claude Code hook receives a session ID. That's all you need. - -But Claude built an entire redundant session management system on top: -- An `sdk_sessions` table with status tracking, port assignment, and prompt counting -- 11 methods in `SessionStore` to manage this artificial complexity -- Auto-creation logic scattered across 3 locations -- A cleanup hook that "completed" sessions at the end - -**Why?** Because it seemed "robust." Because "what if the session doesn't exist?" - -But the edge cases didn't exist. Hooks ALWAYS provide session IDs. The "defensive" code was solving imaginary problems while creating real ones. - ---- - -## The Pattern of Failure - -Every time a bug appeared, Claude's instinct was to **ADD** more code: - -| Bug | What Claude Added | What Should Have Happened | -|-----|------------------|--------------------------| -| Race conditions | Auto-create fallbacks | Delete the auto-create logic | -| Duplicate observations | Validation layers | Delete the code path allowing duplicates | -| UNIQUE constraint violations | Try-catch with fallbacks | Use `INSERT OR IGNORE` (5 characters) | -| Session not found | Silent auto-creation | **FAIL LOUDLY** (it's a hook bug) | - ---- - -## The 7+ Failed Attempts - -- **Nov 4**: "Always store session data regardless of pre-existence." Complexity planted. -- **Nov 11**: `INSERT OR IGNORE` recognized. But complexity documented, not removed. -- **Nov 21**: Duplicate observations bug. Fixed. Then broken again by endless mode. -- **Dec 5**: "6 hours of work delivered zero value." User requests self-audit. -- **Dec 20**: "Phase 2: Eliminated Race Conditions" — felt like progress. Complexity remained. -- **Dec 24**: Finally, forced deletion. - -The user stated "hooks provide session IDs, no extra management needed" **seven times** across months. Claude didn't listen. - ---- - -## The Fix - -### Deleted (984 lines): -- 11 `SessionStore` methods: `incrementPromptCounter`, `getPromptCounter`, `setWorkerPort`, `getWorkerPort`, `markSessionCompleted`, `markSessionFailed`, `reactivateSession`, `findActiveSDKSession`, `findAnySDKSession`, `updateSDKSessionId` -- Auto-create logic from `storeObservation` and `storeSummary` -- The entire cleanup hook (was aborting SDK agent and causing data loss) -- 117 lines from `worker-utils.ts` - -### What remains (~10 lines): -```javascript -createSDKSession(sessionId) { - db.run('INSERT OR IGNORE INTO sdk_sessions (...) VALUES (...)'); - return db.query('SELECT id FROM sdk_sessions WHERE ...').get(sessionId); -} -``` - -**That's it.** - ---- - -## Behavior Change - -- **Before:** Missing session? Auto-create silently. Bug hidden. -- **After:** Missing session? Storage fails. Bug visible immediately. - ---- - -## New Tools - -Since we're now explicit about recovery instead of silently papering over problems: - -- `GET /api/pending-queue` - See what's stuck -- `POST /api/pending-queue/process` - Manually trigger recovery -- `npm run queue:check` / `npm run queue:process` - CLI equivalents - ---- - -## Dependencies -- Upgraded `@anthropic-ai/claude-agent-sdk` from `^0.1.67` to `^0.1.76` - ---- - -**PR #437:** https://github.com/thedotmack/claude-mem/pull/437 - +## The 3-Month Battle Against Complexity + +**TL;DR:** For three months, Claude's instinct to add code instead of delete it caused the same bugs to recur. What should have been 5 lines of code became ~1000 lines, 11 useless methods, and 7+ failed "fixes." The timestamp corruption that finally broke things was just a symptom. The real achievement: **984 lines of code deleted.** + +--- + +## What Actually Happened + +Every Claude Code hook receives a session ID. That's all you need. + +But Claude built an entire redundant session management system on top: +- An `sdk_sessions` table with status tracking, port assignment, and prompt counting +- 11 methods in `SessionStore` to manage this artificial complexity +- Auto-creation logic scattered across 3 locations +- A cleanup hook that "completed" sessions at the end + +**Why?** Because it seemed "robust." Because "what if the session doesn't exist?" + +But the edge cases didn't exist. Hooks ALWAYS provide session IDs. The "defensive" code was solving imaginary problems while creating real ones. + +--- + +## The Pattern of Failure + +Every time a bug appeared, Claude's instinct was to **ADD** more code: + +| Bug | What Claude Added | What Should Have Happened | +|-----|------------------|--------------------------| +| Race conditions | Auto-create fallbacks | Delete the auto-create logic | +| Duplicate observations | Validation layers | Delete the code path allowing duplicates | +| UNIQUE constraint violations | Try-catch with fallbacks | Use `INSERT OR IGNORE` (5 characters) | +| Session not found | Silent auto-creation | **FAIL LOUDLY** (it's a hook bug) | + +--- + +## The 7+ Failed Attempts + +- **Nov 4**: "Always store session data regardless of pre-existence." Complexity planted. +- **Nov 11**: `INSERT OR IGNORE` recognized. But complexity documented, not removed. +- **Nov 21**: Duplicate observations bug. Fixed. Then broken again by endless mode. +- **Dec 5**: "6 hours of work delivered zero value." User requests self-audit. +- **Dec 20**: "Phase 2: Eliminated Race Conditions" — felt like progress. Complexity remained. +- **Dec 24**: Finally, forced deletion. + +The user stated "hooks provide session IDs, no extra management needed" **seven times** across months. Claude didn't listen. + +--- + +## The Fix + +### Deleted (984 lines): +- 11 `SessionStore` methods: `incrementPromptCounter`, `getPromptCounter`, `setWorkerPort`, `getWorkerPort`, `markSessionCompleted`, `markSessionFailed`, `reactivateSession`, `findActiveSDKSession`, `findAnySDKSession`, `updateSDKSessionId` +- Auto-create logic from `storeObservation` and `storeSummary` +- The entire cleanup hook (was aborting SDK agent and causing data loss) +- 117 lines from `worker-utils.ts` + +### What remains (~10 lines): +```javascript +createSDKSession(sessionId) { + db.run('INSERT OR IGNORE INTO sdk_sessions (...) VALUES (...)'); + return db.query('SELECT id FROM sdk_sessions WHERE ...').get(sessionId); +} +``` + +**That's it.** + +--- + +## Behavior Change + +- **Before:** Missing session? Auto-create silently. Bug hidden. +- **After:** Missing session? Storage fails. Bug visible immediately. + +--- + +## New Tools + +Since we're now explicit about recovery instead of silently papering over problems: + +- `GET /api/pending-queue` - See what's stuck +- `POST /api/pending-queue/process` - Manually trigger recovery +- `npm run queue:check` / `npm run queue:process` - CLI equivalents + +--- + +## Dependencies +- Upgraded `@anthropic-ai/claude-agent-sdk` from `^0.1.67` to `^0.1.76` + +--- + +**PR #437:** https://github.com/thedotmack/claude-mem/pull/437 + *The evidence: Observations #3646, #6738, #7598, #12860, #12866, #13046, #15259, #20995, #21055, #30524, #31080, #32114, #32116, #32125, #32126, #32127, #32146, #32324—the complete record of a 3-month battle.* ## [8.0.6] - 2025-12-24 @@ -2663,13 +2674,13 @@ This represents a major reliability improvement for Windows users, eliminating c ## [7.3.5] - 2025-12-17 -## What's Changed -* fix(windows): solve zombie port problem with wrapper architecture by @ToxMox in https://github.com/thedotmack/claude-mem/pull/372 -* chore: bump version to 7.3.5 by @thedotmack in https://github.com/thedotmack/claude-mem/pull/375 - -## New Contributors -* @ToxMox made their first contribution in https://github.com/thedotmack/claude-mem/pull/372 - +## What's Changed +* fix(windows): solve zombie port problem with wrapper architecture by @ToxMox in https://github.com/thedotmack/claude-mem/pull/372 +* chore: bump version to 7.3.5 by @thedotmack in https://github.com/thedotmack/claude-mem/pull/375 + +## New Contributors +* @ToxMox made their first contribution in https://github.com/thedotmack/claude-mem/pull/372 + **Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v7.3.4...v7.3.5 ## [7.3.4] - 2025-12-17 @@ -5199,12 +5210,12 @@ None (patch version) ## [4.3.0] - 2025-10-25 -## What's Changed -* feat: Enhanced context hook with session observations and cross-platform improvements by @thedotmack in https://github.com/thedotmack/claude-mem/pull/25 - -## New Contributors -* @thedotmack made their first contribution in https://github.com/thedotmack/claude-mem/pull/25 - +## What's Changed +* feat: Enhanced context hook with session observations and cross-platform improvements by @thedotmack in https://github.com/thedotmack/claude-mem/pull/25 + +## New Contributors +* @thedotmack made their first contribution in https://github.com/thedotmack/claude-mem/pull/25 + **Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v4.2.11...v4.3.0 ## [4.2.10] - 2025-10-25