Blogengineering1 min read

Why Sidecar Code Graphs Go Stale

Sidecars proved agents need a graph. They also proved a second source of truth is a liability.

Sidecar graph tools proved the demand, then went stale between runs.

An indexer that lives outside version control is blind to history, missing mid-session edits, and gone when the folder moves. Throughput Lines of Code Per Day computes the graph inside the VCS — updated sub-second per file on every change, keyed by object ID so it is queryable at any commit, not just the last time an indexer happened to run. Agents propose; history stays yours. Delete the derived layer and nothing canonical is lost.

Prefer tools that treat the repository as the source of truth — not a cache that drifts.

Continue