baa-conductor

T-S011.md

  1# Task T-S011：把 `status-api` 测试接入根验证入口
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S011.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/apps/status-api/package.json`
 10- `/Users/george/code/baa-conductor/apps/status-api/src/index.test.js`
 11- `/Users/george/code/baa-conductor/package.json`
 12- `/Users/george/code/baa-conductor/scripts/verify-workspace.mjs`
 13- `/Users/george/code/baa-conductor/docs/ops/repo-verification.md`
 14
 15## 当前基线
 16
 17- 仓库：`/Users/george/code/baa-conductor`
 18- 分支：`main`
 19- 提交：`097621a`
 20- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
 21
 22## 建议分支名
 23
 24- `chore/add-status-api-root-test`
 25
 26## 目标
 27
 28给 `status-api` 补稳定的包级 `test` 入口，并把它纳入根 `pnpm test`。
 29
 30## 背景
 31
 32- `status-api` 已经有 `apps/status-api/src/index.test.js`。
 33- 但包本身没有 `test` script，所以根验证入口刻意没有覆盖它。
 34- 这导致“根验证已成型，但状态面仍游离在根测试矩阵之外”。
 35
 36## 涉及仓库
 37
 38- `/Users/george/code/baa-conductor`
 39
 40## 范围
 41
 42- 给 `@baa-conductor/status-api` 增加稳定 `test` 脚本
 43- 把它接入根 `pnpm test`
 44- 更新验证文档说明覆盖范围
 45
 46## 路径约束
 47
 48- 优先复用现有 `apps/status-api/src/index.test.js`
 49- 不要把任务扩展成 `status-api` 架构重构
 50- 不要顺手改 `conductor-daemon` 或 `codexd`
 51
 52## 推荐实现边界
 53
 54建议优先做：
 55
 56- 为 `apps/status-api/package.json` 增加 `test`
 57- 如有需要，调整测试运行前置 build 方式
 58- 更新根验证脚本和 repo verification 文档
 59
 60## 允许修改的目录
 61
 62- `/Users/george/code/baa-conductor/apps/status-api/`
 63- `/Users/george/code/baa-conductor/package.json`
 64- `/Users/george/code/baa-conductor/scripts/`
 65- `/Users/george/code/baa-conductor/docs/ops/`
 66- `/Users/george/code/baa-conductor/docs/runtime/README.md`
 67
 68## 尽量不要修改
 69
 70- `/Users/george/code/baa-conductor/apps/conductor-daemon/`
 71- `/Users/george/code/baa-conductor/apps/codexd/`
 72- `/Users/george/code/baa-conductor/tasks/`
 73
 74## 必须完成
 75
 76### 1. 给 `status-api` 增加稳定测试入口
 77
 78- 包级 `pnpm --filter @baa-conductor/status-api test` 应可执行
 79- 测试不依赖人工交互或线上环境
 80
 81### 2. 纳入根测试矩阵
 82
 83- 根 `pnpm test` 应覆盖 `status-api`
 84- 失败点仍要能定位到具体包
 85
 86### 3. 回写文档
 87
 88- 更新根验证文档的覆盖范围
 89- 说明哪些检查仍未纳入根入口
 90
 91## 需要特别注意
 92
 93- 不要把根入口做成难以定位失败点的一串黑盒命令
 94- 如果 `status-api` 测试仍需要 build 前置，文档里要说明
 95- 与 repo residual 清理任务并行时，避免同时修改同一段总览文档
 96
 97## 验收标准
 98
 99- `@baa-conductor/status-api` 有稳定 `test` 入口
100- 根 `pnpm test` 覆盖 `status-api`
101- 文档已同步更新
102- `git diff --check` 通过
103
104## 推荐验证命令
105
106- `npx --yes pnpm -C /Users/george/code/baa-conductor -F @baa-conductor/status-api test`
107- `npx --yes pnpm -C /Users/george/code/baa-conductor test`
108- `git -C /Users/george/code/baa-conductor diff --check`
109
110## 交付要求
111
112完成后请说明：
113
114- 修改了哪些文件
115- `status-api` 的测试入口最终怎么组织
116- 根 `pnpm test` 现在新增覆盖了什么
117- 还有哪些检查仍未被根入口覆盖