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.mdindex 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, thequiet-heartbeat cap, the run budget (`--max-model-calls`) and the caller'sown timeout bound it.