baa-conductor

T-S012.md

  1# Task T-S012：清理 repo 中最后一批 legacy 模板与残留 importer
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S012.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/ops/launchd/so.makefile.baa-conductor.plist`
 10- `/Users/george/code/baa-conductor/ops/launchd/so.makefile.baa-status-api.plist`
 11- `/Users/george/code/baa-conductor/scripts/runtime/install-mini.sh`
 12- `/Users/george/code/baa-conductor/pnpm-lock.yaml`
 13- `/Users/george/code/baa-conductor/docs/runtime/launchd.md`
 14- `/Users/george/code/baa-conductor/tests/control-api/control-api-smoke.test.mjs`
 15
 16## 当前基线
 17
 18- 仓库：`/Users/george/code/baa-conductor`
 19- 分支：`main`
 20- 提交：`097621a`
 21- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
 22
 23## 建议分支名
 24
 25- `chore/clean-runtime-legacy-residuals`
 26
 27## 目标
 28
 29清掉 repo 里最后一批已经不再代表当前主线的 legacy 模板和删旧残留，让仓库静态资产与当前运行口径一致。
 30
 31## 背景
 32
 33- 当前主线已经有 canonical `BAA_CONDUCTOR_PUBLIC_API_BASE` / `--public-api-base`。
 34- 但 repo 内仍有一些静态残留没有同步：
 35  - `ops/launchd/so.makefile.baa-conductor.plist` 还只写 legacy key 和旧注释
 36  - `pnpm-lock.yaml` 还保留已删除的 `apps/control-api-worker` importer
 37  - `install-mini.sh` 仍把 `control-api-worker.secrets.env` 当 fallback 文件名写在默认说明里
 38- 这些不会立刻打坏主线，但会持续误导维护者。
 39
 40## 涉及仓库
 41
 42- `/Users/george/code/baa-conductor`
 43
 44## 范围
 45
 46- 清理 repo 模板和辅助脚本里的静态 legacy 残留
 47- 让 lockfile / 模板 / 帮助文本与当前主线一致
 48- 保留必要兼容时，要明确标成 legacy fallback
 49
 50## 路径约束
 51
 52- 这个任务以静态资产和辅助脚本为主
 53- 不要改 `apps/conductor-daemon` 的运行时逻辑
 54- 不要把任务扩展成新的部署方案设计
 55
 56## 推荐实现边界
 57
 58建议优先做：
 59
 60- 更新 repo 里的 launchd plist 模板
 61- 清理 lockfile 里已删除 importer
 62- 收口 `install-mini.sh` 对 legacy secrets fallback 的口径
 63
 64## 允许修改的目录
 65
 66- `/Users/george/code/baa-conductor/ops/launchd/`
 67- `/Users/george/code/baa-conductor/scripts/runtime/`
 68- `/Users/george/code/baa-conductor/docs/runtime/`
 69- `/Users/george/code/baa-conductor/pnpm-lock.yaml`
 70- `/Users/george/code/baa-conductor/docs/ops/`
 71
 72## 尽量不要修改
 73
 74- `/Users/george/code/baa-conductor/apps/conductor-daemon/`
 75- `/Users/george/code/baa-conductor/apps/status-api/`
 76- `/Users/george/code/baa-conductor/tasks/`
 77
 78## 必须完成
 79
 80### 1. 清理 launchd 模板残留
 81
 82- repo 模板应体现 canonical public API 配置名
 83- 注释要明确哪些内容只是 legacy 兼容
 84
 85### 2. 清理删旧后的静态残留
 86
 87- 清掉 lockfile 里已删除 importer 等明显残留
 88- 不要留下与当前仓库结构冲突的静态记录
 89
 90### 3. 收口 helper 脚本说明
 91
 92- `install-mini.sh` 的默认说明要和当前 secrets 口径一致
 93- 如果保留 legacy fallback，必须明确它只是兼容兜底
 94
 95## 需要特别注意
 96
 97- 不要破坏 `install-mini.sh` 当前对老环境的兼容回退能力
 98- 如需更新 lockfile，保持改动最小，不要顺手升级无关依赖
 99- 与 `status-api` 测试接入任务并行时，尽量不要同时修改同一段 runtime 文档
100
101## 验收标准
102
103- repo 模板和辅助脚本与当前主线口径一致
104- 已删除 importer 等静态残留被清掉
105- 兼容 fallback 若保留，文档和帮助文本说明清楚
106- `git diff --check` 通过
107
108## 推荐验证命令
109
110- `bash -n /Users/george/code/baa-conductor/scripts/runtime/install-mini.sh`
111- `bash -n /Users/george/code/baa-conductor/scripts/runtime/install-launchd.sh`
112- `npx --yes pnpm -C /Users/george/code/baa-conductor lint`
113- `git -C /Users/george/code/baa-conductor diff --check`
114
115## 交付要求
116
117完成后请说明：
118
119- 修改了哪些静态模板或辅助脚本
120- 清掉了哪些残留
121- 保留了哪些 legacy fallback
122- 跑了哪些验证