Watch
0
0
Fork
You've already forked hyperhive
0

docs: the hive dashboard and agent page shrink to overviews

The hive dashboard and the per-agent page lose their control-by-control UI
description and endpoint tables from the handbook. The full text moves to
4-implementation/web-ui/dashboard.md and agent-page.md, and the handbook pages
keep what an operator needs to find and use them. Code comments that named the
old sections point at the new pages.
This commit is contained in:
iris 2026-11-11 00:09:45 +01:00
commit 2acde41e54
5 changed files with 1028 additions and 955 deletions

View file

@ -16,7 +16,7 @@
/* ─── full-screen layout overrides ─────────────────────────────────
The agent page mounts a full-viewport terminal under a fixed
frosted-glass header. See docs/2-handbook/agents/web-page.md::Per-agent
frosted-glass header. See docs/4-implementation/web-ui/agent-page.md::Per-agent
page for the layer / pill / side-panel structure; rules below
override the in-page defaults from @hive/shared. */
@ -184,7 +184,7 @@ h3 {
}
.agent-icon {
/* Square identity anchor — explicit 5em sizing + align-self.
See docs/2-handbook/agents/web-page.md::Per-agent page (Agent icon) for the
See docs/4-implementation/web-ui/agent-page.md::Per-agent page (Agent icon) for the
intrinsic-dim-pushes-parent-flex-open + sticks-to-top
rationale. */
width: 5em;
@ -594,7 +594,7 @@ pre.diff {
/* Tail pill (↓ N new): z-index bumped above the floating chrome so the
pill sits on the top layer instead of being clipped by it. (Pill is anchored in
`.agent-main` rather than `.terminal-wrap` — see
docs/2-handbook/agents/web-page.md::Per-agent page Terminal-wrap paragraph for the
docs/4-implementation/web-ui/agent-page.md::Per-agent page Terminal-wrap paragraph for the
backdrop-filter stacking-context rationale.) */
.agent-main .tail-pill {
bottom: 0.6em;

View file

@ -50,7 +50,7 @@ export interface HeaderProps {
* a variable pill count) grows to fit badges+pills together, keeping
* the header a stable height even on widescreen. Meta-nav
* (`<MetaNav>`) lives here too, as a fixed-size trigger, not an
* inline link list in the title row (docs/2-handbook/agents/web-page.md). */
* inline link list in the title row (docs/4-implementation/web-ui/agent-page.md). */
pills?: ComponentChildren;
}

View file

@ -19,7 +19,7 @@
<body class="agent-shell">
<!-- The Preact rewrite owns everything below — header, terminal,
side panel. See main.tsx/Root.tsx for the component
tree; docs/2-handbook/agents/web-page.md for the design. -->
tree; docs/4-implementation/web-ui/agent-page.md for the design. -->
<div id="preact-root"></div>
<script type="module" src="static/main.js" defer></script>

View file

@ -36,7 +36,7 @@
<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/2-handbook/agents/web-page.md (GET /screen)
// running inside the container. See docs/4-implementation/web-ui/agent-page.md (GET /screen)
// for the design rationale + canvas-sizing implementation notes.
(function () {
@ -61,7 +61,7 @@
});
// --- Fit-to-window toggle ---
// See docs/2-handbook/agents/web-page.md::Per-agent endpoints (GET /screen) for the
// See docs/4-implementation/web-ui/agent-page.md::Per-agent endpoints (GET /screen) for the
// localStorage persistence + canvas-intrinsic-resolution +
// pointer-rescale model.
let fitMode = localStorage.getItem("screen-fit") !== "off";
@ -105,7 +105,7 @@
// Sends an RFB SetDesktopSize request so the VNC server (weston)
// changes its actual output resolution to match the browser
// viewport — sharper than fit-mode's CSS downscale. Gated on the
// server's ExtendedDesktopSize advert; see docs/2-handbook/agents/web-page.md::Per-agent
// server's ExtendedDesktopSize advert; see docs/4-implementation/web-ui/agent-page.md::Per-agent
// endpoints (GET /screen).
let extDesktopSupported = false;
let screenId = 1; // captured from the server's ExtendedDesktopSize advert

View file

@ -34,7 +34,7 @@ export interface AgentState {
// in the agent page header (stats/screen + any
// `services.hyperhive.agent.dashboardLinks` extras). `agent_links()` on the backend
// is the single source of truth for what links an agent exposes; see
// docs/2-handbook/agents/web-page.md::Header for the kind → URL resolution table.
// docs/4-implementation/web-ui/agent-page.md::Header for the kind → URL resolution table.
export interface AgentLink {
url: string;
icon: string;