heddle review

heddle review show [state] renders the headline, agent narrative, in-budget signals, discussions, existing signatures, and the available signing kinds as one artefact a human can read in a sitting. --all-signals includes the hidden ones beyond the in-budget set.

Signing is over a specific state, not over a thread. heddle review sign is deliberately low-level: the caller passes the canonical signed-at timestamp, the public key and the signature bytes, and the verifier checks the signature over that exact timestamp, rejecting values outside a small skew window. In day-to-day work an editor integration prepares these for you; the bare command is for tooling and CI.

Three signing kinds, spelled with hyphens: read, agent-preview, agent-co-review. Underscored spellings are rejected with exit 64.

review next walks to the next pending review when review selection is configured; --mine-only narrows it to the current actor. All of review is local — it runs against the repository, with no server round-trip.

Examples

Render the review surface locally

bash$ heddle review showreview of state hd-d01a8b4e7m9k  replace JWT auth with Biscuit capabilities  signals (in budget):    novelty · 0.42    test_reachability · 0.91  signatures: (none)  available signing kinds: read, agent-preview, agent-co-review

Sign as a human read

bash$ heddle review sign hd-d01a8b4e7m9k --kind read --public-key <hex> --signature <hex> --signed-at-unix 1715472851

Walk to the next pending review

bash$ heddle review next --mine-only

See also

• heddle show
• heddle discuss
• heddle verify

Subcommands

• review show Render the review payload for a state
• review sign Submit a review signature on a state (kind: read / agent-preview / agent-co-review)
• review next Walk to the next pending review when review selection is configured
• review health Per-module signal health over a rolling window