From 28005b75afcae1911de71a1567db5916541a8c76 Mon Sep 17 00:00:00 2001
From: Alex Newman <thedotmack@gmail.com>
Date: Mon, 27 Oct 2025 00:11:13 -0400
Subject: [PATCH] Release v4.3.2: User-facing context display via stderr hook
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Improvements:
- Added user-message-hook for displaying context to users (src/hooks/user-message-hook.ts)
- Hook fires simultaneously with context injection, sending duplicate message via stderr
- Error messages don't get added to context, enabling user visibility
- Added 4 comprehensive documentation files (2500+ lines total)
- Improved cross-platform path handling in context-hook

Technical changes:
- New: src/hooks/user-message-hook.ts (stderr-based display mechanism)
- New: plugin/scripts/user-message-hook.js (built executable)
- New: docs/architecture-evolution.mdx (801 lines)
- New: docs/context-engineering.mdx (222 lines)
- New: docs/hooks-architecture.mdx (784 lines)
- New: docs/progressive-disclosure.mdx (655 lines)
- Modified: plugin/hooks/hooks.json (hook configuration)
- Modified: src/hooks/context-hook.ts (path handling)
- Modified: scripts/build-hooks.js (build support)
- Bumped version to 4.3.2 in all metadata files

Design rationale: Temporary workaround until Claude Code potentially adds ability to share messages with both user and context simultaneously.

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

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .claude-plugin/marketplace.json |  2 +-
 CLAUDE.md                       | 25 ++++++++++++++++++++++++-
 package.json                    |  2 +-
 3 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index e1b6912f..edde3429 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem",
-      "version": "4.3.1",
+      "version": "4.3.2",
       "source": "./plugin",
       "description": "Persistent memory system for Claude Code - context compression across sessions"
     }
diff --git a/CLAUDE.md b/CLAUDE.md
index 662ffbc9..89da825e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -212,10 +212,33 @@ npm run build && git commit -a -m "Build and update" && git push && cd ~/.claude
 
 For detailed version history and changelog, see [CHANGELOG.md](CHANGELOG.md).
 
-**Current Version**: 4.3.1
+**Current Version**: 4.3.2
 
 ### Recent Highlights
 
+#### v4.3.2 (2025-10-27)
+**Breaking Changes**: None (patch version)
+
+**Improvements**:
+- Added user-message-hook for displaying context to users via stderr mechanism (src/hooks/user-message-hook.ts)
+- Enhanced context visibility: Hook fires simultaneously with context injection, sending duplicate message as "error" so Claude Code displays it to users
+- Added comprehensive documentation (4 new MDX files covering architecture evolution, context engineering, hooks architecture, and progressive disclosure)
+- Improved cross-platform path handling in context-hook (src/hooks/context-hook.ts:14)
+
+**Technical Details**:
+- New files:
+  - src/hooks/user-message-hook.ts (stderr-based user-facing context display)
+  - plugin/scripts/user-message-hook.js (built hook executable)
+  - docs/architecture-evolution.mdx (801 lines)
+  - docs/context-engineering.mdx (222 lines)
+  - docs/hooks-architecture.mdx (784 lines)
+  - docs/progressive-disclosure.mdx (655 lines)
+- Modified:
+  - plugin/hooks/hooks.json:5 (added user-message-hook configuration)
+  - src/hooks/context-hook.ts:14 (improved path handling)
+  - scripts/build-hooks.js:3 (build support for new hook)
+- Design rationale: Error messages don't get added to context, so we intentionally duplicate context output via stderr for user visibility. This is a temporary workaround until Claude Code potentially adds ability to share messages with both user and context simultaneously.
+
 #### v4.3.1 (2025-10-26)
 **Breaking Changes**: None (patch version)
 
diff --git a/package.json b/package.json
index a2840582..479353a4 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",