Skip to content

Commit cadc46c

Browse files
committed
docs(todos): describe completion cycle repair and readback
Signed-off-by: Jim-jimu <49069997+bmh201708@users.noreply.github.com>
1 parent 8987068 commit cadc46c

5 files changed

Lines changed: 38 additions & 0 deletions

File tree

37.1 KB
Loading
36.2 KB
Loading
32.8 KB
Loading
36.2 KB
Loading

‎docs/reference/todo-continuation-readback.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,44 @@ prequota;只声明 filesystem/shell 不会启用。省略该声明即关闭外
5858
通过 `todo list --goal-id GOAL --todo-id TODO --format json` 回读。
5959
TurnEnvelope 应复用同一类型化依赖事实;本批未证明所有 Turn host 已接入自动核验。
6060

61+
## Completion dependency cycles / 完成依赖环
62+
63+
An unfinished `todo_done` chain that reaches a cycle now projects
64+
`resume_condition_invalid` with `invalid_state=dependency_cycle`, consistently
65+
with canonical execution admission. `dependency_cycle_todo_ids` identifies up
66+
to eight members in dependency order; `dependency_cycle_size` retains the full
67+
count. A task leading into the cycle is also invalid, even when another Agent
68+
owns the cyclic tasks. Actual `done` records, including retained archived
69+
completion, terminate the chain. Missing records in a partial source do not
70+
prove a cycle; other resume kinds keep their own rules.
71+
72+
When no independent work is executable, the current/unclaimed, non-excluded
73+
Agent lane requests successor replan instead of quiet waiting. Read the exact
74+
Todo with `todo list --goal-id GOAL --todo-id TODO --format json`, inspect the
75+
reported members and their owners, and repair only a reviewed obsolete
76+
dependency through the existing Todo lifecycle and owner/lease/CAS checks.
77+
Cycle detection grants no authority to delete dependencies or complete work.
78+
An already-bound Turn retains its identity and exposes `repair=dependency`;
79+
re-enter that same Turn after authorized repair. New causal wait closeout cannot
80+
qualify a cycle, and current delivery supervision cannot use it as an ordinary
81+
wait exemption. Frozen v0 causal receipts keep their historical pair-only
82+
readback semantics; they never certify today's graph. No receipt migration or
83+
automatic dependency rewrite is performed.
84+
85+
未完成的 `todo_done` 依赖链进入环时,读回与执行检查统一返回无效依赖;
86+
`dependency_cycle_todo_ids` 最多展示八个环内任务,完整数量保存在
87+
`dependency_cycle_size`。实际完成(含归档完成)截断追踪;局部快照缺少任务不能
88+
作为有环的证据。没有独立可执行工作时,当前 Agent 可处理的任务进入明确重规划,
89+
不能静默等待。通过精确 Todo 读回查看环及 owner,只能按既有权限、租约和 CAS
90+
规则修复经核实已经过时的依赖;诊断不授权删边或虚报完成。已绑定 Turn 保留
91+
原身份,修复后重新进入同一 Turn。新等待结算和当前交付监督不再将环视为正常
92+
因果等待;旧 v0 回执仍按冻结的双任务事实读回,不重新裁决过去,也不证明当前图合法。
93+
94+
Synthetic packaged-UI readback: [before](images/completion-dependency-cycle/before.png),
95+
[cycle diagnosed](images/completion-dependency-cycle/after.png),
96+
[mobile](images/completion-dependency-cycle/mobile.png), and
97+
[after owner-reviewed repair](images/completion-dependency-cycle/repaired.png).
98+
6199
## Relationship evidence
62100

63101
The policy evaluates the complete available Todo graph before role, status,

0 commit comments

Comments
 (0)