Skip to content

No endpoint of the Rust executable without a benchmark, and no number without evidence

No endpoint of the Rust executable without a benchmark, and no number without evidence

majordomus://rule/project.rust-benchmark-coverage@1active rustperformancetesting

it references

Nothing. This object declares no reference.

referenced by

Rationale

"Representative endpoints only" is how the slow one escapes. The benchmark projection derives every target from the same declaration that derives the endpoint, so an operation cannot exist without its measurement, and a measurement cannot outlive the operation it measured. The baseline is one reviewable file per platform and the regression policy is data, so a threshold is a decision somebody made in a commit.

Required behaviour

A capability's input type implements BenchmarkCases and produces at least one case for the repository at hand. A descriptor whose honest cases need a record the repository may not hold declares that on its policy (required_when, with a typed precondition); where the precondition is unmet and no case exists the requirement is reported inapplicable with the precondition as its reason — never counted as covered — and where it is met a missing case is missing. majordomus bench coverage reports missing 0; majordomus bench baseline update is the only way a baseline changes, from a clean tree unless --allow-dirty is said; majordomus bench --check compares a run with its platform's baseline under .ai/repo/benchmarks/rust/policy.yaml and reports every line, new targets and stale baseline entries by name.

Failure behaviour

capabilities validate exits 10 naming the missing requirement; bench coverage --check exits 10; bench --check exits 10 on a regression over the policy; CI runs both checks; a document that states a latency without pointing at evidence is refused in review.

Verification

apps/majordomus-cli/tests/{bench,bench_units}.rs, test/cases/91_canonical_architecture.sh, the rust job in .github/workflows/validate.yml.

Where this comes from

canonical file
.ai/repo/rules/project/rust-benchmark-coverage.v1.md
identity
project.rust-benchmark-coverage@1
also served as
MCP resource majordomus://rule/project.rust-benchmark-coverage@1 · majordomus entity show rule/project-rust-benchmark-coverage-1 · GET /api/v1/entity?uri=majordomus://rule/project.rust-benchmark-coverage@1
in the Cockpit
/cockpit/objects/rule/project-rust-benchmark-coverage-1

This page is generated from the file above by scripts/generate-site-data; editing the page changes nothing, editing the file changes every surface. The relations above are edges of docs/generated/graph.json, which the executable writes from the same index.

Searches the titles and descriptions of every page this site publishes.