docs(help): write the CLI help and command metadata in ASD-STE100
TH
25m ago+1003+1003+0123456789012345678901234567890123456789-739-739-012345678901234567890123456789
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: thelaunchConsoleandjitterPxinput 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-5andgpt-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 nowgpt-5.6-luna;gpt-5.4-minidoes not work with a ChatGPT login.