claude-flow 2.0.0-alpha.64 → 2.0.0-alpha.66

package/CHANGELOG.md

@@ -5,6 +5,46 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0-alpha.66] - 2025-01-20
+
+### 🔧 Bug Fixes
+- **Hooks Command**: Fixed "command.toLowerCase is not a function" error in hooks pre-command
+- **ARM64 Support**: Improved ARM64 compatibility for better-sqlite3 on macOS (#378)
+- Added type checking for command parameter in hooks to handle empty/missing values
+- Enhanced postinstall script with ARM64 detection and automatic rebuild
+
+### 🚀 New Features
+- Automatic SQLite binding verification and rebuild for Apple Silicon Macs
+- Graceful fallback to in-memory storage if SQLite bindings fail
+- Better error handling and user feedback during installation
+
+### 🏗️ Infrastructure
+- Added `node20-macos-arm64` target to pkg configuration
+- Improved boolean parameter parsing in hooks commands
+- Enhanced platform detection for ARM64 architecture
+
+### 📚 Documentation
+- Added ARM64 troubleshooting guide
+- Updated hooks command usage examples
+
+## [2.0.0-alpha.65] - 2025-01-20
+
+### 🔧 Bug Fixes
+- **CRITICAL**: Fixed "table agents has no column named role" error in hive-mind wizard (#403)
+- Added missing `role` column to agents table schema in init/index.js
+- Fixed TypeScript build errors preventing compilation
+- Resolved ILogger interface issues and async/await problems
+- Fixed missing type definitions in multiple modules
+
+### 🏗️ Infrastructure
+- **Database Schema**: Synchronized agents table schema across all modules
+- **Build System**: Fixed critical TypeScript compilation errors
+- **Type Safety**: Added proper type annotations throughout codebase
+
+### 📚 Documentation
+- Added migration instructions for existing databases
+- Updated test suite with schema validation tests
+
 ## [2.0.0-alpha.64] - 2025-01-18
 
 ### 🔧 Bug Fixes

package/bin/claude-flow

@@ -1,7 +1,7 @@
 #!/bin/sh
 # Claude-Flow Smart Dispatcher - Detects and uses the best available runtime
 
-VERSION="2.0.0-alpha.64"
+VERSION="2.0.0-alpha.66"
 
 # Determine the correct path based on how the script is invoked
 if [ -L "$0" ]; then

package/dist/api/claude-api-errors.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Claude API specific error types with enhanced error handling
+ */
+import { ClaudeFlowError } from '../utils/errors.js';
+/**
+ * Base error class for Claude API errors
+ */
+export declare class ClaudeAPIError extends ClaudeFlowError {
+    readonly statusCode?: number | undefined;
+    readonly retryable: boolean;
+    constructor(message: string, statusCode?: number | undefined, retryable?: boolean, details?: unknown);
+}
+/**
+ * Error for 500 Internal Server Error
+ */
+export declare class ClaudeInternalServerError extends ClaudeAPIError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error for 503 Service Unavailable
+ */
+export declare class ClaudeServiceUnavailableError extends ClaudeAPIError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error for 429 Too Many Requests (Rate Limit)
+ */
+export declare class ClaudeRateLimitError extends ClaudeAPIError {
+    readonly retryAfter?: number | undefined;
+    constructor(message: string, retryAfter?: number | undefined, details?: unknown);
+}
+/**
+ * Error for network timeouts
+ */
+export declare class ClaudeTimeoutError extends ClaudeAPIError {
+    readonly timeout: number;
+    constructor(message: string, timeout: number, details?: unknown);
+}
+/**
+ * Error for network-related issues
+ */
+export declare class ClaudeNetworkError extends ClaudeAPIError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error for authentication issues
+ */
+export declare class ClaudeAuthenticationError extends ClaudeAPIError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error for invalid requests
+ */
+export declare class ClaudeValidationError extends ClaudeAPIError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    latency?: number;
+    error?: string;
+    timestamp: Date;
+}
+/**
+ * User-friendly error messages and fallback suggestions
+ */
+export declare const ERROR_MESSAGES: {
+    INTERNAL_SERVER_ERROR: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    SERVICE_UNAVAILABLE: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    RATE_LIMIT: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    TIMEOUT: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    NETWORK_ERROR: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    AUTHENTICATION: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+    VALIDATION: {
+        title: string;
+        message: string;
+        suggestions: string[];
+    };
+};
+/**
+ * Get user-friendly error information
+ */
+export declare function getUserFriendlyError(error: ClaudeAPIError): {
+    title: string;
+    message: string;
+    suggestions: string[];
+    retryable: boolean;
+};
+//# sourceMappingURL=claude-api-errors.d.ts.map

package/dist/api/claude-api-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api-errors.d.ts","sourceRoot":"","sources":["../../src/api/claude-api-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,qBAAa,cAAe,SAAQ,eAAe;aAG/B,UAAU,CAAC,EAAE,MAAM;aACnB,SAAS,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,GAAE,OAAe,EAC1C,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,cAAc;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAS/C;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,cAAc;gBACnD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAS/C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;aAGpC,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,OAAO;CAUpB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;aACP,OAAO,EAAE,MAAM;gBAAhD,OAAO,EAAE,MAAM,EAAkB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAShF;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAS/C;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,cAAc;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAS/C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAS/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuE1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAuBA"}

package/dist/api/claude-api-errors.js

@@ -0,0 +1,198 @@
+/**
+ * Claude API specific error types with enhanced error handling
+ */
+import { ClaudeFlowError } from '../utils/errors.js';
+/**
+ * Base error class for Claude API errors
+ */
+export class ClaudeAPIError extends ClaudeFlowError {
+    statusCode;
+    retryable;
+    constructor(message, statusCode, retryable = false, details) {
+        super(message, 'CLAUDE_API_ERROR', details);
+        this.statusCode = statusCode;
+        this.retryable = retryable;
+        this.name = 'ClaudeAPIError';
+    }
+}
+/**
+ * Error for 500 Internal Server Error
+ */
+export class ClaudeInternalServerError extends ClaudeAPIError {
+    constructor(message, details) {
+        super(message || 'Claude API internal server error. The service may be temporarily unavailable.', 500, true, // Retryable
+        details);
+        this.name = 'ClaudeInternalServerError';
+    }
+}
+/**
+ * Error for 503 Service Unavailable
+ */
+export class ClaudeServiceUnavailableError extends ClaudeAPIError {
+    constructor(message, details) {
+        super(message || 'Claude API service is temporarily unavailable. Please try again later.', 503, true, // Retryable
+        details);
+        this.name = 'ClaudeServiceUnavailableError';
+    }
+}
+/**
+ * Error for 429 Too Many Requests (Rate Limit)
+ */
+export class ClaudeRateLimitError extends ClaudeAPIError {
+    retryAfter;
+    constructor(message, retryAfter, details) {
+        super(message || 'Rate limit exceeded. Please wait before making more requests.', 429, true, // Retryable
+        details);
+        this.retryAfter = retryAfter;
+        this.name = 'ClaudeRateLimitError';
+    }
+}
+/**
+ * Error for network timeouts
+ */
+export class ClaudeTimeoutError extends ClaudeAPIError {
+    timeout;
+    constructor(message, timeout, details) {
+        super(message || `Request timed out after ${timeout}ms. The API may be slow or unreachable.`, undefined, true, // Retryable
+        details);
+        this.timeout = timeout;
+        this.name = 'ClaudeTimeoutError';
+    }
+}
+/**
+ * Error for network-related issues
+ */
+export class ClaudeNetworkError extends ClaudeAPIError {
+    constructor(message, details) {
+        super(message || 'Network error occurred. Please check your internet connection.', undefined, true, // Retryable
+        details);
+        this.name = 'ClaudeNetworkError';
+    }
+}
+/**
+ * Error for authentication issues
+ */
+export class ClaudeAuthenticationError extends ClaudeAPIError {
+    constructor(message, details) {
+        super(message || 'Authentication failed. Please check your API key.', 401, false, // Not retryable
+        details);
+        this.name = 'ClaudeAuthenticationError';
+    }
+}
+/**
+ * Error for invalid requests
+ */
+export class ClaudeValidationError extends ClaudeAPIError {
+    constructor(message, details) {
+        super(message || 'Invalid request. Please check your parameters.', 400, false, // Not retryable
+        details);
+        this.name = 'ClaudeValidationError';
+    }
+}
+/**
+ * User-friendly error messages and fallback suggestions
+ */
+export const ERROR_MESSAGES = {
+    INTERNAL_SERVER_ERROR: {
+        title: 'Claude API Service Error',
+        message: 'The Claude API is experiencing technical difficulties.',
+        suggestions: [
+            'Wait a few minutes and try again',
+            'Check the Anthropic status page for service updates',
+            'Consider using a fallback AI service if available',
+            'Cache previous responses for offline usage',
+        ],
+    },
+    SERVICE_UNAVAILABLE: {
+        title: 'Service Temporarily Unavailable',
+        message: 'Claude API is temporarily unavailable or undergoing maintenance.',
+        suggestions: [
+            'Try again in 5-10 minutes',
+            'Check if there\'s scheduled maintenance',
+            'Use cached responses if available',
+            'Consider implementing a queue for requests',
+        ],
+    },
+    RATE_LIMIT: {
+        title: 'Rate Limit Exceeded',
+        message: 'You\'ve made too many requests to the Claude API.',
+        suggestions: [
+            'Implement request throttling',
+            'Batch multiple requests together',
+            'Consider upgrading your API plan',
+            'Use exponential backoff for retries',
+        ],
+    },
+    TIMEOUT: {
+        title: 'Request Timeout',
+        message: 'The request took too long to complete.',
+        suggestions: [
+            'Check your internet connection',
+            'Try a simpler request',
+            'Increase the timeout duration',
+            'Break large requests into smaller ones',
+        ],
+    },
+    NETWORK_ERROR: {
+        title: 'Network Connection Error',
+        message: 'Unable to connect to the Claude API.',
+        suggestions: [
+            'Check your internet connection',
+            'Verify firewall/proxy settings',
+            'Try using a different network',
+            'Check if the API endpoint is correct',
+        ],
+    },
+    AUTHENTICATION: {
+        title: 'Authentication Failed',
+        message: 'Unable to authenticate with the Claude API.',
+        suggestions: [
+            'Verify your API key is correct',
+            'Check if your API key has expired',
+            'Ensure the API key has proper permissions',
+            'Generate a new API key if needed',
+        ],
+    },
+    VALIDATION: {
+        title: 'Invalid Request',
+        message: 'The request contains invalid parameters.',
+        suggestions: [
+            'Check the request parameters',
+            'Verify the model name is correct',
+            'Ensure message format is valid',
+            'Review the API documentation',
+        ],
+    },
+};
+/**
+ * Get user-friendly error information
+ */
+export function getUserFriendlyError(error) {
+    let errorInfo = ERROR_MESSAGES.INTERNAL_SERVER_ERROR; // Default
+    if (error instanceof ClaudeInternalServerError) {
+        errorInfo = ERROR_MESSAGES.INTERNAL_SERVER_ERROR;
+    }
+    else if (error instanceof ClaudeServiceUnavailableError) {
+        errorInfo = ERROR_MESSAGES.SERVICE_UNAVAILABLE;
+    }
+    else if (error instanceof ClaudeRateLimitError) {
+        errorInfo = ERROR_MESSAGES.RATE_LIMIT;
+    }
+    else if (error instanceof ClaudeTimeoutError) {
+        errorInfo = ERROR_MESSAGES.TIMEOUT;
+    }
+    else if (error instanceof ClaudeNetworkError) {
+        errorInfo = ERROR_MESSAGES.NETWORK_ERROR;
+    }
+    else if (error instanceof ClaudeAuthenticationError) {
+        errorInfo = ERROR_MESSAGES.AUTHENTICATION;
+    }
+    else if (error instanceof ClaudeValidationError) {
+        errorInfo = ERROR_MESSAGES.VALIDATION;
+    }
+    return {
+        ...errorInfo,
+        retryable: error.retryable,
+    };
+}
+//# sourceMappingURL=claude-api-errors.js.map

package/dist/api/claude-api-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api-errors.js","sourceRoot":"","sources":["../../src/api/claude-api-errors.ts"],"names":[],"mappings":"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"}

package/dist/api/claude-client-enhanced.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Enhanced Claude API client with comprehensive error handling
+ * Implements exponential backoff, health checks, and improved error messages
+ */
+import { EventEmitter } from 'events';
+import { ILogger } from '../core/logger.js';
+import { ConfigManager } from '../config/config-manager.js';
+import { HealthCheckResult } from './claude-api-errors.js';
+import { ClaudeAPIConfig, ClaudeModel, ClaudeMessage, ClaudeResponse, ClaudeStreamEvent } from './claude-client.js';
+export interface EnhancedClaudeAPIConfig extends ClaudeAPIConfig {
+    enableHealthCheck?: boolean;
+    healthCheckInterval?: number;
+    circuitBreakerThreshold?: number;
+    circuitBreakerTimeout?: number;
+    circuitBreakerResetTimeout?: number;
+    maxRetries?: number;
+    retryBaseDelay?: number;
+    retryMaxDelay?: number;
+    retryJitter?: boolean;
+}
+export declare class EnhancedClaudeAPIClient extends EventEmitter {
+    private config;
+    private logger;
+    private configManager;
+    private circuitBreaker;
+    private lastHealthCheck?;
+    private healthCheckTimer?;
+    constructor(logger: ILogger, configManager: ConfigManager, config?: Partial<EnhancedClaudeAPIConfig>);
+    /**
+     * Load configuration with enhanced defaults
+     */
+    private loadConfiguration;
+    /**
+     * Validate configuration
+     */
+    private validateConfiguration;
+    /**
+     * Start periodic health checks
+     */
+    private startHealthCheck;
+    /**
+     * Perform a health check on the API
+     */
+    performHealthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Get last health check result
+     */
+    getHealthStatus(): HealthCheckResult | undefined;
+    /**
+     * Send a message with enhanced error handling
+     */
+    sendMessage(messages: ClaudeMessage[], options?: {
+        model?: ClaudeModel;
+        temperature?: number;
+        maxTokens?: number;
+        systemPrompt?: string;
+        stream?: boolean;
+    }): Promise<ClaudeResponse | AsyncIterable<ClaudeStreamEvent>>;
+    /**
+     * Send request with retry logic and enhanced error handling
+     */
+    private sendRequestWithRetry;
+    /**
+     * Send a single request
+     */
+    private sendRequestOnce;
+    /**
+     * Stream request with retry logic
+     */
+    private streamRequestWithRetry;
+    /**
+     * Send a single streaming request
+     */
+    private streamRequestOnce;
+    /**
+     * Create appropriate error based on status code
+     */
+    private createAPIError;
+    /**
+     * Transform generic errors to Claude API errors
+     */
+    private transformError;
+    /**
+     * Calculate retry delay with exponential backoff and jitter
+     */
+    private calculateRetryDelay;
+    /**
+     * Handle errors with user-friendly messages and logging
+     */
+    private handleError;
+    /**
+     * Helper method for simple completions with error handling
+     */
+    complete(prompt: string, options?: {
+        model?: ClaudeModel;
+        temperature?: number;
+        maxTokens?: number;
+        systemPrompt?: string;
+    }): Promise<string>;
+    /**
+     * Delay helper
+     */
+    private delay;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=claude-client-enhanced.d.ts.map

package/dist/api/claude-client-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-client-enhanced.d.ts","sourceRoot":"","sources":["../../src/api/claude-client-enhanced.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EASL,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EAEb,cAAc,EACd,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAAiB;gBAE9B,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAmBpG;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6CzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAwDtD;;OAEG;IACH,eAAe,IAAI,iBAAiB,GAAG,SAAS;IAIhD;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GACA,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IA4C7D;;OAEG;YACW,oBAAoB;IAsClC;;OAEG;YACW,eAAe;IA0D7B;;OAEG;YACY,sBAAsB;IAgCrC;;OAEG;YACY,iBAAiB;IAiEhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,MAAM,CAAC;IAclB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}