From 3be7a211d027e723c1a695df77a9724f6c925c09 Mon Sep 17 00:00:00 2001 From: atlas Date: Fri, 14 Aug 2026 09:52:44 +0200 Subject: [PATCH] docs(3202): state the file's scope positively MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per mara's review: "describe what is, not what is not." The header said "the swarm services' vhosts are NOT here", which describes the file by its absences and dates immediately — the list of what is missing grows every time a service is added, while the list of what the file holds does not. Reworded to say what it is: the hive's own gateway surface (the `_` default server and the vhost named for the hive domain), with the scope line stating where a swarm service's vhost lives rather than where it doesn't. --- nix/host-modules/hive-gateway/vhosts.nix | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/nix/host-modules/hive-gateway/vhosts.nix b/nix/host-modules/hive-gateway/vhosts.nix index 5f74f059..e54dddda 100644 --- a/nix/host-modules/hive-gateway/vhosts.nix +++ b/nix/host-modules/hive-gateway/vhosts.nix @@ -1,14 +1,14 @@ -# nginx virtual-host tree for the gateway: the `_` default server — -# now only a catch-all that rejects — and the hive's own domain, which -# carries the dashboard, per-agent routing, matrix discovery and the -# swagger UI. +# nginx virtual-host tree for the **hive's own** gateway surface: the `_` +# default server, which answers unmatched `Host` with a bare 444, and the +# vhost named for the hive domain, which carries the dashboard, per-agent +# routing, matrix discovery, the swagger UI and the legacy +# `/matrix/*` redirect. # -# ⚠️ The swarm services' vhosts are NOT here. Forge, matrix and authelia -# each declare their own, built from the same kit this file consumes -# (`services.hyperhive.gateway.lib`, ./vhost-lib.nix), so a service owns -# its whole gateway surface — vhost and dns name — inside its own -# module. A service name appearing in this file is the signal that the -# coupling is growing back. +# Scope: a swarm service declares its own vhost and dns name in its own +# module, built from the kit this file also consumes +# (`services.hyperhive.gateway.lib`, ./vhost-lib.nix). That keeps a +# service's gateway surface next to the service, and keeps this file to +# the surface the hive itself serves. # # Pure function — called from ./default.nix with the outer-scope config # values as arguments; returns `{ virtualHosts }`.