airkjw/claude-mem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update CHANGELOG.md for v8.5.0 release

Browse Source 
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex Newman
2025-12-29 23:13:53 -05:00
parent f7f11b2a4b
commit 61a23a14a9
1 changed files with 107 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+107 -128
View File
@@ -6,7 +6,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [8.5.0] - 2025-12-30 ## [8.5.0] - 2025-12-30
# Cursor Support Now Available # Cursor Support Now Available 🎉
This is a major release introducing **full Cursor IDE support**. Claude-mem now works with Cursor, bringing persistent AI memory to Cursor users with or without a Claude Code subscription. This is a major release introducing **full Cursor IDE support**. Claude-mem now works with Cursor, bringing persistent AI memory to Cursor users with or without a Claude Code subscription.
@@ -79,27 +79,6 @@ Full documentation available at [docs.claude-mem.ai/cursor](https://docs.claude-
- OpenRouter Setup Guide - OpenRouter Setup Guide
- Troubleshooting - Troubleshooting
## Technical Improvements
### New Utilities Module (`src/utils/cursor-utils.ts`)
Extracted testable pure functions for:
- Project registry management
- Context file operations
- MCP configuration
- JSON utilities with array access support
- Cross-platform path handling
### Comprehensive Test Suite
New test files validating Cursor integration:
- `cursor-registry.test.ts` - Project registry operations
- `cursor-context-update.test.ts` - Context file management
- `cursor-hooks-json-utils.test.ts` - JSON parsing utilities
- `cursor-mcp-config.test.ts` - MCP configuration
- `cursor-hook-outputs.test.ts` - Hook script output validation
### Atomic File Writes
Context files use temp-file-plus-rename pattern to prevent corruption during updates.
## Getting Started ## Getting Started
### For Cursor-Only Users (No Claude Code) ### For Cursor-Only Users (No Claude Code)
@@ -118,7 +97,7 @@ bun run cursor:setup
claude-mem cursor install claude-mem cursor install
``` ```
--- **Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v8.2.10...v8.5.0
## [8.2.10] - 2025-12-30 ## [8.2.10] - 2025-12-30
@@ -368,98 +347,98 @@ Huge thanks to **Alexander Knigge** ([@AlexanderKnigge](https://x.com/AlexanderK
## [8.1.0] - 2025-12-25 ## [8.1.0] - 2025-12-25
## The 3-Month Battle Against Complexity ## 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.** **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 ## What Actually Happened
Every Claude Code hook receives a session ID. That's all you need. Every Claude Code hook receives a session ID. That's all you need.
But Claude built an entire redundant session management system on top: But Claude built an entire redundant session management system on top:
- An `sdk_sessions` table with status tracking, port assignment, and prompt counting - An `sdk_sessions` table with status tracking, port assignment, and prompt counting
- 11 methods in `SessionStore` to manage this artificial complexity - 11 methods in `SessionStore` to manage this artificial complexity
- Auto-creation logic scattered across 3 locations - Auto-creation logic scattered across 3 locations
- A cleanup hook that "completed" sessions at the end - A cleanup hook that "completed" sessions at the end
**Why?** Because it seemed "robust." Because "what if the session doesn't exist?" **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. 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 ## The Pattern of Failure
Every time a bug appeared, Claude's instinct was to **ADD** more code: Every time a bug appeared, Claude's instinct was to **ADD** more code:
| Bug | What Claude Added | What Should Have Happened | | Bug | What Claude Added | What Should Have Happened |
|-----|------------------|--------------------------| |-----|------------------|--------------------------|
| Race conditions | Auto-create fallbacks | Delete the auto-create logic | | Race conditions | Auto-create fallbacks | Delete the auto-create logic |
| Duplicate observations | Validation layers | Delete the code path allowing duplicates | | Duplicate observations | Validation layers | Delete the code path allowing duplicates |
| UNIQUE constraint violations | Try-catch with fallbacks | Use `INSERT OR IGNORE` (5 characters) | | 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) | | Session not found | Silent auto-creation | **FAIL LOUDLY** (it's a hook bug) |
--- ---
## The 7+ Failed Attempts ## The 7+ Failed Attempts
- **Nov 4**: "Always store session data regardless of pre-existence." Complexity planted. - **Nov 4**: "Always store session data regardless of pre-existence." Complexity planted.
- **Nov 11**: `INSERT OR IGNORE` recognized. But complexity documented, not removed. - **Nov 11**: `INSERT OR IGNORE` recognized. But complexity documented, not removed.
- **Nov 21**: Duplicate observations bug. Fixed. Then broken again by endless mode. - **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 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 20**: "Phase 2: Eliminated Race Conditions" — felt like progress. Complexity remained.
- **Dec 24**: Finally, forced deletion. - **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 user stated "hooks provide session IDs, no extra management needed" **seven times** across months. Claude didn't listen.
--- ---
## The Fix ## The Fix
### Deleted (984 lines): ### Deleted (984 lines):
- 11 `SessionStore` methods: `incrementPromptCounter`, `getPromptCounter`, `setWorkerPort`, `getWorkerPort`, `markSessionCompleted`, `markSessionFailed`, `reactivateSession`, `findActiveSDKSession`, `findAnySDKSession`, `updateSDKSessionId` - 11 `SessionStore` methods: `incrementPromptCounter`, `getPromptCounter`, `setWorkerPort`, `getWorkerPort`, `markSessionCompleted`, `markSessionFailed`, `reactivateSession`, `findActiveSDKSession`, `findAnySDKSession`, `updateSDKSessionId`
- Auto-create logic from `storeObservation` and `storeSummary` - Auto-create logic from `storeObservation` and `storeSummary`
- The entire cleanup hook (was aborting SDK agent and causing data loss) - The entire cleanup hook (was aborting SDK agent and causing data loss)
- 117 lines from `worker-utils.ts` - 117 lines from `worker-utils.ts`
### What remains (~10 lines): ### What remains (~10 lines):
```javascript ```javascript
createSDKSession(sessionId) { createSDKSession(sessionId) {
db.run('INSERT OR IGNORE INTO sdk_sessions (...) VALUES (...)'); db.run('INSERT OR IGNORE INTO sdk_sessions (...) VALUES (...)');
return db.query('SELECT id FROM sdk_sessions WHERE ...').get(sessionId); return db.query('SELECT id FROM sdk_sessions WHERE ...').get(sessionId);
} }
``` ```
**That's it.** **That's it.**
--- ---
## Behavior Change ## Behavior Change
- **Before:** Missing session? Auto-create silently. Bug hidden. - **Before:** Missing session? Auto-create silently. Bug hidden.
- **After:** Missing session? Storage fails. Bug visible immediately. - **After:** Missing session? Storage fails. Bug visible immediately.
--- ---
## New Tools ## New Tools
Since we're now explicit about recovery instead of silently papering over problems: Since we're now explicit about recovery instead of silently papering over problems:
- `GET /api/pending-queue` - See what's stuck - `GET /api/pending-queue` - See what's stuck
- `POST /api/pending-queue/process` - Manually trigger recovery - `POST /api/pending-queue/process` - Manually trigger recovery
- `npm run queue:check` / `npm run queue:process` - CLI equivalents - `npm run queue:check` / `npm run queue:process` - CLI equivalents
--- ---
## Dependencies ## Dependencies
- Upgraded `@anthropic-ai/claude-agent-sdk` from `^0.1.67` to `^0.1.76` - Upgraded `@anthropic-ai/claude-agent-sdk` from `^0.1.67` to `^0.1.76`
--- ---
**PR #437:** https://github.com/thedotmack/claude-mem/pull/437 **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.* *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 ## [8.0.6] - 2025-12-24
@@ -686,13 +665,13 @@ This represents a major reliability improvement for Windows users, eliminating c
## [7.3.5] - 2025-12-17 ## [7.3.5] - 2025-12-17
## What's Changed ## What's Changed
* fix(windows): solve zombie port problem with wrapper architecture by @ToxMox in https://github.com/thedotmack/claude-mem/pull/372 * 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 * chore: bump version to 7.3.5 by @thedotmack in https://github.com/thedotmack/claude-mem/pull/375
## New Contributors ## New Contributors
* @ToxMox made their first contribution in https://github.com/thedotmack/claude-mem/pull/372 * @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 **Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v7.3.4...v7.3.5
## [7.3.4] - 2025-12-17 ## [7.3.4] - 2025-12-17
@@ -3222,12 +3201,12 @@ None (patch version)
## [4.3.0] - 2025-10-25 ## [4.3.0] - 2025-10-25
## What's Changed ## 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 * feat: Enhanced context hook with session observations and cross-platform improvements by @thedotmack in https://github.com/thedotmack/claude-mem/pull/25
## New Contributors ## New Contributors
* @thedotmack made their first contribution in https://github.com/thedotmack/claude-mem/pull/25 * @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 **Full Changelog**: https://github.com/thedotmack/claude-mem/compare/v4.2.11...v4.3.0
## [4.2.10] - 2025-10-25 ## [4.2.10] - 2025-10-25