Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -423,6 +423,7 @@ recipe file tools.
(easyblocks; `eb_build_test` only with `EB_STACK_ALLOW_BUILD=1`);
- `eb_stack_solve`, `eb_stack_sbom`, `eb_stack_order`,
`eb_stack_easystack`, `eb_stack_gap`, `eb_stack_provided`,
`eb_stack_buildenv`,
`eb_stack_shadow`, `eb_stack_batch`, `eb_stack_shard`,
`eb_stack_arch`, `eb_stack_files`, `eb_stack_generation`,
`eb_stack_cuda_cc`, `eb_stack_known_failures`, `eb_stack_oom`,
Expand Down
1 change: 1 addition & 0 deletions changelog.d/+stack-buildenv.feature.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
`eb-stack stack buildenv --build-list LIST [--installed MODULES]` names every toolchain a build list builds with and whether its `buildenv/default-<toolchain>` module is installed, listed or missing, with the easyconfig that adds it. `--strict` exits 1 while one is missing, so a pipeline can require a build environment for every toolchain it ships.
5 changes: 3 additions & 2 deletions docs/orgmode/explanation/sbom-blast-radius.org
Original file line number Diff line number Diff line change
Expand Up @@ -992,7 +992,7 @@ table. ~reverse=0~ again, for the same reason as the CMakeMake run.

* The same document over MCP

The Model Context Protocol (MCP) catalog has 64 tools. ~tools/list~ prints
The Model Context Protocol (MCP) catalog has 65 tools. ~tools/list~ prints
their names:

#+begin_src bash
Expand Down Expand Up @@ -1030,6 +1030,7 @@ eb_stack_easystack
eb_package_latest
eb_stack_gap
eb_stack_provided
eb_stack_buildenv
eb_stack_shadow
eb_stack_batch
eb_stack_capacity
Expand Down Expand Up @@ -1068,7 +1069,7 @@ eb_ledger_verify_anchors
eb_ledger_project
#+end_src

That is 64 tools.
That is 65 tools.
~eb_stack_sbom~ writes the CycloneDX file ~stack sbom~ writes.
Its ~tools/list~ description reads: "Emit CycloneDX from an existing stack lock, reading dependency edges and source checksums from the easyconfigs the lock names. With backport_list, also write the modules whose reach class justifies a backport."
~eb_stack_sbom~ reads the Cbc lock:
Expand Down
13 changes: 13 additions & 0 deletions docs/orgmode/reference/cli.org
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ Package commands take the toolchain as ~--toolchain name/version~, the spelling
| ~stack sections~ | Regroup a Jenkins build list under a previous list's headers |
| ~stack from-commit~ | Report ~from-commit~ pins already contained in an EasyBuild release |
| ~stack provided~ | Fail when a build list names software a baseline already provides |
| ~stack buildenv~ | Name the toolchains of a build list that have no ~buildenv~ module |
| ~stack shadow~ | Report a site-layer recipe that shadows an EESSI base-stack module |
| ~stack arch~ | Refuse a plan an architecture cannot build, and flag entries never installed there |
| ~stack files~ | Find the patch and source files an easystack's easyconfigs need that no tree has |
Expand Down Expand Up @@ -803,6 +804,18 @@ route (~site-only.tsv~ for ~excluded~, ~bump.tsv~ for ~no-recipe~, and
~moved~ names the target EESSI version, ~site-only~ is an ~excluded~
name, and every other missing route is ~gone~ until it lands.

~stack buildenv~ reads each ~--build-list~ and collects the toolchain
of every line (~foss-2026.1~, ~iimpi-2026.1~, ~NVHPC-26.9~); system
recipes and comments are not counted. A toolchain is ~installed~ when an
~--installed~ listing (~Name/Version~ per line, a trailing ~.lua~
dropped) has ~buildenv/default-<toolchain>~, ~listed~ when a line of
the lists builds ~buildenv-default-<toolchain>.eb~, and ~missing~
otherwise, printed with the easyconfig to add. The last line is
~<missing> of <total> toolchains have no buildenv module~. ~--json~
prints the rows with the list and line where each toolchain is first
used. The exit status is 0; ~--strict~ makes a missing build
environment exit 1.

~stack provided~ reads each ~--build-list~ (a Jenkins list or one
easyconfig path per line; ~#~ comments are skipped) and fails when a
line's package name is one ~--installed~ or ~--baseline-lock~ already
Expand Down
3 changes: 2 additions & 1 deletion docs/orgmode/reference/mcp.org
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ absolute path there.

* Tools

The catalog has 64 tools. ~tools/list~ returns one tool for each CLI
The catalog has 65 tools. ~tools/list~ returns one tool for each CLI
command in the table, and the recipe and easyblock tools that have no
command. ~mcp~ publishes that catalog and has no tool of its own. Each
command's tool calls the same runner as that command. The ~text~ field
Expand All @@ -113,6 +113,7 @@ name in the schema ~tools/list~ returns. The
| ~stack order~ | ~eb_stack_order~ |
| ~stack gap~ | ~eb_stack_gap~ |
| ~stack provided~ | ~eb_stack_provided~ |
| ~stack buildenv~ | ~eb_stack_buildenv~ |
| ~stack shadow~ | ~eb_stack_shadow~ |
| ~stack batch~ | ~eb_stack_batch~ |
| ~stack shard~ | ~eb_stack_shard~ |
Expand Down
21 changes: 18 additions & 3 deletions llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6762,6 +6762,7 @@ Package commands take the toolchain as `--toolchain name/version`, the spelling
| `stack sections` | Regroup a Jenkins build list under a previous list's headers |
| `stack from-commit` | Report `from-commit` pins already contained in an EasyBuild release |
| `stack provided` | Fail when a build list names software a baseline already provides |
| `stack buildenv` | Name the toolchains of a build list that have no `buildenv` module |
| `stack shadow` | Report a site-layer recipe that shadows an EESSI base-stack module |
| `stack arch` | Refuse a plan an architecture cannot build, and flag entries never installed there |
| `stack files` | Find the patch and source files an easystack's easyconfigs need that no tree has |
Expand Down Expand Up @@ -7514,6 +7515,18 @@ route (`site-only.tsv` for `excluded`, `bump.tsv` for `no-recipe`, and
`moved` names the target EESSI version, `site-only` is an `excluded`
name, and every other missing route is `gone` until it lands.

`stack buildenv` reads each `--build-list` and collects the toolchain
of every line (`foss-2026.1`, `iimpi-2026.1`, `NVHPC-26.9`); system
recipes and comments are not counted. A toolchain is `installed` when an
`--installed` listing (`Name/Version` per line, a trailing `.lua`
dropped) has `buildenv/default-<toolchain>`, `listed` when a line of
the lists builds `buildenv-default-<toolchain>.eb`, and `missing`
otherwise, printed with the easyconfig to add. The last line is
`<missing> of <total> toolchains have no buildenv module`. `--json`
prints the rows with the list and line where each toolchain is first
used. The exit status is 0; `--strict` makes a missing build
environment exit 1.

`stack provided` reads each `--build-list` (a Jenkins list or one
easyconfig path per line; `#` comments are skipped) and fails when a
line's package name is one `--installed` or `--baseline-lock` already
Expand Down Expand Up @@ -9484,7 +9497,7 @@ absolute path there.

# Tools

The catalog has 64 tools. `tools/list` returns one tool for each CLI
The catalog has 65 tools. `tools/list` returns one tool for each CLI
command in the table, and the recipe and easyblock tools that have no
command. `mcp` publishes that catalog and has no tool of its own. Each
command's tool calls the same runner as that command. The `text` field
Expand All @@ -9509,6 +9522,7 @@ name in the schema `tools/list` returns. The
| `stack order` | `eb_stack_order` |
| `stack gap` | `eb_stack_gap` |
| `stack provided` | `eb_stack_provided` |
| `stack buildenv` | `eb_stack_buildenv` |
| `stack shadow` | `eb_stack_shadow` |
| `stack batch` | `eb_stack_batch` |
| `stack shard` | `eb_stack_shard` |
Expand Down Expand Up @@ -13722,7 +13736,7 @@ table. `reverse=0` again, for the same reason as the CMakeMake run.

# The same document over MCP

The Model Context Protocol (MCP) catalog has 64 tools. `tools/list` prints
The Model Context Protocol (MCP) catalog has 65 tools. `tools/list` prints
their names:

```bash
Expand Down Expand Up @@ -13760,6 +13774,7 @@ eb_stack_easystack
eb_package_latest
eb_stack_gap
eb_stack_provided
eb_stack_buildenv
eb_stack_shadow
eb_stack_batch
eb_stack_capacity
Expand Down Expand Up @@ -13798,7 +13813,7 @@ eb_ledger_verify_anchors
eb_ledger_project
```

That is 64 tools.
That is 65 tools.
`eb_stack_sbom` writes the CycloneDX file `stack sbom` writes.
Its `tools/list` description reads: "Emit CycloneDX from an existing stack lock, reading dependency edges and source checksums from the easyconfigs the lock names. With backport_list, also write the modules whose reach class justifies a backport."
`eb_stack_sbom` reads the Cbc lock:
Expand Down
Loading