Skip to content

Rename PyAutoPulse to PyAutoHeart#18

Merged
Jammy2211 merged 3 commits into
mainfrom
feature/rename-pyautopulse-to-pyautoheart
Jun 24, 2026
Merged

Rename PyAutoPulse to PyAutoHeart#18
Jammy2211 merged 3 commits into
mainfrom
feature/rename-pyautopulse-to-pyautoheart

Conversation

@Jammy2211

@Jammy2211 Jammy2211 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Renames the project identity from PyAutoPulse to PyAutoHeart across README, agent guidance, package metadata, tests, and workflow display text.
  • Adds heart/ as the canonical implementation package and pyauto-heart as the canonical CLI.
  • Keeps stable reusable workflow filenames, including .github/workflows/pulse-health.yml, while updating workflow display names, job names, comments, and issue labels to Heart terminology.
  • Updates the architecture boundary to the PyAuto organism roles: Brain -> Heart -> Hands, while noting the current PyAutoAgent/PyAutoBuild repos where relevant.

Compatibility Notes

  • bin/pyauto-pulse remains as a compatibility wrapper around bin/pyauto-heart.
  • The former pulse Python package remains as compatibility wrappers around heart modules, including python -m pulse.status and python -m pulse.checks.* paths.
  • pyautopulse remains as a package shim and pyautoheart is added as the canonical project package name.
  • Legacy PULSE_* environment variables still work as aliases for the new HEART_* variables.
  • Reusable workflow filenames are intentionally not renamed to avoid breaking external uses: PyAutoLabs/PyAutoPulse/.github/workflows/... callers during the transition.

Validation

  • git diff --check
  • NUMBA_CACHE_DIR=/tmp/numba_cache MPLCONFIGDIR=/tmp/matplotlib pytest tests/ -q (105 passed)
  • PYTHONPATH=. python3 -m heart.status --help
  • PYTHONPATH=. python3 -m pulse.status --help
  • ./bin/pyauto-heart help
  • ./bin/pyauto-pulse help
  • HEART_STATE_DIR=$(mktemp -d /tmp/pyauto-heart-smoke.XXXXXX) NO_COLOR=1 ./bin/pyauto-heart tick, then status --quiet and readiness --quiet against that temp state dir. Command sequence completed; readiness was yellow due to existing ecosystem state (workspace validation not passing, not this rename).
  • Repository-wide ripgrep review for PyAutoPulse, pyautopulse, AutoPulse, pyauto-pulse, pulse, Pulse, and PULSE; remaining hits are compatibility shims, legacy aliases, stable workflow filename references, and the git worktree pointer.

Follow-up Tasks

  • Rename the GitHub repository from PyAutoPulse to PyAutoHeart after this PR lands.
  • Update downstream repos still calling PyAutoLabs/PyAutoPulse/.github/workflows/...; existing filenames are stable, but callers should migrate owner/repo references once GitHub redirects are confirmed.
  • Update any local shell startup snippets from pyauto-pulse / PYAUTO_PULSE_* to pyauto-heart / PYAUTO_HEART_* or HEART_* when convenient.

Closes #17

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Renames the project identity from PyAutoPulse to PyAutoHeart across docs, CLI surfaces, workflows, and the Python/shell implementation, while keeping the legacy pulse and pyauto-pulse entry points as compatibility wrappers.

Changes:

  • Introduces heart/ as the canonical implementation and bin/pyauto-heart as the canonical CLI, with pulse/ and bin/pyauto-pulse delegating to Heart.
  • Updates tests, docs, config, and GitHub workflow display text to Heart terminology, while preserving stable reusable workflow filenames where needed.
  • Adds distribution/package shims (pyautoheart, pyautopulse) and preserves legacy PULSE_* env var behavior via aliases.

Reviewed changes

Copilot reviewed 66 out of 68 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
tests/test_version_skew.py Switches unit test imports to heart.checks.version_skew.
tests/test_test_run.py Updates test_run parsing test to import Heart check module.
tests/test_state.py Updates env var + module reload to Heart state module.
tests/test_script_timing.py Updates env vars/constants to Heart timing paths.
tests/test_readiness.py Switches readiness imports and env vars to Heart.
tests/test_noise.py Switches noise module import to Heart.
tests/test_color.py Moves tests to heart.heart_color and adds Heart env alias coverage.
README.md Renames user-facing documentation and adds transition/compat section.
pyproject.toml Renames distribution to pyautoheart and expands package discovery.
pyautopulse/init.py Adds pyautopulse compatibility shim.
pyautoheart/init.py Adds pyautoheart compatibility shim pointing to heart.
pulse/tick.sh Replaces implementation with wrapper delegating to heart/tick.sh.
pulse/status.py Replaces implementation with wrapper delegating to heart.status.
pulse/state.py Replaces implementation with wrapper delegating to heart.state.
pulse/readiness.py Replaces implementation with wrapper delegating to heart.readiness.
pulse/pulse_color.py Replaces implementation with wrapper delegating to heart.heart_color.
pulse/noise.py Replaces implementation with wrapper delegating to heart.noise.
pulse/fix.py Replaces implementation with wrapper delegating to heart.fix.
pulse/daemon.sh Replaces implementation with wrapper delegating to heart/daemon.sh.
pulse/checks/worktree_drift.sh Wrapper delegating to Heart worktree drift check.
pulse/checks/version_skew.py Wrapper delegating to Heart version skew check.
pulse/checks/url_sweep.sh Wrapper delegating to Heart url sweep check.
pulse/checks/url_check.sh Wrapper delegating to Heart url check script.
pulse/checks/url_check_live.sh Wrapper delegating to Heart live url audit script.
pulse/checks/test_run.py Wrapper delegating to Heart test_run check.
pulse/checks/script_timing.py Wrapper delegating to Heart script_timing check.
pulse/checks/repo_state.sh Wrapper delegating to Heart repo_state check.
pulse/checks/open_prs.sh Wrapper delegating to Heart open_prs check.
pulse/checks/ci_status.sh Wrapper delegating to Heart ci_status check.
pulse/checks/init.py Adds package marker for compatibility imports.
pulse/_common.sh Wrapper sourcing Heart common helpers.
pulse/_color.sh Wrapper sourcing Heart color helpers.
pulse/init.py Adds package marker for the legacy pulse namespace.
heart/tick.sh Adds canonical Heart tick implementation.
heart/status.py Adds canonical Heart status renderer.
heart/state.py Adds canonical Heart state I/O + PULSE_* aliases.
heart/noise.py Adds canonical Heart noise classification module.
heart/heart_color.py Adds canonical Heart Python color helpers + PULSE_* aliases.
heart/fix.py Adds canonical Heart fix context bundler.
heart/daemon.sh Adds canonical Heart watch loop.
heart/checks/worktree_drift.sh Adds canonical Heart worktree drift check.
heart/checks/version_skew.py Adds canonical Heart version skew check.
heart/checks/url_sweep.sh Adds canonical Heart url sweep check.
heart/checks/url_check.sh Adds canonical Heart offline url guard.
heart/checks/url_check_live.sh Adds canonical Heart live url audit runner.
heart/checks/test_run.py Adds canonical Heart test_run check (local+cloud verdict).
heart/checks/script_timing.py Adds canonical Heart script timing check.
heart/checks/repo_state.sh Adds canonical Heart repo_state check.
heart/checks/open_prs.sh Adds canonical Heart open_prs check.
heart/checks/ci_status.sh Adds canonical Heart ci_status check.
heart/checks/init.py Adds package marker for Heart checks.
heart/_common.sh Adds canonical Heart shell globals/helpers + PULSE_* aliases.
heart/_color.sh Adds canonical Heart shell color helpers + PULSE_* aliases.
heart/init.py Adds package marker for Heart.
config/repos.yaml Updates header/comments and daemon reload example to Heart CLI.
CLAUDE.md Updates agent guidance and boundary docs to Heart terminology.
bin/pyauto-pulse Converts legacy CLI into wrapper that execs pyauto-heart.
bin/pyauto-heart Adds canonical CLI dispatcher for Heart.
AGENTS.md Updates ecosystem boundary and call-chain docs to Brain→Heart→Hands.
.github/workflows/workspace-validation.yml Updates comments/strings referencing Heart ownership and CLI.
.github/workflows/url-check.yml Updates checkout path and scripts to Heart locations/wording.
.github/workflows/pulse-health.yml Keeps filename but updates workflow display/job naming to Heart.
.github/workflows/lib-tests.yml Updates workflow comments to reference Heart repo ownership.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Comment thread heart/checks/test_run.py
Comment thread heart/checks/script_timing.py Outdated
Comment thread heart/checks/test_run.py Outdated
Comment thread heart/checks/version_skew.py Outdated

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 66 out of 68 changed files in this pull request and generated 1 comment.

Comment thread .github/workflows/lib-tests.yml Outdated
@Jammy2211 Jammy2211 merged commit a2543d0 into main Jun 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename PyAutoPulse to PyAutoHeart

2 participants