@telora/daemon 0.21.98 → 0.21.144

package/dist/queries/escalation-dispositions.js

@@ -0,0 +1,18 @@
+/**
+ * Daemon-local literals, TYPE-PINNED to the daemon-core disposition vocabulary.
+ *
+ * Shared by the escalation dedup guards (escalations.ts) and the consumption
+ * reads (escalation-consumption.ts) so the pinned mirror lives in exactly one
+ * place. This module must NOT take a runtime (value) import of
+ * `@telora/daemon-core` -- only the type import below. Under the node:test
+ * module-mock loader a bare `@telora/*` value specifier resolves relative to
+ * this file and dies with ERR_MODULE_NOT_FOUND, so the vocabulary is mirrored as
+ * local literals rather than imported values.
+ *
+ * The `Extract<...>` annotation keeps each honest: it stops compiling if the
+ * value is dropped or renamed in daemon-core, so these are pinned mirrors of the
+ * vocabulary rather than redeclarations that can silently drift.
+ */
+export const DISPOSITION_AGENT_RESOLVABLE = 'agent_resolvable';
+export const DISPOSITION_NEEDS_INTENT = 'needs_intent';
+//# sourceMappingURL=escalation-dispositions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-dispositions.js","sourceRoot":"","sources":["../../src/queries/escalation-dispositions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,4BAA4B,GACvC,kBAAkB,CAAC;AAErB,MAAM,CAAC,MAAM,wBAAwB,GACnC,cAAc,CAAC"}

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

@@ -27,7 +27,7 @@
  * 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';
+import { createEscalation, type CreateEscalationParams } from './escalations.js';
 /** Minimal escalation row shape the cause-key suppression check reads. */
 interface CauseKeyEscalationRow {
     id: string;

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

@@ -1 +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"}
+{"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,kBAAkB,CAAC;AAYjF,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

@@ -28,7 +28,7 @@
  * a suppression check at file time" path).
  */
 import { callApi } from './shared.js';
-import { createEscalation } from './issues.js';
+import { createEscalation } from './escalations.js';
 import { createLogger } from '../shell/log.js';
 const log = createLogger({ module: 'escalations' });
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"escalation-suppression.js","sourceRoot":"","sources":["../../src/queries/escalation-suppression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAA+B,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,oBAAoB,GAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAsBtF,KAAK,UAAU,iCAAiC,CAC9C,IAA0B;IAE1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAA2C,iBAAiB,EAAE;QACxF,MAAM,EAAE;YACN,QAAQ,EAAE,oBAAoB;YAC9B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD;QACD,KAAK,EAAE,GAAG;KACX,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW,CAAC,GAA0B;IAC7C,MAAM,IAAI,GAAI,GAAG,CAAC,QAA2C,IAAI,IAAI,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,EAAE,SAAS,CAAC;IAC5B,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,OAA6B,EAAE,EAC/B,OAAkC,EAAE;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,0BAA0B,IAAI,iCAAiC,CAAC;IAClF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACvE,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAkBD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsC,EACtC,OAAkC,EAAE;IAEpC,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC;IAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAEpE,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAC5C,QAAQ,EACR,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EACjE,IAAI,CACL,CAAC;IACF,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,4DAA4D,QAAQ,kCAAkC,CAAC,CAAC;QACjH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,iBAAiB,CAAC;QAC/C,GAAG,YAAY;QACf,QAAQ,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE;KACpE,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"escalation-suppression.js","sourceRoot":"","sources":["../../src/queries/escalation-suppression.ts"],"names":[],"mappings":"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"}

package/dist/queries/escalations.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Escalation queries: creation, open-escalation dedup reads, and resolution.
+ *
+ * Split out of queries/issues.ts (file-size limit); the issue CRUD stays there
+ * and re-exports this module so existing importers of queries/issues.js keep
+ * working -- the same shape as the queries/holds.ts split.
+ *
+ * This module must NOT take a runtime (value) import of `@telora/daemon-core`
+ * (only the type import below). Under the node:test module-mock loader a bare
+ * `@telora/*` value specifier resolves RELATIVE TO THIS FILE
+ * (.../src/queries/@telora/daemon-core) and dies with ERR_MODULE_NOT_FOUND --
+ * so every test that registers a mock.module and transitively loads this file
+ * fails to even start. The disposition vocabulary is therefore mirrored as
+ * type-pinned local literals (DISPOSITION_AGENT_RESOLVABLE / _NEEDS_INTENT);
+ * the same quirk keeps src/shell/log.ts daemon-local.
+ */
+import { type CallApiDeps } from './shared.js';
+import { resolveProvenance, type EscalationAnchor } from '../completion/escalation-provenance.js';
+/**
+ * Parameters for creating an escalation request.
+ */
+export interface CreateEscalationParams {
+    organizationId: string;
+    /** Session context (informational only -- not forwarded to the edge fn). Optional for daemon-side non-team callers. */
+    sessionId?: string;
+    issueId: string | null;
+    reasonType: string;
+    description: string;
+    whatWasTried?: string;
+    helpNeeded?: string;
+    /**
+     * Optional discriminator for the kind of escalation (e.g. 'stuck_focus_branch').
+     * Persisted on `agent_escalations.escalation_kind` when present.
+     */
+    escalationKind?: string;
+    /**
+     * Optional structured metadata (e.g. { branch_name, focus_id }).
+     * Persisted on `agent_escalations.metadata` when present.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Optional first-class provenance: where this escalation came from.
+     * Persisted on the agent_escalations product_id/focus_id/delivery_id
+     * columns. Prefer deriving these via resolveProvenance(anchor) so no
+     * site files an anonymous escalation when an anchor is available.
+     */
+    productId?: string;
+    focusId?: string;
+    deliveryId?: string;
+    /**
+     * Optional disposition: the resolution routing axis (who/what can resolve
+     * this). Distinct from escalationKind (the diagnosis). One of
+     * EscalationDisposition. Persisted on agent_escalations.disposition.
+     */
+    disposition?: string;
+    /**
+     * Optional cross-product TARGET provenance: the product this escalation is a
+     * blocker AGAINST (distinct from productId, which is the SOURCE product the
+     * escalation came from). Forwarded to the edge as fields.targetProductId. The
+     * edge escalation_create handler may or may not persist this on the
+     * agent_escalations.target_product_id column yet -- the escalation -> Nexus
+     * bridge does not depend on that, since the audit row also carries the target
+     * in metadata.target_product_id.
+     */
+    targetProductId?: string;
+    /**
+     * Optional provenance anchor: whatever the creation site holds (a delivery,
+     * focus, issue, session id, or branch). When present, the shared path runs
+     * resolveProvenance(anchor) and stamps the derived product/focus/delivery
+     * columns -- so no site files an anonymous escalation when an anchor is
+     * available. Explicitly-passed productId/focusId/deliveryId on params WIN
+     * over the derived values (caller intent beats derivation).
+     */
+    anchor?: EscalationAnchor;
+}
+/**
+ * Create an escalation request.
+ *
+ * When `anchor` is supplied, provenance is derived centrally via
+ * resolveProvenance and merged with any explicit productId/focusId/deliveryId
+ * on params (explicit wins). This is the single stamping point that closes
+ * Delivery C: every site routes through here and provenance is guaranteed
+ * whenever an anchor is available. resolveProvenance never throws, so a
+ * derivation miss degrades to the explicit fields (or none) rather than
+ * aborting the escalation.
+ */
+/**
+ * Injectable deps for createEscalation. Two-dep cascade: the shared path calls
+ * BOTH callApi (to write the row) AND resolveProvenance (to derive the anchor's
+ * product/focus/delivery columns). CallApiDeps only covers callApi, so this
+ * local interface adds the provenance seam. A test injects fakes THROUGH deps,
+ * registering ZERO mock.module (which would poison the daemon-core mock-loader);
+ * production callers pass nothing and get the real imports.
+ */
+export interface CreateEscalationDeps extends CallApiDeps {
+    resolveProvenance?: typeof resolveProvenance;
+}
+export declare function createEscalation(params: CreateEscalationParams, deps?: CreateEscalationDeps): Promise<{
+    escalationId: string | null;
+}>;
+/**
+ * Minimal shape of an escalation row returned by listPendingEscalations.
+ * Only includes the fields needed by the merge-back loop.
+ */
+export interface PendingEscalation {
+    id: string;
+    reasonType: string;
+    description: string;
+    whatWasTried: string | null;
+    helpNeeded: string | null;
+    escalationKind?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * List open (not-yet-resolved) escalations for the organization.
+ *
+ * Returns rows with status in `('pending', 'in_review')` -- both are
+ * "open" from a dedup perspective. An operator may move a stuck-branch
+ * escalation to `in_review` while triaging; the merge-back loop must
+ * still treat it as suppressing duplicates so it does not file a second
+ * `pending` row for the same branch.
+ *
+ * Used by the merge-back loop to detect when a branch already has an
+ * unresolved merge-conflict escalation, and to find existing stuck-branch
+ * escalations for dedup / auto-resolution.
+ */
+export declare function listPendingEscalations(deps?: CallApiDeps): Promise<PendingEscalation[]>;
+/**
+ * Returns true when an open (status pending or in_review) team_failure
+ * escalation exists for the given focus.
+ *
+ * Used by the focus-executor spawn precondition to prevent respawning a
+ * team that has already given up on a focus. The escalation row is the
+ * signal "this focus is not currently workable"; until a human resolves
+ * it, the daemon should not spend cycles re-deriving the same conclusion.
+ *
+ * Dedup matches on the first-class `focus_id` column (stamped via the
+ * anchor since Delivery B of the Escalation Signal Richness focus). A
+ * metadata.focusId fallback covers any rows that predate the migration's
+ * backfill and landed in the deployment window before the daemon restarted.
+ */
+export declare function hasOpenTeamFailureEscalation(focusId: string, deps?: CallApiDeps, opts?: {
+    excludeAgentResolvable?: boolean;
+}): Promise<boolean>;
+/**
+ * Returns true when an open (status pending or in_review) escalation exists
+ * for the given delivery + kind discriminator.
+ *
+ * Now that the advance-block class is a first-class `escalation_kind`
+ * ('advance_blocked', added to the DB CHECK + ESCALATION_KINDS) and the
+ * delivery is a first-class `delivery_id` column, dedup matches on the
+ * COLUMNS in preference to the metadata bag. A metadata fallback is retained
+ * for back-compat with rows already open at deploy time (filed before this
+ * promotion, which carry the discriminator only in metadata.kind /
+ * metadata.deliveryId).
+ *
+ * Used by the delivery advance-block path so a delivery stuck across many
+ * polls files exactly one open escalation instead of one per tick.
+ */
+export declare function hasOpenEscalationForDelivery(deliveryId: string, escalationKind: string): Promise<boolean>;
+/**
+ * escalation_kind discriminators for the two focus-merge worktree-dirty
+ * classes. Declared as daemon-local string constants (not imported from
+ * @telora/daemon-core's ESCALATION_KINDS) on purpose: the daemon consumes the
+ * registry-PUBLISHED daemon-core, so it cannot reference newly-added enum
+ * members until a build that depends on a daemon-core publish carrying them.
+ * They ARE now in daemon-core (ESCALATION_KINDS.MERGE_CONFLICT /
+ * .MERGE_REFUSED_DIRTY, shipped in 0.2.45) for other consumers (frontend, MCP),
+ * but the daemon keeps the local strings so this code does not depend on the
+ * publish ordering. The DB CHECK is the real constraint -- loosened by the
+ * agent_escalations_kind_merge_classes migration to admit these two values --
+ * and the daemon stamps them as plain strings.
+ * (advance_blocked already shipped in daemon-core as ESCALATION_KINDS.ADVANCE_BLOCKED.)
+ */
+export declare const MERGE_CONFLICT_ESCALATION_KIND = "merge_conflict";
+export declare const MERGE_REFUSED_DIRTY_ESCALATION_KIND = "merge_refused_dirty";
+/**
+ * The worktree-dirty escalation classes: a single physical fact (one focus
+ * worktree with uncommitted changes) can be observed by three independent
+ * daemon paths -- the delivery advance-block guard (advance_blocked), the
+ * focus-merge dirty-worktree refusal (merge_refused_dirty), and the
+ * focus-merge conflict path (merge_conflict). They are siblings: when one is
+ * already open for a focus, the others should suppress rather than pile on.
+ */
+export declare const WORKTREE_DIRTY_ESCALATION_KINDS: readonly string[];
+/**
+ * Returns true when an open (status pending or in_review) worktree-dirty-class
+ * escalation exists for the given FOCUS.
+ *
+ * This generalizes hasOpenEscalationForDelivery from per-delivery to
+ * focus/worktree grain. A dirty worktree is a property of one focus worktree
+ * shared by all of the focus's deliveries, so deduping per delivery emits N
+ * rows for one physical fact. Keying on the focus collapses them to one.
+ *
+ * It also collapses ACROSS escalation classes: by default the sibling set is
+ * { advance_blocked, merge_conflict, merge_refused_dirty }, so an open
+ * advance-block escalation suppresses a merge-refuse one (and vice versa) --
+ * one dirty-worktree fact yields at most one open escalation regardless of how
+ * many code paths observe it. Pass `kinds` to narrow the sibling set.
+ *
+ * Dedup matches on the typed `focus_id` + `escalation_kind` COLUMNS in
+ * preference to the metadata bag, with a metadata fallback (metadata.focusId /
+ * metadata.kind) for rows already open at deploy time. Because it queries the
+ * DB rather than an in-memory Set, the dedup survives a daemon restart.
+ *
+ * The request narrows server-side by `focusId` + open `statuses` (both honored
+ * by the live escalation_list handler) so the 500-row page is scoped to this
+ * focus's open rows, not the org's newest 500 -- closing the gap where a busy
+ * org could push the matching sibling off the page. The status + focus + kind
+ * predicate is ALSO applied client-side (isOpenWorktreeDirtyMatch) as
+ * defense-in-depth.
+ */
+export declare function hasOpenWorktreeDirtyEscalation(focusId: string, kinds?: readonly string[], deps?: CallApiDeps): Promise<boolean>;
+/** The escalation_kind filed by the planning-wedge watchdog. */
+export declare const WEDGED_FOCUS_ESCALATION_KIND = "wedged_focus";
+/**
+ * Returns true when an OPEN (status pending or in_review) wedged_focus
+ * escalation already exists for the given FOCUS.
+ *
+ * The planning-wedge watchdog re-evaluates every poll tick, so without a dedup
+ * it would file an identical wedged_focus row each tick the focus stays wedged
+ * (the 172-duplicate storm class). Keying on the focus + escalation_kind COLUMNS
+ * collapses the threshold-crossing escalation to at most one open row per focus.
+ *
+ * Mirrors hasOpenWorktreeDirtyEscalation: the request narrows server-side by
+ * focusId + open statuses (both honored by the live escalation_list handler) so
+ * a busy org cannot page the matching row off the 500-row window, and the
+ * status + focus + kind predicate is ALSO applied client-side as defense-in-depth.
+ * Because it queries the DB rather than an in-memory Set, the dedup SURVIVES A
+ * DAEMON RESTART -- a restart cannot re-storm a focus that is still wedged.
+ */
+export declare function hasOpenWedgedFocusEscalation(focusId: string): Promise<boolean>;
+/**
+ * Returns true when an OPEN (status pending or in_review) escalation of the
+ * given `escalationKind` already exists for the given FOCUS. Generic per-focus
+ * dedup, mirroring hasOpenWedgedFocusEscalation but parameterized on the kind.
+ *
+ * Used by the targeted stall detectors (review_window_stalled) so a focus that
+ * stays stalled across many poll ticks files exactly one open escalation
+ * instead of one per tick. Queries the DB (not an in-memory Set), so the dedup
+ * survives a daemon restart. Narrows server-side by focusId + open statuses and
+ * re-applies the status/focus/kind predicate client-side as defense-in-depth.
+ */
+/**
+ * The escalation_kind the review-exit drift-streak breaker files when a focus
+ * branch keeps advancing DURING each review pass (review-exit-escalations.ts).
+ * Named here so the respawn guard and the filer agree on the exact string.
+ */
+export declare const REVIEW_COVERAGE_INCOMPLETE_ESCALATION_KIND = "review_coverage_incomplete";
+/**
+ * Returns true when an open (status pending or in_review)
+ * review_coverage_incomplete escalation exists for the given focus.
+ *
+ * Used by the respawn guard so a focus whose drift-streak breaker has already
+ * fired parks its re-review spawns instead of burning a review cycle every
+ * spawn cooldown while the escalation sits open (the 2026-08-06 incident: the
+ * breaker fired 4 minutes in, but nothing stopped the loop for 4.5h). Mirrors
+ * hasOpenTeamFailureEscalation; delegates to the generic per-focus dedup query.
+ */
+export declare function hasOpenReviewCoverageIncompleteEscalation(focusId: string): Promise<boolean>;
+export declare function hasOpenFocusEscalation(focusId: string, escalationKind: string): Promise<boolean>;
+/**
+ * The close half for a per-FOCUS escalation kind: resolve every open (pending or
+ * in_review) escalation of `escalationKind` for the focus, once the daemon has
+ * observed its clearing condition. Mirrors resolveOpenWorktreeDirtyEscalations
+ * (the delivery-scoped precedent) for the focus-scoped blocking kinds that
+ * applyRespawnGuard reads as a spawn block (team_failure) -- so a machine-filed
+ * spawn block clears itself the moment its own condition (genuine progress)
+ * clears, and the armed focus resumes spawning with no human act.
+ *
+ * Best-effort: a resolve failure for one row is logged and skipped, never thrown,
+ * so the caller's primary work (advancing a delivery) is not blocked. Returns the
+ * count resolved.
+ */
+/**
+ * Read the OPEN (pending or in_review) escalations of `escalationKind` for a
+ * focus, returning each row's id + metadata. The read sibling of
+ * resolveOpenFocusEscalationsOfKind, for close-halves whose clearing condition
+ * is per-row (e.g. review_coverage_incomplete clears only when the focus branch
+ * has stabilized at the tip recorded in the row's metadata at filing).
+ */
+/**
+ * List the escalation_kind of every OPEN (pending/in_review) escalation naming a
+ * focus -- the raw evidence the wedge-cause arbiter (TEL-3) draws on. Any-kind
+ * (no server kind filter); the caller narrows to wedge causes. Column-first with
+ * the metadata.focusId fallback for pre-backfill rows.
+ */
+export declare function listOpenFocusEscalationKinds(focusId: string, deps?: CallApiDeps): Promise<string[]>;
+export declare function listOpenFocusEscalationsOfKind(focusId: string, escalationKind: string, deps?: CallApiDeps): Promise<Array<{
+    id: string;
+    metadata: Record<string, unknown> | null;
+}>>;
+export declare function resolveOpenFocusEscalationsOfKind(focusId: string, escalationKind: string, resolutionNotes: string, deps?: CallApiDeps): Promise<number>;
+/**
+ * Auto-resolve the open worktree-dirty escalations for a focus once their
+ * underlying condition has cleared (the worktree is observed clean again, or a
+ * merge conflict has been merged through). Lists the open rows for the focus
+ * narrowed to `kinds`, resolves each with a daemon-remediation note, and
+ * returns the count resolved.
+ *
+ * This is the close half of the disposition-aware model: an agent_resolvable
+ * condition that auto-remediates should also stop showing in the human inbox
+ * the moment it clears, instead of lingering as a resolved-in-fact but
+ * still-pending row. Best-effort: a resolve failure for one row is logged and
+ * skipped, never thrown, so the caller's primary work is not blocked.
+ *
+ * Callers MUST pass `kinds` narrowed to the conditions the clearing event
+ * actually resolves -- e.g. a clean worktree clears advance_blocked /
+ * merge_refused_dirty but NOT merge_conflict (a content conflict is not a dirty
+ * worktree), and a successful merge clears merge_conflict.
+ */
+export declare function resolveOpenWorktreeDirtyEscalations(focusId: string, kinds: readonly string[], resolutionNotes?: string, deps?: CallApiDeps): Promise<number>;
+/**
+ * Returns true when an OPEN (status pending or in_review) PRD machine escalation
+ * of the given `discriminator` already exists for the given PRD.
+ *
+ * PRD machine escalations are filed via escalations.fileEscalation with a machine
+ * `kind` -- carried in metadata.machine_discriminator (NOT the escalation_kind
+ * CHECK enum) -- and the prd id folded from `details` into metadata.prdId. So
+ * dedup matches on those two metadata fields. Parameterizing the discriminator
+ * lets every cadence-reachable PRD escalation path share ONE idempotency guard:
+ * the steward divergence path ('prd_divergence_steward_escalation') AND the
+ * reflex no-surviving-path fallback ('prd_divergence_no_surviving_path'), both of
+ * which would otherwise flood identically (the 172-duplicate storm class).
+ *
+ * Because it queries the DB rather than a process-lifetime in-memory Set, the
+ * dedup SURVIVES A DAEMON RESTART: the escalation storm this prevents (identical
+ * pending rows filed every cadence tick) cannot recur after a restart, unlike the
+ * no-arm-role Set whose intentional restart-renotify semantics stay untouched.
+ *
+ * The request narrows server-side by metadata->>prdId (metadataPrdId, honored by
+ * the live escalation_list handler) so a busy org cannot page this PRD's row off
+ * the 500-row window. The metadata predicate is ALSO applied client-side as
+ * defense-in-depth AND so the dedup works before the edge-fn filter deploys
+ * (edge changes propagate via the separate INFRA pipeline) -- an unknown
+ * metadataPrdId field is simply ignored server-side until then.
+ */
+export declare function hasOpenPrdEscalation(prdId: string, discriminator: string): Promise<boolean>;
+/**
+ * Mark an escalation as resolved with optional notes.
+ */
+export declare function markEscalationResolved(escalationId: string, resolutionNotes?: string, deps?: CallApiDeps): Promise<void>;
+//# sourceMappingURL=escalations.d.ts.map

package/dist/queries/escalations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalations.d.ts","sourceRoot":"","sources":["../../src/queries/escalations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAWlG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,uHAAuH;IACvH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;CAC9C;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAyB1C;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsB9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,EACtB,IAAI,GAAE;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,OAAO,CAAC,OAAO,CAAC,CAkClB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAOD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAC/D,eAAO,MAAM,mCAAmC,wBAAwB,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,MAAM,EAI5D,CAAC;AA+CF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,SAAS,MAAM,EAAoC,EAC1D,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAapF;AAED;;;;;;;;;;GAUG;AACH;;;;GAIG;AACH,eAAO,MAAM,0CAA0C,+BAA+B,CAAC;AAEvF;;;;;;;;;GASG;AACH,wBAAsB,yCAAyC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjG;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;GAMG;AACH;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAc1E;AAED,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,eAAe,SAAuE,EACtF,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAGD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,EACxB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CASf"}