ADR 0244: the mesh in domains, one word per thing, checked (graduates research 034) #174

2026-10-07T18:02:22Z

mesh-admin commented

2026-10-07 18:02:22 +00:00

Graduates research 034 (carried here from #170, which this replaces) into a decision, a design and a check.

ADR 0244 — the mesh is described in ten domains (a domain is an area that owns its concepts and the one word for each; ADR 0006's seven contexts carry over as domains, observability becoming Health and repair). A machine is any computer; a node is a machine the mesh has adopted and owns. The glossary is the authority, organised by domain, and a retired word is named on its replacement's *Not:* line with its scope (none, hq or tools). It settles the clashes the operator answered on 2026-10-07: node-engine (not "the host"), tool runner (not "node tools"), the mesh MCP server (not "console"), mesh-sdk, plan / push / send / release / deploy as the research proposed.

To-be 49 draws the domains and how the words are kept and checked.

Glossary rewritten by domain: the console and deprecated-broker contradictions removed, the missing words added (module, manifest, condition, gate, tier, operator, ...), a homonym table, 25 retired words on Not: lines.

00-META/checks/words.py, run by merge-check.sh: fails on a retired word in running prose (code spans, quotations and link targets exempt) in 00-META, both design layers, AGENTS.md, README.md and research/issues dated from 2026-10-07; and on a head word defined twice or also retired. Its first run found 581 uses in 63 documents; all are reworded here (wording only). words-allowed.md keeps research 034 as written (a graduated record of the words it studied). Decision records are untouched.

Companion: the catalogue's copy of the tools' retired words and its check (mesh-catalog, branch feat/tool-descriptions-use-the-glossarys-words).

Checks run: records.py, index.py, cycle.py, words.py, sh merge-check.sh — all pass; words.py also compared with the catalogue's copy (MESH_CATALOG_DIR) and matches.

Graduates research 034 (carried here from #170, which this replaces) into a decision, a design and a check. **ADR 0244** — the mesh is described in ten domains (a *domain* is an area that owns its concepts and the one word for each; ADR 0006's seven contexts carry over as domains, observability becoming Health and repair). A **machine** is any computer; a **node** is a machine the mesh has adopted and owns. The glossary is the authority, organised by domain, and a retired word is named on its replacement's `*Not:*` line with its scope (none, hq or tools). It settles the clashes the operator answered on 2026-10-07: node-engine (not "the host"), **tool runner** (not "node tools"), **the mesh MCP server** (not "console"), mesh-sdk, plan / push / send / release / deploy as the research proposed. **To-be 49** draws the domains and how the words are kept and checked. **Glossary** rewritten by domain: the console and deprecated-broker contradictions removed, the missing words added (module, manifest, condition, gate, tier, operator, ...), a homonym table, 25 retired words on `Not:` lines. **`00-META/checks/words.py`**, run by `merge-check.sh`: fails on a retired word in running prose (code spans, quotations and link targets exempt) in 00-META, both design layers, AGENTS.md, README.md and research/issues dated from 2026-10-07; and on a head word defined twice or also retired. Its first run found 581 uses in 63 documents; all are reworded here (wording only). `words-allowed.md` keeps research 034 as written (a graduated record of the words it studied). Decision records are untouched. Companion: the catalogue's copy of the tools' retired words and its check (mesh-catalog, branch `feat/tool-descriptions-use-the-glossarys-words`). Checks run: records.py, index.py, cycle.py, words.py, `sh merge-check.sh` — all pass; words.py also compared with the catalogue's copy (MESH_CATALOG_DIR) and matches.

mesh-admin added 3 commits 2026-10-07 18:02:23 +00:00

Research 034: the mesh in domains

mesh/merge-gate pass: the change touches no module of the mesh's graph

Details

mesh/repo-check pass: its merge-check.sh passed

Details

mesh/delivery stopped: the pull request closed unmerged

Details

f2abbb042c

The operator asked for one language per domain because the same concept
keeps arriving under different words. Inventory the words in use, test a
domain split, list the clashes with evidence, and describe how the
glossary rule would be checked.

Graduate research 034: the mesh in domains, one word per thing, checked a28da1734b

ADR 0244 sorts the mesh's concepts into ten domains (ADR 0006's contexts
carry over as domains), keeps machine and node as distinct words, and
makes the glossary the authority with every retired word on its
replacement's Not: line. To-be 49 draws the domains; the glossary is
reorganised by them, its two contradictions removed and the missing
words added. words.py now fails on a retired word in running prose and
on a word defined twice, so the rule is enforced rather than believed;
the 63 documents it failed on are reworded here, and research 034 is
kept as the record of the words it studied.

Retire "the host" in hq prose only: in the tools it is also an SSH server's word

mesh/merge-gate pass: the change touches no module of the mesh's graph

Details

mesh/repo-check pass: its merge-check.sh passed

Details

mesh/delivery superseded: a newer head of the same pull request

Details

051696e107

mesh-admin commented

2026-10-07 18:03:03 +00:00

Delivery novox/hq@008014591b02 — delivered since 2026-10-07T18:24:03Z

Delivery plan — builds nothing: the change touches no module of the mesh's graph

Transitions

2026-10-07 18:07 (new) → proposed (announced): novox/hq#174's head announced
2026-10-07 18:10 proposed → checked (checked): the verdict names this commit
2026-10-07 18:10 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
2026-10-07 18:24 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
2026-10-07 18:24 published → delivered (done): nothing for a walk to move

The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.

**Delivery** `novox/hq@008014591b02` — **delivered** since 2026-10-07T18:24:03Z **Delivery plan** — builds nothing: the change touches no module of the mesh's graph **Transitions** - 2026-10-07 18:07 (new) → proposed (announced): novox/hq#174's head announced - 2026-10-07 18:10 proposed → checked (checked): the verdict names this commit - 2026-10-07 18:10 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail - 2026-10-07 18:24 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move - 2026-10-07 18:24 published → delivered (done): nothing for a walk to move The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.

jschoubben added 1 commit 2026-10-07 18:07:36 +00:00

Do not track the word check's compiled cache

mesh/merge-gate pass: the change touches no module of the mesh's graph

Details

mesh/repo-check pass: its merge-check.sh passed

Details

mesh/delivery delivered

Details

008014591b

mesh-admin merged commit 4556d37370 into main

2026-10-07 18:23:58 +00:00

mesh-admin deleted branch decision/0244-the-mesh-in-domains