Skip to content

toolroom.audit

Report which tools have moved on since their record's newest reading.

A record holds what one tool accepted at the versions it was read from. Tools keep releasing, and footman promises no particular speed at following them — so a tool showing up here means a newer version exists, not that anything is wrong. Every stubbed verb ends in **flags: Any, so the bridge already speaks a flag the record has never heard of; only the hint is behind. --fix takes a fresh reading, --strict gives automation something to trip on, and --prefix asks the question against a provisioned latest set rather than this machine.

A snapshot only ever moves forward, so two readings are worth less than the record already checked in and are named and left alone: a tool missing from --prefix (a partial provision must not read as drift, and the host's copy is not the answer), and one whose version is older than the record holds (a machine behind the one that took the snapshot has nothing to add). Neither counts as behind — they are unanswered.

One finding here is a fault, and always exits non-zero: footman's negation and wrapper tables are read by the runtime, so a disagreement there means a task emits the wrong command today.

fm toolroom.audit [--only=VALUE] [--fix] [--prefix=VALUE] [--strict]
Parameter Type Default Description
--only=VALUE "" check just this tool
--fix flag false take a fresh snapshot instead of reporting
--prefix=VALUE "" read binaries from this prefix's bin/
--strict flag false exit non-zero when a snapshot is behind

Returns: an object

Example

$ fm toolroom.audit --fix