claude-self-reflect 7.1.13 → 7.1.15

package/README.md

@@ -205,6 +205,9 @@ Your code quality displayed live as you work:
 
 **9.3x Better Search Quality** • **50% Cost Savings** • **Fully Automated**
 
+> [!IMPORTANT]
+> **Opt-In Feature**: AI narratives require an Anthropic API key and are **enabled during CLI setup** when you answer "yes" to "Enable AI-powered narratives?". This sends conversation data to Anthropic for processing. Without an API key, CSR works normally with local-only search.
+
 v7.0 introduces AI-powered conversation narratives that transform raw conversation excerpts into rich problem-solution summaries with comprehensive metadata extraction.
 
 ### Before/After Comparison

package/installer/setup-wizard-docker.js

@@ -537,7 +537,7 @@ async function enrichMetadata() {
         '-e', 'RATE_LIMIT_DELAY=0.5',
         '-e', 'MAX_CONCURRENT_UPDATES=2',
         'importer',
-        'python', '/app/scripts/delta-metadata-update-safe.py'
+        'python', '/app/src/runtime/delta-metadata-update-safe.py'
       ], {
         cwd: projectRoot,
         stdio: 'inherit'
@@ -548,12 +548,12 @@ async function enrichMetadata() {
     } catch (error) {
       console.log('\n⚠️  Metadata enrichment had some issues but continuing setup');
       console.log('   You can retry later with:');
-      console.log('   docker compose run --rm importer python /app/scripts/delta-metadata-update-safe.py');
+      console.log('   docker compose run --rm importer python /app/src/runtime/delta-metadata-update-safe.py');
     }
   } else {
     console.log('\n📝 Skipping metadata enrichment.');
     console.log('   You can run it later with:');
-    console.log('   docker compose run --rm importer python /app/scripts/delta-metadata-update-safe.py');
+    console.log('   docker compose run --rm importer python /app/src/runtime/delta-metadata-update-safe.py');
   }
 }
 
@@ -770,7 +770,7 @@ async function showFinalInstructions() {
   console.log('   • Check status: docker compose ps');
   console.log('   • View logs: docker compose logs -f');
   console.log('   • Import conversations: docker compose run --rm importer');
-  console.log('   • Enrich metadata: docker compose run --rm importer python /app/scripts/delta-metadata-update-safe.py');
+  console.log('   • Enrich metadata: docker compose run --rm importer python /app/src/runtime/delta-metadata-update-safe.py');
   console.log('   • Start watcher: docker compose --profile watch up -d');
   console.log('   • Ralph hooks: ./scripts/ralph/install_hooks.sh --check');
   console.log('   • Stop all: docker compose down');
@@ -817,7 +817,7 @@ async function checkExistingInstallation() {
         console.log('\n📋 Quick Commands:');
         console.log('   • View status: docker compose ps');
         console.log('   • View logs: docker compose logs -f');
-        console.log('   • Enrich metadata: docker compose run --rm importer python /app/scripts/delta-metadata-update-safe.py');
+        console.log('   • Enrich metadata: docker compose run --rm importer python /app/src/runtime/delta-metadata-update-safe.py');
         console.log('   • Restart: docker compose restart');
         console.log('   • Stop: docker compose down');
         

package/mcp-server/pyproject.toml

@@ -16,6 +16,7 @@ dependencies = [
     "pydantic-settings>=2.0.0,<3.0.0",
     "fastembed>=0.4.0,<1.0.0",
     "dependency-injector>=4.0.0,<5.0.0",
+    "aiofiles>=23.0.0,<25.0.0",
 ]
 
 [project.scripts]

package/mcp-server/requirements.txt

@@ -6,3 +6,4 @@ pydantic>=2.0.0
 pydantic-settings>=2.0.0
 numpy>=1.24.0
 fastembed>=0.2.0
+aiofiles>=23.0.0,<25.0.0

package/package.json

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

package/scripts/requirements.txt

@@ -1,9 +1,9 @@
-qdrant-client==1.15.1
+qdrant-client==1.16.0
 mcp-server-qdrant==0.8.0
 backoff==2.2.1
 tqdm==4.67.1
-humanize==4.13.0
+humanize==4.14.0
 fastembed==0.7.3
 voyageai==0.3.5
 tenacity==9.1.2
-psutil==7.0.0
+psutil==7.1.3

package/src/runtime/batch_watcher.py

@@ -291,10 +291,10 @@ class BatchWatcher:
         logger.info(f"   Files: {len(batch_files)}")
         logger.info(f"{'='*60}\n")
 
-        try:
-            import subprocess
+        import subprocess
 
-            # Run batch import script with configurable timeout
+        # Step 1: Run the batch import
+        try:
             result = subprocess.run(
                 [sys.executable, str(BATCH_IMPORT_SCRIPT)],
                 capture_output=True,
@@ -306,29 +306,35 @@ class BatchWatcher:
             logger.info("\n✅ Batch triggered successfully")
             logger.info("   Output:\n%s", result.stdout)
 
-            # Mark files as processed
-            for entry in batch_files:
-                self.state_manager.add_imported_file(
-                    file_path=entry["file_path"],
-                    chunks=0,  # Will be updated by batch import
-                    metadata={"batch_queued": True}
-                )
-
         except subprocess.CalledProcessError as cpe:
             logger.error("❌ Batch import failed (rc=%s)", cpe.returncode)
             logger.error("   Stdout: %s", cpe.stdout)
             logger.error("   Stderr: %s", cpe.stderr)
 
-            # Re-queue failed files
+            # Re-queue only on actual batch failure
             for entry in batch_files:
                 self.batch_queue.add(entry["file_path"], entry["project"])
+            return
 
-        except Exception as e:
-            logger.error("❌ Error triggering batch: %s", e, exc_info=True)
+        except subprocess.TimeoutExpired as te:
+            logger.error("❌ Batch import timed out after %ss", SUBPROCESS_TIMEOUT_SECONDS)
 
-            # Re-queue failed files
+            # Re-queue on timeout
             for entry in batch_files:
                 self.batch_queue.add(entry["file_path"], entry["project"])
+            return
+
+        # Step 2: Mark files as processed (batch succeeded, don't re-queue on failure here)
+        for entry in batch_files:
+            try:
+                self.state_manager.add_imported_file(
+                    file_path=entry["file_path"],
+                    chunks=0,
+                    importer="batch",
+                    status="completed"
+                )
+            except Exception as e:
+                logger.warning("⚠️ Failed to mark %s as processed: %s", entry["file_path"], e)
 
     def _hot_cycle(self):
         """Fast cycle to check for HOT files only."""

package/src/runtime/import-conversations-unified.py

@@ -51,6 +51,7 @@ logger = logging.getLogger(__name__)
 # Constants
 QDRANT_URL = os.getenv("QDRANT_URL", "http://localhost:6333")
 MAX_CHUNK_SIZE = int(os.getenv("MAX_CHUNK_SIZE", "50"))
+LOGS_DIR = os.getenv("LOGS_DIR", os.path.expanduser("~/.claude/projects"))
 
 
 class ConversationImporter:
@@ -327,8 +328,8 @@ def main():
             sys.exit(1)
         projects = [project_path]
     else:
-        # Import all projects
-        claude_dir = Path.home() / ".claude" / "projects"
+        # Import all projects (supports LOGS_DIR env var for Docker)
+        claude_dir = Path(LOGS_DIR).expanduser().resolve()
         if not claude_dir.exists():
             logger.error(f"Claude projects directory not found: {claude_dir}")
             sys.exit(1)

package/src/runtime/unified_state_manager.py

@@ -364,39 +364,39 @@ class UnifiedStateManager:
                 break
 
         # Validate path is within allowed directories
+        # Base allowed paths for local environment
         allowed_bases = [
             Path.home() / ".claude",
             Path.home() / ".claude-self-reflect",
         ]
 
-        # Add Docker paths if they exist
-        for docker_path in docker_paths:
-            docker_base = Path(docker_path)
-            if docker_base.exists():
-                allowed_bases.append(docker_base)
-
         # Check if path is within allowed directories
         path_allowed = False
 
         # In Docker: validate original path against Docker mounts
+        # Note: No existence check needed - relative_to() works mathematically on paths
+        # Docker paths only added to allowed_bases when actually running in Docker context
         if is_docker_path:
+            # Add Docker mount paths only when validating Docker paths (security: don't widen trust on local)
+            docker_allowed_bases = allowed_bases.copy()
+            for docker_path in docker_paths:
+                docker_allowed_bases.append(Path(docker_path))
+
             original_resolved = Path(original_path_str).resolve()
-            for base in allowed_bases:
+            for base in docker_allowed_bases:
                 try:
-                    if base.exists():
-                        original_resolved.relative_to(base)
-                        path_allowed = True
-                        break
+                    original_resolved.relative_to(base)
+                    path_allowed = True
+                    break
                 except ValueError:
                     continue
         else:
-            # Local environment: validate transformed path
+            # Local environment: validate transformed path (no Docker paths in allowed list)
             for base in allowed_bases:
                 try:
-                    if base.exists():
-                        resolved.relative_to(base)
-                        path_allowed = True
-                        break
+                    resolved.relative_to(base)
+                    path_allowed = True
+                    break
                 except ValueError:
                     continue