@tangle-network/browser-agent-driver 0.29.0 → 0.31.0

package/dist/cli-design-audit.d.ts

@@ -12,10 +12,12 @@ export interface DesignAuditOptions {
     model?: string;
     provider?: string;
     apiKey?: string;
+    baseUrl?: string;
     output?: string;
     json?: boolean;
     headless?: boolean;
     debug?: boolean;
+    storageState?: string;
     viewport?: string;
     extractTokens?: boolean;
     /** Evolve mode: true/css for CSS injection, or agent name (claude-code, codex, opencode) for agent dispatch */
@@ -28,6 +30,20 @@ export interface DesignAuditOptions {
     projectDir?: string;
     /** Optional path to user-supplied rubric fragments */
     rubricsDir?: string;
+    /** Subjective LLM audit passes: standard, deep, max, number, or comma-list */
+    auditPasses?: string;
+    /** Bypass the ethics floor entirely. Audited + warned. Test-only. */
+    skipEthics?: boolean;
+    /** Override directory for ethics rule yaml files. */
+    ethicsRulesDir?: string;
+    /** Comma-separated audience tags: developer, clinician, kids, ... */
+    audience?: string;
+    /** Comma-separated regulatory contexts: hipaa, gdpr, coppa, ... */
+    regulatoryContext?: string;
+    /** Comma-separated audience-vulnerability tags: patient-facing, minor-facing, ... */
+    audienceVulnerability?: string;
+    /** Single modality: mobile, tablet, desktop, tv, kiosk */
+    modality?: string;
 }
 export declare function runDesignAudit(opts: DesignAuditOptions): Promise<void>;
 export interface ExtractDesignTokensOptions {

package/dist/cli-design-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-design-audit.d.ts","sourceRoot":"","sources":["../src/cli-design-audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAA4B,YAAY,EAA8L,MAAM,YAAY,CAAA;AAgNpQ,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkN5E;AAstCD,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACjK;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsRrG"}
+{"version":3,"file":"cli-design-audit.d.ts","sourceRoot":"","sources":["../src/cli-design-audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAA4B,YAAY,EAA8L,MAAM,YAAY,CAAA;AA0RpQ,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4U5E;AAsxCD,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACjK;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsRrG"}

package/dist/cli-design-audit.js

@@ -15,7 +15,66 @@ import { resolveProviderApiKey, resolveProviderModelName } from './provider-defa
 import { loadLocalEnvFiles } from './env-loader.js';
 import { cliError } from './cli-ui.js';
 import { auditOnePage } from './design/audit/pipeline.js';
+/** Split "a, b , c" → ['a','b','c']. Returns undefined for empty input so the
+ *  v2 predicate predicates can distinguish "operator did not say" from "[]". */
+function parseTagList(input) {
+    if (!input)
+        return undefined;
+    const tags = input.split(',').map(s => s.trim()).filter(Boolean);
+    return tags.length > 0 ? tags : undefined;
+}
+/** Pretty-print the ethics-violation report for a set of pages. Prints
+ *  nothing when no page tripped a rule. Each rule is shown with severity,
+ *  remediation, and citation so the operator can act without re-running. */
+function printEthicsViolations(pages) {
+    const offenders = pages.filter(p => (p.ethicsViolations?.length ?? 0) > 0);
+    if (offenders.length === 0)
+        return;
+    console.log('');
+    console.log(`  ${chalk.bgRed.white.bold(' ETHICS VIOLATIONS ')}`);
+    for (const page of offenders) {
+        console.log(`  ${chalk.dim('Page:')} ${page.url}`);
+        for (const v of page.ethicsViolations ?? []) {
+            const sevColor = v.severity === 'critical-floor' ? chalk.red : chalk.yellow;
+            console.log(`    ${sevColor('•')} ${chalk.bold(v.ruleId)} ${chalk.dim('—')} ${sevColor(v.severity)} ${chalk.dim(`(rollup capped at ${v.rollupCap})`)}`);
+            console.log(`      ${chalk.dim('fix:')} ${v.remediation}`);
+            if (v.citation)
+                console.log(`      ${chalk.dim('cite:')} ${v.citation}`);
+        }
+    }
+}
+/** Lowest rollup cap across all violated pages, or undefined if none fired. */
+function lowestRollupCap(pages) {
+    const caps = pages.flatMap(p => p.ethicsViolations ?? []).map(v => v.rollupCap);
+    return caps.length === 0 ? undefined : Math.min(...caps);
+}
+/**
+ * Layer 1 — print the per-dimension breakdown for one page when an
+ * `auditResultV2` is attached. Five dim lines + one rollup line; each shows
+ * score, range, and confidence so an agent can reason about uncertainty.
+ */
+function printV2Breakdown(page) {
+    const v2 = page.auditResultV2;
+    if (!v2 || !v2.scores || !v2.rollup)
+        return;
+    const dimOrder = ['product_intent', 'visual_craft', 'trust_clarity', 'workflow', 'content_ia'];
+    for (const dim of dimOrder) {
+        const s = v2.scores[dim];
+        if (!s)
+            continue;
+        const sevColor = s.score >= 8 ? chalk.green : s.score >= 5 ? chalk.yellow : chalk.red;
+        const confColor = s.confidence === 'high' ? chalk.green : s.confidence === 'medium' ? chalk.yellow : chalk.dim;
+        console.log(`      ${chalk.dim(dim.padEnd(15))} ${sevColor(`${s.score}/10`)} ${chalk.dim(`[${s.range[0]}-${s.range[1]}]`)} ${confColor(s.confidence)}`);
+    }
+    const r = v2.rollup;
+    const rColor = r.score >= 8 ? chalk.green : r.score >= 5 ? chalk.yellow : chalk.red;
+    const confColor = r.confidence === 'high' ? chalk.green : r.confidence === 'medium' ? chalk.yellow : chalk.dim;
+    console.log(`      ${chalk.dim('rollup'.padEnd(15))} ${rColor(`${r.score.toFixed(1)}/10`)} ${chalk.dim(`[${r.range[0].toFixed(1)}-${r.range[1].toFixed(1)}]`)} ${confColor(r.confidence)}  ${chalk.dim(r.rule)}`);
+}
+import { resolveAuditPasses } from './design/audit/evaluate.js';
 import { detectSystemicFindings, topByRoi } from './design/audit/roi.js';
+import { getTelemetry, setInvocation } from './telemetry/index.js';
+import { randomUUID } from 'node:crypto';
 // ---------------------------------------------------------------------------
 // Page discovery — find key pages by crawling links
 // ---------------------------------------------------------------------------
@@ -194,15 +253,46 @@ export async function runDesignAudit(opts) {
     const provider = (opts.provider ?? 'claude-code');
     const modelName = resolveProviderModelName(provider, opts.model);
     const apiKey = opts.apiKey ?? resolveProviderApiKey(provider);
+    const auditPasses = resolveAuditPasses(opts.auditPasses);
+    // Layer 7 — ethics gate options. Threaded into every auditOnePage call site.
+    if (opts.skipEthics) {
+        console.warn(`  ${chalk.yellow('⚠')} ${chalk.bold('--skip-ethics')} ${chalk.dim('— ethics floor disabled (test-only)')}`);
+    }
+    const ethicsCommonOpts = {
+        skipEthics: opts.skipEthics,
+        ethicsRulesDir: opts.ethicsRulesDir,
+        audience: parseTagList(opts.audience),
+        regulatoryContext: parseTagList(opts.regulatoryContext),
+        audienceVulnerability: parseTagList(opts.audienceVulnerability),
+        modality: parseTagList(opts.modality),
+    };
+    // Telemetry: every design-audit invocation gets a stable runId. Children
+    // (per-page, evolve rounds) link back via parentRunId so a fleet rollup can
+    // reconstruct the tree.
+    const runId = randomUUID();
+    const runStartedAt = Date.now();
+    const invocation = opts.evolve ? 'design-audit:evolve' : opts.reproducibility ? 'design-audit:reproducibility' : 'design-audit';
+    setInvocation(invocation);
+    const telemetry = getTelemetry();
     const [vw, vh] = (opts.viewport ?? '1440x900').split('x').map(Number);
     console.log('');
     console.log(`  ${chalk.bold('bad design-audit')}`);
     const profileLabel = profile ?? chalk.dim('auto-classify');
-    console.log(`  ${profileLabel} ${chalk.dim('·')} ${chalk.cyan(modelName)} ${chalk.dim('·')} ${vw}×${vh} ${chalk.dim('·')} up to ${maxPages} pages`);
+    const passLabel = auditPasses.length === 1 && auditPasses[0] === 'standard'
+        ? '1 audit pass'
+        : `${auditPasses.length} audit passes (${auditPasses.join(', ')})`;
+    console.log(`  ${profileLabel} ${chalk.dim('·')} ${chalk.cyan(modelName)} ${chalk.dim('·')} ${vw}×${vh} ${chalk.dim('·')} ${passLabel} ${chalk.dim('·')} up to ${maxPages} pages`);
     console.log(`  ${chalk.dim('→')} ${opts.url}`);
     console.log('');
+    const storageState = opts.storageState ? path.resolve(opts.storageState) : undefined;
+    if (storageState && !fs.existsSync(storageState)) {
+        cliError(`storage state file not found: ${storageState}`);
+    }
     const browser = await chromium.launch({ headless: opts.headless ?? true });
-    const context = await browser.newContext({ viewport: { width: vw, height: vh } });
+    const context = await browser.newContext({
+        viewport: { width: vw, height: vh },
+        ...(storageState ? { storageState } : {}),
+    });
     const page = await context.newPage();
     // Discover pages
     console.log(`  ${chalk.dim('Discovering pages…')}`);
@@ -220,7 +310,8 @@ export async function runDesignAudit(opts) {
     const brain = new Brain({
         model: modelName,
         apiKey,
-        provider: opts.provider,
+        provider: provider,
+        baseUrl: opts.baseUrl ?? process.env.LLM_BASE_URL,
         vision: true,
         debug: opts.debug,
         llmTimeoutMs: 120_000, // design audits generate ~8k tokens of structured JSON — need 2min
@@ -239,6 +330,11 @@ export async function runDesignAudit(opts) {
             profileOverride: profile,
             screenshotDir,
             userRubricsDir: opts.rubricsDir,
+            auditPasses,
+            runId,
+            provider,
+            model: modelName,
+            ...ethicsCommonOpts,
         });
         const result = gen2;
         results.push(result);
@@ -249,6 +345,7 @@ export async function runDesignAudit(opts) {
             ? chalk.dim(` (${result.classification.type}/${result.classification.domain})`)
             : '';
         console.log(`  ${icon} ${scoreColor(`${result.score}/10`)} ${chalk.dim('—')} ${findingCount} finding${findingCount !== 1 ? 's' : ''}${classLabel}`);
+        printV2Breakdown(result);
     }
     // Cross-page systemic detection + top-fixes ranking.
     // Findings appearing on 2+ pages collapse into a single systemic finding.
@@ -270,16 +367,29 @@ export async function runDesignAudit(opts) {
     const minor = allFindings.filter(f => f.severity === 'minor').length;
     if (opts.json) {
         const jsonPath = path.join(outputDir, 'report.json');
+        // Layer 1 — emit BOTH schemaVersion 1 (legacy) and schemaVersion 2 (new)
+        // shapes for one release. Consumers can migrate to v2 incrementally.
+        const v2Pages = results
+            .map(r => r.auditResultV2)
+            .filter((r) => r !== undefined);
         fs.writeFileSync(jsonPath, JSON.stringify({
+            schemaVersion: 1,
             timestamp: new Date().toISOString(),
             profile,
             url: opts.url,
             pages: results,
             topFixes,
             summary: { avgScore, totalFindings: allFindings.length, critical, major, minor },
+            v2: {
+                schemaVersion: 2,
+                pages: v2Pages,
+            },
         }, null, 2));
         console.log(`  ${chalk.dim('JSON →')} ${jsonPath}`);
     }
+    // ── Layer 7 — surface ethics violations BEFORE the score summary so the
+    // operator sees the floor reason, not just the capped number. ──
+    printEthicsViolations(results);
     // Summary
     console.log('');
     console.log(`  ${chalk.dim('─'.repeat(52))}`);
@@ -292,6 +402,10 @@ export async function runDesignAudit(opts) {
     if (minor > 0)
         findingParts.push(chalk.dim(`${minor} minor`));
     console.log(`  Avg: ${avgColor(`${avgScore.toFixed(1)}/10`)}  ${chalk.dim('·')}  ${allFindings.length} findings ${findingParts.length ? chalk.dim('(') + findingParts.join(chalk.dim(' · ')) + chalk.dim(')') : ''}`);
+    const lowestCap = lowestRollupCap(results);
+    if (lowestCap !== undefined) {
+        console.log(`  ${chalk.red('⚠ Rollup capped at')} ${chalk.bold(`${lowestCap}/10`)} ${chalk.dim('— resolve ethics violations to lift the cap')}`);
+    }
     console.log(`  ${chalk.dim('Report →')} ${reportPath}`);
     if (screenshotDir)
         console.log(`  ${chalk.dim('Screenshots →')} ${screenshotDir}`);
@@ -310,6 +424,12 @@ export async function runDesignAudit(opts) {
                     url,
                     profileOverride: profile,
                     userRubricsDir: opts.rubricsDir,
+                    auditPasses,
+                    runId,
+                    provider,
+                    model: modelName,
+                    parentRunId: runId,
+                    ...ethicsCommonOpts,
                 });
                 repResults.push(gen2);
             }
@@ -343,11 +463,11 @@ export async function runDesignAudit(opts) {
         if (evolveMode !== 'css') {
             // Agent-dispatched evolve — a coding agent edits the actual source code
             const projectDir = opts.projectDir ?? process.cwd();
-            evolveResult = await runAgentEvolveLoop(brain, driver, page, pages, evolveProfile, results, outputDir, opts.evolveRounds ?? 3, evolveMode, projectDir, opts.debug);
+            evolveResult = await runAgentEvolveLoop(brain, driver, page, pages, evolveProfile, results, outputDir, opts.evolveRounds ?? 3, evolveMode, projectDir, opts.debug, auditPasses, runId, provider, modelName);
         }
         else {
             // CSS-injection evolve — ephemeral fixes injected into the browser page
-            evolveResult = await runEvolveLoop(brain, driver, page, pages, evolveProfile, results, outputDir, opts.evolveRounds ?? 3);
+            evolveResult = await runEvolveLoop(brain, driver, page, pages, evolveProfile, results, outputDir, opts.evolveRounds ?? 3, auditPasses, runId, provider, modelName);
         }
         // Write evolve report
         const evolvePath = path.join(outputDir, 'evolve-report.md');
@@ -364,10 +484,62 @@ export async function runDesignAudit(opts) {
             fs.writeFileSync(evJsonPath, JSON.stringify(evolveResult, null, 2));
         }
         console.log('');
+        telemetry.emit({
+            kind: 'design-evolve-run',
+            runId,
+            ok: true,
+            durationMs: Date.now() - runStartedAt,
+            model: { provider, name: modelName },
+            data: {
+                url: opts.url,
+                pages: pages.length,
+                rounds: evolveResult.scoreHistory.length - 1,
+                scoreHistory: evolveResult.scoreHistory,
+                appliedFixCount: evolveResult.appliedFixes?.length ?? 0,
+                evolveMode: evolveMode === 'css' ? 'css' : `agent:${evolveMode}`,
+            },
+            metrics: {
+                initialScore: evolveResult.scoreHistory[0] ?? 0,
+                finalScore: evolveResult.scoreHistory[evolveResult.scoreHistory.length - 1] ?? 0,
+                delta: (evolveResult.scoreHistory[evolveResult.scoreHistory.length - 1] ?? 0) - (evolveResult.scoreHistory[0] ?? 0),
+                rounds: evolveResult.scoreHistory.length - 1,
+            },
+        });
     }
+    // Run-level summary envelope — fires for every design-audit invocation,
+    // evolve or not. This is the row a fleet rollup queries to track audit
+    // health across repos over time.
+    telemetry.emit({
+        kind: 'design-audit-run',
+        runId,
+        ok: true,
+        durationMs: Date.now() - runStartedAt,
+        model: { provider, name: modelName },
+        data: {
+            url: opts.url,
+            pages: pages.length,
+            profile: profile ?? null,
+            auditPasses,
+            outputDir,
+        },
+        metrics: {
+            avgScore,
+            pageCount: pages.length,
+            totalFindings: allFindings.length,
+            criticalFindings: critical,
+            majorFindings: major,
+            minorFindings: minor,
+            topFixCount: topFixes.length,
+        },
+        tags: {
+            evolveMode: opts.evolve ? (opts.evolve === true || opts.evolve === 'css' ? 'css' : 'agent') : 'off',
+            reproducibility: opts.reproducibility ? 'on' : 'off',
+        },
+    });
     await browser.close();
 }
-async function runEvolveLoop(brain, driver, page, pages, profile, initialResults, outputDir, maxRounds) {
+async function runEvolveLoop(brain, driver, page, pages, profile, initialResults, outputDir, maxRounds, auditPasses, parentRunId, provider, model) {
+    const telemetry = parentRunId ? getTelemetry() : undefined;
     const initialAvg = initialResults.reduce((s, r) => s + r.score, 0) / initialResults.length;
     const scoreHistory = [initialAvg];
     const appliedFixes = [];
@@ -463,6 +635,10 @@ async function runEvolveLoop(brain, driver, page, pages, profile, initialResults
                     url,
                     profileOverride: profile,
                     screenshotDir,
+                    auditPasses,
+                    ...(parentRunId ? { runId: parentRunId, parentRunId } : {}),
+                    ...(provider ? { provider } : {}),
+                    ...(model ? { model } : {}),
                 }));
                 roundResults.push(result);
             }
@@ -482,6 +658,28 @@ async function runEvolveLoop(brain, driver, page, pages, profile, initialResults
         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
@@ -638,7 +836,8 @@ Do NOT:
 - Refactor unrelated code
 - Change component structure or HTML semantics unless a finding specifically requires it`;
 }
-async function runAgentEvolveLoop(brain, driver, page, pages, profile, initialResults, outputDir, maxRounds, agentName, projectDir, debug) {
+async function runAgentEvolveLoop(brain, driver, page, pages, profile, initialResults, outputDir, maxRounds, agentName, projectDir, debug, auditPasses, parentRunId, provider, model) {
+    const telemetry = parentRunId ? getTelemetry() : undefined;
     const initialAvg = initialResults.reduce((s, r) => s + r.score, 0) / initialResults.length;
     const scoreHistory = [initialAvg];
     const appliedFixes = [];
@@ -719,6 +918,10 @@ async function runAgentEvolveLoop(brain, driver, page, pages, profile, initialRe
                 url,
                 profileOverride: profile,
                 screenshotDir: roundScreenshotDir,
+                auditPasses,
+                ...(parentRunId ? { runId: parentRunId, parentRunId } : {}),
+                ...(provider ? { provider } : {}),
+                ...(model ? { model } : {}),
             }));
             roundResults.push(result);
         }
@@ -738,6 +941,28 @@ async function runAgentEvolveLoop(brain, driver, page, pages, profile, initialRe
                 finding: `Score: ${currentAvg.toFixed(1)} → ${roundAvg.toFixed(1)}`,
             });
         }
+        if (telemetry && parentRunId) {
+            telemetry.emit({
+                kind: 'design-evolve-round',
+                runId: parentRunId,
+                parentRunId,
+                ok: true,
+                durationMs: 0,
+                ...(provider && model ? { model: { provider, name: model } } : {}),
+                data: {
+                    mode: `agent:${agentName}`,
+                    round,
+                    resolvedCount,
+                },
+                metrics: {
+                    round,
+                    beforeScore: currentAvg,
+                    afterScore: roundAvg,
+                    delta,
+                    findingsResolved: resolvedCount,
+                },
+            });
+        }
         currentResults = roundResults;
         currentAvg = roundAvg;
         // Check convergence