@telora/daemon 0.22.104 → 0.22.132

package/dist/completion/session-hold-sweep-deps.js

@@ -0,0 +1,89 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/review-window-idle-coding-lead-regression.test.ts,
+//   packages/daemon/src/completion/session-hold.test.ts,
+//   packages/daemon/src/directive/review-during-hold-terminates-coding.test.ts
+// PINNED-BY-END
+/**
+ * Production wiring for the bounded session-hold sweep (session-hold.ts): the
+ * live active-team map, the real terminateTeam, the pending spawn-directive
+ * queue, and the escalation filer. Split from session-hold.ts so that module
+ * stays a leaf (the directive dispatcher and the completion iterator both import
+ * it) while this one carries the heavier collaborators; only the poll loop
+ * (focus/listener.ts) and tests import it.
+ */
+import { ESCALATION_REASONS, ESCALATION_DISPOSITIONS } from '@telora/daemon-core';
+import { getActiveTeams } from '../focus/focus-team-state.js';
+import { getPendingSpawnDirective } from '../directive/directive-queue.js';
+import { createEscalation as defaultCreateEscalation } from '../queries/escalations.js';
+import { NO_HUMAN_ACT } from '../queries/filing-observation.js';
+import { terminateTeam, forceReapTeam } from './team-lifecycle.js';
+import { SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS } from './session-hold.js';
+/** metadata.cause stamped on a session-hold expiry escalation. */
+export const SESSION_HOLD_EXPIRED_CAUSE = 'session_hold_expired';
+function describeStillActive({ hold, team, elapsedMs, reason }) {
+    return {
+        description: `A ${hold.kind} session hold kept the team for focus "${team.focusName}" alive for ${Math.round(elapsedMs / 1000)}s, ` +
+            `past its ${Math.round(hold.maxMs / 1000)}s bound, and the team is still active (${reason}).\n\n` +
+            `**Focus ID:** ${hold.focusId}\n\n` +
+            `The hold has re-windowed once: if the team is still held when that window lapses, the daemon ` +
+            `tears it down.`,
+        whatWasTried: `Kept the team alive under a bounded ${hold.kind} hold; the bound lapsed while the team kept working.`,
+        helpNeeded: `Read the team's session log and decide whether the work it is doing belongs to this pass; ` +
+            `if not, stop the team so the queued pass can spawn.`,
+    };
+}
+function describeTeardownUnsignalable({ hold, team, reason }) {
+    return {
+        description: `A ${hold.kind} session hold on focus "${team.focusName}" expired (${reason}), but the daemon could not ` +
+            `signal the team lead to tear it down in ${SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS} attempts ` +
+            `(lead pid: ${team.leadPid ?? 'none recorded'}). It force-reaped the team's registration -- released its ` +
+            `session slot and dropped it from the active-team map -- so the queued pass can spawn.\n\n` +
+            `**Focus ID:** ${hold.focusId}`,
+        whatWasTried: `Retried the ${hold.kind} teardown ${SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS} times (terminateTeam found no ` +
+            `signalable lead each time), then force-reaped the registration.`,
+        helpNeeded: `Confirm no orphaned lead process for this focus is still running against its worktree` +
+            `${team.leadPid ? ` (pid ${team.leadPid})` : ''}; if one is, stop it before the next pass works the worktree.`,
+    };
+}
+/**
+ * File the ONE escalation a hold expiry owes: a still-active kept team, or a
+ * teardown that could not signal the lead and ended in a forced registration
+ * reap. Both are agent work (read the log / check for an orphan process) -- no
+ * human act -- so the filing chokepoint sends them to the machine lane as
+ * observations.
+ */
+export async function fileSessionHoldExpiryEscalation(expired, deps = { createEscalation: defaultCreateEscalation }) {
+    const { hold, team, elapsedMs, cause } = expired;
+    const forced = cause === 'teardown_unsignalable';
+    await deps.createEscalation({
+        organizationId: team.organizationId,
+        sessionId: team.leadSessionId ?? '',
+        issueId: null,
+        reasonType: ESCALATION_REASONS.ERROR_ENCOUNTERED,
+        disposition: ESCALATION_DISPOSITIONS.NEEDS_OPERATOR,
+        humanAct: NO_HUMAN_ACT,
+        anchor: { focusId: hold.focusId },
+        metadata: {
+            cause: SESSION_HOLD_EXPIRED_CAUSE, hold_kind: hold.kind, expiry_cause: cause, elapsed_ms: elapsedMs, max_ms: hold.maxMs,
+            ...(forced ? { forced_cleanup: true, teardown_attempts: SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS } : {}),
+        },
+        ...(forced ? describeTeardownUnsignalable(expired) : describeStillActive(expired)),
+    });
+}
+/** The production sweep deps; tests override individual collaborators. */
+export function buildSessionHoldSweepDeps(overrides = {}) {
+    return {
+        getActiveTeam: (focusId) => getActiveTeams().get(focusId),
+        terminateTeam: (focusId, shutdownReason) => terminateTeam(focusId, shutdownReason),
+        forceReapTeam: async (focusId, shutdownReason) => {
+            // Deferred: the governor binding lives in the spawn graph (focus-executor).
+            // This path is rarely hit, so keep that graph out of the sweep's static imports.
+            const { getGovernor } = await import('../focus/focus-executor.js');
+            return forceReapTeam(focusId, shutdownReason, { governor: getGovernor() });
+        },
+        fileEscalation: (expired) => fileSessionHoldExpiryEscalation(expired),
+        isDirectiveStillQueued: (focusId, contentHash) => getPendingSpawnDirective(focusId)?.contentHash === contentHash,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=session-hold-sweep-deps.js.map

package/dist/completion/session-hold-sweep-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hold-sweep-deps.js","sourceRoot":"","sources":["../../src/completion/session-hold-sweep-deps.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,yDAAyD;AACzD,+EAA+E;AAC/E,gBAAgB;AAEhB;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,IAAI,uBAAuB,EAA+B,MAAM,2BAA2B,CAAC;AACrH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,kCAAkC,EAAsD,MAAM,mBAAmB,CAAC;AAE3H,kEAAkE;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAIjE,SAAS,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAsB;IAChF,OAAO;QACL,WAAW,EACT,KAAK,IAAI,CAAC,IAAI,0CAA0C,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK;YACtH,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,0CAA0C,MAAM,QAAQ;YACjG,iBAAiB,IAAI,CAAC,OAAO,MAAM;YACnC,+FAA+F;YAC/F,gBAAgB;QAClB,YAAY,EAAE,uCAAuC,IAAI,CAAC,IAAI,sDAAsD;QACpH,UAAU,EACR,4FAA4F;YAC5F,qDAAqD;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAsB;IAC9E,OAAO;QACL,WAAW,EACT,KAAK,IAAI,CAAC,IAAI,2BAA2B,IAAI,CAAC,SAAS,cAAc,MAAM,8BAA8B;YACzG,2CAA2C,kCAAkC,YAAY;YACzF,cAAc,IAAI,CAAC,OAAO,IAAI,eAAe,6DAA6D;YAC1G,2FAA2F;YAC3F,iBAAiB,IAAI,CAAC,OAAO,EAAE;QACjC,YAAY,EACV,eAAe,IAAI,CAAC,IAAI,aAAa,kCAAkC,iCAAiC;YACxG,iEAAiE;QACnE,UAAU,EACR,uFAAuF;YACvF,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,+DAA+D;KACjH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAA2B,EAC3B,OAAmF,EAAE,gBAAgB,EAAE,uBAAuB,EAAE;IAEhI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,KAAK,uBAAuB,CAAC;IACjD,MAAM,IAAI,CAAC,gBAAgB,CAAC;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;QACnC,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,kBAAkB,CAAC,iBAAiB;QAChD,WAAW,EAAE,uBAAuB,CAAC,cAAc;QACnD,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;QACjC,QAAQ,EAAE;YACR,KAAK,EAAE,0BAA0B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK;YACvH,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,kCAAkC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnG;QACD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;KACnF,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CAAC,YAA2C,EAAE;IACrF,OAAO;QACL,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;QACzD,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC;QAClF,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE;YAC/C,4EAA4E;YAC5E,iFAAiF;YACjF,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACnE,OAAO,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,+BAA+B,CAAC,OAAO,CAAC;QACrE,sBAAsB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,WAAW;QAChH,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/completion/session-hold.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Bounded session holds: every daemon decision that KEEPS a team alive (or
+ * defers the queued directive that would replace it) records a hold here, and
+ * the poll loop sweeps the holds each tick. A hold carries its own bound and the
+ * outcome its expiry fires -- teardown or escalation -- so no keep is open-ended.
+ *
+ * Why (2026-09-15, daemon v0.22.104): an idle coding lead in a review window was
+ * kept by review-window routing ('leave_running', no expiry) while the queued
+ * review directive was deferred behind the same young team
+ * ('defer_young_divergence', "stays queued for the natural exit", no expiry). The
+ * lead waited on the review and the review waited on the lead's exit; the review
+ * spawned only after an operator killed the lead 800s+ later. Each hold was
+ * locally reasonable; the missing piece was a bound on either of them.
+ *
+ * A hold is keyed to the focus AND the team identity (team.startedAt) it was
+ * recorded against, so a hold never outlives its team: the sweep drops a hold
+ * whose team exited or was replaced. Re-recording a hold for the same team keeps
+ * the original clock -- a kept team emitting result after result cannot extend
+ * its own bound.
+ *
+ * Expiry policy per kind (resolveSessionHoldExpiry):
+ *   - young_team_directive_deferral: teardown (shutdownReason 'handoff', the same
+ *     outcome the past-window 'respawn' decision takes) iff the deferred directive
+ *     is still queued; a consumed/replaced directive drops the hold silently.
+ *   - merge_resolution: teardown iff resolvingMergeConflict is STILL set past
+ *     requestTeamLeadResolution's own bounded wait; else drop.
+ *   - review_window_keep_alive / first_result_teardown_demoted (keep-alives):
+ *     no agent activity since the hold was recorded -> teardown. Still active ->
+ *     ONE escalation, and the hold re-windows; its next expiry ends in teardown.
+ *
+ * A teardown that cannot signal the lead (terminateTeam returns false: no lead
+ * pid, or the signal threw) does NOT drop the hold -- a dropped hold would leave
+ * the stale active-team entry excluding the focus from the pending-spawn pass
+ * with nothing bounding it. The hold re-windows by SESSION_HOLD_TEARDOWN_RETRY_MS
+ * and retries; the SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS-th failure clears the hold,
+ * force-reaps the registration (team-lifecycle forceReapTeam: the reapers' own
+ * reclamation), and files ONE escalation.
+ *
+ * Every fired expiry logs exactly:
+ *   [session-hold] <kind> hold on focus <id8> expired after <N>s -- fired: teardown|escalation (<reason>)
+ * and a teardown that could not signal the lead follows it with:
+ *   [session-hold] <kind> hold on focus <id8> teardown attempt <n>/<max> found no signalable lead -- fired: teardown_retry|forced_cleanup (...)
+ *
+ * Pure registry + sweep: collaborators arrive through SessionHoldSweepDeps (the
+ * production wiring lives in session-hold-sweep-deps.ts) so this module stays a
+ * leaf the directive dispatcher and the completion iterator can both import.
+ */
+import type { FocusTeamState } from '../types/index.js';
+/** The keep/defer decisions a hold bounds. */
+export type SessionHoldKind = 'review_window_keep_alive' | 'young_team_directive_deferral' | 'first_result_teardown_demoted' | 'merge_resolution';
+/** What an expired hold fires. */
+export type SessionHoldExpiry = 'teardown' | 'escalation';
+/**
+ * What a sweep actually did for an expired hold: its expiry outcome, or -- when
+ * the teardown could not signal the lead -- a bounded retry or the terminal
+ * forced cleanup (registration reaped + one escalation).
+ */
+export type SessionHoldFired = SessionHoldExpiry | 'teardown_retry' | 'forced_cleanup';
+/** Teardown attempts an expired hold makes before it force-reaps the team registration. */
+export declare const SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS = 3;
+/** Re-window between teardown attempts whose lead could not be signalled. */
+export declare const SESSION_HOLD_TEARDOWN_RETRY_MS = 60000;
+/** A declared bound: how long a hold may stand and what its expiry fires. */
+export interface SessionHoldBound {
+    kind: SessionHoldKind;
+    maxMs: number;
+    onExpire: SessionHoldExpiry;
+}
+/** Bound on keeping a coding pass alive inside a review window while it still has actionable work. */
+export declare const REVIEW_WINDOW_KEEP_ALIVE_MAX_MS: number;
+/** Bound on the demoted (observe-only) teardown-at-first-result keep. */
+export declare const FIRST_RESULT_DEMOTED_KEEP_MAX_MS: number;
+/**
+ * Bound on the merge-resolution completion hold. Set ABOVE
+ * requestTeamLeadResolution's 300s wait (merge/focus-merge.ts
+ * MERGE_CONFLICT_RESOLUTION_TIMEOUT_MS), whose finally clears the flag -- so the
+ * hold only fires when that self-limit failed to run. Pinned by session-hold.test.ts.
+ */
+export declare const MERGE_RESOLUTION_HOLD_MAX_MS: number;
+/** Grace past the spawn-guard window before a deferred directive tears the young team down. */
+export declare const YOUNG_TEAM_DEFERRAL_GRACE_MS = 5000;
+export declare const REVIEW_WINDOW_KEEP_ALIVE_BOUND: SessionHoldBound;
+export declare const MERGE_RESOLUTION_HOLD_BOUND: SessionHoldBound;
+export declare const FIRST_RESULT_DEMOTED_KEEP_BOUND: SessionHoldBound;
+/** The shutdown reason each kind's teardown stamps (read by the exit classifier + cooldown). */
+export declare const SESSION_HOLD_TEARDOWN_REASON: Readonly<Record<SessionHoldKind, FocusTeamState['shutdownReason']>>;
+/** A recorded hold. */
+export interface SessionHold extends SessionHoldBound {
+    focusId: string;
+    reason: string;
+    /** Team identity the hold was recorded against (team.startedAt epoch ms). */
+    teamStartedAtMs: number;
+    recordedAtMs: number;
+    /** young_team_directive_deferral only: the deferred directive's contentHash. */
+    directiveHash?: string;
+    /** Set once the hold's expiry filed its one escalation; the next expiry tears down. */
+    escalated?: boolean;
+    /**
+     * Teardown attempts that could not signal the lead so far. Each re-windows the
+     * hold by SESSION_HOLD_TEARDOWN_RETRY_MS; the attempt that reaches
+     * SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS force-reaps instead.
+     */
+    teardownAttempts?: number;
+}
+export interface RecordSessionHoldInput extends SessionHoldBound {
+    focusId: string;
+    reason: string;
+    teamStartedAt: Date;
+    nowMs: number;
+    directiveHash?: string;
+}
+/**
+ * Record (or refresh) a hold. Re-recording for the SAME team identity keeps the
+ * original clock, bound, and escalation state -- a re-record can never extend a
+ * bound. A different team identity replaces the hold with a fresh one.
+ */
+export declare function recordSessionHold(input: RecordSessionHoldInput): SessionHold;
+/**
+ * Record the bounded young-team directive deferral: the directive waits for the
+ * young team only until the spawn-guard window (measured from team.startedAt)
+ * lapses, plus a small grace.
+ */
+export declare function recordYoungTeamDeferralHold(args: {
+    focusId: string;
+    teamStartedAt: Date;
+    contentHash: string;
+    nowMs: number;
+}): SessionHold;
+/** Clear one kind of hold for a focus, or every hold on it when kind is omitted. */
+export declare function clearSessionHold(focusId: string, kind?: SessionHoldKind): void;
+/** Read the holds currently recorded for a focus (snapshot copies). */
+export declare function getSessionHolds(focusId: string): SessionHold[];
+/** Test-only: drop every recorded hold. */
+export declare function __resetSessionHoldsForTesting(): void;
+/** The team facts the expiry policy reads (structural slice of FocusTeamState). */
+export type SessionHoldTeam = Pick<FocusTeamState, 'startedAt' | 'lastActivityAt' | 'resolvingMergeConflict' | 'organizationId' | 'focusName' | 'leadSessionId' | 'leadPid'>;
+/**
+ * Why an expiry files an escalation: the kept team is still active past its
+ * bound, or its teardown could not signal the lead and the registration was
+ * force-reaped.
+ */
+export type SessionHoldEscalationCause = 'still_active' | 'teardown_unsignalable';
+/** What an expiry that files an escalation hands the filer. */
+export interface ExpiredSessionHold {
+    hold: SessionHold;
+    team: SessionHoldTeam;
+    elapsedMs: number;
+    reason: string;
+    cause: SessionHoldEscalationCause;
+}
+export interface SessionHoldSweepDeps {
+    getActiveTeam: (focusId: string) => SessionHoldTeam | undefined;
+    terminateTeam: (focusId: string, shutdownReason: FocusTeamState['shutdownReason']) => boolean;
+    /** Force-reclaim a registration whose teardown could not signal the lead; true iff one was reaped. */
+    forceReapTeam: (focusId: string, shutdownReason: FocusTeamState['shutdownReason']) => Promise<boolean>;
+    fileEscalation: (expired: ExpiredSessionHold) => Promise<void>;
+    /** True while a pending spawn directive with this contentHash is still queued for the focus. */
+    isDirectiveStillQueued: (focusId: string, contentHash: string) => boolean;
+}
+export interface FiredSessionHold {
+    focusId: string;
+    kind: SessionHoldKind;
+    fired: SessionHoldFired;
+    elapsedMs: number;
+    reason: string;
+}
+/**
+ * Decide what an expired hold fires, re-checking the condition that justified
+ * it. Pure; exported for test.
+ */
+export declare function resolveSessionHoldExpiry(hold: SessionHold, team: SessionHoldTeam, isDirectiveStillQueued: SessionHoldSweepDeps['isDirectiveStillQueued']): {
+    outcome: SessionHoldExpiry | 'drop';
+    detail: string;
+};
+/**
+ * Sweep every recorded hold once. A hold whose team exited or was replaced is
+ * dropped; an expired hold fires its (re-checked) outcome. Returns what fired.
+ */
+export declare function sweepExpiredSessionHolds(nowMs: number, deps: SessionHoldSweepDeps): Promise<FiredSessionHold[]>;
+//# sourceMappingURL=session-hold.d.ts.map

package/dist/completion/session-hold.d.ts.map

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

package/dist/completion/session-hold.js

@@ -0,0 +1,238 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/completion-event-phase-registry.test.ts,
+//   packages/daemon/src/completion/review-window-idle-coding-lead-regression.test.ts,
+//   packages/daemon/src/completion/review-window-no-premature-teardown.test.ts,
+//   packages/daemon/src/completion/session-hold.test.ts,
+//   packages/daemon/src/completion/teardown-demotion-gate.test.ts,
+//   packages/daemon/src/directive/review-during-hold-terminates-coding.test.ts
+// PINNED-BY-END
+import { SPAWN_GUARD_WINDOW_MS } from '../directive/directive-queue.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'session-hold' });
+/** Teardown attempts an expired hold makes before it force-reaps the team registration. */
+export const SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS = 3;
+/** Re-window between teardown attempts whose lead could not be signalled. */
+export const SESSION_HOLD_TEARDOWN_RETRY_MS = 60_000;
+/** Bound on keeping a coding pass alive inside a review window while it still has actionable work. */
+export const REVIEW_WINDOW_KEEP_ALIVE_MAX_MS = 10 * 60_000;
+/** Bound on the demoted (observe-only) teardown-at-first-result keep. */
+export const FIRST_RESULT_DEMOTED_KEEP_MAX_MS = 10 * 60_000;
+/**
+ * Bound on the merge-resolution completion hold. Set ABOVE
+ * requestTeamLeadResolution's 300s wait (merge/focus-merge.ts
+ * MERGE_CONFLICT_RESOLUTION_TIMEOUT_MS), whose finally clears the flag -- so the
+ * hold only fires when that self-limit failed to run. Pinned by session-hold.test.ts.
+ */
+export const MERGE_RESOLUTION_HOLD_MAX_MS = 6 * 60_000;
+/** Grace past the spawn-guard window before a deferred directive tears the young team down. */
+export const YOUNG_TEAM_DEFERRAL_GRACE_MS = 5_000;
+export const REVIEW_WINDOW_KEEP_ALIVE_BOUND = {
+    kind: 'review_window_keep_alive', maxMs: REVIEW_WINDOW_KEEP_ALIVE_MAX_MS, onExpire: 'teardown',
+};
+export const MERGE_RESOLUTION_HOLD_BOUND = {
+    kind: 'merge_resolution', maxMs: MERGE_RESOLUTION_HOLD_MAX_MS, onExpire: 'teardown',
+};
+export const FIRST_RESULT_DEMOTED_KEEP_BOUND = {
+    kind: 'first_result_teardown_demoted', maxMs: FIRST_RESULT_DEMOTED_KEEP_MAX_MS, onExpire: 'teardown',
+};
+/** The shutdown reason each kind's teardown stamps (read by the exit classifier + cooldown). */
+export const SESSION_HOLD_TEARDOWN_REASON = {
+    young_team_directive_deferral: 'handoff',
+    merge_resolution: 'teardown',
+    review_window_keep_alive: 'teardown',
+    first_result_teardown_demoted: 'no_actionable_work',
+};
+const holds = new Map();
+function teamIdentityMs(startedAt) {
+    return startedAt instanceof Date ? startedAt.getTime() : Number.NaN;
+}
+/**
+ * Record (or refresh) a hold. Re-recording for the SAME team identity keeps the
+ * original clock, bound, and escalation state -- a re-record can never extend a
+ * bound. A different team identity replaces the hold with a fresh one.
+ */
+export function recordSessionHold(input) {
+    const byKind = holds.get(input.focusId) ?? new Map();
+    const teamStartedAtMs = teamIdentityMs(input.teamStartedAt);
+    const prior = byKind.get(input.kind);
+    const hold = prior !== undefined && prior.teamStartedAtMs === teamStartedAtMs
+        ? { ...prior, reason: input.reason, ...(input.directiveHash !== undefined ? { directiveHash: input.directiveHash } : {}) }
+        : {
+            focusId: input.focusId,
+            kind: input.kind,
+            reason: input.reason,
+            maxMs: input.maxMs,
+            onExpire: input.onExpire,
+            teamStartedAtMs,
+            recordedAtMs: input.nowMs,
+            ...(input.directiveHash !== undefined ? { directiveHash: input.directiveHash } : {}),
+        };
+    byKind.set(input.kind, hold);
+    holds.set(input.focusId, byKind);
+    return hold;
+}
+/**
+ * Record the bounded young-team directive deferral: the directive waits for the
+ * young team only until the spawn-guard window (measured from team.startedAt)
+ * lapses, plus a small grace.
+ */
+export function recordYoungTeamDeferralHold(args) {
+    const deadlineMs = teamIdentityMs(args.teamStartedAt) + SPAWN_GUARD_WINDOW_MS + YOUNG_TEAM_DEFERRAL_GRACE_MS;
+    return recordSessionHold({
+        focusId: args.focusId,
+        kind: 'young_team_directive_deferral',
+        maxMs: Math.max(0, deadlineMs - args.nowMs),
+        onExpire: 'teardown',
+        reason: 'a divergent spawn directive was deferred behind a young team',
+        teamStartedAt: args.teamStartedAt,
+        nowMs: args.nowMs,
+        directiveHash: args.contentHash,
+    });
+}
+/** Clear one kind of hold for a focus, or every hold on it when kind is omitted. */
+export function clearSessionHold(focusId, kind) {
+    if (kind === undefined) {
+        holds.delete(focusId);
+        return;
+    }
+    const byKind = holds.get(focusId);
+    if (!byKind)
+        return;
+    byKind.delete(kind);
+    if (byKind.size === 0)
+        holds.delete(focusId);
+}
+/** Read the holds currently recorded for a focus (snapshot copies). */
+export function getSessionHolds(focusId) {
+    return [...(holds.get(focusId)?.values() ?? [])].map((h) => ({ ...h }));
+}
+/** Test-only: drop every recorded hold. */
+export function __resetSessionHoldsForTesting() {
+    holds.clear();
+}
+/**
+ * Decide what an expired hold fires, re-checking the condition that justified
+ * it. Pure; exported for test.
+ */
+export function resolveSessionHoldExpiry(hold, team, isDirectiveStillQueued) {
+    if (hold.kind === 'young_team_directive_deferral') {
+        return hold.directiveHash !== undefined && isDirectiveStillQueued(hold.focusId, hold.directiveHash)
+            ? { outcome: 'teardown', detail: 'the deferred spawn directive is still queued behind this team' }
+            : { outcome: 'drop', detail: 'the deferred spawn directive was consumed or replaced' };
+    }
+    if (hold.kind === 'merge_resolution') {
+        return team.resolvingMergeConflict
+            ? { outcome: hold.onExpire, detail: 'the merge-conflict resolution flag is still set past its bounded wait' }
+            : { outcome: 'drop', detail: 'the merge-conflict resolution already ended' };
+    }
+    // A keep-alive whose teardown already failed stays on the teardown path: the
+    // decision was made, and activity cannot re-open it into an escalation.
+    if ((hold.teardownAttempts ?? 0) > 0) {
+        return { outcome: 'teardown', detail: 'retrying a teardown whose lead could not be signalled' };
+    }
+    const activeSinceRecorded = (team.lastActivityAt ?? Number.NEGATIVE_INFINITY) > hold.recordedAtMs;
+    if (!activeSinceRecorded)
+        return { outcome: hold.onExpire, detail: 'no agent activity since the hold was recorded' };
+    if (hold.escalated)
+        return { outcome: 'teardown', detail: 'still active after the escalated bound' };
+    return { outcome: 'escalation', detail: 'the kept team is still active' };
+}
+function holdTag(hold) {
+    return `[session-hold] ${hold.kind} hold on focus ${hold.focusId.slice(0, 8)}`;
+}
+async function fireExpiredHold(hold, team, nowMs, deps) {
+    const elapsedMs = nowMs - hold.recordedAtMs;
+    const { outcome, detail } = resolveSessionHoldExpiry(hold, team, deps.isDirectiveStillQueued);
+    if (outcome === 'drop') {
+        clearSessionHold(hold.focusId, hold.kind);
+        log.debug(`${holdTag(hold)} dropped at expiry (${detail})`);
+        return null;
+    }
+    const reason = `${hold.reason}; ${detail}`;
+    log.warn(`${holdTag(hold)} expired after ${Math.round(elapsedMs / 1000)}s -- fired: ${outcome} (${reason})`);
+    const expired = { hold, team, elapsedMs, reason, cause: 'still_active' };
+    const fired = outcome === 'teardown'
+        ? await fireTeardown(expired, nowMs, deps)
+        : await fireEscalation(expired, nowMs, deps);
+    return { focusId: hold.focusId, kind: hold.kind, fired, elapsedMs, reason };
+}
+async function fileHoldEscalation(expired, deps) {
+    try {
+        await deps.fileEscalation(expired);
+    }
+    catch (err) {
+        log.warn(`${holdTag(expired.hold)} escalation filing failed: ${err.message}`);
+    }
+}
+/**
+ * One filing per expiry, never repeated for this hold: re-window it so the NEXT
+ * expiry ends in teardown rather than a second escalation.
+ */
+async function fireEscalation(expired, nowMs, deps) {
+    const { hold } = expired;
+    holds.get(hold.focusId)?.set(hold.kind, { ...hold, escalated: true, recordedAtMs: nowMs });
+    await fileHoldEscalation(expired, deps);
+    return 'escalation';
+}
+/**
+ * Tear the held team down. A teardown that cannot signal the lead keeps the hold
+ * and re-windows it for a bounded retry; the last allowed attempt force-reaps.
+ */
+async function fireTeardown(expired, nowMs, deps) {
+    const { hold } = expired;
+    if (deps.terminateTeam(hold.focusId, SESSION_HOLD_TEARDOWN_REASON[hold.kind])) {
+        clearSessionHold(hold.focusId, hold.kind);
+        return 'teardown';
+    }
+    const attempts = (hold.teardownAttempts ?? 0) + 1;
+    const attemptNote = `teardown attempt ${attempts}/${SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS} found no signalable lead`;
+    if (attempts >= SESSION_HOLD_TEARDOWN_MAX_ATTEMPTS)
+        return forceCleanup(expired, attemptNote, deps);
+    holds.get(hold.focusId)?.set(hold.kind, {
+        ...hold, teardownAttempts: attempts, recordedAtMs: nowMs, maxMs: SESSION_HOLD_TEARDOWN_RETRY_MS,
+    });
+    log.warn(`${holdTag(hold)} ${attemptNote} -- fired: teardown_retry ` +
+        `(hold re-windowed for ${Math.round(SESSION_HOLD_TEARDOWN_RETRY_MS / 1000)}s)`);
+    return 'teardown_retry';
+}
+/**
+ * Terminal outcome of a teardown that never reached the lead: clear the hold,
+ * force-reap the stale registration (so the pending-spawn pass stops excluding
+ * the focus), and file ONE escalation naming the forced cleanup.
+ */
+async function forceCleanup(expired, attemptNote, deps) {
+    const { hold } = expired;
+    clearSessionHold(hold.focusId, hold.kind);
+    let registration;
+    try {
+        registration = await deps.forceReapTeam(hold.focusId, SESSION_HOLD_TEARDOWN_REASON[hold.kind]) ? 'reaped' : 'already gone';
+    }
+    catch (err) {
+        registration = `reap failed: ${err.message}`;
+    }
+    log.warn(`${holdTag(hold)} ${attemptNote} -- fired: forced_cleanup (registration ${registration}; escalated; ${expired.reason})`);
+    await fileHoldEscalation({ ...expired, cause: 'teardown_unsignalable' }, deps);
+    return 'forced_cleanup';
+}
+/**
+ * Sweep every recorded hold once. A hold whose team exited or was replaced is
+ * dropped; an expired hold fires its (re-checked) outcome. Returns what fired.
+ */
+export async function sweepExpiredSessionHolds(nowMs, deps) {
+    const fired = [];
+    const snapshot = [...holds.values()].flatMap((byKind) => [...byKind.values()]);
+    for (const hold of snapshot) {
+        const team = deps.getActiveTeam(hold.focusId);
+        if (!team || teamIdentityMs(team.startedAt) !== hold.teamStartedAtMs) {
+            clearSessionHold(hold.focusId, hold.kind);
+            continue;
+        }
+        if (nowMs - hold.recordedAtMs < hold.maxMs)
+            continue;
+        const result = await fireExpiredHold(hold, team, nowMs, deps);
+        if (result)
+            fired.push(result);
+    }
+    return fired;
+}
+//# sourceMappingURL=session-hold.js.map

package/dist/completion/session-hold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hold.js","sourceRoot":"","sources":["../../src/completion/session-hold.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,qFAAqF;AACrF,sFAAsF;AACtF,gFAAgF;AAChF,yDAAyD;AACzD,mEAAmE;AACnE,+EAA+E;AAC/E,gBAAgB;AAmDhB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAmBrD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAEpD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AASrD,sGAAsG;AACtG,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,GAAG,MAAM,CAAC;AAE3D,yEAAyE;AACzE,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,MAAM,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,MAAM,CAAC;AAEvD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD,MAAM,CAAC,MAAM,8BAA8B,GAAqB;IAC9D,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,+BAA+B,EAAE,QAAQ,EAAE,UAAU;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAqB;IAC3D,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,UAAU;CACpF,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAqB;IAC/D,IAAI,EAAE,+BAA+B,EAAE,KAAK,EAAE,gCAAgC,EAAE,QAAQ,EAAE,UAAU;CACrG,CAAC;AAEF,gGAAgG;AAChG,MAAM,CAAC,MAAM,4BAA4B,GAAwE;IAC/G,6BAA6B,EAAE,SAAS;IACxC,gBAAgB,EAAE,UAAU;IAC5B,wBAAwB,EAAE,UAAU;IACpC,6BAA6B,EAAE,oBAAoB;CACpD,CAAC;AA6BF,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6C,CAAC;AAEnE,SAAS,cAAc,CAAC,SAA2B;IACjD,OAAO,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAgC,CAAC;IACnF,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAgB,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,eAAe,KAAK,eAAe;QACxF,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QAC1H,CAAC,CAAC;YACA,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe;YACf,YAAY,EAAE,KAAK,CAAC,KAAK;YACzB,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;IACJ,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAK3C;IACC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,qBAAqB,GAAG,4BAA4B,CAAC;IAC7G,OAAO,iBAAiB,CAAC;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,+BAA+B;QACrC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3C,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,8DAA8D;QACtE,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,aAAa,EAAE,IAAI,CAAC,WAAW;KAChC,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,IAAsB;IACtE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,6BAA6B;IAC3C,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AA4CD;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAiB,EACjB,IAAqB,EACrB,sBAAsE;IAEtE,IAAI,IAAI,CAAC,IAAI,KAAK,+BAA+B,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC;YACjG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,+DAA+D,EAAE;YAClG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,uDAAuD,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,sBAAsB;YAChC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,uEAAuE,EAAE;YAC7G,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC;IACjF,CAAC;IACD,6EAA6E;IAC7E,wEAAwE;IACxE,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,uDAAuD,EAAE,CAAC;IAClG,CAAC;IACD,MAAM,mBAAmB,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;IAClG,IAAI,CAAC,mBAAmB;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC;IACrH,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,wCAAwC,EAAE,CAAC;IACrG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,OAAO,CAAC,IAAiB;IAChC,OAAO,kBAAkB,IAAI,CAAC,IAAI,kBAAkB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAiB,EACjB,IAAqB,EACrB,KAAa,EACb,IAA0B;IAE1B,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;IAC5C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9F,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,uBAAuB,MAAM,GAAG,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;IAC3C,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAuB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC7F,MAAM,KAAK,GAAG,OAAO,KAAK,UAAU;QAClC,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;QAC1C,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAA2B,EAAE,IAA0B;IACvF,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA+B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAAC,OAA2B,EAAE,KAAa,EAAE,IAA0B;IAClG,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,OAA2B,EAAE,KAAa,EAAE,IAA0B;IAChG,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9E,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,oBAAoB,QAAQ,IAAI,kCAAkC,2BAA2B,CAAC;IAClH,IAAI,QAAQ,IAAI,kCAAkC;QAAE,OAAO,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACpG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QACtC,GAAG,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B;KAChG,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CACN,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,4BAA4B;QAC3D,yBAAyB,IAAI,CAAC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,IAAI,CAC/E,CAAC;IACF,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAC,OAA2B,EAAE,WAAmB,EAAE,IAA0B;IACtG,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC;IAC7H,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,GAAG,gBAAiB,GAAa,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,2CAA2C,YAAY,gBAAgB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAClI,MAAM,kBAAkB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/E,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAa,EACb,IAA0B;IAE1B,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/E,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,eAAe,EAAE,CAAC;YACrE,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK;YAAE,SAAS;QACrD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/completion/state-cascade.d.ts

@@ -2,6 +2,7 @@ import type { DaemonConfig, PipelineConfig } from '../types/index.js';
 import type { FocusDeliveryInfo } from '../types/index.js';
 import { type SettleSweepOutcome } from './settle-injection-sweep.js';
 import { type FocusExecutionPhase } from '../focus/focus-phase.js';
+import { type ReviewNextStepIssue } from './review-next-step.js';
 /** Injectable dependencies for cascade functions (testing). */
 export interface CascadeDeps {
     getFocusDeliveries: (focusId: string) => Promise<FocusDeliveryInfo[]>;
@@ -37,6 +38,24 @@ export interface CascadeDeps {
      * object omitting it behaves as before (no hold).
      */
     hasOpenBreakerHold?: (focusId: string) => Promise<boolean>;
+    /**
+     * Whether the review-cycle cap holds the focus (focus/review-cycle-cap-hold.ts):
+     * its review loop reached TELORA_REVIEW_CYCLE_CAP without converging. The same
+     * hold every spawn gate reads; checkAutoReview declines to open the window while
+     * held. Fails CLOSED (unlike hasOpenBreakerHold). Wired per focus by
+     * runFocusCascadePass, which holds the row's review_cycle_count; a partial test
+     * deps object omitting it behaves as before (no hold).
+     */
+    isReviewCycleCapHeld?: (focusId: string) => Promise<boolean>;
+    /**
+     * The focus's issues, read by checkAutoReview for the open-work half of the
+     * shared review-next-step decision (completion/review-next-step.ts) -- read
+     * only once the focus has converged on verify with review enabled. A read
+     * failure fails OPEN (the window opens on the delivery census, as before).
+     * Optional: present in the default deps so production always applies the
+     * open-work matrix; a partial test deps object omitting it reads no issues.
+     */
+    getFocusIssues?: (focusId: string) => Promise<readonly ReviewNextStepIssue[]>;
 }
 /**
  * Whether a settle sweep's outcome permits latching the focus as swept (quiet

package/dist/completion/state-cascade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-cascade.d.ts","sourceRoot":"","sources":["../../src/completion/state-cascade.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAU3D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAoBrF,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACtE,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D;AAqCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAExE;AAcD;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAGxD;AA8BD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,IAAI,GAAE,WAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAyFf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,IAAI,GAAE,WAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAsEf;AAiJD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1E"}
+{"version":3,"file":"state-cascade.d.ts","sourceRoot":"","sources":["../../src/completion/state-cascade.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAW3D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAA8C,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAqB7G,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACtE,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;CAC/E;AAsCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAExE;AAcD;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAGxD;AA2ED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,IAAI,GAAE,WAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgFf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,EAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,IAAI,GAAE,WAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAsEf;AA4JD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1E"}