Autonomous development for real products. Governed agents build from specs you approve, follow the rules you set, and nothing merges until another agent proves it. Your decisions, judgement and taste are the bar that work must clear. Declare your vision and let agents build it.
JavaScript agentic-codingai-agentsai-governanceautonomous-agentsclaude-codeclicode-reviewcodexcoding-agentsdeveloper-toolsgit-hooksllmlocal-firstmulti-agentsoftware-factoryspec-driven-developmentverificationvibe-coding
docs(formats): engine 63 records recurring jobs [D1,C7]
Corey Olson63e2bce16386
diff --git a/docs/formats.md b/docs/formats.mdindex fabf5b1e..84f5c4f2 100644--- a/docs/formats.md+++ b/docs/formats.md@@ -113,7 +113,7 @@ The board file is in the repository's Git common directory at `.git/pullboard/bo| `row grammar` | `1` | `SPEC_GRAMMAR_VERSION` in `src/spec.js`; optional `<!-- pullboard-grammar N -->` line in either file (absence means the current grammar) | Both files share the version. A declared version must match; an incompatible grammar change requires a coordinated version bump and compatible files. No automatic conversion occurs. || `board schema` | `2` | `SCHEMA_VERSION` in `src/board.js`, persisted as `PRAGMA user_version` | Create missing tables and indexes, add missing columns in place with declared defaults, restore missing or changed triggers, and remove stale machine triggers without replacing rows. || `event log` | `1` | `EVENT_LOG_VERSION` in `src/board.js`, persisted in `board_meta` as `event_log_version` | Older event-log versions upgrade in place; newer versions are refused with `EVENT_LOG_VERSION`. Preserve event rows when the board schema changes. |-| `move engine` | `62` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |+| `move engine` | `63` | `ENGINE_VERSION` in `src/machine.js`, carried as `engine` in every sealed executable move | Bump when a move's meaning changes, independently of the event log and sealed envelope. A newer engine is refused with `ENGINE_VERSION`, naming both versions and asking you to upgrade Pullboard. |<!-- format-versions:end -->Relay transport capability `apiVersion: 2` is independent of these versions and@@ -176,6 +176,8 @@ Engine 61 (`NATIVE_FLAKE_ENGINE`) adds `recordFlakeObservation` and typed diagnoEngine 62 (`HEALTH_CAP_ENGINE`; engine 61 is #887's) caps what one recorded health run shouts. A run sends at most ten notices one by one, resolved first; when it has more, one more notice to the coordinator says how many it held back, and every finding still records its own health event. An idle seat alone hears that it is idle. A recorded run at an older engine replays with its original notices.+Engine 63 (`RECURRING_JOB_ENGINE`) records recurring jobs. `declareJob` is the coordinator's or the person's: it stores a job's name, its cadence (`10m`, `2h`, `1d`, `hourly` or `daily`) and its owner, and a later declaration replaces the cadence and owner but keeps the run history. `recordJobRun` is any joined seat's and stores the job's name. Both events carry `engine: 63`. `pullboard health` reports a job with no run within one and a half cadences as `JOB_MISSED`, once per episode. An older engine refuses both moves with `ENGINE_VERSION`, and a replay at an older engine ignores their events.+The CLI declares its engine in every relay request's `X-Pullboard-Engine` header.A linked board requires at least engine 48 after issuing any agent token or machine credential, includingrevoked or expired ones; before engine 48 these minimums were 3 and 6. The minimum survives reopening the auth database;diff --git a/test/health.test.js b/test/health.test.jsindex f9c774d4..2a7ea940 100644--- a/test/health.test.js+++ b/test/health.test.js@@ -579,3 +579,32 @@ test('an agent cannot widen a declared cadence [D1,C7]', (t) => {assert.equal(recurringJobs(board)[0].every, '10m');assert.equal(store.declareJob(board, { agentId: 'coordinator', name: 'loop', every: '1h', owner: 'coordinator' }).every, '1h', 'the coordinator may change it');});++test('a missed job is reported once per episode, not on every scan [D1,C7]', (t) => {+ const box = repo(t);+ const { board, at } = boardAt(box);+ t.after(() => store.closeBoard(board));+ store.register(board, { lane: 'coordinator', path: box.root });+ const worker = store.register(board, { lane: 'core', path: join(box.dir, 'core-1') });+ at(10 * HOUR);+ store.declareJob(board, { agentId: 'coordinator', name: 'sweep', every: '10m', owner: 'coordinator' });+ at(0);+ /** Scan and record as the sentinel does; returns what the scan published, or null when nothing changed. */+ const scan = () => {+ const seen = scanHealthSentinel(box.file, { root: box.root, config: loadConfig(box.root), now: new Date(NOW) });+ if (seen) store.recordHealthFindings(board, { agentId: 'coordinator', ...seen });+ return seen;+ };+ assert.ok(scan()?.findings.some((entry) => entry.key === 'JOB_MISSED:job:sweep'), 'the first scan reports the miss');+ const notices = () => store.allShouts(board).filter((notice) => notice.shout_from === 'sentinel').length;+ const first = notices();+ assert.ok(first >= 1, 'the owner hears of it');+ assert.equal(scan(), null, 'a second scan of the same episode publishes nothing');+ assert.equal(notices(), first, 'and shouts nothing');+ at(5 * 60_000);+ store.recordJobRun(board, { agentId: worker, name: 'sweep' });+ at(0);+ const cleared = scan();+ assert.ok(cleared && !cleared.findings.some((entry) => entry.cause === 'JOB_MISSED'), 'a run ends the episode and the scan publishes the clearing');+ assert.equal(scan(), null, 'and then it is quiet');+});