vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(dashboard): add L0GS page section documenting three sub-tabs

Browse source 
/logs.html was undocumented — only mentioned in passing in API
endpoint lists. Adds a proper section covering BUILD / AGENT /
SYSTEM sub-tabs, their API endpoints, and behaviour.
This commit is contained in:
iris 2026-06-02 11:06:23 +02:00 • committed by mara
commit 14368b2e09
1 changed files with 31 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
docs/web-ui/dashboard.md
View file

@ -289,6 +289,37 @@ to confirm; `@*` broadcasts). `POST /op-send` drops
frame re-renders both the terminal row and the inbox section.
Manager is addressed as `@root`.
## L0GS page (`/logs.html`)
A dedicated log-viewer page (not a tab pane — a separate HTML page),
linked from the SETTINGS tab's `◆ L0GS ◆ →` entry. Minimal chrome:
a `← dashboard` back link and a three-item sub-tab strip. Tab
routing is hash-based (`#build`, `#agent`, `#system`); default is
`#build`.
**BUILD sub-tab** — all-agents build log history. Fetches
`GET /api/build-logs?limit=30` on load and on `↻ refresh`. Renders
a scrollable list of build entries; each row is a collapsible button
showing status badge (`live` / `ok` / `fail`), agent name, elapsed
duration, build kind, age, and the invocation command line.
Expanding a row fetches the full stdout+stderr via
`GET /api/build-logs/id/{id}`. A live in-progress build shows a
`live` badge and a growing `…` duration chip; when complete, the row
re-renders with the final status. `status === null` = still running.
**AGENT sub-tab** — per-container journald viewer. Two selects: agent
name (populated from `GET /api/state`) and unit filter
(`hive-ag3nt.service` / `(full machine journal)`). Fetches
`GET /api/journal/{name}?unit=<unit>&lines=500` on refresh. Output
rendered as a `<pre>` block.
**SYSTEM sub-tab** — host-side service logs. Unit selector (currently
only `hive-c0re.service`). Fetches
`GET /api/journal-host?unit=hive-c0re.service&lines=500` on activation
and on `↻ refresh`. Rendered as a `<pre>` block. Available to the
operator unconditionally (not capability-gated — the endpoint lives
on the hive-c0re dashboard, behind the gateway).
## Container row
A full-height **square agent icon** (5em, capped) on the left. The