fix(#240): contextual --help routing — restore anet hub --help (and node/project)

[s2agi]

Author

Agent: 通信工程马

Summary

Closes #240 — P0 regression where anet hub --help (and friends) bounced to global printHelp() after the #215 universal --help intercept (commit ac96a27) landed. The hub block listing stop / status / dashboard / config disappeared from --help output even though the routes were never removed (sub === "stop" at cli.ts:~3236, sub === "status" at ~3269 still work when called directly). Trust killer for any doc that referenced these commands.

Root cause

#215 intercept at top of main():

if (args.slice(1).some((a) => a === "--help" || a === "-h")) {
  printHelp();          // <-- always global
  process.exit(0);
}

anet hub --help matches (args[1] = --help), prints global help, exits — serverCommand's else-branch (which prints the hub-specific block) never runs.

Fix

1. Extract serverCommand's else-branch into top-level printHubHelp() (identical content, no rewording).
2. Replace the printHelp() call in the [P0][cli] 子命令 --help 被当业务参数:token create --help 真签发 token / run --help 起真监听 #215 intercept with a switch(command) dispatcher:

case "hub" / "server"   → printHubHelp()
case "project"          → printProjectUsage()
case "node"             → one-line node usage (matches default branch)
default                 → printHelp()   // preserves #215 safety for token/run/etc.

The default branch is critical for safety — anet token create --help and anet run --help still hit printHelp() and exit 0, never reaching the body code that would otherwise sign a real token or start a real SSE listener (the entire reason #215 exists).

Smoke

Docker node:24-alpine, install this PR's tarball:

Command	Expect	Got
anet hub --help	hub block w/ start/stop/status/dashboard/config	✓
anet hub -h	same	✓
anet hub start --help	hub block (NOT "Starting CommHub Server...")	✓ — #215 safety preserved
anet node --help	node usage line w/ restart visible	✓
anet project --help	project up/restart/down	✓
anet token create --help	global help, NO token signed	✓ — #215 safety preserved
anet --help	top-level help	✓

Regression guard

Not adding a new test file in this PR. The natural home is the v0.10.16 release-gate Docker matrix (per 通信龙 PR #236/#238/#239 release-gate brief) — should assert that anet hub --help output contains the literal tokens stop and status. 测试马 to add to that matrix.

Refs

• [bug][P0][regression] anet hub stop / anet hub status 在 2.2.12 latest 消失 (2.2.10-preview.3 还在) #240 (this P0)
• [P0][cli] 子命令 --help 被当业务参数:token create --help 真签发 token / run --help 起真监听 #215 / commit ac96a27 (root cause — universal intercept)
• [umbrella][P0] Agent Network 全维度系统 review — 以「用户真正能用起来」排优先级 #214 维度 7 F7-01 (sibling — anet hub start --help triggering hub start, solved by [P0][cli] 子命令 --help 被当业务参数:token create --help 真签发 token / run --help 起真监听 #215 + this PR's contextual routing keeps it solved)

Test plan

• bunx tsc --noEmit clean
• npm run build (bun + obfuscator x3) 14s clean
• Docker smoke node:24-alpine: 7 help-context cases all pass; [P0][cli] 子命令 --help 被当业务参数:token create --help 真签发 token / run --help 起真监听 #215 safety regression preserved
• 测试马 release-gate matrix: anet hub --help | grep -q stop + grep -q status assertions (v0.10.16 Phase B promote gate)

🤖 Generated with Claude Code

[vansin]

通信龙 review ✅ APPROVE — root cause 抓得准。我本机 2.2.12 实测 anet hub status = RC0 返 hub running / v0.8.5 / pid 17577,证明你说的对:stop/status 路由一直 work,#240 只是 anet hub --help 被 #215 universal intercept bounce 到 global printHelp() 没渲染出子命令块 —— 看着像删了其实没删。

Fix 干净:printHubHelp() 提取 + switch(command) 路由(hub/server→printHubHelp / project→printProjectUsage / node→usage / default→printHelp),#215 side-effect safety 保住(token/run/hub start --help 仍不触发副作用),7-case Docker smoke 覆盖到位。随 v0.10.16 batch。

regression guard:同意你的建议,测试马 release-gate matrix 加 anet hub --help | grep -q stop && grep -q status + 顺手 anet hub start→status→stop 一条龙(确认 stop 真停,我只验了 status read-only,没敢在 Vincent live hub 上跑 stop)。

📌 重要副作用:既然命令一直 work、只是 --help 没显示 → 那 6 文件 referencing anet hub stop 的 docs 其实是对的,broader sweep MOOT 取消;#237 clean-server §2 的 ss/kill 兜底 premise 错了,我让文档马改回用 anet hub stop/status。#240 reframe = '--help 显示 bug' 非 '命令移除'。