Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Jedna větev, jedna worktree, na cestě odvozené z gitu

Worktree větve je tam, kde říká git, nikdy tam, kam ho někdo umístil, a špatně umístěný je diagnóza s nápravou, ne záhada.

status
stav funkce: stabilní
doména
Koordinace
na domovské stránce
zvýrazněné

Co dělá

Pro daný repozitář a název větve existuje právě jedna cesta a každý povrch ji odvozuje stejně: majordomus worktree create <branch> vytvoří větev z trunku a worktree na té cestě, worktree path ji vypíše, aby do ní shell mohl cd, worktree samo říká, kde se aktuální relace nachází a zda tam patří, a worktree migrate přivede špatně umístěný worktree domů s nedotčenými změněnými, připravenými i nesledovanými soubory. Nic cestu neregistruje: registrem je společný adresář gitu, jeho seznam worktree a jeho refy.

Pre-commit hook se ptá worktree guard a odmítne featurovou větev commitnutou z primárního checkoutu nebo z worktree, které není vlastním worktree větve. Topologie je jeden modul schopnosti, takže tatáž typovaná odpověď — každý worktree se svým stavem, každá diagnostika se svým kódem a nápravou — je na příkazové řádce, přes MCP a HTTP i na stránce worktrees v Cockpitu.

Co nedělá

Nikdy nemaže větev, nikdy nepřepíše existující cíl a nikdy nepřesouvá odpojený worktree ani pracovní checkout relace, pokud o to není požádán. Nerozhoduje, k čemu větev slouží; úkol, který větev pojmenovává, se čte z jejího názvu, pokud nějaký uvádí.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Topologie worktree worktree ověřeno chováním

Kam patří každý propojený git worktree tohoto repozitáře a kde který je. Kontejner je sourozenec primárního checkoutu pojmenovaný s `-wt`, cesta pod ním je název větve se zachovanou hierarchií a obojí se odvozuje z vlastní identity gitu — společného adresáře, registrovaných worktrees, větví — nikdy z registru, konfigurace nebo aktuálního adresáře. Worktree jinde je typovaná diagnostika s nápravou; migrace, která ji opraví, je operace příkazové řádky téže služby.

Konvergence convergence ověřeno chováním

Zda je každá jednotka práce v tomto repozitáři někde, kde ji může najít jiný worker. Holding je cokoli, co může práci držet — pracovní strom s necommitnutými soubory, větev s commity, stash — a každý nese dispozici přečtenou z gitu: integrated (trunk na něj dosáhne), published (dosáhne na něj remote-tracking ref), local_only (commitnuto na tomto disku a nikde jinde) nebo uncommitted. Poslední dvě jsou ohrožené: jsou neviditelné pro každého jiného workera a worker, který skončí, není rollback. Měří se offline, jen z tohoto checkoutu; zda pro větev existuje pull request, je otázka na forge a tady se neklade.

Kde se nachází

doména
Koordinace — Každý worker deklaruje cesty, kterých se dotkne, vidí, kdo jiný pracuje a kde, a o kolizi se dozví ještě před commitem.
oblasti práce
koordinacework-tracking
pojmenováno v
KoordinacePlánování

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

v Cockpitu, běžícího serveru
/cockpit/worktrees Worktrees

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Spustitelné případy užití

Pravidla, která jej drží

  • blokující Worktree branche je v <repo>-wt/<branch>, odvozený z gitu, nikdy neregistrovanýproject.worktree-topology
  • blokující Nic, co tento repozitář commituje, nepojmenovává cestu na stroji, kde to bylo napsánoproject.no-machine-paths

Rozhodnutí za ním

Použití

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

  • majordomus worktree status [OPTIONS]

    Kde toto volání je — větev, worktree, zda kanonický, necommitovaná práce — a kolik chyb nese celá topologie; exit 10, když je tento worktree na nesprávném místě

  • majordomus worktree topology [OPTIONS]

    Celá topologie: repozitář, kontejner, trunk, každý worktree, každá větev bez worktree, každá diagnostika; exit 10, když obsahuje chybu

  • majordomus worktree inspect [OPTIONS] <BRANCH>

    Jedna větev: její kanonická cesta, zda existuje, co cestu zabírá, worktree, který ji drží, a co stojí v cestě

  • majordomus worktree migrate [OPTIONS]

    Přenese každý špatně umístěný worktree na jeho kanonickou cestu, včetně necommitovaného stavu, s otiskem pořízeným před každým přesunem a po něm; --plan ukáže kroky a nic nezmění

  • majordomus worktree uncommitted [OPTIONS]

    Každý propojený 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á, s příkazem, který by ji dostal na vzdálený ref. Čte každý worktree a žádný nezapisuje

  • majordomus worktree trunk [OPTIONS]

    Jak daleko je tento checkout a lokální trunk od vzdáleného trunku, k poslednímu fetchi, posuzováno podle checkout.trunk_distance v politice: aktuální, zaostává, zastaralý, neposouzeno nebo neměřeno, s příkazy, které jej zaktualizují. Nic nestahuje; exit 10, když je zastaralý

  • majordomus convergence [OPTIONS]

    Drží se některá práce tohoto repozitáře tam, kde se může ztratit? Každé držení (pracovní strom s necommitnutými soubory, větev s commity, stash) s dispozicí přečtenou z gitu a jeden verdikt nad nimi

Odkud tato stránka pochází

soubor
.ai/repo/features/worktrees.md
stejná odpověď
majordomus product show worktrees
číst dál

Worktrees

Prohledává názvy a popisy všech stránek, které tento web publikuje.