← All packages
The record · v0.1.0 · Apache-2.0

@flashyos/canon

A lockfile for facts

canon/1 — a lockfile for facts. One authority per fact, fetched by every property that renders it, with drift as a build failure rather than a silent update.

npm i @flashyos/canonnpm ↗source ↗

Why it exists

Ten properties render the same definitions, counts and paths, and each was typed in by hand — so changing one meant remembering every place it was written, and the places nobody remembered were wrong quietly for a year. This is `npm install` for prose: one authority, a revision, a lockfile, and a build that fails when they disagree.

What it refuses to do
It never updates a page silently. A build reads only the lock, so it is reproducible and works offline; the check reports drift as a failure naming both values and the authority. A channel that changed ten sites with nobody reading a diff would make every page unverifiable at any moment.

Use it

Find out whether a fact this site renders has moved
npx canon check

Installing it puts this command on your path — read from the package’s own manifest, so this list cannot drift from what you actually get.

canon

The licence

Apache-2.0, read from the package’s own manifest. Embed it in anything, including closed software — that is what makes a spec adoptable and a verifier worth running. FlashyOS’s server side is AGPL-3.0-only instead, and a test in the monorepo asserts the direction between them: AGPL code may consume this, this may never consume AGPL code.

Keep reading

The standardAudit a site
Also in the record
@flashyos/directory@flashyos/backlog@flashyos/shiplog@flashyos/checkpoint@flashyos/frontdoor