agentic-qe 1.0.0 → 1.0.1

package/dist/core/coordination/OODACoordination.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OODACoordination = void 0;
+const events_1 = require("events");
+/**
+ * OODACoordination - Observe-Orient-Decide-Act loop for agent decision making
+ *
+ * Implements the OODA loop pattern for rapid, adaptive decision cycles
+ *
+ * Features:
+ * - Continuous observation gathering
+ * - Context-aware orientation
+ * - Decision making with options analysis
+ * - Action execution and tracking
+ * - Cycle performance metrics
+ */
+class OODACoordination extends events_1.EventEmitter {
+    constructor(memory) {
+        super();
+        this.memory = memory;
+        this.currentLoop = null;
+        this.cycleCount = 0;
+    }
+    /**
+     * Start a new OODA loop cycle
+     */
+    async startCycle() {
+        this.cycleCount++;
+        this.currentLoop = {
+            id: `ooda-cycle-${this.cycleCount}-${Date.now()}`,
+            cycleNumber: this.cycleCount,
+            observations: [],
+            orientation: null,
+            decision: null,
+            action: null,
+            startTime: Date.now()
+        };
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles',
+            ttl: 86400 // 24 hours
+        });
+        this.emit('ooda:cycle-started', this.currentLoop);
+        return this.currentLoop.id;
+    }
+    /**
+     * Observe - Gather raw data from environment
+     */
+    async observe(observation) {
+        if (!this.currentLoop) {
+            throw new Error('No active OODA cycle. Call startCycle() first.');
+        }
+        const obs = {
+            id: `obs-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            ...observation,
+            timestamp: Date.now()
+        };
+        this.currentLoop.observations.push(obs);
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles'
+        });
+        this.emit('ooda:observation-added', { cycle: this.currentLoop, observation: obs });
+        return obs;
+    }
+    /**
+     * Orient - Analyze observations and build situational awareness
+     */
+    async orient(analysis, context = {}) {
+        if (!this.currentLoop) {
+            throw new Error('No active OODA cycle. Call startCycle() first.');
+        }
+        if (this.currentLoop.observations.length === 0) {
+            throw new Error('Cannot orient without observations');
+        }
+        const orientation = {
+            id: `orient-${Date.now()}`,
+            observations: this.currentLoop.observations.map(o => o.id),
+            analysis,
+            context,
+            timestamp: Date.now()
+        };
+        this.currentLoop.orientation = orientation;
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles'
+        });
+        this.emit('ooda:orientation-completed', { cycle: this.currentLoop, orientation });
+        return orientation;
+    }
+    /**
+     * Decide - Make decision based on orientation
+     */
+    async decide(options, selected, rationale) {
+        if (!this.currentLoop) {
+            throw new Error('No active OODA cycle. Call startCycle() first.');
+        }
+        if (!this.currentLoop.orientation) {
+            throw new Error('Cannot decide without orientation');
+        }
+        const decision = {
+            id: `decision-${Date.now()}`,
+            orientationId: this.currentLoop.orientation.id,
+            options,
+            selected,
+            rationale,
+            timestamp: Date.now()
+        };
+        this.currentLoop.decision = decision;
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles'
+        });
+        this.emit('ooda:decision-made', { cycle: this.currentLoop, decision });
+        return decision;
+    }
+    /**
+     * Act - Execute the decided action
+     */
+    async act(type, parameters, executor) {
+        if (!this.currentLoop) {
+            throw new Error('No active OODA cycle. Call startCycle() first.');
+        }
+        if (!this.currentLoop.decision) {
+            throw new Error('Cannot act without decision');
+        }
+        const action = {
+            id: `action-${Date.now()}`,
+            decisionId: this.currentLoop.decision.id,
+            type,
+            parameters,
+            status: 'pending',
+            timestamp: Date.now()
+        };
+        this.currentLoop.action = action;
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles'
+        });
+        this.emit('ooda:action-started', { cycle: this.currentLoop, action });
+        try {
+            action.status = 'executing';
+            const result = await executor();
+            action.status = 'completed';
+            action.result = result;
+            this.currentLoop.action = action;
+            await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+                partition: 'ooda_cycles'
+            });
+            this.emit('ooda:action-completed', { cycle: this.currentLoop, action });
+        }
+        catch (error) {
+            action.status = 'failed';
+            action.result = { error: error instanceof Error ? error.message : String(error) };
+            this.currentLoop.action = action;
+            await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+                partition: 'ooda_cycles'
+            });
+            this.emit('ooda:action-failed', { cycle: this.currentLoop, action, error });
+        }
+        return action;
+    }
+    /**
+     * Complete current OODA cycle
+     */
+    async completeCycle() {
+        if (!this.currentLoop) {
+            throw new Error('No active OODA cycle');
+        }
+        this.currentLoop.endTime = Date.now();
+        this.currentLoop.duration = this.currentLoop.endTime - this.currentLoop.startTime;
+        await this.memory.store(`ooda:cycle:${this.currentLoop.id}`, this.currentLoop, {
+            partition: 'ooda_cycles'
+        });
+        this.emit('ooda:cycle-completed', this.currentLoop);
+        const completedLoop = this.currentLoop;
+        this.currentLoop = null;
+        return completedLoop;
+    }
+    /**
+     * Get current active cycle
+     */
+    getCurrentCycle() {
+        return this.currentLoop ? { ...this.currentLoop } : null;
+    }
+    /**
+     * Get cycle history
+     */
+    async getCycleHistory(limit = 10) {
+        const cycles = await this.memory.query('ooda:cycle:%', {
+            partition: 'ooda_cycles'
+        });
+        return cycles
+            .map(entry => entry.value)
+            .sort((a, b) => b.startTime - a.startTime)
+            .slice(0, limit);
+    }
+    /**
+     * Get average cycle time
+     */
+    async getAverageCycleTime() {
+        const cycles = await this.getCycleHistory(100);
+        const completedCycles = cycles.filter(c => c.duration !== undefined);
+        if (completedCycles.length === 0) {
+            return 0;
+        }
+        const totalDuration = completedCycles.reduce((sum, c) => sum + (c.duration || 0), 0);
+        return totalDuration / completedCycles.length;
+    }
+}
+exports.OODACoordination = OODACoordination;
+//# sourceMappingURL=OODACoordination.js.map

package/dist/core/coordination/OODACoordination.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Coordination Patterns for Agentic QE Fleet
+ *
+ * This module provides coordination patterns for distributed agent swarms:
+ *
+ * 1. **Blackboard Pattern** - Asynchronous information sharing via hints
+ * 2. **Consensus Gating** - Quorum-based decision making
+ * 3. **GOAP (Goal-Oriented Action Planning)** - A* pathfinding for task sequences
+ * 4. **OODA Loop** - Observe-Orient-Decide-Act for rapid adaptation
+ */
+export { BlackboardCoordination } from './BlackboardCoordination';
+export { ConsensusGating } from './ConsensusGating';
+export { GOAPCoordination } from './GOAPCoordination';
+export { OODACoordination } from './OODACoordination';
+export type { BlackboardHint } from './BlackboardCoordination';
+export type { ConsensusProposal, ConsensusState } from './ConsensusGating';
+export type { WorldState, Goal, Action, Plan } from './GOAPCoordination';
+export type { Observation, Orientation, Decision, Action as OODAAction, OODALoop } from './OODACoordination';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/coordination/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/coordination/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Coordination Patterns for Agentic QE Fleet
+ *
+ * This module provides coordination patterns for distributed agent swarms:
+ *
+ * 1. **Blackboard Pattern** - Asynchronous information sharing via hints
+ * 2. **Consensus Gating** - Quorum-based decision making
+ * 3. **GOAP (Goal-Oriented Action Planning)** - A* pathfinding for task sequences
+ * 4. **OODA Loop** - Observe-Orient-Decide-Act for rapid adaptation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OODACoordination = exports.GOAPCoordination = exports.ConsensusGating = exports.BlackboardCoordination = void 0;
+var BlackboardCoordination_1 = require("./BlackboardCoordination");
+Object.defineProperty(exports, "BlackboardCoordination", { enumerable: true, get: function () { return BlackboardCoordination_1.BlackboardCoordination; } });
+var ConsensusGating_1 = require("./ConsensusGating");
+Object.defineProperty(exports, "ConsensusGating", { enumerable: true, get: function () { return ConsensusGating_1.ConsensusGating; } });
+var GOAPCoordination_1 = require("./GOAPCoordination");
+Object.defineProperty(exports, "GOAPCoordination", { enumerable: true, get: function () { return GOAPCoordination_1.GOAPCoordination; } });
+var OODACoordination_1 = require("./OODACoordination");
+Object.defineProperty(exports, "OODACoordination", { enumerable: true, get: function () { return OODACoordination_1.OODACoordination; } });
+//# sourceMappingURL=index.js.map

package/dist/core/coordination/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/coordination/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAC/B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/core/events/QEEventBus.d.ts

@@ -0,0 +1,62 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+import { EventHandler } from './types';
+/**
+ * QE Event Bus for real-time agent coordination
+ *
+ * Provides event-driven communication between agents with optional
+ * persistence to SwarmMemoryManager for event history and auditing.
+ */
+export declare class QEEventBus extends EventEmitter {
+    private memory?;
+    private isActive;
+    constructor(memory?: SwarmMemoryManager);
+    /**
+     * Subscribe to an event type
+     * @param event Event name to subscribe to
+     * @param handler Handler function to call when event is emitted
+     */
+    subscribe<T = any>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Unsubscribe from an event type
+     * @param event Event name to unsubscribe from
+     * @param handler Handler function to remove
+     */
+    unsubscribe<T = any>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Emit an event to all subscribers and optionally persist to memory
+     * @param event Event name to emit
+     * @param data Event data payload
+     */
+    emitAsync(event: string, data: any): Promise<boolean>;
+    /**
+     * Emit an event once - will be automatically unsubscribed after first call
+     * @param event Event name to subscribe to
+     * @param handler Handler function
+     */
+    subscribeOnce<T = any>(event: string, handler: EventHandler<T>): this;
+    /**
+     * Get all event names currently being listened to
+     */
+    getEventNames(): (string | symbol)[];
+    /**
+     * Get listener count for a specific event
+     * @param event Event name
+     */
+    getListenerCount(event: string): number;
+    /**
+     * Remove all listeners for a specific event or all events
+     * @param event Optional event name - if not provided, removes all listeners
+     */
+    removeAllListeners(event?: string): this;
+    /**
+     * Shutdown the event bus and stop emitting events
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if event bus is active
+     */
+    isEventBusActive(): boolean;
+}
+//# sourceMappingURL=QEEventBus.d.ts.map

package/dist/core/events/QEEventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QEEventBus.d.ts","sourceRoot":"","sources":["../../../src/core/events/QEEventBus.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAiB;gBAErB,MAAM,CAAC,EAAE,kBAAkB;IAMvC;;;;OAIG;IACH,SAAS,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjE;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAInE;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IA8B3D;;;;OAIG;IACH,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAKrE;;OAEG;IACH,aAAa,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAIpC;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC;;;OAGG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACH,gBAAgB,IAAI,OAAO;CAG5B"}

package/dist/core/events/QEEventBus.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QEEventBus = void 0;
+const events_1 = require("events");
+/**
+ * QE Event Bus for real-time agent coordination
+ *
+ * Provides event-driven communication between agents with optional
+ * persistence to SwarmMemoryManager for event history and auditing.
+ */
+class QEEventBus extends events_1.EventEmitter {
+    constructor(memory) {
+        super();
+        this.isActive = true;
+        this.memory = memory;
+        this.setMaxListeners(100); // Allow many subscribers
+    }
+    /**
+     * Subscribe to an event type
+     * @param event Event name to subscribe to
+     * @param handler Handler function to call when event is emitted
+     */
+    subscribe(event, handler) {
+        this.on(event, handler);
+    }
+    /**
+     * Unsubscribe from an event type
+     * @param event Event name to unsubscribe from
+     * @param handler Handler function to remove
+     */
+    unsubscribe(event, handler) {
+        this.off(event, handler);
+    }
+    /**
+     * Emit an event to all subscribers and optionally persist to memory
+     * @param event Event name to emit
+     * @param data Event data payload
+     */
+    async emitAsync(event, data) {
+        if (!this.isActive) {
+            return false;
+        }
+        // Add timestamp if not present
+        const eventData = {
+            ...data,
+            timestamp: data.timestamp || Date.now()
+        };
+        // Emit to all synchronous listeners
+        const hasListeners = super.emit(event, eventData);
+        // Persist to memory if available
+        if (this.memory) {
+            try {
+                await this.memory.store(`events:${event}:${Date.now()}`, eventData, {
+                    partition: 'events',
+                    ttl: 2592000 // 30 days in seconds
+                });
+            }
+            catch (error) {
+                // Log error but don't fail the emit
+                console.error(`Failed to persist event ${event} to memory:`, error);
+            }
+        }
+        return hasListeners;
+    }
+    /**
+     * Emit an event once - will be automatically unsubscribed after first call
+     * @param event Event name to subscribe to
+     * @param handler Handler function
+     */
+    subscribeOnce(event, handler) {
+        super.once(event, handler);
+        return this;
+    }
+    /**
+     * Get all event names currently being listened to
+     */
+    getEventNames() {
+        return this.eventNames();
+    }
+    /**
+     * Get listener count for a specific event
+     * @param event Event name
+     */
+    getListenerCount(event) {
+        return this.listenerCount(event);
+    }
+    /**
+     * Remove all listeners for a specific event or all events
+     * @param event Optional event name - if not provided, removes all listeners
+     */
+    removeAllListeners(event) {
+        return super.removeAllListeners(event);
+    }
+    /**
+     * Shutdown the event bus and stop emitting events
+     */
+    async shutdown() {
+        this.isActive = false;
+        this.removeAllListeners();
+    }
+    /**
+     * Check if event bus is active
+     */
+    isEventBusActive() {
+        return this.isActive;
+    }
+}
+exports.QEEventBus = QEEventBus;
+//# sourceMappingURL=QEEventBus.js.map

package/dist/core/events/QEEventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QEEventBus.js","sourceRoot":"","sources":["../../../src/core/events/QEEventBus.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAItC;;;;;GAKG;AACH,MAAa,UAAW,SAAQ,qBAAY;IAI1C,YAAY,MAA2B;QACrC,KAAK,EAAE,CAAC;QAHF,aAAQ,GAAY,IAAI,CAAC;QAI/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,yBAAyB;IACtD,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAU,KAAa,EAAE,OAAwB;QACxD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAU,KAAa,EAAE,OAAwB;QAC1D,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,IAAS;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,+BAA+B;QAC/B,MAAM,SAAS,GAAG;YAChB,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SACxC,CAAC;QAEF,oCAAoC;QACpC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAElD,iCAAiC;QACjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE;oBAClE,SAAS,EAAE,QAAQ;oBACnB,GAAG,EAAE,OAAO,CAAC,qBAAqB;iBACnC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,oCAAoC;gBACpC,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,aAAa,EAAE,KAAK,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAU,KAAa,EAAE,OAAwB;QAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,KAAc;QAC/B,OAAO,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AA9GD,gCA8GC"}

package/dist/core/events/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * EventBus module for AQE Fleet
+ * Provides real-time event-driven coordination between agents
+ */
+export { QEEventBus } from './QEEventBus';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,cAAc,SAAS,CAAC"}

package/dist/core/events/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * EventBus module for AQE Fleet
+ * Provides real-time event-driven coordination between agents
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QEEventBus = void 0;
+var QEEventBus_1 = require("./QEEventBus");
+Object.defineProperty(exports, "QEEventBus", { enumerable: true, get: function () { return QEEventBus_1.QEEventBus; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,0CAAwB"}

package/dist/core/events/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Event types for the QE Event Bus
+ */
+export interface BaseEvent {
+    timestamp: number;
+}
+export interface AgentEvent extends BaseEvent {
+    agentId: string;
+}
+export interface AgentSpawnedEvent extends AgentEvent {
+    type: string;
+    capabilities?: string[];
+}
+export interface AgentReadyEvent extends AgentEvent {
+    status: 'ready';
+}
+export interface AgentCompletedEvent extends AgentEvent {
+    result: 'success' | 'failure' | 'cancelled';
+    duration: number;
+    output?: any;
+}
+export interface AgentErrorEvent extends AgentEvent {
+    error: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    stack?: string;
+}
+export interface TestEvent extends BaseEvent {
+    testId: string;
+}
+export interface TestStartedEvent extends TestEvent {
+    suite: string;
+    testCount?: number;
+}
+export interface TestProgressEvent extends TestEvent {
+    completed: number;
+    total: number;
+    currentTest?: string;
+}
+export interface TestCompletedEvent extends TestEvent {
+    passed: number;
+    failed: number;
+    skipped?: number;
+    duration: number;
+    coverage?: number;
+}
+export interface QualityGateEvent extends BaseEvent {
+    gateId: string;
+    status: 'passed' | 'failed' | 'warning';
+    metrics: Record<string, number>;
+}
+export interface CoverageEvent extends BaseEvent {
+    moduleId: string;
+    coverage: number;
+    gaps: string[];
+}
+/**
+ * Event type mapping
+ */
+export type EventTypeMap = {
+    'agent:spawned': AgentSpawnedEvent;
+    'agent:ready': AgentReadyEvent;
+    'agent:completed': AgentCompletedEvent;
+    'agent:error': AgentErrorEvent;
+    'test:started': TestStartedEvent;
+    'test:progress': TestProgressEvent;
+    'test:completed': TestCompletedEvent;
+    'quality:gate': QualityGateEvent;
+    'coverage:analyzed': CoverageEvent;
+};
+export type EventType = keyof EventTypeMap;
+export type EventHandler<T = any> = (data: T) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/events/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,EAAE,iBAAiB,CAAC;IACnC,aAAa,EAAE,eAAe,CAAC;IAC/B,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,aAAa,EAAE,eAAe,CAAC;IAC/B,cAAc,EAAE,gBAAgB,CAAC;IACjC,eAAe,EAAE,iBAAiB,CAAC;IACnC,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,cAAc,EAAE,gBAAgB,CAAC;IACjC,mBAAmB,EAAE,aAAa,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC;AAC3C,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/core/events/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event types for the QE Event Bus
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/events/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}