@tangle-network/browser-agent-driver 0.30.0 → 0.32.0

package/dist/reports/aggregate.js

@@ -0,0 +1,145 @@
+/**
+ * Deterministic aggregation over a job's per-target audit results.
+ *
+ * Every number that shows up in a report flows through here — never through
+ * an LLM. The narration layer can describe / contextualize / dramatize, but
+ * counts, scores, deltas, and rankings are all computed here. Same pattern
+ * we use for the audit patches contract: agent narrates, code computes.
+ */
+import * as fs from 'node:fs';
+/**
+ * Read each ok result's `report.json` from disk and project to AggregateRow.
+ * Skipped/failed entries become rows with `rollupScore: NaN` so callers can
+ * filter them — keeping them in the list preserves index alignment with
+ * `job.results` for tools that want to drill in.
+ */
+export function aggregateJob(job) {
+    const out = [];
+    for (const r of job.results) {
+        out.push(toRow(r));
+    }
+    return out;
+}
+function toRow(r) {
+    const base = {
+        url: r.url,
+        snapshotUrl: r.snapshotUrl,
+        capturedAt: r.capturedAt,
+        runId: r.runId ?? '',
+        rollupScore: typeof r.rollupScore === 'number' ? r.rollupScore : NaN,
+        dimensions: {},
+        ethicsViolations: 0,
+        resultPath: r.resultPath,
+        pageType: r.pageType,
+    };
+    if (r.status !== 'ok' || !r.resultPath || !fs.existsSync(r.resultPath)) {
+        return base;
+    }
+    try {
+        const json = JSON.parse(fs.readFileSync(r.resultPath, 'utf-8'));
+        const page = json.pages?.[0];
+        if (!page)
+            return base;
+        const result = page.auditResult;
+        const cls = result?.classification ?? page.classification ?? {};
+        base.pageType = base.pageType ?? cls.type;
+        base.domain = cls.domain;
+        if (result?.rollup?.score !== undefined)
+            base.rollupScore = result.rollup.score;
+        else if (page.rollup?.score !== undefined)
+            base.rollupScore = page.rollup.score;
+        else if (typeof page.score === 'number')
+            base.rollupScore = page.score;
+        if (result?.scores) {
+            for (const [dim, ds] of Object.entries(result.scores)) {
+                if (ds && typeof ds.score === 'number')
+                    base.dimensions[dim] = ds.score;
+            }
+        }
+        base.ethicsViolations = Array.isArray(page.ethicsViolations) ? page.ethicsViolations.length : 0;
+    }
+    catch {
+        // Corrupt or partial report.json — leave as-is. Don't pretend we have data we don't.
+    }
+    return base;
+}
+export function leaderboard(rows, opts = {}) {
+    const dir = opts.direction ?? 'desc';
+    const filtered = rows
+        .filter(r => Number.isFinite(r.rollupScore))
+        .filter(r => !opts.byType || r.pageType === opts.byType);
+    filtered.sort((a, b) => (dir === 'desc' ? b.rollupScore - a.rollupScore : a.rollupScore - b.rollupScore));
+    if (opts.topN && opts.topN > 0)
+        return filtered.slice(0, opts.topN);
+    return filtered;
+}
+/** Longitudinal view: all snapshots for one URL, sorted by capture time. */
+export function longitudinalFor(rows, url) {
+    return rows
+        .filter(r => r.url === url && r.capturedAt && Number.isFinite(r.rollupScore))
+        .map(r => ({
+        url: r.url,
+        capturedAt: r.capturedAt,
+        rollupScore: r.rollupScore,
+        pageType: r.pageType,
+    }))
+        .sort((a, b) => a.capturedAt.localeCompare(b.capturedAt));
+}
+export function compareRuns(a, b) {
+    const dims = new Set([
+        ...Object.keys(a.dimensions),
+        ...Object.keys(b.dimensions),
+    ]);
+    const perDimension = [];
+    for (const dim of dims) {
+        const ax = a.dimensions[dim];
+        const bx = b.dimensions[dim];
+        if (typeof ax !== 'number' || typeof bx !== 'number')
+            continue;
+        perDimension.push({ dim, beforeScore: bx, afterScore: ax, delta: round2(ax - bx) });
+    }
+    return {
+        a,
+        b,
+        rollupDelta: round2(a.rollupScore - b.rollupScore),
+        perDimension,
+    };
+}
+export function tierBuckets(rows, boundaries) {
+    const ranked = leaderboard(rows);
+    const buckets = [];
+    const sorted = [...new Set(boundaries)].sort((a, b) => a - b);
+    let prev = 0;
+    for (const upper of sorted) {
+        const slice = ranked.slice(prev, upper);
+        if (slice.length === 0) {
+            prev = upper;
+            continue;
+        }
+        const label = prev === 0 ? `top ${upper}` : `${prev + 1}–${upper}`;
+        buckets.push({ label, rows: slice, ...stats(slice) });
+        prev = upper;
+    }
+    if (prev < ranked.length) {
+        const slice = ranked.slice(prev);
+        buckets.push({ label: `${prev + 1}+`, rows: slice, ...stats(slice) });
+    }
+    return buckets;
+}
+function stats(rows) {
+    if (rows.length === 0)
+        return { meanScore: NaN, medianScore: NaN };
+    const scores = rows.map(r => r.rollupScore).filter(Number.isFinite);
+    const sum = scores.reduce((a, b) => a + b, 0);
+    const sorted = [...scores].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    const median = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+    return {
+        meanScore: round2(sum / scores.length),
+        medianScore: round2(median),
+    };
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/reports/aggregate.js.map

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

package/dist/reports/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reports — turn a job's audit results into shareable artifacts.
+ *
+ * Two surfaces:
+ *   1. Static templates (deterministic markdown rendering — see templates.ts)
+ *   2. AI SDK tools (agentic chat over the same data — see tools.ts)
+ *
+ * Both flow through the same aggregate.ts functions, so numbers are consistent.
+ */
+export type { AggregateRow, CompareRunsResult, DimensionDelta, LongitudinalRow, ReportTemplate } from './types.js';
+export { aggregateJob, leaderboard, longitudinalFor, compareRuns, tierBuckets } from './aggregate.js';
+export type { LeaderboardOptions, TierBucket } from './aggregate.js';
+export { renderLeaderboard, renderLongitudinal, renderBatchComparison, renderBrandEvolution, renderJobHeader, } from './templates.js';
+export type { LeaderboardRenderOpts, LongitudinalRenderOpts, BatchComparisonRenderOpts, BrandEvolutionRenderOpts, } from './templates.js';
+export { aggregateTokens, diffTokens, groupByUrl } from './tokens.js';
+export type { TokenSummary, TokenDiff, TokenSeries } from './tokens.js';
+export { buildReportTools } from './tools.js';
+export type { ReportToolsContext, ReportToolSet } from './tools.js';
+export { narrateReport } from './narrate.js';
+export type { NarrateOptions } from './narrate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/reports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrG,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/reports/index.js

@@ -0,0 +1,15 @@
+/**
+ * Reports — turn a job's audit results into shareable artifacts.
+ *
+ * Two surfaces:
+ *   1. Static templates (deterministic markdown rendering — see templates.ts)
+ *   2. AI SDK tools (agentic chat over the same data — see tools.ts)
+ *
+ * Both flow through the same aggregate.ts functions, so numbers are consistent.
+ */
+export { aggregateJob, leaderboard, longitudinalFor, compareRuns, tierBuckets } from './aggregate.js';
+export { renderLeaderboard, renderLongitudinal, renderBatchComparison, renderBrandEvolution, renderJobHeader, } from './templates.js';
+export { aggregateTokens, diffTokens, groupByUrl } from './tokens.js';
+export { buildReportTools } from './tools.js';
+export { narrateReport } from './narrate.js';
+//# sourceMappingURL=index.js.map

package/dist/reports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAErG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAOvB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/reports/narrate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * LLM narration around deterministic data.
+ *
+ * The contract: numbers come from the templates (which call the aggregate
+ * functions). The LLM only writes prose context — top-line takeaways, an
+ * angle on what's surprising. Same pattern as the patches contract.
+ *
+ * If a Brain isn't supplied, the deterministic markdown is returned as-is.
+ * That's the safe default — never silently fabricate prose.
+ */
+import type { Brain } from '../brain/index.js';
+export interface NarrateOptions {
+    /** When supplied, prepends an LLM-written executive summary above the deterministic body. */
+    brain?: Brain;
+    /** Free-form context passed to the LLM (e.g. "this is the YC W25 cohort"). */
+    context?: string;
+}
+export declare function narrateReport(deterministicMarkdown: string, opts?: NarrateOptions): Promise<string>;
+//# sourceMappingURL=narrate.d.ts.map

package/dist/reports/narrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrate.d.ts","sourceRoot":"","sources":["../../src/reports/narrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAU9C,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAsB,aAAa,CAAC,qBAAqB,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB7G"}

package/dist/reports/narrate.js

@@ -0,0 +1,40 @@
+/**
+ * LLM narration around deterministic data.
+ *
+ * The contract: numbers come from the templates (which call the aggregate
+ * functions). The LLM only writes prose context — top-line takeaways, an
+ * angle on what's surprising. Same pattern as the patches contract.
+ *
+ * If a Brain isn't supplied, the deterministic markdown is returned as-is.
+ * That's the safe default — never silently fabricate prose.
+ */
+const SYSTEM = `You are an analyst writing a one-paragraph executive summary at the top of a design-audit report.
+
+Rules:
+- Use ONLY the numbers and facts in the provided markdown report. Do not invent rankings, scores, or claims.
+- Surface the most surprising or load-bearing finding (e.g. a tier-vs-tier gap, a dramatic longitudinal swing, an outlier).
+- Two to four sentences. No bullet lists.
+- Do not preface with "Here is your summary" or similar.`;
+export async function narrateReport(deterministicMarkdown, opts = {}) {
+    if (!opts.brain)
+        return deterministicMarkdown;
+    const user = [
+        opts.context ? `Context: ${opts.context}` : undefined,
+        'REPORT:',
+        deterministicMarkdown,
+        '',
+        'Write the executive summary now.',
+    ].filter(Boolean).join('\n\n');
+    try {
+        const { text } = await opts.brain.complete(SYSTEM, user, { maxOutputTokens: 320 });
+        const summary = text.trim();
+        if (!summary)
+            return deterministicMarkdown;
+        return `## Executive summary\n\n${summary}\n\n${deterministicMarkdown}`;
+    }
+    catch {
+        // Don't let narration failures block the artifact. Ship the data.
+        return deterministicMarkdown;
+    }
+}
+//# sourceMappingURL=narrate.js.map

package/dist/reports/narrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrate.js","sourceRoot":"","sources":["../../src/reports/narrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,GAAG;;;;;;yDAM0C,CAAA;AASzD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,qBAA6B,EAAE,OAAuB,EAAE;IAC1F,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,qBAAqB,CAAA;IAC7C,MAAM,IAAI,GAAG;QACX,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;QACrD,SAAS;QACT,qBAAqB;QACrB,EAAE;QACF,kCAAkC;KACnC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAA;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO;YAAE,OAAO,qBAAqB,CAAA;QAC1C,OAAO,2BAA2B,OAAO,OAAO,qBAAqB,EAAE,CAAA;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;QAClE,OAAO,qBAAqB,CAAA;IAC9B,CAAC;AACH,CAAC"}

package/dist/reports/templates.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Static report templates — markdown rendering of pre-aggregated data.
+ *
+ * No LLM. The narration layer (narrate.ts) wraps these with prose; the
+ * templates themselves are pure functions of data so they're snapshot-testable
+ * and deterministic.
+ */
+import type { Job } from '../jobs/types.js';
+import type { AggregateRow } from './types.js';
+export interface LeaderboardRenderOpts {
+    title?: string;
+    topN?: number;
+    byType?: string;
+    /** Tier bucket boundaries — e.g. [10, 100, 200] → "top 10", "11–100", "101–200", "201+". */
+    buckets?: number[];
+}
+export declare function renderLeaderboard(rows: AggregateRow[], opts?: LeaderboardRenderOpts): string;
+export interface LongitudinalRenderOpts {
+    title?: string;
+    /** If multiple URLs are in scope, render one section per URL. */
+    urls?: string[];
+}
+export declare function renderLongitudinal(rows: AggregateRow[], opts?: LongitudinalRenderOpts): string;
+export interface BatchComparisonRenderOpts {
+    title?: string;
+    /** Pairs of (a, b) URLs to diff. If omitted, the first two URLs encountered are paired. */
+    pairs?: Array<[string, string]>;
+}
+export declare function renderBatchComparison(rows: AggregateRow[], opts?: BatchComparisonRenderOpts): string;
+export interface BrandEvolutionRenderOpts {
+    title?: string;
+    /** Max colors to render per snapshot (top by usage count). Default 6. */
+    topColors?: number;
+}
+/**
+ * Render a per-URL brand-kit evolution: for each URL, list the snapshots in
+ * chronological order with their distinct color palette, font families, and
+ * detected libraries. Between consecutive snapshots, surface the delta
+ * (colors added/removed, families added/removed, brand-meta changes).
+ */
+export declare function renderBrandEvolution(job: Job, opts?: BrandEvolutionRenderOpts): string;
+export declare function renderJobHeader(job: Job): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/reports/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/reports/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAA;AAI/D,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,qBAA0B,GAAG,MAAM,CAwChG;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CA6BlG;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2FAA2F;IAC3F,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,yBAA8B,GAAG,MAAM,CA+BxG;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE,wBAA6B,GAAG,MAAM,CAqD1F;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAWhD"}

package/dist/reports/templates.js

@@ -0,0 +1,200 @@
+/**
+ * Static report templates — markdown rendering of pre-aggregated data.
+ *
+ * No LLM. The narration layer (narrate.ts) wraps these with prose; the
+ * templates themselves are pure functions of data so they're snapshot-testable
+ * and deterministic.
+ */
+import { leaderboard, longitudinalFor, tierBuckets, compareRuns } from './aggregate.js';
+import { aggregateTokens, diffTokens, groupByUrl } from './tokens.js';
+export function renderLeaderboard(rows, opts = {}) {
+    const lines = [];
+    const title = opts.title ?? 'Design Audit Leaderboard';
+    lines.push(`# ${title}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    if (opts.byType) {
+        lines.push(`Filtered to page-type: \`${opts.byType}\``);
+        lines.push('');
+    }
+    const ranked = leaderboard(rows, { topN: opts.topN, byType: opts.byType });
+    lines.push(`## Ranked sites (${ranked.length})`);
+    lines.push('');
+    lines.push('| # | URL | Page type | Rollup | Top dim | Bottom dim | Ethics |');
+    lines.push('|---|-----|-----------|--------|---------|------------|--------|');
+    ranked.forEach((r, i) => {
+        const dims = Object.entries(r.dimensions);
+        dims.sort((a, b) => b[1] - a[1]);
+        const top = dims[0] ? `${dims[0][0]} ${dims[0][1].toFixed(1)}` : '—';
+        const bot = dims[dims.length - 1] ? `${dims[dims.length - 1][0]} ${dims[dims.length - 1][1].toFixed(1)}` : '—';
+        lines.push(`| ${i + 1} | ${escapeMd(r.url)} | ${r.pageType ?? '?'} | ${r.rollupScore.toFixed(2)} | ${top} | ${bot} | ${r.ethicsViolations} |`);
+    });
+    lines.push('');
+    if (opts.buckets && opts.buckets.length > 0) {
+        const buckets = tierBuckets(rows, opts.buckets);
+        lines.push('## Tiers');
+        lines.push('');
+        lines.push('| Tier | N | Mean | Median |');
+        lines.push('|------|---|------|--------|');
+        for (const b of buckets) {
+            lines.push(`| ${b.label} | ${b.rows.length} | ${fmt(b.meanScore)} | ${fmt(b.medianScore)} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function renderLongitudinal(rows, opts = {}) {
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Longitudinal Design Audit'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    const urls = opts.urls ?? Array.from(new Set(rows.map(r => r.url)));
+    for (const url of urls) {
+        const series = longitudinalFor(rows, url);
+        if (series.length === 0)
+            continue;
+        lines.push(`## ${escapeMd(url)}`);
+        lines.push('');
+        lines.push('| Captured | Rollup | Page type |');
+        lines.push('|----------|--------|-----------|');
+        for (const s of series) {
+            lines.push(`| ${s.capturedAt.slice(0, 10)} | ${s.rollupScore.toFixed(2)} | ${s.pageType ?? '?'} |`);
+        }
+        const first = series[0];
+        const last = series[series.length - 1];
+        if (first && last && first !== last) {
+            const delta = last.rollupScore - first.rollupScore;
+            const sign = delta >= 0 ? '+' : '';
+            lines.push('');
+            lines.push(`Net change ${first.capturedAt.slice(0, 10)} → ${last.capturedAt.slice(0, 10)}: **${sign}${delta.toFixed(2)}**`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function renderBatchComparison(rows, opts = {}) {
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Batch Comparison'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    let pairs = opts.pairs ?? [];
+    if (pairs.length === 0) {
+        const urls = Array.from(new Set(rows.map(r => r.url)));
+        if (urls.length >= 2)
+            pairs = [[urls[0], urls[1]]];
+    }
+    for (const [aUrl, bUrl] of pairs) {
+        const a = rows.find(r => r.url === aUrl && Number.isFinite(r.rollupScore));
+        const b = rows.find(r => r.url === bUrl && Number.isFinite(r.rollupScore));
+        if (!a || !b)
+            continue;
+        const cmp = compareRuns(a, b);
+        lines.push(`## ${escapeMd(aUrl)} vs ${escapeMd(bUrl)}`);
+        lines.push('');
+        lines.push(`Rollup delta: **${signed(cmp.rollupDelta)}** (a ${a.rollupScore.toFixed(2)} – b ${b.rollupScore.toFixed(2)})`);
+        lines.push('');
+        if (cmp.perDimension.length > 0) {
+            lines.push('| Dimension | a | b | Δ |');
+            lines.push('|-----------|---|---|---|');
+            for (const d of cmp.perDimension) {
+                lines.push(`| ${d.dim} | ${d.afterScore.toFixed(1)} | ${d.beforeScore.toFixed(1)} | ${signed(d.delta)} |`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a per-URL brand-kit evolution: for each URL, list the snapshots in
+ * chronological order with their distinct color palette, font families, and
+ * detected libraries. Between consecutive snapshots, surface the delta
+ * (colors added/removed, families added/removed, brand-meta changes).
+ */
+export function renderBrandEvolution(job, opts = {}) {
+    const summaries = aggregateTokens(job);
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Brand & Design-System Evolution'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    if (summaries.length === 0) {
+        lines.push(`_No tokens.json files were produced. Run the job with \`audit.extractTokens: true\` to enable._`);
+        return lines.join('\n');
+    }
+    const topColors = opts.topColors ?? 6;
+    const series = groupByUrl(summaries);
+    for (const { url, snapshots } of series) {
+        lines.push(`## ${escapeMd(url)}`);
+        lines.push('');
+        for (let i = 0; i < snapshots.length; i++) {
+            const s = snapshots[i];
+            const captured = s.capturedAt ? s.capturedAt.slice(0, 10) : 'live';
+            lines.push(`### ${captured}`);
+            lines.push('');
+            const swatches = s.colors.slice(0, topColors).map(c => `\`${c.hex}\` ×${c.count}`).join(' · ');
+            lines.push(`**Top colors**: ${swatches || '_none extracted_'}`);
+            const families = s.fontFamilies.map(f => `${f.family} (${f.classification})`).join(', ');
+            lines.push(`**Font families**: ${families || '_none_'}`);
+            lines.push(`**Type-scale entries**: ${s.typeScaleEntries}`);
+            if (s.detectedLibraries.length > 0)
+                lines.push(`**Detected libraries**: ${s.detectedLibraries.join(', ')}`);
+            if (s.brand?.themeColor)
+                lines.push(`**Theme color**: \`${s.brand.themeColor}\``);
+            if (s.logos.length > 0)
+                lines.push(`**Logos**: ${s.logos.length}`);
+            lines.push('');
+            // Snapshot-to-snapshot delta against the previous snapshot in the series.
+            const prev = snapshots[i - 1];
+            if (prev) {
+                const d = diffTokens(prev, s);
+                const callouts = [];
+                if (d.colorsAdded.length > 0)
+                    callouts.push(`+${d.colorsAdded.length} new colors`);
+                if (d.colorsRemoved.length > 0)
+                    callouts.push(`−${d.colorsRemoved.length} removed`);
+                if (d.familiesAdded.length > 0)
+                    callouts.push(`+ ${d.familiesAdded.join(', ')}`);
+                if (d.familiesRemoved.length > 0)
+                    callouts.push(`− ${d.familiesRemoved.join(', ')}`);
+                if (d.librariesAdded.length > 0)
+                    callouts.push(`adopted ${d.librariesAdded.join(', ')}`);
+                if (d.librariesRemoved.length > 0)
+                    callouts.push(`dropped ${d.librariesRemoved.join(', ')}`);
+                if (d.brandChanges.length > 0)
+                    callouts.push(`brand meta: ${d.brandChanges.map(c => c.field).join(', ')} changed`);
+                if (callouts.length > 0) {
+                    lines.push(`_Δ vs ${prev.capturedAt?.slice(0, 10) ?? 'previous'}: ${callouts.join(' · ')}_`);
+                    lines.push('');
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+export function renderJobHeader(job) {
+    const ok = job.results.filter(r => r.status === 'ok').length;
+    const fail = job.results.filter(r => r.status === 'failed').length;
+    const skip = job.results.filter(r => r.status === 'skipped').length;
+    return [
+        `**Job**: \`${job.jobId}\``,
+        job.spec.label ? `**Label**: ${job.spec.label}` : undefined,
+        `**Targets**: ${job.targets.length}  ·  ok: ${ok}  ·  failed: ${fail}  ·  skipped: ${skip}`,
+        `**Cost**: $${job.totalCostUSD.toFixed(2)}`,
+        `**Status**: ${job.status}`,
+    ].filter(Boolean).join('  \n');
+}
+function escapeMd(s) {
+    return s.replace(/\|/g, '\\|');
+}
+function signed(n) {
+    if (!Number.isFinite(n))
+        return '—';
+    return (n >= 0 ? '+' : '') + n.toFixed(2);
+}
+function fmt(n) {
+    return Number.isFinite(n) ? n.toFixed(2) : '—';
+}
+//# sourceMappingURL=templates.js.map

package/dist/reports/templates.js.map

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

package/dist/reports/tokens.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Brand-kit / design-token aggregation across a job's targets.
+ *
+ * Reads each per-target `tokens.json` (produced when AuditOptions.extractTokens
+ * was true) and projects to a flat row shape so longitudinal evolution and
+ * batch comparison templates can render without re-implementing extraction.
+ *
+ * No LLM. Pure function of on-disk data — same contract as aggregate.ts.
+ */
+import type { Job } from '../jobs/types.js';
+import type { DesignTokens, ColorToken, FontFamily } from '../types.js';
+export interface TokenSummary {
+    /** Seed URL (groups snapshots of the same site). */
+    url: string;
+    /** Snapshot URL when wayback. */
+    snapshotUrl?: string;
+    /** ISO datetime of capture. */
+    capturedAt?: string;
+    /** Per-target runId (== outputDir for jobs). */
+    runId: string;
+    /** Resolved on-disk path to tokens.json. */
+    tokensPath?: string;
+    /** Top-level brand metadata (title, theme color, favicon, og image). */
+    brand: DesignTokens['brand'];
+    /** All distinct colors, sorted desc by usage count. */
+    colors: ColorToken[];
+    /** Distinct typography families with classification + weight set. */
+    fontFamilies: FontFamily[];
+    /** Type-scale entry count (proxy for typographic complexity). */
+    typeScaleEntries: number;
+    /** Logo asset URLs (svg + raster). */
+    logos: string[];
+    /** Loaded font-file URLs. */
+    fontFiles: string[];
+    /** Detected libraries (e.g. ['tailwind','radix-ui']). */
+    detectedLibraries: string[];
+}
+/** Read each ok result's tokens.json and project to TokenSummary. */
+export declare function aggregateTokens(job: Job): TokenSummary[];
+/**
+ * Diff between two TokenSummary records. Useful for "this URL evolved from
+ * 4 colors → 12 colors and dropped Helvetica for Inter" callouts.
+ */
+export interface TokenDiff {
+    colorsAdded: string[];
+    colorsRemoved: string[];
+    colorsCommon: number;
+    familiesAdded: string[];
+    familiesRemoved: string[];
+    brandChanges: Array<{
+        field: keyof DesignTokens['brand'];
+        before: string | undefined;
+        after: string | undefined;
+    }>;
+    librariesAdded: string[];
+    librariesRemoved: string[];
+}
+export declare function diffTokens(a: TokenSummary, b: TokenSummary): TokenDiff;
+/**
+ * Group token summaries by URL and return a chronological evolution series.
+ * Returns one entry per URL; each carries the sequence of TokenSummary rows
+ * sorted by capturedAt (or insertion order when capturedAt is missing).
+ */
+export interface TokenSeries {
+    url: string;
+    snapshots: TokenSummary[];
+}
+export declare function groupByUrl(summaries: TokenSummary[]): TokenSeries[];
+//# sourceMappingURL=tokens.d.ts.map

package/dist/reports/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/reports/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5B,uDAAuD;IACvD,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,qEAAqE;IACrE,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAA;IACxB,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,EAAE,CAyBxD;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;IAClH,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,CAuBtE;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,YAAY,EAAE,CAAA;CAC1B;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAYnE"}