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

docs: document harness/ dir layout including bash-tasks

Browse source
This commit is contained in:
damocles 2026-06-01 13:56:46 +02:00 • committed by mara
commit 73bf7bef95
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
docs/persistence.md
View file

@ -174,6 +174,18 @@ Under `/var/lib/hyperhive/agents/<name>/`:
inside the container (uniform for sub-agents + manager). inside the container (uniform for sub-agents + manager).
The `$HYPERHIVE_STATE_DIR` env var exposes the same path to The `$HYPERHIVE_STATE_DIR` env var exposes the same path to
in-container scripts. in-container scripts.
- `harness/` — harness-internal ephemeral state; not intended for
agent consumption. Bind-mounted to `/agents/<name>/harness`
inside the container (`$HYPERHIVE_HARNESS_DIR`). Contents:
- `bash-tasks/` — task JSON + stdout/stderr files for
background `bash_run` jobs. JSON files are
`<id>.json` (status + tails), `<id>.out` / `<id>.err`
(full captured output). Cleaned up by the agent after
inspecting with `bash_status`.
- `hyperhive-events.sqlite` — turn-loop event log.
- `hyperhive-turn-stats.sqlite` — per-turn timing stats.
- `hyperhive-harness.json` — consolidated flags (rate-limited,
model override, etc.) written atomically on each turn.
Under `/var/lib/hyperhive/applied/<name>/` — the hive-c0re-only Under `/var/lib/hyperhive/applied/<name>/` — the hive-c0re-only
applied repo. Tracks `flake.nix` (module-only boilerplate; never applied repo. Tracks `flake.nix` (module-only boilerplate; never