feat(multi-node): engine DaemonSet bundling + Caddy sticky LB + GPU/CPU pool placement

.gitignore

@@ -148,4 +148,11 @@ cluster-config/cluster-config.yaml
 charts/graphistry-helm/templates/postgres/pg-sts.yaml
 
 
-charts-aux-bundled
+charts-aux-bundled
+
+# helm-docs transient artifacts staged into chart dirs by docs/Makefile
+# helm-docs-gen target. Normally cleaned up by the recipe; ignored here
+# as belt-and-suspenders in case a run is interrupted (Ctrl-C, OOM,
+# SIGKILL between cp and rm).
+.helmdocs.gotmpl
+.helmdocs-out.md

.readthedocs.yaml

@@ -1,22 +1,45 @@
+# Read the Docs build configuration.
+# Spec: https://docs.readthedocs.io/en/stable/config-file/v2.html
+#
+# RTD's default pipeline is `pip install requirements -> sphinx-build`.
+# Our Sphinx site references generated chart READMEs and helm-docs-
+# produced parameter tables that live OUTSIDE docs/source/ at rest --
+# they are gitignored build artefacts (see docs/source/.gitignore).
+# Without a pre_build hook, sphinx finds nothing for those toctree
+# entries and the published site silently loses the chart README and
+# Values pages.
+#
+# `build.jobs.pre_build` runs after pip install and before sphinx-build,
+# so we use it to materialise the inputs sphinx needs:
+#   1. helm-docs-install: fetch the helm-docs binary (pinned in Makefile)
+#   2. readmes:           copy chart READMEs into docs/source/ + link rewrite
+#   3. helm-docs-gen:     render per-chart Values tables from values.yaml
+#
+# Note: every command in build.jobs runs in a FRESH shell with cwd
+# pinned at the repo root (per RTD spec), so each line uses
+# `make -C docs <target>` rather than `cd docs && ...`. RTD's build
+# VM is ephemeral; no post_build cleanup is needed.
 
-# .readthedocs.yml
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
 version: 2
 
-# Build documentation in the docs/ directory with Sphinx
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.11"
+  jobs:
+    pre_build:
+      - make -C docs helm-docs-install
+      - make -C docs readmes
+      - make -C docs helm-docs-gen
+
 sphinx:
   configuration: docs/source/conf.py
 
-# Optionally build your docs in additional formats such as PDF
+python:
+  install:
+    - requirements: docs/requirements.txt
+
 formats:
   - pdf
   - htmlzip
   - epub
-
-# Build configuration
-python:
-   install:
-   - requirements: docs/requirements.txt