majordomus commit

Commit jako hodnota: co by pracovní strom commitnul a jak se dělí, slovník rozsahů, který vyplývá z historie tohoto repozitáře, a verdikt o jedné zprávě vůči politice commitů

majordomus commit

Použití

majordomus commit [OPTIONS] [COMMAND]

Příkazy

majordomus commit plan Co by pracovní strom commitnul: větev, upstream, divergence, každá připravená, nepřipravená a nesledovaná cesta, jakékoli probíhající sloučení nebo rebase a commity, které podporuje vlastní rozdělení historie — pod otiskem, který činí plán odmítnutelným, jakmile se strom pohne
majordomus commit scopes Každý scope, který historie commitů tohoto repozitáře používá, jak často a o kterých adresářích se pod ním píše
majordomus commit history Posoudí v jednom průchodu každý commit v rozsahu historie podle politiky commitů; exit 10, když kterýkoli nese chybu
majordomus commit validate Posoudí jednu zprávu commitu proti politice commitů repozitáře; exit 10, když je nález chybou

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

Co by tento strom commitnul a proč

`commit` bez čehokoli dalšího plánuje, protože to člověk chce, když se ptá na commitování. Větev, její upstream a divergenci, co je staged a co ne, a commity, které podporuje vlastní členění historie — každý s důkazem místo tvrzení. Čistý strom to říká.
```
$ majordomus commit
```
Co tvrdí: skončí kódem 0; vypíše větev, strom, otisk.
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 commit --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.