Expand description
The hook: every harness’s events, one canonical, Claude-shaped event each (session_id, cwd, prompt,
tool_name, tool_input, error, last_assistant_message, transcript_path, stop_hook_active), answered
Claude-shaped ({“decision”:“block”,“reason”} at stop, hookSpecificOutput with context at a prompt
or tool call); adapters translate both ways (harness/). What differs per harness comes from its
Harness: capabilities, the turn’s work and the drone’s last message, never its name.
main routes and records presence; dispatch has one function per event. Hooks always fail open:
any error lets the drone continue untouched.
Functions§
- dispatch
- One hook event, canonical already (harness
normalise), for the dronehruns: what borg answers (Claude-shaped), or None. One function per event. - live_
check borg check(live.rs): one check of the session’s work so far, in the background. Takes the session’s lock (or leaves: a check runs), decides again under it, then runs the stop’s check on this turn so far: its asks wait in the.queuedfile as alive <ids>line when it graded a 3, which a stop asks while they wait as its own block would have, else as alive-next <ids>line, which no stop asks (Verdict::Ask); the free lessons as at the stop. It writes no#borg-asked(that happens at delivery,ask_live) and no#borg-skip(that closes a stop’s turn): a gate skip is#borg-live-skip. The mark records the changes a completed check covered.- main
borg hook <harness> <event>, the event on stdin: routes the repo to its collective (an off repo leaves no trace), records presence, then answers through steering, the experts anddispatch, with the messages from other sessions (msg.rs). An unknown harness, like any failure here, lets the drone continue untouched.- stripped
- Whether the judge sees question
lessonofcheckwithout the drone’s<id>: applies|skip: a fair coin from blake3 over both, so a retry strips alike and a replay knows it (outcome.rsstripped; a test predicts a judge prompt by it). Method: a random half, to measure what the declaration adds to a verdict.