baa-conductor

T-S015.md

  1# Task T-S015：给 `mini` 单节点补统一 on-node verify wrapper
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S015.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/scripts/runtime/check-launchd.sh`
 10- `/Users/george/code/baa-conductor/scripts/runtime/check-node.sh`
 11- `/Users/george/code/baa-conductor/docs/runtime/node-verification.md`
 12- `/Users/george/code/baa-conductor/docs/runtime/README.md`
 13- `/Users/george/code/baa-conductor/docs/ops/repo-verification.md`
 14- `/Users/george/code/baa-conductor/package.json`
 15
 16## 当前基线
 17
 18- 仓库：`/Users/george/code/baa-conductor`
 19- 分支：`main`
 20- 提交：`d7a83fd`
 21- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
 22
 23## 建议分支名
 24
 25- `chore/add-mini-verify-wrapper`
 26
 27## 目标
 28
 29把 `mini` 节点的 on-node 静态检查和运行态检查收成一条统一入口，降低运维和回归时的命令记忆成本。
 30
 31## 背景
 32
 33- 当前仓库根已经有 `pnpm lint`、`pnpm test`、`pnpm smoke`，但这些都属于 repo 内可自举验证。
 34- 真正的 on-node 检查仍然需要分别记住 `check-launchd.sh` 和 `check-node.sh`，而且要自己拼同一组参数。
 35- `status-api` 已经降成 opt-in 观察面，新的 wrapper 也需要跟这个默认集合保持一致。
 36
 37## 涉及仓库
 38
 39- `/Users/george/code/baa-conductor`
 40
 41## 范围
 42
 43- 新增一条统一的 `mini` on-node verify wrapper
 44- 让默认检查集合跟当前 runtime 默认服务集合一致
 45- 回写 runtime / ops 文档和根脚本入口
 46
 47## 路径约束
 48
 49- 优先复用现有 `check-launchd.sh` 和 `check-node.sh`
 50- 不要重写已有静态检查或 HTTP 探针逻辑
 51- 不要把任务扩展成 launchd 安装流程重构
 52
 53## 推荐实现边界
 54
 55建议优先做：
 56
 57- 新增 `scripts/runtime/verify-mini.sh` 或等价 wrapper
 58- 默认同时跑静态检查和运行态检查
 59- 提供显式 `--service status-api` 或等价开关，保持 opt-in 观察面能力
 60
 61## 允许修改的目录
 62
 63- `/Users/george/code/baa-conductor/scripts/runtime/`
 64- `/Users/george/code/baa-conductor/docs/runtime/`
 65- `/Users/george/code/baa-conductor/docs/ops/`
 66- `/Users/george/code/baa-conductor/package.json`
 67- `/Users/george/code/baa-conductor/README.md`
 68
 69## 尽量不要修改
 70
 71- `/Users/george/code/baa-conductor/apps/`
 72- `/Users/george/code/baa-conductor/tasks/`
 73
 74## 必须完成
 75
 76### 1. 补统一 on-node wrapper
 77
 78- 新入口默认覆盖 `conductor` 和 `codexd`
 79- 调用方不需要再手动拼两套重复参数
 80
 81### 2. 保持现有检查脚本职责不变
 82
 83- `check-launchd.sh` 和 `check-node.sh` 仍然保留
 84- wrapper 只是编排，不要复制一份内部逻辑
 85
 86### 3. 回写文档和根入口
 87
 88- runtime 文档要写清新的推荐 on-node 用法
 89- 如有必要，根 `package.json` 补一个合适的调用入口
 90
 91## 需要特别注意
 92
 93- 不要破坏当前 `status-api` opt-in 语义
 94- 不要把 repo 内 `pnpm smoke` 和 on-node verify 混成一条命令
 95- 与 `status-api` 终局任务并行时，尽量避免同时大改同一段 runtime 文档
 96
 97## 验收标准
 98
 99- `mini` on-node 检查有统一入口
100- 默认服务集合与当前 runtime 默认集合一致
101- 文档和帮助文本已同步
102- `git diff --check` 通过
103
104## 推荐验证命令
105
106- `bash -n /Users/george/code/baa-conductor/scripts/runtime/verify-mini.sh`
107- `bash -n /Users/george/code/baa-conductor/scripts/runtime/check-launchd.sh`
108- `bash -n /Users/george/code/baa-conductor/scripts/runtime/check-node.sh`
109- `git -C /Users/george/code/baa-conductor diff --check`
110
111## 交付要求
112
113完成后请说明：
114
115- 新 wrapper 叫什么、默认会跑什么
116- 默认服务集合是什么
117- 修改了哪些脚本和文档
118- 还有哪些 on-node 检查仍需要人工判断