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

package/dist/design/audit/attribution/store.js

@@ -0,0 +1,108 @@
+/**
+ * Layer 4 — Append-only JSONL store for PatchApplication records.
+ *
+ * Layout: `<dir>/applications/<YYYY-MM-DD>.jsonl`
+ * Each line is a standalone JSON object — `patchHash` is always set so cross-
+ * tenant aggregation can group by patch signature, not per-tenant path.
+ *
+ * Append-only invariant: never mutate existing lines. Outcome updates are
+ * recorded as NEW lines so the JSONL is an event stream, not a state snapshot.
+ */
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import * as crypto from 'node:crypto';
+const DEFAULT_DIR = path.join(os.homedir(), '.bad', 'attribution');
+function applicationsDir(dir) {
+    return path.join(dir, 'applications');
+}
+function todayPath(dir) {
+    const date = new Date().toISOString().slice(0, 10);
+    return path.join(applicationsDir(dir), `${date}.jsonl`);
+}
+/**
+ * Stable hash for a patch diff + scope. Same patch content across tenants →
+ * same hash, enabling cross-tenant reliability aggregation.
+ */
+export function patchHash(diff, scope) {
+    return crypto
+        .createHash('sha256')
+        .update(`${diff.before}\n---\n${diff.after}\n---\n${scope}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+/** Append a new PatchApplication record. */
+export async function appendPatchApplication(app, dir = DEFAULT_DIR) {
+    await fsp.mkdir(applicationsDir(dir), { recursive: true });
+    await fsp.appendFile(todayPath(dir), JSON.stringify(app) + '\n', 'utf-8');
+}
+/** Sync variant for non-async call sites. */
+export function appendPatchApplicationSync(app, dir = DEFAULT_DIR) {
+    fs.mkdirSync(applicationsDir(dir), { recursive: true });
+    fs.appendFileSync(todayPath(dir), JSON.stringify(app) + '\n', 'utf-8');
+}
+/** Read all PatchApplication records from the last `days` days. */
+export async function readRecentApplications(days = 7, dir = DEFAULT_DIR) {
+    const appsDir = applicationsDir(dir);
+    if (!fs.existsSync(appsDir))
+        return [];
+    const results = [];
+    for (let d = 0; d < days; d++) {
+        const date = new Date(Date.now() - d * 86_400_000).toISOString().slice(0, 10);
+        const filePath = path.join(appsDir, `${date}.jsonl`);
+        if (!fs.existsSync(filePath))
+            continue;
+        const lines = fs.readFileSync(filePath, 'utf-8').split('\n').filter(Boolean);
+        for (const line of lines) {
+            try {
+                results.push(JSON.parse(line));
+            }
+            catch {
+                // corrupt line — skip
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Find the most recent pending application for a patchId — one that has no
+ * `postAuditRunId` yet. Used when a re-audit lands to attach the outcome.
+ */
+export async function findPendingApplication(patchId, dir = DEFAULT_DIR) {
+    const apps = await readRecentApplications(7, dir);
+    // Most recent first; pick the newest pending one.
+    const pending = apps
+        .filter(a => a.patchId === patchId && !a.postAuditRunId)
+        .sort((a, b) => b.appliedAt.localeCompare(a.appliedAt));
+    return pending[0] ?? null;
+}
+/**
+ * Append an outcome event for an existing application. Does NOT mutate the
+ * original line — appends a new event so the JSONL remains an event stream.
+ */
+export async function updateApplicationOutcome(applicationId, postAuditRunId, observed, dir = DEFAULT_DIR) {
+    const apps = await readRecentApplications(7, dir);
+    const original = apps.find(a => a.applicationId === applicationId);
+    if (!original) {
+        throw new Error(`PatchApplication ${applicationId} not found in the last 7 days`);
+    }
+    const agreementScore = computeAgreementScore(original.predicted, observed);
+    const outcome = {
+        ...original,
+        postAuditRunId,
+        observed,
+        agreementScore,
+    };
+    await fsp.mkdir(applicationsDir(dir), { recursive: true });
+    await fsp.appendFile(todayPath(dir), JSON.stringify(outcome) + '\n', 'utf-8');
+}
+function computeAgreementScore(predicted, observed) {
+    if (!predicted || !observed)
+        return 0;
+    const p = predicted.delta;
+    const o = observed.delta;
+    const denom = Math.max(Math.abs(p), Math.abs(o), 1);
+    return 1 - Math.abs(p - o) / denom;
+}
+//# sourceMappingURL=store.js.map

package/dist/design/audit/attribution/store.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Layer 4 — Outcome attribution type contract.
+ *
+ * These types are already defined in src/design/audit/v2/types.ts as part of
+ * the Phase 0 contract. This module re-exports them so attribution code can
+ * import from a single, predictable path. When v2/types.ts is the sole
+ * canonical source, update these re-exports accordingly.
+ */
+export type { PatchApplication, PatchReliability, } from '../v2/types.js';
+/** sha256(diff.before + '\n---\n' + diff.after + '\n---\n' + scope).slice(0,16) */
+export type PatchHash = string;
+export type PatchRecommendation = 'recommended' | 'neutral' | 'antipattern';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/attribution/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAA;AAEvB,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,CAAA"}

package/dist/design/audit/attribution/types.js

@@ -0,0 +1,10 @@
+/**
+ * Layer 4 — Outcome attribution type contract.
+ *
+ * These types are already defined in src/design/audit/v2/types.ts as part of
+ * the Phase 0 contract. This module re-exports them so attribution code can
+ * import from a single, predictable path. When v2/types.ts is the sole
+ * canonical source, update these re-exports accordingly.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/design/audit/attribution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/design/audit/attribution/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/design/audit/classify-ensemble.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Ensemble classifier — Layer 1 of the world-class design-audit architecture.
+ *
+ * Three-signal vote (URL pattern + DOM heuristic + LLM) decides the page type
+ * and reports an ensemble confidence so downstream layers (first-principles
+ * fallback, rubric loader, telemetry) can act on uncertainty honestly.
+ *
+ * Vote logic:
+ *   - URL + DOM agree on a type AND combined confidence > 0.7  → accept (skip LLM)
+ *   - else                                                      → run LLM, take majority
+ *   - if LLM confidence < 0.5 AND signals disagree              → return 'unknown' with dissent
+ */
+import type { Brain } from '../../brain/index.js';
+import type { PageState } from '../../types.js';
+import type { PageType } from './types.js';
+import type { ClassifierSignal, DomHeuristics, EnsembleClassification } from './v2/types.js';
+interface UrlPatternRule {
+    pattern: RegExp;
+    type: PageType;
+    confidence: number;
+    rationale: string;
+}
+export interface EnsembleClassifyInput {
+    brain: Brain;
+    state: PageState;
+    url: string;
+    /** Optional pre-captured DOM heuristics. If absent, we attempt to derive them from the snapshot. */
+    domHeuristics?: DomHeuristics;
+}
+/** Public entry point. */
+export declare function classifyEnsemble(input: EnsembleClassifyInput): Promise<EnsembleClassification>;
+export declare function classifyByUrl(url: string): ClassifierSignal | null;
+export declare function classifyByDom(dom: DomHeuristics): ClassifierSignal | null;
+/**
+ * Best-effort DOM heuristic derivation from the accessibility-tree snapshot.
+ * Pipelines that capture true DOM heuristics via Playwright should pass them
+ * in directly; this fallback works against the @ref-snapshot text.
+ */
+export declare function deriveHeuristics(state: PageState): DomHeuristics;
+export declare const ENSEMBLE_INTERNALS: {
+    URL_PATTERN_RULES: UrlPatternRule[];
+    ENSEMBLE_AGREEMENT_THRESHOLD: number;
+    LLM_FALLBACK_CONFIDENCE: number;
+};
+export {};
+//# sourceMappingURL=classify-ensemble.d.ts.map

package/dist/design/audit/classify-ensemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-ensemble.d.ts","sourceRoot":"","sources":["../../../src/design/audit/classify-ensemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EAAsB,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAEtB,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAoBD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,oGAAoG;IACpG,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,0BAA0B;AAC1B,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgFpG;AA8BD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAkBlE;AAID,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,GAAG,IAAI,CA8BzE;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAchE;AAYD,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA"}

package/dist/design/audit/classify-ensemble.js

@@ -0,0 +1,207 @@
+/**
+ * Ensemble classifier — Layer 1 of the world-class design-audit architecture.
+ *
+ * Three-signal vote (URL pattern + DOM heuristic + LLM) decides the page type
+ * and reports an ensemble confidence so downstream layers (first-principles
+ * fallback, rubric loader, telemetry) can act on uncertainty honestly.
+ *
+ * Vote logic:
+ *   - URL + DOM agree on a type AND combined confidence > 0.7  → accept (skip LLM)
+ *   - else                                                      → run LLM, take majority
+ *   - if LLM confidence < 0.5 AND signals disagree              → return 'unknown' with dissent
+ */
+import { classifyPage, defaultClassification } from './classify.js';
+/**
+ * URL pattern rules — straight from the RFC. Order matters: more specific
+ * patterns first. Each rule's confidence is the URL signal's contribution to
+ * the ensemble vote.
+ */
+const URL_PATTERN_RULES = [
+    { pattern: /\/(docs|reference|api|guide|help|faq)(\/|$)/, type: 'docs', confidence: 0.85, rationale: 'URL contains a docs path segment' },
+    { pattern: /\/(checkout|cart|pay|order|billing)(\/|$)/, type: 'ecommerce', confidence: 0.85, rationale: 'URL contains a commerce path segment' },
+    { pattern: /\/(app|dashboard|workspace|admin)(\/|$)/, type: 'saas-app', confidence: 0.75, rationale: 'URL contains an app/dashboard path segment' },
+    { pattern: /\/(login|signup|auth|sign-in)(\/|$)/, type: 'utility', confidence: 0.85, rationale: 'URL contains an auth path segment' },
+    { pattern: /\/(pricing|plans|features|product)(\/|$)/, type: 'marketing', confidence: 0.7, rationale: 'URL contains a marketing path segment' },
+    { pattern: /\/(blog|articles|news|stories)(\/|$)/, type: 'blog', confidence: 0.8, rationale: 'URL contains a blog path segment' },
+    { pattern: /\/$/, type: 'marketing', confidence: 0.4, rationale: 'URL is a root path — weak marketing default' },
+];
+const ENSEMBLE_AGREEMENT_THRESHOLD = 0.7;
+const LLM_FALLBACK_CONFIDENCE = 0.5;
+/** Public entry point. */
+export async function classifyEnsemble(input) {
+    const signals = [];
+    // ── 1. URL pattern signal ──
+    const urlSignal = classifyByUrl(input.url);
+    if (urlSignal)
+        signals.push(urlSignal);
+    // ── 2. DOM heuristic signal ──
+    const dom = input.domHeuristics ?? deriveHeuristics(input.state);
+    const domSignal = classifyByDom(dom);
+    if (domSignal)
+        signals.push(domSignal);
+    // ── Quick path: URL + DOM agree with combined confidence > threshold ──
+    if (urlSignal &&
+        domSignal &&
+        urlSignal.type === domSignal.type &&
+        urlSignal.confidence + domSignal.confidence > ENSEMBLE_AGREEMENT_THRESHOLD) {
+        const ensembleConfidence = clamp01(Math.min(1, (urlSignal.confidence + domSignal.confidence) / 1.6));
+        return finalize({
+            type: urlSignal.type,
+            base: defaultClassification(),
+            signals,
+            ensembleConfidence,
+            signalsAgreed: true,
+        });
+    }
+    // ── 3. LLM tiebreaker ──
+    const llmClass = await classifyPage(input.brain, input.state).catch(() => defaultClassification());
+    signals.push({
+        source: 'llm',
+        type: llmClass.type,
+        confidence: llmClass.confidence,
+        rationale: llmClass.intent || 'LLM page classification',
+    });
+    // ── Vote ──
+    const tally = new Map();
+    for (const sig of signals) {
+        tally.set(sig.type, (tally.get(sig.type) ?? 0) + sig.confidence);
+    }
+    const sortedVotes = [...tally.entries()].sort((a, b) => b[1] - a[1]);
+    const winner = sortedVotes[0];
+    const winningType = winner ? winner[0] : 'unknown';
+    const winningTotal = winner ? winner[1] : 0;
+    // Compute aggregate confidence: average over participating signals, weighted by agreement.
+    const winningSignals = signals.filter((s) => s.type === winningType);
+    const agreementShare = winningSignals.length / signals.length;
+    const meanConfidence = winningSignals.reduce((acc, s) => acc + s.confidence, 0) / Math.max(winningSignals.length, 1);
+    const ensembleConfidence = clamp01(meanConfidence * agreementShare + 0.05 * (winningTotal - meanConfidence));
+    const signalsAgreed = signals.every((s) => s.type === winningType);
+    const dissent = signals.filter((s) => s.type !== winningType).map((s) => ({ source: s.source, type: s.type }));
+    // ── Low-confidence + disagreement → 'unknown' with dissent ──
+    if (!signalsAgreed && llmClass.confidence < LLM_FALLBACK_CONFIDENCE) {
+        return finalize({
+            type: 'unknown',
+            base: llmClass,
+            signals,
+            ensembleConfidence: Math.min(ensembleConfidence, 0.5),
+            signalsAgreed: false,
+            dissent,
+        });
+    }
+    return finalize({
+        type: winningType,
+        base: llmClass,
+        signals,
+        ensembleConfidence,
+        signalsAgreed,
+        dissent: signalsAgreed ? undefined : dissent,
+    });
+}
+function finalize(args) {
+    const { type, base, signals, ensembleConfidence, signalsAgreed } = args;
+    const firstPrinciplesMode = !signalsAgreed || ensembleConfidence < 0.6;
+    const out = {
+        ...base,
+        type,
+        confidence: ensembleConfidence,
+        signals,
+        signalsAgreed,
+        ensembleConfidence,
+        firstPrinciplesMode,
+    };
+    if (args.dissent && args.dissent.length > 0)
+        out.dissent = args.dissent;
+    return out;
+}
+// ── URL-pattern classifier ──────────────────────────────────────────────────
+export function classifyByUrl(url) {
+    let pathname;
+    try {
+        pathname = new URL(url).pathname || '/';
+    }
+    catch {
+        return null;
+    }
+    for (const rule of URL_PATTERN_RULES) {
+        if (rule.pattern.test(pathname)) {
+            return {
+                source: 'url-pattern',
+                type: rule.type,
+                confidence: rule.confidence,
+                rationale: `${rule.rationale} (${pathname})`,
+            };
+        }
+    }
+    return null;
+}
+// ── DOM-heuristic classifier ────────────────────────────────────────────────
+export function classifyByDom(dom) {
+    // docs: lots of paragraphs + code blocks, modest nav
+    if (dom.codeBlockCount >= 3 && dom.paragraphCount >= 6) {
+        return signal('dom-heuristic', 'docs', 0.7, `code blocks=${dom.codeBlockCount}, paragraphs=${dom.paragraphCount}`);
+    }
+    // dashboard: many table rows or charts + sidebar
+    if ((dom.tableRowCount >= 8 || dom.chartCount >= 2) && dom.hasSidebar) {
+        return signal('dom-heuristic', 'dashboard', 0.7, `rows=${dom.tableRowCount}, charts=${dom.chartCount}, sidebar=true`);
+    }
+    // saas-app: sidebar + multiple forms or many inputs
+    if (dom.hasSidebar && (dom.formCount >= 1 || dom.inputCount >= 4)) {
+        return signal('dom-heuristic', 'saas-app', 0.65, `sidebar=true, forms=${dom.formCount}, inputs=${dom.inputCount}`);
+    }
+    // utility: single dominant form, no hero, no sidebar
+    if (dom.formCount >= 1 && dom.inputCount >= 2 && !dom.hasHeroSection && !dom.hasSidebar) {
+        return signal('dom-heuristic', 'utility', 0.7, `single form, no hero, no sidebar`);
+    }
+    // ecommerce: forms + many nav items + footer links (storefront chrome)
+    if (dom.formCount >= 1 && dom.navItems >= 6 && dom.hasFooterLinks) {
+        return signal('dom-heuristic', 'ecommerce', 0.6, `nav=${dom.navItems}, footer-links, form present`);
+    }
+    // blog: long body of paragraphs without forms or tables
+    if (dom.paragraphCount >= 8 && dom.formCount === 0 && dom.tableRowCount === 0) {
+        return signal('dom-heuristic', 'blog', 0.65, `paragraphs=${dom.paragraphCount}, no forms or tables`);
+    }
+    // marketing: hero + footer-link cloud + few paragraphs
+    if (dom.hasHeroSection && dom.hasFooterLinks && dom.paragraphCount < 8) {
+        return signal('dom-heuristic', 'marketing', 0.6, `hero present, footer-links, paragraphs=${dom.paragraphCount}`);
+    }
+    return null;
+}
+function signal(source, type, confidence, rationale) {
+    return { source, type, confidence, rationale };
+}
+// ── DOM heuristic derivation from snapshot ──────────────────────────────────
+/**
+ * Best-effort DOM heuristic derivation from the accessibility-tree snapshot.
+ * Pipelines that capture true DOM heuristics via Playwright should pass them
+ * in directly; this fallback works against the @ref-snapshot text.
+ */
+export function deriveHeuristics(state) {
+    const snapshot = state.snapshot ?? '';
+    return {
+        formCount: countMatches(snapshot, /\bform\b/gi),
+        inputCount: countMatches(snapshot, /\b(textbox|searchbox|combobox|spinbutton|input)\b/gi),
+        tableRowCount: countMatches(snapshot, /\brow\b/gi),
+        chartCount: countMatches(snapshot, /\b(graphics-document|graphics-symbol|figure)\b/gi),
+        navItems: countMatches(snapshot, /\bnavigation\b/gi),
+        hasFooterLinks: /\bcontentinfo\b/i.test(snapshot),
+        hasHeroSection: /\bhero\b/i.test(snapshot) || /\bbanner\b/i.test(snapshot),
+        hasSidebar: /\bcomplementary\b/i.test(snapshot) || /\bsidebar\b/i.test(snapshot),
+        paragraphCount: countMatches(snapshot, /\bparagraph\b/gi),
+        codeBlockCount: countMatches(snapshot, /\bcode\b/gi),
+    };
+}
+function countMatches(haystack, pattern) {
+    const m = haystack.match(pattern);
+    return m ? m.length : 0;
+}
+function clamp01(n) {
+    if (Number.isNaN(n))
+        return 0;
+    return Math.max(0, Math.min(1, n));
+}
+export const ENSEMBLE_INTERNALS = {
+    URL_PATTERN_RULES,
+    ENSEMBLE_AGREEMENT_THRESHOLD,
+    LLM_FALLBACK_CONFIDENCE,
+};
+//# sourceMappingURL=classify-ensemble.js.map

package/dist/design/audit/classify-ensemble.js.map

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

package/dist/design/audit/ethics/check.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ethics check — Layer 7.
+ *
+ * Given a page state + classification, evaluate every loaded `EthicsRule` whose
+ * `appliesWhen` matches the classification. Each rule produces zero-or-one
+ * `EthicsViolation`. Violations enforce a hard floor on the rollup score:
+ * `critical-floor → 4`, `major-floor → 6`.
+ *
+ * Detector kinds:
+ *   pattern-absent   → regex must appear in page text; violation if absent
+ *   pattern-present  → regex must NOT appear in page text; violation if present
+ *   llm-classifier   → ask the LLM the question; violation when answer is yes
+ *
+ * Pattern matches are case-insensitive. The LLM classifier asks for a
+ * single-token yes/no answer to keep latency + cost predictable.
+ */
+import type { Brain } from '../../../brain/index.js';
+import type { AppliesWhen, EthicsRule, EthicsViolation, PageClassification, AudienceTag, ModalityTag, RegulatoryContextTag, AudienceVulnerabilityTag } from '../v2/types.js';
+export interface EthicsCheckContext {
+    /** Lowercased page text used by `pattern-absent` / `pattern-present`. */
+    pageText: string;
+    /** Page snapshot — passed verbatim to the LLM classifier prompt. */
+    snapshot: string;
+    /** The page-type / domain / maturity / designSystem classification. */
+    classification: PageClassification;
+    /** Operator-supplied audience / modality / regulatory hints (Layer 6). */
+    audience?: AudienceTag[];
+    modality?: ModalityTag[];
+    regulatoryContext?: RegulatoryContextTag[];
+    audienceVulnerability?: AudienceVulnerabilityTag[];
+}
+export interface EthicsCheckOptions {
+    /** When set, llm-classifier rules are evaluated; else skipped (deterministic-only). */
+    brain?: Brain;
+    /** Optional screenshot URL/path passed alongside snapshot context (unused today). */
+    screenshotPath?: string;
+    /** Logger override — defaults to console.warn for skipped rules. */
+    warn?: (msg: string) => void;
+}
+/**
+ * Run every applicable rule against the page. Returns one violation per rule
+ * that fires. Rules whose detector is `llm-classifier` are skipped (with a
+ * warning) when no `brain` is supplied — the alternative is silent passes,
+ * which would hide ethics gaps in offline tests.
+ */
+export declare function checkEthics(rules: EthicsRule[], ctx: EthicsCheckContext, opts?: EthicsCheckOptions): Promise<EthicsViolation[]>;
+/**
+ * Predicate evaluator — extends the rubric loader's logic with the v2 fields
+ * (audience / modality / regulatoryContext / audienceVulnerability). All
+ * declared predicates are AND-combined.
+ */
+export declare function appliesWhenMatches(w: AppliesWhen, ctx: EthicsCheckContext): boolean;
+export declare function runLlmClassifier(brain: Brain, question: string, snapshot: string): Promise<boolean>;
+/** Build the lowercased text blob used by pattern detectors. URL is intentionally excluded — URL path tokens (e.g. "no-dosage") would cause false negatives on pattern-absent rules. */
+export declare function pageTextBlob(snapshot: string, extra?: {
+    url?: string;
+    title?: string;
+}): string;
+//# sourceMappingURL=check.d.ts.map

package/dist/design/audit/ethics/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/ethics/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,gBAAgB,CAAA;AAGvB,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,cAAc,EAAE,kBAAkB,CAAA;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC1C,qBAAqB,CAAC,EAAE,wBAAwB,EAAE,CAAA;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,GAAG,EAAE,kBAAkB,EACvB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CAS5B;AAaD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAqCnF;AAuCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wLAAwL;AACxL,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG/F"}

package/dist/design/audit/ethics/check.js

@@ -0,0 +1,137 @@
+/**
+ * Ethics check — Layer 7.
+ *
+ * Given a page state + classification, evaluate every loaded `EthicsRule` whose
+ * `appliesWhen` matches the classification. Each rule produces zero-or-one
+ * `EthicsViolation`. Violations enforce a hard floor on the rollup score:
+ * `critical-floor → 4`, `major-floor → 6`.
+ *
+ * Detector kinds:
+ *   pattern-absent   → regex must appear in page text; violation if absent
+ *   pattern-present  → regex must NOT appear in page text; violation if present
+ *   llm-classifier   → ask the LLM the question; violation when answer is yes
+ *
+ * Pattern matches are case-insensitive. The LLM classifier asks for a
+ * single-token yes/no answer to keep latency + cost predictable.
+ */
+import { rollupCapFor } from './loader.js';
+/**
+ * Run every applicable rule against the page. Returns one violation per rule
+ * that fires. Rules whose detector is `llm-classifier` are skipped (with a
+ * warning) when no `brain` is supplied — the alternative is silent passes,
+ * which would hide ethics gaps in offline tests.
+ */
+export async function checkEthics(rules, ctx, opts = {}) {
+    const warn = opts.warn ?? ((m) => console.warn(m));
+    const violations = [];
+    for (const rule of rules) {
+        if (!appliesWhenMatches(rule.appliesWhen, ctx))
+            continue;
+        const fired = await runDetector(rule, ctx, opts.brain, warn);
+        if (fired)
+            violations.push(toViolation(rule));
+    }
+    return violations;
+}
+function toViolation(rule) {
+    return {
+        ruleId: rule.ruleId,
+        detected: true,
+        severity: rule.severity,
+        rollupCap: rollupCapFor(rule.severity),
+        remediation: rule.remediation,
+        ...(rule.citation ? { citation: rule.citation } : {}),
+    };
+}
+/**
+ * Predicate evaluator — extends the rubric loader's logic with the v2 fields
+ * (audience / modality / regulatoryContext / audienceVulnerability). All
+ * declared predicates are AND-combined.
+ */
+export function appliesWhenMatches(w, ctx) {
+    if (w.universal)
+        return true;
+    const cls = ctx.classification;
+    if (w.type?.length && !w.type.includes(cls.type))
+        return false;
+    if (w.maturity?.length && !w.maturity.includes(cls.maturity))
+        return false;
+    if (w.designSystem?.length && !w.designSystem.includes(cls.designSystem))
+        return false;
+    if (w.domain?.length) {
+        const domain = (cls.domain ?? '').toLowerCase();
+        const ok = w.domain.some(d => domain.includes(d.toLowerCase()));
+        if (!ok)
+            return false;
+    }
+    if (w.audience?.length) {
+        if (!w.audience.some(a => (ctx.audience ?? []).includes(a)))
+            return false;
+    }
+    if (w.modality?.length) {
+        if (!w.modality.some(m => (ctx.modality ?? []).includes(m)))
+            return false;
+    }
+    if (w.regulatoryContext?.length) {
+        if (!w.regulatoryContext.some(r => (ctx.regulatoryContext ?? []).includes(r)))
+            return false;
+    }
+    if (w.audienceVulnerability?.length) {
+        if (!w.audienceVulnerability.some(v => (ctx.audienceVulnerability ?? []).includes(v)))
+            return false;
+    }
+    // Same conservative behavior as the rubric loader: with no predicates and
+    // no `universal: true`, the rule does NOT apply (don't fire blindly).
+    const hasPredicate = !!w.type?.length ||
+        !!w.maturity?.length ||
+        !!w.designSystem?.length ||
+        !!w.domain?.length ||
+        !!w.audience?.length ||
+        !!w.modality?.length ||
+        !!w.regulatoryContext?.length ||
+        !!w.audienceVulnerability?.length;
+    return hasPredicate;
+}
+async function runDetector(rule, ctx, brain, warn) {
+    const d = rule.detector;
+    if (d.kind === 'pattern-absent') {
+        const re = compilePattern(d.pattern);
+        return !re.test(ctx.pageText);
+    }
+    if (d.kind === 'pattern-present') {
+        const re = compilePattern(d.pattern);
+        return re.test(ctx.pageText);
+    }
+    if (d.kind === 'llm-classifier') {
+        if (!brain) {
+            warn(`ethics: skipping llm-classifier rule ${rule.ruleId} — no brain provided`);
+            return false;
+        }
+        return await runLlmClassifier(brain, d.llmCheck, ctx.snapshot);
+    }
+    return false;
+}
+function compilePattern(pattern) {
+    // Allow already-anchored regexes; default is case-insensitive substring.
+    try {
+        return new RegExp(pattern, 'i');
+    }
+    catch {
+        // Fallback: treat as a literal token if regex compile fails.
+        return new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'i');
+    }
+}
+const LLM_SYSTEM = `You are an ethics auditor. Answer the user's yes/no question about the page snapshot. Respond with exactly one token — yes or no — followed by an optional one-sentence rationale. Do not hedge. If the evidence is missing, answer no.`;
+export async function runLlmClassifier(brain, question, snapshot) {
+    const truncated = snapshot.length > 8000 ? `${snapshot.slice(0, 8000)}\n…[truncated]` : snapshot;
+    const user = `QUESTION: ${question}\n\nPAGE SNAPSHOT:\n${truncated}\n\nAnswer yes or no.`;
+    const { text } = await brain.complete(LLM_SYSTEM, user, { maxOutputTokens: 80 });
+    const first = text.trim().toLowerCase().match(/^[a-z]+/)?.[0] ?? '';
+    return first === 'yes';
+}
+/** Build the lowercased text blob used by pattern detectors. URL is intentionally excluded — URL path tokens (e.g. "no-dosage") would cause false negatives on pattern-absent rules. */
+export function pageTextBlob(snapshot, extra) {
+    const parts = [snapshot, extra?.title ?? ''];
+    return parts.join('\n').toLowerCase();
+}
+//# sourceMappingURL=check.js.map

package/dist/design/audit/ethics/check.js.map

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