mother: preflight python3, document prereqs, route from build handoff #178

Merged

clawdie merged 1 commit from mother-setup-prep into main

2026-06-24 19:25:29 +02:00

clawdie commented

2026-06-24 19:24:46 +02:00

Owner

Three reinforcing changes so the next agent's mother-node setup on osa lands the first time instead of failing late or in an unread doc.

Why

setup-mother.sh installs geodesic-dome-mcp (a python3 script) without checking python3 exists — so a missing interpreter installs fine and only fails when the MCP host invokes the tool. And the build-lane handoff (the agent's entry point) never pointed at the mother docs at all.

Changes

setup-mother.sh — fail-fast --- 0. preflight --- for python3, with a clear pkg install python3 hint. Active guard: protects the agent even if they read nothing.
MOTHER-SETUP.md — new Prerequisites section: python3 on PATH (stdlib only, no pip), and the COLIBRI_AUTOSPAWN_RPC_PROMPT boot decision (set = auto-spawn agent on boot; unset = quiet, token-free boot).
FREEBSD-BUILD-LANE-HANDOFF.md — pointer to MOTHER-SETUP.md / setup-mother.sh so the mother docs are discoverable from the entry point.

The chain: handoff routes → doc documents → script enforces the hard one. sh -n clean.

🤖 Generated with Claude Code

Three reinforcing changes so the next agent's **mother-node setup on osa** lands the first time instead of failing late or in an unread doc. ### Why `setup-mother.sh` installs `geodesic-dome-mcp` (a `python3` script) without checking python3 exists — so a missing interpreter installs fine and only fails when the MCP host invokes the tool. And the build-lane handoff (the agent's entry point) never pointed at the mother docs at all. ### Changes - **`setup-mother.sh`** — fail-fast `--- 0. preflight ---` for `python3`, with a clear `pkg install python3` hint. Active guard: protects the agent even if they read nothing. - **`MOTHER-SETUP.md`** — new **Prerequisites** section: `python3` on PATH (stdlib only, no pip), and the `COLIBRI_AUTOSPAWN_RPC_PROMPT` boot decision (set = auto-spawn agent on boot; unset = quiet, token-free boot). - **`FREEBSD-BUILD-LANE-HANDOFF.md`** — pointer to `MOTHER-SETUP.md` / `setup-mother.sh` so the mother docs are discoverable from the entry point. The chain: handoff **routes** → doc **documents** → script **enforces** the hard one. `sh -n` clean. 🤖 Generated with Claude Code

clawdie added 1 commit 2026-06-24 19:24:48 +02:00

mother: preflight python3, document prereqs, route from build handoff

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

CI / port (pull_request) Has been cancelled

Details

CI / agent-jail-pkgs (pull_request) Has been cancelled

Details

382b4a9188

Three reinforcing changes so the next agent's mother setup lands instead
of failing late:

- setup-mother.sh: fail-fast preflight for python3 (geodesic-dome-mcp is a
  python3 script that otherwise installs fine and fails only when invoked).
- MOTHER-SETUP.md: new Prerequisites section — python3 on PATH, and the
  COLIBRI_AUTOSPAWN_RPC_PROMPT boot decision (set = auto-spawn agent on
  boot; unset = quiet token-free boot).
- FREEBSD-BUILD-LANE-HANDOFF.md: pointer to MOTHER-SETUP.md/setup-mother.sh
  so the mother docs are discoverable from the build-lane entry point.

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