majordomus plan delivery
Nejzazší fáze doručení každého úkolu, s objektem, který ji dokázal, a jeho deklarovaným stavem vedle
majordomus plan delivery
Použití
majordomus plan delivery [OPTIONS] [ISSUE]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| <ISSUE> | <ISSUE> | — | Jeden úkol; ve výchozím stavu každý úkol plánu |
| --at | <REV> | — | Pozorovat k tomuto commitu: jeho historie a záznamy o release stromu, nic živého (žádná branch, forge, nasazení ani hodiny) |
| --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
-
Jak daleko práce každého úkolu dospěla
Stejná odpověď, jakou vrací `GET /api/v1/plan/delivery` a nástroj MCP `majordomus_plan_delivery`: každý úkol s jeho deklarovaným stavem a nejdále prokázanou fází — none, branch, pr_open, merged, released, deployed — u každé fáze větev, pull request, merge commit, tag nebo `latest.json`, které ji prokázaly. Checkout, který forge nikdy nepozoroval, říká, že forge nebyl přečten, a úkol, který mohl postoupit dál, není uzavřen.
$ majordomus plan delivery --format jsonCo tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /observed/commit, /tallies/none, /issues/0/stage, /sources.
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í.
-
Jeden úkol k danému commitu
`--at` čte merge v historii daného commitu a release záznamy stromu a nic živého — žádnou větev, forge, nasazení ani hodiny — takže dokazuje jen sloučeno a vydáno a odpověď je funkcí samotného commitu. To je to, co `scripts/generate-site-data` zapisuje do `site/data/generated/delivery.json` a co reprodukuje pod `--check`.
$ majordomus plan delivery I0001 --at HEADCo tvrdí: skončí s kódem 0; vytiskne I0001, none, unread.
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 plan delivery --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.