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

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

package/dist/design/audit/rubric/anchors/saas-app.yaml

@@ -0,0 +1,38 @@
+type: saas-app
+score_9_10:
+  criteria:
+    - Domain object visible above the fold (tasks, deployments, conversations, files)
+    - One visually-dominant primary action per page state
+    - Empty states preview real product (sample rows, setup checklists, status timelines), not generic illustrations
+    - Action hierarchy = product hierarchy; no decorative buttons competing with workflow
+    - Trust details visible where commitment exists (price, permissions, undo, audit trail)
+  fixtures:
+    - fixture:linear-app
+    - fixture:figma-file-ui
+    - fixture:notion-editor
+    - fixture:superhuman
+    - fixture:github-pr-view
+score_7_8:
+  criteria:
+    - Most criteria from 9-10 with one or two minor gaps
+    - Polish gaps that don't block job completion
+    - Domain objects present but action hierarchy slightly diffuse
+  fixtures:
+    - fixture:airtable-grid
+    - fixture:notion-database
+score_5_6:
+  criteria:
+    - Functional but generic component-library assembly
+    - No domain object above the fold OR action hierarchy unclear
+    - Empty states show illustrations + platitudes instead of product preview
+    - Multiple equal-weight CTAs without a dominant primary
+  fixtures:
+    - fixture:generic-dashboard
+score_3_4:
+  criteria:
+    - No primary job inferable from screen
+    - Equal-weight CTAs blocking workflow
+    - Decorative elements actively distract from product surface
+    - Page reads as a marketing/setup stub rather than an operational product
+  fixtures:
+    - fixture:no-primary-action

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

@@ -0,0 +1,33 @@
+type: social
+score_9_10:
+  criteria:
+    - Feed prioritizes real content (posts, conversations) over chrome and ads
+    - Compose surface is one click away and primary in the layout
+    - Identity signals (verified accounts, profile preview, follower counts) consistent and lightweight
+    - State transitions (like, reply, repost) feel instant and reversible
+    - Empty states preview what the feed will look like with a few followed accounts
+  fixtures:
+    - fixture:threads-web
+    - fixture:bluesky-web
+    - fixture:substack-inline
+score_7_8:
+  criteria:
+    - Solid feed and compose flow but reply chains are visually flat
+    - Identity signals inconsistent across surfaces
+    - Empty states use illustrations rather than previewing real content
+  fixtures:
+    - fixture:generic-microblog
+score_5_6:
+  criteria:
+    - Feed cluttered with chrome (rails, ads, suggestions) competing with content
+    - Compose buried two clicks deep
+    - Action affordances (reply, like, share) are equal weight with no clear primary
+  fixtures:
+    - fixture:cluttered-feed
+score_3_4:
+  criteria:
+    - Page reads as ad inventory with content squeezed in
+    - No clear primary feed; multiple surfaces compete
+    - Identity signals fake or absent (anonymous content with no provenance)
+  fixtures:
+    - fixture:ad-heavy-feed

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

@@ -0,0 +1,33 @@
+type: tool
+score_9_10:
+  criteria:
+    - Single-purpose surface — the input and output relationship is immediate and obvious
+    - Keyboard-first interaction (shortcuts, focus management, paste support)
+    - Output is copyable, exportable, and shareable without modal interruption
+    - Recent results, history, or undo always available
+    - State (input, processing, output, error) handled explicitly with clear transitions
+  fixtures:
+    - fixture:linear-command-palette
+    - fixture:github-pr-view
+    - fixture:raycast
+score_7_8:
+  criteria:
+    - Tool works well but lacks keyboard affordances or history
+    - Output exportable but with extra clicks
+    - Error states present but generic
+  fixtures:
+    - fixture:generic-converter
+score_5_6:
+  criteria:
+    - Form-and-submit pattern with reload-style output
+    - No keyboard shortcuts, no history, no undo
+    - Loading and error states use defaults
+  fixtures:
+    - fixture:basic-tool-form
+score_3_4:
+  criteria:
+    - Multi-step flow for what should be a single action
+    - Output requires manual selection/copy
+    - No error handling — failures show generic browser errors
+  fixtures:
+    - fixture:broken-tool

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

@@ -0,0 +1,33 @@
+type: utility
+score_9_10:
+  criteria:
+    - Status, configuration, or admin surface that exposes the operational object directly (deploy, build, job, account)
+    - Real state (running, succeeded, failed, queued) with timestamps and durations
+    - Action affordances (retry, rollback, configure, audit) match the operational verbs of the system
+    - Logs, diagnostics, or detail panels are one click from the summary
+    - Empty states preview what real activity will look like
+  fixtures:
+    - fixture:vercel-deployment-status
+    - fixture:cloudflare-dashboard
+    - fixture:github-actions
+score_7_8:
+  criteria:
+    - Status surface clear but action affordances are generic (Edit/Save instead of Retry/Rollback)
+    - Logs accessible but require navigation
+    - Empty states use illustrations rather than previewing activity
+  fixtures:
+    - fixture:generic-admin
+score_5_6:
+  criteria:
+    - Status indicators are decorative pills without timestamps or durations
+    - Logs and diagnostics buried in modals
+    - Forms-of-forms pattern instead of operational verbs
+  fixtures:
+    - fixture:basic-settings-page
+score_3_4:
+  criteria:
+    - Status is text only — no visual signal of failure or success
+    - No way to retry, rollback, or audit from the surface
+    - Settings sprawl with no IA, no search
+  fixtures:
+    - fixture:settings-sprawl

package/dist/design/audit/rubric/fragments/audience-clinician.md

@@ -0,0 +1,42 @@
+---
+id: audience-clinician
+title: Clinician Audience
+weight: high
+applies-when:
+  audience: [clinician]
+---
+
+This surface is used by clinical professionals (physicians, nurses, pharmacists,
+therapists) in high-stakes decision-making contexts. Standard consumer-UX
+heuristics are insufficient — apply the following additional lens.
+
+INFORMATION DENSITY
+- Clinicians tolerate and often require high information density. Sparse
+  consumer-style layouts that hide detail behind progressive disclosure are
+  friction, not polish.
+- Data tables, lab result grids, medication lists must be fully visible without
+  expand/collapse. If key data is folded, score `content_ia` lower.
+
+WORKFLOW EFFICIENCY
+- Clinicians context-switch constantly (patient to patient, chart to EHR to
+  order entry). Keyboard navigation, dense primary actions, and minimal
+  confirmation dialogs for routine operations are expected.
+- If standard consumer patterns (fat CTAs, step-by-step wizards) dominate
+  routine tasks, score `workflow` lower.
+
+CRITICAL VALUE FLAGGING
+- Out-of-range lab values, drug interactions, and alert states must be
+  immediately visible with high visual contrast — not just color. Include
+  icon + text pattern redundancy.
+- Missing or weak critical-value flagging is a major finding in `trust_clarity`.
+
+AUDIT TRAIL AND ATTRIBUTION
+- Clinician workflows require visible "who did what, when" — last modified by,
+  order placed by, cosigned by. This is both regulatory and practical.
+- If attributable actions lack visible provenance, that is a major finding in
+  `trust_clarity`.
+
+DO NOT penalize for:
+- Dense information layouts (this is intentional)
+- Lack of illustrations or hero imagery
+- Technical terminology appropriate to the audience

package/dist/design/audit/rubric/fragments/audience-developer.md

@@ -0,0 +1,40 @@
+---
+id: audience-developer
+title: Developer Audience
+weight: medium
+applies-when:
+  audience: [developer]
+---
+
+This surface is used by software engineers and technical practitioners.
+
+INFORMATION OVER DECORATION
+- Code samples, CLI commands, API endpoints, and technical specifications must
+  be immediately accessible — not gated behind tabs, scrolling, or "Request
+  Demo" flows. If core technical content requires navigation to find, score
+  `content_ia` lower.
+
+COPY-PASTE HYGIENE
+- Every code block must have a visible copy button or be selectable without
+  capturing surrounding prose. Missing copy affordance is a minor-to-major
+  finding in `workflow` depending on frequency.
+
+DARK MODE AND TERMINAL AESTHETICS
+- Developers default to dark environments. A light-only surface with no dark
+  mode is a `visual_craft` minor finding. A surface that actively breaks
+  (illegible code contrast) in dark mode is major.
+
+AUTHENTICATION PATHS
+- API keys, tokens, and credentials should be displayed with
+  mask-by-default + reveal-on-click. Showing credentials in plaintext by
+  default is a critical `trust_clarity` finding.
+
+SEARCH AS PRIMARY NAVIGATION
+- Technical docs and reference surfaces must have a prominent, keyboard-
+  accessible search. If Cmd/Ctrl-K does not open search, that is a major
+  finding in `workflow`.
+
+DO NOT penalize for:
+- Dense information layouts
+- Monospace typography sections
+- Minimal illustration or marketing copy

package/dist/design/audit/rubric/fragments/audience-kids.md

@@ -0,0 +1,35 @@
+---
+id: audience-kids
+title: Kids Audience
+weight: critical
+applies-when:
+  audience: [kids]
+---
+
+This surface is used by or targeted at minors. Apply the following additional
+lens. Note: ethics rules in Layer 7 enforce hard score floors independently
+of rubric scoring — both layers apply simultaneously.
+
+AGE-APPROPRIATE LANGUAGE AND IMAGERY
+- Copy must be readable at the stated age level. Technical jargon, legalese,
+  or implicit social pressure ("Your friends are waiting!") are major findings
+  in `content_ia`.
+- Imagery should be appropriate for the age group. Mature themes, even subtle
+  ones, are critical findings in `trust_clarity`.
+
+FRICTION-SYMMETRIC FLOWS
+- Actions that benefit the operator (in-app purchase, data sharing, account
+  creation) must have equal or greater friction than their reversal
+  (cancellation, data deletion, account closure).
+- Any flow where it is easier to spend money / share data than to undo is a
+  critical finding in `workflow`.
+
+PARENTAL CONTROLS VISIBILITY
+- If the app collects data from minors, parental consent or control mechanisms
+  must be visible without buried navigation. If absent: major finding in
+  `trust_clarity`.
+
+DO NOT penalize for:
+- Simplified language and larger touch targets
+- Reduced information density appropriate to age
+- Bright color palettes and playful illustration styles