@telora/daemon 0.22.245 → 0.22.290

package/dist/focus/focus-poller-auto-advance.js

@@ -0,0 +1,442 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/delivery/advance-hold.test.ts,
+//   packages/daemon/src/delivery/delivery-work-start.test.ts,
+//   packages/daemon/src/delivery/discovery-only-auto-advance.test.ts,
+//   packages/daemon/src/focus/focus-activity-progress-clock.test.ts,
+//   packages/daemon/src/focus/focus-poller-auto-advance-guard-measure.test.ts,
+//   packages/daemon/src/focus/focus-poller-auto-advance-team-presence.test.ts,
+//   packages/daemon/src/focus/focus-poller-auto-advance-teamless-wedge.test.ts,
+//   packages/daemon/src/focus/heartbeat-focus-activity.test.ts,
+//   packages/daemon/src/focus/recorded-delivery-auto-advance.test.ts,
+//   packages/daemon/src/integration/advancement-path-parity.test.ts,
+//   packages/daemon/src/integration/shortfall-park-incident-regression.test.ts,
+//   packages/daemon/src/integration/verification-history-round-trip.test.ts
+// PINNED-BY-END
+import { carryVerificationHistory } from '../queries/delivery-gate-state/delivery-gate-state.js';
+import { isStatusAgentActionable } from '../workflow/stage-classifier.js';
+import { OPEN_ISSUE_STATUSES, filterWorkIssues, filterContextGroups } from '../types/issue-status.js';
+import { autoCloseContextGroups, sweepDeliveryCloseIssues } from '../delivery/delivery-close-actions.js';
+import { resolveReconciledWrite, workStartReconcileInput, advanceReconcileInput } from '../delivery/delivery-reconciler-apply.js';
+import { isAuditPhaseFocus } from '../audit/audit-shape.js';
+import { evaluateGuardsForDeliveryTransition } from '../delivery/delivery-lifecycle.js';
+import { hasAdvanceHold, noteAdvanceRefused } from '../delivery/advance-hold.js';
+import { determineTransition } from '../workflow/workflow-engine.js';
+import { resolveOpenFocusEscalationsOfKind } from '../supervision/escalation-clearing.js';
+import { resolveOperatorHold, writeOperatorHoldGateState, describeOperatorHold } from '../delivery/operator-hold.js';
+import { resolveExternalHold, makeDeferredRequestClosureEvaluator, describeExternalHold } from '../delivery/external-hold.js';
+import { surfaceStaleReferenceLessExternalHold } from '../delivery/external-hold-surface.js';
+import { clearSpawnCooldown } from '../supervision/spawn-cooldown.js';
+import { createLogger } from '../log/daemon-log.js';
+const log = createLogger({ module: 'focus-poller' });
+/**
+ * Constants mirroring @telora/daemon-core values. Inlined because this module
+ * avoids a runtime import of @telora/daemon-core so tests can stub transitive
+ * dependencies without fighting tsx's bare-specifier resolution under
+ * --experimental-test-module-mocks. Values must stay in sync with the
+ * canonical enums in packages/daemon-core/src/execution-status.ts and
+ * packages/daemon-core/src/escalation-types.ts.
+ */
+const DELIVERY_STATUS_QUEUED = 'queued';
+const DELIVERY_STATUS_CODING = 'coding';
+const DELIVERY_STATUS_VERIFY = 'verify';
+const DELIVERY_STATUS_VERIFY_FAILED = 'verify_failed';
+/**
+ * Measure the guard at a teamless delivery's advance edge (coding->verify), the
+ * SAME way the team path (advanceDeliveryStage) does, so a blocking guard is not
+ * silently skipped on the teamless path (TEL-2: identical delivery state yields
+ * the identical decision). Inputs are the canonical ones for a teamless advance:
+ * all work issues are Done (openIssueCount 0, so determineTransition selects the
+ * forward edge, not a retry) and exitCode 0 (the same value paused-revival uses
+ * to re-evaluate a block -- so the entry gate and the revival gate agree).
+ *
+ * evaluateGuardsForDeliveryTransition MEASURES and, on a block, writes the
+ * transition_blocks row (the human decision_paths that name the exit, and the
+ * record paused-revival reads back to revive the pause) -- but it does NOT write
+ * the delivery's execution_status (that stays the reconciler's single write).
+ * Returns null when the edge has no workflow transition (nothing to gate).
+ * The production measurement; the composition root binds it (`autoAdvance`).
+ */
+export async function measureAdvanceGuard(config, delivery, workflow, fromStatus) {
+    const currentStage = workflow.stages.find((s) => s.name === fromStatus);
+    if (!currentStage)
+        return null;
+    const transition = determineTransition({
+        workflow,
+        currentStageId: currentStage.id,
+        exitCode: 0,
+        openIssueCount: 0,
+        attemptCount: 0,
+        maxRetries: 5,
+    });
+    if (!transition.nextStage || !transition.workflowTransition)
+        return null;
+    const outcome = await evaluateGuardsForDeliveryTransition({
+        deliveryId: delivery.id,
+        organizationId: config.organizationId,
+        workflowTransition: transition.workflowTransition,
+        exitCode: 0,
+        policyFailureMode: config.policyFailureMode,
+        deliveryName: delivery.name,
+        sessionId: null,
+    });
+    return { blocked: outcome.blocked, gateState: outcome.gateState ?? null };
+}
+/**
+ * The delivery re-opened: nothing waits on the advance any more, so a hold
+ * recorded while it was finished no longer describes it. Logs, never throws.
+ */
+async function clearReopenedAdvanceHold(delivery, clear) {
+    if (!hasAdvanceHold(delivery.gateState))
+        return;
+    await clear(delivery.id).catch((err) => log.warn(`Clearing the advance hold on "${delivery.name}" failed: ${err.message}`));
+}
+export async function checkDeliveryAutoAdvance(config, deps) {
+    const { getActiveFocuses: _getActiveFocuses, getFocusDeliveries: _getFocusDeliveries, getDeliveryIssues: _getDeliveryIssues, updateIssueStatus: _updateIssueStatus, ensureWorktreeCommittedBeforeAdvance: _ensureWorktreeCommittedBeforeAdvance, fetchEffectiveWorkflow: _fetchEffectiveWorkflow, updateDeliveryStatus: _updateDeliveryStatus, findOpenOperatorHoldForDelivery: _findOpenOperatorHoldForDelivery, measureGuardAtAdvance: _measureGuardAtAdvance, } = deps;
+    // Advance a delivery on its OWN state, regardless of whether its focus has a
+    // live team. The former team-presence freeze skipped every focus with an
+    // active team, on the theory that "auto-advancing while a team is executing
+    // causes coding->verify->verify_failed churn" and that the team's own exit
+    // path (advanceDeliveryStatuses) would advance finished deliveries. But that
+    // made advancement eligibility a property of TEAM PRESENCE, not of the
+    // delivery: a finished delivery pinned at `coding` for as long as any team
+    // worked any sibling, and a focus that keeps gaining work keeps a team alive,
+    // so the teamless window in which it could advance never opened. Its recorded
+    // status then contradicted its real state.
+    //
+    // The churn the freeze prevented is now held off per-delivery at the WRITE
+    // point rather than per-focus at SELECTION: a delivery advances out of `coding`
+    // only when (a) all its work issues are Done/Verified/In Review (the openWork
+    // check below) AND (b) the focus worktree is committed
+    // (ensureWorktreeCommittedBeforeAdvance). While a team is actively producing
+    // uncommitted edits the worktree is dirty and the advance is held; once the
+    // work is committed and the delivery's issues are all done, it advances even
+    // with a live team on a sibling. This mirrors the 2026-07-27 move that pushed
+    // hasFocusWorktree from focus selection down to the write point.
+    //
+    // focusId -> audit-phase (isAuditPhaseFocus). A focus is in the audit phase
+    // either explicitly (read_only===true) OR structurally (audit-origin AND not
+    // yet ratified) -- the second signal (injection #7) so a flag-absent audit
+    // focus is still handled as discovery-only instead of wedging the
+    // queued->coding scoping gate. An audit-phase focus's deliveries are
+    // DISCOVERY-ONLY: their contract is Context Group findings, never Task/Bug
+    // issues, so they terminalize without work issues.
+    const focusAuditPhase = new Map();
+    try {
+        const activeFocuses = await _getActiveFocuses(config.organizationId, config.productId);
+        for (const focus of activeFocuses) {
+            // Evaluate EVERY active focus -- teamed or teamless, worktree-registered or
+            // not. Focus SELECTION is independent of both team presence and worktree
+            // registration. Previously this set was gated on _hasFocusWorktree (a
+            // teamless, worktree-less focus was silently unreachable -- 2026-07-27
+            // wedge, delivery c42c1db1) AND on the absence of an active team (a
+            // finished delivery pinned at `coding` while a team worked a sibling). Both
+            // gates moved to the point of the write: git-touching advances stay gated
+            // by ensureWorktreeCommittedBeforeAdvance below (which also holds off the
+            // coding->verify->verify_failed churn the team freeze used to prevent),
+            // while status-only re-queues (verify_failed -> queued) need no disk.
+            focusAuditPhase.set(focus.focus_id, isAuditPhaseFocus({
+                readOnly: focus.read_only === true,
+                auditOrigin: focus.audit_origin === true,
+                ratified: focus.ratified_at != null,
+            }));
+        }
+    }
+    catch (err) {
+        log.warn('Auto-advance: failed to fetch active focuses:', err.message);
+    }
+    for (const [focusId, auditPhase] of focusAuditPhase) {
+        try {
+            const deliveries = await _getFocusDeliveries(focusId);
+            for (const delivery of deliveries) {
+                if (!isStatusAgentActionable(delivery.executionStatus ?? ''))
+                    continue;
+                try {
+                    const issues = await _getDeliveryIssues(delivery.id);
+                    // Context Groups are reference material, not actionable work
+                    const workIssues = filterWorkIssues(issues);
+                    const contextGroups = filterContextGroups(issues);
+                    // A discovery-only delivery (audit-phase focus, no Task/Bug issues) is
+                    // exempt from the scoping gate: it terminalizes once its Context Group
+                    // findings are all resolved (>=1 CG, none open). An un-run audit (no
+                    // CGs yet) is NOT swept -- requiring resolved findings is the
+                    // "discovery complete" signal that prevents killing a pending audit.
+                    // `auditPhase` covers both read_only=true and the second structural
+                    // signal (audit-origin + unratified), so a flag-absent audit focus
+                    // terminalizes too; a NORMAL focus (auditPhase=false) is unaffected.
+                    const discoveryComplete = auditPhase &&
+                        workIssues.length === 0 &&
+                        contextGroups.length > 0 &&
+                        contextGroups.every(cg => !OPEN_ISSUE_STATUSES.has(cg.status));
+                    // Skip deliveries with no work issues (nothing to check), unless this
+                    // is a completed discovery-only delivery that must walk to terminal.
+                    if (workIssues.length === 0 && !discoveryComplete)
+                        continue;
+                    // Single shared open-work predicate (OPEN_ISSUE_STATUSES, the same set
+                    // the reconciler's areDeliveryIssuesDone uses).
+                    const openWork = workIssues.filter(i => OPEN_ISSUE_STATUSES.has(i.status));
+                    if (openWork.length > 0) {
+                        await clearReopenedAdvanceHold(delivery, deps.clearAdvanceHold);
+                        // A delivery with open work never advances FORWARD here. But the
+                        // re-queue edge verify_failed -> queued (delivery-reconciler.ts) is
+                        // the one this teamless pass MUST drive: a verify_failed delivery
+                        // with open work on a teamless focus otherwise has NO invoker and
+                        // sits wedged forever (2026-07-27 incident). checkVerifyDeliveries-
+                        // ForOpenIssues covers only TEAMED focuses; checkDeliveryWorkStart
+                        // owns queued -> coding. So ONLY verify_failed is re-queued here --
+                        // re-queueing `coding` would oscillate against checkDeliveryWorkStart
+                        // (In-Progress work re-advances queued -> coding every tick). The
+                        // re-queue is a STATUS-ONLY write (no git), so no worktree precheck.
+                        if ((delivery.executionStatus ?? '') === DELIVERY_STATUS_VERIFY_FAILED) {
+                            const requeueStatus = (delivery.executionStatus ?? '');
+                            const requeueWorkflow = await _fetchEffectiveWorkflow(delivery.id);
+                            const requeueDecision = resolveReconciledWrite({
+                                // Status-only back-path (verify_failed -> queued): no git touch, no
+                                // guard, no review -- guardVerdict:null is the explicit choice.
+                                input: advanceReconcileInput({
+                                    currentStatus: requeueStatus,
+                                    issues,
+                                    guardVerdict: null,
+                                    discoveryOnly: false,
+                                }),
+                            });
+                            if (requeueDecision.target !== requeueStatus) {
+                                const requeueStage = requeueWorkflow.stages.find(s => s.name === requeueDecision.target);
+                                await _updateDeliveryStatus(delivery.id, requeueDecision.target, requeueStage?.id, undefined, undefined, { organizationId: config.organizationId, fromStatus: requeueStatus });
+                                log.info(`[focus-poller] Re-queued delivery "${delivery.name}" from ${requeueStatus} to ${requeueDecision.target}: ` +
+                                    `${openWork.length} open issue(s) on a teamless focus (no other invoker).`);
+                            }
+                        }
+                        continue;
+                    }
+                    // Auto-close Context Groups + sweep Verified/In-Review issues to Done
+                    // via the shared close actions (single definition).
+                    await autoCloseContextGroups(contextGroups, _updateIssueStatus, log);
+                    await sweepDeliveryCloseIssues(workIssues, _updateIssueStatus, log);
+                    // All work issues are Done (or swept to Done) -- advance
+                    // to verify, but only if the focus worktree has no uncommitted
+                    // changes. Otherwise the agent left work uncommitted and advancing
+                    // risks losing it on focus merge.
+                    const precheck = await _ensureWorktreeCommittedBeforeAdvance({
+                        deliveryId: delivery.id,
+                        deliveryName: delivery.name,
+                        focusId,
+                        organizationId: config.organizationId,
+                        sessionId: null,
+                    });
+                    if (!precheck.ok) {
+                        await noteAdvanceRefused(delivery, precheck, deps.recordAdvanceHold);
+                        continue;
+                    }
+                    // Advance via the single-writer reconciler. The teamless path has no
+                    // exiting team, so the worktree-commit gate is the precheck above
+                    // (committed === true here), there is no guard verdict, and no review
+                    // session. The reconciler is single-step, so we walk queued -> coding
+                    // -> verify by re-keying currentStatus to each actual write.
+                    // (workflow doesn't allow queued -> verify directly.) A completed
+                    // discovery-only delivery walks one step further, verify -> done, since
+                    // its findings ARE the output and there is no review to await.
+                    const workflow = await _fetchEffectiveWorkflow(delivery.id);
+                    const reconcilerIssues = issues.map(i => ({ status: i.status, issueType: i.issueType }));
+                    let currentStatus = (delivery.executionStatus ?? '');
+                    if (currentStatus === DELIVERY_STATUS_QUEUED) {
+                        const decision = resolveReconciledWrite({
+                            // queued -> coding has no guard (the work-start crossing) -- null is
+                            // the explicit choice; discoveryOnly threads the discovery terminal.
+                            input: advanceReconcileInput({
+                                currentStatus,
+                                issues: reconcilerIssues,
+                                guardVerdict: null,
+                                discoveryOnly: discoveryComplete,
+                            }),
+                        });
+                        const stage = workflow.stages.find(s => s.name === decision.target);
+                        await _updateDeliveryStatus(delivery.id, decision.target, stage?.id, undefined, undefined, { organizationId: config.organizationId, fromStatus: currentStatus });
+                        currentStatus = decision.target;
+                    }
+                    // Measure the coding->verify guard the SAME way the team path does, so
+                    // a blocking guard is not silently skipped on the teamless path (TEL-2).
+                    // A block -> paused + a transition_blocks row (which paused-revival reads
+                    // back to revive once the guard clears -- the daemon-traversable exit);
+                    // a pass -> null verdict + a cleared verdict that CARRIES the verification
+                    // history forward (carryVerificationHistory), advancing to verify. Only
+                    // the coding->verify edge is gated here: queued->coding has no guard, and
+                    // the discovery verify->done edge is handled below.
+                    let advanceGuardVerdict = null;
+                    let advanceGateState = carryVerificationHistory(delivery.gateState);
+                    if (currentStatus === DELIVERY_STATUS_CODING) {
+                        const measured = await _measureGuardAtAdvance(config, delivery, workflow, currentStatus);
+                        if (measured) {
+                            advanceGuardVerdict = { blocked: measured.blocked };
+                            if (measured.blocked)
+                                advanceGateState = carryVerificationHistory(delivery.gateState, measured.gateState);
+                        }
+                    }
+                    const verifyDecision = resolveReconciledWrite({
+                        // coding -> verify: the guard verdict is the MEASURED one
+                        // (advanceGuardVerdict from measureGuardAtAdvance above) -- the same
+                        // measurement the team path makes, never a bypassing null (D6 parity).
+                        input: advanceReconcileInput({
+                            currentStatus,
+                            issues: reconcilerIssues,
+                            guardVerdict: advanceGuardVerdict,
+                            discoveryOnly: discoveryComplete,
+                        }),
+                    });
+                    const verifyStage = workflow.stages.find(s => s.name === verifyDecision.target);
+                    await _updateDeliveryStatus(delivery.id, verifyDecision.target, verifyStage?.id, advanceGateState, undefined, { organizationId: config.organizationId, fromStatus: currentStatus });
+                    currentStatus = verifyDecision.target;
+                    // Discovery-only terminal step: verify -> done (no review window). A
+                    // completed discovery-only delivery walks one step further than a
+                    // normal one, since its findings ARE the output and there is no review
+                    // to await.
+                    if (discoveryComplete && currentStatus === DELIVERY_STATUS_VERIFY) {
+                        const doneDecision = resolveReconciledWrite({
+                            // Discovery-only verify -> done: no review window and no guard at
+                            // this edge (its findings ARE the output) -- null is explicit.
+                            input: advanceReconcileInput({
+                                currentStatus,
+                                issues: reconcilerIssues,
+                                guardVerdict: null,
+                                discoveryOnly: true,
+                            }),
+                        });
+                        if (doneDecision.target !== currentStatus) {
+                            // Operator-hold gate (FAIL-CLOSED): even this discovery-only
+                            // verify->done edge (audit deliveries, no review window) must not
+                            // converge over an open needs_operator / external_wait escalation
+                            // anchored to the delivery -- the same gate as the review-exit
+                            // auto-approve path, so the hold holds by ANY path to done.
+                            const holdDeps = {
+                                findOpenOperatorHoldForDelivery: _findOpenOperatorHoldForDelivery,
+                                updateDeliveryStatus: _updateDeliveryStatus,
+                            };
+                            const hold = await resolveOperatorHold(holdDeps, delivery.id, focusId);
+                            // External-hold gate (sibling of the operator-hold gate): an
+                            // irreducibly-external dependency carried as gate_state STATE (not
+                            // an escalation row) must ALSO hold this verify->done edge. It
+                            // clears by re-reading its condition, not by a human resolve.
+                            const externalHold = hold.held
+                                ? { held: false, hold: null, cleared: false }
+                                : await resolveExternalHold(holdDeps, delivery.id, delivery.gateState, makeDeferredRequestClosureEvaluator(config.productId), deps.isoNow);
+                            // Surface (or clear) a stale reference-less external hold as
+                            // operator-visible state (TEL-5, delivery 2). The `in` guard covers
+                            // the operator-held short-circuit branch (no external eval ran).
+                            surfaceStaleReferenceLessExternalHold(delivery.id, delivery.name, ('staleReferenceLess' in externalHold && externalHold.staleReferenceLess) || false, externalHold.hold);
+                            if (hold.held) {
+                                await writeOperatorHoldGateState(holdDeps, delivery.id, hold, delivery.gateState);
+                                log.info(`[focus-poller] Delivery "${delivery.name}" NOT moved to done -- ${describeOperatorHold(hold)}. ` +
+                                    `Left in verify pending operator resolution.`);
+                            }
+                            else if (externalHold.held) {
+                                log.info(`[focus-poller] Delivery "${delivery.name}" NOT moved to done -- ${describeExternalHold(externalHold)}. ` +
+                                    `Left in verify pending an external reality change.`);
+                            }
+                            else {
+                                const doneStage = workflow.stages.find(s => s.name === doneDecision.target);
+                                await _updateDeliveryStatus(delivery.id, doneDecision.target, doneStage?.id, undefined, undefined, { organizationId: config.organizationId, fromStatus: currentStatus });
+                                currentStatus = doneDecision.target;
+                            }
+                        }
+                    }
+                    log.info(`[focus-poller] Auto-advanced delivery "${delivery.name}" from ${delivery.executionStatus} to ${currentStatus}: ` +
+                        (discoveryComplete
+                            ? `discovery-only delivery, ${contextGroups.length} finding(s) resolved`
+                            : `all ${workIssues.length} work issue(s) Done`));
+                    // Spawn-independent genuine progress clears the halt (delivery 3, TEL-3
+                    // + TEL-4). checkDeliveryAutoAdvance is teamless and forward-only, so a
+                    // delivery advancing here is real progress the daemon observed WITHOUT a
+                    // spawn -- the ONE path that can recover a focus whose spawn-cooldown
+                    // `exhausted` latch would otherwise block every respawn (a team can't
+                    // spawn to make progress, so only a spawn-independent advance breaks the
+                    // deadlock). Reset the teardown streak + latch via clearSpawnCooldown.
+                    clearSpawnCooldown(focusId);
+                    // Close half for the team_failure spawn block (delivery 7 Task 1): the
+                    // ESSENTIAL deadlock break. applyRespawnGuard parks every spawn while a
+                    // team_failure escalation is open, so no team can run to observe its
+                    // clearing condition -- only this spawn-independent advance can. Resolve
+                    // the open team_failure escalation so the armed focus resumes spawning,
+                    // with no human act. Best-effort, fire-and-forget.
+                    void resolveOpenFocusEscalationsOfKind(focusId, 'team_failure', 'auto_swept', 'Auto-resolved by the daemon: the focus made genuine progress (a delivery advanced), so the team_failure spawn block cleared.').catch(() => { });
+                }
+                catch (err) {
+                    log.warn(`[focus-poller] Auto-advance: failed to check/advance delivery "${delivery.name}":`, err.message);
+                }
+            }
+        }
+        catch (err) {
+            log.warn(`[focus-poller] Auto-advance: failed to fetch deliveries for focus ${focusId}:`, err.message);
+        }
+    }
+}
+/**
+ * Cross queued -> coding the moment a work issue is In Progress (the work-START
+ * edge), during ACTIVE execution -- not only at team exit.
+ *
+ * This restores the advancement the deleted auto_advance_delivery_on_issue_active
+ * PG trigger used to provide (migration 20260614172757), now routed through the
+ * single-writer reconciler. The completion path (status-advance-phase.ts) crosses
+ * this edge when a team exits; this live tick crosses it WHILE the team runs, so a
+ * delivery is never wedged in queued waiting for its team to drive every issue to
+ * terminal in one pass.
+ *
+ * Deliberately NOT folded into checkDeliveryAutoAdvance: that path skips
+ * active-team focuses and skips deliveries with open work (advancing all-done ->
+ * verify while a team executes causes coding->verify->verify_failed churn). The
+ * work-start crossing is the inverse -- it is SAFE during active execution (it is
+ * literally what should happen when a team starts working) and so runs for ALL
+ * active focuses, including those with a live team.
+ *
+ * Only queued deliveries are candidates; the reconciler returns coding for
+ * queued + In-Progress work and stays queued for not-started open work (To Do /
+ * Blocked only) or no work issues (scoping gate). A status write is not
+ * git-touching, so there is no worktree-commit precheck. Idempotent: once a
+ * delivery is coding it is no longer a candidate, so the divergence line logs at
+ * most once per crossing.
+ */
+export async function checkDeliveryWorkStart(config, deps) {
+    const { getActiveFocuses: _getActiveFocuses, getFocusDeliveries: _getFocusDeliveries, getDeliveryIssues: _getDeliveryIssues, fetchEffectiveWorkflow: _fetchEffectiveWorkflow, updateDeliveryStatus: _updateDeliveryStatus, } = deps;
+    let activeFocuses;
+    try {
+        activeFocuses = await _getActiveFocuses(config.organizationId, config.productId);
+    }
+    catch (err) {
+        log.warn('Work-start: failed to fetch active focuses:', err.message);
+        return;
+    }
+    for (const focus of activeFocuses) {
+        let deliveries;
+        try {
+            deliveries = await _getFocusDeliveries(focus.focus_id);
+        }
+        catch (err) {
+            log.warn(`Work-start: failed to fetch deliveries for focus ${focus.focus_id}:`, err.message);
+            continue;
+        }
+        for (const delivery of deliveries) {
+            // Only queued deliveries can take the work-start crossing.
+            if ((delivery.executionStatus ?? '') !== DELIVERY_STATUS_QUEUED)
+                continue;
+            try {
+                const issues = await _getDeliveryIssues(delivery.id);
+                const reconcilerIssues = issues.map(i => ({ status: i.status, issueType: i.issueType }));
+                // Single-writer reconciler decides: queued + In-Progress work -> coding;
+                // otherwise stays queued (no active work yet / scoping gate). Shared
+                // work-start input (workStartReconcileInput) with the completion path.
+                const decision = resolveReconciledWrite({ input: workStartReconcileInput(reconcilerIssues) });
+                if (decision.target === DELIVERY_STATUS_QUEUED)
+                    continue; // no active work yet
+                const workflow = await _fetchEffectiveWorkflow(delivery.id);
+                const stage = workflow.stages.find(s => s.name === decision.target);
+                // fromStatus=queued double-write guard: if another path already crossed
+                // this delivery, the optimistic from-status check rejects/no-ops the write.
+                await _updateDeliveryStatus(delivery.id, decision.target, stage?.id, undefined, undefined, { organizationId: config.organizationId, fromStatus: DELIVERY_STATUS_QUEUED });
+                log.info(`[focus-poller] Work-start: delivery "${delivery.name}" crossed ${DELIVERY_STATUS_QUEUED} -> ${decision.target} ` +
+                    `(work issue In Progress)`);
+            }
+            catch (err) {
+                log.warn(`Work-start: failed to advance delivery "${delivery.name}":`, err.message);
+            }
+        }
+    }
+}
+//# sourceMappingURL=focus-poller-auto-advance.js.map

package/dist/focus/focus-poller-auto-advance.js.map

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

package/dist/focus/focus-poller-spawn.d.ts

@@ -0,0 +1,113 @@
+import { type FocusHoldWorkDeps } from '../worktree/verify-hold-facts.js';
+import { type ActiveFocusRow } from '../queries/focuses/focus-discovery.js';
+import type { PendingSpawnPassDeps, ReadyFocusPassDeps } from './pending-spawn-pass-deps.js';
+import { type ReviewHoldParkDeps } from '../spawn/review-hold-park.js';
+import { type PendingReviewApprovedHeadDeps } from './pending-review-approved-head.js';
+/**
+ * Process any focuses ready for agent work.
+ *
+ * For each ready focus without an active team, spawns a single
+ * Agent Team that manages all deliveries within that focus.
+ * Also detects focuses that have been deactivated and shuts down
+ * their teams. Once every session slot is in use it starts no further team
+ * but keeps classifying, so each focus it would otherwise have spawned is
+ * recorded as waiting for a slot (recordSlotBlockedFocuses).
+ */
+export declare function processReadyFocuses(deps: ReadyFocusPassDeps): Promise<void>;
+/**
+ * Falsifiability correlation: a focus that is READY again (getReadyFocuses
+ * surfaced it, so it has actionable work) while it still holds an unclassified
+ * teardown-at-first-result firing classifies that teardown a FALSE POSITIVE -- its
+ * "no team-actionable work" prediction was wrong. The settle sweep TPs any firing
+ * that stood past the window, so a still-unclassified one is a QUICK re-ready (the
+ * 2026-09-06 storm shape). A no-op for a focus with no such firing.
+ */
+export declare function classifyReadyFalsifiedTeardowns(readyFocuses: ReadonlyArray<{
+    focus_id: string;
+}>): Set<string>;
+/**
+ * Block-to-observe enforcement for the spawn-gate-vs-exit respawn mechanism: when
+ * it is DEMOTED (zero true positives over the window) a respawn of a focus we just
+ * tore down is suppressed -- recorded, not acted on -- breaking the storm at the
+ * spawn side (AC/FRT #10). A no-op unless this focus is in the just-falsified-
+ * teardown set AND the mechanism is demoted. The suppressed respawn's firing is
+ * marked UNACTED so it is never swept to TP by silence; the demotion lifts only
+ * when its acted false positives age out of the demotion window, not merely
+ * because the demoted mechanism stopped respawning.
+ */
+export declare function respawnSuppressedByDemotion(focus: {
+    focus_id: string;
+    focus_name: string;
+}, respawnAfterTeardown: ReadonlySet<string>): boolean;
+/**
+ * Whether a queued REVIEW directive for this focus is parked on an operator hold
+ * (spawn/review-hold-park.ts): the review waits on the escalation, not on billed
+ * respawns, and the hold's resolution releases it (clearing the respawn halt).
+ * Read BEFORE the respawn-halt check so a halted focus still observes its
+ * release. A non-review directive is never parked here.
+ */
+export declare function pendingReviewParkedOnOperatorHold(focus: {
+    focus_id: string;
+    focus_name: string;
+}, deps: ReviewHoldParkDeps): Promise<boolean>;
+/**
+ * Whether a queued REVIEW directive is declined because the focus head is the
+ * commit its current approval already judged (focus/pending-review-approved-head.ts):
+ * dropped with its stale review window, or withheld while a hold marker still
+ * awaits its release. Read AFTER the operator-hold park, so a resolved hold is
+ * released (halt cleared durably) even when the review itself is declined.
+ */
+export declare function pendingReviewDeclinedAtApprovedHead(focus: ActiveFocusRow, deps: PendingReviewApprovedHeadDeps): Promise<boolean>;
+/**
+ * Stage-currency guard: a queued spawn directive belongs to the stage the focus
+ * was in when it was stashed (originStageId). If the focus has since LEFT that
+ * stage, the directive is stale -- the 2026-09-06 focus 6f866509 case, where a
+ * verifying-stage directive was consumed by a spawn 0.4s after the focus moved to
+ * reviewing. Drop it rather than consume it, and report whether the spawn must be
+ * skipped. A null origin (older entry, or a stash site with no stage) or a null
+ * current stage skips the check (fail-open, never a false drop).
+ */
+export declare function dropStalePendingSpawnDirective(focus: {
+    focus_id: string;
+    focus_name: string;
+    current_workflow_stage_id: string | null;
+}): boolean;
+/**
+ * Whether a pending spawn directive must be DEFERRED because an in-flight verify
+ * hold covers the focus's only open work -- read through the ONE shared predicate,
+ * so a sibling delivery's open work outside the verified delivery still spawns
+ * (f1, 2026-09-13). A REVIEW-lineage pending directive is EXEMPT (returns false
+ * even while held): the review is exactly the work that releases the deliveries
+ * the hold is holding, so gating it would deadlock the focus in verify. Mirrors
+ * the directive gate's lineage exemption (directive/directive-verify-hold-gate.ts)
+ * and the review-always-spawnable rule, so the two disposal sites cannot drift.
+ */
+export declare function pendingSpawnDeferredByVerifyHold(focusId: string, deps: FocusHoldWorkDeps): Promise<boolean>;
+/**
+ * One poll's pending-spawn pass. It starts a drain of the escalation spool
+ * (supervision/escalation-spool.ts): an escalation a bounded hold spooled when the
+ * writer was down, whose queued directive is already gone, so nothing else would
+ * carry it. The drain starts even when no directive is queued, but the pass does
+ * NOT wait on it (single-flight per spool directory, every filing time-bounded):
+ * a slow writer or a backlog never delays the pending-directive spawns that run
+ * next.
+ */
+export declare function runPendingSpawnPass(deps: PendingSpawnPassDeps): Promise<void>;
+/**
+ * Spawn teams for focuses that have a pending spawn directive but were
+ * not surfaced by getReadyFocuses.
+ *
+ * getReadyFocuses (daemon-focus-handlers.ts) only returns focuses with
+ * queued/coding deliveries (or zero deliveries). A review-stage spawn
+ * directive on a focus whose deliveries are all in verify never makes
+ * it to processReadyFocuses -- the pending directive sits forever and
+ * the team never starts. This function bridges that gap: scan the
+ * pending-spawn map directly and spawn for any focus that's not
+ * already running.
+ */
+export declare function processPendingSpawnFocuses(deps: PendingSpawnPassDeps): Promise<void>;
+/** The ready-focus pass the focus poll and the engine run: over the composition root's installed contexts. */
+export declare function runProductionReadyFocusPass(): Promise<void>;
+/** The pending-spawn pass the focus poll runs: over the composition root's installed contexts. */
+export declare function runProductionPendingSpawnPass(): Promise<void>;
+//# sourceMappingURL=focus-poller-spawn.d.ts.map

package/dist/focus/focus-poller-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-poller-spawn.d.ts","sourceRoot":"","sources":["../../src/focus/focus-poller-spawn.ts"],"names":[],"mappings":"AAmCA,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAcvG,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAQ7F,OAAO,EAAiC,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEtG,OAAO,EAAmC,KAAK,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAiExH;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuKjF;AAuDD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,aAAa,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,GAAG,CAAC,MAAM,CAAC,CAuBb;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC/C,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO,CAQT;AAgBD;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC/C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAGlB;AA8BD;;;;;;GAMG;AACH,wBAAsB,mCAAmC,CACvD,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxF,OAAO,CAUT;AAkCD;;;;;;;;;GASG;AACH,wBAAsB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjH;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiN1F;AAED,8GAA8G;AAC9G,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,kGAAkG;AAClG,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnE"}