baa-conductor

T-S024.md

  1# Task T-S024：回写文档、补 smoke 并同步主线状态
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S024.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/plans/archive/FIREFOX_BRIDGE_CONTROL_REQUIREMENTS.md`
 10- `/Users/george/code/baa-conductor/plans/archive/BROWSER_BRIDGE_PERSISTENCE_REQUIREMENTS.md`
 11- `/Users/george/code/baa-conductor/tasks/archive/T-S021.md`
 12- `/Users/george/code/baa-conductor/tasks/archive/T-S022.md`
 13- `/Users/george/code/baa-conductor/tasks/archive/T-S023.md`
 14- `/Users/george/code/baa-conductor/README.md`
 15- `/Users/george/code/baa-conductor/docs/api/README.md`
 16- `/Users/george/code/baa-conductor/docs/firefox/README.md`
 17- `/Users/george/code/baa-conductor/plugins/baa-firefox/README.md`
 18
 19## 当前基线
 20
 21- 仓库：`/Users/george/code/baa-conductor`
 22- 分支：`main`
 23- 提交：`0f218b9`
 24- 开工要求：如需新分支，从当前 `main` 新切
 25
 26## 当前状态
 27
 28- `已完成（2026-03-26）`
 29
 30## 建议分支名
 31
 32- `docs/browser-agent-surface-finalize`
 33
 34## 目标
 35
 36在 `T-S021`、`T-S022`、`T-S023` 完成后，把正式文档、smoke 和任务状态视图同步到新的浏览器桥接主模型。
 37
 38## 背景
 39
 40浏览器桥接主线一旦完成实现，文档必须统一到：
 41
 42- 两层 describe：`business/control`
 43- 通用 browser request/cancel
 44- 插件管理类动作
 45- 正式 SSE
 46- 空壳页和持久化登录态模型
 47
 48否则后续 AI 调用方仍会按旧的 Claude 专用路径或页面对话模型理解系统。
 49
 50## 涉及仓库
 51
 52- `/Users/george/code/baa-conductor`
 53
 54## 范围
 55
 56- 更新 README 和 docs
 57- 更新 browser smoke 或等价回归检查
 58- 同步 tasks / plans 状态
 59
 60## 路径约束
 61
 62- 本任务默认在 `T-S021`、`T-S022`、`T-S023` 基础上收尾
 63- 不再大改核心协议或数据库模型
 64- 如需补 smoke 钩子，只做最小补充
 65
 66## 推荐实现边界
 67
 68建议优先做：
 69
 70- README 与 docs 收口
 71- smoke 覆盖通用 browser request/SSE
 72- 清理旧文案里的“页面对话主能力”表述
 73- 同步 `tasks/`、`plans/` 状态
 74
 75## 允许修改的目录
 76
 77- `/Users/george/code/baa-conductor/README.md`
 78- `/Users/george/code/baa-conductor/docs/`
 79- `/Users/george/code/baa-conductor/plugins/baa-firefox/README.md`
 80- `/Users/george/code/baa-conductor/tests/browser/`
 81- `/Users/george/code/baa-conductor/tasks/`
 82- `/Users/george/code/baa-conductor/plans/`
 83
 84## 尽量不要修改
 85
 86- `/Users/george/code/baa-conductor/apps/conductor-daemon/`
 87- `/Users/george/code/baa-conductor/plugins/baa-firefox/controller.js`
 88- `/Users/george/code/baa-conductor/packages/db/`
 89
 90## 必须完成
 91
 92### 1. 回写正式口径
 93
 94- 文档明确只有 `business/control` 两层 describe
 95- 文档明确通用 browser request/cancel 和 SSE 是正式能力
 96- 文档明确 Claude 专用路径是兼容包装或 legacy
 97
 98### 2. 更新 smoke / 验收说明
 99
100- smoke 覆盖：
101  - 通用 browser request
102  - 正式 SSE
103  - 插件管理动作
104  - 凭证不泄露
105  - legacy Claude wrapper 兼容
106
107### 3. 同步任务状态
108
109- `tasks/` 和 `plans/` 里的当前 TODO 状态与新任务进度一致
110- 不让旧 backlog 看起来像当前主线
111
112## 需要特别注意
113
114- 不要让 README 和 docs 再出现第三层 browser describe
115- 不要模糊：
116  - AI-facing Agent Surface
117  - Firefox Bridge Protocol
118  - 本地空壳页 runtime
119- 如果文档口径和实际实现不一致，以实际实现为准，再回写文档和 smoke
120
121## 验收标准
122
123- README / docs 与新正式模型一致
124- smoke 与新正式模型一致
125- tasks / plans 状态同步
126- `git diff --check` 通过
127
128## 推荐验证命令
129
130- `node --test /Users/george/code/baa-conductor/tests/browser/browser-control-e2e-smoke.test.mjs`
131- `pnpm -C /Users/george/code/baa-conductor smoke`
132- `git -C /Users/george/code/baa-conductor diff --check`
133
134## 交付要求
135
136完成后请说明：
137
138- 修改了哪些文档和 smoke
139- 正式口径现在如何表述
140- 哪些旧文案被删除、降级或标为 legacy
141- 跑了哪些验证
142- 还有哪些残余风险
143
144## 当前残余风险
145
146- 为满足现有 runtime smoke 前置条件，本机仓库根已补空目录：
147  - `state/`
148  - `runs/`
149  - `worktrees/`
150  - `logs/launchd`
151  - `logs/codexd`
152  - `tmp/`
153- 这些目录不是 git 跟踪改动，而是当前脚本和本机运行环境前提。
154- 真实 Firefox 手工 smoke 仍未执行，因此“手动关 tab -> `tab_restore` -> WS 重连后状态回报”的浏览器端闭环还没实测。
155- `shell_runtime` 和 richer 的插件动作结果合同仍未接入 `conductor`，但它们已降为后续增量，不再算当前主线 blocker。