CLI reference

heddle verify

Shipped

heddle verify [OPTIONS]

Verify this workspace; exits nonzero until every check is clean. The proof surface: whether Heddle, Git mapping, worktree, remotes, active operations, clone state, and machine contracts agree.

Output text (default) · json

verify is the command to gate CI on. It exits 0 only when every check is clean, 65 when verification reports a blocked state, and 74 on IO trouble reading state. Because the failure code is 65 and not 75, a failing verify is never something to retry — the inputs are the problem.

--provenance additionally verifies each state's offline authorship and review-signature chain.

Flags

--provenance: Verify each state's offline authorship and review-signature chain.

Exit codes

Declared by this command's contract, verbatim. Anything not listed contracts only to 0 on success and an unspecified non-zero on failure. The full table and the retry rule — in short, 75 is the only code that is safe to retry.

0: verified clean
65: verification reports blocked state
74: io reading state

Examples

Gate CI on a clean workspace

bash$ heddle verify --output json

Flags

Exit codes

Examples

See also