Error Codes

Reference for every code the validator can emit, generated from the validator's own shared/error-codes.json.

Code	Severity	Category	Message template	Spec ref
`ACTION_UNUSUAL_CARRIER`	warning	ball-possession	Defense player '{player}' performs {action}; unusual but allowed.	design §4-B
`BALL_AMBIGUOUS`	error	ball-possession	Action by '{player}' omits ball_id but {count} balls are in play.	design §4-B
`BALL_CARRIER_MISMATCH`	error	ball-possession	Player '{player}' performs {action} but does not carry ball '{ball_id}'.	design §4-B
`BALL_NOT_AT_LOCATION`	error	ball-possession	Player '{player}' performs {action} but no ball is available to pick up.	design §4-B
`CONTRAST_LOW`	warning	quality	color_scheme {ref} contrast {ratio} is below 4.5:1 (WCAG AA).	spec §780
`EMPTY_FRAME`	warning	quality	Frame '{ref}' has no actions and no state change.	design §4-D
`END_STATE_DISAGREE`	error	coherence	end_state for '{ref}' disagrees with action endpoint.	design §4-C
`ENTITY_OFFCOURT`	warning	quality	Coordinate ({x},{y}) lies outside the {ruleset} court.	design §4-D
`JSON_PARSE`	error	schema	File is not valid JSON: {detail}	design §5
`MODEL_LEGACY`	error	schema	Document uses the superseded geometric model (entity_states/lines). Use the action model (actions/balls/end_state).	design §1
`REF_BALL_UNKNOWN`	error	reference	References unknown ball '{ref}'.	design §4-A
`REF_BRANCH_TARGET_UNKNOWN`	error	reference	Branch outcome '{outcome}' targets unknown frame '{ref}'.	design §4-A
`REF_ENTITY_UNKNOWN`	error	reference	References unknown entity '{ref}'.	design §4-A
`REF_NAMED_POS_UNKNOWN`	error	reference	Unknown named position '{ref}'.	design §4-A
`SCHEMA_INVALID`	error	schema	Schema validation failed: {detail}	schema/v1.json
`START_STATE_DISCONTINUITY`	warning	coherence	start_state for '{ref}' differs from previous frame's end_state.	design §4-C