Skip to content

Commit e710d0c

Browse files
Jammy2211claude
authored andcommitted
docs(build): add Consumer column to BUILD_CAPABILITIES table
Make the execution/health boundary visible in the capabilities table: a new "Consumer today" column records who actually drives each capability, alongside the existing Build Agent mode allowlist. The workspace full-run flow (run/run_python/run_all/script_matrix/ aggregate_results) migrated out of release.yml into PyAutoHeart's workspace-validation.yml, which calls the PyAutoBuild primitives directly. Nothing routes them through `pyauto-brain build run_*` today, so those build-mode allowlist entries are a latent seam with Heart as the live consumer. Note added to explain the Mode-vs-Consumer split. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 1f94fb9 commit e710d0c

1 file changed

Lines changed: 35 additions & 17 deletions

File tree

agents/conductors/build/BUILD_CAPABILITIES.md

Lines changed: 35 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,41 @@ dispatcher (`PyAutoBuild/bin/autobuild`) and `PyAutoBuild/CLAUDE.md`.
77

88
## Execution capabilities (the Build Agent calls these)
99

10-
From `autobuild help`:
11-
12-
| Capability | What it does | Build Agent mode |
13-
|------------|--------------|------------------|
14-
| `pre_build` | Format, regenerate notebooks, push workspaces, then dispatch `release.yml`. | release |
15-
| `tag_and_merge` | Commit and tag every library repo for a release. | release |
16-
| `generate_release_notes` | Generate release notes from merged PRs and create GitHub Releases. | release |
17-
| `create_analysis_issue` | Open a GitHub issue with the release report and assign Copilot. | release |
18-
| `generate` | Convert a workspace's `scripts/` to `notebooks/`. | build, deploy |
19-
| `run` | Execute notebooks in a workspace folder. | build |
20-
| `run_python` | Execute Python scripts in a workspace folder. | build |
21-
| `run_all` | Run scripts across one or more workspaces, produce summary reports. | build |
22-
| `script_matrix` | Output a JSON `{name, directory}` matrix for GitHub Actions. | build |
23-
| `aggregate_results` | Aggregate per-job JSON into a release-readiness report. | build, release |
24-
| `slow_skip_check` | Surface SLOW / NEEDS_FIX entries in workspace `no_run.yaml`. | build |
25-
| `repro_command` | Emit the shell command autobuild uses to run one script. | build |
26-
| `bump_colab_urls` | Rewrite Colab URLs in cwd from an old to a new date-tag. | build, deploy |
10+
From `autobuild help`. **Mode** is the Build Agent allowlist that *may* route
11+
the capability (`build.sh`); **Consumer today** is who actually drives it now.
12+
The two diverge for the workspace-run surface — see the note below.
13+
14+
| Capability | What it does | Mode | Consumer today |
15+
|------------|--------------|------|----------------|
16+
| `pre_build` | Format, regenerate notebooks, push workspaces, then dispatch `release.yml`. | release | Build Agent (release) · `/pre_build` |
17+
| `tag_and_merge` | Commit and tag every library repo for a release. | release | release path (release execution) |
18+
| `generate_release_notes` | Generate release notes from merged PRs and create GitHub Releases. | release | `release.yml` (CI) |
19+
| `create_analysis_issue` | Open a GitHub issue with the release report and assign Copilot. | release | release path — posts the Heart-run aggregate report |
20+
| `generate` | Convert a workspace's `scripts/` to `notebooks/`. | build, deploy | Build Agent (deploy) **and** Heart `workspace-validation.yml` |
21+
| `run` | Execute notebooks in a workspace folder. | build | **Heart** `workspace-validation.yml` |
22+
| `run_python` | Execute Python scripts in a workspace folder. | build | **Heart** `workspace-validation.yml` · `health_release.sh` |
23+
| `run_all` | Run scripts across one or more workspaces, produce summary reports. | build | **Heart** `health_release.sh` + readiness checks |
24+
| `script_matrix` | Output a JSON `{name, directory}` matrix for GitHub Actions. | build | **Heart** `workspace-validation.yml` (CI) |
25+
| `aggregate_results` | Aggregate per-job JSON into a release-readiness report. | build, release | **Heart** `workspace-validation.yml` (CI) |
26+
| `slow_skip_check` | Surface SLOW / NEEDS_FIX entries in workspace `no_run.yaml`. | build | `run_all.py` + Heart `test_run` check |
27+
| `repro_command` | Emit the shell command autobuild uses to run one script. | build | triage (manual handoff) |
28+
| `bump_colab_urls` | Rewrite Colab URLs in cwd from an old to a new date-tag. | build, deploy | `release.yml` (CI) + deploy |
29+
30+
**Reading the Consumer column — the run\* seam is latent, not active.** The
31+
capabilities still *exist* and match the `autobuild` dispatcher and the
32+
`build.sh` allowlists exactly; the *Mode* column remains accurate as the
33+
allowlist of record. What changed is the driver. The workspace full-run →
34+
report → issue flow moved **out of `release.yml` into PyAutoHeart's
35+
`workspace-validation.yml`** (see `PyAutoBuild/docs/internals.md` and the
36+
`release.yml` comment recording the removed `run_scripts` / `run_notebooks` /
37+
`analyze_results` jobs). Heart checks these primitives out from Build and reuses
38+
them directly — calling `run.py` / `run_python.py` / `script_matrix.py` /
39+
`aggregate_results.py`, **not** `autobuild run_*` and **not** `pyauto-brain build
40+
run_*`. Nothing invokes `run` / `run_python` / `run_all` through the Build Agent
41+
today, so their build-mode allowlist entries are a **latent seam** — kept so the
42+
Build Agent could re-own execution without churn, but **Heart is the live
43+
consumer**. This is the execution/health boundary the audit below argues for,
44+
now made visible in the table itself.
2745

2846
Underlying implementation assets the agent never re-owns: `autobuild/run_python.py`,
2947
`run.py`, `generate.py`, `script_matrix.py`, `aggregate_results.py`,

0 commit comments

Comments
 (0)