releases/ClaudeDo
2
0
Fork 0
Code Issues 1 Pull Requests 2 Actions Packages Projects Releases 24 Wiki Activity

docs(explore-notes): document stale-Running chain/parent advance fix

Browse Source 
Bump worker-task-pipeline verified-against commit to 58741c2.
This commit is contained in:
mika kuns
2026-08-06 13:17:07 +02:00
parent 58741c2bd6
commit 1649291ef0
1 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/explore-notes/worker-task-pipeline.md
+7 -3
View File
@@ -1,6 +1,6 @@
> **Explore-note — verify before trusting.** Distilled map of a subsystem, not authoritative. > **Explore-note — verify before trusting.** Distilled map of a subsystem, not authoritative.
> Last verified against commit `896d4b5` (2026-07-23). > Last verified against commit `58741c2` (2026-08-06).
> Drift check: `git log --oneline 896d4b5..HEAD -- src/ClaudeDo.Worker` > Drift check: `git log --oneline 58741c2..HEAD -- src/ClaudeDo.Worker`
> Stable structure only (no line numbers). See docs/explore-notes/README.md. > Stable structure only (no line numbers). See docs/explore-notes/README.md.
# Worker: Task Execution Pipeline # Worker: Task Execution Pipeline
@@ -108,7 +108,11 @@ read-only "## Reference files" section.
- `TaskStateService` — all task status transitions; guards preconditions; signals queue/hub. - `TaskStateService` — all task status transitions; guards preconditions; signals queue/hub.
**Lifecycle/** (startup recovery) **Lifecycle/** (startup recovery)
- `StaleTaskRecovery` — tasks stuck Running after a crash/restart → Failed. - `StaleTaskRecovery` — tasks stuck Running after a crash/restart → Failed. The underlying
`TaskStateService.RecoverStaleRunningAsync` bulk-flips Running→Failed, then re-runs the same
chain/parent-advance side effects as a normal `FailAsync` (per recovered id, best-effort) so a
crash mid-chain-child or mid-improvement-child doesn't leave a successor blocked forever or a
`WaitingForChildren` parent wedged.
- `OrphanRecovery` — dequeues children whose parent is no longer planning (stays attached). - `OrphanRecovery` — dequeues children whose parent is no longer planning (stays attached).
- `AttachmentOrphanRecovery` — cleans orphaned attachment files. - `AttachmentOrphanRecovery` — cleans orphaned attachment files.
- `TaskResetService` — manual reset to Idle. - `TaskResetService` — manual reset to Idle.