-
Notifications
You must be signed in to change notification settings - Fork 48
Open
Description
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.revisionshould 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.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels