← Duties

Box heartbeat

Every ten minutes, check the box still has room to work: read the clock and the disk, decide whether space is getting tight, and only make noise if it is. A green run here means the runner and the schedule are both alive.

Duty

Id
box-heartbeat
Trigger
cron — */10 * * * * America/Chicago
Next run
2026-08-09 17:20 CDT
State
enabled
Created
2026-08-09 20:30 UTC
Updated
2026-08-09 20:30 UTC

Runs

Every time this duty has fired — on its schedule and by hand.

Flow — 4 steps

What runs, in order. Reading, not editing — the duty's own agent writes it.

true false Read the clock and the disk the box runs something command: date -u '+%Y-%m-%d %H:%M:%S UTC'; df -h / </> Read the clock and the disk date -u '+%Y-%m-%d %… Is the disk getting tight? a branch command: [ "$(df --output=pcent / | tr -dc '0-9')" -ge 90 ] ? Is the disk getting tight? [ "$(df --output=p… Tell Ben the box is filling up sends it somewhere to: ben integration: notifications ➜ Tell Ben the box is filling up ben Nothing to report deliberately nothing reason: There is room. A heartbeat with nothing to say says nothing. ∅ Nothing to report There is room. A hea…
  • </> code — the box runs something
  • ? decision — a branch
  • ➜ notify — sends it somewhere
  • ∅ noop — deliberately nothing
Read it as a list
  1. code Read the clock and the disk → getting_tight
  2. decision Is the disk getting tight? → say_so (true), stay_quiet (false)
  3. notify Tell Ben the box is filling up
  4. noop Nothing to report