fix(help): a command's page should say what that command does - #911

Merged

jdx merged 9 commits into

mainfrom

agent/help-describes-the-command

Aug 16, 2026

Commits on Aug 16, 2026

feat(derive): say what a command does to the world

jdx
and
claude
committed
1fce9bf
fix(derive): refuse an effect where nothing would carry it

jdx
and
claude
committed
4ddf863
feat(derive): name a value the way clap names it, and say which usage can read the spec

jdx
and
claude
committed
0229e63
fix(derive): shout a short-only flag's placeholder, and keep one claim per spec

jdx
and
claude
committed
cdfd87a
feat(argv): answer `--version`, which an adopter loses on the way from clap

jdx
and
claude
committed
a2be6b3
feat(derive): let `parse()` answer a failure the way a program does

jdx
and
claude
committed
91c27e4
test(argv): read the message, not the escapes around it

jdx
and
claude
committed
8a3201e
fix(help): a command's page should say what that command does

jdx
and
claude
committed
0a96871
fix(spec): a clap-derived subcommand should know where it sits

jdx
and
claude
committed
66dd3bc