Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Spustitelný soubor v Rustu nese své důkazy s sebou

Spustitelný soubor v Rustu nese své důkazy s sebou

majordomus://rule/project.rust-cli-evidence@1aktivní rusttestovánídokumentace

odkazuje na

Nic. Tento objekt nedeklaruje žádný odkaz.

Zdůvodnění

Spustitelný soubor je ta část Majordomus, se kterou mluví jiné programy, takže tvrzení o něm, které nedokazuje žádný test, a veřejná položka, kterou nikdo nedokumentoval, jsou přesně ten drift, jemuž má předcházet pravidlo no-claim-without-test shellového nástroje. Příklady v dokumentaci, které se kompilují a běží (cargo test --doc), udržují dokumentaci pravdivou tak, jako behaviorální případ udržuje pravdivé tvrzení.

Požadované chování

Pod apps/majordomus-cli/: #![warn(missing_docs)] zůstává zapnuto a clippy běží s varováními jako chybami, takže nedokumentovaná veřejná položka se v CI nesestaví; veřejné funkce, jejichž použití není zřejmé, nesou doctest; každý příkaz, volba, projekce a diagnostický kód uvedený v README.md nebo docs/CAPABILITIES.md je vyzkoušen testem pod tests/ nebo případem pod test/cases/; scripts/rust-check spouští tytéž kontroly jako CI, včetně cargo llvm-cov s prahem, který CI vynucuje, a benches/ měří cesty, které škálují s repozitářem (podmnožina YAML, objevování, index, registr, dokument OpenAPI, jeden výpis MCP).

Chování při selhání

CI selže při chybějícím dokumentu, selhávajícím doctestu, hodnotě pokrytí pod prahem nebo zastaralé generované projekci; recenzent odmítne zdokumentované chování bez testu, který ho pojmenovává.

Ověření

test/cases/77_rust_evidence.sh: zapojení, čtené z kořenů cratů, scripts/rust-check, souboru s prahy, CI workflow a justfile, které se musí shodovat na každé kontrole a jejím pořadí; s přítomným toolchainem také spustí příklady v dokumentaci, sestaví měření výkonu a přes sestavený spustitelný soubor přečte zpět politiku měření výkonu každé spustitelné schopnosti. Samotné kontroly: scripts/rust-check (just rust-check) a joby rust a coverage v .github/workflows/validate.yml. Tvrzení rust-evidence-gates, rust-coverage-floor a rust-hot-path-benchmarks v docs/CLAIMS.yaml.

Odkud to pochází

kanonický soubor
.ai/repo/rules/project/rust-cli-evidence.v1.md
identity
project.rust-cli-evidence@1
dostupné také jako
Zdroj MCP 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
v Cockpitu
/cockpit/objects/rule/project-rust-cli-evidence-1

Tato stránka je generována z výše uvedeného souboru pomocí scripts/generate-site-data; úprava stránky nic nemění, úprava souboru změní všechna rozhraní. Výše uvedené vztahy jsou hrany docs/generated/graph.json, které spustitelný program zapisuje ze stejného indexu.

Prohledává názvy a popisy všech stránek, které tento web publikuje.