@mrxkun/mcfast-mcp 4.1.8 → 4.1.10

package/README.md

@@ -5,19 +5,13 @@
   <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node.js">
   <img src="https://img.shields.io/npm/l/@mrxkun/mcfast-mcp.svg" alt="License">
   <img src="https://img.shields.io/badge/performance-80--98%25%20faster-success.svg" alt="Performance">
-  <img src="https://img.shields.io/badge/WASM-Rust-orange.svg" alt="WASM">
 </p>
 
 <p align="center">
-  <strong>🚀 Ultra-fast AI code editing with WebAssembly acceleration</strong><br>
+  <strong>🚀 Ultra-fast AI code editing with AST-aware refactoring</strong><br>
   Optimized for Claude, Cursor, and AI assistants with 80-98% latency reduction
 </p>
 
-<p align="center">
-  <strong>🧠 NEW in v4.0.5: Intelligence Layer</strong><br>
-  ML-powered pattern detection | Adaptive strategy selection | Predictive suggestions
-</p>
-
 ---
 
 ## ✨ What Makes MCFAST Special?
@@ -35,7 +29,28 @@
 
 ---
 
-## 🧠 Memory System (v4.0.1)
+## 📦 Current Version: v4.1.10
+
+### What's New in v4.1.10 🐛
+- **Bug Fixes**: Fixed `getCuratedMemories()` and `getIntelligenceStats()` missing methods
+- **Fixed VSCode MCP Reload Issue**: Complete console suppression in MCP mode
+- **Version Sync**: All packages now unified to v4.1.10
+
+### What's New in v4.1.4 🧠
+- **ContextAnalyzer API**: AI-powered memory analysis with Mercury Coder
+  - **5 New Endpoints**: Analyze changes, session summaries, pattern detection, memory updates, context retrieval
+  - **SQL Migration**: Complete database schema with 5 tables, 24 indexes, 4 views
+
+### What's New in v4.1.0 🧠
+- **Major Memory Refactor**: Complete rewrite of memory system
+  - **Markdown Source of Truth**: Memory stored as plain Markdown files (git-friendly!)
+  - **Two-Tier Memory**: Daily logs + Curated memory
+  - **Hybrid Search**: Vector 70% + BM25 30% for 90%+ accuracy
+  - **File Watcher**: Auto-indexes files with debounced 1.5s delay
+
+---
+
+## 🧠 Memory System (v4.1)
 
 **Semantic code search with 90-95% accuracy** - Find code by meaning, not just keywords.
 
@@ -60,185 +75,52 @@ await engine.initialize('./my-project');
 const results = await engine.intelligentSearch('find authentication code', {
   limit: 5
 });
-
-console.log(results);
-// {
-//   results: [
-//     { file: 'auth.js', score: 0.92, content: 'function login()...' },
-//     { file: 'UserService.js', score: 0.88, content: 'async authenticate()...' }
-//   ],
-//   metadata: {
-//     method: 'intelligent-hybrid',
-//     accuracy: '95%',
-//     routingDecision: { useMercury: true, reason: 'Complex query' },
-//     duration: '105ms'
-//   }
-// }
 ```
 
-### Smart Routing Modes
-
-1. **Always Local** (⚡ Fastest)
-   - 90% accuracy, <1ms
-   - 100% offline
-   - $0 cost
-
-2. **Auto Smart** (🧠 Recommended)
-   - Auto-selects based on query complexity
-   - Balances speed vs accuracy
-   - 70% cost savings vs always Mercury
-
-3. **Always Mercury** (🎯 Best Accuracy)
-   - 95% accuracy, ~100ms
-   - Complex queries only
-   - $0.01 per query
-
 ---
 
-## 🎛️ 8 Unified Tools (v3.5.7)
+## 🛠️ 10 Unified Tools
 
-| Tool | Description | Avg Latency | Best For |
-|------|-------------|-------------|----------|
-| **edit** | Multi-file intelligent editing | 35ms | Complex refactoring, renaming |
-| **parallel_edit** | Multi-file with dependency resolution | 40ms | Coordinated multi-file changes |
-| **search** | Lightning-fast code search | 8ms | Finding patterns, symbols |
-| **read** | Smart file reading with batch mode | 6ms | Reading multiple files |
-| **list_files** | Directory listing with filters | 3ms | Project exploration |
-| **analyze** | AST parsing & complexity analysis | 5ms | Code analysis, metrics |
-| **fuzzy_match** | Fuzzy string matching | 25ms | Auto-complete, suggestions |
-| **reapply** | Retry failed edits with fixes | 30ms | Error recovery |
+| Tool | Description | Avg Latency |
+|------|-------------|-------------|
+| **mcfast_edit** | Multi-file intelligent editing | 35ms |
+| **mcfast_search** | Lightning-fast code search | 8ms |
+| **mcfast_read** | Smart file reading with batch mode | 6ms |
+| **mcfast_list_files** | Directory listing with filters | 3ms |
+| **mcfast_reapply** | Retry failed edits with fixes | 30ms |
+| **mcfast_memory_search** | Semantic code search | 15ms |
+| **mcfast_memory_get** | Retrieve memories & stats | 5ms |
+| **mcfast_detect_patterns** | Detect code patterns | 20ms |
+| **mcfast_get_suggestions** | Get code suggestions | 15ms |
+| **mcfast_select_strategy** | ML strategy selection | 5ms |
 
 ---
 
 ## 🚀 Performance Highlights
 
-### Before vs After Optimization
-
 | Operation | Before | After MCFAST | Improvement |
 |-----------|--------|--------------|-------------|
-| **Edit** | 150ms | **30ms** | **80% faster** 🚀 |
-| **Read** | 50ms | **6ms** | **88% faster** 🚀 |
-| **Search** | 500ms | **8ms** | **98% faster** 🚀 |
-| **Analyze** | 100ms | **5ms** | **95% faster** 🚀 |
-| **Fuzzy Match** | 100ms | **25ms** | **75% faster** 🚀 |
-
-### Throughput Improvements
-
-- **Requests/sec**: 20 → 200 (**10x increase**)
-- **Concurrent edits**: 1 → 8 (**8x parallel processing**)
-- **Cache hit rate**: 0% → 87% (**87% reduction in API calls**)
-
----
-
-## 🏗️ Technical Architecture
-
-### 1. WebAssembly (Rust) Acceleration
-
-Near-native performance for CPU-intensive operations:
-
-```
-JavaScript (80ms) ──────► WASM (25ms) = 3.2x faster
-         Fuzzy Matching
-
-JavaScript (20ms) ──────► WASM (8ms) = 2.5x faster
-         Code Search
-
-JavaScript (15ms) ──────► WASM (5ms) = 3x faster
-         AST Parsing
-```
-
-**Features:**
-- ⚡ **3.2x faster** fuzzy matching
-- 🔍 **2.5x faster** code search
-- 🌳 **3x faster** AST parsing
-- 🔄 **Automatic fallback** to JavaScript if WASM fails
-- 📦 **Only 55KB** total bundle size (22KB gzipped)
-
-### 2. Multi-Layer Caching (L1/L2/L3)
-
-Three-tier caching for maximum hit rate:
-
-**L1: In-Memory Cache (100MB)**
-- Access time: **0.04ms**
-- Hit rate: **70%**
-- Eviction: LRU (Least Recently Used)
-
-**L2: Redis Cache (Upstash)**
-- Access time: **5-15ms**
-- Hit rate: **20%**
-- Features: Tag-based invalidation, distributed
-
-**L3: CDN Edge Cache**
-- Access time: **50-100ms**
-- Hit rate: **10%**
-- Geographic distribution
-
-**Combined: 87% cache hit rate** 🎯
-
-### 3. Worker Thread Pool
-
-Parallel processing with 8 workers:
-
-- **Priority queue**: High-priority tasks first
-- **Load balancing**: Even distribution across workers
-- **Hybrid mode**: Native workers (self-hosted) or simulated (serverless)
-- **Auto-scaling**: Adjusts to workload
-
-### 4. Intelligent Edit Strategies (v3.5.7 - NEW: MINIMAL_DIFF)
-
-**MINIMAL_DIFF Strategy (NEW in v3.5.7):**
-- Extracts exact search/replace pairs from instructions
-- Applies deterministic replacements first (no API call!)
-- Falls back to Mercury only for complex changes
-- Reduces tokens by 40-60% for simple edits
-
-Supported patterns:
-- Quoted strings: `replace "foo" with "bar"`
-- Code identifiers: `change function foo to bar`
-- Arrow notation: `oldName -> newName`
-- Variable renames: `rename user to account`
-
-**AST-Aware Editing:**
-- Uses Tree-sitter for accurate parsing
-- Scope-aware renames
-- Type-safe transformations
-
-**Fuzzy Patching:**
-- Levenshtein distance matching
-- Token-based similarity
-- Handles whitespace/formatting changes
-
-**Multi-File Coordination:**
-- Dependency graph resolution
-- Parallel execution where possible
-- Atomic rollback on failure
+| **Edit** | 150ms | **30ms** | **80% faster** |
+| **Read** | 50ms | **6ms** | **88% faster** |
+| **Search** | 500ms | **8ms** | **98% faster** |
+| **Analyze** | 100ms | **5ms** | **95% faster** |
 
 ---
 
 ## 📦 Installation
 
 ### Prerequisites
-
 - **Node.js** ≥ 18.0.0
-- **npm** or **yarn**
 
 ### Global Installation (Recommended)
-
 ```bash
 npm install -g @mrxkun/mcfast-mcp
 ```
 
-### Local Installation
-
-```bash
-npm install @mrxkun/mcfast-mcp
-```
-
 ### Verify Installation
-
 ```bash
 mcfast-mcp --version
-# Output: 4.0.1
+# Output: 4.1.10
 ```
 
 ---
@@ -247,8 +129,6 @@ mcfast-mcp --version
 
 ### Configure Claude Desktop
 
-Add to your `claude_desktop_config.json`:
-
 ```json
 {
   "mcpServers": {
@@ -265,8 +145,6 @@ Add to your `claude_desktop_config.json`:
 
 ### Configure Cursor
 
-Add to Cursor MCP settings:
-
 ```json
 {
   "mcpServers": {
@@ -281,163 +159,6 @@ Add to Cursor MCP settings:
 }
 ```
 
-### Start Using
-
-Once configured, MCFAST tools are automatically available in your AI assistant:
-
-```
-User: "Add error handling to the login function"
-AI: [Uses mcfast edit tool]
-✅ Changes applied in 35ms with automatic validation
-```
-
----
-
-## 📖 Usage Examples
-
-### 1. Basic Edit
-
-```javascript
-// AI sends:
-{
-  "tool": "edit",
-  "params": {
-    "instruction": "Add console.log at the start",
-    "files": {
-      "src/utils.js": "function helper() { return true; }"
-    }
-  }
-}
-
-// Response:
-{
-  "success": true,
-  "diffs": {
-    "src/utils.js": "+  console.log('Starting helper');"
-  },
-  "strategy": "edit_file",
-  "latency_ms": 35,
-  "from_cache": false
-}
-```
-
-### 2. Parallel Multi-File Edit
-
-Perfect for complex refactoring:
-
-```javascript
-{
-  "tool": "parallel_edit",
-  "params": {
-    "instruction": "Rename 'user' to 'account'",
-    "files": {
-      "auth.js": "function getUser() {}",
-      "profile.js": "const user = {}",
-      "settings.js": "export { user }"
-    },
-    "dependencies": ["auth.js", "profile.js", "settings.js"]
-  }
-}
-```
-
-### 3. Batch Read (Up to 50 files)
-
-```javascript
-{
-  "tool": "read",
-  "params": {
-    "paths": ["src/app.js", "src/utils.js", "src/config.js"],
-    "files": { /* file contents */ },
-    "max_lines_per_file": 100
-  }
-}
-```
-
-### 4. Code Search (NEW in v3.5)
-
-```javascript
-{
-  "tool": "search",
-  "params": {
-    "query": "function handleError",
-    "files": {
-      "app.js": "// code",
-      "utils.js": "// code"
-    },
-    "fuzzy": true,
-    "max_results": 10
-  }
-}
-
-// Response:
-{
-  "results": [
-    {
-      "path": "app.js",
-      "score": 95.5,
-      "matches": [
-        { "line": 42, "content": "function handleError(err)" }
-      ]
-    }
-  ],
-  "duration_ms": 8
-}
-```
-
-### 5. AST Analysis (NEW in v3.5)
-
-```javascript
-{
-  "tool": "analyze",
-  "params": {
-    "code": "function add(a, b) { return a + b; }",
-    "language": "javascript",
-    "operations": ["extract-functions", "analyze-complexity"]
-  }
-}
-
-// Response:
-{
-  "functions": [
-    {
-      "name": "add",
-      "params": ["a", "b"],
-      "line": 1,
-      "complexity": 1
-    }
-  ],
-  "complexity": {
-    "cyclomatic": 1,
-    "lines": 1,
-    "functions": 1
-  }
-}
-```
-
-### 6. Fuzzy Matching (NEW in v3.5)
-
-```javascript
-{
-  "tool": "fuzzy_match",
-  "params": {
-    "pattern": "col",
-    "targets": ["color", "column", "cold", "warm"],
-    "threshold": 0.6,
-    "max_results": 5
-  }
-}
-
-// Response:
-{
-  "matches": [
-    { "target": "color", "score": 0.75, "index": 0 },
-    { "target": "column", "score": 0.625, "index": 1 },
-    { "target": "cold", "score": 0.75, "index": 2 }
-  ],
-  "duration_ms": 25
-}
-```
-
 ---
 
 ## ⚙️ Configuration
@@ -445,354 +166,44 @@ Perfect for complex refactoring:
 ### Environment Variables
 
 ```bash
-# Required
+# Required for cloud features
 MERCURY_API_KEY=your_mercury_api_key
 
 # Optional - Dashboard Integration
-MCFAST_API_URL=https://mcfast.vercel.app/api/v1
-MCFAST_API_TOKEN=your_dashboard_token
+MCFAST_TOKEN=your_dashboard_token
+MCFAST_DASHBOARD_URL=https://mcfast.vercel.app
 
 # Optional - Redis (for distributed caching)
 UPSTASH_REDIS_REST_URL=https://...
 UPSTASH_REDIS_REST_TOKEN=...
-
-# Optional - Performance Tuning
-MAX_WORKERS=8
-CACHE_TTL_SECONDS=3600
-WASM_ENABLED=true
-```
-
-### Dashboard Integration
-
-Track usage and performance:
-
-```bash
-# Get metrics
-curl https://mcfast.vercel.app/api/v1/metrics \
-  -H "Authorization: Bearer YOUR_TOKEN"
-
-# Response
-{
-  "metrics": {
-    "requests": { "total": 10000, "success": 9950 },
-    "latency": { "avg": 25, "p95": 45, "p99": 80 },
-    "cache": { "hit_rate": 87 },
-    "workers": { "active": 8 },
-    "wasm": { "enabled": true }
-  }
-}
 ```
 
 ---
 
-## 🎯 Best Practices
-
-### 1. Use Batch Operations
-
-```javascript
-// ✅ Good - Single batch request
-{
-  "paths": ["file1.js", "file2.js", "file3.js"]
-}
-
-// ❌ Bad - Multiple individual requests
-{ "path": "file1.js" }
-{ "path": "file2.js" }
-```
-
-### 2. Enable Caching (Default)
-
-```javascript
-{
-  "instruction": "Add comments",
-  "files": { ... },
-  "use_cache": true  // 87% hit rate
-}
-```
-
-### 3. Handle Rate Limits
-
-```javascript
-// Response headers include rate limit info
-X-RateLimit-Remaining: 59
-X-RateLimit-Reset: 1699999999
-
-// Handle 429 gracefully
-if (response.status === 429) {
-  await sleep(response.headers['Retry-After'] * 1000);
-}
-```
-
-### 4. Use Parallel Edit for Dependencies
-
-```javascript
-{
-  "tool": "parallel_edit",
-  "files": { ... },
-  "dependencies": ["auth.js", "profile.js"]
-}
-```
-
----
-
-## 🧪 Testing
-
-### Run Tests
-
-```bash
-# Install dependencies
-npm install
-
-# Run all tests
-npm test
-
-# Run with coverage
-npm run test:coverage
-```
-
-### Test Coverage
-
-- **77 tests** across 4 test suites
-- **90% code coverage**
-- **100% pass rate**
-
----
-
-## 🛠️ Troubleshooting
-
-### Common Issues
-
-#### Issue: "Cannot find module"
-
-```bash
-# Solution
-npm cache clean --force
-npm install -g @mrxkun/mcfast-mcp@latest
-```
-
-#### Issue: "Rate limit exceeded"
-
-```bash
-# Default limits:
-# Free: 60 req/min
-# Pro: 600 req/min
-# Enterprise: Custom
-
-# Solution: Upgrade plan or implement backoff
-```
-
-#### Issue: "WASM not loading"
-
-```bash
-# Automatic fallback to JavaScript is enabled
-# Check console for WASM status
-# Requires Node.js 18+ or modern browser
-```
-
----
-
-## 📊 Benchmarks
-
-### Latency Breakdown
-
-```
-Edit API (Total: 30ms)
-├── Auth: 2ms
-├── Cache Check (L1): 0.04ms ✅
-├── Mercury API: 20ms
-├── Processing: 5ms
-└── Response: 2ms
-
-Read API (Total: 6ms)
-├── Auth: 2ms
-├── Cache Check (L1): 0.04ms ✅ (87% hit)
-├── Processing: 2ms
-└── Response: 2ms
-```
-
-### Resource Usage
-
-- **Memory per instance**: ~160MB
-  - L1 Cache: 100MB
-  - Worker Pool: 50MB
-  - WASM Modules: 10MB
-- **CPU**: 25% utilization (2x more efficient)
-- **Bundle size**: 55KB (22KB gzipped)
-
----
-
 ## 📝 Changelog
 
-### v4.1.5 (2026-02-17) 🐛 Critical MCP Fix
-
-- 🔧 **Fixed JSON-RPC Stream Corruption**
-  - Replaced ALL `console.log` with `console.error` (35+ statements)
-  - MCP protocol uses `stdout` for JSON-RPC - console.log corrupts stream
-  - Error `[FileWatche..." is not valid JSON` now resolved
-  - Fixed in 10 files: strategy-selector, agents-md, curated-memory, databases, context-analyzer, daily-logs, embedder, sync-engine, ultra-embedder
-
-### v4.1.4 (2026-02-17) 🎉 ContextAnalyzer API
-
-- ✨ **ContextAnalyzer Integration**
-  - `POST /memory/analyze` - AI-powered change analysis with Mercury Coder
-  - `POST /memory/session/summary` - Work session summarization
-  - `POST /memory/patterns/detect` - Pattern detection across sessions
-  - `POST /memory/update` - Automatic MEMORY.md updates
-  - `GET /memory/context` - Context retrieval with caching
-
-- 📊 **SQL Migration Complete**
-  - 5 tables: memory_analysis, session_summaries, memory_updates, context_cache, analysis_patterns
-  - 24 indexes for optimal performance
-  - 4 analytics views, 3 functions, 2 triggers
-
-### v4.0.5 (2026-02-16) 🎉 Bug Fix - Chokidar Version
-
-- 🔧 **Fixed**: Sửa chokidar version từ ^4.0.4 sang ^4.0.3
-  - Phiên bản 4.0.4 không tồn tại trên npm registry
-  - Đảm bảo cài đặt dependencies thành công
-
-### v4.0.4 (2026-02-16) 🎉 Phase 4 Complete - MCP Tools Added
-
-- 🔧 **MCP Tools Registration**
-  - `memory_search` - Semantic code search with 90-95% accuracy
-  - `memory_get` - Retrieve stored memories and intelligence stats
-  - `detect_patterns` - Detect code patterns from edit history
-  - `get_suggestions` - Get intelligent code suggestions
-  - `select_strategy` - ML-based strategy selection
-
-- 🧠 **Pattern Recognition**
-  - Detect frequent renames (naming inconsistencies)
-  - Identify repeated error fixes (recurring bugs)
-  - Find common edit sequences (automation opportunities)
-  - Spot problematic strategies (>30% failure rate)
-  - Detect hot files (frequently modified)
-  
-- 💡 **Predictive Suggestions**
-  - Naming convention fixes
-  - Long function extraction (>50 lines)
-  - Missing test coverage detection
-  - Unused import cleanup
-  - Duplicate code detection
-  - Performance anti-pattern detection
-  
-- 🎯 **Adaptive Strategy Selection**
-  - ML-based strategy selection (deterministic/cached/llm)
-  - Feature extraction from edit history
-  - Online learning from success/failure
-  - Automatic model improvement
-  - Persistent model storage
-  
-- 📊 **Analytics & Insights**
-  - Pattern detection API
-  - Suggestion generation API
-  - Strategy effectiveness tracking
-  - ML model performance metrics
-  - Dashboard integration
-
-- 📈 **Phase 4 Metrics**:
-  - Suggestion relevance: >70%
-  - Strategy accuracy: >85%
-  - Pattern detection: >90% accuracy
-  - Auto-apply success: >90%
-
-### v4.0.3 (2026-02-16) 🎉 Phase 4 Core Implementation
-- Initial Phase 4 implementation (PatternDetector, SuggestionEngine, StrategySelector)
-- Dashboard analytics endpoints
-- SQL migration for Phase 4 tables
-
-### v4.0.2 (2026-02-16) 🎉 Phase 3 Complete
-- ✨ **Enhanced Edit Tool** with Memory Context
-  - Automatic context retrieval from codebase memory
-  - Impact analysis for rename operations (detects affected files)
-  - Auto-fix references across multiple files
-  - Enhanced instruction with relevant code context
-- 🔧 **Memory-Integrated Search**
-  - Unified search now uses intelligent hybrid search (90-95% accuracy)
-  - Smart routing: auto-selects local vs Mercury re-ranking
-  - Edit history tracking and learning from past edits
-- 📝 **Enhanced Memory Tools**
-  - `memory_search`: Now uses UltraHybrid search with 6 techniques
-  - `memory_get`: Added support for today's log and curated memories
-  - Full integration with MemoryEngine (replaced old LocalMemoryStore)
-- 📊 **Phase 3 Metrics**:
-  - Context relevance: >80% (retrieved memories relevant to query)
-  - Search latency: <100ms for intelligent search
-  - Edit impact detection: >90% accuracy for symbol renames
-
-### v4.0.1 (2026-02-14) 🎉
-- 🗓️ **Daily Logs**: Auto-generated markdown notes for code changes
-  - Log file created/modified/deleted events
-  - Log edit sessions with strategy & success status
-  - Curated long-term memories (MEMORY.md)
-  - Cleanup old logs automatically
-- 🔄 **Sync Engine**: Local ↔ Cloud synchronization
-  - Queue-based sync with persistence
-  - Periodic auto-sync (5 min default)
-  - Online/offline detection
-  - Last-write-wins conflict resolution
-- 🧠 **Memory Enhancements**:
-  - `memory.logFileCreated()`, `memory.logFileModified()`, `memory.logFileDeleted()`
-  - `memory.logEditToMemory()` - Log edit + save to database
-  - `memory.getTodayLog()`, `memory.getCuratedMemories()`
-  - `memory.getSyncStatus()`, `memory.triggerSync()`
-- ⚙️ **Optional Cloud Sync**: Auto-detects `MCFAST_TOKEN` for sync with Dashboard
-
-### v4.0.0 (2026-02-14) 🎉
-- 🧠 **Memory System**: Semantic code search with 90-95% accuracy
-  - Ultra-Enhanced Embeddings (1024-dim, 150+ synonyms)
-  - 6-technique hybrid search
-  - Auto-indexing with file watcher
-  - Offline-first: 100% offline, <1ms search
-- 🎯 **Smart Routing**: Intelligent local vs Mercury decision
-  - 5-factor scoring (complexity, confidence, budget, history, urgency)
-  - 3 modes: Always Local / Auto Smart / Always Mercury
-  - Cost optimization: 70% savings
-- 🎛️ **Dashboard Integration**: Web UI configuration
-  - Toggle Mercury re-ranking
-  - Monthly budget controls
-  - Usage analytics
-- ⚡ **Performance**: 12,500+ embeddings/second
-- 🔒 **Security**: API key management in Dashboard
-
-### v3.5.7 (2026-02-13)
-- 🚀 **NEW: MINIMAL_DIFF strategy** - Extracts exact search/replace pairs and applies deterministically
-- 🔍 **Enhanced pattern detection** - Supports code identifiers, arrow notation, variable renames
-- ⚡ **Parallel processing** - Multi-file edits processed concurrently
-- 📦 **40-60% token reduction** for simple edits
-- 🎯 **Smart fallback** - Only calls Mercury API when needed
-
-### v3.5.1 (2026-02-13)
-- 🐛 Bug fixes and stability improvements
-- 📚 Enhanced documentation
-- ✅ Updated dependencies
-
-### v3.5.0 (2026-02-13)
-- 🚀 **WebAssembly (Rust) support**
-- ⚡ 3.2x faster fuzzy matching
-- 🔍 2.5x faster code search
-- 🌳 3x faster AST parsing
-- 🎯 New tools: search, analyze, fuzzy_match
-- 💾 Multi-layer caching (87% hit rate)
-- 👷 Worker thread pool (8 workers)
-
-### v3.4.2 (2026-02-12)
-- 📦 Batch read mode (50 files)
-- 🔗 Parallel edit with dependencies
-- 💰 67% cost reduction
+### v4.1.10 (2026-02-17)
+- 🔧 Fixed `getCuratedMemories()` and `getIntelligenceStats()` missing methods
+- 🔧 Version sync across all packages
+- 📚 Updated documentation
 
----
+### v4.1.5 (2026-02-17)
+- 🔧 Fixed JSON-RPC Stream Corruption
+- 🔄 Console suppression in MCP mode
 
-## 🤝 Contributing
+### v4.1.4 (2026-02-17)
+- ✨ ContextAnalyzer API with 5 new endpoints
+- 📊 SQL Migration with 5 tables, 24 indexes
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md).
+### v4.1.0 (2026-02-17)
+- 🧠 Major Memory Refactor with Markdown source of truth
+- 🔍 Hybrid Search (Vector 70% + BM25 30%)
 
-```bash
-# Development setup
-git clone https://github.com/ndpmmo/mcfast.git
-cd mcfast
-npm install
-npm run dev
-```
+### v4.0.5 (2026-02-16)
+- 🔧 Fixed chokidar version (4.0.4 → 4.0.3)
+
+### v4.0.4 (2026-02-16)
+- 🔧 MCP Tools Registration (memory_search, memory_get, detect_patterns, etc.)
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mrxkun/mcfast-mcp",
-  "version": "4.1.8",
-  "description": "Ultra-fast code editing with WASM acceleration, fuzzy patching, multi-layer caching, and 8 unified tools. v4.1.8: Debug mode - Write logs to .mcfast/mcp-debug.log",
+  "version": "4.1.10",
+  "description": "Ultra-fast code editing with WASM acceleration, fuzzy patching, multi-layer caching, and 8 unified tools. v4.1.10: Suppress console output to prevent JSON-RPC stream corruption.",
   "type": "module",
   "bin": {
     "mcfast-mcp": "src/index.js"

package/src/index.js

@@ -8,32 +8,31 @@
 // CRITICAL: Suppress ALL console output in MCP mode to prevent JSON parsing errors
 // MCP protocol requires stdout to contain ONLY JSON-RPC messages
 
-// Also override console.log - log to file in MCP mode
+// ANSI Color Codes for Terminal Output (MUST be defined before any usage)
+const colors = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    gray: '\x1b[90m',
+    white: '\x1b[37m',
+    bgBlack: '\x1b[40m',
+};
+
+// Override console.log - suppress in MCP mode
 const originalConsoleLog = console.log;
 console.log = function(...args) {
-    // Write to log file in project directory
-    try {
-        const logDir = process.cwd();
-        const logFile = logDir + '/.mcfast/mcp-debug.log';
-        const message = `[${new Date().toISOString()}] [LOG] ${args.join(' ')}\n`;
-        require('fs').appendFileSync(logFile, message);
-    } catch (e) {
-        // Ignore if can't write
-    }
+    // Suppressed in MCP mode
 };
 
-// Override console.error - log to file in MCP mode  
+// Override console.error - suppress in MCP mode  
 const originalConsoleError = console.error;
 console.error = function(...args) {
-    // Write to log file in project directory
-    try {
-        const logDir = process.cwd();
-        const logFile = logDir + '/.mcfast/mcp-debug.log';
-        const message = `[${new Date().toISOString()}] [ERROR] ${args.join(' ')}\n`;
-        require('fs').appendFileSync(logFile, message);
-    } catch (e) {
-        // Ignore if can't write
-    }
+    // Suppressed in MCP mode
 };
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -318,21 +317,6 @@ async function analyzeRenameImpact(symbolName, currentFile = null) {
     }
 }
 
-// ANSI Color Codes for Terminal Output
-const colors = {
-    reset: '\x1b[0m',
-    bold: '\x1b[1m',
-    dim: '\x1b[2m',
-    cyan: '\x1b[36m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    gray: '\x1b[90m',
-    white: '\x1b[37m',
-    bgBlack: '\x1b[40m',
-};
-
 // Tool icons (v2.0 - 4 core tools)
 const toolIcons = {
     edit: '✏️',
@@ -617,11 +601,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             // MEMORY TOOL 2: memory_get
             {
                 name: "memory_get",
-                description: "📚 Get stored memories: today's log, curated memories, or intelligence stats. Use to review recent changes or long-term knowledge.",
+                description: "📚 Get stored memories: today's log, curated memories, stats, or trigger re-index. Use to review recent changes or long-term knowledge.",
                 inputSchema: {
                     type: "object",
                     properties: {
-                        type: { type: "string", enum: ["today_log", "curated", "stats", "intelligence"], description: "Type of memory to retrieve" }
+                        type: { type: "string", enum: ["today_log", "curated", "stats", "intelligence", "reindex"], description: "Type of memory to retrieve or 'reindex' to trigger codebase re-indexing" }
                     },
                     required: ["type"]
                 }
@@ -2062,10 +2046,6 @@ async function handleReadFileInternal({ path: filePath, start_line, end_line, ma
 
         if (startLine < 1) startLine = 1;
         if (endLine < 1 || endLine > totalLines) endLine = totalLines;
-        if (startLine > endLine) {
-            throw new Error(`Invalid line range: start_line (${startLine}) > end_line (${endLine})`);
-        }
-
         if (start_line || end_line) {
             outputContent = lines.slice(startLine - 1, endLine).join('\n');
         } else if (max_lines && lines.length > max_lines) {
@@ -2917,7 +2897,7 @@ async function handleMemorySearch({ query, type = 'all', maxResults = 6, minScor
                 score: fact.confidence || 0.8
             }));
         } else if (type === 'code') {
-            const searchResult = await engine.ultraSearch(query, { limit: maxResults });
+            const searchResult = await engine.intelligentSearch(query, { limit: maxResults });
             results = searchResult.results.map(result => ({
                 type: 'chunk',
                 content: result.code || result.content,
@@ -3009,10 +2989,31 @@ async function handleMemoryGet({ type }) {
         } else if (type === 'stats') {
             const stats = await engine.getStats();
             output = `📊 Memory Stats\n\n`;
-            output += `Total chunks: ${stats.totalChunks || 0}\n`;
-            output += `Total facts: ${stats.totalFacts || 0}\n`;
-            output += `Index size: ${stats.indexSize || 0}\n`;
-            output += `Last indexed: ${stats.lastIndexed || 'Never'}`;
+            output += `📝 Memory Index\n`;
+            output += `  Files: ${stats.memory?.files || 0}\n`;
+            output += `  Chunks: ${stats.memory?.chunks || 0}\n`;
+            output += `  Embeddings: ${stats.memory?.embeddings || 0}\n\n`;
+            output += `💻 Codebase Index\n`;
+            output += `  Files: ${stats.codebase?.files || 0}\n`;
+            output += `  Facts: ${stats.codebase?.facts || 0}\n`;
+            output += `  Chunks: ${stats.codebase?.chunks || 0}\n`;
+            output += `  Embeddings: ${stats.codebase?.embeddings || 0}\n`;
+            output += `  Edits: ${stats.codebase?.edits || 0}\n\n`;
+            output += `🔄 Indexing\n`;
+            output += `  Complete: ${stats.indexing?.is_complete ? '✅' : '⏳'}\n`;
+            output += `  Indexed: ${stats.indexing?.indexed_files || 0}/${stats.indexing?.total_files || 0}\n`;
+            output += `  Failed: ${stats.indexing?.failed_files || 0}\n`;
+        } else if (type === 'reindex') {
+            output = `🔄 Re-indexing Codebase\n\n`;
+            output += `Starting re-index in background...\n`;
+            
+            // Trigger re-index in background
+            engine.performInitialScan().catch(err => {
+                console.error('[Reindex] Error:', err.message);
+            });
+            
+            output += `✅ Re-index started. Check stats in a few seconds.\n`;
+            output += `Use 'memory_get stats' to check progress.`;
         } else if (type === 'intelligence') {
             const intelStats = engine.getIntelligenceStats();
             output = `🧠 Intelligence Stats\n\n`;

package/src/memory/memory-engine.js

@@ -731,6 +731,25 @@ export class MemoryEngine {
     return { strategy: 'cached', confidence: 0.6, reason: 'Default selection' };
   }
 
+  async getCuratedMemories() {
+    return this.curatedMemory?.read?.() || null;
+  }
+
+  getIntelligenceStats() {
+    return {
+      enabled: this.intelligenceEnabled,
+      patternDetector: {
+        totalPatterns: this.patternDetector?.getTotalPatterns?.() || 0
+      },
+      suggestionEngine: {
+        minConfidence: this.suggestionEngine?.minConfidence || 0.7
+      },
+      strategySelector: {
+        learningRate: this.strategySelector?.learningRate || 0.1
+      }
+    };
+  }
+
   // ========== Sync Engine ==========
 
   getSyncStatus() {