文档先行：把 DirectProject 聊天真相源收敛的文档改到当前实现状态

- 主规范把事件模型写成 ts-rs 导出的 tagged enum，说明 seq 不下发、事件不带回合身份，并补上 ts 绑定生成与 f64 时间戳约定
- ADR 补上 tagged enum 绑定、turn id 删除、正文只增不减与回合回收、前端卡片去掉 turnId、未知类型前端丢弃
- 里程碑与实施计划同步：文件改名到 direct_thread_wire.rs，新增删回合身份与生成绑定两步，验证命令加上 export_bindings
- 工具卡片技术方案在文首加修订段：数据来源层作废，表现层契约仍然有效，DirectRuntime 的 tool-calls.jsonl 写入保留
- 对话回合唯一投影里程碑改为 superseded，列出仍然有效与已作废的分界

docs/project-memory/plans/【实施计划】DirectProject聊天真相源收敛-2026-09-16.md

@@ -8,28 +8,30 @@
 
 ## 修改边界
 
-- 允许修改：`agent/direct_thread_manager.rs`、`agent/direct_thread_raw_item.rs`、`agent/codex_app_server/`、`agent/direct_project_history.rs`、`main.rs` 命令注册、AGC 前端订阅与聊天投影、对应测试与 `docs/`。
+- 允许修改：`agent/direct_thread_wire.rs`、`agent/direct_thread_manager.rs`、`agent/codex_app_server/`、`agent/direct_project_history.rs`、`main.rs` 命令注册、`src/features/project-workspace/generated/`（ts-rs 生成目录）、AGC 前端订阅与聊天投影、对应测试与 `docs/`。
 - 明确不修改：SpacetimeDB schema 与绑定、HTTP/OpenAPI、DirectRuntime 自己的进度事件与 `turn-stream.jsonl` / `tool-calls.jsonl` 写入、Codex durable thread 行为、审批弹层现有状态来源。
 - 保持 `.env` 未提交修改，不触碰个人配置。
 
 ## 实现顺序
 
-1. Rust 只搬运：`agent/direct_thread_raw_item.rs` 把 Codex 原始条目挑字段、脱敏、截断后下发，事件载荷与历史切片同形，不生成卡片形状。
-2. 条目身份归一：`itemId = call_id ?? id`，同时从事件 envelope 与前端形状里删掉第二个 id 概念；历史切片的 `firstItemId` 继续取文件里的原始 item id。
-3. 思考正文流式：`item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta` 产出 `item.delta{kind:"reasoning"}`；plan 文本与命令输出保持活动状态。
-4. 前端收敛为单一 reducer：`subscribe` 返回的 bootstrap 事件就是已暂存的运行态，游标已经在队尾，前端直接 reduce 这批事件即可（不需要再补一次 `consume`）；此后只由 notify 唤醒 `consume`。合并规则只保留"先到定形、后到补空白"，并删掉 `deltaText` 缓冲与回合结束后的运行态残留。
-5. 首屏与分页：以 `lastCompletedItemId` 为锚点取最近切片，历史读取改为从文件尾反向扫描；锚点按原始 item id 推进，切片无可见条目时自动连拉（上限 5 页）。
-6. App.tsx 接线：订阅 + 立即 consume + notify 唤醒，聊天视图改由 reducer 状态投影（含工具卡片），删除 Direct 回合事件订阅与 `directTurnStream` / `directToolCalls` 状态。
-7. 删除只服务旧读路径的命令与前端调用（`read_direct_project_history`、`read_direct_turn_stream`、`read_direct_tool_calls`、`list_game_creator_direct_active_turns`），DirectRuntime 自己的写入保留。
-8. 测试与文档收口：补 reducer 单测、解锁跳过的工具卡片用例、更新主规范并把冲突的实施计划与工具卡片文档改写为当前状态。
+1. Rust 只搬运：`agent/direct_thread_wire.rs` 把 Codex 原始条目挑字段、脱敏、截断后下发，事件载荷与历史切片同形，不生成卡片形状；线上模型是 ts-rs 导出的 tagged enum（`DirectThreadItem` / `DirectThreadEvent` / bootstrap / consume / history slice），`at` 标 `#[ts(as = "f64")]`，改完模型跑 `cargo test export_bindings` 生成前端绑定。
+2. 条目身份归一：进队列前收敛成一个 `itemId`，事件 envelope 与前端形状里都不出现第二个 id 概念；历史切片的 `firstItemId` 继续取文件里的原始 item id。
+3. 删掉回合身份：`turn.started` 无载荷、`turn.completed{status}`，条目 / 增量 / 请求 / 生命周期锚点都不带 turn id；队列 `append` 直接收 `DirectThreadEvent`，`seq` 内部自算。
+4. 思考正文流式：`item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta` 产出 `item.delta{kind:"reasoning"}`；plan 文本与命令输出保持活动状态。
+5. 前端收敛为单一 reducer：`subscribe` 返回的 bootstrap 事件就是已暂存的运行态，游标已经在队尾，前端直接 reduce 这批事件即可（不需要再补一次 `consume`）；此后只由 notify 唤醒 `consume`。合并规则只保留"先到定形、后到补空白"（正文只增不减、工具状态允许从 running 升级到终态），`item.delta` 直接追加到运行态条目正文，删掉 `deltaText` 缓冲，`turn.completed` 把运行态条目并入历史再清空。
+6. 首屏与分页：以 `lastCompletedItemId` 为锚点取最近切片，历史读取改为从文件尾反向扫描；锚点按原始 item id 推进，切片无可见条目时自动连拉（上限 5 页）。
+7. App.tsx 接线：订阅 + 立即 reduce bootstrap + notify 唤醒 consume，聊天视图改由 reducer 状态投影（含工具卡片），删除 Direct 回合事件订阅与 `directTurnStream` / `directToolCalls` 状态。
+8. 删除只服务旧读路径的命令与前端调用（`read_direct_project_history`、`read_direct_turn_stream`、`read_direct_tool_calls`、`list_game_creator_direct_active_turns`），DirectRuntime 自己的写入保留。
+9. 测试与文档收口：补 reducer 单测、解锁跳过的工具卡片用例、更新主规范并把冲突的实施计划与工具卡片文档改写为当前状态。
 
 ## 验证命令
 
 1. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml direct_thread -- --nocapture`
-2. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directThreadEvents.test.ts`
-3. `npx vitest run apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
-4. TypeScript 类型检查与 ESLint（范围同前次 DirectProject 迁移）。
-5. `npm run check:encoding`、`npm run check:doc-index`、`git diff --check`
+2. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml export_bindings`（生成 `src/features/project-workspace/generated/`）
+3. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directThreadEvents.test.ts`
+4. `npx vitest run apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
+5. TypeScript 类型检查与 ESLint（范围同前次 DirectProject 迁移）。
+6. `npm run check:encoding`、`npm run check:doc-index`、`git diff --check`
 
 ## 风险与回滚点
 

docs/project-memory/plans/【里程碑】DirectProject聊天真相源收敛-2026-09-16.md

@@ -11,15 +11,16 @@
 
 AGC 项目开发对话的显示与恢复只依赖两项输入：**项目对话历史**（`.agent/conversations/project.jsonl`）与 **运行态事件**（Thread Manager `subscribe` / `consume` / `notify`）。Direct 回合事件、`turn-stream.jsonl`、`tool-calls.jsonl` 与活动回合快照都不再是聊天视图的输入。
 
-边界固定为：Thread Manager 只是**搬运层**——把 Codex 原始条目挑字段、脱敏、截断后下发；工具卡片的形状、可见性与合并全部由前端投影完成。条目身份只有一个：Rust 在进队列前归一到 `call_id ?? id`，不再暴露第二套 id 概念。
+边界固定为：Thread Manager 只是**搬运层**——把 Codex 原始条目挑字段、脱敏、截断后下发；工具卡片的形状、可见性与合并全部由前端投影完成。线上模型是 ts-rs 导出的 tagged enum（`agent/direct_thread_wire.rs`），条目身份只有一个：Rust 在进队列前归一成一个 `itemId`，不再暴露第二个 id 概念，也不带任何回合身份。
 
 ## 范围
 
 - 运行态事件自足化：`item.started` / `item.completed` 携带与历史切片同形的脱敏**原始条目**，前端用同一个投影函数处理实时与回读。
-- 条目身份归一：`itemId = call_id ?? id`（工具 item 的 app-server id 就是 `call_id`）；历史切片另给 `firstItemId` 作为分页锚点，锚点始终是文件里的原始 item id。
+- 线上模型与提示词同源：条目与事件是 ts-rs 导出的 tagged enum，前端消费生成绑定（改 Rust 模型后跑 `cargo test export_bindings`）；毫秒时间戳用 `#[ts(as = "f64")]` 对齐 Tauri JSON 通道的 `number`。
+- 条目身份归一：进队列前收敛成一个 `itemId`（工具条目在 `project.jsonl` 里带调用 id 与 response item id 两个值）；历史切片另给 `firstItemId` 作为分页锚点，锚点始终是文件里的原始 item id。
 - 思考正文流式：`item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta` 以 `item.delta{kind:"reasoning"}` 下发正文；plan 文本与命令输出仍只降级为活动状态。
 - 历史读取以 `subscribe` 返回的 `lastCompletedItemId` 为首屏锚点，切片从**文件尾反向扫描**；不可显示条目由前端跳过并继续取页（上限 5 页）。
-- 前端收敛为单一事件 reducer 与单一聊天投影；活动回合只由 `turn.started` 与 `turn.completed` 判定；回合结束后回收该回合运行态条目。
+- 前端收敛为单一事件 reducer 与单一聊天投影；活动回合只由 `turn.started` 与 `turn.completed` 判定（事件不带 turn id，前端只有一个 `turnRunning` 布尔）；`item.delta` 直接追加到运行态条目正文，不保留增量缓冲；`turn.completed` 把该回合运行态条目并入历史再清空。
 - 删除前端对 Direct 回合事件、`turn-stream.jsonl`、`tool-calls.jsonl`、活动回合快照的读取，以及只服务这些读取的命令与状态。
 
 ## 不在范围内
@@ -34,10 +35,12 @@ AGC 项目开发对话的显示与恢复只依赖两项输入：**项目对话
 
 - 投影在前端：Rust 不生成 `kind` / 标题 / 折叠摘要，也不做合并。
 - 合并只保留"先到定形、后到补空白"：第一次见到的快照决定卡片形状，后续快照只补输出与状态；不做逐字段优先级表。
-- 条目 id 只有一套：`call_id ?? id`；前端与 Thread Manager 都不再出现第二个 id。
+- 条目 id 只有一套：归一到 `itemId`；前端与 Thread Manager 都不再出现第二个 id。
+- 事件不带回合身份：`turn.started` 无载荷、`turn.completed{status}`；Thread Manager 的生命周期锚点、条目、增量与请求都不带 turn id。
 - 思考正文流式下发不放宽可见范围：被下发的就是此前已在 `item.completed` 展示、并已落进 `project.jsonl` 的同一段文本。
 - 失败与中止说明只在运行期显示（不写 `project.jsonl`），页面重进后不再出现。
-- 未知 item 类型由 Rust 原样透传（只有类型与身份），当前由前端投影丢弃。
+- 未知 item 类型由 Rust 原样透传（只有类型与身份，Rust 侧留 TODO），当前由前端投影丢弃。
+- 前端聊天卡片的工具形状是 `Omit<GameCreatorDirectToolCall, 'turnId'>`；`tool-calls.jsonl` 的持久化形状与 DirectRuntime 的写入保持不变。
 
 ## 依赖与前置条件
 
@@ -52,12 +55,13 @@ AGC 项目开发对话的显示与恢复只依赖两项输入：**项目对话
 - [ ] 进程存活期间的页面重进（含切走再切回）能恢复运行中回合，并允许终止。
 - [ ] 历史分页在切片内全部是不可显示条目时仍能继续向前，不出现锚点停滞。
 - [ ] 聊天视图不再读取 `turn-stream.jsonl` / `tool-calls.jsonl` / Direct 回合事件 / 活动回合快照；`read_direct_turn_stream`、`read_direct_tool_calls`、`list_game_creator_direct_active_turns` 不再被前端调用。
-- [ ] 同一工具调用在实时与回读各只出现一张卡片（跨 id 空间按归一身份对齐）。
+- [ ] 同一工具调用在实时与回读各只出现一张卡片（两个 id 空间按归一后的 `itemId` 对齐）。
+- [ ] 前端聊天状态里不再出现第二个 id 概念与任何回合身份字段；事件解析统一来自 ts-rs 生成绑定。
 - [ ] 思考正文在回合进行中即可见，且不进入活动状态文本。
 - [ ] 订阅过期后重新 `subscribe` 并原子替换状态，不重复渲染已完成的条目。
 
 ## 证据要求
 
-- 自动化：Thread Manager 事件契约测试、原始条目搬运与脱敏测试、聊天 reducer 单测（bootstrap / consume / 过期重订阅 / 残回合 / 先到优先合并）、历史分页锚点测试、前端渲染测试（含此前跳过的工具卡片用例）。
+- 自动化：Thread Manager 事件契约测试、原始条目搬运与脱敏测试、ts-rs 绑定生成（`cargo test export_bindings`）、聊天 reducer 单测（bootstrap / consume / 过期重订阅 / 残回合 / 先到优先合并 / 回合回收）、历史分页锚点测试、前端渲染测试（含此前跳过的工具卡片用例）。
 - 运行时：真实 app-server 会话下的新回合、杀进程重开、页面重进、分页与终止。
 - 边界：订阅过期、事件重复与乱序、不可显示切片、无 `turn.completed` 的残回合、工具输出超长截断与脱敏。

docs/project-memory/plans/【里程碑】对话回合唯一投影-2026-09-16.md

@@ -1,29 +1,32 @@
 # 对话回合唯一投影
 
-- Version: 2
-- Status: implemented-awaiting-runtime-acceptance
+- Version: 3
+- Status: superseded
 - Date: 2026-09-16
+- Superseded by: `../【里程碑】DirectProject聊天真相源收敛-2026-09-16.md`
 - Parent Spec: ../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
 
-## 范围与评审
+## 结论
 
-单里程碑修复回合展示和流写入的一致性；补充终态重进恢复、用户发送时间和完成后的过程折叠。评审确认：活动快照及 Direct 事件拥有生命周期，Provider 回放不创建 client 回合；JSONL 信封可选时间字段不污染原始 item，无须数据库或旧数据迁移；最终回复沿用 Runtime 的最后 assistant item 合同，失败提示不折叠。没有身份的旧记录不得做位置猜配。
+本里程碑原先把「回合唯一投影」落在 Direct 回合事件 + `turn-stream.jsonl` + `tool-calls.jsonl` + 活动回合快照这条读路径上，方向已被推翻：聊天视图的输入只剩**项目对话历史**与**运行态事件**两项，Direct 回合事件、`turn-stream.jsonl`、`tool-calls.jsonl`、活动回合快照都不再是聊天视图的输入。后续实现与验收一律以 `../【里程碑】DirectProject聊天真相源收敛-2026-09-16.md` 与 `docs/adr/【ADR】DirectProject对话历史单一事实源-2026-09-16.md` 为准。
 
-## 验收
+## 仍然有效的部分
 
-1. 一个 turn 只有一个呈现入口，用户消息不丢失。
-2. item 增量、完成、持久化和回读保持相同身份与固定顺序。
-3. 工具输入输出保留，重复快照不重复渲染。
-4. TypeScript、最小 Cargo 检查、编码和 diff 检查通过；用户要求不运行测试，实机新回合/重开/分页验收待确认。
-5. 已结束回合重进不显示提交中，真实运行回合可恢复；跨项目/新回合迟到快照无效。
-6. 用户消息时间可刷新恢复，旧无时间记录不造值；完成后中间正文和工具统一折叠，最终回复及失败提示保持可见。
+1. 一个回合只有一个呈现入口，用户消息不丢失；历史里带不了身份（没有 id）的旧记录不得做位置猜配。
+2. 同一 item 的增量、完成、持久化与回读使用同一个身份、同一个顺序；重复快照不重复渲染。
+3. 工具调用的输入与输出都保留，展开后仍显示「输入 / 输出」。
+4. 已结束回合重进不显示提交中；真实运行回合可恢复。
+5. 用户消息时间只来自条目自己的时间戳，旧无时间记录不造值；完成后中间正文与工具统一折叠，最终回复与失败提示保持可见。
+6. 失败与中止说明只在运行期显示，不写进 `project.jsonl`；页面重进后不再出现。
 
-依赖：既有项目历史和 v1 turn-stream / tool-calls DTO。未完成真实 UI 验收前不进入其它里程碑。
+## 已作废的部分
+
+- 由活动回合快照接管运行中回合：改为由 `subscribe` bootstrap 事件判定（事件序列里 `turn.started` 之后没有 `turn.completed` 即运行中）。
+- 按 `turnId` 归并回合并把工具卡片挂在回合上：事件与条目都不再带回合身份，前端只有一个 `turnRunning` 布尔，卡片形状去掉 `turnId`。
+- 用 `turn-stream.jsonl` 的 `seq` 决定文本与工具的交替顺序：改为按运行态事件顺序 + 历史文件顺序投影。
+- 前端订阅 `game-creator-direct-turn-update`：改为 `subscribe` + `notify` 唤醒 `consume`（bootstrap 的事件直接 reduce，不再补一次 `consume`）。
 
 ## 当前证据
 
-- 定向 TypeScript 类型检查、`cargo check --locked --bin genarrative-ai-game-creator-shell`、编码检查、文档索引检查、`git diff --check` 通过。
-- 已补充回合归属、分页、重复快照、无流回退及 writer 完成/切段、持久快照单调性/跨回合裁剪用例；按用户要求未执行测试，不能作为已通过凭证。
-- 静态自审确认视图只剩统一回合列表，不再存在 mapped/unmapped/live 三个回合流出口；失败提示使用稳定 failure 身份。
-- 真实新回合、历史重开、分页、失败/中断、工具展开输入输出仍待重启原生客户端后验收；仅本地提交，不推送。
-- 本次增量已完成生命周期来源收敛、信封发送时间和完成过程折叠；定向 TypeScript、ESLint、Cargo check、文档索引通过。新增时间幂等/旧记录、终态分类及内容分区用例但未运行；主页进入项目、重新发送/切项目竞态和自动折叠仍待原生实机验收，仅本地提交，不推送。
+- 里程碑版本的静态检查结论（TypeScript、Cargo、编码、文档索引、`git diff --check`）仍然成立；该增量按当时授权未运行测试。
+- 新路径的证据要求见 `../【里程碑】DirectProject聊天真相源收敛-2026-09-16.md` 的「验收标准」与「证据要求」，其中包含解锁此前跳过的工具卡片渲染用例。