Skip to content

The Rust executable carries its evidence with it

The Rust executable carries its evidence with it

majordomus://rule/project.rust-cli-evidence@1active rusttestingdocumentation

it references

Nothing. This object declares no reference.

Rationale

The executable is the part of Majordomus other programs talk to, so a claim about it that no test proves and a public item nobody documented are exactly the drift the shell tool's no-claim-without-test rule exists to prevent. Doc examples that compile and run (cargo test --doc) keep the documentation true the way a behavioural case keeps a claim true.

Required behaviour

Under apps/majordomus-cli/: #![warn(missing_docs)] stays on and clippy runs with warnings as errors, so an undocumented public item does not build in CI; public functions whose use is not obvious carry a doctest; every command, option, projection and diagnostic code named in README.md or docs/CAPABILITIES.md is exercised by a test under tests/ or a case under test/cases/; scripts/rust-check runs the same gates CI runs, including cargo llvm-cov with the threshold CI enforces, and benches/ measure the paths that scale with the repository (the YAML subset, discovery, the index, the registry, the OpenAPI document, one MCP listing).

Failure behaviour

CI fails on a missing doc, a failing doctest, a coverage figure under the threshold, or a stale generated projection; a reviewer refuses a documented behaviour with no test naming it.

Verification

test/cases/77_rust_evidence.sh: the wiring, read from the crate roots, scripts/rust-check, the threshold file, the CI workflow and the justfile, which must agree on every gate and its order; with a toolchain present it also runs the doc examples, builds the benchmarks and reads the benchmark policy of every executable capability back through the built executable. The gates themselves: scripts/rust-check (just rust-check), and the rust and coverage jobs in .github/workflows/validate.yml. Claims rust-evidence-gates, rust-coverage-floor and rust-hot-path-benchmarks in docs/CLAIMS.yaml.

Where this comes from

canonical file
.ai/repo/rules/project/rust-cli-evidence.v1.md
identity
project.rust-cli-evidence@1
also served as
MCP resource majordomus://rule/project.rust-cli-evidence@1 · majordomus entity show rule/project-rust-cli-evidence-1 · GET /api/v1/entity?uri=majordomus://rule/project.rust-cli-evidence@1
in the Cockpit
/cockpit/objects/rule/project-rust-cli-evidence-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.