agentic-qe 3.2.2 → 3.3.0

package/v3/dist/integrations/coherence/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Agentic QE v3 - Coherence Service Module
+ *
+ * Mathematical coherence verification using Prime Radiant engines.
+ * Provides coherence gates for multi-agent coordination per ADR-052.
+ *
+ * **Six 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 - Homotopy type theory for formal verification
+ * 6. WitnessEngine - Blake3 witness chain for audit trails
+ *
+ * **Compute Lanes (based on energy threshold):**
+ * | Lane | Energy Range | Latency | Action |
+ * |------|--------------|---------|--------|
+ * | Reflex | E < 0.1 | <1ms | Immediate execution |
+ * | Retrieval | 0.1 - 0.4 | ~10ms | Fetch additional context |
+ * | Heavy | 0.4 - 0.7 | ~100ms | Deep analysis |
+ * | Human | E > 0.7 | Async | Queen escalation |
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { CoherenceService, createCoherenceService } from '@agentic-qe/v3/integrations/coherence';
+ *
+ * // Create and initialize
+ * const service = await createCoherenceService(wasmLoader);
+ *
+ * // 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();
+ * }
+ * ```
+ *
+ * @example Strange Loop Integration
+ * ```typescript
+ * const coherence = await createCoherenceService(wasmLoader);
+ *
+ * strangeLoop.on('observation_complete', async ({ observation }) => {
+ *   const check = await coherence.checkSwarmCoherence(observation.agentHealth);
+ *   if (!check.isCoherent) {
+ *     await strangeLoop.reconcileBeliefs(check.contradictions);
+ *   }
+ * });
+ * ```
+ *
+ * @example Consensus Verification
+ * ```typescript
+ * const votes: AgentVote[] = [
+ *   { agentId: 'agent-1', verdict: 'pass', confidence: 0.9, ... },
+ *   { agentId: 'agent-2', verdict: 'pass', confidence: 0.85, ... },
+ *   { agentId: 'agent-3', verdict: 'fail', confidence: 0.6, ... },
+ * ];
+ *
+ * const consensus = await service.verifyConsensus(votes);
+ *
+ * if (consensus.isFalseConsensus) {
+ *   // Spawn independent reviewer
+ * }
+ * ```
+ *
+ * @module integrations/coherence
+ */
+export { CoherenceService, createCoherenceService, type ICoherenceService, } from './coherence-service';
+export { CohomologyAdapter, createCohomologyAdapter, type ICohomologyAdapter, SpectralAdapter, createSpectralAdapter, type ISpectralAdapter, CausalAdapter, createCausalAdapter, type ICausalAdapter, CategoryAdapter, createCategoryAdapter, type ICategoryAdapter, HomotopyAdapter, createHomotopyAdapter, type IHomotopyAdapter, type Proposition, type PathEquivalenceResult, type VerificationStatus, WitnessAdapter, createWitnessAdapter, type IWitnessAdapter, } from './engines';
+export type { ComputeLane, ComputeLaneConfig, CoherenceNode, CoherenceEdge, CoherenceResult, Contradiction, Belief, AgentHealth, SwarmState, CollapseRisk, CausalData, CausalVerification, TypedElement, TypedPipeline, TypeVerification, TypeMismatch, Decision, WitnessRecord, ReplayResult, AgentVote, ConsensusResult, HasEmbedding, CoherenceServiceConfig, CoherenceStats, CoherenceLogger, IWasmLoader, WasmModule, SpectralEngineConstructor, HoTTEngineConstructor, CoherenceEngines, RawCoherenceEngines, ICohomologyEngine, ISpectralEngine, ICausalEngine, ICategoryEngine, IHomotopyEngine, IWitnessEngine, IRawCohomologyEngine, IRawSpectralEngine, IRawCausalEngine, IRawCategoryEngine, IRawHoTTEngine, IRawQuantumEngine, ContradictionRaw, TypeMismatchRaw, WitnessRaw, WasmLoaderEvent, } from './types';
+export { DEFAULT_COHERENCE_CONFIG, DEFAULT_LANE_CONFIG, DEFAULT_COHERENCE_LOGGER, } from './types';
+export { CoherenceError, WasmNotLoadedError, WasmLoadError, CoherenceCheckError, CoherenceTimeoutError, UnresolvableContradictionError, } from './types';
+export { WasmLoader, wasmLoader, createLoader, isLoaded as isWasmLoaded, getEngines as getWasmEngines, isInDegradedMode, getFallbackState, getEnginesWithFallback, } from './wasm-loader';
+export type { FallbackResult, FallbackState } from './types';
+export { DEFAULT_FALLBACK_RESULT } from './types';
+export { ThresholdTuner, createThresholdTuner, type IThresholdTuner, type ThresholdTunerConfig, type ThresholdStats, type DomainStats, type OutcomeRecord, type ThresholdCalibratedPayload, type IThresholdMemoryStore, type IThresholdEventBus, DEFAULT_TUNER_CONFIG, } from './threshold-tuner';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/integrations/coherence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/coherence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAMH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAEL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EAGvB,eAAe,EACf,qBAAqB,EACrB,KAAK,gBAAgB,EAGrB,aAAa,EACb,mBAAmB,EACnB,KAAK,cAAc,EAGnB,eAAe,EACf,qBAAqB,EACrB,KAAK,gBAAgB,EAGrB,eAAe,EACf,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EAGvB,cAAc,EACd,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AAMnB,YAAY,EAEV,WAAW,EACX,iBAAiB,EAGjB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EAGb,MAAM,EAGN,WAAW,EACX,UAAU,EACV,YAAY,EAGZ,UAAU,EACV,kBAAkB,EAGlB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EAGZ,QAAQ,EACR,aAAa,EACb,YAAY,EAGZ,SAAS,EACT,eAAe,EAGf,YAAY,EAGZ,sBAAsB,EACtB,cAAc,EACd,eAAe,EAGf,WAAW,EACX,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EAGnB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EAGd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAGjB,gBAAgB,EAChB,eAAe,EACf,UAAU,EAGV,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,IAAI,YAAY,EACxB,UAAU,IAAI,cAAc,EAE5B,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAMvB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAMlD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/v3/dist/integrations/coherence/index.js

@@ -0,0 +1,114 @@
+/**
+ * Agentic QE v3 - Coherence Service Module
+ *
+ * Mathematical coherence verification using Prime Radiant engines.
+ * Provides coherence gates for multi-agent coordination per ADR-052.
+ *
+ * **Six 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 - Homotopy type theory for formal verification
+ * 6. WitnessEngine - Blake3 witness chain for audit trails
+ *
+ * **Compute Lanes (based on energy threshold):**
+ * | Lane | Energy Range | Latency | Action |
+ * |------|--------------|---------|--------|
+ * | Reflex | E < 0.1 | <1ms | Immediate execution |
+ * | Retrieval | 0.1 - 0.4 | ~10ms | Fetch additional context |
+ * | Heavy | 0.4 - 0.7 | ~100ms | Deep analysis |
+ * | Human | E > 0.7 | Async | Queen escalation |
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { CoherenceService, createCoherenceService } from '@agentic-qe/v3/integrations/coherence';
+ *
+ * // Create and initialize
+ * const service = await createCoherenceService(wasmLoader);
+ *
+ * // 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();
+ * }
+ * ```
+ *
+ * @example Strange Loop Integration
+ * ```typescript
+ * const coherence = await createCoherenceService(wasmLoader);
+ *
+ * strangeLoop.on('observation_complete', async ({ observation }) => {
+ *   const check = await coherence.checkSwarmCoherence(observation.agentHealth);
+ *   if (!check.isCoherent) {
+ *     await strangeLoop.reconcileBeliefs(check.contradictions);
+ *   }
+ * });
+ * ```
+ *
+ * @example Consensus Verification
+ * ```typescript
+ * const votes: AgentVote[] = [
+ *   { agentId: 'agent-1', verdict: 'pass', confidence: 0.9, ... },
+ *   { agentId: 'agent-2', verdict: 'pass', confidence: 0.85, ... },
+ *   { agentId: 'agent-3', verdict: 'fail', confidence: 0.6, ... },
+ * ];
+ *
+ * const consensus = await service.verifyConsensus(votes);
+ *
+ * if (consensus.isFalseConsensus) {
+ *   // Spawn independent reviewer
+ * }
+ * ```
+ *
+ * @module integrations/coherence
+ */
+// ============================================================================
+// Main Service
+// ============================================================================
+export { CoherenceService, createCoherenceService, } from './coherence-service';
+// ============================================================================
+// Engine Adapters
+// ============================================================================
+export { 
+// Cohomology (Contradiction Detection)
+CohomologyAdapter, createCohomologyAdapter, 
+// Spectral (Collapse Prediction)
+SpectralAdapter, createSpectralAdapter, 
+// Causal (Spurious Correlation Detection)
+CausalAdapter, createCausalAdapter, 
+// Category (Type Verification)
+CategoryAdapter, createCategoryAdapter, 
+// Homotopy (Formal Verification)
+HomotopyAdapter, createHomotopyAdapter, 
+// Witness (Audit Trails)
+WitnessAdapter, createWitnessAdapter, } from './engines';
+// ============================================================================
+// Constants & Defaults
+// ============================================================================
+export { DEFAULT_COHERENCE_CONFIG, DEFAULT_LANE_CONFIG, DEFAULT_COHERENCE_LOGGER, } from './types';
+// ============================================================================
+// Errors
+// ============================================================================
+export { CoherenceError, WasmNotLoadedError, WasmLoadError, CoherenceCheckError, CoherenceTimeoutError, UnresolvableContradictionError, } from './types';
+// ============================================================================
+// WASM Loader
+// ============================================================================
+export { WasmLoader, wasmLoader, createLoader, isLoaded as isWasmLoaded, getEngines as getWasmEngines, 
+// ADR-052 A4.3: Fallback exports
+isInDegradedMode, getFallbackState, getEnginesWithFallback, } from './wasm-loader';
+export { DEFAULT_FALLBACK_RESULT } from './types';
+// ============================================================================
+// Threshold Auto-Tuning (ADR-052 A4.2)
+// ============================================================================
+export { ThresholdTuner, createThresholdTuner, DEFAULT_TUNER_CONFIG, } from './threshold-tuner';
+//# sourceMappingURL=index.js.map

package/v3/dist/integrations/coherence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/coherence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO;AACL,uCAAuC;AACvC,iBAAiB,EACjB,uBAAuB;AAGvB,iCAAiC;AACjC,eAAe,EACf,qBAAqB;AAGrB,0CAA0C;AAC1C,aAAa,EACb,mBAAmB;AAGnB,+BAA+B;AAC/B,eAAe,EACf,qBAAqB;AAGrB,iCAAiC;AACjC,eAAe,EACf,qBAAqB;AAMrB,yBAAyB;AACzB,cAAc,EACd,oBAAoB,GAErB,MAAM,WAAW,CAAC;AAqFnB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,IAAI,YAAY,EACxB,UAAU,IAAI,cAAc;AAC5B,iCAAiC;AACjC,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAQvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,oBAAoB,EASpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/v3/dist/integrations/coherence/threshold-tuner.d.ts

@@ -0,0 +1,396 @@
+/**
+ * Agentic QE v3 - Threshold Auto-Tuner for Coherence Gates
+ *
+ * ADR-052 Action A4.2: Threshold Auto-Tuning
+ *
+ * This module provides adaptive threshold management for coherence gates.
+ * It tracks false positive/negative rates over time and uses exponential
+ * moving average (EMA) to adjust thresholds per domain.
+ *
+ * **Key Features:**
+ * 1. Domain-specific thresholds (test-generation, security, coverage, etc.)
+ * 2. EMA-based threshold adjustment for smooth adaptation
+ * 3. False positive/negative tracking with configurable windows
+ * 4. Memory persistence for calibrated thresholds
+ * 5. Manual override capability via configuration
+ * 6. EventBus integration for threshold_calibrated events
+ *
+ * **Default Thresholds (per ADR-052):**
+ * - reflex: 0.1 (E < 0.1 = immediate execution)
+ * - retrieval: 0.4 (0.1-0.4 = fetch additional context)
+ * - heavy: 0.7 (0.4-0.7 = deep analysis)
+ * - human: 1.0 (E > 0.7 = Queen escalation)
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const tuner = new ThresholdTuner({
+ *   memoryStore: myMemoryStore,
+ *   eventBus: myEventBus,
+ * });
+ *
+ * // Get threshold for a domain/lane combination
+ * const threshold = tuner.getThreshold('test-generation', 'reflex');
+ *
+ * // Record outcome to improve thresholds
+ * tuner.recordOutcome('test-generation', true, 0.05);
+ *
+ * // Trigger calibration
+ * await tuner.calibrate();
+ * ```
+ *
+ * @module integrations/coherence/threshold-tuner
+ */
+import type { ComputeLane, ComputeLaneConfig } from './types';
+import type { DomainName, EventHandler, DomainEvent } from '../../shared/types';
+/**
+ * Configuration for the threshold tuner
+ */
+export interface ThresholdTunerConfig {
+    /** EMA alpha parameter (0-1). Higher = more responsive to recent data. Default: 0.1 */
+    emaAlpha: number;
+    /** Minimum samples before calibration adjusts thresholds. Default: 10 */
+    minSamplesForCalibration: number;
+    /** Maximum history size per domain. Default: 1000 */
+    maxHistorySize: number;
+    /** Target false positive rate. Default: 0.05 (5%) */
+    targetFalsePositiveRate: number;
+    /** Target false negative rate. Default: 0.02 (2%) */
+    targetFalseNegativeRate: number;
+    /** Maximum adjustment per calibration cycle. Default: 0.05 */
+    maxAdjustmentPerCycle: number;
+    /** Whether to auto-calibrate on recordOutcome. Default: false */
+    autoCalibrate: boolean;
+    /** Auto-calibration interval (samples between calibrations). Default: 100 */
+    autoCalibrateInterval: number;
+    /** Manual threshold overrides per domain. Takes precedence over auto-tuning. */
+    manualOverrides?: Partial<Record<DomainName, Partial<ComputeLaneConfig>>>;
+    /** Default thresholds when no calibration data exists */
+    defaultThresholds: ComputeLaneConfig;
+}
+/**
+ * Default configuration for threshold tuner
+ */
+export declare const DEFAULT_TUNER_CONFIG: ThresholdTunerConfig;
+/**
+ * A single outcome record for threshold tuning
+ */
+export interface OutcomeRecord {
+    /** Timestamp of the outcome */
+    timestamp: Date;
+    /** Whether the decision was correct */
+    wasCorrect: boolean;
+    /** Energy value at decision time */
+    energy: number;
+    /** The compute lane that was selected */
+    lane: ComputeLane;
+    /** Whether this was a false positive (escalated when shouldn't have) */
+    falsePositive: boolean;
+    /** Whether this was a false negative (didn't escalate when should have) */
+    falseNegative: boolean;
+}
+/**
+ * Statistics for a domain's threshold performance
+ */
+export interface DomainStats {
+    /** Total outcomes recorded */
+    totalOutcomes: number;
+    /** Number of correct decisions */
+    correctDecisions: number;
+    /** Number of false positives */
+    falsePositives: number;
+    /** Number of false negatives */
+    falseNegatives: number;
+    /** Current accuracy rate */
+    accuracy: number;
+    /** Current false positive rate */
+    falsePositiveRate: number;
+    /** Current false negative rate */
+    falseNegativeRate: number;
+    /** Current thresholds for this domain */
+    thresholds: ComputeLaneConfig;
+    /** Whether manual override is active */
+    hasManualOverride: boolean;
+    /** Last calibration timestamp */
+    lastCalibrationAt?: Date;
+    /** Number of calibrations performed */
+    calibrationCount: number;
+}
+/**
+ * Aggregate statistics across all domains
+ */
+export interface ThresholdStats {
+    /** Stats per domain */
+    domains: Record<string, DomainStats>;
+    /** Global stats */
+    global: {
+        totalOutcomes: number;
+        correctDecisions: number;
+        falsePositives: number;
+        falseNegatives: number;
+        accuracy: number;
+        falsePositiveRate: number;
+        falseNegativeRate: number;
+        domainsCalibrated: number;
+        lastCalibrationAt?: Date;
+    };
+    /** Configuration snapshot */
+    config: {
+        emaAlpha: number;
+        targetFalsePositiveRate: number;
+        targetFalseNegativeRate: number;
+        minSamplesForCalibration: number;
+        autoCalibrate: boolean;
+    };
+}
+/**
+ * Payload for threshold_calibrated event
+ */
+export interface ThresholdCalibratedPayload {
+    /** Domain that was calibrated */
+    domain: string;
+    /** Previous thresholds */
+    previousThresholds: ComputeLaneConfig;
+    /** New thresholds after calibration */
+    newThresholds: ComputeLaneConfig;
+    /** Statistics at calibration time */
+    stats: DomainStats;
+    /** Reason for calibration */
+    reason: 'auto' | 'manual' | 'scheduled';
+}
+/**
+ * Memory store interface for persisting thresholds
+ */
+export interface IThresholdMemoryStore {
+    /** Store a value */
+    store(key: string, value: unknown, namespace?: string): Promise<void>;
+    /** Retrieve a value */
+    retrieve(key: string, namespace?: string): Promise<unknown | null>;
+}
+/**
+ * Event bus interface for publishing threshold events
+ */
+export interface IThresholdEventBus {
+    /** Publish an event */
+    publish<T>(event: DomainEvent<T>): Promise<void>;
+    /** Subscribe to events */
+    subscribe<T>(eventType: string, handler: EventHandler<T>): {
+        unsubscribe: () => void;
+    };
+}
+/**
+ * Interface for the ThresholdTuner
+ */
+export interface IThresholdTuner {
+    /**
+     * Get the threshold for a specific domain and compute lane
+     *
+     * @param domain - The domain name (e.g., 'test-generation', 'security')
+     * @param lane - The compute lane
+     * @returns The threshold value
+     */
+    getThreshold(domain: string, lane: ComputeLane): number;
+    /**
+     * Get all thresholds for a domain
+     *
+     * @param domain - The domain name
+     * @returns The lane configuration for the domain
+     */
+    getThresholds(domain: string): ComputeLaneConfig;
+    /**
+     * Record an outcome for threshold tuning
+     *
+     * @param domain - The domain name
+     * @param wasCorrect - Whether the decision was correct
+     * @param energy - The energy value at decision time
+     * @param lane - Optional lane that was selected
+     */
+    recordOutcome(domain: string, wasCorrect: boolean, energy: number, lane?: ComputeLane): void;
+    /**
+     * Calibrate thresholds based on collected data
+     * Publishes threshold_calibrated events for any changes
+     */
+    calibrate(): Promise<void>;
+    /**
+     * Get statistics for all domains
+     */
+    getStats(): ThresholdStats;
+    /**
+     * Reset statistics and thresholds for a specific domain or all domains
+     *
+     * @param domain - Optional domain to reset. If omitted, resets all.
+     */
+    reset(domain?: string): void;
+    /**
+     * Set a manual override for a domain's thresholds
+     *
+     * @param domain - The domain name
+     * @param thresholds - The threshold overrides
+     */
+    setManualOverride(domain: string, thresholds: Partial<ComputeLaneConfig>): void;
+    /**
+     * Clear manual override for a domain
+     *
+     * @param domain - The domain name
+     */
+    clearManualOverride(domain: string): void;
+    /**
+     * Persist current thresholds to memory
+     */
+    persist(): Promise<void>;
+    /**
+     * Load persisted thresholds from memory
+     */
+    load(): Promise<void>;
+}
+/**
+ * Threshold Auto-Tuner Implementation
+ *
+ * Provides adaptive threshold management for coherence gates with:
+ * - Domain-specific calibration
+ * - EMA-based smooth adjustment
+ * - False positive/negative tracking
+ * - Memory persistence
+ * - EventBus integration
+ *
+ * @example
+ * ```typescript
+ * const tuner = new ThresholdTuner({
+ *   memoryStore: myMemoryStore,
+ *   eventBus: myEventBus,
+ *   config: {
+ *     emaAlpha: 0.15,
+ *     targetFalsePositiveRate: 0.03,
+ *   }
+ * });
+ *
+ * // Load persisted thresholds
+ * await tuner.load();
+ *
+ * // Use in coherence checking
+ * const threshold = tuner.getThreshold('security', 'heavy');
+ *
+ * // Record outcomes
+ * tuner.recordOutcome('security', true, 0.55);
+ *
+ * // Periodic calibration
+ * await tuner.calibrate();
+ *
+ * // Persist for next session
+ * await tuner.persist();
+ * ```
+ */
+export declare class ThresholdTuner implements IThresholdTuner {
+    private readonly config;
+    private readonly memoryStore?;
+    private readonly eventBus?;
+    private readonly domains;
+    private readonly manualOverrides;
+    private static readonly MEMORY_NAMESPACE;
+    private static readonly MEMORY_KEY_PREFIX;
+    /**
+     * Create a new ThresholdTuner
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: {
+        memoryStore?: IThresholdMemoryStore;
+        eventBus?: IThresholdEventBus;
+        config?: Partial<ThresholdTunerConfig>;
+    });
+    /**
+     * Get threshold for a specific domain and lane
+     */
+    getThreshold(domain: string, lane: ComputeLane): number;
+    /**
+     * Get all thresholds for a domain
+     */
+    getThresholds(domain: string): ComputeLaneConfig;
+    /**
+     * Record an outcome for threshold tuning
+     */
+    recordOutcome(domain: string, wasCorrect: boolean, energy: number, lane?: ComputeLane): void;
+    /**
+     * Calibrate thresholds for all domains
+     */
+    calibrate(): Promise<void>;
+    /**
+     * Get statistics for all domains
+     */
+    getStats(): ThresholdStats;
+    /**
+     * Reset statistics and thresholds
+     */
+    reset(domain?: string): void;
+    /**
+     * Set a manual override for a domain
+     */
+    setManualOverride(domain: string, thresholds: Partial<ComputeLaneConfig>): void;
+    /**
+     * Clear manual override for a domain
+     */
+    clearManualOverride(domain: string): void;
+    /**
+     * Persist thresholds to memory
+     */
+    persist(): Promise<void>;
+    /**
+     * Load persisted thresholds from memory
+     */
+    load(): Promise<void>;
+    /**
+     * Get or create domain state
+     */
+    private getOrCreateDomainState;
+    /**
+     * Calibrate a specific domain
+     */
+    private calibrateDomain;
+    /**
+     * Compute statistics for a domain
+     */
+    private computeDomainStats;
+    /**
+     * Determine compute lane from energy and thresholds
+     */
+    private determineLane;
+    /**
+     * Check if lane1 is higher (more escalated) than lane2
+     */
+    private isHigherLane;
+    /**
+     * Check if lane1 is lower (less escalated) than lane2
+     */
+    private isLowerLane;
+    /**
+     * Get threshold value from config for a lane
+     */
+    private getLaneThresholdFromConfig;
+    /**
+     * Get default threshold for a lane
+     */
+    private getDefaultThreshold;
+}
+/**
+ * Create a new ThresholdTuner instance
+ *
+ * @param options - Configuration options
+ * @returns A new ThresholdTuner instance
+ *
+ * @example
+ * ```typescript
+ * const tuner = createThresholdTuner({
+ *   memoryStore: myMemoryStore,
+ *   eventBus: myEventBus,
+ *   config: { emaAlpha: 0.15 }
+ * });
+ *
+ * await tuner.load(); // Load persisted thresholds
+ * const threshold = tuner.getThreshold('security', 'heavy');
+ * ```
+ */
+export declare function createThresholdTuner(options?: {
+    memoryStore?: IThresholdMemoryStore;
+    eventBus?: IThresholdEventBus;
+    config?: Partial<ThresholdTunerConfig>;
+}): ThresholdTuner;
+//# sourceMappingURL=threshold-tuner.d.ts.map

package/v3/dist/integrations/coherence/threshold-tuner.d.ts.map

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