Usage: rebar <subcommand> [args...]

Run 'rebar <subcommand> --help' for usage of a specific subcommand.

Subcommands:
  init        Initialize the ticket system
  create      Create a new ticket
  idea        Capture an undesigned idea (creates an epic in status 'idea'; excluded from ready/next-batch)
  show        Show ticket details
  list        List all tickets as JSON
  transition  Transition ticket status (optimistic concurrency)
  claim       Atomically claim an open ticket (-> in_progress + assignee; exit 10 if taken)
  reopen      Reopen a closed ticket (closed -> open; exit 10 if not currently closed)
  comment     Add a comment to a ticket
  session-log Capture helper: append "<entry>" to the current session_log (start rotates to a fresh log)
  link        Link two tickets (relation REQUIRED: blocks|depends_on|relates_to|duplicates|supersedes|discovered_from|caused_by)
  unlink      Remove ONE link between an ordered <source> <target> pair (no relation arg; most-recent first)
  deps        Show dependency graph for a ticket (<ticket_id>)
  edit          Edit ticket fields (--title, --priority, --assignee, --ticket_type, --description, --parent; tags via --add-tag/--remove-tag/--set-tags)
  tag           Add a tag to a ticket
  untag         Remove a tag from a ticket
  validate      Repo-wide tracker health check (NO ticket id; scores the whole store 1-5, exit 0-4; --output json, --terse, --verbose, --fix)
  clarity-check Score one ticket's clarity (<ticket_id>; exit 0=pass, 1=fail; JSON: score/verdict/threshold)
  check-ac      Check one ticket has an Acceptance Criteria block (<ticket_id>; exit 0=pass, 1=fail; AC_CHECK: pass|fail)
  quality-check Check one ticket's dispatch readiness (<ticket_id>; exit 0=pass, 1=fail; QUALITY: pass|fail)
  purge-bridge  Remove non-project inbound bridge tickets (--keep=<KEY> [--dry-run])
  summary       One-line ticket summary with blocking status for one or more IDs
  bridge-status Show last bridge run status [--output json]
  bridge-fsck   Audit bridge mappings (orphans, duplicates, stale SYNCs)
  bridge-probe  Preflight live Jira capability (create/label/search/delete round-trip)
  exists        O(1) presence check (exit 0=exists, 1=not found)
  list-descendants  BFS walk from a root ticket, bucketed by type (JSON)
  next-batch    Select next parallel agent batch for an epic [--output json]
  ready         List tickets ready to work (all blockers closed)
  search        Full-text search over titles/descriptions/comments/tags (JSON)
  session-logs  List the newest session_log tickets, newest first [--limit=<n>]
  archive       Archive an open ticket (excludes from default list; idempotent)
  set-file-impact  Record file impact for a ticket (JSON array of {path,reason} objects)
  get-file-impact  Get the current file impact array for a ticket (JSON)
  set-verify-commands  Record DD-level verify commands (JSON array of {dd_id,dd_text,command})
  get-verify-commands  Get the current verify commands array for a ticket (JSON)
  sign             Sign a ticket's manifest of verified steps with the environment key (JSON array of strings)
  verify-signature Certify that a ticket's verified steps match its signature (exit 0=certified)
  scratch          Manage per-ticket scratch values (set/get/clear)
  delete        Delete a ticket (destructive; requires --user-approved)
  compact       Compact a ticket's event log [--threshold=<n>]
  compact-all   Compact all eligible tickets [--dry-run] [--limit=<n>] [--no-commit]
  fsck          Check store integrity (JSON validity, CREATE presence, index.lock) [--output json]
  fsck-recover  Recover the tracker worktree (dangling commits, interrupted rebases) [--tracker-dir <path>]
  revert        Revert a ticket to a prior event UUID (<ticket_id> <target_uuid> [--reason=<text>])
  resolve       Resolve an id/alias/prefix to a canonical ticket id
  format        Render a ticket for display (<ticket_id> [mode])
  export        Export the store as NDJSON (one ticket per line) [-o FILE] [--strip-external]
  import        Import tickets from export NDJSON (clean rebar->rebar migration) [FILE] [--dry-run]
  grounding-info  Print the code-grounding oracle contract (dimensions/kinds/reasons/backends) [--output json]
  audit         Show a ticket audit trail (plan-review history + completion + code reviews) (audit show <id> [--output json|text])
  metrics       Render the full metric registry over a date range [--since <date>] [--until <date>] [--output json|text]
