Skip to content

toolroom.refresh

Observe what is new on this platform, and fold it into the store.

gather then assemble, in one process — the whole job when one machine is the whole matrix, and exactly the two halves the weekly workflow runs on three machines and one assembler. There is no third code path: what runs locally is what runs in CI, with the document handed across a function call instead of an artifact.

Nothing new anywhere means nothing to release, and that is the whole exit condition. An index that would not answer is reported and exits non-zero rather than counting as "nothing new": a rename or a moved repo would otherwise make a tool silently untracked while the job kept reporting success.

With --submit, a refresh that moved a tool's surface is committed on the day's branch and submitted as a pull request: armed when every change only added to a surface, the graded trigger's green light, and left for a person otherwise. A day's branch that origin already holds with every file this refresh wrote means the day's refresh is already submitted. Nothing moved means no branch and no pull request. A refresh asked to submit submits from the history of origin's default branch alone, so on another checkout, a branch a rehearsal runs on among them, it observes nothing and says so.

fm toolroom.refresh [--only=VALUE] [--prefix=VALUE] [--no-changelog] [--submit]
Parameter Type Default Description
--only=VALUE "" refresh just this tool
--prefix=VALUE "" drive the tiers from this prefix's bin/
--changelog flag true write the events into CHANGELOG.md
--submit flag false commit what moved on a branch and open its pull request

Returns: Refreshed {read, events, unreachable, skipped, holes, wrote_changelog, release, additions_only, ingest, ingest_ok, artifacts}

Field Type
read a mapping of lists of text
events a mapping of lists of text
unreachable a mapping of text
skipped a list of text
holes a mapping of lists of text
wrote_changelog true/false
release true/false
additions_only true/false
ingest a mapping of lists of text
ingest_ok true/false
artifacts a mapping of lists of text

Example

$ fm toolroom.refresh --changelog