- Get Started

Limits & Defaults

The meaningful numbers to know when operating OpenFlows. Most of these are deliberate design choices rather than settings you’d tune — they’re presented here in plain language as behaviors and ranges, not as configuration constants.

Health & liveness

NumberMeaning
Beacon refreshWorkers refresh their liveness beacon on a short cadence.
Beacon lifetimeIf a beacon stops refreshing, it expires on its own shortly after.
Staleness thresholdA worker silent past this point is declared stale and recoverable.

Net effect: OpenFlows detects a dead or unresponsive worker within roughly a couple of minutes, without needing to poke every container.

Recovery

NumberMeaning
Recovery attemptsA bounded retry count per ticket.
After exhaustingThe ticket escalates to a human instead of retrying forever.

Recovery is bounded, then escalated — the system stops and asks rather than retrying forever.

Notifications

LimitMeaning
Per-channel cooldownAt most one notification per channel per ticket within a window — prevents alert floods.
Failure safetyA failing channel is logged, never fatal to the orchestration.

Delegated verification

During delegated verification, the reviewer asks the builder to run a safe command and return evidence:

LimitMeaning
Command setOnly a fixed allowlist of safe commands can be run during delegated verification.
Timeout capA verification run has a hard maximum timeout.
Output boundCaptured output is bounded so large logs don’t overflow the exchange.

Orchestration pacing

NumberMeaning
Pass intervalThe cadence at which the Controller re-reads the whole system and advances work.
Pass boundA single pass is bounded so it can’t loop forever; it stops and retries next beat.
Self-healingA bad pass is logged and retried — it never kills the controller.

Durability

ItemMeaning
Coordination storeConfigured for durable storage so team state survives restarts.
Two-writer ruleOnly the controller and the worker surface may write; writes are validated.

Design invariants (not configurable)

InvariantWhy it exists
Planning before codeNo code until the plan is approved.
Single-use approvalsA gate approval can’t be replayed.
Isolated reviewReviewer and builder never share a filesystem.
No keys in workersSecurity by construction.
“When in doubt, don’t approve”The reviewer blocks rather than guesses.
Bounded then escalateRecovery stops and asks rather than spinning.

Related