@telora/daemon 0.22.132 → 0.22.136

package/dist/queries/escalation-field-bounds.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bound every daemon escalation text field below the server's field limit.
+ *
+ * The escalation create endpoint (supabase/functions/_shared/validation.ts
+ * validateEscalationFields) refuses a description, whatWasTried or helpNeeded
+ * longer than ESCALATION_FIELD_MAX with a validation error that no resubmission
+ * can clear. Detector text embeds gate state -- failing-test lists, shortfall
+ * reasons, gate_state JSON -- whose length grows with the product's test suite,
+ * so a producer that composes blind sooner or later composes past the cap, and
+ * the filing (and the signal it carries) is lost. The chokepoint
+ * (queries/escalations.ts createEscalation) therefore fits EVERY field it sends
+ * through boundEscalationFields, whatever produced it.
+ *
+ * An over-cap field keeps its HEAD (where producers state the delivery and the
+ * cause) and its TAIL (where they point at the full detail, e.g. a log path),
+ * cuts the middle, and says so in-line: that it was shortened, from how many
+ * characters, and where the full text is. Producers that can summarize better
+ * than a middle cut (verify/verify-gate-stall.ts) fit themselves first; this is
+ * the floor no path can go under.
+ *
+ * Pure; no imports.
+ */
+/** The server-side cap on each escalation text field (description, whatWasTried, helpNeeded). */
+export declare const ESCALATION_FIELD_MAX = 5000;
+/** The description cap. The same number as every other field; named for producers that fit a description. */
+export declare const ESCALATION_DESCRIPTION_MAX = 5000;
+/** The in-line note an over-cap field carries in place of its cut middle. */
+export declare function shortenedMarker(originalLength: number, cap?: number): string;
+/**
+ * Pure: fit one field under `cap`. A field at or under the cap is returned
+ * unchanged; an over-cap field keeps its head and tail around shortenedMarker.
+ * The result's length is always <= cap.
+ */
+export declare function boundEscalationField(text: string, cap?: number): string;
+/** The text fields a filing sends. */
+export interface EscalationTextFields {
+    description: string;
+    whatWasTried: string | undefined;
+    helpNeeded: string | undefined;
+}
+/** The bounded fields, plus the original length of each field that had to be shortened. */
+export interface BoundedEscalationFields extends EscalationTextFields {
+    /** field name -> original length, for every field that was shortened; empty when none was. */
+    shortened: Record<string, number>;
+}
+/** Pure: fit every text field of a filing under `cap`, recording which were shortened. */
+export declare function boundEscalationFields(fields: EscalationTextFields, cap?: number): BoundedEscalationFields;
+//# sourceMappingURL=escalation-field-bounds.d.ts.map

package/dist/queries/escalation-field-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-field-bounds.d.ts","sourceRoot":"","sources":["../../src/queries/escalation-field-bounds.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iGAAiG;AACjG,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,6GAA6G;AAC7G,eAAO,MAAM,0BAA0B,OAAuB,CAAC;AAK/D,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,GAAE,MAA6B,GAAG,MAAM,CAMlG;AASD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAA6B,GAAG,MAAM,CAU7F;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,2FAA2F;AAC3F,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,EAC5B,GAAG,GAAE,MAA6B,GACjC,uBAAuB,CAazB"}

package/dist/queries/escalation-field-bounds.js

@@ -0,0 +1,83 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/queries/escalation-field-bounds.test.ts,
+//   packages/daemon/src/queries/escalation-refusal.test.ts,
+//   packages/daemon/src/queries/filing-chokepoint.test.ts, packages/daemon/src/verify/stall-detectors.test.ts
+// PINNED-BY-END
+/**
+ * Bound every daemon escalation text field below the server's field limit.
+ *
+ * The escalation create endpoint (supabase/functions/_shared/validation.ts
+ * validateEscalationFields) refuses a description, whatWasTried or helpNeeded
+ * longer than ESCALATION_FIELD_MAX with a validation error that no resubmission
+ * can clear. Detector text embeds gate state -- failing-test lists, shortfall
+ * reasons, gate_state JSON -- whose length grows with the product's test suite,
+ * so a producer that composes blind sooner or later composes past the cap, and
+ * the filing (and the signal it carries) is lost. The chokepoint
+ * (queries/escalations.ts createEscalation) therefore fits EVERY field it sends
+ * through boundEscalationFields, whatever produced it.
+ *
+ * An over-cap field keeps its HEAD (where producers state the delivery and the
+ * cause) and its TAIL (where they point at the full detail, e.g. a log path),
+ * cuts the middle, and says so in-line: that it was shortened, from how many
+ * characters, and where the full text is. Producers that can summarize better
+ * than a middle cut (verify/verify-gate-stall.ts) fit themselves first; this is
+ * the floor no path can go under.
+ *
+ * Pure; no imports.
+ */
+/** The server-side cap on each escalation text field (description, whatWasTried, helpNeeded). */
+export const ESCALATION_FIELD_MAX = 5000;
+/** The description cap. The same number as every other field; named for producers that fit a description. */
+export const ESCALATION_DESCRIPTION_MAX = ESCALATION_FIELD_MAX;
+/** Share of the kept budget given to the head; the rest keeps the tail. */
+const HEAD_SHARE = 0.7;
+/** The in-line note an over-cap field carries in place of its cut middle. */
+export function shortenedMarker(originalLength, cap = ESCALATION_FIELD_MAX) {
+    return (`\n\n[... shortened by the daemon to fit the ${cap}-character escalation field limit ` +
+        `(original ${originalLength} characters); the full text was written to the daemon log ` +
+        `(telora-daemon logs) when this escalation was filed ...]\n\n`);
+}
+/** True when index `i` would split a UTF-16 surrogate pair. */
+function splitsSurrogatePair(text, i) {
+    if (i <= 0 || i >= text.length)
+        return false;
+    const prev = text.charCodeAt(i - 1);
+    return prev >= 0xd800 && prev <= 0xdbff;
+}
+/**
+ * Pure: fit one field under `cap`. A field at or under the cap is returned
+ * unchanged; an over-cap field keeps its head and tail around shortenedMarker.
+ * The result's length is always <= cap.
+ */
+export function boundEscalationField(text, cap = ESCALATION_FIELD_MAX) {
+    if (text.length <= cap)
+        return text;
+    const marker = shortenedMarker(text.length, cap);
+    const budget = cap - marker.length;
+    if (budget <= 0)
+        return marker.slice(0, cap);
+    let head = Math.ceil(budget * HEAD_SHARE);
+    if (splitsSurrogatePair(text, head))
+        head -= 1;
+    let tailStart = text.length - (budget - head);
+    if (splitsSurrogatePair(text, tailStart))
+        tailStart += 1;
+    return `${text.slice(0, head)}${marker}${text.slice(tailStart)}`;
+}
+/** Pure: fit every text field of a filing under `cap`, recording which were shortened. */
+export function boundEscalationFields(fields, cap = ESCALATION_FIELD_MAX) {
+    const shortened = {};
+    const fit = (name, value) => {
+        if (value === undefined || value.length <= cap)
+            return value;
+        shortened[name] = value.length;
+        return boundEscalationField(value, cap);
+    };
+    return {
+        description: fit('description', fields.description),
+        whatWasTried: fit('whatWasTried', fields.whatWasTried),
+        helpNeeded: fit('helpNeeded', fields.helpNeeded),
+        shortened,
+    };
+}
+//# sourceMappingURL=escalation-field-bounds.js.map

package/dist/queries/escalation-field-bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-field-bounds.js","sourceRoot":"","sources":["../../src/queries/escalation-field-bounds.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,0EAA0E;AAC1E,4DAA4D;AAC5D,8GAA8G;AAC9G,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,6GAA6G;AAC7G,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAE/D,2EAA2E;AAC3E,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,cAAsB,EAAE,MAAc,oBAAoB;IACxF,OAAO,CACL,+CAA+C,GAAG,oCAAoC;QACtF,aAAa,cAAc,4DAA4D;QACvF,8DAA8D,CAC/D,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAS,mBAAmB,CAAC,IAAY,EAAE,CAAS;IAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAc,oBAAoB;IACnF,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC1C,IAAI,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,IAAI,IAAI,CAAC,CAAC;IAC/C,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,IAAI,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,SAAS,IAAI,CAAC,CAAC;IACzD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AACnE,CAAC;AAeD,0FAA0F;AAC1F,MAAM,UAAU,qBAAqB,CACnC,MAA4B,EAC5B,MAAc,oBAAoB;IAElC,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,CAA+B,IAAY,EAAE,KAAQ,EAAK,EAAE;QACtE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC;QAC7D,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAM,CAAC;IAC/C,CAAC,CAAC;IACF,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC;QACnD,YAAY,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC;QACtD,UAAU,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC;QAChD,SAAS;KACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,88 @@
+import type { CallApiDeps } from './shared.js';
+/** Longest server reason / original-text head the refusal record quotes. */
+export declare const REFUSAL_REASON_MAX = 500;
+export declare const REFUSAL_HEAD_MAX = 1500;
+/** Health-event code for a refused escalation filing. */
+export declare const ESCALATION_FILING_REFUSED_CODE = "escalation.filing_refused";
+/** The escalation_create fields the chokepoint sends. */
+export interface EscalationCreateFields {
+    reasonType: string;
+    description: string;
+    whatWasTried?: string;
+    helpNeeded?: string;
+    escalationKind?: string;
+    metadata?: Record<string, unknown>;
+    productId?: string;
+    focusId?: string;
+    deliveryId?: string;
+    targetProductId?: string;
+    disposition?: string;
+}
+/** One remembered refusal. */
+export interface FilingRefusal {
+    statusCode: number;
+    reason: string;
+    refusedAt: string;
+    /** The refusal record's escalation id once filed; null while unfiled, or when it was itself refused. */
+    recordEscalationId: string | null;
+    /** 'pending' = not yet filed (retried on the next identical filing); 'filed'; 'refused' = the record itself was refused. */
+    recordState: 'pending' | 'filed' | 'refused';
+}
+/** What the write produced. */
+export interface SendEscalationCreateResult {
+    escalationId: string | null;
+    /** Set when the filing was refused (now or on an earlier identical attempt); escalationId is then the refusal record's. */
+    refusal?: FilingRefusal;
+}
+export type FilingRefusalMemory = Map<string, FilingRefusal>;
+/** A health event as the daemon-core buffer takes it. */
+export interface RefusalHealthEvent {
+    severity: 'error';
+    source: string;
+    code: string;
+    message: string;
+    productId?: string;
+}
+export interface SendEscalationCreateDeps extends CallApiDeps {
+    refusalMemory?: FilingRefusalMemory;
+    emitHealthEvent?: (event: RefusalHealthEvent) => void | Promise<void>;
+    now?: () => string;
+}
+/**
+ * Pure: whether a failed write is a refusal no identical resubmission can clear.
+ * Follows daemon-core's own retryability semantics (resilience.ts
+ * classifyHttpStatus): a server response whose status is 4xx and that the client
+ * marked non-retryable -- 400, 401, 403, 404, 409, 413, 422, ... -- or a CHECK
+ * violation. 429 is marked retryable there and stays transient, as do network
+ * errors, 5xx, and a ReadOnlyModeError (503, non-retryable but not a refusal of the
+ * content). Duck-typed over daemon-core's ApiError: this module takes no
+ * daemon-core value import (see queries/escalations.ts).
+ */
+export declare function isNonTransientRefusal(err: unknown): err is Error & {
+    statusCode: number;
+};
+/**
+ * Pure: the content fingerprint -- everything the server judges: the text fields,
+ * kind, disposition, anchors and the metadata bag (canonicalized), minus only the
+ * per-tick metadata the chokepoint re-stamps. A corrected metadata value is a
+ * different filing and is sent again.
+ */
+export declare function filingFingerprint(fields: EscalationCreateFields): string;
+/** Pure: who the filing was for, for the log line and the health event. */
+export declare function filingSubject(fields: EscalationCreateFields): string;
+/**
+ * Pure: the minimal, fixed-size record filed in place of a refused filing. It keeps
+ * the kind, anchors, disposition, cause key and incident key (so dedup and incident
+ * correlation still see the condition), quotes the server's reason and the head of
+ * the refused description (which names the delivery and the cause), and says where
+ * the full text is. Every field is far under the server's field limits.
+ */
+export declare function refusalRecordFields(fields: EscalationCreateFields, refusal: FilingRefusal): EscalationCreateFields;
+type CreateCall = NonNullable<CallApiDeps['callApi']>;
+/**
+ * The chokepoint's escalation_create write, with non-transient refusal memory (see
+ * the module header). Throws only a transient failure.
+ */
+export declare function sendEscalationCreate(call: CreateCall, issueId: string | null, fields: EscalationCreateFields, deps?: SendEscalationCreateDeps): Promise<SendEscalationCreateResult>;
+export {};
+//# sourceMappingURL=escalation-refusal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-refusal.d.ts","sourceRoot":"","sources":["../../src/queries/escalation-refusal.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yDAAyD;AACzD,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAK1E,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4HAA4H;IAC5H,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,+BAA+B;AAC/B,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2HAA2H;IAC3H,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,MAAM,mBAAmB,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAK7D,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,KAAK,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAMzF;AAiBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAWxE;AAMD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAMpE;AAKD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,GAAG,sBAAsB,CAgBlH;AAmBD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;AA0BtD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/queries/escalation-refusal.js

@@ -0,0 +1,217 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/queries/escalation-refusal.test.ts
+// PINNED-BY-END
+/**
+ * A filing the server refuses for a non-transient reason is sent once, logged
+ * once, and surfaced to an operator -- never resubmitted identically every tick.
+ *
+ * Incident (daemon v0.22.132, 2026-09-16..17): the verify-gate stall detector's
+ * escalation was refused ("escalation description exceeds maximum length of 5000
+ * characters"); the refusal is a non-retryable 400, so withRetry threw at once, the
+ * detector downgraded it to a warn, and the next ~30s tick rebuilt and resubmitted
+ * the same text -- 181 refused filings, and an empty inbox while a delivery looped.
+ * Bounding the fields (queries/escalation-field-bounds.ts) removes that particular
+ * refusal; this module removes the loop for ANY refusal no resubmission can clear.
+ *
+ * sendEscalationCreate is the chokepoint's one escalation_create write
+ * (queries/escalations.ts createEscalation, and so the spool drain too):
+ *
+ *   - A transient failure (network, timeout, 5xx, read-only mode) is rethrown
+ *     unchanged -- the caller's retry and the next tick still apply.
+ *   - A non-transient refusal (any non-retryable 4xx, or a CHECK violation) is remembered
+ *     by the filing's content fingerprint, logged ONCE at error level naming the
+ *     server's reason and the delivery/focus, and emitted as an error health event
+ *     (heartbeat metadata -> the dashboard). A minimal, fixed-size record of the
+ *     refusal is then filed in its place with the same kind, anchors, cause key and
+ *     incident key, so the inbox carries the condition and the open row keeps the
+ *     cause-keyed detector from filing again.
+ *   - A later filing with the same fingerprint is not sent. If its refusal record
+ *     is still unfiled (a transient failure), only the record is retried.
+ *
+ * The memory is in-process: after a restart a refused filing is sent once more,
+ * and its refusal record's open row (cause key / incident key) is what keeps the
+ * detector quiet across the restart.
+ */
+import { createHash } from 'node:crypto';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'escalations' });
+/** Longest server reason / original-text head the refusal record quotes. */
+export const REFUSAL_REASON_MAX = 500;
+export const REFUSAL_HEAD_MAX = 1500;
+/** Health-event code for a refused escalation filing. */
+export const ESCALATION_FILING_REFUSED_CODE = 'escalation.filing_refused';
+/** Bound on remembered fingerprints; the oldest is forgotten first. */
+const REFUSAL_MEMORY_MAX = 500;
+/** The process-wide memory. Tests pass their own through deps. */
+const processMemory = new Map();
+/**
+ * Pure: whether a failed write is a refusal no identical resubmission can clear.
+ * Follows daemon-core's own retryability semantics (resilience.ts
+ * classifyHttpStatus): a server response whose status is 4xx and that the client
+ * marked non-retryable -- 400, 401, 403, 404, 409, 413, 422, ... -- or a CHECK
+ * violation. 429 is marked retryable there and stays transient, as do network
+ * errors, 5xx, and a ReadOnlyModeError (503, non-retryable but not a refusal of the
+ * content). Duck-typed over daemon-core's ApiError: this module takes no
+ * daemon-core value import (see queries/escalations.ts).
+ */
+export function isNonTransientRefusal(err) {
+    if (!(err instanceof Error))
+        return false;
+    const e = err;
+    if (e.isRetryable === true)
+        return false;
+    if (e.name === 'SchemaConstraintViolation')
+        return true;
+    return typeof e.statusCode === 'number' && e.statusCode >= 400 && e.statusCode < 500;
+}
+/**
+ * Metadata the chokepoint re-stamps on every attempt with per-tick values
+ * (incident symptoms carry observed_at), so it is not part of the content identity.
+ */
+const VOLATILE_METADATA_KEYS = new Set(['symptoms']);
+/** Pure: JSON with object keys sorted at every depth, so equal content hashes equally. */
+function canonicalJson(value) {
+    return JSON.stringify(value, (_key, v) => {
+        if (v === null || typeof v !== 'object' || Array.isArray(v))
+            return v;
+        const obj = v;
+        return Object.fromEntries(Object.keys(obj).sort().map((k) => [k, obj[k]]));
+    });
+}
+/**
+ * Pure: the content fingerprint -- everything the server judges: the text fields,
+ * kind, disposition, anchors and the metadata bag (canonicalized), minus only the
+ * per-tick metadata the chokepoint re-stamps. A corrected metadata value is a
+ * different filing and is sent again.
+ */
+export function filingFingerprint(fields) {
+    const metadata = fields.metadata
+        ? Object.fromEntries(Object.entries(fields.metadata).filter(([k]) => !VOLATILE_METADATA_KEYS.has(k)))
+        : null;
+    const identity = [
+        fields.reasonType, fields.escalationKind ?? null, fields.disposition ?? null,
+        fields.productId ?? null, fields.focusId ?? null, fields.deliveryId ?? null, fields.targetProductId ?? null,
+        fields.description, fields.whatWasTried ?? null, fields.helpNeeded ?? null,
+        metadata,
+    ];
+    return createHash('sha256').update(canonicalJson(identity)).digest('hex');
+}
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 3)}...`;
+}
+/** Pure: who the filing was for, for the log line and the health event. */
+export function filingSubject(fields) {
+    const parts = [
+        fields.deliveryId ? `delivery ${fields.deliveryId}` : null,
+        fields.focusId ? `focus ${fields.focusId}` : null,
+    ].filter((p) => p !== null);
+    return parts.length ? parts.join(', ') : 'no delivery or focus anchor';
+}
+/** Metadata keys the refusal record keeps: the ones that tie it to its cause and incident. */
+const RECORD_METADATA_KEYS = ['cause', 'cause_key', 'original_cause_key', 'incident_key', 'symptoms', 'observation'];
+/**
+ * Pure: the minimal, fixed-size record filed in place of a refused filing. It keeps
+ * the kind, anchors, disposition, cause key and incident key (so dedup and incident
+ * correlation still see the condition), quotes the server's reason and the head of
+ * the refused description (which names the delivery and the cause), and says where
+ * the full text is. Every field is far under the server's field limits.
+ */
+export function refusalRecordFields(fields, refusal) {
+    const kept = {};
+    for (const k of RECORD_METADATA_KEYS)
+        if (fields.metadata?.[k] !== undefined)
+            kept[k] = fields.metadata[k];
+    return {
+        ...fields,
+        description: `The daemon's ${fields.escalationKind ?? 'unkinded'} escalation for ${filingSubject(fields)} was refused by ` +
+            `the server (${refusal.statusCode}: ${clip(refusal.reason, REFUSAL_REASON_MAX)}), so this shortened record ` +
+            `of it is filed instead and the refused text is not resubmitted. The full refused filing was written to the ` +
+            `daemon log (telora-daemon logs) at ${refusal.refusedAt}. It began:\n\n${clip(fields.description, REFUSAL_HEAD_MAX)}`,
+        whatWasTried: 'The daemon sent the filing once; the server refused it for a reason no identical resubmission can clear, ' +
+            'so it was not retried.',
+        helpNeeded: fields.helpNeeded === undefined ? undefined : clip(fields.helpNeeded, REFUSAL_HEAD_MAX),
+        metadata: { ...kept, filing_refused: { status_code: refusal.statusCode, reason: clip(refusal.reason, REFUSAL_REASON_MAX), refused_at: refusal.refusedAt } },
+    };
+}
+async function defaultEmitHealthEvent(event) {
+    // Deferred: the daemon-core value import behind this seam is only needed on a
+    // refusal, and a static one would poison mock-loaded tests that import the chokepoint.
+    const { healthEvents } = await import('../shell/health-events.js');
+    healthEvents.emit({ ...event, timestamp: new Date().toISOString() });
+}
+function remember(memory, fingerprint, refusal) {
+    memory.delete(fingerprint);
+    memory.set(fingerprint, refusal);
+    while (memory.size > REFUSAL_MEMORY_MAX) {
+        const oldest = memory.keys().next().value;
+        if (oldest === undefined)
+            break;
+        memory.delete(oldest);
+    }
+}
+async function create(call, issueId, fields) {
+    const res = await call('escalation_create', { issueId, fields });
+    return res.escalation?.id ?? null;
+}
+/** File the refusal record for `refusal`; a transient failure leaves it pending, a refusal of the record ends it. */
+async function fileRefusalRecord(call, issueId, fields, refusal) {
+    try {
+        refusal.recordEscalationId = await create(call, issueId, refusalRecordFields(fields, refusal));
+        refusal.recordState = 'filed';
+        log.info(`[escalations] filed the refusal record ${refusal.recordEscalationId ?? '(no id)'} for the refused ${fields.escalationKind ?? 'unkinded'} filing (${filingSubject(fields)})`);
+    }
+    catch (err) {
+        if (!isNonTransientRefusal(err))
+            throw err;
+        refusal.recordState = 'refused';
+        log.error(`[escalations] the server also refused the refusal record for the ${fields.escalationKind ?? 'unkinded'} filing (${filingSubject(fields)}): ${err.message}; the refusal stays visible as the ${ESCALATION_FILING_REFUSED_CODE} health event`);
+    }
+    return { escalationId: refusal.recordEscalationId, refusal };
+}
+/**
+ * The chokepoint's escalation_create write, with non-transient refusal memory (see
+ * the module header). Throws only a transient failure.
+ */
+export async function sendEscalationCreate(call, issueId, fields, deps = {}) {
+    const memory = deps.refusalMemory ?? processMemory;
+    const fingerprint = filingFingerprint(fields);
+    const known = memory.get(fingerprint);
+    if (known) {
+        if (known.recordState === 'pending')
+            return fileRefusalRecord(call, issueId, fields, known);
+        log.debug(`[escalations] not resubmitting a ${fields.escalationKind ?? 'unkinded'} filing the server refused at ${known.refusedAt} (${filingSubject(fields)})`);
+        return { escalationId: known.recordEscalationId, refusal: known };
+    }
+    try {
+        return { escalationId: await create(call, issueId, fields) };
+    }
+    catch (err) {
+        if (!isNonTransientRefusal(err))
+            throw err;
+        const refusal = {
+            statusCode: err.statusCode ?? 400,
+            reason: err.message,
+            refusedAt: (deps.now ?? (() => new Date().toISOString()))(),
+            recordEscalationId: null,
+            recordState: 'pending',
+        };
+        remember(memory, fingerprint, refusal);
+        const message = `The server refused the daemon's ${fields.escalationKind ?? 'unkinded'} escalation for ${filingSubject(fields)} ` +
+            `(${refusal.statusCode}: ${clip(refusal.reason, REFUSAL_REASON_MAX)}); it will not be resubmitted with identical content.`;
+        log.error(`[escalations] ${message} Refused filing: ${JSON.stringify(fields)}`);
+        try {
+            await (deps.emitHealthEvent ?? defaultEmitHealthEvent)({
+                severity: 'error',
+                source: 'escalations',
+                code: ESCALATION_FILING_REFUSED_CODE,
+                message,
+                ...(fields.productId ? { productId: fields.productId } : {}),
+            });
+        }
+        catch (emitErr) {
+            log.warn(`[escalations] could not emit the ${ESCALATION_FILING_REFUSED_CODE} health event: ${emitErr.message}`);
+        }
+        return fileRefusalRecord(call, issueId, fields, refusal);
+    }
+}
+//# sourceMappingURL=escalation-refusal.js.map

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

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

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

@@ -88,6 +88,12 @@ export interface FileEscalationIdempotentResult {
      * failed before this row was filed; null otherwise.
      */
     incidentEscalationId?: string | null;
+    /**
+     * Whether the server refused the filing non-transiently (queries/escalation-refusal.ts):
+     * filed is then false, and escalationId is the refusal record filed in its place (null
+     * while unfiled or itself refused).
+     */
+    refused?: boolean;
 }
 /**
  * File an escalation ONLY if its cause key is not already suppressed (open,

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":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAYtF;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,wEAAwE;IACxE,0BAA0B,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpF,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;CAC5C;AAiCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK5F;AAED;;;;;;;;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,CAElB;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,wGAAwG;IACxG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,EACtC,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,8BAA8B,CAAC,CAqBzC"}
+{"version":3,"file":"escalation-suppression.d.ts","sourceRoot":"","sources":["../../src/queries/escalation-suppression.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAYtF;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,wEAAwE;IACxE,0BAA0B,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpF,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAC;CAC5C;AAiCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK5F;AAED;;;;;;;;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,CAElB;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,wGAAwG;IACxG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,EACtC,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,8BAA8B,CAAC,CAuBzC"}

package/dist/queries/escalation-suppression.js

@@ -1,16 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/completion/machine-remediable-demotion.test.ts,
-//   packages/daemon/src/drift/drift-eval-loop.test.ts,
-//   packages/daemon/src/integration/resolution-class-routing-flow.test.ts,
-//   packages/daemon/src/integration/verification-history-round-trip.test.ts,
-//   packages/daemon/src/queries/escalation-cause-key.test.ts,
-//   packages/daemon/src/queries/escalation-noise-regressions.test.ts,
-//   packages/daemon/src/queries/filing-chokepoint.test.ts,
-//   packages/daemon/src/queries/incident-correlation.test.ts,
-//   packages/daemon/src/queries/loop-refusal-observation.test.ts,
-//   packages/daemon/src/spawn/spawn-cooldown.test.ts, packages/daemon/src/verify/shortfall-routing.test.ts,
-//   packages/daemon/src/verify/stall-detectors.test.ts,
-//   packages/daemon/src/verify/unreviewed-settle-detector.test.ts
+// Pinned by: 22 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/queries/escalation-suppression.ts
 // PINNED-BY-END
 /**
  * Cause-keyed escalation suppression + idempotent filing.
@@ -126,12 +115,14 @@ export async function fileEscalationIdempotent(params, deps = {}) {
     };
     const created = await (deps.createEscalation ?? createEscalation)(keyed, deps.callApi ? { callApi: deps.callApi } : {});
     const correlated = created.correlated === true;
+    const refused = created.refusal !== undefined;
     return {
-        filed: !correlated,
+        filed: !correlated && !refused,
         suppressed: false,
         escalationId: correlated ? null : created.escalationId,
         correlated,
         incidentEscalationId: created.incidentEscalationId ?? null,
+        refused,
     };
 }
 //# sourceMappingURL=escalation-suppression.js.map

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

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

@@ -13,18 +13,8 @@ import type { EscalationResolutionClass } from '@telora/daemon-core';
 import { type CallApiDeps } from './shared.js';
 import { resolveProvenance, type EscalationAnchor } from '../completion/escalation-provenance.js';
 import { type HumanAct } from './filing-observation.js';
+import { type FilingRefusal, type SendEscalationCreateDeps } from './escalation-refusal.js';
 import { type IncidentRow, type SymptomClearing } from './incident-correlation.js';
-/**
- * The escalation `description` hard cap enforced server-side by
- * supabase/functions/_shared/validation.ts (validateMaxLength(description, 5000)).
- * Every daemon-side producer that composes a description MUST fit it under this
- * ONE number rather than compose blind and let the edge reject on length --
- * the disagreement that let an over-cap description be re-submitted forever
- * (Nexus notifications, and the former agent_resolvable promotion refile, which
- * the daemon no longer files). The Nexus producer (nexus/return.ts) imports it
- * from here so producer and server agree on the limit.
- */
-export declare const ESCALATION_DESCRIPTION_MAX = 5000;
 /**
  * Parameters for creating an escalation request.
  */
@@ -94,9 +84,9 @@ export interface CreateEscalationParams {
  * (derives the anchor's product/focus/delivery columns). Tests inject fakes THROUGH
  * deps, registering ZERO mock.module; production callers pass nothing.
  */
-export interface CreateEscalationDeps extends CallApiDeps {
+export interface CreateEscalationDeps extends SendEscalationCreateDeps {
     resolveProvenance?: typeof resolveProvenance;
-    /** ISO-8601 clock for the symptom's observed_at. */
+    /** ISO-8601 clock for the symptom's observed_at (and a refusal's refused_at). */
     now?: () => string;
 }
 /** Outcome of a filing through the chokepoint. */
@@ -107,6 +97,8 @@ export interface CreateEscalationResult {
     correlated?: boolean;
     /** The lane row it correlated onto, or whose attach failed before this row was filed; else null. */
     incidentEscalationId?: string | null;
+    /** Set when the server refused the filing non-transiently (queries/escalation-refusal.ts); escalationId is then its refusal record's. */
+    refusal?: FilingRefusal;
 }
 /**
  * Create an escalation request -- the single filing chokepoint. Provenance is

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

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