Files
stack/docs/scratchpads/561-python-is-python3.md
Hermes Agent 8030d3ebf0
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
docs(bootstrap): add python-is-python3 host prereq (#561)
2026-07-03 04:00:39 -05:00

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-python3 to 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 found failures from fleet agents that emit python foo.py.
  • guides/BOOTSTRAP.md and packages/mosaic/framework/guides/BOOTSTRAP.md are the source and packaged framework copies of the bootstrap guide.
  • Targeted repo sweep found no agent-host Debian package provisioning script. Existing apt-get install hits are CI/test helper paths or unrelated deployment docs.

Plan

  1. Add a host prerequisite section to both bootstrap guide copies.
  2. Include python-is-python3 in the Debian/Ubuntu package list with an issue comment.
  3. Note the non-Debian equivalent as a /usr/bin/python -> python3 symlink.
  4. Validate markdown/diff, run shell syntax checks where applicable, run required review, commit, queue guard, and push.

Validation Log

  • rg recon: no existing agent-host Debian package provisioning script; only CI/test helper apt-get install paths 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 because node_modules was absent and prettier was unavailable; pnpm install --frozen-lockfile initially hit an invalid /root pnpm store path. Reran install with --store-dir /home/hermes/agent-work/.pnpm-store, then pnpm format:check passed.