@gate-forge/core 0.7.0 → 0.8.0

package/dist/quarantine/index.js

@@ -0,0 +1,194 @@
+/**
+ * Flaky-test quarantine loading.
+ *
+ * Owner-approved, always-expiring files in `.gateforge/quarantine/*.yml`
+ * that remove ONE test from the required set. The same trust pattern as
+ * waivers, with one difference in force: a quarantined test never
+ * FORGIVES anything — it never blocks and its evidence is never used,
+ * so an obligation only it covered stays `missing`.
+ *
+ * Fail-closed rules:
+ * - ALL FOUR attribution fields (testKey, owner, approver, reason) plus
+ *   the expiry are mandatory; a file missing any of them is a
+ *   configuration error, never a partially-applied exception.
+ * - Expiry is judged against the INJECTED clock, never the wall clock
+ *   (invariant 7).
+ * - A maximum duration is enforced: a quarantine may never outlive the
+ *   documented ceiling, so a "temporary" escape hatch cannot become
+ *   permanent by hand-editing the expiry.
+ * - Two quarantines on the same test key are ambiguous → error.
+ *
+ * Loading is synchronous, matching the waivers loader.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { compareStrings } from '../graph/util.js';
+import { QuarantineSchema } from '../schemas/quarantine.js';
+import { parseInstant } from '../verdict/index.js';
+/** Maximum quarantine lifetime in days: a quarantine always expires. */
+export const QUARANTINE_MAX_DAYS = 14;
+/** The documented ceiling in milliseconds. */
+export const QUARANTINE_MAX_DURATION_MS = QUARANTINE_MAX_DAYS * 86_400_000;
+/** Repo-relative quarantine directory. */
+export const QUARANTINE_DIR = '.gateforge/quarantine';
+/** Error raised for any fail-closed quarantine configuration problem. */
+export class GateforgeQuarantineError extends Error {
+    /** Every problem found, file-scoped, in deterministic order. */
+    problems;
+    constructor(problems) {
+        const rendered = problems.map((problem) => `  ${problem.file}: ${problem.detail}`).join('\n');
+        super(`quarantine configuration failed closed with ${problems.length} problem(s):\n${rendered}`);
+        this.name = 'GateforgeQuarantineError';
+        this.problems = problems;
+    }
+}
+/**
+ * Parses one quarantine document (fail-closed: an empty or non-mapping
+ * document is a problem, never an empty quarantine).
+ *
+ * Args:
+ *   text: the raw file content.
+ *
+ * Returns:
+ *   unknown: the parsed YAML mapping.
+ *
+ * @throws Error when the bytes are unparsable or not a mapping.
+ */
+function parseYamlDocument(text) {
+    const parsed = parseYaml(text);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('quarantine document must be a mapping with schemaVersion, testKey, owner, approver, reason, expiresAt');
+    }
+    return parsed;
+}
+/**
+ * Loads and validates every `*.yml` quarantine file in `dir` (sorted by
+ * filename for determinism). A missing directory yields an empty result
+ * — most repositories have no quarantines. Any problem (unparsable
+ * YAML, missing mandatory field, duplicate test key, over-long duration)
+ * fails closed with {@link GateforgeQuarantineError}.
+ *
+ * Args:
+ *   dir: the quarantine directory (`.gateforge/quarantine`).
+ *   options: injected clock and optional maximum duration.
+ *
+ * Returns:
+ *   QuarantineLoadResult: active and expired partitions, both sorted by
+ *   test key.
+ *
+ * @throws GateforgeQuarantineError when any file fails closed.
+ */
+export function loadQuarantines(dir, options) {
+    const now = parseInstant(options.now);
+    const maxDurationMs = options.maxDurationMs ?? QUARANTINE_MAX_DURATION_MS;
+    if (!existsSync(dir))
+        return { active: [], expired: [] };
+    const files = readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.yml'))
+        .map((entry) => entry.name)
+        .sort(compareStrings);
+    const problems = [];
+    const parsed = [];
+    for (const file of files) {
+        let document;
+        try {
+            document = parseYamlDocument(readFileSync(join(dir, file), 'utf8'));
+        }
+        catch (error) {
+            problems.push({
+                file,
+                detail: `not parsable YAML: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            continue;
+        }
+        const result = QuarantineSchema.safeParse(document);
+        if (!result.success) {
+            for (const issue of result.error.issues) {
+                problems.push({ file, detail: `${issue.path.join('.') || '<quarantine>'}: ${issue.message}` });
+            }
+            continue;
+        }
+        const duration = Date.parse(result.data.expiresAt) - now.getTime();
+        if (duration > maxDurationMs) {
+            problems.push({
+                file,
+                detail: `expiresAt '${result.data.expiresAt}' exceeds the maximum quarantine duration ` +
+                    `(${String(Math.round(maxDurationMs / 86_400_000))} days from now)`,
+            });
+            continue;
+        }
+        parsed.push({ file, quarantine: result.data });
+    }
+    const byTestKey = new Map();
+    for (const entry of parsed) {
+        const firstFile = byTestKey.get(entry.quarantine.testKey);
+        if (firstFile !== undefined) {
+            problems.push({
+                file: entry.file,
+                detail: `test key '${entry.quarantine.testKey}' is already quarantined by '${firstFile}' — ` +
+                    'one quarantine per test, never two overlapping exceptions',
+            });
+            continue;
+        }
+        byTestKey.set(entry.quarantine.testKey, entry.file);
+    }
+    if (problems.length > 0)
+        throw new GateforgeQuarantineError(problems);
+    const active = [];
+    const expired = [];
+    for (const entry of parsed) {
+        if (now.getTime() >= Date.parse(entry.quarantine.expiresAt))
+            expired.push(entry);
+        else
+            active.push(entry);
+    }
+    const byTest = (a, b) => compareStrings(a.quarantine.testKey, b.quarantine.testKey);
+    return { active: [...active].sort(byTest), expired: [...expired].sort(byTest) };
+}
+/**
+ * Serializes one quarantine document in the stable on-disk form
+ * (block YAML, trailing newline).
+ *
+ * Args:
+ *   quarantine: the schema-valid document.
+ *
+ * Returns:
+ *   string: the file content.
+ */
+export function serializeQuarantine(quarantine) {
+    const body = stringifyYaml({
+        schemaVersion: quarantine.schemaVersion,
+        testKey: quarantine.testKey,
+        owner: quarantine.owner,
+        approver: quarantine.approver,
+        reason: quarantine.reason,
+        expiresAt: quarantine.expiresAt,
+    });
+    return `${body.endsWith('\n') ? body : `${body}\n`}`;
+}
+/**
+ * Writes one quarantine document, creating parent directories as needed.
+ * Fail-closed: a write failure surfaces as a {@link GateforgeQuarantineError}.
+ *
+ * Args:
+ *   path: destination file path.
+ *   quarantine: the schema-valid document to write.
+ *
+ * @throws GateforgeQuarantineError when the file cannot be written.
+ */
+export function writeQuarantine(path, quarantine) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, serializeQuarantine(quarantine), 'utf8');
+    }
+    catch (error) {
+        throw new GateforgeQuarantineError([
+            {
+                file: basename(path),
+                detail: `could not be written: ${error instanceof Error ? error.message : String(error)}`,
+            },
+        ]);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/quarantine/index.js.map

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

package/dist/receipt/index.d.ts

@@ -1,6 +1,8 @@
 import { type JsonValue } from '../canonical-json.js';
-import { type GateReceipt } from '../schemas/gate-receipt.js';
 import { EMPTY_BEHAVIOR_CATALOG_DIGEST } from '../policy/behavior.js';
+import { type GateReceipt } from '../schemas/gate-receipt.js';
+import type { ExecutedOutcome } from '../schemas/execution-result.js';
+import { type RunRecord, type RunRecordBody } from '../schemas/run-record.js';
 /** Domain tag binding receipt MACs to the gate-receipt envelope format. */
 export declare const RECEIPT_DOMAIN = "gateforge.receipt.v2";
 /** The only receipt envelope version this code produces or honors. */
@@ -63,6 +65,68 @@ export { EMPTY_BEHAVIOR_CATALOG_DIGEST };
  *   TypeError: when the verifier key is empty.
  */
 export declare function gateReceiptMac(verifierKey: string, body: GateReceiptBody): string;
+/**
+ * Digest over a run's per-test outcomes, in the sealed order. A run
+ * record binds it so the record can never claim a cleaner run than the
+ * execution result it names, and a consumer recomputes it from that
+ * execution result when it recomputes the re-seal.
+ *
+ * Args:
+ *   outcomes: the sealed execution result's per-test outcomes.
+ *
+ * Returns:
+ *   string: 64-char lowercase hex digest.
+ */
+export declare function testOutcomesDigestOf(outcomes: readonly ExecutedOutcome[]): string;
+/** Domain tag binding run-record MACs to the run-record envelope format. */
+export declare const RUN_RECORD_DOMAIN = "gateforge.run-record.v1";
+/** The only run-record envelope version this code produces or honors. */
+export declare const RUN_RECORD_VERSION = 1;
+/**
+ * Computes the run-record MAC: HMAC-SHA256 over the GF-canonical JSON
+ * of `{domain: 'gateforge.run-record.v1', ...body}` keyed by the same
+ * witness verifier key a receipt uses. The distinct domain tag makes
+ * cross-format acceptance impossible in both directions: a run record
+ * can never verify as a gate receipt, and a receipt MAC can never
+ * verify as a run record.
+ *
+ * Args:
+ *   verifierKey: the witness verifier secret (non-empty).
+ *   body: the unsigned run-record body.
+ *
+ * Returns:
+ *   string: 64-char lowercase hex HMAC.
+ *
+ * Throws:
+ *   TypeError: when the verifier key is empty.
+ */
+export declare function runRecordMac(verifierKey: string, body: RunRecordBody): string;
+/** Typed reasons a run-record candidate failed verification (fail closed). */
+export type RunRecordRejection = 'missing' | 'malformed' | 'mac-fail' | 'not-whole-suite';
+/** The verification outcome: a validated run record or a typed rejection. */
+export type RunRecordVerification = {
+    ok: true;
+    record: RunRecord;
+} | {
+    ok: false;
+    rejection: RunRecordRejection;
+    detail: string;
+};
+/**
+ * Verifies a run-record candidate end to end (fail closed): the strict
+ * schema first, then the MAC under the given verifier key. A run record
+ * authenticates EXACTLY this much and no more — it carries no gate
+ * verdict, so there is nothing here to grade, compare against a policy
+ * pin, or accept as proof for a blocked gate.
+ *
+ * Args:
+ *   verifierKey: the witness verifier secret the record must carry a MAC for.
+ *   candidate: the parsed run-state document.
+ *
+ * Returns:
+ *   RunRecordVerification: the validated record or the typed rejection.
+ */
+export declare function verifyRunRecord(verifierKey: string, candidate: unknown): RunRecordVerification;
 /** Typed reasons a receipt candidate failed verification (fail closed). */
 export type ReceiptRejection = 'missing' | 'malformed' | 'mac-fail' | 'input-digest-mismatch' | 'policy-digest-mismatch' | 'selection-digest-mismatch' | 'catalog-digest-mismatch' | 'execution-digest-mismatch' | 'attestation-digest-mismatch' | 'tree-mismatch' | 'behavior-digest-mismatch' | 'case-set-mismatch' | 'case-execution-mismatch' | 'engine-bundle-mismatch' | 'boundary-mismatch' | 'artifact-mismatch' | 'not-clean';
 /** The verification outcome: a validated receipt or a typed rejection. */

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

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

package/dist/receipt/index.js

@@ -15,8 +15,9 @@
  */
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import { canonicalJson, sha256Canonical } from '../canonical-json.js';
-import { GateReceiptSchema } from '../schemas/gate-receipt.js';
 import { EMPTY_BEHAVIOR_CATALOG_DIGEST } from '../policy/behavior.js';
+import { GateReceiptSchema } from '../schemas/gate-receipt.js';
+import { RunRecordSchema } from '../schemas/run-record.js';
 /** Domain tag binding receipt MACs to the gate-receipt envelope format. */
 export const RECEIPT_DOMAIN = 'gateforge.receipt.v2';
 /** The only receipt envelope version this code produces or honors. */
@@ -127,6 +128,119 @@ export function gateReceiptMac(verifierKey, body) {
     }))
         .digest('hex');
 }
+/**
+ * Digest over a run's per-test outcomes, in the sealed order. A run
+ * record binds it so the record can never claim a cleaner run than the
+ * execution result it names, and a consumer recomputes it from that
+ * execution result when it recomputes the re-seal.
+ *
+ * Args:
+ *   outcomes: the sealed execution result's per-test outcomes.
+ *
+ * Returns:
+ *   string: 64-char lowercase hex digest.
+ */
+export function testOutcomesDigestOf(outcomes) {
+    return sha256Canonical(outcomes);
+}
+/** Domain tag binding run-record MACs to the run-record envelope format. */
+export const RUN_RECORD_DOMAIN = 'gateforge.run-record.v1';
+/** The only run-record envelope version this code produces or honors. */
+export const RUN_RECORD_VERSION = 1;
+/**
+ * Computes the run-record MAC: HMAC-SHA256 over the GF-canonical JSON
+ * of `{domain: 'gateforge.run-record.v1', ...body}` keyed by the same
+ * witness verifier key a receipt uses. The distinct domain tag makes
+ * cross-format acceptance impossible in both directions: a run record
+ * can never verify as a gate receipt, and a receipt MAC can never
+ * verify as a run record.
+ *
+ * Args:
+ *   verifierKey: the witness verifier secret (non-empty).
+ *   body: the unsigned run-record body.
+ *
+ * Returns:
+ *   string: 64-char lowercase hex HMAC.
+ *
+ * Throws:
+ *   TypeError: when the verifier key is empty.
+ */
+export function runRecordMac(verifierKey, body) {
+    if (typeof verifierKey !== 'string' || verifierKey.length === 0) {
+        throw new TypeError('runRecordMac: verifier key must be a non-empty string');
+    }
+    return createHmac('sha256', verifierKey)
+        .update(canonicalJson({
+        domain: RUN_RECORD_DOMAIN,
+        ...body,
+    }))
+        .digest('hex');
+}
+/**
+ * Verifies a run-record candidate end to end (fail closed): the strict
+ * schema first, then the MAC under the given verifier key. A run record
+ * authenticates EXACTLY this much and no more — it carries no gate
+ * verdict, so there is nothing here to grade, compare against a policy
+ * pin, or accept as proof for a blocked gate.
+ *
+ * Args:
+ *   verifierKey: the witness verifier secret the record must carry a MAC for.
+ *   candidate: the parsed run-state document.
+ *
+ * Returns:
+ *   RunRecordVerification: the validated record or the typed rejection.
+ */
+export function verifyRunRecord(verifierKey, candidate) {
+    if (candidate === undefined || candidate === null) {
+        return { ok: false, rejection: 'missing', detail: 'run record is missing' };
+    }
+    const parsed = RunRecordSchema.safeParse(candidate);
+    if (!parsed.success) {
+        const issue = parsed.error.issues[0];
+        const path = issue === undefined ? '' : ` at '${issue.path.map(String).join('.')}':`;
+        return {
+            ok: false,
+            rejection: 'malformed',
+            detail: `run record is malformed${path} ${issue?.message ?? 'unknown schema error'}`,
+        };
+    }
+    const record = parsed.data;
+    const { mac, ...body } = record;
+    if (typeof verifierKey !== 'string' || verifierKey.length === 0) {
+        return {
+            ok: false,
+            rejection: 'mac-fail',
+            detail: 'run record cannot verify without a verifier key (fail closed)',
+        };
+    }
+    if (!MAC_PATTERN.test(mac)) {
+        return { ok: false, rejection: 'mac-fail', detail: 'run record mac is malformed' };
+    }
+    let expectedMac;
+    let claimedMac;
+    try {
+        expectedMac = Buffer.from(runRecordMac(verifierKey, body), 'hex');
+        claimedMac = Buffer.from(mac, 'hex');
+    }
+    catch {
+        return { ok: false, rejection: 'mac-fail', detail: 'run record mac could not be recomputed' };
+    }
+    if (expectedMac.length !== claimedMac.length || !timingSafeEqual(expectedMac, claimedMac)) {
+        return {
+            ok: false,
+            rejection: 'mac-fail',
+            detail: 'run record signature fails; the record was forged or tampered with (fail closed)',
+        };
+    }
+    if (record.plannedTests === 0) {
+        return {
+            ok: false,
+            rejection: 'not-whole-suite',
+            detail: 'run record holds no planned test, so it proves no whole-suite run',
+        };
+    }
+    return { ok: true, record };
+}
 /**
  * Verifies a receipt candidate end-to-end (fail closed):
  * 1. structural — the value must parse against the strict v1 schema;

package/dist/receipt/index.js.map

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

package/dist/report/human-message.d.ts

@@ -0,0 +1,33 @@
+import type { CauseCode } from '../schemas/verdict.js';
+/** Minimal report data required to build a consistent human-readable message. */
+export interface HumanMessageEntry {
+    /** The stable cause code, when the entry has one. */
+    cause?: CauseCode | null;
+    /** Plain-language detail or verdict reason. */
+    detail?: string;
+    /** Resource or obligation identity used to choose a useful command. */
+    id?: string;
+    /** Suggested action associated with the cause. */
+    nextAction?: string | null;
+    /** Verdict reason, when the entry represents an obligation. */
+    reason?: string | null;
+    /** Blocking kind or verdict name used when no cause is available. */
+    type?: string;
+}
+/**
+ * Prefix of the refusal a receipt sealed by an older engine produces. The
+ * receipt records the version that sealed it, so a version disagreement is
+ * reportable fact, and it is the one cause a user acts on by re-sealing.
+ */
+export declare const ENGINE_UPGRADE_REFUSAL_PREFIX = "require-e2e: this receipt was sealed by Gateforge ";
+/**
+ * Builds the common sentence, copyable command, and final cause marker for a report entry.
+ *
+ * Args:
+ *   entry: report detail, identity, cause, and suggested action.
+ *
+ * Returns:
+ *   string: one deterministic sentence followed by a runnable command and `[CODE]`.
+ */
+export declare function humanMessage(entry: HumanMessageEntry): string;
+//# sourceMappingURL=human-message.d.ts.map

package/dist/report/human-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-message.d.ts","sourceRoot":"","sources":["../../src/report/human-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,uDACY,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiB7D"}

package/dist/report/human-message.js

@@ -0,0 +1,33 @@
+/**
+ * Prefix of the refusal a receipt sealed by an older engine produces. The
+ * receipt records the version that sealed it, so a version disagreement is
+ * reportable fact, and it is the one cause a user acts on by re-sealing.
+ */
+export const ENGINE_UPGRADE_REFUSAL_PREFIX = 'require-e2e: this receipt was sealed by Gateforge ';
+/**
+ * Builds the common sentence, copyable command, and final cause marker for a report entry.
+ *
+ * Args:
+ *   entry: report detail, identity, cause, and suggested action.
+ *
+ * Returns:
+ *   string: one deterministic sentence followed by a runnable command and `[CODE]`.
+ */
+export function humanMessage(entry) {
+    // The sentence gets its own period below; a detail that already ends in
+    // one would print `.. Run`.
+    const sentence = (entry.reason ?? entry.detail ?? 'Gateforge found an unresolved item').trim().replace(/\.$/, '');
+    const command = entry.nextAction?.startsWith('gateforge ')
+        ? entry.nextAction
+        : entry.cause === 'TEST_MAPPING_MISSING' ||
+            entry.cause === 'TEST_MAPPING_AMBIGUOUS' ||
+            entry.cause === 'TEST_MAPPING_STALE' ||
+            entry.cause === 'TEST_KIND_UNKNOWN'
+            ? 'gateforge tests suggest'
+            : entry.id !== undefined
+                ? `gateforge explain ${entry.id}`
+                : 'gateforge discover --json';
+    const code = entry.cause ?? entry.type?.toUpperCase().replaceAll('-', '_') ?? 'BLOCKING_FINDING';
+    return `${sentence}. Run \`${command}\`. [${code}]`;
+}
+//# sourceMappingURL=human-message.js.map

package/dist/report/human-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-message.js","sourceRoot":"","sources":["../../src/report/human-message.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,oDAAoD,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,wEAAwE;IACxE,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,oCAAoC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAClH,MAAM,OAAO,GACX,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;QACxC,CAAC,CAAC,KAAK,CAAC,UAAU;QAClB,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,sBAAsB;YACpC,KAAK,CAAC,KAAK,KAAK,wBAAwB;YACxC,KAAK,CAAC,KAAK,KAAK,oBAAoB;YACpC,KAAK,CAAC,KAAK,KAAK,mBAAmB;YACrC,CAAC,CAAC,yBAAyB;YAC3B,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS;gBACtB,CAAC,CAAC,qBAAqB,KAAK,CAAC,EAAE,EAAE;gBACjC,CAAC,CAAC,2BAA2B,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,kBAAkB,CAAC;IACjG,OAAO,GAAG,QAAQ,WAAW,OAAO,QAAQ,IAAI,GAAG,CAAC;AACtD,CAAC"}