|
1 | 1 | # Changelog |
2 | 2 |
|
| 3 | +## [0.2.0] - 2025-11-17 |
| 4 | + |
| 5 | +### 🚀 Major Enhancement: Persistent Daemon Architecture |
| 6 | + |
| 7 | +This release introduces a **complete persistent daemon architecture** that provides Gemini CLI-like session persistence for browser automation MCP servers, enabling seamless multi-command workflows. |
| 8 | + |
| 9 | +### ✨ New Features |
| 10 | + |
| 11 | +#### Persistent Browser Sessions |
| 12 | +- **Daemon Background Service** - Cross-platform daemon process for managing persistent MCP connections |
| 13 | +- **Automatic Session Persistence** - Browser state maintained across CLI command invocations |
| 14 | +- **Zero Configuration Setup** - Works out of the box with existing `mcp_servers.json` configurations |
| 15 | +- **Smart Client Bridge** - Automatic daemon usage with fallback to direct connections |
| 16 | +- **Multi-MCP Server Support** - Simultaneous sessions for Chrome DevTools, Playwright, and other persistent servers |
| 17 | + |
| 18 | +#### New Daemon CLI Commands |
| 19 | +- `daemon start` - Start the background daemon service |
| 20 | +- `daemon stop` - Stop the running daemon |
| 21 | +- `daemon status` - Display daemon status and active sessions |
| 22 | +- `daemon logs` - View daemon service logs |
| 23 | + |
| 24 | +#### Enhanced Browser Automation |
| 25 | +- **Chrome DevTools Integration** - Persistent sessions with console access, navigation, and screenshots |
| 26 | +- **Playwright Integration** - Advanced browser automation with element interaction and page snapshots |
| 27 | +- **Session Auto-Creation** - Browser sessions automatically created when tools are called |
| 28 | +- **Cross-Platform Compatibility** - Windows, Linux, macOS, and WSL support |
| 29 | + |
| 30 | +### 🔧 Configuration Enhancements |
| 31 | + |
| 32 | +#### Simplified Server Configuration |
| 33 | +```json |
| 34 | +{ |
| 35 | + "chrome-devtools": { |
| 36 | + "command": "npx", |
| 37 | + "args": ["-y", "chrome-devtools-mcp@latest", "--isolated"], |
| 38 | + "persistent": true, |
| 39 | + "timeout": 60 |
| 40 | + }, |
| 41 | + "playwright": { |
| 42 | + "command": "npx", |
| 43 | + "args": ["-y", "@playwright/mcp@latest"], |
| 44 | + "persistent": true, |
| 45 | + "timeout": 60 |
| 46 | + } |
| 47 | +} |
| 48 | +``` |
| 49 | + |
| 50 | +- **Persistent Flag** - Simple boolean to enable daemon-managed sessions |
| 51 | +- **Chrome Isolation** - Automatic `--isolated` flag for browser profile conflict prevention |
| 52 | +- **Smart Defaults** - Browser automation servers configured for persistence by default |
| 53 | +- **HTTP API Communication** - RESTful daemon interface for reliable session management |
| 54 | + |
| 55 | +### 🏗️ Architecture Improvements |
| 56 | + |
| 57 | +#### Daemon System |
| 58 | +- **Cross-Platform Process Management** - Native process lifecycle management for all platforms |
| 59 | +- **HTTP API Server** - RESTful interface for daemon communication |
| 60 | +- **Session Health Monitoring** - Automatic session cleanup and recovery |
| 61 | +- **Resource Management** - Proper cleanup of browser processes and connections |
| 62 | +- **PID File Management** - Daemon process tracking and lifecycle coordination |
| 63 | + |
| 64 | +#### Smart Client Architecture |
| 65 | +- **Automatic Daemon Detection** - Checks for running daemon before creating connections |
| 66 | +- **Graceful Fallback** - Falls back to direct connections if daemon unavailable |
| 67 | +- **Session Auto-Start** - Automatically starts daemon for persistent servers |
| 68 | +- **Transport-Agnostic** - Works with both HTTP and stdio MCP servers |
| 69 | + |
| 70 | +### 🛠️ Developer Experience |
| 71 | + |
| 72 | +#### Enhanced Error Handling |
| 73 | +- **Daemon Status Indicators** - Clear feedback on daemon connectivity |
| 74 | +- **Session State Reporting** - Detailed session health and activity information |
| 75 | +- **Graceful Degradation** - Continues working even if daemon unavailable |
| 76 | +- **Comprehensive Logging** - Detailed daemon logs for troubleshooting |
| 77 | + |
| 78 | +#### Improved CLI Interface |
| 79 | +- **Verbose Mode** - Enhanced debugging with daemon communication details |
| 80 | +- **Progress Indicators** - Real-time feedback on daemon operations |
| 81 | +- **Clear Error Messages** - Actionable error messages with suggestions |
| 82 | +- **Status Reporting** - Rich status information for all daemon-managed sessions |
| 83 | + |
| 84 | +### 🔍 Testing and Validation |
| 85 | + |
| 86 | +#### Browser Automation Workflows |
| 87 | +- **Chrome DevTools Testing** - Complete workflow validation: navigate → console access → screenshots |
| 88 | +- **Playwright Testing** - Advanced automation testing: navigation → interaction → screenshots |
| 89 | +- **Session Persistence** - Verified browser state maintained across multiple CLI invocations |
| 90 | +- **Cross-Platform Verification** - Daemon functionality validated on macOS, Linux, and Windows |
| 91 | + |
| 92 | +#### Multi-Server Support |
| 93 | +- **Simultaneous Sessions** - Multiple MCP servers running concurrently |
| 94 | +- **Resource Isolation** - Separate browser instances for each MCP server |
| 95 | +- **Memory Management** - Efficient resource usage with proper cleanup |
| 96 | +- **Process Recovery** - Automatic recovery from browser process crashes |
| 97 | + |
| 98 | +### 📚 Documentation Updates |
| 99 | + |
| 100 | +#### Configuration Guide |
| 101 | +- **Daemon Setup** - Complete guide for enabling persistent sessions |
| 102 | +- **Browser Automation** - Updated examples for Chrome DevTools and Playwright |
| 103 | +- **Troubleshooting** - Common issues and solutions for daemon usage |
| 104 | +- **Migration Guide** - Instructions for upgrading from v0.1.0 |
| 105 | + |
| 106 | +#### Updated Examples |
| 107 | +- **Persistent Workflows** - Real-world examples of multi-command browser automation |
| 108 | +- **Daemon Management** - Complete lifecycle management examples |
| 109 | +- **Chrome DevTools Console** - Browser console access and debugging examples |
| 110 | +- **Cross-Platform Usage** - Platform-specific configuration and usage |
| 111 | + |
| 112 | +--- |
| 113 | + |
3 | 114 | ## [0.1.0] - 2025-11-15 |
4 | 115 |
|
| 116 | +### 🎉 Initial Release |
| 117 | + |
5 | 118 | ### Added |
6 | 119 | - **MCP Protocol Implementation**: Full JSON-RPC 2.0 support for Model Context Protocol |
7 | 120 | - **Multi-Transport Support**: HTTP and stdio transport layers for MCP servers |
|
68 | 181 | - Go-based implementation for performance and portability |
69 | 182 | - Makefile with comprehensive build targets |
70 | 183 | - Automated dependency management |
71 | | -- Development environment setup scripts |
72 | | - |
| 184 | +- Development environment setup scripts |
0 commit comments