fix: make help and version successful discovery
Some checks failed
checks / flake (push) Has been cancelled

This commit is contained in:
hermes 2026-07-28 19:26:43 +00:00
commit 5c81b469e5
5 changed files with 88 additions and 1 deletions

View file

@ -11,3 +11,10 @@ whether stdout is a terminal or pipe; human-readable presentation requires
command has the same framing and semantics in every execution environment.
JSON mode never emits interactive prompts; required confirmation is represented
as a structured error and satisfied by an explicit flag.
Clap discovery requests are intentionally outside the operation-result
protocol. Root and subcommand `--help`, plus `--version`, return conventional
plain UTF-8 text on stdout with status 0 and no stderr. They do not initialize
the runtime or execute an operation. This narrow exception keeps the CLI
self-describing for both people and automation agents without weakening JSON
framing for analysis and cleanup commands.