@agentic-qe/v3 3.0.0-alpha.3

package/dist/coordination/claims/work-stealing.js

@@ -0,0 +1,335 @@
+/**
+ * Agentic QE v3 - Work Stealing Coordinator
+ * Enables idle agents to steal stale claims for load balancing
+ *
+ * Work stealing algorithm:
+ * 1. Identify idle agents (no claims, idle > threshold)
+ * 2. Find stale claims (claimed but inactive > threshold)
+ * 3. Match idle agents to stealable claims by domain/capability
+ * 4. Execute steal with proper handoff semantics
+ */
+import { v4 as uuidv4 } from 'uuid';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_WORK_STEALING_CONFIG = {
+    enabled: true,
+    idleThresholdMs: 30000, // 30 seconds
+    stealBatchSize: 5,
+    checkIntervalMs: 30000, // Check every 30 seconds
+    prioritizeByPriority: true,
+    allowCrossDomain: false,
+};
+// ============================================================================
+// Work Stealing Coordinator Implementation
+// ============================================================================
+export class WorkStealingCoordinator {
+    claimService;
+    repository;
+    eventBus;
+    config;
+    agentActivity = new Map();
+    checkTimer = null;
+    initialized = false;
+    constructor(claimService, repository, eventBus, config = {}) {
+        this.claimService = claimService;
+        this.repository = repository;
+        this.eventBus = eventBus;
+        this.config = { ...DEFAULT_WORK_STEALING_CONFIG, ...config };
+    }
+    // ============================================================================
+    // Lifecycle
+    // ============================================================================
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.config.enabled) {
+            this.checkTimer = setInterval(() => this.checkAndSteal().catch(console.error), this.config.checkIntervalMs);
+        }
+        this.initialized = true;
+    }
+    async dispose() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+        this.agentActivity.clear();
+        this.initialized = false;
+    }
+    // ============================================================================
+    // Work Stealing Logic
+    // ============================================================================
+    async checkAndSteal() {
+        // Note: enabled only controls the automatic timer, manual calls always work
+        const idleAgents = this.getIdleAgents();
+        if (idleAgents.length === 0)
+            return 0;
+        let totalStolen = 0;
+        for (const agent of idleAgents) {
+            // Check batch limit per round
+            if (totalStolen >= this.config.stealBatchSize)
+                break;
+            const stealableClaims = await this.getStealableClaims(agent);
+            if (stealableClaims.length === 0)
+                continue;
+            // Steal the best matching claim
+            const claim = stealableClaims[0];
+            try {
+                const stealInput = {
+                    claimId: claim.id,
+                    newClaimant: agent,
+                    reason: 'stale',
+                };
+                await this.claimService.steal(stealInput);
+                totalStolen++;
+                // Update agent activity
+                this.recordActivity(agent.id, claim.id);
+                // Emit event
+                await this.emitStealEvent(claim, agent);
+            }
+            catch (error) {
+                console.error(`Failed to steal claim ${claim.id} for agent ${agent.id}:`, error);
+            }
+        }
+        return totalStolen;
+    }
+    async getStealableClaims(idleAgent) {
+        // Find stale claims
+        const staleClaims = await this.repository.findStale(this.config.idleThresholdMs);
+        // Filter by agent compatibility
+        const compatible = staleClaims.filter(claim => {
+            // Must be in claimed status
+            if (claim.status !== 'claimed' && claim.status !== 'in-progress') {
+                return false;
+            }
+            // Don't steal from same agent
+            if (claim.claimant?.id === idleAgent.id) {
+                return false;
+            }
+            // Check domain compatibility
+            if (!this.config.allowCrossDomain && idleAgent.domain) {
+                if (claim.domain !== idleAgent.domain) {
+                    return false;
+                }
+            }
+            // Check steal count limit
+            // (handled in claim service, but good to filter early)
+            return true;
+        });
+        // Sort by priority if configured
+        if (this.config.prioritizeByPriority) {
+            const priorityOrder = { p0: 0, p1: 1, p2: 2, p3: 3 };
+            compatible.sort((a, b) => {
+                const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+                if (priorityDiff !== 0)
+                    return priorityDiff;
+                // Then by staleness (oldest update first)
+                return a.updatedAt.getTime() - b.updatedAt.getTime();
+            });
+        }
+        else {
+            // Sort by staleness only
+            compatible.sort((a, b) => a.updatedAt.getTime() - b.updatedAt.getTime());
+        }
+        return compatible;
+    }
+    // ============================================================================
+    // Agent Activity Tracking
+    // ============================================================================
+    recordActivity(agentId, claimId) {
+        const existing = this.agentActivity.get(agentId);
+        if (existing) {
+            this.agentActivity.set(agentId, {
+                ...existing,
+                lastActivityAt: new Date(),
+                currentClaimId: claimId ?? existing.currentClaimId,
+            });
+        }
+    }
+    /**
+     * Register an agent for activity tracking
+     */
+    registerAgent(claimant) {
+        this.agentActivity.set(claimant.id, {
+            agentId: claimant.id,
+            claimant,
+            lastActivityAt: new Date(),
+        });
+    }
+    /**
+     * Unregister an agent from activity tracking
+     */
+    unregisterAgent(agentId) {
+        this.agentActivity.delete(agentId);
+    }
+    getIdleAgents() {
+        const now = Date.now();
+        const threshold = this.config.idleThresholdMs;
+        const idleAgents = [];
+        for (const activity of this.agentActivity.values()) {
+            const idleTime = now - activity.lastActivityAt.getTime();
+            if (idleTime >= threshold && !activity.currentClaimId) {
+                idleAgents.push(activity.claimant);
+            }
+        }
+        return idleAgents;
+    }
+    getBusyAgents() {
+        const now = Date.now();
+        const threshold = this.config.idleThresholdMs;
+        const busyAgents = [];
+        for (const activity of this.agentActivity.values()) {
+            const idleTime = now - activity.lastActivityAt.getTime();
+            if (idleTime < threshold || activity.currentClaimId) {
+                busyAgents.push(activity.claimant);
+            }
+        }
+        return busyAgents;
+    }
+    /**
+     * Mark an agent as having completed their current claim
+     */
+    markClaimCompleted(agentId) {
+        const existing = this.agentActivity.get(agentId);
+        if (existing) {
+            this.agentActivity.set(agentId, {
+                ...existing,
+                lastActivityAt: new Date(),
+                currentClaimId: undefined,
+            });
+        }
+    }
+    /**
+     * Get all tracked agents
+     */
+    getTrackedAgents() {
+        return Array.from(this.agentActivity.values());
+    }
+    /**
+     * Set activity time for an agent (for testing purposes)
+     */
+    setAgentActivityTime(agentId, time) {
+        const existing = this.agentActivity.get(agentId);
+        if (existing) {
+            this.agentActivity.set(agentId, {
+                ...existing,
+                lastActivityAt: time,
+            });
+        }
+    }
+    // ============================================================================
+    // Configuration
+    // ============================================================================
+    /**
+     * Enable work stealing
+     */
+    enable() {
+        if (!this.checkTimer) {
+            this.checkTimer = setInterval(() => this.checkAndSteal().catch(console.error), this.config.checkIntervalMs);
+        }
+    }
+    /**
+     * Disable work stealing
+     */
+    disable() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    }
+    /**
+     * Check if work stealing is enabled
+     */
+    isEnabled() {
+        return this.checkTimer !== null;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        Object.assign(this.config, config);
+        // Restart timer if interval changed
+        if (config.checkIntervalMs && this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = setInterval(() => this.checkAndSteal().catch(console.error), this.config.checkIntervalMs);
+        }
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    async emitStealEvent(claim, newClaimant) {
+        if (!this.eventBus)
+            return;
+        const event = {
+            id: uuidv4(),
+            type: 'ClaimsWorkStealingOccurred',
+            timestamp: new Date(),
+            source: claim.domain,
+            correlationId: claim.correlationId,
+            payload: {
+                claimId: claim.id,
+                previousClaimant: claim.claimant,
+                newClaimant,
+                staleDuration: Date.now() - claim.updatedAt.getTime(),
+                stealCount: claim.stealCount + 1,
+            },
+        };
+        await this.eventBus.publish(event);
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a work stealing coordinator
+ */
+export function createWorkStealingCoordinator(claimService, repository, eventBus, config) {
+    return new WorkStealingCoordinator(claimService, repository, eventBus, config);
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Check if an agent can work on a specific claim type
+ */
+export function canAgentHandleClaimType(agentType, claimType) {
+    if (!agentType)
+        return true; // Allow if no type specified
+    const typeMapping = {
+        'coverage-gap': ['generator', 'tester', 'analyzer'],
+        'flaky-test': ['tester', 'analyzer', 'validator'],
+        'defect-investigation': ['analyzer', 'validator', 'specialist'],
+        'test-review': ['reviewer', 'validator', 'coordinator'],
+    };
+    const allowedTypes = typeMapping[claimType];
+    return allowedTypes.includes(agentType);
+}
+/**
+ * Calculate priority score for work stealing
+ * Higher score = higher priority to steal
+ */
+export function calculateStealPriority(claim) {
+    let score = 0;
+    // Priority weight (p0 = 100, p1 = 75, p2 = 50, p3 = 25)
+    const priorityScores = { p0: 100, p1: 75, p2: 50, p3: 25 };
+    score += priorityScores[claim.priority];
+    // Staleness weight (older = higher priority)
+    const staleness = Date.now() - claim.updatedAt.getTime();
+    score += Math.min(staleness / 60000, 50); // Max 50 points for staleness
+    // Deadline weight (closer deadline = higher priority)
+    if (claim.deadline) {
+        const timeToDeadline = claim.deadline.getTime() - Date.now();
+        if (timeToDeadline < 3600000) {
+            // Less than 1 hour
+            score += 50;
+        }
+        else if (timeToDeadline < 86400000) {
+            // Less than 1 day
+            score += 25;
+        }
+    }
+    // Steal count penalty (already stolen multiple times)
+    score -= claim.stealCount * 10;
+    return score;
+}
+//# sourceMappingURL=work-stealing.js.map

package/dist/coordination/claims/work-stealing.js.map

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

package/dist/coordination/cross-domain-router.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Agentic QE v3 - Cross-Domain Event Router
+ * Routes events between all 12 domains, tracks correlations, and provides aggregation
+ */
+import { DomainName, DomainEvent } from '../shared/types';
+import { EventBus } from '../kernel/interfaces';
+import { CrossDomainRouter, EventCorrelation, EventAggregation, DomainRoute } from './interfaces';
+export declare class CrossDomainEventRouter implements CrossDomainRouter {
+    private readonly eventBus;
+    private readonly subscriptions;
+    private readonly correlations;
+    private readonly eventHistory;
+    private readonly routes;
+    private readonly domainSubscriptions;
+    private readonly maxHistorySize;
+    private readonly correlationTimeout;
+    private readonly maxEventsPerCorrelation;
+    private initialized;
+    constructor(eventBus: EventBus, options?: {
+        maxHistorySize?: number;
+        correlationTimeout?: number;
+        maxEventsPerCorrelation?: number;
+    });
+    /**
+     * Initialize the router by subscribing to all domains
+     */
+    initialize(): Promise<void>;
+    /**
+     * Subscribe to events from a specific domain
+     */
+    subscribeToDoamin(domain: DomainName, handler: (event: DomainEvent) => Promise<void>): string;
+    /**
+     * Subscribe to specific event types
+     */
+    subscribeToEventType(eventType: string, handler: (event: DomainEvent) => Promise<void>): string;
+    /**
+     * Unsubscribe from events
+     */
+    unsubscribe(subscriptionId: string): boolean;
+    /**
+     * Route an event to appropriate handlers
+     */
+    route(event: DomainEvent): Promise<void>;
+    /**
+     * Get correlation by ID
+     */
+    getCorrelation(correlationId: string): EventCorrelation | undefined;
+    /**
+     * Track event for correlation
+     */
+    trackCorrelation(event: DomainEvent): void;
+    /**
+     * Get aggregated events for a time window
+     */
+    aggregate(windowStart: Date, windowEnd: Date): EventAggregation;
+    /**
+     * Get event history with optional filtering
+     */
+    getHistory(filter?: {
+        eventTypes?: string[];
+        domains?: DomainName[];
+        fromTimestamp?: Date;
+        toTimestamp?: Date;
+        limit?: number;
+    }): DomainEvent[];
+    /**
+     * Add a route for event forwarding
+     */
+    addRoute(route: DomainRoute): void;
+    /**
+     * Remove a route
+     */
+    removeRoute(eventPattern: string, source?: DomainName): boolean;
+    /**
+     * Dispose resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Handle incoming events from the event bus
+     */
+    private handleIncomingEvent;
+    /**
+     * Find subscriptions matching an event
+     */
+    private findMatchingSubscriptions;
+    /**
+     * Match event type against pattern (supports wildcards)
+     */
+    private matchEventType;
+    /**
+     * Apply routes to forward events
+     */
+    private applyRoutes;
+    /**
+     * Add event to history
+     */
+    private addToHistory;
+}
+export declare function createCrossDomainRouter(eventBus: EventBus, options?: {
+    maxHistorySize?: number;
+    correlationTimeout?: number;
+    maxEventsPerCorrelation?: number;
+}): CrossDomainRouter;
+//# sourceMappingURL=cross-domain-router.d.ts.map

package/dist/coordination/cross-domain-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-domain-router.d.ts","sourceRoot":"","sources":["../../src/coordination/cross-domain-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACZ,MAAM,cAAc,CAAC;AA4BtB,qBAAa,sBAAuB,YAAW,iBAAiB;IAa5D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZ3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuC;IAE3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,WAAW,CAAS;gBAGT,QAAQ,EAAE,QAAQ,EACnC,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC;IAOH;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;OAEG;IACH,iBAAiB,CACf,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,MAAM;IAYT;;OAEG;IACH,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7C,MAAM;IAYT;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAU5C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9C;;OAEG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAgBnE;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAuC1C;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,gBAAgB;IAwC/D;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,IAAI,CAAC;QACrB,WAAW,CAAC,EAAE,IAAI,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,WAAW,EAAE;IAwBjB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWlC;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO;IAa/D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B;;OAEG;YACW,mBAAmB;IAIjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;YACW,WAAW;IAwCzB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB;AAMD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GACA,iBAAiB,CAEnB"}