[cli] 4 个命令(batch/config/opencode/token)在 main 上存在但未列入 anet --help

[vansin]

事实

文档(guide/getting-started.md + guide/cli.md)提到 32 个一级命令。
拿 latest(2.2.21,即默认 npm i -g 装到的版本) 的 anet --help 逐个比对:

27 个在 --help 里列出
 5 个没有:  batch  config  daemon  opencode  token

这 5 个逐个真跑确认都存在(anet <cmd> --help 均不报 unknown command),
只是没写进 --help 的清单。

所以这是可发现性问题,不是文档错误

• 文档没写错 —— 这 32 个命令在 latest 上一个都不缺;
• 但一个只看 anet --help 的用户,发现不了其中 5 个;
• 其中 anet daemon 和 anet opencode 恰恰是部署与运行时相关的命令,
  不是边缘功能。

建议

把这 5 个补进 --help,或明确标注它们是「高级/实验」并给出发现路径。
如果是有意不暴露(例如 batch 属内部),也值得在代码里写一句理由 ——
否则下一个人会以为是漏了。

附:这次排查里我自己的一个失败

第一次跑出来是「32 个全部缺失」。这个比例本身不合理,所以我没有直接报。
查下去发现:我用 [ -s <file> ] 判断「上次结果还在不在」,
而那个文件里装的是 docker 的报错信息(镜像已被我删掉),
非空 → 被当成有效结果 → 跳过重建 → 拿一份错误输出去比对。

判据:「文件非空」不等于「文件有效」。 缓存/复用中间产物时,
要校验内容形态(这里应当校验 --help 输出行数或首行特征),而不是只看长度。

[vansin]

🔴 更正:5 个里有 1 个是我搞错了

我用 latest(2.2.21) 的 anet --help 比对,列出 5 个「未列出」。
但我没有同时对 main 检查。补上之后:

main 的 printHelp 模板:
  anet daemon    命中 4 处   ← 已列出,是我错了
  anet batch     命中 0
  anet config    命中 0
  anet opencode  命中 0
  anet token     命中 0

anet daemon 在 main 上早已列入 help(Daemon (host_supervisor — required by the dashboard's node-creation wizard) 那一节),只是还没进 latest。
所以它属于「latest 落后」,不是代码缺陷 —— 我在原文里把两者混为一谈了。

真正仍缺的是 4 个:batch / config / opencode / token。

这是我两轮内第二次犯同一个错

#773 是「拿 main 的行为当 latest 的现状写文档」;
这次是「拿 latest 的缺失当 main 的缺陷报 issue」。方向相反,根因相同 ——
没有把「main」和「用户装到的版本」当作两个必须分别指名的对象。

判据固定:凡是断言「X 不存在 / X 是这样」,句子里必须带上在哪个版本上。
只说「anet 没有列出 daemon」是不完整的陈述,它在 latest 上成立、在 main 上不成立。

[vansin]

Follow-up after #776 merged: the discoverability change landed with three parser/help mismatches documented in the pre-merge review. Draft PR #784 corrects the current main help to the implemented config [path|json], batch lifecycle verb, and required opencode auth-login provider forms, and adds a real bun cli.ts --help subprocess regression test with witnessed red. No new command is introduced to make the inaccurate help true. Keep this issue open until #784 is independently reviewed and lands.

[vansin]

Resolved on main by #776 plus corrective #784 (squash 566039df). The top-level help now exposes all four missing command families and its summary matches the implemented parsers: config [path|json], batch lifecycle verbs, token verbs, and opencode upgrade/auth-login with the required provider argument. A real bun cli.ts --help subprocess regression test is now in the aggregate unit domain; #784 was independently CLEAN and all 9 checks passed, including both Docker E2E jobs.

This closure is specifically for the main-source discoverability issue named in the title. The default npm latest channel remains a separate release-state question tracked by #777; merging main does not claim stable users already have these help entries.