spec: issue-3639 Line ranges that point into the pushed code

Merged
JI
7h ago
+154-0

Summary

Each file entry of the Chainloop Trace session evidence has a list of line ranges. Today these ranges are the positions that each agent edit wrote, at the time of the edit. The CLI never adjusts them, so they do not point into any version of the file that a reader can open. This spec changes the ranges to point into the file at the pushed commit. Each range also gets an attribution, AI or human. A viewer can then mark the lines of a session in the pushed code.

This spec builds on the net contribution of docs/specs/issue-3639-trace-line-attribution.md and ships after its milestone 2.

Open questions for reviewers

None. The rollout order is in D-005 (open the schema one release before the CLI writes the property) and D-006 (the CLI writes attributed ranges before the platform reads them).

We would like two reviewers to approve this spec before it merges.

Refs #3639

AI disclosure: this spec was drafted with the assistance of Claude Code.

🤖 Generated with Claude Code