mcp-prompt-optimizer 1.3.3 → 1.4.0

package/CHANGELOG.md

@@ -2,88 +2,15 @@
 
 All notable changes to the MCP Prompt Optimizer will be documented in this file.
 
-## [1.3.3] - 2025-07-19 - 🚀 **PRODUCTION-READY RELEASE**
+## [1.4.0] - 2025-07-28 - ✨ Backend Alignment & Feature Completion
 
-### 🎯 **Production Deployment**
-- **RELEASE**: Package ready for production publication with 92/100 confidence score
-- **VERIFIED**: All production-grade features tested and validated
-- **CONFIRMED**: Enterprise-grade reliability and network resilience
-- **VALIDATED**: Universal MCP client compatibility verified
-
-### 🛡️ **Network Resilience Excellence**
-- **PRODUCTION**: Exponential backoff with jitter prevents thundering herd
-- **ROBUST**: DNS resolution failure handling with intelligent recovery
-- **ENTERPRISE**: Multiple fallback strategies (cache, mock, offline)
-- **RELIABLE**: 5-tier retry logic with progressive delays up to 30s
-- **TESTED**: Real-world network issue handling proven in production
-- **COMPATIBLE**: Corporate firewall and proxy server support
-
-### 🧪 **Development Experience Perfection**
-- **COMPLETE**: Full offline functionality for development
-- **INTELLIGENT**: Mock optimization responses with realistic data
-- **AUTOMATIC**: Mode detection (dev keys → auto dev mode)
-- **INDEPENDENT**: No backend dependency for testing and development
-- **ENHANCED**: Comprehensive debugging and diagnostic capabilities
-
-### 🔧 **Error Handling Excellence**
-- **COMPREHENSIVE**: Complete error classification system
-- **CLEAR**: Actionable error messages with guided troubleshooting
-- **PROFESSIONAL**: Enterprise-grade user experience
-- **ROBUST**: No crashes under any test scenario
-- **INTELLIGENT**: Context-aware error recovery strategies
-
-### 📊 **Diagnostics & Monitoring**
-- **COMPREHENSIVE**: Full diagnostic tool suite for troubleshooting
-- **MONITORING**: Network health tracking with performance metrics
-- **ANALYTICS**: Cache system monitoring and optimization
-- **METRICS**: Response time tracking and trend analysis
-- **GUIDANCE**: Enterprise-grade troubleshooting recommendations
-
-### ⚙️ **CLI & Configuration**
-- **COMPLETE**: Full CLI tool suite with enhanced commands
-- **METADATA**: Enhanced package.json with comprehensive feature documentation
-- **SCRIPTS**: Separate development and production script configurations
-- **HELP**: Comprehensive help system and documentation
-- **COMPATIBILITY**: Windows command line compatibility verified
-
-### 🧪 **Quality Assurance**
-- **TESTED**: Enhanced test suite with development mode coverage
-- **VALIDATED**: Network resilience testing under various conditions
-- **VERIFIED**: Mock functionality validation and reliability
-- **CONFIRMED**: All edge cases and error scenarios handled gracefully
-
-### 📚 **Documentation Excellence**
-- **ENHANCED**: CLI help text with detailed usage examples
-- **COMPREHENSIVE**: Error guidance with step-by-step troubleshooting
-- **COMPLETE**: Development mode documentation and setup guides
-- **PROFESSIONAL**: Enterprise deployment and configuration guidance
-
-### 🔒 **Security & Validation**
-- **VALIDATED**: API key format validation for all supported types
-- **SECURE**: Safe caching with no sensitive data exposure
-- **SUPPORTED**: Development key support for testing environments
-- **CONSIDERATION**: Rate limiting recommendations for production deployments
-
-### 🚀 **Publication Readiness**
-- **IMMEDIATE**: Ready for NPM publication with excellent user experience
-- **ENTERPRISE**: Network resilience features are production-grade
-- **DEVELOPER**: Development mode features provide outstanding offline capabilities
-- **PROFESSIONAL**: Comprehensive error handling and troubleshooting support
-
-### 🏆 **Quality Metrics Achieved**
-- **🛡️ Network Resilience**: 98/100 (Excellent)
-- **🧪 Development Experience**: 100/100 (Perfect)
-- **🔧 Error Handling**: 95/100 (Excellent)
-- **📊 Diagnostics & Monitoring**: 97/100 (Excellent)
-- **⚙️ Configuration & CLI**: 95/100 (Excellent)
-
-### 🎉 **Production Highlights**
-- **PROVEN**: Real-world tested with actual DNS resolution failures
-- **ENTERPRISE**: Comprehensive network resilience and fallback strategies
-- **DEVELOPER**: Complete offline development capability
-- **PROFESSIONAL**: Clear error messages with guided troubleshooting
-- **COMPATIBLE**: Zero breaking changes, fully backward compatible
-- **UNIVERSAL**: Works with Claude Desktop, Cursor, Windsurf, and 17+ MCP clients
+### ✨ Features & Alignment
+- **ALIGNED**: Fully aligned request payloads and response handling with the latest backend API for enhanced reliability.
+- **ENHANCED**: AI Context Detection now correctly recognizes `structured_output`, `code_generation`, and `api_automation`, providing more accurate, context-aware optimizations.
+- **ADDED**: `search_templates` and `get_quota_status` tools are now fully implemented and validated.
+- **IMPROVED**: Response formatting for all tools provides a richer, more detailed, and user-friendly experience.
+- **VALIDATED**: The comprehensive startup validation and CLI command suite (`diagnose`, `test`, `check-status`) are now fully functional and tested.
+- **FIXED**: Corrected all version inconsistencies across the package for stable dependency management.
 
 ---
 
@@ -120,132 +47,7 @@ All notable changes to the MCP Prompt Optimizer will be documented in this file.
 - **FIXED**: Error handling for backend communication
 - **IMPROVED**: Fallback behavior for missing features
 
-## [2.0.0] - 2024-12-19 - 🚀 **MAJOR RELEASE: True MCP Server**
-
-### 🎯 **Revolutionary Architecture**
-- **BREAKING**: Complete rewrite to true MCP server architecture
-- **NEW**: Hybrid local+remote optimization capabilities
-- **NEW**: Universal compatibility with ALL MCP clients
-- **NEW**: Intelligent routing between optimization strategies
-
-### ⚡ **Local Optimization Engine**
-- **NEW**: JavaScript-based rules engine for ultra-fast optimization (~50ms)
-- **NEW**: AI context detection (image generation, code, technical automation, etc.)
-- **NEW**: Parameter preservation for image generation (`--parameters`)
-- **NEW**: Code block and URL preservation
-- **NEW**: Sophistication analysis for intelligent routing
-- **NEW**: 15+ optimization rules with priority system
-- **NEW**: Offline capability (no API key required for local mode)
-
-### 🌐 **Remote Enhancement**
-- **IMPROVED**: Enhanced remote API integration
-- **NEW**: Smart fallback handling
-- **NEW**: Confidence-based enhancement decisions
-- **NEW**: Batch optimization support
-- **NEW**: Health monitoring and diagnostics
-
-### 🔄 **Hybrid Routing System**
-- **NEW**: Auto mode with intelligent strategy selection
-- **NEW**: Local-first mode (fast local + optional remote enhancement)
-- **NEW**: Remote-first mode (quality remote + local validation)
-- **NEW**: Parallel mode (run both, choose best result)
-- **NEW**: Local-only mode (pure offline)
-- **NEW**: Remote-only mode (cloud-powered)
-
-### 🛠️ **Enhanced Configuration**
-- **NEW**: Comprehensive configuration manager
-- **NEW**: User preference system
-- **NEW**: Environment variable support
-- **NEW**: Configuration file persistence (`~/.mcp-prompt-optimizer/`)
-- **NEW**: CLI configuration options
-- **NEW**: Health check and diagnostic tools
-
-### 📋 **MCP Protocol Compliance**
-- **NEW**: Full JSON-RPC 2.0 implementation
-- **NEW**: Proper MCP protocol version 2024-11-05
-- **NEW**: Standard tools interface
-- **NEW**: Error handling and validation
-- **NEW**: Stdio communication
-
-### 🎮 **Enhanced Tools**
-- **IMPROVED**: `optimize_prompt` with extensive options
-- **NEW**: `health_check` tool with detailed diagnostics
-- **NEW**: `get_config` tool for configuration viewing
-- **NEW**: `update_config` tool for runtime configuration updates
-
-### 🏗️ **New Components**
-- **NEW**: `lib/mcp-server.js` - Core MCP protocol handler
-- **NEW**: `lib/hybrid-router.js` - Intelligent optimization routing
-- **NEW**: `lib/local-optimizer.js` - Local rules engine
-- **NEW**: `lib/remote-client.js` - Enhanced remote API client
-- **NEW**: `lib/ai-context-detector.js` - AI context detection
-- **NEW**: `lib/config-manager.js` - Configuration management
-- **NEW**: `bin/mcp-prompt-optimizer` - New CLI executable
-
-### 📊 **Performance Improvements**
-- **IMPROVED**: ~50ms local optimization (vs ~2-5s remote-only)
-- **NEW**: Parallel processing capabilities
-- **NEW**: Strategy caching for repeated optimizations
-- **NEW**: Intelligent timeout handling
-- **NEW**: Memory-efficient rule application
-
-### 🔧 **Developer Experience**
-- **NEW**: Comprehensive test suite
-- **NEW**: Debug mode with detailed logging
-- **NEW**: Health check and connection testing
-- **NEW**: Configuration generation tools
-- **NEW**: Example configurations for all MCP clients
-
-### 🎯 **AI Context Support**
-- **NEW**: `human_communication` - Emails, letters, social content
-- **NEW**: `llm_interaction` - General LLM conversations (default)
-- **NEW**: `image_generation` - Image/art generation prompts
-- **NEW**: `technical_automation` - DevOps, system administration
-- **NEW**: `structured_output` - JSON, data formats, templates
-- **NEW**: `code_generation` - Programming and development
-- **NEW**: `api_automation` - API calls, integrations
-
-### 🎨 **Optimization Goals**
-- **EXISTING**: `clarity` - Make prompts clearer
-- **EXISTING**: `conciseness` - Remove unnecessary words
-- **EXISTING**: `creativity` - Enhance creative aspects
-- **NEW**: `specificity` - Add specific details
-- **NEW**: `actionability` - Make prompts more directive
-- **NEW**: `comprehensiveness` - Add depth and thoroughness
-- **NEW**: `precision` - Increase accuracy and exactness
-- **NEW**: `engagement` - Improve user engagement
-
-### 📚 **Documentation**
-- **REWRITTEN**: Complete README with hybrid architecture explanation
-- **NEW**: Comprehensive usage examples
-- **NEW**: Performance comparison tables
-- **NEW**: Troubleshooting guide
-- **NEW**: Architecture documentation
-- **NEW**: API reference
-
-### 🔄 **Backward Compatibility**
-- **MAINTAINED**: Legacy mode support for existing users
-- **MAINTAINED**: Existing API key configuration
-- **MAINTAINED**: Original remote-only functionality
-- **SMOOTH**: Auto-detection of old vs new mode
-
-### 🐛 **Bug Fixes**
-- **FIXED**: Connection timeout handling
-- **FIXED**: Error response formatting
-- **FIXED**: Configuration persistence issues
-- **FIXED**: MCP client compatibility issues
-
-### ⚠️ **Breaking Changes**
-- **BREAKING**: New binary location (`bin/mcp-prompt-optimizer`)
-- **BREAKING**: Enhanced configuration structure
-- **BREAKING**: New tool response format (includes content array)
-- **MIGRATION**: Automatic migration from legacy config
-
-### 🔒 **Security**
-- **IMPROVED**: Input validation and sanitization
-- **IMPROVED**: Error message safety
-- **NEW**: Local processing for sensitive parameters
-- **NEW**: Configurable data routing
+---
 
 ## [1.0.2] - 2024-12-17
 
@@ -266,73 +68,4 @@ All notable changes to the MCP Prompt Optimizer will be documented in this file.
 - Remote optimization using AI-Enhanced Prompt Optimizer API
 - MCP protocol compliance
 - Cross-platform support (Windows, macOS, Linux)
-- Global npm installation support
-
----
-
-## Migration Guide: 1.x → 2.0
-
-### For Existing Users
-
-1. **Backup Configuration** (optional):
-   ```bash
-   cp ~/.prompt-optimizer/config.json ~/.prompt-optimizer/config.json.backup
-   ```
-
-2. **Update Package**:
-   ```bash
-   npm update -g mcp-prompt-optimizer
-   ```
-
-3. **Test New Server**:
-   ```bash
-   mcp-prompt-optimizer --health-check
-   ```
-
-4. **Update MCP Client Config** (optional):
-   ```json
-   {
-     "mcpServers": {
-       "prompt-optimizer": {
-         "command": "npx",
-         "args": ["mcp-prompt-optimizer", "--mode", "auto"]
-       }
-     }
-   }
-   ```
-
-### New Configuration Options
-
-```bash
-# Use hybrid mode (recommended)
-mcp-prompt-optimizer --mode hybrid
-
-# Use local-only (no API key needed)
-mcp-prompt-optimizer --local-only
-
-# Debug mode
-mcp-prompt-optimizer --debug
-```
-
-### Legacy Mode
-
-The 1.x functionality is still available:
-```bash
-mcp-prompt-optimizer --legacy
-```
-
----
-
-## Upgrade Benefits
-
-| Aspect | v1.x | v2.0 |
-|--------|------|------|
-| **Speed** | ~2-5s | ~50ms (local) |
-| **Offline** | ❌ | ✅ (local mode) |
-| **Preservation** | ⚠️ | ✅ (perfect) |
-| **Clients** | Limited | All MCP clients |
-| **Architecture** | API wrapper | True MCP server |
-| **Intelligence** | Basic | Hybrid routing |
-| **Flexibility** | Single mode | 5 modes |
-
-**Ready to experience the future of prompt optimization? Update now!**
+- Global npm installation support

package/README.md

@@ -119,7 +119,7 @@ When you update models in WebUI, the NPM package automatically uses the new sett
 
 ## 💰 Cloud Subscription Plans
 
-> **All plans include the same sophisticated AI optimization quality** - differences are only in quotas, team size, and support levels.
+> **All plans include the same sophisticated AI optimization quality**
 
 ### 🎯 Explorer - $2.99/month
 - **5,000 optimizations** per month