Concept

Git overlay

heddle init adds Heddle to an existing Git checkout while Git remains the source authority.

One-step capture

heddle capture records a recoverable Heddle state and writes the Git checkpoint as one verified operation. You can then heddle push to publish. Check heddle status and run project checks before capture; capture does not run Git hooks.

Native source authority

heddle import local is the explicit transition to Native Heddle. It imports selected Git history and switches durable source authority. Native history can be projected to Git with heddle bridge git export.