agentic-qe 3.8.7 → 3.8.9

package/dist/integrations/coherence/engines/witness-adapter.d.ts

@@ -1,11 +1,11 @@
 /**
  * Agentic QE v3 - Witness Engine Adapter
  *
- * Wraps the Prime Radiant WitnessEngine for Blake3 witness chain operations.
+ * Wraps the Prime Radiant WitnessEngine for SHA-256 witness chain operations.
  * Used for creating tamper-evident audit trails of agent decisions.
  *
- * Blake3 Witness Chains:
- * - Each decision is hashed with Blake3
+ * Witness Chains:
+ * - Each decision is hashed with SHA-256
  * - Hash includes reference to previous witness
  * - Creates immutable audit trail
  * - Enables deterministic replay
@@ -94,8 +94,8 @@ export declare class WitnessAdapter implements IWitnessAdapter {
      */
     private createFallbackEngine;
     /**
-     * Compute a hash for witness creation
-     * Uses a simple hash when crypto is not available
+     * Compute a SHA-256 hash for witness creation.
+     * Chains the previous hash into the computation for tamper-evidence.
      */
     private computeHash;
     /**

package/dist/integrations/coherence/engines/witness-adapter.js

@@ -1,11 +1,11 @@
 /**
  * Agentic QE v3 - Witness Engine Adapter
  *
- * Wraps the Prime Radiant WitnessEngine for Blake3 witness chain operations.
+ * Wraps the Prime Radiant WitnessEngine for SHA-256 witness chain operations.
  * Used for creating tamper-evident audit trails of agent decisions.
  *
- * Blake3 Witness Chains:
- * - Each decision is hashed with Blake3
+ * Witness Chains:
+ * - Each decision is hashed with SHA-256
  * - Hash includes reference to previous witness
  * - Creates immutable audit trail
  * - Enables deterministic replay
@@ -13,7 +13,7 @@
  * @module integrations/coherence/engines/witness-adapter
  */
 import { WasmNotLoadedError, DEFAULT_COHERENCE_LOGGER } from '../types';
-import { secureRandom } from '../../../shared/utils/crypto-random.js';
+import { createHash } from 'crypto';
 // ============================================================================
 // Witness Adapter Implementation
 // ============================================================================
@@ -131,28 +131,16 @@ export class WitnessAdapter {
         };
     }
     /**
-     * Compute a hash for witness creation
-     * Uses a simple hash when crypto is not available
+     * Compute a SHA-256 hash for witness creation.
+     * Chains the previous hash into the computation for tamper-evidence.
      */
     computeHash(data, previousHash) {
-        // Simple hash implementation for environments without crypto
-        // In production, this would use Blake3 or SHA-256
-        let hash = 0;
-        for (let i = 0; i < data.length; i++) {
-            hash = ((hash << 5) - hash + data[i]) | 0;
-        }
+        const hasher = createHash('sha256');
+        hasher.update(data);
         if (previousHash) {
-            for (let i = 0; i < previousHash.length; i++) {
-                hash = ((hash << 5) - hash + previousHash.charCodeAt(i)) | 0;
-            }
+            hasher.update(previousHash, 'utf-8');
         }
-        // Convert to hex string
-        const unsignedHash = hash >>> 0;
-        return unsignedHash.toString(16).padStart(8, '0') +
-            '-' +
-            Date.now().toString(16) +
-            '-' +
-            secureRandom().toString(16).slice(2, 10);
+        return hasher.digest('hex');
     }
     /**
      * Check if the adapter is initialized

package/dist/integrations/ruvector/coherence-gate.d.ts

@@ -10,12 +10,13 @@
  *   - Retrieval (~10ms): Full word-frequency coherence computation
  *
  * Implements ITransferCoherenceGate for cross-domain transfer validation.
- * Uses Blake3 hash-chained witness records for audit trail.
+ * Uses SHA-256 hash-chained witness records for audit trail.
  *
  * @module integrations/ruvector/coherence-gate
  * @see ADR-083-coherence-gated-agent-actions.md
  */
 import type { ITransferCoherenceGate, CoherenceValidation } from './transfer-coherence-stub.js';
+import type { WitnessChain as GovernanceWitnessChain } from '../../governance/witness-chain.js';
 /**
  * Reset the CohomologyEngine loader state (for testing).
  */
@@ -148,7 +149,16 @@ export declare class CoherenceGate implements ITransferCoherenceGate {
     private witnessChain;
     private lastWitnessHash;
     private nativeAvailable;
+    /** Optional governance witness chain for SQLite persistence */
+    private governanceChain;
     constructor(threshold?: number);
+    /**
+     * Attach a governance WitnessChain (or PersistentWitnessChain) for
+     * durable persistence of coherence decisions. When attached, every
+     * validation is appended to the governance chain in addition to the
+     * in-memory witness array.
+     */
+    setGovernanceChain(chain: GovernanceWitnessChain): void;
     /**
      * Compute coherence energy for a test artifact.
      *
@@ -271,12 +281,11 @@ export declare class CoherenceGate implements ITransferCoherenceGate {
      */
     private buildFailureReason;
     /**
-     * Create a Blake3-style hash-chained witness record.
-     * Falls back to SHA-256 when Blake3 is unavailable.
+     * Create a SHA-256 hash-chained witness record.
      */
     private createWitnessRecord;
     /**
-     * Hash content using SHA-256 (Blake3 fallback).
+     * Hash content using SHA-256.
      */
     private hashContent;
     /**
@@ -298,7 +307,7 @@ export declare class CoherenceGate implements ITransferCoherenceGate {
  * @param threshold - Coherence energy threshold (default: 0.4)
  * @returns A new CoherenceGate instance
  */
-export declare function createCoherenceGate(threshold?: number): CoherenceGate;
+export declare function createCoherenceGate(threshold?: number, governanceChain?: GovernanceWitnessChain): CoherenceGate;
 /**
  * Create a transfer coherence gate.
  *

package/dist/integrations/ruvector/coherence-gate.js

@@ -10,7 +10,7 @@
  *   - Retrieval (~10ms): Full word-frequency coherence computation
  *
  * Implements ITransferCoherenceGate for cross-domain transfer validation.
- * Uses Blake3 hash-chained witness records for audit trail.
+ * Uses SHA-256 hash-chained witness records for audit trail.
  *
  * @module integrations/ruvector/coherence-gate
  * @see ADR-083-coherence-gated-agent-actions.md
@@ -97,9 +97,20 @@ export class CoherenceGate {
     witnessChain = [];
     lastWitnessHash = '0'.repeat(64);
     nativeAvailable = null;
+    /** Optional governance witness chain for SQLite persistence */
+    governanceChain = null;
     constructor(threshold = DEFAULT_COHERENCE_THRESHOLD) {
         this.threshold = threshold;
     }
+    /**
+     * Attach a governance WitnessChain (or PersistentWitnessChain) for
+     * durable persistence of coherence decisions. When attached, every
+     * validation is appended to the governance chain in addition to the
+     * in-memory witness array.
+     */
+    setGovernanceChain(chain) {
+        this.governanceChain = chain;
+    }
     // ==========================================================================
     // Core API
     // ==========================================================================
@@ -531,8 +542,7 @@ export class CoherenceGate {
         return parts.join(' ');
     }
     /**
-     * Create a Blake3-style hash-chained witness record.
-     * Falls back to SHA-256 when Blake3 is unavailable.
+     * Create a SHA-256 hash-chained witness record.
      */
     createWitnessRecord(artifact, energy, threshold, passed) {
         const id = randomUUID();
@@ -556,11 +566,25 @@ export class CoherenceGate {
         if (flags.useWitnessChain) {
             this.witnessChain.push(record);
             this.lastWitnessHash = record.recordHash;
+            // Persist to governance chain if attached
+            if (this.governanceChain) {
+                try {
+                    const governanceDecision = {
+                        type: 'coherence-gate',
+                        decision: passed ? 'PASS' : 'FAIL',
+                        context: { energy, threshold, artifactHash: record.artifactHash },
+                    };
+                    this.governanceChain.appendWitness(governanceDecision);
+                }
+                catch (err) {
+                    logger.debug('Failed to persist to governance chain', { error: String(err) });
+                }
+            }
         }
         return record;
     }
     /**
-     * Hash content using SHA-256 (Blake3 fallback).
+     * Hash content using SHA-256.
      */
     hashContent(content) {
         return createHash('sha256').update(content).digest('hex');
@@ -616,8 +640,12 @@ export class CoherenceGate {
  * @param threshold - Coherence energy threshold (default: 0.4)
  * @returns A new CoherenceGate instance
  */
-export function createCoherenceGate(threshold) {
-    return new CoherenceGate(threshold);
+export function createCoherenceGate(threshold, governanceChain) {
+    const gate = new CoherenceGate(threshold);
+    if (governanceChain) {
+        gate.setGovernanceChain(governanceChain);
+    }
+    return gate;
 }
 /**
  * Create a transfer coherence gate.

package/dist/learning/agent-routing.d.ts

@@ -7,12 +7,14 @@
  */
 import type { QEDomain } from './qe-patterns.js';
 /**
- * Profile describing an agent's domains, capabilities, and performance.
+ * Profile describing an agent's domains, capabilities, performance, and language expertise.
  */
 export interface AgentCapabilityProfile {
     domains: QEDomain[];
     capabilities: string[];
     performanceScore: number;
+    /** Languages this agent has expertise in (for language-aware routing) */
+    languages?: string[];
 }
 /**
  * Static mapping of QE agent types to their capability profiles.
@@ -33,6 +35,8 @@ export interface RoutingWeights {
     similarity: number;
     performance: number;
     capabilities: number;
+    /** Weight for language match boost (default: 1.0) */
+    language?: number;
 }
 /**
  * Calculate agent scores for a routing request.
@@ -42,9 +46,10 @@ export interface RoutingWeights {
  * @param agentDomainPatternCounts - Map from agent type to number of matching patterns
  * @param routingWeights - Weights for the scoring components
  * @param agentCapabilities - Agent capability map (defaults to AGENT_CAPABILITIES)
+ * @param requestLanguage - Optional language to boost agents with matching language expertise
  * @returns Sorted array of scored agents (highest score first)
  */
-export declare function calculateAgentScores(detectedDomains: QEDomain[], requestCapabilities: string[] | undefined, agentDomainPatternCounts: Map<string, number>, routingWeights: RoutingWeights, agentCapabilities?: Record<string, AgentCapabilityProfile>): ScoredAgent[];
+export declare function calculateAgentScores(detectedDomains: QEDomain[], requestCapabilities: string[] | undefined, agentDomainPatternCounts: Map<string, number>, routingWeights: RoutingWeights, agentCapabilities?: Record<string, AgentCapabilityProfile>, requestLanguage?: string): ScoredAgent[];
 /**
  * Domain compatibility matrix for cross-domain pattern transfer.
  * Maps each domain to its related domains (same as TransferSpecialistService).

package/dist/learning/agent-routing.js

@@ -16,21 +16,25 @@ export const AGENT_CAPABILITIES = {
         domains: ['test-generation'],
         capabilities: ['test-generation', 'tdd', 'bdd', 'unit-test', 'integration-test'],
         performanceScore: 0.85,
+        languages: ['typescript', 'javascript', 'python', 'java', 'csharp', 'go', 'rust', 'swift', 'kotlin', 'dart'],
     },
     'qe-coverage-analyzer': {
         domains: ['coverage-analysis'],
         capabilities: ['coverage-analysis', 'gap-detection', 'risk-scoring'],
         performanceScore: 0.92,
+        languages: ['typescript', 'javascript', 'python', 'java', 'csharp', 'go', 'rust', 'swift', 'kotlin', 'dart'],
     },
     'qe-coverage-specialist': {
         domains: ['coverage-analysis'],
         capabilities: ['sublinear-analysis', 'branch-coverage', 'mutation-testing'],
         performanceScore: 0.88,
+        languages: ['typescript', 'javascript'],
     },
     'qe-test-architect': {
         domains: ['test-generation', 'coverage-analysis'],
         capabilities: ['test-strategy', 'test-pyramid', 'architecture'],
         performanceScore: 0.9,
+        languages: ['typescript', 'javascript', 'python', 'java', 'csharp', 'go', 'rust', 'swift', 'kotlin', 'dart'],
     },
     'qe-api-contract-validator': {
         domains: ['contract-testing'],
@@ -76,9 +80,10 @@ export const AGENT_CAPABILITIES = {
  * @param agentDomainPatternCounts - Map from agent type to number of matching patterns
  * @param routingWeights - Weights for the scoring components
  * @param agentCapabilities - Agent capability map (defaults to AGENT_CAPABILITIES)
+ * @param requestLanguage - Optional language to boost agents with matching language expertise
  * @returns Sorted array of scored agents (highest score first)
  */
-export function calculateAgentScores(detectedDomains, requestCapabilities, agentDomainPatternCounts, routingWeights, agentCapabilities = AGENT_CAPABILITIES) {
+export function calculateAgentScores(detectedDomains, requestCapabilities, agentDomainPatternCounts, routingWeights, agentCapabilities = AGENT_CAPABILITIES, requestLanguage) {
     const agentScores = [];
     for (const [agentType, profile] of Object.entries(agentCapabilities)) {
         let score = 0;
@@ -105,6 +110,17 @@ export function calculateAgentScores(detectedDomains, requestCapabilities, agent
         // Historical performance (0-0.3)
         score += profile.performanceScore * 0.3 * routingWeights.performance;
         reasoning.push(`Performance score: ${(profile.performanceScore * 100).toFixed(0)}%`);
+        // Language match boost (0-0.15)
+        if (requestLanguage && profile.languages && profile.languages.length > 0) {
+            const langWeight = routingWeights.language ?? 1.0;
+            const langLower = requestLanguage.toLowerCase();
+            const hasLanguage = profile.languages.some(l => l.toLowerCase() === langLower);
+            if (hasLanguage) {
+                const langBoost = 0.15 * langWeight;
+                score += langBoost;
+                reasoning.push(`Language match: ${requestLanguage}`);
+            }
+        }
         // Pattern similarity boost
         const patternCount = agentDomainPatternCounts.get(agentType) || 0;
         if (patternCount > 0) {