@ai-dossier/sched 0.14.0 → 0.16.0

package/README.md

@@ -13,8 +13,8 @@ invokes an LLM** — it spawns the agent process the operator configured and rec
 the durable record (`ai-dossier runstate` / `gh` / `git`) that the spawned run leaves
 behind.
 
-Design: RFC-0001 *Batch Cycles* §B/C.1/D (the RFC lives on branch `docs/batch-cycles-rfc`,
-not yet merged to `main`; the §D state machines are frozen verbatim into the types below).
+Design: RFC-0001 *Batch Cycles* ([`rfcs/0001-batch-cycles.md`](../../rfcs/0001-batch-cycles.md))
+§B/C.1/D — the §D state machines are frozen verbatim into the types below.
 This package is the deterministic replacement for fleet-cycle's LLM-prose supervision,
 whose named failure — slots sitting idle after a subagent finished — is a scheduling bug
 this state machine makes impossible to forget.
@@ -158,6 +158,20 @@ as the shorthand and are the fallback for any field a `tiers` entry leaves unset
 1.3.0 config with no `tiers` at all resolves identically to before — there is no on-disk
 migration, only resolution-time fallback in `resolveDispatch`.
 
+Config schema moves to 1.6.0 (#562): `dispatch` gains `suite_command` — an explicit argv
+override for the aggregate batch-suite command, the middle tier of the new resolution
+order (`cap run test.full` manifest → `dispatch.suite_command` → a repo-detected safe
+default that never forwards extra flags through an unrecognized wrapper script). Also new:
+the `blocked` `BatchStatus` and `batch-blocked` journal event — an unreadable suite report
+blocks the batch (worktree and every member commit preserved) instead of dissolving it,
+distinct from `dissolving`'s "a red suite named no offender." `blocked` is a new
+persisted-field *value*, not a new field, so no `state.json` schema-version bump or
+backfill is needed on load — but it is NOT downgrade-safe: an older build's
+`BATCH_STATUSES` (derived from its own `BATCH_TRANSITIONS`) will reject a `state.json`
+containing a `blocked` batch with "unknown batch status", bricking that project's whole
+`SchedStore.load()`. Resume or abandon any blocked batch before downgrading past this
+version.
+
 Two engine-safety policies were explicit product decisions on #464:
 
 - **Pid identity is hybrid-verified (decision 1, option C).** Every spawn records the
@@ -235,6 +249,8 @@ against real scratch repos.
 validating → attributing → fixing (ONE bounded attempt) → validating
                          → evicting (revert the member's commits) → validating
   > ⅓ of members evicted, or a revert conflict → dissolving → members requeued
+  suite report unreadable, after the fallback retry when one applied
+                         → blocked → validating (nothing requeued/reverted; #562)
 awaiting-merge (CONFLICTING | auto-merge-blocked)
                          → rebasing → re-validating → shipping
                          → (2nd occurrence) dissolving into two half-batches
@@ -283,11 +299,12 @@ awaiting-merge (CONFLICTING | auto-merge-blocked)
    with no `anchor` or no `run_id` cannot post — the CLI requires both — so the milestone
    it could not post is journaled in full instead of vanishing.
 
-Ten journal events carry the detail: `suite-failed`, `attributed`, `fix-dispatched`,
+Eleven journal events carry the detail: `suite-failed`, `attributed`, `fix-dispatched`,
 `fix-resolved`, `member-evicted`, `revert-conflict`, `batch-rebased`, `batch-dissolved`,
-`batch-split` and `milestone-post-failed`, plus `git-failed` for any git command that
-returned non-zero (the injected `ExecFn` collapses every git failure into `null`, so the
-command that produced one is always recorded).
+`batch-blocked` (#562 — the suite report was unreadable), `batch-split` and
+`milestone-post-failed`, plus `git-failed` for any git command that returned non-zero (the
+injected `ExecFn` collapses every git failure into `null`, so the command that produced one
+is always recorded).
 
 Schema 1.3.0 carries the new state: `BatchEntry` gains `anchor`, `branch`, `run_id`,
 `eviction_groups`, `evictions`, `fix_attempts` and `rebase_attempts`; `QueueEntry` gains
@@ -344,11 +361,18 @@ ready → executing(member i/N) ⟲ → validating → reviewing → shipping
   → awaiting-merge → merged → deployed → reported → done
 failure rails: executing → dissolving (a member self-reports blocked)
                validating → attributing → (fixing | evicting) → validating → dissolving
+               validating → blocked (suite report unreadable, #562) → validating
 ```
 
 - **One shared worktree/branch per batch**, claimed once by a deterministic (no LLM)
-  `batch-setup` step: `git branch`/`push`/`worktree add` off `base_branch`, named
-  `batch/<id>-<date>`, plus a fresh `ai-dossier runstate mint` against the anchor issue.
+  `batch-setup` step, named `batch/<id>-<date>`, plus a fresh `ai-dossier runstate mint`
+  against the anchor issue. Tries a pool claim first (`npx worktree-pool claim` —
+  already warm by construction, `BatchEntry.pool_claimed`); on the cold `git branch`/
+  `push`/`worktree add` path, batch-setup warms the worktree itself before returning
+  (#561) — `cap run worktree.prepare` when the repo's manifest declares it, else
+  package-manager-detected install/build (`@ai-dossier/worktree-pool`'s command
+  resolution — respects the repo's `.worktree-pool.json` `project_subdir`/
+  `warm_commands` even in repos that never use the pool for anything else).
 - **Members run serially, one fresh `slot-cycle` agent at a time**, in the shared
   worktree. A member's completion signal is `phase=review status=done mode=slot` on its
   OWN issue (`slot-cycle` posts no phase of its own past `review` — ship is batch-owned);
@@ -373,23 +397,26 @@ failure rails: executing → dissolving (a member self-reports blocked)
   `report-issue`'s batch variant.
 - **Scope cuts, recorded rather than discovered later:** no `git bisect` stage for an
   ambiguous aggregate failure (an unattributable red suite dissolves instead); no
-  worktree-pool integration for batch-setup (cold `git worktree add` only); no per-phase
-  stall/escalation ladder for batch sub-agents (a dead-without-verification agent is
-  treated as blocked, not redispatched stronger).
+  per-phase stall/escalation ladder for batch sub-agents (a dead-without-verification
+  agent is treated as blocked, not redispatched stronger).
 
 Schema 1.7.0: `BatchEntry` gains `worktree` (absolute path of the shared batch worktree,
 null until batch-setup lands), `ranges` (`MemberRange[]` — each member's commit range,
 recomputed after every member completes) and `pr` (the batch PR parked on auto-merge,
 persisted so a restart mid-watch still knows what to poll). 1.6.0 states migrate on load:
 no batch was ever dispatched under them, so `null`/`[]`/`null` is the exact backfill, not
-a guess. Config schema moves to 1.3.0: `dispatch` gains `member_prompt`,
-`batch_tail_prompt` and `batch_report_prompt` (the three new agent prompt templates).
-
-New journal events: `batch-setup-done`, `batch-setup-failed`, `member-advanced`. Member/
-tail/report/fix-agent spawn, progress, completion and park events reuse the existing
-unit-generic names (`assigned`/`spawned`/`unit-failed`/`external-advance`/`pr-parked`/
-`merge-accepted`/`report-dispatched`/`teardown-done`/`teardown-failed`) with
-`unit = batch:<id>`.
+a guess. `BatchEntry` also gains `pool_claimed` (#561) — pre-#561 states carry no such
+key at all, and backfill it to `false` on load (no batch was ever pool-claimed before
+batch-setup had pool integration). Config schema moves to 1.3.0: `dispatch` gains
+`member_prompt`, `batch_tail_prompt` and `batch_report_prompt` (the three new agent
+prompt templates).
+
+New journal events: `batch-setup-done`, `batch-setup-failed`, `member-advanced`,
+`batch-warmup-done`, `batch-warmup-failed` (#561 — the cold-path warm step only; a pool
+claim emits neither). Member/tail/report/fix-agent spawn, progress, completion and park
+events reuse the existing unit-generic names (`assigned`/`spawned`/`unit-failed`/
+`external-advance`/`pr-parked`/`merge-accepted`/`report-dispatched`/`teardown-done`/
+`teardown-failed`) with `unit = batch:<id>`.
 
 ## API surface
 
@@ -447,6 +474,8 @@ import {
   TEARDOWN_TIMEOUT_MS,   // teardown subprocess timeout (120 s)
   attributeByOverlap,    // #472 pure stage-1 attribution: failing tests → members
   parseVitestJson,       // vitest --reporter=json → failing tests
+  isReadableVitestReport, // #562: a parseable { testResults: [...] } document exists —
+                          //   distinct from "zero failures"
   parseBoundaryCommits,  // git log → issue-boundary commits via the (#N) trailer
   memberRanges,          // boundary commits → each member's commit list
   runAttributionBisect,  // stage-2: real git bisect over the failing tests only
@@ -456,6 +485,8 @@ import {
   evictMembers,          // revert + requeue with evidence + suite re-run + dissolve check
   checkDissolveTrigger,  // pure: > ⅓ of members evicted
   dissolveBatch,         // full or halved dissolve; preserves everything green
+  blockBatch,            // #562: unreadable suite report → blocked; no requeue, no revert
+  type BlockOptions,     // { reason, milestonePhase? } for blockBatch
   handlePrConflict,      // rebase + re-ship once, then dissolve into halves
   createExecMilestonePoster, // batch milestones via `ai-dossier runstate post`
   expandEvictionGroups,  // members that must revert together (§E.4 eviction groups)
@@ -519,8 +550,8 @@ telemetry" below.
 ├── state.json     # hot operational truth — atomic tmp+fsync+rename writes;
 ├── config.json    # durable intent: max_slots, stall_timeout_ms, reconcile_interval_ms,
 │                  # pr_poll_interval_ms, dispatch (incl. report_prompt,
-│                  # phase_stall_timeout_ms, fence_takeover_timeout_ms, tiers — #527),
-│                  # auto_upgrade — #537
+│                  # phase_stall_timeout_ms, fence_takeover_timeout_ms, tiers — #527,
+│                  # suite_command — #562), auto_upgrade — #537
 ├── events.jsonl   # append-only event journal (the operator's flight recorder)
 ├── runs/          # per-unit agent output logs (issue-<n>.log)
 └── .sched-lock/   # cross-process directory mutex (pid; stolen from dead holders)

package/dist/attribution.d.ts

@@ -65,6 +65,16 @@ export declare function offendersOf(attributed: ReadonlyMap<number, unknown>): n
  * "no attributable tests", which routes to bisect, never to a guess.
  */
 export declare function parseVitestJson(stdout: string | null): FailingTest[];
+/**
+ * Whether `stdout` contains a parseable vitest JSON report (a `{ testResults:
+ * [...] }` document) — independent of whether any test in it failed (#562).
+ * `parseVitestJson` returns `[]` both for "found a report, zero failures" and
+ * "found no report at all" (an empty string, a wrapper script's plain-text
+ * abort message, a make error): those two are NOT the same thing to a caller
+ * deciding whether to trust a red exit code's failing-test list, or a green
+ * exit code that happens to carry no parseable body.
+ */
+export declare function isReadableVitestReport(stdout: string | null): boolean;
 /** One commit on the batch branch, with the member it belongs to. */
 export interface BoundaryCommit {
     sha: string;

package/dist/attribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACvC,0DAA0D;IAC1D,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAEnE;AAqCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,kBAAkB,CAwBpB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAE9E;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE,CA0BpE;AAiCD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AASD;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAsB,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,EAAE,CAalF;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,EAAE,CAgB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9F"}
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACvC,0DAA0D;IAC1D,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAEnE;AAqCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,kBAAkB,CAwBpB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAE9E;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE,CA0BpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMrE;AAiCD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AASD;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAsB,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,EAAE,CAalF;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,EAAE,CAgB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9F"}

package/dist/attribution.js

@@ -22,6 +22,7 @@ exports.failingTest = failingTest;
 exports.attributeByOverlap = attributeByOverlap;
 exports.offendersOf = offendersOf;
 exports.parseVitestJson = parseVitestJson;
+exports.isReadableVitestReport = isReadableVitestReport;
 exports.parseBoundaryCommits = parseBoundaryCommits;
 exports.memberRanges = memberRanges;
 exports.memberOfCommit = memberOfCommit;
@@ -138,6 +139,24 @@ function parseVitestJson(stdout) {
     }
     return out;
 }
+/**
+ * Whether `stdout` contains a parseable vitest JSON report (a `{ testResults:
+ * [...] }` document) — independent of whether any test in it failed (#562).
+ * `parseVitestJson` returns `[]` both for "found a report, zero failures" and
+ * "found no report at all" (an empty string, a wrapper script's plain-text
+ * abort message, a make error): those two are NOT the same thing to a caller
+ * deciding whether to trust a red exit code's failing-test list, or a green
+ * exit code that happens to carry no parseable body.
+ */
+function isReadableVitestReport(stdout) {
+    if (stdout === null)
+        return false;
+    const parsed = extractJsonObject(stdout);
+    if (parsed === null)
+        return false;
+    const results = parsed.testResults;
+    return Array.isArray(results);
+}
 /** The first balanced `{...}` document in `text`, parsed; null when there is none. */
 function extractJsonObject(text) {
     const start = text.indexOf('{');

package/dist/attribution.js.map

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

package/dist/batch-dispatch.d.ts

@@ -47,12 +47,18 @@
  * an ambiguous aggregate failure (bisect needs a per-project "run only these
  * tests" command this module has no generic way to construct) — an
  * unattributable red aggregate suite dissolves the batch rather than
- * bisecting, which `attributing → dissolving` already models. No worktree-pool
- * integration for batch-setup — cold `git worktree add` only, mirroring
- * `teardown.ts`'s cold path. No per-phase stall/escalation ladder for batch
- * sub-agents — a dead-without-verification agent is treated as blocked and
- * evicted/reported rather than redispatched stronger. Both are documented
- * follow-ups, not gaps discovered later.
+ * bisecting, which `attributing → dissolving` already models. No per-phase
+ * stall/escalation ladder for batch sub-agents — a dead-without-verification
+ * agent is treated as blocked and evicted/reported rather than redispatched
+ * stronger. Both are documented follow-ups, not gaps discovered later.
+ *
+ * `runBatchSetup` (#561) tries a pool claim first (already warm, mirroring
+ * `teardown.ts`'s `poolReturn` — same `npx`-through-`deps.exec` pattern, never
+ * a direct in-process `claim()` import, which resolves its git root from
+ * `process.cwd()` and would break this module's `deps.repoDir` testability
+ * contract); on the cold `git worktree add` path it warms the worktree itself
+ * before returning, so a member's first command is never the one that
+ * discovers `node_modules` is missing (`env-cold`, `docs/agent-traps.md`).
  */
 import { type ResolvedDispatch, type SpawnDeps } from './dispatch';
 import { type GroundTruth } from './groundtruth';
@@ -81,17 +87,30 @@ export interface BatchDispatchDeps {
     repoDir: string;
     /** Exec for batch git/milestone-CLI operations (never throws — the `ExecFn` contract). */
     exec: ExecFn;
+    /**
+     * Exec for the cold-path warm-up install/build (#561), on its own budget —
+     * a real `npm ci` + build routinely exceeds the git-op timeout `exec` is
+     * tuned for. Falls back to `exec` when not supplied (existing callers/tests
+     * are unaffected; production wiring should still give this its own longer
+     * timeout, e.g. `@ai-dossier/worktree-pool`'s `WARM_COMMAND_TIMEOUT_MS`).
+     */
+    warmExec?: ExecFn;
     /** Runs the aggregate suite inside a batch worktree; batches never leave `validating` without one. */
     runSuite: (worktree: string) => SuiteResult;
     /**
-     * Runs one `ai-dossier cap run <capabilityId>` in a batch worktree for the
-     * per-member incremental gate (#523 AC2 — "typecheck + focused tests via
-     * `cap run test.focused` when available"). Optional and degrade-not-crash,
-     * like `batchExec`/`runBatchSuite`: without it, or on `automation-broken`/
-     * `capability-unavailable`, the gate is skipped — the member's own
-     * `slot-cycle` run already attempted this fast path (with its own reasoning
-     * fallback) before ever posting `review done`, so a repo with no manifest
-     * loses nothing but the engine's independent re-check.
+     * Runs one `ai-dossier cap run <capabilityId>` in a batch worktree. Two call
+     * sites, different degrade contracts:
+     * - the per-member incremental gate (#523 AC2 — "typecheck + focused tests
+     *   via `cap run test.focused` when available"): degrade-not-crash — without
+     *   this hook, or on `automation-broken`/`capability-unavailable`, the gate
+     *   is skipped (the member's own `slot-cycle` run already attempted this
+     *   fast path before ever posting `review done`, so a repo with no manifest
+     *   loses nothing but the engine's independent re-check).
+     * - batch-setup's `worktree.prepare` warm step (#561, `warmColdBatchWorktree`):
+     *   `undefined`/`capability-unavailable`/`automation-broken` fall through to
+     *   package-manager detection, but a declared-and-`task-failed` capability
+     *   hard-fails the whole batch setup — a repo that owns its warm-up should
+     *   never be silently second-guessed by a fallback underneath it.
      */
     runCapability?: (worktree: string, capabilityId: string) => CapOutcome;
     fsExists?: FsExists;

package/dist/batch-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch-dispatch.d.ts","sourceRoot":"","sources":["../src/batch-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAWH,OAAO,EAKL,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,WAAW,EAOjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,KAAK,QAAQ,EAA+B,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAKV,WAAW,EAIZ,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,aAAa,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;IAC5C;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,UAAU,CAAC;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA6vCD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAsEjB"}
+{"version":3,"file":"batch-dispatch.d.ts","sourceRoot":"","sources":["../src/batch-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAiBH,OAAO,EAKL,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,WAAW,EAOjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,OAAO,EAAa,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAUL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,KAAK,QAAQ,EAA2D,MAAM,YAAY,CAAC;AACpG,OAAO,KAAK,EAKV,WAAW,EAIZ,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,aAAa,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;IAC5C;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,UAAU,CAAC;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA67CD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAsEjB"}

package/dist/batch-dispatch.js

@@ -48,12 +48,18 @@
  * an ambiguous aggregate failure (bisect needs a per-project "run only these
  * tests" command this module has no generic way to construct) — an
  * unattributable red aggregate suite dissolves the batch rather than
- * bisecting, which `attributing → dissolving` already models. No worktree-pool
- * integration for batch-setup — cold `git worktree add` only, mirroring
- * `teardown.ts`'s cold path. No per-phase stall/escalation ladder for batch
- * sub-agents — a dead-without-verification agent is treated as blocked and
- * evicted/reported rather than redispatched stronger. Both are documented
- * follow-ups, not gaps discovered later.
+ * bisecting, which `attributing → dissolving` already models. No per-phase
+ * stall/escalation ladder for batch sub-agents — a dead-without-verification
+ * agent is treated as blocked and evicted/reported rather than redispatched
+ * stronger. Both are documented follow-ups, not gaps discovered later.
+ *
+ * `runBatchSetup` (#561) tries a pool claim first (already warm, mirroring
+ * `teardown.ts`'s `poolReturn` — same `npx`-through-`deps.exec` pattern, never
+ * a direct in-process `claim()` import, which resolves its git root from
+ * `process.cwd()` and would break this module's `deps.repoDir` testability
+ * contract); on the cold `git worktree add` path it warms the worktree itself
+ * before returning, so a member's first command is never the one that
+ * discovers `node_modules` is missing (`env-cold`, `docs/agent-traps.md`).
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -90,7 +96,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runBatchTick = runBatchTick;
+const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const worktree_pool_1 = require("@ai-dossier/worktree-pool");
 const attribution_1 = require("./attribution");
 const dispatch_1 = require("./dispatch");
 const groundtruth_1 = require("./groundtruth");
@@ -177,7 +185,9 @@ function safeSuite(deps, batchId, worktree) {
     catch (err) {
         const detail = `suite runner threw: ${err.message}`;
         journalEvent(deps, 'suite-failed', unit(batchId), { detail });
-        return { ok: false, failing: [], detail };
+        // A throw is exactly "no trustworthy report" (#562) — must not default to
+        // `readable: true` and look like a parseable report naming zero failures.
+        return { ok: false, failing: [], readable: false, detail };
     }
 }
 function recoveryDeps(deps, batch, now) {
@@ -228,11 +238,93 @@ function releaseSlot(state, batchId, now) {
 }
 // --- Batch setup (ready → executing, member 1) ---
 /**
- * `batch/<id>-<YYYYMMDD>` off `base_branch`, a worktree at
- * `<repoDir>/worktrees/batch-<id>-<YYYYMMDD>` (cold git only — no pool
- * integration in this version, see the module doc), and a fresh runstate run
- * id minted against the anchor. All-or-nothing: any failed step reports the
- * step name and nothing is partially recorded on the batch.
+ * A pool claim already returns a warm worktree (deps installed, built), so
+ * only the cold `git worktree add` path needs its own warm step (#561).
+ *
+ * Tries `worktree.prepare` via the optional `runCapability` hook first (a
+ * repo that declares it in its manifest knows its own warm-up best) — a
+ * declared-and-`task-failed` capability hard-fails the whole batch setup
+ * (deliberately NOT degrade-not-crash, unlike every other `runCapability`
+ * call site in this file: a repo that owns `worktree.prepare` should never
+ * be silently second-guessed by falling back underneath it). `undefined`,
+ * `capability-unavailable` (no such id declared) AND `automation-broken`
+ * (broken manifest, missing tool, timeout — "do not trust the machinery",
+ * not "the task failed") all fall through to the generic path below.
+ *
+ * The generic path reuses `@ai-dossier/worktree-pool`'s package-manager
+ * detection, guarded on `package.json` actually being present — `npm
+ * install` (and the pnpm/yarn/bun equivalents) hard-fail with no
+ * `package.json` at all, so an unguarded call would turn "nothing to warm"
+ * into a false failure for every non-Node repo. The guard is bypassed when
+ * `.worktree-pool.json` declares explicit `warm_commands` — the escape hatch
+ * for a repo whose warm-up isn't `npm install`-shaped at all.
+ *
+ * Warm commands run on `deps.warmExec ?? deps.exec` — a separate, longer
+ * budget than the git/milestone calls `deps.exec` is tuned for (a cold
+ * install+build routinely exceeds a git-op timeout; see `BatchDispatchDeps`).
+ *
+ * Journals `batch-warmup-done`/`batch-warmup-failed` with the elapsed time
+ * appended to `detail` either way (satisfying AC1 even on the no-op branch —
+ * `JournalEvent` has no dedicated `duration_ms` field).
+ */
+function warmColdBatchWorktree(deps, batch, worktree, now, 
+/** Prefixed onto the journaled detail — e.g. `pool-claim-invalid:` when the cold path was taken because a pool claim returned unusable output, rather than the ordinary "no warm spares" case. */
+poolNote = '') {
+    const warmStart = deps.now();
+    const elapsedMs = () => deps.now().getTime() - warmStart.getTime();
+    const fail = (tag) => {
+        deps.journal.append((0, journal_1.unitEvent)('batch-warmup-failed', unit(batch.id), {
+            detail: `${poolNote}${tag} ${elapsedMs()}ms`,
+        }), now);
+        return { ok: false, reason: `warmup-failed:${tag}` };
+    };
+    const done = (tag) => {
+        deps.journal.append((0, journal_1.unitEvent)('batch-warmup-done', unit(batch.id), {
+            detail: `${poolNote}${tag} ${elapsedMs()}ms`,
+        }), now);
+        return { ok: true };
+    };
+    const capOutcome = deps.runCapability?.(worktree, 'worktree.prepare');
+    if (capOutcome === 'ok')
+        return done('cap:worktree.prepare');
+    if (capOutcome === 'task-failed')
+        return fail('cap:worktree.prepare:task-failed');
+    // `undefined` (no hook injected) / `capability-unavailable` (not declared)
+    // / `automation-broken` (declared but the machinery itself is untrustworthy)
+    // all fall through to the generic package-manager path below.
+    const fsExists = deps.fsExists ?? ((p) => fs.existsSync(p));
+    const cfg = (0, worktree_pool_1.readPoolFileConfig)(deps.repoDir);
+    const projectDir = (0, worktree_pool_1.resolveProjectDir)(worktree, cfg.project_subdir);
+    // `.worktree-pool.json`'s `project_subdir` is repo config, not attacker
+    // input, but a `../`-shaped value would otherwise run install/build
+    // OUTSIDE the batch worktree entirely — skip rather than warm the wrong
+    // directory (or fail the whole batch over a misconfigured pool file).
+    if (projectDir !== worktree && !projectDir.startsWith(worktree + path.sep)) {
+        return done('skipped:project-dir-outside-worktree');
+    }
+    const hasExplicitWarmCommands = (cfg.warm_commands?.length ?? 0) > 0;
+    if (!hasExplicitWarmCommands && !fsExists(path.join(projectDir, 'package.json'))) {
+        return done('skipped:no-package-json');
+    }
+    const commands = (0, worktree_pool_1.resolveWarmCommands)(projectDir, cfg);
+    for (const [i, cmd] of commands.entries()) {
+        const [bin, ...args] = cmd;
+        if (bin === undefined)
+            return fail(`pm:${i + 1}/${commands.length}:empty-command`);
+        if ((deps.warmExec ?? deps.exec)(bin, args, projectDir) === null) {
+            return fail(`pm:${i + 1}/${commands.length}:${bin}`);
+        }
+    }
+    const pm = commands[0]?.[0] ?? 'none';
+    return done(`pm:${pm}:${commands.length}cmds`);
+}
+/**
+ * `batch/<id>-<YYYYMMDD>` off `base_branch`, and a fresh runstate run id
+ * minted against the anchor. The worktree is either a pool claim (already
+ * warm) or a cold `git worktree add` that this function then warms itself
+ * (#561, see the module doc) — either way, the worktree is warm before this
+ * returns `ok: true`. All-or-nothing: any failed step reports the step name
+ * and nothing is partially recorded on the batch.
  */
 function runBatchSetup(deps, batch, now) {
     if (batch.anchor === null)
@@ -255,6 +347,36 @@ function runBatchSetup(deps, batch, now) {
     if (runId === null || runId.trim() === '')
         return { ok: false, reason: 'runstate-mint-failed' };
     const mintedRunId = runId.trim();
+    // Pool claim first — a claimed worktree is already warm by construction, so
+    // no separate warm step runs for it (AC2). `claim()` itself never pushes
+    // the branch (mirrors setup-issue-workflow's per-issue pool-claim step),
+    // so that still happens here on success.
+    const claimed = deps.exec(teardown_1.POOL_BIN, [...teardown_1.POOL_ARGS_PREFIX, 'claim', '--issue', String(batch.anchor), '--branch', branch], deps.repoDir);
+    const claimedWorktree = claimed?.trim();
+    // Same hardening `teardown.ts`'s destructive sinks apply to a worktree path
+    // (no NUL/newline, no unresolved `..`) — this one is our own CLI's stdout,
+    // not attacker input, but garbage here would otherwise be trusted verbatim
+    // as `BatchEntry.worktree` and used as a spawn/exec cwd for every member.
+    const claimIsUsable = !!claimedWorktree &&
+        !claimedWorktree.includes('\0') &&
+        !claimedWorktree.includes('\n') &&
+        path.isAbsolute(claimedWorktree) &&
+        path.resolve(claimedWorktree) === claimedWorktree &&
+        (deps.fsExists ?? ((p) => fs.existsSync(p)))(claimedWorktree);
+    if (claimedWorktree && claimIsUsable) {
+        if (deps.exec('git', ['push', '-u', 'origin', '--', branch], claimedWorktree) === null) {
+            // Return the claim rather than leaking a permanently `assigned` pool
+            // entry nothing else will ever reference — `BatchEntry` only records
+            // `worktree`/`pool_claimed` on the `ok: true` path below.
+            deps.exec(teardown_1.POOL_BIN, [...teardown_1.POOL_ARGS_PREFIX, 'return', '--path', claimedWorktree, '--json'], deps.repoDir);
+            return { ok: false, reason: 'branch-push-failed', runId: mintedRunId };
+        }
+        return { ok: true, branch, worktree: claimedWorktree, runId: mintedRunId, poolClaimed: true };
+    }
+    // A non-null, non-empty, unusable claim response (rather than a plain "no
+    // warm spares" null/empty) is unusual enough to note on the batch that
+    // otherwise cold-builds silently.
+    const poolNote = claimedWorktree ? 'pool-claim-invalid:' : '';
     if (deps.exec('git', ['fetch', 'origin', '--', batch.base_branch], deps.repoDir) === null) {
         return { ok: false, reason: 'fetch-failed', runId: mintedRunId };
     }
@@ -267,7 +389,20 @@ function runBatchSetup(deps, batch, now) {
     if (deps.exec('git', ['worktree', 'add', '--', worktree, branch], deps.repoDir) === null) {
         return { ok: false, reason: 'worktree-add-failed', runId: mintedRunId };
     }
-    return { ok: true, branch, worktree, runId: mintedRunId };
+    const warmed = warmColdBatchWorktree(deps, batch, worktree, now, poolNote);
+    if (!warmed.ok) {
+        // Restore the "all-or-nothing" contract this function documents: a warm
+        // failure otherwise leaves the branch pushed and the worktree on disk,
+        // so the NEXT tick's retry dies at `branch-create-failed` forever
+        // instead of ever reaching warm-up again. Best-effort — a failed cleanup
+        // here just means the next retry's `worktree-add-failed`/`branch-create-failed`
+        // surfaces the leftover instead, no worse than before this cleanup existed.
+        deps.exec('git', ['worktree', 'remove', '--force', '--', worktree], deps.repoDir);
+        deps.exec('git', ['branch', '-D', branch], deps.repoDir);
+        deps.exec('git', ['push', 'origin', '--delete', branch], deps.repoDir);
+        return { ok: false, reason: warmed.reason, runId: mintedRunId };
+    }
+    return { ok: true, branch, worktree, runId: mintedRunId, poolClaimed: false };
 }
 /** Spawn one batch member's `slot-cycle` agent into the slot batch-setup (or a prior member) just released. */
 /**
@@ -420,7 +555,12 @@ function claimAndSetup(deps, config, dispatch, batchId, now, result) {
     poster(batch.anchor, setup.runId, {
         phase: 'batch-setup',
         status: 'done',
-        kv: { branch: setup.branch, worktree: setup.worktree, base_branch: batch.base_branch },
+        kv: {
+            branch: setup.branch,
+            worktree: setup.worktree,
+            base_branch: batch.base_branch,
+            pool_claimed: setup.poolClaimed ? 'true' : 'false',
+        },
     });
     deps.journal.append((0, journal_1.unitEvent)('batch-setup-done', unit(batchId), { detail: setup.worktree }), now);
     deps.store.withLock((s) => {
@@ -438,7 +578,12 @@ function claimAndSetup(deps, config, dispatch, batchId, now, result) {
             });
             return { state: releaseSlot(s, batchId, now), result: undefined };
         }
-        let next = (0, state_1.patchBatch)(s, batchId, { branch: setup.branch, worktree: setup.worktree, run_id: setup.runId }, now);
+        let next = (0, state_1.patchBatch)(s, batchId, {
+            branch: setup.branch,
+            worktree: setup.worktree,
+            run_id: setup.runId,
+            pool_claimed: setup.poolClaimed,
+        }, now);
         next = (0, state_1.transitionBatch)(next, batchId, 'executing', { executing_member: 1 }, now);
         const slot = slotFor(next, batchId);
         if (slot)
@@ -590,8 +735,11 @@ function boundaryCommits(deps, batch) {
 /**
  * `validating`, no live slot: run the aggregate suite (deterministic — no
  * agent, no slot claimed, matching AC5's "member or batch-LLM-step" wording).
- * Green proceeds to the tail; red attributes and either fixes one offender or
- * dissolves when nothing could be attributed (RFC F.2/F.8).
+ * Green proceeds to the tail; an unreadable report (never got a parseable
+ * report at all, distinct from a parseable one naming zero failures) blocks
+ * the batch instead of attributing (#562); a genuinely red, parseable report
+ * attributes and either fixes one offender or dissolves when nothing could be
+ * attributed (RFC F.2/F.8).
  */
 function runValidate(deps, config, dispatch, batchId, now, result) {
     const state = deps.store.load();
@@ -605,7 +753,7 @@ function runValidate(deps, config, dispatch, batchId, now, result) {
         if (batch.anchor !== null && batch.run_id !== null) {
             poster(batch.anchor, batch.run_id, { phase: 'batch-validate', status: 'done', kv: {} });
         }
-        deps.journal.append((0, journal_1.unitEvent)('verify-complete', unit(batchId), { detail: 'suite green' }), now);
+        deps.journal.append((0, journal_1.unitEvent)('verify-complete', unit(batchId), { detail: suite.detail ?? 'suite green' }), now);
         deps.store.withLock((s) => {
             const b = (0, state_1.findBatch)(s, batchId);
             if (!b || b.status !== 'validating')
@@ -615,6 +763,28 @@ function runValidate(deps, config, dispatch, batchId, now, result) {
         spawnTailAgent(deps, config, dispatch, batchId, now, result);
         return;
     }
+    // #562: the suite report itself was unreadable (empty, unparseable, a
+    // spawn/timeout error) even after the runner's own fallback retry — NOT the
+    // same as a parseable report naming zero failures. Attribution would read
+    // `suite.failing` as "nothing to attribute" and dissolve a batch that may
+    // be fully green; block instead, preserving every member commit and the
+    // worktree, for an operator to inspect. `blocked` has no CLI resume verb
+    // yet — `sched abandon --batch` is today's only real exit.
+    if (suite.readable === false) {
+        deps.journal.append((0, journal_1.unitEvent)('suite-failed', unit(batchId), {
+            detail: suite.detail ?? 'suite report unreadable',
+        }), now);
+        const blocked = (0, recovery_1.blockBatch)(state, batchId, { reason: 'suite-unreadable' }, rDeps);
+        deps.store.withLock((s) => ({
+            state: applyBatchAndIssues(s, blocked.state, batchId, []),
+            result: undefined,
+        }));
+        // `result.blocked` is "issue numbers requeued full-cycle by a dissolve"
+        // (see `BatchTickResult`'s field doc) — a blocked batch requeues nothing,
+        // so it is reported only under `failed`, not under `blocked`.
+        result.failed.push(unit(batchId));
+        return;
+    }
     const { state: attributed, outcome } = (0, recovery_1.beginAttribution)(state, batchId, { failing: suite.failing, footprints: memberFootprints(deps, batch) }, rDeps);
     if (outcome.offenders.length === 0) {
         const dissolve = (0, recovery_1.dissolveBatch)(attributed, batchId, { strategy: 'full', reason: 'unattributable-suite-failure' }, rDeps);
@@ -1037,14 +1207,18 @@ function teardownBatch(deps, batchId) {
     if (!batch || batch.worktree === null)
         return;
     const root = deps.exec('git', ['rev-parse', '--show-toplevel'], deps.repoDir) ?? deps.repoDir;
-    if (!(0, teardown_1.isSafeWorktree)(path.resolve(root), batch.worktree)) {
+    // Pool-claimed worktrees are validated by the pool's own `return` (it only
+    // accepts paths in pool state) and can legitimately live outside either
+    // `isSafeWorktree` root when `.worktree-pool.json` configures a custom
+    // `pool_dir` — mirrors `runTeardown`'s own internal skip for `poolClaimed`.
+    if (batch.pool_claimed !== true && !(0, teardown_1.isSafeWorktree)(path.resolve(root), batch.worktree)) {
         journalEvent(deps, 'teardown-failed', unit(batchId), {
             reason: 'unsafe-worktree-path',
             detail: batch.worktree,
         });
         return;
     }
-    const result = (0, teardown_1.runTeardown)(deps.exec, deps.repoDir, { worktree: batch.worktree, poolClaimed: false, branch: batch.branch }, deps.fsExists);
+    const result = (0, teardown_1.runTeardown)(deps.exec, deps.repoDir, { worktree: batch.worktree, poolClaimed: batch.pool_claimed === true, branch: batch.branch }, deps.fsExists);
     journalEvent(deps, result.cleanup === 'done' ? 'teardown-done' : 'teardown-failed', unit(batchId), {
         cleanup: result.cleanup,
         detail: result.detail,