dotbot/console-web: unified web console for control + orchestration

.github/workflows/continuous-integration.yml

@@ -118,8 +118,37 @@ jobs:
         name: frontend
         path: ./dotbot/frontend/build
 
+  console:
+    name: check console
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up nodejs
+      uses: actions/setup-node@v4
+      with:
+        node-version: "20"
+    - run: npm install
+      working-directory: ./dotbot/console-web
+    - run: npm run lint
+      working-directory: ./dotbot/console-web
+    - run: npm run typecheck
+      working-directory: ./dotbot/console-web
+    - run: npm run test
+      working-directory: ./dotbot/console-web
+    - run: npm run build
+      working-directory: ./dotbot/console-web
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        verbose: true
+    - name: Upload console build
+      uses: actions/upload-artifact@v4
+      with:
+        name: console
+        path: ./dotbot/console-web/dist
+
   package:
-    needs: [test, doc, frontend, control_loop]
+    needs: [test, doc, frontend, console, control_loop]
     name: build source package
     runs-on: ${{ matrix.os }}
     strategy:

.gitignore

@@ -9,6 +9,7 @@
 *.log
 *.egg-info/
 .coverage
+coverage/
 .tox/
 dist/
 node_modules/

dotbot/__init__.py

@@ -17,6 +17,7 @@
 MQTT_PORT_DEFAULT = 1883
 MAP_SIZE_DEFAULT = "2000x2000"  # in mm unit
 SIMULATOR_INIT_STATE_DEFAULT = "simulator_init_state.toml"
+SWARMIT_URL_DEFAULT = "http://localhost:8001"  # swarmit server default port
 
 
 def pydotbot_version() -> str:

dotbot/config.py

@@ -145,6 +145,7 @@ class ControllerSection(_Strict):
     headless: bool | None = None
     gw_address: str | None = None
     simulator_init_state: str | None = None
+    swarmit_url: str | None = None
 
 
 class GatewaySection(_Strict):
@@ -292,11 +293,13 @@ def _env_candidates(section: str | None, key: str) -> tuple[str, ...]:
     """Env-var names to check, in priority order (Cargo's mechanical mapping).
 
     Sectioned key -> `DOTBOT_<SECTION>_<KEY>`, then the shared `DOTBOT_<KEY>`
-    alias. Top-level key -> just `DOTBOT_<KEY>`.
+    alias. Top-level key -> just `DOTBOT_<KEY>`. A nested section like
+    `run.controller` flattens its dots: `DOTBOT_RUN_CONTROLLER_<KEY>`.
     """
     key_part = key.upper().replace("-", "_")
     if section:
-        return (f"DOTBOT_{section.upper()}_{key_part}", f"DOTBOT_{key_part}")
+        section_part = section.upper().replace(".", "_")
+        return (f"DOTBOT_{section_part}_{key_part}", f"DOTBOT_{key_part}")
     return (f"DOTBOT_{key_part}",)
 
 
@@ -318,11 +321,17 @@ def _file_value(
     key: str,
     deployment: Deployment | None,
 ) -> Any:
-    """The value this key has in the file layer: section > deployment > top-level."""
+    """The value this key has in the file layer: section > deployment > top-level.
+
+    `section` may be nested (dot-separated, e.g. `run.controller`); each part
+    is walked with getattr.
+    """
     if config is None:
         return None
     if section is not None:
-        section_obj = getattr(config, section, None)
+        section_obj: Any = config
+        for part in section.split("."):
+            section_obj = getattr(section_obj, part, None)
         value = getattr(section_obj, key, None)
         if value is not None:
             return value
@@ -348,9 +357,10 @@ def resolve(
     `flag` > env (`DOTBOT_<SECTION>_<KEY>`, then shared `DOTBOT_<KEY>`) >
     file (section > deployment > top-level) > `default`.
 
-    `section` is one of `SECTIONS` for a per-namespace key, or `None` for a
-    top-level shared key (e.g. `conn`, `swarm_id`). Env values are coerced to
-    the type of `default`.
+    `section` is one of `SECTIONS` for a per-namespace key, a dotted path for
+    a nested table (e.g. `run.controller`), or `None` for a top-level shared
+    key (e.g. `conn`, `swarm_id`). Env values are coerced to the type of
+    `default`.
     """
     if flag is not None:
         return flag

dotbot/console-web/dev/TESTING.md

@@ -0,0 +1,81 @@
+# Console manual test guide
+
+Start the stack (three terminals, from the workspace root, venv active):
+
+```bash
+PYTHONPATH=repos/wt-PyDotBot-unified-web-ui dotbot run simulator --headless \
+  --simulator-init-state repos/wt-PyDotBot-unified-web-ui/dotbot/console-web/dev/simulator_init_state.toml
+
+python repos/wt-PyDotBot-unified-web-ui/dotbot/console-web/dev/fake_swarmit_server.py
+
+npm --prefix repos/wt-PyDotBot-unified-web-ui/dotbot/console-web run start
+```
+
+Open http://localhost:5173. Handy URL params: `?sel=1111` (preselect),
+`?view=list|grid`, `?rail=testbed|missions`, `?theme=light`.
+
+If the title bar says OFFLINE: the vite proxy targets do not match where the
+controller runs. `curl localhost:5173/controller/dotbots` must return bots.
+
+## Checklist
+
+Map + selection
+- [ ] Title bar: LIVE (green pulse), bot count; Dark|Light toggle flips theme
+- [ ] Bots move smoothly; heading pointer at the circle edge; battery bar above
+- [ ] Plain drag pans (clamped); plain click clears selection
+- [ ] Shift-drag marquee selects; shift-click toggles one bot
+- [ ] Click bot: red rectangle + id chip; hover another bot: chip appears
+- [ ] Zoom +/-/recenter; arena keeps margins when rail opens or window resizes
+- [ ] Layers panel: Battery Bars / Waypoints / DotBots / Real-scale / Trails toggle live
+
+Footer (bottom strip)
+- [ ] Nothing selected: N/1000 + per-state rollup; click a state row selects those bots
+- [ ] One bot: LED thumb, short id, device, Drivable pill, state, battery, "x, y mm"
+- [ ] Ghost bot (0001/0002): "Not drivable" pill, dock grayed, warning hint
+- [ ] Multi: "N selected", per-state mini-rollup, dock drives the group
+- [ ] Minimap: square (arena aspect), dots colored by state, drag moves the map view
+
+Control dock
+- [ ] Joystick: drag = bot drives, release = stops; knob shows LED color + live heading
+- [ ] LED button -> swatch grid -> bot circle + map dot recolor (toast confirms)
+- [ ] Alt-click map queues waypoints (dashed diamonds); popover lists "x, y mm" with per-item remove
+- [ ] Go sends: bot navigates, diamonds go solid, button morphs to "Stop nav"
+- [ ] Deselect and reselect other bots: the Planned mission survives (see rail Missions)
+
+Testbed rail
+- [ ] Icon strip -> panel; Testbed tab: Target label follows selection
+- [ ] Flash... dialog: pick image, Flash N device(s); bots blink amber, queue tab
+      shows per-device % bars, fleet % bar in Testbed tab, footer shows chunk progress
+- [ ] After flash: bots in Bootloader (not drivable) -> Start returns them to Running
+- [ ] Stop: Stopping -> Bootloader; Reset: Resetting -> Bootloader
+- [ ] Console tab: log lines stream (flash/start/stop events), Clear works
+- [ ] Missions tab: Planned (Go / discard) and Active (interrupt) rows; click row
+      reselects its bots; arrival adds a "Recently completed" line
+
+List / Grid
+- [ ] Search by id, state filter, column sort; checkbox multi-select + select-all
+- [ ] Selection carries across Map/List/Grid and drives the same footer dock
+
+## Scripted actions (against the running stack)
+
+```bash
+# color a bot's LED
+curl -X PUT localhost:8000/controller/dotbots/badcafe111111111/0/rgb_led \
+  -H 'Content-Type: application/json' -d '{"red":34,"green":197,"blue":94}'
+
+# send a waypoint mission (bot navigates on its own)
+curl -X PUT localhost:8000/controller/dotbots/badcafe111111111/0/waypoints \
+  -H 'Content-Type: application/json' \
+  -d '{"threshold":60,"waypoints":[{"x":400,"y":1600},{"x":1600,"y":400}]}'
+
+# flash two bots (watch rail queue + console)
+curl -N -X POST localhost:8001/flash/stream -H 'Content-Type: application/json' \
+  -d '{"firmware_b64":"ZmFrZQ==","devices":["badcafe111111111","deadbeef22222222"]}'
+
+# stop / start / reset a subset (or omit devices = whole fleet)
+curl -X POST localhost:8001/stop -H 'Content-Type: application/json' \
+  -d '{"devices":["badcafe111111111"]}'
+
+# screenshot for the Claude Design re-seed loop
+node dotbot/console-web/dev/screenshot.mjs "http://127.0.0.1:5173/?sel=1111" out.png
+```