Add radar lock and melee sweep to DevControlBot

The bot now drives its radar every tick. It still never moves and never
fires: body, turret and gun stay white ("not programmed"), while the
radar paints itself black at init to mark itself as working.

- modules/radar.nim replaces the earlier multi-module radar design with a
  single module holding the whole of it: target memory, mode selection
  and both commands
- two commands, picked from the only fact the bot is sure of (the API's
  getEnemyCount()): one enemy plus a target in hand -> LOCK, servo onto
  its bearing; anything else -> SWEEP at 45 deg/tick, the radar's physics
  cap, a full revolution every 8 ticks
- the lock turns by the delta to the target's bearing plus 5 deg PAST it,
  so the radar CROSSES the bearing every tick instead of settling on it.
  That crossing is what produces a fresh ScannedBotEvent every tick: a
  scan per tick, with no rescan to wait for. Turning by the bare error
  parks the radar on the bearing and the scans stop
- commandRadar() is called before go() on every path, so there is no idle
  branch to fall into and switching modes costs zero turns
- idea derived from ModularBot's radar (Apache-2.0) via common_libs/;
  common_libs/ is not edited in place
- AGENTS.md gains mermaid behaviour diagrams plus pointers to the physics
  and coordinate references
- version bumped to 1.1.0 in both DevControlBot.nimble and
  DevControlBot.json so the two agree

Compiled against robocode_tankroyale_botapi 1.0.7.

DevControlBot_garage/DevControlBot/DevControlBot.nim

@@ -1,14 +1,24 @@
-## DevControlBot — control skeleton: boots, stands still, does nothing.
+## DevControlBot — control skeleton: boots, stands still, and drives nothing but
+## the radar. It never moves and it never fires.
 ##
-## Team convention: white means "not programmed yet", so body, gun and radar are
-## all plain white. Colors are applied once at initialization, never per tick.
+## Team convention: white means "not programmed yet". At startup body, turret, gun
+## and radar are all plain WHITE. The radar then claims its OWN colours when it
+## starts working: initRadar() paints the radar and the scan arc BLACK, leaving
+## body/turret/gun white (this bot never moves and never fires, so they stay
+## "not programmed"). Colors are applied once, never per tick.
 ##
 ## This module is both the bot type and the program entry point (see isMainModule
-## below); there is no separate top-level DevControlBot.nim.
+## below). All radar logic lives in modules/radar.nim; the bot keeps no state.
+##
+## The run loop drives the radar: commandRadar() is called BEFORE go() every
+## tick, so the command is part of the tick's intent and is sent by THIS go().
+## The order matters — go() sends the intent first and dispatches the pending
+## events last, so onScannedBot only feeds the NEXT tick.
 ##
 ## API: robocode_tankroyale_botapi 1.0.7 (the renamed tankroyale_botapi package).
-import std/os
+import std/[os]
 import robocode_tankroyale_botapi
+import modules/radar
 
 type DevControlBot* = ref object of Bot
 
@@ -19,14 +29,24 @@ proc newDevControlBot*(): DevControlBot =
   setGunColor(WHITE)
   setRadarColor(WHITE)
 
+method onScannedBot*(bot: DevControlBot, e: ScannedBotEvent) =
+  onScan(e.x, e.y)                # remembered; commandRadar() re-aims every tick
+                                   # (e.scannedBotId, schemas.nim:305, is the
+                                   # scanned bot's identity; unused here)
+
 method run*(bot: DevControlBot) =
+  initRadar()                       # once: radar + scan turn BLACK = programmed
   while isRunning():
+    # One radar command per tick, unconditionally, BEFORE go() — so the command
+    # is part of this tick's intent and no tick is ever left without one.
+    commandRadar()
     go()
 
 when isMainModule:
   # argv[1] may override the metadata file (used by DevControlBot/DevControlBot.sh);
   # otherwise the JSON next to this source, resolved at compile time so any cwd works.
-  let jsonPath = if paramCount() >= 1: paramStr(1)
-                else: currentSourcePath().parentDir / "DevControlBot.json"
+  let jsonPath =
+    if paramCount() >= 1: paramStr(1)
+    else: currentSourcePath().parentDir / "DevControlBot.json"
   var bot = newDevControlBot()
   start(bot, jsonPath)