Trace emission timing and history-rewrite behavior are currently implementation-defined, which makes consumer behavior diverge.
Problem
Without shared guidance, producers and consumers interpret lifecycle and revision anchoring differently.
Proposal
Add documentation clarifying:
- Provisional traces: workspace-time, may omit
vcs.
- Final traces: revision-anchored, should include
vcs.
vcs.revision should be interpreted as snapshot semantics.
- For rebase/amend/squash/cherry-pick, producers should either re-emit for new revisions or document their mapping strategy.
Why This Should Be Added
- Reduces interoperability ambiguity without over-constraining implementations.
- Improves consistency in downstream attribution queries.
- Keeps the spec minimal by clarifying interpretation rather than mandating infrastructure.
Compatibility
Documentation-only clarification; no schema break.
Scope
This clarifies interpretation of revision-anchored attribution. It does not define a universal rewrite-mapping protocol.
Trace emission timing and history-rewrite behavior are currently implementation-defined, which makes consumer behavior diverge.
Problem
Without shared guidance, producers and consumers interpret lifecycle and revision anchoring differently.
Proposal
Add documentation clarifying:
vcs.vcs.vcs.revisionshould be interpreted as snapshot semantics.Why This Should Be Added
Compatibility
Documentation-only clarification; no schema break.
Scope
This clarifies interpretation of revision-anchored attribution. It does not define a universal rewrite-mapping protocol.