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

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"}

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

@@ -0,0 +1,34 @@
+/**
+ * Patch validator — given a parsed patch and the page snapshot text, verify
+ * that the patch is grounded and applyable.
+ *
+ * Rules:
+ *   - `diff.before` must appear as a case-sensitive substring of the snapshot.
+ *     Agents apply patches literally; a hallucinated `before` is unfixable.
+ *   - `target` must carry at least one locator (cssSelector | filePath |
+ *     componentName). Without one the agent has nowhere to apply.
+ *   - `estimatedDelta.delta` must be in [-3, 3]. Larger claims are almost
+ *     always over-confident on a 1–10 scale.
+ */
+import type { Patch } from '../v2/types.js';
+export type ValidationReason = 'before-not-in-snapshot' | 'target-missing-locator' | 'estimated-delta-out-of-range' | 'before-empty';
+export interface ValidationResult {
+    valid: boolean;
+    reasons: ValidationReason[];
+}
+/**
+ * Validate a single patch against a page snapshot. Reports all issues in one
+ * pass so callers can surface every problem to the agent at once.
+ */
+export declare function validatePatch(patch: Patch, snapshot: string): ValidationResult;
+/**
+ * Validate a list of patches and partition into valid / invalid.
+ */
+export declare function validatePatches(patches: Patch[], snapshot: string): {
+    valid: Patch[];
+    invalid: Array<{
+        patch: Patch;
+        reasons: ValidationReason[];
+    }>;
+};
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patches/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,wBAAwB,GACxB,8BAA8B,GAC9B,cAAc,CAAA;AAElB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAuB9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,EAAE,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,CASnF"}

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

@@ -0,0 +1,53 @@
+/**
+ * Patch validator — given a parsed patch and the page snapshot text, verify
+ * that the patch is grounded and applyable.
+ *
+ * Rules:
+ *   - `diff.before` must appear as a case-sensitive substring of the snapshot.
+ *     Agents apply patches literally; a hallucinated `before` is unfixable.
+ *   - `target` must carry at least one locator (cssSelector | filePath |
+ *     componentName). Without one the agent has nowhere to apply.
+ *   - `estimatedDelta.delta` must be in [-3, 3]. Larger claims are almost
+ *     always over-confident on a 1–10 scale.
+ */
+const DELTA_MIN = -3;
+const DELTA_MAX = 3;
+/**
+ * Validate a single patch against a page snapshot. Reports all issues in one
+ * pass so callers can surface every problem to the agent at once.
+ */
+export function validatePatch(patch, snapshot) {
+    const reasons = [];
+    const { target, diff, estimatedDelta } = patch;
+    if (!target.cssSelector && !target.filePath && !target.componentName) {
+        reasons.push('target-missing-locator');
+    }
+    if (diff.before.length === 0) {
+        reasons.push('before-empty');
+    }
+    else if (!snapshot.includes(diff.before)) {
+        reasons.push('before-not-in-snapshot');
+    }
+    if (estimatedDelta.delta < DELTA_MIN ||
+        estimatedDelta.delta > DELTA_MAX ||
+        !Number.isFinite(estimatedDelta.delta)) {
+        reasons.push('estimated-delta-out-of-range');
+    }
+    return { valid: reasons.length === 0, reasons };
+}
+/**
+ * Validate a list of patches and partition into valid / invalid.
+ */
+export function validatePatches(patches, snapshot) {
+    const valid = [];
+    const invalid = [];
+    for (const patch of patches) {
+        const result = validatePatch(patch, snapshot);
+        if (result.valid)
+            valid.push(patch);
+        else
+            invalid.push({ patch, reasons: result.reasons });
+    }
+    return { valid, invalid };
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/design/audit/patches/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,MAAM,SAAS,GAAG,CAAC,CAAC,CAAA;AACpB,MAAM,SAAS,GAAG,CAAC,CAAA;AAEnB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,QAAgB;IAC1D,MAAM,OAAO,GAAuB,EAAE,CAAA;IACtC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,KAAK,CAAA;IAE9C,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC9B,CAAC;SAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IACxC,CAAC;IAED,IACE,cAAc,CAAC,KAAK,GAAG,SAAS;QAChC,cAAc,CAAC,KAAK,GAAG,SAAS;QAChC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,EACtC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,QAAgB;IAEhB,MAAM,KAAK,GAAY,EAAE,CAAA;IACzB,MAAM,OAAO,GAAyD,EAAE,CAAA;IACxE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC7C,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC3B,CAAC"}

package/dist/design/audit/patterns/match.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Layer 5 — Pattern matching.
+ *
+ * Fuzzy-matches a page against catalogued patterns. When patterns exist (post
+ * fleet accumulation), findings include `matchedPatterns[]` so agents can cite
+ * fleet evidence rather than applying novel patches.
+ *
+ * Currently returns [] (cold-start). The interface is stable.
+ */
+import type { PatternMatch } from './types.js';
+import type { PageType, Dimension } from '../v2/types.js';
+export interface MatchContext {
+    pageType: PageType;
+    weakDimensions: Dimension[];
+    dir?: string;
+}
+/**
+ * Match patterns against the current page context. Returns the top-N matches
+ * ordered by expected leverage (weakest dim × pattern's median delta for that dim).
+ *
+ * Cold-start: returns [] until patterns are mined.
+ */
+export declare function matchPatterns(ctx: MatchContext, topN?: number): Promise<PatternMatch[]>;
+//# sourceMappingURL=match.d.ts.map

package/dist/design/audit/patterns/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patterns/match.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAW,YAAY,EAAgB,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAGzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,CAAA;IAClB,cAAc,EAAE,SAAS,EAAE,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CA+BzB"}

package/dist/design/audit/patterns/match.js

@@ -0,0 +1,48 @@
+/**
+ * Layer 5 — Pattern matching.
+ *
+ * Fuzzy-matches a page against catalogued patterns. When patterns exist (post
+ * fleet accumulation), findings include `matchedPatterns[]` so agents can cite
+ * fleet evidence rather than applying novel patches.
+ *
+ * Currently returns [] (cold-start). The interface is stable.
+ */
+import { queryPatterns } from './store.js';
+/**
+ * Match patterns against the current page context. Returns the top-N matches
+ * ordered by expected leverage (weakest dim × pattern's median delta for that dim).
+ *
+ * Cold-start: returns [] until patterns are mined.
+ */
+export async function matchPatterns(ctx, topN = 5) {
+    const query = {
+        pageType: ctx.pageType,
+        minApplications: 5,
+        minSuccessRate: 0.5,
+    };
+    const candidates = await queryPatterns(query, ctx.dir);
+    if (candidates.length === 0)
+        return [];
+    const scored = candidates.map(p => {
+        const leverage = ctx.weakDimensions.reduce((sum, dim) => {
+            return sum + (p.fleetEvidence.medianDimDelta[dim] ?? 0);
+        }, 0);
+        return { pattern: p, leverage };
+    });
+    return scored
+        .sort((a, b) => b.leverage - a.leverage)
+        .slice(0, topN)
+        .map(({ pattern, leverage }) => {
+        const expectedDelta = {};
+        for (const dim of ctx.weakDimensions) {
+            expectedDelta[dim] = pattern.fleetEvidence.medianDimDelta[dim] ?? 0;
+        }
+        return {
+            pattern,
+            matchConfidence: Math.min(1, leverage / 10),
+            expectedDelta,
+            applicationGuidance: `Apply ${pattern.scaffold.description}. Key decisions: ${pattern.scaffold.keyDecisions.join('; ')}.`,
+        };
+    });
+}
+//# sourceMappingURL=match.js.map

package/dist/design/audit/patterns/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../../../src/design/audit/patterns/match.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAiB,EACjB,OAAe,CAAC;IAEhB,MAAM,KAAK,GAAiB;QAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,eAAe,EAAE,CAAC;QAClB,cAAc,EAAE,GAAG;KACpB,CAAA;IACD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,MAAM,GAAkD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC/E,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACtD,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,CAAC,EAAE,CAAC,CAAC,CAAA;QACL,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM;SACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7B,MAAM,aAAa,GAA8B,EAA+B,CAAA;QAChF,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACrC,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACrE,CAAC;QACD,OAAO;YACL,OAAO;YACP,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,EAAE,CAAC;YAC3C,aAAa;YACb,mBAAmB,EAAE,SAAS,OAAO,CAAC,QAAQ,CAAC,WAAW,oBAAoB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC1H,CAAA;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/design/audit/patterns/mine.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Layer 5 — Pattern mining (scaffold).
+ *
+ * In production this runs as a Cloudflare Worker cron job on accumulated
+ * PatchApplication telemetry. The mining threshold (N≥30, ≥5 tenants,
+ * replicationRate≥0.7) prevents false patterns from premature data.
+ *
+ * Until fleet data accumulates this module is a scaffold. Run:
+ *   pnpm patterns:mine --dir ~/.bad
+ *
+ * TODO: implement clustering algorithm once sufficient attribution data exists.
+ */
+import type { PatchApplication } from '../attribution/types.js';
+export interface MineOptions {
+    minApplications?: number;
+    minTenants?: number;
+    minReplicationRate?: number;
+    dir?: string;
+}
+/**
+ * Mine patterns from accumulated PatchApplication records.
+ *
+ * Currently a stub — returns 0 mined until clustering is implemented.
+ * The interface is stable; consumers can call it safely in tests via synthetic
+ * data without triggering real fleet operations.
+ */
+export declare function minePatterns(applications: PatchApplication[], opts?: MineOptions): Promise<{
+    mined: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=mine.d.ts.map

package/dist/design/audit/patterns/mine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mine.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patterns/mine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAI/D,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAQD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,gBAAgB,EAAE,EAChC,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7C"}

package/dist/design/audit/patterns/mine.js

@@ -0,0 +1,35 @@
+/**
+ * Layer 5 — Pattern mining (scaffold).
+ *
+ * In production this runs as a Cloudflare Worker cron job on accumulated
+ * PatchApplication telemetry. The mining threshold (N≥30, ≥5 tenants,
+ * replicationRate≥0.7) prevents false patterns from premature data.
+ *
+ * Until fleet data accumulates this module is a scaffold. Run:
+ *   pnpm patterns:mine --dir ~/.bad
+ *
+ * TODO: implement clustering algorithm once sufficient attribution data exists.
+ */
+import { savePattern } from './store.js';
+const DEFAULTS = {
+    minApplications: 30,
+    minTenants: 5,
+    minReplicationRate: 0.7,
+};
+/**
+ * Mine patterns from accumulated PatchApplication records.
+ *
+ * Currently a stub — returns 0 mined until clustering is implemented.
+ * The interface is stable; consumers can call it safely in tests via synthetic
+ * data without triggering real fleet operations.
+ */
+export async function minePatterns(applications, opts = {}) {
+    void applications;
+    void opts;
+    void DEFAULTS;
+    void savePattern;
+    // TODO: implement structural clustering by (scope, target.cssSelector pattern,
+    // diff similarity) once N≥30 fleet data is available. See RFC §Layer 5.
+    return { mined: 0, skipped: applications.length };
+}
+//# sourceMappingURL=mine.js.map

package/dist/design/audit/patterns/mine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mine.js","sourceRoot":"","sources":["../../../../src/design/audit/patterns/mine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AASxC,MAAM,QAAQ,GAAuC;IACnD,eAAe,EAAE,EAAE;IACnB,UAAU,EAAE,CAAC;IACb,kBAAkB,EAAE,GAAG;CACxB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAgC,EAChC,OAAoB,EAAE;IAEtB,KAAK,YAAY,CAAA;IACjB,KAAK,IAAI,CAAA;IACT,KAAK,QAAQ,CAAA;IACb,KAAK,WAAW,CAAA;IAChB,+EAA+E;IAC/E,wEAAwE;IACxE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAA;AACnD,CAAC"}

package/dist/design/audit/patterns/store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Layer 5 — Pattern store.
+ *
+ * Reads/writes patterns from a JSONL file. In production this is backed by a
+ * Cloudflare D1 or R2 store; the JSONL backend is for local dev and tests.
+ *
+ * Cold-start: the pattern library is empty until fleet data accumulates.
+ * The store returns [] for all queries until patterns are mined (Layer 5 mine.ts).
+ */
+import type { Pattern, PatternQuery } from './types.js';
+export declare function loadPatterns(dir?: string): Promise<Pattern[]>;
+export declare function savePattern(pattern: Pattern, dir?: string): Promise<void>;
+export declare function queryPatterns(query: PatternQuery, dir?: string): Promise<Pattern[]>;
+//# sourceMappingURL=store.d.ts.map

package/dist/design/audit/patterns/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patterns/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAKvD,wBAAsB,YAAY,CAAC,GAAG,GAAE,MAAoB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAQhF;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5F;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,GAAE,MAAoB,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC,CAapB"}

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

@@ -0,0 +1,53 @@
+/**
+ * Layer 5 — Pattern store.
+ *
+ * Reads/writes patterns from a JSONL file. In production this is backed by a
+ * Cloudflare D1 or R2 store; the JSONL backend is for local dev and tests.
+ *
+ * Cold-start: the pattern library is empty until fleet data accumulates.
+ * The store returns [] for all queries until patterns are mined (Layer 5 mine.ts).
+ */
+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';
+const DEFAULT_DIR = path.join(os.homedir(), '.bad', 'patterns');
+const PATTERNS_FILE = 'patterns.jsonl';
+export async function loadPatterns(dir = DEFAULT_DIR) {
+    const filePath = path.join(dir, PATTERNS_FILE);
+    if (!fs.existsSync(filePath))
+        return [];
+    const lines = fs.readFileSync(filePath, 'utf-8').split('\n').filter(Boolean);
+    return lines.flatMap(line => {
+        try {
+            return [JSON.parse(line)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+export async function savePattern(pattern, dir = DEFAULT_DIR) {
+    await fsp.mkdir(dir, { recursive: true });
+    await fsp.appendFile(path.join(dir, PATTERNS_FILE), JSON.stringify(pattern) + '\n', 'utf-8');
+}
+export async function queryPatterns(query, dir = DEFAULT_DIR) {
+    const all = await loadPatterns(dir);
+    return all.filter(p => {
+        if (query.category && p.category !== query.category)
+            return false;
+        if (query.pageType && p.classification.type !== query.pageType)
+            return false;
+        if (query.minApplications && p.fleetEvidence.applications < query.minApplications)
+            return false;
+        if (query.minSuccessRate && p.fleetEvidence.successRate < query.minSuccessRate)
+            return false;
+        if (query.weakDimension) {
+            const delta = p.fleetEvidence.medianDimDelta[query.weakDimension] ?? 0;
+            if (delta <= 0)
+                return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../src/design/audit/patterns/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAG7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;AAC/D,MAAM,aAAa,GAAG,gBAAgB,CAAA;AAEtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,WAAW;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5E,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC1B,IAAI,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAA;QAAC,CAAC;QAC5C,MAAM,CAAC;YAAC,OAAO,EAAE,CAAA;QAAC,CAAC;IACrB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB,EAAE,MAAc,WAAW;IAC3E,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;AAC9F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB,EACnB,MAAc,WAAW;IAEzB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACpB,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAA;QACjE,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAA;QAC5E,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,aAAa,CAAC,YAAY,GAAG,KAAK,CAAC,eAAe;YAAE,OAAO,KAAK,CAAA;QAC/F,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,aAAa,CAAC,WAAW,GAAG,KAAK,CAAC,cAAc;YAAE,OAAO,KAAK,CAAA;QAC5F,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;YACtE,IAAI,KAAK,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAA;QAC9B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Layer 5 — Pattern library type contract.
+ *
+ * Patterns are mined from accumulated PatchApplication data once a cluster
+ * meets: N≥30 applications across ≥5 distinct tenants, replicationRate≥0.7.
+ * Until fleet data accumulates (≥6 weeks), the pattern library is empty.
+ *
+ * This module defines the stable query API so agents can code against it now.
+ * The mining and matching implementations are scaffolded; real clustering runs
+ * as a Cloudflare Worker cron once the attribution data accumulates.
+ */
+export type { PageType, Dimension } from '../v2/types.js';
+import type { PageType, Dimension } from '../v2/types.js';
+export interface PatternScaffold {
+    description: string;
+    referenceTsx?: string;
+    referenceCss?: string;
+    keyDecisions: string[];
+}
+export interface PatternFleetEvidence {
+    applications: number;
+    successRate: number;
+    medianDimDelta: Record<Dimension, number>;
+    sampleTenants: number;
+}
+export interface Pattern {
+    patternId: string;
+    category: string;
+    classification: {
+        type: PageType;
+        tags: string[];
+    };
+    scaffold: PatternScaffold;
+    scores: {
+        whenFollowed: Record<Dimension, number>;
+    };
+    fleetEvidence: PatternFleetEvidence;
+    fixtures: string[];
+}
+export interface PatternQuery {
+    category?: string;
+    pageType?: PageType;
+    weakDimension?: Dimension;
+    minApplications?: number;
+    minSuccessRate?: number;
+}
+export interface PatternMatch {
+    pattern: Pattern;
+    matchConfidence: number;
+    expectedDelta: Record<Dimension, number>;
+    applicationGuidance: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/patterns/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAEzD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACzC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAClD,QAAQ,EAAE,eAAe,CAAA;IACzB,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IACnD,aAAa,EAAE,oBAAoB,CAAA;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACxC,mBAAmB,EAAE,MAAM,CAAA;CAC5B"}

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

@@ -0,0 +1,13 @@
+/**
+ * Layer 5 — Pattern library type contract.
+ *
+ * Patterns are mined from accumulated PatchApplication data once a cluster
+ * meets: N≥30 applications across ≥5 distinct tenants, replicationRate≥0.7.
+ * Until fleet data accumulates (≥6 weeks), the pattern library is empty.
+ *
+ * This module defines the stable query API so agents can code against it now.
+ * The mining and matching implementations are scaffolded; real clustering runs
+ * as a Cloudflare Worker cron once the attribution data accumulates.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -9,7 +9,9 @@
 import type { Page } from 'playwright';
 import type { Brain } from '../../brain/index.js';
 import { PlaywrightDriver } from '../../drivers/playwright.js';
+import { type AuditPassId, type AuditOverrides } from './evaluate.js';
 import type { PageAuditResult } from './types.js';
+import type { AudienceTag, ModalityTag, RegulatoryContextTag, AudienceVulnerabilityTag } from './v2/types.js';
 export interface AuditOnePageOptions {
     brain: Brain;
     driver: PlaywrightDriver;
@@ -21,6 +23,30 @@ export interface AuditOnePageOptions {
     screenshotDir?: string;
     /** User-supplied rubric fragments directory */
     userRubricsDir?: string;
+    /** Focused LLM audit passes to run for the subjective evaluation layer */
+    auditPasses?: AuditPassId[];
+    /** Telemetry correlation — links every page envelope to its parent run. */
+    runId?: string;
+    parentRunId?: string;
+    /** Provider/model — captured into telemetry so a rollup can group by model. */
+    provider?: string;
+    model?: string;
+    /**
+     * Evolve-aware overrides. The GEPA harness passes these per-trial to A/B
+     * candidate prompts; production runs leave them undefined.
+     */
+    overrides?: AuditOverrides;
+    /**
+     * Layer 7 — bypass the ethics gate entirely. Audited + warned. Test-only.
+     */
+    skipEthics?: boolean;
+    /** Override directory containing ethics `*.yaml` rule files. */
+    ethicsRulesDir?: string;
+    /** Layer 6 hints used by ethics + composable predicates. */
+    audience?: AudienceTag[];
+    modality?: ModalityTag[];
+    regulatoryContext?: RegulatoryContextTag[];
+    audienceVulnerability?: AudienceVulnerabilityTag[];
 }
 /**
  * Audit one page through the full Gen 2 pipeline.

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/design/audit/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAK9D,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAA;AAErE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAqBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyEtF"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/design/audit/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAI9D,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAA;AAOrE,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EAGzB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,EAAE,CAAA;IAC3B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,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;AAqBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2NtF"}