From eb7356360fea0561f0571350fe4e9ed1fd519139 Mon Sep 17 00:00:00 2001 From: jochen Date: Mon, 5 Oct 2026 22:31:13 +0200 Subject: [PATCH] Glossary: the node-engine, the program every node runs, replaces "host agent" and mesh-host --- 00-META/glossary.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/00-META/glossary.md b/00-META/glossary.md index 5a84ad9..70e498a 100644 --- a/00-META/glossary.md +++ b/00-META/glossary.md @@ -7,7 +7,7 @@ another — and a mesh you cannot name precisely is a mesh two people describe d ## The mesh and its machines -- **node** — a machine in the mesh. There are 0..n of them, and each runs the host agent. A node is +- **node** — a machine in the mesh. There are 0..n of them, and each runs the node-engine. A node is just a machine that has joined; being one implies nothing about what it runs. - **operator account** — the login name of the person who works on a node, stated on the node record; empty for a machine nobody logs into. Everything the mesh places under a person's home is @@ -28,6 +28,13 @@ another — and a mesh you cannot name precisely is a mesh two people describe d control-plane/data-plane, and opaque here). - **mesh-controller** — the module that runs the controller. It **claims** the `mesh-controller` seat at mesh scope, which is what makes it singular. Replaces the module name **`mesh-control`**. +- **node-engine** — the program on every node that applies what the controller declares: it receives the + node's declaration, writes the files, runs the services and containers, and reports what it did. It + is the engine, not a module: it owns no file's content, and every file it writes belongs to the module + that declared it. Replaces **"host agent"**, **"the host"** and **`mesh-host`**. *Agent* is avoided + because the word already means two other things here, the build agent and the operator's coding + agent. The code still carries the old name (the `mesh-host` repository, its binary and service + unit) until the rename is made there; a record written before the rename keeps the old name. (The git repository has been renamed `mesh-control` -> `mesh-controller` on the forge; the module, container and image it produces are `mesh-controller`.) - **foundation** — the store and the broker, raised at genesis before any module system exists.