@claude-flow/swarm 3.0.0-alpha.1

package/dist/coordination/agent-registry.js

@@ -0,0 +1,412 @@
+/**
+ * V3 Agent Registry
+ * Manages registration, lifecycle, and capabilities of all 15 agents
+ *
+ * Based on ADR-002 (DDD) and 15-Agent Swarm Architecture
+ */
+import { agentSpawnedEvent, agentStatusChangedEvent, agentErrorEvent } from '../shared/events';
+// =============================================================================
+// Agent Registry Implementation
+// =============================================================================
+export class AgentRegistry {
+    definitions = new Map();
+    states = new Map();
+    healthChecks = new Map();
+    eventBus;
+    healthCheckInterval = 5000;
+    healthCheckTimer = null;
+    maxMissedHeartbeats = 3;
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+        this.registerDefaultAgents();
+    }
+    // ==========================================================================
+    // Registration
+    // ==========================================================================
+    register(definition) {
+        if (this.definitions.has(definition.id)) {
+            throw new Error(`Agent ${definition.id} is already registered`);
+        }
+        this.definitions.set(definition.id, definition);
+        this.healthChecks.set(definition.id, {
+            agentId: definition.id,
+            healthy: false,
+            lastHeartbeat: 0,
+            consecutiveMisses: 0,
+            status: 'idle'
+        });
+    }
+    unregister(agentId) {
+        if (this.states.has(agentId)) {
+            throw new Error(`Cannot unregister active agent ${agentId}`);
+        }
+        this.healthChecks.delete(agentId);
+        return this.definitions.delete(agentId);
+    }
+    isRegistered(agentId) {
+        return this.definitions.has(agentId);
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    async spawn(agentId) {
+        const definition = this.definitions.get(agentId);
+        if (!definition) {
+            throw new Error(`Agent ${agentId} is not registered`);
+        }
+        if (this.states.has(agentId)) {
+            throw new Error(`Agent ${agentId} is already spawned`);
+        }
+        const state = {
+            id: agentId,
+            role: definition.role,
+            status: 'idle',
+            currentTask: null,
+            completedTasks: [],
+            metrics: this.createInitialMetrics(),
+            lastHeartbeat: Date.now()
+        };
+        this.states.set(agentId, state);
+        const healthStatus = this.healthChecks.get(agentId);
+        healthStatus.healthy = true;
+        healthStatus.lastHeartbeat = Date.now();
+        healthStatus.status = 'idle';
+        await this.eventBus.emit(agentSpawnedEvent(agentId, definition.role));
+        return state;
+    }
+    async terminate(agentId) {
+        const state = this.states.get(agentId);
+        if (!state) {
+            return false;
+        }
+        if (state.currentTask) {
+            throw new Error(`Cannot terminate agent ${agentId} with active task ${state.currentTask}`);
+        }
+        this.states.delete(agentId);
+        const healthStatus = this.healthChecks.get(agentId);
+        if (healthStatus) {
+            healthStatus.healthy = false;
+            healthStatus.status = 'idle';
+        }
+        await this.eventBus.emit(agentStatusChangedEvent(agentId, state.status, 'terminated'));
+        return true;
+    }
+    // ==========================================================================
+    // State Management
+    // ==========================================================================
+    getState(agentId) {
+        return this.states.get(agentId);
+    }
+    updateStatus(agentId, status) {
+        const state = this.states.get(agentId);
+        if (!state) {
+            throw new Error(`Agent ${agentId} is not spawned`);
+        }
+        const previousStatus = state.status;
+        state.status = status;
+        const healthStatus = this.healthChecks.get(agentId);
+        if (healthStatus) {
+            healthStatus.status = status;
+        }
+        this.eventBus.emitSync(agentStatusChangedEvent(agentId, previousStatus, status));
+    }
+    assignTask(agentId, taskId) {
+        const state = this.states.get(agentId);
+        if (!state) {
+            throw new Error(`Agent ${agentId} is not spawned`);
+        }
+        if (state.currentTask) {
+            throw new Error(`Agent ${agentId} already has task ${state.currentTask}`);
+        }
+        state.currentTask = taskId;
+        this.updateStatus(agentId, 'active');
+    }
+    completeTask(agentId, taskId) {
+        const state = this.states.get(agentId);
+        if (!state) {
+            throw new Error(`Agent ${agentId} is not spawned`);
+        }
+        if (state.currentTask !== taskId) {
+            throw new Error(`Agent ${agentId} current task is ${state.currentTask}, not ${taskId}`);
+        }
+        state.completedTasks.push(taskId);
+        state.currentTask = null;
+        state.metrics.tasksCompleted++;
+        this.updateStatus(agentId, 'idle');
+    }
+    // ==========================================================================
+    // Queries
+    // ==========================================================================
+    getDefinition(agentId) {
+        return this.definitions.get(agentId);
+    }
+    getAllAgents() {
+        return Array.from(this.definitions.values());
+    }
+    getActiveAgents() {
+        return Array.from(this.states.values()).filter(s => s.status === 'active');
+    }
+    getAgentsByDomain(domain) {
+        return Array.from(this.definitions.values()).filter(d => d.domain === domain);
+    }
+    getAgentsByCapability(taskType) {
+        return Array.from(this.definitions.values()).filter(d => d.capabilities.some(c => c.supportedTaskTypes.includes(taskType)));
+    }
+    // ==========================================================================
+    // Health Management
+    // ==========================================================================
+    heartbeat(agentId) {
+        const state = this.states.get(agentId);
+        if (state) {
+            state.lastHeartbeat = Date.now();
+        }
+        const healthStatus = this.healthChecks.get(agentId);
+        if (healthStatus) {
+            healthStatus.lastHeartbeat = Date.now();
+            healthStatus.consecutiveMisses = 0;
+            healthStatus.healthy = true;
+        }
+    }
+    getHealthStatus() {
+        return new Map(this.healthChecks);
+    }
+    startHealthChecks() {
+        if (this.healthCheckTimer) {
+            return;
+        }
+        this.healthCheckTimer = setInterval(() => {
+            this.performHealthCheck();
+        }, this.healthCheckInterval);
+    }
+    stopHealthChecks() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+    }
+    performHealthCheck() {
+        const now = Date.now();
+        for (const [agentId, healthStatus] of this.healthChecks) {
+            const state = this.states.get(agentId);
+            if (!state) {
+                continue;
+            }
+            const timeSinceHeartbeat = now - healthStatus.lastHeartbeat;
+            if (timeSinceHeartbeat > this.healthCheckInterval) {
+                healthStatus.consecutiveMisses++;
+                if (healthStatus.consecutiveMisses >= this.maxMissedHeartbeats) {
+                    healthStatus.healthy = false;
+                    this.updateStatus(agentId, 'error');
+                    this.eventBus.emitSync(agentErrorEvent(agentId, new Error(`Agent ${agentId} missed ${healthStatus.consecutiveMisses} heartbeats`)));
+                }
+            }
+        }
+    }
+    // ==========================================================================
+    // Events
+    // ==========================================================================
+    onAgentEvent(handler) {
+        const unsubscribers = [
+            this.eventBus.subscribe('agent:spawned', handler),
+            this.eventBus.subscribe('agent:status-changed', handler),
+            this.eventBus.subscribe('agent:task-assigned', handler),
+            this.eventBus.subscribe('agent:task-completed', handler),
+            this.eventBus.subscribe('agent:error', handler)
+        ];
+        return () => {
+            unsubscribers.forEach(unsub => unsub());
+        };
+    }
+    // ==========================================================================
+    // Default Agent Registration
+    // ==========================================================================
+    registerDefaultAgents() {
+        const agentDefinitions = [
+            {
+                id: 'agent-1',
+                role: 'queen-coordinator',
+                domain: 'core',
+                description: 'Orchestration & GitHub Issue management for all 15 agents',
+                capabilities: [
+                    { name: 'orchestration', description: 'Coordinate all agents', supportedTaskTypes: ['architecture-design'] },
+                    { name: 'github-management', description: 'Manage GitHub issues and PRs', supportedTaskTypes: ['documentation'] }
+                ],
+                dependencies: [],
+                priority: 1
+            },
+            {
+                id: 'agent-2',
+                role: 'security-architect',
+                domain: 'security',
+                description: 'Security architecture review and design',
+                capabilities: [
+                    { name: 'security-design', description: 'Design security architecture', supportedTaskTypes: ['security-audit', 'architecture-design'] }
+                ],
+                dependencies: [],
+                priority: 2
+            },
+            {
+                id: 'agent-3',
+                role: 'security-implementer',
+                domain: 'security',
+                description: 'CVE fixes and security code implementation',
+                capabilities: [
+                    { name: 'security-implementation', description: 'Implement security fixes', supportedTaskTypes: ['security-fix', 'implementation'] }
+                ],
+                dependencies: ['agent-2'],
+                priority: 2
+            },
+            {
+                id: 'agent-4',
+                role: 'security-tester',
+                domain: 'security',
+                description: 'Security testing using TDD London School methodology',
+                capabilities: [
+                    { name: 'security-testing', description: 'Write and run security tests', supportedTaskTypes: ['security-test', 'test-writing'] }
+                ],
+                dependencies: ['agent-2'],
+                priority: 2
+            },
+            {
+                id: 'agent-5',
+                role: 'core-architect',
+                domain: 'core',
+                description: 'Core module DDD architecture design',
+                capabilities: [
+                    { name: 'architecture', description: 'Design core architecture', supportedTaskTypes: ['architecture-design'] }
+                ],
+                dependencies: ['agent-2'],
+                priority: 3
+            },
+            {
+                id: 'agent-6',
+                role: 'core-implementer',
+                domain: 'core',
+                description: 'Core module implementation and type system modernization',
+                capabilities: [
+                    { name: 'core-implementation', description: 'Implement core modules', supportedTaskTypes: ['implementation'] }
+                ],
+                dependencies: ['agent-5'],
+                priority: 3
+            },
+            {
+                id: 'agent-7',
+                role: 'memory-specialist',
+                domain: 'core',
+                description: 'Memory system unification with AgentDB (150x-12500x improvement)',
+                capabilities: [
+                    { name: 'memory-optimization', description: 'Optimize memory systems', supportedTaskTypes: ['memory-optimization', 'implementation'] }
+                ],
+                dependencies: ['agent-5'],
+                priority: 4
+            },
+            {
+                id: 'agent-8',
+                role: 'swarm-specialist',
+                domain: 'core',
+                description: 'Single SwarmCoordinator (merge 4 systems)',
+                capabilities: [
+                    { name: 'swarm-coordination', description: 'Design swarm coordination', supportedTaskTypes: ['swarm-coordination', 'implementation'] }
+                ],
+                dependencies: ['agent-5'],
+                priority: 4
+            },
+            {
+                id: 'agent-9',
+                role: 'mcp-specialist',
+                domain: 'core',
+                description: 'MCP server optimization and enhancement',
+                capabilities: [
+                    { name: 'mcp-optimization', description: 'Optimize MCP server', supportedTaskTypes: ['mcp-enhancement', 'implementation'] }
+                ],
+                dependencies: ['agent-5'],
+                priority: 4
+            },
+            {
+                id: 'agent-10',
+                role: 'integration-architect',
+                domain: 'integration',
+                description: 'agentic-flow@alpha deep integration',
+                capabilities: [
+                    { name: 'integration', description: 'Integrate with agentic-flow', supportedTaskTypes: ['integration', 'architecture-design'] }
+                ],
+                dependencies: ['agent-5', 'agent-7', 'agent-8', 'agent-9'],
+                priority: 5
+            },
+            {
+                id: 'agent-11',
+                role: 'cli-hooks-developer',
+                domain: 'integration',
+                description: 'CLI modernization and hooks system development',
+                capabilities: [
+                    { name: 'cli-development', description: 'Develop CLI and hooks', supportedTaskTypes: ['cli-development', 'implementation'] }
+                ],
+                dependencies: ['agent-9', 'agent-10'],
+                priority: 5
+            },
+            {
+                id: 'agent-12',
+                role: 'neural-learning-dev',
+                domain: 'integration',
+                description: 'Neural and SONA learning system integration',
+                capabilities: [
+                    { name: 'neural-training', description: 'Implement neural features', supportedTaskTypes: ['neural-training', 'implementation'] }
+                ],
+                dependencies: ['agent-7', 'agent-10'],
+                priority: 5
+            },
+            {
+                id: 'agent-13',
+                role: 'tdd-test-engineer',
+                domain: 'quality',
+                description: 'TDD London School methodology implementation',
+                capabilities: [
+                    { name: 'testing', description: 'Write comprehensive tests', supportedTaskTypes: ['test-writing'] }
+                ],
+                dependencies: [],
+                priority: 3
+            },
+            {
+                id: 'agent-14',
+                role: 'performance-engineer',
+                domain: 'performance',
+                description: 'Benchmarking and performance optimization (2.49x-7.47x target)',
+                capabilities: [
+                    { name: 'benchmarking', description: 'Run performance benchmarks', supportedTaskTypes: ['benchmark'] }
+                ],
+                dependencies: ['agent-7', 'agent-8'],
+                priority: 6
+            },
+            {
+                id: 'agent-15',
+                role: 'release-engineer',
+                domain: 'deployment',
+                description: 'Deployment pipeline and release management',
+                capabilities: [
+                    { name: 'deployment', description: 'Manage releases', supportedTaskTypes: ['deployment', 'documentation'] }
+                ],
+                dependencies: ['agent-10', 'agent-13', 'agent-14'],
+                priority: 7
+            }
+        ];
+        for (const definition of agentDefinitions) {
+            this.register(definition);
+        }
+    }
+    createInitialMetrics() {
+        return {
+            tasksCompleted: 0,
+            tasksFailed: 0,
+            averageTaskDuration: 0,
+            utilization: 0,
+            startTime: Date.now()
+        };
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+export function createAgentRegistry(eventBus) {
+    return new AgentRegistry(eventBus);
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/coordination/agent-registry.js.map

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

package/dist/coordination/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Coordination Components
+ * Agent registry, task orchestration, and swarm hub
+ */
+export { AgentRegistry, createAgentRegistry, type IAgentRegistry, } from './agent-registry.js';
+export { TaskOrchestrator, createTaskOrchestrator, type ITaskOrchestrator, type TaskSpec, } from './task-orchestrator.js';
+export { SwarmHub, createSwarmHub, type ISwarmHub, } from './swarm-hub.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/coordination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,GACd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,SAAS,GACf,MAAM,gBAAgB,CAAC"}

package/dist/coordination/index.js

@@ -0,0 +1,8 @@
+/**
+ * Coordination Components
+ * Agent registry, task orchestration, and swarm hub
+ */
+export { AgentRegistry, createAgentRegistry, } from './agent-registry.js';
+export { TaskOrchestrator, createTaskOrchestrator, } from './task-orchestrator.js';
+export { SwarmHub, createSwarmHub, } from './swarm-hub.js';
+//# sourceMappingURL=index.js.map

package/dist/coordination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAGvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,cAAc,GAEf,MAAM,gBAAgB,CAAC"}

package/dist/coordination/swarm-hub.d.ts

@@ -0,0 +1,150 @@
+/**
+ * V3 Swarm Hub - COMPATIBILITY LAYER (ADR-003)
+ *
+ * DEPRECATION NOTICE:
+ * This is a THIN FACADE over UnifiedSwarmCoordinator for backward compatibility.
+ * All operations are delegated to the canonical UnifiedSwarmCoordinator.
+ *
+ * For new code, use UnifiedSwarmCoordinator directly:
+ * ```typescript
+ * import { createUnifiedSwarmCoordinator } from '@claude-flow/swarm';
+ * const coordinator = createUnifiedSwarmCoordinator(config);
+ * await coordinator.initialize();
+ * ```
+ *
+ * ADR-003 Decision:
+ * - ONE canonical coordination engine: UnifiedSwarmCoordinator
+ * - SwarmHub maintained ONLY for compatibility with existing code
+ * - All core logic delegated to UnifiedSwarmCoordinator
+ *
+ * Based on ADR-001 (agentic-flow integration), ADR-003 (Single Coordination Engine),
+ * and the 15-Agent Swarm Architecture
+ */
+import { AgentId, AgentDomain, AgentState, TaskId, TaskDefinition, TaskResult, PhaseId, PhaseDefinition, MilestoneDefinition, SwarmConfig, SwarmState, SwarmMetrics, SwarmMessage, MessageType, MessageHandler, EventHandler } from '../shared/types';
+import { IEventBus } from '../shared/events';
+import { IAgentRegistry } from './agent-registry';
+import { ITaskOrchestrator, TaskSpec } from './task-orchestrator';
+import { UnifiedSwarmCoordinator } from '../unified-coordinator';
+export interface ISwarmHub {
+    initialize(config?: Partial<SwarmConfig>): Promise<void>;
+    shutdown(): Promise<void>;
+    isInitialized(): boolean;
+    spawnAgent(agentId: AgentId): Promise<AgentState>;
+    spawnAllAgents(): Promise<Map<AgentId, AgentState>>;
+    spawnAgentsByDomain(domain: AgentDomain): Promise<AgentState[]>;
+    terminateAgent(agentId: AgentId): Promise<boolean>;
+    submitTask(spec: TaskSpec): TaskDefinition;
+    submitBatchTasks(specs: TaskSpec[]): TaskDefinition[];
+    assignNextTask(agentId: AgentId): TaskDefinition | undefined;
+    completeTask(taskId: TaskId, result: TaskResult): void;
+    getCurrentPhase(): PhaseId;
+    advancePhase(): PhaseId;
+    getPhaseDefinition(phaseId: PhaseId): PhaseDefinition;
+    getMilestones(): MilestoneDefinition[];
+    completeMilestone(milestoneId: string): void;
+    sendMessage<T>(message: Omit<SwarmMessage<T>, 'id' | 'timestamp'>): void;
+    broadcast<T>(from: AgentId, type: MessageType, payload: T): void;
+    onMessage<T>(handler: MessageHandler<T>): () => void;
+    getState(): SwarmState;
+    getMetrics(): SwarmMetrics;
+    getAgentRegistry(): IAgentRegistry;
+    getTaskOrchestrator(): ITaskOrchestrator;
+    onSwarmEvent(handler: EventHandler): () => void;
+}
+/**
+ * @deprecated Use UnifiedSwarmCoordinator directly instead.
+ * This class is maintained for backward compatibility only.
+ *
+ * Migration guide:
+ * ```typescript
+ * // OLD:
+ * const hub = createSwarmHub();
+ * await hub.initialize();
+ *
+ * // NEW:
+ * const coordinator = createUnifiedSwarmCoordinator();
+ * await coordinator.initialize();
+ * ```
+ */
+export declare class SwarmHub implements ISwarmHub {
+    private coordinator;
+    private eventBus;
+    private agentRegistry;
+    private taskOrchestrator;
+    private currentPhase;
+    private phases;
+    private milestones;
+    private messageHandlers;
+    private messageCounter;
+    private startTime;
+    constructor(eventBus?: IEventBus);
+    /**
+     * @deprecated Delegates to UnifiedSwarmCoordinator.initialize()
+     */
+    initialize(config?: Partial<SwarmConfig>): Promise<void>;
+    /**
+     * @deprecated Delegates to UnifiedSwarmCoordinator.shutdown()
+     */
+    shutdown(): Promise<void>;
+    /**
+     * @deprecated Check UnifiedSwarmCoordinator state instead
+     */
+    isInitialized(): boolean;
+    spawnAgent(agentId: AgentId): Promise<AgentState>;
+    spawnAllAgents(): Promise<Map<AgentId, AgentState>>;
+    spawnAgentsByDomain(domain: AgentDomain): Promise<AgentState[]>;
+    terminateAgent(agentId: AgentId): Promise<boolean>;
+    submitTask(spec: TaskSpec): TaskDefinition;
+    submitBatchTasks(specs: TaskSpec[]): TaskDefinition[];
+    assignNextTask(agentId: AgentId): TaskDefinition | undefined;
+    completeTask(taskId: TaskId, result: TaskResult): void;
+    getCurrentPhase(): PhaseId;
+    advancePhase(): PhaseId;
+    getPhaseDefinition(phaseId: PhaseId): PhaseDefinition;
+    getMilestones(): MilestoneDefinition[];
+    completeMilestone(milestoneId: string): void;
+    sendMessage<T>(message: Omit<SwarmMessage<T>, 'id' | 'timestamp'>): void;
+    broadcast<T>(from: AgentId, type: MessageType, payload: T): void;
+    onMessage<T>(handler: MessageHandler<T>): () => void;
+    getState(): SwarmState;
+    getMetrics(): SwarmMetrics;
+    getAgentRegistry(): IAgentRegistry;
+    getTaskOrchestrator(): ITaskOrchestrator;
+    onSwarmEvent(handler: EventHandler): () => void;
+    /**
+     * Get the underlying UnifiedSwarmCoordinator for direct access.
+     * This is the canonical coordination engine as per ADR-003.
+     *
+     * Use this to access advanced features not exposed by the SwarmHub facade.
+     */
+    getCoordinator(): UnifiedSwarmCoordinator;
+    private ensureInitialized;
+    private convertToCoordinatorConfig;
+    private createPhaseDefinitions;
+    private initializeMilestones;
+}
+/**
+ * @deprecated Use createUnifiedSwarmCoordinator() instead.
+ * This factory is maintained for backward compatibility only.
+ *
+ * Migration:
+ * ```typescript
+ * // OLD:
+ * const hub = createSwarmHub();
+ *
+ * // NEW:
+ * import { createUnifiedSwarmCoordinator } from '@claude-flow/swarm';
+ * const coordinator = createUnifiedSwarmCoordinator();
+ * ```
+ */
+export declare function createSwarmHub(eventBus?: IEventBus): ISwarmHub;
+/**
+ * @deprecated Use UnifiedSwarmCoordinator singleton pattern instead.
+ * This function is maintained for backward compatibility only.
+ */
+export declare function getSwarmHub(): ISwarmHub;
+/**
+ * @deprecated Use coordinator.shutdown() directly instead.
+ */
+export declare function resetSwarmHub(): void;
+//# sourceMappingURL=swarm-hub.d.ts.map

package/dist/coordination/swarm-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-hub.d.ts","sourceRoot":"","sources":["../../src/coordination/swarm-hub.ts"],"names":[],"mappings":"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"}