This repository was archived by the owner on Apr 7, 2026. It is now read-only.
Description Kaizen Surface Gate K2 Failure (4 defects)
--help is not recognized on file-taking subcommands:
simular run --help → "Error: Failed to read experiment file" (exit 1)
simular verify --help → "Error: Failed to read experiment file" (exit 1)
simular emc-check --help → "Error: Failed to read experiment file" (exit 1)
simular emc-validate --help → "Error: Failed to read experiment file" (exit 1)
The manual arg parser consumes the next positional arg as a filename without first checking for --help/-h.
Five-Whys
Why does --help fail? The string "--help" is passed as the filename argument
Why is it treated as a filename? Manual arg parsing takes next positional arg without flag check
Why manual arg parsing? simular uses custom dispatch instead of clap
Why no --help check? The flag check only exists at the top level, not per-subcommand
Why not caught? No K2 surface gate testing in CI
Fix
Add --help/-h flag detection before consuming positional args in each subcommand handler. Alternatively, migrate to clap for consistent arg parsing.
Found via kaizen surface gate sweep.
Reactions are currently unavailable
Kaizen Surface Gate K2 Failure (4 defects)
--helpis not recognized on file-taking subcommands:simular run --help→ "Error: Failed to read experiment file" (exit 1)simular verify --help→ "Error: Failed to read experiment file" (exit 1)simular emc-check --help→ "Error: Failed to read experiment file" (exit 1)simular emc-validate --help→ "Error: Failed to read experiment file" (exit 1)The manual arg parser consumes the next positional arg as a filename without first checking for
--help/-h.Five-Whys
Fix
Add
--help/-hflag detection before consuming positional args in each subcommand handler. Alternatively, migrate to clap for consistent arg parsing.Found via kaizen surface gate sweep.