@telora/daemon 0.22.245 → 0.22.289

package/dist/queries/delivery-gate-state/delivery-gate-state.js

@@ -0,0 +1,319 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: 45 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/queries/delivery-gate-state/delivery-gate-state.ts
+// PINNED-BY-END
+/**
+ * The shape of `org_nodes.gate_state` on a delivery row, plus the per-origin
+ * detail records that hang off it.
+ *
+ * Kept apart from `queries/deliveries/deliveries.ts` (which holds the API calls) because
+ * these are the vocabulary of the verify gate, not of any one query: the
+ * verification engine, the feedback/re-work path, the operator- and
+ * external-hold gates, and the stall detectors all read and write them. Keeping
+ * them here lets those modules depend on the gate's vocabulary without pulling
+ * in the query layer.
+ *
+ * The one rule that shapes every type below: each way the gate can hold a
+ * delivery gets its OWN key. A shell-command failure (`verification`), a
+ * declared-vs-achieved gap (`shortfallReconciliation`), an unvouchable evidence
+ * bundle (`evidenceUnavailable`), an operator hold, and an external dependency
+ * are distinct facts about distinct things, and a reader must be able to tell
+ * "the gate was blind" from "the work fell short" without inspecting fields.
+ *
+ * History: docs/daemon/history-platform.md (queries/delivery-gate-state/delivery-gate-state.ts).
+ *
+ * @module queries/delivery-gate-state/delivery-gate-state
+ */
+import { parseShortfallPark } from './shortfall-park-record.js';
+// ---------------------------------------------------------------------------
+// Verification history: read, carry forward, reset. Pure; no imports.
+// ---------------------------------------------------------------------------
+function asObject(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+/** Validate a signature run read from JSON (gate_state); null when malformed. Pure. */
+export function parseSignatureRun(raw) {
+    const r = asObject(raw);
+    if (!r)
+        return null;
+    const signature = typeof r.signature === 'string' && r.signature.length > 0
+        ? r.signature
+        : r.signature === null ? null : undefined;
+    if (signature === undefined)
+        return null;
+    if (typeof r.consecutive !== 'number' || !Number.isInteger(r.consecutive) || r.consecutive < 0)
+        return null;
+    const previousSignature = typeof r.previousSignature === 'string' ? r.previousSignature : null;
+    return { signature, previousSignature, consecutive: r.consecutive };
+}
+/** Validate a shortfall repeat record read from JSON; null when malformed. Pure. */
+export function parseShortfallRepeat(raw) {
+    const r = asObject(raw);
+    if (!r || typeof r.signature !== 'string' || typeof r.count !== 'number' || !Number.isFinite(r.count))
+        return null;
+    const commitSet = typeof r.commitSet === 'string' && r.commitSet !== '' ? r.commitSet : undefined;
+    return { signature: r.signature, count: r.count, ...(commitSet !== undefined ? { commitSet } : {}) };
+}
+/** A commit sha read from JSON; null when absent or malformed. Pure. */
+function parseSha(raw) {
+    return typeof raw === 'string' && raw.length > 0 ? raw : null;
+}
+/**
+ * The commit a verification run's command FAILED on, or null. Only a verdict
+ * about a tree counts: a non-zero exit at a known judged sha, or a run the timeout
+ * ended after it named failing tests. A timeout that rendered nothing (a kill, not
+ * a verdict), an unknown exit, or an in-place run with no judged sha is null.
+ * Pure; the one rule both the durable record and the in-memory guard apply.
+ */
+export function judgedFailedSha(result) {
+    if (result.timedOut === true)
+        return null;
+    // A run the timeout ended that had already named failing tests rendered a
+    // failure verdict (verify/deterministic-gate/timed-out-rendered-verdict.ts): its exit is null.
+    const commandFailed = (typeof result.exitCode === 'number' && result.exitCode !== 0) || result.renderedBeforeKill === 'failed';
+    return commandFailed ? parseSha(result.verifiedSha) : null;
+}
+/** The history records a gate_state holds LIVE (as the rejection it itself is). */
+function readLiveHistory(gate) {
+    const verification = asObject(gate?.verification);
+    const signatureRun = parseSignatureRun(verification?.signatureRun);
+    const shortfallRepeat = parseShortfallRepeat(asObject(gate?.shortfallReconciliation)?.repeat);
+    const failedAtSha = parseSha(verification?.failedAtSha);
+    return {
+        ...(signatureRun ? { signatureRun } : {}),
+        ...(shortfallRepeat ? { shortfallRepeat } : {}),
+        ...(failedAtSha ? { failedAtSha } : {}),
+    };
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((s) => typeof s === 'string');
+}
+/** A persisted gate verdict for exactly `sha`; null when absent, malformed, or about another commit. Pure. */
+function parseJudgedVerdict(raw, sha) {
+    const r = asObject(raw);
+    if (!r || r.sha !== sha || (r.outcome !== 'passed' && r.outcome !== 'failed'))
+        return null;
+    return {
+        outcome: r.outcome,
+        sha,
+        ...(r.outcome === 'failed' && typeof r.failedStage === 'string' && r.failedStage.length > 0 ? { failedStage: r.failedStage } : {}),
+        ...(isStringArray(r.preExistingStages) && r.preExistingStages.length > 0 ? { preExistingStages: [...r.preExistingStages] } : {}),
+    };
+}
+/** Validate a judged-commit record read from JSON; null when malformed. Pure. */
+function parseJudgedCommit(raw) {
+    const r = asObject(raw);
+    const sha = parseSha(r?.sha);
+    if (!sha || typeof r?.judgedAt !== 'string')
+        return null;
+    const gateVerdict = parseJudgedVerdict(r.gateVerdict, sha);
+    return { sha, judgedAt: r.judgedAt, ...(gateVerdict ? { gateVerdict } : {}) };
+}
+/** Validate an explicit-method verdict read from JSON; null when malformed. Pure. */
+function parseExplicitOutcome(raw) {
+    const r = asObject(raw);
+    if (!r || (r.outcome !== 'passed' && r.outcome !== 'failed') || typeof r.recordedAt !== 'string')
+        return null;
+    const sha = parseSha(r.sha);
+    if (sha === null && r.sha !== null)
+        return null;
+    const gateKey = typeof r.gateKey === 'string' && r.gateKey !== '' ? r.gateKey : undefined;
+    const runId = typeof r.runId === 'string' && r.runId !== '' ? r.runId : undefined;
+    return {
+        outcome: r.outcome, sha, ...(gateKey !== undefined ? { gateKey } : {}), recordedAt: r.recordedAt, ...(runId !== undefined ? { runId } : {}),
+    };
+}
+/**
+ * The verification history a delivery's gate_state carries, whether live (the
+ * gate IS a rejection: `verification.signatureRun`,
+ * `shortfallReconciliation.repeat`) or carried (`verificationHistory`). A live
+ * record wins over the carried copy of the same kind. `judgedCommit`,
+ * `shortfallPark` and `explicitOutcome` are only ever carried (their writers stamp them there). Returns `{}` for null,
+ * malformed, or history-free gate_state. Defensive over the loosely typed JSONB.
+ * Pure.
+ */
+export function readVerificationHistory(gateState) {
+    const gate = asObject(gateState);
+    const carried = asObject(gate?.verificationHistory);
+    const signatureRun = parseSignatureRun(carried?.signatureRun);
+    const shortfallRepeat = parseShortfallRepeat(carried?.shortfallRepeat);
+    const failedAtSha = parseSha(carried?.failedAtSha);
+    const judgedCommit = parseJudgedCommit(carried?.judgedCommit);
+    const explicitOutcome = parseExplicitOutcome(carried?.explicitOutcome);
+    const shortfallPark = parseShortfallPark(carried?.shortfallPark);
+    return {
+        ...(signatureRun ? { signatureRun } : {}),
+        ...(shortfallRepeat ? { shortfallRepeat } : {}),
+        ...(failedAtSha ? { failedAtSha } : {}),
+        ...(judgedCommit ? { judgedCommit } : {}),
+        ...(explicitOutcome ? { explicitOutcome } : {}),
+        ...(shortfallPark ? { shortfallPark } : {}),
+        ...readLiveHistory(gate),
+    };
+}
+/** The standing park a gate_state carries, or null (none, malformed, or a verify pass dropped it). Pure. */
+export function readShortfallPark(gateState) {
+    return readVerificationHistory(gateState).shortfallPark ?? null;
+}
+/**
+ * `gateState` with its judged commit REPLACED: set to `sha` (judged at
+ * `judgedAt`) when the run judged a commit, removed when it judged none, so a
+ * re-work never leaves an older judgment standing for a newer run. `gateVerdict`
+ * is persisted beside the sha only when it is a verdict for that same sha. The
+ * rest of the history is untouched; an emptied history key is dropped. Pure.
+ */
+export function stampJudgedCommit(gateState, sha, judgedAt, gateVerdict) {
+    const history = { ...(gateState.verificationHistory ?? {}) };
+    delete history.judgedCommit;
+    if (sha)
+        history.judgedCommit = { sha, judgedAt, ...(gateVerdict?.sha === sha ? { gateVerdict } : {}) };
+    const next = { ...gateState };
+    delete next.verificationHistory;
+    return Object.keys(history).length > 0 ? { ...next, verificationHistory: history } : next;
+}
+/**
+ * `gateState` with its explicit-method verdict REPLACED: set to `outcome` when
+ * the run rendered one, removed when it rendered none
+ * (verify/gate-verdicts/explicit-gate-outcome.ts). Every other key and the rest of the history
+ * are untouched; an emptied history key is dropped, and a gate left holding
+ * nothing is null. A verdict stamped on a null gate_state rides beside an EMPTY
+ * `blocking` array, like carried history. Pure.
+ */
+export function stampExplicitGateOutcome(gateState, outcome) {
+    const gate = asObject(gateState);
+    let next;
+    if (gate)
+        next = { ...gate };
+    else if (outcome)
+        next = { blocking: [], warnings: [], evaluatedAt: outcome.recordedAt };
+    else
+        return null;
+    const history = { ...(next.verificationHistory ?? {}) };
+    delete history.explicitOutcome;
+    if (outcome)
+        history.explicitOutcome = outcome;
+    delete next.verificationHistory;
+    if (Object.keys(history).length > 0)
+        next.verificationHistory = history;
+    return isEmptyClear(next) ? null : next;
+}
+export function carryVerificationHistory(prior, next = null) {
+    const live = readLiveHistory(asObject(next));
+    const history = { ...readVerificationHistory(prior), ...readVerificationHistory(next) };
+    if (live.signatureRun)
+        delete history.signatureRun;
+    if (live.shortfallRepeat)
+        delete history.shortfallRepeat;
+    if (live.failedAtSha)
+        delete history.failedAtSha;
+    const hasHistory = history.signatureRun !== undefined || history.shortfallRepeat !== undefined
+        || history.failedAtSha !== undefined || history.judgedCommit !== undefined || history.explicitOutcome !== undefined
+        || history.shortfallPark !== undefined;
+    if (next === null) {
+        if (!hasHistory)
+            return null;
+        const priorEvaluatedAt = asObject(prior)?.evaluatedAt;
+        return {
+            blocking: [],
+            warnings: [],
+            evaluatedAt: typeof priorEvaluatedAt === 'string' ? priorEvaluatedAt : new Date().toISOString(),
+            verificationHistory: history,
+        };
+    }
+    const carried = { ...next };
+    delete carried.verificationHistory;
+    return hasHistory ? { ...carried, verificationHistory: history } : carried;
+}
+/**
+ * A gate_state with its verification history RESET, which is what a verify PASS
+ * leaves. Drops the carried copy (a standing shortfall park with it) and the
+ * live run/repeat records so the next rejection starts a fresh count. Returns null when what remains is an empty
+ * clear (no guard verdict, no warning, no hold), so a history-only gate goes
+ * back to null. Every other key (holds, a live verdict's detail) is preserved.
+ * Pure.
+ */
+export function clearVerificationHistory(gateState) {
+    if (!gateState)
+        return null;
+    const next = { ...gateState };
+    delete next.verificationHistory;
+    if (next.verification) {
+        const verification = { ...next.verification };
+        delete verification.signatureRun;
+        delete verification.failedAtSha;
+        next.verification = verification;
+    }
+    if (next.shortfallReconciliation) {
+        const shortfall = { ...next.shortfallReconciliation };
+        delete shortfall.repeat;
+        next.shortfallReconciliation = shortfall;
+    }
+    return isEmptyClear(next) ? null : next;
+}
+/** Whether a gate_state is an empty clear: no guard verdict, no warning, no other key. Pure. */
+export function isEmptyClear(gate) {
+    return Object.keys(gate).every((k) => k === 'blocking' || k === 'warnings' || k === 'evaluatedAt') &&
+        (gate.blocking?.length ?? 0) === 0 &&
+        (gate.warnings?.length ?? 0) === 0;
+}
+/**
+ * The signature run recorded on a delivery's LATEST deterministic rejection
+ * (gate_state.verification), or null when none is usable: no verification
+ * detail (a guard-only, shortfall or evidence-unavailable gate_state), a legacy
+ * row written before signatures existed, or an underivable (null) signature.
+ * The stall detector falls back to the iteration cap on null. Pure.
+ */
+export function readRecordedSignatureRun(gateState) {
+    if (gateState == null || typeof gateState !== 'object')
+        return null;
+    const verification = gateState.verification;
+    if (verification == null || typeof verification !== 'object')
+        return null;
+    const v = verification;
+    if (typeof v.failureSignature !== 'string' || v.failureSignature.length === 0)
+        return null;
+    const run = parseSignatureRun(v.signatureRun);
+    if (!run || run.signature !== v.failureSignature || run.consecutive < 1)
+        return null;
+    return { signature: run.signature, consecutive: run.consecutive };
+}
+/**
+ * The `Timeout applied: <ms>ms from <source>` line for a timeout fault that
+ * recorded its applied timeout, else null.
+ *
+ * One formatter so the team inject message and the verify_gate_unclearable
+ * escalation print the identical line: a reader who sees it in one place can grep
+ * for it in the other. Null for every other hold, so those bodies stay unchanged.
+ */
+export function formatTimeoutAppliedLine(fault) {
+    if (fault?.kind !== 'timeout' || typeof fault.timeoutMs !== 'number')
+        return null;
+    return `Timeout applied: ${fault.timeoutMs}ms from ${fault.timeoutSource ?? 'an unrecorded source'}`;
+}
+/**
+ * Read a timeout fault that recorded its applied timeout out of an untyped
+ * gate_state (FocusDeliveryInfo.gateState is `unknown`), or undefined. Defensive
+ * at every level: a legacy or foreign gate_state shape reads as "no timeout fault",
+ * never a throw.
+ */
+export function readTimeoutFault(gateState) {
+    if (gateState == null || typeof gateState !== 'object')
+        return undefined;
+    const held = gateState.evidenceUnavailable;
+    if (held == null || typeof held !== 'object')
+        return undefined;
+    const fault = held.deterministicFault;
+    if (fault == null || typeof fault !== 'object')
+        return undefined;
+    const f = fault;
+    if (f.kind !== 'timeout' || typeof f.timeoutMs !== 'number')
+        return undefined;
+    return {
+        kind: 'timeout',
+        exitCode: typeof f.exitCode === 'number' ? f.exitCode : null,
+        timeoutMs: f.timeoutMs,
+        ...(typeof f.timeoutSource === 'string' ? { timeoutSource: f.timeoutSource } : {}),
+    };
+}
+//# sourceMappingURL=delivery-gate-state.js.map

package/dist/queries/delivery-gate-state/delivery-gate-state.js.map

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

package/dist/queries/delivery-gate-state/misattributed-commits-record.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The misattributed-commits note a verify hold carries in gate_state (a
+ * shortfall reconciliation or an evidence-unavailable hold).
+ *
+ * A LEAF with no imports: queries/delivery-gate-state/delivery-gate-state.ts types its key with it; the
+ * detector that builds it lives in verify/attribution/misattributed-commits.ts.
+ *
+ * @module queries/delivery-gate-state/misattributed-commits-record
+ */
+/**
+ * Commits in the focus's recorded batches that may hold a held delivery's work
+ * without being attributed to it (trailered `none`, `unattributed`, or not at
+ * all), named on a hold so misattributed work reads differently from missing
+ * work (verify/attribution/misattributed-commits.ts). `scope` says whether they were matched
+ * against the files the delivery concerns or, with none recorded, listed unscoped.
+ */
+export interface MisattributedCommitsRecord {
+    scope: 'files' | 'unscoped';
+    commits: Array<{
+        sha: string;
+        subject: string;
+        trailer: 'sentinel' | 'unattributed' | 'unattributed_capture';
+        files: string[];
+    }>;
+}
+//# sourceMappingURL=misattributed-commits-record.d.ts.map

package/dist/queries/delivery-gate-state/misattributed-commits-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misattributed-commits-record.d.ts","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/misattributed-commits-record.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,UAAU,GAAG,cAAc,GAAG,sBAAsB,CAAC;QAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;CACJ"}

package/dist/queries/delivery-gate-state/misattributed-commits-record.js

@@ -0,0 +1,5 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/verify/attribution/misattributed-hold.test.ts
+// PINNED-BY-END
+export {};
+//# sourceMappingURL=misattributed-commits-record.js.map

package/dist/queries/delivery-gate-state/misattributed-commits-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misattributed-commits-record.js","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/misattributed-commits-record.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+EAA+E;AAC/E,gBAAgB"}

package/dist/queries/delivery-gate-state/recorded-targets-record.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The RECORDED-TARGETS record carried on a delivery's gate_state
+ * (gate_state.recordedTargets), and its defensive JSON parse.
+ *
+ * A LEAF with no imports: queries/delivery-gate-state/delivery-gate-state.ts names the key on
+ * DeliveryGateState, and verify/effect-reconciliation/recorded-targets.ts reads,
+ * stamps and durably writes it -- so neither of those files needs the other.
+ *
+ * WHAT IT RECORDS. An arm covers the effects the focus held when the human said
+ * go. A target added to an in-flight injection after that is not owed work: the
+ * verify reconciliation sets it aside, and it produces no shortfall, no hold and
+ * no re-work issue (verify/effect-reconciliation/verify-restatement.ts narrowToArmCoverage). But set
+ * aside is not the same as never seen, and until this record the difference lived
+ * only in the daemon log: nothing an operator or a later pass could read told a
+ * gate that DECLINED to judge a target from one that never saw it. A gate that
+ * sets work aside without recording it is indistinguishable from a gate that
+ * missed it.
+ *
+ * Its OWN key, for the reason every other origin on gate_state has one: a reader
+ * must be able to tell "recorded, waiting for the next arm" from "held". It is a
+ * RECORD, never a hold -- no guard verdict, no entry in `blocking`, and nothing
+ * completion/stall-escalations/event-escalations.ts hasLiveGateBlock reads -- so it blocks nothing,
+ * and it clears with the rest of the gate when the delivery finally routes.
+ *
+ * @module queries/delivery-gate-state/recorded-targets-record
+ */
+/**
+ * The targets a verify run did NOT hold its delivery to, because the focus's arm
+ * did not cover them. They run on the next arm.
+ */
+export interface RecordedTargetsRecord {
+    /** The injection whose targets these are; null when the run named none. */
+    injectionNodeId: string | null;
+    /** The recorded target node ids, in the order the reconciliation reported them. */
+    nodeIds: string[];
+    /** ISO timestamp of the verify run that recorded them. */
+    recordedAt: string;
+}
+/**
+ * Validate a recorded-targets record read from JSON (gate_state); null when
+ * absent or malformed. An EMPTY node set is not a record -- a run that set
+ * nothing aside records nothing, so reading one back as a record would report a
+ * narrowing that never happened. Pure.
+ */
+export declare function parseRecordedTargets(raw: unknown): RecordedTargetsRecord | null;
+//# sourceMappingURL=recorded-targets-record.d.ts.map

package/dist/queries/delivery-gate-state/recorded-targets-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded-targets-record.d.ts","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/recorded-targets-record.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,GAAG,IAAI,CAU/E"}

package/dist/queries/delivery-gate-state/recorded-targets-record.js

@@ -0,0 +1,29 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/verify/effect-reconciliation/recorded-targets.test.ts
+// PINNED-BY-END
+function asRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+/**
+ * Validate a recorded-targets record read from JSON (gate_state); null when
+ * absent or malformed. An EMPTY node set is not a record -- a run that set
+ * nothing aside records nothing, so reading one back as a record would report a
+ * narrowing that never happened. Pure.
+ */
+export function parseRecordedTargets(raw) {
+    const r = asRecord(raw);
+    if (!r || typeof r.recordedAt !== 'string' || r.recordedAt === '')
+        return null;
+    if (!Array.isArray(r.nodeIds) || r.nodeIds.length === 0)
+        return null;
+    if (!r.nodeIds.every((n) => typeof n === 'string' && n !== ''))
+        return null;
+    return {
+        injectionNodeId: typeof r.injectionNodeId === 'string' && r.injectionNodeId !== '' ? r.injectionNodeId : null,
+        nodeIds: [...r.nodeIds],
+        recordedAt: r.recordedAt,
+    };
+}
+//# sourceMappingURL=recorded-targets-record.js.map

package/dist/queries/delivery-gate-state/recorded-targets-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded-targets-record.js","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/recorded-targets-record.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,uFAAuF;AACvF,gBAAgB;AA0ChB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACxE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;QAC7G,OAAO,EAAE,CAAC,GAAI,CAAC,CAAC,OAAoB,CAAC;QACrC,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC;AACJ,CAAC"}

package/dist/queries/delivery-gate-state/shortfall-park-record.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The durable SHORTFALL PARK record carried in a delivery's gate_state
+ * (verificationHistory.shortfallPark), and its defensive JSON parse.
+ *
+ * A LEAF with no imports: queries/delivery-gate-state/delivery-gate-state.ts types its key with it
+ * and calls the parser, so the record rides every carry / reset rule that file owns
+ * without an import cycle. The classifier that WRITES it, and the release rule
+ * later readers apply, live in verify/shortfalls/shortfall-park.ts.
+ *
+ * @module queries/delivery-gate-state/shortfall-park-record
+ */
+/**
+ * A delivery PARKED on a repeating verify shortfall: the identical shortfall
+ * signature re-held on an unchanged delivery-trailered commit set enough times
+ * (verify/shortfalls/shortfall-park.ts SHORTFALL_PARK_REPEAT_LIMIT) that sending it back to
+ * coding again cannot change the verdict. History, not a verdict: it survives
+ * every clearing or replacing gate_state writer (carryVerificationHistory) and
+ * only a verify PASS drops it (clearVerificationHistory), so a writer that
+ * rewrites the live gate -- a review exit, a same-status hold -- cannot erase it.
+ */
+export interface ShortfallPark {
+    /** The shortfall signature that repeated (verify/shortfalls/shortfall-repeat.ts shortfallSignature). */
+    signature: string;
+    /**
+     * Fingerprint of the delivery-trailered commit set the repeats were judged on
+     * (verify/shortfalls/shortfall-park.ts commitSetFingerprint). null when the set could not
+     * be read at any judgement that parked it: such a park is not released by a
+     * commit-set change (there is nothing to compare against) until a later
+     * judgement fills it in; a ruling or a verify pass still releases it.
+     */
+    commitSet: string | null;
+    /** The tree node ids the repeated shortfall names, sorted and unique. */
+    nodeIds: string[];
+    /** Consecutive identical judgements on this commit set (>= the limit once parked; keeps counting on re-holds). */
+    count: number;
+    /** ISO timestamp of the judgement that FIRST parked it; kept on every re-hold. */
+    parkedAt: string;
+    /**
+     * The fingerprint of the operator rulings (queries/verification/shortfall-rulings.ts) the
+     * judgement that parked or last re-held it applied. A ruling recorded since
+     * changes the current fingerprint and releases it (verify/shortfalls/shortfall-park.ts
+     * isShortfallParkReleased). PRESENT means the rulings were READ then -- `''` is
+     * a succeeded read of an EMPTY ruling set ("no ruling was in force"), which is
+     * a known fact. ABSENT means they could NOT be read (or the record predates
+     * that rule), so nothing is known about what was in force; a reader that must
+     * not answer from an unknown history refuses such a park
+     * (verify/shortfalls/parked-shortfall-reuse.ts).
+     */
+    rulingsFingerprint?: string;
+}
+/** Validate a shortfall park read from JSON (gate_state); null when absent or malformed. Pure. */
+export declare function parseShortfallPark(raw: unknown): ShortfallPark | null;
+//# sourceMappingURL=shortfall-park-record.d.ts.map

package/dist/queries/delivery-gate-state/shortfall-park-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortfall-park-record.d.ts","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/shortfall-park-record.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,wGAAwG;IACxG,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kHAAkH;IAClH,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAgBrE"}

package/dist/queries/delivery-gate-state/shortfall-park-record.js

@@ -0,0 +1,39 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/review-exit-holds/review-exit-shortfall-park.test.ts,
+//   packages/daemon/src/focus/parked-shortfall-spawn.test.ts,
+//   packages/daemon/src/focus/verify-routing-passes.test.ts,
+//   packages/daemon/src/integration/shortfall-park-incident-regression.test.ts,
+//   packages/daemon/src/prompt-sections/prompt-listing.test.ts,
+//   packages/daemon/src/spawn/review-hold-park-shortfall.test.ts,
+//   packages/daemon/src/verify/shortfalls/shortfall-park-escalation.test.ts,
+//   packages/daemon/src/verify/shortfalls/shortfall-park.test.ts,
+//   packages/daemon/src/verify/shortfalls/shortfall-rulings.test.ts
+// PINNED-BY-END
+function asRecord(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+/** Validate a shortfall park read from JSON (gate_state); null when absent or malformed. Pure. */
+export function parseShortfallPark(raw) {
+    const r = asRecord(raw);
+    if (!r || typeof r.signature !== 'string' || typeof r.parkedAt !== 'string')
+        return null;
+    if (typeof r.count !== 'number' || !Number.isInteger(r.count) || r.count < 1)
+        return null;
+    if (!Array.isArray(r.nodeIds) || !r.nodeIds.every((n) => typeof n === 'string'))
+        return null;
+    const commitSet = typeof r.commitSet === 'string' && r.commitSet !== '' ? r.commitSet : null;
+    if (commitSet === null && r.commitSet !== null && r.commitSet !== undefined)
+        return null;
+    const rulingsFingerprint = typeof r.rulingsFingerprint === 'string' ? r.rulingsFingerprint : undefined;
+    return {
+        signature: r.signature,
+        commitSet,
+        nodeIds: [...r.nodeIds],
+        count: r.count,
+        parkedAt: r.parkedAt,
+        ...(rulingsFingerprint !== undefined ? { rulingsFingerprint } : {}),
+    };
+}
+//# sourceMappingURL=shortfall-park-record.js.map

package/dist/queries/delivery-gate-state/shortfall-park-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortfall-park-record.js","sourceRoot":"","sources":["../../../src/queries/delivery-gate-state/shortfall-park-record.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,kGAAkG;AAClG,8DAA8D;AAC9D,6DAA6D;AAC7D,gFAAgF;AAChF,gEAAgE;AAChE,kEAAkE;AAClE,6EAA6E;AAC7E,kEAAkE;AAClE,oEAAoE;AACpE,gBAAgB;AAsDhB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACxE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzF,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7F,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzF,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS;QACT,OAAO,EAAE,CAAC,GAAI,CAAC,CAAC,OAAoB,CAAC;QACrC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC"}