Menghuan1918
7f2674ab70
docs+test: 对齐等待 banner 的注释/设计口径并钉住 skip-wait 的 404 契约
v0.19.0 发版前 review 发现两处「文档与实现互相矛盾」（均不改运行时行为）：
- use-host-feeds.ts 的 effect 注释仍写「terminal tab 类型禁用时 pushes are
ignored」，而 mirrorAgentWaits 恰恰改成了不忽略（只跳过 tab 增删 reconcile）。
注释改为如实描述；
- 设计文档 §1 写「轮询每圈优先检查 skipped」，实现是 aborted → exited →
skipped。维持实现现状（pty 已死是客观事实，两种顺序下用户可见结果——banner
消失 / skipWait 归零 / 等待结束——完全相同，只有 kind 文案不同），设计原文
同步为「退出优先」，并在实施偏差记录写清未采纳「用户意图优先」的理由与日后
改动点；
- src/index.ts 的 agent-pty.skip-wait 注释把「无活动等待 → 0」泛化成了
「幂等」，收窄为「无活动等待返回 {skipped:0}；未知 uuid 走 expect → 404，
客户端 .catch 容忍并等下一次推送收敛」。
另把 skipWait 未知 uuid 的既有断言从「只校验 /not found/ 文案」升级为
「SidebarError + status 404 + code not-found」——HTTP 层 writeError 直接把
status 映射成响应码，此前这条契约没有测试守护（把 404 改成 410 时新断言即
失败，已验证）。
验证：pnpm test 126 files / 1312 passed / 0 failed，tsc --noEmit 与 eslint
均 exit 0；改动面仅 5 个文件，src/client/service.ts、builtins/ 与
external-plugin-guide.md 继续零改动。
2026-09-10 22:26:02 +08:00
..
2026-08-10 16:46:01 +08:00
2026-08-16 19:14:57 +08:00
2026-08-10 16:46:01 +08:00
2026-08-10 16:46:01 +08:00
2026-08-21 21:39:59 +08:00
2026-08-16 23:35:57 +08:00
2026-08-20 02:09:36 +08:00
2026-08-13 10:26:57 +08:00
2026-08-18 01:22:28 +08:00
2026-09-02 23:26:04 +08:00
2026-08-12 23:04:30 +08:00
2026-08-14 23:04:25 +08:00
2026-08-17 00:06:20 +08:00
2026-08-18 10:50:30 +08:00
2026-08-14 14:53:03 +08:00
2026-08-22 19:10:02 +08:00
2026-08-15 15:05:06 +08:00
2026-08-18 23:23:17 +08:00
2026-08-18 01:22:28 +08:00
2026-08-19 04:04:44 +08:00
2026-09-02 23:37:40 +08:00
2026-08-21 01:28:17 +08:00
2026-09-06 00:59:03 +08:00
2026-09-04 20:28:35 +08:00
2026-08-24 01:19:43 +08:00
2026-08-23 22:02:47 +08:00
2026-08-24 00:59:27 +08:00
2026-09-03 09:56:31 +08:00
2026-08-26 21:40:32 +08:00
2026-08-26 18:21:43 +08:00
2026-08-29 15:49:19 +08:00
2026-09-02 23:13:57 +08:00
2026-09-01 16:07:33 +08:00
2026-09-03 21:21:22 +08:00
2026-09-04 22:08:02 +08:00
2026-09-06 23:48:25 +08:00
2026-09-08 00:04:25 +08:00
2026-09-08 22:20:15 +08:00
2026-09-08 21:21:29 +08:00
2026-09-10 17:13:32 +08:00
2026-09-10 22:26:02 +08:00
2026-09-09 13:15:49 +08:00
2026-09-10 17:13:32 +08:00
2026-09-10 14:54:19 +08:00