agentic-qe 3.7.15 → 3.7.17

package/dist/context/sources/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Context Source Types (BMAD-005)
+ */
+export interface ContextRequest {
+    /** Target files to gather context for */
+    targetFiles: string[];
+    /** Agent type requesting context */
+    agentType: string;
+    /** Task description */
+    taskDescription: string;
+    /** Maximum token budget across all sources */
+    maxTokenBudget?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface ContextFragment {
+    /** Source identifier */
+    sourceId: string;
+    /** Fragment title */
+    title: string;
+    /** Fragment content */
+    content: string;
+    /** Estimated token count (chars / 3.5 with safety margin) */
+    estimatedTokens: number;
+    /** Relevance score 0-1 */
+    relevance: number;
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface ContextSource {
+    /** Source identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Priority (higher = more important, included first) */
+    priority: number;
+    /** Maximum tokens this source can use */
+    maxTokens: number;
+    /** Gather context fragments */
+    gather(request: ContextRequest): Promise<ContextFragment[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/sources/types.js

@@ -0,0 +1,5 @@
+/**
+ * Context Source Types (BMAD-005)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domains/test-generation/coordinator.js

@@ -140,8 +140,9 @@ export class TestGenerationCoordinator extends BaseDomainCoordinator {
                 console.log('[TestGenerationCoordinator] QEFlashAttention initialized for test-similarity');
             }
             catch (error) {
-                console.error('[TestGenerationCoordinator] Failed to initialize QEFlashAttention:', error);
-                throw new Error(`QEFlashAttention initialization failed: ${toErrorMessage(error)}`);
+                // Graceful degradation: native module may not be available on all platforms
+                console.warn('[TestGenerationCoordinator] QEFlashAttention unavailable (optional native module), continuing without it:', toErrorMessage(error));
+                this.flashAttention = null;
             }
         }
         // Initialize Decision Transformer for test case selection
@@ -155,8 +156,9 @@ export class TestGenerationCoordinator extends BaseDomainCoordinator {
                 console.log('[TestGenerationCoordinator] DecisionTransformer created for test case selection');
             }
             catch (error) {
-                console.error('[TestGenerationCoordinator] Failed to create DecisionTransformer:', error);
-                throw new Error(`DecisionTransformer creation failed: ${toErrorMessage(error)}`);
+                // Graceful degradation: native module may not be available on all platforms
+                console.warn('[TestGenerationCoordinator] DecisionTransformer unavailable (optional native module), continuing without it:', toErrorMessage(error));
+                this.decisionTransformer = null;
             }
         }
         // Subscribe to relevant events

package/dist/feedback/feedback-loop.d.ts

@@ -176,4 +176,9 @@ export declare function createQualityFeedbackLoop(config?: Partial<FeedbackConfi
  * Create and initialize a quality feedback loop with DB persistence
  */
 export declare function createInitializedFeedbackLoop(config?: Partial<FeedbackConfig>): Promise<QualityFeedbackLoop>;
+/**
+ * Get the initialized feedback loop singleton.
+ * Returns null if not yet initialized (call createInitializedFeedbackLoop first).
+ */
+export declare function getQualityFeedbackLoop(): QualityFeedbackLoop | null;
 //# sourceMappingURL=feedback-loop.d.ts.map

package/dist/feedback/feedback-loop.js

@@ -295,6 +295,18 @@ export function createQualityFeedbackLoop(config) {
 export async function createInitializedFeedbackLoop(config) {
     const loop = new QualityFeedbackLoop(config);
     await loop.initialize();
+    _feedbackLoopInstance = loop;
     return loop;
 }
+// ============================================================================
+// Singleton accessor for cross-module integration
+// ============================================================================
+let _feedbackLoopInstance = null;
+/**
+ * Get the initialized feedback loop singleton.
+ * Returns null if not yet initialized (call createInitializedFeedbackLoop first).
+ */
+export function getQualityFeedbackLoop() {
+    return _feedbackLoopInstance;
+}
 //# sourceMappingURL=feedback-loop.js.map

package/dist/feedback/index.d.ts

@@ -11,7 +11,7 @@ export { CoverageLearner, createCoverageLearner, } from './coverage-learner.js';
 export { QualityScoreCalculator, createQualityScoreCalculator, } from './quality-score-calculator.js';
 export { PatternPromotionManager, createPatternPromotionManager, } from './pattern-promotion.js';
 export type { PatternMetrics } from './pattern-promotion.js';
-export { QualityFeedbackLoop, createQualityFeedbackLoop, createInitializedFeedbackLoop, } from './feedback-loop.js';
+export { QualityFeedbackLoop, createQualityFeedbackLoop, createInitializedFeedbackLoop, getQualityFeedbackLoop, } from './feedback-loop.js';
 export type { FeedbackLoopStats, RoutingAnalysis, RoutingOutcomeInput, } from './feedback-loop.js';
 export { RoutingFeedbackCollector, createRoutingFeedbackCollector, } from '../routing/routing-feedback.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/feedback/index.js

@@ -14,7 +14,7 @@ export { QualityScoreCalculator, createQualityScoreCalculator, } from './quality
 // Pattern Promotion Manager
 export { PatternPromotionManager, createPatternPromotionManager, } from './pattern-promotion.js';
 // Main Feedback Loop Integrator
-export { QualityFeedbackLoop, createQualityFeedbackLoop, createInitializedFeedbackLoop, } from './feedback-loop.js';
+export { QualityFeedbackLoop, createQualityFeedbackLoop, createInitializedFeedbackLoop, getQualityFeedbackLoop, } from './feedback-loop.js';
 // Re-export routing feedback for direct access
 export { RoutingFeedbackCollector, createRoutingFeedbackCollector, } from '../routing/routing-feedback.js';
 //# sourceMappingURL=index.js.map

package/dist/init/agents-installer.d.ts

@@ -17,6 +17,10 @@ export interface AgentsInstallResult {
     errors: string[];
     totalCount: number;
     agentsDir: string;
+    /** Agents that had customization overlays applied */
+    overlaysApplied?: string[];
+    /** Warnings from overlay loading */
+    overlayWarnings?: string[];
 }
 export interface AgentsInstallerOptions {
     /** Project root directory */
@@ -43,6 +47,11 @@ export declare class AgentsInstaller {
      * PRIORITY: assets directory (has helpers) > root .claude (no helpers)
      */
     private findSourceAgentsDir;
+    /**
+     * Ensure the agent-overrides directory exists and is preserved during install.
+     * This directory holds user customization overlays that survive `aqe init`.
+     */
+    private preserveOverridesDir;
     /**
      * Install agents to the project
      */

package/dist/init/agents-installer.js

@@ -9,6 +9,7 @@ import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSy
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
+import { loadOverlays, applyOverlayToContent } from '../agents/overlay-loader.js';
 // ============================================================================
 // Agent Categories
 // ============================================================================
@@ -169,6 +170,30 @@ export class AgentsInstaller {
         // If no agents found, return the first path (will fail gracefully)
         return possiblePaths[0];
     }
+    /**
+     * Ensure the agent-overrides directory exists and is preserved during install.
+     * This directory holds user customization overlays that survive `aqe init`.
+     */
+    preserveOverridesDir() {
+        const overridesDir = join(this.projectRoot, '.claude', 'agent-overrides');
+        if (!existsSync(overridesDir)) {
+            mkdirSync(overridesDir, { recursive: true });
+        }
+        // Copy the example overlay template if not already present
+        const exampleDest = join(overridesDir, '_example.yaml');
+        if (!existsSync(exampleDest)) {
+            const templateSources = [
+                join(__dirname, '..', '..', 'assets', 'templates', 'agent-override-example.yaml'),
+                join(__dirname, '..', 'assets', 'templates', 'agent-override-example.yaml'),
+            ];
+            for (const src of templateSources) {
+                if (existsSync(src)) {
+                    copyFileSync(src, exampleDest);
+                    break;
+                }
+            }
+        }
+    }
     /**
      * Install agents to the project
      */
@@ -179,7 +204,11 @@ export class AgentsInstaller {
             errors: [],
             totalCount: 0,
             agentsDir: join(this.projectRoot, '.claude', 'agents', 'v3'),
+            overlaysApplied: [],
+            overlayWarnings: [],
         };
+        // Preserve the agent-overrides directory (survives reinstall)
+        this.preserveOverridesDir();
         // Check if source agents exist
         if (!existsSync(this.sourceAgentsDir)) {
             result.errors.push(`Source agents directory not found: ${this.sourceAgentsDir}`);
@@ -219,6 +248,49 @@ export class AgentsInstaller {
                 result.errors.push(`Failed to install ${agentName}: ${toErrorMessage(error)}`);
             }
         }
+        // Load and apply agent customization overlays (BMAD-002)
+        const overlayResult = loadOverlays(this.projectRoot);
+        if (overlayResult.warnings.length > 0) {
+            result.overlayWarnings = overlayResult.warnings;
+            for (const warning of overlayResult.warnings) {
+                console.error(`[AgentsInstaller] Overlay warning: ${warning}`);
+            }
+        }
+        if (overlayResult.errors.length > 0) {
+            for (const error of overlayResult.errors) {
+                result.errors.push(`Overlay error: ${error}`);
+            }
+        }
+        // Apply overlays to installed agent files
+        for (const overlay of overlayResult.overlays) {
+            const agentName = overlay.agent;
+            const isSubagent = V3_SUBAGENTS.includes(agentName);
+            const agentFile = isSubagent
+                ? join(targetSubagentsDir, `${agentName}.md`)
+                : join(targetAgentsDir, `${agentName}.md`);
+            if (!existsSync(agentFile)) {
+                result.overlayWarnings.push(`Overlay for "${agentName}" found but agent file does not exist. Skipping.`);
+                continue;
+            }
+            try {
+                const agentContent = readFileSync(agentFile, 'utf-8');
+                const { content: modifiedContent, applied } = applyOverlayToContent(agentContent, overlay);
+                writeFileSync(agentFile, modifiedContent, 'utf-8');
+                result.overlaysApplied.push(agentName);
+                const changes = [
+                    ...applied.replacedFields.map(f => `replaced:${f}`),
+                    ...applied.appendedFields.map(f => `appended:${f}`),
+                    ...applied.configOverrides.map(f => `config:${f}`),
+                ];
+                console.error(`[AgentsInstaller] Applied overlay for ${agentName}: ${changes.join(', ')}`);
+            }
+            catch (error) {
+                result.overlayWarnings.push(`Failed to apply overlay for "${agentName}": ${toErrorMessage(error)}`);
+            }
+        }
+        if (result.overlaysApplied.length > 0) {
+            console.error(`[AgentsInstaller] Applied ${result.overlaysApplied.length} agent overlay(s): ${result.overlaysApplied.join(', ')}`);
+        }
         // Create agents index file
         await this.createAgentsIndex(targetAgentsDir, result.installed);
         return result;

package/dist/init/phases/07-hooks.d.ts

@@ -46,6 +46,17 @@ export declare class HooksPhase extends BasePhase<HooksResult> {
      * verifies the checkpoint exists on session start.
      */
     private installBrainCheckpoint;
+    /**
+     * Install the statusline-v3.cjs helper into .claude/helpers/.
+     * This script generates a dynamic status line for Claude Code showing
+     * fleet status, learning metrics, domain progress, and architecture info.
+     */
+    private installStatusline;
+    /**
+     * Generate a minimal statusline-v3.cjs script as a fallback.
+     * Used when the full asset isn't available for copying.
+     */
+    private generateMinimalStatuslineScript;
     /**
      * Generate the brain-checkpoint.cjs script inline.
      * Used when the source file isn't available for copying.

package/dist/init/phases/07-hooks.js

@@ -153,6 +153,8 @@ export class HooksPhase extends BasePhase {
         const { projectRoot } = context;
         // Install brain-checkpoint helper into .claude/helpers/
         this.installBrainCheckpoint(projectRoot, context);
+        // Install statusline-v3 helper into .claude/helpers/
+        this.installStatusline(projectRoot, context);
         // Install cross-phase memory config
         const crossPhasePath = join(hooksDir, 'cross-phase-memory.yaml');
         if (!existsSync(crossPhasePath)) {
@@ -241,6 +243,71 @@ export class HooksPhase extends BasePhase {
             context.services.log('  Installed brain-checkpoint.cjs (generated)');
         }
     }
+    /**
+     * Install the statusline-v3.cjs helper into .claude/helpers/.
+     * This script generates a dynamic status line for Claude Code showing
+     * fleet status, learning metrics, domain progress, and architecture info.
+     */
+    installStatusline(projectRoot, context) {
+        const helpersDir = join(projectRoot, '.claude', 'helpers');
+        if (!existsSync(helpersDir)) {
+            mkdirSync(helpersDir, { recursive: true });
+        }
+        const destPath = join(helpersDir, 'statusline-v3.cjs');
+        // Try to copy from distributed assets or our own installation
+        const sourcePaths = [
+            join(projectRoot, 'node_modules', 'agentic-qe', 'assets', 'helpers', 'statusline-v3.cjs'),
+            join(projectRoot, 'assets', 'helpers', 'statusline-v3.cjs'),
+        ];
+        for (const src of sourcePaths) {
+            if (existsSync(src) && src !== destPath) {
+                const { copyFileSync } = require('fs');
+                copyFileSync(src, destPath);
+                context.services.log('  Installed statusline-v3.cjs (copied)');
+                return;
+            }
+        }
+        // If not available from source, generate a minimal fallback
+        if (!existsSync(destPath)) {
+            writeFileSync(destPath, this.generateMinimalStatuslineScript(), 'utf-8');
+            context.services.log('  Installed statusline-v3.cjs (generated)');
+        }
+    }
+    /**
+     * Generate a minimal statusline-v3.cjs script as a fallback.
+     * Used when the full asset isn't available for copying.
+     */
+    generateMinimalStatuslineScript() {
+        return `#!/usr/bin/env node
+/**
+ * Agentic QE v3 Statusline (minimal fallback, generated by aqe init)
+ * For the full statusline, reinstall: npx agentic-qe init --auto
+ */
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+function q(cmd, d) { try { return execSync(cmd, { encoding: 'utf-8', timeout: 3000 }).trim(); } catch { return d || ''; } }
+
+const dir = process.cwd();
+const dbPath = path.join(dir, '.agentic-qe', 'memory.db');
+let patterns = 0;
+try {
+  if (fs.existsSync(dbPath)) {
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    patterns = db.prepare('SELECT COUNT(*) AS c FROM qe_patterns').get()?.c || 0;
+    db.close();
+  }
+} catch { /* ignore */ }
+
+const branch = q('git branch --show-current 2>/dev/null');
+const branchStr = branch ? \`  \\x1b[34m⎇ \${branch}\\x1b[0m\` : '';
+const patStr = patterns > 0 ? \`  \\x1b[35m🎓 \${patterns} patterns\\x1b[0m\` : '';
+
+console.log(\`\\x1b[1m\\x1b[35m▊ Agentic QE v3\\x1b[0m\${branchStr}\${patStr}\`);
+`;
+    }
     /**
      * Generate the brain-checkpoint.cjs script inline.
      * Used when the source file isn't available for copying.

package/dist/init/phases/09-assets.js

@@ -8,6 +8,7 @@ import { BasePhase, } from './phase-interface.js';
 import { createSkillsInstaller } from '../skills-installer.js';
 import { createAgentsInstaller } from '../agents-installer.js';
 import { createN8nInstaller } from '../n8n-installer.js';
+import { initializeOverlays } from '../../routing/qe-agent-registry.js';
 /**
  * Assets phase - installs skills and agents
  */
@@ -66,6 +67,8 @@ export class AssetsPhase extends BasePhase {
         if (agentsResult.errors.length > 0) {
             context.services.warn(`Agents warnings: ${agentsResult.errors.join(', ')}`);
         }
+        // Initialize overlay configs in agent registry for runtime use
+        initializeOverlays(projectRoot);
         // Install n8n platform (optional)
         if (options.withN8n) {
             const n8nInstaller = createN8nInstaller({

package/dist/init/settings-merge.js

@@ -95,7 +95,7 @@ export function generateV3SettingsSections(config) {
         },
         statusLine: {
             type: 'command',
-            command: 'node .claude/helpers/statusline-v3.cjs 2>/dev/null || .claude/statusline-v3.sh 2>/dev/null || echo "▊ Agentic QE v3"',
+            command: 'node .claude/helpers/statusline-v3.cjs 2>/dev/null || echo "▊ Agentic QE v3"',
             refreshMs: 5000,
             enabled: true,
         },

package/dist/kernel/hnsw-adapter.d.ts

@@ -31,6 +31,9 @@ export declare class HnswAdapter implements IHnswIndexProvider {
     constructor(name: string, config?: Partial<HnswConfig>);
     add(id: number, vector: Float32Array, metadata?: Record<string, unknown>): void;
     search(query: Float32Array, k: number): SearchResult[];
+    /** Last search latency in ms, for instrumentation */
+    private _lastSearchLatencyMs;
+    get lastSearchLatencyMs(): number;
     remove(id: number): boolean;
     size(): number;
     dimensions(): number;

package/dist/kernel/hnsw-adapter.js

@@ -76,8 +76,18 @@ export class HnswAdapter {
         this.backend.add(id, vector, metadata);
     }
     search(query, k) {
-        return this.backend.search(query, k);
+        const start = performance.now();
+        const results = this.backend.search(query, k);
+        const elapsed = performance.now() - start;
+        if (elapsed > 50) {
+            console.warn(`[HNSW] search took ${elapsed.toFixed(1)}ms (k=${k}, results=${results.length})`);
+        }
+        this._lastSearchLatencyMs = elapsed;
+        return results;
     }
+    /** Last search latency in ms, for instrumentation */
+    _lastSearchLatencyMs = 0;
+    get lastSearchLatencyMs() { return this._lastSearchLatencyMs; }
     remove(id) {
         return this.backend.remove(id);
     }

package/dist/kernel/unified-memory-schemas.d.ts

@@ -17,6 +17,6 @@ export declare const QE_PATTERNS_SCHEMA = "\n  -- QE Patterns table (unified fro
 export declare const MINCUT_SCHEMA = "\n  -- MinCut Graph Snapshots (ADR-047)\n  CREATE TABLE IF NOT EXISTS mincut_snapshots (\n    id TEXT PRIMARY KEY,\n    timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n    vertex_count INTEGER NOT NULL,\n    edge_count INTEGER NOT NULL,\n    total_weight REAL NOT NULL DEFAULT 0.0,\n    is_connected INTEGER NOT NULL DEFAULT 1,\n    component_count INTEGER NOT NULL DEFAULT 1,\n    vertices_json TEXT NOT NULL,\n    edges_json TEXT NOT NULL,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n\n  -- MinCut History (time-series MinCut values)\n  CREATE TABLE IF NOT EXISTS mincut_history (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n    mincut_value REAL NOT NULL,\n    vertex_count INTEGER NOT NULL,\n    edge_count INTEGER NOT NULL,\n    algorithm TEXT NOT NULL DEFAULT 'weighted-degree',\n    duration_ms INTEGER,\n    snapshot_id TEXT,\n    created_at TEXT DEFAULT (datetime('now')),\n    FOREIGN KEY (snapshot_id) REFERENCES mincut_snapshots(id) ON DELETE SET NULL\n  );\n\n  -- MinCut Weak Vertices (detected bottlenecks)\n  CREATE TABLE IF NOT EXISTS mincut_weak_vertices (\n    id TEXT PRIMARY KEY,\n    vertex_id TEXT NOT NULL,\n    weighted_degree REAL NOT NULL,\n    risk_score REAL NOT NULL,\n    reason TEXT NOT NULL,\n    domain TEXT,\n    vertex_type TEXT NOT NULL,\n    suggestions_json TEXT,\n    detected_at TEXT NOT NULL DEFAULT (datetime('now')),\n    resolved_at TEXT,\n    snapshot_id TEXT,\n    created_at TEXT DEFAULT (datetime('now')),\n    FOREIGN KEY (snapshot_id) REFERENCES mincut_snapshots(id) ON DELETE SET NULL\n  );\n\n  -- MinCut Alerts\n  CREATE TABLE IF NOT EXISTS mincut_alerts (\n    id TEXT PRIMARY KEY,\n    severity TEXT NOT NULL,\n    message TEXT NOT NULL,\n    mincut_value REAL NOT NULL,\n    threshold REAL NOT NULL,\n    affected_vertices_json TEXT,\n    remediations_json TEXT,\n    acknowledged INTEGER DEFAULT 0,\n    acknowledged_at TEXT,\n    acknowledged_by TEXT,\n    timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n\n  -- MinCut Healing Actions (self-healing history)\n  CREATE TABLE IF NOT EXISTS mincut_healing_actions (\n    id TEXT PRIMARY KEY,\n    action_type TEXT NOT NULL,\n    action_params_json TEXT NOT NULL,\n    success INTEGER NOT NULL,\n    mincut_before REAL NOT NULL,\n    mincut_after REAL NOT NULL,\n    improvement REAL NOT NULL DEFAULT 0.0,\n    error_message TEXT,\n    duration_ms INTEGER NOT NULL,\n    triggered_by TEXT,\n    snapshot_before_id TEXT,\n    snapshot_after_id TEXT,\n    created_at TEXT DEFAULT (datetime('now')),\n    FOREIGN KEY (snapshot_before_id) REFERENCES mincut_snapshots(id) ON DELETE SET NULL,\n    FOREIGN KEY (snapshot_after_id) REFERENCES mincut_snapshots(id) ON DELETE SET NULL\n  );\n\n  -- MinCut Strange Loop Observations (P1: self-organizing)\n  CREATE TABLE IF NOT EXISTS mincut_observations (\n    id TEXT PRIMARY KEY,\n    iteration INTEGER NOT NULL,\n    mincut_value REAL NOT NULL,\n    weak_vertex_count INTEGER NOT NULL DEFAULT 0,\n    weak_vertices_json TEXT,\n    snapshot_id TEXT,\n    prediction_json TEXT,\n    actual_vs_predicted_diff REAL,\n    timestamp TEXT NOT NULL DEFAULT (datetime('now')),\n    FOREIGN KEY (snapshot_id) REFERENCES mincut_snapshots(id) ON DELETE SET NULL\n  );\n\n  -- MinCut Indexes\n  CREATE INDEX IF NOT EXISTS idx_mincut_history_timestamp ON mincut_history(timestamp DESC);\n  CREATE INDEX IF NOT EXISTS idx_mincut_history_value ON mincut_history(mincut_value);\n  CREATE INDEX IF NOT EXISTS idx_mincut_weak_vertex ON mincut_weak_vertices(vertex_id);\n  CREATE INDEX IF NOT EXISTS idx_mincut_weak_risk ON mincut_weak_vertices(risk_score DESC);\n  CREATE INDEX IF NOT EXISTS idx_mincut_weak_resolved ON mincut_weak_vertices(resolved_at);\n  CREATE INDEX IF NOT EXISTS idx_mincut_alerts_severity ON mincut_alerts(severity);\n  CREATE INDEX IF NOT EXISTS idx_mincut_alerts_ack ON mincut_alerts(acknowledged);\n  CREATE INDEX IF NOT EXISTS idx_mincut_healing_type ON mincut_healing_actions(action_type);\n  CREATE INDEX IF NOT EXISTS idx_mincut_healing_success ON mincut_healing_actions(success);\n  CREATE INDEX IF NOT EXISTS idx_mincut_observations_iter ON mincut_observations(iteration);\n";
 export declare const SONA_PATTERNS_SCHEMA = "\n  -- SONA Patterns table (ADR-046: Pattern Persistence for Neural Backbone)\n  CREATE TABLE IF NOT EXISTS sona_patterns (\n    id TEXT PRIMARY KEY,\n    type TEXT NOT NULL,\n    domain TEXT NOT NULL,\n    state_embedding BLOB,\n    action_embedding BLOB,\n    action_type TEXT NOT NULL,\n    action_value TEXT,\n    outcome_reward REAL NOT NULL DEFAULT 0.0,\n    outcome_success INTEGER NOT NULL DEFAULT 0,\n    outcome_quality REAL NOT NULL DEFAULT 0.0,\n    confidence REAL DEFAULT 0.5,\n    usage_count INTEGER DEFAULT 0,\n    success_count INTEGER DEFAULT 0,\n    failure_count INTEGER DEFAULT 0,\n    metadata TEXT,\n    created_at TEXT DEFAULT (datetime('now')),\n    updated_at TEXT DEFAULT (datetime('now')),\n    last_used_at TEXT\n  );\n  CREATE INDEX IF NOT EXISTS idx_sona_patterns_type ON sona_patterns(type);\n  CREATE INDEX IF NOT EXISTS idx_sona_patterns_domain ON sona_patterns(domain);\n  CREATE INDEX IF NOT EXISTS idx_sona_patterns_confidence ON sona_patterns(confidence DESC);\n  CREATE INDEX IF NOT EXISTS idx_sona_patterns_updated ON sona_patterns(updated_at DESC);\n";
 export declare const WITNESS_CHAIN_SCHEMA = "\n  -- Witness Chain (ADR-070: Cryptographic audit trail for QE decisions)\n  CREATE TABLE IF NOT EXISTS witness_chain (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    prev_hash TEXT NOT NULL,\n    action_hash TEXT NOT NULL,\n    action_type TEXT NOT NULL,\n    action_data TEXT,\n    timestamp TEXT NOT NULL,\n    actor TEXT NOT NULL\n  );\n  CREATE INDEX IF NOT EXISTS idx_witness_action_type ON witness_chain(action_type);\n  CREATE INDEX IF NOT EXISTS idx_witness_timestamp ON witness_chain(timestamp);\n";
-export declare const FEEDBACK_SCHEMA = "\n  -- Test outcomes (ADR-023: Quality Feedback Loop)\n  CREATE TABLE IF NOT EXISTS test_outcomes (\n    id TEXT PRIMARY KEY,\n    test_id TEXT NOT NULL,\n    test_name TEXT NOT NULL,\n    generated_by TEXT NOT NULL,\n    pattern_id TEXT,\n    framework TEXT NOT NULL,\n    language TEXT NOT NULL,\n    domain TEXT NOT NULL,\n    passed INTEGER NOT NULL,\n    error_message TEXT,\n    coverage_lines REAL DEFAULT 0,\n    coverage_branches REAL DEFAULT 0,\n    coverage_functions REAL DEFAULT 0,\n    mutation_score REAL,\n    execution_time_ms REAL NOT NULL,\n    flaky INTEGER DEFAULT 0,\n    flakiness_score REAL,\n    maintainability_score REAL NOT NULL,\n    complexity REAL,\n    lines_of_code INTEGER,\n    assertion_count INTEGER,\n    file_path TEXT,\n    source_file_path TEXT,\n    metadata_json TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_pattern ON test_outcomes(pattern_id);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_agent ON test_outcomes(generated_by);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_domain ON test_outcomes(domain);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_created ON test_outcomes(created_at);\n\n  -- Routing outcomes (ADR-022: Adaptive QE Agent Routing)\n  CREATE TABLE IF NOT EXISTS routing_outcomes (\n    id TEXT PRIMARY KEY,\n    task_json TEXT NOT NULL,\n    decision_json TEXT NOT NULL,\n    used_agent TEXT NOT NULL,\n    followed_recommendation INTEGER NOT NULL,\n    success INTEGER NOT NULL,\n    quality_score REAL NOT NULL,\n    duration_ms REAL NOT NULL,\n    error TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_agent ON routing_outcomes(used_agent);\n  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_created ON routing_outcomes(created_at);\n\n  -- Coverage sessions (ADR-023: Coverage Learning)\n  CREATE TABLE IF NOT EXISTS coverage_sessions (\n    id TEXT PRIMARY KEY,\n    target_path TEXT NOT NULL,\n    agent_id TEXT NOT NULL,\n    technique TEXT NOT NULL,\n    before_lines REAL DEFAULT 0,\n    before_branches REAL DEFAULT 0,\n    before_functions REAL DEFAULT 0,\n    after_lines REAL DEFAULT 0,\n    after_branches REAL DEFAULT 0,\n    after_functions REAL DEFAULT 0,\n    tests_generated INTEGER DEFAULT 0,\n    tests_passed INTEGER DEFAULT 0,\n    gaps_json TEXT,\n    duration_ms REAL NOT NULL,\n    started_at TEXT NOT NULL,\n    completed_at TEXT NOT NULL,\n    context_json TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_technique ON coverage_sessions(technique);\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_agent ON coverage_sessions(agent_id);\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_created ON coverage_sessions(created_at);\n";
+export declare const FEEDBACK_SCHEMA = "\n  -- Test outcomes (ADR-023: Quality Feedback Loop)\n  CREATE TABLE IF NOT EXISTS test_outcomes (\n    id TEXT PRIMARY KEY,\n    test_id TEXT NOT NULL,\n    test_name TEXT NOT NULL,\n    generated_by TEXT NOT NULL,\n    pattern_id TEXT,\n    framework TEXT NOT NULL,\n    language TEXT NOT NULL,\n    domain TEXT NOT NULL,\n    passed INTEGER NOT NULL,\n    error_message TEXT,\n    coverage_lines REAL DEFAULT 0,\n    coverage_branches REAL DEFAULT 0,\n    coverage_functions REAL DEFAULT 0,\n    mutation_score REAL,\n    execution_time_ms REAL NOT NULL,\n    flaky INTEGER DEFAULT 0,\n    flakiness_score REAL,\n    maintainability_score REAL NOT NULL,\n    complexity REAL,\n    lines_of_code INTEGER,\n    assertion_count INTEGER,\n    file_path TEXT,\n    source_file_path TEXT,\n    metadata_json TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_pattern ON test_outcomes(pattern_id);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_agent ON test_outcomes(generated_by);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_domain ON test_outcomes(domain);\n  CREATE INDEX IF NOT EXISTS idx_test_outcomes_created ON test_outcomes(created_at);\n\n  -- Routing outcomes (ADR-022: Adaptive QE Agent Routing)\n  CREATE TABLE IF NOT EXISTS routing_outcomes (\n    id TEXT PRIMARY KEY,\n    task_json TEXT NOT NULL,\n    decision_json TEXT NOT NULL,\n    used_agent TEXT NOT NULL,\n    followed_recommendation INTEGER NOT NULL,\n    success INTEGER NOT NULL,\n    quality_score REAL NOT NULL,\n    duration_ms REAL NOT NULL,\n    error TEXT,\n    model_tier TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_agent ON routing_outcomes(used_agent);\n  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_created ON routing_outcomes(created_at);\n  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_tier ON routing_outcomes(model_tier);\n\n  -- Coverage sessions (ADR-023: Coverage Learning)\n  CREATE TABLE IF NOT EXISTS coverage_sessions (\n    id TEXT PRIMARY KEY,\n    target_path TEXT NOT NULL,\n    agent_id TEXT NOT NULL,\n    technique TEXT NOT NULL,\n    before_lines REAL DEFAULT 0,\n    before_branches REAL DEFAULT 0,\n    before_functions REAL DEFAULT 0,\n    after_lines REAL DEFAULT 0,\n    after_branches REAL DEFAULT 0,\n    after_functions REAL DEFAULT 0,\n    tests_generated INTEGER DEFAULT 0,\n    tests_passed INTEGER DEFAULT 0,\n    gaps_json TEXT,\n    duration_ms REAL NOT NULL,\n    started_at TEXT NOT NULL,\n    completed_at TEXT NOT NULL,\n    context_json TEXT,\n    created_at TEXT DEFAULT (datetime('now'))\n  );\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_technique ON coverage_sessions(technique);\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_agent ON coverage_sessions(agent_id);\n  CREATE INDEX IF NOT EXISTS idx_coverage_sessions_created ON coverage_sessions(created_at);\n";
 export declare const STATS_TABLES: string[];
 //# sourceMappingURL=unified-memory-schemas.d.ts.map

package/dist/kernel/unified-memory-schemas.js

@@ -551,10 +551,12 @@ export const FEEDBACK_SCHEMA = `
     quality_score REAL NOT NULL,
     duration_ms REAL NOT NULL,
     error TEXT,
+    model_tier TEXT,
     created_at TEXT DEFAULT (datetime('now'))
   );
   CREATE INDEX IF NOT EXISTS idx_routing_outcomes_agent ON routing_outcomes(used_agent);
   CREATE INDEX IF NOT EXISTS idx_routing_outcomes_created ON routing_outcomes(created_at);
+  CREATE INDEX IF NOT EXISTS idx_routing_outcomes_tier ON routing_outcomes(model_tier);
 
   -- Coverage sessions (ADR-023: Coverage Learning)
   CREATE TABLE IF NOT EXISTS coverage_sessions (

package/dist/kernel/unified-memory.js

@@ -25,6 +25,7 @@ import Database from 'better-sqlite3';
 import { safeJsonParse } from '../shared/safe-json.js';
 import { toErrorMessage } from '../shared/error-utils.js';
 import * as fs from 'fs';
+import * as os from 'os';
 import * as path from 'path';
 import { MEMORY_CONSTANTS } from './constants.js';
 import { LoggerFactory } from '../logging/index.js';
@@ -207,6 +208,11 @@ export class UnifiedMemoryManager {
             UnifiedMemoryManager.instance = null;
         }
         UnifiedMemoryManager.instancePromise = null;
+        // CRITICAL: Clear the cached project root so the next getInstance() call
+        // re-reads AQE_PROJECT_ROOT from the environment. Without this, tests that
+        // call resetUnifiedMemory() would still use the stale cached path, potentially
+        // opening the production database instead of the test database.
+        clearProjectRootCache();
     }
     async initialize() {
         if (this.initialized)
@@ -220,6 +226,25 @@ export class UnifiedMemoryManager {
         if (this.initialized)
             return;
         try {
+            // SAFETY: Detect test processes trying to open the production DB.
+            // If AQE_PROJECT_ROOT is set to a temp dir (vitest isolation) but the
+            // dbPath resolves to the REAL project's .agentic-qe/memory.db, redirect.
+            // Only redirect production paths — leave explicitly-set temp paths alone.
+            const envRoot = process.env.AQE_PROJECT_ROOT;
+            if (envRoot) {
+                const resolvedPath = path.resolve(this.config.dbPath);
+                const resolvedRoot = path.resolve(envRoot);
+                // Only redirect if path points OUTSIDE the env root AND into a real
+                // .agentic-qe directory (not another temp test dir)
+                if (!resolvedPath.startsWith(resolvedRoot) &&
+                    !resolvedPath.startsWith(os.tmpdir()) &&
+                    resolvedPath.includes('.agentic-qe')) {
+                    console.error(`[UnifiedMemory] WARNING: DB path "${this.config.dbPath}" points to a ` +
+                        `production .agentic-qe/ while AQE_PROJECT_ROOT="${envRoot}". ` +
+                        `Redirecting to test-safe path.`);
+                    this.config.dbPath = path.join(envRoot, '.agentic-qe', 'memory.db');
+                }
+            }
             const dir = path.dirname(this.config.dbPath);
             if (!fs.existsSync(dir)) {
                 fs.mkdirSync(dir, { recursive: true });

package/dist/learning/experience-capture-middleware.js

@@ -268,11 +268,35 @@ async function persistExperience(context, outcome) {
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), ?)
     `);
         stmt.run(outcome.id, context.task, context.agent, context.domain, outcome.success ? 1 : 0, outcome.quality, outcome.durationMs, context.modelTier || null, safeJsonStringify(context.routing), safeJsonStringify(outcome.steps), safeJsonStringify(outcome.result), outcome.error || null, context.startedAt.toISOString(), 'middleware');
+        // Fire-and-forget: compute and store embedding for this experience
+        computeExperienceEmbedding(db, outcome.id, context.task, context.domain).catch(() => { });
     }
     catch (error) {
         console.error('[ExperienceCaptureMiddleware] Failed to persist experience:', error);
     }
 }
+/**
+ * Compute and store embedding for a captured experience (async, non-blocking).
+ * Uses the shared ONNX transformer model (all-MiniLM-L6-v2, 384-dim).
+ */
+async function computeExperienceEmbedding(db, experienceId, task, domain) {
+    try {
+        const { computeRealEmbedding } = await import('./real-embeddings.js');
+        const text = `${domain}: ${task}`.slice(0, 512); // Cap input length
+        const embedding = await computeRealEmbedding(text);
+        if (!embedding || embedding.length === 0)
+            return;
+        const buffer = Buffer.from(new Float32Array(embedding).buffer);
+        db.prepare(`
+      UPDATE captured_experiences
+      SET embedding = ?, embedding_dimension = ?
+      WHERE id = ? AND embedding IS NULL
+    `).run(buffer, embedding.length, experienceId);
+    }
+    catch {
+        // Non-critical — embedding will be backfilled later if needed
+    }
+}
 /**
  * Persist to sona_patterns for learning integration
  */

package/dist/learning/sqlite-persistence.d.ts

@@ -93,6 +93,9 @@ export declare class SQLitePatternStore {
         id: string;
         ftsScore: number;
     }>;
+    /** Last FTS5 search latency in ms, for instrumentation */
+    private _lastFtsLatencyMs;
+    get lastFtsLatencyMs(): number;
     /**
      * Ghost pattern check: find patterns in SQLite that have no embeddings.
      * Used by aqe_health to detect data integrity issues.

package/dist/learning/sqlite-persistence.js

@@ -417,6 +417,7 @@ export class SQLitePatternStore {
         // Sanitize: wrap in double quotes to force literal phrase match,
         // escaping any internal double quotes to prevent FTS5 syntax injection
         const sanitized = '"' + query.replace(/"/g, '""') + '"';
+        const start = performance.now();
         try {
             const rows = this.db.prepare(`
         SELECT p.id, rank AS fts_score
@@ -426,6 +427,11 @@ export class SQLitePatternStore {
         ORDER BY rank
         LIMIT ?
       `).all(sanitized, limit);
+            const elapsed = performance.now() - start;
+            if (elapsed > 50) {
+                console.warn(`[FTS5] searchFTS took ${elapsed.toFixed(1)}ms (results=${rows.length})`);
+            }
+            this._lastFtsLatencyMs = elapsed;
             // FTS5 rank is negative (lower = better), normalize to 0..1
             // Use Math.max(maxScore, 1.0) to prevent single-result inflation:
             // without this, a single FTS5 result always normalizes to 1.0
@@ -440,6 +446,9 @@ export class SQLitePatternStore {
             return [];
         }
     }
+    /** Last FTS5 search latency in ms, for instrumentation */
+    _lastFtsLatencyMs = 0;
+    get lastFtsLatencyMs() { return this._lastFtsLatencyMs; }
     /**
      * Ghost pattern check: find patterns in SQLite that have no embeddings.
      * Used by aqe_health to detect data integrity issues.

package/dist/learning/token-tracker.js

@@ -83,6 +83,9 @@ class TokenMetricsCollectorImpl {
         if (config) {
             this.costConfig = { ...DEFAULT_COST_CONFIG, ...config };
         }
+        // Activate DB-backed persistence and auto-save timer
+        this.initializeDb().catch(() => { });
+        this.startAutoSave();
     }
     /**
      * Set cost configuration for token pricing.
@@ -146,6 +149,7 @@ class TokenMetricsCollectorImpl {
         }
         // Mark as dirty for persistence
         this.isDirty = true;
+        this.maybePersistToKv();
     }
     /**
      * Record pattern reuse for a task (tokens saved by skipping LLM call).