@telora/daemon 0.22.245 → 0.22.289

package/dist/supervision/stop-rows-completion-stall.js

@@ -0,0 +1,116 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/supervision/stop-registry.test.ts
+// PINNED-BY-END
+/**
+ * Stop-registry rows: the stops the COMPLETION-EVENT pipeline decides on a
+ * team's result -- the structural dead end, the no-actionable-work teardown and
+ * the terminal-error termination. Ending a team for NOT MOVING is not decided
+ * here: the pipeline's no-progress, delivery-advancement and re-engagement
+ * counters are asks it hands the one stalled_team row
+ * (supervision/stop-rows-team-stall.ts).
+ *
+ * The facts interfaces are declared here structurally: the completion layer's
+ * own types (completion/completion-event/completion-decision.ts
+ * CompletionDecisionFacts) sit above supervision/ and are assignable to them.
+ *
+ * Each row IS the decision its enforcing module acts on: the module asks
+ * supervision/stop-registry.ts evaluateStop for the verdict and decides nothing
+ * on its own.
+ *
+ * @module supervision/stop-rows-completion-stall
+ */
+import { booleanStopRow, TEAM_PROGRESS_RECORD_FACT } from './stop-row.js';
+/** No actionable work and no newly-appeared delivery to hand off. */
+const nothingToHandOff = (f) => !f.teamHasActionableWork && !f.hasNewlyAppearedDelivery;
+const isNonAdvanceable = (f) => nothingToHandOff(f) && !f.advancedThisCycle && f.hasNonAdvanceableStuck;
+const completion = (over) => ({
+    teamHasActionableWork: true,
+    advancedThisCycle: false,
+    hasNonAdvanceableStuck: false,
+    hasNewlyAppearedDelivery: false,
+    ...over,
+});
+export const COMPLETION_STALL_STOP_ROWS = {
+    completion_non_advanceable: booleanStopRow({
+        id: 'completion_non_advanceable',
+        kind: 'stall_detector',
+        stopsOn: 'remaining_delivery_structurally_non_advanceable',
+        enforcedBy: 'completion/team-outcome/decide-turn-work-rows.ts',
+        condition: 'On a completion event, the team has no actionable work and no newly-appeared delivery, did ' +
+            'not advance this cycle, and a remaining agent-actionable delivery is structurally ' +
+            'non-advanceable (NULL stage / no automatic transition out).',
+        factsRead: [
+            'team actionable work (deliveries + open issues)',
+            'teamState.knownDeliveryIds (newly-appeared deliveries)',
+            TEAM_PROGRESS_RECORD_FACT,
+            'delivery workflow stage + transitions (findNonAdvanceableDelivery)',
+        ],
+        effect: 'Files ONE team_failure escalation (skipped if one is open) and terminates the team.',
+        releaser: 'An operator/agent giving the stuck delivery a stage with a transition out, or the team advancing state.',
+        releaseCondition: 'The team advanced this cycle, has actionable or newly-appeared work, or no non-advanceable delivery remains.',
+        decidesOnProgress: true,
+        evaluate: isNonAdvanceable,
+        characterization: {
+            trigger: [completion({ teamHasActionableWork: false, hasNonAdvanceableStuck: true })],
+            release: [
+                completion({ teamHasActionableWork: false, hasNonAdvanceableStuck: true, advancedThisCycle: true }),
+                completion({ teamHasActionableWork: false, hasNonAdvanceableStuck: true, hasNewlyAppearedDelivery: true }),
+                completion({ hasNonAdvanceableStuck: true }),
+            ],
+        },
+    }),
+    completion_no_actionable_work: booleanStopRow({
+        id: 'completion_no_actionable_work',
+        kind: 'reaper',
+        stopsOn: 'team_has_no_work_to_hand_off',
+        enforcedBy: 'completion/team-outcome/decide-turn-work-rows.ts',
+        condition: 'On a completion event, the team has no actionable work, no newly-appeared delivery to hand ' +
+            'off, and is not at a structural dead end (completion_non_advanceable does not fire).',
+        factsRead: [
+            'team actionable work (deliveries + open issues)',
+            'teamState.knownDeliveryIds (newly-appeared deliveries)',
+            TEAM_PROGRESS_RECORD_FACT,
+            'delivery workflow stage + transitions (findNonAdvanceableDelivery)',
+        ],
+        effect: 'Terminates the team cleanly (no escalation) and records a TEARDOWN_AT_FIRST_RESULT firing; ' +
+            'while that mechanism is demoted the team is kept (bounded by a session hold) instead.',
+        releaser: 'New actionable work on the focus (an open issue, a planning delivery, or a new delivery).',
+        releaseCondition: 'The team has actionable work or a newly-appeared delivery to hand off.',
+        // Reads the record through the dead-end precedence (advancedThisCycle).
+        decidesOnProgress: true,
+        evaluate: (f) => nothingToHandOff(f) && !isNonAdvanceable(f),
+        characterization: {
+            trigger: [
+                completion({ teamHasActionableWork: false }),
+                completion({ teamHasActionableWork: false, hasNonAdvanceableStuck: true, advancedThisCycle: true }),
+            ],
+            release: [
+                completion({}),
+                completion({ teamHasActionableWork: false, hasNewlyAppearedDelivery: true }),
+                completion({ teamHasActionableWork: false, hasNonAdvanceableStuck: true }),
+            ],
+        },
+    }),
+    terminal_error_terminate: booleanStopRow({
+        id: 'terminal_error_terminate',
+        kind: 'reaper',
+        stopsOn: 'coding_result_is_error',
+        enforcedBy: 'completion/team-outcome/decide-turn-entry-rows.ts',
+        condition: 'A CODING pass completion result carries is_error (a provider error such as a 429, or any ' +
+            'errored turn): the session has terminated. The review pass is exempt.',
+        factsRead: ['completion result is_error', 'FocusTeamState.sessionType'],
+        effect: 'Terminates the team (shutdownReason teardown) and halts the completion pipeline; the focus ' +
+            'respawns on a later poll, bounded by the spawn cooldown.',
+        releaser: 'The session, by completing without is_error; review passes are never terminated here.',
+        releaseCondition: 'The result is not an error, or the pass is a review pass.',
+        evaluate: ({ sessionType, resultIsError }) => sessionType !== 'review' && resultIsError,
+        characterization: {
+            trigger: [{ sessionType: 'coding', resultIsError: true }],
+            release: [
+                { sessionType: 'coding', resultIsError: false },
+                { sessionType: 'review', resultIsError: true },
+            ],
+        },
+    }),
+};
+//# sourceMappingURL=stop-rows-completion-stall.js.map

package/dist/supervision/stop-rows-completion-stall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-rows-completion-stall.js","sourceRoot":"","sources":["../../src/supervision/stop-rows-completion-stall.ts"],"names":[],"mappings":"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"}

package/dist/supervision/stop-rows-delivery.d.ts

@@ -0,0 +1,106 @@
+/** Facts for the operator hold on one delivery (delivery/operator-hold.ts resolveOperatorHold). */
+export interface OperatorHoldFacts {
+    /** The lookup found an open operator-hold escalation anchored to the delivery. */
+    escalationFound: boolean;
+    /** The lookup threw (the gate fails closed on it). */
+    readFailed: boolean;
+}
+/** One condition an escalation row carries: its own, or one correlated onto it as a symptom. */
+export interface OperatorHoldCondition {
+    /** escalation_kind (typed column, metadata.kind fallback). */
+    kind: string | null;
+    /** metadata.observation.proposed_disposition (or the symptom's), when it proposed one. */
+    proposedDisposition: string | null;
+}
+/** Facts for whether ONE escalation row holds a delivery (supervision/holds.ts). */
+export interface OperatorHoldEscalationFacts {
+    /** status is open (pending / in_review), or absent. */
+    rowOpen: boolean;
+    /** The row is anchored to the delivery (typed delivery_id, metadata.deliveryId fallback). */
+    anchoredToDelivery: boolean;
+    /** The row's own disposition (typed column, metadata fallback). */
+    disposition: string | null;
+    /** The row's own condition first, then each correlated symptom. */
+    conditions: readonly OperatorHoldCondition[];
+    /** Dispositions that hold (OPERATOR_HOLD_DISPOSITIONS). */
+    holdDispositions: readonly string[];
+    /** Kinds that never hold (SELF_REPORT_STALL_HOLD_KINDS + REFUSED_OPERATOR_HOLD_KINDS). */
+    excludedKinds: readonly string[];
+}
+/** Which condition of the row holds, and whether the row's own disposition is a hold one. */
+export type OperatorHoldEscalationVerdict = {
+    conditionIndex: number;
+    direct: boolean;
+} | null;
+/** Facts for the external hold (delivery/external-hold.ts resolveExternalHold). */
+export interface ExternalHoldFacts {
+    /** gate_state.externalHold is present and well-formed. */
+    holdDeclared: boolean;
+    /** The clearing condition re-read this pass: met, unmet, or the evaluator threw. */
+    clearingCondition: 'met' | 'unmet' | 'read_failed';
+}
+/** Facts for the reference-less external-hold staleness bound. */
+export interface ExternalHoldStaleFacts {
+    /** The hold's wait can still fire (it carries a re-readable request reference). */
+    waitCanStillFire: boolean;
+    /** Date.parse of the hold's declaredAt (NaN when unparseable). */
+    declaredAtMs: number;
+    nowMs: number;
+    boundMs: number;
+}
+/** Facts for the commit-verdict hold at its (unchanged or carried) commit. */
+export interface CommitVerdictHoldFacts {
+    /** The route the review exit withheld (absent = done). */
+    route?: 'done' | 'verify_failed' | undefined;
+    /** The gate verdict state for the awaited commit (verify/gate-verdicts/own-gate-verdict.ts). */
+    verdict: 'unconfigured' | 'passed' | 'failed' | 'pending';
+    /** A gate run that may judge the awaited commit is selected or in flight. */
+    gateRunPending: boolean;
+}
+/** Facts for the coding -> verify advance precheck. */
+export interface AdvanceHoldFacts {
+    /** A focus worktree is registered for the focus. */
+    worktreeRegistered: boolean;
+    /** A verify command runs in the focus worktree. */
+    verifyInFlight: boolean;
+    /** The focus worktree carries uncommitted changes (read only when no verify runs). */
+    uncommitted: boolean;
+}
+/** The hold the advance precheck names, or null when it admits the advance. */
+export type AdvanceHoldVerdict = 'verify_in_flight' | 'worktree_uncommitted' | null;
+/** Facts for a reconciliation throw at verify. */
+export interface ModelUnavailableVerifyHoldFacts {
+    /** The throw is a typed ModelUnavailable (backends/claude/one-shot-model.ts isModelUnavailable). */
+    thrownModelUnavailable: boolean;
+}
+/** Facts for re-holding a standing incurable model hold without a model call. */
+export interface IncurableModelHoldFacts {
+    /** The standing hold's kind is one retrying cannot cure (backends/claude/one-shot-model.ts retryCannotCure). */
+    incurableKind: boolean;
+    /** The hold recorded the input it was judged against. */
+    inputRecorded: boolean;
+    /**
+     * The current input was READ and its commit-set or rulings fingerprint differs
+     * from the recorded one. An unreadable current input proves no change.
+     */
+    inputChangeProven: boolean;
+}
+/** Facts for the review exit's done route. */
+export interface ModelUnavailableDoneHoldFacts {
+    /** gate_state records the model-unavailable hold (queries/delivery-gate-state/verify-own-holds.ts). */
+    modelUnavailableHoldRecorded: boolean;
+}
+export declare const DELIVERY_STOP_ROWS: {
+    readonly operator_hold: import("./stop-row.js").StopRow<OperatorHoldFacts, boolean>;
+    readonly operator_hold_escalation: import("./stop-row.js").StopRow<OperatorHoldEscalationFacts, OperatorHoldEscalationVerdict>;
+} & {
+    readonly external_hold: import("./stop-row.js").StopRow<ExternalHoldFacts, boolean>;
+    readonly external_hold_reference_less_stale: import("./stop-row.js").StopRow<ExternalHoldStaleFacts, boolean>;
+} & {
+    readonly commit_verdict_hold: import("./stop-row.js").StopRow<CommitVerdictHoldFacts, boolean>;
+    readonly advance_hold: import("./stop-row.js").StopRow<AdvanceHoldFacts, AdvanceHoldVerdict>;
+    readonly model_unavailable_verify_hold: import("./stop-row.js").StopRow<ModelUnavailableVerifyHoldFacts, boolean>;
+    readonly incurable_model_hold: import("./stop-row.js").StopRow<IncurableModelHoldFacts, boolean>;
+    readonly model_unavailable_done_hold: import("./stop-row.js").StopRow<ModelUnavailableDoneHoldFacts, boolean>;
+};
+//# sourceMappingURL=stop-rows-delivery.d.ts.map

package/dist/supervision/stop-rows-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-rows-delivery.d.ts","sourceRoot":"","sources":["../../src/supervision/stop-rows-delivery.ts"],"names":[],"mappings":"AA8BA,mGAAmG;AACnG,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,eAAe,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,0FAA0F;IAC1F,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,oFAAoF;AACpF,MAAM,WAAW,2BAA2B;IAC1C,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,6FAA6F;IAC7F,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,2DAA2D;IAC3D,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0FAA0F;IAC1F,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,6FAA6F;AAC7F,MAAM,MAAM,6BAA6B,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAE/F,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,iBAAiB,EAAE,KAAK,GAAG,OAAO,GAAG,aAAa,CAAC;CACpD;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAC7C,gGAAgG;IAChG,OAAO,EAAE,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1D,6EAA6E;IAC7E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,sBAAsB,GAAG,IAAI,CAAC;AAEpF,kDAAkD;AAClD,MAAM,WAAW,+BAA+B;IAC9C,oGAAoG;IACpG,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,gHAAgH;IAChH,aAAa,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,6BAA6B;IAC5C,uGAAuG;IACvG,4BAA4B,EAAE,OAAO,CAAC;CACvC;AAoVD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAAqF,CAAC"}

package/dist/supervision/stop-rows-delivery.js

@@ -0,0 +1,335 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/supervision/stop-registry.test.ts
+// PINNED-BY-END
+/**
+ * Stop-registry rows: the holds that keep a DELIVERY out of a transition (done,
+ * an advance) -- the operator, external, commit-verdict, advance and
+ * model-unavailable holds. The verify-gate stall cap and the verify re-run
+ * suppressors are declared in supervision/stop-rows-verify-rerun.ts and
+ * assembled into DELIVERY_STOP_ROWS here, so the registry reads them through
+ * this one export.
+ *
+ * Each row IS the decision its enforcing module acts on: the module asks
+ * supervision/stop-registry.ts evaluateStop for the verdict and decides nothing
+ * on its own.
+ *
+ * @module supervision/stop-rows-delivery
+ */
+import { booleanStopRow, combineStopRowTables, stopRow } from './stop-row.js';
+/**
+ * The operator disposition, for the escalation-row fixtures below. A named
+ * constant because a fixture row is not a filing (the detector-disposition gate
+ * reads a literal disposition in an object as one).
+ */
+const FIXTURE_OPERATOR_DISPOSITION = 'needs_operator';
+const HOUR_MS = 3_600_000;
+const OPERATOR_HOLD_ROWS = {
+    operator_hold: booleanStopRow({
+        id: 'operator_hold',
+        kind: 'hold',
+        stopsOn: 'delivery_operator_hold',
+        enforcedBy: 'delivery/operator-hold.ts',
+        condition: 'An open escalation anchored to the delivery holds it (operator_hold_escalation), or the lookup ' +
+            'failed -- the one escalation lookup that fails CLOSED.',
+        factsRead: [
+            'open agent_escalations for the org / focus (supervision/holds.ts findOpenOperatorHoldForDelivery)',
+            'whether that read threw',
+        ],
+        effect: 'Every verify->done write path (review exit, standing-approval convergence, discovery auto-advance) ' +
+            'leaves the delivery in verify and writes gate_state.operatorHold; the review park skips a focus ' +
+            'whose every delivery is held.',
+        releaser: 'Whoever resolves / dismisses the escalation (a human, or the agent that owns an observation); ' +
+            'the next read clears the gate_state marker (clearOperatorHoldGateState).',
+        releaseCondition: 'The lookup succeeds and finds no open operator-hold escalation for the delivery.',
+        evaluate: ({ escalationFound, readFailed }) => readFailed || escalationFound,
+        characterization: {
+            trigger: [
+                { escalationFound: true, readFailed: false },
+                { escalationFound: false, readFailed: true },
+            ],
+            release: [{ escalationFound: false, readFailed: false }],
+        },
+    }),
+    operator_hold_escalation: stopRow({
+        id: 'operator_hold_escalation',
+        kind: 'hold',
+        stopsOn: 'escalation_carries_hold_disposition',
+        enforcedBy: 'supervision/holds.ts',
+        condition: 'An open escalation anchored to the delivery has a needs_operator / external_wait disposition, or ' +
+            'it (or a symptom correlated onto it) is an observation proposing one -- unless that condition\'s ' +
+            'kind is a self-referential stall alarm or a refused kind that names no human act.',
+        factsRead: [
+            'agent_escalations row: status, disposition (metadata fallback), delivery_id (metadata fallback), ' +
+                'escalation_kind (metadata.kind fallback)',
+            'metadata.observation.proposed_disposition and metadata.symptoms',
+            'OPERATOR_HOLD_DISPOSITIONS, SELF_REPORT_STALL_HOLD_KINDS, REFUSED_OPERATOR_HOLD_KINDS',
+        ],
+        effect: 'findOpenOperatorHoldForDelivery returns the row, so operator_hold holds the delivery.',
+        releaser: 'Whoever resolves / dismisses the escalation, or the correlation that clears its symptom.',
+        releaseCondition: 'The row is resolved, or none of its conditions carries a hold disposition outside the excluded kinds.',
+        evaluate: ({ rowOpen, anchoredToDelivery, disposition, conditions, holdDispositions, excludedKinds }) => {
+            if (!rowOpen || !anchoredToDelivery)
+                return null;
+            const direct = disposition !== null && holdDispositions.includes(disposition);
+            const conditionIndex = conditions.findIndex((c) => (direct || (c.proposedDisposition !== null && holdDispositions.includes(c.proposedDisposition))) &&
+                !(c.kind !== null && excludedKinds.includes(c.kind)));
+            return conditionIndex < 0 ? null : { conditionIndex, direct };
+        },
+        fires: (verdict) => verdict !== null,
+        characterization: {
+            trigger: [
+                {
+                    rowOpen: true, anchoredToDelivery: true, disposition: FIXTURE_OPERATOR_DISPOSITION,
+                    conditions: [{ kind: 'advance_blocked', proposedDisposition: null }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: ['verify_gate_unclearable'],
+                },
+                {
+                    rowOpen: true, anchoredToDelivery: true, disposition: 'agent_resolvable',
+                    conditions: [{ kind: 'schema_drift_blocked', proposedDisposition: 'needs_operator' }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: [],
+                },
+                {
+                    rowOpen: true, anchoredToDelivery: true, disposition: 'agent_resolvable',
+                    conditions: [
+                        { kind: 'team_failure', proposedDisposition: null },
+                        { kind: 'cd_push_failed', proposedDisposition: 'external_wait' },
+                    ],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: [],
+                },
+            ],
+            release: [
+                {
+                    rowOpen: true, anchoredToDelivery: true, disposition: FIXTURE_OPERATOR_DISPOSITION,
+                    conditions: [{ kind: 'verify_gate_unclearable', proposedDisposition: null }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: ['verify_gate_unclearable'],
+                },
+                {
+                    rowOpen: true, anchoredToDelivery: true, disposition: 'agent_resolvable',
+                    conditions: [{ kind: 'advance_blocked', proposedDisposition: null }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: [],
+                },
+                {
+                    rowOpen: true, anchoredToDelivery: false, disposition: FIXTURE_OPERATOR_DISPOSITION,
+                    conditions: [{ kind: 'advance_blocked', proposedDisposition: null }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: [],
+                },
+                {
+                    rowOpen: false, anchoredToDelivery: true, disposition: FIXTURE_OPERATOR_DISPOSITION,
+                    conditions: [{ kind: 'advance_blocked', proposedDisposition: null }],
+                    holdDispositions: ['needs_operator', 'external_wait'], excludedKinds: [],
+                },
+            ],
+        },
+    }),
+};
+const EXTERNAL_HOLD_ROWS = {
+    external_hold: booleanStopRow({
+        id: 'external_hold',
+        kind: 'hold',
+        stopsOn: 'delivery_external_wait_unmet',
+        enforcedBy: 'delivery/external-hold.ts',
+        condition: 'The delivery\'s gate_state declares an externalHold whose clearing condition re-reads unmet, or ' +
+            'whose evaluator threw (fails closed).',
+        factsRead: [
+            'delivery gate_state.externalHold (condition, clearsWhen, declaredAt, clearsWhenRequestsClosed)',
+            'status of the referenced cross-product requests (queries/nexus-requests/requests.ts), via the ' +
+                'injected condition evaluator',
+        ],
+        effect: 'Every verify->done write path leaves the delivery in verify; no escalation is filed (an external ' +
+            'dependency is state, not an inbox event).',
+        releaser: 'The condition evaluator on the next verify->done pass (it rewrites gate_state without the hold), ' +
+            'or a re-declaration / clearExternalHold on a reality change.',
+        releaseCondition: 'Every request the hold references has reached closure (status closed); a reference-less hold ' +
+            'never self-clears.',
+        evaluate: ({ holdDeclared, clearingCondition }) => holdDeclared && clearingCondition !== 'met',
+        characterization: {
+            trigger: [
+                { holdDeclared: true, clearingCondition: 'unmet' },
+                { holdDeclared: true, clearingCondition: 'read_failed' },
+            ],
+            release: [
+                { holdDeclared: true, clearingCondition: 'met' },
+                { holdDeclared: false, clearingCondition: 'unmet' },
+            ],
+        },
+    }),
+    external_hold_reference_less_stale: booleanStopRow({
+        id: 'external_hold_reference_less_stale',
+        kind: 'watchdog',
+        stopsOn: 'external_hold_unfireable_and_stale',
+        enforcedBy: 'delivery/external-hold.ts',
+        condition: 'An external hold carries no re-readable request reference (its wait cannot fire) and was declared ' +
+            'at least 24h ago.',
+        factsRead: ['delivery gate_state.externalHold (declaredAt, clearsWhenRequestsClosed)', 'wall clock'],
+        effect: 'resolveExternalHold reports staleReferenceLess, and the caller surfaces the hold as a health ' +
+            'signal (delivery/external-hold-surface.ts) so it is never a silent permanent hold.',
+        releaser: 'A human re-declaring the hold with a clearing reference, or clearing it.',
+        releaseCondition: 'The hold carries a request reference, is younger than the bound, or is gone.',
+        evaluate: ({ waitCanStillFire, declaredAtMs, nowMs, boundMs }) => {
+            if (waitCanStillFire)
+                return false;
+            if (Number.isNaN(declaredAtMs))
+                return false;
+            return nowMs - declaredAtMs >= boundMs;
+        },
+        characterization: {
+            trigger: [
+                { waitCanStillFire: false, declaredAtMs: 0, nowMs: 24 * HOUR_MS, boundMs: 24 * HOUR_MS },
+                { waitCanStillFire: false, declaredAtMs: 0, nowMs: 48 * HOUR_MS, boundMs: 24 * HOUR_MS },
+            ],
+            release: [
+                { waitCanStillFire: false, declaredAtMs: 0, nowMs: 24 * HOUR_MS - 1, boundMs: 24 * HOUR_MS },
+                { waitCanStillFire: true, declaredAtMs: 0, nowMs: 100 * HOUR_MS, boundMs: 24 * HOUR_MS },
+                { waitCanStillFire: false, declaredAtMs: Number.NaN, nowMs: 100 * HOUR_MS, boundMs: 24 * HOUR_MS },
+            ],
+        },
+    }),
+};
+const GATE_ROUTE_HOLD_ROWS = {
+    commit_verdict_hold: booleanStopRow({
+        id: 'commit_verdict_hold',
+        kind: 'hold',
+        stopsOn: 'awaited_commit_verdict_not_passing',
+        enforcedBy: 'completion/team-outcome/decide-advance-rows.ts',
+        condition: 'A review exit held its route on gate_state.commitVerdictHold and, at the awaited commit, no ' +
+            'passing gate verdict exists (a done route), or a gate run that may judge it is still pending (a ' +
+            'verify_failed route).',
+        factsRead: [
+            'delivery gate_state.commitVerdictHold (sha, route, heldAt, review)',
+            'per-commit gate verdict for the awaited commit (verify/gate-verdicts/own-gate-verdict.ts)',
+            'gate-run registry: a run selected or in flight for the commit',
+        ],
+        effect: 'The delivery stays in verify with its held review exit un-replayed; the review park skips the ' +
+            'focus; after 2h a commit_verdict_overdue observation names the wait.',
+        releaser: 'The commit-verdict release pass (releaseCommitVerdictHolds), which clears the marker and replays ' +
+            'the held review exit; a moved HEAD with own work drops the marker; a failed verdict\'s ' +
+            'verify_failed write drops it.',
+        releaseCondition: 'A passing verdict for the awaited commit, no gate configured any more, or (held verify_failed) ' +
+            'no gate run pending for it.',
+        evaluate: ({ route, verdict, gateRunPending }) => {
+            if (verdict === 'passed' || verdict === 'unconfigured')
+                return false;
+            return !(route === 'verify_failed' && !gateRunPending);
+        },
+        characterization: {
+            trigger: [
+                { route: 'done', verdict: 'pending', gateRunPending: true },
+                { route: 'done', verdict: 'pending', gateRunPending: false },
+                { verdict: 'failed', gateRunPending: true },
+                { route: 'verify_failed', verdict: 'pending', gateRunPending: true },
+            ],
+            release: [
+                { route: 'done', verdict: 'passed', gateRunPending: false },
+                { route: 'done', verdict: 'unconfigured', gateRunPending: true },
+                { route: 'verify_failed', verdict: 'pending', gateRunPending: false },
+                { route: 'verify_failed', verdict: 'failed', gateRunPending: false },
+            ],
+        },
+    }),
+    advance_hold: stopRow({
+        id: 'advance_hold',
+        kind: 'hold',
+        stopsOn: 'focus_worktree_busy_or_dirty',
+        enforcedBy: 'delivery/delivery-advance-block.ts',
+        condition: 'A finished delivery\'s coding -> verify advance is refused while a verify command runs in the ' +
+            'focus worktree, or while that worktree carries uncommitted changes the daemon could not ' +
+            'remediate (lockfile commit, re-wake, safety-commit).',
+        factsRead: [
+            'registered focus worktree (worktree/focus-worktree-state.ts)',
+            'verify-in-flight marker for the worktree',
+            'git status of the focus worktree',
+        ],
+        effect: 'The advance is skipped this pass and gate_state.advanceHold names the reason and paths ' +
+            '(delivery/advance-hold.ts recordAdvanceHold); an unremediable dirty worktree files advance_blocked.',
+        releaser: 'The verify command finishing, the team committing (re-woken lead), the daemon\'s lockfile / ' +
+            'safety commit; the advance write (or clearAdvanceHold on a re-open) drops the marker.',
+        releaseCondition: 'No verify runs in the worktree and it is clean, or no focus worktree is registered.',
+        evaluate: ({ worktreeRegistered, verifyInFlight, uncommitted }) => {
+            if (!worktreeRegistered)
+                return null;
+            if (verifyInFlight)
+                return 'verify_in_flight';
+            return uncommitted ? 'worktree_uncommitted' : null;
+        },
+        fires: (verdict) => verdict !== null,
+        characterization: {
+            trigger: [
+                { worktreeRegistered: true, verifyInFlight: true, uncommitted: false },
+                { worktreeRegistered: true, verifyInFlight: false, uncommitted: true },
+            ],
+            release: [
+                { worktreeRegistered: true, verifyInFlight: false, uncommitted: false },
+                { worktreeRegistered: false, verifyInFlight: true, uncommitted: true },
+            ],
+        },
+    }),
+    model_unavailable_verify_hold: booleanStopRow({
+        id: 'model_unavailable_verify_hold',
+        kind: 'hold',
+        stopsOn: 'verify_reconciliation_model_unreachable',
+        enforcedBy: 'verify/engine/verification-engine.ts',
+        condition: 'The verify-time reconciliation threw because its judge could not run or be vouched for (rate limit, auth, ' +
+            'input too large, session exhausted, timeout, spawn error, no pinned checkout, or citations that do not ' +
+            'resolve at the judged commit): nothing was judged.',
+        factsRead: ['the reconciliation throw (backends/claude/one-shot-model.ts ModelUnavailable)'],
+        effect: 'The outcome is demoted to pending and gate_state carries verify_model_unavailable at the ' +
+            'delivery\'s own status (no transition, no iteration, no re-work); a non-rate-limit cause is ' +
+            'surfaced once as an observation. Any other throw is a shortfall instead.',
+        releaser: 'The verification tick re-judging the same commit.',
+        releaseCondition: 'The next reconciliation renders a judgement: a shortfall route rebuilds gate_state, a pass drops ' +
+            'every verify-own hold.',
+        evaluate: ({ thrownModelUnavailable }) => thrownModelUnavailable,
+        characterization: {
+            trigger: [{ thrownModelUnavailable: true }],
+            release: [{ thrownModelUnavailable: false }],
+        },
+    }),
+    incurable_model_hold: booleanStopRow({
+        id: 'incurable_model_hold',
+        kind: 'hold',
+        stopsOn: 'verify_judge_input_unchanged_after_incurable_failure',
+        enforcedBy: 'verify/outcome-routing/incurable-model-hold.ts',
+        condition: 'A delivery holds a verify model hold of a kind retrying cannot cure (input_too_large, or a bounded judge ' +
+            'session that used every turn of its budget: session_exhausted), recorded against ' +
+            'the input it was judged on, and no change to that input has been observed (an unreadable current input ' +
+            'observes none).',
+        factsRead: [
+            'delivery gate_state.modelUnavailable (kind, judgedAgainst)',
+            "the delivery's current commit-set fingerprint",
+            "the delivery's current rulings fingerprint (operator rulings and approving-review verdicts)",
+            'the fingerprint of the question the judge is asked (every declared statement it is handed)',
+        ],
+        effect: 'The dispatch re-holds the delivery with NO model call (neither the reconciliation nor ai_inspection runs); ' +
+            'the hold is surfaced once as its own escalation.',
+        releaser: 'A new commit on the delivery, a new shortfall ruling, a new approving review, or an edit of a declared statement the judge is handed.',
+        releaseCondition: 'A successful read of the commit-set, rulings and question fingerprints differs from the recorded one.',
+        evaluate: ({ incurableKind, inputRecorded, inputChangeProven }) => incurableKind && inputRecorded && !inputChangeProven,
+        characterization: {
+            trigger: [{ incurableKind: true, inputRecorded: true, inputChangeProven: false }],
+            release: [
+                { incurableKind: true, inputRecorded: true, inputChangeProven: true },
+                { incurableKind: true, inputRecorded: false, inputChangeProven: false },
+                { incurableKind: false, inputRecorded: true, inputChangeProven: false },
+            ],
+        },
+    }),
+    model_unavailable_done_hold: booleanStopRow({
+        id: 'model_unavailable_done_hold',
+        kind: 'hold',
+        stopsOn: 'gate_state_records_model_unavailable',
+        enforcedBy: 'completion/review-exit/review-exit-phase.ts',
+        condition: 'A review exit would move a delivery to done while its gate_state records that the verify ' +
+            'reconciliation could not run (model unavailable).',
+        factsRead: ['delivery gate_state.modelUnavailable / verify_model_unavailable blocking guard'],
+        effect: 'The done route is skipped; the delivery stays in verify.',
+        releaser: 'The verification tick re-judging the delivery once the model answers.',
+        releaseCondition: 'Verify renders a judgement and drops the model-unavailable hold from gate_state.',
+        evaluate: ({ modelUnavailableHoldRecorded }) => modelUnavailableHoldRecorded,
+        characterization: {
+            trigger: [{ modelUnavailableHoldRecorded: true }],
+            release: [{ modelUnavailableHoldRecorded: false }],
+        },
+    }),
+};
+export const DELIVERY_STOP_ROWS = combineStopRowTables(OPERATOR_HOLD_ROWS, EXTERNAL_HOLD_ROWS, GATE_ROUTE_HOLD_ROWS);
+//# sourceMappingURL=stop-rows-delivery.js.map

package/dist/supervision/stop-rows-delivery.js.map

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

package/dist/supervision/stop-rows-focus-health.d.ts

@@ -0,0 +1,29 @@
+/** Facts for the planning-wedge watchdog's threshold (an escalation-eligible block). */
+export interface FocusWedgeFacts {
+    /**
+     * When the wedge began: the blocking delivery's updatedAt (restart-durable),
+     * or the watchdog's in-memory first-seen clock when updatedAt is unavailable.
+     */
+    wedgeSinceMs: number;
+    nowMs: number;
+    /** TELORA_WEDGED_FOCUS_THRESHOLD_MIN in ms. */
+    thresholdMs: number;
+}
+/** Facts for one control-plane circuit breaker, as the wedged-circuit watcher samples it. */
+export interface CircuitWedgeFacts {
+    /** The breaker's concern class (queries/api-client/shared.ts CONCERN_CLASS); only 'control-plane' is watched. */
+    concernClass: string | undefined;
+    /** The breaker's state is not 'closed' (open or half-open). */
+    circuitOpen: boolean;
+    /** When the watcher first observed this circuit continuously open. */
+    openSinceMs: number;
+    /** A wedge was already reported for this open episode. */
+    alreadyReported: boolean;
+    nowMs: number;
+    thresholdMs: number;
+}
+export declare const FOCUS_HEALTH_STOP_ROWS: {
+    readonly focus_wedge: import("./stop-row.js").StopRow<FocusWedgeFacts, boolean>;
+    readonly circuit_wedge: import("./stop-row.js").StopRow<CircuitWedgeFacts, boolean>;
+};
+//# sourceMappingURL=stop-rows-focus-health.d.ts.map

package/dist/supervision/stop-rows-focus-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-rows-focus-health.d.ts","sourceRoot":"","sources":["../../src/supervision/stop-rows-focus-health.ts"],"names":[],"mappings":"AAoBA,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,iHAAiH;IACjH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB;;;CA0EzB,CAAC"}