@telora/daemon 0.22.245 → 0.22.290

package/dist/completion/review-exit/review-exit-escalations.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Escalation tail of the review-exit gate.
+ *
+ * Every notice in this module fires AFTER routing has already been decided --
+ * none of them gate a delivery transition. The delivery has moved toward intent
+ * (or been held) by the time any of these file; what they carry is the residue
+ * the routing decider or an agent reconciles: a hand-off that keeps routing
+ * nothing, a review whose coverage keeps falling behind the branch, a gaps_found
+ * verdict with nothing actionable filed, an agent that skipped review_complete.
+ * (The review-cycle cap, which DOES stop the loop, lives in review-cycle-cap.ts
+ * and files through fileDedupedFocusEscalation here.)
+ *
+ * Kept apart from review-exit-phase.ts to hold that file under the daemon
+ * file-size limit -- sibling of review-exit-shortfall.ts, same seam. The filers
+ * share one deduped filer, `fileDedupedFocusEscalation`.
+ *
+ * History: docs/daemon/history-team-lifecycle.md (completion/review-exit/review-exit-escalations.ts).
+ *
+ * @module completion/review-exit/review-exit-escalations
+ */
+import { ESCALATION_REASONS } from '@telora/daemon-core';
+import type { hasOpenFocusEscalation } from '../../queries/escalations/escalations.js';
+import type { createEscalation } from '../../supervision/escalation-filing.js';
+import type { clearReviewRequestedAt, setReviewHandoffCount } from '../../queries/focuses/focuses.js';
+import type { resolveReviewHandoffCap } from '../../supervision/stall-detector-config.js';
+import { type HumanAct } from '../../queries/escalations/filing-observation.js';
+/** The slice of ReviewExitDeps this module needs (structural, so no import cycle). */
+export interface ReviewExitEscalationDeps {
+    createEscalation: typeof createEscalation;
+    hasOpenFocusEscalation: typeof hasOpenFocusEscalation;
+}
+/** Focus/session anchor shared by every review-exit escalation. */
+export interface ReviewExitEscalationContext {
+    organizationId: string;
+    focusId: string;
+    focusName: string;
+    sessionId: string;
+    /**
+     * The focus-branch head this review pass covered (reviewSpawnTip, else the exit
+     * tip), or null when unknown. The hand-off breaker records it as the head it
+     * crossed on; the hold ends when the focus branch moves past it
+     * (review-breaker-hold.ts). Optional: a context without it records no head.
+     */
+    coveredSha?: string | null;
+}
+/**
+ * A compact summary of one open, blocking, review-filed finding on a focus,
+ * enumerated in the hand-off-exhausted escalation and the review-cycle cap
+ * observation so whoever routes them sees the outstanding findings without
+ * opening the daemon log.
+ */
+export interface ReviewFiledFindingSummary {
+    /** The issue id -- carried so the re-homing pass can move the issue. */
+    id: string;
+    key: string;
+    title: string;
+    deliveryId: string | null;
+    /** The issue's current description -- preserved when the issue is re-homed. */
+    description: string | null;
+}
+/**
+ * File a focus-anchored needs_operator escalation, at most one open per
+ * (focus, kind). Each caller decides `humanAct`: a named act only a human can
+ * perform reaches the operator; NO_HUMAN_ACT files an observation the focus's
+ * next agent session decides (supervision/filing-route.ts).
+ *
+ * Best-effort throughout: a dedup-probe failure files anyway (a duplicate
+ * notice is cheaper than a swallowed one), and a create failure is logged, not
+ * thrown -- none of these notices may abort an exit handler that has already
+ * written delivery state. Returns whether a row of the kind is now open (filed,
+ * or already open): the review-cycle cap (review-cycle-cap.ts) resets its count
+ * only once its observation exists.
+ *
+ * `label` names the site in the warn lines so the pre-extraction log text
+ * survives verbatim.
+ */
+export declare function fileDedupedFocusEscalation(deps: ReviewExitEscalationDeps, ctx: ReviewExitEscalationContext, args: {
+    escalationKind: string;
+    label: string;
+    description: string;
+    metadata: Record<string, unknown>;
+    /** Required so every site states its routing: a named act, or NO_HUMAN_ACT. */
+    humanAct: HumanAct | null;
+    reasonType?: typeof ESCALATION_REASONS[keyof typeof ESCALATION_REASONS];
+    onFiled?: () => void;
+}): Promise<boolean>;
+/**
+ * Drift persisted after the full-pass respawn -- an operator must look.
+ *
+ * Raised only on the SECOND consecutive below-coverage clean exit: the focus
+ * branch advanced DURING each review pass, so a clean review never covered the
+ * exact state it would have approved.
+ */
+export declare function fileCoverageIncompleteEscalation(deps: ReviewExitEscalationDeps, ctx: ReviewExitEscalationContext, args: {
+    coveredSha: string | null;
+    currentBranchTip: string | null;
+    streak: number;
+}): Promise<void>;
+/** Deps for the bounded hand-off decision: the escalation deps plus the two focus writers it drives. */
+export interface HandoffBoundDeps extends ReviewExitEscalationDeps {
+    clearReviewRequestedAt: typeof clearReviewRequestedAt;
+    setReviewHandoffCount: typeof setReviewHandoffCount;
+    resolveReviewHandoffCap: typeof resolveReviewHandoffCap;
+    /**
+     * Resolve any open review_handoff_exhausted escalation for the focus -- the
+     * durable breaker HOLD. Called on a real delta so a focus that resumes progress
+     * lifts its own hold (returns the count resolved). The state cascade also ends
+     * it when the focus branch moves past the head it crossed on
+     * (review-breaker-hold.ts), and a resolve still clears it.
+     */
+    resolveHandoffExhaustedHold: (focusId: string, notes: string) => Promise<number>;
+}
+/**
+ * Bound the review-exit hand-off. Called ONLY when a review exit routed nothing
+ * AND a spawn directive is pending -- the branch that used to leave
+ * review_requested_at set unconditionally "for the incoming team", re-making an
+ * unverified promise forever.
+ *
+ * Counts consecutive routes-nothing hand-offs in a DURABLE focus counter (so the
+ * bound survives a daemon restart, which would reset an in-memory counter and
+ * make the loop look fresh each cycle). Under the cap: record the incremented
+ * count and leave review_requested_at set (the legitimate hand-off). AT the cap:
+ * stop re-asserting -- close the review window (clear review_requested_at,
+ * removing the precondition that re-fires the branch) and file ONE
+ * review_handoff_exhausted escalation instead, so a review exit can no longer
+ * re-create the condition that produced it. All writes best-effort.
+ */
+export declare function recordHandoffAndMaybeTerminate(deps: HandoffBoundDeps, ctx: ReviewExitEscalationContext, currentHandoffCount: number, opts?: {
+    /**
+     * What produced this no-progress cycle, for accurate logging. Two callers
+     * share the ONE durable counter (both are no-progress review exits):
+     *   - 'pending_spawn_handoff' (default): nothing routed, a spawn directive is
+     *     pending, so the flag is left set "for the incoming team".
+     *   - 'no_delta_cycle': a status was routed but focus state did not change
+     *     (the empty verify->verify_failed round trip).
+     */
+    trigger?: 'pending_spawn_handoff' | 'no_delta_cycle';
+    /**
+     * The EXITING session's type. The hand-off breaker measures ONLY review-pass
+     * exits: a coding pass cannot approve a review, so its routes-nothing exit
+     * was never a routing candidate and must not advance the cap (2026-08-27:
+     * two CODING exits exhausted the cap without one review exit having failed,
+     * then the breaker filed an escalation asserting the focus was done while a
+     * P1 finding was open). When present and NOT 'review', this is a no-op --
+     * the counter does not advance and no escalation is filed. Absent preserves
+     * the legacy count-any-exit behavior for callers/tests that predate the gate.
+     */
+    sessionType?: 'coding' | 'review';
+    /**
+     * Open, blocking, review-filed findings on the focus, resolved by the
+     * handler. Enumerated in the exhausted escalation (and its metadata) so the
+     * escalation states what it MEASURED instead of asserting "nothing to route".
+     */
+    openBlockingFindings?: ReviewFiledFindingSummary[];
+}): Promise<void>;
+/**
+ * Pure: who owns an exhausted review hand-off, decided from what was MEASURED.
+ *
+ * Open blocking findings -> NO_HUMAN_ACT: routing or re-homing them onto a
+ * delivery is Telora planning work an agent session performs. Zero findings ->
+ * the focus reads as done, and closing it is the completion act humans own (the
+ * breaker hold is kind-keyed, so either route keeps the review window held).
+ */
+export declare function handoffExhaustedHumanAct(focusName: string, openBlockingFindingCount: number): HumanAct | null;
+/**
+ * The review hand-off has terminated. The review-exit hand-off branch re-asserts
+ * an unverified promise -- "the incoming team will route it" -- and re-makes it
+ * unchanged when it fails. After TELORA_REVIEW_HANDOFF_CAP consecutive
+ * routes-nothing hand-offs the daemon stops re-asserting: it closes the review
+ * window (clears review_requested_at, removing the precondition that re-fires the
+ * branch) and files THIS escalation instead. One open row per focus.
+ */
+export declare function fileHandoffExhaustedEscalation(deps: ReviewExitEscalationDeps, ctx: ReviewExitEscalationContext, args: {
+    handoffCount: number;
+    cap: number;
+    trigger?: 'pending_spawn_handoff' | 'no_delta_cycle';
+    openBlockingFindings?: ReviewFiledFindingSummary[];
+}): Promise<void>;
+/**
+ * The routing inconsistency the review-exit gate exists to catch: the review
+ * stamped a gaps_found VERDICT but no verify delivery carried blocking open
+ * work, so the coding team has nothing concrete to close.
+ *
+ * The verdict has already routed the delivery to verify_failed (toward intent,
+ * never toward done) by the time this files. Mutually exclusive with the
+ * missing-report notice by construction: gaps_found implies reportExists=true,
+ * and that notice requires !reportExists.
+ */
+export declare function fileGapsWithoutIssueEscalation(deps: ReviewExitEscalationDeps, ctx: ReviewExitEscalationContext): Promise<void>;
+/**
+ * Surface that the agent skipped review_complete even though the loop healed.
+ *
+ * Fires only when routing happened via BLOCKING issue evidence: a review that
+ * filed only deferrable low-severity notes converged cleanly (auto-approve), so
+ * it neither re-coded nor "skipped" a needed outcome -- raising the notice there
+ * would be operator noise. Deliberately NOT deduped: it is a per-exit hygiene
+ * notice about one session's behavior, not a standing focus condition.
+ */
+export declare function fileMissingReportNotice(deps: ReviewExitEscalationDeps, ctx: ReviewExitEscalationContext): Promise<void>;
+//# sourceMappingURL=review-exit-escalations.d.ts.map

package/dist/completion/review-exit/review-exit-escalations.d.ts.map

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

package/dist/completion/review-exit/review-exit-escalations.js

@@ -0,0 +1,326 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/completion/review-cycle-budget/review-exit-breaker-hold.test.ts,
+//   packages/daemon/src/completion/review-exit/review-exit-rehoming.test.ts
+// PINNED-BY-END
+/**
+ * Escalation tail of the review-exit gate.
+ *
+ * Every notice in this module fires AFTER routing has already been decided --
+ * none of them gate a delivery transition. The delivery has moved toward intent
+ * (or been held) by the time any of these file; what they carry is the residue
+ * the routing decider or an agent reconciles: a hand-off that keeps routing
+ * nothing, a review whose coverage keeps falling behind the branch, a gaps_found
+ * verdict with nothing actionable filed, an agent that skipped review_complete.
+ * (The review-cycle cap, which DOES stop the loop, lives in review-cycle-cap.ts
+ * and files through fileDedupedFocusEscalation here.)
+ *
+ * Kept apart from review-exit-phase.ts to hold that file under the daemon
+ * file-size limit -- sibling of review-exit-shortfall.ts, same seam. The filers
+ * share one deduped filer, `fileDedupedFocusEscalation`.
+ *
+ * History: docs/daemon/history-team-lifecycle.md (completion/review-exit/review-exit-escalations.ts).
+ *
+ * @module completion/review-exit/review-exit-escalations
+ */
+import { ESCALATION_REASONS, ESCALATION_DISPOSITIONS } from '@telora/daemon-core';
+import { NO_HUMAN_ACT } from '../../queries/escalations/filing-observation.js';
+import { breakerHoldEndCondition, CROSSED_ON_HEAD_KEY, REVIEW_HANDOFF_EXHAUSTED_ESCALATION_KIND, } from '../review-cycle-budget/review-breaker-hold.js';
+import { createLogger } from '../../log/daemon-log.js';
+import { stopFires } from '../../supervision/stop-registry.js';
+const log = createLogger({ module: 'focus-executor' });
+/**
+ * File a focus-anchored needs_operator escalation, at most one open per
+ * (focus, kind). Each caller decides `humanAct`: a named act only a human can
+ * perform reaches the operator; NO_HUMAN_ACT files an observation the focus's
+ * next agent session decides (supervision/filing-route.ts).
+ *
+ * Best-effort throughout: a dedup-probe failure files anyway (a duplicate
+ * notice is cheaper than a swallowed one), and a create failure is logged, not
+ * thrown -- none of these notices may abort an exit handler that has already
+ * written delivery state. Returns whether a row of the kind is now open (filed,
+ * or already open): the review-cycle cap (review-cycle-cap.ts) resets its count
+ * only once its observation exists.
+ *
+ * `label` names the site in the warn lines so the pre-extraction log text
+ * survives verbatim.
+ */
+export async function fileDedupedFocusEscalation(deps, ctx, args) {
+    const { focusId, focusName, organizationId, sessionId } = ctx;
+    let alreadyOpen = false;
+    try {
+        // A pure DEDUP read: a promoted refile of this kind, or the kind correlated
+        // onto an open incident row, already signals it (never read as a hold here).
+        alreadyOpen = await deps.hasOpenFocusEscalation(focusId, args.escalationKind, { matchCorrelated: true });
+    }
+    catch (err) {
+        log.warn(`hasOpenFocusEscalation (${args.label}) failed for "${focusName}": ${err.message}`);
+    }
+    if (alreadyOpen)
+        return true;
+    try {
+        await deps.createEscalation({
+            organizationId,
+            sessionId,
+            issueId: null,
+            reasonType: args.reasonType ?? ESCALATION_REASONS.DECISION_NEEDED,
+            disposition: ESCALATION_DISPOSITIONS.NEEDS_OPERATOR,
+            humanAct: args.humanAct,
+            anchor: { focusId, sessionId },
+            description: args.description,
+            escalationKind: args.escalationKind,
+            metadata: args.metadata,
+        });
+        args.onFiled?.();
+        return true;
+    }
+    catch (err) {
+        log.warn(`createEscalation (${args.label}) failed for "${focusName}": ${err.message}`);
+        return false;
+    }
+}
+/**
+ * Drift persisted after the full-pass respawn -- an operator must look.
+ *
+ * Raised only on the SECOND consecutive below-coverage clean exit: the focus
+ * branch advanced DURING each review pass, so a clean review never covered the
+ * exact state it would have approved.
+ */
+export async function fileCoverageIncompleteEscalation(deps, ctx, args) {
+    await fileDedupedFocusEscalation(deps, ctx, {
+        escalationKind: 'review_coverage_incomplete',
+        label: 'coverage',
+        description: `Focus "${ctx.focusName}" review coverage keeps falling behind the branch tip: ` +
+            `the focus branch advanced DURING each of the last ${args.streak} review passes, ` +
+            `so a clean review never covered the exact state being approved. A full-pass ` +
+            `re-review was already armed once and drift persisted. An operator must decide: ` +
+            `pause commits during review, or close/descope the focus.`,
+        // Holding commits while a review pass runs is sequencing on the focus branch
+        // -- machine work; the spawn block it raises self-clears on stabilization.
+        humanAct: NO_HUMAN_ACT,
+        metadata: {
+            covered_sha: args.coveredSha,
+            current_tip: args.currentBranchTip,
+            drift_streak: args.streak,
+        },
+        onFiled: () => {
+            log.warn(`[focus-executor] review_coverage_incomplete escalation filed for "${ctx.focusName}" (drift streak ${args.streak}).`);
+        },
+    });
+}
+/**
+ * Bound the review-exit hand-off. Called ONLY when a review exit routed nothing
+ * AND a spawn directive is pending -- the branch that used to leave
+ * review_requested_at set unconditionally "for the incoming team", re-making an
+ * unverified promise forever.
+ *
+ * Counts consecutive routes-nothing hand-offs in a DURABLE focus counter (so the
+ * bound survives a daemon restart, which would reset an in-memory counter and
+ * make the loop look fresh each cycle). Under the cap: record the incremented
+ * count and leave review_requested_at set (the legitimate hand-off). AT the cap:
+ * stop re-asserting -- close the review window (clear review_requested_at,
+ * removing the precondition that re-fires the branch) and file ONE
+ * review_handoff_exhausted escalation instead, so a review exit can no longer
+ * re-create the condition that produced it. All writes best-effort.
+ */
+export async function recordHandoffAndMaybeTerminate(deps, ctx, currentHandoffCount, opts) {
+    const trigger = opts?.trigger ?? 'pending_spawn_handoff';
+    // MEASURE, don't assume: the breaker counts only review-pass exits. A
+    // non-review exit that routed nothing was never a review routing candidate.
+    if (opts?.sessionType && opts.sessionType !== 'review') {
+        log.info(`[focus-executor] "${ctx.focusName}" ${opts.sessionType} session exit routed nothing ` +
+            `(trigger=${trigger}) -- not a review pass; hand-off counter not advanced.`);
+        return;
+    }
+    const handoffCap = deps.resolveReviewHandoffCap();
+    const nextHandoffCount = currentHandoffCount + 1;
+    const persist = async () => {
+        try {
+            await deps.setReviewHandoffCount(ctx.focusId, nextHandoffCount);
+        }
+        catch (err) {
+            log.warn(`[focus-executor] setReviewHandoffCount failed for "${ctx.focusName}": ${err.message}`);
+        }
+    };
+    if (stopFires('review_handoff_breaker', { nextHandoffCount, cap: handoffCap })) {
+        // Exhausted: terminate the hand-off. RESET the durable counter to zero (not
+        // persist the crossing count): the open review_handoff_exhausted escalation is
+        // now the durable HOLD checkAutoReview honours. Resetting to zero stops the
+        // 2026-09-10 re-file loop -- after an operator DISMISSES the escalation the
+        // counter climbs from zero again, so a fresh `cap` no-delta cycles are needed
+        // to re-cross (a dismissal is never immediately followed by a re-file). Close
+        // the window and file one escalation (deduped one-open-per-focus).
+        try {
+            await deps.setReviewHandoffCount(ctx.focusId, 0);
+        }
+        catch (err) {
+            log.warn(`[focus-executor] setReviewHandoffCount(0) on crossing failed for "${ctx.focusName}": ${err.message}`);
+        }
+        await deps.clearReviewRequestedAt(ctx.focusId);
+        await fileHandoffExhaustedEscalation(deps, ctx, {
+            handoffCount: nextHandoffCount,
+            cap: handoffCap,
+            trigger,
+            openBlockingFindings: opts?.openBlockingFindings ?? [],
+        });
+        log.warn(`[focus-executor] "${ctx.focusName}" review no-progress bound EXHAUSTED (${nextHandoffCount} >= cap ${handoffCap}, ` +
+            `trigger=${trigger}) -- counter reset to 0, review_requested_at cleared and review_handoff_exhausted ` +
+            `escalation filed (the durable hold); ${breakerHoldEndCondition(ctx.coveredSha ?? null)}.`);
+    }
+    else {
+        // Under the cap: record the incremented count. For the pending-spawn hand-off
+        // this leaves review_requested_at set for the incoming team; for a no-delta
+        // routed cycle the flag was already cleared by the routed block and the count
+        // simply climbs toward the cap.
+        await persist();
+        const detail = trigger === 'no_delta_cycle'
+            ? 'routed a status but focus state did not change (no-delta cycle)'
+            : 'routed nothing and a spawn directive is pending -- leaving review_requested_at set for the incoming team';
+        log.info(`[focus-executor] "${ctx.focusName}" review exit ${detail} ` +
+            `(no-progress ${nextHandoffCount}/${handoffCap}).`);
+    }
+}
+/**
+ * Pure: who owns an exhausted review hand-off, decided from what was MEASURED.
+ *
+ * Open blocking findings -> NO_HUMAN_ACT: routing or re-homing them onto a
+ * delivery is Telora planning work an agent session performs. Zero findings ->
+ * the focus reads as done, and closing it is the completion act humans own (the
+ * breaker hold is kind-keyed, so either route keeps the review window held).
+ */
+export function handoffExhaustedHumanAct(focusName, openBlockingFindingCount) {
+    if (openBlockingFindingCount > 0)
+        return NO_HUMAN_ACT;
+    return {
+        kind: 'unreachable_capability',
+        act: `Close focus "${focusName}" if its work is done (0 open blocking review-filed findings were ` +
+            `measured), or re-scope it with the work that remains.`,
+    };
+}
+function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * The review hand-off has terminated. The review-exit hand-off branch re-asserts
+ * an unverified promise -- "the incoming team will route it" -- and re-makes it
+ * unchanged when it fails. After TELORA_REVIEW_HANDOFF_CAP consecutive
+ * routes-nothing hand-offs the daemon stops re-asserting: it closes the review
+ * window (clears review_requested_at, removing the precondition that re-fires the
+ * branch) and files THIS escalation instead. One open row per focus.
+ */
+export async function fileHandoffExhaustedEscalation(deps, ctx, args) {
+    // ENUMERATE what the breaker measured. The old text asserted "there was no
+    // work left to route" and asked the operator to confirm the focus is done --
+    // untested, and false in the 2026-08-27 incident (a P1 finding was open the
+    // whole time). State the measured open blocking review-filed findings instead,
+    // or say there are none as a measured result.
+    const findings = args.openBlockingFindings ?? [];
+    const findingsBlock = findings.length > 0
+        ? `\n\nMEASURED: ${findings.length} open blocking review-filed finding(s) remain on this focus ` +
+            `-- the focus is NOT clean:\n` +
+            findings
+                .map(f => `  - ${f.key}: ${f.title}${f.deliveryId ? ` (delivery ${f.deliveryId})` : ''}`)
+                .join('\n') +
+            `\n\nRoute or descope these findings; do not close the focus while they are open.`
+        : `\n\nMEASURED: 0 open blocking review-filed findings on this focus at exit. If the focus is ` +
+            `genuinely done, close/descope it; otherwise resolve why the review window kept re-opening ` +
+            `with no work to route.`;
+    // Name the hold this row IS, and what ends it -- the same words the state cascade's hold log line uses.
+    const crossedOnHead = ctx.coveredSha ?? null;
+    const holdBlock = `\n\nHOLD: while this escalation is open it holds the focus's review window -- no review ` +
+        `window opens and no review team spawns. ${capitalize(breakerHoldEndCondition(crossedOnHead))}.`;
+    await fileDedupedFocusEscalation(deps, ctx, {
+        escalationKind: REVIEW_HANDOFF_EXHAUSTED_ESCALATION_KIND,
+        label: 'handoff-exhausted',
+        reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+        description: `Review of "${ctx.focusName}" handed off to an incoming review team ${args.handoffCount} time(s) ` +
+            `(cap ${args.cap}) without any review session routing a delivery. The daemon has CLOSED the ` +
+            `review window (cleared review_requested_at) and stopped re-asserting the hand-off, so the ` +
+            `self-perpetuating loop cannot re-create its own precondition.` +
+            holdBlock +
+            findingsBlock,
+        humanAct: handoffExhaustedHumanAct(ctx.focusName, findings.length),
+        metadata: {
+            session_id: ctx.sessionId,
+            handoff_count: args.handoffCount,
+            cap: args.cap,
+            routed_via: 'handoff_exhausted',
+            trigger: args.trigger ?? 'pending_spawn_handoff',
+            open_blocking_review_filed_count: findings.length,
+            open_blocking_review_filed_findings: findings.map(f => f.key),
+            // The head the breaker crossed on: the hold ends when the focus branch moves past it (review-breaker-hold.ts).
+            [CROSSED_ON_HEAD_KEY]: crossedOnHead,
+            // Cause-cleared terminator: when the focus converges this row describes
+            // nothing and is auto-swept (resolveConvergedFocusEscalations).
+            terminates_when: 'focus_converged',
+        },
+        onFiled: () => {
+            log.warn(`[focus-executor] review_handoff_exhausted escalation filed for "${ctx.focusName}" ` +
+                `(hand-offs=${args.handoffCount}, cap=${args.cap}); review window closed.`);
+        },
+    });
+}
+/**
+ * The routing inconsistency the review-exit gate exists to catch: the review
+ * stamped a gaps_found VERDICT but no verify delivery carried blocking open
+ * work, so the coding team has nothing concrete to close.
+ *
+ * The verdict has already routed the delivery to verify_failed (toward intent,
+ * never toward done) by the time this files. Mutually exclusive with the
+ * missing-report notice by construction: gaps_found implies reportExists=true,
+ * and that notice requires !reportExists.
+ */
+export async function fileGapsWithoutIssueEscalation(deps, ctx) {
+    await fileDedupedFocusEscalation(deps, ctx, {
+        escalationKind: 'review_gaps_without_issue',
+        label: 'gaps-without-issue',
+        description: `Review of "${ctx.focusName}" stamped outcome=gaps_found but filed no ` +
+            `actionable Bug/Task issue for the coding team. The verify delivery ` +
+            `was routed to verify_failed (never converged to done), but the coding ` +
+            `team has no concrete gap to close. An operator must reconcile: the ` +
+            `review directive requires every gap be filed as an open issue on the ` +
+            `delivery -- either the gap was real (file it) or the verdict should ` +
+            `have been approved.`,
+        // Filing the gap as an issue (or re-reviewing) is a Telora planning call.
+        humanAct: NO_HUMAN_ACT,
+        metadata: { session_id: ctx.sessionId, outcome: 'gaps_found', routed_via: 'gaps_without_issue', terminates_when: 'focus_converged' },
+        onFiled: () => {
+            log.warn(`[focus-executor] review_gaps_without_issue escalation filed for "${ctx.focusName}" ` +
+                `(gaps_found verdict, no blocking issue).`);
+        },
+    });
+}
+/**
+ * Surface that the agent skipped review_complete even though the loop healed.
+ *
+ * Fires only when routing happened via BLOCKING issue evidence: a review that
+ * filed only deferrable low-severity notes converged cleanly (auto-approve), so
+ * it neither re-coded nor "skipped" a needed outcome -- raising the notice there
+ * would be operator noise. Deliberately NOT deduped: it is a per-exit hygiene
+ * notice about one session's behavior, not a standing focus condition.
+ */
+export async function fileMissingReportNotice(deps, ctx) {
+    const { focusId, focusName, organizationId, sessionId } = ctx;
+    try {
+        await deps.createEscalation({
+            organizationId,
+            sessionId,
+            issueId: null,
+            reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+            // Hygiene: tighten the review directive so an outcome is stamped. Routing
+            // already healed, and directive content is an editable repo/seed artifact.
+            disposition: ESCALATION_DISPOSITIONS.NEEDS_OPERATOR,
+            humanAct: NO_HUMAN_ACT,
+            anchor: { focusId, sessionId },
+            description: 'Review session filed issues but did not call focus_review_complete. ' +
+                'Deliveries routed via issue evidence; review_requested_at cleared. ' +
+                'Tighten the review directive so the agent always stamps an outcome.',
+            escalationKind: 'review_missing_report',
+            // Evidence only -- focus provenance is on the columns via the anchor.
+            metadata: { session_id: sessionId, routed_via: 'issue_evidence' },
+        });
+    }
+    catch (err) {
+        log.warn(`[focus-executor] createEscalation (issue-evidence notice) failed for "${focusName}": ${err.message}`);
+    }
+}
+//# sourceMappingURL=review-exit-escalations.js.map

package/dist/completion/review-exit/review-exit-escalations.js.map

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

package/dist/completion/review-exit/review-exit-evidence.d.ts

@@ -0,0 +1,43 @@
+import { type ReviewFindingClasses } from './review-defect-detector.js';
+import type { ReviewFiledFindingSummary } from './review-exit-escalations.js';
+import type { ReviewExitDeps } from './review-exit-deps.js';
+import type { FocusIssueInfo } from '../../types/index.js';
+/** The review-filed evidence bundle the routing decision tree consumes. */
+export interface ReviewExitEvidence {
+    reportExists: boolean;
+    reviewOutcome: 'approved' | 'gaps_found' | null;
+    reviewCreatedIssueIds: string[];
+    hasIssueEvidence: boolean;
+    hasBlockingIssueEvidence: boolean;
+    deferrableIssueIds: Set<string>;
+    attributedDeliveryIds: ReadonlySet<string>;
+    reviewFiledTargetDeliveryIds: ReadonlySet<string>;
+    openBlockingFindings: ReviewFiledFindingSummary[];
+    /**
+     * The focus issue read the signals above were derived from, and the review-filed
+     * id union they keyed on -- carried so the foreign-finding scope
+     * (review-exit-foreign-findings.ts) can re-derive the target sets without the
+     * findings it routed to another focus. Empty on a read failure.
+     */
+    focusIssues: FocusIssueInfo[];
+    reviewFiledIds: ReadonlySet<string>;
+    /**
+     * Each review finding's RECORDED class (blocking / concern), keyed by issue id.
+     * Every blocking decision above keyed on it through isBlockingReviewFinding;
+     * carried so the foreign-finding scope decides with the same facts. Empty when
+     * nothing is recorded or the read failed (-> the priority fallback).
+     */
+    findingClasses: ReviewFindingClasses;
+}
+/**
+ * Gather the review-exit evidence for a focus/session. Every read is best-effort:
+ * a failure logs and degrades to the empty/no-evidence default, exactly as the
+ * inline block did -- routing runs regardless.
+ */
+export declare function gatherReviewExitEvidence(deps: ReviewExitDeps, args: {
+    focusId: string;
+    focusName: string;
+    sessionId: string;
+    reviewRequestedAt: string | null;
+}): Promise<ReviewExitEvidence>;
+//# sourceMappingURL=review-exit-evidence.d.ts.map

package/dist/completion/review-exit/review-exit-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-exit-evidence.d.ts","sourceRoot":"","sources":["../../../src/completion/review-exit/review-exit-evidence.ts"],"names":[],"mappings":"AAuBA,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;IAChD,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,oBAAoB,EAAE,yBAAyB,EAAE,CAAC;IAClD;;;;;OAKG;IACH,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC;;;;;OAKG;IACH,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAuBD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChG,OAAO,CAAC,kBAAkB,CAAC,CAqF7B"}