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

package/dist/design/audit/score.js

@@ -0,0 +1,211 @@
+/**
+ * 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 { DIMENSIONS, } from './score-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 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 buildEvalPrompt(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 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 parseAuditResponse(raw) {
+    const parsed = extractJsonObject(raw);
+    if (!parsed)
+        throw new Error('parser: no JSON object in response');
+    const rawScores = parsed.scores;
+    if (!rawScores || typeof rawScores !== 'object') {
+        throw new Error('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(`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(`parser: ${dim}.score must be a number`);
+    }
+    const integerScore = Math.round(score);
+    if (integerScore < 1 || integerScore > 10) {
+        throw new Error(`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(`parser: ${dim}.range must be [number, number]`);
+    }
+    const [low, high] = range;
+    if (low > high) {
+        throw new Error(`parser: ${dim}.range=[${low},${high}] inverted`);
+    }
+    if (integerScore < low || integerScore > high) {
+        throw new Error(`parser: ${dim}.score=${integerScore} outside range [${low},${high}]`);
+    }
+    if (low < 1 || high > 10) {
+        throw new Error(`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/score.js.map

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

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 './score-types.js';
 export type { DesignFinding, DesignSystemScore } from '../../types.js';
+export type { EthicsViolation } from './score-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 — multi-dim audit result. Emitted alongside the v1 fields for
+     * one release as a backwards-compat bridge. Consumers should migrate to
+     * `auditResult` and treat the v1 surface as deprecated.
+     *
+     * Typed as `unknown` here to avoid pulling score-types.ts into v1 consumers.
+     * The concrete shape is `import('./score-types.js').AuditResult`.
+     */
+    auditResult?: 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":"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"}

package/dist/discover/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Discoverers — turn a job's `discover` spec into a flat list of audit targets.
+ *
+ * Two sources:
+ *   list     — explicit URLs (passthrough).
+ *   wayback  — expand each URL into N historical snapshots via the CDX API.
+ */
+import type { DiscoverSpec, JobTarget } from '../jobs/types.js';
+export { discoverWaybackSnapshots, expandWaybackTargets, snapshotUrl, sampleEvenly, parseCdxRows, cdxStampToIso } from './wayback.js';
+export type { WaybackOptions } from './wayback.js';
+export interface DiscoverOptions {
+    /** Injected fetch (tests). */
+    fetch?: typeof fetch;
+}
+export declare function discoverTargets(spec: DiscoverSpec, opts?: DiscoverOptions): Promise<JobTarget[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/discover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discover/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG/D,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACrI,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAc1G"}

package/dist/discover/index.js

@@ -0,0 +1,25 @@
+/**
+ * Discoverers — turn a job's `discover` spec into a flat list of audit targets.
+ *
+ * Two sources:
+ *   list     — explicit URLs (passthrough).
+ *   wayback  — expand each URL into N historical snapshots via the CDX API.
+ */
+import { expandWaybackTargets } from './wayback.js';
+export { discoverWaybackSnapshots, expandWaybackTargets, snapshotUrl, sampleEvenly, parseCdxRows, cdxStampToIso } from './wayback.js';
+export async function discoverTargets(spec, opts = {}) {
+    if (spec.source === 'list') {
+        return spec.urls.map(url => ({ url }));
+    }
+    if (spec.source === 'wayback') {
+        const wb = {
+            count: spec.snapshotsPerUrl,
+            since: spec.since,
+            until: spec.until,
+            fetch: opts.fetch,
+        };
+        return expandWaybackTargets(spec.urls, wb);
+    }
+    throw new Error(`discover: unsupported source "${spec.source}"`);
+}
+//# sourceMappingURL=index.js.map

package/dist/discover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discover/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,oBAAoB,EAAuB,MAAM,cAAc,CAAA;AAExE,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAQrI,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAkB,EAAE,OAAwB,EAAE;IAClF,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAmB;YACzB,KAAK,EAAE,IAAI,CAAC,eAAe;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAA;QACD,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC5C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iCAAkC,IAAqB,CAAC,MAAM,GAAG,CAAC,CAAA;AACpF,CAAC"}

package/dist/discover/wayback.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Wayback Machine snapshot discoverer (CDX API).
+ *
+ * Uses archive.org's CDX server to list captures of a URL, then samples
+ * `count` snapshots evenly across the time range. The CDX API is rate-limited
+ * (~15 req/s) but for the small N we use here we never approach the cap.
+ *
+ * CDX response shape:
+ *   [["urlkey","timestamp","original","mimetype","statuscode","digest","length"],
+ *    ["com,stripe)/", "20100101120000", "https://stripe.com/", "text/html", "200", "...", "1234"],
+ *    ...]
+ *
+ * Snapshot URL = `https://web.archive.org/web/<timestamp>/<original>`.
+ */
+import type { JobTarget } from '../jobs/types.js';
+export interface WaybackOptions {
+    /** Snapshots per URL. Default 5. */
+    count?: number;
+    /** Lower-bound capture date (ISO 8601 — e.g. "2010-01-01"). */
+    since?: string;
+    /** Upper-bound capture date. */
+    until?: string;
+    /** Limit only HTTP 200 captures. Default true — 4xx/5xx snapshots aren't auditable. */
+    status200Only?: boolean;
+    /** Injected fetch (tests). Defaults to globalThis.fetch (Node 18+). */
+    fetch?: typeof fetch;
+}
+interface CdxRow {
+    urlkey: string;
+    timestamp: string;
+    original: string;
+    mimetype: string;
+    statuscode: string;
+    digest: string;
+    length: string;
+}
+/** Convert CDX timestamp "20100101120000" to ISO datetime. */
+export declare function cdxStampToIso(stamp: string): string;
+export declare function snapshotUrl(timestamp: string, original: string): string;
+/** Sample `count` evenly-spaced rows from a sorted list. Always includes first and last. */
+export declare function sampleEvenly<T>(rows: T[], count: number): T[];
+/** Parse the CDX JSON response (first row is a header). */
+export declare function parseCdxRows(json: unknown): CdxRow[];
+/** Discover N evenly-spaced wayback snapshots for a URL. */
+export declare function discoverWaybackSnapshots(url: string, opts?: WaybackOptions): Promise<JobTarget[]>;
+/** Expand a list of seed URLs into wayback targets, in parallel. */
+export declare function expandWaybackTargets(urls: string[], opts?: WaybackOptions): Promise<JobTarget[]>;
+export {};
+//# sourceMappingURL=wayback.d.ts.map

package/dist/discover/wayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayback.d.ts","sourceRoot":"","sources":["../../src/discover/wayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAIjD,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uFAAuF;IACvF,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,UAAU,MAAM;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAcD,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAU7D;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAkBpD;AAED,4DAA4D;AAC5D,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmC3G;AAED,oEAAoE;AACpE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAG1G"}

package/dist/discover/wayback.js

@@ -0,0 +1,123 @@
+/**
+ * Wayback Machine snapshot discoverer (CDX API).
+ *
+ * Uses archive.org's CDX server to list captures of a URL, then samples
+ * `count` snapshots evenly across the time range. The CDX API is rate-limited
+ * (~15 req/s) but for the small N we use here we never approach the cap.
+ *
+ * CDX response shape:
+ *   [["urlkey","timestamp","original","mimetype","statuscode","digest","length"],
+ *    ["com,stripe)/", "20100101120000", "https://stripe.com/", "text/html", "200", "...", "1234"],
+ *    ...]
+ *
+ * Snapshot URL = `https://web.archive.org/web/<timestamp>/<original>`.
+ */
+const CDX_ENDPOINT = 'https://web.archive.org/cdx/search/cdx';
+const DEFAULT_COUNT = 5;
+/** Convert ISO date "2010-01-01" to CDX yyyymmddhhmmss. */
+function isoToCdxStamp(iso, end = false) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        throw new Error(`wayback: invalid date "${iso}"`);
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return end ? `${y}${m}${day}235959` : `${y}${m}${day}000000`;
+}
+/** Convert CDX timestamp "20100101120000" to ISO datetime. */
+export function cdxStampToIso(stamp) {
+    if (stamp.length < 14)
+        throw new Error(`wayback: malformed CDX timestamp "${stamp}"`);
+    const y = stamp.slice(0, 4);
+    const m = stamp.slice(4, 6);
+    const d = stamp.slice(6, 8);
+    const hh = stamp.slice(8, 10);
+    const mm = stamp.slice(10, 12);
+    const ss = stamp.slice(12, 14);
+    return `${y}-${m}-${d}T${hh}:${mm}:${ss}Z`;
+}
+export function snapshotUrl(timestamp, original) {
+    return `https://web.archive.org/web/${timestamp}/${original}`;
+}
+/** Sample `count` evenly-spaced rows from a sorted list. Always includes first and last. */
+export function sampleEvenly(rows, count) {
+    if (rows.length <= count)
+        return [...rows];
+    if (count <= 0)
+        return [];
+    if (count === 1)
+        return [rows[Math.floor((rows.length - 1) / 2)]];
+    const out = [];
+    const step = (rows.length - 1) / (count - 1);
+    for (let i = 0; i < count; i++) {
+        out.push(rows[Math.round(i * step)]);
+    }
+    return out;
+}
+/** Parse the CDX JSON response (first row is a header). */
+export function parseCdxRows(json) {
+    if (!Array.isArray(json) || json.length < 2)
+        return [];
+    // Skip header row.
+    const rows = json.slice(1);
+    const out = [];
+    for (const r of rows) {
+        if (!Array.isArray(r) || r.length < 7)
+            continue;
+        out.push({
+            urlkey: String(r[0]),
+            timestamp: String(r[1]),
+            original: String(r[2]),
+            mimetype: String(r[3]),
+            statuscode: String(r[4]),
+            digest: String(r[5]),
+            length: String(r[6]),
+        });
+    }
+    return out;
+}
+/** Discover N evenly-spaced wayback snapshots for a URL. */
+export async function discoverWaybackSnapshots(url, opts = {}) {
+    const fetchImpl = opts.fetch ?? globalThis.fetch;
+    if (!fetchImpl)
+        throw new Error('wayback: no fetch implementation available');
+    const count = opts.count ?? DEFAULT_COUNT;
+    const params = new URLSearchParams({
+        url,
+        output: 'json',
+        // collapse=timestamp:6 dedupes to one capture per month (yyyymm = 6 chars).
+        // Without this, CDX returns every capture in the window — which for popular
+        // sites is tens of thousands and silently skews `sampleEvenly` if combined
+        // with a `limit`. With the collapse, the row count is bounded by the
+        // window length in months, so we don't need a limit.
+        collapse: 'timestamp:6',
+    });
+    if (opts.since)
+        params.set('from', isoToCdxStamp(opts.since));
+    if (opts.until)
+        params.set('to', isoToCdxStamp(opts.until, true));
+    if (opts.status200Only !== false) {
+        params.set('filter', 'statuscode:200');
+    }
+    const resp = await fetchImpl(`${CDX_ENDPOINT}?${params.toString()}`);
+    if (!resp.ok) {
+        throw new Error(`wayback: CDX returned ${resp.status} for ${url}`);
+    }
+    const json = await resp.json();
+    const rows = parseCdxRows(json);
+    if (rows.length === 0)
+        return [];
+    // CDX returns chronological order by default. Sample evenly across.
+    const sampled = sampleEvenly(rows, count);
+    return sampled.map(r => ({
+        url,
+        snapshotUrl: snapshotUrl(r.timestamp, r.original),
+        capturedAt: cdxStampToIso(r.timestamp),
+    }));
+}
+/** Expand a list of seed URLs into wayback targets, in parallel. */
+export async function expandWaybackTargets(urls, opts = {}) {
+    const all = await Promise.all(urls.map(u => discoverWaybackSnapshots(u, opts).catch(() => [])));
+    return all.flat();
+}
+//# sourceMappingURL=wayback.js.map

package/dist/discover/wayback.js.map

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

package/dist/jobs/anti-bot.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Anti-bot / blocked-page detection. Pure pattern match against an audit's
+ * report.json — we propagate the existing audit signals rather than re-running
+ * inference.
+ *
+ * Returns a reason string when blocked (so the job can carry it through to
+ * the result envelope), else null.
+ */
+export interface BlockSignals {
+    title?: string;
+    intent?: string;
+    type?: string;
+    ensembleConfidence?: number;
+    findingCount?: number;
+}
+/** Check the audit's report.json for anti-bot patterns. Returns the reason or null. */
+export declare function detectBlock(report: unknown): string | null;
+export declare function reasonFor(s: BlockSignals): string | null;
+//# sourceMappingURL=anti-bot.d.ts.map

package/dist/jobs/anti-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-bot.d.ts","sourceRoot":"","sources":["../../src/jobs/anti-bot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAmBxD"}

package/dist/jobs/anti-bot.js

@@ -0,0 +1,64 @@
+/**
+ * Anti-bot / blocked-page detection. Pure pattern match against an audit's
+ * report.json — we propagate the existing audit signals rather than re-running
+ * inference.
+ *
+ * Returns a reason string when blocked (so the job can carry it through to
+ * the result envelope), else null.
+ */
+const TITLE_PATTERNS = [
+    /just a moment\.{3}/i,
+    /^attention required/i,
+    /access denied/i,
+    /verify you are human/i,
+    /enable javascript and cookies/i,
+    /one more step/i,
+    /please complete the security check/i,
+    /^cloudflare/i,
+    /challenge[- ]page/i,
+];
+const INTENT_PATTERNS = [
+    /cloudflare challenge/i,
+    /anti.?bot/i,
+    /captcha/i,
+    /verify (the )?(human|user|browser)/i,
+    /access (denied|restricted|blocked)/i,
+];
+/** Check the audit's report.json for anti-bot patterns. Returns the reason or null. */
+export function detectBlock(report) {
+    const r = report;
+    const page = r.pages?.[0];
+    if (!page)
+        return null;
+    const v2cls = page.auditResult?.classification;
+    const cls = v2cls ?? page.classification ?? {};
+    const signals = {
+        title: page.title,
+        intent: cls.intent,
+        type: cls.type,
+        ensembleConfidence: cls.ensembleConfidence,
+        findingCount: page.findings?.length ?? 0,
+    };
+    return reasonFor(signals);
+}
+export function reasonFor(s) {
+    const title = (s.title ?? '').trim();
+    const intent = (s.intent ?? '').trim();
+    if (TITLE_PATTERNS.some(re => re.test(title))) {
+        return `blocked: page title looks like an anti-bot challenge ("${title.slice(0, 80)}")`;
+    }
+    if (INTENT_PATTERNS.some(re => re.test(intent))) {
+        return `blocked: classification intent indicates a challenge page ("${intent.slice(0, 80)}")`;
+    }
+    // Last-resort heuristic: zero findings + very low ensemble confidence + unknown
+    // page-type is overwhelmingly an anti-bot or empty page. Leaving it in the
+    // leaderboard pollutes rankings.
+    if ((s.findingCount ?? 0) === 0
+        && typeof s.ensembleConfidence === 'number'
+        && s.ensembleConfidence < 0.35
+        && s.type === 'unknown') {
+        return 'blocked: zero findings, low classifier confidence, unknown type — likely empty/blocked';
+    }
+    return null;
+}
+//# sourceMappingURL=anti-bot.js.map

package/dist/jobs/anti-bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-bot.js","sourceRoot":"","sources":["../../src/jobs/anti-bot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,cAAc,GAAG;IACrB,qBAAqB;IACrB,sBAAsB;IACtB,gBAAgB;IAChB,uBAAuB;IACvB,gCAAgC;IAChC,gBAAgB;IAChB,qCAAqC;IACrC,cAAc;IACd,oBAAoB;CACrB,CAAA;AAED,MAAM,eAAe,GAAG;IACtB,uBAAuB;IACvB,YAAY;IACZ,UAAU;IACV,qCAAqC;IACrC,qCAAqC;CACtC,CAAA;AAUD,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,MAAM,CAAC,GAAG,MAA2P,CAAA;IACrQ,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACzB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAA;IAC9C,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,cAAc,IAAI,EAAE,CAAA;IAC9C,MAAM,OAAO,GAAiB;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;QAC1C,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;KACzC,CAAA;IACD,OAAO,SAAS,CAAC,OAAO,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAe;IACvC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACtC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,0DAA0D,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAA;IACzF,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,+DAA+D,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAA;IAC/F,CAAC;IACD,gFAAgF;IAChF,2EAA2E;IAC3E,iCAAiC;IACjC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,CAAC;WAC1B,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ;WACxC,CAAC,CAAC,kBAAkB,GAAG,IAAI;WAC3B,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,wFAAwF,CAAA;IACjG,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/jobs/cost-estimate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pre-flight cost estimate — refuses to silently spend $1k.
+ *
+ * The numbers here are deliberately conservative and based on observed
+ * production telemetry for `claude-code` provider with sonnet at the time of
+ * writing. If the assumptions drift, only one constant changes.
+ */
+import type { CostEstimate, JobSpec } from './types.js';
+/** Average USD per single-page audit. Tuned for sonnet via claude-code provider, 1 audit pass. */
+export declare const DEFAULT_PER_AUDIT_USD = 0.4;
+export declare function estimateCost(spec: JobSpec, targetCount: number, perAuditUSD?: number): CostEstimate;
+//# sourceMappingURL=cost-estimate.d.ts.map

package/dist/jobs/cost-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimate.d.ts","sourceRoot":"","sources":["../../src/jobs/cost-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEvD,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,SAAwB,GAAG,YAAY,CAUlH"}