majordomus entity show
Jedna entita: její trasa, na co odkazuje, co odkazuje na ni, kde je poskytována
majordomus entity show
Použití
majordomus entity show [OPTIONS] <ADDRESS>Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| <ADDRESS> | <ADDRESS> | povinné | Entita, jako `majordomus://<kind>/<identity>` nebo jako `<kind>/<slug>` |
| --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
-
Jedna entita na své vlastní adrese
Táž odpověď, kterou vracejí `GET /api/v1/entity` a nástroj MCP `majordomus_entity` a kterou rozvrhuje i Cockpit: route entity, reference, které deklaruje, reference, které se na ni vyhodnotí — odvozené, nikdy deklarované —, povrchy, které za ni odpovídají, co lze říci o spustitelných artefaktech, které jmenuje, a její veřejná dokumentační stránka (`documentation`, zde null, protože tento fixture nemá site/data/publication.toml). Adresa jsou dva segmenty route, což je kratší zápis URI a ten, který drží adresní řádek Cockpitu.
$ majordomus entity show rule/project-alpha-1 --format jsonCo tvrdí: končí kódem 0; vypíše jeden JSON dokument nesoucí /uri, /route, /relations, /surfaces, /evidence/state.
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í.
-
Adresa, kterou vrstva neservíruje
Entita, kterou nic nedeklaruje, je not-found, ne prázdná odpověď, z důvodu, který uvádí `rules show`: překlep, který se četl jako `this entity is joined to nothing`, se nedá odlišit od nálezu, který má stránka ukazovat.
$ majordomus entity show rule/no-such-ruleCo 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 entity show --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.