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

@flashyos/shiplog

What you shipped, sealed so a stranger can check it

shipped/1 — the past tense of a record. One sealed entry per thing that shipped, emitted per repository and merged into one cross-repository calendar, changelog and attribution report. Verifiable offline; the past is append-only.

npm install @flashyos/shiplognpm ↗source ↗

Why it exists

One entry per thing that reached the branch that deploys: dated, attributed to the agents and humans who did it, and sealed with the same canonicalisation that seals every settlement here. The cross-repository calendar and the changelog are projections of the merge rather than services, so a company joins by publishing one file instead of being integrated.

What it refuses to do
Nothing is edited. A wrong entry is superseded by a new one, because an edited entry has a different digest and every receipt that quoted the old one would stop verifying. It also refuses to guess: a commit it cannot classify is filed as `other` rather than inflating the number everybody reads.

Use it

Re-verify every seal, then read the calendar
npx @flashyos/shiplog check ./fragments
npx @flashyos/shiplog calendar ./fragments --grain week

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.

flashy-shiplog

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

Machine surfaces
Also in the record
@flashyos/directory@flashyos/backlog@flashyos/checkpoint@flashyos/frontdoor