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

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

@@ -0,0 +1,39 @@
+/**
+ * Artifact renderers + a thin disk writer.
+ *
+ * `renderArtifactMarkdown` and `renderArtifactJson` are PURE and deterministic:
+ * identical artifacts render identical bytes, so the markdown is snapshot-stable
+ * and reproducible across pages/reps. `writeArtifact` is the ONLY IO in this
+ * file — a small `fs` wrapper that lands both renderings next to each other.
+ *
+ * The markdown is the human-facing face of the engine: it names each direction,
+ * shows the ASCII layout, the type/colour/motion systems, the information
+ * hierarchy and the revised copy, plus the grounding exemplars and the pairwise
+ * ranking — everything the lossy `DesignFinding` projection cannot carry.
+ */
+import type { RedesignArtifact } from '../contracts.js';
+export declare function renderArtifactMarkdown(a: RedesignArtifact): string;
+/**
+ * Agent-ready "apply this" spec for the WINNING direction — the single coherent,
+ * grounded redesign the `--evolve` coding agent should implement (not a pile of
+ * piecemeal findings). Names the grounding exemplars so the agent knows the bar.
+ */
+export declare function renderRedesignTarget(a: RedesignArtifact): string;
+export declare function renderArtifactJson(a: RedesignArtifact): string;
+/**
+ * A COMPACT projection of the artifact for the main audit report — the winner in
+ * brief (rationale + a one-line type/colour/hierarchy signature) plus the names
+ * and rationales of the ranked alternates, with a pointer to the full
+ * `<slug>.redesign.md`. Pure and deterministic. The full rich brief (ASCII
+ * layouts, complete type/colour/motion systems, hierarchy, copy) is
+ * `renderArtifactMarkdown`; this is the at-a-glance version that keeps the report
+ * scannable while still surfacing every direction by name.
+ */
+export declare function renderRedesignDirectionsSummary(a: RedesignArtifact, briefFile?: string): string;
+/** Stable slug for an audited URL — shared by the brief file name and the report. */
+export declare function artifactSlug(url: string): string;
+export declare function writeArtifact(a: RedesignArtifact, dir: string): Promise<{
+    jsonPath: string;
+    markdownPath: string;
+}>;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/artifact/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,iBAAiB,CAAA;AAG3F,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA6ClE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAYhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA+B/F;AAeD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAsB,aAAa,CACjC,CAAC,EAAE,gBAAgB,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAQrD"}

package/dist/design/audit/reference/artifact/render.js

@@ -0,0 +1,213 @@
+/**
+ * Artifact renderers + a thin disk writer.
+ *
+ * `renderArtifactMarkdown` and `renderArtifactJson` are PURE and deterministic:
+ * identical artifacts render identical bytes, so the markdown is snapshot-stable
+ * and reproducible across pages/reps. `writeArtifact` is the ONLY IO in this
+ * file — a small `fs` wrapper that lands both renderings next to each other.
+ *
+ * The markdown is the human-facing face of the engine: it names each direction,
+ * shows the ASCII layout, the type/colour/motion systems, the information
+ * hierarchy and the revised copy, plus the grounding exemplars and the pairwise
+ * ranking — everything the lossy `DesignFinding` projection cannot carry.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { clipToWord } from './text.js';
+export function renderArtifactMarkdown(a) {
+    const lines = [];
+    lines.push(`# Redesign directions — ${a.url}`, '');
+    if (a.referenceId)
+        lines.push(`Reference: \`${a.referenceId}\``, '');
+    lines.push(`Winner: ${a.ranking.winnerId || '—'} · ${a.directions.length} direction(s) · ${a.tokensUsed} tokens`, '');
+    lines.push('## Grounding exemplars', '');
+    if (a.retrieval.length === 0) {
+        lines.push('_No exemplars retrieved._', '');
+    }
+    else {
+        for (const r of a.retrieval)
+            lines.push(renderRetrieval(r));
+        lines.push('');
+    }
+    lines.push('## Ranking', '');
+    if (a.ranking.order.length === 0) {
+        lines.push('_Unranked._', '');
+    }
+    else {
+        lines.push('| rank | direction | Bradley-Terry | Elo |', '| --- | --- | --- | --- |');
+        a.ranking.order.forEach((id, i) => {
+            const bt = a.ranking.bradleyTerry[id];
+            const elo = a.ranking.elo[id];
+            lines.push(`| ${i + 1} | ${id} | ${bt !== undefined ? bt.toFixed(3) : '—'} | ${elo !== undefined ? Math.round(elo) : '—'} |`);
+        });
+        lines.push('');
+    }
+    a.directions.forEach((d) => lines.push(renderDirection(d, d.id === a.ranking.winnerId)));
+    if (a.verdicts.length > 0) {
+        lines.push('## Pairwise verdicts', '');
+        for (const v of a.verdicts) {
+            const w = v.winner === 'tie' ? 'tie' : v.winner;
+            const reasons = v.reasons.length ? ` — ${v.reasons.join('; ')}` : '';
+            lines.push(`- ${v.aId} vs ${v.bId} → **${w}** (margin ${v.margin.toFixed(2)})${reasons}`);
+        }
+        lines.push('');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+/**
+ * Agent-ready "apply this" spec for the WINNING direction — the single coherent,
+ * grounded redesign the `--evolve` coding agent should implement (not a pile of
+ * piecemeal findings). Names the grounding exemplars so the agent knows the bar.
+ */
+export function renderRedesignTarget(a) {
+    const winner = a.directions.find((d) => d.id === a.ranking.winnerId) ?? a.directions[0];
+    if (!winner)
+        return '';
+    const grounded = a.retrieval
+        .slice(0, 3)
+        .map((r) => r.exemplar.url || r.exemplar.id)
+        .filter(Boolean)
+        .join(', ');
+    const lines = ['REDESIGN TARGET — implement this single, coherent, world-class direction holistically.'];
+    if (grounded)
+        lines.push(`Grounded in real reference designs: ${grounded}`);
+    lines.push('', renderDirection(winner, true));
+    return lines.join('\n');
+}
+export function renderArtifactJson(a) {
+    return `${JSON.stringify(a, null, 2)}\n`;
+}
+/**
+ * A COMPACT projection of the artifact for the main audit report — the winner in
+ * brief (rationale + a one-line type/colour/hierarchy signature) plus the names
+ * and rationales of the ranked alternates, with a pointer to the full
+ * `<slug>.redesign.md`. Pure and deterministic. The full rich brief (ASCII
+ * layouts, complete type/colour/motion systems, hierarchy, copy) is
+ * `renderArtifactMarkdown`; this is the at-a-glance version that keeps the report
+ * scannable while still surfacing every direction by name.
+ */
+export function renderRedesignDirectionsSummary(a, briefFile) {
+    const lines = [];
+    lines.push(`### ${a.url}`, '');
+    if (a.referenceId)
+        lines.push(`Grounded in reference \`${a.referenceId}\`.`, '');
+    const winner = a.directions.find((d) => d.id === a.ranking.winnerId) ?? a.directions[0];
+    if (!winner) {
+        lines.push('_No ranked direction was produced._', '');
+        return `${lines.join('\n').trimEnd()}\n`;
+    }
+    lines.push(`**Winner — ${winner.name}**`, '');
+    if (winner.rationale.trim())
+        lines.push(clipToWord(winner.rationale, 280), '');
+    for (const sig of directionSignature(winner))
+        lines.push(`- ${sig}`);
+    lines.push('');
+    const alternates = a.directions.filter((d) => d.id !== winner.id);
+    if (alternates.length > 0) {
+        lines.push(`**Alternate directions (${alternates.length}):**`, '');
+        for (const d of alternates) {
+            const why = d.rationale.trim() ? ` — ${clipToWord(d.rationale, 160)}` : '';
+            lines.push(`- **${d.name}**${why}`);
+        }
+        lines.push('');
+    }
+    if (briefFile) {
+        lines.push(`Full brief — ASCII layout, type/colour/motion systems, hierarchy, and copy: \`${briefFile}\``, '');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+/** Compact one-line signatures of a direction's type / colour / hierarchy. */
+function directionSignature(d) {
+    const out = [];
+    const t = d.typeSystem;
+    out.push(`Type: ${t.families.join(', ') || '—'} · ${t.scalePx.join('/') || '—'}px${t.ratio ? ` · ~${t.ratio}×` : ''}`);
+    const c = d.colorSystem;
+    out.push(`Colour: ${c.primary}${c.accent ? ` / ${c.accent}` : ''} on ${c.background}`);
+    if (d.hierarchy.length > 0)
+        out.push(`Hierarchy: ${clipToWord(d.hierarchy.join(' → '), 160)}`);
+    return out;
+}
+/** Stable slug for an audited URL — shared by the brief file name and the report. */
+export function artifactSlug(url) {
+    return slugForUrl(url);
+}
+export async function writeArtifact(a, dir) {
+    await fs.mkdir(dir, { recursive: true });
+    const slug = slugForUrl(a.url);
+    const jsonPath = path.join(dir, `${slug}.artifact.json`);
+    const markdownPath = path.join(dir, `${slug}.artifact.md`);
+    await fs.writeFile(jsonPath, renderArtifactJson(a), 'utf8');
+    await fs.writeFile(markdownPath, renderArtifactMarkdown(a), 'utf8');
+    return { jsonPath, markdownPath };
+}
+function renderRetrieval(r) {
+    const e = r.exemplar;
+    const reasons = r.reasons.length ? ` — ${r.reasons.join('; ')}` : '';
+    return `- \`${e.id}\` (${e.source}, ${e.pageType}) · score ${r.score.toFixed(3)} · elo ${Math.round(e.eloRating)}${reasons}`;
+}
+function renderDirection(d, isWinner) {
+    const lines = [];
+    lines.push(`## ${isWinner ? '★ ' : ''}${d.name}`, '');
+    if (d.rationale.trim())
+        lines.push(d.rationale.trim(), '');
+    if (d.asciiLayout.trim()) {
+        lines.push('### Layout', '', '```', d.asciiLayout.replace(/\n+$/, ''), '```', '');
+    }
+    if (d.hierarchy.length > 0) {
+        lines.push('### Hierarchy', '');
+        d.hierarchy.forEach((h, i) => lines.push(`${i + 1}. ${h}`));
+        lines.push('');
+    }
+    const t = d.typeSystem;
+    lines.push('### Type', '');
+    lines.push(`- Families: ${t.families.join(', ') || '—'}`);
+    lines.push(`- Scale: ${t.scalePx.join(' / ') || '—'} px`);
+    lines.push(`- Ratio: ${t.ratio ? `~${t.ratio}×` : '—'}`);
+    if (t.rationale.trim())
+        lines.push(`- ${t.rationale.trim()}`);
+    lines.push('');
+    const c = d.colorSystem;
+    lines.push('### Color', '');
+    lines.push(`- Primary: ${c.primary}`);
+    if (c.accent)
+        lines.push(`- Accent: ${c.accent}`);
+    lines.push(`- Background: ${c.background}`);
+    lines.push(`- Neutrals: ${c.neutrals.join(', ') || '—'}`);
+    if (c.rationale.trim())
+        lines.push(`- ${c.rationale.trim()}`);
+    lines.push('');
+    const m = d.motionSpec;
+    lines.push('### Motion', '');
+    lines.push(`- Durations: ${m.durationsMs.join(' / ') || '—'} ms`);
+    lines.push(`- Easings: ${m.easings.join(', ') || '—'}`);
+    if (m.cues.length > 0)
+        lines.push(`- Cues: ${m.cues.join('; ')}`);
+    lines.push('');
+    // Drop no-op revisions (before === after after trim) so the brief's Copy table
+    // mirrors the findings projection — a row that changes nothing is noise.
+    const copy = d.copy.filter((rev) => rev.before === undefined || rev.before.trim() !== rev.after.trim());
+    if (copy.length > 0) {
+        lines.push('### Copy', '', '| location | before | after |', '| --- | --- | --- |');
+        for (const rev of copy) {
+            lines.push(`| ${mdCell(rev.location)} | ${mdCell(rev.before ?? '—')} | ${mdCell(rev.after)} |`);
+        }
+        lines.push('');
+    }
+    if (d.groundedInExemplarIds.length > 0) {
+        lines.push(`Grounded in: ${d.groundedInExemplarIds.map((id) => `\`${id}\``).join(', ')}`, '');
+    }
+    return lines.join('\n');
+}
+function mdCell(s) {
+    return s.replace(/\|/g, '\\|').replace(/\n+/g, ' ').trim() || '—';
+}
+function slugForUrl(url) {
+    const s = url
+        .replace(/^https?:\/\//, '')
+        .replace(/[^a-z0-9]+/gi, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 60)
+        .toLowerCase();
+    return s || 'artifact';
+}
+//# sourceMappingURL=render.js.map

package/dist/design/audit/reference/artifact/render.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Word-aware truncation shared by the findings summary and the report's redesign
+ * brief. Unlike the hard char-cut used for directional finding bodies, this never
+ * splits a word: it backs up to the last space before the limit, strips trailing
+ * punctuation, and appends a single ellipsis — so the text always ends cleanly.
+ *
+ * When no space falls inside the kept window (a single token longer than `max`)
+ * it degrades to a hard cut: there is no boundary to honour.
+ */
+export declare function clipToWord(s: string, max: number): string;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/artifact/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQzD"}

package/dist/design/audit/reference/artifact/text.js

@@ -0,0 +1,20 @@
+/**
+ * Word-aware truncation shared by the findings summary and the report's redesign
+ * brief. Unlike the hard char-cut used for directional finding bodies, this never
+ * splits a word: it backs up to the last space before the limit, strips trailing
+ * punctuation, and appends a single ellipsis — so the text always ends cleanly.
+ *
+ * When no space falls inside the kept window (a single token longer than `max`)
+ * it degrades to a hard cut: there is no boundary to honour.
+ */
+export function clipToWord(s, max) {
+    const t = s.trim().replace(/\s+/g, ' ');
+    if (t.length <= max)
+        return t;
+    // Guard max<=1: slice(0, max-1) with max=0 is slice(0,-1) (drops last char).
+    const slice = max > 1 ? t.slice(0, max - 1) : '';
+    const lastSpace = slice.lastIndexOf(' ');
+    const head = (lastSpace > 0 ? slice.slice(0, lastSpace) : slice).replace(/[\s.,;:!?-]+$/, '');
+    return `${head}…`;
+}
+//# sourceMappingURL=text.js.map

package/dist/design/audit/reference/artifact/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../../src/design/audit/reference/artifact/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,GAAW;IAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,CAAA;IAC7B,6EAA6E;IAC7E,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;IAC7F,OAAO,GAAG,IAAI,GAAG,CAAA;AACnB,CAAC"}

package/dist/design/audit/reference/artifact/to-findings.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Artifact → existing-pipeline compatibility layer. PURE: no IO, no LLM.
+ *
+ * Two responsibilities, both expressed by REUSING the v1 audit helpers rather
+ * than re-implementing them — this is what lets the reference-grounded engine
+ * return through the unchanged `PageAuditResult` contract that stages 7-9 expect:
+ *
+ *  1. `directionToFindings` projects the winning `RedesignDirection` + the
+ *     DNA-altitude `DnaDelta` onto the CLOSED `DesignFinding` enum as `minor`
+ *     recommendations, then MERGES the deterministic `measurementsToFindings`
+ *     ground truth (contrast + axe) and ROI-sorts the union via `annotateRoi` /
+ *     `topByRoi`. Directional items are always `minor`, so the v1
+ *     major/critical-must-carry-a-patch downgrade rule can never corrupt them;
+ *     `contrast` / `accessibility` findings come ONLY from measurements — the
+ *     generator is never allowed to invent them.
+ *  2. `toReferencePageAuditResult` maps a finished `RedesignRunResult` onto the
+ *     `PageAuditResult` shape. It NEVER re-scores: the reported page `score` IS
+ *     the engine's `headlineScore` — the single scoring authority (`score-core`
+ *     off one `QualityAssessment`, already measurement-capped by
+ *     `deriveHeadlineScore`). It does NOT borrow `conservativeScore`: there are no
+ *     per-pass page scores in this mode, and folding the per-`Dimension` scores in
+ *     would let an UNASSESSED placeholder (the default-budget fill, score 5 /
+ *     confidence 'low') drag a genuine headline down to ~5 — the scoring fiction
+ *     `score-core` was built to avoid. The rich per-dimension surface flows to
+ *     stage 8 as `precomputedScores`, never into this headline.
+ */
+import type { RedesignDirection, DnaDelta, MeasurementBundle, DesignFinding, RedesignRunResult, PageAuditResult, DesignDNA, RetrievalResult } from '../contracts.js';
+/**
+ * Project the winning direction + DNA gap onto `minor` `DesignFinding`s, merge
+ * the deterministic measurement findings, and return the ROI-sorted union.
+ *
+ * The directional categories are restricted to `typography` / `spacing` /
+ * `layout` / `ux` — `contrast` and `accessibility` are reserved for
+ * `measurementsToFindings` so a generated recommendation can never masquerade as
+ * a measured a11y/contrast fact.
+ *
+ * `dna` + `hits` are optional: when both are supplied an advisory scroll-motion
+ * finding may be minted (see {@link scrollMotionAdvisory}). Omitting them yields
+ * byte-identical output to the prior 3-arg behaviour.
+ */
+export declare function directionToFindings(winner: RedesignDirection, gap: DnaDelta, measurements: MeasurementBundle, dna?: DesignDNA, hits?: RetrievalResult[]): DesignFinding[];
+/**
+ * Map a finished engine run onto the v1 `PageAuditResult` so the reference mode
+ * flows through stages 7-9 unchanged. Pure: it shapes already-computed values
+ * and never issues a new scoring pass.
+ *
+ * `score` IS `result.headlineScore` — the single scoring authority. The headline
+ * is monotonic in the page's win-rate vs world-class exemplars and already capped
+ * by `deriveHeadlineScore` when measurements flag blocking issues. The per-
+ * `Dimension` scores are NOT folded in here: under the default judge budget they
+ * are UNASSESSED placeholders (`score-core`'s confidence-'low' fill), and
+ * averaging those into the reported number would crush a genuine headline toward
+ * 5. The rich dimension surface is consumed by stage 8 as `precomputedScores`
+ * instead. `findings` carries the already ROI-sorted set from the core.
+ */
+export declare function toReferencePageAuditResult(result: RedesignRunResult): PageAuditResult;
+//# sourceMappingURL=to-findings.d.ts.map

package/dist/design/audit/reference/artifact/to-findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-findings.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/artifact/to-findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EAGf,SAAS,EACT,eAAe,EAChB,MAAM,iBAAiB,CAAA;AAwFxB;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,iBAAiB,EAC/B,GAAG,CAAC,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,eAAe,EAAE,GACvB,aAAa,EAAE,CAqIjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAcrF"}