Usage: rebar scan-spec [-h] --spec-file SPEC_FILE [--batch-size BATCH_SIZE] [--epic EPICS] [--output {json,text}] [--ref REF] [--source {attested,local}]

Batch-scan open epics against a specification and emit structured findings
(gaps, conflicts, and overlaps). Requires the 'agents' extra.

options:
  -h, --help            show this help message and exit
  --spec-file SPEC_FILE
                        path to the specification text
  --batch-size BATCH_SIZE
                        epics per batch (default 5)
  --epic EPICS          restrict to these epic ids, repeatable (default: all
                        open epics)
  --output, -o {json,text}
  --ref REF             a branch, tag, or commit SHA to verify against (default:
                        origin/main, configurable through REBAR_GATE_REF or
                        [snapshot].ref). Pass --ref HEAD when the review depends
                        on code you have committed locally but have not yet
                        landed on the default ref, such as a stacked change or
                        feature branch. The default ref reads a snapshot that
                        predates that code, so symbols it adds report as 'does
                        not exist' false findings
  --source {attested,local}
                        attested (default) verifies a snapshot pinned at --ref,
                        signs the result, and records verified_at_sha. local
                        reads the in-place checkout, allows a dirty tree, and
                        never signs
