mesh-reads: a node's files and accounts read as an account that holds no secret (hq ADR 0310, issue 418) #244

Closed
mesh-admin wants to merge 2 commits from fix/418-node-reads into main
Contributor

What. A new module, modules/mesh-reads, which holds node-reads (mesh-controller #257) and serves its six verbs as a Go bundle:

  • stat: each component of one or more paths (at most 200), from / down. For each: type, owner and group (name and number), octal mode with the setuid, setgid and sticky bits, the ls permissions, a link's target, and whether it is a mount point, with its file system and source (from /proc/self/mountinfo). A link is not followed unless follow is "true". A component the account cannot reach stops the walk and says why.
  • readlink: the target as written, where the path leads, and whether that exists.
  • list: the entries of one directory with type, owner, group, mode, size and link. At most 2000 entries; a longer list is cut and says so.
  • read: text only. 64 KiB by default, 256 KiB at most, cut at a line and said so. from and lines choose lines; a negative from reads from the end. The file is opened non-blocking and judged by what was opened, so a fifo answers rather than waits. A binary file, a directory or a device is refused.
  • search: a fixed string, never a pattern. By default 100 matches, 4 directories deep; at most 500 and 8 when asked. Also bounded at 5000 files, 4 MiB per file and 20 s. Links are not followed and binary files are skipped. The answer says which bound it met.
  • account: an account by name or number, with its group and every group it is in; a group with its members; or, with neither, every account and group. Read from /etc/passwd and /etc/group. Never a password field.

How it is bounded (ADR 0310 §3–§5).

  • The account. runs-as: mesh-reads is an account the module makes: /usr/bin/nologin, home /var/lib/mesh-reads, no groups. The tool runner serves it in a runtime of its own (ADR 0259 §8), never as the operator's account or the agent's account (ADR 0266, refused by the controller). The node's file modes are the first bound. It refuses every read if it finds itself running as root.
  • Refused by name before any read, for list, read and search:
    • the controller's MESH_SECRET_PLACES for its node. Without that list it does not start.
    • the known credential files of a machine (refuse.go): .ssh, .gnupg, .aws, .kube, the agent's .credentials.json, .netrc, .pgpass, .git-credentials, id_*, *.key, ssh_host_*_key, /etc/shadow, /etc/ssl/private, /etc/wireguard, the network manager's connections.
    • A link is judged by where it leads too. A search skips such a place and names it.
    • stat and readlink still say its owner and mode and mark it secret-place, because they read no content.
  • The content rule. Each line of a read, each matching line, each link target, each mount source and each account's words pass mesh-sdk's outward.CheckSecret (mesh-sdk #23). A line shaped like a secret is withheld and its number said.
  • No answer over 1 MiB, checked once more on the marshalled answer.

Tests (go test -race):

  • TestEveryReadIsRefusedAsRoot
  • TestItDoesNotStartWithoutTheNodesSecretPlaces
  • TestSecretPlacesAreRefusedByNameBeforeAnyRead: vault, own-secret directory, the agent's credentials, .ssh, .pgpass, an ssh host key, /etc/shadow and *.key, each readable by mode and each refused. A link to the module's broker, a listed vault directory and a search that skips them. A public key and a certificate are not refused.
  • TestAFileTheAccountMayNotReadIsRefusedByItsMode: a file of mode 0000, and a path through a directory the account cannot search. Skipped as root.
  • TestAReadIsBounded: the default cut, more than the maximum refused, lines 10–11, the last two lines, a line past the end.
  • TestOnlyATextFileIsRead: binary, directory, and a fifo answered within 5 s.
  • TestALineShapedLikeASecretIsWithheld: in a read and in a search.
  • TestASearchIsBounded: matches, the maximum matches and depth, depth 3 against a file 5 deep, case, the time bound, and a pattern's characters taken literally.
  • TestStatSaysEachComponent: owner, setgid mode, a link not followed and then followed, an NFS mount point, a missing path, a relative path, 201 paths.
  • TestReadlinkSaysTheTargetAndWhereItLeads, TestListSaysEveryEntry (including the 2000 cut), TestAccountAndGroupLookup, TestNoAnswerIsLargerThanTheBound, TestItServesTheSeatsVerbs.
  • TestTheAccountHoldsNoSecretsGroupAndNoLogin, on the manifest.

By hand, over MCP on stdio with the built binary on g14:

  • /proc/loadavg was read.
  • /var/lib/mesh/bundles was walked from / with its owners and modes.
  • ~/.claude/.credentials.json was refused by name.
  • account jochen gave his ten groups.

MESH_GATE=<controller built from mesh-controller #257> MESH_CHECK_MODULES=mesh-reads sh merge-check.sh passes: words, agent-home, paths, every manifest (69 without health, as kept), deps, and the module's tests.

Order. mesh-sdk #23, then mesh-controller #257, which must be live, then this. Until #257 runs, mesh/merge-gate here reads the claim with a controller that has no node-reads and refuses it. After merge: assign mesh-reads to novox first. The survey of issue 358's 123 directories needs it there. Then ace, shanks and g14.

Limits I chose.

  • Paths and entry names are not passed through the content rule. The rule's random-run test takes a temporary directory's or a container layer's name for a token, which would withhold the survey this was built for. A place by name is refused instead.
  • Accounts come from /etc/passwd and /etc/group only, and the answer says so. A directory service or systemd's dynamic accounts are not covered.
  • The bounds are the ones above, stated in each verb's description.
  • The second commit removes a binary that a local build had committed in the first. It remains in the branch's history unless the merge squashes it.

Not here. Moving messenger onto the SDK's rule (it would cut into #178), the gate check that every node holds node-reads, and the approval mark on execute. Each follows under issue 418.

Part of issue 418. Not merged.

**What.** A new module, `modules/mesh-reads`, which holds `node-reads` (mesh-controller #257) and serves its six verbs as a Go bundle: - `stat`: each component of one or more paths (at most 200), from / down. For each: type, owner and group (name and number), octal mode with the setuid, setgid and sticky bits, the ls permissions, a link's target, and whether it is a mount point, with its file system and source (from `/proc/self/mountinfo`). A link is not followed unless `follow` is "true". A component the account cannot reach stops the walk and says why. - `readlink`: the target as written, where the path leads, and whether that exists. - `list`: the entries of one directory with type, owner, group, mode, size and link. At most 2000 entries; a longer list is cut and says so. - `read`: text only. 64 KiB by default, 256 KiB at most, cut at a line and said so. `from` and `lines` choose lines; a negative `from` reads from the end. The file is opened non-blocking and judged by what was opened, so a fifo answers rather than waits. A binary file, a directory or a device is refused. - `search`: a fixed string, never a pattern. By default 100 matches, 4 directories deep; at most 500 and 8 when asked. Also bounded at 5000 files, 4 MiB per file and 20 s. Links are not followed and binary files are skipped. The answer says which bound it met. - `account`: an account by name or number, with its group and every group it is in; a group with its members; or, with neither, every account and group. Read from `/etc/passwd` and `/etc/group`. Never a password field. **How it is bounded (ADR 0310 §3–§5).** - **The account.** `runs-as: mesh-reads` is an account the module makes: `/usr/bin/nologin`, home `/var/lib/mesh-reads`, no groups. The tool runner serves it in a runtime of its own (ADR 0259 §8), never as the operator's account or the agent's account (ADR 0266, refused by the controller). The node's file modes are the first bound. It refuses every read if it finds itself running as root. - **Refused by name** before any read, for `list`, `read` and `search`: - the controller's `MESH_SECRET_PLACES` for its node. Without that list it does not start. - the known credential files of a machine (`refuse.go`): `.ssh`, `.gnupg`, `.aws`, `.kube`, the agent's `.credentials.json`, `.netrc`, `.pgpass`, `.git-credentials`, `id_*`, `*.key`, `ssh_host_*_key`, `/etc/shadow`, `/etc/ssl/private`, `/etc/wireguard`, the network manager's connections. - A link is judged by where it leads too. A search skips such a place and names it. - `stat` and `readlink` still say its owner and mode and mark it `secret-place`, because they read no content. - **The content rule.** Each line of a read, each matching line, each link target, each mount source and each account's words pass mesh-sdk's `outward.CheckSecret` (mesh-sdk #23). A line shaped like a secret is withheld and its number said. - **No answer over 1 MiB**, checked once more on the marshalled answer. **Tests** (`go test -race`): - `TestEveryReadIsRefusedAsRoot` - `TestItDoesNotStartWithoutTheNodesSecretPlaces` - `TestSecretPlacesAreRefusedByNameBeforeAnyRead`: vault, own-secret directory, the agent's credentials, `.ssh`, `.pgpass`, an ssh host key, `/etc/shadow` and `*.key`, each readable by mode and each refused. A link to the module's broker, a listed vault directory and a search that skips them. A public key and a certificate are not refused. - `TestAFileTheAccountMayNotReadIsRefusedByItsMode`: a file of mode 0000, and a path through a directory the account cannot search. Skipped as root. - `TestAReadIsBounded`: the default cut, more than the maximum refused, lines 10–11, the last two lines, a line past the end. - `TestOnlyATextFileIsRead`: binary, directory, and a fifo answered within 5 s. - `TestALineShapedLikeASecretIsWithheld`: in a read and in a search. - `TestASearchIsBounded`: matches, the maximum matches and depth, depth 3 against a file 5 deep, case, the time bound, and a pattern's characters taken literally. - `TestStatSaysEachComponent`: owner, setgid mode, a link not followed and then followed, an NFS mount point, a missing path, a relative path, 201 paths. - `TestReadlinkSaysTheTargetAndWhereItLeads`, `TestListSaysEveryEntry` (including the 2000 cut), `TestAccountAndGroupLookup`, `TestNoAnswerIsLargerThanTheBound`, `TestItServesTheSeatsVerbs`. - `TestTheAccountHoldsNoSecretsGroupAndNoLogin`, on the manifest. By hand, over MCP on stdio with the built binary on g14: - `/proc/loadavg` was read. - `/var/lib/mesh/bundles` was walked from / with its owners and modes. - `~/.claude/.credentials.json` was refused by name. - `account jochen` gave his ten groups. `MESH_GATE=<controller built from mesh-controller #257> MESH_CHECK_MODULES=mesh-reads sh merge-check.sh` passes: words, agent-home, paths, every manifest (69 without health, as kept), deps, and the module's tests. **Order.** mesh-sdk #23, then mesh-controller #257, which must be live, then this. Until #257 runs, `mesh/merge-gate` here reads the claim with a controller that has no `node-reads` and refuses it. After merge: assign `mesh-reads` to novox first. The survey of issue 358's 123 directories needs it there. Then ace, shanks and g14. **Limits I chose.** - Paths and entry names are not passed through the content rule. The rule's random-run test takes a temporary directory's or a container layer's name for a token, which would withhold the survey this was built for. A place by name is refused instead. - Accounts come from `/etc/passwd` and `/etc/group` only, and the answer says so. A directory service or systemd's dynamic accounts are not covered. - The bounds are the ones above, stated in each verb's description. - The second commit removes a binary that a local build had committed in the first. It remains in the branch's history unless the merge squashes it. **Not here.** Moving messenger onto the SDK's rule (it would cut into #178), the gate check that every node holds `node-reads`, and the approval mark on `execute`. Each follows under issue 418. Part of issue 418. Not merged.
mesh-admin added 2 commits 2026-10-12 12:05:37 +00:00
Reading a file, searching one, listing a directory, the owner and mode of each
component of a path and looking up an account went through the login shell's
execute as the operator's account, which sees the operator's keys and the
agent's credentials, and execute is not served on the control-node. This module
holds node-reads on every node, runs as mesh-reads (no login, no group beside
its own), refuses the node's secret places by name before any read (the
controller's list and the known credential files), withholds any line shaped
like a secret through mesh-sdk's outward rule, and bounds every answer.
mesh-reads: drop the binary a local build left in the tree (issue 418)
mesh/merge-gate fail: builds new: modules/mesh-reads, sent nowhere; no bus step; a manifest the change touches fails the module check: modules/mesh-reads/m…
mesh/repo-check fail: its merge-check.sh failed: files asking for a setting without saying whether it is trusted: 25
mesh/delivery-group group fix/418-node-reads rejected: a member's own check failed
mesh/delivery stopped: the pull request closed unmerged
05c0396f6b
Author
Contributor

Delivery novox/mesh-catalog@05c0396f6be0 — stopped since 2026-10-12T12:33:00Z

Delivery plan — builds new: modules/mesh-reads, sent nowhere; no bus step

Group fix/418-node-reads, in order: novox/mesh-controller@63a99d4323 → novox/mesh-sdk@67bfa22132

Transitions

  • 2026-10-12 12:05 (new) → proposed (announced): novox/mesh-catalog#244's head announced
  • 2026-10-12 12:07 proposed → checked (checked): the verdict names this commit
  • 2026-10-12 12:07 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed
  • 2026-10-12 12:33 rejected → stopped (closed): the pull request closed unmerged

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

<!-- mesh-delivery:view --> **Delivery** `novox/mesh-catalog@05c0396f6be0` — **stopped** since 2026-10-12T12:33:00Z **Delivery plan** — builds new: modules/mesh-reads, sent nowhere; no bus step **Group** `fix/418-node-reads`, in order: novox/mesh-controller@63a99d43237f → novox/mesh-sdk@67bfa22132f2 - novox/mesh-controller@63a99d43237f before novox/mesh-sdk@67bfa22132f2: built by **Transitions** - 2026-10-12 12:05 (new) → proposed (announced): novox/mesh-catalog#244's head announced - 2026-10-12 12:07 proposed → checked (checked): the verdict names this commit - 2026-10-12 12:07 checked → rejected (refused): the gate failed or could not run, or the repository's own check failed - 2026-10-12 12:33 rejected → stopped (closed): the pull request closed unmerged The commit's note under `refs/notes/mesh-plan` keeps every transition: `git log --notes=mesh-plan`.
Author
Contributor

Merge check at 05c0396f

  • mesh/merge-gate: FAIL — a manifest the change touches fails the module check: modules/mesh-reads/module.json: this manifest cannot be used: (modules: new:modules/mesh-reads)
  • mesh/repo-check: FAIL — its merge-check.sh failed: files asking for a setting without saying whether it is trusted: 25

Delivery plan — builds new: modules/mesh-reads, sent nowhere; no bus step

Run by the build seat on g14 as build-1791806740426423506 (builds --log build-1791806740426423506).

--- the gate: new:modules/mesh-reads
mesh-controller: 1 problem(s) in 1 manifest(s)
modules/mesh-reads/module.json: this manifest cannot be used:
  - mesh-reads claims "node-reads", which is a seat in the mesh's own namespace (mesh-*/node-*) that it does not define (novox/hq ADR 0121) — the seats are: git, mesh-artifact-store, mesh-broker, mesh-build-machine, mesh-catalog, mesh-controller, mesh-delivery, mesh-dns-resolver, mesh-store, mesh-vault, node-backup, node-bar, node-build-agent, node-clipboard, node-compositor, node-container-runtime, node-display-server, node-display-session, node-environment, node-hostname, node-hotkeys, node-intrusion-prevention, node-launcher, node-lock-screen, node-login-manager, node-login-shell, node-message-bus, node-mounts, node-nfs-server, node-notifier, node-package-manager, node-packet-filter, node-power, node-resolver, node-secret-service, node-service-manager, node-terminal-emulator, node-uplink, npm-package-registry, the-private-network
long-running resources without health: 0
files asking for a setting without saying whether it is trusted: 0
--- the same manifests on main
--- its merge-check.sh (go toolchain)
ok  	git.novox.be/novox/mesh-catalog/checks/words	0.004s
words: 12 retired words and 70 daemons' lines, none in the 43533 strings of 694 files
ok  	git.novox.be/novox/mesh-catalog/checks/agenthome	0.010s
agent-home: no archive and no file written into under the agent's home
ok  	git.novox.be/novox/mesh-catalog/checks/paths	0.004s
paths: no module names another's state on its machine (3 known, listed to go)
mesh-controller: 1 problem(s) in 127 manifest(s)
modules/mesh-reads/module.json: this manifest cannot be used:
  - mesh-reads claims "node-reads", which is a seat in the mesh's own namespace (mesh-*/node-*) that it does not define (novox/hq ADR 0121) — the seats are: git, mesh-artifact-store, mesh-broker, mesh-build-machine, mesh-catalog, mesh-controller, mesh-delivery, mesh-dns-resolver, mesh-store, mesh-vault, node-backup, node-bar, node-build-agent, node-clipboard, node-compositor, node-container-runtime, node-display-server, node-display-session, node-environment, node-hostname, node-hotkeys, node-intrusion-prevention, node-launcher, node-lock-screen, node-login-manager, node-login-shell, node-message-bus, node-mounts, node-nfs-server, node-notifier, node-package-manager, node-packet-filter, node-power, node-resolver, node-secret-service, node-service-manager, node-terminal-emulator, node-uplink, npm-package-registry, the-private-network
adwaita: ok, 4 tool(s)
artifact-store-tools: ok, 4 tool(s), invokes seat:mesh-controller.artifacts, seat:mesh-controller.collect
asus-zephyrus-g14: ok, 11 tool(s); WARNING: asusd, supergfxd, upower stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
audit-logger: ok, keeps trail (valuable), spool (valuable)
avahi: ok, 4 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
baserow: ok, keeps data (valuable), ready: server by its image's own check every 30s; WARNING: runtime-config 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)
betterbird: ok, 7 tool(s); WARNING: user-js 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)
blueman: ok, 3 tool(s)
bluetooth: ok, 9 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
build-agent: ok, keeps workspace (cache); 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)
ca-trust: ok; WARNING: trust stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
claude-code: ok, 45 tool(s), keeps state servers, holdings, config, proposals, reads claude-licence-manager.bindings, keeps agent-home (valuable); 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)
claude-licence-manager: ok, keeps state bindings, reads claude-code.holdings; 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)
clipmenu: ok, 3 tool(s)
confluence: ok
cups: ok, 7 tool(s); WARNING: socket, scheduler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
dbus: ok, 5 tool(s); WARNING: system-bus stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
de-spiegel: 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)
desk-channel: ok, 1 tool(s), invokes seat:node-notifier.send, keeps state shown; 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)
disk-load: ok, 4 tool(s)
distribution: ok, keeps registry (rebuildable); WARNING: store stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
dmenu: ok, 2 tool(s)
dnsmasq: ok, 3 tool(s), ready: service by unit every 30s; watch by its tool dnsmasq_health every 20s
docker: ok, 22 tool(s), invokes seat:mesh-controller.images; WARNING: socket, runtime, prune stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
docker-compose: ok, 9 tool(s)
dunst: ok, 6 tool(s)
fail2ban: ok, 1 tool(s); WARNING: run stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
feh: ok, 2 tool(s)
flatpak: ok, 11 tool(s)
fonts: ok, 6 tool(s)
forticlient: ok, 3 tool(s), ready: split-dns by unit every 30s; WARNING: scheduler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
gitea: ok, keeps data (valuable); 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)
gitlab: ok
gnome-keyring: ok, 4 tool(s)
grafana: ok, keeps data (valuable), ready: server by http / on web every 30s; WARNING: runtime-config 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)
hello-web: 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)
home-assistant: ok, keeps config (valuable); 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)
hostname: ok; WARNING: name 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)
i3: ok, 10 tool(s)
i3status-rust: ok, 4 tool(s)
icecast: ok, keeps logs (cache); 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)
influxdb: ok, keeps data (valuable), config (valuable); 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)
invoicing: ok; WARNING: app, api stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
jira: ok
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)
lab: ok, keeps work (cache); WARNING: runtime-env 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)
lemurs: ok, 2 tool(s); WARNING: service stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
letta: ok; WARNING: runtime-config 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: 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)
local-model-consumer: ok
localization: ok, 4 tool(s)
logrotate: ok, 7 tool(s); WARNING: timer stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
mailu: ok, keeps mail (valuable), dkim (valuable), data (valuable), dav (valuable), webmail (valuable), queue (valuable), filter (rebuildable), certs (rebuildable), automx (rebuildable), fetchmail (rebuildable), clamav (cache), redis (cache), ready: resolver by its image's own check every 30s; admin by its image's own check every 30s; imap by its image's own check every 30s; smtp by its image's own check every 30s; antispam by its image's own check every 30s; webmail by its image's own check every 30s; webdav by its image's own check every 30s; fetchmail by its image's own check every 30s; front by its image's own check every 30s; WARNING: config-env 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: redis, antivirus, automx stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
marrytts: 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)
matrix: ok, keeps db (valuable), ready: element by its image's own check every 30s; WARNING: element-conf 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: homeserver stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
memory-pressure: ok, 6 tool(s); WARNING: oomd stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
mesh-catalog: ok
mesh-cli: ok
mesh-delivery: ok, 1 tool(s), invokes seat:mesh-controller.delivery-plan, seat:mesh-controller.delivery-order, seat:mesh-controller.delivery-check, seat:mesh-controller.deliver, seat:mesh-controller.delivery-stop, seat:mesh-controller.delivery-walks, gitea.gitea_note_append, gitea.gitea_delivery_view, gitea.gitea_commit_status, gitea.gitea_commit_statuses, gitea.gitea_contains, gitea.gitea_open_pulls, keeps state deliveries, groups
mesh-issues: ok, invokes claude-code.claude_code_judge, seat:mesh-delivery.checks, seat:operator-channel.notify, records.records_status, records.records_list, records.records_read, mesh-knowledge.knowledge_highest, keeps state issues, counters, grooming, reservations, keeps log changes (1024 MiB)
mesh-knowledge: ok, 2 tool(s), invokes seat:issue-tracker.reserve, claude-code.claude_code_judge, claude-code.claude_code_judged, records.records_status, records.records_list, records.records_read, seat:operator-channel.notify, ready: keep by unit every 30s; watch by its tool knowledge_health every 1m0s
mesh-vault: ok, keeps state (valuable), ledger (valuable), root (valuable)
mesh-watcher: ok, 4 tool(s), invokes mesh-watcher.watcher_ping, seat:mesh-controller.seats; 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)
messenger: ok, 7 tool(s), invokes seat:mesh-controller.conditions, seat:mesh-controller.root-free, seat:issue-tracker.tracking, keeps state open, sent, asks, identities, walks; 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)
minio: ok, keeps data (valuable); 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)
model-usage: ok, keeps state (cache), spool (valuable)
mongodb: ok, keeps data (valuable), dumps (rebuildable), ready: server by tcp on database every 30s
mosquitto: ok, keeps data (rebuildable), ready: server by tcp on mqtt every 30s
mounts: ok, 3 tool(s), invokes seat:mesh-controller.data, keeps state shares, reads nfs-server.exports, ready: apply by unit every 30s; watch by its tool mounts_health every 1m0s; WARNING: config 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)
mssql: ok, keeps data (valuable), dumps (rebuildable); 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)
n8n: ok, keeps data (valuable), cache (cache); WARNING: server, cache-server, browser stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
nats: ok, 9 tool(s), keeps jetstream (valuable), snapshots (rebuildable); 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)
netcheck: ok, 5 tool(s)
networkmanager: ok
nextcloud: ok, keeps html (valuable); 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)
nextcloud-client: ok, 4 tool(s)
nfs-server: ok, 1 tool(s), invokes seat:mesh-controller.seats, seat:mesh-controller.data, keeps state exports, reads mounts.shares, ready: server by unit every 30s; exports by its tool nfs_health every 1m0s; WARNING: config 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)
nftables: ok, 1 tool(s); WARNING: load stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
nm-applet: ok, 3 tool(s)
node-env: ok
nodered: ok, keeps data (valuable), ready: server by its image's own check every 30s; 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)
ollama: ok, keeps models (rebuildable); 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)
only-office: ok, keeps data (rebuildable), lib (rebuildable), db (rebuildable), fonts (rebuildable), logs (cache), rabbitmq (cache), redis (cache); 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)
openai-consumer: ok
openrazer: ok, 3 tool(s)
pacman: ok, 15 tool(s); WARNING: mirror-refresh, cache-cleaning stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
photos-eef: ok; WARNING: client stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
photos-filip: ok; WARNING: client stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
picom: ok, 4 tool(s); WARNING: configuration 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)
polychromatic: ok, 3 tool(s)
postgres: ok, keeps store (valuable), dumps (rebuildable), ready: server by tcp on database every 30s
power: ok, 5 tool(s), keeps state draw, ready: draw by unit every 30s; WARNING: logind-power 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: after-boot, before-shutdown stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
powerlevel10k: ok
records: ok, 6 tool(s), keeps checkout (rebuildable)
redis: ok, keeps data (cache), ready: server by tcp on cache every 30s
restic: ok, 3 tool(s), keeps repository (rebuildable), state (cache), ready: night by its tool backup_health every 1m0s; measure by unit every 30s
rofi: ok, 3 tool(s)
route-adapter: ok; WARNING: config 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)
route-proxy: ok, keeps acme (rebuildable), ca (cache); 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)
screen-lock: ok, 3 tool(s)
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)
sensors: ok, 6 tool(s), ready: drives by unit every 30s; watch by its tool sensors_health every 1m0s
showcase: ok; WARNING: server, tools stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
slack: ok, 4 tool(s)
snapd: ok, 10 tool(s)
ssh-client: ok, 8 tool(s), keeps ssh (valuable)
sshd: ok; WARNING: run stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
step-ca: ok, keeps home (valuable), ready: server by its image's own check every 30s
sudo: ok, 4 tool(s)
supabase: ok, keeps db (valuable), dumps (rebuildable), storage (valuable), functions (valuable), db-config (rebuildable), ready: db by its image's own check every 30s; kong by its image's own check every 30s; meta by its image's own check every 30s; studio by its image's own check every 30s; 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: vector, analytics, auth, rest, realtime, imgproxy, storage-api, edge-functions, pooler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
systemd: ok
systemd-networkd: ok
systemd-resolved: ok, ready: service by unit every 30s; guard by unit every 30s
telegram: ok, 1 tool(s), keeps state offset, messages
time-sync: ok, 3 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
triggerhappy: ok, 4 tool(s); WARNING: service stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8)
umami: 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)
unifi: ok, keeps data (valuable); WARNING: runtime-config 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: 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)
website: ok, ready: server by http / on web every 30s
xclip: ok, 4 tool(s)
xdg: ok, 5 tool(s); WARNING: user-dirs 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)
xorg: ok, 9 tool(s)
xterm: ok, 2 tool(s)
zfs: ok, 15 tool(s), ready: watch by its tool zfs_health every 1m0s; events by unit every 30s; WARNING: scrub-config 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)
zsh: ok, 1 tool(s); WARNING: tools-conf 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)
zsh-autosuggestions: ok
zsh-syntax-highlighting: ok
long-running resources without health: 69
files asking for a setting without saying whether it is trusted: 25
**Merge check** at `05c0396f` - `mesh/merge-gate`: **FAIL** — a manifest the change touches fails the module check: modules/mesh-reads/module.json: this manifest cannot be used: (modules: new:modules/mesh-reads) - `mesh/repo-check`: **FAIL** — its merge-check.sh failed: files asking for a setting without saying whether it is trusted: 25 **Delivery plan** — builds new: modules/mesh-reads, sent nowhere; no bus step Run by the build seat on g14 as `build-1791806740426423506` (`builds --log build-1791806740426423506`). ``` --- the gate: new:modules/mesh-reads mesh-controller: 1 problem(s) in 1 manifest(s) modules/mesh-reads/module.json: this manifest cannot be used: - mesh-reads claims "node-reads", which is a seat in the mesh's own namespace (mesh-*/node-*) that it does not define (novox/hq ADR 0121) — the seats are: git, mesh-artifact-store, mesh-broker, mesh-build-machine, mesh-catalog, mesh-controller, mesh-delivery, mesh-dns-resolver, mesh-store, mesh-vault, node-backup, node-bar, node-build-agent, node-clipboard, node-compositor, node-container-runtime, node-display-server, node-display-session, node-environment, node-hostname, node-hotkeys, node-intrusion-prevention, node-launcher, node-lock-screen, node-login-manager, node-login-shell, node-message-bus, node-mounts, node-nfs-server, node-notifier, node-package-manager, node-packet-filter, node-power, node-resolver, node-secret-service, node-service-manager, node-terminal-emulator, node-uplink, npm-package-registry, the-private-network long-running resources without health: 0 files asking for a setting without saying whether it is trusted: 0 --- the same manifests on main --- its merge-check.sh (go toolchain) ok git.novox.be/novox/mesh-catalog/checks/words 0.004s words: 12 retired words and 70 daemons' lines, none in the 43533 strings of 694 files ok git.novox.be/novox/mesh-catalog/checks/agenthome 0.010s agent-home: no archive and no file written into under the agent's home ok git.novox.be/novox/mesh-catalog/checks/paths 0.004s paths: no module names another's state on its machine (3 known, listed to go) mesh-controller: 1 problem(s) in 127 manifest(s) modules/mesh-reads/module.json: this manifest cannot be used: - mesh-reads claims "node-reads", which is a seat in the mesh's own namespace (mesh-*/node-*) that it does not define (novox/hq ADR 0121) — the seats are: git, mesh-artifact-store, mesh-broker, mesh-build-machine, mesh-catalog, mesh-controller, mesh-delivery, mesh-dns-resolver, mesh-store, mesh-vault, node-backup, node-bar, node-build-agent, node-clipboard, node-compositor, node-container-runtime, node-display-server, node-display-session, node-environment, node-hostname, node-hotkeys, node-intrusion-prevention, node-launcher, node-lock-screen, node-login-manager, node-login-shell, node-message-bus, node-mounts, node-nfs-server, node-notifier, node-package-manager, node-packet-filter, node-power, node-resolver, node-secret-service, node-service-manager, node-terminal-emulator, node-uplink, npm-package-registry, the-private-network adwaita: ok, 4 tool(s) artifact-store-tools: ok, 4 tool(s), invokes seat:mesh-controller.artifacts, seat:mesh-controller.collect asus-zephyrus-g14: ok, 11 tool(s); WARNING: asusd, supergfxd, upower stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) audit-logger: ok, keeps trail (valuable), spool (valuable) avahi: ok, 4 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) baserow: ok, keeps data (valuable), ready: server by its image's own check every 30s; WARNING: runtime-config 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) betterbird: ok, 7 tool(s); WARNING: user-js 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) blueman: ok, 3 tool(s) bluetooth: ok, 9 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) build-agent: ok, keeps workspace (cache); 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) ca-trust: ok; WARNING: trust stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) claude-code: ok, 45 tool(s), keeps state servers, holdings, config, proposals, reads claude-licence-manager.bindings, keeps agent-home (valuable); 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) claude-licence-manager: ok, keeps state bindings, reads claude-code.holdings; 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) clipmenu: ok, 3 tool(s) confluence: ok cups: ok, 7 tool(s); WARNING: socket, scheduler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) dbus: ok, 5 tool(s); WARNING: system-bus stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) de-spiegel: 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) desk-channel: ok, 1 tool(s), invokes seat:node-notifier.send, keeps state shown; 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) disk-load: ok, 4 tool(s) distribution: ok, keeps registry (rebuildable); WARNING: store stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) dmenu: ok, 2 tool(s) dnsmasq: ok, 3 tool(s), ready: service by unit every 30s; watch by its tool dnsmasq_health every 20s docker: ok, 22 tool(s), invokes seat:mesh-controller.images; WARNING: socket, runtime, prune stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) docker-compose: ok, 9 tool(s) dunst: ok, 6 tool(s) fail2ban: ok, 1 tool(s); WARNING: run stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) feh: ok, 2 tool(s) flatpak: ok, 11 tool(s) fonts: ok, 6 tool(s) forticlient: ok, 3 tool(s), ready: split-dns by unit every 30s; WARNING: scheduler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) gitea: ok, keeps data (valuable); 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) gitlab: ok gnome-keyring: ok, 4 tool(s) grafana: ok, keeps data (valuable), ready: server by http / on web every 30s; WARNING: runtime-config 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) hello-web: 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) home-assistant: ok, keeps config (valuable); 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) hostname: ok; WARNING: name 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) i3: ok, 10 tool(s) i3status-rust: ok, 4 tool(s) icecast: ok, keeps logs (cache); 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) influxdb: ok, keeps data (valuable), config (valuable); 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) invoicing: ok; WARNING: app, api stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) jira: ok 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) lab: ok, keeps work (cache); WARNING: runtime-env 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) lemurs: ok, 2 tool(s); WARNING: service stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) letta: ok; WARNING: runtime-config 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: 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) local-model-consumer: ok localization: ok, 4 tool(s) logrotate: ok, 7 tool(s); WARNING: timer stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) mailu: ok, keeps mail (valuable), dkim (valuable), data (valuable), dav (valuable), webmail (valuable), queue (valuable), filter (rebuildable), certs (rebuildable), automx (rebuildable), fetchmail (rebuildable), clamav (cache), redis (cache), ready: resolver by its image's own check every 30s; admin by its image's own check every 30s; imap by its image's own check every 30s; smtp by its image's own check every 30s; antispam by its image's own check every 30s; webmail by its image's own check every 30s; webdav by its image's own check every 30s; fetchmail by its image's own check every 30s; front by its image's own check every 30s; WARNING: config-env 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: redis, antivirus, automx stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) marrytts: 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) matrix: ok, keeps db (valuable), ready: element by its image's own check every 30s; WARNING: element-conf 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: homeserver stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) memory-pressure: ok, 6 tool(s); WARNING: oomd stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) mesh-catalog: ok mesh-cli: ok mesh-delivery: ok, 1 tool(s), invokes seat:mesh-controller.delivery-plan, seat:mesh-controller.delivery-order, seat:mesh-controller.delivery-check, seat:mesh-controller.deliver, seat:mesh-controller.delivery-stop, seat:mesh-controller.delivery-walks, gitea.gitea_note_append, gitea.gitea_delivery_view, gitea.gitea_commit_status, gitea.gitea_commit_statuses, gitea.gitea_contains, gitea.gitea_open_pulls, keeps state deliveries, groups mesh-issues: ok, invokes claude-code.claude_code_judge, seat:mesh-delivery.checks, seat:operator-channel.notify, records.records_status, records.records_list, records.records_read, mesh-knowledge.knowledge_highest, keeps state issues, counters, grooming, reservations, keeps log changes (1024 MiB) mesh-knowledge: ok, 2 tool(s), invokes seat:issue-tracker.reserve, claude-code.claude_code_judge, claude-code.claude_code_judged, records.records_status, records.records_list, records.records_read, seat:operator-channel.notify, ready: keep by unit every 30s; watch by its tool knowledge_health every 1m0s mesh-vault: ok, keeps state (valuable), ledger (valuable), root (valuable) mesh-watcher: ok, 4 tool(s), invokes mesh-watcher.watcher_ping, seat:mesh-controller.seats; 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) messenger: ok, 7 tool(s), invokes seat:mesh-controller.conditions, seat:mesh-controller.root-free, seat:issue-tracker.tracking, keeps state open, sent, asks, identities, walks; 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) minio: ok, keeps data (valuable); 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) model-usage: ok, keeps state (cache), spool (valuable) mongodb: ok, keeps data (valuable), dumps (rebuildable), ready: server by tcp on database every 30s mosquitto: ok, keeps data (rebuildable), ready: server by tcp on mqtt every 30s mounts: ok, 3 tool(s), invokes seat:mesh-controller.data, keeps state shares, reads nfs-server.exports, ready: apply by unit every 30s; watch by its tool mounts_health every 1m0s; WARNING: config 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) mssql: ok, keeps data (valuable), dumps (rebuildable); 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) n8n: ok, keeps data (valuable), cache (cache); WARNING: server, cache-server, browser stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) nats: ok, 9 tool(s), keeps jetstream (valuable), snapshots (rebuildable); 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) netcheck: ok, 5 tool(s) networkmanager: ok nextcloud: ok, keeps html (valuable); 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) nextcloud-client: ok, 4 tool(s) nfs-server: ok, 1 tool(s), invokes seat:mesh-controller.seats, seat:mesh-controller.data, keeps state exports, reads mounts.shares, ready: server by unit every 30s; exports by its tool nfs_health every 1m0s; WARNING: config 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) nftables: ok, 1 tool(s); WARNING: load stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) nm-applet: ok, 3 tool(s) node-env: ok nodered: ok, keeps data (valuable), ready: server by its image's own check every 30s; 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) ollama: ok, keeps models (rebuildable); 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) only-office: ok, keeps data (rebuildable), lib (rebuildable), db (rebuildable), fonts (rebuildable), logs (cache), rabbitmq (cache), redis (cache); 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) openai-consumer: ok openrazer: ok, 3 tool(s) pacman: ok, 15 tool(s); WARNING: mirror-refresh, cache-cleaning stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) photos-eef: ok; WARNING: client stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) photos-filip: ok; WARNING: client stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) picom: ok, 4 tool(s); WARNING: configuration 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) polychromatic: ok, 3 tool(s) postgres: ok, keeps store (valuable), dumps (rebuildable), ready: server by tcp on database every 30s power: ok, 5 tool(s), keeps state draw, ready: draw by unit every 30s; WARNING: logind-power 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: after-boot, before-shutdown stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) powerlevel10k: ok records: ok, 6 tool(s), keeps checkout (rebuildable) redis: ok, keeps data (cache), ready: server by tcp on cache every 30s restic: ok, 3 tool(s), keeps repository (rebuildable), state (cache), ready: night by its tool backup_health every 1m0s; measure by unit every 30s rofi: ok, 3 tool(s) route-adapter: ok; WARNING: config 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) route-proxy: ok, keeps acme (rebuildable), ca (cache); 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) screen-lock: ok, 3 tool(s) 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) sensors: ok, 6 tool(s), ready: drives by unit every 30s; watch by its tool sensors_health every 1m0s showcase: ok; WARNING: server, tools stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) slack: ok, 4 tool(s) snapd: ok, 10 tool(s) ssh-client: ok, 8 tool(s), keeps ssh (valuable) sshd: ok; WARNING: run stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) step-ca: ok, keeps home (valuable), ready: server by its image's own check every 30s sudo: ok, 4 tool(s) supabase: ok, keeps db (valuable), dumps (rebuildable), storage (valuable), functions (valuable), db-config (rebuildable), ready: db by its image's own check every 30s; kong by its image's own check every 30s; meta by its image's own check every 30s; studio by its image's own check every 30s; 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: vector, analytics, auth, rest, realtime, imgproxy, storage-api, edge-functions, pooler stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) systemd: ok systemd-networkd: ok systemd-resolved: ok, ready: service by unit every 30s; guard by unit every 30s telegram: ok, 1 tool(s), keeps state offset, messages time-sync: ok, 3 tool(s); WARNING: daemon stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) triggerhappy: ok, 4 tool(s); WARNING: service stay(s) up and say(s) not how it is ready — judged by liveness alone, refused from 2026-11-18 (ADR 0240 rule 8) umami: 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) unifi: ok, keeps data (valuable); WARNING: runtime-config 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: 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) website: ok, ready: server by http / on web every 30s xclip: ok, 4 tool(s) xdg: ok, 5 tool(s); WARNING: user-dirs 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) xorg: ok, 9 tool(s) xterm: ok, 2 tool(s) zfs: ok, 15 tool(s), ready: watch by its tool zfs_health every 1m0s; events by unit every 30s; WARNING: scrub-config 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) zsh: ok, 1 tool(s); WARNING: tools-conf 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) zsh-autosuggestions: ok zsh-syntax-highlighting: ok long-running resources without health: 69 files asking for a setting without saying whether it is trusted: 25 ```
mesh-admin left a comment
Author
Contributor

Verdict: request changes at 05c0396f6b

Independent review for issue 418 (ADR 0310). In modules/mesh-reads, go vet ./... is clean and go test -race -count=1 ./... passes. With a controller built from mesh-controller #257 head 4ead5a3, MESH_GATE=… MESH_CHECK_MODULES=mesh-reads sh merge-check.sh passes, so the red mesh/merge-gate and mesh/repo-check come from the running controller lacking the seat.

What holds:

  • The account is nologin, has its own home and no groups, and every read is refused as root.
  • Every verb applies the size bounds, and the marshalled answer is held to 1 MiB.
  • A fifo or a device is refused within milliseconds (O_NONBLOCK and fstat on what was opened).
  • /proc/self/environ and cmdline are refused as binary.
  • A link to a secret place is refused through EvalSymlinks, including /proc/self/fd/N that leads into one.
  • A search skips secret places, does not follow links and skips non-regular files.
  • account never answers a password field.

Required 1: the name check and the open are two lookups (TOCTOU). refusedRead judges path and EvalSymlinks(path). Then os.OpenFile(path, …) resolves the path again and follows links. I tested a link flipped in a loop between a harmless file and a file inside a secret place. Read answered the secret place's content 3744 times in 20000 calls. searchFile has the same gap: WalkDir judges the entry by its lstat type, then the open follows a link that was swapped in.

Why this matters: the name rule is the only bound for what mesh-reads may read by mode. That includes its own bus credential, /var/lib/mesh-reads/broker, which it owns. fs.protected_symlinks=1 closes this in /tmp, but not in any non-sticky directory another account can write.

Fix: judge what was opened, not the name.

  • Open with O_RDONLY|O_NONBLOCK|O_NOCTTY|O_CLOEXEC. In search, also use O_NOFOLLOW.
  • fstat the descriptor and require a regular file.
  • readlink("/proc/self/fd/<n>") and run Refused on that real path. If the path ends in (deleted) or is not absolute, refuse it.
  • Better still: Lstat before opening, so a device is never opened at all. Opening /dev/ptmx or a tape or watchdog device has side effects even when the read is then refused.
  • Add a test that flips a link in a goroutine and asserts that no answer carries the secret.

Required 2: a private key's body leaks a line. I generated an RSA-2048 PKCS#8 key into server.pem (the name is not refused). read withheld 27 of its 28 lines; one base64 line of the key passed CheckSecret. Fix: in read and in search, withhold every line from a -----BEGIN …PRIVATE KEY----- (or any BEGIN the rule refuses) through its END. Better: refuse a file that contains such a block. Add a test with a generated key.

Required 3: shell history by name. History files are where tokens are typed. Add .bash_history, .zsh_history, .histfile, .python_history, .psql_history, .mysql_history, .lesshst, .viminfo and .node_repl_history to knownNames. On g14 they are mode 0600 inside a 0700 home, but the name rule is the second bound for a node where a home is 0755.

Required 4: the stray binary. The first commit carries a 5.1 MB built mesh-reads (Go 1.27.1, not stripped). I extracted it:

  • No token or key shapes.
  • It does carry the operator's account name and checkout paths (/home/jochen/projects/novox/mesh-catalog-418/…, /home/jochen/go/pkg/mod/…).

This repository merges with merge commits, so the binary would stay in main's history for good: about 5 MB of bloat and a disclosure of local paths. It is not a secret leak. Since this PR needs another round anyway, the clean way out is a new branch from current main (for example fix/418-node-reads-2). Squash the two commits (and the fixes above) so the binary never appears, open it as a new PR, and close this one. Also add modules/*/mesh-* (or /modules/mesh-reads/mesh-reads) to .gitignore.

Should, not blocking:

  • search can hang on a hard NFS mount, because SearchTime is checked only between entries. Stay on the root's file system by default (st_dev, like grep -r with -xdev thinking), and skip /proc and /sys unless the root is inside them.
  • Add by name: /proc/*/{environ,mem,fd,map_files,root,cwd} (only the account's own processes are reachable, but /proc/self/fd/N reaches a deleted file today; I tested it), /etc/rancher, /etc/kubernetes/admin.conf, and browser profile directories (.mozilla, .config/google-chrome, .config/chromium).
  • Hard links: the name rule cannot see a hard link to a secret file elsewhere. fs.protected_hardlinks=1 limits who can make one, and the file mode still bounds the read. Say this limit in the README.
  • After mesh-sdk #23 merges, move go.mod to the SDK's merged main commit. 4dc5f29 stays reachable through the merge commit, so this is tidiness, not a break.

Merge order: mesh-sdk #23, then mesh-controller #257 and its rollout done, then the replacement for this PR, assigned to novox first.

Verdict: request changes at 05c0396f6be038b1bc032fac47bdda7291910842 Independent review for issue 418 (ADR 0310). In `modules/mesh-reads`, `go vet ./...` is clean and `go test -race -count=1 ./...` passes. With a controller built from mesh-controller #257 head 4ead5a3, `MESH_GATE=… MESH_CHECK_MODULES=mesh-reads sh merge-check.sh` passes, so the red `mesh/merge-gate` and `mesh/repo-check` come from the running controller lacking the seat. What holds: - The account is `nologin`, has its own home and no groups, and every read is refused as root. - Every verb applies the size bounds, and the marshalled answer is held to 1 MiB. - A fifo or a device is refused within milliseconds (`O_NONBLOCK` and `fstat` on what was opened). - `/proc/self/environ` and `cmdline` are refused as binary. - A link to a secret place is refused through `EvalSymlinks`, including `/proc/self/fd/N` that leads into one. - A search skips secret places, does not follow links and skips non-regular files. - `account` never answers a password field. **Required 1: the name check and the open are two lookups (TOCTOU).** `refusedRead` judges `path` and `EvalSymlinks(path)`. Then `os.OpenFile(path, …)` resolves the path again and follows links. I tested a link flipped in a loop between a harmless file and a file inside a secret place. `Read` answered the secret place's content **3744 times in 20000 calls**. `searchFile` has the same gap: `WalkDir` judges the entry by its `lstat` type, then the open follows a link that was swapped in. Why this matters: the name rule is the only bound for what `mesh-reads` may read by mode. That includes its own bus credential, `/var/lib/mesh-reads/broker`, which it owns. `fs.protected_symlinks=1` closes this in `/tmp`, but not in any non-sticky directory another account can write. Fix: judge what was opened, not the name. - Open with `O_RDONLY|O_NONBLOCK|O_NOCTTY|O_CLOEXEC`. In `search`, also use `O_NOFOLLOW`. - `fstat` the descriptor and require a regular file. - `readlink("/proc/self/fd/<n>")` and run `Refused` on that real path. If the path ends in `(deleted)` or is not absolute, refuse it. - Better still: `Lstat` before opening, so a device is never opened at all. Opening `/dev/ptmx` or a tape or watchdog device has side effects even when the read is then refused. - Add a test that flips a link in a goroutine and asserts that no answer carries the secret. **Required 2: a private key's body leaks a line.** I generated an RSA-2048 PKCS#8 key into `server.pem` (the name is not refused). `read` withheld 27 of its 28 lines; one base64 line of the key passed `CheckSecret`. Fix: in `read` and in `search`, withhold every line from a `-----BEGIN …PRIVATE KEY-----` (or any `BEGIN` the rule refuses) through its `END`. Better: refuse a file that contains such a block. Add a test with a generated key. **Required 3: shell history by name.** History files are where tokens are typed. Add `.bash_history`, `.zsh_history`, `.histfile`, `.python_history`, `.psql_history`, `.mysql_history`, `.lesshst`, `.viminfo` and `.node_repl_history` to `knownNames`. On g14 they are mode 0600 inside a 0700 home, but the name rule is the second bound for a node where a home is 0755. **Required 4: the stray binary.** The first commit carries a 5.1 MB built `mesh-reads` (Go 1.27.1, not stripped). I extracted it: - No token or key shapes. - It does carry the operator's account name and checkout paths (`/home/jochen/projects/novox/mesh-catalog-418/…`, `/home/jochen/go/pkg/mod/…`). This repository merges with merge commits, so the binary would stay in main's history for good: about 5 MB of bloat and a disclosure of local paths. It is not a secret leak. Since this PR needs another round anyway, the clean way out is a new branch from current main (for example `fix/418-node-reads-2`). Squash the two commits (and the fixes above) so the binary never appears, open it as a new PR, and close this one. Also add `modules/*/mesh-*` (or `/modules/mesh-reads/mesh-reads`) to `.gitignore`. **Should, not blocking:** - `search` can hang on a hard NFS mount, because `SearchTime` is checked only between entries. Stay on the root's file system by default (`st_dev`, like `grep -r` with `-xdev` thinking), and skip `/proc` and `/sys` unless the root is inside them. - Add by name: `/proc/*/{environ,mem,fd,map_files,root,cwd}` (only the account's own processes are reachable, but `/proc/self/fd/N` reaches a deleted file today; I tested it), `/etc/rancher`, `/etc/kubernetes/admin.conf`, and browser profile directories (`.mozilla`, `.config/google-chrome`, `.config/chromium`). - Hard links: the name rule cannot see a hard link to a secret file elsewhere. `fs.protected_hardlinks=1` limits who can make one, and the file mode still bounds the read. Say this limit in the README. - After mesh-sdk #23 merges, move `go.mod` to the SDK's merged main commit. 4dc5f29 stays reachable through the merge commit, so this is tidiness, not a break. Merge order: mesh-sdk #23, then mesh-controller #257 and its rollout done, then the replacement for this PR, assigned to novox first.
Author
Contributor

Replaced by #247: a fresh branch from main with one commit, so the stray binary never appears in history, plus review 55's fixes. Closing.

Replaced by #247: a fresh branch from main with one commit, so the stray binary never appears in history, plus review 55's fixes. Closing.
mesh-admin closed this pull request 2026-10-12 12:32:41 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: novox/mesh-catalog#244