agentic-qe 3.9.8 → 3.9.10

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 { installBrowserEngine } from '../browser-engine-installer.js';
 import { initializeOverlays } from '../../routing/qe-agent-registry.js';
 /**
  * Assets phase - installs skills and agents
@@ -74,6 +75,69 @@ export class AssetsPhase extends BasePhase {
         }
         // Initialize overlay configs in agent registry for runtime use
         initializeOverlays(projectRoot);
+        // Install Vibium browser engine for the qe-browser fleet skill.
+        // Graceful — never fails init if Vibium cannot be installed.
+        // Skipped in --minimal mode per ADR-086 minimal-footprint guidance.
+        //
+        // H6 (devil's-advocate finding): the install can take up to 3 minutes
+        // on cold caches because npm downloads Vibium AND lazily downloads a
+        // Chrome for Testing binary. spawnSync blocks the event loop, so the
+        // user sees no output for the entire duration. We log a clear pre-spawn
+        // message so users don't Ctrl-C thinking init hung. Future work: move
+        // this to a lazy/on-first-use install path so non-browser users never
+        // pay the cost.
+        let browserEngine;
+        if (!options.minimal) {
+            try {
+                // Pre-flight check: if vibium is already on PATH, skip the loud
+                // banner so we don't scare users on the common path.
+                const alreadyHere = installBrowserEngine({
+                    skip: false,
+                    // Use a tiny timeout for the pre-flight detect-only call. The
+                    // installer will short-circuit on already-installed without
+                    // ever invoking npm.
+                    timeoutMs: 5_000,
+                });
+                if (alreadyHere.status === 'already-installed') {
+                    browserEngine = alreadyHere;
+                    context.services.log(`  Browser engine: vibium ${browserEngine.version} (already installed)`);
+                }
+                else {
+                    // Not installed → we're about to spawn `npm install -g vibium`
+                    // which can take 1–3 minutes on a cold cache. Tell the user.
+                    context.services.log('  Browser engine: installing vibium via npm (this can take 1–3 minutes on first run; downloads Chrome for Testing lazily)…');
+                    browserEngine = installBrowserEngine({ skip: false });
+                    switch (browserEngine.status) {
+                        case 'installed':
+                            context.services.log(`  Browser engine: vibium ${browserEngine.version} installed`);
+                            break;
+                        case 'skipped':
+                            context.services.log('  Browser engine: skipped');
+                            break;
+                        case 'install-failed':
+                            context.services.warn(`Browser engine install failed (qe-browser skill will be unavailable until you run \`npm install -g vibium\`): ${browserEngine.message || 'unknown'}`);
+                            break;
+                        case 'npm-unavailable':
+                            context.services.warn('Browser engine: npm not on PATH — install Node.js + npm, then `npm install -g vibium` to enable qe-browser');
+                            break;
+                        // 'already-installed' handled by the pre-flight branch above
+                    }
+                }
+            }
+            catch (error) {
+                // M9 (devil's-advocate finding): the previous catch re-emitted the
+                // raw error with no recovery path. Tell the user what's broken
+                // AND how to recover so they aren't left guessing.
+                const msg = error instanceof Error ? error.message : String(error);
+                context.services.warn(`Browser engine install error: ${msg}\n` +
+                    `  qe-browser fleet skill will be unavailable until you run:\n` +
+                    `    npm install -g vibium\n` +
+                    `  Then re-run \`aqe init\` to verify. The rest of the AQE install will continue.`);
+            }
+        }
+        else {
+            browserEngine = { status: 'skipped', packageSpec: 'vibium', message: 'minimal mode' };
+        }
         // Install n8n platform (optional)
         if (options.withN8n) {
             const n8nInstaller = createN8nInstaller({
@@ -266,6 +330,7 @@ export class AssetsPhase extends BasePhase {
             kiroSkills,
             kiroHooks,
             platformsConfigured,
+            browserEngine,
         };
     }
     /**

package/dist/init/phases/12-verification.js

@@ -349,6 +349,14 @@ export class VerificationPhase extends BasePhase {
             `  confidenceThreshold: ${config.routing.confidenceThreshold}`,
             `  feedbackEnabled: ${config.routing.feedbackEnabled}`,
             '',
+            '# ADR-092: Advisor Strategy — agents consult a stronger model for strategic guidance',
+            '# Set provider/model to override auto-detection from environment API keys',
+            'advisor:',
+            '  # provider: "openrouter"        # openrouter | claude | ollama (auto-detected if not set)',
+            '  # model: "anthropic/claude-opus-4"  # provider-specific model ID',
+            '  # maxUses: "3"                  # per-task advisor call cap',
+            '  redact: "strict"                # strict | balanced | off',
+            '',
             'workers:',
             '  enabled:',
             ...config.workers.enabled.map(w => `    - "${w}"`),

package/dist/init/skills-installer.js

@@ -25,6 +25,7 @@ const V3_DOMAIN_SKILLS = [
     'qe-defect-intelligence', // ML defect prediction, root cause
     'qe-requirements-validation', // BDD scenarios, acceptance criteria
     'qe-code-intelligence', // Knowledge graphs, 80% token reduction
+    'qe-browser', // Vibium-based browser automation with QE primitives (assert, batch, visual-diff, check-injection, intent-score)
     'pentest-validation', // Graduated exploit validation (Shannon-inspired)
     'qe-visual-accessibility', // Visual regression, WCAG
     'qe-chaos-resilience', // Fault injection, resilience

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    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 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, ADR-092: advisor_consultation_json)\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    advisor_consultation_json 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

@@ -540,7 +540,7 @@ export const FEEDBACK_SCHEMA = `
   CREATE INDEX IF NOT EXISTS idx_test_outcomes_domain ON test_outcomes(domain);
   CREATE INDEX IF NOT EXISTS idx_test_outcomes_created ON test_outcomes(created_at);
 
-  -- Routing outcomes (ADR-022: Adaptive QE Agent Routing)
+  -- Routing outcomes (ADR-022: Adaptive QE Agent Routing, ADR-092: advisor_consultation_json)
   CREATE TABLE IF NOT EXISTS routing_outcomes (
     id TEXT PRIMARY KEY,
     task_json TEXT NOT NULL,
@@ -552,6 +552,7 @@ export const FEEDBACK_SCHEMA = `
     duration_ms REAL NOT NULL,
     error TEXT,
     model_tier TEXT,
+    advisor_consultation_json TEXT,
     created_at TEXT DEFAULT (datetime('now'))
   );
   CREATE INDEX IF NOT EXISTS idx_routing_outcomes_agent ON routing_outcomes(used_agent);