Engine
Thresholds and cadence
Two tiers, measured in ledgers. Both move together when you move one, and both are only as sharp as the schedule that checks them.
Two tiers
| Tier | Default | Means |
|---|---|---|
| warning | 120,960 | About seven days. Low, recoverable, and affecting only this contract. |
| act now | 17,280 | About one day. Or temporary and low, or shared and low. |
These two figures appear in TypeScript, JSON and Python across this project, and a check asserts they agree in every copy. A threshold that means one thing in the CLI and another in CI is a defect that reads like a difference of opinion.
The boundary is inclusive
An entry at exactly the act-now threshold fails. Remaining exactly N is already the margin you set out to keep, so consuming it is the event you were watching for, not the moment before it.
Raising one raises both
--threshold moves the act-now tier, and the warning tier widens with it. Raising the act-now boundary can therefore never silently narrow the earlier warning — which is what would happen if the warning stayed fixed while the action line moved past it.
What changes is what is reported, never what is written. A threshold is a reading instrument, and moving it does not cause an extension.
Your schedule is the real floor
A threshold is only checked when something checks it. If the engine runs every fifteen minutes, an entry can cross its boundary and sit there for up to fifteen minutes before any decision is recorded — and that is the best case, because a scheduler does not deliver every run it promises.
Ours has been measured rather than assumed, and the delivered rate is well below the configured one. The figures, and the worst gap actually observed, are on the engine page. Set your act-now tier with room for the worst gap, not the nominal interval.
The same numbers in CI
The GitHub Action takes the same threshold in the same units, with the same inclusive boundary, and a repository wanting a week of warning sets it to 120,960 rather than to the default. Action reference
Next