Rename PyAutoPulse to PyAutoHeart (#18)

Rename the PyAutoPulse project identity to PyAutoHeart across docs, code, workflows, package metadata, and CLI surfaces.

Keep compatibility wrappers for legacy pulse imports, pyautopulse package access, pyauto-pulse CLI usage, PULSE_* environment aliases, and stable reusable workflow filenames during the transition.

Validation:
- git diff --check
- NUMBA_CACHE_DIR=/tmp/numba_cache MPLCONFIGDIR=/tmp/matplotlib pytest tests/ -q

Author: Jammy2211

.github/workflows/lib-tests.yml

@@ -1,6 +1,6 @@
 name: Library Tests (reusable)
 
-# Pulse-owned reusable unit-test workflow for the 5 PyAuto libraries
+# Heart-owned reusable unit-test workflow for the 5 PyAuto libraries
 # (Stage 4 Phase A). Each library's own .github/workflows/main.yml is now a thin
 # caller:
 #
@@ -10,8 +10,12 @@ name: Library Tests (reusable)
 #       with: { package: autolens }
 #       secrets: inherit
 #
+# Keep the PyAutoPulse owner/repo in copy-paste examples until the GitHub
+# repository rename is complete and redirects are confirmed. The workflow
+# filename is intentionally stable for downstream callers.
+#
 # PR-time gating is preserved: the caller's `unittest` job runs on push/PR and is
-# the required status check. Pulse owns the test definition; the library just
+# the required status check. Heart owns the test definition; the library just
 # triggers it. Dependency-aware (conf→none, fit/array→conf, galaxy→conf+fit+array,
 # lens→all) so lightweight libs don't install the heavy stack. GitHub-hosted +
 # pip caching.

.github/workflows/pulse-health.yml

@@ -1,10 +1,10 @@
-name: Pulse Health
+name: Heart Health
 
-# Scheduled cloud-safe half of the PyAutoPulse hybrid CI layer.
+# Scheduled cloud-safe half of the PyAutoHeart hybrid CI layer.
 #
 # Runs the two checks that need only the GitHub API (no local working tree) —
 # CI status and open PRs — across every polled repo, then opens-or-updates a
-# single "[pulse-health]" tracking issue when anything is red/degraded, and
+# single "[heart-health]" tracking issue when anything is red/degraded, and
 # closes it when everything is clean again. No agent, no Slack, no secret
 # beyond the auto-provisioned GITHUB_TOKEN — mirrors the url_check.yml pattern.
 #
@@ -21,11 +21,11 @@ permissions:
   issues: write
 
 jobs:
-  pulse-health:
+  heart-health:
     name: Cloud health checks
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout PyAutoPulse
+      - name: Checkout PyAutoHeart
         uses: actions/checkout@v4
 
       - name: Set up Python
@@ -42,21 +42,21 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           # Force colour off; write sidecars under a workspace-local state dir.
           NO_COLOR: "1"
-          PULSE_STATE_DIR: ${{ github.workspace }}/.pulse-state
+          HEART_STATE_DIR: ${{ github.workspace }}/.heart-state
         run: |
           set +e
-          bash pulse/checks/ci_status.sh
-          bash pulse/checks/open_prs.sh
+          bash heart/checks/ci_status.sh
+          bash heart/checks/open_prs.sh
           exit 0
 
       - name: Classify results
         id: classify
         env:
-          PULSE_STATE_DIR: ${{ github.workspace }}/.pulse-state
+          HEART_STATE_DIR: ${{ github.workspace }}/.heart-state
         run: |
           python3 - <<'PY'
           import json, os, glob, pathlib
-          state = pathlib.Path(os.environ["PULSE_STATE_DIR"]) / "per-repo"
+          state = pathlib.Path(os.environ["HEART_STATE_DIR"]) / "per-repo"
           red, yellow = [], []
           for f in sorted(state.glob("*.ci_status.json")):
               d = json.loads(f.read_text())
@@ -69,44 +69,44 @@ jobs:
                   red.append(f"- **{d['name']}**: open PR {age}d old (>30d)")
               elif d.get("open_count", 0) and age >= 7:
                   yellow.append(f"- {d['name']}: open PR {age}d old")
-          lines = ["# Pulse health report", ""]
+          lines = ["# Heart health report", ""]
           if red:
               lines += ["## 🔴 Red", *red, ""]
           if yellow:
               lines += ["## 🟡 Yellow", *yellow, ""]
           if not red and not yellow:
               lines += ["✅ All cloud checks green (CI passing, no stale PRs)."]
           body = "\n".join(lines)
-          pathlib.Path("/tmp/pulse_health_body.md").write_text(body + "\n")
+          pathlib.Path("/tmp/heart_health_body.md").write_text(body + "\n")
           status = "red" if red else ("yellow" if yellow else "green")
           with open(os.environ["GITHUB_OUTPUT"], "a") as out:
               out.write(f"status={status}\n")
           print(body)
           PY
 
-      - name: Open or update [pulse-health] tracking issue
+      - name: Open or update [heart-health] tracking issue
         if: steps.classify.outputs.status != 'green'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          existing=$(gh issue list --search '"[pulse-health]"' --state open --json number --jq '.[0].number // empty')
+          existing=$(gh issue list --search '"[heart-health]"' --state open --json number --jq '.[0].number // empty')
           if [ -n "$existing" ]; then
-            gh issue comment "$existing" --body-file /tmp/pulse_health_body.md
+            gh issue comment "$existing" --body-file /tmp/heart_health_body.md
           else
             gh issue create \
-              --title "[pulse-health] Degraded ecosystem health" \
-              --body-file /tmp/pulse_health_body.md \
-              --label pulse-health 2>/dev/null \
+              --title "[heart-health] Degraded ecosystem health" \
+              --body-file /tmp/heart_health_body.md \
+              --label heart-health 2>/dev/null \
               || gh issue create \
-                --title "[pulse-health] Degraded ecosystem health" \
-                --body-file /tmp/pulse_health_body.md
+                --title "[heart-health] Degraded ecosystem health" \
+                --body-file /tmp/heart_health_body.md
           fi
 
-      - name: Close [pulse-health] issue when clean
+      - name: Close [heart-health] issue when clean
         if: steps.classify.outputs.status == 'green'
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          for n in $(gh issue list --search '"[pulse-health]"' --state open --json number --jq '.[].number'); do
+          for n in $(gh issue list --search '"[heart-health]"' --state open --json number --jq '.[].number'); do
             gh issue close "$n" --comment "Cloud health checks are green — closing automatically."
           done

.github/workflows/url-check.yml

@@ -4,10 +4,10 @@ name: URL Check (central)
 #
 # Replaces the 12 per-repo .github/workflows/url_check.yml workflows: instead of
 # each repo running its own offline + live URL audit and opening its own
-# [url-check] issue, PyAutoPulse sweeps every repo here and consolidates into a
-# SINGLE [url-check] tracking issue. Mirrors the pulse-health.yml pattern.
+# [url-check] issue, PyAutoHeart sweeps every repo here and consolidates into a
+# SINGLE [url-check] tracking issue. Mirrors the heart-health.yml pattern.
 #
-# Monitoring only — URL hygiene does not gate releases (Pulse owns the release
+# Monitoring only — URL hygiene does not gate releases (Heart owns the release
 # gate via `readiness`, which this does not touch).
 
 on:
@@ -31,10 +31,10 @@ jobs:
     name: Central URL sweep
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout PyAutoPulse
+      - name: Checkout PyAutoHeart
         uses: actions/checkout@v4
         with:
-          path: pulse
+          path: heart
 
       - name: Set up Python
         uses: actions/setup-python@v5
@@ -60,10 +60,10 @@ jobs:
               continue
             fi
             # Offline forbidden-pattern guard.
-            off="$(bash pulse/pulse/checks/url_check.sh "checkout/$repo" 2>/dev/null)"
+            off="$(bash heart/heart/checks/url_check.sh "checkout/$repo" 2>/dev/null)"
             off_rc=$?
             # Live HTTP audit (honours the repo's .url_check_allowlist.txt).
-            live="$(bash pulse/pulse/checks/url_check_live.sh "checkout/$repo" 2>/dev/null)"
+            live="$(bash heart/heart/checks/url_check_live.sh "checkout/$repo" 2>/dev/null)"
             live_rc=$?
             if [ "$off_rc" -ne 0 ] || [ "$live_rc" -ne 0 ]; then
               body+=$'\n'"## $repo"$'\n'

.github/workflows/workspace-validation.yml

@@ -1,14 +1,14 @@
 name: Workspace Validation
 
-# Pulse-owned workspace-integration validation (Stage 4 Phase B).
+# Heart-owned workspace-integration validation (Stage 4 Phase B).
 #
 # This is the "heavy validation CI" that used to live in PyAutoBuild's
 # release.yml (find_scripts / generate_notebooks / run_scripts / run_notebooks /
-# analyze_results). Pulse owns it now: Build is a pure executor. It runs every
+# analyze_results). Heart owns it now: Build is a pure executor. It runs every
 # workspace's scripts AND generated notebooks against the CURRENT source `main`
 # of the 5 libraries (source-shadowed via PYTHONPATH), aggregates into the same
 # report.json contract, and uploads it as the `workspace-validation-report`
-# artifact. Pulse's test_run check reads that run's
+# artifact. Heart's test_run check reads that run's
 # conclusion + timestamp into the authoritative `readiness` verdict (with a
 # staleness window).
 #
@@ -17,7 +17,7 @@ name: Workspace Validation
 #
 # Triggers: weekly schedule (the continuous readiness signal), manual dispatch,
 # and workflow_call (so a release path can invoke it on demand). Heavy, so never
-# in the <30s pulse tick.
+# in the <30s heart tick.
 
 on:
   schedule:
@@ -299,7 +299,7 @@ jobs:
       - name: Post summary
         if: always()
         run: cat report.md >> "$GITHUB_STEP_SUMMARY" || true
-      - name: Upload report (consumed by pyauto-pulse readiness)
+      - name: Upload report (consumed by pyauto-heart readiness)
         if: always()
         uses: actions/upload-artifact@v4
         with:

AGENTS.md

@@ -1,33 +1,35 @@
-# PyAutoPulse — Agent Guidance
+# PyAutoHeart — Agent Guidance
 
-PyAutoPulse is the **health authority** of the PyAuto release ecosystem: it owns
-all health and release-readiness checking plus continuous monitoring of the
-PyAuto repos. `pyauto-pulse readiness` is the authoritative "is it safe to
+PyAutoHeart is the **health and vital-signs authority** of the PyAuto organism:
+it owns health checks, release-readiness checking, workspace validation, URL
+hygiene, generated-artifact/noise classification, and continuous monitoring of
+the PyAuto repos. `pyauto-heart readiness` is the authoritative "is it safe to
 release?" gate.
 
 ## The boundary (one description, mirrored in all three repos)
 
-- **PyAutoPulse — the health authority.** All health/readiness logic lives here:
+- **PyAutoHeart — the health authority.** All health/readiness logic lives here:
   version drift, install-path, URL hygiene, CI/worktree/timing monitoring.
-  `pyauto-pulse readiness` is the **authoritative** green/yellow/red verdict —
-  the single "is it safe to release?" gate. Pulse is an observer: it reads and
+  `pyauto-heart readiness` is the **authoritative** green/yellow/red verdict —
+  the single "is it safe to release?" gate. Heart is an observer: it reads and
   emits verdicts; it never writes into other repos and never triggers Build.
-- **PyAutoBuild — the executor.** Packaging, tagging, notebook generation, and
-  PyPI publication via `release.yml`. Build runs **no** readiness checks of its
-  own and never re-derives a gate decision; it just executes.
-- **PyAutoAgent — the brain.** Hosts the agents that connect the two. It owns no
-  checks and no release steps; it gates on Pulse and delegates execution to
-  Build.
+- **PyAutoHands / PyAutoBuild — the executor.** Packaging, tagging, notebook
+  generation, and PyPI publication via `release.yml`. Hands runs **no**
+  readiness checks of its own and never re-derives a gate decision; it just
+  executes.
+- **PyAutoBrain / PyAutoAgent — the brain.** Hosts the agents that connect the
+  two. It owns no checks and no release steps; it gates on Heart and delegates
+  execution to Hands.
 
 ## The call chain (always this order)
 
 ```
-Agent  →  Pulse (gate)  →  Build (execute)
+Brain  →  Heart (gate)  →  Hands (execute)
 ```
 
-The agent asks `pyauto-pulse readiness --json`; only on a **green** verdict does
-it trigger Build's release. Pulse never triggers Build; Build never re-derives a
-gate decision the agent already made.
+The brain asks `pyauto-heart readiness --json`; only on a **green** verdict does
+it trigger Hands' release work. Heart never triggers Hands; Hands never
+re-derives a gate decision the brain already made.
 
 ## Where things live
 
@@ -39,6 +41,6 @@ gate decision the agent already made.
 - `readiness` rolls these into the authoritative verdict (URL hygiene is
   monitoring only and does **not** gate it).
 
-See [`CLAUDE.md`](CLAUDE.md) for Pulse's internals — the check framework, the
+See [`CLAUDE.md`](CLAUDE.md) for Heart's internals — the check framework, the
 <30s tick budget, how to add a check, and the hard rules (observer-only, colour
 coding, atomic state writes).

CLAUDE.md

@@ -1,77 +1,78 @@
-# PyAutoPulse — Agent Guidance
+# PyAutoHeart — Agent Guidance
 
 This file is for AI coding agents (Claude Code, Codex, Cursor, etc.)
 discovering this repository.
 
 ## What this repo is
 
-PyAutoPulse is the **health authority** of the PyAuto ecosystem. It owns all
-health and release-readiness checking: continuous monitoring (CI status, dirty
-checkouts, branch ahead/behind, open PRs, worktree state, script-timing
+PyAutoHeart is the **health and vital-signs authority** of the PyAuto organism.
+It owns health and release-readiness checking: continuous monitoring (CI status,
+dirty checkouts, branch ahead/behind, open PRs, worktree state, script-timing
 regressions, version skew) plus deep on-demand/cloud checks (install
-verification, URL hygiene), all green/yellow/red colour coded. `pyauto-pulse
-readiness` is the **authoritative** "is it safe to release?" gate.
+verification, URL hygiene), workspace validation, and generated-artifact/noise
+classification, all green/yellow/red colour coded. `pyauto-heart readiness` is
+the **authoritative** "is it safe to release?" gate.
 
-It is **separate** from PyAutoBuild on purpose: PyAutoBuild is a pure executor
-(it produces PyPI releases and runs no readiness checks); Pulse owns the
-checking. Pulse shells out to `autobuild` primitives but never imports
-PyAutoBuild Python, never writes into other repos, and never triggers Build.
+It is **separate** from PyAutoHands / PyAutoBuild on purpose: Hands is a pure
+executor (it produces PyPI releases and runs no readiness checks); Heart owns
+the checking. Heart shells out to `autobuild` primitives but never imports
+PyAutoBuild Python, never writes into other repos, and never triggers Hands.
 
-See [`AGENTS.md`](AGENTS.md) for the canonical Build/Pulse/Agent boundary and the
-`Agent → Pulse → Build` call chain, and `README.md` for user-facing docs.
+See [`AGENTS.md`](AGENTS.md) for the canonical Brain/Heart/Hands boundary and
+the `Brain → Heart → Hands` call chain, and `README.md` for user-facing docs.
 
 ## Hard rules
 
 1. **Color coding everywhere**: green = passing, yellow = warning,
    red = failing. Use the `c_ok / c_warn / c_fail / c_info / c_meta`
-   helpers in `pulse/_color.sh` (bash) and `pulse/pulse_color.py`
+   helpers in `heart/_color.sh` (bash) and `heart/heart_color.py`
    (Python). Honour `NO_COLOR` and `--no-color`.
-2. **Never write outside `~/.pyauto-pulse/`** in any check module.
+2. **Never write outside `~/.pyauto-heart/`** in any check module.
    The daemon must be a pure observer; mutations belong in
-   `pyauto-pulse fix <topic>` which only EMITS context for a fresh
+   `pyauto-heart fix <topic>` which only EMITS context for a fresh
    Claude session.
 3. **Polling must be cheap**. A full `tick` should complete in <30s
    total. If a check would take longer, run it less often (move to a
    v2 daily cron, not the watch loop).
-4. **No JAX in tests** — library convention. Pulse tests run with
+4. **No JAX in tests** — library convention. Heart tests run with
    stdlib + PyYAML only.
-5. **State writes are atomic**. Use `pulse.state.atomic_write_json` or
-   the bash equivalent (`pulse_write_json` in `_common.sh`). Concurrent
+5. **State writes are atomic**. Use `heart.state.atomic_write_json` or
+   the bash equivalent (`heart_write_json` in `_common.sh`). Concurrent
    ticks must not corrupt `state.json`.
 
 ## Repo structure
 
 ```
-bin/pyauto-pulse                 # bash dispatcher
-pulse/                           # all logic, shell-first
+bin/pyauto-heart                 # bash dispatcher
+heart/                           # all logic, shell-first
   _color.sh, _common.sh
   daemon.sh, tick.sh             # the loop + one cycle
   state.py, status.py, fix.py    # Python side
-  pulse_color.py
+  heart_color.py
   checks/                        # one file per check class
 config/repos.yaml                # polled repo registry + thresholds
 tests/                           # pytest
 ```
 
 ## Adding a new check
 
-1. Create `pulse/checks/<name>.{sh,py}` following the existing patterns.
+1. Create `heart/checks/<name>.{sh,py}` following the existing patterns.
 2. Each check writes per-repo JSON sidecars to
-   `$PULSE_PER_REPO_DIR/<repo>.<check_kind>.json` OR a global file at
-   `$PULSE_STATE_DIR/<check_name>.json`.
+   `$HEART_PER_REPO_DIR/<repo>.<check_kind>.json` OR a global file at
+   `$HEART_STATE_DIR/<check_name>.json`.
 3. Print a single colour-coded summary line to stdout (logged to the
-   daemon log by `pulse_log`).
-4. Add a section to `pulse/status.py:render` that surfaces the result.
+   daemon log by `heart_log`).
+4. Add a section to `heart/status.py:render` that surfaces the result.
 5. Add tests in `tests/test_<name>.py` covering classification edges.
-6. Wire into `pulse/tick.sh` in the appropriate position.
+6. Wire into `heart/tick.sh` in the appropriate position.
 
 ## Running locally
 
 ```bash
 pip install -e .[dev]
 pytest tests/ -v
-PULSE_FORCE_COLOR=1 pyauto-pulse tick     # one cycle, with colour
-pyauto-pulse status
+HEART_FORCE_COLOR=1 pyauto-heart tick     # one cycle, with colour
+pyauto-heart status
 ```
 
 ## Codex / sandboxed runs