json schema migration impact derived

{
  "input": {
    "body": {
      "role": "producers",
      "after": {
        "type": "object",
        "required": [
          "email"
        ],
        "properties": {
          "age": {
            "type": "integer",
            "minimum": 18
          },
          "tier": {
            "enum": [
              "free",
              "pro"
            ],
            "type": "string"
          },
          "email": {
            "type": "string",
            "format": "email"
          }
        }
      },
      "before": {
        "type": "object",
        "properties": {
          "age": {
            "type": "integer"
          },
          "tier": {
            "type": "string"
          },
          "email": {
            "type": "string"
          }
        }
      },
      "documents": [
        {
          "age": 30,
          "tier": "pro",
          "email": "a@example.com"
        },
        {
          "age": 16,
          "tier": "free",
          "email": "b@example.com"
        },
        {
          "age": 40,
          "tier": "free",
          "email": "not-an-email"
        },
        {
          "age": 25,
          "tier": "enterprise"
        },
        {
          "age": 22,
          "tier": "pro",
          "email": "d@example.com"
        }
      ]
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "role": "producers",
      "limits": {
        "maxLines": 2000,
        "maxHeaders": 100,
        "maxFindings": 500,
        "maxPointers": 2000,
        "maxTextBytes": 262144,
        "maxBatchItems": 500,
        "maxDocumentBytes": 262144
      },
      "complete": true,
      "evidence": {
        "valid_after": 2,
        "valid_before": 5,
        "document_count": 5,
        "newly_accepted": 0,
        "newly_rejected": 3,
        "rejection_rate": 0.6,
        "breaking_constraints": [
          {
            "code": "BELOW_MINIMUM",
            "example": "16 violates minimum 18.",
            "pointer": "/age",
            "documents": 1
          },
          {
            "code": "FORMAT_MISMATCH",
            "example": "Does not look like a email.",
            "pointer": "/email",
            "documents": 1
          },
          {
            "code": "REQUIRED_PROPERTY_MISSING",
            "example": "Required property email is absent.",
            "pointer": "/email",
            "documents": 1
          }
        ]
      },
      "findings": [
        {
          "code": "DOCUMENT_NEWLY_REJECTED",
          "detail": "Document 1 satisfies the before schema and is rejected by the after schema.",
          "errors": [
            {
              "code": "BELOW_MINIMUM",
              "detail": "16 violates minimum 18.",
              "pointer": "/age"
            }
          ],
          "document": 1
        },
        {
          "code": "DOCUMENT_NEWLY_REJECTED",
          "detail": "Document 2 satisfies the before schema and is rejected by the after schema.",
          "errors": [
            {
              "code": "FORMAT_MISMATCH",
              "detail": "Does not look like a email.",
              "pointer": "/email"
            }
          ],
          "document": 2
        },
        {
          "code": "DOCUMENT_NEWLY_REJECTED",
          "detail": "Document 3 satisfies the before schema and is rejected by the after schema.",
          "errors": [
            {
              "code": "REQUIRED_PROPERTY_MISSING",
              "detail": "Required property email is absent.",
              "pointer": "/email",
              "property": "email"
            },
            {
              "code": "NOT_IN_ENUM",
              "detail": "\"enterprise\" is not one of the 2 permitted values.",
              "pointer": "/tier"
            }
          ],
          "document": 3
        }
      ],
      "request_id": "example-request",
      "service_id": "json_schema_migration_impact",
      "assumptions": [
        "The supplied documents stand in for real traffic. A change that breaks nothing in this batch may still break a payload the batch does not contain.",
        "A document counted as newly rejected satisfied the before schema and fails the after schema, which is the only comparison that isolates the effect of the change."
      ],
      "limitations": [
        "Impact over the batch supplied, plus the schema-level verdict. Neither alone decides a release, which is why both are returned.",
        "safe_to_ship is true only when the schema change breaks nobody for the stated role, no supplied payload regressed, and nothing was left unexamined."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "not_examined": [],
      "safe_to_ship": false,
      "finding_count": 3,
      "schema_verdict": {
        "findings": [
          {
            "code": "REQUIRED_PROPERTY_ADDED",
            "breaks": [
              "producers"
            ],
            "detail": "email is now required, so a sender that omitted it now fails.",
            "pointer": "/email",
            "property": "email",
            "severity": "breaking"
          },
          {
            "to": "email",
            "code": "FORMAT_ADDED",
            "breaks": [
              "producers"
            ],
            "detail": "A format of email was added.",
            "pointer": "/email",
            "severity": "risky"
          },
          {
            "to": 18,
            "code": "BOUND_ADDED",
            "breaks": [
              "producers"
            ],
            "detail": "minimum 18 was added where the value was unbounded.",
            "keyword": "minimum",
            "pointer": "/age/minimum",
            "severity": "breaking"
          }
        ],
        "compatible": false,
        "risky_count": 1,
        "breaking_count": 3,
        "unclassified_count": 0
      },
      "service_version": "1.0.0",
      "findings_by_code": {
        "DOCUMENT_NEWLY_REJECTED": 3
      }
    }
  }
}