fix(host): NodeOptions-bound ports, central ESG cache TTL, hosted warm-up wiring; document AllowSingleNodeCluster as validation-only (review 2026-10-21 08/O5, 08/O4, 05/U3)

2026-10-22 08:41:55 -04:00
parent fa73ddb453
commit 1e3765ba6e
4 changed files with 40 additions and 16 deletions
@@ -112,6 +112,13 @@ public class ClusterOptions
    /// node (normally ≥2 are required so either node can start first). Without this
    /// flag a single-node install must list a phantom second seed, which the node
    /// dials forever — log noise and a defeated validation intent (review 01).
+    /// <para>
+    /// <b>Validation-only.</b> This flag changes nothing at runtime: it only relaxes
+    /// <c>ClusterOptionsValidator</c>'s seed-count check. It does not touch
+    /// <c>min-nr-of-members</c>, the downing strategy or the bootstrap guard — a lone node
+    /// forms its cluster because it lists ITSELF first (self-first seed ordering), not because
+    /// of this flag. The name is kept (renaming would break deployed configs) (review 2026-10-21 08/O4).
+    /// </para>
    /// </summary>
    public bool AllowSingleNodeCluster { get; set; }