majordomus worktree

majordomus / worktree

Použití

majordomus worktree [OPTIONS] [COMMAND]

Příkazy

• majordomus worktree status Kde se toto volání nachází — větev, worktree, kanonický či ne, necommitnutá práce — a kolik chyb nese celá topologie; exit 10, když je tento worktree na nesprávném místě
• majordomus worktree list Každý registrovaný worktree s jeho stavem, jeden řádek na každý; exit 10, když topologie obsahuje chybu
• majordomus worktree topology Celá topologie: repozitář, kontejner, trunk, každý worktree, každá větev bez worktree, každá diagnostika; exit 10, má-li chybu
• majordomus worktree root Vypíše kontejner, pod který patří každý linked worktree, a nic jiného: `cd "$(majordomus worktree root)"`
• majordomus worktree path Vypíše kanonickou cestu větve a nic jiného: `cd "$(majordomus worktree path feature/x)"`. Odvozeno z názvu; větev nemusí existovat
• majordomus worktree inspect Jedna větev: její kanonická cesta, zda existuje, co cestu zaujímá, worktree, který ji drží, a co stojí v cestě
• majordomus worktree create Vytvořit kanonický worktree větve. Větev, která zde neexistuje, se fetchne z remote trunku a převezme, pokud ji remote má; jinak se vytvoří z --base, jinak z trunku remote fetchnutého teď (z lokálního trunku jen když remote nelze přečíst, a pak se to řekne, s tím, jak moc zaostává). Cesta se odvozuje; žádnou nelze zadat
• majordomus worktree ensure Kanonický worktree větve: vytvoří se, pokud chybí, vrátí se, pokud existuje, a odmítne se, pokud je větev checkoutnutá jinde
• majordomus worktree migrate Přivede každý špatně umístěný worktree na jeho kanonickou cestu, včetně špinavého stavu, s otiskem před každým přesunem a po něm; --plan ukáže kroky a nic nemění
• majordomus worktree validate Každá chyba topologie a nic jiného; exit 10, když nějaká je
• majordomus worktree doctor Každá diagnostika topologie, chyby, varování i fakta, každá s kódem a nápravou; exit 10, když je chyba
• majordomus worktree guard Smí odtud mutace pokračovat? Exit 0 v kanonickém worktree, v primárním checkoutu na trunku nebo při detached; jinak exit 10 s důvodem. Na co se ptá hook pre-commit
• majordomus worktree repair Zahodí registrace worktree v gitu, jejichž adresáře zmizely, a opraví administrativní odkazy těch, které existují. Nemaže žádný adresář
• majordomus worktree remove Odstraní jedno propojené worktree podle větve nebo cesty. Nikdy primární checkout, nikdy větev, nikdy necommitnutou práci bez --force
• majordomus worktree cleanup Větve sloučené do trunku, jejichž worktree je čisté nebo chybí: co by šlo odstranit. Bez --remove nic neodstraní
• majordomus worktree uncommitted Každý linked worktree s necommitnutou prací: kolik cest, jak stará je nejstarší změna, co ji drží (aktivní úloha, otevřená epizoda, proces uvnitř) a zda je opuštěná, spolu s příkazem, který by ji dostal na vzdálený ref. Čte každý worktree a žádný nezapisuje
• majordomus worktree trunk Jak daleko je tento checkout a lokální trunk od vzdáleného trunku podle posledního fetch, posuzováno podle checkout.trunk_distance v politice: current, lagging, stale, unjudged nebo unmeasured, spolu s příkazy, které jej aktualizují. Nic nestahuje; při stavu stale končí kódem 10
• majordomus worktree branches Každá lokální větev, jedna na řádek, pro doplňování v shellu, které chce živou množinu

Argumenty

Příklady

• Kde jsem a je to místo, kam patřím?

  `worktree` bez čehokoli dalšího odpovídá na otázku, kterou si pracovník klade před startem: která větev to je, zda je tento adresář kanonickým worktree té větve (nebo primárním checkoutem na trunku), co je zde necommitnuto a kolik chyb nese celá topologie. Stejná odpověď z primárního checkoutu i ze čtyř adresářů hluboko uvnitř propojeného worktree.

  $ majordomus worktree

  Co tvrdí: skončí s kódem 0; vypíše branch, worktree, container.

  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 --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.