From 1de4a6f65486efca53aa79e142e0fef5900adb7f Mon Sep 17 00:00:00 2001
From: atlas <atlas@hyperhive>
Date: Sat, 30 May 2026 13:05:04 +0200
Subject: [PATCH] =?UTF-8?q?nix/docs:=20fix=20empty=20host=20options=20page?=
 =?UTF-8?q?=20=E2=80=94=20pick=20under=20services.hyperhive.*=20(#630)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

mara on #630: host options page came up empty (template chrome with no
`<h2>` option headers).

Root cause: `pickSubtrees` filtered the host eval against the pre-#615
roots `[ "hyperhive" ]` and `[ "services" "hive-c0re" ]`. #615 moved
the whole host option tree under `services.hyperhive.*`; neither old
root matches anymore, so the filter silently produced an empty tree
and the rendered page degraded to just `<nav> + <main><h1></h1></main>
+ <footer>` chrome.

Fix: pick under `[ "services" "hyperhive" ]`. Agent options stay at
`[ "hyperhive" ]` — per-agent harness options weren't moved by #615.

Before: 100 lines, 0 `<h2>` headers
After:  661 lines, 33 `<h2>` headers covering:
  services.hyperhive.{enable,domain,c0re.*,forge.*,matrix.*,gateway.*}

Closes #630.
---
 nix/docs/default.nix | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/nix/docs/default.nix b/nix/docs/default.nix
index 55b33c7a..cb5f8805 100644
--- a/nix/docs/default.nix
+++ b/nix/docs/default.nix
@@ -106,11 +106,16 @@ let
     in
     lib.foldl' lib.recursiveUpdate { } (map pick roots);
 
+  # Post-#615, host options live entirely under `services.hyperhive.*`
+  # (closes #630). Pre-#615 had a mix of `hyperhive.*` (forge, matrix,
+  # domain) and `services.hive-c0re.*` — picking against those roots
+  # silently produced an empty options tree on current main, so the
+  # rendered host page was just the template chrome with no `<h2>`
+  # option headers underneath.
   hostOptions = pickSubtrees hostEval.options [
-    [ "hyperhive" ]
     [
       "services"
-      "hive-c0re"
+      "hyperhive"
     ]
   ];