Describe Map

Analyse a BSP map (from a pk3 or direct .bsp file) and return a JSON MapSpec that describes its geometry and entities. What is extracted: • worldspawn settings: sky, gravity, ambient, music, name • All game entities verbatim (weapons, spawns, flags, teleporters, …) • Rooms: detected by pairing floor surfaces (normal ≈ +Z) with ceiling surfaces (normal ≈ −Z) that share the same XY footprint. Each matched pair becomes one RoomSpec with mins/maxs, floor_texture, ceil_texture, and wall_texture. The returned spec can be fed directly to generate_map to produce a geometrically similar BSP (roundtrip is lossless for simple axis-aligned maps; complex maps are approximated as rectangular rooms). Typical workflow: 1. describe_map("cpma1") → inspect / tweak the spec JSON 2. generate_map(spec) → new .bsp that resembles cpma1 3. Use new .bsp in demos