Module git_notes 

Git notes attached at refs/notes/heddle carry Heddle state metadata (change_id, agent, confidence, status) without polluting the commit message — and so without changing the commit SHA.

This is the history-carrying half of the export identity model. The bridge-mapping.json sidecar is a local served/export cache; notes are the portable source that survives plain Git clones and exports.

Sley provides the tree-backed notes plumbing; this module owns Heddle’s JSON payload and the fixed refs/notes/heddle location.

Structs

HeddleNote

JSON payload stored inside each note blob.

NoteAgent

NoteAttribution

OmittedBreakdown

Per-scope omitted-annotation counts emitted alongside refs/notes/heddle.

SignalCounts

Per-module risk-signal fire counts on this state.

Constants

NOTES_REF

The notes ref heddle uses. Git-compatible notes readers can opt into this location, while Heddle reads and writes it natively.

Functions

read_note

Look up the note attached to commit_oid, if any.

remove_notes

Retract the notes attached to commit_oids from refs/notes/heddle.

write_note

Attach note to commit_oid in repo under refs/notes/heddle.