majordomus commands

Každý příkaz, který tento repozitář nabízí, z kteréhokoli programu, který ho nabízí: graf, jeden příkaz, kam se každý promítá, a z něj odvozený most do workflow

majordomus commands

Použití

majordomus commands [OPTIONS] [COMMAND]

Příkazy

majordomus commands list Každý příkaz, jeden řádek na příkaz: co to je, co jeho spuštění mění a kde je promítnut
majordomus commands show Jeden příkaz celý: jeho argumenty, jeho účinek, co potřebuje a každá plocha, která jej nese
majordomus commands explain Proč se jeden příkaz objevuje tam, kde se objevuje: deklarace, z níž pochází, politika, která ho umístila, a důvod každého povrchu, který ho zadržuje
majordomus commands graph Celý graf jako jeden dokument, s jeho otiskem a každou diagnostikou
majordomus commands bridge Zhmotnit můstek workflow z grafu a obnovit cache, kterou čte doplňování; nic nezapisuje, když se graf nezměnil

Argumenty

argument	hodnota	výchozí	popis
--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) `vcs` — Sledované soubory přes index správy verzí (kontrakt vrstvy); vrstva, z níž není nic sledováno, se čte z pracovního stromu `filesystem` — Průchod pracovním stromem se stejnou sémantikou glob; zahrnuje nesledované soubory
--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) `text` — Řádky pro člověka `json` — Jeden dokument JSON, deterministický

Příklady

Každý příkaz, který tento repozitář nabízí

Graf příkazů složený ze tří deklarací, které už existují: strom clap tohoto spustitelného souboru, dodávaný registr příkazů shellového nástroje a recepty, které popisuje workflow runner. Jeden řádek na příkaz, s programem, který jej spouští, a tím, co jeho spuštění mění.
```
$ majordomus commands
```
Co tvrdí: skončí s kódem 0; vypíše commands, executable, read-only.
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 commands --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.