From 964e55f0bbd53a9c7e5eab27fce847d57479b151 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Mon, 29 Jun 2026 00:31:06 +0200
Subject: [PATCH] docs(web-ui/agent): add back-link nav + fix stale doc pointer
 in screen.html

---
 docs/web-ui/agent.md                    | 6 ++++--
 frontend/packages/agent/src/screen.html | 5 ++---
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/web-ui/agent.md b/docs/web-ui/agent.md
index e63ba865..bfe13b62 100644
--- a/docs/web-ui/agent.md
+++ b/docs/web-ui/agent.md
@@ -338,7 +338,8 @@ shaped).
   would vendor noVNC; this file ships the minimal in-tree variant).
   Only accessible when `hyperhive.gui.enable = true` in the agent's
   `agent.nix`; the harness shows a 🖥 screen link in the state row
-  when `gui_vnc_port` is present. Toolbar: `⤢ fit` CSS-downscales
+  when `gui_vnc_port` is present. A `← agent` back-link in the page
+  header returns to the main per-agent page. Controls: `⤢ fit` CSS-downscales
   the canvas to the window via `relayoutCanvas()` setting explicit
   pixel dimensions on the canvas — *not* CSS `max-width/max-height`,
   because a flex item's automatic minimum size (`min-width: auto`
@@ -379,7 +380,8 @@ Bus events (new vocabulary on `/events/stream`):
 
 `GET /stats` is a separate per-agent page (served by the
 harness, linked from the per-agent page's `📊 stats →` and from
-each dashboard container row). Turn analytics, read-only, from
+each dashboard container row). A `← live` back-link in the page
+header returns to the main per-agent page. Turn analytics, read-only, from
 `/state/hyperhive-turn-stats.sqlite`. `GET /api/stats?window=
 24h|7d|30d|all` returns a time-bucketed `Snapshot`; the page renders
 it with Chart.js (bundled into `stats.js` via esbuild — no CDN
diff --git a/frontend/packages/agent/src/screen.html b/frontend/packages/agent/src/screen.html
index 14a4fc6f..854de9a0 100644
--- a/frontend/packages/agent/src/screen.html
+++ b/frontend/packages/agent/src/screen.html
@@ -25,9 +25,8 @@
 <script>
 // Minimal RFB-over-WebSocket renderer. Connects to `screen/ws` on
 // the same host; the harness relays raw RFB bytes to the VNC server
-// running inside the container. See docs/web-ui.md::Per-agent
-// endpoints (GET /screen) for the design rationale + canvas-sizing
-// implementation notes.
+// running inside the container. See docs/web-ui/agent.md (GET /screen)
+// for the design rationale + canvas-sizing implementation notes.
 
 (function () {
   'use strict';