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

package/dist/design/audit/modality/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/modality/android.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9E,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAS;IAEhC,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;CAQxD;AAED,eAAO,MAAM,cAAc,wBAA+B,CAAA"}

package/dist/design/audit/modality/android.js

@@ -0,0 +1,18 @@
+/**
+ * Layer 8 — Android modality adapter (stub).
+ *
+ * UI Automator + accessibility-tree capture. Not yet implemented.
+ *
+ * TODO Layer 8: UI Automator bridge, emulator management, ax-tree capture.
+ */
+export class AndroidModalityAdapter {
+    modality = 'android';
+    async capture(_input) {
+        throw new Error('Android modality adapter is not yet implemented. ' +
+            'See RFC-002 Layer 8 for the implementation plan. ' +
+            'Ship iOS first per the RFC sequencing note. ' +
+            'Use --modality html for web audits.');
+    }
+}
+export const androidAdapter = new AndroidModalityAdapter();
+//# sourceMappingURL=android.js.map

package/dist/design/audit/modality/android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../../../src/design/audit/modality/android.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,sBAAsB;IACxB,QAAQ,GAAG,SAAkB,CAAA;IAEtC,KAAK,CAAC,OAAO,CAAC,MAAqB;QACjC,MAAM,IAAI,KAAK,CACb,mDAAmD;YACjD,mDAAmD;YACnD,8CAA8C;YAC9C,qCAAqC,CACxC,CAAA;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,sBAAsB,EAAE,CAAA"}

package/dist/design/audit/modality/html.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Layer 8 — HTML modality adapter.
+ *
+ * Wraps the existing Playwright-based capture pipeline into the `ModalityAdapter`
+ * interface so it can participate in the unified scoring framework. The underlying
+ * pipeline is unchanged; this module provides the typed adapter boundary.
+ */
+import type { ModalityAdapter, ModalityInput, Evidence } from '../v2/types.js';
+export declare class HtmlModalityAdapter implements ModalityAdapter {
+    readonly modality: "html";
+    /**
+     * Capture HTML evidence. Delegates to the existing browser-based pipeline.
+     * In practice, `pipeline.ts` drives this; the adapter exists to make the
+     * interface explicit and enable Layer 8's modality dispatch.
+     *
+     * @param input.entryPoint - URL to audit
+     * @param input.flow - optional page flow (multi-page audit)
+     */
+    capture(input: ModalityInput): Promise<Evidence>;
+}
+export declare const htmlAdapter: HtmlModalityAdapter;
+//# sourceMappingURL=html.d.ts.map

package/dist/design/audit/modality/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/modality/html.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAqB,MAAM,gBAAgB,CAAA;AAEjG,qBAAa,mBAAoB,YAAW,eAAe;IACzD,QAAQ,CAAC,QAAQ,EAAG,MAAM,CAAS;IAEnC;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;CAevD;AAmBD,eAAO,MAAM,WAAW,qBAA4B,CAAA"}

package/dist/design/audit/modality/html.js

@@ -0,0 +1,51 @@
+/**
+ * Layer 8 — HTML modality adapter.
+ *
+ * Wraps the existing Playwright-based capture pipeline into the `ModalityAdapter`
+ * interface so it can participate in the unified scoring framework. The underlying
+ * pipeline is unchanged; this module provides the typed adapter boundary.
+ */
+export class HtmlModalityAdapter {
+    modality = 'html';
+    /**
+     * Capture HTML evidence. Delegates to the existing browser-based pipeline.
+     * In practice, `pipeline.ts` drives this; the adapter exists to make the
+     * interface explicit and enable Layer 8's modality dispatch.
+     *
+     * @param input.entryPoint - URL to audit
+     * @param input.flow - optional page flow (multi-page audit)
+     */
+    async capture(input) {
+        // The real implementation lives in pipeline.ts / measure/index.ts.
+        // This adapter records the contract and is called by the pipeline dispatcher.
+        // When a caller invokes adapter.capture() directly, it returns a shell
+        // Evidence that the pipeline will hydrate with real snapshot + measurements.
+        const shell = {
+            modality: 'html',
+            surfaces: [],
+            measurements: emptyMeasurementBundle(),
+            snapshot: '',
+            screenshot: undefined,
+        };
+        void input;
+        return shell;
+    }
+}
+function emptyMeasurementBundle() {
+    return {
+        contrast: {
+            totalChecked: 0,
+            aaFailures: [],
+            aaaFailures: [],
+            summary: { aaPassRate: 1, aaaPassRate: 1 },
+        },
+        a11y: {
+            ran: true,
+            violations: [],
+            passes: 0,
+        },
+        hasBlockingIssues: false,
+    };
+}
+export const htmlAdapter = new HtmlModalityAdapter();
+//# sourceMappingURL=html.js.map

package/dist/design/audit/modality/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../../src/design/audit/modality/html.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,mBAAmB;IACrB,QAAQ,GAAG,MAAe,CAAA;IAEnC;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,mEAAmE;QACnE,8EAA8E;QAC9E,uEAAuE;QACvE,6EAA6E;QAC7E,MAAM,KAAK,GAAa;YACtB,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,sBAAsB,EAAE;YACtC,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,SAAS;SACtB,CAAA;QACD,KAAK,KAAK,CAAA;QACV,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,QAAQ,EAAE;YACR,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;SAC3C;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI;YACT,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,CAAC;SACV;QACD,iBAAiB,EAAE,KAAK;KACzB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,mBAAmB,EAAE,CAAA"}

package/dist/design/audit/modality/index.d.ts

@@ -0,0 +1,8 @@
+import type { Modality, ModalityAdapter } from './types.js';
+import { htmlAdapter } from './html.js';
+import { iosAdapter } from './ios.js';
+import { androidAdapter } from './android.js';
+export declare function getModalityAdapter(modality: Modality): ModalityAdapter;
+export { htmlAdapter, iosAdapter, androidAdapter };
+export type { Modality, ModalityAdapter };
+//# sourceMappingURL=index.d.ts.map

package/dist/design/audit/modality/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/modality/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAU7C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAEtE;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,CAAA;AAClD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAA"}

package/dist/design/audit/modality/index.js

@@ -0,0 +1,15 @@
+import { htmlAdapter } from './html.js';
+import { iosAdapter } from './ios.js';
+import { androidAdapter } from './android.js';
+const ADAPTERS = {
+    html: htmlAdapter,
+    ios: iosAdapter,
+    android: androidAdapter,
+    terminal: { modality: 'terminal', capture: async () => { throw new Error('terminal modality not implemented'); } },
+    voice: { modality: 'voice', capture: async () => { throw new Error('voice modality not implemented'); } },
+};
+export function getModalityAdapter(modality) {
+    return ADAPTERS[modality];
+}
+export { htmlAdapter, iosAdapter, androidAdapter };
+//# sourceMappingURL=index.js.map

package/dist/design/audit/modality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/design/audit/modality/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,MAAM,QAAQ,GAAsC;IAClD,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;IACf,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA,CAAC,CAAC,EAAE;IACjH,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA,CAAC,CAAC,EAAE;CACzG,CAAA;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC3B,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,CAAA"}

package/dist/design/audit/modality/ios.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Layer 8 — iOS modality adapter (stub).
+ *
+ * XCUITest + accessibility-tree capture. Not yet implemented.
+ * Ship the interface so CLI dispatch and type-checking work; native
+ * bridging will be added once the HTML adapter's abstraction is validated.
+ *
+ * TODO Layer 8: XCUITest bridge, simulator management, ax-tree capture.
+ */
+import type { ModalityAdapter, ModalityInput, Evidence } from '../v2/types.js';
+export declare class IosModalityAdapter implements ModalityAdapter {
+    readonly modality: "ios";
+    capture(_input: ModalityInput): Promise<Evidence>;
+}
+export declare const iosAdapter: IosModalityAdapter;
+//# sourceMappingURL=ios.d.ts.map

package/dist/design/audit/modality/ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/modality/ios.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9E,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,QAAQ,EAAG,KAAK,CAAS;IAE5B,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;CAOxD;AAED,eAAO,MAAM,UAAU,oBAA2B,CAAA"}

package/dist/design/audit/modality/ios.js

@@ -0,0 +1,19 @@
+/**
+ * Layer 8 — iOS modality adapter (stub).
+ *
+ * XCUITest + accessibility-tree capture. Not yet implemented.
+ * Ship the interface so CLI dispatch and type-checking work; native
+ * bridging will be added once the HTML adapter's abstraction is validated.
+ *
+ * TODO Layer 8: XCUITest bridge, simulator management, ax-tree capture.
+ */
+export class IosModalityAdapter {
+    modality = 'ios';
+    async capture(_input) {
+        throw new Error('iOS modality adapter is not yet implemented. ' +
+            'See RFC-002 Layer 8 for the implementation plan. ' +
+            'Use --modality html for web audits.');
+    }
+}
+export const iosAdapter = new IosModalityAdapter();
+//# sourceMappingURL=ios.js.map

package/dist/design/audit/modality/ios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios.js","sourceRoot":"","sources":["../../../../src/design/audit/modality/ios.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,OAAO,kBAAkB;IACpB,QAAQ,GAAG,KAAc,CAAA;IAElC,KAAK,CAAC,OAAO,CAAC,MAAqB;QACjC,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,mDAAmD;YACnD,qCAAqC,CACxC,CAAA;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,kBAAkB,EAAE,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Layer 8 — Modality adapter type contract.
+ *
+ * Re-exports the stable shapes from v2/types.ts. Each adapter (HTML, iOS,
+ * Android) implements the ModalityAdapter interface and produces an Evidence
+ * record that flows into the shared Layers 1–7 scoring pipeline unchanged.
+ */
+export type { Modality, ModalityAdapter, ModalityInput, Evidence, SurfaceRecord, SurfaceMeasurements, } from '../v2/types.js';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/modality/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EACb,QAAQ,EACR,aAAa,EACb,mBAAmB,GACpB,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Layer 8 — Modality adapter type contract.
+ *
+ * Re-exports the stable shapes from v2/types.ts. Each adapter (HTML, iOS,
+ * Android) implements the ModalityAdapter interface and produces an Evidence
+ * record that flows into the shared Layers 1–7 scoring pipeline unchanged.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/design/audit/patches/index.d.ts

@@ -0,0 +1,8 @@
+export { parsePatch, parsePatches } from './parse.js';
+export { validatePatch, validatePatches } from './validate.js';
+export { renderUnifiedDiff, renderPatchSummary } from './render.js';
+export { enforcePatchPolicy } from './severity-enforcement.js';
+export type { ParseResult } from './parse.js';
+export type { ValidationResult, ValidationReason } from './validate.js';
+export type { EnforcementResult, EnforcementRecord } from './severity-enforcement.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/design/audit/patches/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patches/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACvE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/design/audit/patches/index.js

@@ -0,0 +1,5 @@
+export { parsePatch, parsePatches } from './parse.js';
+export { validatePatch, validatePatches } from './validate.js';
+export { renderUnifiedDiff, renderPatchSummary } from './render.js';
+export { enforcePatchPolicy } from './severity-enforcement.js';
+//# sourceMappingURL=index.js.map

package/dist/design/audit/patches/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/design/audit/patches/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/design/audit/patches/parse.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Patch parser — converts raw LLM JSON output into typed `Patch` objects.
+ *
+ * Strict shape validation. On schema mismatch returns `{ patch: null, reason }`
+ * rather than throwing — the calling pipeline batches many candidate patches
+ * per audit and a single malformed entry must not abort the whole run.
+ */
+import type { Patch } from '../v2/types.js';
+export interface ParseResult {
+    patch: Patch | null;
+    reason?: string;
+}
+/**
+ * Parse a single raw LLM-produced object into a `Patch`. Returns
+ * `{ patch: null, reason }` on any schema violation.
+ */
+export declare function parsePatch(raw: unknown): ParseResult;
+/**
+ * Parse an array of raw patch objects. Invalid entries are dropped from the
+ * returned `patches` and reported in `errors` with their original index.
+ */
+export declare function parsePatches(raw: unknown): {
+    patches: Patch[];
+    errors: Array<{
+        index: number;
+        reason: string;
+    }>;
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/design/audit/patches/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patches/parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,KAAK,EAQN,MAAM,gBAAgB,CAAA;AAgBvB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAwDD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CA+CpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG;IAC1C,OAAO,EAAE,KAAK,EAAE,CAAA;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACjD,CAYA"}

package/dist/design/audit/patches/parse.js

@@ -0,0 +1,153 @@
+/**
+ * Patch parser — converts raw LLM JSON output into typed `Patch` objects.
+ *
+ * Strict shape validation. On schema mismatch returns `{ patch: null, reason }`
+ * rather than throwing — the calling pipeline batches many candidate patches
+ * per audit and a single malformed entry must not abort the whole run.
+ */
+const VALID_SCOPES = ['page', 'section', 'component', 'system'];
+const VALID_TARGET_SCOPES = [
+    'tsx', 'jsx', 'css', 'tailwind', 'module-css', 'styled-component', 'structural', 'html',
+];
+const VALID_TEST_KINDS = [
+    'storybook', 'a11y-rule', 'visual-snapshot', 'unit', 'rerun-audit', 'manual',
+];
+const VALID_ROLLBACK_KINDS = ['git-revert', 'css-disable', 'manual'];
+const VALID_CONFIDENCES = ['high', 'medium', 'low', 'untested'];
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function oneOf(value, allowed) {
+    return typeof value === 'string' && allowed.includes(value);
+}
+function parseTarget(raw) {
+    if (!isObject(raw))
+        return 'target: not an object';
+    if (!oneOf(raw.scope, VALID_TARGET_SCOPES))
+        return `target.scope: invalid (got ${String(raw.scope)})`;
+    const target = { scope: raw.scope };
+    if (raw.filePath !== undefined) {
+        if (!isString(raw.filePath))
+            return 'target.filePath: must be non-empty string';
+        target.filePath = raw.filePath;
+    }
+    if (raw.componentName !== undefined) {
+        if (!isString(raw.componentName))
+            return 'target.componentName: must be non-empty string';
+        target.componentName = raw.componentName;
+    }
+    if (raw.cssSelector !== undefined) {
+        if (!isString(raw.cssSelector))
+            return 'target.cssSelector: must be non-empty string';
+        target.cssSelector = raw.cssSelector;
+    }
+    return target;
+}
+function parseTest(raw) {
+    if (!isObject(raw))
+        return 'testThatProves: not an object';
+    if (!oneOf(raw.kind, VALID_TEST_KINDS))
+        return `testThatProves.kind: invalid (got ${String(raw.kind)})`;
+    if (!isString(raw.description))
+        return 'testThatProves.description: must be non-empty string';
+    const test = { kind: raw.kind, description: raw.description };
+    if (raw.command !== undefined) {
+        if (typeof raw.command !== 'string')
+            return 'testThatProves.command: must be string when present';
+        test.command = raw.command;
+    }
+    return test;
+}
+function parseRollback(raw) {
+    if (!isObject(raw))
+        return 'rollback: not an object';
+    if (!oneOf(raw.kind, VALID_ROLLBACK_KINDS))
+        return `rollback.kind: invalid (got ${String(raw.kind)})`;
+    const rollback = { kind: raw.kind };
+    if (raw.instruction !== undefined) {
+        if (typeof raw.instruction !== 'string')
+            return 'rollback.instruction: must be string when present';
+        rollback.instruction = raw.instruction;
+    }
+    return rollback;
+}
+/**
+ * Parse a single raw LLM-produced object into a `Patch`. Returns
+ * `{ patch: null, reason }` on any schema violation.
+ */
+export function parsePatch(raw) {
+    if (!isObject(raw))
+        return { patch: null, reason: 'patch: not an object' };
+    if (!isString(raw.patchId))
+        return { patch: null, reason: 'patchId: required non-empty string' };
+    if (!isString(raw.findingId))
+        return { patch: null, reason: 'findingId: required non-empty string' };
+    if (!oneOf(raw.scope, VALID_SCOPES))
+        return { patch: null, reason: `scope: invalid (got ${String(raw.scope)})` };
+    const target = parseTarget(raw.target);
+    if (typeof target === 'string')
+        return { patch: null, reason: target };
+    if (!isObject(raw.diff))
+        return { patch: null, reason: 'diff: not an object' };
+    if (!isString(raw.diff.before))
+        return { patch: null, reason: 'diff.before: required non-empty string' };
+    if (typeof raw.diff.after !== 'string')
+        return { patch: null, reason: 'diff.after: required string' };
+    const diff = {
+        before: raw.diff.before,
+        after: raw.diff.after,
+        ...(typeof raw.diff.unifiedDiff === 'string' ? { unifiedDiff: raw.diff.unifiedDiff } : {}),
+    };
+    const test = parseTest(raw.testThatProves);
+    if (typeof test === 'string')
+        return { patch: null, reason: test };
+    const rollback = parseRollback(raw.rollback);
+    if (typeof rollback === 'string')
+        return { patch: null, reason: rollback };
+    if (!isObject(raw.estimatedDelta))
+        return { patch: null, reason: 'estimatedDelta: not an object' };
+    if (!isString(raw.estimatedDelta.dim))
+        return { patch: null, reason: 'estimatedDelta.dim: required' };
+    if (typeof raw.estimatedDelta.delta !== 'number' || !Number.isFinite(raw.estimatedDelta.delta)) {
+        return { patch: null, reason: 'estimatedDelta.delta: must be finite number' };
+    }
+    if (!oneOf(raw.estimatedDeltaConfidence, VALID_CONFIDENCES)) {
+        return { patch: null, reason: `estimatedDeltaConfidence: invalid (got ${String(raw.estimatedDeltaConfidence)})` };
+    }
+    const patch = {
+        patchId: raw.patchId,
+        findingId: raw.findingId,
+        scope: raw.scope,
+        target,
+        diff,
+        testThatProves: test,
+        rollback,
+        estimatedDelta: { dim: raw.estimatedDelta.dim, delta: raw.estimatedDelta.delta },
+        estimatedDeltaConfidence: raw.estimatedDeltaConfidence,
+        ...(typeof raw.matchedPatternId === 'string' ? { matchedPatternId: raw.matchedPatternId } : {}),
+    };
+    return { patch };
+}
+/**
+ * Parse an array of raw patch objects. Invalid entries are dropped from the
+ * returned `patches` and reported in `errors` with their original index.
+ */
+export function parsePatches(raw) {
+    if (!Array.isArray(raw)) {
+        return { patches: [], errors: [{ index: -1, reason: 'patches: not an array' }] };
+    }
+    const patches = [];
+    const errors = [];
+    for (let i = 0; i < raw.length; i++) {
+        const result = parsePatch(raw[i]);
+        if (result.patch)
+            patches.push(result.patch);
+        else
+            errors.push({ index: i, reason: result.reason ?? 'unknown' });
+    }
+    return { patches, errors };
+}
+//# sourceMappingURL=parse.js.map

package/dist/design/audit/patches/parse.js.map

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

package/dist/design/audit/patches/render.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Patch renderer — produces a unified diff from a Patch when filePath is known.
+ *
+ * Agents can pipe the result to `git apply --check` then `git apply`.
+ * When filePath is unknown, returns null — the agent must use before/after for
+ * search-replace instead.
+ */
+import type { Patch } from '../v2/types.js';
+/**
+ * Render a minimal unified diff (1-hunk, 3 lines context) from a patch.
+ * Returns null when:
+ *   - `target.filePath` is not set (no file to diff against)
+ *   - `unifiedDiff` is already set on the patch (prefer the LLM's version)
+ */
+export declare function renderUnifiedDiff(patch: Patch): string | null;
+/**
+ * Render a human-readable patch summary for display in report.md.
+ */
+export declare function renderPatchSummary(patch: Patch): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/design/audit/patches/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patches/render.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAuB7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAYvD"}

package/dist/design/audit/patches/render.js

@@ -0,0 +1,55 @@
+/**
+ * Patch renderer — produces a unified diff from a Patch when filePath is known.
+ *
+ * Agents can pipe the result to `git apply --check` then `git apply`.
+ * When filePath is unknown, returns null — the agent must use before/after for
+ * search-replace instead.
+ */
+/**
+ * Render a minimal unified diff (1-hunk, 3 lines context) from a patch.
+ * Returns null when:
+ *   - `target.filePath` is not set (no file to diff against)
+ *   - `unifiedDiff` is already set on the patch (prefer the LLM's version)
+ */
+export function renderUnifiedDiff(patch) {
+    if (patch.diff.unifiedDiff)
+        return patch.diff.unifiedDiff;
+    if (!patch.target.filePath)
+        return null;
+    const { before, after } = patch.diff;
+    const filePath = patch.target.filePath;
+    const beforeLines = before.split('\n');
+    const afterLines = after.split('\n');
+    const removals = beforeLines.map(l => `- ${l}`);
+    const additions = afterLines.map(l => `+ ${l}`);
+    const hunkOldLen = beforeLines.length;
+    const hunkNewLen = afterLines.length;
+    return [
+        `--- a/${filePath}`,
+        `+++ b/${filePath}`,
+        `@@ -1,${hunkOldLen} +1,${hunkNewLen} @@`,
+        ...removals,
+        ...additions,
+    ].join('\n');
+}
+/**
+ * Render a human-readable patch summary for display in report.md.
+ */
+export function renderPatchSummary(patch) {
+    const parts = [];
+    parts.push(`**Patch ${patch.patchId}** (${patch.scope})`);
+    if (patch.target.filePath)
+        parts.push(`File: \`${patch.target.filePath}\``);
+    else if (patch.target.cssSelector)
+        parts.push(`Selector: \`${patch.target.cssSelector}\``);
+    else if (patch.target.componentName)
+        parts.push(`Component: \`${patch.target.componentName}\``);
+    parts.push(`\`\`\`diff\n${renderUnifiedDiff(patch) ?? `- ${patch.diff.before}\n+ ${patch.diff.after}`}\n\`\`\``);
+    parts.push(`Test: ${patch.testThatProves.description}`);
+    if (patch.testThatProves.command)
+        parts.push(`Command: \`${patch.testThatProves.command}\``);
+    parts.push(`Rollback: ${patch.rollback.kind}${patch.rollback.instruction ? ` — ${patch.rollback.instruction}` : ''}`);
+    parts.push(`Estimated Δ: ${patch.estimatedDelta.dim} ${patch.estimatedDelta.delta > 0 ? '+' : ''}${patch.estimatedDelta.delta} (confidence: ${patch.estimatedDeltaConfidence})`);
+    return parts.join('\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/design/audit/patches/render.js.map

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

package/dist/design/audit/patches/severity-enforcement.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Severity enforcement — every major/critical finding MUST have ≥1 valid patch.
+ *
+ * Findings without patches are downgraded to `minor` with an explanatory note.
+ * This runs as a post-processing step after patch validation.
+ */
+import type { DesignFinding } from '../v2/types.js';
+export interface EnforcementRecord {
+    findingId: string;
+    fromSeverity: string;
+    toSeverity: 'minor';
+    reason: string;
+}
+export interface EnforcementResult {
+    findings: DesignFinding[];
+    downgraded: EnforcementRecord[];
+}
+/**
+ * Given a list of findings and the set of valid patches (post-validation),
+ * downgrade any major/critical finding that has no valid patch to `minor`.
+ */
+export declare function enforcePatchPolicy(findings: DesignFinding[], validPatchIds: Set<string>): EnforcementResult;
+//# sourceMappingURL=severity-enforcement.d.ts.map

package/dist/design/audit/patches/severity-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-enforcement.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patches/severity-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAS,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE1D,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAChC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EAAE,EACzB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,iBAAiB,CAkCnB"}

package/dist/design/audit/patches/severity-enforcement.js

@@ -0,0 +1,42 @@
+/**
+ * Severity enforcement — every major/critical finding MUST have ≥1 valid patch.
+ *
+ * Findings without patches are downgraded to `minor` with an explanatory note.
+ * This runs as a post-processing step after patch validation.
+ */
+/**
+ * Given a list of findings and the set of valid patches (post-validation),
+ * downgrade any major/critical finding that has no valid patch to `minor`.
+ */
+export function enforcePatchPolicy(findings, validPatchIds) {
+    const downgraded = [];
+    const updated = findings.map(f => {
+        if (f.severity !== 'major' && f.severity !== 'critical')
+            return f;
+        const v2Finding = f;
+        const patches = v2Finding.patches ?? [];
+        const hasValidPatch = patches.some(p => validPatchIds.has(p.patchId));
+        if (hasValidPatch)
+            return f;
+        downgraded.push({
+            findingId: f.id,
+            fromSeverity: f.severity,
+            toSeverity: 'minor',
+            reason: patches.length === 0
+                ? 'no patches proposed'
+                : 'all proposed patches failed validation (before not in snapshot, missing locator, or delta out of range)',
+        });
+        return {
+            ...f,
+            severity: 'minor',
+            suggestion: [
+                f.suggestion,
+                '[auto-downgraded: patch required for major/critical severity]',
+            ]
+                .filter(Boolean)
+                .join(' '),
+        };
+    });
+    return { findings: updated, downgraded };
+}
+//# sourceMappingURL=severity-enforcement.js.map

package/dist/design/audit/patches/severity-enforcement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-enforcement.js","sourceRoot":"","sources":["../../../../src/design/audit/patches/severity-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAyB,EACzB,aAA0B;IAE1B,MAAM,UAAU,GAAwB,EAAE,CAAA;IAE1C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC/B,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU;YAAE,OAAO,CAAC,CAAA;QAEjE,MAAM,SAAS,GAAG,CAA0C,CAAA;QAC5D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,EAAE,CAAA;QACvC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;QAErE,IAAI,aAAa;YAAE,OAAO,CAAC,CAAA;QAE3B,UAAU,CAAC,IAAI,CAAC;YACd,SAAS,EAAE,CAAC,CAAC,EAAE;YACf,YAAY,EAAE,CAAC,CAAC,QAAQ;YACxB,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;gBAC1B,CAAC,CAAC,qBAAqB;gBACvB,CAAC,CAAC,yGAAyG;SAC9G,CAAC,CAAA;QAEF,OAAO;YACL,GAAG,CAAC;YACJ,QAAQ,EAAE,OAAgB;YAC1B,UAAU,EAAE;gBACV,CAAC,CAAC,UAAU;gBACZ,+DAA+D;aAChE;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC;SACb,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAC1C,CAAC"}