mara/hyperhive
mara/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

docs: the hive dashboard and agent page shrink to overviews

Browse source 
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
3 changed files with 1028 additions and 955 deletions
Download patch file Download diff file Expand all files Collapse all files

2
hive-agent/src/login.rs
View file

@ -33,7 +33,7 @@ pub fn default_dir() -> PathBuf {
/// exactly these to force re-login while preserving session-history files —
/// so boot detection ([`has_session`]) and logout agree by construction.
/// Rationale + the previous wholesale-wipe shape we replaced live in
/// `docs/2-handbook/agents/web-page.md::Per-agent endpoints`
/// `docs/4-implementation/web-ui/agent-page.md::Per-agent endpoints`
/// (the `/api/logout` bullet).
///
/// `.credentials.json` is the actual OAuth session; `mcp-needs-auth-cache.json`

2
hive-agent/src/web_ui/auth.rs
View file

@ -17,7 +17,7 @@ use super::{AppState, LoginStateCell};
/// resumes when a fresh credentials file appears (the swarm login stores
/// one and `claude_credentials` installs it).
/// Always returns 200 with a body describing what happened. See
/// `docs/2-handbook/agents/web-page.md::Per-agent endpoints`
/// `docs/4-implementation/web-ui/agent-page.md::Per-agent endpoints`
/// (the `/api/logout` bullet) for the three-step rationale +
/// preservation invariants.
pub(super) async fn post_logout(State(state): State<AppState>) -> Response {

4
hive-agent/src/web_ui/state.rs
View file

@ -142,7 +142,7 @@ pub(super) struct StateSnapshot {
/// Navigation links for this agent page. Also served via
/// `DashboardState.links` (`GET /api/dashboard-state`) for the
/// dashboard card's icon strip. Both are produced by `agent_links()`
/// — single source of truth. See [`docs/2-handbook/hives/dashboard.md::Container row`]
/// — single source of truth. See [`docs/4-implementation/web-ui/dashboard.md::Container row`]
/// for the frontend resolver + which links appear in which conditions.
links: Vec<AgentLink>,
/// Human name of this hive instance (e.g. `"pr1ma"`). Sourced
@ -262,7 +262,7 @@ fn read_own_status() -> (Option<String>, Option<i64>) {
/// for `External`; the frontend resolves each against its `kind`
/// against the right base so the backend never has to guess the
/// operator's browser host. See
/// `docs/2-handbook/hives/dashboard.md::Container row` for
/// `docs/4-implementation/web-ui/dashboard.md::Container row` for
/// the resolver + how `deployed:<sha>` ships alongside.
///
/// Icons are real emoji, not unicode arrow/geometric glyphs — mara: