claude-flow 2.0.0-alpha.60 → 2.0.0-alpha.62

package/src/types/mcp.d.ts

@@ -1,4 +1,3 @@
-import { getErrorMessage } from '../utils/error-handler.js';
 // Type definitions for Model Context Protocol SDK
 declare module '@modelcontextprotocol/sdk/types.js' {
   export interface Tool {
@@ -33,14 +32,16 @@ declare module '@modelcontextprotocol/sdk/types.js' {
 }
 
 declare module '@modelcontextprotocol/sdk/server/index.js' {
-  import { Tool, CallToolRequest, CallToolResult, ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
-  
+  import {
+    Tool,
+    CallToolRequest,
+    CallToolResult,
+    ListToolsResult,
+  } from '@modelcontextprotocol/sdk/types.js';
+
   export class Server {
     constructor();
-    setRequestHandler<T>(
-      method: string,
-      handler: (request: T) => Promise<any>
-    ): void;
+    setRequestHandler<T>(method: string, handler: (request: T) => Promise<any>): void;
     connect(transport: any): Promise<void>;
     close(): Promise<void>;
   }
@@ -54,10 +55,7 @@ declare module '@modelcontextprotocol/sdk/server/stdio.js' {
 
 declare module '@modelcontextprotocol/sdk/client/index.js' {
   export class Client {
-    constructor(config: {
-      name: string;
-      version: string;
-    });
+    constructor(config: { name: string; version: string });
     connect(transport: any): Promise<void>;
     request(method: string, params?: any): Promise<any>;
     close(): Promise<void>;
@@ -66,10 +64,6 @@ declare module '@modelcontextprotocol/sdk/client/index.js' {
 
 declare module '@modelcontextprotocol/sdk/client/stdio.js' {
   export class StdioClientTransport {
-    constructor(config: {
-      command: string;
-      args?: string[];
-      env?: Record<string, string>;
-    });
+    constructor(config: { command: string; args?: string[]; env?: Record<string, string> });
   }
-}
+}

package/src/types/vscode.d.ts

@@ -51,10 +51,23 @@ declare module 'vscode' {
   export namespace window {
     export function createOutputChannel(name: string): OutputChannel;
     export function createTerminal(options: TerminalOptions): Terminal;
-    export function createTerminal(name: string, shellPath?: string, shellArgs?: string[]): Terminal;
-    export function showErrorMessage(message: string, ...items: string[]): Thenable<string | undefined>;
-    export function showInformationMessage(message: string, ...items: string[]): Thenable<string | undefined>;
-    export function showWarningMessage(message: string, ...items: string[]): Thenable<string | undefined>;
+    export function createTerminal(
+      name: string,
+      shellPath?: string,
+      shellArgs?: string[],
+    ): Terminal;
+    export function showErrorMessage(
+      message: string,
+      ...items: string[]
+    ): Thenable<string | undefined>;
+    export function showInformationMessage(
+      message: string,
+      ...items: string[]
+    ): Thenable<string | undefined>;
+    export function showWarningMessage(
+      message: string,
+      ...items: string[]
+    ): Thenable<string | undefined>;
     export const onDidCloseTerminal: Event<Terminal>;
     export function registerTerminalProfileProvider(id: string, provider: any): any;
   }
@@ -80,4 +93,4 @@ declare module 'vscode' {
     readonly fsPath: string;
     toString(): string;
   }
-}
+}

package/src/ui/console/README-analysis-tools.md

@@ -9,66 +9,79 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🛠️ Implemented Tools
 
 ### 1. Performance Report (`performance_report`)
+
 - **Purpose**: Generate comprehensive performance metrics and reports
 - **Features**: Response time tracking, throughput analysis, error rate monitoring
 - **API Endpoint**: `/api/analysis/performance-report`
 
 ### 2. Bottleneck Analysis (`bottleneck_analyze`)
+
 - **Purpose**: Detect and analyze system bottlenecks
 - **Features**: Component analysis, severity assessment, impact evaluation
 - **API Endpoint**: `/api/analysis/bottleneck-analyze`
 
 ### 3. Token Usage (`token_usage`)
+
 - **Purpose**: Track and analyze token consumption patterns
 - **Features**: Cost analysis, efficiency metrics, usage trends
 - **API Endpoint**: `/api/analysis/token-usage`
 
 ### 4. Benchmark Run (`benchmark_run`)
+
 - **Purpose**: Execute performance benchmarks and comparisons
 - **Features**: Multi-metric benchmarking, baseline comparisons, scoring
 - **API Endpoint**: `/api/analysis/benchmark-run`
 
 ### 5. Metrics Collection (`metrics_collect`)
+
 - **Purpose**: Collect comprehensive system metrics
 - **Features**: System info, resource usage, performance indicators
 - **API Endpoint**: `/api/analysis/metrics-collect`
 
 ### 6. Trend Analysis (`trend_analysis`)
+
 - **Purpose**: Detect trends and forecast future patterns
 - **Features**: Performance trends, usage patterns, predictions
 - **API Endpoint**: `/api/analysis/trend-analysis`
 
 ### 7. Cost Analysis (`cost_analysis`)
+
 - **Purpose**: Analyze resource costs and optimization opportunities
 - **Features**: Cost breakdown, trend analysis, optimization recommendations
 - **API Endpoint**: `/api/analysis/cost-analysis`
 
 ### 8. Quality Assessment (`quality_assess`)
+
 - **Purpose**: Assess system quality across multiple dimensions
 - **Features**: Performance, reliability, security, maintainability metrics
 - **API Endpoint**: `/api/analysis/quality-assess`
 
 ### 9. Error Analysis (`error_analysis`)
+
 - **Purpose**: Analyze error patterns and provide resolution guidance
 - **Features**: Error categorization, pattern identification, resolution recommendations
 - **API Endpoint**: `/api/analysis/error-analysis`
 
 ### 10. Usage Statistics (`usage_stats`)
+
 - **Purpose**: Generate comprehensive usage statistics and insights
 - **Features**: User analytics, session analysis, feature usage tracking
 - **API Endpoint**: `/api/analysis/usage-stats`
 
 ### 11. Health Check (`health_check`)
+
 - **Purpose**: Monitor system health across all components
 - **Features**: Component health scoring, alert generation, status monitoring
 - **API Endpoint**: `/api/analysis/health-check`
 
 ### 12. Load Monitor (`load_monitor`)
+
 - **Purpose**: Monitor system load and generate alerts
 - **Features**: Real-time load tracking, trend analysis, alert generation
 - **API Endpoint**: `/api/analysis/load-monitor`
 
 ### 13. Capacity Planning (`capacity_plan`)
+
 - **Purpose**: Plan future capacity requirements
 - **Features**: Resource projections, timeline planning, scaling recommendations
 - **API Endpoint**: `/api/analysis/capacity-plan`
@@ -76,18 +89,21 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 📊 Dashboard Features
 
 ### 4-Tab Interface
+
 1. **Metrics**: Real-time performance and token usage metrics
 2. **Reports**: Report generation and export functionality
 3. **Analysis**: Advanced analysis tools and visualizations
 4. **Health**: System health monitoring and alerts
 
 ### Interactive Charts
+
 - **Performance Chart**: Line chart showing response time and throughput trends
 - **Token Usage Chart**: Doughnut chart displaying token distribution
 - **System Health Chart**: Radar chart showing component health scores
 - **Load Monitor Chart**: Bar chart tracking system load over time
 
 ### Real-time Features
+
 - **WebSocket Integration**: Live data updates every 5 seconds
 - **Connection Status**: Visual indicator of WebSocket connection state
 - **Auto-refresh**: Automatic data refresh with manual refresh options
@@ -96,16 +112,19 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🔧 Technical Implementation
 
 ### Frontend Components
+
 - **JavaScript**: `/src/ui/console/js/analysis-tools.js`
 - **CSS**: `/src/ui/console/styles/analysis-tools.css`
 - **HTML**: `/src/ui/console/analysis-tools.html`
 
 ### Backend API
+
 - **Router**: `/src/api/routes/analysis.js`
 - **WebSocket**: Real-time data streaming
 - **Metrics Storage**: In-memory storage with database integration ready
 
 ### Key Features
+
 - **Responsive Design**: Mobile-friendly interface
 - **Export Functionality**: JSON and CSV export options
 - **Dark Mode Support**: Automatic dark theme detection
@@ -115,12 +134,14 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🚀 Getting Started
 
 ### Prerequisites
+
 - Node.js 16+
 - Express.js server
 - Chart.js library
 - WebSocket support
 
 ### Installation
+
 1. Copy the files to your Claude Flow project
 2. Install dependencies:
    ```bash
@@ -128,7 +149,9 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
    ```
 
 ### Integration
+
 1. Add the analysis router to your Express app:
+
    ```javascript
    const analysisRouter = require('./src/api/routes/analysis');
    app.use('/api/analysis', analysisRouter);
@@ -136,12 +159,13 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 
 2. Include the CSS and JavaScript files in your HTML:
    ```html
-   <link rel="stylesheet" href="styles/analysis-tools.css">
+   <link rel="stylesheet" href="styles/analysis-tools.css" />
    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
    <script src="js/analysis-tools.js"></script>
    ```
 
 ### Usage
+
 1. Navigate to `/analysis-tools.html` in your browser
 2. Use the tab navigation to switch between different views
 3. Click tool buttons to execute analysis functions
@@ -151,12 +175,14 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 📈 Data Flow
 
 ### Real-time Metrics
+
 1. **Collection**: Server collects metrics from various sources
 2. **Processing**: Metrics are processed and stored in memory
 3. **Broadcasting**: WebSocket broadcasts updates to connected clients
 4. **Visualization**: Charts update automatically with new data
 
 ### Tool Execution
+
 1. **Request**: User clicks tool button in UI
 2. **API Call**: Frontend makes HTTP request to analysis API
 3. **Processing**: Backend processes request and generates results
@@ -166,17 +192,20 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🔍 Monitoring & Alerts
 
 ### Health Monitoring
+
 - **Component Health**: CPU, Memory, Disk, Network, API, Database
 - **Health Scores**: 0-100 scale with color-coded indicators
 - **Alert Thresholds**: Configurable warning and critical levels
 
 ### Performance Monitoring
+
 - **Response Time**: Average, min, max response times
 - **Throughput**: Requests per second/minute
 - **Error Rate**: Percentage of failed requests
 - **Uptime**: System availability metrics
 
 ### Alert System
+
 - **Real-time Alerts**: Immediate notification of issues
 - **Severity Levels**: Info, Warning, Critical
 - **Auto-dismiss**: Configurable auto-dismiss for info alerts
@@ -185,10 +214,12 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 📊 Export & Reporting
 
 ### Export Formats
+
 - **JSON**: Complete data export with metadata
 - **CSV**: Tabular data export for spreadsheet analysis
 
 ### Report Types
+
 - **Performance Reports**: Comprehensive performance analysis
 - **Cost Reports**: Resource cost breakdown and optimization
 - **Quality Reports**: System quality assessment
@@ -197,16 +228,19 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🎨 Customization
 
 ### Styling
+
 - Modify `analysis-tools.css` for custom styling
 - Responsive breakpoints for different screen sizes
 - Dark mode support with CSS media queries
 
 ### Configuration
+
 - Adjust WebSocket update intervals
 - Configure alert thresholds
 - Customize chart colors and types
 
 ### Extension
+
 - Add new analysis tools following the existing pattern
 - Implement additional chart types using Chart.js
 - Extend API endpoints for custom metrics
@@ -214,11 +248,13 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🔒 Security Considerations
 
 ### Data Protection
+
 - Client-side data validation
 - Secure WebSocket connections (WSS in production)
 - API rate limiting implementation ready
 
 ### Error Handling
+
 - Graceful error handling for failed requests
 - User-friendly error messages
 - Automatic retry mechanisms
@@ -226,11 +262,13 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🚀 Performance Optimization
 
 ### Frontend Optimization
+
 - Lazy loading of chart components
 - Efficient data update strategies
 - Memory management for long-running sessions
 
 ### Backend Optimization
+
 - Efficient metrics collection
 - Optimized database queries (when integrated)
 - Caching strategies for frequently accessed data
@@ -238,11 +276,13 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 📱 Responsive Design
 
 ### Mobile Support
+
 - Touch-friendly interface
 - Responsive chart sizing
 - Optimized navigation for small screens
 
 ### Tablet Support
+
 - Optimized layout for tablet devices
 - Touch gestures for chart interaction
 - Efficient space utilization
@@ -250,12 +290,14 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 🔧 Development & Testing
 
 ### Development Setup
+
 1. Start the development server
 2. Open `analysis-tools.html` in browser
 3. Monitor console for WebSocket connection status
 4. Test all tool functions and exports
 
 ### Testing Checklist
+
 - [ ] All 13 tools execute without errors
 - [ ] WebSocket connection establishes successfully
 - [ ] Real-time updates work correctly
@@ -267,11 +309,13 @@ This implementation provides a comprehensive suite of 13 analysis and monitoring
 ## 📚 API Documentation
 
 ### Endpoint Structure
+
 ```
 GET /api/analysis/{tool-name}
 ```
 
 ### Response Format
+
 ```json
 {
   "timestamp": 1234567890,
@@ -283,6 +327,7 @@ GET /api/analysis/{tool-name}
 ```
 
 ### WebSocket Messages
+
 ```json
 {
   "type": "metrics_update",
@@ -298,6 +343,7 @@ GET /api/analysis/{tool-name}
 ## 🤝 Contributing
 
 ### Adding New Tools
+
 1. Add tool button to HTML interface
 2. Implement tool logic in JavaScript
 3. Create API endpoint in backend router
@@ -305,6 +351,7 @@ GET /api/analysis/{tool-name}
 5. Update documentation
 
 ### Code Style
+
 - Follow existing naming conventions
 - Use ES6+ features where appropriate
 - Maintain consistent error handling
@@ -313,6 +360,7 @@ GET /api/analysis/{tool-name}
 ## 📞 Support
 
 For issues or questions regarding the Analysis & Monitoring Tools:
+
 1. Check the console for error messages
 2. Verify WebSocket connection status
 3. Ensure all dependencies are installed
@@ -321,6 +369,7 @@ For issues or questions regarding the Analysis & Monitoring Tools:
 ## 🔄 Future Enhancements
 
 ### Planned Features
+
 - Database integration for persistent metrics
 - Advanced filtering and search capabilities
 - Custom dashboard creation
@@ -328,6 +377,7 @@ For issues or questions regarding the Analysis & Monitoring Tools:
 - Advanced analytics and ML insights
 
 ### Integration Opportunities
+
 - External monitoring tools
 - Third-party alert systems
 - Business intelligence platforms
@@ -336,4 +386,4 @@ For issues or questions regarding the Analysis & Monitoring Tools:
 ---
 
 **Agent 2 - Analysis & Monitoring Tools Developer**  
-*Complete implementation of 13 analysis and monitoring tools with real-time dashboards and WebSocket integration*
+_Complete implementation of 13 analysis and monitoring tools with real-time dashboards and WebSocket integration_

package/src/ui/console/README.md

@@ -5,6 +5,7 @@ A modern web-based terminal interface for Claude Code, providing an authentic co
 ## Features
 
 ### Terminal Emulation
+
 - **Authentic Terminal Experience**: Console-style dark theme with monospace fonts
 - **Real-time Output**: Live streaming of command output with proper formatting
 - **Command History**: Navigate through previous commands with arrow keys
@@ -12,6 +13,7 @@ A modern web-based terminal interface for Claude Code, providing an authentic co
 - **ANSI Color Support**: Processes ANSI escape codes for colored output
 
 ### WebSocket Communication
+
 - **Real-time Bidirectional Communication**: Connects to Claude Code MCP server via WebSocket
 - **Auto-reconnection**: Automatic reconnection with exponential backoff
 - **Message Queuing**: Queues messages when disconnected and sends when reconnected
@@ -19,6 +21,7 @@ A modern web-based terminal interface for Claude Code, providing an authentic co
 - **Session Management**: Handles MCP protocol initialization and session state
 
 ### Settings Management
+
 - **Connection Settings**: Server URL, authentication tokens, auto-connect
 - **Appearance Customization**: Multiple themes (dark, light, classic, matrix), font size, line height
 - **Behavior Options**: Auto-scroll, timestamps, sound notifications, history limits
@@ -26,6 +29,7 @@ A modern web-based terminal interface for Claude Code, providing an authentic co
 - **Persistent Storage**: Settings saved to localStorage with import/export capabilities
 
 ### Claude Flow Integration
+
 - **Built-in Commands**: Support for all major Claude Flow commands
 - **SPARC Mode Support**: Integration with all 17 specialized SPARC modes
 - **Swarm Management**: Web interface for swarm coordination and monitoring
@@ -34,6 +38,7 @@ A modern web-based terminal interface for Claude Code, providing an authentic co
 ## Architecture
 
 ### Component Structure
+
 ```
 src/ui/console/
 ├── index.html              # Main HTML structure
@@ -50,6 +55,7 @@ src/ui/console/
 ```
 
 ### Integration Points
+
 - **HTTP Transport**: Web console served at `/console` endpoint
 - **WebSocket Endpoint**: Real-time communication via `/ws` endpoint
 - **MCP Protocol**: Full JSON-RPC 2.0 compliant communication
@@ -58,12 +64,15 @@ src/ui/console/
 ## Usage
 
 ### Starting the Web Console
+
 1. Start Claude Code with HTTP transport enabled:
+
    ```bash
    claude-flow start --transport http --port 3000
    ```
 
 2. Open web browser and navigate to:
+
    ```
    http://localhost:3000/console
    ```
@@ -71,6 +80,7 @@ src/ui/console/
 3. The console will automatically attempt to connect to the WebSocket endpoint
 
 ### Basic Commands
+
 - `help` - Show all available commands
 - `connect [url] [token]` - Connect to Claude Code server
 - `status` - Show connection and system status
@@ -80,6 +90,7 @@ src/ui/console/
 - `tools` - List available tools
 
 ### Keyboard Shortcuts
+
 - **Enter** - Execute command
 - **Tab** - Autocomplete command
 - **↑/↓** - Navigate command history
@@ -88,7 +99,9 @@ src/ui/console/
 - **ESC** - Close settings panel
 
 ### Settings Panel
+
 Access via the ⚙️ Settings button to configure:
+
 - Server connection details
 - Visual appearance and themes
 - Console behavior preferences
@@ -97,13 +110,16 @@ Access via the ⚙️ Settings button to configure:
 ## Themes
 
 ### Available Themes
+
 1. **Dark** (default) - Modern dark theme with blue accents
 2. **Light** - Clean light theme for bright environments
 3. **Classic** - Traditional green-on-black terminal
 4. **Matrix** - Matrix-inspired green glow effect
 
 ### Custom Styling
+
 The console uses CSS custom properties for easy theming:
+
 ```css
 :root {
   --bg-primary: #0d1117;
@@ -116,12 +132,14 @@ The console uses CSS custom properties for easy theming:
 ## Mobile Support
 
 ### Responsive Design
+
 - **Tablet Landscape**: Optimized layout with condensed controls
 - **Tablet Portrait**: Settings panel adapts to smaller screens
 - **Mobile Landscape**: Minimized header and status bar
 - **Mobile Portrait**: Full-screen overlay for settings, touch-optimized controls
 
 ### Touch Interactions
+
 - Minimum 44px touch targets for accessibility
 - 16px font size on inputs to prevent iOS zoom
 - Gesture-friendly scrolling and selection
@@ -130,6 +148,7 @@ The console uses CSS custom properties for easy theming:
 ## Accessibility
 
 ### Features
+
 - **Semantic HTML**: Proper ARIA labels and roles
 - **Keyboard Navigation**: Full keyboard accessibility
 - **Screen Reader Support**: Live regions for output updates
@@ -140,12 +159,14 @@ The console uses CSS custom properties for easy theming:
 ## Browser Compatibility
 
 ### Supported Browsers
+
 - **Chrome/Chromium** 88+
 - **Firefox** 85+
 - **Safari** 14+
 - **Edge** 88+
 
 ### Required Features
+
 - ES2020 modules
 - WebSocket API
 - CSS Custom Properties
@@ -155,12 +176,15 @@ The console uses CSS custom properties for easy theming:
 ## Development
 
 ### Local Development
+
 1. Ensure Claude Code backend is running with HTTP transport
 2. Open `src/ui/console/index.html` in a web browser
 3. Modify settings to point to your local server URL
 
 ### Building for Production
+
 The console is designed to be served as static files:
+
 ```bash
 # Copy console files to web server
 cp -r src/ui/console/* /var/www/claude-console/
@@ -170,6 +194,7 @@ app.use('/console', express.static('src/ui/console'));
 ```
 
 ### Customization
+
 - Modify CSS custom properties for theming
 - Extend command handlers for new functionality
 - Add new WebSocket message handlers for custom notifications
@@ -178,12 +203,14 @@ app.use('/console', express.static('src/ui/console'));
 ## Security Considerations
 
 ### Authentication
+
 - Bearer token authentication support
 - Secure WebSocket connections (WSS) in production
 - CORS configuration for cross-origin requests
 - Input validation and sanitization
 
 ### Best Practices
+
 - Use HTTPS in production environments
 - Configure proper CORS origins
 - Implement rate limiting for WebSocket connections
@@ -192,12 +219,14 @@ app.use('/console', express.static('src/ui/console'));
 ## Performance
 
 ### Optimizations
+
 - **Message Queuing**: Efficient handling of high-frequency messages
 - **Output Limiting**: Configurable maximum lines to prevent memory issues
 - **Lazy Loading**: Components loaded only when needed
 - **Debounced Updates**: Status updates batched for performance
 
 ### Memory Management
+
 - Automatic cleanup of old output lines
 - Proper event listener cleanup on disconnect
 - Garbage collection friendly object creation
@@ -206,6 +235,7 @@ app.use('/console', express.static('src/ui/console'));
 ## Troubleshooting
 
 ### Common Issues
+
 1. **Connection Failed**: Check server URL and ensure Claude Code is running with HTTP transport
 2. **WebSocket Errors**: Verify firewall settings and proxy configuration
 3. **Authentication Issues**: Check bearer token format and validity
@@ -213,7 +243,9 @@ app.use('/console', express.static('src/ui/console'));
 5. **Theme Not Loading**: Check CSS file paths and custom property support
 
 ### Debug Mode
+
 Enable debug logging in browser developer tools:
+
 ```javascript
 // Access global console instance
 window.claudeConsole.wsClient.debugMode = true;
@@ -221,4 +253,4 @@ window.claudeConsole.wsClient.debugMode = true;
 
 ## License
 
-Part of the Claude Code project. See main project LICENSE for details.
+Part of the Claude Code project. See main project LICENSE for details.