hyperhive/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
atlas 9ff55399e5 hive-c0re: per-agent btrfs disk usage + optional quota (#1793)
Follow-up to the btrfs-subvolume migration. Operator-opt-in disk
accounting + quotas on agent state subvolumes via btrfs qgroups:

- three privileged ops (qgroup ops need root): EnsureBtrfsQuota
  (btrfs quota enable on the agent-state filesystem — statfs-gated,
  idempotent, no-op off btrfs), ReadSubvolumeUsage (btrfs qgroup show
  -f --raw for one agent), SetSubvolumeQuota (btrfs qgroup limit, or
  clear). Reuses the is_on_btrfs helper from the subvolume work.
- priv_client wrappers, incl parse_qgroup_usage -> (referenced,
  exclusive) bytes.
- hivectl 'quota' subcommand: enable / show [agent] / limit <agent>
  <size|none>, with a K/M/G/T size parser + human-readable output.

Quota is deliberately NOT auto-enabled: btrfs quota enable triggers a
full rescan that is I/O-heavy on a large filesystem, and the operator
should choose when to pay that. 'quota show' on a plain-dir agent (no
subvolume) reports no qgroup data rather than erroring.
2026-06-21 14:53:05 +02:00
..
tools hive-c0re: per-agent btrfs disk usage + optional quota (#1793) 2026-06-21 14:53:05 +02:00
web-ui dashboard: 'starting…'/'stopping…' card badges for start/stop queue kinds (#1806) 2026-06-21 14:52:31 +02:00
agent-hierarchy.md refactor: remove hyperhive.role option — there is only one role: agent 2026-06-04 14:31:44 +02:00
approvals.md docs(#1014): update stale root→ruth references in conventions, approvals, agent-hierarchy 2026-06-02 22:48:10 +02:00
boundary.md docs: move privsep socket-activation + child-state rw rationale out of code comments 2026-06-08 21:58:12 +02:00
ci.md docs(ci): document jobTimeout, fix forge.ci option path 2026-06-15 11:37:50 +02:00
conventions.md docs: document the build + local-check workflow in conventions 2026-06-19 12:23:01 +02:00
coordinator.md hive-c0re: graceful agent stop — quiesce harness, flush state, then stop 2026-06-19 11:50:59 +02:00
forge.md fix(#1637): don't label later activity (bodiless reviews) as new PR 2026-06-13 12:20:21 +02:00
gateway.md nix(gateway): self-signed TLS as the implicit default, deprecate the toggle 2026-06-17 21:14:05 +02:00
gotchas.md docs: note that linking workspace binaries locally needs nix develop (libsqlite3) 2026-06-05 21:30:57 +02:00
knowledge.md docs(knowledge): document the hive-forge AGit no-fork contribution flow 2026-06-05 20:54:25 +02:00
matrix.md feat(#551): gate server-side e2ee behind opt-in matrix.allowEncryption (default off) 2026-06-10 19:12:36 +02:00
network.md docs(network): document container-side route + resolver wiring for isolation 2026-06-10 21:49:01 +02:00
persistence.md hive-c0re: back agent state dirs with btrfs subvolumes 2026-06-19 13:46:39 +02:00
security.md fix: update PrivRequest table to match actual hive-sh4re::priv_proto variants 2026-06-05 18:40:44 +02:00
swarm.md docs: clarify certFingerprint does not govern matrix federation tls 2026-06-06 00:21:52 +02:00
terminal-rendering.md docs(web-ui): document turn start/end times + duration on the agent terminal 2026-06-10 15:38:04 +02:00
turn-loop.md docs: drop stale two-loop/two-binary framings (single hive serve loop) 2026-06-10 20:01:52 +02:00
web-ui.md docs(web-ui): sync dashboard docs after the SYST3M → C0R3 page move 2026-06-10 21:49:12 +02:00