claude-self-reflect 5.0.2 → 5.0.4

package/docker-compose.yaml

@@ -18,7 +18,9 @@ services:
       - "${QDRANT_PORT:-6333}:6333"
     volumes:
       - qdrant_data:/qdrant/storage
-      - ./config/qdrant-config.yaml:/qdrant/config/config.yaml:ro
+      # Note: Using CONFIG_PATH variable to support global npm installs (fixes #71)
+      # macOS Docker Desktop restricts mounts to /Users, /Volumes, /private, /tmp
+      - ${CONFIG_PATH:-~/.claude-self-reflect/config}/qdrant-config.yaml:/qdrant/config/config.yaml:ro
     environment:
       - QDRANT__LOG_LEVEL=INFO
       - QDRANT__SERVICE__HTTP_PORT=6333

package/installer/setup-wizard-docker.js

@@ -71,23 +71,64 @@ async function checkDocker() {
   try {
     safeExec('docker', ['info'], { stdio: 'ignore' });
     console.log('✅ Docker is installed and running');
-    
+
     // Check docker compose
     try {
       safeExec('docker', ['compose', 'version'], { stdio: 'ignore' });
-      console.log('✅ Docker Compose v2 is available');
+      console.log('✅ Docker Compose is available');
       return true;
     } catch {
-      console.log('❌ Docker Compose v2 not found');
-      console.log('   Please update Docker Desktop to the latest version');
+      console.log('❌ Docker Compose not found');
+      console.log('   Please update Docker Desktop to include Compose v2');
       return false;
     }
   } catch {
-    console.log('❌ Docker is not running or not installed');
-    console.log('\n📋 Please install Docker:');
-    console.log('   • macOS/Windows: https://docker.com/products/docker-desktop');
-    console.log('   • Linux: https://docs.docker.com/engine/install/');
-    console.log('\n   After installation, make sure Docker is running and try again.');
+    console.log('❌ Docker is not running or not installed\n');
+    console.log('📋 Claude Self-Reflect requires Docker Desktop');
+    console.log('   (Includes Docker Engine + Compose - everything you need)\n');
+
+    const platform = process.platform;
+    const arch = process.arch;
+
+    if (platform === 'darwin') {
+      const archType = arch === 'arm64' ? 'Apple Silicon (M1/M2/M3/M4)' : 'Intel';
+      console.log(`🍎 macOS (${archType}) Installation:\n`);
+
+      if (arch === 'arm64') {
+        console.log('   Download: https://desktop.docker.com/mac/main/arm64/Docker.dmg');
+      } else {
+        console.log('   Download: https://desktop.docker.com/mac/main/amd64/Docker.dmg');
+      }
+
+      console.log('   1. Open the downloaded Docker.dmg');
+      console.log('   2. Drag Docker.app to Applications folder');
+      console.log('   3. Launch Docker Desktop from Applications');
+      console.log('   4. Wait for Docker to start (whale icon in menu bar)');
+      console.log('   5. Re-run: claude-self-reflect setup\n');
+
+    } else if (platform === 'win32') {
+      console.log('🪟 Windows Installation:\n');
+      console.log('   Download: https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe');
+      console.log('   1. Run the installer');
+      console.log('   2. Follow installation prompts');
+      console.log('   3. Restart computer if prompted');
+      console.log('   4. Launch Docker Desktop');
+      console.log('   5. Re-run: claude-self-reflect setup\n');
+
+    } else {
+      console.log('🐧 Linux Installation:\n');
+      console.log('   Install Docker Engine (includes Compose):');
+      console.log('   • Ubuntu/Debian: https://docs.docker.com/engine/install/ubuntu/');
+      console.log('   • Fedora: https://docs.docker.com/engine/install/fedora/');
+      console.log('   • Arch: https://wiki.archlinux.org/title/docker');
+      console.log('   • CentOS: https://docs.docker.com/engine/install/centos/\n');
+    }
+
+    console.log('ℹ️  Docker Desktop is free for:');
+    console.log('   • Personal use');
+    console.log('   • Small businesses (<250 employees, <$10M revenue)');
+    console.log('   • Education and open source projects\n');
+
     return false;
   }
 }
@@ -123,6 +164,20 @@ async function configureEnvironment() {
     } catch {
       // No old config directory, nothing to migrate
     }
+
+    // Copy qdrant-config.yaml from npm package to user config directory
+    // This is critical for global npm installs where Docker cannot mount from /opt/homebrew
+    const sourceQdrantConfig = join(projectRoot, 'config', 'qdrant-config.yaml');
+    const targetQdrantConfig = join(userConfigDir, 'qdrant-config.yaml');
+    try {
+      await fs.copyFile(sourceQdrantConfig, targetQdrantConfig);
+      console.log('✅ Qdrant config copied to user directory');
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        console.log('⚠️  Could not copy qdrant-config.yaml:', err.message);
+        console.log('   Docker may have issues starting Qdrant service');
+      }
+    }
   } catch (error) {
     console.log(`❌ Could not create config directory: ${error.message}`);
     console.log('   This may cause Docker mount issues. Please check permissions.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-self-reflect",
-  "version": "5.0.2",
+  "version": "5.0.4",
   "description": "Give Claude perfect memory of all your conversations - Installation wizard for Python MCP server",
   "keywords": [
     "claude",

package/scripts/ast_grep_final_analyzer.py

@@ -257,15 +257,18 @@ class FinalASTGrepAnalyzer:
         return '\n'.join(report)
 
 
-def run_final_analysis():
+def run_final_analysis(file_path=None):
     """Run final AST-GREP analysis with unified registry."""
     print("🚀 FINAL AST-GREP Analysis with Unified Registry")
     print("=" * 60)
 
     analyzer = FinalASTGrepAnalyzer()
 
-    # Analyze server.py
-    server_path = "/Users/ramakrishnanannaswamy/projects/claude-self-reflect/mcp-server/src/server.py"
+    # Use provided path or default
+    # Use relative path from script location
+    script_dir = Path(__file__).parent
+    default_path = script_dir.parent / "mcp-server" / "src" / "server.py"
+    server_path = file_path if file_path else str(default_path)
 
     print(f"\nAnalyzing: {server_path}")
     print("-" * 40)
@@ -299,14 +302,14 @@ def run_final_analysis():
 
         # Generate and save report
         report = analyzer.generate_report(result)
-        report_path = "/Users/ramakrishnanannaswamy/projects/claude-self-reflect/scripts/final_analysis_report.md"
+        report_path = script_dir / "final_analysis_report.md"
         with open(report_path, 'w') as f:
             f.write(report)
 
         print(f"\n📝 Full report saved to: {report_path}")
 
         # Save JSON results
-        json_path = "/Users/ramakrishnanannaswamy/projects/claude-self-reflect/scripts/final_analysis_result.json"
+        json_path = script_dir / "final_analysis_result.json"
         with open(json_path, 'w') as f:
             json.dump(result, f, indent=2)
 
@@ -325,4 +328,11 @@ def run_final_analysis():
 
 
 if __name__ == "__main__":
-    run_final_analysis()
+    import sys
+    if len(sys.argv) > 1:
+        # Use provided file path
+        file_path = sys.argv[1]
+    else:
+        # Default to server.py
+        file_path = str(default_path)  # Use the same default path from above
+    run_final_analysis(file_path)

package/scripts/csr-status

@@ -6,6 +6,7 @@ Standalone script that doesn't require venv activation.
 
 import json
 import time
+import os
 from pathlib import Path
 from datetime import datetime, timedelta
 import sys
@@ -147,6 +148,51 @@ def format_statusline_quality(critical=0, medium=0, low=0):
 
 def get_session_health():
     """Get cached session health with icon-based quality display."""
+    # Get project-specific cache based on current directory
+    project_dir = os.getcwd()
+    project_name = os.path.basename(project_dir) if project_dir else "default"
+
+    # Check project-specific realtime cache first
+    quality_dir = Path.home() / ".claude-self-reflect" / "quality_by_project"
+    realtime_cache = quality_dir / f"{project_name}.json"
+
+    # Fallback to global cache if project-specific doesn't exist
+    if not realtime_cache.exists():
+        realtime_cache = Path.home() / ".claude-self-reflect" / "realtime_quality.json"
+
+    if realtime_cache.exists():
+        try:
+            # Check realtime cache age
+            mtime = datetime.fromtimestamp(realtime_cache.stat().st_mtime)
+            age = datetime.now() - mtime
+
+            if age < timedelta(minutes=5):  # Fresh realtime data
+                with open(realtime_cache, 'r') as f:
+                    realtime_data = json.load(f)
+
+                if "session_aggregate" in realtime_data:
+                    agg = realtime_data["session_aggregate"]
+                    issues = agg.get("total_issues", {})
+                    critical = issues.get("critical", 0)
+                    medium = issues.get("medium", 0)
+                    low = issues.get("low", 0)
+
+                    # Include score in display if significantly below threshold
+                    score = agg.get("average_score", 100)
+                    if critical > 0 or medium > 0 or low > 0:
+                        # Show issue counts when there are any issues
+                        return format_statusline_quality(critical, medium, low)
+                    elif score < 70:
+                        # Use red icon for scores below threshold (no issues but poor score)
+                        icon = "🔴"
+                        return f"{icon} {score:.0f}%"
+                    else:
+                        # Good quality, no issues
+                        return format_statusline_quality(critical, medium, low)
+        except Exception:
+            pass  # Fall back to old cache system
+
+    # Fall back to old cache system
     # Check for session edit tracker to show appropriate label
     tracker_file = Path.home() / ".claude-self-reflect" / "current_session_edits.json"
 
@@ -363,8 +409,63 @@ def get_compact_status():
             except:
                 pass
 
-    # Get quality grade - PER PROJECT cache
-    # BUG FIX: Cache must be per-project, not global!
+    # Get project-specific cache based on current directory
+    project_name = os.path.basename(os.getcwd()) if os.getcwd() else "default"
+
+    # Check project-specific realtime cache first
+    quality_dir = Path.home() / ".claude-self-reflect" / "quality_by_project"
+    realtime_cache = quality_dir / f"{project_name}.json"
+
+    # Fallback to global cache if project-specific doesn't exist
+    if not realtime_cache.exists():
+        realtime_cache = Path.home() / ".claude-self-reflect" / "realtime_quality.json"
+
+    grade_str = ""
+    quality_valid = False
+
+    if realtime_cache.exists():
+        try:
+            mtime = datetime.fromtimestamp(realtime_cache.stat().st_mtime)
+            age = datetime.now() - mtime
+            if age < timedelta(minutes=5):  # Fresh realtime data
+                with open(realtime_cache, 'r') as f:
+                    realtime_data = json.load(f)
+
+                if "session_aggregate" in realtime_data:
+                    agg = realtime_data["session_aggregate"]
+                    issues = agg.get("total_issues", {})
+                    critical = issues.get("critical", 0)
+                    medium = issues.get("medium", 0)
+                    low = issues.get("low", 0)
+                    score = agg.get("average_score", 100)
+
+                    # Get icon based on score and issues
+                    if score < 70:
+                        icon = "🔴"  # Red for below threshold
+                    else:
+                        icon = get_quality_icon(critical, medium, low)
+
+                    # Build compact display
+                    if critical > 0 or medium > 0 or low > 0:
+                        # Show issue counts when there are any issues
+                        colored_parts = []
+                        if critical > 0:
+                            colored_parts.append(f"C:{critical}")
+                        if medium > 0:
+                            colored_parts.append(f"M:{medium}")
+                        if low > 0:
+                            colored_parts.append(f"L:{low}")
+                        grade_str = f"[{icon}:{'·'.join(colored_parts)}]"
+                    elif score < 70:
+                        # Show score when below threshold but no specific issues
+                        grade_str = f"[{icon}:{score:.0f}%]"
+                    else:
+                        grade_str = f"[{icon}]"
+                    quality_valid = True
+        except:
+            pass
+
+    # Setup cache file path for fallback
     project_name = os.path.basename(os.getcwd())
     # Secure sanitization with whitelist approach
     import re
@@ -372,21 +473,23 @@ def get_compact_status():
     cache_dir = Path.home() / ".claude-self-reflect" / "quality_cache"
     cache_file = cache_dir / f"{safe_project_name}.json"
 
-    # If the exact cache file doesn't exist, try to find one that ends with this project name
-    # This handles cases like "metafora-Atlas-gold.json" for project "Atlas-gold"
-    if not cache_file.exists():
-        # Look for files ending with the project name
-        possible_files = list(cache_dir.glob(f"*-{safe_project_name}.json"))
-        if possible_files:
-            cache_file = possible_files[0]  # Use the first match
-
-    # Validate cache file path stays within cache directory
-    if cache_file.exists() and not str(cache_file.resolve()).startswith(str(cache_dir.resolve())):
-        # Security issue - return placeholder
-        grade_str = "[...]"
-    else:
-        cache_file.parent.mkdir(exist_ok=True, parents=True)
-    grade_str = ""
+    # Fall back to old cache if no realtime data
+    if not quality_valid:
+
+        # If the exact cache file doesn't exist, try to find one that ends with this project name
+        # This handles cases like "metafora-Atlas-gold.json" for project "Atlas-gold"
+        if not cache_file.exists():
+            # Look for files ending with the project name
+            possible_files = list(cache_dir.glob(f"*-{safe_project_name}.json"))
+            if possible_files:
+                cache_file = possible_files[0]  # Use the first match
+
+        # Validate cache file path stays within cache directory
+        if cache_file.exists() and not str(cache_file.resolve()).startswith(str(cache_dir.resolve())):
+            # Security issue - return placeholder
+            grade_str = "[...]"
+        else:
+            cache_file.parent.mkdir(exist_ok=True, parents=True)
 
     # Try to get quality data (regenerate if too old or missing)
     quality_valid = False

package/scripts/debug-august-parsing.py

@@ -59,7 +59,11 @@ def parse_jsonl_file(file_path):
     return messages
 
 if __name__ == "__main__":
-    file_path = "/Users/ramakrishnanannaswamy/.claude/projects/-Users-ramakrishnanannaswamy-projects-claude-self-reflect/7b3354ed-d6d2-4eab-b328-1fced4bb63bb.jsonl"
+    # Use home directory path
+    from pathlib import Path
+    home = Path.home()
+    file_path = home / ".claude" / "projects" / f"-{home}-projects-claude-self-reflect" / "7b3354ed-d6d2-4eab-b328-1fced4bb63bb.jsonl"
+    file_path = str(file_path)
     
     print(f"Parsing: {file_path}")
     print("=" * 60)

package/scripts/debug-project-resolver.py

@@ -48,9 +48,9 @@ from shared.normalization import normalize_project_name
 import hashlib
 
 test_paths = [
-    "/Users/ramakrishnanannaswamy/projects/claude-self-reflect",
-    "/Users/ramakrishnanannaswamy/projects/memento",
-    "/Users/ramakrishnanannaswamy/projects/cc-enhance"
+    str(Path.home() / "projects" / "claude-self-reflect"),
+    str(Path.home() / "projects" / "memento"),
+    str(Path.home() / "projects" / "cc-enhance")
 ]
 
 for path in test_paths: