baa-conductor

T-S010.md

  1# Task T-S010：补仓库根验证入口
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S010.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/package.json`
 10- `/Users/george/code/baa-conductor/apps/conductor-daemon/package.json`
 11- `/Users/george/code/baa-conductor/apps/codexd/package.json`
 12- `/Users/george/code/baa-conductor/apps/status-api/package.json`
 13- `/Users/george/code/baa-conductor/packages/host-ops/package.json`
 14- `/Users/george/code/baa-conductor/packages/db/package.json`
 15- `/Users/george/code/baa-conductor/docs/runtime/README.md`
 16
 17## 当前基线
 18
 19- 仓库：`/Users/george/code/baa-conductor`
 20- 分支：`main`
 21- 提交：`d1c9090`
 22- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
 23
 24## 建议分支名
 25
 26- `chore/add-root-verification-entrypoints`
 27
 28## 目标
 29
 30把仓库根的 `pnpm lint` / `pnpm test` 从占位脚本改成真实、可重复执行的验证入口。
 31
 32## 背景
 33
 34- 当前根 `package.json` 里的 `lint` 和 `test` 只是 `echo TODO`。
 35- 实际仓库已经有不少稳定可跑的包级 `build` / `typecheck` / `test`，但缺少统一入口。
 36- 这会让协作者不知道“在根目录该跑什么”，也让主线验收口径分散在聊天记录里。
 37
 38## 涉及仓库
 39
 40- `/Users/george/code/baa-conductor`
 41
 42## 范围
 43
 44- 让根 `pnpm lint` / `pnpm test` 成为真实入口
 45- 如有必要，新增少量 helper 脚本收口验证矩阵
 46- 写清这两个入口覆盖什么、不覆盖什么
 47
 48## 路径约束
 49
 50- 优先复用现有包级脚本，不要大范围改包内部测试逻辑
 51- 不要引入重量级新 lint 框架，除非确有必要且收益明确
 52- 这个任务是“入口收口”，不是“给全仓新增 ESLint/Prettier/CI 平台”
 53
 54## 推荐实现边界
 55
 56建议优先做：
 57
 58- 把根 `test` 收口到当前稳定的关键包测试矩阵
 59- 把根 `lint` 改成真实的仓库级静态检查或 repo-hygiene 检查
 60- 在文档里说明根入口的覆盖范围和刻意不覆盖的部分
 61
 62## 允许修改的目录
 63
 64- `/Users/george/code/baa-conductor/package.json`
 65- `/Users/george/code/baa-conductor/scripts/`
 66- `/Users/george/code/baa-conductor/docs/ops/`
 67- `/Users/george/code/baa-conductor/docs/runtime/README.md`
 68
 69## 尽量不要修改
 70
 71- `/Users/george/code/baa-conductor/apps/status-api/`
 72- `/Users/george/code/baa-conductor/apps/codexd/`
 73- `/Users/george/code/baa-conductor/apps/conductor-daemon/`
 74- `/Users/george/code/baa-conductor/tasks/`
 75
 76## 必须完成
 77
 78### 1. 去掉根占位脚本
 79
 80- 根 `pnpm lint` 不能再只是 `echo`
 81- 根 `pnpm test` 不能再只是 `echo`
 82
 83### 2. 让入口可重复执行
 84
 85- 默认在干净仓库即可运行
 86- 不依赖人工交互或线上环境
 87
 88### 3. 写清覆盖边界
 89
 90- 说明根入口覆盖哪些包或脚本
 91- 说明哪些更慢或更特殊的验证仍需单独跑
 92
 93## 需要特别注意
 94
 95- 不要把“根入口”做成超长、脆弱、难维护的一串命令
 96- 尽量让失败点可定位，不要只给一个笼统失败
 97- 与 runtime 命名收口任务并行时，避免同时改同一段 runtime 文档
 98
 99## 验收标准
100
101- 根 `pnpm lint` / `pnpm test` 都是可执行的真实检查
102- 文档已说明这两个入口的覆盖范围
103- 相关命令在当前主线可跑通
104- `git diff --check` 通过
105
106## 推荐验证命令
107
108- `pnpm -C /Users/george/code/baa-conductor lint`
109- `pnpm -C /Users/george/code/baa-conductor test`
110- `pnpm -C /Users/george/code/baa-conductor typecheck`
111- `git -C /Users/george/code/baa-conductor diff --check`
112
113## 交付要求
114
115完成后请说明：
116
117- 根入口最终跑了哪些子检查
118- 有没有新增 helper 脚本
119- 跑了哪些验证
120- 还有哪些检查仍未被根入口覆盖