@tangle-network/browser-agent-driver 0.33.3 → 0.35.0

package/dist/design/audit/evolve/css.d.ts

@@ -0,0 +1,10 @@
+import type { Page } from 'playwright';
+import type { Brain } from '../../../brain/index.js';
+import type { DesignEvolveResult } from '../../../types.js';
+import type { PlaywrightDriver } from '../../../drivers/playwright.js';
+import type { SupportedProvider } from '../../../provider-defaults.js';
+import type { resolveAuditPasses } from '../evaluate.js';
+import type { PageAuditResult } from '../../../cli-design-audit.js';
+import type { ReferenceCommonOpts } from './types.js';
+export declare function runEvolveLoop(brain: Brain, driver: PlaywrightDriver, page: Page, pages: string[], profile: string, initialResults: PageAuditResult[], outputDir: string, maxRounds: number, auditPasses: ReturnType<typeof resolveAuditPasses>, parentRunId?: string, provider?: SupportedProvider, model?: string, referenceCommonOpts?: ReferenceCommonOpts): Promise<DesignEvolveResult>;
+//# sourceMappingURL=css.d.ts.map

package/dist/design/audit/evolve/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/evolve/css.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,wBAAsB,aAAa,CACjC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,eAAe,EAAE,EACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAClD,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,KAAK,CAAC,EAAE,MAAM,EACd,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAmM7B"}

package/dist/design/audit/evolve/css.js

@@ -0,0 +1,206 @@
+// ---------------------------------------------------------------------------
+// Evolve loop — audit → generate CSS fixes → inject → re-audit → compare
+// ---------------------------------------------------------------------------
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import chalk from 'chalk';
+import { auditOnePage } from '../pipeline.js';
+import { getTelemetry } from '../../../telemetry/index.js';
+export async function runEvolveLoop(brain, driver, page, pages, profile, initialResults, outputDir, maxRounds, auditPasses, parentRunId, provider, model, referenceCommonOpts) {
+    const telemetry = parentRunId ? getTelemetry() : undefined;
+    const initialAvg = initialResults.reduce((s, r) => s + r.score, 0) / initialResults.length;
+    const scoreHistory = [initialAvg];
+    const appliedFixes = [];
+    const skippedFixes = [];
+    let cumulativeCSS = '';
+    let currentResults = initialResults;
+    let currentAvg = initialAvg;
+    console.log('');
+    console.log(`  ${chalk.bold('Design Evolve')} — ${maxRounds} rounds max`);
+    console.log(`  ${chalk.dim('Initial score:')} ${currentAvg.toFixed(1)}/10`);
+    console.log('');
+    for (let round = 1; round <= maxRounds; round++) {
+        console.log(`  ${chalk.dim(`Round ${round}/${maxRounds}`)}`);
+        // Collect all findings with CSS fixes across all pages
+        const fixableFixes = currentResults
+            .flatMap(r => r.findings)
+            .filter(f => f.cssSelector && f.cssFix);
+        if (fixableFixes.length === 0) {
+            console.log(`  ${chalk.dim('  No CSS-fixable findings — generating fixes via LLM…')}`);
+            // Ask the LLM to generate CSS fixes for the top findings
+            const topFindings = currentResults
+                .flatMap(r => r.findings)
+                .filter(f => f.severity === 'critical' || f.severity === 'major')
+                .slice(0, 10);
+            if (topFindings.length === 0) {
+                console.log(`  ${chalk.green('  No major/critical findings remaining')}`);
+                break;
+            }
+            const fixPrompt = buildFixGenerationPrompt(topFindings);
+            const fixResult = await brain.auditDesign(await driver.observe(), 'Generate CSS fixes for the design issues listed below', [], fixPrompt);
+            // Parse generated fixes
+            try {
+                let text = fixResult.raw.trim();
+                if (text.startsWith('```'))
+                    text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+                const start = text.indexOf('{');
+                const end = text.lastIndexOf('}');
+                if (start >= 0 && end > start)
+                    text = text.slice(start, end + 1);
+                const parsed = JSON.parse(text);
+                if (Array.isArray(parsed.fixes)) {
+                    for (const fix of parsed.fixes) {
+                        if (fix.cssSelector && fix.cssFix) {
+                            fixableFixes.push({
+                                category: 'ux',
+                                severity: 'major',
+                                description: fix.description || '',
+                                location: fix.location || '',
+                                suggestion: fix.cssFix,
+                                cssSelector: fix.cssSelector,
+                                cssFix: fix.cssFix,
+                            });
+                        }
+                    }
+                }
+            }
+            catch { /* failed to parse fixes */ }
+        }
+        if (fixableFixes.length === 0) {
+            console.log(`  ${chalk.dim('  Could not generate fixable CSS — stopping')}`);
+            break;
+        }
+        // Build CSS override from all fixable findings
+        const roundCSS = fixableFixes
+            .map(f => `/* ${f.severity}: ${f.description?.slice(0, 80)} */\n${f.cssSelector} { ${f.cssFix} }`)
+            .join('\n\n');
+        cumulativeCSS += '\n' + roundCSS;
+        // Track applied fixes
+        for (const f of fixableFixes) {
+            appliedFixes.push({
+                cssSelector: f.cssSelector,
+                cssFix: f.cssFix,
+                finding: f.description,
+            });
+        }
+        console.log(`  ${chalk.dim(`  Applying ${fixableFixes.length} CSS fixes…`)}`);
+        // Re-audit each page with CSS injected
+        const roundResults = [];
+        for (const url of pages) {
+            try {
+                await page.goto(url, { waitUntil: 'networkidle', timeout: 20_000 }).catch(() => page.goto(url, { waitUntil: 'domcontentloaded', timeout: 15_000 }));
+                await page.waitForTimeout(1500);
+                // Inject cumulative CSS fixes
+                await page.addStyleTag({ content: cumulativeCSS });
+                await page.waitForTimeout(500);
+                // Take screenshot of fixed state
+                const screenshotDir = path.join(outputDir, `screenshots-round-${round}`);
+                fs.mkdirSync(screenshotDir, { recursive: true });
+                const result = (await auditOnePage({
+                    brain,
+                    driver,
+                    page,
+                    url,
+                    profileOverride: profile,
+                    screenshotDir,
+                    auditPasses,
+                    ...(parentRunId ? { runId: parentRunId, parentRunId } : {}),
+                    ...(provider ? { provider } : {}),
+                    ...(model ? { model } : {}),
+                    ...(referenceCommonOpts ?? {}),
+                }));
+                roundResults.push(result);
+            }
+            catch {
+                roundResults.push({
+                    url,
+                    score: currentAvg,
+                    summary: 'Re-audit failed',
+                    strengths: [],
+                    findings: [],
+                    error: 'Re-audit with CSS injection failed',
+                });
+            }
+        }
+        const roundAvg = roundResults.reduce((s, r) => s + r.score, 0) / roundResults.length;
+        scoreHistory.push(roundAvg);
+        const delta = roundAvg - currentAvg;
+        const deltaStr = delta >= 0 ? chalk.green(`+${delta.toFixed(1)}`) : chalk.red(delta.toFixed(1));
+        console.log(`  ${chalk.dim('  Score:')} ${roundAvg.toFixed(1)}/10 (${deltaStr})`);
+        if (telemetry && parentRunId) {
+            telemetry.emit({
+                kind: 'design-evolve-round',
+                runId: parentRunId,
+                parentRunId,
+                ok: true,
+                durationMs: 0, // round-level wall time would require a per-round timer; the parent run captures total duration
+                ...(provider && model ? { model: { provider, name: model } } : {}),
+                data: {
+                    mode: 'css',
+                    round,
+                    fixesApplied: fixableFixes.length,
+                },
+                metrics: {
+                    round,
+                    beforeScore: currentAvg,
+                    afterScore: roundAvg,
+                    delta,
+                    fixesApplied: fixableFixes.length,
+                },
+            });
+        }
+        currentResults = roundResults;
+        currentAvg = roundAvg;
+        // Check convergence — if no improvement, stop
+        if (delta <= 0.1 && round > 1) {
+            console.log(`  ${chalk.dim('  Converged — no further improvement')}`);
+            break;
+        }
+    }
+    const totalDelta = currentAvg - initialAvg;
+    const deltaColor = totalDelta >= 2 ? chalk.green : totalDelta > 0 ? chalk.yellow : chalk.red;
+    console.log('');
+    console.log(`  ${chalk.bold('Evolve complete')}`);
+    console.log(`  ${chalk.dim('Score:')} ${initialAvg.toFixed(1)} → ${currentAvg.toFixed(1)} (${deltaColor(`+${totalDelta.toFixed(1)}`)})`);
+    console.log(`  ${chalk.dim('Rounds:')} ${scoreHistory.length - 1}`);
+    console.log(`  ${chalk.dim('Fixes applied:')} ${appliedFixes.length}`);
+    console.log('');
+    return {
+        beforeScore: initialAvg,
+        afterScore: currentAvg,
+        delta: totalDelta,
+        rounds: scoreHistory.length - 1,
+        appliedFixes,
+        skippedFixes,
+        scoreHistory,
+        cssOverride: cumulativeCSS.trim(),
+    };
+}
+function buildFixGenerationPrompt(findings) {
+    const findingList = findings.map((f, i) => `${i + 1}. [${f.severity}/${f.category}] ${f.description}\n   Location: ${f.location}\n   Suggestion: ${f.suggestion}`).join('\n');
+    return `You are a CSS engineer fixing design issues. For each finding, generate a precise CSS fix.
+
+FINDINGS TO FIX:
+${findingList}
+
+RULES:
+- Use specific, targeted CSS selectors. Prefer class-based or semantic selectors.
+- Each fix should be a single CSS rule (selector + property:value pairs).
+- Fixes must not break other elements — be surgical.
+- For spacing: use consistent values (multiples of 4 or 8px).
+- For colors: ensure WCAG AA contrast (4.5:1 for text, 3:1 for large text).
+- For typography: use a limited scale (14px, 16px, 20px, 24px, 32px, 48px).
+
+RESPOND WITH ONLY a JSON object:
+{
+  "fixes": [
+    {
+      "cssSelector": "main > section:first-child",
+      "cssFix": "padding-bottom: 48px; margin-bottom: 0",
+      "description": "Standardize hero section bottom spacing",
+      "location": "Hero → features transition"
+    }
+  ]
+}`;
+}
+//# sourceMappingURL=css.js.map

package/dist/design/audit/evolve/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../../../src/design/audit/evolve/css.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAE9E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAI1D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAY,EACZ,MAAwB,EACxB,IAAU,EACV,KAAe,EACf,OAAe,EACf,cAAiC,EACjC,SAAiB,EACjB,SAAiB,EACjB,WAAkD,EAClD,WAAoB,EACpB,QAA4B,EAC5B,KAAc,EACd,mBAAyC;IAEzC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1D,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAA;IAC1F,MAAM,YAAY,GAAa,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,YAAY,GAAuC,EAAE,CAAA;IAC3D,MAAM,YAAY,GAAuC,EAAE,CAAA;IAC3D,IAAI,aAAa,GAAG,EAAE,CAAA;IACtB,IAAI,cAAc,GAAG,cAAc,CAAA;IACnC,IAAI,UAAU,GAAG,UAAU,CAAA;IAE3B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,SAAS,aAAa,CAAC,CAAA;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAC3E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEf,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,SAAS,EAAE,CAAC,EAAE,CAAC,CAAA;QAE5D,uDAAuD;QACvD,MAAM,YAAY,GAAG,cAAc;aAChC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;QAEzC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,EAAE,CAAC,CAAA;YACtF,yDAAyD;YACzD,MAAM,WAAW,GAAG,cAAc;iBAC/B,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;iBACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;iBAChE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAEf,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,wCAAwC,CAAC,EAAE,CAAC,CAAA;gBACzE,MAAK;YACP,CAAC;YAED,MAAM,SAAS,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAA;YACvD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,WAAW,CACvC,MAAM,MAAM,CAAC,OAAO,EAAE,EACtB,uDAAuD,EACvD,EAAE,EACF,SAAS,CACV,CAAA;YAED,wBAAwB;YACxB,IAAI,CAAC;gBACH,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;gBAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;gBAC9F,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;gBAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;gBACjC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK;oBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;gBAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBAC/B,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;4BAClC,YAAY,CAAC,IAAI,CAAC;gCAChB,QAAQ,EAAE,IAAa;gCACvB,QAAQ,EAAE,OAAgB;gCAC1B,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;gCAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;gCAC5B,UAAU,EAAE,GAAG,CAAC,MAAM;gCACtB,WAAW,EAAE,GAAG,CAAC,WAAW;gCAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;6BACnB,CAAC,CAAA;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,EAAE,CAAC,CAAA;YAC5E,MAAK;QACP,CAAC;QAED,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,YAAY;aAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC;aACjG,IAAI,CAAC,MAAM,CAAC,CAAA;QAEf,aAAa,IAAI,IAAI,GAAG,QAAQ,CAAA;QAEhC,sBAAsB;QACtB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAY;gBAC3B,MAAM,EAAE,CAAC,CAAC,MAAO;gBACjB,OAAO,EAAE,CAAC,CAAC,WAAW;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,cAAc,YAAY,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC,CAAA;QAE7E,uCAAuC;QACvC,MAAM,YAAY,GAAsB,EAAE,CAAA;QAC1C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAC7E,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CACnE,CAAA;gBACD,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;gBAE/B,8BAA8B;gBAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;gBAClD,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;gBAE9B,iCAAiC;gBACjC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,KAAK,EAAE,CAAC,CAAA;gBACxE,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;gBAEhD,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC;oBACjC,KAAK;oBACL,MAAM;oBACN,IAAI;oBACJ,GAAG;oBACH,eAAe,EAAE,OAAO;oBACxB,aAAa;oBACb,WAAW;oBACX,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;iBAC/B,CAAC,CAAoB,CAAA;gBACtB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,CAAC,IAAI,CAAC;oBAChB,GAAG;oBACH,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,iBAAiB;oBAC1B,SAAS,EAAE,EAAE;oBACb,QAAQ,EAAE,EAAE;oBACZ,KAAK,EAAE,oCAAoC;iBAC5C,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAA;QACpF,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAA;QAEnC,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/F,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,QAAQ,GAAG,CAAC,CAAA;QAEjF,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,EAAE,WAAW;gBAClB,WAAW;gBACX,EAAE,EAAE,IAAI;gBACR,UAAU,EAAE,CAAC,EAAE,gGAAgG;gBAC/G,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,IAAI,EAAE;oBACJ,IAAI,EAAE,KAAK;oBACX,KAAK;oBACL,YAAY,EAAE,YAAY,CAAC,MAAM;iBAClC;gBACD,OAAO,EAAE;oBACP,KAAK;oBACL,WAAW,EAAE,UAAU;oBACvB,UAAU,EAAE,QAAQ;oBACpB,KAAK;oBACL,YAAY,EAAE,YAAY,CAAC,MAAM;iBAClC;aACF,CAAC,CAAA;QACJ,CAAC;QAED,cAAc,GAAG,YAAY,CAAA;QAC7B,UAAU,GAAG,QAAQ,CAAA;QAErB,8CAA8C;QAC9C,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAA;YACrE,MAAK;QACP,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAA;IAC1C,MAAM,UAAU,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;IAC5F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAA;IACjD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACxI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC,CAAA;IACtE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAEf,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC;QAC/B,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,WAAW,EAAE,aAAa,CAAC,IAAI,EAAE;KAClC,CAAA;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAyB;IACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,WAAW,kBAAkB,CAAC,CAAC,QAAQ,oBAAoB,CAAC,CAAC,UAAU,EAAE,CACvH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO;;;EAGP,WAAW;;;;;;;;;;;;;;;;;;;;EAoBX,CAAA;AACF,CAAC"}

package/dist/design/audit/evolve/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Evolve subsystem — closed-loop fix → re-audit for the `bad design-audit`
+ * command. Two modes: ephemeral CSS injection (`runEvolveLoop`) and
+ * agent-dispatched source edits (`runAgentEvolveLoop`), plus the shared
+ * evolve report renderer and the reference-grounded options bundle that
+ * threads through every re-audit call site. `buildApplyPrompt` is the
+ * non-spawning default: the portable prompt a coding agent runs itself.
+ */
+export { runEvolveLoop } from './css.js';
+export { runAgentEvolveLoop, buildApplyPrompt, resolveAgentCommand } from './agent.js';
+export { generateEvolveReport } from './report.js';
+export type { ReferenceCommonOpts } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/design/audit/evolve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/evolve/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA"}

package/dist/design/audit/evolve/index.js

@@ -0,0 +1,12 @@
+/**
+ * Evolve subsystem — closed-loop fix → re-audit for the `bad design-audit`
+ * command. Two modes: ephemeral CSS injection (`runEvolveLoop`) and
+ * agent-dispatched source edits (`runAgentEvolveLoop`), plus the shared
+ * evolve report renderer and the reference-grounded options bundle that
+ * threads through every re-audit call site. `buildApplyPrompt` is the
+ * non-spawning default: the portable prompt a coding agent runs itself.
+ */
+export { runEvolveLoop } from './css.js';
+export { runAgentEvolveLoop, buildApplyPrompt, resolveAgentCommand } from './agent.js';
+export { generateEvolveReport } from './report.js';
+//# sourceMappingURL=index.js.map

package/dist/design/audit/evolve/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/design/audit/evolve/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/design/audit/evolve/report.d.ts

@@ -0,0 +1,3 @@
+import type { DesignEvolveResult } from '../../../types.js';
+export declare function generateEvolveReport(result: DesignEvolveResult): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/design/audit/evolve/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/evolve/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA8CvE"}

package/dist/design/audit/evolve/report.js

@@ -0,0 +1,45 @@
+export function generateEvolveReport(result) {
+    const lines = [];
+    lines.push('# Design Evolve Report');
+    lines.push('');
+    // Sign the delta explicitly — a regression (negative delta) must not render as "(+-1.5)".
+    const sign = result.delta >= 0 ? '+' : '';
+    lines.push(`**Score:** ${result.beforeScore.toFixed(1)} → ${result.afterScore.toFixed(1)} (${sign}${result.delta.toFixed(1)})`);
+    lines.push(`**Rounds:** ${result.rounds}`);
+    lines.push(`**Score progression:** ${result.scoreHistory.map(s => s.toFixed(1)).join(' → ')}`);
+    lines.push('');
+    if (result.appliedFixes.length > 0) {
+        lines.push('## Applied Fixes');
+        lines.push('');
+        for (const fix of result.appliedFixes) {
+            lines.push(`- \`${fix.cssSelector}\`: \`${fix.cssFix}\``);
+            if (fix.finding)
+                lines.push(`  - ${fix.finding}`);
+        }
+        lines.push('');
+    }
+    // Skipped fixes carry a reason; surfacing them tells the operator which
+    // generated fixes were dropped and why (data omission otherwise).
+    if (result.skippedFixes.length > 0) {
+        lines.push('## Skipped Fixes');
+        lines.push('');
+        for (const fix of result.skippedFixes) {
+            lines.push(`- \`${fix.cssSelector}\`: \`${fix.cssFix}\` — ${fix.reason}`);
+        }
+        lines.push('');
+    }
+    if (result.cssOverride) {
+        lines.push('## Generated CSS Override');
+        lines.push('');
+        lines.push('```css');
+        lines.push(result.cssOverride);
+        lines.push('```');
+        lines.push('');
+        lines.push('Apply this CSS to your app to fix the identified design issues:');
+        lines.push('```html');
+        lines.push('<link rel="stylesheet" href="design-fixes.css">');
+        lines.push('```');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/design/audit/evolve/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../src/design/audit/evolve/report.ts"],"names":[],"mappings":"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"}

package/dist/design/audit/evolve/types.d.ts

@@ -0,0 +1,14 @@
+import type { EvalMode, ReferenceContext, Exemplar, ReferenceGroundedConfig } from '../reference/index.js';
+/**
+ * The reference-grounded eval bundle, acquired ONCE and spread into every
+ * `auditOnePage` call site (including the evolve re-audit loops) so a
+ * `--reference-grounded` run never silently falls back to v1 scoring on any path.
+ * Default OFF carries only `evalMode:'v1'`, leaving those call sites byte-identical.
+ */
+export type ReferenceCommonOpts = {
+    evalMode: EvalMode;
+    reference?: ReferenceContext;
+    corpus?: Exemplar[];
+    referenceConfig?: ReferenceGroundedConfig;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/design/audit/evolve/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/evolve/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,eAAe,CAAC,EAAE,uBAAuB,CAAA;CAC1C,CAAA"}

package/dist/design/audit/evolve/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/design/audit/evolve/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/design/audit/evolve/types.ts"],"names":[],"mappings":""}

package/dist/design/audit/pipeline.d.ts

@@ -12,6 +12,7 @@ import { PlaywrightDriver } from '../../drivers/playwright.js';
 import { type AuditPassId, type AuditOverrides } from './evaluate.js';
 import type { PageAuditResult } from './types.js';
 import type { AudienceTag, ModalityTag, RegulatoryContextTag, AudienceVulnerabilityTag } from './score-types.js';
+import type { EvalMode, ReferenceContext, Exemplar, ReferenceGroundedConfig } from './reference/index.js';
 export interface AuditOnePageOptions {
     brain: Brain;
     driver: PlaywrightDriver;
@@ -36,6 +37,17 @@ export interface AuditOnePageOptions {
      * candidate prompts; production runs leave them undefined.
      */
     overrides?: AuditOverrides;
+    /**
+     * Reference-grounded eval wiring (opt-in). When `evalMode` is
+     * `'reference-grounded'`, stage 6 routes to the reference engine instead of
+     * `evaluatePage`; absent/`'v1'` leaves the existing path byte-identical. The
+     * `reference`, `corpus`, and `referenceConfig` are acquired ONCE upstream and
+     * threaded in (siblings of `overrides`, never inside `AuditOverrides`).
+     */
+    evalMode?: EvalMode;
+    reference?: ReferenceContext;
+    corpus?: Exemplar[];
+    referenceConfig?: ReferenceGroundedConfig;
     /**
      * Layer 7 — bypass the ethics gate entirely. Audited + warned. Test-only.
      */

package/dist/design/audit/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/design/audit/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAI9D,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAA;AAOrE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EAGzB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,EAAE,CAAA;IAC3B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC1C,qBAAqB,CAAC,EAAE,wBAAwB,EAAE,CAAA;CACnD;AAqBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0OtF"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/design/audit/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAI9D,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAA;AAOrE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EAKzB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,uBAAuB,EACxB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,EAAE,CAAA;IAC3B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC1C,qBAAqB,CAAC,EAAE,wBAAwB,EAAE,CAAA;CACnD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyQtF"}

package/dist/design/audit/pipeline.js

@@ -11,29 +11,13 @@ import { defaultClassification } from './classify.js';
 import { composeRubric, composeRubricFromProfile } from './rubric/loader.js';
 import { gatherMeasurements } from './measure/index.js';
 import { evaluatePage } from './evaluate.js';
+import { dismissCookieBanners } from '../cookie-consent.js';
 import { getTelemetry, shortHash } from '../../telemetry/index.js';
 import { loadEthicsRules } from './ethics/loader.js';
 import { checkEthics, pageTextBlob } from './ethics/check.js';
 import { classifyEnsemble } from './classify-ensemble.js';
 import { loadAnchors } from './rubric/anchor-loader.js';
 import { buildAuditResult } from './build-result.js';
-const COOKIE_BANNER_SELECTORS = [
-    'button:has-text("Accept all")',
-    'button:has-text("Accept")',
-    'button:has-text("Reject all")',
-    'button:has-text("Got it")',
-    'button:has-text("Close")',
-];
-async function dismissCookieBanners(page) {
-    for (const sel of COOKIE_BANNER_SELECTORS) {
-        const btn = page.locator(sel).first();
-        if (await btn.isVisible({ timeout: 500 }).catch(() => false)) {
-            await btn.click({ timeout: 2000 }).catch(() => null);
-            await page.waitForTimeout(500);
-            return;
-        }
-    }
-}
 /**
  * Audit one page through the full design-audit pipeline.
  */
@@ -103,16 +87,45 @@ export async function auditOnePage(opts) {
         // ── 5. Measure (deterministic, runs in parallel) ──
         const measurements = await gatherMeasurements(page);
         // ── 6. Evaluate ──
-        const result = await evaluatePage(brain, {
-            url,
-            state,
-            classification,
-            rubric,
-            measurements,
-            screenshotPath,
-            auditPasses,
-            overrides,
-        });
+        // Single flag-gated branch: reference-grounded mode routes to the engine,
+        // which returns a `PageAuditResult` so stages 7-9 run unchanged. The default
+        // path (`evalMode` absent/'v1') is the original `evaluatePage` call, untouched.
+        // The engine is imported lazily here so v1 never loads it.
+        let result;
+        // Engine-computed per-dimension scores, surfaced from the reference branch and
+        // handed to stage 8 as `precomputedScores` so the engine is the SINGLE scoring
+        // authority (no second `brain.auditDesign` pass). Undefined in v1 ⇒ stage 8 is
+        // byte-identical to the legacy path.
+        let precomputedScores;
+        if (opts.evalMode === 'reference-grounded') {
+            const { evaluateReferenceGrounded, resolveReferenceConfig } = await import('./reference/index.js');
+            const evaluation = await evaluateReferenceGrounded(brain, {
+                url,
+                classification,
+                measurements,
+                ...(screenshotPath ? { screenshotPath } : {}),
+                ...(opts.reference ? { reference: opts.reference } : {}),
+                corpus: opts.corpus ?? [],
+                config: opts.referenceConfig ?? resolveReferenceConfig(),
+            });
+            result = evaluation.result;
+            precomputedScores = evaluation.dimensionScores;
+            // Surface the rich artifact so the CLI can render the full redesign brief.
+            // Reference branch only — v1 results never carry this field.
+            result.referenceArtifact = evaluation.artifact;
+        }
+        else {
+            result = await evaluatePage(brain, {
+                url,
+                state,
+                classification,
+                rubric,
+                measurements,
+                screenshotPath,
+                auditPasses,
+                overrides,
+            });
+        }
         // ── 7. Ethics gate (Layer 7) — apply rollup floor when rules fire ──
         if (skipEthics) {
             console.warn(`[ethics] --skip-ethics: gate bypassed for ${url} (test-only)`);
@@ -153,6 +166,9 @@ export async function auditOnePage(opts) {
                 anchor,
                 runId,
                 overrides,
+                // Reference mode only: the engine already scored every dimension, so pass
+                // them through and skip stage 8's `brain.auditDesign` + `generatePatches`.
+                ...(precomputedScores ? { precomputedScores } : {}),
             });
             result.auditResult = auditResult;
             result.ensembleClassification = ensemble;

package/dist/design/audit/pipeline.js.map

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

package/dist/design/audit/reference/artifact/build.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Artifact assembly — the PURE core that folds the engine's stage outputs into
+ * the first-class `RedesignArtifact`.
+ *
+ * No IO, no LLM: identical inputs always yield an identical artifact, so it
+ * unit-tests on plain fixtures. Two invariants are enforced FAIL-CLOSED (we
+ * throw rather than silently repair or fabricate):
+ *
+ *  - Directions are returned in RANKING order (winner first). A direction the
+ *    ranker did not place is appended in its original order — never dropped —
+ *    so a partial ranking can never silently lose a generated direction.
+ *  - Every `groundedInExemplarIds` entry MUST resolve to a retrieved exemplar.
+ *    A direction claiming grounding in an exemplar that was never retrieved is
+ *    provenance fabrication; the artifact is the thing the taste eval trusts for
+ *    provenance, so we refuse to assemble a lying one.
+ */
+import type { RedesignArtifact, RedesignDirection, RankResult, RetrievalResult, TasteVerdict } from '../contracts.js';
+/**
+ * Inputs to {@link buildRedesignArtifact}. Mirrors the inline shape the
+ * `engine/core` sequencer passes; named here so callers and tests share one
+ * definition.
+ */
+export interface BuildRedesignArtifactInput {
+    url: string;
+    directions: RedesignDirection[];
+    ranking: RankResult;
+    retrieval: RetrievalResult[];
+    verdicts: TasteVerdict[];
+    referenceId?: string;
+    tokensUsed: number;
+}
+export declare function buildRedesignArtifact(input: BuildRedesignArtifactInput): RedesignArtifact;
+//# sourceMappingURL=build.d.ts.map

package/dist/design/audit/reference/artifact/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/artifact/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,YAAY,EACb,MAAM,iBAAiB,CAAA;AAExB;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,iBAAiB,EAAE,CAAA;IAC/B,OAAO,EAAE,UAAU,CAAA;IACnB,SAAS,EAAE,eAAe,EAAE,CAAA;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,gBAAgB,CA0BzF"}