Each mergeable file names the top-level setting keys it takes, in takes-settings (hq ADR 0326):
searxngsettings: general, brand, search, server, ui, outgoing, engines, plugins, categories_as_tabs, preferences (the sections of searxng's settings.yml a person tunes). Its own valkey and use_default_settings are left out. The layer stored for ace (endpoints, search, server) still composes: endpoints is the mesh's own word and no longer lands in the file.
keycloakruntime-config: url, user, realm, issuer, the keys keycloak-provider reads. password is left out on purpose, because the admin password reaches the tools as a file (ADR 0086). No layer is set for keycloak today.
betterbirdaccounts: accounts. betterbird declares the preference prefs, so ADR 0326 §3 requires its mergeable file to name its keys. No layer is set today.
Why
hq issue 168: every setting reached every mergeable file of its module.
How it was tested
MESH_GATE=<mesh-controller #272 built> MESH_CHECK_MODULES="searxng keycloak betterbird" sh merge-check.sh passes: the module check over every manifest, words, agent home, paths, and keycloak's and betterbird's Go tests. The controller of #272 refuses betterbird's definition on main for lacking takes-settings.
Order: do not merge before mesh-controller #272 has walked
The controller the mesh runs today hands takes-settings to the node-engine, which parses resources strictly. Expect mesh/merge-gate to be red until #272 is live, then re-run it.
Fixes issue 168.
## What
Each mergeable file names the top-level setting keys it takes, in `takes-settings` (hq ADR 0326):
- **searxng** `settings`: `general`, `brand`, `search`, `server`, `ui`, `outgoing`, `engines`, `plugins`, `categories_as_tabs`, `preferences` (the sections of searxng's `settings.yml` a person tunes). Its own `valkey` and `use_default_settings` are left out. The layer stored for ace (`endpoints`, `search`, `server`) still composes: `endpoints` is the mesh's own word and no longer lands in the file.
- **keycloak** `runtime-config`: `url`, `user`, `realm`, `issuer`, the keys `keycloak-provider` reads. `password` is left out on purpose, because the admin password reaches the tools as a file (ADR 0086). No layer is set for keycloak today.
- **betterbird** `accounts`: `accounts`. betterbird declares the preference `prefs`, so ADR 0326 §3 requires its mergeable file to name its keys. No layer is set today.
## Why
hq issue 168: every setting reached every mergeable file of its module.
## How it was tested
`MESH_GATE=<mesh-controller #272 built> MESH_CHECK_MODULES="searxng keycloak betterbird" sh merge-check.sh` passes: the module check over every manifest, words, agent home, paths, and keycloak's and betterbird's Go tests. The controller of #272 refuses betterbird's definition on main for lacking `takes-settings`.
## Order: do not merge before mesh-controller #272 has walked
The controller the mesh runs today hands `takes-settings` to the node-engine, which parses resources strictly. Expect `mesh/merge-gate` to be red until #272 is live, then re-run it.
Fixes issue 168.
mesh/merge-gate head 2f55adc57c60 merged into trunk 43a9155d5afe — pass: builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person; e…
mesh/repo-check head 2f55adc57c60 merged into trunk 43a9155d5afe — pass: its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-…
Every setting reached every mergeable file: searxng's endpoints landed in
its settings.yml, keycloak's issuer in its tools' config, betterbird's
prefs would land in its accounts file. Each file now names the keys it
reads, so the controller lays only those over it and calls the rest
stray. Merge only after the controller that knows takes-settings
(mesh-controller #272) has walked: an older one hands the field to the
node-engine, which refuses it.
Deliverynovox/mesh-catalog@2f55adc57c60 — delivered since 2026-10-12T22:40:22Z
Delivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
tier 0: betterbird, keycloak, searxng
ace: receives searxng
g14: waits for a person: betterbird
novox: waits for a person: keycloak
shanks: waits for a person: betterbird
betterbird waits for a person: its policy records (person)
keycloak waits for a person: its policy records (module)
keycloak provides oidc-client: its consumers are sent again after it
keycloak keeps data (ADR 0233): what it holds is backed up before it moves
searxng keeps data (ADR 0233): what it holds is backed up before it moves
grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
Machines
searxng on ace: passed — healthy 1 times over 1m38s
searxng on the rest running it: sent
Transitions
2026-10-12 15:47 (new) → proposed (announced): novox/mesh-catalog#252's head announced
2026-10-12 15:53 proposed → checked (checked): the verdict names this commit
2026-10-12 15:53 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed
2026-10-12 22:24 rejected → proposed (recheck): judged again against trunk 43a9155d5a (it was rejected against trunk )
2026-10-12 22:24 proposed → checked (checked): a verdict names this commit and the trunk's head as its trunk commit
2026-10-12 22:24 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
2026-10-12 22:37 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
2026-10-12 22:37 published → delivering (go): its walk started: let go by this owner in its group's order, by a person, or on the controller's own path — not a failed walk that carried a later commit for it, after which it waits for a walk of its own commit
2026-10-12 22:40 delivering → delivered (done): its walk is done, carrying its own commit: every machine of its deploy plan passed, or was left as its policy says
The commit's note under refs/notes/mesh-plan keeps every transition: git log --notes=mesh-plan.
<!-- mesh-delivery:view -->
**Delivery** `novox/mesh-catalog@2f55adc57c60` — **delivered** since 2026-10-12T22:40:22Z
**Delivery plan** — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
- tier 0: betterbird, keycloak, searxng
- ace: receives searxng
- g14: waits for a person: betterbird
- novox: waits for a person: keycloak
- shanks: waits for a person: betterbird
- betterbird waits for a person: its policy records (person)
- keycloak waits for a person: its policy records (module)
- keycloak provides oidc-client: its consumers are sent again after it
- keycloak keeps data (ADR 0233): what it holds is backed up before it moves
- searxng keeps data (ADR 0233): what it holds is backed up before it moves
- grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
**Machines**
- searxng on ace: passed — healthy 1 times over 1m38s
- searxng on the rest running it: sent
**Transitions**
- 2026-10-12 15:47 (new) → proposed (announced): novox/mesh-catalog#252's head announced
- 2026-10-12 15:53 proposed → checked (checked): the verdict names this commit
- 2026-10-12 15:53 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed
- 2026-10-12 22:24 rejected → proposed (recheck): judged again against trunk 43a9155d5afe (it was rejected against trunk )
- 2026-10-12 22:24 proposed → checked (checked): a verdict names this commit and the trunk's head as its trunk commit
- 2026-10-12 22:24 checked → ready (accepted): the gate passed or warned, and the repository's own check did not fail
- 2026-10-12 22:37 ready → published (merged): on the trunk its modules follow: merged there, and its walk opened — or nothing for a walk to move
- 2026-10-12 22:37 published → delivering (go): its walk started: let go by this owner in its group's order, by a person, or on the controller's own path — not a failed walk that carried a later commit for it, after which it waits for a walk of its own commit
- 2026-10-12 22:40 delivering → delivered (done): its walk is done, carrying its own commit: every machine of its deploy plan passed, or was left as its policy says
The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
mesh/merge-gate: FAIL — 3 problem(s) the change brings; the first: a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored (modules: betterbird, keycloak, searxng)
mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
Delivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 2 wait(s) for a person
tier 0: betterbird, keycloak, searxng
ace: receives searxng
novox: waits for a person: keycloak
shanks: waits for a person: betterbird
betterbird waits for a person: its policy records (person)
keycloak waits for a person: its policy records (module)
keycloak provides oidc-client: its consumers are sent again after it
keycloak keeps data (ADR 0233): what it holds is backed up before it moves
searxng keeps data (ADR 0233): what it holds is backed up before it moves
grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
Run by the build seat on shanks as build-1791820078359988636 (builds --log build-1791820078359988636).
--- the gate: betterbird, keycloak, searxng
betterbird: ok, 8 tool(s), invokes seat:mesh-controller.settings
keycloak: ok; WARNING: server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
searxng: ok, keeps valkey (cache); WARNING: settings ask(s) for a setting and do(es) not say whether it is trusted, so it counts as trusted: set at the terminal alone; say "trusted" false where nothing trusts it (novox/hq issue 339); WARNING: cache, server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
long-running resources without health: 3
files asking for a setting without saying whether it is trusted: 1
3 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 3 module(s) changed against 4 machine(s), as the snapshot of 2026-10-12T15:47:39Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: FAIL — 3 problem(s) the change brings; the first: a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored
judged by controller development build against the facts of 2026-10-12T15:47:39Z
fails:
- a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): nothing could be sent to it with this change — resource "keycloak.runtime-config": a file does not use "takes-settings", and it is set. Refused rather than ignored
- holds mesh-dns-resolver (idt): nothing could be sent to it with this change — resource "searxng.settings": a file does not use "takes-settings", and it is set. Refused rather than ignored
modules the change moves:
- betterbird (changed)
- keycloak (changed)
- searxng (changed)
machines:
- a machine (f35): composes
- holds mesh-dns-resolver (idt): does not compose
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): does not compose
- a machine (yvbpsm): does not compose; the change adds 9 resource(s) and removes 0
a merge would rebuild 3 module(s) in 1 tier(s): betterbird, keycloak, searxng
mesh-controller: the change fails the merge gate
--- its merge-check.sh (go toolchain)
ok git.novox.be/novox/mesh-catalog/checks/words 0.003s
words: 12 retired words and 70 daemons' lines, none in the 44255 strings of 699 files
ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.013s
agent-home: no archive and no file written into under the agent's home
ok git.novox.be/novox/mesh-catalog/checks/paths 0.006s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 69, as kept
ok git.novox.be/novox/mesh-catalog/checks/deps 0.211s
testing modules/betterbird
ok betterbird/cmd/betterbird-tools 1.562s
testing modules/keycloak
ok keycloak/cmd/keycloak-provider 1.427s
modules/searxng is TypeScript: merge-check-typescript.sh type-checks and tests it
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/searxng (TypeScript)
NOT TESTED: modules/searxng is TypeScript and has no tests of its own
**Merge check** at `2f55adc5`
- `mesh/merge-gate`: **FAIL** — 3 problem(s) the change brings; the first: a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored (modules: betterbird, keycloak, searxng)
- `mesh/repo-check`: **PASS** — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
**Delivery plan** — builds betterbird, keycloak, searxng → ace; no bus step; 2 wait(s) for a person
- tier 0: betterbird, keycloak, searxng
- ace: receives searxng
- novox: waits for a person: keycloak
- shanks: waits for a person: betterbird
- betterbird waits for a person: its policy records (person)
- keycloak waits for a person: its policy records (module)
- keycloak provides oidc-client: its consumers are sent again after it
- keycloak keeps data (ADR 0233): what it holds is backed up before it moves
- searxng keeps data (ADR 0233): what it holds is backed up before it moves
- grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
Run by the build seat on shanks as `build-1791820078359988636` (`builds --log build-1791820078359988636`).
```
--- the gate: betterbird, keycloak, searxng
betterbird: ok, 8 tool(s), invokes seat:mesh-controller.settings
keycloak: ok; WARNING: server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
searxng: ok, keeps valkey (cache); WARNING: settings ask(s) for a setting and do(es) not say whether it is trusted, so it counts as trusted: set at the terminal alone; say "trusted" false where nothing trusts it (novox/hq issue 339); WARNING: cache, server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
long-running resources without health: 3
files asking for a setting without saying whether it is trusted: 1
3 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 3 module(s) changed against 4 machine(s), as the snapshot of 2026-10-12T15:47:39Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: FAIL — 3 problem(s) the change brings; the first: a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored
judged by controller development build against the facts of 2026-10-12T15:47:39Z
fails:
- a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): nothing could be sent to it with this change — resource "keycloak.runtime-config": a file does not use "takes-settings", and it is set. Refused rather than ignored
- holds mesh-dns-resolver (idt): nothing could be sent to it with this change — resource "searxng.settings": a file does not use "takes-settings", and it is set. Refused rather than ignored
modules the change moves:
- betterbird (changed)
- keycloak (changed)
- searxng (changed)
machines:
- a machine (f35): composes
- holds mesh-dns-resolver (idt): does not compose
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): does not compose
- a machine (yvbpsm): does not compose; the change adds 9 resource(s) and removes 0
a merge would rebuild 3 module(s) in 1 tier(s): betterbird, keycloak, searxng
mesh-controller: the change fails the merge gate
--- its merge-check.sh (go toolchain)
ok git.novox.be/novox/mesh-catalog/checks/words 0.003s
words: 12 retired words and 70 daemons' lines, none in the 44255 strings of 699 files
ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.013s
agent-home: no archive and no file written into under the agent's home
ok git.novox.be/novox/mesh-catalog/checks/paths 0.006s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 69, as kept
ok git.novox.be/novox/mesh-catalog/checks/deps 0.211s
testing modules/betterbird
ok betterbird/cmd/betterbird-tools 1.562s
testing modules/keycloak
ok keycloak/cmd/keycloak-provider 1.427s
modules/searxng is TypeScript: merge-check-typescript.sh type-checks and tests it
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/searxng (TypeScript)
NOT TESTED: modules/searxng is TypeScript and has no tests of its own
```
Independent review for hq issue 168 and ADR 0326. This approval holds for the change itself. It may merge only after mesh-controller #272 is merged and its rollout is done (mesh-controller.plans says done); then re-run the gate at this head or a rebase of it.
Keys against the stored layers (mesh-controller.settings, mesh-wide and per node)
searxng: there is no mesh-wide layer. ace's layer sets endpoints, search and server. search and server are named. endpoints is a mesh word that the mesh reads itself, so it is not stray. general, brand, ui, outgoing, engines, plugins, categories_as_tabs and preferences are real top-level sections of searxng's settings.yml. valkey and use_default_settings stay the file's own.
keycloak: there is no mesh-wide layer. novox sets only issuer, and issuer is named. Leaving password out is right. A setting is stored in plain text and is not a secret. keycloak-provider reads its password from MESH_KEYCLOAK_PASSWORD_FILE (${dir:state}/admin.secret), which the manifest sets, and config.json's password is only a fallback that nothing sets.
betterbird: there is no layer anywhere; only the prefs default holds. accounts is the one key betterbird-tools writes through mesh-controller.settings. prefs reaches user.js through ${setting:prefs}, so it is not stray, and it no longer merges into the accounts file. That is the issue-168 bug this fixes.
Composed effect
I composed the facts snapshot of 16:04Z with this head merged into catalogue main 23ea0f4 (it merges cleanly) under #272's controller. All 4 machines compose. Against catalogue main, the one difference in every declaration is that searxng's settings.yml no longer carries the mesh's endpoints block. keycloak's config and betterbird's accounts file are unchanged. The field is not in any declaration.
Statuses at this head
mesh/repo-check success. mesh/merge-gate failure: 3 problems, and every one is the expected takes-settings refusal by the old controller, on the 3 resources this change names (betterbird.accounts, keycloak.runtime-config, searxng.settings). The node-engine says "a file does not use takes-settings, and it is set". I reproduced exactly these 3 with controller main, and 0 problems with #272's head. mesh/delivery rejected, because the gate failed. Nothing else is red.
Verdict: approve at 2f55adc57c602b8d993039fe6535f1c6d7aeb5f9
Independent review for hq issue 168 and ADR 0326. This approval holds for the change itself. It may merge only after mesh-controller #272 is merged and its rollout is done (mesh-controller.plans says done); then re-run the gate at this head or a rebase of it.
4. Keys against the stored layers (mesh-controller.settings, mesh-wide and per node)
- searxng: there is no mesh-wide layer. ace's layer sets endpoints, search and server. search and server are named. endpoints is a mesh word that the mesh reads itself, so it is not stray. general, brand, ui, outgoing, engines, plugins, categories_as_tabs and preferences are real top-level sections of searxng's settings.yml. valkey and use_default_settings stay the file's own.
- keycloak: there is no mesh-wide layer. novox sets only issuer, and issuer is named. Leaving password out is right. A setting is stored in plain text and is not a secret. keycloak-provider reads its password from MESH_KEYCLOAK_PASSWORD_FILE (${dir:state}/admin.secret), which the manifest sets, and config.json's password is only a fallback that nothing sets.
- betterbird: there is no layer anywhere; only the prefs default holds. accounts is the one key betterbird-tools writes through mesh-controller.settings. prefs reaches user.js through ${setting:prefs}, so it is not stray, and it no longer merges into the accounts file. That is the issue-168 bug this fixes.
Composed effect
I composed the facts snapshot of 16:04Z with this head merged into catalogue main 23ea0f4 (it merges cleanly) under #272's controller. All 4 machines compose. Against catalogue main, the one difference in every declaration is that searxng's settings.yml no longer carries the mesh's endpoints block. keycloak's config and betterbird's accounts file are unchanged. The field is not in any declaration.
6. Statuses at this head
mesh/repo-check success. mesh/merge-gate failure: 3 problems, and every one is the expected takes-settings refusal by the old controller, on the 3 resources this change names (betterbird.accounts, keycloak.runtime-config, searxng.settings). The node-engine says "a file does not use takes-settings, and it is set". I reproduced exactly these 3 with controller main, and 0 problems with #272's head. mesh/delivery rejected, because the gate failed. Nothing else is red.
Merge check at 2f55adc5
Judged: head 2f55adc57c60 merged into trunk 43a9155d5afe; read beside it: mesh-controller 21ac8fd8586d, mesh-controller-main 21ac8fd8586d, mesh-host 8e95c1d9ed2d, mesh-tools 954e1a53eef9
mesh/merge-gate: PASS — every machine composes with the change as it did without (4 of 4 compose) (modules: betterbird, keycloak, searxng)
mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
Delivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
tier 0: betterbird, keycloak, searxng
ace: receives searxng
g14: waits for a person: betterbird
novox: waits for a person: keycloak
shanks: waits for a person: betterbird
betterbird waits for a person: its policy records (person)
keycloak waits for a person: its policy records (module)
keycloak provides oidc-client: its consumers are sent again after it
keycloak keeps data (ADR 0233): what it holds is backed up before it moves
searxng keeps data (ADR 0233): what it holds is backed up before it moves
grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
Run by the build seat on ace as build-1791843733044631620 (builds --log build-1791843733044631620).
--- the gate: betterbird, keycloak, searxng
betterbird: ok, 10 tool(s), invokes seat:mesh-controller.settings
keycloak: ok; WARNING: server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
searxng: ok, keeps valkey (cache); WARNING: settings ask(s) for a setting and do(es) not say whether it is trusted, so it counts as trusted: set at the terminal alone; say "trusted" false where nothing trusts it (novox/hq issue 339); WARNING: cache, server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
long-running resources without health: 3
files asking for a setting without saying whether it is trusted: 1
3 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 3 module(s) changed against 4 machine(s), as the snapshot of 2026-10-12T22:18:48Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose)
judged by controller development build against the facts of 2026-10-12T22:18:48Z
modules the change moves:
- betterbird (changed)
- keycloak (changed)
- searxng (changed)
machines:
- a machine (f35): composes
- holds mesh-dns-resolver (idt): composes
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes
- a machine (yvbpsm): composes
a merge would rebuild 3 module(s) in 1 tier(s): betterbird, keycloak, searxng
--- its merge-check.sh (go toolchain)
ok git.novox.be/novox/mesh-catalog/checks/words 0.003s
words: 12 retired words and 70 daemons' lines, none in the 45130 strings of 705 files
ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.012s
agent-home: no archive and no file written into under the agent's home
ok git.novox.be/novox/mesh-catalog/checks/paths 0.005s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 67, as kept
ok git.novox.be/novox/mesh-catalog/checks/deps 0.224s
testing modules/betterbird
ok betterbird/cmd/betterbird-tools 1.682s
testing modules/keycloak
ok keycloak/cmd/keycloak-provider 1.323s
modules/searxng is TypeScript: merge-check-typescript.sh type-checks and tests it
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/searxng (TypeScript)
NOT TESTED: modules/searxng is TypeScript and has no tests of its own
**Merge check** at `2f55adc5`
Judged: head `2f55adc57c60` merged into trunk `43a9155d5afe`; read beside it: mesh-controller `21ac8fd8586d`, mesh-controller-main `21ac8fd8586d`, mesh-host `8e95c1d9ed2d`, mesh-tools `954e1a53eef9`
- `mesh/merge-gate`: **PASS** — every machine composes with the change as it did without (4 of 4 compose) (modules: betterbird, keycloak, searxng)
- `mesh/repo-check`: **PASS** — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)
**Delivery plan** — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
- tier 0: betterbird, keycloak, searxng
- ace: receives searxng
- g14: waits for a person: betterbird
- novox: waits for a person: keycloak
- shanks: waits for a person: betterbird
- betterbird waits for a person: its policy records (person)
- keycloak waits for a person: its policy records (module)
- keycloak provides oidc-client: its consumers are sent again after it
- keycloak keeps data (ADR 0233): what it holds is backed up before it moves
- searxng keeps data (ADR 0233): what it holds is backed up before it moves
- grants step: if this changes what the bus's user list says (a new tool, subject or user), novox is sent that list alone, every build there kept, before searxng is judged on its first machine
Run by the build seat on ace as `build-1791843733044631620` (`builds --log build-1791843733044631620`).
```
--- the gate: betterbird, keycloak, searxng
betterbird: ok, 10 tool(s), invokes seat:mesh-controller.settings
keycloak: ok; WARNING: server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
searxng: ok, keeps valkey (cache); WARNING: settings ask(s) for a setting and do(es) not say whether it is trusted, so it counts as trusted: set at the terminal alone; say "trusted" false where nothing trusts it (novox/hq issue 339); WARNING: cache, server stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
long-running resources without health: 3
files asking for a setting without saying whether it is trusted: 1
3 manifest(s) checked. Judged against the seats this binary carries; a claim on one of the mesh's own seats is judged fully at registration, and a seat declared by a module not given here reads as unknown. Identities judged on a 6-character machine name, against the bounds of the providers given here
judging 3 module(s) changed against 4 machine(s), as the snapshot of 2026-10-12T22:18:48Z says they run
composing every machine as the mesh is
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
composing every machine with the change
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
the bus's user list leaves out 5 user(s) the mesh has minted no credential for: controller, node.f35, node.idt, node.ygcyr, node.yvbpsm. Each is a user that cannot connect until one is issued
merge gate: PASS — every machine composes with the change as it did without (4 of 4 compose)
judged by controller development build against the facts of 2026-10-12T22:18:48Z
modules the change moves:
- betterbird (changed)
- keycloak (changed)
- searxng (changed)
machines:
- a machine (f35): composes
- holds mesh-dns-resolver (idt): composes
- holds git, holds mesh-artifact-store, holds mesh-broker, holds mesh-catalog, holds mesh-delivery, holds mesh-dns-resolver, holds mesh-store, holds mesh-vault, holds npm-package-registry, the control node, the hub (ygcyr): composes
- a machine (yvbpsm): composes
a merge would rebuild 3 module(s) in 1 tier(s): betterbird, keycloak, searxng
--- its merge-check.sh (go toolchain)
ok git.novox.be/novox/mesh-catalog/checks/words 0.003s
words: 12 retired words and 70 daemons' lines, none in the 45130 strings of 705 files
ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.012s
agent-home: no archive and no file written into under the agent's home
ok git.novox.be/novox/mesh-catalog/checks/paths 0.005s
paths: no module names another's state on its machine (3 known, listed to go)
long-running resources without health: 67, as kept
ok git.novox.be/novox/mesh-catalog/checks/deps 0.224s
testing modules/betterbird
ok betterbird/cmd/betterbird-tools 1.682s
testing modules/keycloak
ok keycloak/cmd/keycloak-provider 1.323s
modules/searxng is TypeScript: merge-check-typescript.sh type-checks and tests it
--- its merge-check-typescript.sh (typescript toolchain)
type-checking modules/searxng (TypeScript)
NOT TESTED: modules/searxng is TypeScript and has no tests of its own
```
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
What
Each mergeable file names the top-level setting keys it takes, in
takes-settings(hq ADR 0326):settings:general,brand,search,server,ui,outgoing,engines,plugins,categories_as_tabs,preferences(the sections of searxng'ssettings.ymla person tunes). Its ownvalkeyanduse_default_settingsare left out. The layer stored for ace (endpoints,search,server) still composes:endpointsis the mesh's own word and no longer lands in the file.runtime-config:url,user,realm,issuer, the keyskeycloak-providerreads.passwordis left out on purpose, because the admin password reaches the tools as a file (ADR 0086). No layer is set for keycloak today.accounts:accounts. betterbird declares the preferenceprefs, so ADR 0326 §3 requires its mergeable file to name its keys. No layer is set today.Why
hq issue 168: every setting reached every mergeable file of its module.
How it was tested
MESH_GATE=<mesh-controller #272 built> MESH_CHECK_MODULES="searxng keycloak betterbird" sh merge-check.shpasses: the module check over every manifest, words, agent home, paths, and keycloak's and betterbird's Go tests. The controller of #272 refuses betterbird's definition on main for lackingtakes-settings.Order: do not merge before mesh-controller #272 has walked
The controller the mesh runs today hands
takes-settingsto the node-engine, which parses resources strictly. Expectmesh/merge-gateto be red until #272 is live, then re-run it.Fixes issue 168.
Delivery
novox/mesh-catalog@2f55adc57c60— delivered since 2026-10-12T22:40:22ZDelivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
Machines
Transitions
43a9155d5a(it was rejected against trunk )The commit's note under
refs/notes/mesh-plankeeps every transition:git log --notes=mesh-plan.Merge check at
2f55adc5mesh/merge-gate: FAIL — 3 problem(s) the change brings; the first: a machine (yvbpsm): nothing could be sent to it with this change — resource "betterbird.accounts": a file does not use "takes-settings", and it is set. Refused rather than ignored (modules: betterbird, keycloak, searxng)mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)Delivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 2 wait(s) for a person
Run by the build seat on shanks as
build-1791820078359988636(builds --log build-1791820078359988636).Verdict: approve at
2f55adc57cIndependent review for hq issue 168 and ADR 0326. This approval holds for the change itself. It may merge only after mesh-controller #272 is merged and its rollout is done (mesh-controller.plans says done); then re-run the gate at this head or a rebase of it.
Composed effect
I composed the facts snapshot of 16:04Z with this head merged into catalogue main
23ea0f4(it merges cleanly) under #272's controller. All 4 machines compose. Against catalogue main, the one difference in every declaration is that searxng's settings.yml no longer carries the mesh's endpoints block. keycloak's config and betterbird's accounts file are unchanged. The field is not in any declaration.mesh/repo-check success. mesh/merge-gate failure: 3 problems, and every one is the expected takes-settings refusal by the old controller, on the 3 resources this change names (betterbird.accounts, keycloak.runtime-config, searxng.settings). The node-engine says "a file does not use takes-settings, and it is set". I reproduced exactly these 3 with controller main, and 0 problems with #272's head. mesh/delivery rejected, because the gate failed. Nothing else is red.
Merge check at
2f55adc5Judged: head
2f55adc57c60merged into trunk43a9155d5afe; read beside it: mesh-controller21ac8fd8586d, mesh-controller-main21ac8fd8586d, mesh-host8e95c1d9ed2d, mesh-tools954e1a53eef9mesh/merge-gate: PASS — every machine composes with the change as it did without (4 of 4 compose) (modules: betterbird, keycloak, searxng)mesh/repo-check: PASS — its merge-check.sh passed, each part in its toolchain: merge-check.sh (go), merge-check-typescript.sh (typescript)Delivery plan — builds betterbird, keycloak, searxng → ace; no bus step; 3 wait(s) for a person
Run by the build seat on ace as
build-1791843733044631620(builds --log build-1791843733044631620).