graphql schema compatibility derived

{
  "input": {
    "body": {
      "after": "type Query {\n  order(id: ID!, tenant: ID!): Order\n  orders(first: Int = 50): [Order!]!\n}\n\ntype Mutation {\n  createOrder(input: OrderInput!): Order!\n}\n\nenum Status { OPEN ARCHIVED }\n\ninput OrderInput {\n  status: Status\n  note: String\n  tenant: ID!\n}\n\ntype Order {\n  id: ID!\n  status: Status!\n  totalCents: Int\n  channel: String!\n}\n",
      "before": "type Query {\n  order(id: ID!): Order\n  orders(first: Int = 20): [Order!]!\n}\n\ntype Mutation {\n  createOrder(input: OrderInput!): Order!\n}\n\nenum Status { OPEN CLOSED }\n\ninput OrderInput {\n  status: Status\n  note: String\n}\n\ntype Order {\n  id: ID!\n  status: Status!\n  totalCents: Int!\n  note: String\n}\n"
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "limits": {
        "maxFindings": 500,
        "maxSdlBytes": 262144,
        "maxVersions": 25,
        "maxAvroBytes": 262144,
        "maxConsumers": 50,
        "maxProtoBytes": 262144,
        "maxPathsPerConsumer": 200
      },
      "passed": false,
      "complete": true,
      "findings": [
        {
          "code": "REQUIRED_ARGUMENT_ADDED",
          "type": "Query",
          "field": "order",
          "detail": "Query.order(tenant) is new, non-null and has no default, so every existing query on order stops validating.",
          "argument": "tenant",
          "audience": "clients"
        },
        {
          "code": "ARGUMENT_DEFAULT_CHANGED",
          "type": "Query",
          "field": "orders",
          "detail": "Query.orders(first) default went from 20 to 50, so a query that omits it gets a different answer without changing.",
          "argument": "first",
          "audience": "clients"
        },
        {
          "code": "ENUM_VALUE_REMOVED",
          "type": "Status",
          "value": "CLOSED",
          "detail": "Status.CLOSED is gone and Status is returned to clients, so a client with a case for CLOSED now receives a value it has no branch for, or none at all.",
          "audience": "clients"
        }
      ],
      "compatible": false,
      "request_id": "example-request",
      "service_id": "graphql_schema_compatibility",
      "assumptions": [
        "Every finding names the audience it affects. A GraphQL schema is a contract in two directions: clients consume it and servers implement it, and the same edit breaks opposite audiences. Removing an out...",
        "Nullability is directional. An output field made non-null is safe for clients and new work for servers; an input field made non-null is the reverse. Both are reported under the audience that bears the...",
        "An enum value removed is attributed by where the enum actually flows, computed from the roots of the previous schema, because the same removal breaks clients when the enum is returned and callers when..."
      ],
      "limitations": [
        "The two SDL documents supplied, as a documented subset. Type extensions and directive definitions are recognised and listed as not compared, and no query document is validated.",
        "compatible is true only when everything was compared and neither audience was affected. The two audience flags are published separately so a caller who only ships clients can read theirs."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "not_examined": [],
      "finding_count": 9,
      "service_version": "1.0.0",
      "after_type_count": 5,
      "findings_by_code": {
        "FIELD_ADDED": 1,
        "FIELD_REMOVED": 1,
        "ENUM_VALUE_REMOVED": 1,
        "REQUIRED_ARGUMENT_ADDED": 1,
        "ARGUMENT_DEFAULT_CHANGED": 1,
        "ENUM_VALUE_ADDED_TO_OUTPUT": 1,
        "OUTPUT_FIELD_MADE_NULLABLE": 1,
        "REQUIRED_INPUT_FIELD_ADDED": 1,
        "ENUM_VALUE_REMOVED_FROM_INPUT": 1
      },
      "before_type_count": 5,
      "clients_unaffected": false,
      "servers_unaffected": false,
      "client_finding_count": 7,
      "server_finding_count": 2
    }
  }
}