Skip to content

docs(idea): add history discontinuity concept to lockfiles#258

Open
dmcilvaney wants to merge 2 commits into
microsoft:mainfrom
dmcilvaney:damcilva/rfc/lockfile_discontinuity
Open

docs(idea): add history discontinuity concept to lockfiles#258
dmcilvaney wants to merge 2 commits into
microsoft:mainfrom
dmcilvaney:damcilva/rfc/lockfile_discontinuity

Conversation

@dmcilvaney

Copy link
Copy Markdown
Contributor

This was originally deferred until we needed it for branch changes, but recently we discovered that some dist-gits rewrite their history, we need a mechanism to bridge discontinuities in linear history.

Copilot AI review requested due to automatic review settings June 29, 2026 20:59

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new developer-facing design sketch proposing a lockfile-based mechanism to preserve synthetic history across upstream history rewrites (force-push) and distro branch advances with divergent history, so %autorelease/%autochangelog remain monotonic and prior changelog eras aren’t silently dropped.

Changes:

  • Documented the failure mode in the current synthetic-history pipeline when pinned commits become unreachable.
  • Proposed a “transition” record in lock files to explicitly bridge discontinuities, plus UX guardrails (update --allow-discontinuity) and render-time validation.
  • Included a TOML example and pointers to current implementation hotspots for future work.

Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 29, 2026 21:24

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md
Comment thread docs/developer/ideas/lockfile-history-discontinuity-bridging.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants