Skip to content

RFC: Clarify trace lifecycle and git rewrite semantics #25

@jonathansantilli

Description

@jonathansantilli

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:

  1. Provisional traces: workspace-time, may omit vcs.
  2. Final traces: revision-anchored, should include vcs.
  3. vcs.revision should be interpreted as snapshot semantics.
  4. For rebase/amend/squash/cherry-pick, producers should either re-emit for new revisions or document their mapping strategy.

Why This Should Be Added

  1. Reduces interoperability ambiguity without over-constraining implementations.
  2. Improves consistency in downstream attribution queries.
  3. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions