diff --git a/docs/reference/known-issues.md b/docs/reference/known-issues.md index 61165b6a8..035ae5b10 100644 --- a/docs/reference/known-issues.md +++ b/docs/reference/known-issues.md @@ -2,7 +2,7 @@ Tracks bugs that are present in the current release but have been intentionally deferred. Each entry should explain the symptom, the history, any workaround, and the planned resolution. -## v4.2.0 - Delegated child-session early-failure fallback (PR #3825 deferred) +## v4.2.0 - Delegate-task early-failure-fallback (BLOCKER-4, deferred from PR #3825) ### Symptom @@ -12,9 +12,9 @@ This affects subagents launched via the delegate-task tool (background or sync) ### History -PR #3825 (`tw-yshuang/fix/delegated-child-session-early-failure-fallback`, merged as commit `fac90d69f` on 2026-05-07) introduced a shared bootstrap context (`src/shared/delegated-child-session-bootstrap.ts`) to capture the retry payload before the first prompt dispatch, so empty-history failures could still retry with the fallback chain. +PR #3825 (`tw-yshuang/fix/delegated-child-session-early-failure-fallback`, merged as `cd33f3a39` and then `fac90d69f` on 2026-05-07) introduced a shared bootstrap context (`src/shared/delegated-child-session-bootstrap.ts`) to capture the retry payload before the first prompt dispatch, so empty-history failures could still retry with the fallback chain. -After the merge landed on `dev`, the PR's own regression test (`delegated child-session empty-history fallback retries with captured bootstrap prompt` in `src/hooks/runtime-fallback/index.test.ts`) failed on a clean root `bun test --timeout 30000` run (6828 pass / 1 fail). PR #4044 (`code-yeongyu/revert/3825-delegated-bootstrap`, merged on 2026-05-15) reverted the merge to keep `dev` green (6823 pass / 0 fail / 6 skip across 709 files). +After the merge landed on `dev`, the PR's own regression test (`delegated child-session empty-history fallback retries with captured bootstrap prompt` in `src/hooks/runtime-fallback/index.test.ts`) failed on a clean root `bun test --timeout 30000` run (6828 pass / 1 fail). PR #4044 (`code-yeongyu/revert/3825-delegated-bootstrap`, revert commit `3c7d1299a`, merge-revert commit `e2b8e49e2`, merged on 2026-05-15) reverted the merge to keep `dev` green (6823 pass / 0 fail / 6 skip across 709 files). The original failure-mode the PR targets remains in v4.2.0. @@ -24,6 +24,6 @@ The original failure-mode the PR targets remains in v4.2.0. - Configure fallback models conservatively in `categories[].fallback_models` and accept that the very first failure may not auto-retry. - The existing runtime-fallback persisted-history retry path still works after the subagent produces any history. -### Planned Resolution +### Tracking -Reland will target v4.2.1 once the regression test is stabilized against the post-#4032 schema-compatible synthetic tool result shape and the prompt-async-gate's dispatch timeout + post-dispatch hold semantics. A follow-up issue will be filed to track this work. +Issue #4059 tracks the reland with stabilized regression coverage. The reland is deferred to a follow-up release and should account for current schema-shape changes plus prompt-async-gate semantics.