@deepseek-ai/dsh-tool-todo 0.1.2-alpha.5 → 0.1.3-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +5 -6
  3. package/README.zh.md +5 -6
  4. package/package.json +17 -17
package/README.i18n.yaml CHANGED
@@ -2,5 +2,5 @@
2
2
  # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
3
  # after editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/todo/tool-todo/README.md
5
- README.md: 144f3476c36cb9054b7a21df11e78e3a70a1aed2
6
- README.zh.md: 0ebda11ac08a245f4b07eda32c69d062cb79d0a9
5
+ README.md: 0547688d833f10ae9504496d703ed7532e397e3e
6
+ README.zh.md: 23d4f71a41403711a2cdf639d01bf6f33c8f803d
package/README.md CHANGED
@@ -74,7 +74,7 @@ The tool is built on four commitments:
74
74
  - **Deployment policy, not a coded rule.** `allowParallelInProgress` is a required composition choice because the tool cannot observe runtime concurrency; the durable-log invariant deliberately stays silent on the active count so a log written under one policy still replays under another.
75
75
  - **Validation keeps the logged snapshot honest.** Schema-level rejection of unknown keys and `execute`-level rejection of empty or duplicate content keep the durable snapshot equal to what the model believes it wrote.
76
76
 
77
- The [todo_write tool Agent Note](../../../.agents/notes/implemented/feature/2026-06-29-todo-write-tool.md) records the original design and alternatives; the [parallel in-progress Agent Note](../../../.agents/notes/implemented/feature/2026-07-26-todo-parallel-in-progress.md) records the policy decision.
77
+ The [todo_write tool Agent Note](../../../.agents/notes/archived/feature/2026-06-29-todo-write-tool.md) records the original design and alternatives; the [parallel in-progress Agent Note](../../../.agents/notes/archived/feature/2026-07-26-todo-parallel-in-progress.md) records the policy decision.
78
78
 
79
79
  ### Source map
80
80
 
@@ -91,11 +91,11 @@ The plugin is a function/namespace plugin: it exports `name` / `inject` / `apply
91
91
 
92
92
  ### Session projection
93
93
 
94
- When the composition mounts `ctx.sessionProjections` ([`@deepseek-ai/dsh-session-projection`](../../session/session-projection/README.md)), this package registers the `todos` unit on an injected child: the projection is the standing plan — the latest whole `todo/write` list, `null` before the first write, cleared when the next turn starts while `turn/end` keeps the finished checklist visible. The key merges into `SessionProjectionMap` here; carriers serve the value on the history tail page and the `session/projection` push frame. Compositions without the registry are unaffected; see [src/index.ts](src/index.ts) for the unit registration. The lifetime rationale lives in the [todo plan clears on next turn Agent Note](../../../.agents/notes/implemented/feature/2026-07-28-todo-plan-clears-on-next-turn.md).
94
+ When the composition mounts `ctx.sessionProjections` ([`@deepseek-ai/dsh-session-projection`](../../session/session-projection/README.md)), this package registers the `todos` unit on an injected child: the projection is the standing plan — the latest whole `todo/write` list, `null` before the first write, cleared when the next turn starts while `turn/end` keeps the finished checklist visible. The key merges into `SessionProjectionMap` here; carriers serve the value on the history tail page and the `session/projection` push frame. Compositions without the registry are unaffected; see [src/index.ts](src/index.ts) for the unit registration.
95
95
 
96
96
  ### Durable-log invariant
97
97
 
98
- The invariant companion registers on `ctx.invariants`, validates existing and newly announced sessions once, and then advances a committed per-session turn trace for live appends. It rejects malformed entries, empty or duplicated content, unknown statuses, and any durable `todo/write` outside an open turn; core session treats declaration-merged events generically, while this producing package owns todo-specific rules. It deliberately says nothing about how many items are `in_progress`, because that is the tool's per-deployment policy, not a durable-data rule ([event ownership](../../../.agents/notes/implemented/architecture/2026-07-20-todo-event-ownership.md)).
98
+ The invariant companion registers on `ctx.invariants`, validates existing and newly announced sessions once, and then advances a committed per-session turn trace for live appends. It rejects malformed entries, empty or duplicated content, unknown statuses, and any durable `todo/write` outside an open turn; core session treats declaration-merged events generically, while this producing package owns todo-specific rules. It deliberately says nothing about how many items are `in_progress`, because that is the tool's per-deployment policy, not a durable-data rule.
99
99
 
100
100
  ### Call mechanics
101
101
 
@@ -114,9 +114,8 @@ Read these pages when the package-level contract is not enough. They move from t
114
114
  - [todo group map](../README.md) — the sibling group page and its package table.
115
115
  - [Generated tool catalog](../../../docs/tool-catalog.md#deepseek-aidsh-tool-todo) — the `todo_write` schema the model receives.
116
116
  - [Generated configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-tool-todo) — every accepted config field and its source declaration.
117
- - [todo_write tool Agent Note](../../../.agents/notes/implemented/feature/2026-06-29-todo-write-tool.md) — the original design, alternatives, and dropped fields.
118
- - [parallel in-progress Agent Note](../../../.agents/notes/implemented/feature/2026-07-26-todo-parallel-in-progress.md) — why the active-count cap is a deployment policy.
119
- - [todo plan clears on next turn Agent Note](../../../.agents/notes/implemented/feature/2026-07-28-todo-plan-clears-on-next-turn.md) — the projection's standing-plan lifetime.
117
+ - [todo_write tool Agent Note](../../../.agents/notes/archived/feature/2026-06-29-todo-write-tool.md) — the original design, alternatives, and dropped fields.
118
+ - [parallel in-progress Agent Note](../../../.agents/notes/archived/feature/2026-07-26-todo-parallel-in-progress.md) — why the active-count cap is a deployment policy.
120
119
 
121
120
  -----
122
121
 
package/README.zh.md CHANGED
@@ -74,7 +74,7 @@ agent 每次更新都发送完整列表；新列表替换旧列表，因此没
74
74
  - **部署策略，而非编码规则。** `allowParallelInProgress` 是必填组合选择，因为工具无法观测运行时并发；持久日志不变式刻意不跟随它，因此一种策略下写入的日志在部署收紧另一种策略后仍可回放。
75
75
  - **校验让落库快照保持诚实。** schema 层拒绝未知键、`execute` 层拒绝空或重复 content，使持久快照与模型自认为写入的内容一致。
76
76
 
77
- [todo_write 工具 Agent Note](../../../.agents/notes/implemented/feature/2026-06-29-todo-write-tool.zh.md) 记录原始设计与备选方案；[并行 in-progress Agent Note](../../../.agents/notes/implemented/feature/2026-07-26-todo-parallel-in-progress.zh.md) 记录该策略决策。
77
+ [todo_write 工具 Agent Note](../../../.agents/notes/archived/feature/2026-06-29-todo-write-tool.md) 记录原始设计与备选方案；[并行 in-progress Agent Note](../../../.agents/notes/archived/feature/2026-07-26-todo-parallel-in-progress.md) 记录该策略决策。
78
78
 
79
79
  ### 源码地图
80
80
 
@@ -91,11 +91,11 @@ agent 每次更新都发送完整列表；新列表替换旧列表，因此没
91
91
 
92
92
  ### 会话投影
93
93
 
94
- 当组合挂载 `ctx.sessionProjections`（[`@deepseek-ai/dsh-session-projection`](../../session/session-projection/README.zh.md)）时，本包在注入的子插件中注册 `todos` 单元：投影即有效计划——最新的整份 `todo/write` 列表，首次写入前为 `null`，下一轮次开始时清空，而 `turn/end` 保留刚完成的清单。该键在此处合并进 `SessionProjectionMap`；载体通过历史尾页与 `session/projection` 推送帧提供该值。未挂载注册表的组合不受影响；单元注册见 [src/index.ts](src/index.ts)。生命周期理由见 [todo 计划在下一轮次清空 Agent Note](../../../.agents/notes/implemented/feature/2026-07-28-todo-plan-clears-on-next-turn.zh.md)。
94
+ 当组合挂载 `ctx.sessionProjections`（[`@deepseek-ai/dsh-session-projection`](../../session/session-projection/README.zh.md)）时，本包在注入的子插件中注册 `todos` 单元：投影即有效计划——最新的整份 `todo/write` 列表，首次写入前为 `null`，下一轮次开始时清空，而 `turn/end` 保留刚完成的清单。该键在此处合并进 `SessionProjectionMap`；载体通过历史尾页与 `session/projection` 推送帧提供该值。未挂载注册表的组合不受影响；单元注册见 [src/index.ts](src/index.ts)。
95
95
 
96
96
  ### 持久日志不变式
97
97
 
98
- 不变式伴生插件注册到 `ctx.invariants`，先分别校验既有会话与新公布会话一次，再为实时追加推进按会话提交的轮次轨迹。它会拒绝畸形条目、空或重复 content、未知状态，以及开放轮次之外的持久 `todo/write`；核心 session 通用处理声明合并事件，而本生产包拥有 todo 专用规则。它刻意不约束有多少条目处于 `in_progress`，因为那是工具按部署制定的策略，而非持久数据规则（见[事件归属](../../../.agents/notes/implemented/architecture/2026-07-20-todo-event-ownership.zh.md)）。
98
+ 不变式伴生插件注册到 `ctx.invariants`，先分别校验既有会话与新公布会话一次，再为实时追加推进按会话提交的轮次轨迹。它会拒绝畸形条目、空或重复 content、未知状态，以及开放轮次之外的持久 `todo/write`；核心 session 通用处理声明合并事件，而本生产包拥有 todo 专用规则。它刻意不约束有多少条目处于 `in_progress`，因为那是工具按部署制定的策略，而非持久数据规则。
99
99
 
100
100
  ### 调用机制
101
101
 
@@ -114,9 +114,8 @@ agent 每次更新都发送完整列表；新列表替换旧列表，因此没
114
114
  - [todo 组映射](../README.zh.md)——同级组页面及其包表格。
115
115
  - [生成的工具目录](../../../docs/tool-catalog.zh.md#deepseek-aidsh-tool-todo)——模型接收的 `todo_write` schema。
116
116
  - [生成的配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-tool-todo)——每个受支持配置字段及其源声明。
117
- - [todo_write 工具 Agent Note](../../../.agents/notes/implemented/feature/2026-06-29-todo-write-tool.zh.md)——原始设计、备选方案与砍掉的字段。
118
- - [并行 in-progress Agent Note](../../../.agents/notes/implemented/feature/2026-07-26-todo-parallel-in-progress.zh.md)——为何活跃计数上限成为部署策略。
119
- - [todo 计划在下一轮次清空 Agent Note](../../../.agents/notes/implemented/feature/2026-07-28-todo-plan-clears-on-next-turn.zh.md)——投影的有效计划生命周期。
117
+ - [todo_write 工具 Agent Note](../../../.agents/notes/archived/feature/2026-06-29-todo-write-tool.md)——原始设计、备选方案与砍掉的字段。
118
+ - [并行 in-progress Agent Note](../../../.agents/notes/archived/feature/2026-07-26-todo-parallel-in-progress.md)——为何活跃计数上限成为部署策略。
120
119
 
121
120
  -----
122
121
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-todo",
3
3
  "description": "Model-facing todo_write tool over the DeepSeek Harness event-sourced session log",
4
- "version": "0.1.2-alpha.5",
4
+ "version": "0.1.3-alpha.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -41,26 +41,26 @@
41
41
  "@deepseek-ai/schemastery": "^3.18.2"
42
42
  },
43
43
  "peerDependencies": {
44
- "@deepseek-ai/dsh-agent": "^0.1.2-alpha.5",
45
- "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
46
- "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
47
- "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.5",
48
- "@deepseek-ai/dsh-tools": "^0.1.2-alpha.5",
49
- "@deepseek-ai/cordis": "^4.0.2"
44
+ "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
45
+ "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
46
+ "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
47
+ "@deepseek-ai/dsh-tools": "^0.1.3-alpha.2",
48
+ "@deepseek-ai/cordis": "^4.0.2",
49
+ "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2"
50
50
  },
51
51
  "devDependencies": {
52
52
  "@deepseek-ai/cordis-plugin-include": "^1.0.7",
53
53
  "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
54
- "@deepseek-ai/dsh-agent-loop": "^0.1.2-alpha.5",
55
- "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.2-alpha.5",
56
- "@deepseek-ai/dsh-agent": "^0.1.2-alpha.5",
57
- "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
58
- "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
59
- "@deepseek-ai/dsh-system-prompt": "^0.1.2-alpha.5",
60
- "@deepseek-ai/dsh-tools": "^0.1.2-alpha.5",
61
- "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.5",
62
- "@deepseek-ai/dsh-user-questions": "^0.1.2-alpha.5",
54
+ "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2",
55
+ "@deepseek-ai/dsh-agent-loop": "^0.1.3-alpha.2",
56
+ "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.3-alpha.2",
57
+ "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
58
+ "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
59
+ "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
60
+ "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
61
+ "@deepseek-ai/dsh-system-prompt": "^0.1.3-alpha.2",
62
+ "@deepseek-ai/dsh-user-questions": "^0.1.3-alpha.2",
63
63
  "@deepseek-ai/cordis": "^4.0.2",
64
- "@deepseek-ai/dsh-llm": "^0.1.2-alpha.5"
64
+ "@deepseek-ai/dsh-tools": "^0.1.3-alpha.2"
65
65
  }
66
66
  }