agentic-qe 1.0.0

package/dist/mcp/services/AgentRegistry.js

@@ -0,0 +1,403 @@
+"use strict";
+/**
+ * Agent Registry Service
+ *
+ * Central registry for managing QE agent instances spawned via MCP.
+ * Bridges MCP tool calls to TypeScript agent implementations.
+ *
+ * @version 1.0.0
+ * @author Agentic QE Team
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetAgentRegistry = exports.getAgentRegistry = exports.AgentRegistry = void 0;
+const agents_1 = require("../../agents");
+const types_1 = require("../../types");
+const Logger_1 = require("../../utils/Logger");
+const EventBus_1 = require("../../core/EventBus");
+const MemoryManager_1 = require("../../core/MemoryManager");
+/**
+ * AgentRegistry - Central management for QE agent instances
+ *
+ * Responsibilities:
+ * - Create and track agent instances
+ * - Map MCP types to QEAgentType enum
+ * - Execute tasks on agents
+ * - Collect agent metrics
+ * - Handle agent lifecycle
+ */
+class AgentRegistry {
+    constructor(config = {}) {
+        this.agents = new Map();
+        this.nextAgentId = 1;
+        this.config = {
+            maxAgents: config.maxAgents || 50,
+            defaultTimeout: config.defaultTimeout || 300000, // 5 minutes
+            enableMetrics: config.enableMetrics !== false
+        };
+        this.logger = Logger_1.Logger.getInstance();
+        // Initialize infrastructure
+        this.eventBus = new EventBus_1.EventBus();
+        this.memoryStore = new MemoryManager_1.MemoryManager();
+        // Create factory with infrastructure
+        this.factory = new agents_1.QEAgentFactory({
+            eventBus: this.eventBus,
+            memoryStore: this.memoryStore,
+            context: this.createDefaultContext()
+        });
+    }
+    /**
+     * Create default agent context
+     */
+    createDefaultContext() {
+        return {
+            id: `registry-${Date.now()}`,
+            type: 'registry',
+            status: types_1.AgentStatus.INITIALIZING
+        };
+    }
+    /**
+     * Create agent-specific context
+     */
+    createAgentContext(mcpType, agentId) {
+        return {
+            id: agentId,
+            type: mcpType,
+            status: types_1.AgentStatus.ACTIVE,
+            metadata: {
+                workingDirectory: process.cwd(),
+                environment: process.env.NODE_ENV || 'development'
+            }
+        };
+    }
+    /**
+     * Map string capabilities to AgentCapability objects
+     */
+    mapCapabilities(capabilities) {
+        return capabilities.map((cap) => ({
+            name: cap,
+            version: '1.0.0',
+            description: `${cap} capability`
+        }));
+    }
+    /**
+     * Spawn a new QE agent from MCP specification
+     *
+     * @param mcpType - MCP agent type string (e.g., 'test-generator')
+     * @param config - Agent configuration
+     * @returns Spawned agent ID and instance
+     */
+    async spawnAgent(mcpType, config) {
+        // Check agent limit
+        if (this.agents.size >= this.config.maxAgents) {
+            throw new Error(`Agent limit reached: ${this.config.maxAgents}`);
+        }
+        // Map MCP type to QEAgentType
+        const agentType = this.mapMCPTypeToQEAgentType(mcpType);
+        if (!agentType) {
+            throw new Error(`Unknown MCP agent type: ${mcpType}`);
+        }
+        // Generate unique agent ID
+        const agentId = this.generateAgentId(mcpType);
+        this.logger.info(`Spawning agent: ${agentId} (type: ${mcpType} -> ${agentType})`);
+        try {
+            // Create full BaseAgentConfig with infrastructure
+            const fullConfig = {
+                type: agentType,
+                capabilities: config.capabilities
+                    ? this.mapCapabilities(config.capabilities)
+                    : [],
+                context: this.createAgentContext(mcpType, agentId),
+                memoryStore: this.memoryStore,
+                eventBus: this.eventBus
+            };
+            // Create agent via factory instance method with additional config
+            const agent = await this.factory.createAgent(agentType, {
+                ...fullConfig,
+                name: config.name || agentId,
+                description: config.description || `${mcpType} agent spawned via MCP`
+            });
+            // Initialize agent
+            await agent.initialize();
+            // Register agent
+            const registeredAgent = {
+                id: agentId,
+                agent,
+                type: agentType,
+                mcpType,
+                spawnedAt: new Date(),
+                lastActivity: new Date(),
+                tasksCompleted: 0,
+                totalExecutionTime: 0,
+                status: 'idle'
+            };
+            this.agents.set(agentId, registeredAgent);
+            this.logger.info(`Agent spawned successfully: ${agentId}`);
+            return { id: agentId, agent };
+        }
+        catch (error) {
+            this.logger.error(`Failed to spawn agent ${agentId}:`, error);
+            throw new Error(`Agent spawn failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get an agent by ID
+     *
+     * @param agentId - Agent ID
+     * @returns Agent instance or undefined
+     */
+    getAgent(agentId) {
+        const registered = this.agents.get(agentId);
+        if (registered) {
+            registered.lastActivity = new Date();
+        }
+        return registered?.agent;
+    }
+    /**
+     * Get registered agent metadata
+     *
+     * @param agentId - Agent ID
+     * @returns Registered agent metadata or undefined
+     */
+    getRegisteredAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * Execute a task on a specific agent
+     *
+     * @param agentId - Agent ID
+     * @param task - Task to execute
+     * @returns Task result
+     */
+    async executeTask(agentId, task) {
+        const registered = this.agents.get(agentId);
+        if (!registered) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        this.logger.info(`Executing task on agent ${agentId}:`, { taskType: task.taskType });
+        const startTime = Date.now();
+        registered.status = 'busy';
+        try {
+            const result = await registered.agent.executeTask(task);
+            // Update metrics
+            const executionTime = Date.now() - startTime;
+            registered.tasksCompleted++;
+            registered.totalExecutionTime += executionTime;
+            registered.lastActivity = new Date();
+            registered.status = 'idle';
+            this.logger.info(`Task completed on agent ${agentId} in ${executionTime}ms`);
+            return result;
+        }
+        catch (error) {
+            registered.status = 'error';
+            this.logger.error(`Task failed on agent ${agentId}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Terminate an agent
+     *
+     * @param agentId - Agent ID
+     */
+    async terminateAgent(agentId) {
+        const registered = this.agents.get(agentId);
+        if (!registered) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        this.logger.info(`Terminating agent: ${agentId}`);
+        try {
+            // Call public terminate method instead of protected cleanup
+            // The agent will handle cleanup internally
+            await registered.agent.terminate();
+            registered.status = 'terminated';
+            this.agents.delete(agentId);
+            this.logger.info(`Agent terminated: ${agentId}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to terminate agent ${agentId}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get all active agents
+     *
+     * @returns Array of registered agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get agents by type
+     *
+     * @param mcpType - MCP agent type
+     * @returns Array of agents matching type
+     */
+    getAgentsByType(mcpType) {
+        return Array.from(this.agents.values()).filter((registered) => registered.mcpType === mcpType);
+    }
+    /**
+     * Get agent metrics
+     *
+     * @param agentId - Agent ID
+     * @returns Agent metrics
+     */
+    getAgentMetrics(agentId) {
+        const registered = this.agents.get(agentId);
+        if (!registered)
+            return undefined;
+        const uptime = Date.now() - registered.spawnedAt.getTime();
+        const averageExecutionTime = registered.tasksCompleted > 0
+            ? registered.totalExecutionTime / registered.tasksCompleted
+            : 0;
+        return {
+            tasksCompleted: registered.tasksCompleted,
+            averageExecutionTime,
+            uptime,
+            status: registered.status
+        };
+    }
+    /**
+     * Get registry statistics
+     *
+     * @returns Registry statistics
+     */
+    getStatistics() {
+        const agents = Array.from(this.agents.values());
+        const stats = {
+            totalAgents: agents.length,
+            activeAgents: agents.filter((a) => a.status !== 'terminated').length,
+            idleAgents: agents.filter((a) => a.status === 'idle').length,
+            busyAgents: agents.filter((a) => a.status === 'busy').length,
+            errorAgents: agents.filter((a) => a.status === 'error').length,
+            totalTasks: agents.reduce((sum, a) => sum + a.tasksCompleted, 0),
+            averageTaskTime: 0
+        };
+        const totalTime = agents.reduce((sum, a) => sum + a.totalExecutionTime, 0);
+        if (stats.totalTasks > 0) {
+            stats.averageTaskTime = totalTime / stats.totalTasks;
+        }
+        return stats;
+    }
+    /**
+     * Clear all agents (cleanup)
+     */
+    async clearAll() {
+        this.logger.info('Clearing all agents from registry');
+        const agentIds = Array.from(this.agents.keys());
+        for (const agentId of agentIds) {
+            try {
+                await this.terminateAgent(agentId);
+            }
+            catch (error) {
+                this.logger.warn(`Failed to terminate agent ${agentId} during clearAll:`, error);
+            }
+        }
+        this.agents.clear();
+        this.logger.info('All agents cleared from registry');
+    }
+    /**
+     * Generate unique agent ID
+     *
+     * @param mcpType - MCP agent type
+     * @returns Unique agent ID
+     */
+    generateAgentId(mcpType) {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substr(2, 9);
+        const id = this.nextAgentId++;
+        return `${mcpType}-${id}-${timestamp}-${random}`;
+    }
+    /**
+     * Map MCP agent type to QEAgentType enum
+     *
+     * @param mcpType - MCP agent type string
+     * @returns QEAgentType enum value or undefined
+     */
+    mapMCPTypeToQEAgentType(mcpType) {
+        const mapping = {
+            // Core Testing Agents (6)
+            'test-generator': types_1.QEAgentType.TEST_GENERATOR,
+            'test-executor': types_1.QEAgentType.TEST_EXECUTOR,
+            'coverage-analyzer': types_1.QEAgentType.COVERAGE_ANALYZER,
+            'quality-gate': types_1.QEAgentType.QUALITY_GATE,
+            'performance-tester': types_1.QEAgentType.PERFORMANCE_TESTER,
+            'security-scanner': types_1.QEAgentType.SECURITY_SCANNER,
+            // Strategic Planning Agents (3)
+            'requirements-validator': types_1.QEAgentType.REQUIREMENTS_VALIDATOR,
+            'deployment-validator': types_1.QEAgentType.DEPLOYMENT_READINESS,
+            'production-analyzer': types_1.QEAgentType.PRODUCTION_INTELLIGENCE,
+            // Specialized Testing Agents (3)
+            'fleet-commander': types_1.QEAgentType.FLEET_COMMANDER,
+            'chaos-engineer': types_1.QEAgentType.CHAOS_ENGINEER,
+            'visual-tester': types_1.QEAgentType.VISUAL_TESTER,
+            // Optimization Agents (4)
+            'regression-analyzer': types_1.QEAgentType.REGRESSION_RISK_ANALYZER,
+            'data-generator': types_1.QEAgentType.TEST_DATA_ARCHITECT,
+            'contract-validator': types_1.QEAgentType.API_CONTRACT_VALIDATOR,
+            'flaky-test-detector': types_1.QEAgentType.FLAKY_TEST_HUNTER
+        };
+        return mapping[mcpType];
+    }
+    /**
+     * Get supported MCP agent types
+     *
+     * @returns Array of supported MCP types
+     */
+    getSupportedMCPTypes() {
+        return [
+            'test-generator',
+            'test-executor',
+            'coverage-analyzer',
+            'quality-gate',
+            'performance-tester',
+            'security-scanner',
+            'requirements-validator',
+            'deployment-validator',
+            'production-analyzer',
+            'fleet-commander',
+            'chaos-engineer',
+            'visual-tester',
+            'regression-analyzer',
+            'data-generator',
+            'contract-validator',
+            'flaky-test-detector'
+        ];
+    }
+    /**
+     * Check if MCP type is supported
+     *
+     * @param mcpType - MCP agent type
+     * @returns True if supported
+     */
+    isSupportedMCPType(mcpType) {
+        return this.mapMCPTypeToQEAgentType(mcpType) !== undefined;
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+/**
+ * Singleton instance for global access
+ */
+let globalRegistry = null;
+/**
+ * Get or create global agent registry
+ *
+ * @param config - Optional configuration
+ * @returns Global agent registry instance
+ */
+function getAgentRegistry(config) {
+    if (!globalRegistry) {
+        globalRegistry = new AgentRegistry(config);
+    }
+    return globalRegistry;
+}
+exports.getAgentRegistry = getAgentRegistry;
+/**
+ * Reset global agent registry (for testing)
+ */
+function resetAgentRegistry() {
+    if (globalRegistry) {
+        globalRegistry.clearAll().catch(console.error);
+        globalRegistry = null;
+    }
+}
+exports.resetAgentRegistry = resetAgentRegistry;
+//# sourceMappingURL=AgentRegistry.js.map

package/dist/mcp/services/AgentRegistry.js.map

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

package/dist/mcp/services/HookExecutor.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Hook Executor Service
+ *
+ * Executes Claude Flow hooks for agent lifecycle events and coordination.
+ * Bridges MCP agents with Claude Flow's memory and event system.
+ *
+ * @version 1.0.0
+ * @author Agentic QE Team
+ */
+export type HookType = 'pre_task' | 'post_task' | 'post_edit' | 'session_start' | 'session_end' | 'notify';
+export interface HookParams {
+    description?: string;
+    agentType?: string;
+    agentId?: string;
+    taskId?: string;
+    results?: any;
+    status?: string;
+    file?: string;
+    fileName?: string;
+    memoryKey?: string;
+    message?: string;
+    level?: 'info' | 'warn' | 'error';
+    sessionId?: string;
+    exportMetrics?: boolean;
+}
+export interface HookExecutionResult {
+    success: boolean;
+    hookType: HookType;
+    commands: string[];
+    outputs: string[];
+    errors: string[];
+    executionTime: number;
+}
+/**
+ * HookExecutor - Execute Claude Flow hooks for agent coordination
+ *
+ * Responsibilities:
+ * - Execute pre/post task hooks
+ * - Coordinate memory storage/retrieval
+ * - Send notifications to Claude Flow
+ * - Handle session lifecycle
+ * - Bridge MCP agents with Claude Flow ecosystem
+ */
+export declare class HookExecutor {
+    private logger;
+    private enabled;
+    private dryRun;
+    private timeout;
+    constructor(config?: {
+        enabled?: boolean;
+        dryRun?: boolean;
+        timeout?: number;
+    });
+    /**
+     * Execute a hook with specified parameters
+     *
+     * @param hookType - Type of hook to execute
+     * @param params - Hook parameters
+     * @returns Execution result
+     */
+    executeHook(hookType: HookType, params: HookParams): Promise<HookExecutionResult>;
+    /**
+     * Execute pre-task hook
+     *
+     * @param params - Pre-task parameters
+     * @returns Execution result
+     */
+    executePreTask(params: HookParams): Promise<HookExecutionResult>;
+    /**
+     * Execute post-task hook
+     *
+     * @param params - Post-task parameters
+     * @returns Execution result
+     */
+    executePostTask(params: HookParams): Promise<HookExecutionResult>;
+    /**
+     * Execute post-edit hook
+     *
+     * @param params - Post-edit parameters
+     * @returns Execution result
+     */
+    executePostEdit(params: HookParams): Promise<HookExecutionResult>;
+    /**
+     * Send notification to Claude Flow
+     *
+     * @param params - Notification parameters
+     * @returns Execution result
+     */
+    notify(params: HookParams): Promise<HookExecutionResult>;
+    /**
+     * Store data in Claude Flow memory
+     *
+     * @param key - Memory key
+     * @param value - Value to store (will be JSON stringified)
+     * @returns Execution result
+     */
+    storeMemory(key: string, value: any): Promise<HookExecutionResult>;
+    /**
+     * Retrieve data from Claude Flow memory
+     *
+     * @param key - Memory key
+     * @returns Retrieved value or null
+     */
+    retrieveMemory(key: string): Promise<any>;
+    /**
+     * Enable/disable hook execution
+     *
+     * @param enabled - True to enable, false to disable
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Enable/disable dry-run mode
+     *
+     * @param dryRun - True for dry-run, false for real execution
+     */
+    setDryRun(dryRun: boolean): void;
+    /**
+     * Build hook commands based on type and parameters
+     *
+     * @param hookType - Hook type
+     * @param params - Hook parameters
+     * @returns Array of commands to execute
+     */
+    private buildHookCommands;
+    /**
+     * Execute a shell command with timeout
+     *
+     * @param command - Command to execute
+     * @returns Command output
+     */
+    private executeCommand;
+    /**
+     * Escape shell argument to prevent injection
+     *
+     * @param arg - Argument to escape
+     * @returns Escaped argument
+     */
+    private escapeShellArg;
+    /**
+     * Create success result
+     *
+     * @param hookType - Hook type
+     * @param commands - Executed commands
+     * @param outputs - Command outputs
+     * @param errors - Errors (empty for success)
+     * @returns Execution result
+     */
+    private createSuccessResult;
+}
+/**
+ * Get or create global hook executor
+ *
+ * @param config - Optional configuration
+ * @returns Global hook executor instance
+ */
+export declare function getHookExecutor(config?: {
+    enabled?: boolean;
+    dryRun?: boolean;
+    timeout?: number;
+}): HookExecutor;
+/**
+ * Reset global hook executor (for testing)
+ */
+export declare function resetHookExecutor(): void;
+//# sourceMappingURL=HookExecutor.d.ts.map

package/dist/mcp/services/HookExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookExecutor.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/HookExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE3G,MAAM,WAAW,UAAU;IAEzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAGlC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAOlF;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+CvF;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAItE;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIvE;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIvE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI9D;;;;;;OAMG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8BxE;;;;;OAKG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAqB/C;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKhC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAoEzB;;;;;OAKG;YACW,cAAc;IAoB5B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;CAe5B;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAKhH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}