docs: document harness/ dir layout including bash-tasks

This commit is contained in:
damocles 2026-06-01 13:56:46 +02:00 committed by mara
commit 73bf7bef95

View file

@ -174,6 +174,18 @@ Under `/var/lib/hyperhive/agents/<name>/`:
inside the container (uniform for sub-agents + manager).
The `$HYPERHIVE_STATE_DIR` env var exposes the same path to
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
applied repo. Tracks `flake.nix` (module-only boilerplate; never