[SheathedSharp]

问题

up --wait 就绪超时后的清理只发送 groups.kill{only: [服务名]}，不带预期运行身份。A 判定旧运行超时、B 已重启出同名新运行时，A 随后的清理会把 B 的运行一起停掉。本次修复前该风险未动态复现；现在有确定性回归覆盖。

改动

• daemon：groups.kill 新增 expect_runs: [{service, run_id}]（与 only 互斥）。端口选择与 no-port 运行选择都只认指名的 run id；快照无法归属到运行、或 run 名与声明矛盾的行不选。字段不完整、服务未声明、同一服务重复出现均为调用方错误。新能力 groups.kill.expect_runs 随 daemon.hello 宣告。
• CLI：等待结果记录每个超时服务的 run id，清理改发 expect_runs。daemon 未宣告该能力时不发只带服务名的清理（会失败并说明超时运行仍在运行）；拿不到 run id 时同样拒绝。仅 skipped 且无 run id 的旧 daemon 才从状态行回填。
• 协议 schema 重新生成；docs/cli.md、docs/cli.zh.md、docs/agent/architecture.md 同步。

回归（先红后绿）

engine/internal/daemon/groups_kill_expect_test.go 用构造快照 + dry_run: true，不发送任何真实信号。修复前 TestTimeoutCleanupStopsOnlyTheRunItStarted/the_replacement_run_is_not_selected 失败：

cleanup selected the replacement run's listener: [{Host:localhost Port:19001 ... PID:424242 Name:api Method:sigterm OK:true}]

修复后通过；同一测试还覆盖“本次启动的 run 仍会被选中”。engine/internal/cmd/timeout_cleanup_test.go 覆盖请求携带 expect_runs、不带 only，以及旧 daemon / 无 run id 时拒绝清理。

验证（实际执行）

• go build ./...、go vet ./...、go test -count=1 -timeout=8m ./... 全绿
• go test -race 跑完整 scripts/race-packages.txt 清单，全绿
• python3 scripts/check_docs.py：6 对文档一致；python3 -m unittest discover -s scripts -p 'check_*_test.py'：52 项通过
• 隔离 HOME/BERTH_HOME 的真实 daemon 冒烟：
  • 正向：up --wait --wait-timeout 2s（10s 预算、服务不监听）→ 退出 1、failed/ready_timeout、last_exit exit 143，进程已回收
  • 替换场景：A 的 up --wait 等待中，B 用 oberth start -d --group smoke-demo --name api 起同名新运行；A 超时（run 75ee154a）后 B 的进程仍在，status 显示 running
  • 沙箱 daemon 已 stop，进程与临时目录已清理

未跑

• go test -tags integration ./internal/scenario/... 真实服务场景套件
• Windows 原生构建 / 服务场景
• Nightly / 发布门槛（完整 race + 真实服务场景）

🤖 Generated with Claude Code