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

package/dist/design/audit/score-types.d.ts

@@ -0,0 +1,431 @@
+/**
+ * design audit — type contract for the 8-layer architecture.
+ *
+ * RFC: docs/rfc/design-audit-world-class.md
+ *
+ * This file is the stable contract that every layer's implementation
+ * builds against. It exists to let parallel implementation work proceed
+ * without diverging interfaces. Editing this file mid-build is a coordinated
+ * change; layers must update in lockstep.
+ *
+ * Invariants enforced by this contract:
+ *   - Every score is a `DimensionScore` with `range` + `confidence`. No bare numbers.
+ *   - Every finding with `severity in ['major','critical']` MUST have ≥1 `Patch`.
+ *   - Every patch has both `target` (what changes) and `testThatProves` (how we verify).
+ *   - Every classification carries explicit `ensembleConfidence` and `signalsAgreed`.
+ *   - Every audit run can write a `PatchApplication` event for post-hoc attribution.
+ *   - Pattern, ethics, modality types compose cleanly via shared `AppliesWhen`.
+ */
+import type { PageClassification, PageType, Maturity, DesignSystemTag, AppliesWhen as BaseAppliesWhen, MeasurementBundle, DesignFinding as DesignFindingBase } from './types.js';
+export type { PageClassification, PageType, Maturity, DesignSystemTag, MeasurementBundle };
+/**
+ * The five universal dimensions. Every audit produces a DimensionScore for
+ * each. The rollup is computed from these via per-page-type weights.
+ */
+export type Dimension = 'product_intent' | 'visual_craft' | 'trust_clarity' | 'workflow' | 'content_ia';
+export declare const DIMENSIONS: readonly Dimension[];
+export type ConfidenceLevel = 'high' | 'medium' | 'low';
+export interface DimensionScore {
+    /** 1-10 integer score on the dimension. */
+    score: number;
+    /** Self-reported uncertainty range. `range[0] <= score <= range[1]`. */
+    range: [number, number];
+    /** Auditor's confidence in the score. */
+    confidence: ConfidenceLevel;
+    /** One-sentence assessment grounded in observable evidence. */
+    summary: string;
+    /** Stable ids of top findings driving this score. References `DesignFinding.id`. */
+    primaryFindings: string[];
+}
+export interface RollupScore {
+    /** Weighted aggregate of `Record<Dimension, DimensionScore>`. 1-10 number, can be fractional. */
+    score: number;
+    /** Aggregate uncertainty range. */
+    range: [number, number];
+    /** Aggregate confidence. Conservative — `low` if any dim is `low`. */
+    confidence: ConfidenceLevel;
+    /** Human-readable formula, e.g. "saas-app: product*0.35 + workflow*0.30 + ...". */
+    rule: string;
+    /** Per-dimension weight that produced this rollup. Must sum to 1.0 ± 1e-6. */
+    weights: Record<Dimension, number>;
+}
+export type ClassifierSource = 'url-pattern' | 'dom-heuristic' | 'llm';
+export interface ClassifierSignal {
+    source: ClassifierSource;
+    type: PageType;
+    /** 0..1, source-specific. */
+    confidence: number;
+    /** Why this signal voted this type. Logged for debugging. */
+    rationale: string;
+}
+export interface EnsembleClassification extends PageClassification {
+    /** Every signal that voted on this classification. */
+    signals: ClassifierSignal[];
+    /** True if all signals agreed on `type`. */
+    signalsAgreed: boolean;
+    /** Aggregated 0..1 confidence after ensemble vote. */
+    ensembleConfidence: number;
+    /** Signals that disagreed with the final type, if any. */
+    dissent?: {
+        source: ClassifierSource;
+        type: PageType;
+    }[];
+    /** True if Layer 3 (first-principles) mode was triggered. */
+    firstPrinciplesMode: boolean;
+}
+/**
+ * DOM-derived signals used by the heuristic classifier. Captured once during
+ * the page-load phase, fed to the ensemble vote, and emitted into telemetry.
+ */
+export interface DomHeuristics {
+    formCount: number;
+    inputCount: number;
+    tableRowCount: number;
+    chartCount: number;
+    navItems: number;
+    hasFooterLinks: boolean;
+    hasHeroSection: boolean;
+    hasSidebar: boolean;
+    paragraphCount: number;
+    codeBlockCount: number;
+}
+/**
+ * Where a patch applies. At least one of `cssSelector | filePath | componentName`
+ * MUST be set. The combination determines how an agent applies it.
+ */
+export interface PatchTarget {
+    /** Source file path when known via component scan. */
+    filePath?: string;
+    /** Component name when known (e.g. 'Sidebar', 'PrimaryButton'). */
+    componentName?: string;
+    /** CSS selector — fallback when filePath unknown. */
+    cssSelector?: string;
+    /** Patch scope. Determines applicability check. */
+    scope: 'tsx' | 'jsx' | 'css' | 'tailwind' | 'module-css' | 'styled-component' | 'structural' | 'html';
+}
+export interface PatchDiff {
+    /**
+     * Exact substring being replaced. Validators MUST verify `before` is a
+     * substring of the page snapshot or source file at apply time. If `before`
+     * is not found, the patch is rejected (no fuzzy apply).
+     */
+    before: string;
+    /** Replacement text. */
+    after: string;
+    /**
+     * When `target.filePath` is known, the unified diff format an agent can
+     * pipe to `git apply`. Optional; `before`/`after` is the canonical form.
+     */
+    unifiedDiff?: string;
+}
+export type PatchTestKind = 'storybook' | 'a11y-rule' | 'visual-snapshot' | 'unit' | 'rerun-audit' | 'manual';
+export interface PatchTest {
+    kind: PatchTestKind;
+    /** Human-readable description of what proves the patch worked. */
+    description: string;
+    /** Optional CLI command an agent can invoke to verify (e.g. `pnpm vitest <name>`). */
+    command?: string;
+}
+export type PatchRollbackKind = 'git-revert' | 'css-disable' | 'manual';
+export interface PatchRollback {
+    kind: PatchRollbackKind;
+    /** Optional human-readable rollback instruction. */
+    instruction?: string;
+}
+/**
+ * A `Patch` is the agent-actionable unit. Layer 2 mandates ≥1 patch on every
+ * major/critical finding. Findings without patches downgrade to minor.
+ */
+export interface Patch {
+    /** Stable id derived from finding hash + target. Same patch across tenants → same id. */
+    patchId: string;
+    /** The finding this patch fixes. */
+    findingId: string;
+    /** Patch scope — page/section/component/system, drives ROI weighting. */
+    scope: 'page' | 'section' | 'component' | 'system';
+    target: PatchTarget;
+    diff: PatchDiff;
+    testThatProves: PatchTest;
+    rollback: PatchRollback;
+    /** The dimension the auditor predicts this patch will move + by how much. */
+    estimatedDelta: {
+        dim: Dimension;
+        delta: number;
+    };
+    /**
+     * Confidence in `estimatedDelta`, calibrated against fleet outcomes (Layer 4).
+     * 'untested' means no fleet data yet; 'high' means N≥30 with replication ≥0.7.
+     */
+    estimatedDeltaConfidence: ConfidenceLevel | 'untested';
+    /**
+     * If this patch matches a known fleet pattern (Layer 5), the matched pattern
+     * id. Surfaced by the auditor so agents prefer evidence-backed patches.
+     */
+    matchedPatternId?: string;
+}
+/**
+ * Updated `DesignFinding` shape — extends v1 with stable id, dimension link,
+ * mandatory patches for major/critical, optional pattern match.
+ */
+export interface DesignFinding extends DesignFindingBase {
+    /** Stable id, used by `DimensionScore.primaryFindings`. */
+    id: string;
+    /** Which dimension this finding affects. */
+    dimension: Dimension;
+    /** Agent-actionable patches. Required (≥1) when severity is major or critical. */
+    patches: Patch[];
+    /**
+     * Discriminator for finding kind. `polish` findings cap at impact 6;
+     * `job` findings can go to 10; `measurement` findings come from axe/contrast.
+     * Set this so ROI ranking auto-prioritizes job over polish.
+     */
+    kind: 'polish' | 'job' | 'measurement';
+}
+/**
+ * Triggered when ensemble confidence is low or no fixture matches the page
+ * structure. Auditor scores against 5 universal principles and emits a
+ * novel-pattern record for fleet mining.
+ */
+export interface NovelPatternObservation {
+    observationId: string;
+    capturedAt: string;
+    /** What was distinctive about this page structurally. */
+    observed: string;
+    /** Closest existing classification, with low confidence. */
+    closestType: PageType;
+    closestConfidence: number;
+    /** Page snapshot reference for later mining. */
+    snapshotKey?: string;
+    /** URL or fixture id. */
+    pageRef: string;
+}
+/**
+ * One application of a patch. Emitted by the `bad design-audit ack-patch`
+ * subcommand or auto-detected by the `--evolve` loop.
+ */
+export interface PatchApplication {
+    applicationId: string;
+    patchId: string;
+    /** `sha256(diff.before + '\n---\n' + diff.after + '\n---\n' + scope).slice(0, 16)` */
+    patchHash: string;
+    appliedAt: string;
+    appliedBy: string;
+    /** The audit run that proposed the patch. */
+    preAuditRunId: string;
+    /** The audit run after the patch was applied. May be null until re-audit. */
+    postAuditRunId?: string;
+    /** Auditor's prediction at apply time. */
+    predicted: {
+        dim: Dimension;
+        delta: number;
+    };
+    /** Measured delta after re-audit. Populated when postAuditRunId resolves. */
+    observed?: {
+        dim: Dimension;
+        delta: number;
+    };
+    /**
+     * Agreement metric: 1.0 = perfect prediction, 0 = orthogonal, negative = wrong direction.
+     * `(observed.delta * predicted.delta) / max(|observed.delta|, |predicted.delta|, 1)`
+     */
+    agreementScore?: number;
+}
+/**
+ * Aggregated reliability across all applications of a patch (joined on
+ * `patchHash = hash(diff.before, diff.after, scope)`). Surfaces in audit
+ * output as `Patch.estimatedDeltaConfidence` upgrade.
+ */
+export interface PatchReliability {
+    patchHash: string;
+    applications: number;
+    meanPredictedDelta: number;
+    meanObservedDelta: number;
+    /** % of applications where observed >= 0.5 * predicted. */
+    replicationRate: number;
+    recommendation: 'recommended' | 'neutral' | 'antipattern';
+    /** Distinct tenant count. Below 5 → 'untested' confidence. */
+    sampleTenants: number;
+}
+/**
+ * A curated known-good design pattern, mined from accumulated PatchApplication
+ * data once N≥30 across ≥5 distinct tenants with ≥0.7 replication.
+ */
+export interface Pattern {
+    patternId: string;
+    /** Free-form category name, e.g. 'leaderboard', 'empty-state', 'pricing-table'. */
+    category: string;
+    classification: {
+        type: PageType;
+        tags: string[];
+    };
+    scaffold: PatternScaffold;
+    scores: {
+        whenFollowed: Record<Dimension, number>;
+    };
+    fleetEvidence: PatternFleetEvidence;
+    /** Fixture ids that exemplify this pattern. */
+    fixtures: string[];
+}
+export interface PatternScaffold {
+    description: string;
+    referenceTsx?: string;
+    referenceCss?: string;
+    /** Concrete decisions that make the pattern work, e.g. 'criterion in header'. */
+    keyDecisions: string[];
+}
+export interface PatternFleetEvidence {
+    applications: number;
+    /** % where adopting this pattern delivered the predicted dim delta. */
+    successRate: number;
+    medianDimDelta: Record<Dimension, number>;
+    /** Distinct tenants. ≥5 required for promotion to 'recommended'. */
+    sampleTenants: number;
+}
+export interface PatternQuery {
+    category?: string;
+    pageType?: PageType;
+    /** "I'm scoring 4 on product_intent — show me patterns that lift it." */
+    weakDimension?: Dimension;
+    minApplications?: number;
+    minSuccessRate?: number;
+}
+export interface PatternMatch {
+    pattern: Pattern;
+    matchConfidence: number;
+    expectedDelta: Record<Dimension, number>;
+    /** How to adapt this pattern to the current page. */
+    applicationGuidance: string;
+}
+export type AudienceTag = 'developer' | 'clinician' | 'analyst' | 'consumer' | 'admin' | 'kids' | 'enterprise-buyer' | 'creator';
+export type ModalityTag = 'desktop' | 'tablet' | 'mobile' | 'tv' | 'kiosk';
+export type RegulatoryContextTag = 'hipaa' | 'gdpr' | 'sox' | 'pci-dss' | 'coppa' | 'wcag-aaa';
+export type AudienceVulnerabilityTag = 'patient-facing' | 'minor-facing' | 'high-stakes-financial' | 'crisis-context';
+/**
+ * Predicate set composed by the rubric loader. Extends the base predicate
+ * with audience/modality/regulatoryContext/audienceVulnerability so a
+ * pediatric medical app on tablet for clinicians loads multiple fragments
+ * simultaneously.
+ */
+export interface AppliesWhen extends BaseAppliesWhen {
+    audience?: AudienceTag[];
+    modality?: ModalityTag[];
+    regulatoryContext?: RegulatoryContextTag[];
+    audienceVulnerability?: AudienceVulnerabilityTag[];
+}
+export type EthicsCategory = 'medical' | 'kids' | 'finance' | 'legal' | 'accessibility' | 'crisis';
+export type EthicsSeverity = 'critical-floor' | 'major-floor';
+export interface EthicsRule {
+    ruleId: string;
+    category: EthicsCategory;
+    severity: EthicsSeverity;
+    appliesWhen: AppliesWhen;
+    detector: EthicsDetector;
+    remediation: string;
+    /** Citation to regulation or standard, e.g. 'FDA 21 CFR 201.57'. */
+    citation?: string;
+}
+export type EthicsDetector = {
+    kind: 'pattern-absent';
+    pattern: string;
+} | {
+    kind: 'pattern-present';
+    pattern: string;
+} | {
+    kind: 'llm-classifier';
+    llmCheck: string;
+};
+export interface EthicsViolation {
+    ruleId: string;
+    detected: true;
+    severity: EthicsSeverity;
+    /** Rollup ceiling enforced by this violation. critical-floor → 4; major-floor → 6. */
+    rollupCap: number;
+    remediation: string;
+    citation?: string;
+}
+export type Modality = 'html' | 'ios' | 'android' | 'terminal' | 'voice';
+export interface ModalityInput {
+    /** Modality-specific entry point — URL for HTML, app bundle for iOS, etc. */
+    entryPoint: string;
+    /** Optional flow specification when capturing multiple surfaces. */
+    flow?: string[];
+}
+/**
+ * Per-modality measurement bundle — analogous to the existing HTML
+ * MeasurementBundle (axe + contrast). Modality-specific implementations
+ * provide their own a11y/contrast equivalents.
+ */
+export interface SurfaceMeasurements {
+    modality: Modality;
+    /** A11y violations — modality-specific shape. */
+    a11y?: unknown;
+    /** Contrast or readability check — modality-specific. */
+    contrast?: unknown;
+    /** Modality-specific measurements (haptic, latency, etc.). */
+    extra?: Record<string, unknown>;
+}
+export interface SurfaceRecord {
+    /** URL for HTML; screen name for native; turn id for voice. */
+    identifier: string;
+    measurements: SurfaceMeasurements;
+    snapshot: string;
+    screenshot?: string;
+}
+export interface Evidence {
+    modality: Modality;
+    surfaces: SurfaceRecord[];
+    /** Roll-up of per-surface measurements for backwards compat with v1 pipeline. */
+    measurements: MeasurementBundle;
+    /** Concatenated snapshot for LLM consumption. */
+    snapshot: string;
+    screenshot?: string;
+}
+export interface ModalityAdapter {
+    modality: Modality;
+    capture(input: ModalityInput): Promise<Evidence>;
+}
+export interface AuditResult {
+    /** Run id for telemetry / attribution correlation. */
+    runId: string;
+    /** Page reference (URL for HTML; bundle id for native; etc.). */
+    pageRef: string;
+    classification: EnsembleClassification;
+    /** Per-dimension scores, ALWAYS all 5 dimensions. */
+    scores: Record<Dimension, DimensionScore>;
+    rollup: RollupScore;
+    /** Findings + patches. Includes deterministic measurements (axe, contrast). */
+    findings: DesignFinding[];
+    /** Top-N findings ranked by ROI. References `findings[*].id`. */
+    topFixes: string[];
+    measurements: MeasurementBundle;
+    ethicsViolations: EthicsViolation[];
+    /** Patterns matched against the page (Layer 5). May be empty. */
+    matchedPatterns: PatternMatch[];
+    /** When first-principles mode triggered (Layer 3). May be undefined. */
+    novelPattern?: NovelPatternObservation;
+    /** Modality (Layer 8). HTML for v1 compat. */
+    modality: Modality;
+    /** Provenance. */
+    evaluatedAt: string;
+    promptHash: string;
+    rubricHash: string;
+    /** LLM token usage across passes. */
+    tokensUsed?: number;
+    /** Ensemble of audit passes that ran (deep / max / single). */
+    passes: string[];
+    error?: string;
+}
+/**
+ * Operator-supplied hints. None override the classifier outright; they bias
+ * the ensemble toward a result. If a hint disagrees with the classifier's
+ * final type with high confidence, a warning surfaces.
+ */
+export interface AuditRuntimeHints {
+    rubricHint?: PageType;
+    audience?: AudienceTag[];
+    modality?: ModalityTag[];
+    regulatoryContext?: RegulatoryContextTag[];
+    /** Tenant id for cross-tenant attribution + ethics rule overrides. */
+    tenantId?: string;
+}
+//# sourceMappingURL=score-types.d.ts.map

package/dist/design/audit/score-types.d.ts.map

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

package/dist/design/audit/score-types.js

@@ -0,0 +1,26 @@
+/**
+ * design audit — type contract for the 8-layer architecture.
+ *
+ * RFC: docs/rfc/design-audit-world-class.md
+ *
+ * This file is the stable contract that every layer's implementation
+ * builds against. It exists to let parallel implementation work proceed
+ * without diverging interfaces. Editing this file mid-build is a coordinated
+ * change; layers must update in lockstep.
+ *
+ * Invariants enforced by this contract:
+ *   - Every score is a `DimensionScore` with `range` + `confidence`. No bare numbers.
+ *   - Every finding with `severity in ['major','critical']` MUST have ≥1 `Patch`.
+ *   - Every patch has both `target` (what changes) and `testThatProves` (how we verify).
+ *   - Every classification carries explicit `ensembleConfidence` and `signalsAgreed`.
+ *   - Every audit run can write a `PatchApplication` event for post-hoc attribution.
+ *   - Pattern, ethics, modality types compose cleanly via shared `AppliesWhen`.
+ */
+export const DIMENSIONS = [
+    'product_intent',
+    'visual_craft',
+    'trust_clarity',
+    'workflow',
+    'content_ia',
+];
+//# sourceMappingURL=score-types.js.map

package/dist/design/audit/score-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-types.js","sourceRoot":"","sources":["../../../src/design/audit/score-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,UAAU;IACV,YAAY;CACJ,CAAA"}

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

@@ -0,0 +1,49 @@
+/**
+ * Multi-dimensional scoring — prompt builder, parser, and rollup.
+ *
+ * Pure functions. No I/O, no Brain dependency. The pipeline supplies the
+ * inputs (classification, rubric, anchor, measurements) and persists the
+ * resulting `Record<Dimension, DimensionScore> + RollupScore`.
+ */
+import { type Dimension, type DimensionScore, type RollupScore } from './score-types.js';
+import type { PageType } from './types.js';
+import type { CalibrationAnchor } from './rubric/anchor-loader.js';
+export interface BuildPromptInput {
+    pageType: PageType;
+    rubricBody: string;
+    anchor?: CalibrationAnchor;
+    /** Concise text summary of deterministic measurements (axe, contrast). */
+    measurementSummary: string;
+    /** Optional auditor framing override. */
+    systemOpener?: string;
+    /** Page intent line surfaced from classification. */
+    intent?: string;
+}
+/**
+ * Build the evaluation prompt. Demands per-dim DimensionScore output with
+ * range + confidence. Does NOT request the rollup — the rollup is computed
+ * deterministically from the per-dim scores using rollup-weights.
+ */
+export declare function buildEvalPrompt(input: BuildPromptInput): string;
+export interface ParsedDimensionScores {
+    scores: Record<Dimension, DimensionScore>;
+    summary: string;
+    strengths: string[];
+}
+/**
+ * Parse the LLM response. Throws when scores are missing, ranges violate
+ * `range[0] <= score <= range[1]`, or score is outside 1..10. The pipeline
+ * catches the throw and falls back to v1 mean-of-passes.
+ */
+export declare function parseAuditResponse(raw: string): ParsedDimensionScores;
+/**
+ * Compute the rollup from per-dimension scores using per-page-type weights.
+ * Conservative confidence rule: rollup confidence = lowest dim confidence.
+ */
+export declare function computeRollup(scores: Record<Dimension, DimensionScore>, pageType: PageType): RollupScore;
+/**
+ * Aggregate per-dim scores from N independent passes (mean). Used when the
+ * audit runs deep mode and we want one DimensionScore per dimension.
+ */
+export declare function mergeDimensionScoresAcrossPasses(perPass: Array<Record<Dimension, DimensionScore>>): Record<Dimension, DimensionScore>;
+//# sourceMappingURL=score.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../src/design/audit/score.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAKlE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA6C/D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA4BrE;AAoCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAgCxG;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,GAChD,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CA6BnC"}