Repository navigation
fix: hygiene extras crashes on Python 3.10 (no tomllib) #581
Description
Overview
pyauto-brain hygiene (default scan and hygiene extras) crashes with ModuleNotFoundError: No module named 'tomllib'. hygiene.sh runs _hygiene_extras.py with the bare python3, which is 3.10 on the WSL laptop, and tomllib arrived in Python 3.11. Brain CI tests on 3.12 and 3.13, so CI never sees it. The extras mode has been silently empty on the laptop as a result. Found 2026-11-04 in the health and hygiene review.
Plan
hygiene.shruns the extras helper with the newest available interpreter (python3.13,python3.12,python3.11, thenpython3)._hygiene_extras.pyfalls back totomliwhen present. With neither, it prints a one-line "skipped: needs Python ≥ 3.11" row and exits cleanly, not with a traceback.- Add a test for the no-tomllib path.
- Tier: glance — merge mode: human /prm
Detailed implementation plan
agents/conductors/hygiene/hygiene.sh: add_toml_python(), which echoes the first ofpython3.13/3.12/3.11found bycommand -v, elsepython3. Use it at the two_hygiene_extras.pycall sites and inhelper_rowfor extras._hygiene_extras.py: replaceimport tomllibwithtry tomllib / except: try tomli / except: tomllib = None. Withtomllib is None,mainemits the skipped row and exits 0.- Test: run the helper's import path with
tomllibmasked fromsys.modules, and assert the skipped message is printed and nothing is raised.
Activity
Jammy2211 commentedon Nov 4, 2026
Shipped in #582 (merged, CI green 2/2): extras runs on the newest python3.1x with tomllib; without one it reports a skipped/advisory row instead of a traceback.