majordomus release analyze
Co udělal veřejný kontrakt od posledního release a nejmenší verze, kterou tento strom smí proto deklarovat
majordomus release analyze
Použití
majordomus release analyze [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --since | <REF> | — | Měřit vůči tomuto ref místo posledního release |
| --explain | flag | — | Pojmenovat každý pohyb kontraktu a důvod, proč se počítá tak, jak se počítá |
| --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 | Jak vykreslit odpověď (přijímá každý podpříkaz)
|
Příklady
-
Co smlouva udělala a nejmenší verze, kterou dovoluje
Veřejný povrch schopností tohoto stromu proti tomu, který publikoval poslední release, a nejmenší verze, kterou tento strom smí proto deklarovat. Úroveň kompatibility se měří ze smlouvy, ne z předmětů commitů: schopnost, trasa, nástroj MCP, příkaz nebo povinné pole, které volající mohl držet a už nemůže, je zásadní změnou bez ohledu na to, jak se nazval commit, který je odstranil. Stejná hodnota odpovídá na `GET /api/v1/release/analysis`, nástroji MCP `majordomus_release_analysis`, stránce Release v Cockpitu a kontrole `version-surface`. Repozitář, který nic nepublikoval, nemá základ k měření a řekne to kódem 12, místo aby hlásil prázdný diff — ten by se četl jako "nic se nezměnilo".
$ majordomus release analyze --format jsonCo tvrdí: exit 12.
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 release analyze --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.