surf: wire the dormant wave surfer as TR_MOVEMENT=surf + fix 4 real defects

common_libs/movements/wave_surfer.nim was written in an early session and
never wired to the bot. This connects it exactly like tfil/strafe and fixes
the defects a full read found:

  1. the dodge direction was INVERTED: the perpendicular was built from the
     bot->enemy bearing while GF lives in the enemy->bot frame, so the bot
     moved toward MORE danger. Now built from the wave's origin->bot bearing:
     +90 provably increases GF.
  2. the danger histogram was never reset (resetRound cleared waves only), so
     it was a battle-long static average. Now reset to the uniform prior each
     round.
  3. fire detection tracked only the current target's energy via one scalar;
     now per-enemy (seq[(id,energy)]) so melee target switches cannot invent
     or hide waves.
  4. the wall penalty projected a point from the wave origin, not from the
     bot, making the wall test meaningless. Now projects the bot->candidate
     direction.

Wave speed uses the actual firepower (the one-tick energy drop IS the
firepower, so speed = 20 - 3*drop is exact). Adds TR_SURF_* knobs and
registers them in the env report. Shipped TR_MOVEMENT=tfil default untouched
(test_tfil_commit_env: 30/30 pass; test_env_report: pass).

ModularBot_garage/src/ModularBot.nim

@@ -34,6 +34,7 @@ import movements/ram_decision
 import movements/the_floor_is_lava
 import movements/the_floor_is_lava_ring
 import movements/strafe
+import movements/wave_surfer
 import movement_harness/virtual_bodies as mvb
 import movement_harness/bullet_shadows
 import targeting/enemy_tracker
@@ -202,6 +203,7 @@ type
     mover:        TFILModule
     ringMover:    TFILRingModule
     strafeMover:  StrafeModule
+    surfMover:    WaveSurferModule
     rammer:       RammerModule
     isRamming:    bool
     ramDurationTicks: int
@@ -342,6 +344,8 @@ proc printConfig(bot: ModularBot, forceAll: bool = false) =
       if bot.isRamming: "strafe(ram)" else: "strafe"
     elif MovementName == "tfil_ring":
       if bot.isRamming: "tfil_ring(ram)" else: "tfil_ring"
+    elif MovementName == "surf":
+      if bot.isRamming: "surf(ram)" else: "surf"
     elif bot.isRamming: "rammer"
     else: "tfil"
   var line = "[config] "
@@ -591,6 +595,7 @@ method onBulletHitWall*(bot: ModularBot, e: BulletHitWallEvent) =
   bot.mover.removeBulletNear(e.bullet.x, e.bullet.y)
   bot.ringMover.removeBulletNear(e.bullet.x, e.bullet.y)
   bot.strafeMover.removeBulletNear(e.bullet.x, e.bullet.y)
+  bot.surfMover.removeBulletNear(e.bullet.x, e.bullet.y)
 
 method onBulletHitBullet*(bot: ModularBot, e: BulletHitBulletEvent) =
   discard bot.resolveOwnBullet(e.bullet.bulletId)  # bullet-vs-bullet: free the slot
@@ -599,6 +604,7 @@ method onBulletHitBullet*(bot: ModularBot, e: BulletHitBulletEvent) =
   bot.mover.removeBulletNear(e.bullet.x, e.bullet.y)
   bot.ringMover.removeBulletNear(e.bullet.x, e.bullet.y)
   bot.strafeMover.removeBulletNear(e.bullet.x, e.bullet.y)
+  bot.surfMover.removeBulletNear(e.bullet.x, e.bullet.y)
 
 method onHitByBullet*(bot: ModularBot, e: HitByBulletEvent) =
   # Feeds the ram bullet-rain abort window. Accumulate REAL ENERGY (the server's
@@ -826,6 +832,7 @@ method onRoundStarted*(bot: ModularBot, e: RoundStartedEvent) =
   bot.mover.resetRound()
   bot.ringMover.resetRound()
   bot.strafeMover.resetRound()
+  bot.surfMover.resetRound()
   bot.enemyTracker.resetRound()
   # The TM pattern gun is cold every round (no cross-battle persistence): wipe
   # its clause teams and motion history explicitly, so a same-id opponent in the
@@ -1104,6 +1111,8 @@ method run*(bot: ModularBot) =
     var spd, tr: float
     if MovementName == "strafe" and not shouldRam:
       (spd, tr) = bot.strafeMover.computeMove(ws)
+    elif MovementName == "surf" and not shouldRam:
+      (spd, tr) = bot.surfMover.computeMove(ws)
     elif MovementName == "tfil_ring":
       bot.ringMover.band =
         if shouldRam: (lo: 0.0, hi: 50.0)
@@ -1409,6 +1418,7 @@ when isMainModule:
     mover:        TFILModule(debugGraphics: true),
     ringMover:    TFILRingModule(debugGraphics: true),
     strafeMover:  StrafeModule(debugGraphics: true),
+    surfMover:    initWaveSurfer(),
     rammer:       initRammer(),
     moveTracker:  mvb.initVirtualBodyTracker(1),
     currentGun:   -1,

ModularBot_garage/src/env_report.nim

@@ -26,6 +26,7 @@ import movements/ram_decision
 import movements/the_floor_is_lava
 import movements/the_floor_is_lava_ring
 import movements/strafe
+import movements/wave_surfer
 import guns/tm_horizon
 import guns/bitbrain_gun
 import guns/pattern_matcher
@@ -181,6 +182,7 @@ proc printEffectiveValues(ctx: EnvReportContext) =
   let effectiveMovement =
     if ctx.movementName == "tfil_ring": "tfil_ring"
     elif ctx.movementName == "strafe": "strafe"
+    elif ctx.movementName == "surf": "surf"
     else: "tfil"
   emit("TR_MOVEMENT", effectiveMovement, sourceOf("TR_MOVEMENT"))
   emit("TR_MOVEMENT_LOG", onOff(MovementLog), sourceOfPresence("TR_MOVEMENT_LOG"))
@@ -293,6 +295,13 @@ proc printEffectiveValues(ctx: EnvReportContext) =
   emit("TR_STRAFE_WALL_HOTNESS", $StrafeWallHotness, sourceOf("TR_STRAFE_WALL_HOTNESS"))
   emit("TR_STRAFE_WALL_RADIANCE", $StrafeWallRadiance, sourceOf("TR_STRAFE_WALL_RADIANCE"))
 
+  # ── movement (WAVE SURFER) ────────────────────────────────────────────────
+  emit(SurfPrefDistEnv, $SurfPrefDist, sourceOf(SurfPrefDistEnv))
+  emit(SurfDistBandEnv, $SurfDistBand, sourceOf(SurfDistBandEnv))
+  emit(SurfWallMarginEnv, $SurfWallMargin, sourceOf(SurfWallMarginEnv))
+  emit(SurfRadialFracEnv, $SurfRadialFrac, sourceOf(SurfRadialFracEnv))
+  emit(SurfLogEnv, onOff(SurfLog), sourceOfPresence(SurfLogEnv))
+
   # ── ramming ───────────────────────────────────────────────────────────────
   emit("TR_RAM_OPPORTUNITY", onOff(RamOppEnabled), sourceOf("TR_RAM_OPPORTUNITY"))
   emit("TR_RAM_OPP_DIST", $RamOppDist, sourceOf("TR_RAM_OPP_DIST"))
@@ -453,6 +462,8 @@ proc knownEnvNames*(): seq[string] =
     "TR_STRAFE_HEAT_GRID", "TR_STRAFE_BULLET_CORE", "TR_STRAFE_BULLET_AURA",
     "TR_STRAFE_CORRIDOR_HEAT", "TR_STRAFE_WALL_HOTNESS",
     "TR_STRAFE_WALL_RADIANCE",
+    SurfPrefDistEnv, SurfDistBandEnv, SurfWallMarginEnv, SurfRadialFracEnv,
+    SurfLogEnv,
     # harness vars (read by the test framework, inherited by the bot, so they
     # must NOT be reported as typos)
     "TR_SERVER_JAR", "TR_BATTLE_RUNNER", "TR_BATTLE_RUNNER_DIR",