Skip to content

Transitions - #2

Draft
reuvenharrison wants to merge 2 commits into
mainfrom
transitions
Draft

Transitions#2
reuvenharrison wants to merge 2 commits into
mainfrom
transitions

Conversation

@reuvenharrison

Copy link
Copy Markdown
Contributor

Adds the transitions section, answering the review comment that they were unrepresented: the five multi-edit shapes recognized as one semantic change (boolean-false-schema, list-of-types, null-only-type-change, nullable-wrapping, oneof-wrapping), each with its description, the kinds of raw findings it suppresses at its shape, and the changes that report it.

Naming: the model spells the suppressed kinds claimed_kinds rather than claims, since change claims are locations and the two concepts should not share a word. README and SPEC.md gain the corresponding explanations; SPEC.md's transitions section states the conservation property (nothing is silently dropped; the finding moves from the echoes to the recognition).

The generator is pinned to the oasdiff commit that exports transition metadata (oasdiff#1225); generated_from shows the pseudo-version honestly until the next oasdiff release, and the exclusive-bounds catalog (oasdiff#1226) will follow in its own PR once merged.

reuvenharrison and others added 2 commits September 6, 2026 00:52
The multi-edit shapes recognized as one semantic change join the file:
name, description, the kinds of raw findings each suppresses at its
shape, and the changes that report it. Their claimed kinds are named
claimed_kinds, not claims, since change claims are locations and the
two should not share a word. Generator pinned to the oasdiff commit
that exports transition metadata.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QDvUFsg5nu1NBWQffErGDw
@reuvenharrison
reuvenharrison marked this pull request as draft September 5, 2026 21:56
@reuvenharrison

Copy link
Copy Markdown
Contributor Author

Held as draft until the next oasdiff release: the generator currently pins a pseudo-version of main (for the transitions export), and the model should only publish against released oasdiff versions. When the next release ships, the pin moves to the tag and this merges.

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