[
  {
    "id": "cli-option.generate-schema-validators",
    "kind": "cli-option",
    "message": "Schema-derived runtime validators are experimental and may change as JSON Schema coverage is expanded.",
    "note": "The option currently targets Pydantic v2 BaseModel output and covers selected object-level rules such as patternProperties, required-only oneOf/anyOf groups, and simple if/then/else required-property conditions.",
    "since_version": "0.66.1",
    "target": "--generate-schema-validators",
    "tracking_issue": null
  },
  {
    "id": "cli-option.schema-validator-type",
    "kind": "cli-option",
    "message": "Schema-derived runtime validator backend selection is experimental and may change as validation backends are added.",
    "note": "The only currently implemented backend is 'pydantic-v2', which preserves the existing generated Pydantic v2 validator behavior.",
    "since_version": "0.66.1",
    "target": "--schema-validator-type",
    "tracking_issue": null
  },
  {
    "id": "cli-option.use-missing-sentinel",
    "kind": "cli-option",
    "message": "Pydantic MISSING sentinel output is experimental because it depends on pydantic.experimental.missing_sentinel.",
    "note": "The option requires Pydantic v2 BaseModel output and a target Pydantic version that supports the MISSING sentinel.",
    "since_version": "0.66.1",
    "target": "--use-missing-sentinel",
    "tracking_issue": null
  },
  {
    "id": "cli-option.use-type-alias",
    "kind": "cli-option",
    "message": "Type alias output is experimental and may change as Python typing support evolves.",
    "note": "The option replaces root model classes with type aliases where possible. Pydantic v2 output may use TypeAliasType or Python 3.12 type statements depending on the target Python version.",
    "since_version": "0.36.0",
    "target": "--use-type-alias",
    "tracking_issue": null
  },
  {
    "id": "formatter.builtin",
    "kind": "formatter",
    "message": "The internal formatter is experimental and may change as generated-output coverage is expanded.",
    "note": "The formatter is designed for generated model modules and is not a general-purpose Python formatter.",
    "since_version": "0.59.0",
    "target": "--formatters builtin",
    "tracking_issue": null
  },
  {
    "id": "input-format.asyncapi",
    "kind": "input-format",
    "message": "AsyncAPI input support is experimental and may change as real-world usage is validated.",
    "note": "The parser focuses on message payload model generation from AsyncAPI documents.",
    "since_version": "0.59.0",
    "target": "--input-file-type asyncapi",
    "tracking_issue": null
  },
  {
    "id": "input-format.avro",
    "kind": "input-format",
    "message": "Apache Avro schema input support is experimental and may change as real-world usage is validated.",
    "note": "The parser generates Python models from Avro schemas; it does not provide Avro runtime validation.",
    "since_version": "0.59.0",
    "target": "--input-file-type avro",
    "tracking_issue": null
  },
  {
    "id": "input-format.mcp-tools",
    "kind": "input-format",
    "message": "MCP tool schema profile input support is experimental and may change as MCP schemas evolve.",
    "note": "The input is converted from MCP tool inputSchema/outputSchema entries into JSON Schema definitions before model generation.",
    "since_version": "0.60.0",
    "target": "--input-file-type mcp-tools",
    "tracking_issue": null
  },
  {
    "id": "input-format.protobuf",
    "kind": "input-format",
    "message": "Protocol Buffers input support is experimental and may change as real-world usage is validated.",
    "note": "The parser generates Python models from .proto schemas; it does not provide protobuf runtime validation or gRPC code generation.",
    "since_version": "0.59.0",
    "target": "--input-file-type protobuf",
    "tracking_issue": null
  },
  {
    "id": "input-format.xmlschema",
    "kind": "input-format",
    "message": "XML Schema input support is experimental and may change as real-world usage is validated.",
    "note": "The parser focuses on model generation from XSD documents, not full XML instance validation.",
    "since_version": "0.59.0",
    "target": "--input-file-type xmlschema",
    "tracking_issue": null
  }
]
