docs(persistence): document hyperhive-status in state/ and mcp-loose-ends/ in harness/

This commit is contained in:
iris 2026-06-05 15:15:36 +02:00 committed by mara
commit 0d84e11dcd

View file

@ -172,7 +172,16 @@ Under `/var/lib/hyperhive/agents/<name>/`:
- `state/` — durable notes and `hyperhive-harness.json`. Bind-mounted
to `/agents/<name>/state` inside the container (uniform for
sub-agents + manager). The `$HYPERHIVE_STATE_DIR` env var exposes
the same path to in-container scripts.
the same path to in-container scripts. Notable files written here
by the harness:
- `hyperhive-status` — single-line free-text status string written
by `set_status`; cleared on explicit `set_status("")`. Read by
hive-c0re and the per-agent `/api/dashboard-state` endpoint to
surface the status chip on the dashboard. Absent when no status
is set.
- `hyperhive-harness.json` — rate-limited / needs-login flags read
by the dashboard's async container-state fetch. See
`docs/web-ui/dashboard.md::Container row`.
- `harness/` — harness-internal ephemeral state; not intended for
agent consumption. Bind-mounted to `/agents/<name>/harness`
inside the container (`$HYPERHIVE_HARNESS_DIR`). Contents:
@ -181,6 +190,13 @@ Under `/var/lib/hyperhive/agents/<name>/`:
`<id>.json` (status + tails), `<id>.out` / `<id>.err`
(full captured output). Task files persist until container
purge.
- `mcp-loose-ends/` — JSON files published by external MCP daemons
(e.g. `hive-bash-mcp`, `hive-matrix-mcp`) listing their active
loose-end summary strings. Each file is `<daemon>.json` containing
a JSON array of plain-text lines. Read by `get_loose_ends` to
surface active background work without hardcoding per-MCP
knowledge in the harness. Files are created/removed by the
external daemons themselves.
- `hyperhive-events.sqlite` — turn-loop event log.
- `hyperhive-turn-stats.sqlite` — per-turn timing stats.
- `hyperhive-model` — single-line model name override file.