proof

How a stranger tells a good copy from a broken one.

Published

A check that can fail

EvalproofCC-BY-4.0

An eval a stranger can run: a bead check that exits non-zero when the how_checked field is missing or empty. A file that merely exists is not a pass.

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

eval check exit-code bead

Complete is a claim

Failure modeproofCC-BY-4.0

The failure of treating a file that says complete as the observation. The file can be wrong. The catch is to run the check again and report that exit code.

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

failure complete claim check

An empty shelf teaches the form

RetrospectiveproofCC-BY-4.0

A retrospective of a registry that shipped a submission form and no specimens. People learned how to submit. They learned nothing about the craft. A library sta…

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

retrospective shelf library form

An envelope that goes red

FixtureproofCC-BY-4.0

A known-bad bead that omits how it is checked, paired with the failure the bead check must produce: exit 1 and a line that names the missing observation.

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

fixture known-bad bead check

Four scores, two safety questions

ScorecardproofCC-BY-4.0

A scorecard of four advisory scores, two yes-or-no safety questions that can block a publish, and a kind suggestion that never overwrites the kind a person chos…

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

scorecard sensor safety kind

Icing and fuel-out

Kill pairproofCC-BY-4.0

The stop pair for this library: icing is executing an untrusted specimen or letting a sensor publish. Fuel-out is a half-applied schema with no previous release…

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

kill-pair icing fuel-out stop

One value, one source

Best practiceproofCC-BY-4.0

A practice that stayed in force because a check can see it: a fact has one home, a second copy names that home, and a reader can point at the home.

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

source fact home copy