fix: retire status.sh --repos, which sources a deleted file

[Jammy2211]

Overview

PyAutoMind/scripts/status.sh --repos sources scripts/pyauto_status.sh, which
does not exist in the repo. The branch is vestigial: skills/OWNERSHIP.md
records that pyauto-status / pyauto-status-full were retired into the
Heart-owned $health door (/health status, /health full). Worse than a
plain failure, the branch exits 0, so the flag looks like it worked:

$ bash scripts/status.sh --repos
scripts/status.sh: line 20: .../scripts/pyauto_status.sh: No such file or directory
scripts/status.sh: line 21: pyauto-status: command not found
$ echo $?
0

Found by the 2026-08-19 readability-pass census (#248).

Plan

• Confirm no caller passes --repos (done: PyAutoMind, PyAutoBrain and
  PyAutoHeart were all searched — nothing invokes status.sh with any flag).
• The retired replacement is an agent-driven procedure, not a sourceable
  shell function, so the branch cannot be repointed — delete it.
• Leave a short retirement pointer in its place so anyone with muscle memory for
  --repos is told where the cross-repo dashboard went, and exit non-zero
  instead of the current silent success.
• Update the script's usage header, and add a regression test that drives the
  real script.

Detailed implementation plan

Work Classification

Library / Workspace / Both → neither — this is Mind infrastructure
(PyAutoMind only, single repo).

Affected Repositories

• PyAutoMind (primary)

Branch Survey

Repository	Current Branch	Dirty?
./PyAutoMind	claude/status-sh-repos-missing-source-rj332c	clean

Suggested branch: claude/status-sh-repos-missing-source-rj332c (the
session's designated branch; this is a web-github run with no task worktree).

Worktree root: n/a — web-github environment, session clone only.
worktree_check_conflict status-sh-repos-missing-source PyAutoMind → exit 0
(no other task claims PyAutoMind).

Implementation Steps

1. scripts/status.sh — delete the --repos branch (the
   source "$ROOT/scripts/pyauto_status.sh" + pyauto-status + exit 0
   block). Replace it with a message on stderr naming the replacement
   (/health status, PyAutoHeart via the /health door) and exit 2.
2. scripts/status.sh — update the usage comment block: [--full] only, with
   one line recording that --repos was retired into $health status.
3. tests/test_status_script.py (new) — drive the real script:
   • --repos exits non-zero, points at /health status, and emits no
     No such file or directory / command not found shell error;
   • a bare run still exits 0 and prints the == Registry == section.
     Fictional/no-fixture only, per test_spawn_privacy.py — tests/** is
     KEEP-copied verbatim into the public template.

Key Files

• scripts/status.sh — the vestigial branch (lines 8, 12, 18-22).
• tests/test_status_script.py — new regression test.
• skills/OWNERSHIP.md — already records the retirement; no change needed.
• REFERENCE.md — already points at /health status for the dashboard; the
  only status.sh mentions are the flagless inventory run; no change needed.

Testing

python3 -m pytest tests/test_status_script.py plus a manual
bash scripts/status.sh / bash scripts/status.sh --repos.

Original Prompt

Click to expand starting prompt

# status.sh --repos sources a file that no longer exists

Type: bug
Target: pyautomind
Repos:
- PyAutoMind
Difficulty: small
Autonomy: supervised
Priority: low
Status: formalised
Filed: 2026-08-19 (backfilled from git)

Found by the 2026-08-19 readability-pass census (#248).
@PyAutoMind/scripts/status.sh's `--repos` branch does
`source scripts/pyauto_status.sh`, and that file does not exist in `scripts/`
— `bash scripts/status.sh --repos` fails. `skills/OWNERSHIP.md` records that
`pyauto-status` was retired into the `$health status` leg (PyAutoHeart), so
the branch is probably vestigial.

Decide and fix: either delete the `--repos` branch (and any docs offering it),
or repoint it at the Heart-owned replacement. Check the callers first
(Brain `wake_up.md`, `nightly.sh`, `bin/overnight_status.sh`; Heart `tick.sh`,
`ci_status.sh`, `heart-health.yml`) to confirm none of them pass `--repos`.

[Jammy2211]

Shipped

Merged in #332 (70dda35).

Decision: delete, not repoint. No caller passes --repos — PyAutoMind,
PyAutoBrain and PyAutoHeart were all searched and nothing invokes status.sh
with any argument (the Brain/Heart files named in the prompt reference
overnight_status.sh and ci_status.sh, unrelated scripts). Repointing was not
available either: the replacement is an agent-driven procedure, not a sourceable
shell function, so there was nothing to point the branch at.

What changed:

• scripts/status.sh — the vestigial branch is gone. In its place --repos
  names /health status on stderr and exits 2; the old branch ended in
  exit 0, so it reported success while printing nothing but two shell errors.
  Usage header updated to [--full], with a note recording where the dashboard
  went.
• tests/test_status_script.py (new, 4 tests) — drives the real script rather
  than grepping it: the retired flag fails loudly and names its replacement,
  raises no shell error, every file the script sources exists, and a bare run
  still reports the registry. All four fail against the old branch.

CI green on every run and every leg: Lifecycle Drift, Dashboard Refresh, and
Spawn Drift privacy (pytest tests/ → 216 passed). lifecycle.py check OK.

---

Generated by Claude Code