Merge pull request #152 from PyAutoLabs/feature/rename-autobuild-to-autohands

refactor: rename autobuild package and CLI to autohands

Author: Jammy2211

AGENTS.md

@@ -157,7 +157,7 @@ the `/<verb>` slash commands.
 <!-- pyauto:commands:end -->
 
 Like the other PyAuto repos, PyAutoBrain runs from its checkout (no pip install);
-it resolves the sibling `pyauto-heart` and `autobuild` binaries from PATH or the
+it resolves the sibling `pyauto-heart` and `autohands` binaries from PATH or the
 `~/Code/PyAutoLabs/` checkouts.
 
 ## The command surface (Brain implicit)

ORGANISM.md

@@ -23,7 +23,7 @@ organs plan, build, test and release it, and you make every judgment call.
 *Hands* and *Build* name the **same organ** (PyAutoHands) throughout this
 document: the organ is the **Hands**, and *Build* is the call-chain step it
 performs. (The Hands repo was renamed PyAutoBuild → PyAutoHands; the *Build*
-call-chain shorthand and the `autobuild` package/CLI keep their names.
+call-chain shorthand and the `autohands` package/CLI keep their names.
 `PyAutoConf` likewise remains the Nerves repo's name, aligned with its
 `autoconf` package.)
 

agents/_common.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
 # agents/_common.sh — shared helpers for PyAutoBrain's specialist agents.
 #
-# Resolves the sibling PyAuto organ CLIs (pyauto-heart, autobuild) the same way
-# the autobuild shim resolves them: prefer PATH, fall back to the sibling
+# Resolves the sibling PyAuto organ CLIs (pyauto-heart, autohands) the same way
+# the autohands shim resolves them: prefer PATH, fall back to the sibling
 # checkout under ~/Code/PyAutoLabs/. Nothing here is pip-installed.
 
 PYAUTO_ROOT="${PYAUTO_ROOT:-$HOME/Code/PyAutoLabs}"
@@ -31,8 +31,8 @@ resolve_heart() {
   _resolve_bin pyauto-heart "$PYAUTO_ROOT/PyAutoHeart/bin/pyauto-heart"
 }
 
-resolve_autobuild() {
-  _resolve_bin autobuild "$PYAUTO_ROOT/PyAutoHands/bin/autobuild"
+resolve_autohands() {
+  _resolve_bin autohands "$PYAUTO_ROOT/PyAutoHands/bin/autohands"
 }
 
 # _resolve_dir <env-var-name> <repo-name> — echo the path to a sibling PyAuto

agents/conductors/bug/_bug.py

@@ -35,7 +35,8 @@
 # (the organs themselves), not library-source or workspace work.
 INFRA_TARGETS = {
     "pyautobrain": "PyAutoBrain", "pyautoheart": "PyAutoHeart",
-    "pyautobuild": "PyAutoHands", "autobuild": "PyAutoHands",
+    "pyautobuild": "PyAutoHands", "autohands": "PyAutoHands",
+    "autobuild": "PyAutoHands",  # back-compat: the package was renamed autobuild -> autohands
     "pyautomind": "PyAutoMind", "pyautomemory": "PyAutoMemory",
 }
 

agents/conductors/build/AGENTS.md

@@ -86,7 +86,7 @@ mode/action.
   "requested_action": "<PyAutoHands capability>",
   "health_status": "green|yellow|red|unknown",
   "decision": "proceed|proceed-with-caution|abort",
-  "execution_plan": ["autobuild <action> <args>"],
+  "execution_plan": ["autohands <action> <args>"],
   "execution_summary": "<one line>",
   "warnings": ["..."],
   "blockers": ["..."],

agents/conductors/build/BUILD_CAPABILITIES.md

@@ -2,12 +2,12 @@
 
 This audit records the execution surface the PyAutoBrain Build Agent reasons over
 and **calls**. The agent must treat every item here as a PyAutoHands capability,
-not as logic to reimplement inside Brain. Source of truth: the `autobuild`
-dispatcher (`PyAutoHands/bin/autobuild`) and `PyAutoHands/CLAUDE.md`.
+not as logic to reimplement inside Brain. Source of truth: the `autohands`
+dispatcher (`PyAutoHands/bin/autohands`) and `PyAutoHands/CLAUDE.md`.
 
 ## Execution capabilities (the Build Agent calls these)
 
-From `autobuild help`. **Mode** is the Build Agent allowlist that *may* route
+From `autohands help`. **Mode** is the Build Agent allowlist that *may* route
 the capability (`build.sh`); **Consumer today** is who actually drives it now.
 The two diverge for the workspace-run surface — see the note below.
 
@@ -24,26 +24,26 @@ The two diverge for the workspace-run surface — see the note below.
 | `script_matrix` | Output a JSON `{name, directory}` matrix for GitHub Actions. | build | **Heart** `workspace-validation.yml` (CI) |
 | `aggregate_results` | Aggregate per-job JSON into a release-readiness report. | build, release | **Heart** `workspace-validation.yml` (CI) |
 | `slow_skip_check` | Surface SLOW / NEEDS_FIX entries in workspace `no_run.yaml`. | build | `run_all.py` + Heart `test_run` check |
-| `repro_command` | Emit the shell command autobuild uses to run one script. | build | triage (manual handoff) |
+| `repro_command` | Emit the shell command autohands uses to run one script. | build | triage (manual handoff) |
 | `bump_colab_urls` | Rewrite Colab URLs in cwd from an old to a new date-tag. | build, deploy | `release.yml` (CI) + deploy |
 
 **Reading the Consumer column — the run\* seam is latent, not active.** The
-capabilities still *exist* and match the `autobuild` dispatcher and the
+capabilities still *exist* and match the `autohands` dispatcher and the
 `build.sh` allowlists exactly; the *Mode* column remains accurate as the
 allowlist of record. What changed is the driver. The workspace full-run →
 report → issue flow moved **out of `release.yml` into PyAutoHeart's
 `workspace-validation.yml`** (see `PyAutoHands/docs/internals.md` and the
 `release.yml` comment recording the removed `run_scripts` / `run_notebooks` /
 `analyze_results` jobs). Heart checks these primitives out from Build and reuses
 them directly — calling `run.py` / `run_python.py` / `script_matrix.py` /
-`aggregate_results.py`, **not** `autobuild run_*` and **not** `pyauto-brain build
+`aggregate_results.py`, **not** `autohands run_*` and **not** `pyauto-brain build
 run_*`. Nothing invokes `run` / `run_python` / `run_all` through the Build Agent
 today, so their build-mode allowlist entries are a **latent seam** — kept so the
 Build Agent could re-own execution without churn, but **Heart is the live
 consumer**. This is the execution/health boundary the audit below argues for,
 now made visible in the table itself.
 
-Underlying implementation assets the agent never re-owns: `autobuild/run_python.py`,
+Underlying implementation assets the agent never re-owns: `autohands/run_python.py`,
 `run.py`, `generate.py`, `script_matrix.py`, `aggregate_results.py`,
 `tag_and_merge.sh`, `build_util.py`, the `release.yml` GitHub workflow, and the
 per-workspace `config/build/{no_run,env_vars,visualise_notebooks}.yaml`.

agents/conductors/build/build.sh

@@ -27,7 +27,7 @@
 #
 # Usage:
 #   build.sh [--mode build|deploy|release] [--force] [--accept-red=<reason>]...
-#            [--dry-run] [--json] [<action>] [-- <args forwarded to autobuild>]
+#            [--dry-run] [--json] [<action>] [-- <args forwarded to autohands>]
 #
 #   --force            proceed on a YELLOW verdict (deploy/release).
 #   --accept-red=<r>   authorize proceeding despite the RED reason <r>. Repeatable.
@@ -193,7 +193,7 @@ case "$eff" in
 esac
 
 # ----- execution plan -----
-plan_cmd="autobuild $action"
+plan_cmd="autohands $action"
 [[ ${#forward[@]} -gt 0 ]] && plan_cmd+=" ${forward[*]}"
 plan=("$plan_cmd")
 
@@ -250,6 +250,6 @@ if [[ "$dry_run" -eq 1 ]]; then
   exit 0
 fi
 
-autobuild="$(resolve_autobuild)" || exit $?
+autohands="$(resolve_autohands)" || exit $?
 [[ "$json_only" -eq 1 ]] || echo "== exec: $plan_cmd =="
-exec "$autobuild" "$action" "${forward[@]}"
+exec "$autohands" "$action" "${forward[@]}"

agents/conductors/clone/DESIGN.md

@@ -121,7 +121,7 @@ bad usage).
    partition, generation plan, CloneDecision. No writer at all. Proves the
    reasoning on `PyAutoFit → autofit_assistant` as the dry-run case study.
 2. **v1 — seed births. SHIPPED.** `--apply` for **lightweight-seed** via a
-   PyAutoHands primitive (`autobuild/clone_seed.py`: repo creation + generic-set
+   PyAutoHands primitive (`autohands/clone_seed.py`: repo creation + generic-set
    copy + scaffolds + the `PENDING.md` growth queue). Heart gained the
    newborn-validation checklist (`PyAutoHeart/docs/newborn_validation.md`).
 3. **v2 — differentiated siblings.** Skill/wiki regeneration from the domain

agents/conductors/clone/_clone.py

@@ -428,7 +428,7 @@ def apply_seed(args, decision):
     plan_path = Path(tempfile.mkstemp(prefix="clone_plan_", suffix=".json")[1])
     plan_path.write_text(json.dumps(plan, indent=2))
 
-    seed_script = PYAUTO_ROOT / "PyAutoHands" / "autobuild" / "clone_seed.py"
+    seed_script = PYAUTO_ROOT / "PyAutoHands" / "autohands" / "clone_seed.py"
     if not seed_script.exists():
         fail(4, f"Build primitive not found: {seed_script}")
     cmd = [sys.executable, str(seed_script), str(plan_path)]

agents/conductors/intake/_intake.py

@@ -86,7 +86,8 @@
     "autogalaxy": "PyAutoGalaxy", "autolens": "PyAutoLens",
     "pyautomind": "PyAutoMind", "pyautobrain": "PyAutoBrain",
     "pyautoheart": "PyAutoHeart", "pyautobuild": "PyAutoHands",
-    "pyautomemory": "PyAutoMemory", "autobuild": "PyAutoHands",
+    "pyautomemory": "PyAutoMemory", "autohands": "PyAutoHands",
+    "autobuild": "PyAutoHands",  # back-compat: the package was renamed autobuild -> autohands
     "workspaces": "workspaces",
 }
 PRIORITY_HIGH = ["urgent", "asap", "blocker", "blocking", "critical", "important",