majordomus worktree create

Vytvoří kanonický worktree větve. Větev, která zde neexistuje, se stáhne ze vzdáleného repozitáře trunku a převezme se, pokud ji vzdálený repozitář má; jinak se vytvoří z --base, případně z právě stažené trunk větve vzdáleného repozitáře (z lokálního trunku jen když vzdálený nelze přečíst, a pak se to uvede i s tím, o kolik zaostává). Cesta se odvodí; žádnou zadat nelze

Použití

majordomus worktree create [OPTIONS] [BRANCH]

Argumenty

argument	hodnota	výchozí	popis
<BRANCH>	<BRANCH>	—	Větev, celý název (`feature/improve-cli`)
--base	<REF>	—	Začít novou větev z tohoto refu. Nikdy se nefetchuje: musí se rozřešit lokálně
--issue	<ID>	—	Pojmenovat větev podle tohoto úkolu z .ai/repo/project/issues: `feature/<id>-<slug>`, tvaru, z něhož topologie úkol zpětně čte
--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) `vcs` — Sledované soubory přes index správy verzí (kontrakt vrstvy); vrstva, z níž není nic sledováno, se čte z pracovního stromu `filesystem` — Průchod pracovním stromem se stejnou sémantikou glob; zahrnuje nesledované soubory
--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) `text` — Řádky pro člověka `json` — Jeden dokument JSON, deterministický

Příklady

Začít práci na větvi, aniž by se rozhodovalo, kam patří

Vytvoří větev `feature/improve-cli` z trunku a checkoutuje ji do nového worktree v `<repository>-wt/feature/improve-cli`. Cesta se nezadává a nesmí se: cíl vyplývá z identity repozitáře a názvu větve, takže stejný příkaz ve stejném repozitáři vždy dá stejnou cestu — z primárního checkoutu i zevnitř jiného worktree.
```
$ majordomus worktree create feature/improve-cli
```
Co tvrdí: skončí kódem 0; vypíše -wt/feature/improve-cli, feature/improve-cli (new.
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 worktree create --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.