feat(node): connection processes on by default, one per core up to four

At 1 no process starts and every lane of a download lands on the node's
one core. The Node page also sent every setting on each Save, pinning
untouched ones at the day's default; it sends only what changed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 27 insertions, 8 deletions

diff --git a/packages/meshbay-node/src/meshbay_node/config.py b/packages/meshbay-node/src/meshbay_node/config.py
index c5596f1..d46ab8c 100644
--- a/packages/meshbay-node/src/meshbay_node/config.py
+++ b/packages/meshbay-node/src/meshbay_node/config.py
@@ -74,13 +74,14 @@ max_concurrent_uploads = 8
 # the partial file is deleted.
 max_upload_gb = 8
 
-# How many processes carry the connections of members. At 1 the node does it
+# How many processes carry the connections of members. Left unset: one per core
+# of this machine, up to four, about 85 MB of memory each. At 1 the node does it
 # all in one process, on one core: about 35 MB/s summed over every transfer in
-# progress. Above 1 the node starts that many processes for the connections and
-# keeps the rest for itself, so transfers use that many cores, plus part of one
-# for the node. Takes effect for new connections, without a restart. Not above
-# the number of cores of this machine.
-connection_processes = 1
+# progress on Linux, and much less on Windows. Above 1 the node starts that many
+# processes for the connections and keeps the rest for itself, so transfers use
+# that many cores, plus part of one for the node. Takes effect for new
+# connections, without a restart. Not above the number of cores of this machine.
+# connection_processes = 4
 
 # HEVC sources have no browser decoder on most platforms, so streaming one is
 # transcoded to H264 rather than the usual free copy — real CPU per viewer.
@@ -202,8 +203,9 @@ class NodeConfig:
     # §15.3), so this is what stands between a writable root and a full disk.
     max_upload_gb: float = 8.0
     # How many processes hold the peer connections. One means this process
-    # holds them itself, as it always did. See transport/webrtc/workers.py.
-    connection_processes: int = 1
+    # holds them itself. See transport/webrtc/workers.py, and
+    # `default_connection_processes` for why it is not one by default.
+    connection_processes: int = field(default_factory=lambda: default_connection_processes())
     # HEVC (and any future codec in media_probe.py's
     # BROWSER_INCOMPATIBLE_VIDEO_CODECS) has no decoder in most browsers, so
     # streaming it needs a real re-encode to H264 rather than the usual free
@@ -305,6 +307,23 @@ def max_processes() -> int:
     return max(1, os.cpu_count() or 1)
 
 
+# Above four, a single download no longer gains (docs/MESHBAY_DESIGN.md §5.5:
+# 131 MB/s at four, 150 at eight with the receiving browser the limit), and each
+# process is 85 MB held for the life of the node.
+DEFAULT_CONNECTION_PROCESSES_MAX = 4
+
+
+def default_connection_processes() -> int:
+    """
+    One per core, up to four. It was 1, which starts no process at all: the
+    several-cores path was measured, shipped and reached by no node whose
+    operator had not found the setting, and the lanes of a download all landed
+    on the node's one core — on Windows, where Python's UDP costs most, a
+    download over eight connections was as slow as over one.
+    """
+    return min(DEFAULT_CONNECTION_PROCESSES_MAX, max_processes())
+
+
 def _positive(value: object, default: int, name: str) -> int:
     """A count that must be at least one, or the default with a word about it.