@telora/daemon 0.22.239 → 0.22.289

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

@@ -1,250 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 37 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/queries/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.
- *
- * Split out of `queries/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.
- *
- * Re-exported from `queries/deliveries.ts`, so both import paths resolve.
- *
- * @module queries/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. A timeout (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) {
-    const commandFailed = typeof result.exitCode === 'number' && result.exitCode !== 0 && result.timedOut !== true;
-    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),
-    };
-}
-/**
- * `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/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, now = () => new Date().toISOString()) {
-    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 : now(),
-            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;
-}
-//# sourceMappingURL=delivery-gate-state.js.map

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

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

package/dist/queries/delivery-write-discipline.d.ts

@@ -1,65 +0,0 @@
-/**
- * The write discipline of a delivery row (org_nodes, type delivery): one write at
- * a time per delivery, and the verification history key no writer may carry
- * stale.
- *
- * daemon_update_delivery_status applies a write unconditionally: the status it is
- * sent, and the WHOLE gate_state it is sent, with no version or expected status
- * and no merge. Every gate_state writer is a read-modify-write, so a writer that
- * read the row before another write landed overwrites that write with its own
- * snapshot. Two shapes of that loss matter:
- *
- *   - A review or hold writer that read an explicit-method verdict
- *     (verificationHistory.explicitOutcome) before its run's selection removed it
- *     carries the removed verdict back onto the row (carryVerificationHistory).
- *     After a restart that stale PASS governs review again. And a removal that
- *     read the row before a hold landed erases the hold.
- *   - An own-status writer that read `verify` plus a hold, and writes after review
- *     moved the delivery to done, moves done back to verify and restores the hold.
- *
- * No CAS is available without an edge change, and one daemon process owns a
- * product's delivery writes. So the discipline is daemon-side:
- *
- *   1. Serialized per delivery (serializeDeliveryWrite): every write through the
- *      single writer (queries/deliveries.ts) runs after the previous write for that
- *      delivery settled, FIFO, like the per-focus spawn-cooldown writes
- *      (spawn/spawn-cooldown.ts). A gate_state-bearing write reads the row FRESH
- *      inside that turn; a status-only write reads nothing (the hot path), but still
- *      queues, so it never lands between another writer's fresh read and its write.
- *   2. The explicit verdict is OWNED (withRowExplicitOutcome): only the
- *      explicit-outcome writers (verify/explicit-gate-outcome.ts) change
- *      verificationHistory.explicitOutcome, and they stamp only that key over the
- *      fresh gate_state. Every other gate_state write sends the FRESH row's value
- *      for it, never the one its own earlier read carried.
- *   3. An own-status write is non-regressing: it writes at the FRESH status, and
- *      writes nothing to a delivery that is done or cancelled
- *      (queries/deliveries.ts rewriteDeliveryGateStateAtOwnStatus).
- *
- * A leaf: no @telora/* value import, so the module-mock loader tests that mock
- * queries/shared.js around queries/deliveries.ts stay safe.
- *
- * @module queries/delivery-write-discipline
- */
-import { type DeliveryGateState } from './delivery-gate-state.js';
-/** Whether a delivery in `status` stopped cycling (done or cancelled). */
-export declare function isStoppedDeliveryStatus(status: string): boolean;
-/**
- * Run `task` after every earlier write for this delivery has settled -- at once
- * when none is in flight -- resolving/rejecting with it. A task must not itself
- * write the same delivery through a serialized writer: the chain is not
- * re-entrant, and it would wait on itself.
- */
-export declare function serializeDeliveryWrite<T>(deliveryId: string, task: () => Promise<T>): Promise<T>;
-/**
- * `outgoing` -- the gate_state a writer other than the explicit-outcome writers is
- * about to send -- with its explicit verdict REPLACED by the one the fresh row
- * holds (`rowGateState`): a verdict its earlier read carried is never sent, and a
- * verdict written since is kept. Returned unchanged when neither holds one. A
- * write to a stopped status (`targetStatus` done or cancelled) that carries none
- * stays as it is: that clear leaves the delivery no verdict, as it always did,
- * while one that carries a verdict still sends only the row's. Pure.
- */
-export declare function withRowExplicitOutcome(outgoing: DeliveryGateState | null, rowGateState: unknown, targetStatus: string): DeliveryGateState | null;
-/** Test-only: drop every write chain, as a daemon re-exec starts with none. */
-export declare function __resetDeliveryWriteChainsForTests(): void;
-//# sourceMappingURL=delivery-write-discipline.d.ts.map

package/dist/queries/delivery-write-discipline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery-write-discipline.d.ts","sourceRoot":"","sources":["../../src/queries/delivery-write-discipline.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAKlC,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/D;AASD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAShG;AAQD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAClC,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,MAAM,GACnB,iBAAiB,GAAG,IAAI,CAI1B;AAED,+EAA+E;AAC/E,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/queries/delivery-write-discipline.js

@@ -1,102 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/integration/delivery-gate-write-interleaving.test.ts,
-//   packages/daemon/src/integration/explicit-verdict-departure-during-removal.test.ts,
-//   packages/daemon/src/verify/verification-deps-default.test.ts
-// PINNED-BY-END
-/**
- * The write discipline of a delivery row (org_nodes, type delivery): one write at
- * a time per delivery, and the verification history key no writer may carry
- * stale.
- *
- * daemon_update_delivery_status applies a write unconditionally: the status it is
- * sent, and the WHOLE gate_state it is sent, with no version or expected status
- * and no merge. Every gate_state writer is a read-modify-write, so a writer that
- * read the row before another write landed overwrites that write with its own
- * snapshot. Two shapes of that loss matter:
- *
- *   - A review or hold writer that read an explicit-method verdict
- *     (verificationHistory.explicitOutcome) before its run's selection removed it
- *     carries the removed verdict back onto the row (carryVerificationHistory).
- *     After a restart that stale PASS governs review again. And a removal that
- *     read the row before a hold landed erases the hold.
- *   - An own-status writer that read `verify` plus a hold, and writes after review
- *     moved the delivery to done, moves done back to verify and restores the hold.
- *
- * No CAS is available without an edge change, and one daemon process owns a
- * product's delivery writes. So the discipline is daemon-side:
- *
- *   1. Serialized per delivery (serializeDeliveryWrite): every write through the
- *      single writer (queries/deliveries.ts) runs after the previous write for that
- *      delivery settled, FIFO, like the per-focus spawn-cooldown writes
- *      (spawn/spawn-cooldown.ts). A gate_state-bearing write reads the row FRESH
- *      inside that turn; a status-only write reads nothing (the hot path), but still
- *      queues, so it never lands between another writer's fresh read and its write.
- *   2. The explicit verdict is OWNED (withRowExplicitOutcome): only the
- *      explicit-outcome writers (verify/explicit-gate-outcome.ts) change
- *      verificationHistory.explicitOutcome, and they stamp only that key over the
- *      fresh gate_state. Every other gate_state write sends the FRESH row's value
- *      for it, never the one its own earlier read carried.
- *   3. An own-status write is non-regressing: it writes at the FRESH status, and
- *      writes nothing to a delivery that is done or cancelled
- *      (queries/deliveries.ts rewriteDeliveryGateStateAtOwnStatus).
- *
- * A leaf: no @telora/* value import, so the module-mock loader tests that mock
- * queries/shared.js around queries/deliveries.ts stay safe.
- *
- * @module queries/delivery-write-discipline
- */
-import { readVerificationHistory, stampExplicitGateOutcome, } from './delivery-gate-state.js';
-/** The statuses of a delivery that stopped cycling. Mirrors DELIVERY_STATUS.DONE / CANCELLED (the leaf rule above). */
-const STOPPED_STATUSES = new Set(['done', 'cancelled']);
-/** Whether a delivery in `status` stopped cycling (done or cancelled). */
-export function isStoppedDeliveryStatus(status) {
-    return STOPPED_STATUSES.has(status);
-}
-/**
- * Per-delivery write chain: each write for a delivery starts only after the
- * previous one SETTLED, so a writer's fresh read and its write are never split by
- * another write to that row.
- */
-const writeChains = new Map();
-/**
- * Run `task` after every earlier write for this delivery has settled -- at once
- * when none is in flight -- resolving/rejecting with it. A task must not itself
- * write the same delivery through a serialized writer: the chain is not
- * re-entrant, and it would wait on itself.
- */
-export function serializeDeliveryWrite(deliveryId, task) {
-    const prior = writeChains.get(deliveryId);
-    const run = prior ? prior.then(task) : task();
-    const settled = run.then(() => undefined, () => undefined);
-    writeChains.set(deliveryId, settled);
-    void settled.then(() => {
-        if (writeChains.get(deliveryId) === settled)
-            writeChains.delete(deliveryId);
-    });
-    return run;
-}
-/** Whether `gateState` itself carries an explicit verdict key (whatever its shape). Pure. */
-function carriesExplicitOutcome(gateState) {
-    const history = gateState?.verificationHistory;
-    return history !== null && typeof history === 'object' && Reflect.get(history, 'explicitOutcome') !== undefined;
-}
-/**
- * `outgoing` -- the gate_state a writer other than the explicit-outcome writers is
- * about to send -- with its explicit verdict REPLACED by the one the fresh row
- * holds (`rowGateState`): a verdict its earlier read carried is never sent, and a
- * verdict written since is kept. Returned unchanged when neither holds one. A
- * write to a stopped status (`targetStatus` done or cancelled) that carries none
- * stays as it is: that clear leaves the delivery no verdict, as it always did,
- * while one that carries a verdict still sends only the row's. Pure.
- */
-export function withRowExplicitOutcome(outgoing, rowGateState, targetStatus) {
-    const rowOutcome = readVerificationHistory(rowGateState).explicitOutcome;
-    if (!carriesExplicitOutcome(outgoing) && (rowOutcome === undefined || isStoppedDeliveryStatus(targetStatus)))
-        return outgoing;
-    return stampExplicitGateOutcome(outgoing, rowOutcome ?? null);
-}
-/** Test-only: drop every write chain, as a daemon re-exec starts with none. */
-export function __resetDeliveryWriteChainsForTests() {
-    writeChains.clear();
-}
-//# sourceMappingURL=delivery-write-discipline.js.map

package/dist/queries/delivery-write-discipline.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery-write-discipline.js","sourceRoot":"","sources":["../../src/queries/delivery-write-discipline.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,uFAAuF;AACvF,uFAAuF;AACvF,iEAAiE;AACjE,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,uHAAuH;AACvH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7E,0EAA0E;AAC1E,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAI,UAAkB,EAAE,IAAsB;IAClF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3D,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,OAAO;YAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6FAA6F;AAC7F,SAAS,sBAAsB,CAAC,SAAmC;IACjE,MAAM,OAAO,GAAY,SAAS,EAAE,mBAAmB,CAAC;IACxD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,SAAS,CAAC;AAClH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAkC,EAClC,YAAqB,EACrB,YAAoB;IAEpB,MAAM,UAAU,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC;IACzE,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,uBAAuB,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9H,OAAO,wBAAwB,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kCAAkC;IAChD,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/queries/directive-undelivered.d.ts

@@ -1,104 +0,0 @@
-/**
- * The focus's durable record of "I was owed a directive my session never
- * received", and its clear.
- *
- * WHY A RECORD AT ALL. When a directive delivery stopped because its target
- * session had ended, the only trace was a log warn. Nothing told a later reader
- * that the focus had been owed anything: on 2026-09-20 a compact and a
- * 13600-char body were written into a lead that had exited 433ms earlier, and
- * the human who looked 51 minutes later had no way to learn what was lost.
- *
- * WHY IT MUST NOT BE THE OPERATOR-STOP DROP. The listener's null-role branch
- * clears a pending directive and logs "dropped, not carried to resume" whatever
- * put it there. For an operator stop that is exactly right -- the stop is an
- * authoritative halt and the queued directive MUST NOT fire on resume, so
- * dropping is the correct disposal and there is nothing to record. For a session
- * that vanished mid-write it is a misdescription of an accident. One line
- * covering both is why the two could not be told apart.
- *
- * WHERE IT LIVES. focus_debug_artifacts, following
- * queries/focus-integration-conflict.ts exactly: one row per (focus,
- * section_kind), rendered on the focus Debug tab with its own "Updated ...",
- * readable through the focus-debug API, cleared by DELETING the row -- which is
- * the shape "until the focus is served again" wants. Critically it is read by
- * NOTHING in the machine's decision path, so recording a loss can never misroute
- * a delivery. It is a record for a reader.
- *
- * WHY NOT AN ESCALATION. An escalation is the residue of an attempt that failed
- * and needs a human act. This needs none: the debt clears itself the moment the
- * focus is served again. Filing one would manufacture an inbox item that can
- * only wait.
- *
- * SINCE-WHEN SURVIVES THE RE-RECORD. `updated_at` moves on every write, so a
- * focus losing directives repeatedly would always read "just now" and hide how
- * long it had been going. The content carries `Undelivered since:` explicitly
- * and a re-record READS the existing section and carries that value forward. A
- * failed read costs the ORIGINAL since-when, never the record itself.
- */
-import { type CallApiDeps } from './shared.js';
-/** The focus_debug_artifacts section the record lives in. */
-export declare const DIRECTIVE_UNDELIVERED_SECTION_KIND = "directive_undelivered";
-/** The line carrying the first-observed timestamp across re-records. */
-export declare const UNDELIVERED_SINCE_PREFIX = "Undelivered since: ";
-/** What was owed, to which session, and why it did not arrive. */
-export interface UndeliveredDirective {
-    /** 'coding' | 'review' -- which pass the focus was owed. */
-    sessionType: string;
-    /** The workflow stage whose directive this was, when known. */
-    originStageId: string | null;
-    /** Which write found the session gone. */
-    part: 'compact' | 'body';
-    /** Whether a /compact reached the session before the body did not. */
-    compactDelivered: boolean;
-    /** Size of the assembled body, when it had been assembled. */
-    contentLength: number | null;
-    /** The named reason the send reported (spawn/lead-send.ts). */
-    reason: string;
-    /** That reason as a readable clause. */
-    detail: string;
-    /** ISO timestamp of the attempt. */
-    attemptedAt: string;
-}
-/**
- * Render the human-facing record.
- *
- * Written for someone arriving cold, an hour later, asking "why has this focus
- * done nothing?" -- so it answers what was owed, to which session, why it did
- * not arrive, and what happens next, in that order. The first-observed
- * timestamp is the one line a re-record must find again, so it is emitted on
- * its own line with a fixed prefix (parseUndeliveredSince reads it back).
- */
-export declare function renderUndeliveredDirectiveArtifact(args: {
-    focusName: string;
-    undelivered: UndeliveredDirective;
-    since: string;
-}): string;
-/** The `Undelivered since:` value in a stored artifact, or null when absent. */
-export declare function parseUndeliveredSince(content: string | undefined): string | null;
-/**
- * Record that this focus was owed a directive its session never received,
- * carrying forward the first-observed timestamp when one is already on record.
- */
-export declare function recordUndeliveredDirective(args: {
-    focusId: string;
-    focusName: string;
-    undelivered: UndeliveredDirective;
-}, deps?: CallApiDeps): Promise<void>;
-/**
- * Whether this focus is still owed a directive its session never received.
- *
- * Read at daemon startup by the stage-watermark seeding: the in-memory
- * "already processed" watermark does not survive a restart, and the seeding
- * marks every active focus processed -- which would lose the re-offer of a
- * directive the focus is still owed. This record is the durable half of that
- * signal, and it is deleted the moment the focus is served, so it means exactly
- * "still owed" and not "was owed once".
- *
- * Throws on an unreadable API: the caller decides how to fail, and the seeding
- * fails SOFT (seeds as before) rather than leaving a focus re-offering forever
- * on a signal it could not read.
- */
-export declare function hasUndeliveredDirectiveRecord(focusId: string, deps?: CallApiDeps): Promise<boolean>;
-/** Clear the record. Idempotent: deleting a section that is not there is a no-op. */
-export declare function clearUndeliveredDirective(focusId: string, deps?: CallApiDeps): Promise<void>;
-//# sourceMappingURL=directive-undelivered.d.ts.map

package/dist/queries/directive-undelivered.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directive-undelivered.d.ts","sourceRoot":"","sources":["../../src/queries/directive-undelivered.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,6DAA6D;AAC7D,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAE1E,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,sEAAsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,oBAAoB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAmCT;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAShF;AASD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,oBAAoB,CAAA;CAAE,EAC/E,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,qFAAqF;AACrF,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf"}