← The Machine
The relationships · directory.yml

Directory

This repository’s slice of the record, validated at the point it is made.

.github/workflows/directory.ymlruns @flashyos/directory

What it does

The workflow emits this repository’s `directory/1` fragment — the nodes and edges it is the authority for — checks the charter conforms, and validates the fragment, declaring with `--external` every id it references but does not own so it cannot quietly assert a definition of somebody else’s organisation.

The estate-wide merge already catches contested authority and dangling references, but it runs elsewhere and cannot say which repository caused them. This runs here, so a bad fragment fails where it was written.

Two diffs close the loop: the committed fragment must match a freshly emitted one, so nobody edited the JSON instead of its source, and the served copy under `public/` must match the root, so the estate’s federated directory can be assembled without a git checkout.

When it runs
On every push to any branch and on every pull request.
What it emits
A validated `directory.fragment.json` at the repository root and its served copy under `apps/marketing/public/`, proven identical to each other and to a fresh emit.

What a stranger can verify

That the fragment a machine reads is the fragment the source describes. Validate any fragment with `npx @flashyos/directory` against the file itself; the served copy and the committed copy are asserted identical, so a hand-edit cannot hide.

Questions

What does the Directory workflow validate?
This repository’s directory/1 fragment — the nodes and edges it is the authority for — plus that its charter conforms and that every id it cites but does not own is declared external, so it cannot assert a definition of another organisation.
Why validate a fragment per repository when the estate merges them?
The estate-wide merge catches contested authority and dangling references but runs elsewhere and cannot say which repository caused them. Validating here fails a bad fragment at the point it is made, where the cause is obvious.
How does the workflow stop a hand-edited fragment?
It re-emits from source and fails if the committed fragment differs, then diffs the served copy under public/ against the root. A fragment edited by hand instead of via its source no longer matches, and the run goes red.
The concept

A federated directory is a record where each repository emits only the nodes and edges it is the authority for, and the fragments merge into one graph — so an organisation, person or product has a single record and contradictions surface as findings rather than being averaged away.

federated directory →

Keep reading

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