Skip to content

Commit 8fd2201

Browse files
committed
docs(runtime): document blocked task todo migration
Clarify that the one-time legacy bootstrap keeps blocked Task subjects visible as pending Todo items while dropping workflow-only metadata. Refs #4338 Generated-by: OpenAI Codex
1 parent e9cdd20 commit 8fd2201

1 file changed

Lines changed: 6 additions & 4 deletions

File tree

docs/session-todo-lifecycle.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -95,10 +95,12 @@ is what makes one-time migration and explicit clearing deterministic.
9595
## One-time legacy bootstrap
9696

9797
The first Host read of an uninitialized Session, through either `todo_read` or
98-
`session.todo.query`, projects only canonical legacy Tasks whose status is
99-
`pending` or `in_progress`, then persists the result even when it is empty.
100-
Terminal, blocked, failed, cancelled, ownership, evidence, and hierarchy fields
101-
are not imported.
98+
`session.todo.query`, keeps canonical `pending` and `in_progress` Tasks at their
99+
current status. A canonical `blocked` Task is imported as `pending` with the
100+
same subject so unfinished work remains visible for replanning. The Host then
101+
persists the result even when it is empty. Workflow-only blocked reasons,
102+
ownership, evidence, hierarchy, and terminal `completed`, `failed`, or
103+
`cancelled` Tasks are not imported.
102104

103105
The first explicit `todo_write` never reads or merges legacy Tasks. It writes
104106
the requested complete list directly. Once a SessionTodo row exists, no later

0 commit comments

Comments
 (0)