From 268b78083e6c234627d165b1c9bb06d05520bf11 Mon Sep 17 00:00:00 2001
From: Alex Newman <thedotmack@gmail.com>
Date: Wed, 5 Nov 2025 14:24:50 -0500
Subject: [PATCH] Release v5.0.3: Smart caching installer for Windows
 compatibility
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

**Breaking Changes**: None (patch version)

**Fixes**:
- Fixed Windows installation with smart caching installer
- Eliminated redundant npm install on every SessionStart (2-5s → 10ms)
- Dynamic Python version detection in Windows error messages
- Comprehensive Windows troubleshooting guidance

**Improvements**:
- Smart install caches version state (.install-version file)
- Only runs npm install when needed (first time, version change, missing deps)
- Enhanced rsync to respect gitignore rules
- Better PM2 worker startup verification
- Cross-platform compatible (pure Node.js)

**Technical Details**:
- New: scripts/smart-install.js (smart caching installer)
- Modified: plugin/hooks/hooks.json (use smart-install.js)
- Modified: package.json (enhanced sync-marketplace)
- Impact: 200x faster SessionStart for cached installations

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

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

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 3e3e3670..c8c89736 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem",
-      "version": "5.0.2",
+      "version": "5.0.3",
       "source": "./plugin",
       "description": "Persistent memory system for Claude Code - context compression across sessions"
     }
diff --git a/CLAUDE.md b/CLAUDE.md
index 47b90dda..990bed9e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -318,10 +318,35 @@ This approach is especially valuable when:
 
 For detailed version history and changelog, see [CHANGELOG.md](CHANGELOG.md).
 
-**Current Version**: 5.0.2
+**Current Version**: 5.0.3
 
 ### Recent Highlights
 
+#### v5.0.3 (2025-11-05)
+**Breaking Changes**: None (patch version)
+
+**Fixes**:
+- Fixed Windows installation with smart caching installer (PR #54: scripts/smart-install.js)
+- Eliminated redundant npm install executions on every SessionStart (improved from 2-5s to ~10ms)
+- Added comprehensive Windows troubleshooting with VS Build Tools guidance
+- Fixed dynamic Python version detection in Windows error messages (scripts/smart-install.js:106-115)
+
+**Improvements**:
+- Smart install now caches version state in `.install-version` file
+- Only runs npm install when needed: first time, version change, or missing dependencies
+- Enhanced rsync to respect gitignore rules in sync-marketplace (package.json:38)
+- Better PM2 worker startup verification and management
+- Cross-platform compatible installer (pure Node.js, no shell dependencies)
+
+**Technical Details**:
+- New: scripts/smart-install.js (smart caching installer with PM2 worker management)
+- Modified: plugin/hooks/hooks.json:25 (use smart-install.js instead of raw npm install)
+- Modified: .gitignore (added .install-version cache file)
+- Modified: CLAUDE.md (added Windows requirements and troubleshooting section)
+- Modified: package.json:38 (enhanced sync-marketplace with --filter=':- .gitignore' --exclude=.git)
+- Root cause: npm install was running on every SessionStart regardless of whether dependencies changed
+- Impact: 200x faster SessionStart for cached installations (10ms vs 2-5s)
+
 #### v5.0.2 (2025-11-04)
 **Breaking Changes**: None (patch version)
 
diff --git a/package.json b/package.json
index e14df0f5..4ce61326 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "5.0.2",
+  "version": "5.0.3",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index 4945f2f7..bee98a97 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "5.0.2",
+  "version": "5.0.3",
   "description": "Persistent memory system for Claude Code - seamlessly preserve context across sessions",
   "author": {
     "name": "Alex Newman"