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

docs(turn-loop): drop historical framing, point to turn.rs module doc

Browse source
This commit is contained in:
iris 2026-08-15 11:51:28 +02:00 • committed by mara
commit 5df263b202
1 changed files with 8 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

21
docs/turn-loop/claude-invocation.md
View file

@ -218,9 +218,7 @@ socket at `/run/hive/` once at startup:
`services.hyperhive.c0re.operatorPronouns`, default `she/her`).
When `hyperhive.docs.enable` is set, `HIVE_DOCS_DIR` is present
in the environment and `render()` appends a one-sentence pointer
telling the agent the docs are mounted at that path (in lieu of
the old CLAUDE.md-in-docs-dir approach, which was dropped in
favour of this direct injection).
telling the agent the docs are mounted at that path.
Passed via `--system-prompt-file`.
**Marker grammar.** `<!-- role:X -->` opens a block; any
@ -242,14 +240,11 @@ socket at `/run/hive/` once at startup:
empty-string env vars and missing env vars round-trip the
same way.
The per-turn plumbing lives in `hive_ag3nt::turn`: `write_mcp_config` /
`write_system_prompt` (on-boot files), `make_session` (builds the durable
`InfiniteSession`, once), `drive_turn` (the policy state machine —
reset/auto-reset, the turn, 401-retry, deferred-compact-at-turn-end),
`run_pending_compact` (idle operator compact), `BusSink` (stream → bus +
`Telemetry` applied via `apply_telemetry`), `emit_turn_end`, `session_title`
/ `session_store` / `archive_session` (identity + turn-boundary reset). The
actual claude spawn, stream classification, and the reactive/proactive
compaction loop are in the `hive-claude` crate. Login-wait
(`wait_for_login`) lives in `hive_ag3nt::login`.
The per-turn plumbing described on this page — on-boot files, session
identity, the reset/auto-reset/retry state machine, and the
telemetry-to-bus bridge — lives in `hive-agent`'s `turn` module; see its
`//!` doc comment (`hive-agent/src/turn.rs`) for the exact call shape.
The actual claude spawn, stream classification, and the
reactive/proactive compaction loop are in the `hive-claude` crate.
Login-wait lives in `hive-agent`'s `login` module.