DollhouseMCP

# DollhouseMCP v1.8.0 Release Notes **Release Date**: September 15, 2025 **Previous Version**: v1.7.4 **Release Type**: Minor Version Update ## 🚨 Breaking Changes ### Configuration Wizard Auto-Trigger Removed - **What Changed**: The configuration wizard no longer appears automatically on first MCP interaction - **Why**: Different LLMs handled the auto-insertion unpredictably (summarizing, blocking, etc.), causing user experience inconsistencies - **Migration**: The wizard is still available manually via the `config` tool with `action: 'wizard'` - **Impact**: Users will need to explicitly run the configuration wizard if needed ## ✨ New Features & Improvements ### Portfolio Management Enhancements - **Configurable Repository Names**: Portfolio sync now supports custom repository names via configuration - **Enhanced Sync Operations**: Improved sync functionality with better error handling and recovery - **Better GitHub Integration**: More robust authentication and error handling for portfolio operations ### Test Infrastructure Improvements - **Extended Node Compatibility Fixed**: Resolved intermittent CI failures that were blocking releases - **Test Reliability**: Enhanced test mocking and cross-platform compatibility - **CI/CD Stability**: Improved workflow reliability across all supported platforms ## 🔧 Bug Fixes ### GitHub Authentication - **JSON Parsing Error Fixed**: Resolved `Unexpected token 'U', "Unauthorized" is not valid JSON` error - **Better Error Handling**: Improved error messages for authentication failures - **Response Validation**: Added proper response status checking before JSON parsing ### Code Quality - **Test Mock Cleanup**: Fixed unused parameter warnings in test files - **TypeScript Improvements**: Enhanced type safety and removed compilation warnings - **Consistent Code Style**: Applied consistent naming conventions throughout test suite ## 📦 Dependency Updates ### Runtime Dependencies - **@modelcontextprotocol/sdk**: Updated to v1.18.0 (latest MCP protocol features) - **zod**: Updated to v4.1.8 (schema validation improvements) - **jsdom**: Updated to v27.0.0 (DOM testing environment enhancements) ### Development Dependencies - **@types/node**: Updated to v24.4.0 (latest Node.js type definitions) - **Various security patches**: Multiple dependencies updated for security improvements ## 🎯 Developer Experience ### Testing Improvements - **Comprehensive Test Coverage**: Maintained 97%+ test coverage across all changes - **Cross-Platform Validation**: Enhanced support for Windows, macOS, and Linux development - **CI Reliability**: Eliminated flaky tests and improved workflow consistency ### Documentation - **Session Notes**: Comprehensive documentation of all changes and decisions - **Issue Tracking**: Created Issue #950 for tracking remaining Extended Node Compatibility improvements - **Clear Migration Paths**: Documented all breaking changes with migration instructions ## 🔍 Under the Hood ### Architecture Improvements - **Error Handling**: Enhanced error handling patterns throughout the codebase - **Test Infrastructure**: Improved mock strategies and test isolation - **Memory Management**: Better resource cleanup and leak prevention ### Security - **Input Validation**: Continued emphasis on secure input handling - **Authentication**: Improved GitHub authentication flow reliability - **Test Security**: Enhanced security in test environment setup ## 📈 Metrics & Performance ### Test Results - **Total Tests**: 2000+ tests passing consistently - **Coverage**: 97%+ maintained across all modules - **CI Reliability**: 100% pass rate after Extended Node Compatibility fix - **Build Performance**: Optimized build times with enhanced caching ### Compatibility - **Node.js**: Supports Node.js 20.x and 22.x - **Platforms**: Windows, macOS, Linux all fully supported - **MCP Protocol**: Compatible with latest Model Context Protocol specification ## 🚀 Migration Guide ### For Users 1. **Configuration Wizard**: If you rely on the auto-configuration wizard, you'll need to run it manually: ``` # Use the config tool with wizard action Use config tool with action: 'wizard' ``` 2. **No Other Changes Required**: All existing functionality remains the same ### For Developers 1. **Update Dependencies**: Run `npm install` to get the latest dependencies 2. **Test Changes**: Verify your custom tests still pass with the updated test infrastructure 3. **CI Updates**: If you have custom CI workflows, they may benefit from the reliability improvements ## 🎉 What's Next ### Upcoming in v1.9.0 - **Extended Node Compatibility**: Permanent fix for Headers constructor issue (Issue #950) - **Enhanced Portfolio Features**: Additional GitHub integration improvements - **Performance Optimizations**: Further test infrastructure enhancements ### Long-term Roadmap - **Advanced Element Types**: Continued expansion of the element system - **Enhanced User Experience**: More intuitive configuration and setup flows - **Platform Integrations**: Broader ecosystem compatibility ## 📋 Full Changelog ### Merged Pull Requests - **#949**: Fix Extended Node Compatibility test failure - **#948**: Fix unused parameter warnings in test mocks - **#947**: Fix JSON parsing error in GitHub authentication handling - **#946**: Update zod dependency to v4.1.8 - **#944**: Update jsdom dependency to v27.0.0 - **#943**: Update @types/node to v24.4.0 - **#942**: Update @modelcontextprotocol/sdk to v1.18.0 - **#941**: Remove wizard auto-trigger to prevent LLM disruption - **#940**: Update @modelcontextprotocol/inspector to v0.16.7 ### Issues Addressed - **#950**: Extended Node Compatibility: Headers constructor undefined in CI environment (tracking issue) - Various CI reliability and test infrastructure improvements ## 🙏 Acknowledgments This release includes contributions and feedback from the DollhouseMCP community. Special thanks to: - Claude Code for development assistance and code review - GitHub Actions for CI/CD infrastructure - The Model Context Protocol team for ongoing protocol improvements ## 📞 Support & Feedback - **Issues**: [GitHub Issues](https://github.com/DollhouseMCP/mcp-server/issues) - **Discussions**: [GitHub Discussions](https://github.com/DollhouseMCP/mcp-server/discussions) - **Documentation**: [Project Wiki](https://github.com/DollhouseMCP/mcp-server/wiki) --- **🤖 Generated with [Claude Code](https://claude.ai/code)** **Co-Authored-By: Claude <noreply@anthropic.com>**