@dollhousemcp/mcp-server 1.9.24 → 1.9.26

package/CHANGELOG.md

@@ -2,6 +2,248 @@
 
 ## [Unreleased]
 
+## [1.9.26] - 2025-11-07
+
+**Major Feature Release**: Element Source Priority System & Critical Bug Fixes
+
+### ✨ Features
+
+- **Element Source Priority System** (#1451, #1452, #1453, #1454, #1455, #1456) 🌟
+  - **Intelligent element selection** based on configurable source priority
+  - Replaces simple source filtering with advanced priority-based ranking
+  - **Priority levels** (configurable per element type):
+    - `local` - User's portfolio (highest priority by default)
+    - `github` - Personal GitHub portfolio
+    - `collection` - Community collection (lowest priority by default)
+  - **User-facing API** for source priority configuration via `dollhouse_config` tool
+  - **Automatic conflict resolution** when same element exists in multiple sources
+  - **Search integration** - UnifiedIndexManager respects source priority in all searches
+  - **Installation integration** - ElementInstaller follows priority when installing elements
+  - **Comprehensive documentation** - User guides and technical references
+  - **Full test coverage** - 3000+ lines of tests including integration tests
+  - **Non-breaking** - Falls back to local-first behavior if priority not configured
+  - **Configuration persistence** - Saves to `~/.dollhouse/config.yaml`
+
+### 🐛 Bug Fixes
+
+- **Memory Content Preservation** (#1442)
+  - Fixed bug where memory content was lost during YAML import/parsing
+  - Ensures all memory data persists correctly through serialization
+  - Improved error handling for YAML parsing edge cases
+
+- **VerbTriggerManager Critical Bugs** (#1443)
+  - Fixed three critical bugs in verb trigger extraction and management
+  - Improved reliability of verb-based element search
+  - Enhanced error handling and validation
+
+- **OAuth Terminal Error Propagation** (#1444)
+  - Implements RFC 6749/8628 compliance for OAuth device flow
+  - Errors now propagate immediately to terminal instead of hanging
+  - Better user experience during authentication failures
+
+- **GitHubAuthManager Test Mocks** (#1459)
+  - Fixed incomplete Response mock objects causing 8 test failures
+  - Added missing `status`, `statusText`, and `headers` properties
+  - Ensures proper Fetch API compatibility in tests
+
+### 🔧 Technical Improvements
+
+- **jsdom Stability** (#1458)
+  - Rolled back jsdom from 27.1.0 to 27.0.0 to maintain test stability
+  - Avoids ESM/CommonJS incompatibility with parse5 v8
+  - Maintains stable test environment across all platforms
+
+- **SonarCloud Badges** (docs commit 0f30386b)
+  - Restored SonarCloud quality badges to README chunk file
+  - Prevents auto-sync workflow from removing badges
+  - Ensures badges persist across README regeneration
+
+### 📦 Dependency Updates
+
+- **@modelcontextprotocol/sdk** 1.20.2 → 1.21.0 (#1439)
+- **posthog-node** 5.10.3 → 5.11.0 (#1441)
+- **@types/archiver** 6.0.4 → 7.0.0 (#1440)
+- **@types/node** 24.9.1 → 24.10.0 (#1438)
+
+### 📖 Documentation
+
+- **Element Source Priority Documentation** (#1456)
+  - Complete user guide for source priority configuration
+  - Technical implementation details
+  - Best practices and usage examples
+
+- **Session Notes**: Comprehensive documentation of:
+  - Element Source Priority implementation (6 phases)
+  - Bug fixes and investigations
+  - Release preparation process
+
+### 🎯 Impact
+
+**Element Source Priority System**:
+- Advanced element selection replacing simple filtering
+- User control over which sources take precedence
+- Automatic conflict resolution for duplicate elements
+- Foundation for future multi-source element management
+- Seamless integration with existing search and installation flows
+
+**Bug Fixes**:
+- Memory data integrity guaranteed
+- Verb-based search reliability improved
+- OAuth authentication experience enhanced
+- Test suite fully passing across all platforms
+
+### 🔗 Related Issues & PRs
+
+- PR #1451: Source priority configuration system
+- PR #1452: UnifiedIndexManager source priority integration
+- PR #1453: ElementInstaller source priority support
+- PR #1454: User-facing configuration API
+- PR #1455: Integration tests for source priority
+- PR #1456: Comprehensive documentation
+- PR #1442: Memory content preservation fix
+- PR #1443: VerbTriggerManager bug fixes
+- PR #1444: OAuth error propagation
+- PR #1458: jsdom rollback for stability
+- PR #1459: GitHubAuthManager test fixes
+
+---
+
+## [1.9.25] - 2025-10-30
+
+**Major Feature Release**: Auto-Load Baseline Memories & Production Stability
+
+### ✨ Features
+
+- **Auto-Load Baseline Memories** (#1430, #1431) 🌟
+  - **Self-aware DollhouseMCP**: Server now loads baseline knowledge automatically on startup
+  - Eliminates 20-40k token searches for "what can dollhouse do?" - now instant with zero search
+  - Users can mark ANY memory for auto-load via `autoLoad: true` metadata flag
+  - Priority-based loading system (lower priority number = loads first)
+  - Configurable via `~/.dollhouse/config.yaml`:
+    - `autoLoad.enabled` - Global on/off switch (default: true)
+    - `autoLoad.maxTokenBudget` - Token safety limit (default: 5000)
+    - `autoLoad.memories: []` - Explicit memory list (empty = use metadata flags)
+  - Includes seed memory: `dollhousemcp-baseline-knowledge.yaml`
+    - ~2500 tokens of core capabilities overview
+    - Comprehensive trigger words for semantic search
+    - Auto-loaded by default (priority: 1)
+  - **Use Cases**:
+    - Baseline AI context (what DollhouseMCP can do)
+    - Team onboarding (project context for new engineers)
+    - Agent orchestration (swarm foundation with pre-loaded knowledge)
+    - Always-available project knowledge (like CLAUDE.md for Claude Code)
+  - Non-breaking: Auto-load failure logs warning but doesn't prevent startup
+  - Graceful degradation: Returns empty array on error
+  - Production-ready for VC evaluations and agent swarms
+  - **Performance Optimization**: Token estimate caching
+    - Content hash-based caching (SHA-256, first 16 chars)
+    - Max 1,000 cached entries (prevents memory leaks)
+    - ~50% improvement for repeated content calculations
+  - **Enhanced Error Handling**:
+    - Detailed error messages with error type
+    - Helpful recovery suggestions for common errors (ENOENT, EACCES, YAML parse)
+    - Better diagnostics for troubleshooting
+  - **Comprehensive Documentation** (3 new seed memories):
+    - `how-to-create-custom-auto-load-memories.yaml` - Complete step-by-step guide
+    - `priority-best-practices-for-teams.yaml` - Team coordination strategies
+    - `token-estimation-guidelines.yaml` - Optimization techniques and budgeting
+
+### 🐛 Bug Fixes
+
+- **Extended Node Compatibility CI Failures** (CRITICAL - weeks old) (#1432, #1433, #1434)
+  - **Root Cause**: JSDOM/parse5 ESM race condition during Jest teardown
+  - ALL 6 platforms (Ubuntu/macOS/Windows × Node 20.x/22.x) were failing
+  - 19 test files broken with "Must use import to load ES Module" errors
+  - **Phase 1 Fix** (#1433):
+    - Fixed jsdom version mismatch (package.json declared 27.0.1, installed 27.0.0)
+    - Added `maxConcurrency: 1` to enforce truly serial test suite execution
+    - Result: 5 out of 6 platforms passing
+  - **Phase 2 Fix** (#1434):
+    - Increased memory threshold from 500MB to 650MB for YAML bomb test
+    - Windows Node 22.x has ~528MB baseline vs ~400-450MB on Linux/macOS
+    - Platform-agnostic threshold accommodates all environments
+    - Result: ALL 6 platforms now passing ✅
+  - **Technical Details**:
+    - JSDOM initialized at module load time in Memory.ts and yamlValidator.ts
+    - JSDOM uses CommonJS require() but parse5 7.3.0 is ESM-only
+    - Race condition: Jest tears down environment while JSDOM loads parse5
+    - CI vs Local: Different npm dependency resolution (nested vs hoisted parse5)
+
+- **README Badge Issues** (#1432, #1435)
+  - Restored SonarCloud badges (6 quality metrics) after auto-sync removal
+  - Fixed Extended Node Compatibility badge URL (was showing main branch failures)
+  - Fixed Docker Testing badge URL (was showing main branch old status)
+  - All badges now correctly point to develop branch with `?branch=develop`
+  - **Root Cause**: README auto-sync workflow syncs FROM main TO develop
+    - Overwrote develop's correct badges with main's outdated badges
+    - Badge URLs defaulted to main branch without explicit `?branch=` parameter
+
+### 🔧 Technical Improvements
+
+- **LICENSE Synchronization** (#1432)
+  - Synchronized develop LICENSE with main's proven working structure (763-line monolithic)
+  - Main branch LICENSE confirmed working with Glama and GitHub licensee
+  - Removed `LICENSE-ADDITIONAL-TERMS.md` (develop-only experimental file)
+  - Eliminates divergence risk for external license detection tools
+
+- **Jest Configuration Optimization** (#1432)
+  - Restored optimal maxWorkers configuration for CI environments
+  - Added maxConcurrency: 1 for suite-level serialization
+  - Prevents race conditions in test suite execution
+  - Maintains >96% code coverage across all platforms
+
+### 📊 Test Results
+
+**Before Fixes**:
+- Extended Node Compatibility: ALL 6 platforms FAILING ❌
+- 19 test files with JSDOM/parse5 errors
+
+**After Fixes**:
+- Test Suites: 143 passed, 143 of 146 total ✅
+- Tests: 2,656 passed, 2,760 total ✅
+- Coverage: >96% maintained ✅
+- Extended Node Compatibility: ALL 6 platforms PASSING ✅
+  - Ubuntu Node 20.x ✅
+  - Ubuntu Node 22.x ✅
+  - macOS Node 20.x ✅
+  - macOS Node 22.x ✅
+  - Windows Node 20.x ✅
+  - Windows Node 22.x ✅
+
+### 📖 Documentation
+
+- **Session Notes**: Comprehensive documentation of:
+  - Issue #1430 implementation details
+  - CI investigation and resolution process
+  - State-of-repo snapshot for future comparison
+  - Badge saga timeline and fixes
+
+### 🎯 Impact
+
+**Auto-Load Memories Feature**:
+- 80% reduction in tokens for capability questions
+- Instant answers to "what can dollhouse do?"
+- Foundation for agent swarm orchestration
+- Self-aware AI system with baseline knowledge
+- Like CLAUDE.md but for DollhouseMCP itself
+
+**CI Stability**:
+- Resolved weeks-old critical failures blocking all development
+- 100% CI pass rate across all platforms
+- Production-ready develop branch
+- Accurate badge reporting for contributors
+
+### 🔗 Related Issues & PRs
+
+- Issue #1430: Auto-load baseline memories feature
+- PR #1431: Auto-load baseline memories implementation
+- PR #1432: License sync, Jest config, SonarCloud badges
+- PR #1433: Extended Node Compatibility Phase 1
+- PR #1434: Extended Node Compatibility Final
+- PR #1435: README badge fixes
+
+---
+
 ## [1.9.24] - 2025-10-27
 
 **Documentation Release**: Claude Skills Compatibility & Dependency Updates