heddle fsck

Run heddle fsck periodically — or in CI — to catch corruption before it propagates. The default pass is cheap (header + ref consistency). --full walks every object; --thorough adds graph and signature integrity checks. --bridge also validates the Git overlay mirror, mapping, notes, and checkout.

When --repair is set, fsck attempts to reconstruct missing or corrupted objects from the oplog. Repair is conservative — it asks before destroying anything.

Flags

--full

Walk every object in the store, not just refs.

--thorough

Run slower graph and signature integrity checks.

--repair

Attempt to repair issues; interactive on destructive ops.

--bridge

Include the Git overlay mirror, mapping, notes, and checkout in the integrity walk.

Examples

Routine integrity check

bash$ heddle fsckok repository is valid (14,302 checked)

Deep check including the Git bridge

bash$ heddle fsck --full --thorough --bridgeok repository is valid (14,302 checked)  Bridge: mirror and mapping checked

See also

• heddle doctor