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-09-10 14:41:16 +08:00
2026-08-18 20:29:14 +08:00
2026-09-03 20:29:50 +08:00
2026-08-27 21:44:04 +08:00
2026-09-10 22:26:02 +08:00
2026-09-10 18:21:09 +08:00
2026-09-10 21:28:22 +08:00
2026-08-15 00:28:59 +08:00
2026-09-09 11:15:30 +08:00
2026-09-03 12:04:35 +08:00
2026-08-21 23:49:13 +08:00
2026-08-12 18:27:28 +08:00
2026-08-20 02:09:36 +08:00
2026-08-11 19:28:48 +08:00
2026-08-11 19:28:48 +08:00
2026-09-10 14:41:16 +08:00
2026-09-03 10:42:56 +08:00
2026-09-09 23:09:48 +08:00
2026-09-01 18:23:28 +08:00
2026-09-04 14:13:34 +08:00
2026-09-03 20:00:08 +08:00
2026-09-03 20:29:59 +08:00
2026-09-09 15:18:06 +08:00
2026-08-29 15:31:13 +08:00
2026-08-21 01:28:17 +08:00
2026-09-03 12:04:35 +08:00
2026-09-07 23:51:10 +08:00
2026-09-01 23:05:26 +08:00
2026-09-07 23:51:06 +08:00
2026-09-03 17:32:04 +08:00
2026-09-09 15:18:06 +08:00
2026-08-11 11:16:36 +08:00
2026-09-09 15:18:06 +08:00
2026-09-03 12:04:35 +08:00
2026-09-04 20:28:35 +08:00
2026-09-02 10:55:03 +08:00
2026-09-04 22:08:02 +08:00
2026-09-03 12:04:35 +08:00
2026-08-18 18:05:01 +08:00
2026-08-22 22:50:13 +08:00
2026-09-04 22:08:02 +08:00
2026-08-23 02:50:37 +08:00
2026-08-16 23:35:57 +08:00
2026-08-16 23:35:57 +08:00
2026-08-29 15:31:08 +08:00
2026-09-03 12:04:35 +08:00
2026-09-03 10:42:56 +08:00
2026-09-03 10:42:56 +08:00
2026-08-16 23:35:57 +08:00
2026-08-12 01:16:20 +08:00
2026-08-24 17:54:33 +08:00
2026-09-02 21:43:34 +08:00
2026-09-01 16:01:34 +08:00
2026-09-09 15:18:06 +08:00
2026-09-03 12:04:35 +08:00
2026-08-15 15:05:06 +08:00
2026-09-01 16:01:34 +08:00
2026-09-03 12:04:41 +08:00
2026-08-13 10:26:57 +08:00
2026-09-02 23:15:19 +08:00
2026-09-06 21:53:49 +08:00
2026-08-24 12:05:14 +08:00
2026-08-23 22:02:47 +08:00
2026-09-09 15:18:06 +08:00
2026-09-03 10:42:56 +08:00
2026-09-03 12:04:35 +08:00
2026-09-09 15:18:06 +08:00
2026-08-18 01:22:28 +08:00
2026-09-03 12:04:35 +08:00
2026-08-18 01:22:28 +08:00
2026-09-10 14:41:16 +08:00
2026-09-03 19:59:00 +08:00
2026-09-03 10:32:34 +08:00
2026-09-02 10:27:43 +08:00
2026-08-14 14:53:03 +08:00
2026-09-03 12:04:35 +08:00
2026-08-22 23:19:17 +08:00
2026-09-09 15:18:06 +08:00
2026-09-03 20:00:08 +08:00
2026-08-16 23:35:57 +08:00
2026-09-09 15:18:06 +08:00
2026-08-16 23:35:57 +08:00
2026-09-03 19:59:00 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 15:18:06 +08:00
2026-08-16 23:06:44 +08:00
2026-08-21 00:48:16 +08:00
2026-09-08 21:21:30 +08:00
2026-09-06 23:46:46 +08:00
2026-09-03 10:00:13 +08:00
2026-09-09 23:09:48 +08:00
2026-09-06 10:37:53 +08:00
2026-08-13 01:39:59 +08:00
2026-09-03 12:04:35 +08:00
2026-09-09 15:18:06 +08:00
2026-09-02 23:20:17 +08:00
2026-08-16 16:24:28 +08:00
2026-09-09 11:15:30 +08:00
2026-09-03 19:59:00 +08:00
2026-09-03 12:04:35 +08:00
2026-09-09 15:18:06 +08:00
2026-09-10 17:13:21 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 11:15:30 +08:00
2026-09-09 11:15:30 +08:00
2026-09-09 11:15:30 +08:00
2026-09-09 11:15:30 +08:00
2026-09-03 20:00:08 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 11:15:30 +08:00
2026-08-22 15:34:05 +08:00
2026-09-03 12:04:35 +08:00
2026-08-13 09:06:55 +08:00
2026-09-03 12:04:35 +08:00
2026-09-02 21:43:34 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 15:18:06 +08:00
2026-09-09 15:18:06 +08:00
2026-08-26 21:40:32 +08:00
2026-09-03 12:04:35 +08:00
2026-08-29 15:49:35 +08:00
2026-08-27 21:44:32 +08:00
2026-09-09 13:37:08 +08:00
2026-09-03 12:04:24 +08:00
2026-08-16 16:37:11 +08:00
2026-08-21 01:28:17 +08:00
2026-09-09 14:29:44 +08:00
2026-09-09 11:15:30 +08:00
2026-08-24 01:36:29 +08:00
2026-08-20 18:28:57 +08:00
2026-08-21 01:28:17 +08:00