Git-aware section glow — freshness at a glance

[rayeddev]

Vision

Integrate git blame to make section freshness visible. Recently changed sections glow warm. Stale sections fade. Hover for details.

Behavior

• Run git blame on the source file
• Map blame data to rendered sections (by heading boundaries)
• Recent edits (< 1 week) → warm subtle glow/border
• Old sections (> 6 months) → slightly faded
• Hover a section → tooltip: "last modified 3 days ago by @raed"
• Optional: show age indicator in TOC sidebar

Open Questions

• Performance: run blame on every update or cache it?
• How to map line-level blame to section-level freshness? (most recent line in section? average?)
• What about files not in git?
• Should the intensity of the glow be configurable?
• How does this interact with section folding — show age on folded headers?
• Privacy: showing author names — any concern in shared/public repos?

Why This Matters

Deeply developer-native feature, impossible outside an IDE extension. Stale rules in specs become visually obvious — a real pain point for teams.