majordomus rules report
Každé pravidlo proti důkazu, který pro ně existuje
majordomus rules report
Použití
majordomus rules report [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --state | <STATE> | — | Jen pravidla v tomto stavu důkazu (proven, inputs_unchanged, stale, gated, failing, not_run, reviewed, unrunnable, dangling, unproven) |
| --class | <CLASS> | — | Pouze pravidla této třídy (blocking, advisory) |
| --namespace | <NAMESPACE> | — | Pouze pravidla tohoto jmenného prostoru (project, majordomus) |
| --findings | flag | — | Jen pravidla, jejichž deklarovanou třídu důkaz nepodporuje |
| --check | flag | — | Kód 10, když pravidlo deklaruje třídu, kterou důkaz nepodporuje |
| --repo | <PATH> | — | Zde začne hledání kořene repozitáře (výchozí: aktuální adresář) (přijímá každý podpříkaz) |
| --discovery | vcs | filesystem | vcs | Jak se vyhledávají deklarativní soubory (přijímá každý podpříkaz)
|
| --strict | flag | — | Odmítne pokračovat, pokud kterýkoli soubor vrstvy nese diagnostiku typu chyba (přijímá každý podpříkaz) |
| --share | <DIR> | — | Adresář share distribuce nástroje (kinds.yaml, schemas/); výchozí: $MAJORDOMUS_SHARE, poté vlastní share/ repozitáře, poté ten vedle spustitelného souboru (přijímá každý podpříkaz) |
| --format | text | json | text | Tvar výstupu (přijímá každý podpříkaz)
|
Příklady
-
Každé pravidlo proti důkazu, který pro ně existuje
Stejná odpověď, jakou vrací `GET /api/v1/rules` a nástroj MCP `majordomus_rules`: u každého pravidla jeho třída, deklarovaný režim, validátor a případy, které jmenuje, zda je každý ve stromě, provedení za každým, kontroly, které je spouštějí, a věta vysvětlující, jak byl stav odvozen. Součty počítají celý korpus i když jsou pravidla filtrována a `review_only` se počítá odděleně od `passing`, aby se pravidlo, které vynucuje člověk, nikdy nepřičetlo k součtu, který se čte jako důkaz.
$ majordomus rules report --format jsonCo tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /rules, /states, /coverage/rules, /findings.
Testuje apps/majordomus-cli/tests/cli_examples.rs, který spouští příkaz nad sestaveným programem a ověřuje, co stránka uvádí.
Odkud to pochází
Deklarováno jednou v apps/majordomus-cli/src/cli.rs: clap pro strukturu, typovaná metadata v Rustu vedle něj pro příklady. Tato stránka, majordomus rules report --help, docs/generated/cli.md a docs/generated/cli.json jsou projekce této jediné deklarace.
Celá příkazová řádka na jedné stránce: stránka příkazové řádky registru. Životní cyklus úlohy (init, start, finish, doctor, ...) patří nástroji shell, jinému programu: Příkazy a jeho specifikace.