docs/build-manual.py

@@ -15,6 +15,7 @@ import sys
 from pathlib import Path
 
 import manualtools as mt
+import generate_component_registry
 
 DOCS = Path(__file__).parent
 MANUAL = DOCS / "manual"
@@ -840,6 +841,8 @@ def main() -> int:
     if not (args.concat or args.site):
         ap.error("nothing to do: pass --concat and/or --site")
 
+    generate_component_registry.main()
+
     if args.site:
         src = DOCS / "site" / "src"
         out = src / "content" / "docs"

docs/verify-manual.py

@@ -1005,6 +1005,16 @@ def test_render_registry_is_valid_fish_and_round_trips():
     assert "status=0" in proc.stdout, f"lookup did not report found: {proc.stdout!r}"
 
 
+def test_build_manual_regenerates_registry_before_building():
+    """docs/build-manual.py must regenerate the registry as a pre-step."""
+    import build_manual
+
+    assert hasattr(build_manual, "generate_component_registry"), (
+        "build-manual.py must import generate_component_registry so its "
+        "main() can be called as a pre-step before --site/--concat run"
+    )
+
+
 TESTS = [v for k, v in sorted(globals().items()) if k.startswith("test_")]