@jun133/athlete 0.0.5 → 0.0.6

package/spec/implementation//347/233/256/345/275/225/347/273/223/346/236/204/345/210/260/344/273/243/347/240/201/346/226/207/344/273/266/346/230/240/345/260/204/350/241/250.md

@@ -1,176 +0,0 @@
-# 目录结构到代码文件映射表
-
-## 当前主要目录
-
-- `src/agent/`: 主循环与稳定 façade
-- `src/agent/provider.ts`: provider capability profile、request body 组装、provider fallback / recovery model 选择
-- `src/agent/checkpoint/`: checkpoint 归一化、推导、resume 输入、prompt block
-- `src/agent/context/`: request context 组装与压缩
-- `src/agent/session/`: session message / todo / task state / session store 真相整理
-- `src/agent/toolResults/`: tool result preview、transport 压缩、externalize 落盘
-- `src/agent/turn/`: managed turn、closeout、finalize、tool execution、loop / recovery 辅助
-- `src/agent/verification/`: verification state 与 lightweight / auto-readback signals
-- `src/agent/acceptance/signals.ts`: acceptance signal 归一化
-- `src/agent/runtimeMetrics/`: runtime metrics 累积与 runtime summary
-- `src/tools/`: 模型可见工具与 handler
-- `src/tools/governance.ts`: 工具治理 metadata、fail-closed 默认、result signal 校验
-- `src/tools/routing.ts`: 文档 / spreadsheet 专用工具路由 hint
-- `src/skills/`: skill schema、discovery、matching、loading、workflow guard
-- `src/mcp/`: MCP 总接入层
-- `src/mcp/playwright/`: Playwright MCP 配置、路径、artifact、调用归一化
-- `src/context/`: repo root、state root、AGENTS、skills、ignore 发现
-- `src/config/`: 配置读取、环境变量、runtime config、app paths
-- `src/tasks/`: 持久化 task 真相源
-- `src/team/`: teammate、消息、协议、policy
-- `src/background/`: 后台任务
-- `src/worktrees/`: 目录隔离
-- `src/orchestrator/`: lead 编排、任务图、lifecycle 派生、route / dispatch
-- `src/subagent/`: 一次性子智能体
-- `src/interaction/`: 共享交互控制层与 shell 契约
-- `src/interaction/exitGuard.ts`: 交互退出前的后台进程检查与 kill-or-continue 语义
-- `src/shell/cli/`: CLI shell 输入、输出、turn 展示、intro
-- `src/ui/`: CLI 文本格式化、runtime summary 和兼容导出
-- `src/telegram/`: Telegram 私聊通道、delivery、附件、CLI、process lock
-- `src/weixin/`: Weixin 私聊通道、OpeniLink client、delivery、context_token、CLI、process lock
-
-## 当前 lightweight context 对应代码
-
-- `src/agent/promptSections.ts`: prompt facade，对外保留 static / dynamic layer 入口
-- `src/agent/prompt/static.ts`: 静态 operating contract 分块
-- `src/agent/prompt/dynamic.ts`: 动态 runtime 摘要与空状态瘦身
-- `src/agent/prompt/format.ts`: prompt block 渲染与 memory append
-- `src/agent/prompt/structured.ts`: 结构化字段/摘要 section 到 prompt block 的统一渲染
-- `src/agent/prompt/metrics.ts`: prompt layer char / block metrics
-- `src/agent/prompt/requestDiagnostics.ts`: request-time prompt/context diagnostics
-- `src/agent/prompt/types.ts`: prompt layer 类型
-- `src/agent/context.ts`: context / tool-results cluster 入口
-- `src/agent/context/builder.ts`: 使用轻量 payload 的请求上下文构建
-- `src/agent/toolResults/storage.ts`: externalized tool result 落盘
-- `src/agent/toolResults/preview.ts`: tool payload 预览与 transport 压缩
-- `src/tools/files/toolResultArtifact.ts`: `.athlete/tool-results/...` 的紧凑 artifact read
-
-## 当前 checkpoint / continuation 对应代码
-
-- `src/agent/checkpoint.ts`: checkpoint 对外导出面
-- `src/agent/checkpoint/base.ts`: checkpoint 默认结构与从 session 派生
-- `src/agent/checkpoint/state.ts`: checkpoint 归一化与生命周期更新
-- `src/agent/checkpoint/transitions.ts`: checkpoint 上的 yield / recovery / pause / finalize 等转移落盘
-- `src/agent/checkpoint/derivation.ts`: completedSteps / nextStep / artifact 推导
-- `src/agent/checkpoint/prompt.ts`: checkpoint 恢复输入与 prompt block
-- `src/agent/turn.ts`: turn cluster 入口
-- `src/agent/turn/persistence.ts`: turn 开始、yield、recovery、tool batch 的 session 持久化接线
-- `src/agent/turn/managed.ts`: continuation 输入通过 checkpoint 生成
-
-## 当前 runtime transition 对应代码
-
-- `src/agent/runtimeTransition.ts`: runtime transition 对外导出面
-- `src/agent/runtimeTransition/flow.ts`: transition 归一化、checkpoint flow 派生、phase 计算
-- `src/agent/runtimeTransition/builders.ts`: continue / recover / yield / pause / finalize 的结构化 reason builder
-- `src/agent/runtimeTransition/shared.ts`: transition 归一化共享辅助
-
-## 当前 runtime metrics / 仪表盘 对应代码
-
-- `src/agent/runtimeMetrics.ts`: runtime metrics 对外导出面
-- `src/agent/runtimeMetrics/state.ts`: `runtimeStats` 归一化与事件累积
-- `src/agent/runtimeMetrics/summary.ts`: session runtime summary 生成
-- `src/agent/runtimeMetrics/diagnostics.ts`: durable truth / derived diagnostics 拆分与解释生成
-- `src/agent/api.ts`: provider request timing 与 provider usage 采集
-- `src/agent/provider.ts`: provider-specific request body / fallback / recovery policy 下沉
-- `src/agent/runTurn.ts`: tool execution、compression、recovery 等运行事件统计接线
-- `src/ui/runtimeSummary.ts`: 交互态 runtime summary 文本格式化
-- `src/ui/runtimeSummaryData.ts`: `/runtime` 命令的 request-time prompt diagnostics 组装
-- `src/interaction/localCommands.ts`: 共享本地命令语义与 `/runtime` / `/stats` / `/仪表盘` 路由
-- `src/ui/localCommands.ts`: CLI 默认输出适配与薄导出
-
-## 当前 session / task-state 对应代码
-
-- `src/agent/session.ts`: session cluster 入口
-- `src/agent/session/messages.ts`: stored message / chat message 归一化
-- `src/agent/session/store.ts`: session 落盘与恢复
-- `src/agent/session/taskState.ts`: session task-state 提取与 internal reminder
-- `src/agent/session/taskStateHistory.ts`: 从消息历史派生活跃文件、计划动作、完成动作、blocker
-- `src/agent/session/todos.ts`: todo 真相提取、格式化与 normalize
-
-## 当前交互 shell 对应代码
-
-- `src/interaction/sessionDriver.ts`: 共享交互 session loop、multiline、interrupt、turn 生命周期
-- `src/interaction/exitGuard.ts`: 交互退出时列出 background job / teammate worker，并执行 kill-or-continue 分支
-- `src/interaction/shell.ts`: `InteractionShell` / `ShellInputPort` / `ShellOutputPort` / `InteractionTurnDisplay`
-- `src/shell/cli/readlineInput.ts`: CLI 输入适配
-- `src/shell/cli/output.ts`: CLI 文本输出适配
-- `src/shell/cli/turnDisplay.ts`: CLI spinner + stream renderer 适配
-- `src/shell/cli/intro.ts`: CLI banner 与 launch hints
-- `src/shell/cli/shell.ts`: CLI shell 组装
-- `src/ui/interactive.ts`: CLI 入口薄壳，组装 shell 并启动共享 driver
-
-## 当前 Playwright MCP 对应代码
-
-- `src/mcp/config.ts`: MCP 配置归一化
-- `src/mcp/playwright/config.ts`: Playwright MCP 配置归一化与 server args
-- `src/mcp/playwright/paths.ts`: `.athlete/playwright-mcp/` 路径约定
-- `src/mcp/playwright/artifacts.ts`: artifact 目录准备、迁移、生成配置
-- `src/mcp/playwright/invoke.ts`: relative filename 归一化
-- `src/mcp/stdioClient.ts`: 真实 stdio MCP client
-- `src/mcp/toolAdapter.ts`: MCP tool 适配进 Athlete registry，并补充治理所需 origin 信息
-- `src/tools/runtimeRegistry.ts`: runtime registry 组装 built-in tools 与 MCP tools，并保留 blocked diagnostics
-- `src/tools/registry.ts`: fail-closed tool registry、entries / blocked 暴露面与 result governance 校验
-
-## 当前 closeout / verification 对应代码
-
-- `src/agent/turn.ts`: closeout / finalize cluster 入口
-- `src/agent/turn/finalize.ts`: tool-less turn 的最终收口与 verification / pause 行为
-- `src/agent/turn/closeout.ts`: closeout 阶段的工具过滤与 stale todo 容忍规则
-- `src/agent/verification.ts`: verification cluster 入口
-- `src/agent/verification/state.ts`: verification 真相源
-- `src/agent/verification/signals.ts`: lightweight verification signals 与 auto-readback
-- `src/agent/acceptance/signals.ts`: `http_endpoint_verified` / `web_page_verified` / `document_read_completed` / `structured_artifact_valid`
-- `src/cli/support.ts`: one-shot closeout report 生成
-- `src/cli.ts`: one-shot terminal closeout JSON 输出
-- `src/agent/runTurn.ts`: 调度这些规则，但不持有它们的内部实现细节
-
-## 当前 turn / loop 辅助代码
-
-- `src/agent/turn.ts`: turn / loop helper cluster 入口
-- `src/agent/turn/recovery.ts`: API 重试、content-policy redaction、context shrink
-- `src/agent/turn/planGate.ts`: mutating tool 的 todo 前置约束
-- `src/agent/turn/loopGuard.ts`: 重复工具调用保护
-- `src/agent/turn/toolExecutor.ts`: tool 执行与 recovery hint
-- `src/agent/turn/toolless.ts`: 缺 skill / finalize 收口分发
-- `src/agent/turn/state.ts`: request 内 turn 状态 prompt block 与进度提示
-
-## 当前任务编排 / lifecycle 对应代码
-
-- `src/orchestrator/prepareLeadTurn.ts`: lead slice 开始前的 orchestrator 入口
-- `src/orchestrator/analyze.ts`: objective / complexity / handoff 意图判断
-- `src/orchestrator/taskPlanning.ts`: 最小任务图落盘
-- `src/orchestrator/taskLifecycle.ts`: 从 task / team / background / worktree 真相源派生 task lifecycle
-- `src/orchestrator/taskLifecycleShared.ts`: lifecycle 构造与 handoff 共享辅助
-- `src/orchestrator/progress.ts`: 读取 durable truth 并构造 progress snapshot
-- `src/orchestrator/route.ts`: 只消费 lifecycle 后的 ready / active / blocked 事实做 route
-- `src/orchestrator/dispatch.ts`: 派工落盘与 fail-closed handoff 检查
-- `src/tools/tasks/claimTaskTool.ts`: teammate claim + worktree fail-closed 入口
-
-## 当前文档 / 验证位置
-
-- `skills/web-research/SKILL.md`
-- `skills/browser-automation/SKILL.md`
-- `spec/modules/lightweight-context-runtime.md`
-- `spec/modules/session-resume-compact.md`
-- `spec/modules/runtime-metrics.md`
-- `tests/playwright-mcp.test.ts`
-- `tests/browser-tool-priority.test.ts`
-- `tests/playwright-workflow-guard.test.ts`
-- `tests/browser-workflow-abstraction.test.ts`
-- `tests/agent-closeout.test.ts`
-- `tests/interaction-shell.test.ts`
-- `tests/provider-capability.test.ts`
-- `tests/document-workflow-abstraction.test.ts`
-- `tests/acceptance-signal.test.ts`
-- `tests/one-shot-cli-result-contract.test.ts`
-- `tests/runtime-lightweight-context.test.ts`
-- `tests/runtime-checkpoint-resume.test.ts`
-- `tests/runtime-observability.test.ts`
-- `scripts/verify-runtime-lightweight-context-api.mjs`
-- `scripts/verify-runtime-checkpoint-api.mjs`
-- `scripts/verify-runtime-observability-api.mjs`
-- `validation/`

package/spec/interfaces/InteractionShell.md

@@ -1,93 +0,0 @@
-# InteractionShell
-
-## 作用
-
-`InteractionShell` 是共享交互控制层和具体外壳之间的正式边界。
-
-它让 Athlete 的交互 session loop 可以复用同一个大脑，同时替换 CLI、桌面等不同壳。
-
-## 当前真实能力
-
-### 参与者
-
-- `InteractiveSessionDriver`: 共享交互控制器
-- `InteractionShell`: 壳总接口
-- `ShellInputPort`: 输入端口
-- `ShellOutputPort`: 输出端口
-- `InteractionTurnDisplay`: turn 展示端口
-
-### 当前契约语义
-
-#### `ShellInputPort`
-
-负责：
-
-- 读取普通输入
-- 读取 multiline 输入
-- 绑定 interrupt 事件
-- 为共享 driver 提供退出确认时所需的普通输入
-
-不负责：
-
-- 决定 task / runtime 真相
-- 自己执行 agent turn
-
-#### `ShellOutputPort`
-
-负责：
-
-- 输出 `plain / info / warn / error / dim / heading / tool / interrupt`
-- 保持壳自己的展示风格
-
-不负责：
-
-- 修改 session 真相
-- 决定本地命令语义
-
-#### `InteractionTurnDisplay`
-
-负责：
-
-- 接收 turn 生命周期内的 `AgentCallbacks`
-- 展示流式 assistant / reasoning / tool 状态
-- 在 turn 结束或中断时 flush / dispose
-
-#### `InteractionShell`
-
-负责把上面三部分组装给共享 driver 使用。
-
-共享 driver 可以基于这套输入/输出契约实现：
-
-- 普通命令输入
-- multiline 输入
-- interrupt
-- quit 前二次确认
-
-## 当前 CLI 实现
-
-- `src/shell/cli/readlineInput.ts`
-- `src/shell/cli/output.ts`
-- `src/shell/cli/turnDisplay.ts`
-- `src/shell/cli/shell.ts`
-
-CLI 当前通过这些适配器接入：
-
-- `readline`
-- `process.stdin` / `process.stdout`
-- `chalk`
-- spinner / stream renderer
-
-这些都必须留在 CLI shell 内，不进入共享 driver。
-
-## 规则
-
-1. `InteractiveSessionDriver` 不能依赖 `readline`、stdio、`chalk`。
-2. shell 只能提供输入、输出和 turn 展示适配，不能把控制面状态偷搬到壳里。
-3. 本地命令的语义应落在共享交互层，shell 只负责把结果显示出来。
-4. interrupt 的来源可以因壳不同而不同，但共享 driver 的 abort 语义必须一致。
-
-## 未来方向
-
-- 桌面壳可以实现自己的 `ShellInputPort`，例如输入框提交、多行编辑器、停止按钮。
-- 桌面壳可以实现自己的 `ShellOutputPort` / `InteractionTurnDisplay`，例如富文本消息区和状态面板。
-- 未来如果出现 web / mobile 壳，也应优先复用这组契约，而不是复制一套 session loop。

package/spec/interfaces/ProviderAdapter.md

@@ -1,23 +0,0 @@
-# ProviderAdapter
-
-## 作用
-
-ProviderAdapter 把 Athlete 的请求发送到具体模型服务，并返回统一结果。
-
-## 最小职责
-
-- 接收消息数组
-- 接收模型名
-- 接收工具定义
-- 返回 assistant 文本、reasoning、tool calls
-- 对常见 provider 错误提供可恢复语义
-
-## 不负责
-
-- 任务拆分
-- 控制面状态判断
-- 工具执行
-
-## 稳定边界
-
-只要 adapter 还能提供统一输出，底层 provider 可以继续替换。

package/spec/interfaces/README.md

@@ -1,17 +0,0 @@
-# 接口契约
-
-这一组文档不追求把所有 TypeScript 细节抄一遍。
-
-它们只说明 Athlete 内核最关键的抽象边界：
-
-- provider adapter
-- runtime loop
-- session store
-- tool registry
-- interaction shell
-
-## 使用规则
-
-1. 接口文档写稳定边界，不写瞬时实现细节。
-2. 新能力优先问“该落在哪个接口”，再问“该落在哪个文件”。
-3. 如果某个改动让接口职责明显变混，优先拆接口。

package/spec/interfaces/RuntimeLoop.md

@@ -1,28 +0,0 @@
-# RuntimeLoop
-
-## 作用
-
-RuntimeLoop 负责驱动一个 turn，直到：
-
-- 完成
-- 暂停
-- yield
-- 报错
-
-## 最小职责
-
-- 组装请求上下文
-- 读运行时状态
-- 调模型
-- 执行工具
-- 处理 continuation / compact / verification
-
-## 不负责
-
-- 保存长期任务真相
-- 发明新工具
-- 实现具体业务流程
-
-## 下一阶段要求
-
-总指挥层可以成为 loop 的上游决策来源，但不能把 RuntimeLoop 变成一个巨大的业务文件。

package/spec/interfaces/SessionStore.md

@@ -1,22 +0,0 @@
-# SessionStore
-
-## 作用
-
-SessionStore 负责保存和恢复任务现场。
-
-## 最小职责
-
-- 创建 session
-- 追加消息
-- 保存 todo / verification / taskState
-- 加载既有 session
-
-## 不负责
-
-- 任务板真相
-- teammate roster
-- worktree 生命周期
-
-## 关键要求
-
-session 恢复不能破坏 Athlete 的耐跑能力。

package/spec/interfaces/ToolRegistry.md

@@ -1,21 +0,0 @@
-# ToolRegistry
-
-## 作用
-
-ToolRegistry 负责统一管理模型可见工具。
-
-## 最小职责
-
-- 返回工具定义
-- 按名称执行工具
-- 根据 mode / runtime 过滤工具集
-
-## 不负责
-
-- provider 请求
-- session 存储
-- 任务真相维护
-
-## 关键要求
-
-无论未来 tools、skills、MCP 怎么扩，模型看到的动作入口都要保持统一。

package/spec/modules/config-system.md

@@ -1,77 +0,0 @@
-# config system
-
-## 作用
-
-配置系统负责统一读取 Athlete 的运行参数，并把项目级默认值、用户配置和环境变量合并成最终 runtime config。
-
-## 当前范围
-
-- provider / API key / base URL / model
-- mode
-- paths
-- MCP 总开关与 server 配置
-- Playwright MCP repo 级默认值
-- context / continuation / read limits 等运行阈值
-
-## 当前规则
-
-1. 配置入口统一。
-2. 业务模块不直接散读环境变量。
-3. 用户能从 runtime config 理解当前行为从哪来。
-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 环境变量：
-
-- `ATHLETE_MCP_ENABLED`
-- `ATHLETE_MCP_PLAYWRIGHT_ENABLED`
-- `ATHLETE_MCP_PLAYWRIGHT_BROWSER`
-- `ATHLETE_MCP_PLAYWRIGHT_HEADLESS`
-- `ATHLETE_MCP_PLAYWRIGHT_OUTPUT_MODE`
-- `ATHLETE_MCP_PLAYWRIGHT_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 状态目录：
-
-- `.athlete/playwright-mcp/config.json`
-- `.athlete/playwright-mcp/profile/`
-- `.athlete/playwright-mcp/output/`
-- `.athlete/playwright-mcp/legacy-root-artifacts/`
-
-这些路径由配置系统和 `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

@@ -1,139 +0,0 @@
-# interactive terminal
-
-## 作用
-
-交互终端是 Athlete 的表现层外壳，不是控制面真相源。
-
-## 当前真实能力
-
-### 当前分层
-
-- `src/interaction/`: 共享交互控制层
-- `src/shell/cli/`: CLI shell 适配层
-- `src/ui/`: CLI 文本格式化、runtime summary 和兼容导出
-
-### 共享交互控制层职责
-
-- 驱动交互 session loop
-- 处理普通输入和 multiline 分支
-- 处理本地命令路由
-- 在 `quit / q / exit` 时检查当前项目仍在运行的后台进程，并做退出确认
-- 管理 turn in-flight 状态与 abort controller 生命周期
-- 接线 `runManagedAgentTurn`
-- 维护当前 session 的内存态，并在 turn 完成后接收最新 session
-
-### 当前 CLI shell 职责
-
-- 提供 persistent input / multiline input
-- 绑定终端 interrupt
-- 展示 assistant 流式输出
-- 展示 tool 调用和状态消息
-- 展示 banner、launch hints、dim/warn/plain/stderr 风格
-- 展示当前 session 的 runtime summary
-
-## 规则
-
-1. UI 不能反向定义 task、protocol、worktree、checkpoint、runtimeStats 等控制面事实。
-2. spinner、stream renderer、本地命令格式化都只属于表现层。
-3. Athlete 可以替换 UI，但不能因此破坏 runtime kernel。
-4. `/runtime`、`/stats`、`/仪表盘` 只是 `SessionRecord.runtimeStats` 的只读 summary 视图。
-5. UI 可以读取并展示真相源，但不能绕过真相源另造状态。
-6. 交互 session loop 不能直接绑死 `readline`、`process.stdin/stdout`、`chalk` 这类 CLI 细节。
-7. shell 只能提供输入、输出和 turn 展示适配，不能自己发明 task / protocol / runtime 真相。
-
-## Quit Boundary
-
-- `quit / q / exit` 不是“无条件立刻退出”。
-- 共享交互层会先检查当前项目仍在运行的后台进程：
-  - `background job`
-  - `teammate worker`
-- 如果没有运行中的后台进程：
-  - 直接退出会话
-- 如果有运行中的后台进程：
-  - 先把它们列出来
-  - 只允许两个结果：
-    - 确认退出：杀掉全部后台进程，再退出
-    - 取消退出：保持当前 CLI 和后台进程继续运行
-- kill 失败时必须 fail-closed：
-  - 不退出
-  - 明确告诉用户哪些 PID 还活着
-
-这个规则属于共享交互控制层，不属于单个 shell 外壳。
-## 当前本地命令入口
-
-- `/session`
-- `/config`
-- `/todos`
-- `/tasks`
-- `/team`
-- `/background`
-- `/worktrees`
-- `/inbox`
-- `/runtime`
-- `/stats`
-- `/仪表盘`
-- `/reset`
-
-## Runtime Summary 展示范围
-
-当前交互态最小 runtime summary 包含：
-
-- session health
-- model request count
-- model wait total
-- tool call count
-- tool duration total
-- yield / continuation / recovery / compression count
-- externalized result count / bytes
-- top tools
-
-## Reset Boundary
-
-- `/reset` 是显式 destructive local command，不是普通的窗口关闭动作。
-- `/reset` 清空当前项目 `.athlete/` 下的运行时状态，但保留 `.athlete/.env` 和 `.athlete/.env.example`。
-- `/reset` 还会删除当前项目相关的持久化 session，因此 `resume` 不应恢复已经 reset 掉的运行时。
-- `/reset` 会尽量先通过正式 worktree / process 清理路径收尾，再删除状态目录。
-- reset 行为必须落在 runtime / project state 层，UI 只能触发它，不能自己维护一套平行 reset 状态。
-
-## 当前边界
-
-### 共享边界
-
-- `InteractiveSessionDriver`: 共享交互控制器
-- `InteractionShell`: 壳适配接口
-- `ShellInputPort`: 普通输入 / multiline 输入 / interrupt 订阅
-- `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`: 共享本地命令语义
-- `src/interaction/exitGuard.ts`: 退出前后台进程检查与 kill-or-continue 语义
-
-## 当前展示边界
-
-交互终端当前只负责把这些状态展示清楚：
-
-- task board
-- teammate 状态
-- background 状态
-- skill load 状态
-- runtime summary
-
-但它不负责发明这些状态。
-
-交互终端当前还负责把退出确认展示清楚：
-
-- 哪些后台进程仍在运行
-- 用户当前是在“继续运行”还是“kill 后退出”的分支
-- kill 失败时哪些 PID 仍未退出
-
-## 未来方向
-
-- 桌面壳应直接实现 `InteractionShell` 契约，而不是复用 CLI 的 `readline` / stdio 细节。
-- 桌面壳可以自己提供输入框、停止按钮、流式消息区和状态面板。
-- 只要继续复用 `InteractiveSessionDriver`，桌面壳与 CLI 壳就应共享同一套本地命令、turn 驱动和中断语义。

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

@@ -1,80 +0,0 @@
-# lightweight context runtime
-
-## 目标
-
-这一层负责让 Athlete 在长任务里继续跑，但不要把 prompt 和 session 越跑越重。
-
-## 运行时约定
-
-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 外置化
-
-1. 当 tool output 超过约 `12,000` chars 或 `16 KB` 时，进入外置化路径。
-2. 原始 output 落盘到项目 state root 下：
-   - `.athlete/tool-results/<sessionId>/<timestamp>-<tool>-<hash>.json|txt`
-3. session 里保留的 tool message 只存轻量引用：
-   - `externalized: true`
-   - `storagePath`
-   - `summary`
-   - `preview`
-   - `byteLength`
-   - `charLength`
-4. 小结果继续走原来的 inline message 路径，不做无差别外置化。
-5. 当 agent 读取 `.athlete/tool-results/...` 中的 artifact 文件时，`read_file` 默认返回紧凑摘要视图；只有显式 line range 读取才继续走原始逐行查看路径。
-
-## 闭环要求
-
-1. continuation 继续使用 session 中的轻量 tool message，而不是重新塞回原始大正文。
-2. contextBuilder 在压缩历史时继续保留 `storagePath` 和预览信息。
-3. contextBuilder 产出的 prompt diagnostics 必须只存在于当次 request 构建结果里，不能写回 session。
-4. recovery 的 context shrink 也要保住结构化引用，不能把它打回不可追踪的大字符串。
-5. session 保存和加载后，外置化引用仍然可以恢复到落盘文件。
-6. 已通过 streaming delta 发出的 assistant 文本不会在 finalize 阶段再次整段重放。
-
-## 验证方式
-
-1. fail-first 测试：
-   - `tests/runtime-lightweight-context.test.ts`
-2. 核心回归：
-   - `npm run test:build`
-   - `npm run test:core`
-3. 真实 API：
-   - `npm run verify:runtime-context-api`
-## Checkpoint Runtime Contract
-
-- `SessionRecord` now persists a structured `checkpoint` inside the existing session truth source.
-- `checkpoint` is a runtime summary, not a transcript dump. It carries:
-  - objective
-  - completedSteps
-  - currentStep
-  - nextStep
-  - 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.
-- 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`