heddle fsck

Run heddle fsck periodically, or in CI, to catch corruption before it propagates. The default pass is cheap. --full adds content verification; --thorough runs the slower graph and signature integrity checks; --provenance verifies offline authorship identity and review-signature chains; --git includes the Git projection, mapping, notes and checkout.

Repair is a subcommand, not a flag. heddle fsck repair repairs an integrity surface and then verifies it; today the one surface it exposes is heddle fsck repair git, which reconciles Git projection metadata or a single projected ref. --preview shows the authority-valid repair without changing refs, and --prefer git|heddle asserts the intended authority direction.

Flags

--full

Full check (includes content verification).

--thorough

Run slower graph and signature integrity checks.

--provenance

Verify offline authorship identity and review-signature chains.

--git

Include Git projection, mapping, notes, and checkout checks.

Examples

Routine integrity check

bash$ heddle fsck

Deep check including the Git projection

bash$ heddle fsck --full --thorough --provenance --git

Preview a repair before letting it move a ref

bash$ heddle fsck repair git --ref main --preview

See also

• heddle doctor
• heddle verify
• heddle redact