A beat the forge owns, and a gate on the push

The beat

A repository can carry a routine in its default branch's forge.json:

"beat": { "every": "1h" }

Every every (10m to 7d, default an hour; a misspelt key or a bad value is refused with the field named, src/apps/beat_spec.ts), the forge takes one turn of the repository's autonomy loop with its own agent: the next ready issue goes to the crew, or the planner is asked when the map is thin, or the feed says why not (beat.ran: every builder busy, the crew at its pace, autonomy paused, nothing ready). It needs nothing on anyone's machine and stops where the autonomy stops: a person turned autonomy on and set its week's share, and a spent share starts nothing.

In the autonomy tick, a repository with a beat takes its turn of the loop only when the beat is due; the passes around it (finishing, stuck pulls, requested changes) still run each minute. The feed hears when the outcome changes or something started, not every interval, and a beat that cannot be read is said once in the feed (beat not kept: ...) while the repository stays on the minute loop. A repository whose autonomy is off has no beat, and says nothing: autonomy is the switch a person owns. The last run is held in process memory (src/crew/beat.ts), so a restart beats once at once.

The gate

A commit pushed straight to the default branch of an app that declares app.test no longer switches before it is tested. The new tree starts beside the old one and its tests run first; green switches, red does not (the tests get a budget, GATE_BUDGET_MS, ten minutes; a suite that outlives it counts as red): the last green commit keeps serving, the deploy run fails with held back: its tests failed (...); <sha> keeps serving, the feed carries an app.gated post, and the owner's notification address (Account) gets the same line. The first deploy of an app and a merged pull (already checked) switch at once, as before; previews are unchanged (src/apps/push_gate.ts).

The app template's AGENTS.md states the ritual: one change, its test, its README line, its version, one commit.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs