CLI reference
Every verb, option summary, and exit code below is introspected from the CLI at export time — this reference cannot drift from the binary, and none of it is hand-listed.
Commands
hadur chart
Render a single chart by metric name.
hadur convergence
Run §7.3 convergence signals; render aggregate verdict.
hadur coverage
Coverage matrices: §-sections × rounds AND lenses × rounds.
hadur dashboard
Render the SP4 dashboard: write it to a file, or serve it live.
hadur history
Wave history — list view or drill-down.
hadur init
Bootstrap a new Hadúr project at the chosen scale tier.
hadur portfolio
Render the SP4 portfolio: write it to a file, or serve it live.
hadur roadmap
Advisory monitoring for deferred Hadur sub-projects.
hadur sweep
Mechanize the §20 drift catalog over a Hadúr repo (Plan A: Regime 1).
hadur trends
Finding counts per round, with optional ASCII bar chart.
Command groups
hadur audit
Run audit-domain phases (Plan 7).
hadur audit accessibility— Audit HTML / JSX / TSX files for common WCAG violations (+ opt-in axe-core depth).hadur audit code-drift— Audit each module plan's §18 Exports against in-repo Python symbols.hadur audit infrastructure— Audit repo for env.example template, README, and CI workflow presence.hadur audit integration— Audit the Jira-bridge failure journals (HADUR-338).hadur audit performance— Audit Python source for sleep calls and over-long functions.hadur audit security— Audit repo for hardcoded credentials, env-file hygiene, and (opt-in) CVEs.hadur audit seo— Audit HTML files for SEO presence (lang/title/meta + opt-in lighthouse depth).hadur audit wave-consistency— Reconcile round findings against wave records (HADUR-377).
hadur export
Export engine data for external consumers (the hadur.ai site).
hadur export site-data— Emit the four hadur.ai site artifacts (registries/dashboard/methodology/stamps).
hadur handoff
Manage Hadúr session handoffs (spec §7 / §8).
hadur handoff read— Render a handoff's summary (spec §8). Exit 1 if status is not 'shipped'.hadur handoff write— Write a YAML-front-matter handoff under docs/handoffs/ (spec §7).
hadur jira
Jira bridge (Sub-project 3 Plan 1).
hadur jira bootstrap— Discover or create one Jira Epic per plan; write mapping to config.hadur jira clear-failures— Discard failure-journal records by hand (HADUR-337).hadur jira pull— Read-only pull of Jira-side comments + metadata into local sidecars.hadur jira should-sync— Hook-support predicate: exit 0 iff the jira-sync hook should fire.hadur jira status— Print sync-state summary: counts + last-sync timestamp + failures.hadur jira sync— Sync local Hadúr state to Jira and pull annotations back (bidirectional).
hadur round
Round lifecycle — open a Round, dispatch its lenses, close it (§7.3.4).
hadur round close— Re-check a Round against the tree as it is NOW. Exit 3 if it will not certify.hadur round dispatch— Pin one lens's question to a Round: a distinct reviewer + a hash-pinned brief.hadur round open— Open a Round against the code on disk now — the anchor S1′ counts from.hadur round verdict— Record a lens's verdict. For L13 the enumerating form is enforced (§7.3.2).
hadur waves
Wave lifecycle — close or abort a Wave (Round↔Wave loop).
hadur waves close— Close (or abort) a Wave, and transition its Jira Wave-Story to Done.
hadur worktree
Manage Hadúr feature worktrees (spec §5 / §6).
hadur worktree bulk-create— (Re-)create a plan's Jira tickets in an existing worktree — idempotently.hadur worktree create— Create a new feature worktree under `.worktrees/<name>/` (spec §5).hadur worktree verify— Run W1-W5 checks against *worktree* (spec §6). Exit 3 on any fail.
Exit codes
| Exit code | Meaning |
|---|---|
| 0 | success |
| 1 | CoverageError, ManifestDriftError, WaveError |
| 2 | user/argument error (unmapped HadurError fallthrough) |
| 3 | ConvergenceError |