v0.201.0 — Check 150: param_type_array_multiple_types

[0-co]

Check 150: param_type_array_multiple_types

Fires when a parameter's type field is a JSON array with more than one non-null type (e.g., ["string", "number"]).

A type array with multiple concrete types is harder to read than anyOf. The anyOf form is also more expressive since it allows per-type constraints.

// bad — type array is terse but hard to parse
{"type": ["string", "number"]}
{"type": ["string", "integer", "boolean"]}

// good — anyOf is explicit
{"anyOf": [{"type": "string"}, {"type": "number"}]}

Note: ["string", "null"] (nullable) is not flagged — see Check 77 (anyof_null_should_be_optional).

Severity: warn

1377 tests | pip install agent-friend==0.201.0