source-trace

Small, practical tools for reading SourceTrace attribution data from Git Notes.

Repository layout

• attribution-spec/ - format documentation and examples
• srctrace-blame/ - line-level AI attribution viewer
• srctrace-history/ - history and survival analytics CLI

Quickstart

python3 srctrace-blame/srctrace_blame.py --help
python3 srctrace-history/srctrace_history.py --help

Default notes ref used by both tools:

refs/notes/srctrace/attribution

Notes format (summary)

Each commit note stores JSON like:

{
  "v": 1,
  "f": {
    "path/to/file.py": [
      {"s": "agent|cursor(claude-3-7-sonnet-20250219)", "l": [1, "5-9"]},
      {"s": "operator", "l": []}
    ]
  }
}

See attribution-spec/ for full details.