Overview
pyautoheart/ is a 6-line compatibility shim (from heart import *) created by the PyAutoPulse→PyAutoHeart rename (#18, a2543d0) alongside the pulse//pyautopulse/ wrappers. The Phase-2 retirement of the Pulse compat surface (#28, a6f9083) deleted the pulse-era wrappers but missed this one. A census confirmed zero importers of pyautoheart anywhere in the workspace (PyAutoBrain mentions are repo-name routing strings, not imports) and the package is never pip-installed — Heart runs repo-locally via bin/pyauto-heart. Delete the trap rather than document it.
Plan
- Delete the
pyautoheart/ shim directory (single __init__.py)
- Drop
"pyautoheart*" from packages.find include in pyproject.toml (keep name = "pyautoheart" — distribution name, not import name)
- Verify: no importers workspace-wide, PyAutoHeart tests pass,
bin/pyauto-heart status runs
Detailed implementation plan
Affected Repositories
Branch Survey
| Repository |
Current Branch |
Dirty? |
| ./PyAutoHeart |
main |
clean |
Note: PyAutoHeart is currently claimed by task heart-state-clobber (feature/heart-state-clobber, worktree ~/Code/PyAutoLabs-wt/heart-state-clobber, issue #78) — this task registers as planned/blocked until that claim releases. No file overlap (that task touches heart/checks/; this one touches pyautoheart/ + pyproject.toml).
Suggested branch: feature/delete-pyautoheart-shim
Implementation Steps
git rm -r pyautoheart/ — removes the shim (pyautoheart/__init__.py, docstring "The implementation lives in :mod:heart", body from heart import *).- In
pyproject.toml, change [tool.setuptools.packages.find] include = ["heart*", "pyautoheart*"] → include = ["heart*"]. Leave [project] name = "pyautoheart" untouched.
- Verify:
grep -rn "import pyautoheart\|from pyautoheart" . across the workspace → no hits (pre-verified in census; re-check at implementation time).pytest tests/ -q in PyAutoHeart.bin/pyauto-heart status still runs.
Key Files
pyautoheart/__init__.py — the dead shim (delete)pyproject.toml — packages.find include list (edit)
Out of scope
Renaming heart/ → autoheart to match the org convention (autofit/autoconf/autobuild). Heart is never installed into site-packages, so the rename is cosmetic churn today; revisit only if Heart ever ships as a package.
Original Prompt
Click to expand starting prompt
Filed 2026-07-16 from a repo census (PyAutoMind/draft/maintenance/pyautoheart/delete_pyautoheart_shim.md). Original request (verbatim): "PyAutoHeart, heart and pyautoheart folders, feel duplicated / redudant and hsouldnt it be autoheart if anything? i.e. do a quick census of PyAutoHeart" — census done in session, user approved the deletion recommendation ("ok go").
Overview
pyautoheart/is a 6-line compatibility shim (from heart import *) created by the PyAutoPulse→PyAutoHeart rename (#18, a2543d0) alongside thepulse//pyautopulse/wrappers. The Phase-2 retirement of the Pulse compat surface (#28, a6f9083) deleted the pulse-era wrappers but missed this one. A census confirmed zero importers ofpyautoheartanywhere in the workspace (PyAutoBrain mentions are repo-name routing strings, not imports) and the package is never pip-installed — Heart runs repo-locally viabin/pyauto-heart. Delete the trap rather than document it.Plan
pyautoheart/shim directory (single__init__.py)"pyautoheart*"frompackages.findinclude inpyproject.toml(keepname = "pyautoheart"— distribution name, not import name)bin/pyauto-heart statusrunsDetailed implementation plan
Affected Repositories
Branch Survey
Note: PyAutoHeart is currently claimed by task
heart-state-clobber(feature/heart-state-clobber, worktree ~/Code/PyAutoLabs-wt/heart-state-clobber, issue #78) — this task registers as planned/blocked until that claim releases. No file overlap (that task touchesheart/checks/; this one touchespyautoheart/+pyproject.toml).Suggested branch:
feature/delete-pyautoheart-shimImplementation Steps
git rm -r pyautoheart/— removes the shim (pyautoheart/__init__.py, docstring "The implementation lives in :mod:heart", bodyfrom heart import *).pyproject.toml, change[tool.setuptools.packages.find] include = ["heart*", "pyautoheart*"]→include = ["heart*"]. Leave[project] name = "pyautoheart"untouched.grep -rn "import pyautoheart\|from pyautoheart" .across the workspace → no hits (pre-verified in census; re-check at implementation time).pytest tests/ -qin PyAutoHeart.bin/pyauto-heart statusstill runs.Key Files
pyautoheart/__init__.py— the dead shim (delete)pyproject.toml—packages.findinclude list (edit)Out of scope
Renaming
heart/→autoheartto match the org convention (autofit/autoconf/autobuild). Heart is never installed into site-packages, so the rename is cosmetic churn today; revisit only if Heart ever ships as a package.Original Prompt
Click to expand starting prompt
Filed 2026-07-16 from a repo census (
PyAutoMind/draft/maintenance/pyautoheart/delete_pyautoheart_shim.md). Original request (verbatim): "PyAutoHeart, heart and pyautoheart folders, feel duplicated / redudant and hsouldnt it be autoheart if anything? i.e. do a quick census of PyAutoHeart" — census done in session, user approved the deletion recommendation ("ok go").