2.1 KiB
2.1 KiB
Issue #561 — Bare python on agent hosts
Objective
Make the durable bootstrap/provisioning guidance ensure agent hosts provide a bare python command that resolves to Python 3.
Scope
- Add Debian/Ubuntu
python-is-python3to agent-host prerequisites in bootstrap docs. - Check for actual OS package provisioning scripts and update only if an existing agent-host package install path exists.
- Do not touch live host state.
- Do not update
docs/TASKS.md; repo guidance says workers read it but never modify it.
Recon
- Issue #561 confirms repeated
python: command not foundfailures from fleet agents that emitpython foo.py. guides/BOOTSTRAP.mdandpackages/mosaic/framework/guides/BOOTSTRAP.mdare the source and packaged framework copies of the bootstrap guide.- Targeted repo sweep found no agent-host Debian package provisioning script. Existing
apt-get installhits are CI/test helper paths or unrelated deployment docs.
Plan
- Add a host prerequisite section to both bootstrap guide copies.
- Include
python-is-python3in the Debian/Ubuntu package list with an issue comment. - Note the non-Debian equivalent as a
/usr/bin/python -> python3symlink. - Validate markdown/diff, run shell syntax checks where applicable, run required review, commit, queue guard, and push.
Validation Log
rgrecon: no existing agent-host Debian package provisioning script; only CI/test helperapt-get installpaths and unrelated deployment docs.git diff --check: passed.bash -n packages/mosaic/framework/install.sh tools/install.sh packages/mosaic/framework/tools/bootstrap/init-project.sh packages/mosaic/framework/tools/_scripts/mosaic-bootstrap-repo: passed. No touched shell scripts.~/.config/mosaic/tools/codex/codex-code-review.sh --uncommitted: approved, 0 findings.pnpm format:check: initially blocked becausenode_moduleswas absent andprettierwas unavailable;pnpm install --frozen-lockfileinitially hit an invalid/rootpnpm store path. Reran install with--store-dir /home/hermes/agent-work/.pnpm-store, thenpnpm format:checkpassed.