← The Machine
The relationships · frontdoor.yml

Front door

The door this repository opens to strangers, re-emitted and validated on every push.

.github/workflows/frontdoor.ymlruns @flashyos/frontdoor

What it does

The workflow re-emits this repository’s `frontdoor/1` door from its config, validates the result against the format, and fails if emitting changed the committed file — because a stale committed copy means the door a machine reads is not the door the config describes.

The checker and the emitter are vendored byte-identical across every repository that publishes a door and are dependency-free, so the same job runs on a Next.js app and on a static generator with no install.

It also proves the charter is served, not merely committed: the AAO charter once returned 404 on nine of the estate’s ten live properties while the standard told everyone else to publish exactly that path, so the served copy is diffed against the root here.

When it runs
On every push to any branch and on every pull request.
What it emits
A validated `frontdoor.json` under `/.well-known/`, proven byte-identical to a fresh emit, and a `flashyos.roles.json` charter proven present in the served directory and matching its root copy.

What a stranger can verify

That the door is well-formed, carries the notAuthority paragraph, and is actually served. Fetch it from the domain itself with `npx @flashyos/frontdoor-verify <domain>` — over https, with a timeout and a size cap — so a door cannot be proved by a redirect.

Questions

What does the Front door workflow check?
That the frontdoor/1 door re-emits identically from its config, validates against the format, and is served rather than only committed — alongside the AAO charter, which once 404’d on nine of ten live properties.
Why re-emit the door instead of just validating it?
Because a committed door can drift from its config. Re-emitting and failing on any difference proves the door a machine reads is the one the config describes, not a stale copy somebody forgot to regenerate.
Why does the workflow check the door is served, not just committed?
Because four times in one week a mesh file passed its committed check and 404’d in production. A door that validates in the repository but is not served at the domain is a door no stranger can actually read.
The concept

An organizational front door is a published file declaring which lanes an organisation opens to strangers, what it asks at each, and what it owes in return — verified from the applicant’s own domain over https, and normative that a rung buys a reply and never authority.

organizational front door →

Keep reading

Read the workflow — it hides nothing ↗The format it keeps current: @flashyos/frontdoorHow the estate stays honest — all of it
Also in the relationships
Directory