claude-flow 3.25.5 → 3.26.0

package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js

@@ -1,355 +0,0 @@
-/**
- * Maestro Plugin - Official Plugin (ADR-004)
- *
- * Implements orchestration patterns for complex multi-agent workflows.
- * Part of the official plugin collection.
- *
- * @module v3/shared/plugins/official/maestro
- */
-import { HookEvent, HookPriority } from '../../hooks/index.js';
-/**
- * Maestro Plugin Implementation
- */
-export class MaestroPlugin {
-    id = 'maestro';
-    name = 'Maestro Workflow Orchestrator';
-    version = '1.0.0';
-    description = 'Complex multi-agent workflow orchestration with adaptive strategies';
-    context;
-    config;
-    workflows = new Map();
-    activeWorkflows = 0;
-    constructor(config) {
-        this.config = {
-            enabled: true,
-            orchestrationMode: 'adaptive',
-            maxConcurrentWorkflows: 5,
-            workflowTimeout: 600000, // 10 minutes
-            autoRecovery: true,
-            checkpointInterval: 30000, // 30 seconds
-            ...config,
-        };
-    }
-    async initialize(context) {
-        this.context = context;
-        // Register hooks for workflow monitoring
-        context.hooks?.register(HookEvent.PostTaskComplete, async (ctx) => {
-            // Update workflow progress on task completion
-            for (const workflow of this.workflows.values()) {
-                if (workflow.status === 'running' && ctx.task) {
-                    this.updateWorkflowProgress(workflow, ctx.task);
-                }
-            }
-            return { success: true, continueChain: true };
-        }, HookPriority.High, { name: 'maestro-task-complete' });
-        context.hooks?.register(HookEvent.OnError, async (ctx) => {
-            // Handle workflow errors with recovery
-            if (this.config.autoRecovery && ctx.error) {
-                for (const workflow of this.workflows.values()) {
-                    if (workflow.status === 'running') {
-                        this.handleWorkflowError(workflow, ctx.error);
-                    }
-                }
-            }
-            return { success: true, continueChain: true };
-        }, HookPriority.High, { name: 'maestro-error-handler' });
-    }
-    async shutdown() {
-        // Checkpoint all running workflows
-        for (const workflow of this.workflows.values()) {
-            if (workflow.status === 'running') {
-                this.checkpointWorkflow(workflow);
-            }
-        }
-        this.workflows.clear();
-        this.context = undefined;
-    }
-    // ============================================================================
-    // Workflow Management
-    // ============================================================================
-    /**
-     * Create a new workflow
-     */
-    createWorkflow(name, description, steps) {
-        const workflow = {
-            id: `workflow-${Date.now()}`,
-            name,
-            description,
-            steps: steps.map((step, index) => ({
-                ...step,
-                id: `step-${index}`,
-                status: 'pending',
-            })),
-            status: 'created',
-            progress: 0,
-            createdAt: new Date(),
-            checkpoints: new Map(),
-        };
-        this.workflows.set(workflow.id, workflow);
-        return workflow;
-    }
-    /**
-     * Execute a workflow
-     */
-    async executeWorkflow(workflowId) {
-        const workflow = this.workflows.get(workflowId);
-        if (!workflow) {
-            throw new Error(`Workflow not found: ${workflowId}`);
-        }
-        if (this.activeWorkflows >= this.config.maxConcurrentWorkflows) {
-            throw new Error('Maximum concurrent workflows reached');
-        }
-        const startTime = Date.now();
-        workflow.status = 'running';
-        workflow.startedAt = new Date();
-        this.activeWorkflows++;
-        const errors = [];
-        const outputs = {};
-        try {
-            switch (this.config.orchestrationMode) {
-                case 'sequential':
-                    await this.executeSequential(workflow, outputs, errors);
-                    break;
-                case 'parallel':
-                    await this.executeParallel(workflow, outputs, errors);
-                    break;
-                case 'adaptive':
-                    await this.executeAdaptive(workflow, outputs, errors);
-                    break;
-            }
-            workflow.status = errors.length === 0 ? 'completed' : 'failed';
-            workflow.completedAt = new Date();
-        }
-        catch (error) {
-            workflow.status = 'failed';
-            errors.push({
-                stepId: 'workflow',
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-        finally {
-            this.activeWorkflows--;
-        }
-        return {
-            workflowId,
-            success: workflow.status === 'completed',
-            stepsCompleted: workflow.steps.filter((s) => s.status === 'completed').length,
-            stepsTotal: workflow.steps.length,
-            outputs,
-            errors,
-            duration: Date.now() - startTime,
-        };
-    }
-    /**
-     * Pause a workflow
-     */
-    pauseWorkflow(workflowId) {
-        const workflow = this.workflows.get(workflowId);
-        if (!workflow || workflow.status !== 'running')
-            return false;
-        this.checkpointWorkflow(workflow);
-        workflow.status = 'paused';
-        return true;
-    }
-    /**
-     * Resume a paused workflow
-     */
-    async resumeWorkflow(workflowId) {
-        const workflow = this.workflows.get(workflowId);
-        if (!workflow || workflow.status !== 'paused') {
-            throw new Error('Workflow cannot be resumed');
-        }
-        // Restore from checkpoint and continue
-        return this.executeWorkflow(workflowId);
-    }
-    /**
-     * Get workflow status
-     */
-    getWorkflow(workflowId) {
-        return this.workflows.get(workflowId);
-    }
-    /**
-     * List all workflows
-     */
-    listWorkflows() {
-        return Array.from(this.workflows.values());
-    }
-    // ============================================================================
-    // Execution Strategies
-    // ============================================================================
-    async executeSequential(workflow, outputs, errors) {
-        for (const step of workflow.steps) {
-            if (step.status !== 'pending')
-                continue;
-            // Check dependencies
-            const depsComplete = step.dependencies.every((depId) => {
-                const dep = workflow.steps.find((s) => s.id === depId);
-                return dep?.status === 'completed';
-            });
-            if (!depsComplete) {
-                step.status = 'skipped';
-                continue;
-            }
-            workflow.currentStep = step.id;
-            const result = await this.executeStep(step, outputs);
-            if (!result.success) {
-                errors.push({ stepId: step.id, error: result.error ?? 'Unknown error' });
-                break;
-            }
-            outputs[step.id] = result.output;
-            this.updateProgress(workflow);
-        }
-    }
-    async executeParallel(workflow, outputs, errors) {
-        const layers = this.buildExecutionLayers(workflow.steps);
-        for (const layer of layers) {
-            const results = await Promise.all(layer.map((step) => this.executeStep(step, outputs)));
-            for (let i = 0; i < results.length; i++) {
-                const result = results[i];
-                const step = layer[i];
-                if (!result.success) {
-                    errors.push({ stepId: step.id, error: result.error ?? 'Unknown error' });
-                }
-                else {
-                    outputs[step.id] = result.output;
-                }
-            }
-            this.updateProgress(workflow);
-        }
-    }
-    async executeAdaptive(workflow, outputs, errors) {
-        // Adaptive: start parallel, switch to sequential on errors
-        const completedIds = new Set();
-        const pendingSteps = [...workflow.steps];
-        let consecutiveErrors = 0;
-        const maxConsecutiveErrors = 2;
-        while (pendingSteps.length > 0) {
-            // Find steps that can run (all dependencies complete)
-            const runnableSteps = pendingSteps.filter((step) => step.dependencies.every((depId) => completedIds.has(depId)));
-            if (runnableSteps.length === 0) {
-                // No runnable steps but pending remain - circular dependency
-                for (const step of pendingSteps) {
-                    step.status = 'skipped';
-                }
-                break;
-            }
-            // Decide batch size based on error rate
-            const batchSize = consecutiveErrors >= maxConsecutiveErrors ? 1 : runnableSteps.length;
-            const batch = runnableSteps.slice(0, batchSize);
-            const results = await Promise.all(batch.map((step) => this.executeStep(step, outputs)));
-            for (let i = 0; i < results.length; i++) {
-                const result = results[i];
-                const step = batch[i];
-                const stepIndex = pendingSteps.indexOf(step);
-                if (stepIndex > -1) {
-                    pendingSteps.splice(stepIndex, 1);
-                }
-                if (!result.success) {
-                    errors.push({ stepId: step.id, error: result.error ?? 'Unknown error' });
-                    consecutiveErrors++;
-                }
-                else {
-                    outputs[step.id] = result.output;
-                    completedIds.add(step.id);
-                    consecutiveErrors = 0;
-                }
-            }
-            this.updateProgress(workflow);
-        }
-    }
-    // ============================================================================
-    // Helpers
-    // ============================================================================
-    async executeStep(step, outputs) {
-        step.status = 'running';
-        step.startedAt = new Date();
-        try {
-            // Resolve input references from previous outputs
-            const resolvedInput = this.resolveInputReferences(step.input, outputs);
-            // Execute step processing with minimal overhead
-            // Actual task execution delegated to agents via MCP integration
-            await new Promise((resolve) => setTimeout(resolve, 10));
-            step.output = { ...resolvedInput, processed: true };
-            step.status = 'completed';
-            step.completedAt = new Date();
-            return { success: true, output: step.output };
-        }
-        catch (error) {
-            step.status = 'failed';
-            step.error = error instanceof Error ? error.message : String(error);
-            step.completedAt = new Date();
-            return { success: false, error: step.error };
-        }
-    }
-    buildExecutionLayers(steps) {
-        const layers = [];
-        const completed = new Set();
-        while (completed.size < steps.length) {
-            const layer = [];
-            for (const step of steps) {
-                if (completed.has(step.id))
-                    continue;
-                const depsComplete = step.dependencies.every((depId) => completed.has(depId));
-                if (depsComplete) {
-                    layer.push(step);
-                }
-            }
-            if (layer.length === 0)
-                break; // No more runnable steps
-            layers.push(layer);
-            layer.forEach((step) => completed.add(step.id));
-        }
-        return layers;
-    }
-    resolveInputReferences(input, outputs) {
-        const resolved = {};
-        for (const [key, value] of Object.entries(input)) {
-            if (typeof value === 'string' && value.startsWith('$')) {
-                const ref = value.slice(1);
-                resolved[key] = outputs[ref];
-            }
-            else {
-                resolved[key] = value;
-            }
-        }
-        return resolved;
-    }
-    updateProgress(workflow) {
-        const completed = workflow.steps.filter((s) => s.status === 'completed').length;
-        workflow.progress = (completed / workflow.steps.length) * 100;
-    }
-    updateWorkflowProgress(workflow, taskData) {
-        // Match task to workflow step and update
-        const taskId = taskData.id;
-        const step = workflow.steps.find((s) => s.id === taskId);
-        if (step && step.status === 'running') {
-            step.status = 'completed';
-            step.output = taskData.metadata;
-            step.completedAt = new Date();
-            this.updateProgress(workflow);
-        }
-    }
-    handleWorkflowError(workflow, errorData) {
-        const stepId = errorData.context ?? '';
-        const step = workflow.steps.find((s) => s.id === stepId);
-        if (step && step.status === 'running') {
-            step.status = 'failed';
-            step.error = errorData.error?.message ?? 'Unknown error';
-            step.completedAt = new Date();
-        }
-    }
-    checkpointWorkflow(workflow) {
-        workflow.checkpoints.set(`checkpoint-${Date.now()}`, {
-            progress: workflow.progress,
-            currentStep: workflow.currentStep,
-            stepStatuses: workflow.steps.map((s) => ({ id: s.id, status: s.status })),
-        });
-    }
-}
-/**
- * Factory function
- */
-export function createMaestroPlugin(config) {
-    return new MaestroPlugin(config);
-}
-//# sourceMappingURL=maestro-plugin.js.map

package/v3/@claude-flow/shared/dist/plugins/types.d.ts

@@ -1,93 +0,0 @@
-/**
- * Plugin Types - ADR-004 Implementation
- *
- * Type definitions for the plugin system.
- *
- * @module v3/shared/plugins/types
- */
-import type { HookRegistry } from '../hooks/index.js';
-/**
- * Plugin configuration base
- */
-export interface PluginConfig {
-    enabled: boolean;
-    [key: string]: unknown;
-}
-/**
- * Plugin context provided during initialization
- */
-export interface PluginContext {
-    hooks?: HookRegistry;
-    services?: Record<string, unknown>;
-    config?: Record<string, unknown>;
-}
-/**
- * Plugin lifecycle events
- */
-export type PluginEvent = 'initialized' | 'shutdown' | 'error';
-/**
- * Plugin event handler
- */
-export type PluginEventHandler = (event: PluginEvent, data?: unknown) => void;
-/**
- * Claude Flow Plugin Interface
- *
- * All plugins must implement this interface.
- */
-export interface ClaudeFlowPlugin {
-    /** Unique plugin identifier */
-    readonly id: string;
-    /** Human-readable name */
-    readonly name: string;
-    /** Plugin version */
-    readonly version: string;
-    /** Plugin description */
-    readonly description: string;
-    /** Dependencies on other plugins */
-    readonly dependencies?: string[];
-    /**
-     * Initialize the plugin
-     * @param context Plugin context with hooks and services
-     */
-    initialize(context: PluginContext): Promise<void>;
-    /**
-     * Shutdown the plugin
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Optional event handler
-     */
-    onEvent?: PluginEventHandler;
-}
-/**
- * Plugin metadata
- */
-export interface PluginMetadata {
-    id: string;
-    name: string;
-    version: string;
-    description: string;
-    author?: string;
-    license?: string;
-    homepage?: string;
-    dependencies?: string[];
-}
-/**
- * Plugin registry
- */
-export interface IPluginRegistry {
-    register(plugin: ClaudeFlowPlugin): void;
-    unregister(pluginId: string): void;
-    get(pluginId: string): ClaudeFlowPlugin | undefined;
-    getAll(): ClaudeFlowPlugin[];
-    isRegistered(pluginId: string): boolean;
-}
-/**
- * Plugin loader interface
- */
-export interface IPluginLoader {
-    loadFromPath(path: string): Promise<ClaudeFlowPlugin>;
-    loadFromPackage(packageName: string): Promise<ClaudeFlowPlugin>;
-    loadBuiltin(pluginId: string): Promise<ClaudeFlowPlugin>;
-}
-//# sourceMappingURL=types.d.ts.map

package/v3/@claude-flow/shared/dist/plugins/types.js

@@ -1,9 +0,0 @@
-/**
- * Plugin Types - ADR-004 Implementation
- *
- * Type definitions for the plugin system.
- *
- * @module v3/shared/plugins/types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts

@@ -1,105 +0,0 @@
-/**
- * Bulkhead Pattern
- *
- * Isolates failures by limiting concurrent executions.
- *
- * @module v3/shared/resilience/bulkhead
- */
-import { EventEmitter } from 'events';
-/**
- * Bulkhead options
- */
-export interface BulkheadOptions {
-    /** Name for identification */
-    name: string;
-    /** Maximum concurrent executions */
-    maxConcurrent: number;
-    /** Maximum queue size */
-    maxQueue: number;
-    /** Timeout for queued items in ms */
-    queueTimeout: number;
-    /** Callback when rejected */
-    onRejected?: (reason: 'full' | 'timeout') => void;
-}
-/**
- * Bulkhead statistics
- */
-export interface BulkheadStats {
-    active: number;
-    queued: number;
-    maxConcurrent: number;
-    maxQueue: number;
-    completed: number;
-    rejected: number;
-    timedOut: number;
-}
-/**
- * Bulkhead
- *
- * Limits concurrent executions to prevent resource exhaustion.
- *
- * @example
- * const bulkhead = new Bulkhead({
- *   name: 'database',
- *   maxConcurrent: 10,
- *   maxQueue: 50,
- * });
- *
- * try {
- *   const result = await bulkhead.execute(() => dbQuery());
- * } catch (error) {
- *   if (error.message.includes('Bulkhead full')) {
- *     // Handle capacity exceeded
- *   }
- * }
- */
-export declare class Bulkhead extends EventEmitter {
-    private readonly options;
-    private active;
-    private readonly queue;
-    private completed;
-    private rejected;
-    private timedOut;
-    constructor(options: BulkheadOptions);
-    /**
-     * Execute a function within the bulkhead
-     */
-    execute<T>(fn: () => Promise<T>): Promise<T>;
-    /**
-     * Get current statistics
-     */
-    getStats(): BulkheadStats;
-    /**
-     * Check if there's capacity available
-     */
-    hasCapacity(): boolean;
-    /**
-     * Get available capacity (concurrent + queue)
-     */
-    availableCapacity(): number;
-    /**
-     * Reset statistics
-     */
-    resetStats(): void;
-    /**
-     * Run function immediately
-     */
-    private runNow;
-    /**
-     * Add function to queue
-     */
-    private addToQueue;
-    /**
-     * Process next item in queue
-     */
-    private processQueue;
-}
-/**
- * Create a semaphore for limiting concurrent access
- */
-export declare function createSemaphore(maxConcurrent: number): {
-    acquire: () => Promise<void>;
-    release: () => void;
-    available: () => number;
-};
-//# sourceMappingURL=bulkhead.d.ts.map