claude-self-reflect 2.4.12 → 2.4.14

package/Dockerfile.importer

@@ -5,12 +5,20 @@ WORKDIR /app
 # Update system packages for security
 RUN apt-get update && apt-get upgrade -y && rm -rf /var/lib/apt/lists/*
 
-# Install dependencies
-COPY scripts/requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
+# Install dependencies directly (avoids file path issues with global npm installs)
+RUN pip install --no-cache-dir \
+    qdrant-client==1.15.0 \
+    openai==1.97.1 \
+    mcp-server-qdrant==0.8.0 \
+    backoff==2.2.1 \
+    tqdm==4.67.1 \
+    humanize==4.12.3 \
+    fastembed==0.7.1 \
+    voyageai==0.3.4 \
+    tenacity==9.1.2
 
-# Copy only the unified import script
-COPY scripts/import-conversations-unified.py .
+# Note: The import script is mounted as a volume in docker-compose.yaml
+# This allows the container to work with both local development and global npm installs
 
-# Run the unified importer
-CMD ["python", "import-conversations-unified.py"]
+# Default command (can be overridden by docker-compose)
+CMD ["python", "--version"]

package/README.md

@@ -372,4 +372,19 @@ Special thanks to our contributors and security researchers:
 - **[@akamalov](https://github.com/akamalov)** - Highlighted Ubuntu WSL bug and helped educate about filesystem nuances
 - **[@kylesnowschwartz](https://github.com/kylesnowschwartz)** - Comprehensive security review leading to v2.3.3+ security improvements (#6)
 
+## Windows Configuration
+
+### Recommended: Use WSL
+For the best experience on Windows, we recommend using WSL (Windows Subsystem for Linux) which provides native Linux compatibility for Docker operations.
+
+### Alternative: Native Windows
+If using Docker Desktop on native Windows, you need to adjust the CONFIG_PATH in your `.env` file to use Docker-compatible paths:
+
+```bash
+# Replace USERNAME with your Windows username
+CONFIG_PATH=/c/Users/USERNAME/.claude-self-reflect/config
+```
+
+This ensures Docker can properly mount the config directory. The setup wizard creates the directory, but Windows users need to update the path format for Docker compatibility.
+
 MIT License. Built with ❤️ for the Claude community.

package/docker-compose.yaml

@@ -7,7 +7,7 @@ services:
     image: alpine
     command: chown -R 1000:1000 /config
     volumes:
-      - ./config:/config
+      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
     profiles: ["watch", "mcp", "import"]
 
   # Qdrant vector database - the heart of semantic search
@@ -36,7 +36,7 @@ services:
       - qdrant
     volumes:
       - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ./config:/config
+      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
       - ./scripts:/scripts:ro
     environment:
       - QDRANT_URL=http://qdrant:6333
@@ -64,7 +64,7 @@ services:
       - qdrant
     volumes:
       - ${CLAUDE_LOGS_PATH:-~/.claude/projects}:/logs:ro
-      - ./config:/config
+      - ${CONFIG_PATH:-~/.claude-self-reflect/config}:/config
       - ./scripts:/scripts:ro
     environment:
       - QDRANT_URL=http://qdrant:6333

package/installer/setup-wizard-docker.js

@@ -7,6 +7,7 @@ import fs from 'fs/promises';
 import fsSync from 'fs';
 import readline from 'readline';
 import path from 'path';
+import os from 'os';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -94,6 +95,40 @@ async function checkDocker() {
 async function configureEnvironment() {
   console.log('\n🔐 Configuring environment...');
   
+  // Setup config directory in user's home directory for global npm installs
+  const userConfigDir = join(os.homedir(), '.claude-self-reflect', 'config');
+  
+  try {
+    await fs.mkdir(userConfigDir, { recursive: true });
+    console.log(`📁 Using config directory: ${userConfigDir}`);
+    
+    // Migrate existing config from project directory if it exists
+    const oldConfigDir = join(projectRoot, 'config');
+    try {
+      await fs.access(oldConfigDir);
+      const files = await fs.readdir(oldConfigDir);
+      if (files.length > 0) {
+        console.log('🔄 Migrating existing config data...');
+        for (const file of files) {
+          const sourcePath = join(oldConfigDir, file);
+          const targetPath = join(userConfigDir, file);
+          try {
+            await fs.copyFile(sourcePath, targetPath);
+          } catch (err) {
+            // Ignore copy errors, file might already exist
+          }
+        }
+        console.log('✅ Config migration completed');
+      }
+    } catch {
+      // No old config directory, nothing to migrate
+    }
+  } catch (error) {
+    console.log(`❌ Could not create config directory: ${error.message}`);
+    console.log('   This may cause Docker mount issues. Please check permissions.');
+    throw error;
+  }
+  
   const envPath = join(projectRoot, '.env');
   let envContent = '';
   let hasValidApiKey = false;
@@ -153,6 +188,9 @@ async function configureEnvironment() {
   if (!envContent.includes('PREFER_LOCAL_EMBEDDINGS=')) {
     envContent += `PREFER_LOCAL_EMBEDDINGS=${localMode ? 'true' : 'false'}\n`;
   }
+  if (!envContent.includes('CONFIG_PATH=')) {
+    envContent += `CONFIG_PATH=${userConfigDir}\n`;
+  }
   
   await fs.writeFile(envPath, envContent.trim() + '\n');
   console.log('✅ Environment configured');

package/mcp-server/src/server.py

@@ -11,6 +11,7 @@ import hashlib
 import time
 
 from fastmcp import FastMCP, Context
+from .utils import normalize_project_name
 from pydantic import BaseModel, Field
 from qdrant_client import AsyncQdrantClient, models
 from qdrant_client.models import (
@@ -233,8 +234,9 @@ async def reflect_on_past(
         # Filter collections by project if not searching all
         project_collections = []  # Define at this scope for later use
         if target_project != 'all':
-            # Generate the collection name pattern for this project
-            project_hash = hashlib.md5(target_project.encode()).hexdigest()[:8]
+            # Generate the collection name pattern for this project using normalized name
+            normalized_name = normalize_project_name(target_project)
+            project_hash = hashlib.md5(normalized_name.encode()).hexdigest()[:8]
             project_collections = [
                 c for c in all_collections 
                 if c.startswith(f"conv_{project_hash}_")

package/mcp-server/src/utils.py

@@ -0,0 +1,53 @@
+"""Shared utilities for claude-self-reflect MCP server and scripts."""
+
+from pathlib import Path
+
+
+def normalize_project_name(project_path: str) -> str:
+    """
+    Normalize project name for consistent hashing across import/search.
+    
+    Handles various path formats:
+    - Claude logs format: -Users-kyle-Code-claude-self-reflect -> claude-self-reflect
+    - Regular paths: /path/to/project -> project
+    - Already normalized: project -> project
+    
+    Args:
+        project_path: Project path or name in any format
+        
+    Returns:
+        Normalized project name suitable for consistent hashing
+    """
+    if not project_path:
+        return ""
+    
+    # Remove trailing slashes
+    project_path = project_path.rstrip('/')
+    
+    # Handle Claude logs format (starts with dash)
+    if project_path.startswith('-'):
+        # For paths like -Users-kyle-Code-claude-self-reflect
+        # We want to extract the actual project name which may contain dashes
+        # Strategy: Find common parent directories and extract what comes after
+        
+        # Remove leading dash and convert back to path-like format
+        path_str = project_path[1:].replace('-', '/')
+        path_parts = Path(path_str).parts
+        
+        # Look for common project parent directories
+        project_parents = {'projects', 'code', 'Code', 'repos', 'repositories', 
+                          'dev', 'Development', 'work', 'src', 'github'}
+        
+        # Find the project name after a known parent directory
+        for i, part in enumerate(path_parts):
+            if part.lower() in project_parents and i + 1 < len(path_parts):
+                # Everything after the parent directory is the project name
+                # Join remaining parts with dash if project name has multiple components
+                remaining = path_parts[i + 1:]
+                return '-'.join(remaining)
+        
+        # Fallback: just use the last component
+        return path_parts[-1] if path_parts else project_path
+    
+    # Handle regular paths - use basename
+    return Path(project_path).name

package/package.json

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

package/scripts/import-conversations-unified.py

@@ -14,6 +14,10 @@ from typing import List, Dict, Any
 import logging
 from pathlib import Path
 
+# Add the mcp-server/src directory to the Python path
+sys.path.insert(0, os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'mcp-server', 'src'))
+from utils import normalize_project_name
+
 from qdrant_client import QdrantClient
 from qdrant_client.models import (
     VectorParams, Distance, PointStruct,
@@ -343,10 +347,11 @@ def main():
     # Import each project
     total_imported = 0
     for project_dir in project_dirs:
-        # Create collection name from project path
-        collection_name = f"conv_{hashlib.md5(project_dir.name.encode()).hexdigest()[:8]}{collection_suffix}"
+        # Create collection name from normalized project name
+        normalized_name = normalize_project_name(project_dir.name)
+        collection_name = f"conv_{hashlib.md5(normalized_name.encode()).hexdigest()[:8]}{collection_suffix}"
         
-        logger.info(f"Importing project: {project_dir.name} -> {collection_name}")
+        logger.info(f"Importing project: {project_dir.name} (normalized: {normalized_name}) -> {collection_name}")
         chunks = import_project(project_dir, collection_name, state)
         total_imported += chunks
         logger.info(f"Imported {chunks} chunks from {project_dir.name}")