@telora/daemon 0.24.42 → 0.24.55

package/dist/focus/focus-liveness-pass.js

@@ -0,0 +1,197 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/focus-liveness-pass.test.ts,
+//   packages/daemon/src/integration/failed-verdict-review-exit-respawn-regression.test.ts,
+//   packages/daemon/src/integration/failed-verdict-review-loop-regression.test.ts
+// PINNED-BY-END
+/**
+ * The liveness pass: each poll, every ARMED focus of one product (role set, not
+ * operator-stopped, not read-only) has its one next step read
+ * (supervision/focus-next-step.ts) and counted by the liveness detector
+ * (supervision/focus-liveness.ts), and the pass does what the detector says:
+ *   - start_coding: start the coding team the step names -- for a failed HEAD's
+ *     rework, first make it startable: file the HEAD's rework Bug, or re-open the
+ *     done or paused delivery carrying it (focus/failed-head-rework-start.ts), and
+ *     close a review window still open over that HEAD (the decision says no review
+ *     serves it, and the open-work pass routes nothing while it stays open) --
+ *     and queue ONE daemon coding respawn of the focus's own lineage, naming the
+ *     decided reason (and the uncommitted paths, when that is the reason), never
+ *     over a spawn directive already queued. A rework that could not be made
+ *     startable queues nothing and is asked for again next poll, until its Bug is
+ *     filed or re-opened (the retired failed-head wedge retried the same way);
+ *   - report: file ONE agent-resolvable observation for the stalled key, carrying
+ *     a deterministic cause_key so incident correlation records it once; a filing
+ *     that fails is reported again next poll.
+ * It replaces the per-shape backstops it was built over -- the failed-head wedge,
+ * the uncommitted-work backstop and the stranded-review reroute: each of their
+ * stalls is a decided actor that did not move the focus.
+ *
+ * A stranded-work record the retired uncommitted-work backstop left on a delivery
+ * (delivery/advance-hold.ts STRANDED_WORK_REASON) is cleared here once the
+ * worktree reads clean, so the dashboard's Waiting-on line does not keep it.
+ *
+ * Best-effort: every failure is logged and the next poll retries.
+ *
+ * @module focus/focus-liveness-pass
+ */
+import { createHash } from 'node:crypto';
+import { ESCALATION_REASONS } from '@telora/daemon-core';
+import { focusPipelineModelForPass } from '../config/model-resolution.js';
+import { DISPOSITION_AGENT_RESOLVABLE } from '../queries/escalations/escalation-dispositions.js';
+import { computeCauseKey } from '../queries/escalations/cause-key.js';
+import { describeFocusNextStep } from '../supervision/focus-next-step.js';
+import { forgetFocusLiveness, observeFocusLiveness, unmarkFocusLivenessCodingStarted, unmarkFocusLivenessReported, LIVENESS_MERGE_STALL_POLLS, LIVENESS_STALL_POLLS, LIVENESS_STALL_STARTS, } from '../supervision/focus-liveness.js';
+import { hasStrandedWorkRecord } from '../delivery/advance-hold.js';
+import { createLogger } from '../log/daemon-log.js';
+const log = createLogger({ module: 'focus-poller' });
+/** metadata.cause on the stall observation. */
+export const FOCUS_NEXT_ACTOR_STALLED_CAUSE = 'focus_next_actor_stalled';
+/** At most this many uncommitted paths are named in a respawn; the count carries the rest. */
+export const LIVENESS_PATH_CAP = 20;
+const isArmed = (f) => !!f.assigned_agent_role_id && !f.operator_stopped_at && f.read_only !== true;
+/** The respawn message: the decided step, and the paths when the reason is uncommitted work. */
+export function buildLivenessRespawnMessage(focusName, next, paths) {
+    const lines = [
+        `The focus "${focusName}" has a coding team as its next step (${describeFocusNextStep(next)}), and none has started.`,
+    ];
+    if (next.step === 'coding' && next.reason === 'uncommitted_work' && paths.length > 0) {
+        const named = paths.slice(0, LIVENESS_PATH_CAP).map((p) => `- ${p}`);
+        const more = paths.length > LIVENESS_PATH_CAP ? [`- ... and ${paths.length - LIVENESS_PATH_CAP} more`] : [];
+        lines.push('', 'Its worktree holds uncommitted work -- the gate and the review judge commits, so nothing else can see it:', ...named, ...more, '', 'Finish it and commit it (with the Telora-Delivery trailer of the delivery it belongs to), or discard what is not wanted.');
+    }
+    else if (next.step === 'coding' && next.reason.startsWith('gate_rework')) {
+        lines.push('', 'The gate FAILED at the focus HEAD. Read the failure on the HEAD\'s rework Bug (title "Verify gate failed at <sha>:"), '
+            + 're-open it if it was closed with no commit, fix the failure and commit.');
+    }
+    return lines.join('\n');
+}
+/** The ONE observation a stalled key owes (agent-resolvable; its cause_key keys the stalled step and HEAD). */
+export function buildFocusStallObservation(organizationId, focus, stall, next, head) {
+    const at = head ? head.slice(0, 12) : '<unreadable HEAD>';
+    return {
+        organizationId,
+        issueId: null,
+        reasonType: ESCALATION_REASONS.ERROR_ENCOUNTERED,
+        disposition: DISPOSITION_AGENT_RESOLVABLE,
+        anchor: { focusId: focus.focus_id },
+        metadata: {
+            cause: FOCUS_NEXT_ACTOR_STALLED_CAUSE,
+            cause_key: computeCauseKey(FOCUS_NEXT_ACTOR_STALLED_CAUSE, { focusId: focus.focus_id, step: stall.step, head: head ?? 'unreadable' }),
+            step: stall.step,
+            next_step: describeFocusNextStep(next),
+            head,
+            not_started_polls: stall.notStartedPolls,
+            starts: stall.starts,
+        },
+        description: `Armed focus "${focus.focus_name}" is not moving: its next step is ${describeFocusNextStep(next)} at HEAD ${at}, and ` +
+            (stall.starts >= LIVENESS_STALL_STARTS
+                ? `that actor started ${stall.starts} times without the focus moving (no new commit, no new step).`
+                : `that actor has not started for ${stall.notStartedPolls} polls (bound ${stall.step === 'merge' ? LIVENESS_MERGE_STALL_POLLS : LIVENESS_STALL_POLLS}).`),
+        whatWasTried: 'The liveness detector read the focus\'s one next step every poll (supervision/focus-next-step.ts); a coding step ' +
+            'that did not start was given one daemon coding respawn.',
+        helpNeeded: 'Find what keeps that actor from starting or from moving the focus (daemon log: [focus-poller], [state-cascade], ' +
+            '[verification] lines for this focus) and clear it -- e.g. re-open or file the HEAD\'s rework Bug, commit or discard ' +
+            'uncommitted work, or close a review window that cannot route (telora_product_focus update clearReviewRequest).',
+    };
+}
+async function fileStall(organizationId, focus, stall, next, head, deps) {
+    try {
+        await deps.createEscalation(buildFocusStallObservation(organizationId, focus, stall, next, head));
+        log.warn(`[focus-poller] "${focus.focus_name}" is not moving: ${describeFocusNextStep(next)} at ${head?.slice(0, 12) ?? '?'} -- observation filed`);
+    }
+    catch (err) {
+        unmarkFocusLivenessReported(focus.focus_id, stall.key);
+        log.warn(`[focus-poller] "${focus.focus_name}": liveness observation not recorded (retried next poll): ${err.message}`);
+    }
+}
+/**
+ * A failed HEAD's rework needs its Bug on a routable delivery, and no review window holding its delivery in verify,
+ * before a coding team has it to work. False when that could not be made so.
+ */
+async function prepareRework(focus, next, head, deps) {
+    if (next.step !== 'coding' || !next.reason.startsWith('gate_rework'))
+        return true;
+    try {
+        if (focus.review_requested_at) {
+            await deps.closeReviewWindow(focus.focus_id);
+            log.info(`[focus-poller] "${focus.focus_name}": closed the review window over its failed HEAD -- its rework, not a review, is next`);
+        }
+        if (next.reason === 'gate_rework_unanswered' || !head || !focus.product_id)
+            return true;
+        const start = await deps.startFailedHeadRework({ focusId: focus.focus_id, productId: focus.product_id, head });
+        if (!start.ready) {
+            log.warn(`[focus-poller] "${focus.focus_name}": failed HEAD ${head.slice(0, 12)} -- ${start.did}; no coding team queued, retried next poll`);
+            return false;
+        }
+        log.info(`[focus-poller] "${focus.focus_name}": failed HEAD ${head.slice(0, 12)} -- ${start.did}`);
+        return true;
+    }
+    catch (err) {
+        log.warn(`[focus-poller] "${focus.focus_name}": failed HEAD rework not made startable -- no coding team queued; retried next poll: ${err.message}`);
+        return false;
+    }
+}
+async function startCoding(focus, next, head, key, deps) {
+    if (!(await prepareRework(focus, next, head, deps))) {
+        unmarkFocusLivenessCodingStarted(focus.focus_id, key);
+        return;
+    }
+    const paths = next.step === 'coding' && next.reason === 'uncommitted_work' ? deps.listUncommittedPaths(focus.focus_id) : [];
+    const message = buildLivenessRespawnMessage(focus.focus_name, next, paths);
+    const queued = deps.queueCodingRespawn({
+        focusId: focus.focus_id,
+        message,
+        contentHash: createHash('sha256').update(message).digest('hex'),
+        focusOverrideModel: focusPipelineModelForPass(focus.pipeline_config, 'coding'),
+    });
+    log.info(`[focus-poller] "${focus.focus_name}": ${describeFocusNextStep(next)} has not started -- ` +
+        (queued ? 'queued a coding respawn' : 'a spawn directive is already queued'));
+}
+/** Clear a stranded-work record left on a delivery once the worktree reads clean (module header). */
+async function clearStaleStrandedWork(focus, deliveries, deps) {
+    for (const d of deliveries.filter((x) => hasStrandedWorkRecord(x.gateState))) {
+        await deps.clearStrandedWorkRecord(d.id).catch((err) => log.warn(`[focus-poller] "${focus.focus_name}": stranded-work record on ${d.id} not cleared (retried next poll): ${err.message}`));
+    }
+}
+async function observeFocus(organizationId, focus, deps) {
+    const read = await deps.readNextStep(focus);
+    if (!read.readable) {
+        forgetFocusLiveness(focus.focus_id);
+        return { act: 'none' };
+    }
+    if (!read.facts.uncommittedWork)
+        await clearStaleStrandedWork(focus, read.deliveries, deps);
+    const act = observeFocusLiveness({ focusId: focus.focus_id, next: read.next, head: read.head, reviewWindow: focus.review_requested_at });
+    if (act.act === 'start_coding')
+        await startCoding(focus, read.next, read.head, act.key, deps);
+    if (act.act === 'report')
+        await fileStall(organizationId, focus, act, read.next, read.head, deps);
+    return act;
+}
+/** The liveness pass over one product's active focuses (module header). Never throws. */
+export async function detectFocusLivenessStalls(config, deps) {
+    let focuses;
+    try {
+        focuses = await deps.getActiveFocuses(config.organizationId, config.productId);
+    }
+    catch (err) {
+        log.warn(`[focus-poller] liveness pass: active focuses unreadable (retried next poll): ${err.message}`);
+        return [];
+    }
+    const acts = [];
+    for (const focus of focuses) {
+        if (!isArmed(focus)) {
+            forgetFocusLiveness(focus.focus_id);
+            continue;
+        }
+        try {
+            const act = await observeFocus(config.organizationId, focus, deps);
+            if (act.act !== 'none')
+                acts.push({ focusId: focus.focus_id, act });
+        }
+        catch (err) {
+            log.warn(`[focus-poller] liveness pass failed for "${focus.focus_name}" (retried next poll): ${err.message}`);
+        }
+    }
+    return acts;
+}
+//# sourceMappingURL=focus-liveness-pass.js.map

package/dist/focus/focus-liveness-pass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-liveness-pass.js","sourceRoot":"","sources":["../../src/focus/focus-liveness-pass.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,oEAAoE;AACpE,2FAA2F;AAC3F,kFAAkF;AAClF,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAuE,MAAM,mCAAmC,CAAC;AAC/I,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAErD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAEzE,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AA4CpC,MAAM,OAAO,GAAG,CAAC,CAAmB,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;AAE/H,gGAAgG;AAChG,MAAM,UAAU,2BAA2B,CAAC,SAAiB,EAAE,IAAmB,EAAE,KAAwB;IAC1G,MAAM,KAAK,GAAG;QACZ,cAAc,SAAS,yCAAyC,qBAAqB,CAAC,IAAI,CAAC,0BAA0B;KACtH,CAAC;IACF,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,iBAAiB,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5G,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,2GAA2G,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,EAC3I,EAAE,EAAE,0HAA0H,CAAC,CAAC;IACpI,CAAC;SAAM,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wHAAwH;cACnI,yEAAyE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,0BAA0B,CACxC,cAAsB,EACtB,KAAuB,EACvB,KAA8C,EAC9C,IAAmB,EACnB,IAAmB;IAEnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC1D,OAAO;QACL,cAAc;QACd,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,kBAAkB,CAAC,iBAAiB;QAChD,WAAW,EAAE,4BAA4B;QACzC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE;YACR,KAAK,EAAE,8BAA8B;YACrC,SAAS,EAAE,eAAe,CAAC,8BAA8B,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,YAAY,EAAE,CAAC;YACrI,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,qBAAqB,CAAC,IAAI,CAAC;YACtC,IAAI;YACJ,iBAAiB,EAAE,KAAK,CAAC,eAAe;YACxC,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB;QACD,WAAW,EACT,gBAAgB,KAAK,CAAC,UAAU,qCAAqC,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ;YACtH,CAAC,KAAK,CAAC,MAAM,IAAI,qBAAqB;gBACpC,CAAC,CAAC,sBAAsB,KAAK,CAAC,MAAM,+DAA+D;gBACnG,CAAC,CAAC,kCAAkC,KAAK,CAAC,eAAe,iBAAiB,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC;QAC7J,YAAY,EACV,mHAAmH;YACnH,yDAAyD;QAC3D,UAAU,EACR,kHAAkH;YAClH,sHAAsH;YACtH,gHAAgH;KACnH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,cAAsB,EAAE,KAAuB,EAAE,KAA8C,EACtH,IAAmB,EAAE,IAAmB,EAAE,IAAuB;IACjE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAClG,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,oBAAoB,qBAAqB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,uBAAuB,CAAC,CAAC;IACtJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2BAA2B,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,6DAA8D,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACrI,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,aAAa,CAAC,KAAuB,EAAE,IAAmB,EAAE,IAAmB,EAAE,IAAuB;IACrH,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,uFAAuF,CAAC,CAAC;QACvI,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,wBAAwB,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACxF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/G,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,kBAAkB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,GAAG,4CAA4C,CAAC,CAAC;YAC7I,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,kBAAkB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,yFAA0F,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/J,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,KAAuB,EAAE,IAAmB,EAAE,IAAmB,EAAE,GAAW,EAAE,IAAuB;IAChI,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QACpD,gCAAgC,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5H,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACrC,OAAO,EAAE,KAAK,CAAC,QAAQ;QACvB,OAAO;QACP,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,kBAAkB,EAAE,yBAAyB,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC;KAC/E,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,MAAM,qBAAqB,CAAC,IAAI,CAAC,sBAAsB;QACjG,CAAC,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,sBAAsB,CAAC,KAAuB,EAAE,UAA8D,EAAE,IAAuB;IACpJ,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAC9D,GAAG,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,8BAA8B,CAAC,CAAC,EAAE,qCAAsC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,cAAsB,EAAE,KAAuB,EAAE,IAAuB;IAClG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe;QAAE,MAAM,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACzI,IAAI,GAAG,CAAC,GAAG,KAAK,cAAc;QAAE,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9F,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,MAAM,SAAS,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClG,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAqD,EACrD,IAAuB;IAEvB,IAAI,OAAoC,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,gFAAiF,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACnH,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACnE,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,4CAA4C,KAAK,CAAC,UAAU,0BAA2B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3H,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/focus/focus-poller-spawn.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 29 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/focus/focus-poller-spawn.ts
+// Pinned by: 28 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/focus/focus-poller-spawn.ts
 // PINNED-BY-END
 import { resolveReadyFocusSpawnAction } from './ready-focus-spawn-action.js';
 import { roles, pollState, idleLoggedFocuses, nullRoleSkipWarnedFocuses, lastRolesRefreshAt, healthCheckConsecutiveFailures, POLL_INTERVAL_MS, ROLES_REFRESH_INTERVAL_MS, setPollState, setLastRolesRefreshAt, setLastReadyFocusCount, } from './focus-poller-state.js';

package/dist/focus/focus-poller-state.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: 27 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/focus/focus-poller-state.ts
+// Pinned by: 26 tests -- run: npm run gen:pinned-by -- --list packages/daemon/src/focus/focus-poller-state.ts
 // PINNED-BY-END
 /** Polling interval in milliseconds (default: 30 seconds). */
 export const POLL_INTERVAL_MS = 30000;

package/dist/focus/live-branch-preservation.d.ts

@@ -0,0 +1,123 @@
+/**
+ * What crash recovery must NOT remove, and the stale-branch pruner that obeys it.
+ *
+ * ONE RULE FOR WHICH FOCUS BRANCHES ARE LIVE. The migration allocator (the
+ * held-set publisher and the grant handler's coverage check) treats every focus
+ * with a branch and a status other than complete or cancelled as live -- armed
+ * or not -- and requires that branch in every held set. A merged branch is not
+ * a dead one: a finished focus still active (awaiting QA, its arm cleared at
+ * run end) has a branch fully contained in integration that the allocator still
+ * requires. Deleting it refuses every migration claim on the product.
+ *
+ * So recovery reads the SAME population (queries/migrations/live-focus-branches.ts,
+ * canonical src/lib/vocabulary/migration-branch-population.ts) plus every
+ * pending completion merge, once per pass, and both the classifier
+ * (focus/crash-recovery.ts) and the pruner here keep what it names. An
+ * unreadable population removes nothing.
+ *
+ * History: docs/daemon/history-platform.md (focus/live-branch-preservation.ts).
+ *
+ * @module focus/live-branch-preservation
+ */
+import type { DaemonConfig } from '../types/index.js';
+import type { LiveFocusBranch } from '../queries/migrations/live-focus-branches.js';
+/** What the live population is read through (a subset of RecoveryDeps). */
+export interface LiveBranchPreservationDeps {
+    /**
+     * The product's LIVE focus branches with their owning focuses: every focus
+     * with a branch whose status is not complete or cancelled, armed or not
+     * (queries/migrations/live-focus-branches.ts -- the rule the migration
+     * allocator and the grant handler read). Deliberately NOT getActiveFocuses,
+     * the spawn set. A rejection means the population is unknown, and nothing is
+     * removed.
+     */
+    listLiveFocusBranches: (productId: string) => Promise<LiveFocusBranch[]>;
+    /**
+     * The focus ids this host holds a pending completion merge for
+     * (merge/completion-hold-record.ts). Their worktrees are NOT orphans even when
+     * the focus has left the live set: the completed work still has to reach
+     * integration, and the merge-back loop drives it from that worktree.
+     */
+    listPendingCompletionFocusIds: (productId: string) => string[];
+}
+/**
+ * Extract the focus ID prefix (last 8 hex chars) from a worktree directory name.
+ * Focus worktree directories follow: agent-{role}-{name}-{8-char-id}
+ */
+export declare function extractFocusIdPrefix(dirName: string): string | null;
+/**
+ * Extract the 8-char focus-key suffix from an agent BRANCH name.
+ * Branch format: agent/<role>/<slug>-<8hexfocuskey>. The final path segment
+ * carries the same -<8hex> suffix that extractFocusIdPrefix parses off the
+ * worktree DIRECTORY name, so this is the branch-name analogue used to anchor a
+ * residual signal back to the owning focus.
+ */
+export declare function extractFocusKeyFromBranch(branchName: string): string | null;
+/**
+ * Parse `git worktree list --porcelain` to build a map of
+ * worktree path -> branch name for all registered worktrees.
+ */
+export declare function parseWorktreeList(repoPath: string): Map<string, string>;
+/**
+ * What crash recovery must not remove: the shared migration branch population
+ * (every focus with a branch and a status other than complete or cancelled,
+ * armed or not), plus every focus this host holds a pending completion merge
+ * for (RecoveryDeps.listPendingCompletionFocusIds) -- its completed work still
+ * has to reach integration from that worktree.
+ */
+export interface LiveFocusPopulation {
+    /** 8-char focus-id prefixes whose worktrees are persistent. */
+    focusIdPrefixes: Set<string>;
+    /** Branch names live focuses name: never pruned, never removed as a merged orphan. */
+    branches: Set<string>;
+    /** The live focuses themselves, with the status that makes each live -- what the keep log names. */
+    liveFocuses: LiveFocusBranch[];
+    /**
+     * False when the live focus read failed (or the config names no product).
+     * Recovery then removes NOTHING a focus could own: a merged branch can be
+     * recreated by nobody once it is gone, and keeping one an extra restart costs
+     * a directory.
+     */
+    known: boolean;
+}
+/** Read the population recovery preserves. Never throws: a failed read is `known: false`. */
+export declare function readLiveFocusPopulation(config: DaemonConfig, deps: LiveBranchPreservationDeps): Promise<LiveFocusPopulation>;
+/**
+ * Why the population keeps a branch (or the worktree carrying `idPrefix`), or
+ * null when it does not. A LIVE focus is named with the status that makes it
+ * live, so a log reader sees the rule -- not complete or cancelled, armed or
+ * not -- rather than having to infer it; a pending completion merge is a
+ * different reason and says so.
+ */
+export declare function keepReason(population: LiveFocusPopulation, idPrefix: string | null, branchName: string): string | null;
+/**
+ * Whether the live population keeps a REGISTERED worktree: its directory
+ * carries a live (or pending-completion) focus's id prefix, or its branch is
+ * one a live focus names -- merged or not, since its focus can still commit and
+ * the allocator requires the branch in every held set. When the population
+ * could not be read every worktree is kept: whether it is live is unknown, and
+ * it is not removed on a guess.
+ */
+export declare function populationKeepsWorktree(population: LiveFocusPopulation, dirName: string, worktreePath: string, branchName: string): boolean;
+/**
+ * Prune stale agent branches that have no worktree, no unmerged commits, and
+ * that NO LIVE FOCUS NAMES.
+ *
+ * A merged branch is not a dead one: a finished focus that is still active
+ * (awaiting QA, its arm cleared at run end) has a branch fully contained in
+ * integration, and the migration allocator still requires it in every held
+ * set. So the live population (`LiveFocusPopulation`, the same rule the
+ * allocator reads) is consulted before anything is deleted, and an unknown
+ * population prunes nothing.
+ *
+ * Same housekeeping policy as the orphaned-worktree path: a branch with
+ * unmerged commits is PRESERVED and LOGGED (the commits are recoverable from
+ * the ref), never escalated. A merged branch with no worktree is safe to delete.
+ * No path here files a needs_operator escalation -- branch-only orphans are
+ * reality-side housekeeping the daemon owns.
+ */
+export declare function pruneStaleAgentBranches(config: DaemonConfig, livePopulation: LiveFocusPopulation): {
+    pruned: string[];
+    preserved: string[];
+};
+//# sourceMappingURL=live-branch-preservation.d.ts.map

package/dist/focus/live-branch-preservation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-branch-preservation.d.ts","sourceRoot":"","sources":["../../src/focus/live-branch-preservation.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAKpF,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,qBAAqB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACzE;;;;;OAKG;IACH,6BAA6B,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAChE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,oGAAoG;IACpG,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,6FAA6F;AAC7F,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuBlI;AAcD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAWT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,mBAAmB,GAClC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAyD3C"}

package/dist/focus/live-branch-preservation.js

@@ -0,0 +1,192 @@
+// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
+// Pinned by: packages/daemon/src/focus/crash-recovery.test.ts,
+//   packages/daemon/src/integration/finished-merged-active-focus-restart-regression.test.ts
+// PINNED-BY-END
+import { runGitSync } from '../git/types.js';
+import { branchHasUnmergedCommits } from '../worktree/safety.js';
+import { createLogger } from '../log/daemon-log.js';
+const log = createLogger({ module: 'crash-recovery' });
+/**
+ * Extract the focus ID prefix (last 8 hex chars) from a worktree directory name.
+ * Focus worktree directories follow: agent-{role}-{name}-{8-char-id}
+ */
+export function extractFocusIdPrefix(dirName) {
+    const match = dirName.match(/-([0-9a-f]{8})$/);
+    return match ? match[1] : null;
+}
+/**
+ * Extract the 8-char focus-key suffix from an agent BRANCH name.
+ * Branch format: agent/<role>/<slug>-<8hexfocuskey>. The final path segment
+ * carries the same -<8hex> suffix that extractFocusIdPrefix parses off the
+ * worktree DIRECTORY name, so this is the branch-name analogue used to anchor a
+ * residual signal back to the owning focus.
+ */
+export function extractFocusKeyFromBranch(branchName) {
+    const lastSegment = branchName.split('/').pop() ?? branchName;
+    return extractFocusIdPrefix(lastSegment);
+}
+/**
+ * Parse `git worktree list --porcelain` to build a map of
+ * worktree path -> branch name for all registered worktrees.
+ */
+export function parseWorktreeList(repoPath) {
+    const result = runGitSync(['worktree', 'list', '--porcelain'], repoPath);
+    const map = new Map();
+    if (!result.success)
+        return map;
+    let currentPath = null;
+    for (const line of result.output.split('\n')) {
+        if (line.startsWith('worktree ')) {
+            currentPath = line.slice('worktree '.length);
+        }
+        else if (line.startsWith('branch refs/heads/') && currentPath) {
+            map.set(currentPath, line.slice('branch refs/heads/'.length));
+            currentPath = null;
+        }
+        else if (line === '') {
+            currentPath = null;
+        }
+    }
+    return map;
+}
+/** Read the population recovery preserves. Never throws: a failed read is `known: false`. */
+export async function readLiveFocusPopulation(config, deps) {
+    const population = { focusIdPrefixes: new Set(), branches: new Set(), liveFocuses: [], known: false };
+    if (config.productId) {
+        try {
+            for (const live of await deps.listLiveFocusBranches(config.productId)) {
+                population.focusIdPrefixes.add(live.focusId.slice(0, 8));
+                population.branches.add(live.branchName);
+                population.liveFocuses.push(live);
+            }
+            population.known = true;
+        }
+        catch (err) {
+            log.warn(`[crash-recovery] Failed to read the live focus branches: ${err instanceof Error ? err.message : String(err)}. ` +
+                `No focus worktree or agent branch will be removed this pass.`);
+        }
+    }
+    else {
+        log.warn('[crash-recovery] No product in config: the live focus branches cannot be read, so nothing a focus owns is removed.');
+    }
+    for (const focusId of deps.listPendingCompletionFocusIds(config.productId)) {
+        population.focusIdPrefixes.add(focusId.slice(0, 8));
+    }
+    return population;
+}
+/**
+ * List all local branches matching the agent/* pattern.
+ */
+function listAgentBranches(repoPath) {
+    const result = runGitSync(['branch', '--list', 'agent/*'], repoPath);
+    if (!result.success)
+        return [];
+    return result.output
+        .split('\n')
+        .map((line) => line.replace(/^[*+]?\s+/, '').trim())
+        .filter(Boolean);
+}
+/**
+ * Why the population keeps a branch (or the worktree carrying `idPrefix`), or
+ * null when it does not. A LIVE focus is named with the status that makes it
+ * live, so a log reader sees the rule -- not complete or cancelled, armed or
+ * not -- rather than having to infer it; a pending completion merge is a
+ * different reason and says so.
+ */
+export function keepReason(population, idPrefix, branchName) {
+    const live = population.liveFocuses.find((f) => f.branchName === branchName || (idPrefix !== null && f.focusId.startsWith(idPrefix)));
+    if (live) {
+        return `focus ${live.focusId} is live (status '${live.status}', not complete or cancelled), so its branch ` +
+            'is kept merged or not -- the migration allocator requires it in every held set';
+    }
+    if (idPrefix !== null && population.focusIdPrefixes.has(idPrefix)) {
+        return `focus-key ${idPrefix} has a pending completion merge on this host`;
+    }
+    return null;
+}
+/**
+ * Whether the live population keeps a REGISTERED worktree: its directory
+ * carries a live (or pending-completion) focus's id prefix, or its branch is
+ * one a live focus names -- merged or not, since its focus can still commit and
+ * the allocator requires the branch in every held set. When the population
+ * could not be read every worktree is kept: whether it is live is unknown, and
+ * it is not removed on a guess.
+ */
+export function populationKeepsWorktree(population, dirName, worktreePath, branchName) {
+    const reason = keepReason(population, extractFocusIdPrefix(dirName), branchName);
+    if (reason) {
+        log.info(`[crash-recovery] Keeping worktree and branch: ${reason}: ${worktreePath} [${branchName}]`);
+        return true;
+    }
+    if (!population.known) {
+        log.warn(`[crash-recovery] Keeping worktree (live focus branches unknown this pass): ${worktreePath} [${branchName}]`);
+        return true;
+    }
+    return false;
+}
+/**
+ * Prune stale agent branches that have no worktree, no unmerged commits, and
+ * that NO LIVE FOCUS NAMES.
+ *
+ * A merged branch is not a dead one: a finished focus that is still active
+ * (awaiting QA, its arm cleared at run end) has a branch fully contained in
+ * integration, and the migration allocator still requires it in every held
+ * set. So the live population (`LiveFocusPopulation`, the same rule the
+ * allocator reads) is consulted before anything is deleted, and an unknown
+ * population prunes nothing.
+ *
+ * Same housekeeping policy as the orphaned-worktree path: a branch with
+ * unmerged commits is PRESERVED and LOGGED (the commits are recoverable from
+ * the ref), never escalated. A merged branch with no worktree is safe to delete.
+ * No path here files a needs_operator escalation -- branch-only orphans are
+ * reality-side housekeeping the daemon owns.
+ */
+export function pruneStaleAgentBranches(config, livePopulation) {
+    const { repoPath, integrationBranch } = config;
+    const branches = listAgentBranches(repoPath);
+    const pruned = [];
+    const preserved = [];
+    if (branches.length === 0) {
+        log.info('No stale agent branches found');
+        return { pruned, preserved };
+    }
+    if (!livePopulation.known) {
+        log.warn(`[crash-recovery] Branch pruning skipped: the live focus branches are unknown this pass (${branches.length} agent branch(es) kept)`);
+        return { pruned, preserved };
+    }
+    // Get set of branches that have active worktrees
+    const worktreeMap = parseWorktreeList(repoPath);
+    const worktreeBranches = new Set(worktreeMap.values());
+    for (const branch of branches) {
+        // Skip branches with active worktrees
+        if (worktreeBranches.has(branch))
+            continue;
+        // A branch a live focus names is never pruned, merged or not; nor is the
+        // branch of a pending completion merge.
+        const focusKey = extractFocusKeyFromBranch(branch);
+        const keep = keepReason(livePopulation, focusKey, branch);
+        if (keep) {
+            log.info(`[crash-recovery] Keeping branch: ${keep}: ${branch}`);
+            continue;
+        }
+        // Check for unmerged commits
+        if (branchHasUnmergedCommits(branch, integrationBranch, repoPath)) {
+            log.info(`[crash-recovery] Housekeeping: preserving stale branch with unmerged commits: ${branch}` +
+                (focusKey ? ` (focus-key ${focusKey})` : ''));
+            preserved.push(branch);
+            continue;
+        }
+        // Safe to delete
+        const deleteResult = runGitSync(['branch', '-D', branch], repoPath);
+        if (deleteResult.success) {
+            log.info(`Pruned stale branch: ${branch}`);
+            pruned.push(branch);
+        }
+        else {
+            log.warn(`Failed to prune branch ${branch}: ${deleteResult.error}`);
+        }
+    }
+    log.info(`[crash-recovery] Branch pruning: ${pruned.length} pruned, ${preserved.length} preserved with unmerged work`);
+    return { pruned, preserved };
+}
+//# sourceMappingURL=live-branch-preservation.js.map

package/dist/focus/live-branch-preservation.js.map

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

package/dist/focus/migration-claim-pass.d.ts

@@ -30,6 +30,8 @@ export interface MigrationClaimPassResult {
     skippedUnchanged: number;
     /** Focuses whose branch could not be read: nothing was applied for them. */
     unreadable: number;
+    /** Focuses whose unclaimed-file record or clear write failed: retried next tick. */
+    recordFailed: number;
 }
 /**
  * Run the confirm / release / unclaimed-file passes for one product.

package/dist/focus/migration-claim-pass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-claim-pass.d.ts","sourceRoot":"","sources":["../../src/focus/migration-claim-pass.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAKrF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EAEzB,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAIlF,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9D,UAAU,EAAE,OAAO,uBAAuB,CAAC;IAC3C,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,eAAe,EAAE,OAAO,yBAAyB,CAAC;IAClD,cAAc,EAAE,OAAO,wBAAwB,CAAC;IAChD,uEAAuE;IACvE,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,wBAAwB,CAAC;IAC3E,sEAAsE;IACtE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7D,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAWD,sFAAsF;AACtF,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;CACpB;AAuKD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CAsCnC"}
+{"version":3,"file":"migration-claim-pass.d.ts","sourceRoot":"","sources":["../../src/focus/migration-claim-pass.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAMrF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EAEzB,MAAM,+DAA+D,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAIlF,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9D,UAAU,EAAE,OAAO,uBAAuB,CAAC;IAC3C,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,eAAe,EAAE,OAAO,yBAAyB,CAAC;IAClD,cAAc,EAAE,OAAO,wBAAwB,CAAC;IAChD,uEAAuE;IACvE,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,wBAAwB,CAAC;IAC3E,sEAAsE;IACtE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7D,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAWD,sFAAsF;AACtF,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;CACtB;AA+MD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CAsCnC"}