@telora/daemon 0.22.87 → 0.22.97

package/dist/focus/team-actionable-work.d.ts

@@ -14,17 +14,42 @@ export interface FocusHoldDeps {
 /**
  * Whether the focus's worktree is currently held by an in-flight verify command.
  *
- * The daemon runs a product's configured verify command inside the focus
- * worktree and commits from that same worktree; the verify interlock
+ * The daemon runs a product's configured verify command for a delivery of this
+ * focus and commits from the focus worktree; the verify interlock
  * (worktree/verify-interlock.ts) serialises the two. While the hold is held the
  * daemon defers the coding->verify advance (delivery/delivery-advance-block.ts)
- * rather than snapshot a mid-verify tree, so the delivery sits non-terminal with
- * nothing a freshly-spawned coding team could commit or advance.
+ * rather than snapshot a mid-verify tree.
  *
  * A focus with no registered worktree is not held: no verify can run without a
  * worktree to run it in.
  */
 export declare function focusUnderVerifyHold(focusId: string, deps?: FocusHoldDeps): boolean;
+/** The delivery slice the outside-hold work fact reads (structural). */
+export interface HoldWorkDelivery {
+    id: string;
+    executionStatus?: string | null;
+}
+/** The issue slice the outside-hold work fact reads (structural). */
+export interface HoldWorkIssue {
+    deliveryId: string;
+    status: string;
+}
+/**
+ * Whether a delivery OUTSIDE the verified set carries open work a coding team
+ * could act on: an agent-actionable delivery (queued / coding / verify_failed)
+ * that is not being judged by an in-flight verify, holding an open issue. The
+ * same "open issue on an agent-actionable delivery" fact the team-exit reads
+ * (computeCompletionFacts postHasActionableOpen), minus the held deliveries.
+ *
+ * A coding delivery whose advance the hold defers has every issue terminal (that
+ * is why it is advancing), so it contributes nothing -- the 2026-09-06 storm
+ * shape stays "no actionable work".
+ */
+export declare function hasTeamWorkOutsideVerify(input: {
+    deliveries: readonly HoldWorkDelivery[];
+    issues: readonly HoldWorkIssue[];
+    heldDeliveryIds: ReadonlySet<string>;
+}): boolean;
 /** Facts the actionable-work question is decided from. */
 export interface TeamActionableWorkInput {
     /**
@@ -36,12 +61,18 @@ export interface TeamActionableWorkInput {
      */
     hasUnheldActionableWork: boolean;
     /**
-     * Whether a verify command is currently running in the focus worktree
+     * Whether a verify command is currently running for a delivery of this focus
      * (focusUnderVerifyHold). While held, the daemon is deferring this focus's
-     * advance, so there is nothing a coding team could commit or advance -- it
-     * would run one turn and terminate.
+     * advance.
      */
     underVerifyHold: boolean;
+    /**
+     * Under a hold: whether a delivery OUTSIDE the verified set still carries open
+     * work ({@link hasTeamWorkOutsideVerify}). Absent reads as false -- a caller
+     * that cannot see sibling work keeps the storm-safe "held = no work" verdict.
+     * Ignored when there is no hold.
+     */
+    workOutsideVerifyHold?: boolean;
     /**
      * Whether the daemon has sent THIS team a merge-conflict resolution request it
      * has not yet answered (teamState.resolvingMergeConflict, set in
@@ -58,23 +89,30 @@ export interface TeamActionableWorkInput {
  * The one predicate. An outstanding merge-conflict resolution request the daemon
  * sent this team IS actionable work regardless of delivery state -- it takes
  * precedence so a team finishing its last delivery is never torn down mid-merge.
- * Otherwise a focus held by an in-flight verify has NO team-actionable work
- * regardless of its delivery state, and failing both, the caller's own
- * actionable-work fact stands. Pure, so both the spawn gate and the team-exit
- * decision read the identical answer for a given state.
+ * Otherwise, under a verify hold the focus is actionable only when work exists
+ * OUTSIDE the delivery being verified (never more than the caller's own fact);
+ * with no hold, the caller's own actionable-work fact stands. Pure, so every
+ * controller reads the identical answer for a given state.
  */
 export declare function focusHasTeamActionableWork(input: TeamActionableWorkInput): boolean;
 /**
  * Resolve the verify hold for a focus whose worktree path is already known, and
  * fold it into the shared predicate in one step. Convenience for the team-exit
  * fact-gathering (computeCompletionFacts), which has already resolved the
- * worktree path; a null path means no worktree -> no hold. The isWorktreeUnderVerify
- * dep is passed in so the caller keeps its own injection seam.
+ * worktree path and fetched the focus's deliveries + issues; a null path means no
+ * worktree -> no hold. The isWorktreeUnderVerify dep is passed in so the caller
+ * keeps its own injection seam.
  */
 export declare function resolveTeamActionableWork(args: {
     focusWorktreePath: string | null;
     hasUnheldActionableWork: boolean;
     isWorktreeUnderVerify: (worktreePath: string) => boolean;
+    /** The focus's deliveries + issues, read under a hold to find work outside the verified set. */
+    outsideHold?: {
+        deliveries: readonly HoldWorkDelivery[];
+        issues: readonly HoldWorkIssue[];
+        verifyHeldDeliveryIds?: (worktreePath: string) => ReadonlySet<string>;
+    };
     /** See TeamActionableWorkInput.mergeResolutionOutstanding. Optional; defaults
      *  to false so callers that do not track it are unaffected. */
     mergeResolutionOutstanding?: boolean;
@@ -82,6 +120,25 @@ export declare function resolveTeamActionableWork(args: {
     underVerifyHold: boolean;
     teamHasActionableWork: boolean;
 };
+/** The hold facts a spawn-producing controller feeds the shared predicate. */
+export interface VerifyHoldFacts {
+    underVerifyHold: boolean;
+    workOutsideVerifyHold: boolean;
+}
+/** Injectable seam for {@link resolveFocusVerifyHoldFacts}. */
+export interface FocusHoldWorkDeps extends FocusHoldDeps {
+    verifyHeldDeliveryIds?: (worktreePath: string) => ReadonlySet<string>;
+    getFocusDeliveries?: (focusId: string) => Promise<readonly HoldWorkDelivery[]>;
+    getFocusIssues?: (focusId: string) => Promise<readonly HoldWorkIssue[]>;
+}
+/**
+ * Resolve the hold facts for a focus the caller knows only by id (the spawn gate,
+ * the pending-spawn pass, the directive executor). Reads deliveries + issues ONLY
+ * when the focus is held -- an unheld focus costs no fetch. A failed read fails
+ * CLOSED to "no work outside the hold": the storm-safe verdict (defer the spawn,
+ * re-read next poll), never a spawn into a focus whose work could not be seen.
+ */
+export declare function resolveFocusVerifyHoldFacts(focusId: string, deps?: FocusHoldWorkDeps): Promise<VerifyHoldFacts>;
 /** Injectable seam for {@link anyFocusUnderVerifyHold}. */
 export interface AnyFocusHoldDeps {
     getAllFocusWorktrees?: () => ReadonlyMap<string, {
@@ -95,13 +152,12 @@ export interface AnyFocusHoldDeps {
  * (focus-worktree-state + verify-interlock), so the drain/idle gate agrees with
  * the spawn gate and the team-exit classifier about "is a verify in flight".
  *
- * The auto-updater consumes this: a verify runs as a spawned child inside a
- * worktree (verification-deterministic.ts) that can last up to ~30 min, and
- * during that hold there is often NO active team (the coding team already
- * exited, which is why the delivery is deferred at coding->verify). Restarting
- * the daemon then would kill the verify mid-run, so an in-flight hold must read
- * as "not idle" REGARDLESS of team count or queue depth -- robustly, not by the
- * incidental fact that a held focus happens to stay in the ready set.
+ * The auto-updater consumes this: a verify runs as a spawned child (verification-
+ * deterministic.ts) that can last up to ~30 min, and during that hold there is
+ * often NO active team. Restarting the daemon then would kill the verify
+ * mid-run, so an in-flight hold must read as "not idle" REGARDLESS of team count,
+ * queue depth, or which delivery it judges -- robustly, not by the incidental
+ * fact that a held focus happens to stay in the ready set.
  */
 export declare function anyFocusUnderVerifyHold(deps?: AnyFocusHoldDeps): boolean;
 //# sourceMappingURL=team-actionable-work.d.ts.map

package/dist/focus/team-actionable-work.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team-actionable-work.d.ts","sourceRoot":"","sources":["../../src/focus/team-actionable-work.ts"],"names":[],"mappings":"AA4CA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC7E,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAMvF;AAED,0DAA0D;AAC1D,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,uBAAuB,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;;;;;OASG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAIlF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD;mEAC+D;IAC/D,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,GAAG;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAA;CAAE,CAW/D;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,CAAC,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAO5E"}
+{"version":3,"file":"team-actionable-work.d.ts","sourceRoot":"","sources":["../../src/focus/team-actionable-work.ts"],"names":[],"mappings":"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"}

package/dist/focus/team-actionable-work.js

@@ -7,7 +7,8 @@
  * The single definition of "is there team-actionable work for this focus right
  * now?", read by every controller that can spawn, hold, or exit a team so they
  * cannot disagree about the same focus state:
- *   - the spawn gate            (focus/listener-spawn.ts, decideFocusSpawn)
+ *   - the spawn gate            (focus/listener-spawn.ts, decideFocusSpawn +
+ *                                processPendingSpawnFocuses)
  *   - the team-exit decision    (completion/event-phases.ts, computeCompletionFacts)
  *   - the directive executor's spawn-producing paths
  *                               (directive/directive-verify-hold-gate.ts, consumed
@@ -35,19 +36,34 @@
  * reported ready in the first place: no spawn, no no-op cycle to bound, nothing
  * billed.
  *
+ * Why the hold is DELIVERY-scoped: the hold is keyed on the focus worktree, which
+ * every delivery of the focus shares, but "held = nothing to do" is only true of
+ * the delivery the verify is JUDGING (and a delivery whose advance it defers,
+ * which has no open work by construction). Reading the worktree hold as "the
+ * whole focus has nothing to do" starved a sibling delivery holding an open Bug
+ * -- the very defect failing every verify -- so the team that would fix the red
+ * was torn down and never respawned (livelock, f1 2026-09-13). So under a hold a
+ * focus is actionable iff a delivery OUTSIDE the verified set still carries open
+ * work ({@link hasTeamWorkOutsideVerify}); the storm shape (the verified delivery
+ * is the only non-terminal work) still reads as no actionable work.
+ *
  * @module focus/team-actionable-work
  */
 import { getFocusWorktree, getAllFocusWorktrees } from './focus-worktree-state.js';
-import { isWorktreeUnderVerify } from '../worktree/verify-interlock.js';
+import { isWorktreeUnderVerify, verifyHeldDeliveryIds } from '../worktree/verify-interlock.js';
+import { getFocusDeliveries, getFocusIssues } from '../queries/focuses.js';
+import { isStatusAgentActionable } from '../workflow/stage-classifier.js';
+import { OPEN_ISSUE_STATUSES } from '../shell/constants.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'focus' });
 /**
  * Whether the focus's worktree is currently held by an in-flight verify command.
  *
- * The daemon runs a product's configured verify command inside the focus
- * worktree and commits from that same worktree; the verify interlock
+ * The daemon runs a product's configured verify command for a delivery of this
+ * focus and commits from the focus worktree; the verify interlock
  * (worktree/verify-interlock.ts) serialises the two. While the hold is held the
  * daemon defers the coding->verify advance (delivery/delivery-advance-block.ts)
- * rather than snapshot a mid-verify tree, so the delivery sits non-terminal with
- * nothing a freshly-spawned coding team could commit or advance.
+ * rather than snapshot a mid-verify tree.
  *
  * A focus with no registered worktree is not held: no verify can run without a
  * worktree to run it in.
@@ -60,53 +76,102 @@ export function focusUnderVerifyHold(focusId, deps = {}) {
         return false;
     return underVerify(worktreePath);
 }
+/**
+ * Whether a delivery OUTSIDE the verified set carries open work a coding team
+ * could act on: an agent-actionable delivery (queued / coding / verify_failed)
+ * that is not being judged by an in-flight verify, holding an open issue. The
+ * same "open issue on an agent-actionable delivery" fact the team-exit reads
+ * (computeCompletionFacts postHasActionableOpen), minus the held deliveries.
+ *
+ * A coding delivery whose advance the hold defers has every issue terminal (that
+ * is why it is advancing), so it contributes nothing -- the 2026-09-06 storm
+ * shape stays "no actionable work".
+ */
+export function hasTeamWorkOutsideVerify(input) {
+    const actionableIds = new Set(input.deliveries
+        .filter((d) => !input.heldDeliveryIds.has(d.id) && isStatusAgentActionable(d.executionStatus ?? ''))
+        .map((d) => d.id));
+    return input.issues.some((i) => actionableIds.has(i.deliveryId) && OPEN_ISSUE_STATUSES.has(i.status));
+}
 /**
  * The one predicate. An outstanding merge-conflict resolution request the daemon
  * sent this team IS actionable work regardless of delivery state -- it takes
  * precedence so a team finishing its last delivery is never torn down mid-merge.
- * Otherwise a focus held by an in-flight verify has NO team-actionable work
- * regardless of its delivery state, and failing both, the caller's own
- * actionable-work fact stands. Pure, so both the spawn gate and the team-exit
- * decision read the identical answer for a given state.
+ * Otherwise, under a verify hold the focus is actionable only when work exists
+ * OUTSIDE the delivery being verified (never more than the caller's own fact);
+ * with no hold, the caller's own actionable-work fact stands. Pure, so every
+ * controller reads the identical answer for a given state.
  */
 export function focusHasTeamActionableWork(input) {
     if (input.mergeResolutionOutstanding)
         return true;
     if (input.underVerifyHold)
-        return false;
+        return input.hasUnheldActionableWork && input.workOutsideVerifyHold === true;
     return input.hasUnheldActionableWork;
 }
 /**
  * Resolve the verify hold for a focus whose worktree path is already known, and
  * fold it into the shared predicate in one step. Convenience for the team-exit
  * fact-gathering (computeCompletionFacts), which has already resolved the
- * worktree path; a null path means no worktree -> no hold. The isWorktreeUnderVerify
- * dep is passed in so the caller keeps its own injection seam.
+ * worktree path and fetched the focus's deliveries + issues; a null path means no
+ * worktree -> no hold. The isWorktreeUnderVerify dep is passed in so the caller
+ * keeps its own injection seam.
  */
 export function resolveTeamActionableWork(args) {
     const underVerifyHold = args.focusWorktreePath !== null && args.isWorktreeUnderVerify(args.focusWorktreePath);
+    const workOutsideVerifyHold = underVerifyHold && args.outsideHold !== undefined
+        && hasTeamWorkOutsideVerify({
+            deliveries: args.outsideHold.deliveries,
+            issues: args.outsideHold.issues,
+            heldDeliveryIds: (args.outsideHold.verifyHeldDeliveryIds ?? verifyHeldDeliveryIds)(args.focusWorktreePath),
+        });
     return {
         underVerifyHold,
         teamHasActionableWork: focusHasTeamActionableWork({
             hasUnheldActionableWork: args.hasUnheldActionableWork,
             underVerifyHold,
+            workOutsideVerifyHold,
             mergeResolutionOutstanding: args.mergeResolutionOutstanding,
         }),
     };
 }
+/**
+ * Resolve the hold facts for a focus the caller knows only by id (the spawn gate,
+ * the pending-spawn pass, the directive executor). Reads deliveries + issues ONLY
+ * when the focus is held -- an unheld focus costs no fetch. A failed read fails
+ * CLOSED to "no work outside the hold": the storm-safe verdict (defer the spawn,
+ * re-read next poll), never a spawn into a focus whose work could not be seen.
+ */
+export async function resolveFocusVerifyHoldFacts(focusId, deps = {}) {
+    const worktreePath = (deps.getFocusWorktree ?? getFocusWorktree)(focusId)?.worktreePath ?? null;
+    if (worktreePath === null || !(deps.isWorktreeUnderVerify ?? isWorktreeUnderVerify)(worktreePath)) {
+        return { underVerifyHold: false, workOutsideVerifyHold: false };
+    }
+    try {
+        const [deliveries, issues] = await Promise.all([
+            (deps.getFocusDeliveries ?? getFocusDeliveries)(focusId),
+            (deps.getFocusIssues ?? getFocusIssues)(focusId),
+        ]);
+        const heldDeliveryIds = (deps.verifyHeldDeliveryIds ?? verifyHeldDeliveryIds)(worktreePath);
+        return { underVerifyHold: true, workOutsideVerifyHold: hasTeamWorkOutsideVerify({ deliveries, issues, heldDeliveryIds }) };
+    }
+    catch (err) {
+        log.debug(`[team-actionable-work] hold-facts read failed for focus ${focusId.slice(0, 8)}; treating as held with no outside work: ${err.message}`);
+        return { underVerifyHold: true, workOutsideVerifyHold: false };
+    }
+}
 /**
  * Whether ANY registered focus worktree is currently held by an in-flight
  * verify. Reads the same hold source the per-focus predicate does
  * (focus-worktree-state + verify-interlock), so the drain/idle gate agrees with
  * the spawn gate and the team-exit classifier about "is a verify in flight".
  *
- * The auto-updater consumes this: a verify runs as a spawned child inside a
- * worktree (verification-deterministic.ts) that can last up to ~30 min, and
- * during that hold there is often NO active team (the coding team already
- * exited, which is why the delivery is deferred at coding->verify). Restarting
- * the daemon then would kill the verify mid-run, so an in-flight hold must read
- * as "not idle" REGARDLESS of team count or queue depth -- robustly, not by the
- * incidental fact that a held focus happens to stay in the ready set.
+ * The auto-updater consumes this: a verify runs as a spawned child (verification-
+ * deterministic.ts) that can last up to ~30 min, and during that hold there is
+ * often NO active team. Restarting the daemon then would kill the verify
+ * mid-run, so an in-flight hold must read as "not idle" REGARDLESS of team count,
+ * queue depth, or which delivery it judges -- robustly, not by the incidental
+ * fact that a held focus happens to stay in the ready set.
  */
 export function anyFocusUnderVerifyHold(deps = {}) {
     const resolveAll = deps.getAllFocusWorktrees ?? getAllFocusWorktrees;

package/dist/focus/team-actionable-work.js.map

@@ -1 +1 @@
-{"version":3,"file":"team-actionable-work.js","sourceRoot":"","sources":["../../src/focus/team-actionable-work.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,iEAAiE;AACjE,2DAA2D;AAC3D,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAcxE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAAsB,EAAE;IAC5E,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IACxE,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,CAAC;IACpE,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC;AAgCD;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAA8B;IACvE,IAAI,KAAK,CAAC,0BAA0B;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,uBAAuB,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAOzC;IACC,MAAM,eAAe,GACnB,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxF,OAAO;QACL,eAAe;QACf,qBAAqB,EAAE,0BAA0B,CAAC;YAChD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,eAAe;YACf,0BAA0B,EAAE,IAAI,CAAC,0BAA0B;SAC5D,CAAC;KACH,CAAC;AACJ,CAAC;AAQD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAyB,EAAE;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,IAAI,oBAAoB,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,IAAI,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"team-actionable-work.js","sourceRoot":"","sources":["../../src/focus/team-actionable-work.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,iEAAiE;AACjE,2DAA2D;AAC3D,gBAAgB;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAc9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAAsB,EAAE;IAC5E,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IACxE,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,CAAC;IACpE,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC;AAcD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAIxC;IACC,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,KAAK,CAAC,UAAU;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,uBAAuB,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;SACnG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACpB,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACxG,CAAC;AAsCD;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAA8B;IACvE,IAAI,KAAK,CAAC,0BAA0B;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC,uBAAuB,IAAI,KAAK,CAAC,qBAAqB,KAAK,IAAI,CAAC;IACxG,OAAO,KAAK,CAAC,uBAAuB,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAazC;IACC,MAAM,eAAe,GACnB,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxF,MAAM,qBAAqB,GAAG,eAAe,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;WAC1E,wBAAwB,CAAC;YAC1B,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;YACvC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;YAC/B,eAAe,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,CAAC,IAAI,CAAC,iBAA2B,CAAC;SACrH,CAAC,CAAC;IACL,OAAO;QACL,eAAe;QACf,qBAAqB,EAAE,0BAA0B,CAAC;YAChD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;YACrD,eAAe;YACf,qBAAqB;YACrB,0BAA0B,EAAE,IAAI,CAAC,0BAA0B;SAC5D,CAAC;KACH,CAAC;AACJ,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAe,EACf,OAA0B,EAAE;IAE5B,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,CAAC;IAChG,IAAI,YAAY,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QAClG,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,CAAC,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,CAAC,OAAO,CAAC;YACxD,CAAC,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,CAAC,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5F,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE,wBAAwB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC7H,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,2DAA2D,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,4CAA6C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9J,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC;IACjE,CAAC;AACH,CAAC;AAQD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAyB,EAAE;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,IAAI,oBAAoB,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,IAAI,qBAAqB,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,IAAI,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/nexus/incoming.js

@@ -1,5 +1,5 @@
 // PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: none -- no test imports this module directly (baselined; see lint:pinned-by)
+// Pinned by: packages/daemon/src/nexus/nexus-return-path-e2e.test.ts
 // PINNED-BY-END
 import { callApi } from '../queries/shared.js';
 import { createLogger } from '../shell/log.js';

package/dist/nexus/incoming.js.map

@@ -1 +1 @@
-{"version":3,"file":"incoming.js","sourceRoot":"","sources":["../../src/nexus/incoming.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"incoming.js","sourceRoot":"","sources":["../../src/nexus/incoming.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,qEAAqE;AACrE,gBAAgB;AAwBhB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAaxD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;AACrE,CAAC;AASD,8DAA8D;AAC9D,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACpC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAmC,sBAAsB,EAAE;gBAClF,SAAS;gBACT,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC5B,CAAC;QACD,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACnC,MAAM,GAAG,GAAG,MAAM,OAAO,CAA+C,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9F,OAAO,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACtG,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YACjC,MAAM,OAAO,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAoB,EACpB,OAA0B,wBAAwB,EAAE;IAEpD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1D,IAAI,QAA2B,CAAC;IAChC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,gDAAgD,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElC,IAAI,MAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,4CAA4C,SAAS,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,OAAO;IACT,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,aAAa,EAAE,CAAC;QAC7C,GAAG,CAAC,WAAW,QAAQ,CAAC,MAAM,4BAA4B,SAAS,+CAA+C,CAAC,CAAC;QACpH,OAAO;IACT,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,GAAG,CAAC,iCAAiC,GAAG,CAAC,EAAE,gBAAgB,SAAS,iDAAiD,CAAC,CAAC;QACzH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,oCAAoC,GAAG,CAAC,EAAE,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/nexus/pending-returns.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Nexus pending returns on the REQUESTING focus: what that focus is waiting on
+ * across products, and what came back.
+ *
+ * A pending return (product_request_pending_returns) is one return -- a
+ * discovery, question or findings entry the requested team sent, or the
+ * request's close / decline -- carried on the requesting focus until the
+ * requesting team acknowledges it. This module owns the READ + RENDER half:
+ *
+ *   - resolveNexusReturnsSection: loads the focus's unacknowledged returns and
+ *     the open outgoing requests the focus waits on (filed from the focus OR
+ *     from one of its deliveries), and renders ONE prompt section with every
+ *     return's FULL content (never truncated). The spawn path folds it into the
+ *     carried section every pass receives -- fresh coding, scoping, resume and
+ *     review -- so no pass on the focus misses a return.
+ *   - buildNexusReturnHandOff: the message handed to a LIVE team when a new
+ *     return arrives mid-session (nexus/return-routing.ts decides when).
+ *
+ * Leaf module: imports only query helpers, never the return / routing passes,
+ * so both the spawn path and the poll pass can import it without a cycle.
+ */
+import { type CallApiDeps } from '../queries/shared.js';
+/** Rows per pending-return page (the product-api's max `limit`). */
+export declare const PENDING_RETURNS_PAGE_SIZE = 500;
+/**
+ * Read EVERY pending return matching the filter, oldest first. One list call
+ * serves at most a page, so a burst larger than a page would otherwise leave
+ * returns out of a prompt or out of an engagement pass. Walks the keyset cursor
+ * (the last row's createdAt + id) until a page comes back shorter than the limit
+ * the server applied (it echoes `limit`), so an earlier return acknowledged
+ * mid-walk never shifts a later one out of the read and a server cap below the
+ * requested page never ends the walk early. A full page that does not advance
+ * the cursor THROWS (no partial list read as complete). THROWS on a hard API
+ * error. `deps.callApi` is the test seam.
+ */
+export declare function listAllPendingReturns(filter: {
+    focusId?: string;
+    productId?: string;
+    unengagedOnly?: boolean;
+}, deps?: CallApiDeps): Promise<PendingReturn[]>;
+/**
+ * Request statuses in which an outgoing request is still open: the requesting
+ * work waits on it. Single definition shared with the source-delivery gate
+ * (nexus/return.ts).
+ */
+export declare const WAITING_REQUEST_STATUSES: ReadonlySet<string>;
+/** One pending return as product_request_list_pending_returns returns it (camelCase). */
+export interface PendingReturn {
+    id: string;
+    requestId: string;
+    entryId?: string | null;
+    sourceFocusId?: string | null;
+    sourceDeliveryId?: string | null;
+    /** discovery | question | findings | closed | declined */
+    returnKind: string;
+    content: string;
+    createdAt: string;
+    engagedAt?: string | null;
+    requestTitle?: string | null;
+    requestStatus?: string | null;
+    targetProductId?: string | null;
+}
+/** The outgoing-request fields the waiting-on read needs. */
+export interface WaitingRequest {
+    id: string;
+    status?: string;
+    title?: string | null;
+    sourceFocusId?: string | null;
+    sourceDeliveryId?: string | null;
+    targetProductId?: string | null;
+}
+/**
+ * Pure: the open outgoing requests a focus waits on -- filed from the focus
+ * itself (with or without a source delivery) or from one of its deliveries.
+ */
+export declare function selectWaitingOnRequests(outgoing: readonly WaitingRequest[], focusId: string, deliveryIds: ReadonlySet<string>): WaitingRequest[];
+/** Pure: one return rendered in full (its content is never truncated). */
+export declare function renderPendingReturnBlock(ret: PendingReturn): string[];
+/**
+ * Pure: the Nexus section for a focus's prompt. Empty (no lines) when the focus
+ * waits on nothing and has no pending return.
+ */
+export declare function buildNexusReturnsSection(args: {
+    waitingOn: readonly WaitingRequest[];
+    pendingReturns: readonly PendingReturn[];
+}): string;
+/** Pure: the message handed to a live team when new returns arrive mid-session. */
+export declare function buildNexusReturnHandOff(returns: readonly PendingReturn[]): string;
+/** Injectable reads (tests pass fakes; production uses callApi). */
+export interface NexusReturnsSectionDeps {
+    listFocusPendingReturns: (focusId: string) => Promise<PendingReturn[]>;
+    listOutgoing: (productId: string) => Promise<WaitingRequest[]>;
+}
+/** The production reads over a product-api client (`apiDeps.callApi` is the test seam). */
+export declare function nexusReturnsSectionDeps(apiDeps?: CallApiDeps): NexusReturnsSectionDeps;
+export declare const defaultNexusReturnsSectionDeps: NexusReturnsSectionDeps;
+/**
+ * Load + render the focus's Nexus section. Best-effort: each read degrades to
+ * empty on failure (logged) and never blocks a spawn.
+ */
+export declare function resolveNexusReturnsSection(args: {
+    focusId: string;
+    productId: string | undefined;
+    deliveryIds: readonly string[];
+}, deps?: NexusReturnsSectionDeps): Promise<string>;
+/**
+ * Fold the focus's Nexus section into the section every spawn shape carries
+ * (the answered-escalations carrier: appended to fresh directive + legacy
+ * prompts, the scoping message and the resume delta, for coding AND review
+ * passes). Ids are untouched: they name escalations to consume, not returns --
+ * a return is consumed only by the team's acknowledgement.
+ */
+export declare function foldNexusReturnsSection(carried: {
+    section: string;
+    ids: string[];
+}, args: {
+    focusId: string;
+    productId: string | undefined;
+    deliveryIds: readonly string[];
+}, deps?: NexusReturnsSectionDeps): Promise<{
+    section: string;
+    ids: string[];
+}>;
+//# sourceMappingURL=pending-returns.d.ts.map

package/dist/nexus/pending-returns.d.ts.map

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