Skip to content

A profile sets how often a worker should checkpoint, and a stale task is reported

Each profile has a checkpoint_interval. check --checkpoint records a checkpoint; check and watch compare the last checkpoint with the interval and report a task that has gone quiet for longer than its profile allows.

declared statusdeclared status: advisory Projected into the worker's instructions. Whether a worker honours it is not observable from outside. Documentation, not enforcement.

recorded evidencerecorded evidence: not run Not judged: only a guaranteed claim is held to a recorded run. how evidence is recorded

The staleness report is guaranteed. Whether the worker checkpoints is not.

What it means

Each profile has a checkpoint_interval. check --checkpoint records a checkpoint; check and watch compare the last checkpoint with the interval and report a task that has gone quiet for longer than its profile allows.

How it works

checkpoint_at on the task record is updated by check --checkpoint, by handover, and by finish. lib/check.sh computes the age against the profile interval and emits a warning; lib/watch.sh emits staleness drift. The staleness report is deterministic; the worker's checkpointing is not.

How to see it

majordomus check --checkpoint
majordomus watch     # DRIFT staleness … when the interval has passed

What it does not cover

Advisory on the worker's side: whether it checkpoints is up to it. The report of a stale task is guaranteed; a stale checkpoint is a warning in check and never blocks.

Why it exists

Sessions that never end were a named failure; a checkpoint interval makes "this task has not been touched in an hour" a fact the tool can state.

Detail rendered from docs/claims/checkpoint-interval.md.

From the statement to the proof

  1. 1 · the public statement

    A profile sets how often a worker should checkpoint, and a stale task is reported

    Made on Profiles.

  2. 2 · the canonical claim

    checkpoint-intervaldeclared status: advisory in docs/CLAIMS.yaml

    Defined in read it on this site · share/skeleton/policy.yaml

  3. 3 · the implementation

    lib/check.sh · majordomus check

  4. 4 · the test and the scenarios

    Test: test/cases/04_start_check.sh

  5. 5 · the recorded runs

    recorded evidence: not run how evidence is recorded

Verify it yourself

The test runs in a disposable temporary repository and asserts the behaviour, not a string in the source.

from a clone of the repository
bash test/run.sh 04_start_check

Where this claim is used

Related claims same implementation

The moments this answers

Searches the titles and descriptions of every page this site publishes.