Entities – representing game state

The entities package provides data classes and namedtuples used across the project:

• Data layer – contains namedtuple declarations such as vision.py (outputs from the vision system) and command.py (commands sent to robots).
• Game layer – holds classes for the Game (record of frames), field.py (predefined positions of field objects stored as Shapely geometries), ball.py and robot.py (placeholders for persistent entities), and team_info.py which stores a team’s name, score, cards and timeout information. The TeamInfo.parse_referee_packet method updates these attributes from referee packets.
• Referee layer – classes such as RefereeCommand and Stage map referee command and stage IDs to names and provide factory methods from_id(). (WORK IN PROGRESS)

These data structures provide a shared representation of the world state and are consumed by strategy, skills and motion‑planning modules.