From 5df263b2022e626de0771991aa1aeab0f786f409 Mon Sep 17 00:00:00 2001 From: iris Date: Sat, 15 Aug 2026 11:51:28 +0200 Subject: [PATCH] docs(turn-loop): drop historical framing, point to turn.rs module doc --- docs/turn-loop/claude-invocation.md | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/turn-loop/claude-invocation.md b/docs/turn-loop/claude-invocation.md index f5b3df9a..0d92d3d4 100644 --- a/docs/turn-loop/claude-invocation.md +++ b/docs/turn-loop/claude-invocation.md @@ -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.** `` 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.