docs: rework user-facing docs around lan mode + web frontend

docs/README.md

@@ -1,33 +1,39 @@
 # Docs Index
 
-## Start Here
+## Start Here (Users)
 
-- [getting-started/quickstart.md](getting-started/quickstart.md): setup, first checks, and first runtime commands
-- [operators/control-room.md](operators/control-room.md): primary day-to-day operator guide
-- [operators/bindings-files.md](operators/bindings-files.md): `.binds` backup, restore, and preset apply
+- [user/install.md](user/install.md): install Python, `uv`, platform prerequisites.
+- [user/bindings-setup.md](user/bindings-setup.md): Elite bindings required before first run.
+- [user/getting-started.md](user/getting-started.md): recommended TUI + web LAN setup.
+- [user/haul-workflow.md](user/haul-workflow.md): end-to-end haul walkthrough plus `haul.toml`.
+- [user/commands-reference.md](user/commands-reference.md): every Control Room command.
+- [user/troubleshooting.md](user/troubleshooting.md): input, journal, and bindings checks.
 
-## Operator Guides
+## Operator Reference
 
-- [operators/input-timing.md](operators/input-timing.md): human-style delay, hold, and typing randomization settings
-- [operators/market-timing.md](operators/market-timing.md): market buy-hold tuning and sell max rapid-tap settings
-- [operators/manual-journal-routine-testing.md](operators/manual-journal-routine-testing.md): low-level manual validation outside Control Room
+- [operators/control-room.md](operators/control-room.md): run modes, panels, and haul behavior specifics.
+- [operators/control-room-remote.md](operators/control-room-remote.md): multi-client / observer semantics.
+- [operators/bindings-files.md](operators/bindings-files.md): `.binds` backup, restore, and shipped preset apply.
+- [operators/input-timing.md](operators/input-timing.md): human-style delay, hold, and typing randomization.
+- [operators/market-timing.md](operators/market-timing.md): market buy-hold and sell-max tuning.
+- [operators/manual-journal-routine-testing.md](operators/manual-journal-routine-testing.md): low-level manual validation outside Control Room.
 
 ## Diagnostics
 
-- [diagnostics/cli-reference.md](diagnostics/cli-reference.md): utility and diagnostics commands
-- [diagnostics/bindings-reference.md](diagnostics/bindings-reference.md): Elite binding names that matter to this runtime
+- [diagnostics/cli-reference.md](diagnostics/cli-reference.md)
+- [diagnostics/bindings-reference.md](diagnostics/bindings-reference.md)
 
 ## Maintainer Handoff
 
-- [status/README.md](status/README.md): maintained status entrypoint and area map
-- [status/](status/): split current-state handoff files by durable area
-- [iteration-logs/](iteration-logs/): per-iteration maintained notes, one file per substantive work session
-- [iteration-archive.md](iteration-archive.md): generated archive of iteration logs, refreshed whenever iteration-log changes are being committed, pushed, or sent for review
-- [status-archive.md](status-archive.md): legacy archived validation and older pre-migration handoff notes
+- [status/README.md](status/README.md): maintained status entrypoint and area map.
+- [status/](status/): split current-state handoff files by durable area.
+- [iteration-logs/](iteration-logs/): maintained per-session notes.
+- [iteration-archive.md](iteration-archive.md): generated archive, refreshed alongside iteration-log changes.
+- [status-archive.md](status-archive.md): legacy archived validation and pre-migration handoff notes.
 
 ## Deep Reference
 
-- [plans/](plans/): implementation plans
-- [research/](research/): deeper research and behavior-reference material
-- [design/](design/): design notes
-- [devlog/](devlog/): older session-style notes
+- [plans/](plans/): implementation plans.
+- [research/](research/): deeper research and behavior-reference material.
+- [design/](design/): design notes.
+- [devlog/](devlog/): older session-style notes.

docs/operators/control-room-remote.md

@@ -1,12 +1,12 @@
-# Control Room Remote Observer Mode
+# Control Room Multi-Client Mode
 
-This document covers the current `serve` / `connect` split for Control Room.
+This document covers the `serve` / `connect` model when **more than one client** connects to the same Control Room server (e.g. TUI on the runtime host plus a browser plus a second TUI on another laptop).
 
-For normal embedded local use, start with [control-room.md](control-room.md).
+For the recommended single-user LAN setup (one `lan` server + one browser + local TUI for TTS), see [../user/getting-started.md](../user/getting-started.md). For the operator reference on run modes, see [control-room.md](control-room.md).
 
 ## Purpose
 
-Use remote observer mode when one machine should own the runtime and one or more other clients should watch or operate it over the LAN.
+Use multi-client mode when one machine owns the runtime and one or more additional clients should watch or take over control over the LAN.
 
 Current model:
 
@@ -20,17 +20,14 @@ Current model:
 
 ## Commands
 
-Start a server on the machine that owns the Elite runtime:
+Server run modes are documented in [control-room.md](control-room.md#run-modes). A quick summary for multi-client setups:
 
 ```sh
-uv run python3 control_room.py serve --token 1001
-uv run python3 control_room.py local --token 1001
-uv run python3 control_room.py lan --port 8765 --token 1001
-uv run python3 control_room.py serve --lan --port 8765 --token 1001
+uv run python3 control_room.py lan --token 1001
 uv run python3 control_room.py serve --host 0.0.0.0 --port 8765 --token 1001
 ```
 
-Use `local` to bind loopback (`127.0.0.1`) explicitly. Use `lan` or `serve --lan` when clients should connect from the same network and you want Control Room to bind to the detected non-loopback IPv4 address, preferring RFC1918 addresses and skipping VPN-owned ranges like `198.18/15` (Cloudflare WARP) and `100.64/10` (CGNAT). Use `--host` for an explicit bind address, including `0.0.0.0` for all interfaces.
+Pass an explicit `--token` when you want to override the default `edcr`. All clients must use the same token.
 
 Connect from a client: