Lease the Worker: A Weekend Heartbeat for Agent Side Projects

说明与用途

一个轻量级的守护进程，启动代理进程，监控心跳文件，并在预算超时时终止进程。

问题

Weekend agent processes often hang or run indefinitely, wasting wall‑clock time and resources.

结果

A minimal, reproducible lease‑based watchdog that ensures agent jobs terminate within a set budget and do not hang indefinitely.

工作流

• Create lease.json with initial values
• Start worker.py as a new session
• Supervisor polls lease.json every second
• Worker updates heartbeat_unix every 8 seconds
• Supervisor checks for missing heartbeat or deadline breach
• If breach, supervisor kills worker process group
• Worker exits with status "done" or "expired"

证据

Supervisor spawns the worker in a new session, then polls. Missing heartbeats and crossed deadlines both become a kill.

来源