App structure: a swipe-in menu shell; pages/, link/, actions/; Settings

The shell (shell.dart): a drawer from the left edge or each page's menu button.
Dash, Signals, Captures; Tools (Camera, Link test, Orin power options), the
rarely used ones, after pirate-station-aide; Settings (gateway address, dark/bright,
build-time theme and landing). Landing view at build time: YUKART_HOME=dash|signals,
signals for now. Dash, Signals and Captures stay alive while hidden; Captures has its
own navigator, so a run survives switching views. Back goes inside Captures, then to
the landing view, then out. The mock banner sits over every page.

main.dart is startup only; the old home screen is pages/signals.dart; dialogs and
sheets moved to actions/; the protocol client, USB binding and Reading to link/.
lib/README.md catalogues it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DDwfd6Ki8UfG4hK6W5YpJz

lib/README.md

@@ -3,15 +3,21 @@ type: reference
 ---
 # The app's code: a catalogue
 
-Laid out like smart-serow's HUD (`pi/ui/lib/`), which several pieces come from.
+Laid out like smart-serow's HUD (`pi/ui/lib/`), which several pieces come from; the menu follows
+pirate-station-aide's (main views, then the rarely used ones grouped as Tools).
 
 ## Folders
 
 | Where | Holds |
 |---|---|
-| `lib/*.dart` | Pages (`dash`, `checklist`, `camview`, `linktest`), the boundary client (`boundary`), the USB network binding (`net`), and `reading`, one signal's state as a display needs it |
-| `theme/` | `palette.dart`: the palette and `hudFont` |
-| `widgets/` | Reusable display widgets, one per file, each fed values, never the boundary |
+| `main.dart` | Startup: the link to the Orin, the theme, then the shell |
+| `shell.dart` | The shell: a menu that swipes in from the left; Dash, Signals, Captures, then Tools (Camera, Link test, Orin power options), then Settings. Dash, Signals and Captures stay alive while hidden |
+| `shell_scope.dart` | What a page needs from the shell: `MenuButton`, `ShellView`, the landing view (`--dart-define=YUKART_HOME=dash\|signals`, `signals` for now) |
+| `pages/` | One file per view: `dash`, `signals` (values and raw traffic), `checklist` (Captures), `camera`, `link_test`, `settings` |
+| `actions/` | Things done from anywhere, as dialogs and sheets: `marks` (free-form mark), `orin_power` (power off / reboot), `server_url` (gateway address) |
+| `link/` | Talking to the Orin: `boundary` (the protocol client), `net` (binding to the USB link), `reading` (one signal's state as a display needs it) |
+| `theme/` | `palette.dart`: the palette roles and `hudFont` |
+| `widgets/` | Reusable display widgets, one per file, each fed values, never the boundary (`link_status` takes it whole: it shows the link) |
 
 ## Widgets
 
@@ -22,6 +28,8 @@ Laid out like smart-serow's HUD (`pi/ui/lib/`), which several pieces come from.
 | `WhiskeyMark` | `widgets/whiskey_mark.dart` | Attitude: a horizon tilting with roll, ladder moving with pitch | smart-serow |
 | `AccelGraph` | `widgets/accel_graph.dart` | G-meter: a dot for lateral/longitudinal g, a trace and a peak marker over a window | smart-serow |
 | `GpsCompass` | `widgets/gps_compass.dart` | Heading arrow and bearing; "ACQ" while acquiring, "N/A" without | smart-serow, from gps-speedo |
+| `LinkChip`, `LinkDetails` | `widgets/link_status.dart` | The link's state in good / caution / alarm; address, last-message age, clock offset, USB link | Yukart |
+| `MockBanner` | `widgets/mock_banner.dart` | "MOCK DATA — NOT FROM THE CAR" in caution, over every page while the gateway is mocking | Yukart |
 
 ## Conventions