@jun133/athlete 0.0.3 → 0.0.5

package/spec/modules/config-system.md

@@ -4,12 +4,12 @@
 
 配置系统负责统一读取 Athlete 的运行参数，并把项目级默认值、用户配置和环境变量合并成最终 runtime config。
 
-## 当前范围
-
-- API key / base URL / model
-- mode
-- paths
-- MCP 总开关与 server 配置
+## 当前范围
+
+- provider / API key / base URL / model
+- mode
+- paths
+- MCP 总开关与 server 配置
 - Playwright MCP repo 级默认值
 - context / continuation / read limits 等运行阈值
 
@@ -18,9 +18,21 @@
 1. 配置入口统一。
 2. 业务模块不直接散读环境变量。
 3. 用户能从 runtime config 理解当前行为从哪来。
-4. 项目级默认值允许放在 `.athlete/.env`，但仍由统一配置入口解析。
-
-## Playwright MCP 当前事实
+4. 项目级默认值允许放在 `.athlete/.env`，但仍由统一配置入口解析。
+
+## provider 当前事实
+
+当前统一入口会解析：
+
+- `ATHLETE_PROVIDER`
+- `ATHLETE_API_KEY`
+- `ATHLETE_BASE_URL`
+- `ATHLETE_MODEL`
+
+代码默认值与模板示例仍以 DeepSeek 系列为起点，但这只是默认配置/示例，不是 runtime kernel 绑定。
+项目本地 `.athlete/.env` 可以把有效 provider / base URL / model 覆盖到别的 OpenAI-compatible 服务。
+
+## Playwright MCP 当前事实
 
 当前支持的 repo 级 Playwright MCP 环境变量：
 
@@ -31,15 +43,20 @@
 - `ATHLETE_MCP_PLAYWRIGHT_OUTPUT_MODE`
 - `ATHLETE_MCP_PLAYWRIGHT_SAVE_SESSION`
 
-当前仓库默认行为：
-
-- Playwright MCP 在项目级 `.athlete/.env` 中默认启用
-- 默认浏览器为 `chrome`
-- 默认不是 headless
-- 默认 output mode 为 `file`
-- 默认 save session 为开启
-
-## 路径约定
+当前代码默认值：
+
+- 代码默认值是关闭
+- 默认浏览器为 `chromium`
+- 默认不是 headless
+- 默认 output mode 为 `stdout`
+- 默认 save session 为开启
+
+当前项目模板行为：
+
+- `src/config/init.ts` 生成的 `.athlete/.env` / `.athlete/.env.example` 会给出一组 repo 级 Playwright MCP 示例开关
+- 项目本地真实 `.athlete/.env` 可以进一步覆盖这些有效值
+
+## 路径约定
 
 当前 Playwright MCP 状态目录：
 
@@ -48,4 +65,13 @@
 - `.athlete/playwright-mcp/output/`
 - `.athlete/playwright-mcp/legacy-root-artifacts/`
 
-这些路径由配置系统和 `src/mcp/playwright/` 统一导出，不允许在调用侧随意拼接。
+这些路径由配置系统和 `src/mcp/playwright/` 统一导出，不允许在调用侧随意拼接。
+
+## 当前代码落点
+
+- `src/config/store.ts`
+  - runtime config 合并入口
+- `src/config/init.ts`
+  - `.athlete/.env` / `.athlete/.env.example` 模板
+- `src/agent/provider.ts`
+  - provider capability profile 消费 config 中的 provider/model

package/spec/modules/interactive-terminal.md

@@ -12,14 +12,15 @@
 - `src/shell/cli/`: CLI shell 适配层
 - `src/ui/`: CLI 文本格式化、runtime summary 和兼容导出
 
-### 共享交互控制层职责
-
-- 驱动交互 session loop
-- 处理普通输入和 multiline 分支
-- 处理本地命令路由
-- 管理 turn in-flight 状态与 abort controller 生命周期
-- 接线 `runManagedAgentTurn`
-- 维护当前 session 的内存态，并在 turn 完成后接收最新 session
+### 共享交互控制层职责
+
+- 驱动交互 session loop
+- 处理普通输入和 multiline 分支
+- 处理本地命令路由
+- 在 `quit / q / exit` 时检查当前项目仍在运行的后台进程，并做退出确认
+- 管理 turn in-flight 状态与 abort controller 生命周期
+- 接线 `runManagedAgentTurn`
+- 维护当前 session 的内存态，并在 turn 完成后接收最新 session
 
 ### 当前 CLI shell 职责
 
@@ -38,7 +39,26 @@
 4. `/runtime`、`/stats`、`/仪表盘` 只是 `SessionRecord.runtimeStats` 的只读 summary 视图。
 5. UI 可以读取并展示真相源，但不能绕过真相源另造状态。
 6. 交互 session loop 不能直接绑死 `readline`、`process.stdin/stdout`、`chalk` 这类 CLI 细节。
-7. shell 只能提供输入、输出和 turn 展示适配，不能自己发明 task / protocol / runtime 真相。
+7. shell 只能提供输入、输出和 turn 展示适配，不能自己发明 task / protocol / runtime 真相。
+
+## Quit Boundary
+
+- `quit / q / exit` 不是“无条件立刻退出”。
+- 共享交互层会先检查当前项目仍在运行的后台进程：
+  - `background job`
+  - `teammate worker`
+- 如果没有运行中的后台进程：
+  - 直接退出会话
+- 如果有运行中的后台进程：
+  - 先把它们列出来
+  - 只允许两个结果：
+    - 确认退出：杀掉全部后台进程，再退出
+    - 取消退出：保持当前 CLI 和后台进程继续运行
+- kill 失败时必须 fail-closed：
+  - 不退出
+  - 明确告诉用户哪些 PID 还活着
+
+这个规则属于共享交互控制层，不属于单个 shell 外壳。
 ## 当前本地命令入口
 
 - `/session`
@@ -85,25 +105,32 @@
 - `ShellOutputPort`: info / warn / plain / dim / interrupt 等展示输出
 - `InteractionTurnDisplay`: turn 期间的流式展示适配
 
-### 当前 CLI 接线
-
-- `src/ui/interactive.ts`: CLI 入口薄壳，只负责组装 shell、打印 intro、启动 driver
-- `src/shell/cli/readlineInput.ts`: CLI 输入适配
-- `src/shell/cli/output.ts`: `chalk` + stdio 输出适配
-- `src/shell/cli/turnDisplay.ts`: spinner + stream renderer 适配
-- `src/interaction/localCommands.ts`: 共享本地命令语义
+### 当前 CLI 接线
+
+- `src/ui/interactive.ts`: CLI 入口薄壳，只负责组装 shell、打印 intro、启动 driver
+- `src/shell/cli/readlineInput.ts`: CLI 输入适配
+- `src/shell/cli/output.ts`: `chalk` + stdio 输出适配
+- `src/shell/cli/turnDisplay.ts`: spinner + stream renderer 适配
+- `src/interaction/localCommands.ts`: 共享本地命令语义
+- `src/interaction/exitGuard.ts`: 退出前后台进程检查与 kill-or-continue 语义
 
 ## 当前展示边界
 
-交互终端当前只负责把这些状态展示清楚：
-
-- task board
-- teammate 状态
-- background 状态
+交互终端当前只负责把这些状态展示清楚：
+
+- task board
+- teammate 状态
+- background 状态
 - skill load 状态
 - runtime summary
 
-但它不负责发明这些状态。
+但它不负责发明这些状态。
+
+交互终端当前还负责把退出确认展示清楚：
+
+- 哪些后台进程仍在运行
+- 用户当前是在“继续运行”还是“kill 后退出”的分支
+- kill 失败时哪些 PID 仍未退出
 
 ## 未来方向
 

package/spec/modules/lightweight-context-runtime.md

@@ -4,14 +4,29 @@
 
 这一层负责让 Athlete 在长任务里继续跑，但不要把 prompt 和 session 越跑越重。
 
-## 运行时约定
-
-1. system prompt 按两层正式组装：
-   - `Static operating layer`
-   - `Dynamic runtime layer`
-2. 静态层放稳定规则、模式规则、身份规则、项目说明。
-3. 动态层放 cwd / root / date / taskState / todo / verification / task board / team / worktree / protocol / background / skill runtime。
-4. 压缩后的会话总结不再直接拼回静态层，而是追加为 `Compressed conversation memory`。
+## 运行时约定
+
+1. system prompt 按两层正式组装：
+   - `Static operating layer`
+   - `Dynamic runtime layer`
+2. 静态层只放高层 operating contract：
+   - identity / role contract
+   - work loop contract
+   - tool-use contract
+   - communication / output contract
+   - external content boundary
+   - project instructions
+3. 动态层放 cwd / root / date / taskState / todo / verification / checkpoint / task board / team / worktree / protocol / background / skill runtime 的紧凑摘要。
+4. 动态层应省略空状态和低价值 `No ...` 噪音，但要保留 checkpoint、verification pending paths、externalized tool refs 这些恢复锚点。
+5. 压缩后的会话总结不再直接拼回静态层，而是追加为 `Compressed conversation memory`。
+6. request context 构建可以派生 prompt diagnostics，用于诊断但不落盘：
+   - static / dynamic / memory chars
+   - static / dynamic / memory block counts
+   - block hotspot
+   - total prompt chars
+   - initial / final estimated request chars
+   - 当前这次 compression 是否由 prompt 膨胀触发
+   这些都只是派生观测，不是新的持久化真相源。
 
 ## 大 tool result 外置化
 
@@ -31,10 +46,11 @@
 ## 闭环要求
 
 1. continuation 继续使用 session 中的轻量 tool message，而不是重新塞回原始大正文。
-2. contextBuilder 在压缩历史时继续保留 `storagePath` 和预览信息。
-3. recovery 的 context shrink 也要保住结构化引用，不能把它打回不可追踪的大字符串。
-4. session 保存和加载后，外置化引用仍然可以恢复到落盘文件。
-5. 已通过 streaming delta 发出的 assistant 文本不会在 finalize 阶段再次整段重放。
+2. contextBuilder 在压缩历史时继续保留 `storagePath` 和预览信息。
+3. contextBuilder 产出的 prompt diagnostics 必须只存在于当次 request 构建结果里，不能写回 session。
+4. recovery 的 context shrink 也要保住结构化引用，不能把它打回不可追踪的大字符串。
+5. session 保存和加载后，外置化引用仍然可以恢复到落盘文件。
+6. 已通过 streaming delta 发出的 assistant 文本不会在 finalize 阶段再次整段重放。
 
 ## 验证方式
 
@@ -56,8 +72,9 @@
   - recentToolBatch
   - flow phase (`active / continuation / resume / recovery`)
   - priorityArtifacts (externalized tool-result refs, previews, pending paths)
-- continuation, reload/resume, and dynamic prompt rendering must all consume the same checkpoint instead of inventing separate recovery hints.
-- objective changes reset checkpoint progress so old work does not pollute the new task.
-- externalized tool results remain the preferred recoverable context, and checkpoint keeps the references lightweight.
-- fail-first test for this layer: `tests/runtime-checkpoint-resume.test.ts`
-- real API verification entry for this layer: `npm run verify:runtime-checkpoint-api`
+- continuation, reload/resume, and dynamic prompt rendering must all consume the same checkpoint instead of inventing separate recovery hints.
+- objective changes reset checkpoint progress so old work does not pollute the new task.
+- externalized tool results remain the preferred recoverable context, and checkpoint keeps the references lightweight.
+- verification 文案必须与 runtime 能力一致：targeted verification、lightweight readback、auto-readback 都是合法路径，不把所有改动都描述成必须全量 build/test。
+- fail-first test for this layer: `tests/runtime-checkpoint-resume.test.ts`
+- real API verification entry for this layer: `npm run verify:runtime-checkpoint-api`

package/spec/modules/provider-adapter.md

@@ -1,20 +1,45 @@
-# provider adapter
-
-## 作用
-
-provider adapter 负责把 Athlete 的请求发送到具体模型服务。
-
-## 当前策略
-
-- 优先 OpenAI-compatible
-- 运行时对网络错误、超时、上下文过长有恢复策略
-
-## 规则
-
-1. provider 能换，主循环不跟着重写。
-2. provider 问题先在 adapter 层处理，不外溢到任务语义层。
-3. 模型 fallback 属于运行时策略，不属于业务模块。
-
-## 下一阶段要求
-
-总指挥层不依赖某一家 provider 特性。
+# provider adapter
+
+## 作用
+
+provider adapter 负责把 Athlete 的请求发送到具体模型服务，并把 provider-specific 能力差异收敛成稳定的 capability profile。
+
+## 当前策略
+
+- 优先 OpenAI-compatible
+- provider-specific fallback、reasoning 能力、request body 差异、recovery model 选择都下沉到 provider 层
+- 运行时对网络错误、超时、上下文过长仍有恢复策略，但主循环只消费 provider capability，不再写死某家模型名
+
+## 规则
+
+1. provider 能换，主循环不跟着重写。
+2. provider 问题先在 adapter 层处理，不外溢到任务语义层。
+3. 模型 fallback 属于运行时策略，不属于业务模块。
+4. kernel 可以知道“当前 request model 是什么”，但不应该知道“某个具体 provider 为什么要这样切”。
+5. reasoning request body、tool 兼容 fallback、failure streak recovery model 都属于 provider capability。
+
+## 当前实现落点
+
+- `src/agent/provider.ts`
+  - `resolveProviderCapabilities()`
+  - `buildProviderRequestBody()`
+  - `selectProviderRequestModel()`
+- `src/agent/api.ts`
+  - 只消费 provider capability，不再直接判断 `deepseek-reasoner -> deepseek-chat`
+- `src/agent/retryPolicy.ts`
+  - 通过 provider 层选择 recovery request model
+- `src/agent/session/messages.ts`
+  - reasoning content 是否参与请求，也通过 provider capability 决定
+- `src/config/store.ts`
+  - 统一解析 `provider / baseUrl / model`
+
+## 当前状态说明
+
+- 代码默认配置与模板示例仍以 DeepSeek 系列为起点
+- 项目本地 `.athlete/.env` 可以把有效 provider / base URL / model 覆盖到其他 OpenAI-compatible 服务
+- 但 DeepSeek-specific 行为已经不在 kernel 主干里硬编码
+- adapter 层允许出现具体 provider 名词；主循环和业务规则层不允许依赖这些名字
+
+## 下一阶段要求
+
+总指挥层、closeout、workflow guard、acceptance gate 都不依赖某一家 provider 特性。

package/spec/modules/runtime-metrics.md

@@ -1,9 +1,11 @@
 # runtime metrics
 
-## 作用
-
-这一层开始，Athlete 的 session 会持久化结构化 `runtimeStats`，
-作为正式运行态仪表盘的真相源。
+## 作用
+
+这一层开始，Athlete 的 session 会持久化结构化 `runtimeStats`，
+作为正式运行态仪表盘的真相源。
+
+prompt layer metrics / context diagnostics 不属于这里的持久化真相源；它们只是在 request 构建阶段即时派生，用于诊断 prompt 体积、分层占比、hotspot 与压缩触发原因。
 
 它回答的是：
 
@@ -58,22 +60,22 @@
 - 统计粒度：真实 runtime tool execution
 - `tools.byName` 记录每个 tool 的调用次数、累计耗时、成功次数、失败次数
 
-### yield / continuation / recovery
-
-- 来源：`src/agent/turnPersistence.ts`
-- continuation 包括：
-  - managed continuation 的内部续跑输入
-  - 用户显式 `continue` / `resume` 这类恢复输入
+### yield / continuation / recovery
+
+- 来源：`src/agent/turn/persistence.ts`
+- continuation 包括：
+  - managed continuation 的内部续跑输入
+  - 用户显式 `continue` / `resume` 这类恢复输入
 
 ### compression
 
 - 来源：`src/agent/runTurn.ts`
 - 当 `buildRequestContext(...)` 返回 `compressed = true` 时记一次
 
-### externalized tool results
-
-- 来源：`src/agent/runTurn.ts` + `src/agent/toolResultStorage.ts`
-- 只在 tool result 实际被 externalize 时累计
+### externalized tool results
+
+- 来源：`src/agent/runTurn.ts` + `src/agent/toolResults/storage.ts`
+- 只在 tool result 实际被 externalize 时累计
 
 ## 用户入口
 
@@ -83,21 +85,49 @@
 - `/stats`
 - `/仪表盘`
 
-这些命令只读取并格式化当前 session summary，
-不发明新的运行态事实。
-
-## 当前 summary 最少包含
+这些命令读取既有 session 真相源，并在命令执行当下即时派生 prompt diagnostics。
+它们可以解释 runtime，但不会把这些诊断结果反写成新的 session 真相。
 
-- model request 次数
-- model wait 总耗时
+## 当前 summary 最少包含
+
+- model request 次数
+- model wait 总耗时
 - tool call 次数
 - tool 总耗时
 - yields / continuations / recoveries / compressions
 - externalized result count / bytes
-- top tools
-- slowest step
-- usage availability
-- session health
+- top tools
+- slowest step
+- usage availability
+- session health
+- durable truth 区块：
+  - `runtimeStats.updatedAt`
+  - `checkpoint.flow.phase`
+  - `checkpoint.flow.lastTransition`
+  - `verificationState.status`
+- derived diagnostics 区块：
+  - why continue / why recovery / why compression
+  - why slow
+  - flaky tool hotspot
+  - prompt layer / hotspot / slimming 诊断
+
+## durable truth vs derived diagnostics
+
+### durable truth
+
+- `SessionRecord.runtimeStats`
+- `SessionRecord.checkpoint`
+- `SessionRecord.verificationState`
+
+### derived diagnostics
+
+- runtime summary 文本
+- why slow / why continue / why recovery / why compression 的诊断结论
+- prompt layer chars / block counts / hotspots
+- request-time context diagnostics（如 initial / final estimated chars）
+
+derived diagnostics 必须来自既有真相源和当前 request 构建结果，
+不能反过来变成新的持久化 truth。
 
 ## usage 规则
 

package/spec/modules/runtime-rules.md

@@ -4,14 +4,15 @@
 
 运行时规则是 Athlete 的机器约束层。
 
-## 当前包含
-
-- 计划先行
-- inbox 注入
-- verification 状态机
-- finalize / closeout gating
-- continuation / compression
-- tool error recovery
+## 当前包含
+
+- 计划先行
+- inbox 注入
+- verification 状态机
+- finalize / closeout gating
+- continuation / compression
+- tool error recovery
+- runtime transition 模型
 
 ## 不该放进来的东西
 
@@ -19,15 +20,46 @@
 - 具体 skill 内容
 - 某个单一工具的内部实现
 
-## 当前与收口直接相关的规则
-
-- 变更型动作默认要求先 `todo_write`
-- 文件改动和 mutating shell 会把 session 推进到 verification required
-- 轻量交付物允许用定向 `read_file` / auto-readback 完成轻量验证
-- continuation 后仍然读取持久化的 `pendingPaths`，不会因为 slice 切换就忘记“还有哪些输出待验”
-- 当收口条件已满足时，task board closeout 工具会被隐藏，避免 `task_list` / `task_get` / `task_update` 无意义循环
-- 当 todo 已全部完成时，runtime 不再继续鼓励补写 `todo_write`
-
-## 下一阶段要求
-
-总指挥层可以提出“下一步做什么”，但运行时规则仍决定“现在允不允许这样做”。
+## 当前与收口直接相关的规则
+
+- 变更型动作默认要求先 `todo_write`
+- 文件改动和 mutating shell 会把 session 推进到 verification required
+- 轻量交付物允许用定向 `read_file` / auto-readback 完成轻量验证
+- acceptance / verification 统一消费机器 signal，而不是分散反推某个工具名
+- continuation 后仍然读取持久化的 `pendingPaths`，不会因为 slice 切换就忘记“还有哪些输出待验”
+- 当收口条件已满足时，task board closeout 工具会被隐藏，避免 `task_list` / `task_get` / `task_update` 无意义循环
+- 当 todo 已全部完成时，runtime 不再继续鼓励补写 `todo_write`
+- continue / recover / yield / pause / finalize 必须带结构化 reason code，而不是只靠零散字符串
+- 最近一次关键 runtime 决策持久化到既有 checkpoint 真相源，不新增平行 JSON
+- one-shot CLI 收尾输出必须带稳定 machine closeout contract，而不是只打印 session id
+- 交互式 `quit` 如果发现运行中的后台进程，必须先进入 kill-or-continue 二次确认
+
+## 当前 signal 规则
+
+acceptance / verification 当前统一识别的结果类型至少包括：
+
+- `http_endpoint_verified`
+- `web_page_verified`
+- `document_read_completed`
+- `structured_artifact_valid`
+
+换 browser 实现、换 document 引擎、换 provider 时，不应重写 acceptance gate 主体，只能换 adapter 或 signal 生产方式。
+
+## 当前代码落点
+
+- `src/agent/acceptance/signals.ts`
+  - acceptance signal 归一化
+- `src/agent/acceptance/evaluate.ts`
+  - 只消费 signal、file checks、command checks
+- `src/agent/verification/state.ts`
+  - verification 真相源
+- `src/agent/verification/signals.ts`
+  - lightweight verification / auto-readback
+- `src/cli/support.ts`
+  - one-shot closeout report
+- `src/cli.ts`
+  - CLI 终态输出
+
+## 下一阶段要求
+
+总指挥层可以提出“下一步做什么”，但运行时规则仍决定“现在允不允许这样做”。

package/spec/modules/session-resume-compact.md

@@ -24,20 +24,26 @@ Athlete 当前的记忆重点是：
 
 它不是跨项目的人格记忆。
 
-## 当前实现约束
-
-- continuation 会复用已有 session，而不是重新发明 todo / verification 状态。
-- compact 只压缩请求上下文，不抹掉任务板、todo、verification 这些真相源。
-- 收口判断可以依赖持久化的 `verificationState.pendingPaths`，不能只看当前 slice 的临时 `changedPaths`。
-
-## Resume / Reset Contract
-
-- `resume` 的语义是继续现有任务现场。
-- `quit` 只是退出当前聊天窗口，不主动清空项目运行时状态。
-- 显式 `reset` 会清空当前项目 `.athlete/` 下的运行时状态，并删除当前项目相关的持久化 session。
-- 一旦 `reset` 成功，`resume` 不应恢复已经 reset 掉的运行时。
-- 如果 objective 明确变化，checkpoint 进度必须重置，避免旧任务进度污染新任务。
-- externalized tool-result references 和 verification pending paths 仍然是优先的可恢复锚点，但 reset 会主动销毁这一层锚点。
+## 当前实现约束
+
+- continuation 会复用已有 session，而不是重新发明 todo / verification 状态。
+- compact 只压缩请求上下文，不抹掉任务板、todo、verification 这些真相源。
+- 收口判断可以依赖持久化的 `verificationState.pendingPaths`，不能只看当前 slice 的临时 `changedPaths`。
+- `checkpoint.flow.lastTransition` 会随 session 持久化，保留最近一次关键 runtime 决策的结构化原因。
+
+## Resume / Reset Contract
+
+- `resume` 的语义是继续现有任务现场。
+- `quit` 会先检查当前项目仍在运行的后台进程。
+- 如果没有运行中的后台进程，`quit` 只是退出当前聊天窗口，不主动清空项目运行时状态。
+- 如果有运行中的后台进程，`quit` 必须先进入二次确认：
+  - 确认退出：kill 全部后台进程，再退出
+  - 取消退出：继续留在当前会话
+- 显式 `reset` 会清空当前项目 `.athlete/` 下的运行时状态，并删除当前项目相关的持久化 session。
+- 一旦 `reset` 成功，`resume` 不应恢复已经 reset 掉的运行时。
+- 如果 objective 明确变化，checkpoint 进度必须重置，避免旧任务进度污染新任务。
+- externalized tool-result references 和 verification pending paths 仍然是优先的可恢复锚点，但 reset 会主动销毁这一层锚点。
+- runtime transition reason code 也属于 checkpoint 真相源的一部分，resume / continuation 读取它，而不是再造平行恢复提示。
 
 ## 下一阶段要求
 

package/spec/modules/task-state.md

@@ -14,21 +14,28 @@
 - `checklist`
 - `worktree`
 
-## 当前规则
-
-1. `assignee` 表示应该谁做。
-2. `owner` 表示现在谁正在做。
-3. 被阻塞任务不能启动。
-4. 已完成任务不能随意重开。
-
-## 下一阶段演进方向
-
-任务系统要支持总指挥层，优先考虑增加：
-
-- 优先级
-- 父子任务
-- 重试次数
-- 产物引用
-- review / verify 要求
-
-这些演进必须建立在现有持久化任务板上，而不是另起一套任务宇宙。
+## 当前规则
+
+1. `assignee` 表示应该谁做。
+2. `owner` 表示现在谁正在做。
+3. 被阻塞任务不能启动。
+4. 已完成任务不能随意重开。
+5. `status / blockedBy / assignee / owner / worktree` 不是孤立看的，lead orchestrator 会联合 `TeamStore`、`BackgroundJobStore`、`WorktreeStore` 派生任务 lifecycle。
+6. 同一个任务的 machine lifecycle 至少要能区分：
+   - `blocked`
+   - `ready`
+   - `active`
+   - `completed`
+7. `ready` 还要继续区分是谁能接：
+   - lead
+   - 指定 teammate
+   - nobody（缺失或冲突时 fail-closed）
+8. 如果 task 仍绑定失效 worktree、指向缺失 background job、或保留了不存在 teammate 的 handoff，系统必须阻断继续派工。
+
+## 下一阶段演进方向
+
+任务系统后续如要继续长：
+
+- 优先先扩现有 task truth
+- 不新造平行 orchestration plane
+- 继续让 lifecycle / ownership / handoff 由机器从既有真相源派生

package/spec/modules/telegram-private-chat.md

@@ -228,7 +228,8 @@ Telegram 过程输出要更接近终端工作感知，但遵守“可见段按
 
 过程消息按实际事件顺序发送，不做机械固定轮换，也不做最终汇总：
 
-- `onToolCall` 一次，就发一条 tool call 消息
+- `onToolCall` 不直接发聊天消息，避免把工具名刷进聊天框
+- 非 `todo_write` 的 tool result 只发送一条可见 preview，并截断到 150 个字符
 - `todo_write` 对应的可见 preview 一次，就发一条 todo preview 消息
 - `onAssistantDelta` 只作为阶段内缓冲信号，不直接发聊天消息
 - `onAssistantText` 表示拿到了完整 assistant 文本时，发一条 assistant 消息