| Option | Type | Default | Description |
|---|
--current | PATH | required | Path to the current scorecard JSON |
--baseline | PATH | optional | Path to the baseline scorecard JSON |
--allowlist | PATH | optional | Path to the allowlist JSON |
--fail-on | SEVERITY | serious | Minimum severity to fail on |
| Level | When to use |
|---|
critical | Only block on show-stoppers |
serious | Default — blocks on barriers that affect daily use |
moderate | Stricter — includes usability issues |
minor | Strictest practical — catches most issues |
info | Catches everything, including informational notes |
| Code | Meaning |
|---|
0 | All checks passed |
2 | Input or validation error (bad JSON, missing file, schema mismatch) |
3 | Policy gate failed (severity threshold, regression, or expired allowlist) |
Every message follows the low-vision-first contract: [OK]/[WARN]/[ERROR] + What/Why/Fix. No message is ever just a status code or cryptic one-liner.