1.1.2

MCP Nexus v1.1.2 Release Notes

🚀 Major New Features

📦 Dump Validation & Preflight Checks

• New dump validation pipeline added to verify crash dumps before starting full analysis.
• The server now probes dump files (reads a byte) up front to ensure they are accessible, failing fast when files are invalid or unreadable.
• Integrated usage of the dump check (dumpchk) helper binary into the workflow for earlier, clearer validation of dump health.
• The symbol path is now passed to the dumpchk tool, improving the quality and diagnostics of validation output.
• Added an option to automatically remove the dump file when the debug session ends, helping keep environments clean when desired.

🗄️ Storage Management & Retention

• Introduced a retention policy for log files to prevent unbounded growth over long-running deployments.
• Added a retention policy for CDB output files, pruning old debugger outputs according to configurable rules.
• Implemented compression of CDB output files, significantly reducing disk footprint for verbose debugging sessions.

⚡ Performance & Reliability

🧵 Debugger Lifecycle & Service Shutdown

• Ensured the debugger/debug session is reliably destroyed during service shutdown, reducing the risk of orphaned WinDBG/CDB processes.
• Added safeguards to avoid writing to the input stream of already terminated processes, preventing spurious errors and improving robustness under failure scenarios.

🧠 Dump Checking Robustness

• Hardened the dump check path with improved error handling and a fix for a minor exception that could occur in edge cases.
• Overall dump-check behavior is now more deterministic and explicit when encountering invalid or inaccessible dumps.

🧪 Quality & Testing

• Configuration for tests was cleaned up:
  • Corrected appsettings naming in unit test projects.
  • Refactored configuration files to be more general and reusable across different environments.
• Existing tests were updated and aligned with the new dump validation, dumpchk integration, and retention behavior.
• All tests are passing, with code coverage maintained above the required thresholds for both line and branch coverage.

🐛 Fixes & UX Polish

• Fixed a minor exception in dump checking to avoid noisy failures and improve resilience.
• General test and formatting cleanups across the solution for consistency with repository standards.
• Added a Nexus icon for a more polished and recognizable visual identity.
• Enhanced the startup banner with additional details, making it easier to see key configuration/instance information when the server starts.

1.1.1

MCP Nexus v1.1.1 Release Notes

🚀 Major New Features

🧩 Configuration & Server Setup

• Rich, strongly-typed configuration models added:
  • AutomatedRecoverySettings, BatchingSettings, DebuggingSettings, ExtensionsSettings,
    IpRateLimitingSettings, LoggingSettings, McpNexusSettings, RateLimitRule,
    ServerSettings, ServiceSettings, SessionManagementSettings, TransportSettings
• Configuration/Logging wiring updated to use the new models for clearer, safer configuration

🌐 Protocol Layer

• New EngineService in nexus_protocol/Services to encapsulate engine operations
• Expanded protocol tests across tools, middleware, notifications, and resources

🔐 External APIs

• Administrator detection utilities added:
  • Security/AdministratorChecker and IAdministratorChecker

⚡ Performance & Reliability

🔧 Engine & Batching

• Settings forwarded into the debug engine for deterministic behavior
• Batching pipeline refinements:
  • BatchProcessor, BatchCommandBuilder, BatchCommandFilter,
    BatchResultParser, BatchSentinels, SessionBatchCache
• Command preprocessing improvements:
  • CommandPreprocessor, PathHandler, WslPathConverter

🧠 Encapsulation & Surface Area

• Reduced number of public classes to tighten encapsulation and improve maintainability
• Setup and Protocol libraries no longer singletons; constructor-injected lifetimes for testability

🧪 Quality & Testing

• Test coverage substantially increased:
  • 1228 total tests (all passing)
  • 87.1% line coverage, 77.8% branch coverage
• Significant test additions across engine internals, protocol server/services/tools,
  middleware, resources, configuration, setup, share, and extensions
• New/expanded tests for:
  • Engine internals (CDB session/queue/debug session/process output)
  • Batching components and sentinels
  • Protocol notifications, tools, middleware, resources
  • Setup managers, validators, installers
  • Config loading/logging and typed settings
  • Shared models and ID generators

🐛 Fixes

• Numerous static analyzer/style issues resolved
• Protocol and extensions callback models split into explicit types for clarity and safer usage
• General hardening across configuration and logging paths

1.1.0

MCP Nexus v1.1.0 Release Notes

🚀 Major New Features

🔧 Extension & Usability

• Markdown-based Extensions: Extensions now use Markdown to simplify data formatting and reduce serialization complexity
• Usage Improvements: Added missing GET tool function to usage information and expanded usage guide

📊 Command Result & Status Enhancements

• Aggregated CDB Output: Combined command outputs for clearer context
• Richer Status Details: More detailed command status including read counts and improved information density

⚡ Performance & Reliability

🔧 Throughput & Latency Tuning

• Batch Size Optimization: Iteratively tuned max batch size to balance throughput vs. queue blocking
• Faster Queue Consumption: Improved consumer to reduce wait times while maintaining batching efficiency
• Callback Server Refactor: Smaller, testable functions to improve maintainability and reliability

⏱️ Timing & Configuration

• Idle Timeout Handling: Sessions auto-close on idle timeouts
• Synchronization Hardening: Locked config paths to avoid divergent code paths
• Statistics Improvements: Added queue and execution times, enhanced session-end statistics, clarified measurement methodology, and surfaced batching visibility

🧠 Data Structures & Caching

• Efficient Lookups: Replaced linear searches with dictionaries
• Batch ID Cache: More performant batch ID lookup via improved cache design

🧪 Quality & Testing

• Addressed static analyzer findings and compile warnings
• Adjusted tests to align with updated production behavior
• Added coverage-generation scripts (report emitted into bin directory)
• Generalized dependency versions for stability

🔒 Security & Service

• Hardened error handling for extensions and command statistics paths
• Improved resiliency around configuration synchronization

🐛 Key Bug Fixes

• Fixed extensions statistics output and error handling
• Fixed command statistics output and error handling
• Fixed coverage tool usage and exclusions
• Fixed tests and formatting issues
• Addressed code review findings
• Resolved compile warnings

📊 Statistics

• Version: 1.1.0
• Commits: 44 commits with improvements and fixes
• Areas Touched: Batching/queue tuning, statistics, extensions, callback server refactor

🎯 Migration Notes

• No MCP tool API changes expected.
• Behavioral tuning in batching and queue consumption may change timing characteristics.
• Extension authors: Markdown format is now the default for extensions; update custom extensions accordingly if they relied on prior formatting.

1.0.6

MCP Nexus v1.0.6 Release Notes

🚀 Major New Features

🔧 Extension System Architecture

• PowerShell Extension Support: Complete extension system for complex debugging workflows
• HTTP Callback API: Secure callbacks for extensions to execute WinDBG commands
• Pre-built Extensions: 4 ready-to-use extensions including stack_with_sources, basic_crash_analysis, memory_corruption_analysis, and thread_deadlock_investigation
• Developer Helper Module: McpNexusExtensions.psm1 for easy extension development
• Security: Token-based authentication with localhost-only access

📊 Enhanced Command Processing

• Command Preprocessor: Advanced preprocessing with path resolution and variable expansion
• Home Directory Support: Built-in ~ (tilde) expansion for user paths
• Improved Path Handling: Better Windows path formats and WSL path conversion

⚡ Performance & Reliability

🔧 Memory & Performance Optimizations

• Intelligent Caching: Memory-efficient caching with improved eviction strategies
• Resource Cleanup: Enhanced disposal patterns preventing memory leaks
• Thread Pool Tuning: Optimized for faster response times
• Async Processing: Improved asynchronous command execution

⏱️ Timeout & Configuration

• Configurable Timeouts: Flexible timeout configuration for different operations
• Enhanced Encoding: Better text encoding for international characters
• Sentinel-based Commands: Enhanced CDB command execution reliability

🧪 Quality & Testing

• 1,862 Total Tests: Comprehensive test suite (all passing)
• Extension Testing: 120+ tests for extension system
• Zero Warnings: Clean build with warnings treated as errors
• 62.62% Coverage: Enhanced branch coverage with edge case testing

🔒 Security & Service

• Extension Security: Token validation and session isolation
• Windows Service: Improved service installation and logging
• Session Management: Enhanced lifecycle management and cleanup

🐛 Key Bug Fixes

• Fixed session number handling and lifecycle management
• Resolved command completion detection issues
• Fixed blocking calls in command result reading
• Proper dispose pattern implementation preventing resource leaks
• Enhanced concurrency and thread safety

📊 Statistics

• Version: 1.0.6.86 (from 1.0.5)
• Commits: 140+ commits with new features and improvements
• New Components: Extension system with 17+ classes and 4 example extensions
• Build Status: 0 warnings, production-ready

🎯 Migration Notes

The extension system is fully backward compatible. No breaking changes to existing MCP tools or workflows.

---

Full Changelog: 1.0.5...1.0.6

1.0.5

🚀 MCP Nexus v1.0.5.32 - Enterprise Quality Release

📊 Quality Metrics

• 1,936 Tests (100% passing) - +747 tests from v1.0.4
• 89.71% Code Coverage - +43.71% improvement
• Zero Build Warnings - Clean enterprise-grade codebase
• A+ Quality Grade - Production ready

🏆 Major Achievements

✅ Complete Test Coverage

• All production classes now have comprehensive test coverage
• Zero untested classes remaining in the codebase
• 15+ test categories covering all major functionality

✅ Enterprise-Grade Quality

• Zero-warning build across all configurations
• Perfect code formatting with automated tooling
• Comprehensive error handling and edge case coverage

🆕 New Test Categories

• Session Management: 300+ tests
• Command Queue: 200+ tests
• Notifications: 150+ tests
• Infrastructure: 100+ tests
• Security: 80+ tests
• Health & Metrics: 70+ tests
• Resilience: 60+ tests
• Integration: 50+ tests
• Utilities: 40+ tests
• Models: 30+ tests
• Recovery: 25+ tests
• Tools: 20+ tests
• Resources: 15+ tests
• Protocol: 8+ tests

🔧 Infrastructure Improvements

• Complete Windows service management testing
• Comprehensive configuration testing
• Full logging infrastructure testing
• Complete security validation testing

🐛 Bug Fixes

• Fixed intermittent test failures in async operations
• Resolved race conditions in command queue tests
• Eliminated all build warnings
• Fixed code formatting inconsistencies

---

This release represents a massive quality improvement with enterprise-grade standards and comprehensive test coverage.

1.0.4

Release Notes - MCP Nexus v1.0.4

🚀 Major Changes

📚 Complete Documentation Overhaul

• Comprehensive rewrite of all documentation files for clarity and accuracy
• Removed fictional content - All documentation now reflects actual implemented features
• Enhanced README.md with better problem/solution explanation and comprehensive feature overview
• Restructured documentation with clear navigation and improved organization
• Added detailed usage examples and integration guides

🔧 MCP Protocol Compliance

• Standardized MCP resource implementation - Complete restructure for MCP compliance
• Proper resource URIs - All resources now use standard conforming URIs
• Enhanced MCP integration - Better compatibility with MCP clients
• Improved error reporting - Clearer error messages for AI clients

🧪 Massive Test Coverage Expansion

• 1,189 tests - Comprehensive test suite covering all functionality
• 46%+ code coverage - Significant improvement in test coverage
• Fixed 38 warnings - All compiler and analyzer warnings resolved
• Enhanced test reliability - Fixed flaky tests and improved test stability

🛠️ Technical Improvements

🏗️ Architecture Enhancements

• Standard SDK adoption - Migrated to standard MCP SDK for most operations
• Improved concurrency handling - Fixed race conditions and threading issues
• Enhanced notification system - Non-blocking progress communication
• Better error recovery - Improved fault tolerance and recovery mechanisms

🔒 Security Features

• Command validation - Advanced security service for input validation
• Dangerous command blocking - Prevents execution of harmful commands
• Path traversal protection - Prevents directory traversal attacks
• SQL injection protection - Basic SQL injection pattern detection
• Input sanitization - Comprehensive input validation and sanitization

📊 Performance & Monitoring

• Intelligent caching system - Memory-based caching with TTL support
• Advanced metrics collection - Comprehensive performance monitoring
• Circuit breaker implementation - Fault tolerance and resilience patterns
• Health monitoring - System health status and monitoring capabilities

🔄 Command Queue Improvements

• Asynchronous command execution - Non-blocking command processing
• Command timeout handling - Automated timeout management
• Progress tracking - Real-time command execution progress
• Command cancellation - Proper cancellation token support

🐛 Bug Fixes

Critical Fixes

• Fixed notification blocking - Resolved issue where notifications blocked execution
• Fixed argument naming - Corrected wrong argument names in tool definitions
• Fixed cancellation issues - Proper cancellation token handling
• Fixed concurrency issues - Resolved race conditions in multi-threaded scenarios

Minor Fixes

• Improved logging levels - Better log level configuration
• Enhanced error messages - Clearer error reporting for debugging
• Fixed flaky tests - Improved test reliability and stability
• Code cleanup - General code quality improvements

📁 New Features

🌐 Web Interface

• Admin dashboard - Web-based administration interface
• Queue monitoring - Real-time command queue status
• Process management - Process monitoring and control
• Analysis tools - Web-based analysis tools and utilities

🔧 Configuration

• Enhanced configuration - More flexible configuration options
• Symbol server optimization - Improved symbol loading and caching
• Timeout configuration - Configurable timeouts for different operations
• Service configuration - Better service configuration management

📈 Quality Improvements

🧪 Testing

• Comprehensive test coverage - Tests for all major components
• Integration tests - End-to-end testing scenarios
• Performance tests - Load and performance testing
• Edge case testing - Testing of edge cases and error conditions

📝 Documentation

• API documentation - Complete API reference
• Usage examples - Comprehensive usage examples and workflows
• Integration guides - Step-by-step integration instructions
• Troubleshooting guides - Common issues and solutions

🔄 Breaking Changes

MCP Resource Changes

• Resource URI format - Changed from custom format to standard MCP format
• Resource parameters - Removed parameter support (MCP resources don't support parameters)
• Resource responses - Standardized response format

API Changes

• Tool definitions - Updated tool parameter names and descriptions
• Error responses - Standardized error response format
• Notification format - Updated notification message format

🚀 Migration Guide

For Existing Users

1. Update MCP client - Ensure your MCP client supports standard resource URIs
2. Update tool calls - Use updated tool parameter names
3. Review configuration - Check new configuration options
4. Test integration - Verify compatibility with your AI system

For New Users

1. Follow quick start guide - Use the updated README.md for setup
2. Review documentation - Check the comprehensive documentation
3. Explore examples - Use the provided usage examples
4. Configure properly - Set up according to configuration guide

📊 Statistics

• Total Commits: 50+ commits since v1.0.3
• Files Changed: 100+ files modified
• Test Coverage: 46%+ (up from previous version)
• Total Tests: 1,189 tests
• Documentation: 8 comprehensive documentation files
• Warnings Fixed: 38 compiler/analyzer warnings resolved

🙏 Acknowledgments

• Model Context Protocol specification and community
• C# SDK for Model Context Protocol for MCP integration
• Microsoft debugging tools for core functionality
• NLog for comprehensive logging

---

Full Changelog: https://github.com/your-username/mcp_nexus/compare/1.0.3...1.0.4

1.0.3

🚀 Release Notes - MCP Nexus v1.0.3

🎯 Major Features & Improvements

📡 Real-Time Notifications System

• Server-initiated notifications for command execution progress
• Live status updates via notifications/commandStatus
• Heartbeat monitoring for long-running commands via notifications/commandHeartbeat
• Session recovery notifications via notifications/sessionRecovery
• Server health monitoring via notifications/serverHealth

🔄 Enhanced Async Command System

• Non-blocking command execution with progress tracking
• Command queuing system with timeout handling
• Session-aware command processing for better resource management
• Automatic session cleanup and resource management

🛠 New Session Management Tools

• nexus_list_dump_analyze_sessions - List all active debugging sessions
• nexus_list_dump_analyze_session_async_commands - List commands for specific sessions
• nexus_dump_analyze_session_async_command_status - Get command execution status and results

📚 MCP Resources Integration

• Session management resources (sessions://list, commands://list, commands://result)
• Documentation resources (docs://workflows, docs://usage)
• Structured resource access with consistent JSON responses
• Error handling with helpful hints and guidance

🔧 Technical Improvements

Performance & Reliability

• Concurrency improvements with thread-safe session management
• Memory management optimizations and resource cleanup
• Timeout handling for command execution and session management
• Race condition fixes in command queuing system

Code Quality & Architecture

• Dependency injection improvements and interface abstractions
• Error handling enhancements with structured error responses
• Logging improvements with precise messaging and reduced noise
• Code style alignment and static analysis fixes

Testing & Coverage

• Increased test coverage across all components
• Unit tests for async command system
• Integration tests for notification system
• Performance tests for concurrent operations

🐛 Bug Fixes

• Session ID parsing fixes and validation improvements
• Command timeout handling and cancellation fixes
• Path handling improvements for WSL and Windows paths
• Protocol version compliance fixes
• Deadlock prevention in session cleanup
• Exception handling during shutdown and cleanup

📖 Documentation Updates

• Comprehensive tool reference with detailed examples
• Resource usage patterns and integration guides
• Real-time notification documentation and examples
• Configuration guides for different deployment scenarios
• Troubleshooting guides and best practices

🔄 Breaking Changes

• Response format standardization - All responses now include consistent fields
• Session management - Enhanced session lifecycle with better error handling
• Command execution - Async commands now require status polling for results

🚀 Migration Guide

For users upgrading from v1.0.2:

1. Update command usage - Use new session management tools for better control
2. Implement notification handling - Add support for real-time progress updates
3. Update resource access - Use new MCP resources for session and command management
4. Review error handling - Updated error messages provide better guidance

📊 Statistics

• 10 MCP Tools available (up from 8)
• 5 MCP Resources for enhanced functionality
• 4 Notification Types for real-time updates
• 100% Test Coverage for core functionality
• Zero Breaking Changes for existing tool usage

---

Full Changelog: 1.0.2...1.0.3

Documentation: 📋 TOOLS.md | 🔧 Configuration | 🤖 Integration

1.0.2

🌟 What's New

🌐 HTTP Transport Support

• Full HTTP transport mode alongside stdio
• JSON-RPC 2.0 compliant MCP server
• Configurable ports (5117 dev, 5000 production)

🔧 Windows Service Integration

• --install / --uninstall / --update commands
• Production deployment to Program Files
• Automatic backup system with organized structure

📊 Enhanced Operations

• Structured logging with operation prefixes
• Comprehensive --help system
• Multi-target logging (file, console, Event Log)

🛠️ Key Improvements

• Platform Evolution: Repositioned as comprehensive MCP platform (not just debugging)
• Service Management: Complete Windows service lifecycle management
• Documentation: Complete README overhaul with integration guides
• Code Quality: Fixed all compiler warnings and improved error handling
• Backup System: Organized timestamped backups in backups/[timestamp] structure

🐛 Bug Fixes

• Fixed null reference warnings in logging
• Proper handling of service "marked for deletion" states
• JSON serialization compliance (camelCase properties)
• Robust cleanup for failed service operations

🚧 Breaking Changes

• Transport mode must be explicitly specified (--http or --stdio)
• Default HTTP port changed (5117 dev, 5000 production)
• New structured logging format

📋 Migration from v1.0.0

1. Update MCP client configs with transport mode
2. Use new --install command for service deployment
3. Update port configurations if using HTTP mode

🔧 Quick Start

Development mode

dotnet run -- --http

Install as Windows service

dotnet run -- --install

Update existing service

dotnet run -- --update

1.0.1

Fix the issue that it wasn't able to find the cdb.exe on system different than arm64

1.0.0

Implemented the general Windbg analysis capabilities