@telora/daemon 0.20.60 → 0.20.89

package/dist/queries/deliveries.js

@@ -291,6 +291,32 @@ export async function recordFocusMerge(params) {
         },
     });
 }
+/**
+ * Fetch the RECORDED constituent commit shas for a delivery's merge, keyed by
+ * the merge_commit_sha the delivery row carries.
+ *
+ * Reads focus_merges (via focus_merge_list) -- the durable record the daemon
+ * wrote at merge time (extractConstituentCommits -> recordFocusMerge) -- and
+ * returns the commit_shas of the row whose merge_commit_sha matches. This is the
+ * exact attribution, immune to the fast-forward + rebase failures that corrupt a
+ * range re-derived from live branch topology at verify time.
+ *
+ * Returns [] when the focus/merge is unknown or the API action is unavailable
+ * (best-effort): the verify diff resolver then falls through to its
+ * live-topology sources rather than blocking.
+ */
+export async function getRecordedCommitShasForMerge(focusId, mergeCommitSha) {
+    try {
+        const result = await callApi('focus_merge_list', { focusId, limit: 500 });
+        const row = (result.merges ?? []).find((m) => m.mergeCommitSha === mergeCommitSha);
+        return row?.commitShas ?? [];
+    }
+    catch (err) {
+        log.debug(`[focusMerge] commit_shas lookup unavailable for focus ${focusId.slice(0, 8)}: ` +
+            `${err.message}`);
+        return [];
+    }
+}
 /**
  * Track consecutive failures per delivery to detect systematic issues.
  * After FAILURE_THRESHOLD consecutive failures, log at ERROR level.

package/dist/queries/deliveries.js.map

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

package/dist/queries/delivery-gate-state.d.ts

@@ -0,0 +1,192 @@
+/**
+ * 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
+ */
+/**
+ * Detail attached to gate_state when a daemon-side deterministic verification
+ * run fails. Carries the failing-test names (parsed from the run output) and a
+ * pointer to the persistent full-log file so the feedback loop -- dashboard
+ * "Waiting on", live-session inject, and the requeue/respawn prompt -- can
+ * surface WHAT failed and WHERE to read it, without a cold re-run.
+ */
+export interface VerificationFailureDetail {
+    /**
+     * Failing-test ids that GATE this delivery. When baseline-diff attribution ran,
+     * these are the NEW failures the focus introduced; otherwise all parsed failures.
+     */
+    failingTests: string[];
+    /**
+     * Failing tests that pre-exist on the focus base -- recorded, non-blocking
+     * (they do not gate the focus). Absent when attribution did not run.
+     */
+    preExisting?: string[];
+    /** Absolute path to the persistent full-log file, or null when none was written. */
+    logPath: string | null;
+    /** Process exit code of the failed run, or null. */
+    exitCode: number | null;
+    /** ISO timestamp of the failing run. */
+    failedAt: string;
+}
+/**
+ * Detail attached to gate_state when the verify-shortfall RECONCILIATION (not a
+ * deterministic shell run) holds the flip: the achieved outcome fell short of
+ * the declared desired effect for one or more targeted nodes. Distinct from
+ * VerificationFailureDetail on purpose -- a shortfall hold has no exitCode /
+ * failingTests (the deterministic check may well have passed), it has a
+ * declared-vs-achieved gap. Keeping it under its own key prevents a reader from
+ * seeing a passed:false deterministic_verification whose exitCode is 0.
+ */
+export interface ShortfallReconciliationDetail {
+    /** ISO timestamp of the reconciliation that held the gate. */
+    heldAt: string;
+    /** The per-target declared/achieved/reason gaps that withheld the flip. */
+    shortfalls: Array<{
+        nodeId: string;
+        declared: string;
+        achieved: string;
+        reason: string;
+        /** The diff evidence grounding the shortfall, when the judge cited one. */
+        diffCitation?: string;
+    }>;
+}
+/**
+ * Detail attached to gate_state when the verify path could NOT vouch for the
+ * evidence it was handed -- an INSTRUMENT FAULT, not a verdict about the work.
+ * Two flavours, both BLIND:
+ *   - EMPTY   : no diff / changed-files / inspection finding at all.
+ *   - INCOMPLETE (half-blind): a non-empty bundle whose resolved diff range does
+ *     NOT cover the delivery's recorded commit set, so a verdict would judge the
+ *     work against only part of it. `coverage` is populated in this case.
+ * Distinct from VerificationFailureDetail (a shell command failed) and from
+ * ShortfallReconciliationDetail (the work fell short of intent): here the
+ * reconciliation cannot see the whole delivery, so it must not render any
+ * verdict. The delivery is held in `verify` (never routed to verify_failed, so
+ * no iteration is consumed) and a first-occurrence escalation names the fault.
+ */
+export interface EvidenceUnavailableDetail {
+    /** ISO timestamp the instrument-fault hold was recorded. */
+    heldAt: string;
+    /** Which evidence slots were empty (named, so the hold describes the fault, not the work). */
+    missing: string[];
+    /**
+     * Commits the delivery branch is ahead of the integration base. 0 => the
+     * branch already merged / did no work; > 0 => a broken diff MEASUREMENT
+     * (commits present but the diff resolved empty). Carried for operator triage.
+     */
+    commitsAhead: number;
+    /**
+     * Populated for a HALF-BLIND (incomplete) hold: the resolved range covered
+     * only `covered` of the delivery's `recorded` commits. Absent for a plain
+     * empty-bundle hold, so the empty case is byte-unchanged.
+     */
+    coverage?: {
+        /** How many commits the durable record (focus_merges.commit_shas) names. */
+        recorded: number;
+        /** How many of those the resolved diff range actually covered. */
+        covered: number;
+    };
+}
+/**
+ * Shape written into product_deliveries.gate_state when guard evaluation
+ * blocks a stage transition. Cleared (set to null) when guards pass.
+ *
+ * `verification` is populated when the block is a daemon-side deterministic
+ * verification failure (Harness-Owned Delivery Verification), carrying the
+ * failing tests + log path for the feedback loop; absent for guard-only gates.
+ *
+ * `shortfallReconciliation` is populated when the block is a verify-shortfall
+ * reconciliation hold (declared-vs-achieved gap), NOT a deterministic run; the
+ * two are mutually exclusive origins and never share the deterministic guard.
+ */
+export interface DeliveryGateState {
+    blocking: Array<{
+        guardName: string;
+        passed: boolean;
+    }>;
+    warnings: Array<{
+        guardName: string;
+        passed: boolean;
+    }>;
+    evaluatedAt: string;
+    verification?: VerificationFailureDetail;
+    shortfallReconciliation?: ShortfallReconciliationDetail;
+    /**
+     * Populated when the verify path was handed no evidence it could judge the
+     * work against (an instrument fault). Kept under its own key -- never
+     * conflated with `verification` (a shell failure) or `shortfallReconciliation`
+     * (a work shortfall) -- so a reader can tell "the gate was blind" from "the
+     * work fell short". The blocking guard is `verify_evidence_unavailable`.
+     */
+    evidenceUnavailable?: EvidenceUnavailableDetail;
+    /**
+     * Undisposed shortfall drift proposal ids holding this delivery in verify.
+     *
+     * Kept OUT of `blocking` on purpose: that array is guard-verdict data
+     * (guardName + passed), and a shortfall hold is not a guard. Synthesizing a
+     * fake guardName to smuggle the ids through would make `blocking` lie about
+     * what a guard is. `formatGateBlockers` is the single place that merges the
+     * two for display.
+     *
+     * Absent for guard-only gates. Written by the review-exit shortfall hold and
+     * cleared, like the rest of gate_state, when the delivery finally routes.
+     */
+    shortfallProposalIds?: string[];
+    /**
+     * The open operator-blocked escalation (disposition needs_operator /
+     * external_wait, any kind) holding this delivery in verify. Written by the
+     * operator-hold gate (operator-hold.ts) so the board can name what the
+     * delivery is waiting on without a second escalation being filed; cleared,
+     * like the rest of gate_state, when the delivery finally routes. When the hold
+     * read itself failed (fail-closed), escalationId is null and readFailed is
+     * true -- the delivery is still held, just without a specific escalation to
+     * name. Like shortfallProposalIds, kept OUT of `blocking` (a hold is not a
+     * guard verdict).
+     */
+    operatorHold?: {
+        escalationId: string | null;
+        escalationKind: string | null;
+        disposition: string | null;
+        readFailed?: boolean;
+    };
+    /**
+     * An irreducibly-external dependency holding this delivery in verify, carried
+     * as durable STATE rather than an agent_escalations row (external-hold.ts).
+     * The blocking condition and what would clear it live here, attached to the
+     * delivery they block; the hold clears by re-evaluating that condition (a
+     * re-read of reality), not by a human resolving an inbox item. Kept OUT of
+     * `blocking` for the same reason as operatorHold/shortfallProposalIds: a hold
+     * is not a guard verdict. Cleared, like the rest of gate_state, when the
+     * delivery finally routes.
+     */
+    externalHold?: ExternalHoldState;
+}
+/**
+ * The durable external-hold state on a delivery's gate_state. Distinct from an
+ * agent_escalations row: an external dependency is state, not an inbox event.
+ */
+export interface ExternalHoldState {
+    /** What is blocking -- the irreducibly-external dependency. */
+    condition: string;
+    /** The condition that, when re-read as true, clears the hold. */
+    clearsWhen: string;
+    /** ISO timestamp the hold was declared. */
+    declaredAt: string;
+}
+//# sourceMappingURL=delivery-gate-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-gate-state.d.ts","sourceRoot":"","sources":["../../src/queries/delivery-gate-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,6BAA6B;IAC5C,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,EAAE,KAAK,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,2EAA2E;QAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACT,4EAA4E;QAC5E,QAAQ,EAAE,MAAM,CAAC;QACjB,kEAAkE;QAClE,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxD,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,uBAAuB,CAAC,EAAE,6BAA6B,CAAC;IACxD;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE;QACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IACF;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=delivery-gate-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-gate-state.js","sourceRoot":"","sources":["../../src/queries/delivery-gate-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/queries/escalation-suppression.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Cause-keyed escalation suppression + idempotent filing.
+ *
+ * Generalizes the narrow per-delivery precedent (hasOpenEscalationForDelivery in
+ * queries/issues.ts) to EVERY daemon detector via a deterministic cause key
+ * (queries/cause-key.ts). Two properties, both DB-backed so they survive a daemon
+ * restart:
+ *
+ *   1. Idempotent while open. While a filing carrying this cause key is OPEN
+ *      (pending or in_review), a detector re-observing the same cause does not
+ *      file again -- across ticks, restarts, and detector kinds.
+ *
+ *   2. Dismissal memory. A DISMISSED filing carrying this cause key keeps the
+ *      cause silent: the same cause cannot re-file until its subject state
+ *      changes. Because the subject is encoded IN the cause key, a changed subject
+ *      (a NEW sha going red) yields a DIFFERENT key with no matching dismissed row
+ *      and re-files naturally; the SAME sha re-observed yields the SAME key and is
+ *      suppressed no matter how many scans re-observe it.
+ *
+ * A RESOLVED filing does NOT suppress: resolve means the cause was addressed, so a
+ * recurrence should re-file. This is achieved simply by excluding 'resolved' from
+ * the suppression status set below.
+ *
+ * The cause key is stamped into agent_escalations.metadata.cause_key at file time.
+ * metadata JSONB is already persisted by escalation_create and returned by
+ * escalation_list, so this stays entirely daemon-side -- no migration or edge
+ * change is required (the AC's sanctioned "the cause key can live in metadata plus
+ * a suppression check at file time" path).
+ */
+import { createEscalation, type CreateEscalationParams } from './issues.js';
+/** Minimal escalation row shape the cause-key suppression check reads. */
+interface CauseKeyEscalationRow {
+    id: string;
+    status?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * Dependency seam. The real implementations query the Telora API / file via
+ * createEscalation; tests inject stubs to avoid the fragile bare-specifier
+ * `mock.module` path under tsx (same rationale as the stall-detectors /
+ * verification-feedback deps seams).
+ */
+export interface EscalationSuppressionDeps {
+    /** Fetch the open+dismissed escalation rows to scan for a matching cause key. */
+    listSuppressingEscalations?: (opts: {
+        focusId?: string;
+    }) => Promise<CauseKeyEscalationRow[]>;
+    /** File a fresh escalation (defaults to the real createEscalation). */
+    createEscalation?: typeof createEscalation;
+}
+/**
+ * True when an OPEN (pending/in_review) or DISMISSED escalation already carries
+ * this cause key -- i.e. a new filing for the same cause must be suppressed.
+ *
+ * Narrows server-side by open+dismissed statuses (and by focusId when supplied,
+ * honored by the live escalation_list handler) so the 500-row page is scoped to
+ * the relevant rows rather than the org's newest 500. The cause-key match itself
+ * is client-side because cause_key lives in metadata JSONB, not a column.
+ */
+export declare function hasSuppressedCauseKey(causeKey: string, opts?: {
+    focusId?: string;
+}, deps?: EscalationSuppressionDeps): Promise<boolean>;
+/** Params for an idempotent, cause-keyed filing. */
+export interface FileEscalationIdempotentParams extends CreateEscalationParams {
+    /** The deterministic cause key (queries/cause-key.ts). Stamped into metadata.cause_key. */
+    causeKey: string;
+}
+/** Outcome of an idempotent filing attempt. */
+export interface FileEscalationIdempotentResult {
+    /** Whether a new escalation row was created this call. */
+    filed: boolean;
+    /** Whether the call was suppressed by an existing open/dismissed cause-key row. */
+    suppressed: boolean;
+    /** The new escalation id when filed; null when suppressed or the create returned no id. */
+    escalationId: string | null;
+}
+/**
+ * File an escalation ONLY if its cause key is not already suppressed (open or
+ * dismissed). The cause key is stamped into metadata.cause_key so a later
+ * re-observation of the same cause is suppressed by hasSuppressedCauseKey.
+ *
+ * This is the single filing entry point every daemon detector should route
+ * through. It replaces per-detector ad-hoc dedup (hasOpenEscalationForDelivery,
+ * hasOpenWorktreeDirtyEscalation, hasOpenWedgedFocusEscalation, in-memory Sets)
+ * with one cause-keyed gate that also carries dismissal memory.
+ */
+export declare function fileEscalationIdempotent(params: FileEscalationIdempotentParams, deps?: EscalationSuppressionDeps): Promise<FileEscalationIdempotentResult>;
+export {};
+//# sourceMappingURL=escalation-suppression.d.ts.map

package/dist/queries/escalation-suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-suppression.d.ts","sourceRoot":"","sources":["../../src/queries/escalation-suppression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAY5E,0EAA0E;AAC1E,UAAU,qBAAqB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,0BAA0B,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC9F,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;CAC5C;AAsBD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,EAC/B,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,oDAAoD;AACpD,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;IAC5E,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,8BAA8B;IAC7C,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;IACpB,2FAA2F;IAC3F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,EACtC,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,8BAA8B,CAAC,CAmBzC"}

package/dist/queries/escalation-suppression.js

@@ -0,0 +1,98 @@
+/**
+ * Cause-keyed escalation suppression + idempotent filing.
+ *
+ * Generalizes the narrow per-delivery precedent (hasOpenEscalationForDelivery in
+ * queries/issues.ts) to EVERY daemon detector via a deterministic cause key
+ * (queries/cause-key.ts). Two properties, both DB-backed so they survive a daemon
+ * restart:
+ *
+ *   1. Idempotent while open. While a filing carrying this cause key is OPEN
+ *      (pending or in_review), a detector re-observing the same cause does not
+ *      file again -- across ticks, restarts, and detector kinds.
+ *
+ *   2. Dismissal memory. A DISMISSED filing carrying this cause key keeps the
+ *      cause silent: the same cause cannot re-file until its subject state
+ *      changes. Because the subject is encoded IN the cause key, a changed subject
+ *      (a NEW sha going red) yields a DIFFERENT key with no matching dismissed row
+ *      and re-files naturally; the SAME sha re-observed yields the SAME key and is
+ *      suppressed no matter how many scans re-observe it.
+ *
+ * A RESOLVED filing does NOT suppress: resolve means the cause was addressed, so a
+ * recurrence should re-file. This is achieved simply by excluding 'resolved' from
+ * the suppression status set below.
+ *
+ * The cause key is stamped into agent_escalations.metadata.cause_key at file time.
+ * metadata JSONB is already persisted by escalation_create and returned by
+ * escalation_list, so this stays entirely daemon-side -- no migration or edge
+ * change is required (the AC's sanctioned "the cause key can live in metadata plus
+ * a suppression check at file time" path).
+ */
+import { callApi } from './shared.js';
+import { createEscalation } from './issues.js';
+import { createLogger } from '../log.js';
+const log = createLogger({ module: 'escalations' });
+/**
+ * Statuses that SUPPRESS a re-file for a cause key: OPEN (pending/in_review)
+ * gives idempotency-while-open; DISMISSED gives dismissal-memory. 'resolved' is
+ * deliberately ABSENT -- a resolved cause may recur and should re-file.
+ */
+const SUPPRESSING_STATUSES = ['pending', 'in_review', 'dismissed'];
+async function defaultListSuppressingEscalations(opts) {
+    const result = await callApi('escalation_list', {
+        fields: {
+            statuses: SUPPRESSING_STATUSES,
+            ...(opts.focusId ? { focusId: opts.focusId } : {}),
+        },
+        limit: 500,
+    });
+    return result.escalations ?? [];
+}
+/** Read metadata.cause_key off a row, tolerating the loose JSONB shape. */
+function rowCauseKey(row) {
+    const meta = row.metadata ?? null;
+    const key = meta?.cause_key;
+    return typeof key === 'string' ? key : null;
+}
+/**
+ * True when an OPEN (pending/in_review) or DISMISSED escalation already carries
+ * this cause key -- i.e. a new filing for the same cause must be suppressed.
+ *
+ * Narrows server-side by open+dismissed statuses (and by focusId when supplied,
+ * honored by the live escalation_list handler) so the 500-row page is scoped to
+ * the relevant rows rather than the org's newest 500. The cause-key match itself
+ * is client-side because cause_key lives in metadata JSONB, not a column.
+ */
+export async function hasSuppressedCauseKey(causeKey, opts = {}, deps = {}) {
+    const list = deps.listSuppressingEscalations ?? defaultListSuppressingEscalations;
+    const rows = await list({ focusId: opts.focusId });
+    return rows.some((e) => {
+        if (e.status && !SUPPRESSING_STATUSES.includes(e.status))
+            return false;
+        return rowCauseKey(e) === causeKey;
+    });
+}
+/**
+ * File an escalation ONLY if its cause key is not already suppressed (open or
+ * dismissed). The cause key is stamped into metadata.cause_key so a later
+ * re-observation of the same cause is suppressed by hasSuppressedCauseKey.
+ *
+ * This is the single filing entry point every daemon detector should route
+ * through. It replaces per-detector ad-hoc dedup (hasOpenEscalationForDelivery,
+ * hasOpenWorktreeDirtyEscalation, hasOpenWedgedFocusEscalation, in-memory Sets)
+ * with one cause-keyed gate that also carries dismissal memory.
+ */
+export async function fileEscalationIdempotent(params, deps = {}) {
+    const { causeKey, ...createParams } = params;
+    const _createEscalation = deps.createEscalation ?? createEscalation;
+    const suppressed = await hasSuppressedCauseKey(causeKey, { focusId: createParams.focusId ?? createParams.anchor?.focusId }, deps);
+    if (suppressed) {
+        log.info(`[escalations] Suppressed duplicate filing for cause key "${causeKey}" (open or dismissed row exists)`);
+        return { filed: false, suppressed: true, escalationId: null };
+    }
+    const { escalationId } = await _createEscalation({
+        ...createParams,
+        metadata: { ...(createParams.metadata ?? {}), cause_key: causeKey },
+    });
+    return { filed: true, suppressed: false, escalationId };
+}
+//# sourceMappingURL=escalation-suppression.js.map

package/dist/queries/escalation-suppression.js.map

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

package/dist/queries/holds.d.ts

@@ -11,9 +11,11 @@
  *     question the daemon reads back to the asking agent. Fails OPEN at its
  *     call site.
  *
- * Plus SELF_REPORT_STALL_HOLD_KINDS: the kinds that are machine-filed alarms
- * ABOUT a delivery's own cycling, excluded from the operator predicate so an
- * alarm cannot constitute the condition it reports.
+ * Plus two exclusion families the operator predicate drops: SELF_REPORT_STALL_HOLD_KINDS
+ * (machine-filed alarms ABOUT a delivery's own cycling, so an alarm cannot
+ * constitute the condition it reports) and REFUSED_OPERATOR_HOLD_KINDS (kinds that
+ * name no human-only act -- refused at their filing surface and routed to bounded
+ * re-work; a legacy row must not hold a delivery out of done).
  *
  * Extracted from queries/issues.ts to keep that file under the daemon
  * file-size limit -- the self-referential-alarm fix pushed it to 844. Bodies
@@ -58,28 +60,39 @@ export declare const OPERATOR_HOLD_DISPOSITIONS: readonly string[];
  * silence it, and resolving one let the detector file the next on the following
  * tick.
  *
- * ENUMERATION -- every machine-filed, delivery-anchored needs_operator kind, and
- * whether it is a genuine hold or a self-referential stall alarm. The exclusion
- * criterion is narrow and precise: exclude a kind IFF (a) it re-arms while the
- * delivery is non-terminal AND (b) its ONLY silencing is the delivery reaching
- * the terminal state the hold blocks. A kind that describes external reality an
- * operator must change, or that is filed once and silenced by operator
- * resolution, is a GENUINE hold and stays.
+ * ENUMERATION -- every machine-filed, delivery-anchored needs_operator kind,
+ * tested against ONE governing rule ("A hold must name a human act", 2026-07-28):
+ * does the kind name a specific act ONLY a human can perform? A kind that names
+ * one is a GENUINE hold and stays. A kind that names none must NOT hold a
+ * delivery out of done: it is refused at its filing surface and routed into the
+ * machine's own bounded re-work path, and any legacy row is EXCLUDED from this
+ * predicate. (This rule GOVERNS -- it supersedes the older fixpoint-only test,
+ * which read a kind's legitimacy from its re-arm behaviour; the two disagreed on
+ * verify_evidence_unavailable and this rule is the one that wins.) The parallel
+ * self-referential-alarm exclusion still applies too: an alarm ABOUT a delivery's
+ * own cycling cannot constitute the hold it reports.
  *
  *   verify_gate_unclearable (stall-detectors.ts) -- SELF-REFERENTIAL. Trigger
  *     (iteration_count) is monotonic and re-arms every tick while non-terminal;
- *     silenced only by done/cancelled, which the hold blocks. EXCLUDE.
- *   verify_evidence_unavailable (verification-feedback.ts) -- self-REPORT of an
- *     instrument fault, but filed ONCE per delivery (idempotent, never re-armed)
- *     and silenced by operator resolution, not by `done`. It also already holds
- *     the delivery via its OWN gate_state.blocking guard, so it does not lean on
- *     this predicate. Not a fixpoint -> KEEP as a hold.
- *   schema_drift_blocked (listener-auto-advance.ts) -- operator must apply a
- *     migration (external reality). KEEP.
+ *     silenced only by done/cancelled, which the hold blocks. It IS the sole
+ *     surviving human residue of the bounded re-work cap, and it names a human
+ *     act (an operator must decide the unclearable delivery's fate), so it holds
+ *     -- but it must not hold ITSELF, hence the exclusion below. EXCLUDE from the
+ *     predicate for its own delivery (SELF_REPORT_STALL_HOLD_KINDS).
+ *   verify_evidence_unavailable (verification-feedback.ts) -- NAMES NO HUMAN ACT.
+ *     Its ask was "fix the diff range / confirm the merge / clear the delivery" --
+ *     the gate reporting its own BLINDNESS, not work an operator must do. As of
+ *     "A hold must name a human act" it is refused at the filing surface (nothing
+ *     files it; the empty-bundle path re-enters bounded verify_failed re-work in
+ *     verification-engine/feedback) and any legacy open row is EXCLUDED here
+ *     (REFUSED_OPERATOR_HOLD_KINDS) so it cannot hold a delivery out of done.
+ *     REFUSED + ROUTED, no longer a hold.
+ *   schema_drift_blocked (listener-auto-advance.ts) -- an operator must apply a
+ *     migration (a human-only act on external reality). KEEP.
  *   advance_blocked (delivery-advance-block.ts) -- dirty worktree / lockfile
- *     state an operator or agent must resolve. KEEP.
+ *     state an operator or agent must resolve on the host. KEEP.
  *   cd_push_failed (ci-escalation.ts) / ci_run_red (ci-sensor-loop.ts) --
- *     external CI/CD state. KEEP.
+ *     external CI/CD state a human must act on. KEEP.
  *   propagation_stale (staleness-sensor.ts) -- external propagation state. KEEP.
  *
  * (Focus-anchored kinds -- merge_conflict, merge_refused_dirty,
@@ -94,6 +107,25 @@ export declare const OPERATOR_HOLD_DISPOSITIONS: readonly string[];
  * with stall-detectors.VERIFY_GATE_UNCLEARABLE_KIND and the DB CHECK.
  */
 export declare const SELF_REPORT_STALL_HOLD_KINDS: readonly string[];
+/**
+ * escalation_kind discriminators that are REFUSED at their filing surface and
+ * routed into the machine's own bounded re-work path because they NAME NO ACT
+ * ONLY A HUMAN CAN PERFORM ("A hold must name a human act", 2026-07-28). Nothing
+ * files these anymore, but a LEGACY row opened before the filing refusal deployed
+ * must not hold its delivery out of done -- so it is excluded from the
+ * operator-hold predicate here, and the delivery clears itself via re-work
+ * instead of parking on a human inbox.
+ *
+ *   verify_evidence_unavailable -- the verify gate reporting its own blindness
+ *     (empty judgeable bundle). Its ask named no human-only act; the empty-bundle
+ *     path now re-enters bounded verify_failed re-work (verification-feedback.ts
+ *     requeueEvidenceUnavailableAsRework), and verify_gate_unclearable (the
+ *     iteration cap) is the sole surviving human residue.
+ *
+ * Daemon-local string literal for the same node:test module-mock-loader reason as
+ * SELF_REPORT_STALL_HOLD_KINDS / OPERATOR_HOLD_DISPOSITIONS above.
+ */
+export declare const REFUSED_OPERATOR_HOLD_KINDS: readonly string[];
 /** The open operator-hold escalation a delivery is blocked on (for gate_state). */
 export interface OperatorHoldEscalation {
     id: string;
@@ -135,43 +167,4 @@ export declare function findOpenOperatorHoldForDelivery(deliveryId: string, focu
  * only need to know whether the hold exists (not which escalation it is).
  */
 export declare function hasOpenOperatorHoldForDelivery(deliveryId: string, focusId?: string): Promise<boolean>;
-/**
- * The escalation dispositions that mean "a human must STEER before this team's
- * work can proceed": needs_intent (scope/direction/priority) and
- * needs_clarification (ambiguity to resolve). These are exactly the two the
- * escalation tool documents as answerable via the `answer` field -- a DIRECTED
- * question the daemon reads back to the asking agent, distinct from the
- * operator-hold dispositions (needs_operator / external_wait, a blocked-on-reality
- * signal) and agent_resolvable (no human at all).
- *
- * Daemon-local literals for the same reason as OPERATOR_HOLD_DISPOSITIONS above:
- * a bare `@telora/*` value import in a query module pulled into a mocked
- * node:test fails to resolve under the module-mock loader. The canonical enum is
- * packages/daemon-core/src/disposition.ts and the DB CHECK on
- * agent_escalations.disposition is the real constraint; these strings must stay
- * in sync with it.
- */
-export declare const DIRECTED_HOLD_DISPOSITIONS: readonly string[];
-/**
- * Returns the OPEN (pending|in_review) DIRECTED-hold escalation anchored to the
- * given delivery, or null when none is open. Disposition-keyed sibling of
- * findOpenOperatorHoldForDelivery, keyed on DIRECTED_HOLD_DISPOSITIONS
- * (needs_intent / needs_clarification) instead of the operator-hold set.
- *
- * This is the vocabulary the completion-event no-progress guard previously
- * lacked: a team parked on its own unanswered directed question could not be
- * told apart from a team that has stalled, so the scope-coverage guard counted
- * the wait as no-progress, re-engaged the team (real model spend), and
- * eventually filed a team_failure ON TOP of the question.
- *
- * FAIL DIRECTION IS THE OPPOSITE of findOpenOperatorHoldForDelivery. The
- * operator-hold gate's CALLER fails CLOSED (a lookup error => held) because a
- * missed hold lets an operator-blocked delivery reach done. HERE the consuming
- * guard must fail OPEN: a lookup error must NOT suppress a genuine stall
- * escalation, so the caller treats an error as "not blocked". This function
- * still reports what it finds and THROWS on a hard API error; the fail-open
- * decision lives at the call site (completion/event-phases.computeCompletionFacts),
- * which catches and defaults to not-blocked.
- */
-export declare function findOpenDirectedHoldForDelivery(deliveryId: string, focusId?: string): Promise<OperatorHoldEscalation | null>;
 //# sourceMappingURL=holds.d.ts.map