From eb919a435fffd1ba5df9aafeb33566ee21e4904e Mon Sep 17 00:00:00 2001
From: Sam & Claude <hello@clawdie.si>
Date: Sun, 21 Jun 2026 22:28:41 +0200
Subject: [PATCH] =?UTF-8?q?docs(stage):=20guardrail=20comment=20=E2=80=94?=
 =?UTF-8?q?=20zot=20needs=20rpc=20driver=20before=20autospawn?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The spawner uses stdin(Stdio::null()); zot's --json and rpc modes
both require input. Pi's --mode json is autonomous. Document the
blocker inline so nobody tries the pi→zot config flip without the
driver. Ref: colibri issue zot-rpc-driver + ADR-agent-harness-consolidation.md.
---
 scripts/stage-colibri-iso.sh | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/scripts/stage-colibri-iso.sh b/scripts/stage-colibri-iso.sh
index 1be0ac59..ebfb5cfa 100755
--- a/scripts/stage-colibri-iso.sh
+++ b/scripts/stage-colibri-iso.sh
@@ -157,7 +157,12 @@ BW_SERVER="https://vault.smilepowered.org"
 #
 # Behavior toggles (non-secret):
 # COLIBRI_AUTOSPAWN_PI="YES"            # auto-spawn one Pi on daemon startup
-# COLIBRI_PI_BINARY="pi"               # Pi executable name/path
+# COLIBRI_PI_BINARY="pi"               # Pi executable name/path; zot is staged on
+#                                      # the image but needs the zot-rpc driver
+#                                      # before it can autospawn (spawner uses
+#                                      # stdin(Stdio::null()) — zot needs stdin).
+#                                      # See: ADR-agent-harness-consolidation.md
+#                                      # + colibri issue zot-rpc-driver.
 # COLIBRI_AUTOSPAWN_PI_ARGS="--mode json"   # Pi argv
 # COLIBRI_MCP_EXTERNAL_CALL="1"        # allow Pi (via colibri-mcp) to call
 #                                      # external MCP servers; set by