Classify Player Roles

Classify each team player's positional role based on where they spent time during the demo: defender / 2nd_defender / middle / 2nd_attacker / attacker (scaled to actual team size). For CTF, provide the 'map' argument so flag positions can be read from the BSP entity lump — this yields an accurate forward axis. Without a map, the tool falls back to ranking players by their centroid distance toward the enemy team spawn cluster. Only the POV player's trace is always complete; other players have sparse traces (see generate_player_heatmap notes). Call open_demo first to get a session_id.