补首屏历史锚点的实现证据，里程碑验收那条转成已验收

证据要求新增「首屏锚点（已跑）」一条：Rust 22 条、闸门单测 10 条、appSurface 全量 475/457/17 与唯一既有失败的对照结论
里程碑验收「首屏边界只认订阅回执」那条打勾，并写明两处变异验证现象
决策记录把「验证方式（待跑）」改成已跑的实跑结果与变异验证结论

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

@@ -56,7 +56,7 @@ AGC 项目开发对话的显示与恢复只依赖两项输入：**项目对话
 - [ ] 回合进行中终止并重启进程后重进项目：已落盘的部分文本与工具卡片按原顺序出现，且界面不显示忙碌态。【待真实 app-server 运行时验收】
 - [ ] 进程存活期间的页面重进（含切走再切回）能恢复运行中回合，并允许终止。【待真实 app-server 运行时验收】
 - [x] 历史切片从文件尾反向回扫，锚点始终是文件里的原始 item id；切片内全部是不可显示条目时仍能继续向前，不出现锚点停滞。【自动化：`direct_project_history` 尾部回扫与分页锚点用例】
-- [ ] 首屏切片的新端边界是 `subscribe` 回执里的 `lastCompletedItemId`（含该条）：比它更新的条目只从运行态事件来；锚点缺失时按文件尾取尾屏，订阅回执到达前不发首屏请求。【自动化：`direct_project_history` 锚点用例 + 首屏 `throughItemId` 的 appSurface 用例】
+- [x] 首屏切片的新端边界是 `subscribe` 回执里的 `lastCompletedItemId`（含该条）：比它更新的条目只从运行态事件来；锚点缺失时按文件尾取尾屏，订阅回执到达前不发首屏请求。【自动化：`cargo test agent::direct_project_history` 22 条（含 `through_item_id` 锚点用例）+ `directHistoryAnchorGate.test.ts` 10 条 + `project-development.suite.ts` 的 `anchors the first history page at the subscribe receipt instead of the file tail`（变异验证见下）】
 - [x] 前端一次翻页操作自动连拉，直到合并后聊天投影出现新回合或 `hasMore=false`，每个操作上限 5 页；锚点不前进时立即停止，不空转。【自动化：`directHistoryPaging.test.ts` 8 条 + `project-development.suite.ts` 跨页同回合用例（变异验证见下）】
 - [x] 聊天视图不再读取 `turn-stream.jsonl` / `tool-calls.jsonl` / Direct 回合事件 / 活动回合快照；`read_direct_turn_stream` 与 `read_direct_tool_calls` 命令已删除。`list_game_creator_direct_active_turns` **有意保留**：它服务首页跨页面的「运行中的项目」列表（`WorkspaceLauncher` / `directActiveTurns.ts`），不属于聊天框读路径。
 - [x] 同一工具调用在实时与回读各只出现一张卡片（两个 id 空间按归一后的 `itemId` 对齐）。【自动化：reducer「先到定形、后到补空」合并单测 + 工具卡片渲染用例】
@@ -69,6 +69,7 @@ AGC 项目开发对话的显示与恢复只依赖两项输入：**项目对话
 
 - 自动化（已跑）：`cargo test direct_thread`（25 条）、`cargo test direct_project_history`（20 条）、`cargo test export_bindings`（生成绑定与工作区无差异）、`NODE_OPTIONS=--localstorage-file=… npx vitest run apps/ai-game-creator-shell/tests`（125 files / 1676 passed / 17 skipped）、`npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`（exit 0）、ESLint 与 `prettier`。
 - 自动化（分页连拉，已跑）：`npx vitest run apps/ai-game-creator-shell/tests/directHistoryPaging.test.ts`（8 passed）、`npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`（470 tests / 453 passed / 17 skipped，含新增的 `keeps pulling earlier pages while the page only deepens the rendered turn`）、`npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`（exit 0）。变异验证：把停止判据退化成「这一页有可渲染条目就停」后，跨页用例以 `Unable to find an element with the text: 更早的用户提问` 变红，即用户报的「点了没变化」。
+- 自动化（首屏锚点，已跑）：`cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml agent::direct_project_history`（22 passed）、`npx vitest run apps/ai-game-creator-shell/tests/directHistoryAnchorGate.test.ts`（10 passed）、`npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`（475 tests / 457 passed / 17 skipped，含新增的 `anchors the first history page at the subscribe receipt instead of the file tail`）、`npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`（exit 0）、ESLint / prettier / `npm run check:encoding` / `npm run check:doc-index` / `git diff --check`。同一次全量里唯一失败是既有的 `edits the published runtime config without leaking API keys into chat`（`appSurface/runtime-settings.suite.ts`），与本次改动无关：把本次前端改动 stash 掉后它同样变红。变异验证：① 锚点闸门忽略「已消费」后，`directHistoryAnchorGate.test.ts` 的「同项目已消费返回 null」变红；② 首屏不等闸门后，`anchors the first history page at the subscribe receipt instead of the file tail` 以 `throughItemId` 缺失变红。
 - 运行时（待补）：真实 app-server 会话下的新回合、杀进程重开、页面重进、分页与终止。
 - 边界：订阅过期、回执竞态、不可显示切片、无 `turn.completed` 的残回合、工具输出超长截断与脱敏。
 - 环境注意：`rehype-highlight` 已装齐后 `ChatMarkdownMessage` / `AgentMessageContent` 转绿；Node 26 下 vitest 的 jsdom 用例需要 `--localstorage-file` 才能拿到 `window.localStorage`（`clientApi.test.ts` / `chatPromptPolish.test.tsx`），已记入 `docs/project-memory/shared-memory/pitfalls.md`。

docs/project-memory/shared-memory/decision-log.md

@@ -10,7 +10,7 @@
 - 决策（读取时机）：订阅回执到达之前不读首屏，也不退化成「取文件尾」；锚点缺失（订阅不可用 / 失败 / 历史为空）时才按文件尾取尾屏。`/history` 手动重读保持「按当前文件尾取尾屏」的恢复语义，不锚定。
 - 决策（翻页不变）：向后翻页仍用切片返回的 `firstItemId` 作 `beforeItemId`（不含锚点），`hasMore` 与连拉口径不变。
 - 影响范围：`agent/direct_project_history.rs`（切片锚点 + `through_item_id` 参数）、`commands.rs`（`read_direct_project_history_slice` 命令参数）、AGC 前端首屏读取接线与测试骨架。**未改**：DirectRuntime 的 `turn-stream.jsonl` / `tool-calls.jsonl` 写入与进度事件、`list_game_creator_direct_active_turns`、SpacetimeDB 与 HTTP 契约。
-- 验证方式（待跑）：Rust 侧 `direct_project_history` 定向用例（含锚点、排除更新的条目、锚点缺失报错）、前端首屏 `throughItemId` 的 appSurface 用例。
+- 验证方式（已跑）：Rust 侧 `cargo test agent::direct_project_history`（22 passed，含「窗口取到锚点那条、排除比锚点更新的条目、`beforeItemId` 与 `throughItemId` 互斥报错」三类用例）；前端 `npx vitest run .../directHistoryAnchorGate.test.ts`（10 passed）与 appSurface 的 `anchors the first history page at the subscribe receipt instead of the file tail`（全量 475 tests / 457 passed / 17 skipped；唯一失败 `edits the published runtime config without leaking API keys into chat` 与本次改动无关，stash 掉本次前端改动后同样变红）；`tsc` / ESLint / prettier / `check:encoding` / `check:doc-index` / `git diff --check` 全绿。变异验证：闸门忽略「已消费」、首屏不等闸门两处改动各自让对应用例变红。
 - 关联文档：[ADR](../../adr/【ADR】DirectProject对话历史单一事实源-2026-09-16.md)、[里程碑](../plans/【里程碑】DirectProject聊天真相源收敛-2026-09-16.md)、[实施计划](../plans/【实施计划】DirectProject聊天真相源收敛-2026-09-16.md)。
 
 ## 2026-09-17 `agc_tools` 媒体资源提示词上限收敛为单一口径，并按 kind 暴露给模型