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

package/dist/design/audit/pipeline.js

@@ -7,10 +7,16 @@
  * a pure function elsewhere in this module — easy to unit test in isolation.
  */
 import * as path from 'node:path';
-import { classifyPage, defaultClassification } from './classify.js';
+import { defaultClassification } from './classify.js';
 import { composeRubric, composeRubricFromProfile } from './rubric/loader.js';
 import { gatherMeasurements } from './measure/index.js';
 import { evaluatePage } from './evaluate.js';
+import { getTelemetry, shortHash } from '../../telemetry/index.js';
+import { loadEthicsRules } from './ethics/loader.js';
+import { checkEthics, pageTextBlob } from './ethics/check.js';
+import { classifyEnsemble } from './classify-ensemble.js';
+import { loadAnchors } from './rubric/anchor-loader.js';
+import { buildAuditResultV2 } from './v2/build-result.js';
 const COOKIE_BANNER_SELECTORS = [
     'button:has-text("Accept all")',
     'button:has-text("Accept")',
@@ -32,7 +38,8 @@ async function dismissCookieBanners(page) {
  * Audit one page through the full Gen 2 pipeline.
  */
 export async function auditOnePage(opts) {
-    const { brain, driver, page, url, profileOverride, screenshotDir, userRubricsDir } = opts;
+    const { brain, driver, page, url, profileOverride, screenshotDir, userRubricsDir, auditPasses, runId, parentRunId, provider, model, overrides, skipEthics, ethicsRulesDir, audience, modality, regulatoryContext, audienceVulnerability, } = opts;
+    const startedAt = Date.now();
     try {
         // ── 1. Load the page ──
         await page
@@ -49,7 +56,9 @@ export async function auditOnePage(opts) {
             await page.screenshot({ path: screenshotPath, fullPage: false });
         }
         // ── 3. Classify (or use profile override) ──
+        // Layer 1: ensemble classifier (URL + DOM + LLM) when no override is set.
         let classification;
+        let ensemble;
         if (profileOverride) {
             // Build a synthetic classification matching the explicit profile
             classification = {
@@ -59,7 +68,8 @@ export async function auditOnePage(opts) {
             };
         }
         else {
-            classification = await classifyPage(brain, state);
+            ensemble = await classifyEnsemble({ brain, state, url });
+            classification = ensemble;
         }
         // ── 4. Compose rubric ──
         const rubric = profileOverride
@@ -84,17 +94,134 @@ export async function auditOnePage(opts) {
             rubric,
             measurements,
             screenshotPath,
+            auditPasses,
+            overrides,
         });
+        // ── 7. Ethics gate (Layer 7) — apply rollup floor when rules fire ──
+        if (skipEthics) {
+            console.warn(`[ethics] --skip-ethics: gate bypassed for ${url} (test-only)`);
+            result.ethicsViolations = [];
+        }
+        else {
+            const rules = loadEthicsRules(ethicsRulesDir);
+            const ethicsViolations = await checkEthics(rules, {
+                pageText: pageTextBlob(state.snapshot, { url, title: state.title }),
+                snapshot: state.snapshot,
+                classification,
+                audience,
+                modality,
+                regulatoryContext,
+                audienceVulnerability,
+            }, { brain });
+            if (ethicsViolations.length > 0) {
+                const minCap = Math.min(...ethicsViolations.map((v) => v.rollupCap));
+                if (typeof result.score === 'number' && result.score > minCap) {
+                    result.preEthicsScore = result.score;
+                    result.score = minCap;
+                }
+            }
+            result.ethicsViolations = ethicsViolations;
+        }
+        // ── 8. Layer 1 v2 — multi-dim scoring + rollup, emitted alongside v1 ──
+        if (ensemble) {
+            try {
+                const anchors = loadAnchors();
+                const anchor = anchors.get(ensemble.type);
+                const v2 = await buildAuditResultV2({
+                    brain,
+                    state,
+                    pageRef: url,
+                    ensemble,
+                    rubric,
+                    measurements,
+                    v1Result: result,
+                    anchor,
+                    runId,
+                });
+                result.auditResultV2 = v2;
+                result.ensembleClassification = ensemble;
+            }
+            catch (v2Err) {
+                // Don't let v2 failures break v1. Log + move on.
+                console.warn(`[audit/v2] failed to build v2 result for ${url}: ${v2Err.message}`);
+            }
+        }
+        if (runId) {
+            const findings = result.findings ?? [];
+            const ethicsViolations = result.ethicsViolations ?? [];
+            getTelemetry().emit({
+                kind: 'design-audit-page',
+                runId,
+                parentRunId,
+                ok: !result.error,
+                durationMs: Date.now() - startedAt,
+                ...(provider && model ? { model: { provider, name: model, rubricHash: shortHash(rubric.body) } } : {}),
+                data: {
+                    url,
+                    classification,
+                    rubricFragments: rubric.fragments.map((f) => f.id),
+                    rubricDimensions: rubric.dimensions,
+                    auditPasses: auditPasses ?? ['standard'],
+                    designSystemScore: result.designSystemScore,
+                    summary: result.summary,
+                    strengths: result.strengths,
+                    findings: findings.map((f) => ({
+                        category: f.category,
+                        severity: f.severity,
+                        description: f.description,
+                        location: f.location,
+                        cssSelector: f.cssSelector,
+                        impact: f.impact,
+                        effort: f.effort,
+                        blast: f.blast,
+                    })),
+                },
+                metrics: {
+                    score: result.score,
+                    findingCount: findings.length,
+                    criticalCount: findings.filter((f) => f.severity === 'critical').length,
+                    majorCount: findings.filter((f) => f.severity === 'major').length,
+                    minorCount: findings.filter((f) => f.severity === 'minor').length,
+                    contrastAaPassRate: measurements.contrast.summary.aaPassRate,
+                    a11yViolations: measurements.a11y.violations.length,
+                    tokensUsed: result.tokensUsed ?? 0,
+                    ethicsViolations: ethicsViolations.length,
+                    ethicsCriticalFloor: ethicsViolations.filter((v) => v.severity === 'critical-floor').length,
+                    ethicsMajorFloor: ethicsViolations.filter((v) => v.severity === 'major-floor').length,
+                },
+                tags: {
+                    pageType: classification.type,
+                    domain: classification.domain,
+                    maturity: classification.maturity,
+                    designSystem: classification.designSystem,
+                },
+            });
+        }
         return result;
     }
     catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        if (runId) {
+            getTelemetry().emit({
+                kind: 'design-audit-page',
+                runId,
+                parentRunId,
+                ok: false,
+                durationMs: Date.now() - startedAt,
+                ...(provider && model ? { model: { provider, name: model } } : {}),
+                data: { url },
+                metrics: { score: 0, findingCount: 0 },
+                error,
+            });
+        }
         return {
             url,
             score: 0,
             summary: 'Audit failed',
             strengths: [],
             findings: [],
-            error: err instanceof Error ? err.message : String(err),
+            ethicsViolations: [],
+            error,
         };
     }
 }

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

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

package/dist/design/audit/rubric/anchor-loader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Anchor loader — Layer 1 of the world-class design-audit architecture.
+ *
+ * Loads per-page-type calibration anchors from `anchors/<type>.yaml`. Each
+ * anchor encodes score-band criteria + reference fixtures so the LLM scores
+ * an saas-app like Linear's app, not like Linear's marketing site.
+ *
+ * Schema:
+ *   type: <PageType>
+ *   score_9_10: { criteria: string[], fixtures: string[] }
+ *   score_7_8:  { criteria: string[], fixtures: string[] }
+ *   score_5_6:  { criteria: string[], fixtures: string[] }
+ *   score_3_4:  { criteria: string[], fixtures: string[] }
+ */
+import type { PageType } from '../types.js';
+export interface AnchorBand {
+    criteria: string[];
+    fixtures: string[];
+}
+export interface CalibrationAnchor {
+    type: PageType;
+    score_9_10: AnchorBand;
+    score_7_8: AnchorBand;
+    score_5_6: AnchorBand;
+    score_3_4: AnchorBand;
+}
+/**
+ * Parse one anchor YAML. Uses a minimal YAML reader that handles the shape:
+ *   type: saas-app
+ *   score_9_10:
+ *     criteria:
+ *       - line one
+ *       - line two
+ *     fixtures:
+ *       - fixture:linear-app
+ *
+ * Avoids pulling in a YAML dep for ~9 small files. Throws on malformed input.
+ */
+export declare function parseAnchorFile(filePath: string): CalibrationAnchor;
+/** Load all anchors from `anchors/` into a map keyed by PageType. */
+export declare function loadAnchors(dir?: string): Map<PageType, CalibrationAnchor>;
+/** Render an anchor as a markdown block for prompt injection. */
+export declare function renderAnchor(anchor: CalibrationAnchor): string;
+//# sourceMappingURL=anchor-loader.d.ts.map

package/dist/design/audit/rubric/anchor-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-loader.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/rubric/anchor-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAK3C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,UAAU,CAAA;IACrB,SAAS,EAAE,UAAU,CAAA;IACrB,SAAS,EAAE,UAAU,CAAA;CACtB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAuBnE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAoB,GAAG,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CASvF;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAU9D"}

package/dist/design/audit/rubric/anchor-loader.js

@@ -0,0 +1,210 @@
+/**
+ * Anchor loader — Layer 1 of the world-class design-audit architecture.
+ *
+ * Loads per-page-type calibration anchors from `anchors/<type>.yaml`. Each
+ * anchor encodes score-band criteria + reference fixtures so the LLM scores
+ * an saas-app like Linear's app, not like Linear's marketing site.
+ *
+ * Schema:
+ *   type: <PageType>
+ *   score_9_10: { criteria: string[], fixtures: string[] }
+ *   score_7_8:  { criteria: string[], fixtures: string[] }
+ *   score_5_6:  { criteria: string[], fixtures: string[] }
+ *   score_3_4:  { criteria: string[], fixtures: string[] }
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ANCHORS_DIR = path.join(__dirname, 'anchors');
+const REQUIRED_BANDS = ['score_9_10', 'score_7_8', 'score_5_6', 'score_3_4'];
+/**
+ * Parse one anchor YAML. Uses a minimal YAML reader that handles the shape:
+ *   type: saas-app
+ *   score_9_10:
+ *     criteria:
+ *       - line one
+ *       - line two
+ *     fixtures:
+ *       - fixture:linear-app
+ *
+ * Avoids pulling in a YAML dep for ~9 small files. Throws on malformed input.
+ */
+export function parseAnchorFile(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const parsed = parseAnchorYaml(raw);
+    if (!parsed.type || typeof parsed.type !== 'string') {
+        throw new Error(`anchor ${filePath} missing 'type' field`);
+    }
+    for (const band of REQUIRED_BANDS) {
+        const node = parsed[band];
+        if (!node || typeof node !== 'object') {
+            throw new Error(`anchor ${filePath} missing '${band}' band`);
+        }
+        const b = node;
+        if (!Array.isArray(b.criteria) || b.criteria.length === 0) {
+            throw new Error(`anchor ${filePath} '${band}.criteria' must be a non-empty array`);
+        }
+        if (!Array.isArray(b.fixtures) || b.fixtures.length === 0) {
+            throw new Error(`anchor ${filePath} '${band}.fixtures' must be a non-empty array`);
+        }
+    }
+    return parsed;
+}
+/** Load all anchors from `anchors/` into a map keyed by PageType. */
+export function loadAnchors(dir = ANCHORS_DIR) {
+    const out = new Map();
+    if (!fs.existsSync(dir))
+        return out;
+    for (const file of fs.readdirSync(dir)) {
+        if (!file.endsWith('.yaml') && !file.endsWith('.yml'))
+            continue;
+        const anchor = parseAnchorFile(path.join(dir, file));
+        out.set(anchor.type, anchor);
+    }
+    return out;
+}
+/** Render an anchor as a markdown block for prompt injection. */
+export function renderAnchor(anchor) {
+    const band = (label, b) => `${label}\n${b.criteria.map((c) => `- ${c}`).join('\n')}\nReferences: ${b.fixtures.join(', ')}`;
+    return [
+        `Calibration anchor for ${anchor.type}:`,
+        band('Score 9-10:', anchor.score_9_10),
+        band('Score 7-8:', anchor.score_7_8),
+        band('Score 5-6:', anchor.score_5_6),
+        band('Score 3-4:', anchor.score_3_4),
+    ].join('\n\n');
+}
+/**
+ * Minimal YAML parser scoped to the anchor file shape. Supports:
+ *   key: scalar
+ *   key:
+ *     subkey: scalar
+ *     subkey:
+ *       - list item
+ *
+ * Indentation is normalized to spaces; tabs are not supported.
+ */
+function parseAnchorYaml(text) {
+    const lines = text.split('\n').map((l) => l.replace(/\r$/, ''));
+    const root = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim() || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const indent = leadingSpaces(line);
+        if (indent !== 0) {
+            i++;
+            continue;
+        }
+        const m = line.match(/^([a-zA-Z_][\w-]*):\s*(.*)$/);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const [, key, valueRaw] = m;
+        const value = valueRaw.trim();
+        if (value === '') {
+            const { node, nextIndex } = readBlock(lines, i + 1, 2);
+            root[key] = node;
+            i = nextIndex;
+        }
+        else {
+            root[key] = parseScalar(value);
+            i++;
+        }
+    }
+    return root;
+}
+function readBlock(lines, startIndex, baseIndent) {
+    // Detect: is this a list ("- item") or a map?
+    let i = startIndex;
+    while (i < lines.length && !lines[i].trim())
+        i++;
+    if (i >= lines.length)
+        return { node: {}, nextIndex: i };
+    const firstIndent = leadingSpaces(lines[i]);
+    if (firstIndent < baseIndent)
+        return { node: {}, nextIndex: i };
+    if (lines[i].trim().startsWith('- ') || lines[i].trim() === '-') {
+        const items = [];
+        while (i < lines.length) {
+            const line = lines[i];
+            if (!line.trim()) {
+                i++;
+                continue;
+            }
+            const indent = leadingSpaces(line);
+            if (indent < baseIndent)
+                break;
+            const trimmed = line.trim();
+            if (!trimmed.startsWith('-'))
+                break;
+            const item = trimmed.replace(/^-\s*/, '');
+            items.push(parseScalar(item));
+            i++;
+        }
+        return { node: items, nextIndex: i };
+    }
+    const map = {};
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim() || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const indent = leadingSpaces(line);
+        if (indent < baseIndent)
+            break;
+        if (indent > baseIndent) {
+            i++;
+            continue;
+        }
+        const m = line.match(/^\s*([a-zA-Z_][\w-]*):\s*(.*)$/);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const [, key, valueRaw] = m;
+        const value = valueRaw.trim();
+        if (value === '') {
+            const { node, nextIndex } = readBlock(lines, i + 1, baseIndent + 2);
+            map[key] = node;
+            i = nextIndex;
+        }
+        else {
+            map[key] = parseScalar(value);
+            i++;
+        }
+    }
+    return { node: map, nextIndex: i };
+}
+function leadingSpaces(line) {
+    let n = 0;
+    while (n < line.length && line[n] === ' ')
+        n++;
+    return n;
+}
+function parseScalar(raw) {
+    let value = raw.trim();
+    if (value === '')
+        return '';
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+    }
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null' || value === '~')
+        return null;
+    if (/^-?\d+$/.test(value))
+        return Number(value);
+    if (/^-?\d+\.\d+$/.test(value))
+        return Number(value);
+    return value;
+}
+//# sourceMappingURL=anchor-loader.js.map

package/dist/design/audit/rubric/anchor-loader.js.map

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

package/dist/design/audit/rubric/anchors/blog.yaml

@@ -0,0 +1,33 @@
+type: blog
+score_9_10:
+  criteria:
+    - Reading column tuned to 60-75 character measure with deliberate vertical rhythm
+    - Typography scale supports headings, body, callouts, code, captions distinctly
+    - Author identity and publication date prominent without being chrome
+    - Inline media (images, code, embeds) integrate cleanly with text flow
+    - Navigation between posts (next, related, archive) supports the reading habit
+  fixtures:
+    - fixture:stratechery
+    - fixture:substack-post
+    - fixture:notion-blog-template
+score_7_8:
+  criteria:
+    - Strong reading experience but typographic scale is one step shy of intentional
+    - Author and date present but visually inconsistent
+    - Inline media works but breaks rhythm at boundaries
+  fixtures:
+    - fixture:medium-default
+score_5_6:
+  criteria:
+    - Default theme typography (no custom scale, line-height defaults)
+    - Heavy chrome (sidebar, social rail) competing with the article
+    - Author/date hidden in footer
+  fixtures:
+    - fixture:default-ghost
+score_3_4:
+  criteria:
+    - Article copy crammed against gutters; no measure control
+    - Inline ads break reading flow every paragraph
+    - No publication date — content is unanchored in time
+  fixtures:
+    - fixture:ad-heavy-article

package/dist/design/audit/rubric/anchors/dashboard.yaml

@@ -0,0 +1,35 @@
+type: dashboard
+score_9_10:
+  criteria:
+    - Real metrics with units, time windows, and comparison baselines visible at first glance
+    - Charts use deliberate scales, axis labels, and selective color (not rainbow defaults)
+    - Filters, time ranges, and segment selectors are obvious and persistent
+    - Empty states preview real data shape (sample rows, last-7-days skeleton)
+    - Density tuned to operator workflow — no decorative whitespace where dense data belongs
+  fixtures:
+    - fixture:linear-app
+    - fixture:figma-file-ui
+    - fixture:datadog-dashboard
+    - fixture:vercel-dashboard
+score_7_8:
+  criteria:
+    - Metrics present and useful but lack comparison baselines or time-window controls
+    - Charts readable but use default color palette; minor density issues
+    - Filters present but discoverability unclear
+  fixtures:
+    - fixture:grafana-default
+score_5_6:
+  criteria:
+    - Generic stat cards (4 equal boxes) without context or comparison
+    - Charts are rainbow defaults from the component library
+    - No filters or time-range affordance
+    - Empty states are illustrations + platitudes
+  fixtures:
+    - fixture:generic-dashboard
+score_3_4:
+  criteria:
+    - Numbers without units, labels, or context — operator cannot tell good from bad
+    - Decorative chart visualizations (donuts, gauges) instead of operational data
+    - Equal-weight UI controls; no clear workflow path
+  fixtures:
+    - fixture:empty-state-noise

package/dist/design/audit/rubric/anchors/docs.yaml

@@ -0,0 +1,35 @@
+type: docs
+score_9_10:
+  criteria:
+    - Quickstart path from landing to a working result is obvious within one viewport
+    - Code samples are runnable, copy-button-equipped, and language-tabbed where relevant
+    - Reference structure (sidebar, breadcrumbs, search) supports both linear and lookup reading
+    - Versioning, deprecation, and last-updated signals are visible
+    - Typography scale and line-length tuned for sustained reading
+  fixtures:
+    - fixture:stripe-docs
+    - fixture:tailwind-docs
+    - fixture:mdn-docs
+    - fixture:vercel-docs
+score_7_8:
+  criteria:
+    - Quickstart present but buried; copy is solid but examples are partial
+    - Sidebar IA works but search is weak or missing
+    - Versioning unclear
+  fixtures:
+    - fixture:generic-mkdocs
+score_5_6:
+  criteria:
+    - Wall-of-text reference with no quickstart
+    - Code samples without copy buttons or language switching
+    - No search, no breadcrumbs, no last-updated metadata
+    - Default theme typography (inconsistent line-height, no scale)
+  fixtures:
+    - fixture:default-docusaurus
+score_3_4:
+  criteria:
+    - Marketing page disguised as docs (heavy hero, no actual reference)
+    - No code samples or syntax highlighting
+    - IA broken — "Getting Started" buried under marketing copy
+  fixtures:
+    - fixture:marketing-as-docs

package/dist/design/audit/rubric/anchors/ecommerce.yaml

@@ -0,0 +1,33 @@
+type: ecommerce
+score_9_10:
+  criteria:
+    - Product photography is real, detailed, and honest (not stock or AI-rendered)
+    - Price, fees, taxes, shipping, and total are surfaced before the commit button
+    - Stock, delivery, and return-policy signals are visible at decision points
+    - Cart and checkout flows preserve context — user always knows what they are buying
+    - Trust signals (verified payment, secure checkout, real merchant identity) appear where commitment occurs
+  fixtures:
+    - fixture:apple-store
+    - fixture:shopify-storefront
+    - fixture:allbirds-pdp
+score_7_8:
+  criteria:
+    - Solid PDPs but checkout exposes fees only at the last step
+    - Stock and delivery info present but inconsistent across pages
+    - Photography mixes real and stock
+  fixtures:
+    - fixture:generic-shopify
+score_5_6:
+  criteria:
+    - Fees surfaced only after pressing Pay; no shipping calculator
+    - Stock/delivery signals missing on PDPs
+    - Generic merchant identity, no trust badges, no return policy summary
+  fixtures:
+    - fixture:hidden-fees-checkout
+score_3_4:
+  criteria:
+    - Total never shown until after commitment
+    - No merchant identity, no return policy, no trust signals
+    - Forced account creation before checkout, dark-pattern upsells
+  fixtures:
+    - fixture:dark-pattern-checkout

package/dist/design/audit/rubric/anchors/marketing.yaml

@@ -0,0 +1,34 @@
+type: marketing
+score_9_10:
+  criteria:
+    - Hero answers product, audience, and outcome within five seconds
+    - One dominant CTA, secondary actions clearly subordinate
+    - Concrete proof (real customer logos, real metrics, real screenshots) above the fold
+    - Visual craft (typography ramp, spacing rhythm, color system) is intentional, not template-default
+    - Differentiation is shown, not asserted; copy avoids vague hype
+  fixtures:
+    - fixture:stripe-marketing
+    - fixture:linear-marketing
+    - fixture:vercel-marketing
+    - fixture:apple-marketing
+score_7_8:
+  criteria:
+    - Hero clear, but proof is generic (lorem-style logo cloud) or differentiation thin
+    - Visual system coherent but unremarkable; one or two minor rhythm breaks
+    - CTA dominant on hero but competes elsewhere
+  fixtures:
+    - fixture:generic-saas-marketing
+score_5_6:
+  criteria:
+    - Hero copy explains the product instead of selling the outcome
+    - Visual hierarchy works but feels like a Tailwind starter
+    - Equal-weight CTAs, vague social proof, stock illustrations
+  fixtures:
+    - fixture:meta-copy-feature
+score_3_4:
+  criteria:
+    - No primary message; could swap nouns and apply to any startup
+    - No CTA hierarchy; the page is a wall of equal sections
+    - Stock photography, generic gradients, default UI kit components
+  fixtures:
+    - fixture:ambiguous-deploy