Volter World

Build glossary

The words a contributor meets that a user never does. The user's words are in the user glossary; a word in neither is not allowed in a page, a flag or a message.

core — packages/world-core, @volter/world-core: the state kernel and shared runtime libraries. One entry model, checkpoints, parent-position branches and head execution; vendor semantics stay in the packages. See architecture.

kernel — packages/world-*: the runtime (world-runtime), the remote (twins-host), the dev-only tooling, the shared UI assets. Vendor-agnostic; few writers; kernel process.

pack — a twin's package as the build sees it: packages/twin/<vendor>/, born from scaffold-pack.ts, driven by the recipe, admitted by §9. A user says twin, or package.

catalog — every pack, as packages/twin/* in this checkout or as the installed @volter/twin-* packages in an app.

census — a pack's record of what it serves against the vendor's published spec: the source of the coverage percentage. spec-refresh, spec-census-record, spec-census-probe keep it current; the run date is the package's last verified.

ladder — the ranked roster of real application repositories measured against the catalog (generated/ladder.json); the build queue is derived from its uncovered vendors.

dossier — what the line gathers about a vendor before a pack is built: its spec, its SDK, its hosts.

line — the pack-build pipeline: line.ts, spec-dossier.ts, spec-compile.ts, sdk-compile.ts, scaffold-pack.ts, pack-shape-check.ts, merge-check.ts, land.ts.

§9 — the mandatory adversarial review every pack passes before it lands.

T0, T1, T2 — the verification tiers: a pack's own gate; the kernel suites and typecheck; the whole catalog. See gates.

door — an HTTP endpoint a twin or a remote serves beside the vendor's API. A user reads "HTTP API".

backing — which of local and remote stands behind a vendor on a remote. A user reads local and remote as nouns.

shape — a vendor's wire, as the code names it. A user reads "the vendor's API".

placeholder — the default data's origin, as the code names it (PLACEHOLDER_REMOTE, placeholder-pull). A user reads "default data".

observed — vendor state admitted through observeResource into a root’s log; default seeding supplies inherited state through the seed window.

landing — an entry added to the parent with a receipt; its branch copy is not applied twice.

admission — the reservation of memory and disk up makes before starting; refused by name.

instance — the running world's record: instance.json and the directory around it.

manifest (world) — the document a world publishes for attachments: vendors, CA, proxy, env. manifest (capability) — a pack's enumeration of the vendor's surface with a verify() per capability; the completeness number's denominator. manifest (pack) — a derived pack's src/manifest.ts: its descriptor, the vendor facts no spec carries, and the surfaces outside the spec.

derived pack — a pack with src/manifest.ts and src/generated/: its wire, schemas, generic CRUD, perform, refresh and coverage are generated from the vendor's spec; only its semantics are hand-written.

semantics — a derived pack's hand-written behaviour: state machines as data and handlers by operationId. Write semantics run wherever the head does not perform a write now; read semantics run under every head.

cell — a value of a state field paired with an operation on its resource; the unit a derived pack's completion is counted in.

attestation — a signed judgment (a journey's plausibility, a transition's source, a ruling on a cell, a review), keyed by the hash of what it depends on and stale when that changes.

attachment — applying a world's vendor map to one consumer. A user reads run, activate, shell.

narration — a changeset's generated summary, as the code names it. A user reads "summary".

basis — a change’s recorded assumptions, as compatibility code names them. A user reads "base" for the branch’s parent position.

sealed — the mode a user reads as "sandbox"; also a credential at rest on the remote.

recipe (cookbook) — a runnable example, as the cookbook's tooling names it. A user reads "example". recipe (the twin recipe) — adding a twin.

skin — the composed front a remote presents: one URL, every twin a path.

R-numbers (R2a, R14, …) — identifiers retained in the invariant runners and older design records. Current implementation rules live in architecture, and unresolved work lives in the roadmap.

history descriptor — an immutable view's verified segment ranges, storage generations and projection layout. The descriptor's content hash identifies it; its dependencies participate in World cleanup. Local views share payloads; a remote cache deduplicates complete entry contents.