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: forge_notify.rs file map + wait_for_login mtime resumption (follow-up to #544 #545)

Browse source
This commit is contained in:
lexis 2026-05-29 00:23:46 +02:00 • committed by Mara
commit c9f537c2e3
2 changed files with 17 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
CLAUDE.md
View file

@ -150,6 +150,14 @@ hive-ag3nt/ in-container harness crate; produces TWO binaries
src/turn.rs claude --print + stream-json pump; --compact retry; src/turn.rs claude --print + stream-json pump; --compact retry;
proactive compaction + auto session-reset proactive compaction + auto session-reset
src/mcp.rs embedded MCP server (rmcp): AgentServer + ManagerServer src/mcp.rs embedded MCP server (rmcp): AgentServer + ManagerServer
src/forge_notify.rs Forgejo webhook subscriber: formats new-issue /
new-PR / comment / review notifications as
broker messages; embeds a body excerpt
(up to BODY_TRUNCATE bytes, ATX headings
escaped) and surfaces any @mention lines that
fell outside the truncation window in a
trailing `mentions (truncated from body):`
block (#539 / #544).
src/login.rs probe /root/.claude/ for a valid session src/login.rs probe /root/.claude/ for a valid session
src/login_session.rs drives `claude auth login` over stdio pipes src/login_session.rs drives `claude auth login` over stdio pipes
src/prompt.rs system prompt renderer: filters the unified src/prompt.rs system prompt renderer: filters the unified

9
docs/turn-loop.md
View file

@ -38,6 +38,15 @@ Each agent harness (`hive-ag3nt serve` or `hive-m1nd serve`) runs:
the same path used at boot. The operator re-authenticates via the same path used at boot. The operator re-authenticates via
the per-agent web UI login flow; on success the sentinel is the per-agent web UI login flow; on success the sentinel is
cleared and the queued message drives the next turn normally. cleared and the queued message drives the next turn normally.
**Mtime-snapshot resumption** (closes #542): `wait_for_login`
snapshots the `~/.claude/` dir (newest file mtime + file count)
at entry and only resumes when that snapshot advances — not
just when credentials exist on disk. This prevents a silent
infinite-401 loop: stale credentials already on disk at the
time of the 401 no longer cause an immediate false-resume. The
`DirSnapshot` struct tracks both axes; either a mtime advance
OR a file-count change triggers resume (the count axis handles
filesystems where `modified()` errors on every file).
7. Emit `LiveEvent::TurnEnd { ok, note }`. Sleep `poll_ms` to avoid 7. Emit `LiveEvent::TurnEnd { ok, note }`. Sleep `poll_ms` to avoid
tight loops on transient failures. tight loops on transient failures.