agentic-qe 3.3.1 → 3.3.3

package/v3/dist/coordination/mixins/mincut-aware-domain.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Agentic QE v3 - MinCut-Aware Domain Mixin
+ * ADR-047: MinCut Self-Organizing QE Integration
+ *
+ * Provides a reusable mixin that allows any domain coordinator to become
+ * MinCut-aware, enabling topology-based routing and health monitoring.
+ *
+ * This mixin implements the IMinCutAwareDomain interface and can be applied
+ * to any domain coordinator class via the factory function.
+ */
+import { DomainName } from '../../shared/types';
+import { MinCutHealth, WeakVertex } from '../mincut/interfaces';
+import { QueenMinCutBridge } from '../mincut/queen-integration';
+/**
+ * Interface for MinCut-aware domain capabilities
+ */
+export interface IMinCutAwareDomain {
+    /**
+     * Set the MinCut bridge for topology awareness
+     * Uses dependency injection pattern for testability
+     */
+    setMinCutBridge(bridge: QueenMinCutBridge): void;
+    /**
+     * Check if the overall topology is healthy
+     * Returns true if status is not 'critical'
+     */
+    isTopologyHealthy(): boolean;
+    /**
+     * Get weak vertices that belong to this domain
+     * Filters the global weak vertices by domain name
+     */
+    getDomainWeakVertices(): WeakVertex[];
+    /**
+     * Check if this domain itself is a weak point in the topology
+     * Returns true if any weak vertex belongs to this domain
+     */
+    isDomainWeakPoint(): boolean;
+    /**
+     * Get routing candidates excluding weak domains
+     * Filters out domains that are currently weak points
+     * @param targetDomains - List of potential target domains
+     * @returns Filtered list of healthy domains for routing
+     */
+    getTopologyBasedRouting(targetDomains: DomainName[]): DomainName[];
+    /**
+     * Subscribe to topology health changes
+     * @param callback - Function called when health status changes
+     * @returns Unsubscribe function
+     */
+    onTopologyHealthChange(callback: (health: MinCutHealth) => void): () => void;
+}
+/**
+ * Configuration for MinCut-aware domain behavior
+ */
+export interface MinCutAwareConfig {
+    /**
+     * Whether MinCut awareness is enabled
+     * When false, the mixin operates in pass-through mode
+     */
+    enableMinCutAwareness: boolean;
+    /**
+     * Threshold (0-1) for considering topology healthy
+     * Based on normalized MinCut value relative to healthy threshold
+     */
+    topologyHealthThreshold: number;
+    /**
+     * Whether to pause domain operations when topology is critical
+     */
+    pauseOnCriticalTopology: boolean;
+    /**
+     * List of domains this coordinator monitors for health
+     * Empty array means monitor all domains
+     */
+    monitoredDomains: DomainName[];
+}
+/**
+ * Default configuration for MinCut-aware domains
+ */
+export declare const DEFAULT_MINCUT_AWARE_CONFIG: MinCutAwareConfig;
+/**
+ * Mixin class that adds MinCut awareness to any domain coordinator
+ *
+ * Usage:
+ * ```typescript
+ * class MyDomainCoordinator {
+ *   private readonly minCutMixin: MinCutAwareDomainMixin;
+ *
+ *   constructor(domainName: DomainName) {
+ *     this.minCutMixin = createMinCutAwareMixin(domainName);
+ *   }
+ *
+ *   isTopologyHealthy() {
+ *     return this.minCutMixin.isTopologyHealthy();
+ *   }
+ * }
+ * ```
+ */
+export declare class MinCutAwareDomainMixin implements IMinCutAwareDomain {
+    private bridge;
+    private readonly config;
+    private readonly domainName;
+    private healthListeners;
+    private lastHealthStatus;
+    private healthCheckInterval;
+    constructor(domainName: DomainName, config?: Partial<MinCutAwareConfig>);
+    /**
+     * Set the MinCut bridge via dependency injection
+     */
+    setMinCutBridge(bridge: QueenMinCutBridge): void;
+    /**
+     * Get the current MinCut bridge
+     */
+    getMinCutBridge(): QueenMinCutBridge | null;
+    /**
+     * Check if a MinCut bridge is connected
+     */
+    hasBridge(): boolean;
+    /**
+     * Get the domain name this mixin is associated with
+     */
+    getDomainName(): DomainName;
+    /**
+     * Get current configuration
+     */
+    getConfig(): MinCutAwareConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<MinCutAwareConfig>): void;
+    /**
+     * Dispose the mixin and clean up resources
+     */
+    dispose(): void;
+    /**
+     * Check if topology is healthy
+     * Returns true if MinCut awareness is disabled or status is not 'critical'
+     */
+    isTopologyHealthy(): boolean;
+    /**
+     * Get weak vertices belonging to this domain
+     */
+    getDomainWeakVertices(): WeakVertex[];
+    /**
+     * Check if this domain is a weak point in the topology
+     */
+    isDomainWeakPoint(): boolean;
+    /**
+     * Get topology-based routing excluding weak domains
+     */
+    getTopologyBasedRouting(targetDomains: DomainName[]): DomainName[];
+    /**
+     * Subscribe to topology health changes
+     * @throws Error if max listeners limit is reached
+     */
+    onTopologyHealthChange(callback: (health: MinCutHealth) => void): () => void;
+    /**
+     * Get the current MinCut health snapshot
+     */
+    getCurrentHealth(): MinCutHealth | null;
+    /**
+     * Get the current MinCut value
+     */
+    getMinCutValue(): number | null;
+    /**
+     * Check if operations should be paused due to critical topology
+     */
+    shouldPauseOperations(): boolean;
+    /**
+     * Get domains that are healthy for routing
+     * Convenience method that considers monitored domains
+     */
+    getHealthyRoutingDomains(): DomainName[];
+    /**
+     * Get normalized health score (0-1)
+     * Based on MinCut value relative to healthy threshold
+     */
+    getNormalizedHealthScore(): number;
+    /**
+     * Check if health score meets threshold
+     */
+    meetsHealthThreshold(): boolean;
+    /**
+     * Start monitoring health changes
+     */
+    private startHealthMonitoring;
+    /**
+     * Stop monitoring health changes
+     */
+    private stopHealthMonitoring;
+    /**
+     * Check health and notify listeners if status changed
+     */
+    private checkAndNotifyHealthChange;
+    /**
+     * Get all domain names
+     */
+    private getAllDomains;
+}
+/**
+ * Create a MinCut-aware domain mixin instance
+ *
+ * @param domainName - The domain this mixin is associated with
+ * @param config - Optional configuration overrides
+ * @returns MinCutAwareDomainMixin instance
+ *
+ * @example
+ * ```typescript
+ * const mixin = createMinCutAwareMixin('test-generation', {
+ *   pauseOnCriticalTopology: true,
+ *   topologyHealthThreshold: 0.8,
+ * });
+ *
+ * // Later, inject the bridge
+ * mixin.setMinCutBridge(queenMinCutBridge);
+ *
+ * // Use the mixin
+ * if (mixin.isTopologyHealthy()) {
+ *   // Proceed with normal operations
+ * }
+ * ```
+ */
+export declare function createMinCutAwareMixin(domainName: DomainName, config?: Partial<MinCutAwareConfig>): MinCutAwareDomainMixin;
+/**
+ * Check if an object implements IMinCutAwareDomain
+ */
+export declare function isMinCutAwareDomain(obj: unknown): obj is IMinCutAwareDomain;
+//# sourceMappingURL=mincut-aware-domain.d.ts.map

package/v3/dist/coordination/mixins/mincut-aware-domain.d.ts.map

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

package/v3/dist/coordination/mixins/mincut-aware-domain.js

@@ -0,0 +1,368 @@
+/**
+ * Agentic QE v3 - MinCut-Aware Domain Mixin
+ * ADR-047: MinCut Self-Organizing QE Integration
+ *
+ * Provides a reusable mixin that allows any domain coordinator to become
+ * MinCut-aware, enabling topology-based routing and health monitoring.
+ *
+ * This mixin implements the IMinCutAwareDomain interface and can be applied
+ * to any domain coordinator class via the factory function.
+ */
+/**
+ * Default configuration for MinCut-aware domains
+ */
+export const DEFAULT_MINCUT_AWARE_CONFIG = {
+    enableMinCutAwareness: true,
+    topologyHealthThreshold: 0.7,
+    pauseOnCriticalTopology: false,
+    monitoredDomains: [],
+};
+/** Maximum number of health listeners to prevent memory leaks */
+const MAX_HEALTH_LISTENERS = 100;
+// ============================================================================
+// MinCut-Aware Domain Mixin
+// ============================================================================
+/**
+ * Mixin class that adds MinCut awareness to any domain coordinator
+ *
+ * Usage:
+ * ```typescript
+ * class MyDomainCoordinator {
+ *   private readonly minCutMixin: MinCutAwareDomainMixin;
+ *
+ *   constructor(domainName: DomainName) {
+ *     this.minCutMixin = createMinCutAwareMixin(domainName);
+ *   }
+ *
+ *   isTopologyHealthy() {
+ *     return this.minCutMixin.isTopologyHealthy();
+ *   }
+ * }
+ * ```
+ */
+export class MinCutAwareDomainMixin {
+    bridge = null;
+    config;
+    domainName;
+    healthListeners = new Set();
+    lastHealthStatus = null;
+    healthCheckInterval = null;
+    constructor(domainName, config = {}) {
+        this.domainName = domainName;
+        this.config = { ...DEFAULT_MINCUT_AWARE_CONFIG, ...config };
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    /**
+     * Set the MinCut bridge via dependency injection
+     */
+    setMinCutBridge(bridge) {
+        if (this.bridge) {
+            this.stopHealthMonitoring();
+        }
+        this.bridge = bridge;
+        if (this.config.enableMinCutAwareness && this.healthListeners.size > 0) {
+            this.startHealthMonitoring();
+        }
+    }
+    /**
+     * Get the current MinCut bridge
+     */
+    getMinCutBridge() {
+        return this.bridge;
+    }
+    /**
+     * Check if a MinCut bridge is connected
+     */
+    hasBridge() {
+        return this.bridge !== null;
+    }
+    /**
+     * Get the domain name this mixin is associated with
+     */
+    getDomainName() {
+        return this.domainName;
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        Object.assign(this.config, config);
+        // Restart health monitoring if awareness was toggled
+        if ('enableMinCutAwareness' in config) {
+            if (config.enableMinCutAwareness && this.bridge && this.healthListeners.size > 0) {
+                this.startHealthMonitoring();
+            }
+            else {
+                this.stopHealthMonitoring();
+            }
+        }
+    }
+    /**
+     * Dispose the mixin and clean up resources
+     */
+    dispose() {
+        this.stopHealthMonitoring();
+        this.healthListeners.clear();
+        this.bridge = null;
+        this.lastHealthStatus = null;
+    }
+    // ==========================================================================
+    // IMinCutAwareDomain Implementation
+    // ==========================================================================
+    /**
+     * Check if topology is healthy
+     * Returns true if MinCut awareness is disabled or status is not 'critical'
+     */
+    isTopologyHealthy() {
+        if (!this.config.enableMinCutAwareness || !this.bridge) {
+            return true; // Assume healthy when awareness is disabled or no bridge
+        }
+        const health = this.bridge.getMinCutHealth();
+        return health.status !== 'critical';
+    }
+    /**
+     * Get weak vertices belonging to this domain
+     */
+    getDomainWeakVertices() {
+        if (!this.bridge) {
+            return [];
+        }
+        const allWeakVertices = this.bridge.getWeakVertices();
+        return allWeakVertices.filter(vertex => vertex.vertex.domain === this.domainName);
+    }
+    /**
+     * Check if this domain is a weak point in the topology
+     */
+    isDomainWeakPoint() {
+        const domainWeakVertices = this.getDomainWeakVertices();
+        return domainWeakVertices.length > 0;
+    }
+    /**
+     * Get topology-based routing excluding weak domains
+     */
+    getTopologyBasedRouting(targetDomains) {
+        if (!this.config.enableMinCutAwareness || !this.bridge) {
+            return targetDomains; // Return all when awareness is disabled
+        }
+        const weakVertices = this.bridge.getWeakVertices();
+        // Extract domains that are weak
+        const weakDomains = new Set();
+        for (const vertex of weakVertices) {
+            if (vertex.vertex.domain) {
+                weakDomains.add(vertex.vertex.domain);
+            }
+        }
+        // Filter out weak domains from routing candidates
+        return targetDomains.filter(domain => !weakDomains.has(domain));
+    }
+    /**
+     * Subscribe to topology health changes
+     * @throws Error if max listeners limit is reached
+     */
+    onTopologyHealthChange(callback) {
+        // Prevent memory leaks from unbounded listener growth
+        if (this.healthListeners.size >= MAX_HEALTH_LISTENERS) {
+            console.error(`[MinCutAwareDomain] Max health listeners (${MAX_HEALTH_LISTENERS}) reached for ${this.domainName}. ` +
+                `Ensure listeners are properly unsubscribed.`);
+            throw new Error(`Max health listeners (${MAX_HEALTH_LISTENERS}) exceeded`);
+        }
+        this.healthListeners.add(callback);
+        // Start monitoring if this is the first listener and we have a bridge
+        if (this.healthListeners.size === 1 && this.bridge && this.config.enableMinCutAwareness) {
+            this.startHealthMonitoring();
+        }
+        // Return unsubscribe function
+        return () => {
+            this.healthListeners.delete(callback);
+            // Stop monitoring if no more listeners
+            if (this.healthListeners.size === 0) {
+                this.stopHealthMonitoring();
+            }
+        };
+    }
+    // ==========================================================================
+    // Extended Methods
+    // ==========================================================================
+    /**
+     * Get the current MinCut health snapshot
+     */
+    getCurrentHealth() {
+        if (!this.bridge) {
+            return null;
+        }
+        return this.bridge.getMinCutHealth();
+    }
+    /**
+     * Get the current MinCut value
+     */
+    getMinCutValue() {
+        if (!this.bridge) {
+            return null;
+        }
+        return this.bridge.getMinCutValue();
+    }
+    /**
+     * Check if operations should be paused due to critical topology
+     */
+    shouldPauseOperations() {
+        if (!this.config.pauseOnCriticalTopology) {
+            return false;
+        }
+        return !this.isTopologyHealthy();
+    }
+    /**
+     * Get domains that are healthy for routing
+     * Convenience method that considers monitored domains
+     */
+    getHealthyRoutingDomains() {
+        const domainsToCheck = this.config.monitoredDomains.length > 0
+            ? this.config.monitoredDomains
+            : this.getAllDomains();
+        return this.getTopologyBasedRouting(domainsToCheck);
+    }
+    /**
+     * Get normalized health score (0-1)
+     * Based on MinCut value relative to healthy threshold
+     */
+    getNormalizedHealthScore() {
+        if (!this.bridge) {
+            return 1.0; // Assume healthy when no bridge
+        }
+        const health = this.bridge.getMinCutHealth();
+        if (health.healthyThreshold <= 0) {
+            return health.minCutValue > 0 ? 1.0 : 0.0;
+        }
+        // Normalize: minCutValue / healthyThreshold, capped at 1.0
+        return Math.min(1.0, health.minCutValue / health.healthyThreshold);
+    }
+    /**
+     * Check if health score meets threshold
+     */
+    meetsHealthThreshold() {
+        return this.getNormalizedHealthScore() >= this.config.topologyHealthThreshold;
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * Start monitoring health changes
+     */
+    startHealthMonitoring() {
+        if (this.healthCheckInterval) {
+            return; // Already monitoring
+        }
+        // Check health periodically and notify listeners on change
+        this.healthCheckInterval = setInterval(() => {
+            this.checkAndNotifyHealthChange();
+        }, 5000); // Check every 5 seconds
+        // Immediate first check
+        this.checkAndNotifyHealthChange();
+    }
+    /**
+     * Stop monitoring health changes
+     */
+    stopHealthMonitoring() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = null;
+        }
+    }
+    /**
+     * Check health and notify listeners if status changed
+     */
+    checkAndNotifyHealthChange() {
+        if (!this.bridge) {
+            return;
+        }
+        const health = this.bridge.getMinCutHealth();
+        // Only notify if status changed
+        if (health.status !== this.lastHealthStatus) {
+            this.lastHealthStatus = health.status;
+            // Notify all listeners
+            for (const listener of this.healthListeners) {
+                try {
+                    listener(health);
+                }
+                catch (error) {
+                    console.error('Error in health change listener:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Get all domain names
+     */
+    getAllDomains() {
+        return [
+            'test-generation',
+            'test-execution',
+            'coverage-analysis',
+            'quality-assessment',
+            'defect-intelligence',
+            'requirements-validation',
+            'code-intelligence',
+            'security-compliance',
+            'contract-testing',
+            'visual-accessibility',
+            'chaos-resilience',
+            'learning-optimization',
+            'coordination',
+        ];
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a MinCut-aware domain mixin instance
+ *
+ * @param domainName - The domain this mixin is associated with
+ * @param config - Optional configuration overrides
+ * @returns MinCutAwareDomainMixin instance
+ *
+ * @example
+ * ```typescript
+ * const mixin = createMinCutAwareMixin('test-generation', {
+ *   pauseOnCriticalTopology: true,
+ *   topologyHealthThreshold: 0.8,
+ * });
+ *
+ * // Later, inject the bridge
+ * mixin.setMinCutBridge(queenMinCutBridge);
+ *
+ * // Use the mixin
+ * if (mixin.isTopologyHealthy()) {
+ *   // Proceed with normal operations
+ * }
+ * ```
+ */
+export function createMinCutAwareMixin(domainName, config) {
+    return new MinCutAwareDomainMixin(domainName, config);
+}
+// ============================================================================
+// Type Guard
+// ============================================================================
+/**
+ * Check if an object implements IMinCutAwareDomain
+ */
+export function isMinCutAwareDomain(obj) {
+    if (!obj || typeof obj !== 'object') {
+        return false;
+    }
+    const domain = obj;
+    return (typeof domain.setMinCutBridge === 'function' &&
+        typeof domain.isTopologyHealthy === 'function' &&
+        typeof domain.getDomainWeakVertices === 'function' &&
+        typeof domain.isDomainWeakPoint === 'function' &&
+        typeof domain.getTopologyBasedRouting === 'function' &&
+        typeof domain.onTopologyHealthChange === 'function');
+}
+//# sourceMappingURL=mincut-aware-domain.js.map

package/v3/dist/coordination/mixins/mincut-aware-domain.js.map

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

package/v3/dist/coordination/queen-coordinator.d.ts

@@ -138,6 +138,8 @@ export interface IQueenCoordinator {
     getMetrics(): QueenMetrics;
     executeProtocol(protocolId: string, params?: Record<string, unknown>): Promise<Result<string, Error>>;
     executeWorkflow(workflowId: string, params?: Record<string, unknown>): Promise<Result<string, Error>>;
+    getMinCutBridge(): QueenMinCutBridge | null;
+    injectMinCutBridgeIntoDomain(domainName: DomainName): boolean;
 }
 export interface TaskFilter {
     status?: TaskExecution['status'];
@@ -202,6 +204,14 @@ export declare class QueenCoordinator implements IQueenCoordinator {
      * ADR-047: Allows QE agents to access topology health directly
      */
     getMinCutBridge(): QueenMinCutBridge | null;
+    /**
+     * Inject MinCut bridge into a specific domain plugin
+     * ADR-047: Enables late-binding for domains registered after Queen initialization
+     *
+     * @param domainName - The domain to inject the bridge into
+     * @returns true if bridge was injected, false if domain not found or bridge unavailable
+     */
+    injectMinCutBridgeIntoDomain(domainName: DomainName): boolean;
     /**
      * Get TinyDancer router for direct routing access
      * TD-004/TD-005/TD-006: Allows QE agents to query routing decisions directly
@@ -219,6 +229,11 @@ export declare class QueenCoordinator implements IQueenCoordinator {
     private handleTaskCompleted;
     private handleTaskFailed;
     private handleAgentStatusChanged;
+    /**
+     * Handle task completion callback from domain plugin
+     * Queen-Domain Integration Fix: Direct task execution callback handler
+     */
+    private handleTaskCompletion;
     private assignTask;
     private assignTaskToDomain;
     private enqueueTask;
@@ -245,6 +260,13 @@ export declare class QueenCoordinator implements IQueenCoordinator {
 }
 /**
  * Create a Queen Coordinator from a QE Kernel
+ *
+ * @param kernel - The QE Kernel instance
+ * @param router - Cross-domain event router
+ * @param protocolExecutor - Optional protocol executor for cross-domain protocols
+ * @param workflowExecutor - Optional workflow executor
+ * @param domainPlugins - Map of domain plugins for direct task execution (Integration Fix)
+ * @param config - Optional configuration overrides
  */
-export declare function createQueenCoordinator(kernel: QEKernel, router: CrossDomainRouter, protocolExecutor?: ProtocolExecutor, workflowExecutor?: WorkflowExecutor, config?: Partial<QueenConfig>): QueenCoordinator;
+export declare function createQueenCoordinator(kernel: QEKernel, router: CrossDomainRouter, protocolExecutor?: ProtocolExecutor, workflowExecutor?: WorkflowExecutor, domainPlugins?: Map<DomainName, DomainPlugin>, config?: Partial<QueenConfig>): QueenCoordinator;
 //# sourceMappingURL=queen-coordinator.d.ts.map