docs(help): write the CLI help and command metadata in ASD-STE100

TH
25m ago
+1003-739

Summary

Rewrites the versioned CLI help in ASD-STE100 Simplified Technical English: the root help, all help topics, the MCP guide, and the command, flag, and input metadata that help and MCP render. This is a language change; the meaning of each rule is frozen. Command lines, flags, enums, defaults, limits, and error codes are unchanged. One commit per topic or metadata module.

  • New gate src/commands/schema/cli-help-first-screen.test.ts: each topic and the root help declare their key rules, which must stay in the first 30 rendered lines. A new topic must declare its rules. Detection is proved: a moved rule, a missing entry, and the earlier regressions all fail it.
  • Three fix(help) commits correct facts: the launchConsole and jitterPx input descriptions, the MCP help-tool description ("root decision card"), and a topic that listed itself in its Related footer.
  • The workflow Escalate list no longer lists debugging, tv, react-native, and remote, to fit the 9,100-byte workflow budget. The workflow topic body still points to each of these topics.

Review rounds

  • Round 1 (independent; Codex reviewed the Claude-written text): 5 high, 7 medium; fixed.
  • Round 2 (Codex): 2 medium; fixed. All metadata families and the other topics are equivalent to base.

Not changed (pre-existing)

  • react-native points to Expo URL command shapes that the workflow topic does not have (test-pinned).
  • A "Device busy and ownership" section sits in the react-devtools topic.

Validation

  • pnpm check:affected --run --head 3e7f1efce6: passed, exactCommit=true.
  • pnpm bench:help-conformance (31 cases, claude-haiku-4-5 and gpt-5.6-luna, 3 repeats): base 111/186, head 111/186. A Codex drop on one case did not repeat in a parallel 10-repeat run (base 4/10, head 4/10). The default Codex runner is now gpt-5.6-luna; gpt-5.4-mini does not work with a ChatGPT login.