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

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

@@ -5,7 +5,9 @@
  * Each stage is a pure transformation; the orchestrator (`pipeline.ts`) wires them.
  */
 import type { DesignFinding, DesignSystemScore } from '../../types.js';
+import type { EthicsViolation } from './v2/types.js';
 export type { DesignFinding, DesignSystemScore } from '../../types.js';
+export type { EthicsViolation } from './v2/types.js';
 /**
  * Page classification — produced by a single cheap LLM call before any scoring.
  * Drives rubric composition and measurement strategy.
@@ -161,6 +163,32 @@ export interface PageAuditResult {
     designSystemScore?: DesignSystemScore;
     screenshotPath?: string;
     tokensUsed?: number;
+    /**
+     * Layer 7 — domain ethics violations. When non-empty, `score` is capped by
+     * the lowest `rollupCap` across violations until the underlying issue is
+     * remediated. Empty when --skip-ethics is set or when no rule fires.
+     */
+    ethicsViolations?: EthicsViolation[];
+    /**
+     * The pre-cap score (Layer 7). Set when `ethicsViolations` is non-empty so
+     * tooling can show "would have scored X, capped at Y" without losing
+     * the LLM's original assessment.
+     */
+    preEthicsScore?: number;
+    /**
+     * Layer 1 — v2 multi-dim audit result. Emitted alongside the v1 fields for
+     * one release as a backwards-compat bridge. Consumers should migrate to
+     * `auditResultV2` and treat the v1 surface as deprecated.
+     *
+     * Typed as `unknown` here to avoid pulling v2/types.ts into v1 consumers.
+     * The concrete shape is `import('./v2/types.js').AuditResult_v2`.
+     */
+    auditResultV2?: unknown;
+    /**
+     * Layer 1 — ensemble classification (URL + DOM + LLM). When set, the
+     * pipeline used `--audit-passes auto` (the new default).
+     */
+    ensembleClassification?: unknown;
     error?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/design/audit/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/design/audit/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+CAA+C;IAC/C,YAAY,EAAE,eAAe,CAAA;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,QAAQ,CAAA;IAClB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAA;IACd,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,UAAU,GACV,WAAW,GACX,MAAM,GACN,WAAW,GACX,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,SAAS,CAAA;AAEb,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,QAAQ,GACR,iBAAiB,GACjB,cAAc,GACd,UAAU,GACV,SAAS,CAAA;AAEb,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,KAAK,GACL,SAAS,GACT,UAAU,GACV,aAAa,CAAA;AAIjB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAA;IACxB,yCAAyC;IACzC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IAC9C,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAID;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,cAAc,CAAA;IACxB,IAAI,EAAE,UAAU,CAAA;IAChB,qFAAqF;IACrF,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,yEAAyE;IACzE,WAAW,EAAE,eAAe,EAAE,CAAA;IAC9B,kBAAkB;IAClB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,GAAG,EAAE,OAAO,CAAA;IACZ,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,UAAU,EAAE,aAAa,EAAE,CAAA;IAC3B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,uBAAuB;IACvB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;IACrD,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;QACX,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,cAAc,EAAE,MAAM,CAAA;KACvB,CAAC,CAAA;IACF,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAID;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IACpC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/design/audit/v2/build-result.d.ts

@@ -0,0 +1,47 @@
+/**
+ * v2 AuditResult builder.
+ *
+ * Wraps the existing v1 PageAuditResult with multi-dim scoring + ensemble
+ * classification + rollup. Layer 1 emits BOTH schemas in `report.json` so
+ * downstream consumers can migrate at their own pace (one-release deprecation
+ * window per the RFC).
+ */
+import type { Brain } from '../../../brain/index.js';
+import type { PageState } from '../../../types.js';
+import type { PageAuditResult, ComposedRubric, MeasurementBundle } from '../types.js';
+import { type AuditResult_v2, type DesignFinding, type Dimension, type DimensionScore, type EnsembleClassification } from './types.js';
+import { renderAnchor, type CalibrationAnchor } from '../rubric/anchor-loader.js';
+export interface BuildV2ResultInput {
+    brain: Brain;
+    state: PageState;
+    pageRef: string;
+    ensemble: EnsembleClassification;
+    rubric: ComposedRubric;
+    measurements: MeasurementBundle;
+    v1Result: PageAuditResult;
+    anchor?: CalibrationAnchor;
+    /** Reuse the pipeline runId so envelopes correlate. */
+    runId?: string;
+    /** Optional override (e.g. test fixtures). When set, skip the LLM call. */
+    precomputedScores?: Record<Dimension, DimensionScore>;
+}
+/**
+ * Produce a complete `AuditResult_v2`. When `precomputedScores` is set we
+ * skip the v2 LLM call entirely (used by deterministic tests + the
+ * `--audit-passes auto` legacy fallback path).
+ */
+export declare function buildAuditResultV2(input: BuildV2ResultInput): Promise<AuditResult_v2>;
+declare function renderMeasurementSummary(measurements: MeasurementBundle): string;
+declare function adaptFindings(v1Findings: PageAuditResult['findings']): DesignFinding[];
+declare function mapCategoryToDimension(category: string): Dimension;
+declare function computeTopFixes(findings: DesignFinding[]): DesignFinding[];
+declare function synthesizeScoresFromV1(v1: PageAuditResult): Record<Dimension, DimensionScore>;
+export declare const V2_INTERNALS: {
+    renderMeasurementSummary: typeof renderMeasurementSummary;
+    adaptFindings: typeof adaptFindings;
+    mapCategoryToDimension: typeof mapCategoryToDimension;
+    computeTopFixes: typeof computeTopFixes;
+    synthesizeScoresFromV1: typeof synthesizeScoresFromV1;
+};
+export { renderAnchor };
+//# sourceMappingURL=build-result.d.ts.map

package/dist/design/audit/v2/build-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-result.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/v2/build-result.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EACd,iBAAiB,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAG5B,MAAM,YAAY,CAAA;AAMnB,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEjF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,sBAAsB,CAAA;IAChC,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,iBAAiB,CAAA;IAC/B,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;CACtD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyD3F;AAED,iBAAS,wBAAwB,CAAC,YAAY,EAAE,iBAAiB,GAAG,MAAM,CAOzE;AAED,iBAAS,aAAa,CAAC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,aAAa,EAAE,CAe/E;AAED,iBAAS,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAe3D;AAQD,iBAAS,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAMnE;AAWD,iBAAS,sBAAsB,CAAC,EAAE,EAAE,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAgBtF;AAMD,eAAO,MAAM,YAAY;;;;;;CAMxB,CAAA;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/design/audit/v2/build-result.js

@@ -0,0 +1,163 @@
+/**
+ * v2 AuditResult builder.
+ *
+ * Wraps the existing v1 PageAuditResult with multi-dim scoring + ensemble
+ * classification + rollup. Layer 1 emits BOTH schemas in `report.json` so
+ * downstream consumers can migrate at their own pace (one-release deprecation
+ * window per the RFC).
+ */
+import { randomUUID, createHash } from 'node:crypto';
+import { DIMENSIONS, } from './types.js';
+import { buildEvalPromptV2, computeRollup, parseAuditResponseV2, } from './score.js';
+import { renderAnchor } from '../rubric/anchor-loader.js';
+/**
+ * Produce a complete `AuditResult_v2`. When `precomputedScores` is set we
+ * skip the v2 LLM call entirely (used by deterministic tests + the
+ * `--audit-passes auto` legacy fallback path).
+ */
+export async function buildAuditResultV2(input) {
+    const { brain, state, pageRef, ensemble, rubric, measurements, v1Result, anchor, runId } = input;
+    const measurementSummary = renderMeasurementSummary(measurements);
+    const prompt = buildEvalPromptV2({
+        pageType: ensemble.type,
+        rubricBody: rubric.body,
+        anchor,
+        measurementSummary,
+        intent: ensemble.intent,
+    });
+    let scores;
+    let llmTokens = 0;
+    if (input.precomputedScores) {
+        scores = input.precomputedScores;
+    }
+    else {
+        try {
+            const llm = await brain.auditDesign(state, 'Multi-dimensional audit (v2)', [], prompt);
+            llmTokens = llm.tokensUsed ?? 0;
+            const parsed = parseAuditResponseV2(llm.raw);
+            scores = parsed.scores;
+        }
+        catch {
+            // Fall back: synthesize per-dim scores from the v1 result. Conservative —
+            // every dim gets the v1 score, range +/- 1, confidence 'low'.
+            scores = synthesizeScoresFromV1(v1Result);
+        }
+    }
+    const rollup = computeRollup(scores, ensemble.type);
+    const findings = adaptFindings(v1Result.findings);
+    const topFixes = computeTopFixes(findings).slice(0, 5).map((f) => f.id);
+    const promptHash = sha1(prompt);
+    const rubricHash = sha1(rubric.body);
+    const totalTokens = (v1Result.tokensUsed ?? 0) + llmTokens;
+    return {
+        schemaVersion: 2,
+        runId: runId ?? randomUUID(),
+        pageRef,
+        classification: ensemble,
+        scores,
+        rollup,
+        findings,
+        topFixes,
+        measurements,
+        ethicsViolations: [],
+        matchedPatterns: [],
+        modality: 'html',
+        evaluatedAt: new Date().toISOString(),
+        promptHash,
+        rubricHash,
+        tokensUsed: totalTokens > 0 ? totalTokens : undefined,
+        passes: ['v2-multidim'],
+        ...(v1Result.error ? { error: v1Result.error } : {}),
+    };
+}
+function renderMeasurementSummary(measurements) {
+    const aaFails = measurements.contrast.aaFailures.length;
+    const a11y = measurements.a11y.violations.length;
+    return [
+        `contrast AA failures: ${aaFails} of ${measurements.contrast.totalChecked} text elements`,
+        `axe violations: ${a11y}${a11y > 0 ? ` (top: ${measurements.a11y.violations.slice(0, 3).map((v) => `${v.id}/${v.impact}`).join(', ')})` : ''}`,
+    ].join('\n');
+}
+function adaptFindings(v1Findings) {
+    return v1Findings.map((f, idx) => {
+        const id = `finding-${idx + 1}-${sha1(`${f.category}|${f.description}`).slice(0, 8)}`;
+        const dimension = mapCategoryToDimension(f.category);
+        const kind = inferKind(f);
+        return {
+            ...f,
+            id,
+            dimension,
+            kind,
+            // Layer 2 supplies real Patches; Layer 1 emits an empty array so the
+            // schema is satisfied without fabricating diffs.
+            patches: [],
+        };
+    });
+}
+function mapCategoryToDimension(category) {
+    switch (category) {
+        case 'visual-bug':
+        case 'spacing':
+        case 'typography':
+        case 'alignment':
+        case 'layout':
+            return 'visual_craft';
+        case 'contrast':
+        case 'accessibility':
+            return 'visual_craft';
+        case 'ux':
+        default:
+            return 'product_intent';
+    }
+}
+function inferKind(f) {
+    if (f.category === 'contrast' || f.category === 'accessibility')
+        return 'measurement';
+    if (f.category === 'ux')
+        return 'job';
+    return 'polish';
+}
+function computeTopFixes(findings) {
+    return [...findings].sort((a, b) => {
+        const aScore = (a.impact ?? 0) * blastWeight(a.blast);
+        const bScore = (b.impact ?? 0) * blastWeight(b.blast);
+        return bScore - aScore;
+    });
+}
+function blastWeight(blast) {
+    switch (blast) {
+        case 'system': return 4;
+        case 'component': return 3;
+        case 'section': return 2;
+        default: return 1;
+    }
+}
+function synthesizeScoresFromV1(v1) {
+    const fallback = Math.max(1, Math.min(10, Math.round(v1.score)));
+    const out = {};
+    for (const dim of DIMENSIONS) {
+        out[dim] = {
+            score: fallback,
+            range: [
+                Math.max(1, fallback - 1),
+                Math.min(10, fallback + 1),
+            ],
+            confidence: 'low',
+            summary: 'Synthesized from v1 score (v2 LLM call unavailable).',
+            primaryFindings: [],
+        };
+    }
+    return out;
+}
+function sha1(s) {
+    return createHash('sha1').update(s).digest('hex');
+}
+export const V2_INTERNALS = {
+    renderMeasurementSummary,
+    adaptFindings,
+    mapCategoryToDimension,
+    computeTopFixes,
+    synthesizeScoresFromV1,
+};
+export { renderAnchor };
+//# sourceMappingURL=build-result.js.map

package/dist/design/audit/v2/build-result.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * Layer 1 multi-dim 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 './types.js';
+import type { PageType } from '../types.js';
+import type { CalibrationAnchor } from '../rubric/anchor-loader.js';
+export interface BuildV2PromptInput {
+    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 v2 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 buildEvalPromptV2(input: BuildV2PromptInput): string;
+export interface ParsedDimensionScores {
+    scores: Record<Dimension, DimensionScore>;
+    summary: string;
+    strengths: string[];
+}
+/**
+ * Parse the v2 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 parseAuditResponseV2(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/v2/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/v2/score.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAKnE,MAAM,WAAW,kBAAkB;IACjC,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,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6CnE;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,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA4BvE;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"}

package/dist/design/audit/v2/score.js

@@ -0,0 +1,211 @@
+/**
+ * Layer 1 multi-dim 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 { DIMENSIONS, } from './types.js';
+import { rollupFormula, rollupWeightsFor } from '../rubric/rollup-weights.js';
+import { renderAnchor } from '../rubric/anchor-loader.js';
+const VALID_CONFIDENCE = ['high', 'medium', 'low'];
+const DEFAULT_OPENER = 'You are a principal product-design auditor. Score this page on five universal dimensions independently, with explicit ranges and confidence. The downstream system aggregates these into a page-type-aware rollup.';
+/**
+ * Build the v2 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 function buildEvalPromptV2(input) {
+    const opener = input.systemOpener ?? DEFAULT_OPENER;
+    const anchorBlock = input.anchor ? renderAnchor(input.anchor) : '';
+    const intentLine = input.intent ? `\nPAGE INTENT (from classifier): ${input.intent}` : '';
+    return `${opener}
+
+You are auditing a page that has been pre-classified as type=${input.pageType}. Contrast and accessibility measurements have already been counted deterministically — do NOT re-evaluate them. They will be merged with your output.${intentLine}
+
+DIMENSIONS — score each one 1-10 (integer) with an explicit uncertainty range and confidence:
+
+  product_intent  — Does the page make its audience, purpose, primary action, and product state obvious within 5 seconds? Empty/loading/error states designed?
+  visual_craft    — Is the visual system intentional? Typography ramp, spacing rhythm, color tokens, component coherence, polish details. Decorative-but-shallow output is a defect.
+  trust_clarity   — Are commitments (money, identity, deploy, share, irreversible actions) accompanied by the right trust details (price, fees, permissions, undo path, provenance)?
+  workflow        — Can a user complete the end-to-end job? State transitions, recovery from failure, action hierarchy match the operational verbs of the system.
+  content_ia      — Is the copy plain and useful? Are labels and IA tuned to the audience's tasks? Meta-copy that explains the UI is a defect.
+
+DETERMINISTIC MEASUREMENTS (do not duplicate):
+${input.measurementSummary}
+
+${anchorBlock ? anchorBlock + '\n\n' : ''}EVALUATION RUBRIC:
+${input.rubricBody}
+
+OUTPUT REQUIREMENTS:
+- Every dimension MUST have an integer score 1-10.
+- Every dimension MUST have a range [low, high] with low <= score <= high. Range width encodes your uncertainty.
+- Every dimension MUST have confidence in {"high","medium","low"}.
+- Summary is one sentence grounded in observable evidence.
+- primaryFindings is a list of finding ids that drive the score (may be empty if you produce no findings).
+
+RESPOND WITH ONLY a JSON object:
+{
+  "scores": {
+    "product_intent": { "score": 6, "range": [5, 7], "confidence": "medium", "summary": "Hero is clear but action hierarchy is diffuse.", "primaryFindings": [] },
+    "visual_craft":   { "score": 7, "range": [6, 8], "confidence": "high",   "summary": "Spacing rhythm is intentional but type ramp drifts in cards.", "primaryFindings": [] },
+    "trust_clarity":  { "score": 5, "range": [4, 6], "confidence": "medium", "summary": "Fees disclosed but only at the final step.", "primaryFindings": [] },
+    "workflow":       { "score": 6, "range": [5, 7], "confidence": "medium", "summary": "Empty state directs the user but error recovery is implicit.", "primaryFindings": [] },
+    "content_ia":     { "score": 7, "range": [6, 8], "confidence": "high",   "summary": "Copy is plain and audience-tuned.", "primaryFindings": [] }
+  },
+  "summary": "One-sentence overall assessment.",
+  "strengths": ["..."],
+  "findings": []
+}
+
+Score 1-10. Most production apps score 5-7. Only world-class deserves 8+. Be honest.`;
+}
+/**
+ * Parse the v2 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 function parseAuditResponseV2(raw) {
+    const parsed = extractJsonObject(raw);
+    if (!parsed)
+        throw new Error('v2 parser: no JSON object in response');
+    const rawScores = parsed.scores;
+    if (!rawScores || typeof rawScores !== 'object') {
+        throw new Error('v2 parser: missing scores object');
+    }
+    const scoreMap = rawScores;
+    const out = {};
+    for (const dim of DIMENSIONS) {
+        const dimRaw = scoreMap[dim];
+        if (!dimRaw || typeof dimRaw !== 'object') {
+            throw new Error(`v2 parser: dimension ${dim} missing`);
+        }
+        out[dim] = parseDimensionScore(dim, dimRaw);
+    }
+    return {
+        scores: out,
+        summary: typeof parsed.summary === 'string' ? parsed.summary : '',
+        strengths: Array.isArray(parsed.strengths)
+            ? (parsed.strengths.filter((s) => typeof s === 'string'))
+            : [],
+    };
+}
+function parseDimensionScore(dim, raw) {
+    const score = raw.score;
+    if (typeof score !== 'number' || !Number.isFinite(score)) {
+        throw new Error(`v2 parser: ${dim}.score must be a number`);
+    }
+    const integerScore = Math.round(score);
+    if (integerScore < 1 || integerScore > 10) {
+        throw new Error(`v2 parser: ${dim}.score=${integerScore} outside 1..10`);
+    }
+    const range = raw.range;
+    if (!Array.isArray(range) || range.length !== 2 || typeof range[0] !== 'number' || typeof range[1] !== 'number') {
+        throw new Error(`v2 parser: ${dim}.range must be [number, number]`);
+    }
+    const [low, high] = range;
+    if (low > high) {
+        throw new Error(`v2 parser: ${dim}.range=[${low},${high}] inverted`);
+    }
+    if (integerScore < low || integerScore > high) {
+        throw new Error(`v2 parser: ${dim}.score=${integerScore} outside range [${low},${high}]`);
+    }
+    if (low < 1 || high > 10) {
+        throw new Error(`v2 parser: ${dim}.range=[${low},${high}] outside 1..10`);
+    }
+    const confidenceRaw = String(raw.confidence ?? '').toLowerCase();
+    const confidence = VALID_CONFIDENCE.includes(confidenceRaw)
+        ? confidenceRaw
+        : 'medium';
+    const summary = typeof raw.summary === 'string' ? raw.summary : '';
+    const primaryFindings = Array.isArray(raw.primaryFindings)
+        ? raw.primaryFindings.filter((s) => typeof s === 'string')
+        : [];
+    return { score: integerScore, range: [low, high], confidence, summary, primaryFindings };
+}
+/**
+ * Compute the rollup from per-dimension scores using per-page-type weights.
+ * Conservative confidence rule: rollup confidence = lowest dim confidence.
+ */
+export function computeRollup(scores, pageType) {
+    const weights = rollupWeightsFor(pageType);
+    let weighted = 0;
+    let lowSum = 0;
+    let highSum = 0;
+    for (const dim of DIMENSIONS) {
+        const dimScore = scores[dim];
+        const w = weights[dim];
+        weighted += dimScore.score * w;
+        lowSum += dimScore.range[0] * w;
+        highSum += dimScore.range[1] * w;
+    }
+    const score = Math.round(weighted * 10) / 10;
+    const range = [
+        Math.round(lowSum * 10) / 10,
+        Math.round(highSum * 10) / 10,
+    ];
+    const confidences = DIMENSIONS.map((d) => scores[d].confidence);
+    const confidence = confidences.includes('low')
+        ? 'low'
+        : confidences.includes('medium')
+            ? 'medium'
+            : 'high';
+    return {
+        score,
+        range,
+        confidence,
+        rule: rollupFormula(pageType, weights),
+        weights,
+    };
+}
+/**
+ * Aggregate per-dim scores from N independent passes (mean). Used when the
+ * audit runs deep mode and we want one DimensionScore per dimension.
+ */
+export function mergeDimensionScoresAcrossPasses(perPass) {
+    if (perPass.length === 0) {
+        throw new Error('mergeDimensionScoresAcrossPasses: empty input');
+    }
+    if (perPass.length === 1)
+        return perPass[0];
+    const out = {};
+    for (const dim of DIMENSIONS) {
+        const samples = perPass.map((p) => p[dim]);
+        const meanScore = samples.reduce((a, s) => a + s.score, 0) / samples.length;
+        const meanLow = samples.reduce((a, s) => a + s.range[0], 0) / samples.length;
+        const meanHigh = samples.reduce((a, s) => a + s.range[1], 0) / samples.length;
+        const conf = samples.map((s) => s.confidence);
+        const confidence = conf.includes('low') ? 'low' : conf.includes('medium') ? 'medium' : 'high';
+        const allFindings = samples.flatMap((s) => s.primaryFindings);
+        const primaryFindings = Array.from(new Set(allFindings)).slice(0, 3);
+        const summary = samples.find((s) => s.summary)?.summary ?? '';
+        out[dim] = {
+            score: Math.round(meanScore),
+            range: [
+                Math.max(1, Math.floor(meanLow)),
+                Math.min(10, Math.ceil(meanHigh)),
+            ],
+            confidence,
+            summary,
+            primaryFindings,
+        };
+    }
+    return out;
+}
+function extractJsonObject(raw) {
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const start = text.indexOf('{');
+        const end = text.lastIndexOf('}');
+        if (start < 0 || end <= start)
+            return null;
+        return JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=score.js.map

package/dist/design/audit/v2/score.js.map

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