Glossary

Terms are as the project defines them on 15 November 2026. A term marked (draft) comes from a draft document.

Term Meaning
Admission An owner-signed record saying "this service, from this publisher, as this class, may exist" on a node. No admission, no run. Chapter 9.
Advertisement freshness How a node's liveness is judged: recency of its advertisement, not DPresence. (draft)
Authority registry The one Venue registry a node is bound to for placement. (draft)
BenixOS The distributed OS: one namespace, identity, placement and storage across every node a person or household owns.
Channel A folder of signed release files (nightly, beta, stable) served by any web server; not trusted.
Claim Binding a device to an owner: pins the owner key and produces a signed binding record.
Client node A node that holds keys and presents grants but hosts no services and holds no leases.
Conformance suite Tests a Hearth implementation, or a node, must pass. Neither exists yet.
D (message) A server-pushed Hearth message with tag = 0.
DeviceNix The BenixOS-native host distro; Yocto in slash-builder/core.
Distribution A named bundle of services with roles and host support, resolved to a lock and published on a channel.
Envelope The single Protobuf message on every Hearth frame.
Executor The process that follows venued's feed and runs containers. venue-node is its first form.
Fencing token (registry key id, incarnation, hold revision), minted by the registry. (draft)
Full node A node that hosts services.
Glue A service adapter exposing an upstream service as nodes in the namespace.
Grant An owner-signed, typed, attenuable, offline-verifiable permission to use or egress a resource. (draft)
Hearth The open wire protocol for distributed personal resources, 9P-inspired.
High-water mark The highest registry revision a node has accepted, persisted on disk. (draft)
Hold A Venue reservation: place, start, renew, release.
Hub The server that routes Hearth sessions; Quickring operates the reference one.
Incarnation A registry's restore generation; a restored registry starts a new one. (draft)
Kit A focused library owning one domain, with an API others build on.
Lease The time a hold or placement stays valid; judged by the node's own monotonic clock.
libbenix The portable primitive library in benix-base; candidate node-contract primitives.
Lock The complete, self-contained, hash-identified plan a distribution compiles to.
Manager A Venue principal class with its own token and caps: Authoritative, NodeAgent, Consumer, Observer, Untrusted.
Node A claimed machine or container running a node agent.
Node agent The resident process that decides whether a placement runs, from grants and local policy.
Node contract The document everything else is specified against. v0 is a draft.
Owner The person whose key was pinned on the node at claim.
Partition policy Per workload: replace, hold or self-stop if the registry is lost. (draft)
Placement A Venue decision about where work runs. Not an authorization.
Profile A tiered selection of BenixOS offered by Quickring, at engineering altitude.
PoP Proof of possession of a device key.
Quickring The commercial operator built on Hearth and BenixOS.
R (message) A server response to a T, with the same tag.
Registry key The key the registry signs placements with; separate from its TLS key. (draft)
Release id The hash of a lock's contents.
Roster The household's list of devices, attested and read by devices.
Role An owner-signed assignment of what a node may do; checked against a placement's group label. (draft)
Sealed payload An end-to-end encrypted Hearth payload; the hub cannot read it.
Star topology One registry host, an executor on every node, outbound-only.
T (message) A client request; the server answers with exactly one R or RError.
Tag The per-message correlation id.
Thunderhead The reference-hardware category: Aether (Pi 5, CM5) and Forge (AMD64).
Typed address A resource address parsed once into a typed value that rejects non-canonical spellings. (draft)
Venue The registry, planner and ledger for places work can run. Provisional name.
venued Venue's daemon: JSON over HTTP, a token per app, a long-poll event feed.