[cueweb/docs] Document the Monitor Hosts page

- Add Monitor Hosts screenshots (CueCommander menu + page, light/dark) to the user guide
- Expand the user-guide Monitor Hosts section: Columns menu, host filter; fix Memory sort note (idle ratio, not idle bytes)
- Mark Monitor Hosts (initial version) as implemented in the CueCommander menu/route lists and cross-link the section
- Add Monitor Hosts feature entry to the CueWeb overview (other-guides)
- Add a Monitor Hosts reference subsection plus the GetHosts endpoint and /api/host/gethosts proxy route

Author: ramonfigueiredo

docs/_docs/other-guides/cueweb.md

@@ -155,6 +155,11 @@ CueWeb replicates the core functionality of [CueGUI](https://www.opencue.io/docs
    - Toggled from the checkable **Cuetopia → View Job Graph** entry (header dropdown and sidebar); the choice is persisted and synced across tabs.
    - When on, selecting a job in Monitor Jobs mounts the graph as a third panel under the inline Layers and Frames panels. It walks the depends in both directions (what the job depends on and what depends on the job), color-codes nodes by kind (JOB / LAYER / FRAME), rings the focus job, truncates long names with a full-name tooltip, and lets you click a node to open that job's detail page. Pan / zoom / fit controls and a "No dependencies found" empty state are included.
 
+28. **Monitor Hosts (CueCommander → Monitor Hosts):**
+   - A read-only host registry at `/hosts`, the CueWeb equivalent of CueGUI's CueCommander Monitor Hosts plugin. Reached from the CueCommander menu / sidebar entry or the dashboard hosts widget's **View hosts** link.
+   - Sortable, filterable table with columns Name, State, Locked, NIMBY, Cores (Idle/Total), Memory (Idle/Total), and Free /mcp. Resource columns sort by their underlying numeric value, not the formatted text. Column show/hide and pagination mirror the jobs table.
+   - Auto-refreshes every 30 seconds; a failed refresh keeps the previously loaded rows in place, and a failed first load shows an inline error with a **Retry** button. Host actions (lock/unlock, tag editing, reboot, NIMBY toggle) are out of scope for this page.
+
 
 ## CueWeb's user interface
 

docs/_docs/reference/cueweb.md

@@ -328,6 +328,23 @@ A read-only, interactive node graph of a job's dependency tree, rendered with [R
 
 ![The dependency graph panel on its own](/assets/images/cueweb/cueweb_cuetopia_view_job_graph_monitor_jobs_dependency_graph_only.png)
 
+### Monitor Hosts
+
+A read-only host registry at `/hosts` (`cueweb/app/hosts/page.tsx`), the CueWeb equivalent of CueGUI's `MonitorHostsPlugin` / `HostMonitorTree`. Reached from **CueCommander → Monitor Hosts** (header dropdown and sidebar) or the dashboard hosts widget's **View hosts** link.
+
+![Monitor Hosts entry in the CueCommander menu](/assets/images/cueweb/cueweb_cuecommander_monitor_hosts_menu.png)
+
+![CueWeb Monitor Hosts page](/assets/images/cueweb/cueweb_cuecommander_monitor_hosts.png)
+
+| Behavior | Description |
+|----------|-------------|
+| **Data source** | Loads via `getHosts()` (`app/utils/get_utils.ts`), which posts to the `/api/host/gethosts` proxy → `host.HostInterface/GetHosts`. `getHosts()` returns an array on success and throws on a failed request so the page can tell a real failure from an empty registry. |
+| **Columns** | Name, State, Locked, NIMBY, Cores (Idle/Total), Memory (Idle/Total), Free /mcp (`app/hosts/columns.tsx`). State and Locked reuse the shared `Status` badge. |
+| **Sorting** | Resource columns sort by their underlying numeric value, not the formatted string: Cores and Memory by idle ratio (`idleRatio`), Free /mcp by byte count. Memory / mcp arrive from the gateway as KB-in-string and are parsed/formatted by `app/hosts/host_format_utils.ts` (`kbStringToNumber`, `kbStringToHuman`). |
+| **Table** | Rendered by the shared `SimpleDataTable` with the `isHostsTable` flag - host-specific filter placeholder and empty-state copy, and no row context menu (read-only). Column show/hide persists to `localStorage["cueweb.hosts.columnVisibility"]`. |
+| **Refresh** | Auto-refreshes every 30s. A failed poll keeps previously loaded rows; a failed first load renders an inline error with a **Retry** button. |
+| **Scope** | Read-only. Host actions (lock/unlock, tag editing, reboot, NIMBY toggle) and server-side filtering are tracked under sibling issues and are not part of this page. |
+
 ### Job-finished notifications
 
 | Behavior | Description |
@@ -937,10 +954,11 @@ CueWeb communicates with these REST Gateway endpoints:
 | `frame.FrameInterface/Retry` | Retry frame |
 | `frame.FrameInterface/Kill` | Kill frame |
 | `frame.FrameInterface/Eat` | Eat frame |
+| `host.HostInterface/GetHosts` | List hosts for the Monitor Hosts page |
 
 ### CueWeb Proxy Routes
 
-The browser does not call REST Gateway directly; it goes through Next.js API proxies that attach the JWT. Comment-related routes:
+The browser does not call REST Gateway directly; it goes through Next.js API proxies that attach the JWT. Comment- and host-related routes:
 
 | Route | Forwards to |
 |-------|-------------|
@@ -949,6 +967,7 @@ The browser does not call REST Gateway directly; it goes through Next.js API pro
 | `POST /api/job/action/addsubscriber` | `job.JobInterface/AddSubscriber` |
 | `POST /api/comment/action/save` | `comment.CommentInterface/Save` |
 | `POST /api/comment/action/delete` | `comment.CommentInterface/Delete` |
+| `POST /api/host/gethosts` | `host.HostInterface/GetHosts` (unwraps the gateway's double-nested `{hosts:{hosts:[...]}}` to a flat array) |
 
 ---
 
@@ -1028,7 +1047,8 @@ Layout, left to right:
   - Allocations (`/allocations`)
   - Limits (`/limits`)
   - Monitor Cue (`/monitor-cue`)
-  - Monitor Hosts (`/hosts`)
+  - Monitor Hosts (`/hosts`) - implemented; read-only host registry (see
+    [Monitor Hosts](#monitor-hosts)).
   - Redirect (`/redirect`)
   - Services (`/services`)
   - Shows (`/shows`)

docs/_docs/user-guides/cueweb-user-guide.md

@@ -133,7 +133,7 @@ The screen is composed of:
     - **File** -> *Disable Job Interaction* (read-only safety toggle, see below).
     - **Cuebot Facility** -> switch between `local` · `dev` · `cloud` · `external` (the active facility is shown as a small chip on the menu trigger).
     - **Cuetopia** -> Monitor Jobs.
-    - **CueCommander** -> Allocations, Limits, Monitor Cue, Monitor Hosts, Redirect, Services, Shows, Stuck Frame, Subscription Graphs, Subscriptions. Unimplemented routes 404 gracefully - they are placeholders for upcoming features.
+    - **CueCommander** -> Allocations, Limits, Monitor Cue, **Monitor Hosts** (see [Monitor Hosts](#monitor-hosts)), Redirect, Services, Shows, Stuck Frame, Subscription Graphs, Subscriptions. The remaining unimplemented routes 404 gracefully - they are placeholders for upcoming features.
     - **Other** -> *Attributes* (toggles the docked Attributes panel, see below).
     - **Help** -> a search box that finds commands across **every** menu in CueWeb (CueGUI parity), plus Online User Guide, Make a Suggestion, and Report a Bug.
   - **Theme toggle**: Switch between light and dark modes (your choice persists across sessions).
@@ -910,7 +910,17 @@ When the job reaches `FINISHED`, Cuebot sends the configured notification email
 
 ## Monitor Hosts
 
-The **Monitor Hosts** page (CueCommander → Monitor Hosts in the sidebar, or the **View hosts** link on the dashboard hosts widget) lists the render hosts registered with Cuebot. It is the CueWeb equivalent of CueGUI's CueCommander Monitor Hosts plugin, and mirrors the jobs table interactions (sortable columns, substring filter, column show/hide, pagination).
+The **Monitor Hosts** page (CueCommander → Monitor Hosts in the sidebar or header, or the **View hosts** link on the dashboard hosts widget) lists the render hosts registered with Cuebot. It is the CueWeb equivalent of CueGUI's CueCommander Monitor Hosts plugin, and mirrors the jobs table interactions (sortable columns, substring filter, column show/hide, pagination).
+
+Open it from the **CueCommander** menu (or the matching entry in the left sidebar).
+
+![Monitor Hosts entry in the CueCommander menu](/assets/images/cueweb/cueweb_cuecommander_monitor_hosts_menu.png)
+
+The page renders a sortable, filterable table of every host. It follows the active theme:
+
+![CueWeb Monitor Hosts page](/assets/images/cueweb/cueweb_cuecommander_monitor_hosts.png)
+
+![CueWeb Monitor Hosts page in dark mode](/assets/images/cueweb/cueweb_cuecommander_monitor_hosts_dark.png)
 
 ### Host columns
 
@@ -921,10 +931,10 @@ The **Monitor Hosts** page (CueCommander → Monitor Hosts in the sidebar, or
 | Locked | Lock state (`OPEN`, `LOCKED`, `NIMBY_LOCKED`) shown as a status badge |
 | NIMBY | Whether NIMBY is enabled on the host (`Yes` / `No`) |
 | Cores (Idle/Total) | Idle vs total cores. Sorts by the idle ratio |
-| Memory (Idle/Total) | Idle vs total memory, human-readable. Sorts by idle bytes |
+| Memory (Idle/Total) | Idle vs total memory, human-readable. Sorts by the idle ratio |
 | Free /mcp | Free temporary (`/mcp`) space, human-readable |
 
-Numeric columns sort by their underlying value rather than the formatted text, so memory and core counts sort numerically.
+Numeric columns sort by their underlying value rather than the formatted text, so memory and core counts sort numerically. Use the **Columns** menu to show or hide columns - your choice persists per browser - and the **Filter hosts...** box to narrow the table by a substring of the host name.
 
 ### Refresh