|
| 1 | +--- |
| 2 | +title: Enhanced Schema Change Detection with Directive Support and Input Value Tracking |
| 3 | +description: |
| 4 | + A major upgrade to change detection, with more accurate severity levels and directive support. |
| 5 | +date: 2025-11-27 |
| 6 | +authors: [jdolle] |
| 7 | +--- |
| 8 | + |
| 9 | +Breaking change detection is complicated, but it's an incredibly valuable tool for any API. In our |
| 10 | +latest release, we upgraded this detection to make breaking changes even more accurate and provide a |
| 11 | +more complete set of changes for schema checks. |
| 12 | + |
| 13 | +These have been highly requested features, but our hope is that this change goes mostly unnoticed |
| 14 | +because that means it's working and that the changes are tracked accurately. |
| 15 | + |
| 16 | +The technical set of changes are: |
| 17 | + |
| 18 | +- `FieldDeprecationRemoved` severity is changing from "dangerous" to "non-breaking". This is because |
| 19 | + deprecation does not impact behavior. |
| 20 | +- `InputFieldAdded` is now "non-breaking" IF a default value is set for the input. Previously only |
| 21 | + nullability was taken into account. This is because the default value will be provided |
| 22 | + automatically, so non-nullable inputs still don't need passed by clients. |
| 23 | +- A redundant DeprecationAdded and DeprecationRemoved change was removed. |
| 24 | +- And `DirectiveUsage` changes are being tracked. E.g. `DirectiveUsageEnumRemoved` and |
| 25 | + `DirectiveUsageObjectAdded`. A similar set of usage events were added for arguments as well. |
| 26 | + |
| 27 | +--- |
| 28 | + |
| 29 | +This upgrade also lays the foundation for the upcoming feature, schema proposals, which is powered |
| 30 | +by [GraphQL Inspector](https://the-guild.dev/graphql/inspector) for change capture and rebasing |
| 31 | +changes on top of schemas. |
| 32 | + |
| 33 | +For more insights on the schema proposals work being done, refer to our |
| 34 | +[Schema Proposal Review](https://the-guild.dev/graphql/hive/product-updates/2025-09-03-schema-proposals) |
| 35 | +update. |
0 commit comments