agentic-qe 1.0.0

package/dist/core/FleetManager.js

@@ -0,0 +1,354 @@
+"use strict";
+/**
+ * FleetManager - Central coordination hub for the AQE Fleet
+ *
+ * @remarks
+ * The FleetManager is the primary interface for managing the Agentic QE Fleet.
+ * It provides comprehensive lifecycle management for autonomous agents, task
+ * coordination, and fleet-wide monitoring through an event-driven architecture.
+ *
+ * @example
+ * ```typescript
+ * // Initialize a fleet with multiple agent types
+ * const config = {
+ *   agents: [
+ *     { type: 'test-generator', count: 2, config: { aiModel: 'claude-sonnet-4.5' } },
+ *     { type: 'test-executor', count: 4, config: { maxParallelTests: 8 } },
+ *     { type: 'coverage-analyzer', count: 1 }
+ *   ]
+ * };
+ *
+ * const fleet = new FleetManager(config);
+ * await fleet.initialize();
+ * await fleet.start();
+ *
+ * // Submit tasks
+ * const task = new Task('test-generation', 'Generate API tests', {
+ *   targetFiles: ['./src/api/*.ts']
+ * });
+ * await fleet.submitTask(task);
+ *
+ * // Monitor fleet status
+ * const status = fleet.getStatus();
+ * console.log(`Active agents: ${status.activeAgents}/${status.totalAgents}`);
+ * ```
+ *
+ * @public
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FleetManager = void 0;
+const events_1 = require("events");
+const uuid_1 = require("uuid");
+const Agent_1 = require("./Agent");
+const Task_1 = require("./Task");
+const EventBus_1 = require("./EventBus");
+const Database_1 = require("../utils/Database");
+const Logger_1 = require("../utils/Logger");
+class FleetManager extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.startTime = null;
+        this.status = 'initializing';
+        this.id = (0, uuid_1.v4)();
+        this.agents = new Map();
+        this.tasks = new Map();
+        this.eventBus = new EventBus_1.EventBus();
+        this.database = new Database_1.Database();
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = config;
+        this.setupEventHandlers();
+    }
+    /**
+     * Initialize the fleet manager and its components
+     *
+     * @remarks
+     * This method performs the following operations:
+     * - Initializes the database connection
+     * - Starts the event bus
+     * - Creates the initial pool of agents based on configuration
+     *
+     * @returns A promise that resolves when initialization is complete
+     * @throws {Error} If database initialization fails or agents cannot be created
+     *
+     * @example
+     * ```typescript
+     * const fleet = new FleetManager(config);
+     * await fleet.initialize();
+     * ```
+     *
+     * @public
+     */
+    async initialize() {
+        this.logger.info(`Initializing Fleet Manager ${this.id}`);
+        try {
+            // Initialize database
+            await this.database.initialize();
+            // Initialize event bus
+            await this.eventBus.initialize();
+            // Create initial agent pool
+            await this.createInitialAgents();
+            this.status = 'running';
+            this.logger.info('Fleet Manager initialized successfully');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize Fleet Manager:', error);
+            throw error;
+        }
+    }
+    /**
+     * Start the fleet operations and activate all agents
+     *
+     * @remarks
+     * Starts all agents in the fleet and begins accepting tasks. The fleet must be
+     * initialized before calling this method.
+     *
+     * @returns A promise that resolves when all agents have started
+     * @throws {Error} If fleet is not initialized or agents fail to start
+     * @fires fleet:started
+     *
+     * @public
+     */
+    async start() {
+        if (this.status !== 'running') {
+            throw new Error('Fleet must be initialized before starting');
+        }
+        this.startTime = new Date();
+        this.logger.info('Fleet Manager started');
+        // Start all agents
+        for (const agent of this.agents.values()) {
+            await agent.start();
+        }
+        this.emit('fleet:started', this.getStatus());
+    }
+    /**
+     * Stop the fleet operations gracefully
+     *
+     * @remarks
+     * Performs graceful shutdown:
+     * - Stops accepting new tasks
+     * - Waits for running tasks to complete
+     * - Stops all agents
+     * - Closes database connections
+     *
+     * @returns A promise that resolves when shutdown is complete
+     * @fires fleet:stopped
+     *
+     * @public
+     */
+    async stop() {
+        this.status = 'stopping';
+        this.logger.info('Stopping Fleet Manager');
+        // Stop all agents gracefully
+        const stopPromises = Array.from(this.agents.values()).map(agent => agent.stop());
+        await Promise.all(stopPromises);
+        // Close database connection
+        await this.database.close();
+        this.status = 'stopped';
+        this.emit('fleet:stopped', this.getStatus());
+        this.logger.info('Fleet Manager stopped');
+    }
+    /**
+     * Create and register a new agent in the fleet
+     *
+     * @param type - The type of agent to create (e.g., 'test-generator', 'test-executor')
+     * @param config - Optional configuration for the agent
+     * @returns A promise that resolves to the created agent instance
+     * @throws {Error} If agent type is unknown or creation fails
+     * @fires agent:spawned
+     *
+     * @example
+     * ```typescript
+     * const testGen = await fleet.spawnAgent('test-generator', {
+     *   aiModel: 'claude-sonnet-4.5',
+     *   frameworks: ['jest', 'vitest']
+     * });
+     * ```
+     *
+     * @public
+     */
+    async spawnAgent(type, config = {}) {
+        const agentId = (0, uuid_1.v4)();
+        // Import agent factory and create agent
+        const { createAgent } = await Promise.resolve().then(() => __importStar(require('../agents')));
+        const agent = await createAgent(type, agentId, config, this.eventBus);
+        this.agents.set(agentId, agent);
+        await agent.initialize();
+        this.logger.info(`Agent spawned: ${type} (${agentId})`);
+        this.emit('agent:spawned', { agentId, type });
+        return agent;
+    }
+    /**
+     * Remove an agent from the fleet
+     */
+    async removeAgent(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        await agent.stop();
+        this.agents.delete(agentId);
+        this.logger.info(`Agent removed: ${agentId}`);
+        this.emit('agent:removed', { agentId });
+    }
+    /**
+     * Submit a task for execution by an available agent
+     *
+     * @remarks
+     * The fleet will automatically assign the task to an available agent that can
+     * handle the task type. If no agent is available, the task will be queued.
+     *
+     * @param task - The task to submit
+     * @returns A promise that resolves when the task is submitted
+     * @fires task:submitted
+     *
+     * @example
+     * ```typescript
+     * const task = new Task(
+     *   'coverage-analysis',
+     *   'Analyze test coverage',
+     *   { coverageReport: './coverage/coverage-final.json' }
+     * );
+     * await fleet.submitTask(task);
+     * ```
+     *
+     * @public
+     */
+    async submitTask(task) {
+        this.tasks.set(task.getId(), task);
+        // Find available agent for the task
+        const agent = this.findAvailableAgent(task.getType());
+        if (agent) {
+            await agent.assignTask(task);
+            this.logger.info(`Task ${task.getId()} assigned to agent ${agent.getId()}`);
+        }
+        else {
+            task.setStatus(Task_1.TaskStatus.QUEUED);
+            this.logger.warn(`No available agent for task ${task.getId()}, queuing`);
+        }
+        this.emit('task:submitted', { taskId: task.getId() });
+    }
+    /**
+     * Get current fleet status and metrics
+     *
+     * @returns Fleet status including agent counts, task metrics, and uptime
+     *
+     * @example
+     * ```typescript
+     * const status = fleet.getStatus();
+     * console.log(`Fleet ${status.id}: ${status.activeAgents}/${status.totalAgents} agents active`);
+     * console.log(`Tasks: ${status.runningTasks} running, ${status.completedTasks} completed`);
+     * ```
+     *
+     * @public
+     */
+    getStatus() {
+        const activeAgents = Array.from(this.agents.values())
+            .filter(agent => agent.getStatus() === Agent_1.AgentStatus.ACTIVE).length;
+        const runningTasks = Array.from(this.tasks.values())
+            .filter(task => task.getStatus() === Task_1.TaskStatus.RUNNING).length;
+        const completedTasks = Array.from(this.tasks.values())
+            .filter(task => task.getStatus() === Task_1.TaskStatus.COMPLETED).length;
+        const failedTasks = Array.from(this.tasks.values())
+            .filter(task => task.getStatus() === Task_1.TaskStatus.FAILED).length;
+        return {
+            id: this.id,
+            activeAgents,
+            totalAgents: this.agents.size,
+            runningTasks,
+            completedTasks,
+            failedTasks,
+            uptime: this.startTime ? Date.now() - this.startTime.getTime() : 0,
+            status: this.status
+        };
+    }
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * Get all agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get task by ID
+     */
+    getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+    /**
+     * Get all tasks
+     */
+    getAllTasks() {
+        return Array.from(this.tasks.values());
+    }
+    /**
+     * Find an available agent for a specific task type
+     */
+    findAvailableAgent(taskType) {
+        return Array.from(this.agents.values()).find(agent => agent.getStatus() === Agent_1.AgentStatus.IDLE &&
+            agent.canHandleTaskType(taskType));
+    }
+    /**
+     * Create initial agent pool based on configuration
+     */
+    async createInitialAgents() {
+        const { agents: agentConfigs } = this.config;
+        for (const agentConfig of agentConfigs) {
+            for (let i = 0; i < agentConfig.count; i++) {
+                await this.spawnAgent(agentConfig.type, agentConfig.config);
+            }
+        }
+    }
+    /**
+     * Setup event handlers for fleet coordination
+     */
+    setupEventHandlers() {
+        this.eventBus.on('task:completed', (data) => {
+            const task = this.tasks.get(data.taskId);
+            if (task) {
+                this.logger.info(`Task completed: ${data.taskId}`);
+                this.emit('task:completed', data);
+            }
+        });
+        this.eventBus.on('task:failed', (data) => {
+            const task = this.tasks.get(data.taskId);
+            if (task) {
+                this.logger.error(`Task failed: ${data.taskId}`, data.error);
+                this.emit('task:failed', data);
+            }
+        });
+        this.eventBus.on('agent:error', (data) => {
+            this.logger.error(`Agent error: ${data.agentId}`, data.error);
+            this.emit('agent:error', data);
+        });
+    }
+}
+exports.FleetManager = FleetManager;
+//# sourceMappingURL=FleetManager.js.map

package/dist/core/FleetManager.js.map

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

package/dist/core/MemoryManager.d.ts

@@ -0,0 +1,119 @@
+/**
+ * MemoryManager - Intelligent memory management for AQE Fleet
+ *
+ * Provides in-memory storage with TTL support, namespacing, and optional
+ * SQLite persistence for cross-session memory and agent coordination.
+ */
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { Database } from '../utils/Database';
+import { MemoryRecord } from '../types';
+export interface MemoryOptions {
+    ttl?: number;
+    namespace?: string;
+    metadata?: Record<string, any>;
+    persist?: boolean;
+}
+export interface MemorySearchOptions {
+    namespace?: string;
+    pattern?: string;
+    limit?: number;
+    includeExpired?: boolean;
+}
+export interface MemoryStats {
+    totalKeys: number;
+    totalSize: number;
+    namespaces: string[];
+    expiredKeys: number;
+    persistentKeys: number;
+}
+export declare class MemoryManager extends EventEmitter {
+    private readonly storage;
+    private readonly database;
+    private readonly logger;
+    private readonly cleanupInterval;
+    private readonly defaultTTL;
+    private initialized;
+    constructor(database?: Database);
+    /**
+     * Initialize the memory manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Store a value in memory
+     */
+    store(key: string, value: any, options?: MemoryOptions): Promise<void>;
+    /**
+     * Retrieve a value from memory
+     */
+    retrieve(key: string, namespace?: string): Promise<any>;
+    /**
+     * Delete a key from memory
+     */
+    delete(key: string, namespace?: string): Promise<boolean>;
+    /**
+     * Check if a key exists
+     */
+    exists(key: string, namespace?: string): Promise<boolean>;
+    /**
+     * List all keys in a namespace
+     */
+    list(namespace?: string): Promise<string[]>;
+    /**
+     * Search for keys by pattern
+     */
+    search(options?: MemorySearchOptions): Promise<MemoryRecord[]>;
+    /**
+     * Clear all keys in a namespace
+     */
+    clear(namespace?: string): Promise<number>;
+    /**
+     * Get memory statistics
+     */
+    getStats(): MemoryStats;
+    /**
+     * Set TTL for an existing key
+     */
+    setTTL(key: string, ttl: number, namespace?: string): Promise<boolean>;
+    /**
+     * Get TTL for a key
+     */
+    getTTL(key: string, namespace?: string): Promise<number | undefined>;
+    /**
+     * Export memory data for backup
+     */
+    export(namespace?: string): Promise<MemoryRecord[]>;
+    /**
+     * Import memory data from backup
+     */
+    import(records: MemoryRecord[]): Promise<number>;
+    /**
+     * Cleanup expired keys
+     */
+    cleanupExpired(): void;
+    /**
+     * Shutdown memory manager
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Create full key with namespace
+     */
+    private createFullKey;
+    /**
+     * Check if a record is expired
+     */
+    private isExpired;
+    /**
+     * Load a record from database
+     */
+    private loadFromDatabase;
+    /**
+     * Load persistent memory from database
+     */
+    private loadPersistentMemory;
+    /**
+     * Save memory to persistence
+     */
+    private saveToPersistence;
+}
+//# sourceMappingURL=MemoryManager.d.ts.map

package/dist/core/MemoryManager.d.ts.map

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