Release v2.5.3

DevMind MCP v2.5.3

Fixed

• Critical: Multi-Project Session Detection: Made project_path a required parameter for record_context

  • Breaking Change: project_path is now REQUIRED (was optional)
  • AI must explicitly specify project path for every memory recording
  • Eliminates all path inference and guessing logic
  • Impact: 100% accurate session detection, zero cross-project contamination

• Smart Memory Auto-Update Disabled: Removed automatic memory update to prevent information loss

  • Problem: Auto-update (even at 95% similarity) caused incorrect merging of different work
  • Example: "Implement feature A" + "Fix bug in feature A" were incorrectly merged
  • Solution: Now only provides warning, AI decides whether to use update_context
  • Impact: Safer memory system, no accidental information loss

Changed

• record_context Tool: project_path parameter is now required

  • Old: required: ["content"]
  • New: required: ["content", "project_path"]
  • Description updated to emphasize requirement
  • Clear error message if not provided

• Simplified Session Logic: Removed complex multi-project detection

  • No more path inference from environment variables
  • No more multi-project conflict detection
  • No more session tracking (no longer needed)
  • Direct path → session lookup

Removed

• Path Inference Logic: Removed automatic project path detection

  • No longer tries to infer from process.env.INIT_CWD, PWD, CD, or cwd()
  • No longer searches for project root automatically
  • AI must provide explicit path

• Multi-Project Conflict Detection: Removed complex validation logic

  • No longer checks for multiple active projects
  • No longer compares with recently accessed projects
  • No longer throws multi-project conflict errors

• Session Tracking: Removed tracking mechanisms (no longer needed)

  • Removed lastUsedSession tracking
  • Removed SessionManager.currentSession tracking
  • Removed setCurrentSession() method
  • Simpler, more reliable logic

• Automatic Memory Update: Removed auto-update logic (~100 lines)

  • No longer automatically merges similar memories
  • No longer calls handleUpdateContext automatically
  • No longer uses mergeMemoryContent() for auto-merge
  • Simpler, safer behavior

Technical Details

• Simplified Flow:

  1. AI provides project_path (required)
  2. Normalize and validate path
  3. Get or create project's active session
  4. Record memory to that session
  5. If similar memory detected (>95%), show warning only
  

• Session Management Simplification:

  • Removed SessionManager.currentSession tracking (no longer needed)
  • Removed setCurrentSession() method (unused in simplified flow)
  • Removed CURRENT_SESSION_TTL constant (5-minute TTL check)
  • Removed lastUsedSession tracking in mcp-server.ts
  • Removed SESSION_TRACKING_TTL constant
  • getCurrentSession() now requires project_path parameter
  • Direct path-based lookup: project_path → normalize → find project → get active session
  • Lines of Code: Reduced by ~60 lines
  • Complexity: From 3/5 to 1/5

• Memory Update Behavior Change:

  • Before: Auto-update if similarity >95% (risky)
  • After: Always create new record + show warning (safe)
  • Warning format:

    ⚠️ 检测到相似记忆：
    - ID: xxx
    - 相似度: 95.2%
    - 创建时间: 0.5小时前
    
    如果这是重复工作，建议使用 update_context(context_id: "xxx") 更新现有记忆。
    否则已创建新记录（推荐保留独立记忆）。
    

  • Lines of Code: Reduced by ~100 lines
  • Complexity: From 5/5 to 1/5
  • Safety: From 70% to 100%

• Error Handling: Clear error if project_path not provided

  • Includes usage example in error message
  • No fallback to guessing or inference

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.5.3

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.5.3

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.5.3

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.5.2

DevMind MCP v2.5.2

Fixed

• Critical: Multi-Project Memory Contamination: Fixed cross-project memory pollution in multi-project scenarios

  • Enhanced project path detection with strict validation
  • Now throws explicit error when multiple active projects detected and path is ambiguous
  • Requires explicit project_path parameter in multi-project environments
  • Prevents memories from being recorded to wrong project sessions
  • Impact: Ensures memory isolation between projects in multi-project development

• Codebase Indexing Session Management: Fixed indexing session proliferation issue

  • Each project now maintains only one persistent indexing session
  • Subsequent indexing operations reuse existing session
  • Session name: Codebase Index (Auto-managed)
  • Prevents session list pollution from repeated indexing
  • Impact: Cleaner session management, truly implements v2.5.1's "temporary sessions" intent

Changed

• Multi-Project Error Handling: More explicit error messages for multi-project conflicts
  • Shows detected projects and their paths
  • Provides clear usage examples
  • Guides users to specify project_path explicitly

Technical Details

• handleRecordContext: Enhanced multi-project validation logic

  • Throws error instead of warning when project path is ambiguous
  • Compares inferred project with most recently accessed project
  • Only allows auto-detection when unambiguous

• ContextEngine.indexCodebase: Added session reuse logic

  • New findIndexingSession() method to locate existing indexing session
  • Reuses active codebase-indexer session if exists
  • Creates new session only when none exists

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.5.2

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.5.2

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.5.2

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.5.1

DevMind MCP v2.5.1

Fixed

• Tool Descriptions: Improved clarity of optional/required parameters to prevent AI misuse in multi-project scenarios
• Session Management: Fixed session creation to reuse existing sessions, ensuring stable main session IDs
• Codebase Indexing: Now uses temporary sessions to avoid interfering with user sessions

Changed

• record_context: Updated project_path description to clarify auto-detection behavior
• semantic_search: Verified correct search of both memory and codebase files
• All tools: Standardized project_path parameter descriptions

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.5.1

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.5.1

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.5.1

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.5.0

DevMind MCP v2.5.0

Fixed

• Critical: semantic_search Core Defect Fixed: Previously, semantic_search only searched development memory (contexts table) while completely ignoring ContextEngine-indexed code files (file_index table), causing the "full project understanding" feature to fail
  • Database Layer: Added getFileIndexForVectorSearch() method to query file_index table
  • Search Logic: Modified handleSemanticSearch() to query both contexts and file_index
  • Data Conversion: Convert file_index records to Context-compatible format
  • Priority Optimization: Code file quality score increased from 0.8 to 0.95
  • Project Detection: Improved path detection logic for multi-project scenarios
  • Smart Warnings: Detect multiple active projects and warn users to explicitly specify project_path

Added

• Enhanced Project Detection: Multi-factor scoring system for project path detection

  • Existing projects get +10 points
  • Recently accessed projects get additional +20 points
  • Projects with .git directory get +5 points
  • Detailed logging for troubleshooting

• Multi-Project Warnings: Smart detection and user guidance

  • Detects multiple recently active projects (within 7 days)
  • Warns when operations might be recorded to non-most-recent project
  • Provides clear usage recommendations

Changed

• Search Result Ranking: Code files now prioritized for "how to implement" queries
  • Code files: quality_score 0.95 (was 0.8)
  • Development memory: quality_score 0.9
  • Combined with QueryEnhancer file type weights for optimal results

Impact

• For Users: Can now perform true "full project understanding" queries in natural language
• For Developers: Code discovery and project understanding significantly improved
• Multi-Project Support: Better isolation and warnings for multi-project development scenarios
• Performance: Unified search across memory and codebase without performance degradation

Testing

• Created comprehensive test script test-semantic-search.js validating the fix
• Verified development memory + codebase index simultaneous search
• Confirmed code file priority for "implementation" queries
• TypeScript compilation passes with no errors

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.5.0

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.5.0

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.5.0

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.9

DevMind MCP v2.4.9

Added

• ContextEngine - Codebase Indexing System: Complete implementation of project file indexing
  • New codebase tool: Index project files for semantic search
  • New delete_codebase_index tool: Remove codebase index for a project
  • Intelligent file scanning with .gitignore and .augmentignore support
  • Built-in exclusion patterns for common directories (node_modules/, dist/, build/, .git/, etc.)
  • Supports 20+ programming languages
  • Independent storage in file_index table to avoid polluting development memory
  • Incremental indexing based on file hashes
  • Binary file detection and automatic skipping

Fixed

• Ignore Library Usage: Fixed incorrect ignore library usage in IgnoreProcessor
  • Changed from (ignore as any)({ ignorecase: true }) to ignore().add(content)
  • Updated import statement from import * as ignore to import ignore
  • Enables proper file filtering and directory exclusion

Changed

• Documentation Updates: Comprehensive README updates for 15 MCP tools
  • Removed references to deleted tools (project_analysis_engineer, verify_work_recorded)
  • Added ContextEngine section with .gitignore and .augmentignore documentation
  • Updated tool count from 15 to 16 then back to 15 (corrected error)
  • Updated project structure to reflect new context-engine directory

Impact

• For Users: Can now index entire codebases and search through code files
• For AI: Enhanced semantic search across both development memory and codebase
• Performance: Efficient file scanning with intelligent filtering

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.9

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.9

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.9

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.8

DevMind MCP v2.4.8

Fixed

• Session ID Detection: Fixed critical issue where subdirectories created separate sessions

  • Now correctly associates subdirectory operations with parent directory session
  • Supports empty directories (no git/gitignore required)
  • Ensures single session per project across all subdirectories
  • Fixed Windows path normalization for Unix-style paths

• Removed Dead Configuration: Cleaned up unused max_contexts_per_session config

  • Eliminated misleading configuration options
  • Aligned documentation with actual code implementation
  • Clarified DevMind's design philosophy: unlimited complete development memory

Changed

• Enhanced Path Resolution: Improved project root detection logic
  • Forces project root lookup in all path inference scenarios
  • Ensures consistent cache key normalization
  • Better handling of Windows path case sensitivity

Impact

• For Users: No duplicate sessions, cleaner memory organization
• For AI: More predictable session management across project subdirectories
• Performance: Faster session lookup with improved caching

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.8

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.8

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.8

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.7

DevMind MCP v2.4.7

Added

• Smart Duplicate Detection: Automatically detects similar memories before recording
  • Searches recent 24-hour memories with 85% similarity threshold
  • Warns AI when potential duplicate is found
  • Suggests using update_context instead of creating duplicates
  • Minimal performance impact (~50-100ms, only during recording)

Improved

• Enhanced update_context Tool Description: Now clearly explains when and how to use

  • Added explicit use cases: user requests + AI discovers duplicates
  • Provided clear workflow for avoiding duplicate memories
  • Emphasized importance of keeping memory clean

• Enhanced record_context Tool Description: Added "BEFORE RECORDING" guidance

  • Prompts AI to search for similar contexts first
  • Suggests using update_context for duplicates
  • Helps maintain clean and organized memory

Impact

• Reduces duplicate memory records
• Improves memory quality and maintainability
• Guides AI to use tools correctly
• Keeps memory database clean and efficient

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.7

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.7

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.7

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.6

DevMind MCP v2.4.6

Fixed

• Critical: Removed Auto File Monitoring to Fix Memory Leak: Resolved frequent memory overflow crashes
  • Removed legacy CLI auto-monitoring feature (~500 lines of code)
  • Fixed "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory"
  • Removed chokidar file watcher that caused continuous memory growth
  • Impact: MCP server now stable, no more crashes or connection failures

Removed

• Auto file monitoring feature (legacy from CLI version, unused in MCP architecture)
  • startAutoMonitoring() and related methods
  • fileWatcher and file system monitoring
  • Automatic context recording on file changes
• Note: All memory recording now done through AI actively calling record_context tool (higher quality, no duplication)

Improved

• Reduced memory footprint significantly
• Improved MCP server stability and reliability
• Eliminated duplicate memory recordings
• Better resource utilization

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.6

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.6

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.6

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.5

DevMind MCP v2.4.5

Fixed

• Enhanced record_context Trigger Coverage for Update Operations: Improved auto-memory reliability in Claude Code CLI
  • Explicitly listed all file operation types: create, write, update, modify, edit, delete
  • Previously only mentioned "editing files", causing Update operations to be missed
  • Now covers all file change scenarios consistently
  • Impact: Update operations in Claude Code CLI now reliably trigger automatic memory recording

Improved

• Tool description now explicitly covers all file operation verbs used by different AI coding tools
• Ensures consistent auto-memory behavior across Write and Update modes

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.5

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.5

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.5

Documentation

• 📖 README
• 📝 Full Changelog

Release v2.4.4

DevMind MCP v2.4.4

Optimized

• Massive Token Reduction Across All Tool Descriptions: Reduced total token usage by ~1,500+ tokens (70%+ reduction)
  • record_context: 450 → 150 tokens (67% reduction)
    • Added critical workflow requirement with ⚠️ warning
    • Simplified to YOU MUST 5-point checklist
    • Removed redundant WHY/HOW sections
    • Kept strong enforcement language (CRITICAL, MUST) for auto-call behavior
  • semantic_search: 500 → 120 tokens (76% reduction)
  • list_projects: 350 → 80 tokens (77% reduction)
  • get_context: 300 → 100 tokens (67% reduction)
  • list_contexts: 280 → 100 tokens (64% reduction)
  • Impact: Significantly faster AI processing, lower API costs, improved response times

Improved

• Tool descriptions now follow consistent pattern: WHEN TO USE + KEY PARAMETERS + Returns
• Removed verbose WHY/HOW sections that AI doesn't need
• Kept critical information for tool selection and usage
• Enhanced record_context with Sequential Thinking-inspired enforcement pattern
• Better balance between clarity and conciseness

Technical Details

• Analyzed official MCP Sequential Thinking server for best practices
• Applied strong enforcement language only to record_context (auto-call tool)
• Simplified other tools (user-initiated) to essential information only
• Maintained all functionality while dramatically reducing token overhead

---

Installation

Via npx (recommended, no installation needed):

Use specific version:

npx -y devmind-mcp@2.4.4

Or always use latest:

npx -y devmind-mcp@latest

Or install globally:

Install specific version:

npm install -g devmind-mcp@2.4.4

Install latest:

npm install -g devmind-mcp@latest

NPM Package

• 📦 devmind-mcp@2.4.4

Documentation

• 📖 README
• 📝 Full Changelog