Usage: rebar review-plan [-h] [--output {json,text}] [--no-sign] [--force] [--check] [--status] [--retry] [--ref REF] [--source {attested,local}] [ticket_id]

Run the plan-review gate on a ticket. The gate applies a deterministic Layer-1
floor and a four-pass review of the plan (find, verify, decide, then coach),
then signs a plan-review attestation on a non-blocking PASS. It is the inverse
of verify-completion.

positional arguments:
  ticket_id             ticket id, short id, or alias

options:
  -h, --help            show this help message and exit
  --output, -o {json,text}
  --no-sign             run the review but do not sign an attestation. By
                        default a non-blocking PASS signs one. That attestation
                        is the durable product of the review, and it is what the
                        claim gate consumes, so this flag is the explicit opt-
                        out rather than the way to get a signature. An unsigned
                        PASS leaves the claim gate unsatisfied. To recover a
                        lost signature cheaply, with no LLM call, run `rebar
                        sign-review <id>`
  --force               re-run the review even if a current attestation exists,
                        bypassing the idempotence short-circuit. It also reviews
                        a ticket that is not yet claimable (closed, idea, or
                        blocked status, or blocked by an unclosed dependency),
                        which is otherwise fast-failed without running the LLM
  --check               print backend and credential availability and exit. This
                        does not inspect a ticket's attestation status. Use
                        --status for that
  --status              report read-only whether the ticket's plan-review
                        attestation is current right now, with no model call, no
                        network, and no re-sign. Prints the verdict and the
                        bound verified-at-sha. Exit 0 when current and 12 when
                        stale or absent
  --retry               resume only the exact latest eligible INDETERMINATE
                        review. It reuses the checkpointed findings of the
                        already-successful units and issues model calls only for
                        the missing units, under a fresh per-invocation attempt
                        budget. It is eligible only when the latest retained
                        REVIEW_RESULT is INDETERMINATE with a versioned
                        discovery journal and at least one retryable missing
                        unit. A PASS or BLOCK verdict, a non-retryable
                        indeterminate, or a missing, legacy, corrupt, stale, or
                        digest-mismatched journal is refused before any model
                        call (exit 2) with the normal full-review remedy.
                        Cumulative retry lineage is recorded as audit telemetry
                        and is never enforced as a cap. This flag is mutually
                        exclusive with --force, --status, and --check, and is
                        compatible with --no-sign. The retry response stays a
                        narrow end-result view, and the per-unit journal is
                        never printed
  --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

Coaching deep-links and `rebar explain <criterion-id>` reference the criteria
authoring guide at https://github.com/navapbc/rebar/blob/main/docs/plan-review-
criteria-guide.md (anchor `#<criterion-id lower-cased>`, override the base with
REBAR_DOCS_URL).
