Skip to content

Commit 7c5f5d4

Browse files
committed
docs(workflow): explain deterministic prefix replay
1 parent d12fc43 commit 7c5f5d4

1 file changed

Lines changed: 10 additions & 8 deletions

File tree

skills/dynamic-workflows/SKILL.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -100,14 +100,16 @@ Failed and cancelled runs are terminal. Recovery creates a **new** run:
100100
4. Run `devspace workflow run --resume <runId>` (optionally with
101101
`--script-path <path>`).
102102

103-
Replay first matches the same call index and cache key, then consumes one
104-
compatible prior cache key after reordering. The new run records whether each
105-
call was reused by same-index or compatible-key matching, and where it came
106-
from. Failed, interrupted, changed, or unmatched calls execute live.
107-
108-
Replay restores an agent's **return value**. It does not recreate shared-checkout
109-
edits or reapply a prior worktree diff. Verify required filesystem state before
110-
depending on a replayed mutating call.
103+
Replay walks the prior run in call-index order and reuses the longest unchanged
104+
prefix. The first failed, interrupted, changed, missing, corrupt, or unavailable
105+
result executes live and closes replay for every later call, even when a later
106+
cache key happens to match. Exact return values are stored separately from
107+
bounded UI previews.
108+
109+
Replay restores an agent's **return value**, not its execution. Shared-checkout
110+
calls assume their existing filesystem effects are still present. Worktree calls
111+
are never reused unless their exact worktree can be restored, so they currently
112+
end the reusable prefix and run live.
111113

112114
### Cancel
113115

0 commit comments

Comments
 (0)