@miller-tech/uap 2.1.7 → 2.11.0

package/dist/delivery/gate-evidence.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Gate Evidence (uplift 1.4) — binds a deliver mission's gate outcomes to the
+ * exact commit they prove.
+ *
+ * A deliver mission ends with its gates green against some HEAD; that HEAD is
+ * the merge candidate a later ship action (git push / gh pr create/merge) will
+ * publish. This module records that pairing as
+ * `.uap/evidence/<candidateSha>.json` so the `evidence-bound-ship` enforcer can
+ * require, at ship time, proof that the gates passed for THIS commit — not for
+ * some earlier or later tree. Stale, missing, malformed, or SHA-mismatched
+ * evidence is rejected by the enforcer (fail closed).
+ *
+ * The artifact lives under `.uap/evidence/`, which enforcement-self-protect
+ * lists as a PROTECTED_TARGET with no agent carve-out (including
+ * interpreter-mediated writes): the deliver CLI (this module) writes it, an
+ * agent shell cannot. `.uap/` itself is git-ignored, so evidence is a local
+ * record, never committed payload.
+ *
+ * Writes are atomic (tmp + rename). The writer validates loudly — an
+ * unresolvable HEAD, a DIRTY TREE (the gates provably ran against something
+ * other than HEAD), or a malformed gate all throw; the deliver seam wraps the
+ * call fail-soft so evidence emission can never break a mission.
+ */
+import type { GateRung, RungResult } from './verifier-ladder.js';
+/** One gate's outcome, as recorded in the evidence artifact. */
+export interface GateOutcome {
+    /** Gate name, e.g. 'build', 'npm test' (bounded). */
+    name: string;
+    /** The exact command that ran, e.g. 'npm run build' (bounded). */
+    command: string;
+    /** Process exit code; 0 is the only passing value the enforcer accepts. */
+    exitCode: number;
+    /** Bounded tail of combined output (last OUTPUT_TAIL_MAX chars). */
+    outputTail: string;
+    /**
+     * ISO-8601 time the gate finished. Reconstructed from rung durations
+     * relative to the recording time (gates run back-to-back inside one ladder
+     * pass), NOT a measured wall-clock per gate — treat as approximate.
+     */
+    at: string;
+}
+/** The on-disk evidence artifact schema (version 1). */
+export interface GateEvidence {
+    version: 1;
+    /** Full commit SHA the gates prove — the merge candidate. */
+    candidateSha: string;
+    /** ISO-8601 time the evidence was recorded. */
+    recordedAt: string;
+    /** Deliver run id, when emitted from a deliver mission. */
+    runId?: string;
+    /**
+     * Gate-affecting env hatches (KNOWN_GATE_HATCHES) that were SET when the
+     * evidence was recorded. Audit value only — the enforcer does not act on it,
+     * but a reviewer reading the artifact can see the gates ran with e.g. the
+     * quality gate disabled.
+     */
+    hatches: string[];
+    gates: GateOutcome[];
+}
+/** Per-gate output tail bound (last-N characters). */
+export declare const OUTPUT_TAIL_MAX = 2000;
+/** Field bounds so a pathological gate cannot mint an unbounded artifact. */
+export declare const NAME_MAX = 200;
+export declare const COMMAND_MAX = 500;
+/** A mission never legitimately runs more gates than this. */
+export declare const MAX_GATES = 100;
+/**
+ * Environment variables that weaken or bypass a gate. Mirrors
+ * enforcement_self_protect.BYPASS_PATTERNS plus the documented per-gate
+ * hatches; recorded into the artifact (when set) for audit. Keep in sync with
+ * the enforcer list.
+ */
+export declare const KNOWN_GATE_HATCHES: readonly ["UAP_DELIVER_BYPASS", "UAP_ENFORCE_DELIVERY", "UAP_SELF_PROTECT_OFF", "UAP_NO_WORKTREE", "UAP_WORKDIR_SCOPE_OFF", "UAP_INFRA_PROTECT_OFF", "UAP_NO_REVIEW", "UAP_EVIDENCE_GATE_OFF", "UAP_EVIDENCE_MAX_AGE_HOURS", "UAP_QUALITY_GATE_OFF", "UAP_USER_VALIDATION", "UAP_DELIVER_NO_LOCK", "UAP_ALLOW_GATELESS_ROOT", "UAP_ORACLE_CONSISTENCY", "UAP_SCHEMA_DIFF_INLINE", "UAP_VISUAL_GATE_OFF", "UAP_DESIGN_GATE_OFF"];
+/**
+ * Resolve and validate the candidate SHA for `projectDir`.
+ *
+ * Throws (fails loudly) when HEAD cannot be resolved — not a repo, unborn
+ * branch, git missing — or when git answers with something that is not a
+ * commit SHA. Evidence written against a guessed SHA would prove nothing, so
+ * there is no silent fallback here.
+ */
+export declare function resolveCandidateSha(projectDir: string): string;
+/**
+ * Require the working tree to be CLEAN before evidence binds HEAD.
+ *
+ * Evidence claims "the gates passed for commit <sha>". If the tree carries
+ * uncommitted changes, the gates actually ran against HEAD-plus-delta and the
+ * claim is unprovable — the delta could be anything. The deliver flow this
+ * supports is therefore: commit the candidate, run `uap deliver` (baseline
+ * check goes green as alreadyDelivered), ship.
+ *
+ * `.uap/` is git-ignored, so the evidence write itself cannot dirty the tree
+ * — but the check runs BEFORE the write regardless.
+ *
+ * Throws with the offending porcelain lines when the tree is dirty.
+ */
+export declare function assertCleanTree(projectDir: string): void;
+/** Names of KNOWN_GATE_HATCHES set to a non-empty value right now. */
+export declare function activeGateHatches(env?: NodeJS.ProcessEnv): string[];
+/** Path of the evidence artifact for one candidate SHA. */
+export declare function gateEvidencePath(projectDir: string, sha: string): string;
+/** The slice of a DeliveryResult the evidence builder reads. */
+export interface GateEvidenceSource {
+    history: ReadonlyArray<{
+        passed: boolean;
+        gateResults: ReadonlyArray<RungResult>;
+    }>;
+    /** Baseline ladder results when the run short-circuited as alreadyDelivered
+     * (history is empty then — without this the evidence path dead-ends on the
+     * exact flow that must work: commit → deliver → ship). */
+    baselineGates?: ReadonlyArray<RungResult>;
+}
+/**
+ * Build the evidence gate list from a mission result.
+ *
+ * Source precedence: the LAST passing iteration (findLast semantics — evidence
+ * must describe the final passing tree, not an early pass the loop later
+ * regressed and repaired), else the baseline ladder run (alreadyDelivered),
+ * else an empty list (recordGateEvidence then refuses — zero gates prove
+ * nothing).
+ *
+ * Per-gate `at` is reconstructed: rungs carry durations but no wall-clock
+ * finish time, and they run back-to-back inside one ladder pass, so gate i's
+ * finish ≈ recordedAt − (durations of the gates after it). Approximate —
+ * honest ordering, not honest wall-clock.
+ */
+export declare function gateOutcomesFromResult(source: GateEvidenceSource, rungs: ReadonlyArray<Pick<GateRung, 'id' | 'command' | 'args'>>, recordedAt?: Date): GateOutcome[];
+/**
+ * Record gate evidence for the current HEAD of `projectDir`.
+ *
+ * @param projectDir working tree whose HEAD is the merge candidate
+ * @param gates      outcomes of the mission's gates (must be non-empty)
+ * @param opts.runId deliver run id to attribute the evidence to
+ * @returns the evidence artifact path
+ * @throws on an unresolvable/invalid HEAD, a DIRTY tree, a malformed gate, or
+ *         an empty list — the caller decides whether that is fatal (the
+ *         deliver seam wraps this fail-soft; the enforcer consumes only
+ *         well-formed artifacts).
+ */
+export declare function recordGateEvidence(projectDir: string, gates: GateOutcome[], opts?: {
+    runId?: string;
+}): string;
+//# sourceMappingURL=gate-evidence.d.ts.map

package/dist/delivery/gate-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-evidence.d.ts","sourceRoot":"","sources":["../../src/delivery/gate-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEjE,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,sDAAsD;AACtD,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,6EAA6E;AAC7E,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,8DAA8D;AAC9D,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iaAkBrB,CAAC;AAwBX;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAUxD;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAKhF;AA8BD,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;KAAE,CAAC,CAAC;IACpF;;8DAE0D;IAC1D,aAAa,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,EAC/D,UAAU,GAAE,IAAiB,GAC5B,WAAW,EAAE,CAkCf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAAE,EACpB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,MAAM,CAwBR"}

package/dist/delivery/gate-evidence.js

@@ -0,0 +1,239 @@
+/**
+ * Gate Evidence (uplift 1.4) — binds a deliver mission's gate outcomes to the
+ * exact commit they prove.
+ *
+ * A deliver mission ends with its gates green against some HEAD; that HEAD is
+ * the merge candidate a later ship action (git push / gh pr create/merge) will
+ * publish. This module records that pairing as
+ * `.uap/evidence/<candidateSha>.json` so the `evidence-bound-ship` enforcer can
+ * require, at ship time, proof that the gates passed for THIS commit — not for
+ * some earlier or later tree. Stale, missing, malformed, or SHA-mismatched
+ * evidence is rejected by the enforcer (fail closed).
+ *
+ * The artifact lives under `.uap/evidence/`, which enforcement-self-protect
+ * lists as a PROTECTED_TARGET with no agent carve-out (including
+ * interpreter-mediated writes): the deliver CLI (this module) writes it, an
+ * agent shell cannot. `.uap/` itself is git-ignored, so evidence is a local
+ * record, never committed payload.
+ *
+ * Writes are atomic (tmp + rename). The writer validates loudly — an
+ * unresolvable HEAD, a DIRTY TREE (the gates provably ran against something
+ * other than HEAD), or a malformed gate all throw; the deliver seam wraps the
+ * call fail-soft so evidence emission can never break a mission.
+ */
+import { execFileSync } from 'child_process';
+import { mkdirSync, renameSync, writeFileSync } from 'fs';
+import { join } from 'path';
+/** Per-gate output tail bound (last-N characters). */
+export const OUTPUT_TAIL_MAX = 2000;
+/** Field bounds so a pathological gate cannot mint an unbounded artifact. */
+export const NAME_MAX = 200;
+export const COMMAND_MAX = 500;
+/** A mission never legitimately runs more gates than this. */
+export const MAX_GATES = 100;
+/**
+ * Environment variables that weaken or bypass a gate. Mirrors
+ * enforcement_self_protect.BYPASS_PATTERNS plus the documented per-gate
+ * hatches; recorded into the artifact (when set) for audit. Keep in sync with
+ * the enforcer list.
+ */
+export const KNOWN_GATE_HATCHES = [
+    'UAP_DELIVER_BYPASS',
+    'UAP_ENFORCE_DELIVERY',
+    'UAP_SELF_PROTECT_OFF',
+    'UAP_NO_WORKTREE',
+    'UAP_WORKDIR_SCOPE_OFF',
+    'UAP_INFRA_PROTECT_OFF',
+    'UAP_NO_REVIEW',
+    'UAP_EVIDENCE_GATE_OFF',
+    'UAP_EVIDENCE_MAX_AGE_HOURS',
+    'UAP_QUALITY_GATE_OFF',
+    'UAP_USER_VALIDATION',
+    'UAP_DELIVER_NO_LOCK',
+    'UAP_ALLOW_GATELESS_ROOT',
+    'UAP_ORACLE_CONSISTENCY',
+    'UAP_SCHEMA_DIFF_INLINE',
+    'UAP_VISUAL_GATE_OFF',
+    'UAP_DESIGN_GATE_OFF',
+];
+const SHA_RE = /^[0-9a-f]{40}(?:[0-9a-f]{24})?$/; // sha1 (40) or sha256 (64)
+/** git exports repo-context vars into hook environments; strip them so the
+ * git calls below resolve against `projectDir`, never a hook's repo. */
+function cleanGitEnv() {
+    const env = { ...process.env };
+    for (const key of Object.keys(env)) {
+        if (key.startsWith('GIT_'))
+            delete env[key];
+    }
+    return env;
+}
+function git(projectDir, args) {
+    return execFileSync('git', args, {
+        cwd: projectDir,
+        encoding: 'utf-8',
+        timeout: 5000,
+        env: cleanGitEnv(),
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }).trim();
+}
+/**
+ * Resolve and validate the candidate SHA for `projectDir`.
+ *
+ * Throws (fails loudly) when HEAD cannot be resolved — not a repo, unborn
+ * branch, git missing — or when git answers with something that is not a
+ * commit SHA. Evidence written against a guessed SHA would prove nothing, so
+ * there is no silent fallback here.
+ */
+export function resolveCandidateSha(projectDir) {
+    const out = git(projectDir, ['rev-parse', '--verify', 'HEAD^{commit}']);
+    if (!SHA_RE.test(out)) {
+        throw new Error(`gate-evidence: git rev-parse returned a non-SHA: ${JSON.stringify(out.slice(0, 120))}`);
+    }
+    return out;
+}
+/**
+ * Require the working tree to be CLEAN before evidence binds HEAD.
+ *
+ * Evidence claims "the gates passed for commit <sha>". If the tree carries
+ * uncommitted changes, the gates actually ran against HEAD-plus-delta and the
+ * claim is unprovable — the delta could be anything. The deliver flow this
+ * supports is therefore: commit the candidate, run `uap deliver` (baseline
+ * check goes green as alreadyDelivered), ship.
+ *
+ * `.uap/` is git-ignored, so the evidence write itself cannot dirty the tree
+ * — but the check runs BEFORE the write regardless.
+ *
+ * Throws with the offending porcelain lines when the tree is dirty.
+ */
+export function assertCleanTree(projectDir) {
+    const status = git(projectDir, ['status', '--porcelain']);
+    if (status !== '') {
+        const sample = status.split('\n').slice(0, 10).join('; ');
+        throw new Error(`gate-evidence: refusing to bind HEAD with a dirty working tree — the gates ran ` +
+            `against uncommitted changes, which the artifact cannot prove (${sample}). ` +
+            'Commit the candidate first, then record evidence.');
+    }
+}
+/** Names of KNOWN_GATE_HATCHES set to a non-empty value right now. */
+export function activeGateHatches(env = process.env) {
+    return KNOWN_GATE_HATCHES.filter((name) => {
+        const v = env[name];
+        return typeof v === 'string' && v !== '';
+    }).sort();
+}
+/** Bound and validate one gate outcome; throws on a malformed entry. */
+function normalizeGate(g, index) {
+    if (!g || typeof g !== 'object') {
+        throw new Error(`gate-evidence: gate[${index}] is not an object`);
+    }
+    if (typeof g.name !== 'string' || g.name.trim() === '') {
+        throw new Error(`gate-evidence: gate[${index}] has no name`);
+    }
+    if (typeof g.command !== 'string' || g.command.trim() === '') {
+        throw new Error(`gate-evidence: gate[${index}] (${g.name}) has no command`);
+    }
+    if (!Number.isInteger(g.exitCode)) {
+        throw new Error(`gate-evidence: gate[${index}] (${g.name}) has a non-integer exitCode`);
+    }
+    if (typeof g.at !== 'string' || Number.isNaN(Date.parse(g.at))) {
+        throw new Error(`gate-evidence: gate[${index}] (${g.name}) has an unparseable timestamp`);
+    }
+    const tail = typeof g.outputTail === 'string' ? g.outputTail : '';
+    return {
+        name: g.name.slice(0, NAME_MAX),
+        command: g.command.slice(0, COMMAND_MAX),
+        exitCode: g.exitCode,
+        // Keep the SUFFIX: a rung's verdict line is at the end of its output.
+        outputTail: tail.slice(-OUTPUT_TAIL_MAX),
+        at: new Date(g.at).toISOString(),
+    };
+}
+/** Path of the evidence artifact for one candidate SHA. */
+export function gateEvidencePath(projectDir, sha) {
+    return join(projectDir, '.uap', 'evidence', `${sha}.json`);
+}
+/**
+ * Build the evidence gate list from a mission result.
+ *
+ * Source precedence: the LAST passing iteration (findLast semantics — evidence
+ * must describe the final passing tree, not an early pass the loop later
+ * regressed and repaired), else the baseline ladder run (alreadyDelivered),
+ * else an empty list (recordGateEvidence then refuses — zero gates prove
+ * nothing).
+ *
+ * Per-gate `at` is reconstructed: rungs carry durations but no wall-clock
+ * finish time, and they run back-to-back inside one ladder pass, so gate i's
+ * finish ≈ recordedAt − (durations of the gates after it). Approximate —
+ * honest ordering, not honest wall-clock.
+ */
+export function gateOutcomesFromResult(source, rungs, recordedAt = new Date()) {
+    let results;
+    for (let i = source.history.length - 1; i >= 0; i--) {
+        const rec = source.history[i];
+        if (rec.passed && rec.gateResults.length > 0) {
+            results = rec.gateResults;
+            break;
+        }
+    }
+    results ??= source.baselineGates;
+    if (!results)
+        return [];
+    const rungById = new Map(rungs.map((r) => [r.id, r]));
+    const ran = results.filter((r) => !r.skipped && r.exitCode !== null);
+    const base = recordedAt.getTime();
+    const outcomes = new Array(ran.length);
+    let suffixMs = 0;
+    for (let i = ran.length - 1; i >= 0; i--) {
+        const r = ran[i];
+        const rung = rungById.get(r.id);
+        outcomes[i] = {
+            name: r.name,
+            // The exact command when the rung is still resolvable; the gate name
+            // otherwise (redetected mid-loop rungs may not be in scope).
+            command: rung ? [rung.command, ...rung.args].join(' ') : r.name,
+            exitCode: r.exitCode,
+            outputTail: r.outputTail,
+            at: new Date(base - suffixMs).toISOString(),
+        };
+        suffixMs += r.durationMs;
+    }
+    return outcomes;
+}
+/**
+ * Record gate evidence for the current HEAD of `projectDir`.
+ *
+ * @param projectDir working tree whose HEAD is the merge candidate
+ * @param gates      outcomes of the mission's gates (must be non-empty)
+ * @param opts.runId deliver run id to attribute the evidence to
+ * @returns the evidence artifact path
+ * @throws on an unresolvable/invalid HEAD, a DIRTY tree, a malformed gate, or
+ *         an empty list — the caller decides whether that is fatal (the
+ *         deliver seam wraps this fail-soft; the enforcer consumes only
+ *         well-formed artifacts).
+ */
+export function recordGateEvidence(projectDir, gates, opts = {}) {
+    const sha = resolveCandidateSha(projectDir);
+    // BEFORE any write: evidence must bind exactly what the gates saw.
+    assertCleanTree(projectDir);
+    if (!Array.isArray(gates) || gates.length === 0) {
+        throw new Error('gate-evidence: refusing to record an artifact with zero gates — it would prove nothing');
+    }
+    const bounded = gates.slice(0, MAX_GATES).map(normalizeGate);
+    const evidence = {
+        version: 1,
+        candidateSha: sha,
+        recordedAt: new Date().toISOString(),
+        ...(opts.runId ? { runId: opts.runId.slice(0, 120) } : {}),
+        hatches: activeGateHatches(),
+        gates: bounded,
+    };
+    const path = gateEvidencePath(projectDir, sha);
+    mkdirSync(join(projectDir, '.uap', 'evidence'), { recursive: true });
+    // Atomic write: a crashed mission must never leave a half-written artifact —
+    // the enforcer would read it as malformed and block a legitimate ship.
+    const tmp = `${path}.tmp-${process.pid}`;
+    writeFileSync(tmp, JSON.stringify(evidence, null, 2) + '\n', 'utf-8');
+    renameSync(tmp, path);
+    return path;
+}
+//# sourceMappingURL=gate-evidence.js.map

package/dist/delivery/gate-evidence.js.map

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

package/dist/delivery/index.d.ts

@@ -30,6 +30,7 @@ export { InMemoryPracticeStore, FilePracticeStore, extractKeywords, distillPract
 export { exploreAndCommit, DEFAULT_STRATEGY_SEEDS, MAX_CANDIDATES, type CandidateResult, type ExplorationResult, type ExplorerConfig, type StrategySeed, } from './explorer.js';
 export { createModelJudge, extractJson, type Judge, type JudgeCandidate, type JudgeVerdict, } from './judge.js';
 export { createModelCritic, parseFixList, type Critic, type Critique, type CritiqueInput, } from './critic.js';
+export { recordGateEvidence, resolveCandidateSha, assertCleanTree, gateEvidencePath, gateOutcomesFromResult, activeGateHatches, KNOWN_GATE_HATCHES, OUTPUT_TAIL_MAX, type GateOutcome, type GateEvidence, type GateEvidenceSource, } from './gate-evidence.js';
 export { detectRungs, runLadder, runRung, formatFeedback, dockerCargoRung, type GateRung, type RungResult, type RungFailureReason, type LadderResult, type LadderOptions, } from './verifier-ladder.js';
 export { applyFileBlocks, applyFileBlocksWithRollback, parseFileBlocks, findProtectedTestFiles, isGateConfigBasename, isTestFilePath, type Applier, type ApplyOptions, type ApplyResult, type FileBlock, type RevertibleApply, } from './applier.js';
 export { planAutoOptimization, DELIVERY_COMPLEXITY_THRESHOLDS, type AutoPlan, type DeliveryComplexity, } from './auto-optimizer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE3H,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/delivery/index.js

@@ -30,6 +30,7 @@ export { InMemoryPracticeStore, FilePracticeStore, extractKeywords, distillPract
 export { exploreAndCommit, DEFAULT_STRATEGY_SEEDS, MAX_CANDIDATES, } from './explorer.js';
 export { createModelJudge, extractJson, } from './judge.js';
 export { createModelCritic, parseFixList, } from './critic.js';
+export { recordGateEvidence, resolveCandidateSha, assertCleanTree, gateEvidencePath, gateOutcomesFromResult, activeGateHatches, KNOWN_GATE_HATCHES, OUTPUT_TAIL_MAX, } from './gate-evidence.js';
 export { detectRungs, runLadder, runRung, formatFeedback, dockerCargoRung, } from './verifier-ladder.js';
 export { applyFileBlocks, applyFileBlocksWithRollback, parseFileBlocks, findProtectedTestFiles, isGateConfigBasename, isTestFilePath, } from './applier.js';
 export { planAutoOptimization, DELIVERY_COMPLEXITY_THRESHOLDS, } from './auto-optimizer.js';

package/dist/delivery/index.js.map

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

package/dist/evals/routing-corpus.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ROUTING CORPUS — loads the routable surfaces (patterns, droids, skills)
+ * into a uniform entry list for the routing eval harness.
+ *
+ * The eval measures whether each entry's description keeps it rank-1
+ * separable as the registry grows (agent-dev-team precedent: routing evals
+ * with planted traps, CI-enforced).
+ */
+export type RoutingKind = 'pattern' | 'droid' | 'skill';
+export interface RoutingEntry {
+    /** Unique key: "<kind>:<id>" — e.g. "pattern:12", "droid:qa-expert". */
+    key: string;
+    kind: RoutingKind;
+    /** Bare id within the kind (pattern id, droid/skill name). */
+    id: string;
+    name: string;
+    /** Text the ranker embeds: name + description (+ keywords for patterns). */
+    text: string;
+    /** True when a real frontmatter description was found (false = body fallback). */
+    hasDescription: boolean;
+    /** Repo-relative source path. */
+    source: string;
+}
+interface Frontmatter {
+    name?: string;
+    description?: string;
+}
+/** Minimal frontmatter parser — single-line `key: value` for name/description only. */
+export declare function parseFrontmatter(content: string): Frontmatter;
+/** First non-heading, non-empty body paragraph, for entries without a description. */
+export declare function bodyFallback(content: string, maxLen?: number): string;
+/** Load all (or selected) routing surfaces from a project directory. */
+export declare function loadRoutingCorpus(projectDir: string, kinds?: RoutingKind[]): RoutingEntry[];
+export {};
+//# sourceMappingURL=routing-corpus.d.ts.map

package/dist/evals/routing-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-corpus.d.ts","sourceRoot":"","sources":["../../src/evals/routing-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,cAAc,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAS7D;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CASlE;AA6GD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,WAAW,EAAkC,GACnD,YAAY,EAAE,CAWhB"}

package/dist/evals/routing-corpus.js

@@ -0,0 +1,142 @@
+/**
+ * ROUTING CORPUS — loads the routable surfaces (patterns, droids, skills)
+ * into a uniform entry list for the routing eval harness.
+ *
+ * The eval measures whether each entry's description keeps it rank-1
+ * separable as the registry grows (agent-dev-team precedent: routing evals
+ * with planted traps, CI-enforced).
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+/** Minimal frontmatter parser — single-line `key: value` for name/description only. */
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match)
+        return {};
+    const out = {};
+    for (const line of match[1].split(/\r?\n/)) {
+        const kv = line.match(/^(name|description):\s*(.+)$/);
+        if (kv)
+            out[kv[1]] = kv[2].trim();
+    }
+    return out;
+}
+/** First non-heading, non-empty body paragraph, for entries without a description. */
+export function bodyFallback(content, maxLen = 300) {
+    const body = content.replace(/^---\r?\n[\s\S]*?\r?\n---/, '');
+    for (const raw of body.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (line.length < 20)
+            continue;
+        if (line.startsWith('#') || line.startsWith('>') || line.startsWith('-') || line.startsWith('|'))
+            continue;
+        return line.slice(0, maxLen);
+    }
+    return '';
+}
+function loadPatterns(projectDir) {
+    const indexPath = join(projectDir, '.factory/patterns/index.json');
+    if (!existsSync(indexPath))
+        return [];
+    try {
+        const data = JSON.parse(readFileSync(indexPath, 'utf-8'));
+        return data.patterns.map((p) => ({
+            key: `pattern:${p.id}`,
+            kind: 'pattern',
+            id: String(p.id),
+            name: p.title,
+            text: `${p.title} ${p.category} ${(p.keywords ?? []).join(' ')}`,
+            hasDescription: true,
+            source: '.factory/patterns/index.json',
+        }));
+    }
+    catch (error) {
+        // A malformed index.json must fail loudly with context — swallowing it
+        // resurfaces later as a misleading "corpus is empty" error.
+        throw new Error(`failed to parse ${indexPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function loadMarkdownEntry(kind, filePath, source, fallbackName) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const fm = parseFrontmatter(content);
+    const name = fm.name ?? fallbackName;
+    const description = fm.description ?? bodyFallback(content);
+    if (!description)
+        return null; // unroutable: no text to embed at all
+    return {
+        key: `${kind}:${name}`,
+        kind,
+        id: name,
+        name,
+        text: `${name} ${description}`,
+        hasDescription: fm.description !== undefined,
+        source,
+    };
+}
+function loadDroids(projectDir) {
+    const dir = join(projectDir, '.factory/droids');
+    if (!existsSync(dir))
+        return [];
+    const entries = [];
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.md'))
+            continue;
+        const entry = loadMarkdownEntry('droid', join(dir, file), `.factory/droids/${file}`, file.replace(/\.md$/, ''));
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
+}
+function loadSkills(projectDir) {
+    const dir = join(projectDir, '.factory/skills');
+    if (!existsSync(dir))
+        return [];
+    const entries = [];
+    for (const item of readdirSync(dir)) {
+        const full = join(dir, item);
+        // throwIfNoEntry: a dangling symlink or vanished entry skips, not crashes.
+        const stat = statSync(full, { throwIfNoEntry: false });
+        if (!stat)
+            continue;
+        if (stat.isDirectory()) {
+            const skillFile = join(full, 'SKILL.md');
+            if (!existsSync(skillFile))
+                continue;
+            const entry = loadMarkdownEntry('skill', skillFile, `.factory/skills/${item}/SKILL.md`, item);
+            if (entry)
+                entries.push(entry);
+        }
+        else if (item.endsWith('.md') && item !== 'SKILL-TEMPLATE.md') {
+            const entry = loadMarkdownEntry('skill', full, `.factory/skills/${item}`, item.replace(/\.md$/, ''));
+            if (entry)
+                entries.push(entry);
+        }
+    }
+    return entries;
+}
+const LOADERS = {
+    pattern: loadPatterns,
+    droid: loadDroids,
+    skill: loadSkills,
+};
+/** Load all (or selected) routing surfaces from a project directory. */
+export function loadRoutingCorpus(projectDir, kinds = ['pattern', 'droid', 'skill']) {
+    const seen = new Set();
+    const entries = [];
+    for (const kind of kinds) {
+        for (const entry of LOADERS[kind](projectDir)) {
+            if (seen.has(entry.key))
+                continue; // e.g. duplicate droid name
+            seen.add(entry.key);
+            entries.push(entry);
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=routing-corpus.js.map

package/dist/evals/routing-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-corpus.js","sourceRoot":"","sources":["../../src/evals/routing-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAwB5B,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtD,IAAI,EAAE;YAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAsB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAM,GAAG,GAAG;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAC9D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;YAAE,SAAS;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3G,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,UAAkB;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAOvD,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,EAAE,SAAkB;YACxB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,KAAK;YACb,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAChE,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,8BAA8B;SACvC,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,4DAA4D;QAC5D,MAAM,IAAI,KAAK,CACb,mBAAmB,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAiB,EACjB,QAAgB,EAChB,MAAc,EACd,YAAoB;IAEpB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,YAAY,CAAC;IACrC,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC,CAAC,sCAAsC;IACrE,OAAO;QACL,GAAG,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE;QACtB,IAAI;QACJ,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,IAAI,EAAE,GAAG,IAAI,IAAI,WAAW,EAAE;QAC9B,cAAc,EAAE,EAAE,CAAC,WAAW,KAAK,SAAS;QAC5C,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG,iBAAiB,CAC7B,OAAO,EACP,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EACf,mBAAmB,IAAI,EAAE,EACzB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAC1B,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,2EAA2E;QAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,SAAS;YACrC,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,IAAI,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9F,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAChE,MAAM,KAAK,GAAG,iBAAiB,CAC7B,OAAO,EACP,IAAI,EACJ,mBAAmB,IAAI,EAAE,EACzB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAC1B,CAAC;YACF,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,GAAgE;IAC3E,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,QAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;IAEpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,4BAA4B;YAC/D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}