[Grok/dsh 76] Ship 完整流程与恢复验证

[Blackman99]

Parent

#132

Ticket: 76

Status: ready-for-agent

User Stories: 67, 68（见父规格）

What to build

启用扩展的用户完成现有 Ship 从规划到实现的完整流程，遇到冲突、失败或中断仍可在一致状态下继续。

Acceptance criteria

• 保留已有阶段、确认、任务依赖、worktree 执行和持久化契约；底层实际代理仍由 dsh 执行。
• 以既有受控场景验证成功、冲突、取消、缺状态与恢复；未知副作用不能自动宣称完成。
• 完整流程期间终端、浏览器图和恢复后的状态一致，使用真实浏览器检查共享状态路由与桌面/移动视口。
• 不依赖与既有 Ship 无关的新 Goal/Rhai；不改变默认界面键位或将扩展重新变成核心必需品。

Blocked by

• [Grok/dsh 42] Git worktree 隔离与结果应用 #174 — Ticket 42: Git worktree 隔离与结果应用
• [Grok/dsh 63] Ship 可选安装与首阶段接入 #195 — Ticket 63: Ship 可选安装与首阶段接入
• [Grok/dsh 64] Ship 浏览器图与终端一致性 #196 — Ticket 64: Ship 浏览器图与终端一致性

Delivery contract

用户于2026-09-20批准当前测试与任务拆分。按父规格的已安装产物/真实终端和公开协议测试验收；实际实现须带适用的文档、Changeset及必要检查。ready-for-agent表示任务已定义，不表示前置任务已完成，也不授权自动开始本轮实施、购买付费资源或发布软件版本。

[Blackman99]

集成结果

• 提交：7ba4372
• 快进推送：rewrite/grok-dsh-20260920 287ee62..7ba4372（仅 fast-forward，无强推）
• Rebase：基于 493c0e2 开发，rebase 到最新分支（含 [Grok/dsh 72] 插件 MCP 贡献接入 #204 99ebc6a、[Grok/dsh 65] 用量、费用与跨入口统计 #197 5f48970、3f072be 移除 scripts/__pycache__、[Grok/dsh 62] 会话副本迁移与回退 #194 287ee62），无冲突；双方新增内容（rust/src/plugin.rs、rust/src/main.rs、mock、README.zh）均保留，提交内无 .pyc。

实现

• 新增 packages/bundle/src/ship-extension-runner.ts：在 Hook 边界跑完旧版 /ship 全流程，实际代理全部由 dsh 执行。
  • Stop 作为阶段循环：合法前进的 Status 变化（或 wayfinder/grill 的人工回答）后，用下一阶段约定续跑当前轮（shipContinuationFor，受 Hook 运行器 8 次续跑上限约束）。
  • PreToolUse 自动确认 gate 1/2（封存 Mission Contract）与 gate 2/2；封存后 Edit 形式的闸门写入 ## Blocker。
  • 落地：Stop 认领无阻塞 ticket（ship: claim landing:N + .scratch/<slug>/landing/ 简报），父代理一步内按 ticket 调用 isolation: "worktree" 子代理并行执行；每个 PostToolUse 结果按 Ready-set 串行 merge --no-ff、移除 worktree、Proof: green、勾选提交。冲突沿用旧版 ship-conflict 校验，最多三次，之后快照、中止并写 ## Blocker。
  • 最终验证独立一轮；Status: shipped 后检查计划、Blocker 与封存验收证据，再合并回 Original-Branch（fast-forward，否则 squash + 同一解决流程）。
  • 失败/取消的子代理绝不合并或勾选；/ship 可从任意阶段恢复；认领但无结果的 ticket 带提示（含保留的 worktree 路径）重新派发，两次无结果则停止；封存合约缺失/损坏则停止且不重编译；运行状态丢失时从文件重建；取消遗留的进行中冲突会回滚后重合并。
• hooks.json 增至 7 个 Hook（新增 PreToolUse ask_user_question、PostToolUseFailure subagent、Stop）；插件仍为可选，未改默认键位，不使用 Goal/Rhai。
• 修复两处真实问题（完整 PTY 流程中发现）：
  • rust-acp-hooks.mjs：取消时被杀的 Hook 或不读 stdin 就退出的 Hook 会触发未处理的 EPIPE，导致整个 dsh 退出（"ACP connection ended"）。现已忽略该错误，并有回归测试（修复前可复现）。
  • Rust 客户端 live_message_turn：Stop 续跑的模型调用有新的 messageId，其文本此前被丢弃不显示；现归入运行中的回合，并有单测。
• 新 mock ship-full 模式与 scripts/rust-ship-full-pty-test.py；rust-ship-pty-test.py 第 6 步由“拒绝后续阶段”改为“在 grill 恢复”。文档：扩展 README、README/README.zh、CONTEXT、CONTRIBUTING；Changeset rust-ship-full-flow.md（codsh-cli、codsh-bundle patch）。

检查（rebase 后、干净环境）

• pnpm run typecheck：通过。
• pnpm test -- --testTimeout=60000：102 文件通过、2 跳过；2579 通过 / 15 跳过 / 1 失败——rust-monitor.spec 忙碌回合批处理的时序抖动，单独重跑两次均 28/28 通过（前一轮全量运行中该用例通过）。另：在重建 debug 二进制前 rust-plugin-mcp.spec（[Grok/dsh 72] 插件 MCP 贡献接入 #204）因旧二进制失败，cargo build 后 2/2 通过。新 ship-extension-runner.spec 12/12。
• cargo build --workspace：通过；cargo test --workspace --no-fail-fast：1708 通过、4 失败（均为已知：2 个 filesystem_sandbox、privacy::drafts_stay_local…、voice::substitute_route…）；cargo fmt --check：通过；clippy -D warnings -A dead_code -A clippy::needless_return：通过。
• pnpm run build:rust：通过。
• PTY：rust-ship-pty-test.py、rust-ship-web-pty-test.py、rust-plugin-content-pty-test.py、新 rust-ship-full-pty-test.py 全部通过（后者 rebase 前另连续两次通过）；受客户端改动影响的 rust-queue、rust-background、rust-monitor PTY 通过；rust-turn/rust-cancel/rust-hook PTY 为仅 macOS 脚本，未运行。
• 旧版 e2e：pnpm run build 后 e2e/pty-ship*.e2e.ts 4 文件 14 用例通过。
• 完整流程 PTY 截图（agent-browser + Chrome，1440×900 与 390×844）：开始、shipped、停止、恢复四个状态，浏览器与终端状态行一致。

未验证 / 已知差异

• 仅 mock 模型；真实付费模型未运行。
• macOS 与 Windows 未验证（仅 Linux）。
• 旧版 Alignment Gate 与漂移扫描未移植（已在文档中说明）。
• 终端中较长回合的回答块超过预览行数后按客户端既有规则折叠（→ 展开）；测试对后续阶段回复以请求轨迹核对，对前两个阶段回复核对终端实际绘制。
• Ctrl+C 会取消整批并行子代理（dsh 在整批返回后才报告），因此已在 worktree 中完成但未回报的 ticket 也不会被合并，worktree 保留供审阅。

main/npm/#213 未改动。

后续

本票是 #211（完整对齐审计）的前置之一；#211 仍被其他未关闭任务阻塞，本票关闭后没有直接解除阻塞的后续任务。