agentic-qe 3.2.3 → 3.3.0

package/v3/dist/init/phases/phase-interface.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Phase Interface - Modular Init System
+ * ADR-025: Enhanced Init with Self-Configuration
+ *
+ * Defines the contract for init phases that can be composed
+ * into a pipeline for flexible initialization.
+ */
+import type { ProjectAnalysis, AQEInitConfig } from '../types.js';
+/**
+ * Result of running an init phase
+ */
+export interface PhaseResult<T = unknown> {
+    /** Whether the phase succeeded */
+    success: boolean;
+    /** Phase output data */
+    data?: T;
+    /** Error if phase failed */
+    error?: Error;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Optional message for logging */
+    message?: string;
+    /** Whether to skip subsequent phases */
+    skipRemaining?: boolean;
+}
+/**
+ * Enhancement availability status
+ */
+export interface EnhancementStatus {
+    claudeFlow: boolean;
+    claudeFlowVersion?: string;
+    ruvector: boolean;
+    ruvectorVersion?: string;
+}
+/**
+ * Context passed through init phases
+ */
+export interface InitContext {
+    /** Project root directory */
+    projectRoot: string;
+    /** CLI options passed to init */
+    options: InitOptions;
+    /** Configuration being built up through phases */
+    config: Partial<AQEInitConfig>;
+    /** Project analysis result (set by analysis phase) */
+    analysis?: ProjectAnalysis;
+    /** Available enhancements detected */
+    enhancements: EnhancementStatus;
+    /** Results from completed phases */
+    results: Map<string, PhaseResult>;
+    /** V2 detection result (if applicable) */
+    v2Detection?: V2DetectionResult;
+    /** Shared services for phases */
+    services: {
+        /** Log a message */
+        log: (message: string) => void;
+        /** Log a warning */
+        warn: (message: string) => void;
+        /** Log an error */
+        error: (message: string) => void;
+    };
+}
+/**
+ * Options passed to aqe init command
+ */
+export interface InitOptions {
+    /** Skip wizard and use auto-configuration */
+    autoMode?: boolean;
+    /** Skip pattern loading */
+    skipPatterns?: boolean;
+    /** Minimal configuration (no skills, patterns, workers) */
+    minimal?: boolean;
+    /** Automatically migrate from v2 if detected */
+    autoMigrate?: boolean;
+    /** Install n8n workflow testing platform */
+    withN8n?: boolean;
+    /** N8n API configuration */
+    n8nApiConfig?: {
+        baseUrl?: string;
+        apiKey?: string;
+    };
+    /** Custom wizard answers */
+    wizardAnswers?: Record<string, unknown>;
+}
+/**
+ * V2 installation detection result
+ */
+export interface V2DetectionResult {
+    detected: boolean;
+    memoryDbPath?: string;
+    configPath?: string;
+    agentsPath?: string;
+    hasMemoryDb: boolean;
+    hasConfig: boolean;
+    hasAgents: boolean;
+    version?: string;
+}
+/**
+ * Init phase interface
+ * Each phase is a self-contained unit of initialization logic
+ */
+export interface InitPhase<TResult = unknown> {
+    /** Unique phase name (used as key in results map) */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Execution order (lower runs first) */
+    readonly order: number;
+    /** If true, failure stops the entire init process */
+    readonly critical: boolean;
+    /** Phase names that must complete before this phase */
+    readonly requiresPhases?: readonly string[];
+    /** Enhancement names that this phase uses (optional) */
+    readonly requiresEnhancements?: readonly string[];
+    /**
+     * Determine if this phase should run
+     * @param context Current init context
+     * @returns true if phase should execute
+     */
+    shouldRun(context: InitContext): Promise<boolean>;
+    /**
+     * Execute the phase
+     * @param context Current init context
+     * @returns Phase result with data or error
+     */
+    execute(context: InitContext): Promise<PhaseResult<TResult>>;
+    /**
+     * Optional rollback if phase fails and cleanup is needed
+     * @param context Current init context
+     */
+    rollback?(context: InitContext): Promise<void>;
+}
+/**
+ * Base class for init phases with common functionality
+ */
+export declare abstract class BasePhase<TResult = unknown> implements InitPhase<TResult> {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly order: number;
+    abstract readonly critical: boolean;
+    readonly requiresPhases?: readonly string[];
+    readonly requiresEnhancements?: readonly string[];
+    /**
+     * Default shouldRun - always returns true
+     * Override in subclass for conditional execution
+     */
+    shouldRun(_context: InitContext): Promise<boolean>;
+    /**
+     * Execute with timing wrapper
+     */
+    execute(context: InitContext): Promise<PhaseResult<TResult>>;
+    /**
+     * Implement phase logic here
+     * @param context Init context
+     * @returns Phase result data
+     */
+    protected abstract run(context: InitContext): Promise<TResult>;
+    /**
+     * Check if required phases have completed successfully
+     */
+    protected checkDependencies(context: InitContext): boolean;
+    /**
+     * Check if required enhancements are available
+     */
+    protected checkEnhancements(context: InitContext): boolean;
+}
+/**
+ * Phase registry for managing available phases
+ */
+export declare class PhaseRegistry {
+    private phases;
+    /**
+     * Register a phase
+     */
+    register(phase: InitPhase): void;
+    /**
+     * Get a phase by name
+     */
+    get(name: string): InitPhase | undefined;
+    /**
+     * Get all phases sorted by order
+     */
+    getOrdered(): InitPhase[];
+    /**
+     * Check if a phase is registered
+     */
+    has(name: string): boolean;
+}
+/**
+ * Create a new phase registry with default phases
+ */
+export declare function createPhaseRegistry(): PhaseRegistry;
+//# sourceMappingURL=phase-interface.d.ts.map

package/v3/dist/init/phases/phase-interface.d.ts.map

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

package/v3/dist/init/phases/phase-interface.js

@@ -0,0 +1,119 @@
+/**
+ * Phase Interface - Modular Init System
+ * ADR-025: Enhanced Init with Self-Configuration
+ *
+ * Defines the contract for init phases that can be composed
+ * into a pipeline for flexible initialization.
+ */
+/**
+ * Base class for init phases with common functionality
+ */
+export class BasePhase {
+    requiresPhases;
+    requiresEnhancements;
+    /**
+     * Default shouldRun - always returns true
+     * Override in subclass for conditional execution
+     */
+    async shouldRun(_context) {
+        return true;
+    }
+    /**
+     * Execute with timing wrapper
+     */
+    async execute(context) {
+        const startTime = Date.now();
+        try {
+            const data = await this.run(context);
+            return {
+                success: true,
+                data,
+                durationMs: Date.now() - startTime,
+                message: `${this.description} completed`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                durationMs: Date.now() - startTime,
+                message: `${this.description} failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Check if required phases have completed successfully
+     */
+    checkDependencies(context) {
+        if (!this.requiresPhases?.length)
+            return true;
+        for (const phaseName of this.requiresPhases) {
+            const result = context.results.get(phaseName);
+            if (!result?.success) {
+                context.services.warn(`Phase ${this.name} requires ${phaseName} which has not completed`);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Check if required enhancements are available
+     */
+    checkEnhancements(context) {
+        if (!this.requiresEnhancements?.length)
+            return true;
+        for (const enhancement of this.requiresEnhancements) {
+            const available = enhancement === 'claudeFlow'
+                ? context.enhancements.claudeFlow
+                : enhancement === 'ruvector'
+                    ? context.enhancements.ruvector
+                    : false;
+            if (!available) {
+                context.services.warn(`Phase ${this.name} requires ${enhancement} which is not available`);
+                return false;
+            }
+        }
+        return true;
+    }
+}
+/**
+ * Phase registry for managing available phases
+ */
+export class PhaseRegistry {
+    phases = new Map();
+    /**
+     * Register a phase
+     */
+    register(phase) {
+        if (this.phases.has(phase.name)) {
+            throw new Error(`Phase ${phase.name} is already registered`);
+        }
+        this.phases.set(phase.name, phase);
+    }
+    /**
+     * Get a phase by name
+     */
+    get(name) {
+        return this.phases.get(name);
+    }
+    /**
+     * Get all phases sorted by order
+     */
+    getOrdered() {
+        return Array.from(this.phases.values())
+            .sort((a, b) => a.order - b.order);
+    }
+    /**
+     * Check if a phase is registered
+     */
+    has(name) {
+        return this.phases.has(name);
+    }
+}
+/**
+ * Create a new phase registry with default phases
+ */
+export function createPhaseRegistry() {
+    return new PhaseRegistry();
+}
+//# sourceMappingURL=phase-interface.js.map

package/v3/dist/init/phases/phase-interface.js.map

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

package/v3/dist/integrations/coherence/coherence-service.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Agentic QE v3 - Coherence Service
+ *
+ * Main facade that wraps all 6 Prime Radiant engines for coherence verification.
+ * Provides mathematical coherence gates for multi-agent coordination.
+ *
+ * **Architecture Overview:**
+ * ```
+ * ┌─────────────────────────────────────────────────────────────────────┐
+ * │                    AQE v3 COHERENCE ARCHITECTURE                    │
+ * ├─────────────────────────────────────────────────────────────────────┤
+ * │                                                                     │
+ * │  ┌────────────────┐     ┌─────────────────────┐     ┌────────────┐ │
+ * │  │ QE Agent       │────▶│ COHERENCE GATE      │────▶│ Execution  │ │
+ * │  │ Decision       │     │ (Prime Radiant)     │     │ Layer      │ │
+ * │  └────────────────┘     └─────────────────────┘     └────────────┘ │
+ * │                                │                                    │
+ * │                    ┌───────────┼───────────┐                       │
+ * │                    ▼           ▼           ▼                       │
+ * │              ┌──────────┐ ┌──────────┐ ┌──────────┐                │
+ * │              │ REFLEX   │ │ RETRIEVAL│ │ ESCALATE │                │
+ * │              │ E < 0.1  │ │ E: 0.1-0.4│ │ E > 0.4  │                │
+ * │              │ <1ms     │ │ ~10ms    │ │ Queen    │                │
+ * │              └──────────┘ └──────────┘ └──────────┘                │
+ * │                                                                     │
+ * └─────────────────────────────────────────────────────────────────────┘
+ * ```
+ *
+ * @module integrations/coherence/coherence-service
+ */
+import type { CoherenceNode, CoherenceResult, CoherenceServiceConfig, CoherenceStats, Belief, Contradiction, SwarmState, AgentHealth, CollapseRisk, CausalData, CausalVerification, TypedPipeline, TypeVerification, Decision, WitnessRecord, ReplayResult, AgentVote, ConsensusResult, HasEmbedding, IWasmLoader, CoherenceLogger } from './types';
+/**
+ * Interface for the main Coherence Service
+ */
+export interface ICoherenceService {
+    /**
+     * Initialize the service (loads WASM modules)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Core coherence checking for a set of nodes
+     *
+     * @param nodes - Nodes to check for coherence
+     * @returns Coherence result with energy, lane, and contradictions
+     */
+    checkCoherence(nodes: CoherenceNode[]): Promise<CoherenceResult>;
+    /**
+     * Detect contradictions in a set of beliefs
+     *
+     * @param beliefs - Beliefs to check for contradictions
+     * @returns Array of detected contradictions
+     */
+    detectContradictions(beliefs: Belief[]): Promise<Contradiction[]>;
+    /**
+     * Predict collapse risk for a swarm
+     *
+     * @param state - Current swarm state
+     * @returns Collapse risk assessment
+     */
+    predictCollapse(state: SwarmState): Promise<CollapseRisk>;
+    /**
+     * Verify a causal relationship
+     *
+     * @param cause - Name of the cause variable
+     * @param effect - Name of the effect variable
+     * @param data - Observation data
+     * @returns Causal verification result
+     */
+    verifyCausality(cause: string, effect: string, data: CausalData): Promise<CausalVerification>;
+    /**
+     * Verify type consistency in a pipeline
+     *
+     * @param pipeline - Typed pipeline to verify
+     * @returns Type verification result
+     */
+    verifyTypes(pipeline: TypedPipeline): Promise<TypeVerification>;
+    /**
+     * Create a witness record for a decision
+     *
+     * @param decision - Decision to witness
+     * @returns Witness record
+     */
+    createWitness(decision: Decision): Promise<WitnessRecord>;
+    /**
+     * Replay a decision from a witness
+     *
+     * @param witnessId - ID of the witness to replay from
+     * @returns Replay result
+     */
+    replayFromWitness(witnessId: string): Promise<ReplayResult>;
+    /**
+     * Check coherence of swarm agents
+     *
+     * @param agentHealth - Map of agent ID to health state
+     * @returns Coherence result for the swarm
+     */
+    checkSwarmCoherence(agentHealth: Map<string, AgentHealth>): Promise<CoherenceResult>;
+    /**
+     * Verify multi-agent consensus mathematically
+     *
+     * @param votes - Array of agent votes
+     * @returns Consensus verification result
+     */
+    verifyConsensus(votes: AgentVote[]): Promise<ConsensusResult>;
+    /**
+     * Filter items to only return coherent ones
+     *
+     * @param items - Items with embeddings to filter
+     * @param context - Context for coherence checking
+     * @returns Filtered items that are coherent with context
+     */
+    filterCoherent<T extends HasEmbedding>(items: T[], context: unknown): Promise<T[]>;
+    /**
+     * Get service statistics
+     */
+    getStats(): CoherenceStats;
+    /**
+     * Dispose of service resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Main Coherence Service implementation
+ *
+ * Provides a unified interface to all 6 Prime Radiant engines:
+ * 1. CohomologyEngine - Sheaf cohomology for contradiction detection
+ * 2. SpectralEngine - Spectral analysis for collapse prediction
+ * 3. CausalEngine - Causal inference for spurious correlation detection
+ * 4. CategoryEngine - Category theory for type verification
+ * 5. HomotopyEngine - HoTT for formal verification
+ * 6. WitnessEngine - Blake3 witness chains for audit trails
+ *
+ * @example
+ * ```typescript
+ * const service = new CoherenceService(wasmLoader);
+ * await service.initialize();
+ *
+ * // Check coherence
+ * const result = await service.checkCoherence(nodes);
+ * if (!result.isCoherent) {
+ *   console.log('Contradictions found:', result.contradictions);
+ * }
+ *
+ * // Route based on lane
+ * switch (result.lane) {
+ *   case 'reflex': return executeImmediately();
+ *   case 'retrieval': return fetchContextAndRetry();
+ *   case 'heavy': return deepAnalysis();
+ *   case 'human': return escalateToQueen();
+ * }
+ * ```
+ */
+export declare class CoherenceService implements ICoherenceService {
+    private readonly wasmLoader;
+    private readonly config;
+    private readonly logger;
+    private cohomologyAdapter;
+    private spectralAdapter;
+    private causalAdapter;
+    private categoryAdapter;
+    private homotopyAdapter;
+    private witnessAdapter;
+    private initialized;
+    private stats;
+    private totalEnergySum;
+    private totalDurationSum;
+    /**
+     * Create a new CoherenceService
+     *
+     * @param wasmLoader - WASM module loader (dependency injection)
+     * @param config - Optional service configuration
+     * @param logger - Optional logger for diagnostics
+     */
+    constructor(wasmLoader: IWasmLoader, config?: Partial<CoherenceServiceConfig>, logger?: CoherenceLogger);
+    /**
+     * Initialize the service by loading all WASM modules
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if the service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Ensure the service is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Check coherence of a set of nodes
+     */
+    checkCoherence(nodes: CoherenceNode[]): Promise<CoherenceResult>;
+    /**
+     * Check coherence using WASM adapter
+     */
+    private checkCoherenceWithWasm;
+    /**
+     * Check coherence using TypeScript fallback
+     */
+    private checkCoherenceWithFallback;
+    /**
+     * Build edges between nodes based on similarity
+     */
+    private buildEdgesFromNodes;
+    /**
+     * Detect contradictions in beliefs
+     */
+    detectContradictions(beliefs: Belief[]): Promise<Contradiction[]>;
+    /**
+     * Predict collapse risk for a swarm
+     */
+    predictCollapse(state: SwarmState): Promise<CollapseRisk>;
+    /**
+     * Fallback collapse prediction using simple heuristics
+     */
+    private predictCollapseWithFallback;
+    /**
+     * Verify a causal relationship
+     */
+    verifyCausality(cause: string, effect: string, data: CausalData): Promise<CausalVerification>;
+    /**
+     * Fallback causality verification using correlation
+     */
+    private verifyCausalityWithFallback;
+    /**
+     * Verify type consistency in a pipeline
+     */
+    verifyTypes(pipeline: TypedPipeline): Promise<TypeVerification>;
+    /**
+     * Fallback type verification using simple matching
+     */
+    private verifyTypesWithFallback;
+    /**
+     * Create a witness for a decision
+     */
+    createWitness(decision: Decision): Promise<WitnessRecord>;
+    /**
+     * Replay a decision from a witness
+     */
+    replayFromWitness(witnessId: string): Promise<ReplayResult>;
+    /**
+     * Check coherence of swarm agents
+     */
+    checkSwarmCoherence(agentHealth: Map<string, AgentHealth>): Promise<CoherenceResult>;
+    /**
+     * Verify multi-agent consensus
+     */
+    verifyConsensus(votes: AgentVote[]): Promise<ConsensusResult>;
+    /**
+     * Fallback consensus verification
+     */
+    private verifyConsensusWithFallback;
+    /**
+     * Filter items to only return coherent ones
+     */
+    filterCoherent<T extends HasEmbedding>(items: T[], context: unknown): Promise<T[]>;
+    /**
+     * Get service statistics
+     */
+    getStats(): CoherenceStats;
+    /**
+     * Dispose of service resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Compute the appropriate compute lane based on energy
+     */
+    private computeLane;
+    /**
+     * Update statistics after a coherence check
+     */
+    private updateStats;
+    /**
+     * Generate recommendations based on coherence result
+     */
+    private generateRecommendations;
+    /**
+     * Convert agent health to a numerical embedding
+     */
+    private agentHealthToEmbedding;
+    /**
+     * Convert agent type to a number for embedding
+     */
+    private agentTypeToNumber;
+    /**
+     * Compute Euclidean distance between two vectors
+     */
+    private euclideanDistance;
+    /**
+     * Compute cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Compute Pearson correlation coefficient
+     */
+    private computeCorrelation;
+    /**
+     * Simple hash function for fallback
+     */
+    private simpleHash;
+}
+/**
+ * Create and initialize a CoherenceService
+ *
+ * @param wasmLoader - WASM module loader
+ * @param config - Optional service configuration
+ * @param logger - Optional logger
+ * @returns Initialized service
+ *
+ * @example
+ * ```typescript
+ * const service = await createCoherenceService(wasmLoader);
+ *
+ * const result = await service.checkCoherence(nodes);
+ * if (!result.isCoherent) {
+ *   console.log('Contradictions:', result.contradictions);
+ * }
+ * ```
+ */
+export declare function createCoherenceService(wasmLoader: IWasmLoader, config?: Partial<CoherenceServiceConfig>, logger?: CoherenceLogger): Promise<CoherenceService>;
+//# sourceMappingURL=coherence-service.d.ts.map

package/v3/dist/integrations/coherence/coherence-service.d.ts.map

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