Expand description
SRD-85 bundled-workload catalog (embedded workloads, tiers, exact-name lookup). Bundled-workload catalog — SRD-85.
Workloads embedded into the artifact, discoverable by
catalog name (cql/keyvalue, examples/lfsr). The catalog
is assembled once at process startup from the manifests each
contributing crate generates at build time (see
tools/bundle-gen): the core binary contributes the curated
workloads/ set and the examples/ tier; adapter crates
contribute their own adapters/<a>/workloads/ sets behind
their feature gates, so the catalog is truthful about what
this binary can run.
Visibility tiers separate the two audiences: everything in
the catalog is runnable by name, but only the
[Tier::Curated] entries are listed by default —
nmbrs describe workloads shows the products, not fifty test
fixtures; --all (or the examples subtopic) reveals the
rest.
Resolution policy lives with the resolver
(nmbrs-runtime::runner::resolve_workload): nearest-first —
the logical filesystem location is favored over the catalog
by default, and a name that resolves both ways picks the
local file with a LOGGED WARNING naming both candidates.
Shadowing is allowed but never silent; --strict promotes
the warning to an error.
Structs§
- Bundled
Workload - One embedded workload.
Enums§
- Tier
- Visibility tier of a bundled workload.
Functions§
- install
- Install the catalog from the contributing manifests. Called once at process startup (before any workload resolution); subsequent calls are ignored — the first installation wins, which keeps test harnesses that re-enter startup idempotent.
- iter
- All catalog entries in name order. Empty when no catalog was installed (library consumers without the nmbrs binary’s startup hook).
- iter_
tier - Entries of one tier, in name order.
- lookup
- Exact-name lookup. No globbing, no fuzzy matching —
nmbrs describe workloadsis the discovery surface, not the resolver.