docs: rescan rebased documentation hierarchy

2026-08-05 16:16:57 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/todo/README.md
-README.md: da85a5573507cd8bb1ac52f9614225819a479baf
-README.zh.md: 5b83fe4d2d59ff6401b6a455d8d5977d6a5e5122
+README.md: 66abf18131ee53d87e933757c40117841e94b07f
+README.zh.md: 38a6b3c22653b8e22cc0b693eb666620513a3d8c
@@ -2,10 +2,10 @@

 English | [中文](README.zh.md)

-The model-facing todo tool. A single **product** package — there is no interface/implementation seam here, because the list is single-owner session state (one agent session owns its own list), not a swappable capability.
+The model-facing todo capability. It is a single **product** package because one agent session owns the list; there is no replaceable provider seam.

 | Package | Role | ctx key |
 |---|---|---|
-| `tool-todo/` | Model-facing `todo_write` tool; writes the whole list to the session log (`todo/write`) | (registers on `ctx.tools`) |
+| [`tool-todo/`](tool-todo/README.md) | Stores and exposes the session's todo list. | (registers on `ctx.tools`) |

-The list lives on the event-sourced session log (`SessionEventMap['todo/write']`, owned by [`dsh-session`](../core/session)); this package is the thin consumer that appends the snapshot. Host/client runtimes render the durable list from session events.
+The child README owns the tool, persistence, and rendering contract.
@@ -2,10 +2,10 @@

 [English](README.md) | 中文

-面向模型的 todo 工具。它是单一 **产品**包（package）：这里没有接口／实现 seam，因为该列表是由单一所有者管理的会话状态（每个 agent（智能体）会话拥有自己的列表），而非可替换能力。
+面向模型的 todo 能力。它是单一**产品**包，因为一个 agent（智能体）会话拥有该列表；不存在可替换的提供方 seam。

 | 包 | 职责 | ctx 键 |
 |---|---|---|
-| `tool-todo/` | 面向模型的 `todo_write` 工具；将完整列表写入会话日志（`todo/write`） | （注册到 `ctx.tools`） |
+| [`tool-todo/`](tool-todo/README.md) | 存储并公开会话的 todo 列表。 | （注册到 `ctx.tools`） |

-列表存在于事件溯源会话日志中（`SessionEventMap['todo/write']`，由 [`dsh-session`](../core/session) 拥有）；本包是追加快照的轻量消费方。宿主／客户端运行时会根据会话事件渲染该持久化列表。
+子级 README 负责工具、持久化和渲染契约。