heddle review

Review is what closes the loop on a state. heddle review show [state] renders the headline, agent narrative, in-budget signals, discussions, existing signatures, and the set of available signing kinds — as one artefact a human can read in a sitting.

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. In day-to-day workflows you'll go through an editor integration or heddle agent which prepares these for you; the bare command is for tooling and for the script that runs in CI.

Three signing kinds: read (a human reviewed it), agent_preview (an agent looked but didn't co-sign), agent_co_review (a second agent — typically a different model — co-signed the resolved state).

Examples

Render the review surface locally

bash$ heddle review showreview of state hd-d01a8b4e  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-d01a8b4e --kind read --public-key <hex> --signature <hex> --signed-at-unix 1715472851signed state hd-d01a8b4e as read (signature_id sig-9a2f)

Walk to the next pending review

bash$ heddle review next --mine-onlynext pending review: hd-e3a7c1b9  add scope-narrowing tests  existing signatures: 1

See also

• heddle thread
• heddle bridge git
• heddle discuss

Subcommands

• review show Render the review payload for a state (defaults to HEAD)
• review sign Submit a review signature on a state (kind: read / agent_preview / agent_co_review)
• review next Walk to the next pending review
• review health Per-module signal health over a rolling window of states