majordomus completion query
Kandidáti pro jednu příkazovou řádku z grafu příkazů. Co shellový adaptér volá při každém TAB
majordomus completion query
Použití
majordomus completion query [OPTIONS] [WORD]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --surface | cli | workflow | cli | Pro který povrch jsou slova napsána
|
| --cursor | <N> | — | Index slova, ve kterém je kurzor; výchozí je nové slovo za posledním |
| --format | text | json | text | Tvar výstupu
|
| <WORD> | <WORD> | — | Slova příkazového řádku, na prvním místě vlastní jméno programu |
| --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) |
Příklady
-
Na co se shell ptá při každém TAB
Slova příkazové řádky a pozice kurzoru; zpět přicházejí kandidáti s popisy. Stejné volání obsluhuje doplňování workflow runneru s `--surface workflow`: vyřeší název receptu na příkaz, který přemosťuje, a pak doplní argumenty tohoto příkazu.
$ majordomus completion query --surface cli -- majordomus workCo tvrdí: skončí s kódem 0; vypíše worktree.
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 completion query --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.