majordomus commit plan
Co by pracovní strom commitnul: větev, upstream, rozchod, každá stagovaná, nestagovaná i nesledovaná cesta, jakýkoli probíhající merge nebo rebase a commity, které podporuje vlastní členění historie, pod otiskem, který činí plán odmítnutelným, jakmile se strom pohne
majordomus commit plan
Použití
majordomus commit plan [OPTIONS]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)
|
| --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
-
Plán s otiskem, který ho činí odmítnutelným
Otisk je repozitář, worktree, HEAD a hash přes každou změnu s její fází. Volající, který drží plán, jej porovná se stromem před sebou a dozví se, co se pohnulo — `HEAD moved from a1b2c3d4e to e4f5a6b70` — místo aby se nedozvěděl nic a commitoval cizí staged práci.
$ majordomus commit planCo tvrdí: skončí s kódem 0; vypíše fingerprint, nothing staged.
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í.
-
Tatáž odpověď v tvaru, který vracejí API a MCP
Jeden doménový model za každou projekcí: tento dokument je to, co vrací `GET /api/v1/commit/plan` a na co odpovídá nástroj `majordomus_commit_plan`, s pracovním stromem, každou skupinou s jejím zdůvodněním a otiskem.
$ majordomus commit plan --format jsonCo tvrdí: skončí kódem 0; vypíše jeden dokument JSON nesoucí /fingerprint/repository, /fingerprint/worktree, /tree/changes.
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 plan --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.