@yasserkhanorg/impact-gate 2.0.0 → 2.1.0

package/README.md

@@ -63,7 +63,7 @@ The fastest way to evaluate the package is the deterministic CI path. These comm
 Install the package:
 
 ```bash
-npm install @yasserkhanorg/impact-gate
+npm install -D @yasserkhanorg/impact-gate
 ```
 
 Requires Node.js >= 20. Ships both CommonJS and ESM builds.

package/dist/cli/commands/install_skill.d.ts

@@ -0,0 +1,2 @@
+export declare function runInstallSkillCommand(skillName?: string): void;
+//# sourceMappingURL=install_skill.d.ts.map

package/dist/cli/commands/install_skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install_skill.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install_skill.ts"],"names":[],"mappings":"AAsBA,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CA8C/D"}

package/dist/cli/commands/install_skill.js

@@ -0,0 +1,60 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInstallSkillCommand = runInstallSkillCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// skills/ lives at the package root, two levels up from dist/cli/commands/
+const SKILLS_SOURCE = (0, path_1.join)(__dirname, '..', '..', '..', 'skills');
+function getSkillsDir() {
+    if ((0, fs_1.existsSync)(SKILLS_SOURCE)) {
+        return SKILLS_SOURCE;
+    }
+    throw new Error('Could not find skills/ directory in the impact-gate package. Reinstall with: npm install @yasserkhanorg/impact-gate');
+}
+function listAvailableSkills(skillsDir) {
+    return (0, fs_1.readdirSync)(skillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && (0, fs_1.existsSync)((0, path_1.join)(skillsDir, d.name, 'SKILL.md')))
+        .map((d) => d.name);
+}
+function runInstallSkillCommand(skillName) {
+    const targetDir = process.cwd();
+    const claudeSkillsDir = (0, path_1.join)(targetDir, '.claude', 'skills');
+    const skillsDir = getSkillsDir();
+    const available = listAvailableSkills(skillsDir);
+    if (!skillName) {
+        // List available skills
+        console.log('');
+        console.log('  Available skills:');
+        console.log('');
+        for (const name of available) {
+            const installed = (0, fs_1.existsSync)((0, path_1.join)(claudeSkillsDir, name, 'SKILL.md'));
+            const status = installed ? ' (installed)' : '';
+            console.log(`    /${name}${status}`);
+        }
+        console.log('');
+        console.log('  Usage: impact-gate install-skill <name>');
+        console.log('  Example: impact-gate install-skill qa');
+        console.log('');
+        return;
+    }
+    if (!available.includes(skillName)) {
+        console.error(`Unknown skill: "${skillName}". Available: ${available.join(', ')}`);
+        process.exit(1);
+    }
+    const source = (0, path_1.join)(skillsDir, skillName);
+    const dest = (0, path_1.join)(claudeSkillsDir, skillName);
+    if ((0, fs_1.existsSync)((0, path_1.join)(dest, 'SKILL.md'))) {
+        console.log(`  /${skillName} is already installed at .claude/skills/${skillName}/`);
+        console.log('  To reinstall, remove the directory first and re-run.');
+        return;
+    }
+    (0, fs_1.mkdirSync)(dest, { recursive: true });
+    (0, fs_1.cpSync)(source, dest, { recursive: true });
+    console.log('');
+    console.log(`  Installed /${skillName} → .claude/skills/${skillName}/`);
+    console.log('');
+    console.log('  You can now use /' + skillName + ' in Claude Code.');
+    console.log('');
+}

package/dist/cli/parse_args.js

@@ -168,7 +168,7 @@ const COMMANDS = new Set([
     'finalize-generated-tests', 'feedback',
     'traceability-capture', 'traceability-ingest',
     'analyze', 'llm-health', 'train', 'crew', 'cost-report', 'gate',
-    'bootstrap',
+    'bootstrap', 'install-skill',
 ]);
 // ---------------------------------------------------------------------------
 // Parser

package/dist/cli/types.d.ts

@@ -1,5 +1,5 @@
 import type { AnalysisProfile, FrameworkType } from '../agent/config.js';
-export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train' | 'crew' | 'cost-report' | 'gate' | 'bootstrap';
+export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train' | 'crew' | 'cost-report' | 'gate' | 'bootstrap' | 'install-skill';
 export interface ParsedArgs {
     command?: Command;
     configPath?: string;

package/dist/cli/types.d.ts.map

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

package/dist/cli/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CAyGjC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CA0GjC"}

package/dist/cli/usage.js

@@ -24,6 +24,7 @@ function printUsage() {
         '  init [--yes]',
         '  train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
         '  bootstrap --path <app-root> [options]',
+        '  install-skill [name]        Install a Claude Code skill (e.g. /qa)',
         '  feedback --path <app-root> --feedback-input <json>',
         '  traceability-capture --path <app-root> --traceability-report <json>',
         '  traceability-ingest --path <app-root> --traceability-input <json>',

package/dist/cli.js

@@ -22,9 +22,10 @@ const crew_js_1 = require("./cli/commands/crew.js");
 const cost_report_js_1 = require("./cli/commands/cost_report.js");
 const gate_js_1 = require("./cli/commands/gate.js");
 const bootstrap_js_1 = require("./cli/commands/bootstrap.js");
+const install_skill_js_1 = require("./cli/commands/install_skill.js");
 const errors_js_1 = require("./cli/errors.js");
 // Commands that skip default resolution (they handle their own setup)
-const SKIP_DEFAULTS_COMMANDS = new Set(['init', 'llm-health', 'cost-report', 'bootstrap']);
+const SKIP_DEFAULTS_COMMANDS = new Set(['init', 'llm-health', 'cost-report', 'bootstrap', 'install-skill']);
 // Commands that need path/testsRoot/framework/since
 const NEEDS_DEFAULTS_COMMANDS = new Set([
     'impact', 'plan', 'suggest', 'crew', 'generate', 'heal', 'analyze', 'train',
@@ -51,6 +52,11 @@ async function main() {
         await (0, init_js_1.runInitCommand)(hasYes);
         return;
     }
+    if (args.command === 'install-skill') {
+        const skillName = process.argv[3]; // impact-gate install-skill <name>
+        (0, install_skill_js_1.runInstallSkillCommand)(skillName);
+        return;
+    }
     if (args.command === 'bootstrap') {
         await (0, bootstrap_js_1.runBootstrapCommand)(args);
         return;

package/dist/esm/cli/commands/install_skill.js

@@ -0,0 +1,57 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { existsSync, mkdirSync, cpSync, readdirSync } from 'fs';
+import { join } from 'path';
+// skills/ lives at the package root, two levels up from dist/cli/commands/
+const SKILLS_SOURCE = join(__dirname, '..', '..', '..', 'skills');
+function getSkillsDir() {
+    if (existsSync(SKILLS_SOURCE)) {
+        return SKILLS_SOURCE;
+    }
+    throw new Error('Could not find skills/ directory in the impact-gate package. Reinstall with: npm install @yasserkhanorg/impact-gate');
+}
+function listAvailableSkills(skillsDir) {
+    return readdirSync(skillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory() && existsSync(join(skillsDir, d.name, 'SKILL.md')))
+        .map((d) => d.name);
+}
+export function runInstallSkillCommand(skillName) {
+    const targetDir = process.cwd();
+    const claudeSkillsDir = join(targetDir, '.claude', 'skills');
+    const skillsDir = getSkillsDir();
+    const available = listAvailableSkills(skillsDir);
+    if (!skillName) {
+        // List available skills
+        console.log('');
+        console.log('  Available skills:');
+        console.log('');
+        for (const name of available) {
+            const installed = existsSync(join(claudeSkillsDir, name, 'SKILL.md'));
+            const status = installed ? ' (installed)' : '';
+            console.log(`    /${name}${status}`);
+        }
+        console.log('');
+        console.log('  Usage: impact-gate install-skill <name>');
+        console.log('  Example: impact-gate install-skill qa');
+        console.log('');
+        return;
+    }
+    if (!available.includes(skillName)) {
+        console.error(`Unknown skill: "${skillName}". Available: ${available.join(', ')}`);
+        process.exit(1);
+    }
+    const source = join(skillsDir, skillName);
+    const dest = join(claudeSkillsDir, skillName);
+    if (existsSync(join(dest, 'SKILL.md'))) {
+        console.log(`  /${skillName} is already installed at .claude/skills/${skillName}/`);
+        console.log('  To reinstall, remove the directory first and re-run.');
+        return;
+    }
+    mkdirSync(dest, { recursive: true });
+    cpSync(source, dest, { recursive: true });
+    console.log('');
+    console.log(`  Installed /${skillName} → .claude/skills/${skillName}/`);
+    console.log('');
+    console.log('  You can now use /' + skillName + ' in Claude Code.');
+    console.log('');
+}

package/dist/esm/cli/parse_args.js

@@ -162,7 +162,7 @@ const COMMANDS = new Set([
     'finalize-generated-tests', 'feedback',
     'traceability-capture', 'traceability-ingest',
     'analyze', 'llm-health', 'train', 'crew', 'cost-report', 'gate',
-    'bootstrap',
+    'bootstrap', 'install-skill',
 ]);
 // ---------------------------------------------------------------------------
 // Parser

package/dist/esm/cli/usage.js

@@ -21,6 +21,7 @@ export function printUsage() {
         '  init [--yes]',
         '  train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
         '  bootstrap --path <app-root> [options]',
+        '  install-skill [name]        Install a Claude Code skill (e.g. /qa)',
         '  feedback --path <app-root> --feedback-input <json>',
         '  traceability-capture --path <app-root> --traceability-report <json>',
         '  traceability-ingest --path <app-root> --traceability-input <json>',

package/dist/esm/cli.js

@@ -20,9 +20,10 @@ import { runCrewCommand } from './cli/commands/crew.js';
 import { runCostReportCommand } from './cli/commands/cost_report.js';
 import { runGateCommand } from './cli/commands/gate.js';
 import { runBootstrapCommand } from './cli/commands/bootstrap.js';
+import { runInstallSkillCommand } from './cli/commands/install_skill.js';
 import { classifyError, EXIT_CODES } from './cli/errors.js';
 // Commands that skip default resolution (they handle their own setup)
-const SKIP_DEFAULTS_COMMANDS = new Set(['init', 'llm-health', 'cost-report', 'bootstrap']);
+const SKIP_DEFAULTS_COMMANDS = new Set(['init', 'llm-health', 'cost-report', 'bootstrap', 'install-skill']);
 // Commands that need path/testsRoot/framework/since
 const NEEDS_DEFAULTS_COMMANDS = new Set([
     'impact', 'plan', 'suggest', 'crew', 'generate', 'heal', 'analyze', 'train',
@@ -49,6 +50,11 @@ async function main() {
         await runInitCommand(hasYes);
         return;
     }
+    if (args.command === 'install-skill') {
+        const skillName = process.argv[3]; // impact-gate install-skill <name>
+        runInstallSkillCommand(skillName);
+        return;
+    }
     if (args.command === 'bootstrap') {
         await runBootstrapCommand(args);
         return;

package/dist/esm/qa-agent/cli.js

@@ -7,6 +7,7 @@ const MODES = new Set(['pr', 'hunt', 'fix', 'release']);
 const KNOWN_FLAGS = new Set([
     '--base-url', '--since', '--phase', '--time', '--budget',
     '--headed', '--tests-root', '--project', '--output', '--help', '-h',
+    '--fix-tier', '--no-fix', '--regression',
 ]);
 function printUsage() {
     console.log(`
@@ -28,6 +29,9 @@ Options:
   --tests-root <path>   Path to tests directory
   --project <name>      Playwright project name
   --output <dir>        Output directory (default: .e2e-ai-agents)
+  --fix-tier <tier>     Fix tier: quick (critical+high), standard (+medium), exhaustive (+low) (default: standard)
+  --no-fix              Skip the fix loop (Phase 2.5)
+  --regression          Compare against previous baseline
   --help                Show this help
 
 Examples:
@@ -59,6 +63,9 @@ function parseCliArgs(argv) {
     let testsRoot;
     let project;
     let outputDir;
+    let fixTier = 'standard';
+    let fixEnabled = true;
+    let regression = false;
     // For hunt mode, the second positional arg is the target
     let startFlags = 1;
     if (mode === 'hunt' && argv[1] && !argv[1].startsWith('--')) {
@@ -122,6 +129,22 @@ function parseCliArgs(argv) {
                 outputDir = next;
                 i++;
                 break;
+            case '--fix-tier': {
+                const validTiers = new Set(['quick', 'standard', 'exhaustive']);
+                if (!validTiers.has(next)) {
+                    console.error(`Error: --fix-tier must be quick, standard, or exhaustive (got "${next}")`);
+                    process.exit(1);
+                }
+                fixTier = next;
+                i++;
+                break;
+            }
+            case '--no-fix':
+                fixEnabled = false;
+                break;
+            case '--regression':
+                regression = true;
+                break;
             default:
                 if (arg.startsWith('--') && !KNOWN_FLAGS.has(arg)) {
                     console.error(`Warning: unknown flag "${arg}" (ignored)`);
@@ -178,6 +201,9 @@ function parseCliArgs(argv) {
         testsRoot,
         project,
         outputDir,
+        fixTier,
+        fixEnabled,
+        regression,
     };
 }
 async function main() {

package/dist/esm/qa-agent/finding_taxonomy.js

@@ -0,0 +1,102 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+// ---------------------------------------------------------------------------
+// Legacy type → canonical category mapping
+// ---------------------------------------------------------------------------
+const LEGACY_TO_CATEGORY = {
+    'bug': 'functional',
+    'gap': 'functional',
+    'visual-regression': 'visual',
+    'ux-issue': 'ux',
+};
+const CANONICAL_CATEGORIES = new Set([
+    'visual', 'functional', 'ux', 'content', 'performance', 'console', 'accessibility',
+]);
+/**
+ * Normalize any FindingType (legacy or canonical) to a canonical FindingCategory.
+ * Returns 'functional' for unrecognized types.
+ */
+export function normalizeFindingType(raw) {
+    if (CANONICAL_CATEGORIES.has(raw)) {
+        return raw;
+    }
+    return LEGACY_TO_CATEGORY[raw] ?? 'functional';
+}
+/**
+ * Map a FindingType to its HealthScoreCategory.
+ * Same logic as normalizeFindingType — the category names match.
+ */
+export function normalizeFindingCategory(type) {
+    if (type === 'verified-ok') {
+        return 'functional';
+    }
+    return normalizeFindingType(type);
+}
+// ---------------------------------------------------------------------------
+// Severity definitions
+// ---------------------------------------------------------------------------
+export const SEVERITY_DEFINITIONS = {
+    critical: 'Blocks a core workflow, causes data loss, or crashes the app. Examples: form submit error page, checkout broken, data deleted without confirmation.',
+    high: 'Major feature broken or unusable, no workaround. Examples: search returns wrong results, file upload silently fails, auth redirect loop.',
+    medium: 'Feature works but with noticeable problems, workaround exists. Examples: slow page load (>5s), missing form validation, layout broken on mobile only.',
+    low: 'Minor cosmetic or polish issue. Examples: typo in footer, 1px alignment, hover state inconsistent.',
+    info: 'Observation or suggestion, not a defect. Examples: missing alt text noted, potential optimization.',
+};
+// ---------------------------------------------------------------------------
+// Category definitions
+// ---------------------------------------------------------------------------
+export const CATEGORY_DEFINITIONS = {
+    visual: {
+        label: 'Visual/UI',
+        description: 'Layout breaks, broken images, z-index issues, font/color inconsistencies, animation glitches, alignment issues, dark mode problems.',
+        examples: ['Overlapping elements', 'Clipped text', 'Horizontal scrollbar', 'Incorrect z-index'],
+    },
+    functional: {
+        label: 'Functional',
+        description: 'Broken links, dead buttons, form validation failures, incorrect redirects, state not persisting, race conditions.',
+        examples: ['404 links', 'Click does nothing', 'Form bypasses validation', 'Data lost on refresh'],
+    },
+    ux: {
+        label: 'UX',
+        description: 'Confusing navigation, missing loading indicators, slow interactions, unclear error messages, no destructive-action confirmation.',
+        examples: ['No breadcrumbs', 'No loading spinner', '>500ms with no feedback', '"Something went wrong" with no detail'],
+    },
+    content: {
+        label: 'Content',
+        description: 'Typos, grammar errors, outdated text, placeholder/lorem ipsum left in, truncated text, wrong labels.',
+        examples: ['Typo in heading', 'Lorem ipsum visible', 'Button label says "Submit" instead of "Save"'],
+    },
+    performance: {
+        label: 'Performance',
+        description: 'Slow page loads (>3s), janky scrolling, layout shifts, excessive network requests, large unoptimized images.',
+        examples: ['Page takes 5s to load', 'Content jumping after load', '>50 network requests'],
+    },
+    console: {
+        label: 'Console/Errors',
+        description: 'JavaScript exceptions, failed network requests (4xx/5xx), deprecation warnings, CORS errors, mixed content.',
+        examples: ['Uncaught TypeError', '500 on API call', 'CORS blocked', 'Mixed content warning'],
+    },
+    accessibility: {
+        label: 'Accessibility',
+        description: 'Missing alt text, unlabeled inputs, broken keyboard navigation, focus traps, missing ARIA attributes, insufficient contrast.',
+        examples: ['Image without alt', 'Can\'t tab to button', 'Modal focus trap', 'Low contrast text'],
+    },
+};
+// ---------------------------------------------------------------------------
+// Fix eligibility
+// ---------------------------------------------------------------------------
+const TIER_SEVERITIES = {
+    quick: new Set(['critical', 'high']),
+    standard: new Set(['critical', 'high', 'medium']),
+    exhaustive: new Set(['critical', 'high', 'medium', 'low']),
+};
+/**
+ * Determine whether a finding should be fixed based on the selected tier.
+ * 'info' severity and 'verified-ok' type are never fixable.
+ */
+export function isFixable(finding, tier) {
+    if (finding.type === 'verified-ok' || finding.severity === 'info') {
+        return false;
+    }
+    return TIER_SEVERITIES[tier].has(finding.severity);
+}

package/dist/esm/qa-agent/health_score.js

@@ -0,0 +1,99 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { normalizeFindingCategory } from './finding_taxonomy.js';
+// ---------------------------------------------------------------------------
+// Category weights (must sum to 1.0)
+// ---------------------------------------------------------------------------
+const CATEGORY_WEIGHTS = {
+    console: 0.15,
+    links: 0.10,
+    visual: 0.10,
+    functional: 0.20,
+    ux: 0.15,
+    performance: 0.10,
+    content: 0.05,
+    accessibility: 0.15,
+};
+// ---------------------------------------------------------------------------
+// Severity deductions
+// ---------------------------------------------------------------------------
+const SEVERITY_DEDUCTIONS = {
+    critical: 25,
+    high: 15,
+    medium: 8,
+    low: 3,
+    info: 0,
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Map a finding to its health-score category.
+ * Handles both canonical categories and legacy finding types.
+ */
+export function mapFindingToCategory(finding) {
+    return normalizeFindingCategory(finding.type);
+}
+/**
+ * Compute a weighted health score (0-100) from a set of findings.
+ *
+ * Each of 8 categories starts at 100. Per finding, deduct based on severity
+ * (critical -25, high -15, medium -8, low -3). Clamp each category at 0.
+ * Overall = sum(category_score * weight).
+ */
+export function computeHealthScore(findings) {
+    // Initialize per-category state
+    const categoryState = {
+        console: { score: 100, findings: [] },
+        links: { score: 100, findings: [] },
+        visual: { score: 100, findings: [] },
+        functional: { score: 100, findings: [] },
+        ux: { score: 100, findings: [] },
+        performance: { score: 100, findings: [] },
+        content: { score: 100, findings: [] },
+        accessibility: { score: 100, findings: [] },
+    };
+    // Apply deductions
+    for (const finding of findings) {
+        if (finding.type === 'verified-ok') {
+            continue;
+        }
+        const category = mapFindingToCategory(finding);
+        const deduction = SEVERITY_DEDUCTIONS[finding.severity] ?? 0;
+        categoryState[category].score = Math.max(0, categoryState[category].score - deduction);
+        categoryState[category].findings.push(finding.id);
+    }
+    // Build category scores
+    const categories = Object.keys(CATEGORY_WEIGHTS).map((cat) => ({
+        category: cat,
+        score: categoryState[cat].score,
+        weight: CATEGORY_WEIGHTS[cat],
+        findings: categoryState[cat].findings,
+    }));
+    // Compute weighted overall
+    const overall = Math.round(categories.reduce((sum, c) => sum + c.score * c.weight, 0));
+    return {
+        overall,
+        categories,
+        computedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Render a health score as a markdown table.
+ */
+export function formatHealthScoreMarkdown(score) {
+    const lines = [
+        `## Health Score: ${score.overall}/100`,
+        '',
+        '| Category | Score | Weight | Issues |',
+        '|----------|-------|--------|--------|',
+    ];
+    for (const cat of score.categories) {
+        const pct = `${Math.round(cat.weight * 100)}%`;
+        lines.push(`| ${capitalize(cat.category)} | ${cat.score} | ${pct} | ${cat.findings.length} |`);
+    }
+    return lines.join('\n');
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}

package/dist/esm/qa-agent/orchestrator.js

@@ -5,10 +5,14 @@ import { mkdirSync } from 'fs';
 import { logger } from '../logger.js';
 import { runPhase1 } from './phase1/runner.js';
 import { runAgentLoop } from './phase2/agent_loop.js';
+import { AgentBrowser } from './phase2/agent_browser.js';
 import { computeVerdict } from './phase3/verdict.js';
 import { generateReport } from './phase3/reporter.js';
 import { generateSpecsForFindings } from './phase3/spec_generator.js';
 import { submitFeedback } from './phase3/feedback.js';
+import { computeHealthScore } from './health_score.js';
+import { runFixLoop } from './phase25/fix_loop.js';
+import { saveBaseline, loadBaseline, compareBaselines } from './regression/baseline.js';
 function emptyPhase2Result() {
     return { findings: [], flowsExplored: [], actionsCount: 0, tokensUsed: 0, costUSD: 0, durationMs: 0 };
 }
@@ -76,15 +80,64 @@ export async function runQAAgent(inputConfig) {
         return earlyReturn(config, phase1, phase2);
     }
     // -----------------------------------------------------------------------
+    // Phase 2.5: Fix Loop (optional)
+    // -----------------------------------------------------------------------
+    let phase25;
+    let healthScore = phase2.healthScore || computeHealthScore(phase2.findings);
+    if (config.fixEnabled !== false && phase2.findings.length > 0) {
+        logger.info('=== Phase 2.5: Fix Loop ===');
+        // Create a browser instance for the fix loop to verify fixes
+        const fixBrowser = new AgentBrowser({ session: config.headed ? 'qa-fix-headed' : undefined });
+        try {
+            const projectRoot = execFileSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf-8' }).trim();
+            phase25 = await runFixLoop(config, phase2.findings, fixBrowser, projectRoot);
+            healthScore = phase25.healthScoreAfter;
+            logger.info('Phase 2.5 complete', {
+                attempted: phase25.fixesAttempted,
+                verified: phase25.fixesVerified,
+                reverted: phase25.fixesReverted,
+                scoreDelta: `${phase25.healthScoreBefore.overall} → ${phase25.healthScoreAfter.overall}`,
+            });
+        }
+        catch (err) {
+            logger.warn('Phase 2.5 failed, continuing without fixes', { error: String(err) });
+        }
+        finally {
+            if (!config.headed) {
+                fixBrowser.close();
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Regression comparison (optional)
+    // -----------------------------------------------------------------------
+    let regressionComparison;
+    if (config.regression) {
+        const baseline = loadBaseline(outputDir);
+        if (baseline) {
+            regressionComparison = compareBaselines(healthScore, phase2.findings, baseline);
+            logger.info('Regression comparison', {
+                scoreDelta: regressionComparison.scoreDelta,
+                fixedIssues: regressionComparison.fixedIssues.length,
+                newIssues: regressionComparison.newIssues.length,
+            });
+        }
+        else {
+            logger.info('No baseline found — saving current run as baseline');
+        }
+    }
+    // Always save baseline for future comparisons
+    saveBaseline(outputDir, healthScore, phase2.findings, config.baseUrl);
+    // -----------------------------------------------------------------------
     // Phase 3: Report + Spec Generation + Verdict
     // -----------------------------------------------------------------------
     logger.info('=== Phase 3: Report & Verdict ===');
     // Generate specs for discovered bugs
     const generatedSpecs = generateSpecsForFindings(phase2.findings, config);
-    // Compute verdict
-    const verdict = computeVerdict(phase1, phase2);
+    // Compute verdict (now with health score)
+    const verdict = computeVerdict(phase1, phase2, healthScore, phase25);
     // Generate report
-    const phase3 = generateReport(config, phase1, phase2, verdict, generatedSpecs);
+    const phase3 = generateReport(config, phase1, phase2, verdict, generatedSpecs, phase25, healthScore, regressionComparison);
     // Submit feedback
     try {
         submitFeedback(config);
@@ -94,27 +147,32 @@ export async function runQAAgent(inputConfig) {
     }
     logger.info(`=== QA Agent Complete: ${verdict.decision.toUpperCase()} ===`);
     logger.info(verdict.reason);
-    return buildQAReport(config, phase1, phase2, phase3, verdict);
+    return buildQAReport(config, phase1, phase2, phase3, verdict, phase25, healthScore, regressionComparison);
 }
 function earlyReturn(config, phase1, phase2) {
     const p2 = phase2 || emptyPhase2Result();
-    const verdict = computeVerdict(phase1, p2);
-    const phase3 = generateReport(config, phase1, p2, verdict, []);
-    return buildQAReport(config, phase1, p2, phase3, verdict);
+    const healthScore = computeHealthScore(p2.findings);
+    const verdict = computeVerdict(phase1, p2, healthScore);
+    const phase3 = generateReport(config, phase1, p2, verdict, [], undefined, healthScore);
+    return buildQAReport(config, phase1, p2, phase3, verdict, undefined, healthScore);
 }
-function buildQAReport(config, phase1, phase2, phase3, verdict) {
+function buildQAReport(config, phase1, phase2, phase3, verdict, phase25, healthScore, regressionComparison) {
     return {
-        schemaVersion: '1.0.0',
+        schemaVersion: '1.1.0',
         generatedAt: new Date().toISOString(),
         mode: config.mode,
         config: {
             baseUrl: config.baseUrl,
             timeLimitMinutes: config.timeLimitMinutes,
             budgetUSD: config.budgetUSD,
+            fixTier: config.fixTier,
         },
         phase1,
         phase2,
+        phase25,
         phase3,
         verdict,
+        healthScore,
+        regressionComparison,
     };
 }