Skip to content

docs: add UPGRADING.md covering breaking changes since v0.30.0 - #401

Merged
osanderson merged 1 commit into
mainfrom
docs/upgrade-notes
Sep 27, 2026
Merged

osanderson merged 1 commit into
mainfrom
docs/upgrade-notes

Conversation

@osanderson

Copy link
Copy Markdown
Collaborator

Summary

Adds UPGRADING.md: every breaking change from v0.30.0 through v0.38.0, newest first, each with who it affects, why it exists, and the exact change needed. Linked from the README's Contributing section.

  • Code snippets for the three changes most likely to need real integration work: the v0.37.0 AuthorizationCallback.Session cookie binding, v0.37.0 keys.DeclareCustody, and v0.36.0 X5CAttesterChain.IssuerBinding.
  • Production-only changes are marked, so a development-assurance setup can skip them.
  • Notes that the v0.31.0 KeySourceAssurance gate was breaking under production despite not being flagged in that release's changelog.
  • Covers v0.38.0 (release PR chore(main): release 0.38.0 #400) ahead of its tag.

Every type, field, constructor and contract-test name used was checked against the current code.

🤖 Generated with Claude Code

https://claude.ai/code/session_01GMAyPYDPGpfnwow3JLeooZ

One page per breaking change from v0.30.0 to v0.38.0: who it affects,
why it exists, and the code change needed, with snippets for the
session-handle cookie binding, key custody declaration and
X5CAttesterChain issuer binding. Linked from the README.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov

codecov Bot commented Sep 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@sonarqubecloud

Copy link
Copy Markdown

@osanderson
osanderson merged commit 7a56646 into main Sep 27, 2026
9 checks passed
@osanderson
osanderson deleted the docs/upgrade-notes branch September 27, 2026 14:48
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.

1 participant