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

package/dist/design/audit/reference/retrieval/matcher.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Exemplar retrieval — the de-hardcoding PURE core. Implements `ExemplarMatcher`.
+ *
+ * Instead of the scattered if/else domain tables the v1 audit uses, retrieval
+ * ranks exemplars by similarity: a hard `pageType` filter, then a blended score
+ * over aesthetic-vector cosine similarity, an optional structural-vector signal,
+ * and a low-weight job-to-be-done token overlap. The de-hardcoding guarantee:
+ * a NOVEL `pageType` with no same-type exemplar does not fall through a table —
+ * it resolves to its nearest neighbour across the whole corpus.
+ *
+ * Purity: the matcher consumes the PRE-COMPUTED `query.aestheticVector` (the
+ * orchestrator embeds once) and NEVER embeds. Its only same-layer imports are
+ * `cosineSimilarity` (the pure half of the embedding boundary) and
+ * `structuralFeatures` — the SAME projection the orchestrator uses to build
+ * `query.structuralVector`, so both sides of the structural comparison live in
+ * one feature space. No IO, no LLM.
+ */
+import type { CorpusQuery, Exemplar, RetrievalResult, RetrieveWeights } from '../contracts.js';
+/**
+ * Blended similarity of one exemplar to the query, in [0, 1]. Pure: the
+ * weighted sub-scores are renormalised by the weights actually applied, so the
+ * absence of a structural vector does not deflate the score.
+ */
+export declare function scoreExemplar(query: CorpusQuery, e: Exemplar, weights?: RetrieveWeights): number;
+/**
+ * Rank a corpus of exemplars against a query. Hard-filters to same-`pageType`
+ * candidates; if none exist (novel page type) it ranks the FULL corpus by nearest
+ * neighbour rather than failing or table-dispatching. Sorted best→worst by
+ * blended score, tie-broken by `eloRating` (desc) then `id` (asc) for full
+ * determinism. Returns every candidate (no `k` truncation — the orchestrator
+ * slices to its configured `k`).
+ */
+export declare function retrieve(query: CorpusQuery, corpus: Exemplar[], weights?: RetrieveWeights): RetrievalResult[];
+//# sourceMappingURL=matcher.d.ts.map

package/dist/design/audit/reference/retrieval/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/retrieval/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AA6B9F;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAE,eAAkC,GAAG,MAAM,CAmBlH;AAkBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,GAAE,eAAkC,GAC1C,eAAe,EAAE,CAmBnB"}

package/dist/design/audit/reference/retrieval/matcher.js

@@ -0,0 +1,107 @@
+/**
+ * Exemplar retrieval — the de-hardcoding PURE core. Implements `ExemplarMatcher`.
+ *
+ * Instead of the scattered if/else domain tables the v1 audit uses, retrieval
+ * ranks exemplars by similarity: a hard `pageType` filter, then a blended score
+ * over aesthetic-vector cosine similarity, an optional structural-vector signal,
+ * and a low-weight job-to-be-done token overlap. The de-hardcoding guarantee:
+ * a NOVEL `pageType` with no same-type exemplar does not fall through a table —
+ * it resolves to its nearest neighbour across the whole corpus.
+ *
+ * Purity: the matcher consumes the PRE-COMPUTED `query.aestheticVector` (the
+ * orchestrator embeds once) and NEVER embeds. Its only same-layer imports are
+ * `cosineSimilarity` (the pure half of the embedding boundary) and
+ * `structuralFeatures` — the SAME projection the orchestrator uses to build
+ * `query.structuralVector`, so both sides of the structural comparison live in
+ * one feature space. No IO, no LLM.
+ */
+import { cosineSimilarity } from './embedding-hash.js';
+import { structuralFeatures } from '../dna/descriptor.js';
+/**
+ * Fallback blend used ONLY when no weights are passed (direct/test calls).
+ * Aesthetic + pageType dominate; `job` is intentionally low because
+ * classification intent is noisy and is fabricated on `--profile` runs. The
+ * orchestrator always supplies config's canonical `DEFAULT_RETRIEVE_WEIGHTS`.
+ */
+const FALLBACK_WEIGHTS = { aesthetic: 0.7, structural: 0.2, job: 0.1 };
+// Score differences below this read as a tie and defer to the elo/id tie-break.
+const SCORE_TIE_EPSILON = 1e-9;
+const round2 = (n) => Math.round(n * 100) / 100;
+const clamp01 = (n) => (n < 0 ? 0 : n > 1 ? 1 : n);
+/** Jaccard overlap of the word tokens in two job-to-be-done strings, 0-1. */
+function jobOverlap(a, b) {
+    const sa = new Set((a.toLowerCase().match(/[a-z0-9]+/g) ?? []).filter((t) => t.length >= 2));
+    const sb = new Set((b.toLowerCase().match(/[a-z0-9]+/g) ?? []).filter((t) => t.length >= 2));
+    if (sa.size === 0 || sb.size === 0)
+        return 0;
+    let inter = 0;
+    for (const t of sa)
+        if (sb.has(t))
+            inter++;
+    const union = sa.size + sb.size - inter;
+    return union === 0 ? 0 : inter / union;
+}
+/**
+ * Blended similarity of one exemplar to the query, in [0, 1]. Pure: the
+ * weighted sub-scores are renormalised by the weights actually applied, so the
+ * absence of a structural vector does not deflate the score.
+ */
+export function scoreExemplar(query, e, weights = FALLBACK_WEIGHTS) {
+    let acc = 0;
+    let wsum = 0;
+    const aesthetic = clamp01(cosineSimilarity(query.aestheticVector, e.aestheticVector));
+    acc += weights.aesthetic * aesthetic;
+    wsum += weights.aesthetic;
+    if (query.structuralVector && query.structuralVector.length > 0) {
+        const structural = clamp01(cosineSimilarity(query.structuralVector, structuralFeatures(e.dna)));
+        acc += weights.structural * structural;
+        wsum += weights.structural;
+    }
+    const job = jobOverlap(query.jobToBeDone, e.jobToBeDone);
+    acc += weights.job * job;
+    wsum += weights.job;
+    return wsum > 0 ? clamp01(acc / wsum) : 0;
+}
+function buildReasons(query, e, novel) {
+    const reasons = [];
+    reasons.push(novel
+        ? `nearest-neighbour fallback: no '${query.pageType}' exemplar, matched across types (${e.pageType})`
+        : `page-type match: ${e.pageType}`);
+    reasons.push(`aesthetic similarity ${round2(clamp01(cosineSimilarity(query.aestheticVector, e.aestheticVector)))}`);
+    if (query.structuralVector && query.structuralVector.length > 0) {
+        reasons.push(`structural similarity ${round2(clamp01(cosineSimilarity(query.structuralVector, structuralFeatures(e.dna))))}`);
+    }
+    const job = jobOverlap(query.jobToBeDone, e.jobToBeDone);
+    if (job > 0)
+        reasons.push(`job overlap ${round2(job)}`);
+    return reasons;
+}
+/**
+ * Rank a corpus of exemplars against a query. Hard-filters to same-`pageType`
+ * candidates; if none exist (novel page type) it ranks the FULL corpus by nearest
+ * neighbour rather than failing or table-dispatching. Sorted best→worst by
+ * blended score, tie-broken by `eloRating` (desc) then `id` (asc) for full
+ * determinism. Returns every candidate (no `k` truncation — the orchestrator
+ * slices to its configured `k`).
+ */
+export function retrieve(query, corpus, weights = FALLBACK_WEIGHTS) {
+    if (corpus.length === 0)
+        return [];
+    const sameType = corpus.filter((e) => e.pageType === query.pageType);
+    const novel = sameType.length === 0;
+    const candidates = novel ? corpus : sameType;
+    const scored = candidates.map((e) => ({
+        exemplar: e,
+        score: scoreExemplar(query, e, weights),
+        reasons: buildReasons(query, e, novel),
+    }));
+    scored.sort((x, y) => {
+        if (Math.abs(y.score - x.score) > SCORE_TIE_EPSILON)
+            return y.score - x.score;
+        if (y.exemplar.eloRating !== x.exemplar.eloRating)
+            return y.exemplar.eloRating - x.exemplar.eloRating;
+        return x.exemplar.id.localeCompare(y.exemplar.id);
+    });
+    return scored;
+}
+//# sourceMappingURL=matcher.js.map

package/dist/design/audit/reference/retrieval/matcher.js.map

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

package/dist/design/audit/reference/run.d.ts

@@ -0,0 +1,59 @@
+/**
+ * L4 entrypoint — the rich library/CLI entry returning the first-class
+ * `RedesignArtifact`. ORCH: it composes the default wiring, runs the ONE shared
+ * core, and shapes nothing of its own.
+ *
+ * Responsibilities (and only these):
+ *  - resolve the config once (operator overrides + the already-resolved
+ *    `reference` folded into `config.reference`, the single field the core reads);
+ *  - build the dependency bundle through `engine/wiring.buildDefaultDeps`, unless
+ *    the caller injects its own `deps` (tests pass deterministic fakes — no live
+ *    model, browser, or corpus disk);
+ *  - acquire-once: load the corpus a SINGLE time per run via `deps.store.load()`
+ *    (overridable by `corpus`) and thread it into the core, so a caller looping
+ *    pages never re-reads it — the reproducibility discipline the core relies on;
+ *  - stream accepted directions through `onDirection` by decorating the generator
+ *    dep (the core sequences and does not forward streaming hooks);
+ *  - write the artifact when `config.artifactDir` is set, then return it.
+ *
+ * Classification + deterministic measurements are produced by the existing v1
+ * stages UPSTREAM (`classifyEnsemble` / `gatherMeasurements`) and passed in. When
+ * a caller omits them this entry falls back to an honest "unknown / nothing
+ * measured" pair — never fabricated passing data — so retrieval fails closed in
+ * the guard (no exemplars of an unknown type, no reference) rather than grounding
+ * against a guessed page archetype.
+ */
+import type { RedesignArtifact, RedesignDirection, ReferenceEngineDeps, ReferenceContext, PageClassification, MeasurementBundle, Exemplar } from './contracts.js';
+import { type ReferenceBrain } from './engine/wiring.js';
+import { type ReferenceConfigOverrides } from './config.js';
+/**
+ * Options for {@link runReferenceRedesign}. `url` + `brain` are the only required
+ * inputs; everything else is an override the upstream pipeline (or a test) supplies.
+ */
+export interface RunReferenceRedesignOptions {
+    url: string;
+    /** Text model seam, satisfied structurally by the real `Brain`. */
+    brain: ReferenceBrain;
+    /** Operator overrides merged onto the frozen defaults. */
+    config?: ReferenceConfigOverrides;
+    /** Reference resolved ONCE upstream; folded into `config.reference` here. */
+    reference?: ReferenceContext;
+    /** Upstream page classification; an honest `unknown` placeholder when omitted. */
+    classification?: PageClassification;
+    /** Upstream deterministic measurements; an honest "nothing measured" bundle when omitted. */
+    measurements?: MeasurementBundle;
+    /** Page screenshot for a future vision judge (text judge ignores it). */
+    screenshotPath?: string;
+    /** Fires once per accepted direction as generation streams. */
+    onDirection?: (direction: RedesignDirection) => void;
+    /** Pre-built deps; defaults to `buildDefaultDeps(brain, config)`. Tests inject fakes. */
+    deps?: ReferenceEngineDeps;
+    /** Pre-loaded corpus; defaults to a single `deps.store.load()` per run. */
+    corpus?: Exemplar[];
+}
+/**
+ * Run one page through the reference-grounded engine and return the rich
+ * `RedesignArtifact` (winner-first directions, ranking, grounding provenance).
+ */
+export declare function runReferenceRedesign(opts: RunReferenceRedesignOptions): Promise<RedesignArtifact>;
+//# sourceMappingURL=run.d.ts.map

package/dist/design/audit/reference/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/reference/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACT,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAA0B,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAGnF;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,mEAAmE;IACnE,KAAK,EAAE,cAAc,CAAA;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,wBAAwB,CAAA;IACjC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,kFAAkF;IAClF,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACpD,yFAAyF;IACzF,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;CACpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}

package/dist/design/audit/reference/run.js

@@ -0,0 +1,99 @@
+/**
+ * L4 entrypoint — the rich library/CLI entry returning the first-class
+ * `RedesignArtifact`. ORCH: it composes the default wiring, runs the ONE shared
+ * core, and shapes nothing of its own.
+ *
+ * Responsibilities (and only these):
+ *  - resolve the config once (operator overrides + the already-resolved
+ *    `reference` folded into `config.reference`, the single field the core reads);
+ *  - build the dependency bundle through `engine/wiring.buildDefaultDeps`, unless
+ *    the caller injects its own `deps` (tests pass deterministic fakes — no live
+ *    model, browser, or corpus disk);
+ *  - acquire-once: load the corpus a SINGLE time per run via `deps.store.load()`
+ *    (overridable by `corpus`) and thread it into the core, so a caller looping
+ *    pages never re-reads it — the reproducibility discipline the core relies on;
+ *  - stream accepted directions through `onDirection` by decorating the generator
+ *    dep (the core sequences and does not forward streaming hooks);
+ *  - write the artifact when `config.artifactDir` is set, then return it.
+ *
+ * Classification + deterministic measurements are produced by the existing v1
+ * stages UPSTREAM (`classifyEnsemble` / `gatherMeasurements`) and passed in. When
+ * a caller omits them this entry falls back to an honest "unknown / nothing
+ * measured" pair — never fabricated passing data — so retrieval fails closed in
+ * the guard (no exemplars of an unknown type, no reference) rather than grounding
+ * against a guessed page archetype.
+ */
+import { runRedesignCore } from './engine/core.js';
+import { buildDefaultDeps } from './engine/wiring.js';
+import { resolveReferenceConfig } from './config.js';
+import { writeArtifact } from './artifact/render.js';
+/**
+ * Run one page through the reference-grounded engine and return the rich
+ * `RedesignArtifact` (winner-first directions, ranking, grounding provenance).
+ */
+export async function runReferenceRedesign(opts) {
+    const config = resolveReferenceConfig({
+        ...opts.config,
+        ...(opts.reference ? { reference: opts.reference } : {}),
+    });
+    const baseDeps = opts.deps ?? buildDefaultDeps(opts.brain, config);
+    const deps = opts.onDirection ? withDirectionStream(baseDeps, opts.onDirection) : baseDeps;
+    // Acquire-once: a single corpus read per run, reused across the caller's pages.
+    const corpus = opts.corpus ?? (await deps.store.load());
+    const result = await runRedesignCore(deps, {
+        url: opts.url,
+        classification: opts.classification ?? neutralClassification(),
+        measurements: opts.measurements ?? unmeasuredBundle(),
+        ...(opts.screenshotPath ? { screenshotPath: opts.screenshotPath } : {}),
+        corpus,
+        config,
+    });
+    if (config.artifactDir)
+        await writeArtifact(result.artifact, config.artifactDir);
+    return result.artifact;
+}
+/**
+ * Decorate the generator boundary so the caller's `onDirection` is injected into
+ * the core's generation call. The core invokes `generate(ctx, hits, { count })`
+ * with no streaming hook by design; composing the callback here keeps the core a
+ * pure sequencer while still surfacing each accepted direction as it lands.
+ */
+function withDirectionStream(deps, onDirection) {
+    const generator = {
+        generate: (ctx, exemplars, genOpts) => deps.generator.generate(ctx, exemplars, { ...genOpts, onDirection }),
+    };
+    return { ...deps, generator };
+}
+/**
+ * The honest "no upstream classification" fallback. Only `type` (the retrieval
+ * hard filter) and `intent` (the low-weight job signal) are consumed by the
+ * engine, so the remaining fields are inert placeholders; `type: 'unknown'` with
+ * `confidence: 0` makes the absence explicit and lets the guard abort rather than
+ * grounding against a guessed archetype.
+ */
+function neutralClassification() {
+    return {
+        type: 'unknown',
+        domain: 'unknown',
+        framework: null,
+        designSystem: 'unknown',
+        maturity: 'shipped',
+        intent: '',
+        confidence: 0,
+    };
+}
+/**
+ * The honest "no measurements gathered" fallback — NOT "everything passed". No
+ * failures are reported because nothing ran (`a11y.ran: false`, contrast
+ * `totalChecked: 0`), mirroring `gatherMeasurements`' own catch-fallback shape, so
+ * the DNA folds in absent signals and the headline floor never trips on
+ * fabricated pass data.
+ */
+function unmeasuredBundle() {
+    return {
+        contrast: { totalChecked: 0, aaFailures: [], aaaFailures: [], summary: { aaPassRate: 1, aaaPassRate: 1 } },
+        a11y: { ran: false, violations: [], passes: 0 },
+        hasBlockingIssues: false,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/design/audit/reference/run.js.map

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

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

@@ -0,0 +1,35 @@
+/**
+ * Design Audit report renderer.
+ *
+ * Turns scored page-audit results into the markdown report, plus the
+ * terminal print/format helpers the design-audit CLI handler uses to
+ * surface scores and ethics violations.
+ */
+import type { DesignFinding } from '../../types.js';
+import type { EthicsViolation } from './types.js';
+import type { PageAuditResult } from '../../cli-design-audit.js';
+/** Split "a, b , c" → ['a','b','c']. Returns undefined for empty input so the
+ *  layered predicates can distinguish "operator did not say" from "[]". */
+export declare function parseTagList(input: string | undefined): string[] | 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. */
+export declare function printEthicsViolations(pages: Array<{
+    url: string;
+    ethicsViolations?: EthicsViolation[];
+}>): void;
+/** Lowest rollup cap across all violated pages, or undefined if none fired. */
+export declare function lowestRollupCap(pages: Array<{
+    ethicsViolations?: EthicsViolation[];
+}>): number | undefined;
+/**
+ * Layer 1 — print the per-dimension breakdown for one page when an
+ * `auditResult` is attached. Five dim lines + one rollup line; each shows
+ * score, range, and confidence so an agent can reason about uncertainty.
+ */
+export declare function printScoreBreakdown(page: {
+    auditResult?: unknown;
+}): void;
+declare function generateReport(results: PageAuditResult[], profile: string | undefined, topFixes?: DesignFinding[], redesignSection?: string): string;
+export { generateReport as generateDesignReport };
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/design/audit/report.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;2EAC2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAI5E;AAED;;4EAE4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,GAAG,IAAI,CAc/G;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAG1G;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAyBzE;AAMD,iBAAS,cAAc,CACrB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,GAAE,aAAa,EAAO,EAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CA6HR;AAID,OAAO,EAAE,cAAc,IAAI,oBAAoB,EAAE,CAAA"}

package/dist/design/audit/report.js

@@ -0,0 +1,195 @@
+/**
+ * Design Audit report renderer.
+ *
+ * Turns scored page-audit results into the markdown report, plus the
+ * terminal print/format helpers the design-audit CLI handler uses to
+ * surface scores and ethics violations.
+ */
+import chalk from 'chalk';
+/** Split "a, b , c" → ['a','b','c']. Returns undefined for empty input so the
+ *  layered predicates can distinguish "operator did not say" from "[]". */
+export 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. */
+export 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. */
+export 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
+ * `auditResult` is attached. Five dim lines + one rollup line; each shows
+ * score, range, and confidence so an agent can reason about uncertainty.
+ */
+export function printScoreBreakdown(page) {
+    const result = page.auditResult;
+    if (!result || !result.scores || !result.rollup)
+        return;
+    const dimOrder = ['product_intent', 'visual_craft', 'trust_clarity', 'workflow', 'content_ia'];
+    for (const dim of dimOrder) {
+        const s = result.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 = result.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)}`);
+}
+// ---------------------------------------------------------------------------
+// Report generation
+// ---------------------------------------------------------------------------
+function generateReport(results, profile, topFixes = [], redesignSection) {
+    const lines = [];
+    const avgScore = results.length > 0
+        ? results.reduce((sum, r) => sum + r.score, 0) / results.length
+        : 0;
+    const allFindings = results.flatMap(r => r.findings);
+    const critical = allFindings.filter(f => f.severity === 'critical').length;
+    const major = allFindings.filter(f => f.severity === 'major').length;
+    const minor = allFindings.filter(f => f.severity === 'minor').length;
+    const totalTokens = results.reduce((sum, r) => sum + (r.tokensUsed ?? 0), 0);
+    lines.push('# Design Audit Report');
+    lines.push('');
+    if (profile) {
+        lines.push(`**Profile:** ${profile}`);
+    }
+    // Surface per-page classification when present.
+    const classifications = results
+        .filter(r => r.classification)
+        .map(r => `${r.url}: ${r.classification.type}/${r.classification.domain} (${r.classification.maturity})`);
+    if (classifications.length > 0) {
+        lines.push(`**Auto-classified:**`);
+        for (const c of classifications)
+            lines.push(`- ${c}`);
+    }
+    lines.push(`**Pages audited:** ${results.length}`);
+    lines.push(`**Overall score:** ${avgScore.toFixed(1)}/10`);
+    lines.push(`**Findings:** ${allFindings.length} (${critical} critical, ${major} major, ${minor} minor)`);
+    if (totalTokens > 0)
+        lines.push(`**Tokens used:** ${totalTokens.toLocaleString()}`);
+    lines.push('');
+    // Score bar
+    const scoreBar = '█'.repeat(Math.round(avgScore)) + '░'.repeat(10 - Math.round(avgScore));
+    lines.push(`\`${scoreBar}\` ${avgScore.toFixed(1)}/10`);
+    lines.push('');
+    // ── Top Fixes (by ROI) — the headline section users actually read first ──
+    if (topFixes.length > 0) {
+        lines.push('## Top Fixes (by ROI)');
+        lines.push('');
+        lines.push('Fix these first — sorted by impact × blast / effort:');
+        lines.push('');
+        for (let i = 0; i < topFixes.length; i++) {
+            const f = topFixes[i];
+            const tags = [];
+            if (f.pageCount && f.pageCount >= 2)
+                tags.push(`appears on ${f.pageCount} pages`);
+            if (f.blast === 'system')
+                tags.push('SYSTEMIC');
+            const tagStr = tags.length > 0 ? ` _(${tags.join(', ')})_` : '';
+            const roiStr = f.roi !== undefined ? f.roi.toFixed(1) : '—';
+            lines.push(`### ${i + 1}. [${f.severity}] ${f.description}${tagStr}`);
+            lines.push('');
+            lines.push(`- **ROI:** ${roiStr}  ·  Impact ${f.impact ?? '—'}  ·  Effort ${f.effort ?? '—'}  ·  Blast ${f.blast ?? '—'}`);
+            lines.push(`- **Location:** ${f.location}`);
+            lines.push(`- **Fix:** ${f.suggestion}`);
+            if (f.cssSelector && f.cssFix) {
+                lines.push(`- **CSS:** \`${f.cssSelector} { ${f.cssFix} }\``);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+    }
+    // ── Redesign directions (reference-grounded mode only) — a pre-rendered,
+    // compact projection of the rich artifact: winner in brief + ranked alternates,
+    // pointing at the full `<slug>.redesign.md`. Undefined on the v1 path, so the
+    // default report stays byte-identical. ──
+    if (redesignSection) {
+        lines.push(redesignSection);
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+    // Per-page results
+    for (const result of results) {
+        lines.push(`## ${result.url}`);
+        lines.push('');
+        const pageBar = '█'.repeat(Math.round(result.score)) + '░'.repeat(10 - Math.round(result.score));
+        lines.push(`**Score:** \`${pageBar}\` ${result.score}/10`);
+        if (result.summary)
+            lines.push(`**Summary:** ${result.summary}`);
+        if (result.error)
+            lines.push(`**Error:** ${result.error}`);
+        lines.push('');
+        if (result.strengths.length > 0) {
+            lines.push('**Strengths:**');
+            for (const s of result.strengths)
+                lines.push(`- ${s}`);
+            lines.push('');
+        }
+        if (result.designSystemScore) {
+            lines.push('**Design System Breakdown:**');
+            lines.push('');
+            const ds = result.designSystemScore;
+            // Universal dimensions in fixed order, then any custom dimensions (alpha)
+            const universal = ['layout', 'typography', 'color', 'spacing', 'components', 'interactions', 'accessibility', 'polish'];
+            const custom = Object.keys(ds).filter(k => !universal.includes(k)).sort();
+            for (const key of [...universal, ...custom]) {
+                if (typeof ds[key] === 'number') {
+                    const bar = '█'.repeat(Math.round(ds[key])) + '░'.repeat(10 - Math.round(ds[key]));
+                    lines.push(`- ${key}: \`${bar}\` ${ds[key]}/10`);
+                }
+            }
+            lines.push('');
+        }
+        if (result.findings.length > 0) {
+            lines.push('**Findings:**');
+            lines.push('');
+            lines.push('| Sev | Category | Description | Location | Fix | CSS |');
+            lines.push('|-----|----------|-------------|----------|-----|-----|');
+            for (const f of result.findings) {
+                const esc = (s) => s.replace(/\|/g, '\\|').replace(/\n/g, ' ').slice(0, 120);
+                const icon = f.severity === 'critical' ? '🔴' : f.severity === 'major' ? '🟡' : '⚪';
+                const cssFix = f.cssFix ? `\`${esc(f.cssFix)}\`` : '';
+                lines.push(`| ${icon} ${f.severity} | ${f.category} | ${esc(f.description)} | ${esc(f.location)} | ${esc(f.suggestion)} | ${cssFix} |`);
+            }
+            lines.push('');
+        }
+        else if (!result.error) {
+            lines.push('No issues found.');
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+// Exported under a distinct name to avoid clashing with test-report.ts's
+// unrelated `generateReport`. Internal name kept for parity with prior history.
+export { generateReport as generateDesignReport };
+//# sourceMappingURL=report.js.map

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

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