Glossary
The words on these pages, one line each.
- ring
- A complete, signed set of pacman databases over the same packages: edge, rc, stable — and the lab beside them, where a build is tried by a real pacman before a maintainer sends it to edge; nothing in the lab is promised or promoted.
- release
- One immutable selection of packages for a ring; a ring's history is the list of its releases.
- head
- The release a ring serves right now. Pointing the ring at an earlier release is a rollback.
- evidence
- What a decision is made on: a health check, an ABI check, a security scan — or a contributor's build (PKGBUILD, log, manifest) in their staging workspace for a maintainer to read. Never what users install.
- staging workspace
- Where a contributor's builds land: theirs, public, evidence; 5 GB per contributor, reclaimed when a build is decided.
- soak
- The green health checks a ring must collect before the next one takes it: one for edge → rc, two in a row (about six hours) for rc → stable.
- fast-track
- A confident advisory with a clean newer version already in edge, or a factory build the trial installed, goes to rc and stable at once — with the usual health check and rollback.
- the lab
- The fourth ring, beside the three: the factory's builds are pinned there and installed by a real pacman (the trial) before a maintainer decides; nothing in it is promised or promoted.
- the trial
- A real pacman installing the project's build from the lab, in a clean container, before a maintainer approves it; its transcript sits beside the audit.
- OPR
- The Omarchy Package Repository: Omarchy's own packages; its edge channel is a source of the pool, and it earns rc and stable here like every other source.
- ABI check
- Before a promotion: does anything the ring serves load a library whose symbol versions the promotion would change? If so, the promotion is blocked.
- lease
- A worker's claim on a task: it holds the lease while it builds and heartbeats; an expired lease puts the task back in the queue.
- trust
- Two maintainers' word on a worker's registration — one proposes, another confirms; the owner never proposes their own, but may confirm — that lets it run the project's jobs and rebuilds; one maintainer takes it back.
- the broker
- The one process on a worker's host that holds the token and the agent key and runs no build; the builder beside it is born with nothing and speaks to it.
- category
- What a package is about, for a person browsing the pool — one of a fixed list; proposed by the project's agent, settled by a maintainer.
- the seal
- A package's provenance, served with it: the project and keyring for a synced package; the whole chain and a signed attestation for a factory one.
- track record
- One number, from what the pool records anyway: what you brought that a maintainer let in, what you built, what you decided.