Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python

ADR 0215: note how it amends ADR 0064 and why the heartbeat stays

justrachb841eac0fe92
diff --git a/docs/adr/0215-headless-runs-wait-until-idle.md b/docs/adr/0215-headless-runs-wait-until-idle.md
index 8d42be54..2d0e2be6 100644
--- a/docs/adr/0215-headless-runs-wait-until-idle.md
+++ b/docs/adr/0215-headless-runs-wait-until-idle.md
@@ -54,6 +54,15 @@ the next one.
## Consequences
+- This amends ADR 0064's "no global worker wait" for headless roots. That rule
+ kept unrelated jobs and long-lived servers from holding a turn open. A
+ headless process runs one session, so every job in it belongs to this run,
+ and servers are excluded.
+- The operation-priorities proposal avoids periodic heartbeats by default,
+ because a wakeup can spend a request without new information. Here the
+ heartbeat is the only way out of a wait on work that never reports. It
+ costs at most one request per ten silent minutes, and three quiet
+ heartbeats end the wait.
- A headless run lasts as long as its background work. The heartbeat, the
quiet-heartbeat cap, the run budget (`--max-model-calls`) and the caller's
own timeout bound it.