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 codeMeaning
0success
1CoverageError, ManifestDriftError, WaveError
2user/argument error (unmapped HadurError fallthrough)
3ConvergenceError