[avrabe]

Measured on v0.46.0 across all 17 commands in the dispatch table: 14
treated --help as an unknown option and exited 1 (spar allocate --help printed "Unknown option: --help"). dbc, mcp and lsp already
exited 0. A request for
help and a misspelled flag were the same failure, with the same exit
code. The PulseEngine CLI baseline is --help → 0, unknown flag → 2
with usage on stderr. The top-level dispatcher already met it (#422);
the subcommands did not.

• main: one check before dispatch. A command in the COMMANDS table
  given --help / -h prints spar <command> — <description> to
  stdout and exits 0. moves, dbc and mcp keep their own, fuller
  help (SELF_HELP).
• spar moves --help reached "Unknown moves subcommand" and exited 1;
  it now prints the moves usage and exits 0.
• The 16 "Unknown option" sites in main.rs, and insight's one, exit 2.

Oracles: a CLI test runs --help and -h on all 17 commands in the
table (exit 0, no "Unknown option"; red on v0.46.0 for 14 of them). A
negative control checks that a misspelled flag still exits 2 with
"Unknown option" on six commands.

NOT CLAIMED:

• per-option usage for the commands that do not print their own; they
  print their description;
• moves argument errors, which stay 1, because moves uses 2 for a
  FINDING (documented in main.rs at CLI baseline: --version errors (exit 1), and spar's version is not obtainable anywhere #422);
• insight's unknown-SUBCOMMAND path;
• moves's and dbc's help going to stderr instead of stdout.

Refs #508

🤖 Generated with Claude Code

https://claude.ai/code/session_01BnBWxgVEUPdsBTLNKtrA6Z

[github-actions]

Rivet verification gate

✅ 20/20 passed

	count
Passed	20
Failed	0
Skipped (no steps)	0

Filter: (and (= type "feature") (or (has-tag "v093") (has-tag "v0100")))

Failed artifacts

(none)

_{Updated automatically by tools/post_verification_comment.py. Source of truth: artifacts/verification.yaml.}

[codecov]

Codecov Report

❌ Patch coverage is 86.20690% with 4 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
crates/spar-cli/src/main.rs	84.00%	4 Missing ⚠️

📢 Thoughts on this report? Let us know!