@telora/daemon 0.22.233 → 0.22.245

package/dist/delivery/delivery-advance-block.js

@@ -1,5 +1,6 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/queries/incident-correlation.test.ts,
+// Pinned by: packages/daemon/src/focus/advance-hold.test.ts,
+//   packages/daemon/src/queries/incident-correlation.test.ts,
 //   packages/daemon/src/shell/safety-capture-entry-points.test.ts
 // PINNED-BY-END
 /**
@@ -153,22 +154,9 @@ async function safetyCommitStrandedWork(worktree, params, deps, onSweepRefusal)
  * across daemon restarts (it reads the DB, holds no in-memory state).
  */
 export async function ensureWorktreeCommittedBeforeAdvance(params, deps = {}) {
-    const getWorktree = deps.getFocusWorktree ?? getFocusWorktree;
-    const hasUncommitted = deps.worktreeHasUncommittedChanges ?? worktreeHasUncommittedChanges;
-    const createEsc = deps.createEscalation ?? createEscalation;
-    const hasOpenEsc = deps.hasOpenWorktreeDirtyEscalation ?? hasOpenWorktreeDirtyEscalation;
-    const resolveOpenEsc = deps.resolveOpenWorktreeDirtyEscalations ?? resolveOpenWorktreeDirtyEscalations;
-    const reconcileTorn = deps.reconcileTornWrite ?? reconcileTornWrite;
-    const isUnderVerify = deps.isWorktreeUnderVerify ?? isWorktreeUnderVerify;
-    const isLockfileOnly = deps.dirtyChangesAreGeneratedLockfilesOnly ?? dirtyChangesAreGeneratedLockfilesOnly;
-    const commitLockfiles = deps.commitGeneratedLockfiles ?? commitGeneratedLockfiles;
-    const getTeam = deps.getActiveTeam ?? ((id) => getActiveTeams().get(id));
-    const sendMsg = deps.sendMessage ?? sendMessage;
-    const budget = deps.autoRemediationBudget ?? resolveAutoRemediationBudget();
-    const rewakeMinIntervalMs = deps.rewakeMinIntervalMs ?? REWAKE_MIN_INTERVAL_MS;
-    const now = deps.now ?? Date.now;
-    const { deliveryId, deliveryName, focusId, organizationId, sessionId } = params;
-    const worktree = getWorktree(focusId);
+    const r = resolveAdvanceBlockDeps(deps);
+    const { deliveryName, focusId } = params;
+    const worktree = r.getWorktree(focusId);
     if (!worktree)
         return { ok: true };
     // Verify interlock: if a verify command is running in this focus worktree, the
@@ -178,13 +166,13 @@ export async function ensureWorktreeCommittedBeforeAdvance(params, deps = {}) {
     // budget spent), so the next poll re-evaluates cleanly once the verify completes.
     // Guarding here as well as in guardedCommit keeps a transient mid-verify dirt
     // from ever being read as an uncommitted-work condition in the first place.
-    if (isUnderVerify(worktree.worktreePath)) {
+    if (r.isUnderVerify(worktree.worktreePath)) {
         log.info(`[delivery-lifecycle] Deferring advance of "${deliveryName}": a verify command is ` +
             `running in ${worktree.worktreePath}. Not committing, re-waking, or escalating; ` +
             `the next poll retries once verify completes.`);
-        return { ok: false, reason: 'verify in flight (safety-commit deferred)' };
+        return { ok: false, reason: 'verify in flight (safety-commit deferred)', hold: { kind: 'verify_in_flight', worktreePath: worktree.worktreePath } };
     }
-    if (!hasUncommitted(worktree.worktreePath)) {
+    if (!r.hasUncommitted(worktree.worktreePath)) {
         // Clean -- the dirty episode (if any) is over. Reset the retry budget so a
         // future episode starts fresh, and auto-close any worktree-dirty escalation
         // we filed for it so a resolved-in-fact condition stops sitting in the human
@@ -192,179 +180,222 @@ export async function ensureWorktreeCommittedBeforeAdvance(params, deps = {}) {
         // common clean-advance path adds no extra DB round-trip.
         const hadEpisode = remediationState.delete(focusId);
         if (hadEpisode) {
-            await autoResolveClearedEscalations(resolveOpenEsc, focusId);
+            await autoResolveClearedEscalations(r.resolveOpenEsc, focusId);
         }
         return { ok: true };
     }
     const reason = `uncommitted changes in focus worktree ${worktree.worktreePath}`;
+    const hold = { kind: 'worktree_uncommitted', worktreePath: worktree.worktreePath };
     log.warn(`Blocking advance of "${deliveryName}": ${reason}`);
-    // ── Auto-remediation 0: pure torn write -> reconcile the index, advance ────
-    // A staged index entry with NO worktree content behind it (index != HEAD,
-    // worktree == HEAD) is not agent work -- it is a torn write (e.g. a verify
-    // command mutated a tracked file and restored it while a safety-commit
-    // snapshotted the index mid-flight). There is nothing for a team to commit and
-    // nothing to preserve, so re-waking or escalating would loop forever. Reconcile
-    // the index to the worktree; the tree goes clean and the delivery advances with
-    // NO escalation. Runs FIRST so a torn write never reaches the lockfile /
-    // re-wake / safety-commit branches below. The advance-gate DETECTOR
-    // (worktreeHasUncommittedChanges, `git status --porcelain`) and this REMEDIATOR
-    // (reconcileTornWrite, index-aware) agree on this dirt -- the wedge is what this
-    // focus exists to remove (escalation 2170fdde, 2026-08-16).
-    const reconciled = reconcileTorn(worktree.worktreePath);
-    if (reconciled) {
-        log.info(`[delivery-lifecycle] Reconciled torn-write index for "${deliveryName}" at ` +
-            `${worktree.worktreePath} (${reconciled.reconciled.length} staged path(s) with no ` +
-            `worktree content); advancing without escalation.`);
-        remediationState.delete(focusId);
-        await autoResolveClearedEscalations(resolveOpenEsc, focusId);
+    if (await clearMechanicalDirt(worktree.worktreePath, deliveryName, focusId, r))
         return { ok: true };
-    }
-    // ── Auto-remediation 1: pure generated-lockfile churn -> auto-commit ──────
-    if (isLockfileOnly(worktree.worktreePath)) {
-        const sha = commitLockfiles(worktree.worktreePath);
-        if (sha) {
-            log.info(`[delivery-lifecycle] Auto-committed generated lockfile churn for "${deliveryName}" ` +
-                `(${sha.slice(0, 8)}); advancing without escalation.`);
-            remediationState.delete(focusId);
-            // The worktree is now clean -- close any escalation the dirty churn raised.
-            await autoResolveClearedEscalations(resolveOpenEsc, focusId);
-            return { ok: true };
-        }
-        // Commit failed -- fall through to re-wake / escalation.
-    }
     // Record that this focus has an active dirty episode so the clean path can
     // later auto-resolve whatever escalation we file/maintain for it, even when
     // the episode is escalated without ever re-waking a team.
     if (!remediationState.has(focusId)) {
         remediationState.set(focusId, { attempts: 0, lastNudgeAt: 0 });
     }
-    // ── Auto-remediation 2: real work -> re-wake the team, within budget ──────
-    // Idempotent per poll cycle at FOCUS grain: this guard runs once per delivery,
-    // but the dirty worktree is one focus-level fact. Only the first delivery in a
-    // cycle acts (re-wake or escalate); siblings within the same cycle no-op.
-    //
-    // whatWasTried context for the eventual human escalation -- overwritten by the
-    // branch that actually decides to escalate so the row explains itself.
-    let escalationContext = 'the focus worktree had uncommitted changes the daemon could not auto-remediate';
-    const leadStdin = getTeam(focusId)?.leadStdin ?? null;
-    if (leadStdin) {
-        const state = remediationState.get(focusId) ?? { attempts: 0, lastNudgeAt: 0 };
-        const newCycle = now() - state.lastNudgeAt >= rewakeMinIntervalMs;
-        if (!newCycle) {
-            // A sibling delivery already acted on this focus's dirty worktree this
-            // poll cycle (re-woke or escalated). Suppress to hold "one action per
-            // cycle" -- without re-filing or double-counting budget.
-            return { ok: false, reason };
-        }
-        // Claim the cycle up front (idempotency) regardless of which branch we take.
-        state.lastNudgeAt = now();
+    const leadStdin = r.getTeam(focusId)?.leadStdin ?? null;
+    const step = leadStdin
+        ? rewakeLeadWithinBudget(leadStdin, worktree.worktreePath, deliveryName, focusId, r)
+        : await safetyCommitWithNoTeam(worktree, params, deps, r);
+    if (step.kind === 'advance')
+        return { ok: true };
+    if (step.kind === 'held')
+        return { ok: false, reason, hold };
+    await fileAdvanceBlockEscalation(params, worktree.worktreePath, step.escalationContext, r);
+    return { ok: false, reason, hold };
+}
+/** ensureWorktreeCommittedBeforeAdvance's collaborators, each defaulted to the real one. */
+function resolveAdvanceBlockDeps(deps) {
+    return {
+        getWorktree: deps.getFocusWorktree ?? getFocusWorktree,
+        hasUncommitted: deps.worktreeHasUncommittedChanges ?? worktreeHasUncommittedChanges,
+        createEsc: deps.createEscalation ?? createEscalation,
+        hasOpenEsc: deps.hasOpenWorktreeDirtyEscalation ?? hasOpenWorktreeDirtyEscalation,
+        resolveOpenEsc: deps.resolveOpenWorktreeDirtyEscalations ?? resolveOpenWorktreeDirtyEscalations,
+        reconcileTorn: deps.reconcileTornWrite ?? reconcileTornWrite,
+        isUnderVerify: deps.isWorktreeUnderVerify ?? isWorktreeUnderVerify,
+        isLockfileOnly: deps.dirtyChangesAreGeneratedLockfilesOnly ?? dirtyChangesAreGeneratedLockfilesOnly,
+        commitLockfiles: deps.commitGeneratedLockfiles ?? commitGeneratedLockfiles,
+        getTeam: deps.getActiveTeam ?? ((id) => getActiveTeams().get(id)),
+        sendMsg: deps.sendMessage ?? sendMessage,
+        budget: deps.autoRemediationBudget ?? resolveAutoRemediationBudget(),
+        rewakeMinIntervalMs: deps.rewakeMinIntervalMs ?? REWAKE_MIN_INTERVAL_MS,
+        now: deps.now ?? Date.now,
+    };
+}
+/** The dirty episode is over: forget its budget and close what it filed. */
+async function closeDirtyEpisode(focusId, r) {
+    remediationState.delete(focusId);
+    await autoResolveClearedEscalations(r.resolveOpenEsc, focusId);
+}
+/**
+ * Auto-remediations 0 and 1: dirt no team needs to commit. True when the tree
+ * was made clean and the delivery may advance.
+ *
+ * 0. A pure torn write -- a staged index entry with NO worktree content behind
+ *    it (index != HEAD, worktree == HEAD) is not agent work (e.g. a verify
+ *    command mutated a tracked file and restored it while a safety-commit
+ *    snapshotted the index mid-flight). There is nothing for a team to commit and
+ *    nothing to preserve, so re-waking or escalating would loop forever. Reconcile
+ *    the index to the worktree; the tree goes clean and the delivery advances with
+ *    NO escalation. Runs FIRST so a torn write never reaches the lockfile /
+ *    re-wake / safety-commit steps. The advance-gate DETECTOR
+ *    (worktreeHasUncommittedChanges, `git status --porcelain`) and this REMEDIATOR
+ *    (reconcileTornWrite, index-aware) agree on this dirt -- the wedge is what this
+ *    focus exists to remove (escalation 2170fdde, 2026-08-16).
+ * 1. Pure generated-lockfile churn -> auto-commit. A failed commit falls through
+ *    to re-wake / escalation.
+ */
+async function clearMechanicalDirt(worktreePath, deliveryName, focusId, r) {
+    const reconciled = r.reconcileTorn(worktreePath);
+    if (reconciled) {
+        log.info(`[delivery-lifecycle] Reconciled torn-write index for "${deliveryName}" at ` +
+            `${worktreePath} (${reconciled.reconciled.length} staged path(s) with no ` +
+            `worktree content); advancing without escalation.`);
+        await closeDirtyEpisode(focusId, r);
+        return true;
+    }
+    if (!r.isLockfileOnly(worktreePath))
+        return false;
+    const sha = r.commitLockfiles(worktreePath);
+    if (!sha)
+        return false;
+    log.info(`[delivery-lifecycle] Auto-committed generated lockfile churn for "${deliveryName}" ` +
+        `(${sha.slice(0, 8)}); advancing without escalation.`);
+    // The worktree is now clean -- close any escalation the dirty churn raised.
+    await closeDirtyEpisode(focusId, r);
+    return true;
+}
+/**
+ * Auto-remediation 2: real work with a live lead -> re-wake it to commit, within
+ * budget. Idempotent per poll cycle at FOCUS grain: the guard runs once per
+ * delivery, but the dirty worktree is one focus-level fact, so only the first
+ * delivery in a cycle acts (re-wake or escalate); siblings within the same cycle
+ * are `held`.
+ *
+ * The bounded-retry-vs-escalate boundary is the shared resolver-dispatch policy
+ * primitive (nextResolverStep), so this dirty-worktree path and the general seam
+ * agree on the ONE definition of "retry within budget, else escalate". The
+ * re-wake IS the resolver attempt here; escalation is the residue when it is
+ * spent. Only a SUCCESSFUL nudge spends a budget tick -- a failed write means the
+ * lead is effectively unreachable, so it escalates now (TEL-5).
+ */
+function rewakeLeadWithinBudget(leadStdin, worktreePath, deliveryName, focusId, r) {
+    const state = remediationState.get(focusId) ?? { attempts: 0, lastNudgeAt: 0 };
+    if (r.now() - state.lastNudgeAt < r.rewakeMinIntervalMs) {
+        // A sibling delivery already acted on this focus's dirty worktree this poll
+        // cycle (re-woke or escalated): hold "one action per cycle" without
+        // re-filing or double-counting budget.
+        return { kind: 'held' };
+    }
+    // Claim the cycle up front (idempotency) regardless of which branch we take.
+    state.lastNudgeAt = r.now();
+    remediationState.set(focusId, state);
+    if (nextResolverStep(state.attempts, r.budget) !== 'retry') {
+        log.warn(`[delivery-lifecycle] Auto-remediation budget (${r.budget}) exhausted for focus ${focusId}; escalating to a human.`);
+        return {
+            kind: 'escalate',
+            escalationContext: `auto-remediation (generated-lockfile auto-commit and re-waking the team to commit) ` +
+                `did not clear the uncommitted changes within the retry budget (${r.budget})`,
+        };
+    }
+    try {
+        r.sendMsg(leadStdin, `Your focus worktree has uncommitted changes, so the daemon cannot advance ` +
+            `delivery "${deliveryName}" yet. Please commit (or discard) your work in ` +
+            `${worktreePath}; the daemon advances automatically once the worktree ` +
+            `is clean. (auto-remediation attempt ${state.attempts + 1}/${r.budget})`);
+        state.attempts += 1;
         remediationState.set(focusId, state);
-        // Delegate the bounded-retry-vs-escalate boundary to the shared
-        // resolver-dispatch policy primitive (nextResolverStep), so this
-        // dirty-worktree path and the general seam agree on the ONE definition of
-        // "retry within budget, else escalate" -- the attempt-first, bounded-retry,
-        // escalate-on-exhaustion shape this whole focus generalizes. The re-wake IS
-        // the resolver attempt here; escalation is the residue when it is spent.
-        if (nextResolverStep(state.attempts, budget) === 'retry') {
-            // Within budget: try to re-wake the lead. Only a SUCCESSFUL nudge spends a
-            // budget tick -- a failed write means the lead is effectively unreachable,
-            // so we stop pretending a re-wake is possible and escalate now (TEL-5).
-            try {
-                sendMsg(leadStdin, `Your focus worktree has uncommitted changes, so the daemon cannot advance ` +
-                    `delivery "${deliveryName}" yet. Please commit (or discard) your work in ` +
-                    `${worktree.worktreePath}; the daemon advances automatically once the worktree ` +
-                    `is clean. (auto-remediation attempt ${state.attempts + 1}/${budget})`);
-                state.attempts += 1;
-                remediationState.set(focusId, state);
-                log.info(`[delivery-lifecycle] Re-woke team for focus ${focusId} to commit ` +
-                    `(auto-remediation ${state.attempts}/${budget}); not escalating.`);
-                return { ok: false, reason };
-            }
-            catch (err) {
-                log.warn(`[delivery-lifecycle] Re-wake of team for "${deliveryName}" failed (${err.message}); ` +
-                    `treating the lead as unreachable and escalating to a human.`);
-                escalationContext =
-                    're-waking the team to commit failed because its input stream was unwritable ' +
-                        '(the lead is effectively unreachable), so the daemon could not ask it to commit';
-                // fall through to escalation; the failed nudge did NOT spend budget.
-            }
-        }
-        else {
-            // Budget exhausted -- fall through to the human escalation (durably deduped).
-            log.warn(`[delivery-lifecycle] Auto-remediation budget (${budget}) exhausted for focus ${focusId}; escalating to a human.`);
-            escalationContext =
-                `auto-remediation (generated-lockfile auto-commit and re-waking the team to commit) ` +
-                    `did not clear the uncommitted changes within the retry budget (${budget})`;
-        }
+        log.info(`[delivery-lifecycle] Re-woke team for focus ${focusId} to commit ` +
+            `(auto-remediation ${state.attempts}/${r.budget}); not escalating.`);
+        return { kind: 'held' };
     }
-    else {
-        // No live team to re-wake and the dirt is not generated-lockfile-only. The
-        // team wrote real work but exited (or was killed) before committing, leaving
-        // it stranded: the commit-gate has no team to re-wake, and re-spawning a team
-        // is out of scope here. Rather than file a needs_operator escalation for a
-        // condition the daemon can self-resolve, make a WIP safety-commit of the
-        // uncommitted agent work and advance to verify -- review is the real gate, so
-        // committing the work-in-progress loses nothing and the differential loop is
-        // not left churning on a stranded delivery. This reuses the same
-        // safetyCommitWorktree primitive crash-recovery and removeWorktree use.
-        // DECIDED 2026-06-22, Jeremy -- this deliberately reverses the prior
-        // "committing incomplete agent work and merging it is unsafe" stance: the
-        // safety-commit lands on the focus branch and review still gates the merge.
-        // Capture a mass-sweep refusal so the eventual escalation can name the
-        // count/paths the guard withheld (the work stays recoverable).
-        let sweepRefusal = null;
-        const { sha, unmergedEscalated } = await safetyCommitStrandedWork(worktree, params, deps, (r) => {
-            sweepRefusal = r;
-        });
-        // A conflict refusal already filed its own escalation: filing the generic one too would duplicate it.
-        if (!sha && unmergedEscalated)
-            return { ok: false, reason };
-        if (sha) {
-            log.info(`[delivery-lifecycle] No live team for focus ${focusId} to re-wake; safety-committed ` +
-                `uncommitted agent work ${sha.slice(0, 8)} and advancing "${deliveryName}" to verify -- ` +
-                `review is the gate.`);
-            // The worktree is now clean -- close out the dirty episode and auto-resolve
-            // any worktree-dirty escalation we filed for this focus, mirroring the
-            // lockfile-only auto-commit branch above.
-            remediationState.delete(focusId);
-            await autoResolveClearedEscalations(resolveOpenEsc, focusId);
-            return { ok: true };
-        }
-        // Safety-commit failed -- the one genuine corner that still needs a human.
-        // Fall through to the escalation block, explaining the corner (TEL-3).
-        // A sweep refusal is a distinct, recoverable corner: name the count/paths so
-        // an agent/operator can commit the legitimate subset (the daemon kept the
-        // scratch/sweep out of history and preserved the working tree).
-        if (sweepRefusal) {
-            const r = sweepRefusal;
-            escalationContext =
-                `no team is live to re-wake and the daemon REFUSED to safety-commit ${r.count} files ` +
-                    `(exceeds the ${r.maxFiles}-file sweep threshold; e.g. ${r.sample.slice(0, 5).join(', ')}), ` +
-                    `so a mass sweep was kept out of history and the working tree is preserved for recovery`;
-        }
-        else {
-            escalationContext =
-                'no team is live to re-wake and the WIP safety-commit of the uncommitted agent work ' +
-                    'failed, so the daemon could not self-resolve';
-        }
+    catch (err) {
+        log.warn(`[delivery-lifecycle] Re-wake of team for "${deliveryName}" failed (${err.message}); ` +
+            `treating the lead as unreachable and escalating to a human.`);
+        // The failed nudge did NOT spend budget.
+        return {
+            kind: 'escalate',
+            escalationContext: 're-waking the team to commit failed because its input stream was unwritable ' +
+                '(the lead is effectively unreachable), so the daemon could not ask it to commit',
+        };
     }
-    // ── File the residue (proposed needs_operator, no human act) ──────────────
-    // Reached only when the retry budget is exhausted, the lead was unreachable,
-    // or no team is reachable to re-wake and the dirt is not lockfile-only. Durable
-    // focus-grain dedup still applies; fail open on lookup error so a genuine first
-    // escalation is not silently swallowed.
+}
+/**
+ * No live team to re-wake and the dirt is not generated-lockfile-only. The team
+ * wrote real work but exited (or was killed) before committing, leaving it
+ * stranded: the commit-gate has no team to re-wake, and re-spawning a team is out
+ * of scope here. Rather than file a needs_operator escalation for a condition the
+ * daemon can self-resolve, make a WIP safety-commit of the uncommitted agent work
+ * and advance to verify -- review is the real gate, so committing the
+ * work-in-progress loses nothing and the differential loop is not left churning
+ * on a stranded delivery. This reuses the same safetyCommitWorktree primitive
+ * crash-recovery and removeWorktree use. DECIDED 2026-06-22, Jeremy -- this
+ * deliberately reverses the prior "committing incomplete agent work and merging
+ * it is unsafe" stance: the safety-commit lands on the focus branch and review
+ * still gates the merge.
+ */
+async function safetyCommitWithNoTeam(worktree, params, deps, r) {
+    const { deliveryName, focusId } = params;
+    // Capture a mass-sweep refusal so the eventual escalation can name the
+    // count/paths the guard withheld (the work stays recoverable).
+    let sweepRefusal = null;
+    const { sha, unmergedEscalated } = await safetyCommitStrandedWork(worktree, params, deps, (report) => {
+        sweepRefusal = report;
+    });
+    // A conflict refusal already filed its own escalation: filing the generic one too would duplicate it.
+    if (!sha && unmergedEscalated)
+        return { kind: 'held' };
+    if (sha) {
+        log.info(`[delivery-lifecycle] No live team for focus ${focusId} to re-wake; safety-committed ` +
+            `uncommitted agent work ${sha.slice(0, 8)} and advancing "${deliveryName}" to verify -- ` +
+            `review is the gate.`);
+        // The worktree is now clean -- close out the dirty episode, mirroring the
+        // lockfile-only auto-commit.
+        await closeDirtyEpisode(focusId, r);
+        return { kind: 'advance' };
+    }
+    // Safety-commit failed -- the one genuine corner that still needs a human
+    // (TEL-3). A sweep refusal is a distinct, recoverable corner: name the
+    // count/paths so an agent/operator can commit the legitimate subset (the
+    // daemon kept the scratch/sweep out of history and preserved the working tree).
+    if (sweepRefusal) {
+        const refusal = sweepRefusal;
+        return {
+            kind: 'escalate',
+            escalationContext: `no team is live to re-wake and the daemon REFUSED to safety-commit ${refusal.count} files ` +
+                `(exceeds the ${refusal.maxFiles}-file sweep threshold; e.g. ${refusal.sample.slice(0, 5).join(', ')}), ` +
+                `so a mass sweep was kept out of history and the working tree is preserved for recovery`,
+        };
+    }
+    return {
+        kind: 'escalate',
+        escalationContext: 'no team is live to re-wake and the WIP safety-commit of the uncommitted agent work ' +
+            'failed, so the daemon could not self-resolve',
+    };
+}
+/**
+ * File the residue (proposed needs_operator, no human act). Reached only when the
+ * retry budget is exhausted, the lead was unreachable, or no team is reachable to
+ * re-wake and the safety-commit failed. Durable focus-grain dedup still applies;
+ * fail open on lookup error so a genuine first escalation is not silently
+ * swallowed. Never throws.
+ */
+async function fileAdvanceBlockEscalation(params, worktreePath, escalationContext, r) {
+    const { deliveryId, deliveryName, focusId, organizationId, sessionId } = params;
     let alreadyOpen = false;
     try {
-        alreadyOpen = await hasOpenEsc(focusId);
+        alreadyOpen = await r.hasOpenEsc(focusId);
     }
     catch (err) {
         log.warn(`[delivery-lifecycle] Open advance-block escalation lookup failed for "${deliveryName}", proceeding to file: ${err.message}`);
     }
-    if (alreadyOpen) {
-        return { ok: false, reason };
-    }
+    if (alreadyOpen)
+        return;
     try {
-        await withRetry(() => createEsc({
+        await withRetry(() => r.createEsc({
             organizationId,
             sessionId: sessionId ?? '',
             issueId: null,
@@ -382,12 +413,11 @@ export async function ensureWorktreeCommittedBeforeAdvance(params, deps = {}) {
                 `that the daemon could not auto-remediate.`,
             whatWasTried: 'Daemon detected all work issues Done and was about to advance the delivery, but the ' +
                 `focus worktree had uncommitted changes. Escalating because ${escalationContext}.`,
-            helpNeeded: `Commit (or discard) pending changes in ${worktree.worktreePath}, then the next poll will advance the delivery.`,
+            helpNeeded: `Commit (or discard) pending changes in ${worktreePath}, then the next poll will advance the delivery.`,
         }), { maxAttempts: 3, label: 'escalation-uncommitted-before-advance' });
     }
     catch (err) {
         log.error(`Failed to create uncommitted-changes escalation: ${err.message}`);
     }
-    return { ok: false, reason };
 }
 //# sourceMappingURL=delivery-advance-block.js.map

package/dist/delivery/delivery-advance-block.js.map

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

package/dist/focus/advance-hold.d.ts

@@ -0,0 +1,55 @@
+import { type DeliveryGateRowIo, type DeliveryGateState } from '../queries/deliveries.js';
+import type { AdvanceHoldDetail } from '../queries/delivery-gate-holds.js';
+import type { AdvancePrecheckHold, AdvancePrecheckResult } from '../delivery/delivery-advance-block.js';
+/** The guard names of the paired `blocking` entries -- one per hold reason. */
+export declare const ADVANCE_HOLD_GUARDS: ReadonlySet<string>;
+/** At most this many paths are named; the count carries the rest. */
+export declare const ADVANCE_HOLD_PATH_CAP = 20;
+/**
+ * The uncommitted paths in a worktree, as `git status --porcelain` names them
+ * (a rename names its destination). Empty when git cannot be read -- the hold
+ * is still recorded, just without paths.
+ */
+export declare function listUncommittedPaths(worktreePath: string): string[];
+/** Build the hold detail for a precheck refusal. Pure over its inputs. */
+export declare function buildAdvanceHold(hold: AdvancePrecheckHold, uncommittedPaths: readonly string[], nowIso: string): AdvanceHoldDetail;
+/**
+ * The gate_state with `hold` recorded, merged over what the row already carries
+ * (verification history and any other key survive). Returns undefined when the
+ * same hold is already recorded, so a hold that stands across polls writes once.
+ * `heldSince` is kept from the standing record when only the paths changed.
+ */
+export declare function withAdvanceHold(prior: DeliveryGateState | null, hold: AdvanceHoldDetail): DeliveryGateState | undefined;
+/** The gate_state with any advance hold removed; undefined when there is none. */
+export declare function withoutAdvanceHold(prior: DeliveryGateState | null): DeliveryGateState | undefined;
+/** Injectable seams (tests drive the row IO and the path read). */
+export interface AdvanceHoldDeps {
+    io?: Partial<DeliveryGateRowIo>;
+    listUncommittedPaths?: (worktreePath: string) => string[];
+    now?: () => string;
+}
+/**
+ * Record a precheck refusal on the delivery's gate_state, at the row's own
+ * status and in its serialized write turn. A standing identical hold writes
+ * nothing. Throws what the row read/write throws; the caller logs and moves on.
+ */
+export declare function recordAdvanceHold(deliveryId: string, hold: AdvancePrecheckHold, deps?: AdvanceHoldDeps): Promise<void>;
+/**
+ * Clear a recorded advance hold (the delivery re-opened: it holds open work
+ * again, so nothing is waiting on the advance). No write when there is none.
+ */
+export declare function clearAdvanceHold(deliveryId: string, deps?: AdvanceHoldDeps): Promise<void>;
+/**
+ * An advance the precheck refused: log it, and name the hold where the team and
+ * the dashboard read it -- a finished delivery held at coding otherwise looks
+ * stuck, and a team that cannot see why escalates for a status the daemon owns.
+ * The live pass (focus/listener-auto-advance.ts) and the team-exit pass
+ * (completion/status-advance-phase.ts) both call it. Logs, never throws.
+ */
+export declare function noteAdvanceRefused(delivery: {
+    id: string;
+    name: string;
+}, precheck: AdvancePrecheckResult, record?: typeof recordAdvanceHold): Promise<void>;
+/** Whether a delivery's gate_state (as read) carries an advance hold. */
+export declare function hasAdvanceHold(gateState: unknown): boolean;
+//# sourceMappingURL=advance-hold.d.ts.map

package/dist/focus/advance-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance-hold.d.ts","sourceRoot":"","sources":["../../src/focus/advance-hold.ts"],"names":[],"mappings":"AAkCA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAKxG,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAGlD,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAcnE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,EACzB,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,MAAM,EAAE,MAAM,GACb,iBAAiB,CAWnB;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAC/B,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,GAAG,SAAS,CAW/B;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAOjG;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,oBAAoB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpG;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACtC,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,GAAE,OAAO,iBAAqC,GACnD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAG1D"}