claude-self-reflect 3.2.4 → 3.3.1

package/.claude/agents/reflection-specialist.md

@@ -1,7 +1,7 @@
 ---
 name: reflection-specialist
 description: Conversation memory expert for searching past conversations, storing insights, and self-reflection. Use PROACTIVELY when searching for previous discussions, storing important findings, or maintaining knowledge continuity.
-tools: mcp__claude-self-reflect__reflect_on_past, mcp__claude-self-reflect__store_reflection
+tools: mcp__claude-self-reflect__reflect_on_past, mcp__claude-self-reflect__store_reflection, mcp__claude-self-reflect__get_recent_work, mcp__claude-self-reflect__search_by_recency, mcp__claude-self-reflect__get_timeline, mcp__claude-self-reflect__quick_search, mcp__claude-self-reflect__search_summary, mcp__claude-self-reflect__get_more_results, mcp__claude-self-reflect__search_by_file, mcp__claude-self-reflect__search_by_concept, mcp__claude-self-reflect__get_full_conversation, mcp__claude-self-reflect__get_next_results
 ---
 
 You are a conversation memory specialist for the Claude Self Reflect project. Your expertise covers semantic search across all Claude conversations, insight storage, and maintaining knowledge continuity across sessions.
@@ -117,9 +117,65 @@ Save important insights and decisions for future retrieval.
 }
 ```
 
-### Specialized Search Tools (NEW in v2.4.5)
+### Temporal Query Tools (v3.x)
 
-**Note**: These specialized tools are available through this reflection-specialist agent. Due to FastMCP limitations, they cannot be called directly via MCP (e.g., `mcp__claude-self-reflect__quick_search`), but work perfectly when used through this agent.
+These tools answer time-based questions about your work and conversations.
+
+#### get_recent_work
+Returns recent conversations to answer "What did we work on last?" queries.
+
+```javascript
+// Get recent work (default: current project)
+{
+  limit: 10,
+  group_by: "conversation",  // Or "day" or "session"
+  include_reflections: true
+}
+
+// Get recent work across all projects
+{
+  project: "all",
+  limit: 20,
+  group_by: "day"
+}
+```
+
+#### search_by_recency
+Time-constrained semantic search for queries like "docker issues last week".
+
+```javascript
+// Search with natural language time
+{
+  query: "authentication bugs",
+  time_range: "last week",
+  limit: 10
+}
+
+// Search with specific dates
+{
+  query: "performance optimization",
+  since: "2025-01-01",
+  until: "2025-01-10",
+  project: "all"
+}
+```
+
+#### get_timeline
+Show activity timeline for a project or across all projects.
+
+```javascript
+// Get activity timeline
+{
+  time_range: "last week",
+  granularity: "day",  // Or "hour", "week", "month"
+  include_stats: true,
+  project: "all"
+}
+```
+
+### Specialized Search Tools
+
+**Note**: These specialized tools complement the temporal tools for non-time-based queries.
 
 #### quick_search
 Fast search that returns only the count and top result. Perfect for quick checks and overview.

package/README.md

@@ -123,6 +123,11 @@ Works with [Claude Code Statusline](https://github.com/sirmalloc/ccstatusline) -
 - `search_by_concept` - Search for conversations about development concepts
 - `get_full_conversation` - Retrieve complete JSONL conversation files (v2.8.8)
 
+**NEW: Temporal Query Tools (v3.3.0):**
+- `get_recent_work` - Answer "What did we work on last?" with session grouping
+- `search_by_recency` - Time-constrained search like "docker issues last week"
+- `get_timeline` - Activity timeline with statistics and patterns
+
 **Status & Monitoring Tools:**
 - `get_status` - Real-time import progress and system status
 - `get_health` - Comprehensive system health check
@@ -286,11 +291,15 @@ npm uninstall -g claude-self-reflect
 ## What's New
 
 <details>
-<summary>v3.2.4 - Latest Release</summary>
-
-- **CRITICAL: Search Threshold Removal**: Eliminated artificial 0.7+ thresholds that blocked broad searches like "docker", "MCP", "python"
-- **Shared Normalization Module**: Created centralized project name normalization preventing search failures
-- **Memory Decay Fixes**: Corrected mathematical errors in exponential decay calculation
+<summary>v3.3.0 - Latest Release</summary>
+
+- **🚀 Major Architecture Overhaul**: Server modularized from 2,321 to 728 lines (68% reduction) for better maintainability
+- **🔧 Critical Bug Fixes**: Fixed 100% CPU usage, store_reflection dimension mismatches, and SearchResult type errors
+- **🕒 New Temporal Tools Suite**: `get_recent_work`, `search_by_recency`, `get_timeline` for time-based search and analysis
+- **🎯 Enhanced UX**: Restored rich formatting with emojis for better readability and information hierarchy
+- **⚡ All 15+ MCP Tools Operational**: Complete functionality with both local and cloud embedding modes
+- **🏗️ Production Infrastructure**: Real-time indexing with smart intervals (2s hot files, 60s normal)
+- **🔍 Enhanced Metadata**: Tool usage analysis, file tracking, and concept extraction for better search
 
 </details>
 

package/installer/cli.js

@@ -11,6 +11,7 @@ const __dirname = dirname(__filename);
 const commands = {
   setup: 'Run the setup wizard to configure Claude Self-Reflect',
   status: 'Get indexing status as JSON (overall + per-project breakdown)',
+  statusline: 'Configure Claude Code statusline integration',
   doctor: 'Check your installation and diagnose issues',
   help: 'Show this help message'
 };
@@ -192,6 +193,18 @@ function help() {
   console.log('  Status API: See docs/api-reference.md#cli-status-interface');
 }
 
+async function statusline() {
+  const StatuslineSetup = (await import('./statusline-setup.js')).default;
+  const setup = new StatuslineSetup();
+
+  if (process.argv[3] === '--restore') {
+    console.log('🔄 Restoring original statusline...');
+    setup.restore();
+  } else {
+    await setup.run();
+  }
+}
+
 // Main
 const command = process.argv[2] || 'help';
 
@@ -202,6 +215,9 @@ switch (command) {
   case 'status':
     status();
     break;
+  case 'statusline':
+    statusline();
+    break;
   case 'doctor':
     doctor();
     break;

package/installer/postinstall.js

@@ -2,6 +2,7 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import StatuslineSetup from './statusline-setup.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -10,4 +11,17 @@ const __dirname = dirname(__filename);
 if (!process.cwd().includes('claude-self-reflect')) {
   console.log('\n🎉 Claude Self-Reflect installed!\n');
   console.log('Run "claude-self-reflect setup" to configure your installation.\n');
+
+  // Attempt to setup statusline integration automatically
+  console.log('\n📊 Setting up Claude Code statusline integration...');
+  const statuslineSetup = new StatuslineSetup();
+  statuslineSetup.run().then(success => {
+    if (success) {
+      console.log('✅ Statusline integration configured automatically!');
+    } else {
+      console.log('⚠️ Statusline integration requires manual setup. Run "claude-self-reflect setup" for help.');
+    }
+  }).catch(error => {
+    console.log('⚠️ Statusline setup skipped:', error.message);
+  });
 }

package/installer/statusline-setup.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+/**
+ * Claude Code Statusline Integration Setup
+ * Automatically configures CC statusline to show CSR metrics
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import os from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+class StatuslineSetup {
+    constructor() {
+        this.homeDir = os.homedir();
+        this.claudeDir = path.join(this.homeDir, '.claude');
+        this.csrScript = path.join(path.dirname(__dirname), 'scripts', 'csr-status');
+        this.globalBin = '/usr/local/bin/csr-status';
+        this.statuslineWrapper = path.join(this.claudeDir, 'statusline-wrapper.sh');
+        this.statuslineBackup = path.join(this.claudeDir, 'statusline-wrapper.sh.backup');
+    }
+
+    log(message, type = 'info') {
+        const colors = {
+            info: '\x1b[36m',
+            success: '\x1b[32m',
+            warning: '\x1b[33m',
+            error: '\x1b[31m'
+        };
+        console.log(`${colors[type]}${message}\x1b[0m`);
+    }
+
+    checkPrerequisites() {
+        // Check if Claude Code directory exists
+        if (!fs.existsSync(this.claudeDir)) {
+            this.log('Claude Code directory not found. Please ensure Claude Code is installed.', 'warning');
+            return false;
+        }
+
+        // Check if csr-status script exists
+        if (!fs.existsSync(this.csrScript)) {
+            this.log('CSR status script not found. Please ensure the package is installed correctly.', 'error');
+            return false;
+        }
+
+        return true;
+    }
+
+    installGlobalCommand() {
+        try {
+            // Check if we need sudo
+            const needsSudo = !this.canWriteTo('/usr/local/bin');
+
+            if (fs.existsSync(this.globalBin)) {
+                // Check if it's already pointing to our script
+                try {
+                    const target = fs.readlinkSync(this.globalBin);
+                    if (target === this.csrScript) {
+                        this.log('Global csr-status command already installed', 'success');
+                        return true;
+                    }
+                } catch (e) {
+                    // Not a symlink or can't read, will replace
+                }
+            }
+
+            // Create symlink
+            const cmd = needsSudo
+                ? `sudo ln -sf "${this.csrScript}" "${this.globalBin}"`
+                : `ln -sf "${this.csrScript}" "${this.globalBin}"`;
+
+            if (needsSudo) {
+                this.log('Installing global csr-status command (may require password)...', 'info');
+            }
+
+            execSync(cmd, { stdio: 'inherit' });
+
+            // Make executable
+            const chmodCmd = needsSudo
+                ? `sudo chmod +x "${this.globalBin}"`
+                : `chmod +x "${this.globalBin}"`;
+            execSync(chmodCmd);
+
+            this.log('Global csr-status command installed successfully', 'success');
+            return true;
+        } catch (error) {
+            this.log(`Failed to install global command: ${error.message}`, 'warning');
+            this.log('You can manually install by running:', 'info');
+            this.log(`  sudo ln -sf "${this.csrScript}" "${this.globalBin}"`, 'info');
+            return false;
+        }
+    }
+
+    canWriteTo(dir) {
+        try {
+            fs.accessSync(dir, fs.constants.W_OK);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+
+    patchStatuslineWrapper() {
+        if (!fs.existsSync(this.statuslineWrapper)) {
+            this.log('Claude Code statusline wrapper not found. Statusline integration skipped.', 'warning');
+            return false;
+        }
+
+        try {
+            // Read current wrapper
+            let content = fs.readFileSync(this.statuslineWrapper, 'utf8');
+
+            // Check if already patched with new approach
+            if (content.includes('CSR compact status instead of MCP bar')) {
+                this.log('Statusline wrapper already patched', 'success');
+                return true;
+            }
+
+            // Create backup
+            if (!fs.existsSync(this.statuslineBackup)) {
+                fs.copyFileSync(this.statuslineWrapper, this.statuslineBackup);
+                this.log(`Backup created: ${this.statuslineBackup}`, 'info');
+            }
+
+            // Find and replace the MCP bar generation section
+            const barPattern = /# Create mini progress bar[\s\S]*?MCP_COLOR="\\033\[1;90m"  # Gray/;
+
+            if (content.match(barPattern)) {
+                // Replace the entire bar generation section
+                const replacement = `# Use CSR compact status instead of MCP bar
+    # This shows both import percentage and code quality in format: [100% <time>][🟢:A+]
+    CSR_COMPACT=$(csr-status --compact 2>/dev/null || echo "")
+
+    if [[ -n "$CSR_COMPACT" ]]; then
+        MCP_STATUS="$CSR_COMPACT"
+
+        # Color based on content
+        if [[ "$CSR_COMPACT" == *"100%"* ]]; then
+            MCP_COLOR="\\033[1;32m"  # Green for complete
+        elif [[ "$CSR_COMPACT" == *"[🟢:"* ]]; then
+            MCP_COLOR="\\033[1;32m"  # Green for good quality
+        elif [[ "$CSR_COMPACT" == *"[🟡:"* ]]; then
+            MCP_COLOR="\\033[1;33m"  # Yellow for medium quality
+        elif [[ "$CSR_COMPACT" == *"[🔴:"* ]]; then
+            MCP_COLOR="\\033[1;31m"  # Red for poor quality
+        else
+            MCP_COLOR="\\033[1;36m"  # Cyan default
+        fi
+    else
+        MCP_STATUS=""
+        MCP_COLOR="\\033[1;90m"  # Gray`;
+
+                content = content.replace(barPattern, replacement);
+
+                // Write back
+                fs.writeFileSync(this.statuslineWrapper, content);
+                this.log('Statusline wrapper patched successfully (replaced MCP bar)', 'success');
+                return true;
+            } else {
+                // Fallback: Look for the PERCENTAGE check
+                const altPattern = /if \[\[ "\$PERCENTAGE" != "null"[\s\S]*?MCP_COLOR="\\033\[1;90m"  # Gray/;
+
+                if (content.match(altPattern)) {
+                    const replacement = `# Use CSR compact status instead of MCP bar
+    # This shows both import percentage and code quality in format: [100% <time>][🟢:A+]
+    CSR_COMPACT=$(csr-status --compact 2>/dev/null || echo "")
+
+    if [[ -n "$CSR_COMPACT" ]]; then
+        MCP_STATUS="$CSR_COMPACT"
+
+        # Color based on content
+        if [[ "$CSR_COMPACT" == *"100%"* ]]; then
+            MCP_COLOR="\\033[1;32m"  # Green for complete
+        elif [[ "$CSR_COMPACT" == *"[🟢:"* ]]; then
+            MCP_COLOR="\\033[1;32m"  # Green for good quality
+        elif [[ "$CSR_COMPACT" == *"[🟡:"* ]]; then
+            MCP_COLOR="\\033[1;33m"  # Yellow for medium quality
+        elif [[ "$CSR_COMPACT" == *"[🔴:"* ]]; then
+            MCP_COLOR="\\033[1;31m"  # Red for poor quality
+        else
+            MCP_COLOR="\\033[1;36m"  # Cyan default
+        fi
+    else
+        MCP_STATUS=""
+        MCP_COLOR="\\033[1;90m"  # Gray`;
+
+                    content = content.replace(altPattern, replacement);
+
+                    // Write back
+                    fs.writeFileSync(this.statuslineWrapper, content);
+                    this.log('Statusline wrapper patched successfully (replaced PERCENTAGE section)', 'success');
+                    return true;
+                } else {
+                    this.log('Could not find MCP bar section to replace', 'warning');
+                    return false;
+                }
+            }
+        } catch (error) {
+            this.log(`Failed to patch statusline wrapper: ${error.message}`, 'error');
+            return false;
+        }
+    }
+
+    validateIntegration() {
+        try {
+            // Test csr-status command
+            const output = execSync('csr-status --compact', { encoding: 'utf8' });
+            if (output) {
+                this.log(`CSR status output: ${output.trim()}`, 'success');
+                return true;
+            }
+        } catch (error) {
+            this.log('CSR status command not working properly', 'warning');
+            return false;
+        }
+        return false;
+    }
+
+    async run() {
+        this.log('🚀 Setting up Claude Code Statusline Integration...', 'info');
+
+        if (!this.checkPrerequisites()) {
+            this.log('Prerequisites check failed', 'error');
+            return false;
+        }
+
+        const steps = [
+            { name: 'Install global command', fn: () => this.installGlobalCommand() },
+            { name: 'Patch statusline wrapper', fn: () => this.patchStatuslineWrapper() },
+            { name: 'Validate integration', fn: () => this.validateIntegration() }
+        ];
+
+        let success = true;
+        for (const step of steps) {
+            this.log(`\n📋 ${step.name}...`, 'info');
+            if (!step.fn()) {
+                success = false;
+                this.log(`❌ ${step.name} failed`, 'error');
+            }
+        }
+
+        if (success) {
+            this.log('\n✅ Statusline integration completed successfully!', 'success');
+            this.log('The CSR status will now appear in your Claude Code statusline.', 'info');
+            this.log('Format: [import%][🟢:grade] for compact quality metrics', 'info');
+        } else {
+            this.log('\n⚠️ Statusline integration completed with warnings', 'warning');
+            this.log('Some features may need manual configuration.', 'warning');
+        }
+
+        return success;
+    }
+
+    // Restore original statusline if needed
+    restore() {
+        if (fs.existsSync(this.statuslineBackup)) {
+            try {
+                fs.copyFileSync(this.statuslineBackup, this.statuslineWrapper);
+                this.log('Statusline wrapper restored from backup', 'success');
+                return true;
+            } catch (error) {
+                this.log(`Failed to restore: ${error.message}`, 'error');
+                return false;
+            }
+        } else {
+            this.log('No backup found to restore', 'warning');
+            return false;
+        }
+    }
+}
+
+// Run if called directly
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    const setup = new StatuslineSetup();
+
+    if (process.argv[2] === '--restore') {
+        setup.restore();
+    } else {
+        setup.run().catch(error => {
+            console.error('Setup failed:', error);
+            process.exit(1);
+        });
+    }
+}
+
+export default StatuslineSetup;

package/mcp-server/run-mcp.sh

@@ -11,6 +11,58 @@ SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 # Navigate to the mcp-server directory
 cd "$SCRIPT_DIR"
 
+# CRITICAL: Environment variables priority:
+# 1. Command-line args from Claude Code (already in environment)
+# 2. .env file (only for missing values)
+# 3. Defaults (as fallback)
+
+# Store any command-line provided values BEFORE loading .env
+CMDLINE_VOYAGE_KEY="${VOYAGE_KEY:-}"
+CMDLINE_PREFER_LOCAL="${PREFER_LOCAL_EMBEDDINGS:-}"
+CMDLINE_QDRANT_URL="${QDRANT_URL:-}"
+
+# Load .env file for any missing values
+if [ -f "../.env" ]; then
+    echo "[DEBUG] Loading .env file from project root" >&2
+    set -a  # Export all variables
+    source ../.env
+    set +a  # Stop exporting
+else
+    echo "[DEBUG] No .env file found, using defaults" >&2
+fi
+
+# Restore command-line values (they take precedence)
+if [ ! -z "$CMDLINE_VOYAGE_KEY" ]; then
+    export VOYAGE_KEY="$CMDLINE_VOYAGE_KEY"
+    echo "[DEBUG] Using command-line VOYAGE_KEY" >&2
+fi
+
+if [ ! -z "$CMDLINE_PREFER_LOCAL" ]; then
+    export PREFER_LOCAL_EMBEDDINGS="$CMDLINE_PREFER_LOCAL"
+    echo "[DEBUG] Using command-line PREFER_LOCAL_EMBEDDINGS: $PREFER_LOCAL_EMBEDDINGS" >&2
+fi
+
+if [ ! -z "$CMDLINE_QDRANT_URL" ]; then
+    export QDRANT_URL="$CMDLINE_QDRANT_URL"
+    echo "[DEBUG] Using command-line QDRANT_URL: $QDRANT_URL" >&2
+fi
+
+# Set smart defaults ONLY if still not set
+if [ -z "$QDRANT_URL" ]; then
+    export QDRANT_URL="http://localhost:6333"
+    echo "[DEBUG] Using default QDRANT_URL: $QDRANT_URL" >&2
+fi
+
+if [ -z "$PREFER_LOCAL_EMBEDDINGS" ]; then
+    export PREFER_LOCAL_EMBEDDINGS="true"
+    echo "[DEBUG] Using default PREFER_LOCAL_EMBEDDINGS: true (privacy-first)" >&2
+fi
+
+if [ -z "$ENABLE_MEMORY_DECAY" ]; then
+    export ENABLE_MEMORY_DECAY="false"
+    echo "[DEBUG] Using default ENABLE_MEMORY_DECAY: false" >&2
+fi
+
 # Check if virtual environment exists
 if [ ! -d "venv" ]; then
     echo "Creating virtual environment..."
@@ -63,11 +115,27 @@ if [ -z "$FASTEMBED_SKIP_HUGGINGFACE" ]; then
 fi
 
 # Debug: Show what environment variables are being passed
-echo "[DEBUG] Environment variables for MCP server:"
-echo "[DEBUG] VOYAGE_KEY: ${VOYAGE_KEY:+set}"
-echo "[DEBUG] PREFER_LOCAL_EMBEDDINGS: ${PREFER_LOCAL_EMBEDDINGS:-not set}"
-echo "[DEBUG] QDRANT_URL: ${QDRANT_URL:-not set}"
-echo "[DEBUG] ENABLE_MEMORY_DECAY: ${ENABLE_MEMORY_DECAY:-not set}"
+echo "[DEBUG] Environment variables for MCP server:" >&2
+echo "[DEBUG] VOYAGE_KEY: ${VOYAGE_KEY:+set}" >&2
+echo "[DEBUG] PREFER_LOCAL_EMBEDDINGS: ${PREFER_LOCAL_EMBEDDINGS:-not set}" >&2
+echo "[DEBUG] QDRANT_URL: ${QDRANT_URL:-not set}" >&2
+echo "[DEBUG] ENABLE_MEMORY_DECAY: ${ENABLE_MEMORY_DECAY:-not set}" >&2
+
+# Quick connectivity check for Qdrant
+echo "[DEBUG] Checking Qdrant connectivity at $QDRANT_URL..." >&2
+if command -v curl &> /dev/null; then
+    # Check root endpoint instead of /health which doesn't exist in Qdrant
+    if curl -s -f -m 2 "$QDRANT_URL/" > /dev/null 2>&1; then
+        echo "[DEBUG] ✅ Qdrant is reachable at $QDRANT_URL" >&2
+    else
+        echo "[WARNING] ⚠️  Cannot reach Qdrant at $QDRANT_URL" >&2
+        echo "[WARNING] Common fixes:" >&2
+        echo "[WARNING]   1. Start Qdrant: docker compose up -d qdrant" >&2
+        echo "[WARNING]   2. Check if port is different (e.g., 59999)" >&2
+        echo "[WARNING]   3. Update .env file with correct QDRANT_URL" >&2
+        echo "[WARNING] Continuing anyway - some features may not work..." >&2
+    fi
+fi
 
 # Run the MCP server
 exec python -m src

package/mcp-server/src/app_context.py

@@ -0,0 +1,64 @@
+"""Application context for sharing state across modules."""
+
+from dataclasses import dataclass
+from typing import Optional, Any
+from qdrant_client import AsyncQdrantClient
+try:
+    from .embedding_manager import EmbeddingManager
+    from .decay_manager import DecayManager
+    from .utils import ProjectResolver
+except ImportError:
+    # Fallback for testing
+    EmbeddingManager = None
+    DecayManager = None
+    ProjectResolver = None
+
+@dataclass
+class AppContext:
+    """Shared application context for all MCP tools."""
+    
+    qdrant_client: AsyncQdrantClient
+    embedding_manager: EmbeddingManager
+    decay_manager: DecayManager
+    project_resolver: ProjectResolver
+    
+    # Optional context for debugging
+    debug_context: Optional[Any] = None
+    
+    def __post_init__(self):
+        """Initialize any additional state after dataclass creation."""
+        # Ensure all managers are properly initialized
+        if not self.embedding_manager:
+            self.embedding_manager = EmbeddingManager()
+        
+        if not self.decay_manager:
+            self.decay_manager = DecayManager()
+        
+        if not self.project_resolver:
+            self.project_resolver = ProjectResolver()
+    
+    async def get_all_collections(self) -> list:
+        """Get all collections from Qdrant."""
+        try:
+            collections = await self.qdrant_client.get_collections()
+            return [c.name for c in collections.collections]
+        except Exception as e:
+            if self.debug_context:
+                await self.debug_context.debug(f"Failed to get collections: {e}")
+            return []
+    
+    async def generate_embedding(self, text: str, embedding_type: Optional[str] = None):
+        """Generate embedding using the embedding manager."""
+        # The embedding_manager.embed method is synchronous, not async
+        embeddings = self.embedding_manager.embed(text, input_type="document")
+        if embeddings and len(embeddings) > 0:
+            return embeddings[0]
+        return None
+    
+    def get_current_project(self) -> Optional[str]:
+        """Get current project from resolver."""
+        return self.project_resolver.get_current_project()
+    
+    def normalize_project_name(self, project_name: str) -> str:
+        """Normalize project name using resolver."""
+        return self.project_resolver.normalize_project_name(project_name)

package/mcp-server/src/config.py

@@ -0,0 +1,57 @@
+"""Configuration and environment constants for Claude Self-Reflect MCP server."""
+
+import os
+from pathlib import Path
+from dotenv import load_dotenv
+
+# Load environment variables
+load_dotenv()
+
+# API Keys
+VOYAGE_API_KEY = os.getenv('VOYAGE_API_KEY', '')
+QDRANT_URL = os.getenv('QDRANT_URL', 'http://localhost:6333')
+
+# Embedding Configuration
+PREFER_LOCAL_EMBEDDINGS = os.getenv('PREFER_LOCAL_EMBEDDINGS', 'true').lower() == 'true'
+VOYAGE_MODEL = "voyage-3-lite"
+LOCAL_MODEL = "sentence-transformers/all-MiniLM-L6-v2"
+
+# Decay Configuration
+USE_DECAY = os.getenv('USE_DECAY', 'false').lower() == 'true'
+DECAY_SCALE_DAYS = int(os.getenv('DECAY_SCALE_DAYS', '90'))
+DECAY_WEIGHT = float(os.getenv('DECAY_WEIGHT', '0.3'))
+USE_NATIVE_DECAY = os.getenv('USE_NATIVE_DECAY', 'false').lower() == 'true'
+
+# Search Configuration
+DEFAULT_SEARCH_LIMIT = 5
+MAX_SEARCH_LIMIT = 100
+DEFAULT_MIN_SCORE = 0.3
+
+# Memory Management
+MAX_RESULTS_PER_COLLECTION = int(os.getenv('MAX_RESULTS_PER_COLLECTION', '10'))
+MAX_TOTAL_RESULTS = int(os.getenv('MAX_TOTAL_RESULTS', '1000'))
+MAX_MEMORY_MB = int(os.getenv('MAX_MEMORY_MB', '500'))
+
+# Connection Pool Configuration
+POOL_SIZE = int(os.getenv('QDRANT_POOL_SIZE', '10'))
+POOL_MAX_OVERFLOW = int(os.getenv('QDRANT_POOL_OVERFLOW', '5'))
+POOL_TIMEOUT = float(os.getenv('QDRANT_POOL_TIMEOUT', '30.0'))
+RETRY_ATTEMPTS = int(os.getenv('QDRANT_RETRY_ATTEMPTS', '3'))
+RETRY_DELAY = float(os.getenv('QDRANT_RETRY_DELAY', '1.0'))
+
+# Performance Configuration
+MAX_CONCURRENT_SEARCHES = int(os.getenv('MAX_CONCURRENT_SEARCHES', '10'))
+ENABLE_PARALLEL_SEARCH = os.getenv('ENABLE_PARALLEL_SEARCH', 'true').lower() == 'true'
+
+# Paths
+CLAUDE_PROJECTS_PATH = Path.home() / '.claude' / 'projects'
+CONFIG_PATH = Path.home() / '.claude-self-reflect' / 'config'
+
+# Collection Naming
+VOYAGE_SUFFIX = '_voyage'
+LOCAL_SUFFIX = '_local'
+
+# Logging
+import logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)