majordomus prs

Integrace pull requestů: každý otevřený pull request klasifikovaný vůči aktuálnímu masteru spolu s důkazy, seřazený plán a executor, který slučuje další prokazatelně bezpečný pull request — vždy jeden, s přeplánováním po každém (ADR 0101)

majordomus prs

Použití

majordomus prs [OPTIONS] [COMMAND]

Příkazy

majordomus prs status Každý otevřený pull request s dispozicí, rizikem a důvodem, v pořadí podle ranku, z posledního zaznamenaného pozorování; exit 10, když je pozorování zastaralé nebo chybí
majordomus prs plan Co by executor udělal příště: příští sloučení, pull requesty, které potřebují vnést master, a dráhy; nic se nemění
majordomus prs explain Proč je jeden pull request tam, kde je: revize, proti kterým se rozhodovalo, každý důkaz, jeho pořadí a faktory za ním
majordomus prs refresh Pozoruje forge nyní (GitHub CLI a jeden `git fetch`) a zaznamená pozorování; jediné čtení, které sahá do sítě
majordomus prs drain Sloučí další připravený pull request, ověří, že přistál, znovu pozoruje a opakuje — nejvýše `--max` sloučení; `--dry-run` rozhoduje bez jednání
majordomus prs cleanup Zavře pull requesty, jejichž práce už je prokazatelně v masteru; bez `--apply` je jen vypíše
majordomus prs repair Zapracovat master do jednoho pojmenovaného pull requestu, jehož jediný konflikt s ním je nad odvozenými soubory (`merge=derived`). Způsobilý jen tehdy, když klasifikace říká, že je za masterem a jeho merge nekonfliktuje na žádné autorské cestě; autorský konflikt se odmítne s uvedením souborů. Ve výchozím stavu dry run, rozhodnutý offline na posledním zaznamenaném pozorování, jako `status`. S `--apply` vezme integrační lease, znovu pozoruje forge, nejprve zaznamená akt na stopu, a mergne master ve scratch worktree, odvodí, commitne a pushne fast-forward s lease na pozorovaný head; nikdy nemerguje do masteru. Exit 10 při odmítnutí nebo chybějícím pozorování, 12 když nemohl jednat
majordomus prs events Auditní stopa: každý výběr, merge, odmítnutí, zastaralé rozhodnutí a uzavření, které zaznamenal executor tohoto checkoutu
majordomus prs trains Trainy naskládaných pull requestů v pořadí přistání: dispozice každého článku, vztah k masteru, připravená hlava pod `refs/prep/<n>` (pushnutá nebo čekající) a řada. Offline a jen pro čtení, z poslední zaznamenané observace; exit 10, je-li zastaralá nebo chybí
majordomus prs brief Jeden řádek pro briefing relace: poslední fronta sestavená v tomto checkoutu (otevřené, podle lane, další merge, hladovějící), kdo drží integrační lease a zda sahá přes stroje, poslední merge a poslední obnovení, selhání nebo zastaralé rozhodnutí. Offline, nerozhoduje žádný vztah a nevypíše nic, kde forge nikdy nebylo pozorováno
majordomus prs prove-dry-run Prokáže, že nemutující cyklus nic nepohne: snapshot refů originu, otevřených pull requestů, auditní stopy, leasu a lokálních refů, spustí refresh, plan, drain --dry-run a cleanup (výpis), znovu snapshot a porovná; stažená zrcadla refreshe se musí rovnat tomu, co origin servíruje. Exit 10 s názvem toho, co se pohnulo. Nebere žádný flag: není co zapínat

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) `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

Fronta, než byl forge kdy pozorován

`prs` bez čehokoli dalšího je `prs status`. Čte poslední zaznamenané pozorování forgeu a nikdy nesahá do sítě, takže v checkoutu, kde `prs refresh` nikdy neběžel, nemá co řadit: řekne to, jmenuje příkaz, který pozoruje, a skončí kódem 10.
```
$ majordomus prs
```
Co tvrdí: exit 10.
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 prs --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.