From db31b317653a40679d3ca768a17f4e8ab9abf50e Mon Sep 17 00:00:00 2001 From: Bryan Deng Date: Sat, 16 May 2026 12:41:53 +0800 Subject: [PATCH] docs: document subprocess_worker as single blocking worker --- builders/server/workers/subprocess_worker.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/builders/server/workers/subprocess_worker.py b/builders/server/workers/subprocess_worker.py index 9d73683..3e7e544 100644 --- a/builders/server/workers/subprocess_worker.py +++ b/builders/server/workers/subprocess_worker.py @@ -12,6 +12,11 @@ # # # Reason: the builder venv will not have server packages installed, so # # any non-stdlib import will fail at runtime. # +# # +# Design note: currently there is a single worker subprocess per build # +# timestamp. Execution is blocking; the orchestrator waits for each # +# subprocess to complete before spawning the next. Future work may # +# parallelize within a dependency level. # ########################################################################### """