majordomus plan drift

Každý rozpor mezi deklarovaným stavem úkolu a jeho dodáním — merged_not_recorded, active_without_work, done_without_trace — každý s důkazem; s --gate posuzováno proti oknu, které deklaruje .ai/repo/ci/plan.yaml

Použití

majordomus plan drift [OPTIONS] [ISSUE]

Argumenty

argument	hodnota	výchozí	popis
<ISSUE>	<ISSUE>	—	Jeden úkol; ve výchozím stavu každý úkol plánu
--at	<REV>	—	Pozorovat k tomuto commitu, jako to dělá `plan delivery --at`
--gate	head \| trunk	—	Posoudit jako kontrolu: na `head` je sloučená práce čekající, na `trunk` za oknem je odmítnuta (kód 10 při blokujícím vynucování); chybějící okno končí kódem 12 `head` — Hlava: sloučená práce, kterou plán nezaznamenal, je nevyřízená `trunk` — Trunk: sloučená práce nezaznamenaná za oknem je odmítnuta
--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

Kde razítka plánu odporují dodané práci

Stejná odpověď, jakou vrací `GET /api/v1/plan/drift` a nástroj MCP `majordomus_plan_drift`: každé zjištění merged_not_recorded, active_without_work a done_without_trace s pull requestem, merge commitem a release, které je dokazují, jeho stářím vůči oknu, které deklaruje `.ai/repo/ci/plan.yaml`, a příkazem, který je vyřeší.
```
$ majordomus plan drift --format json
```
Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON nesoucí /observed/commit, /window/model, /tallies/merged_not_recorded, /verdict.
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í.
K určitému commitu

`--at` čte jen historii onoho commitu a záznamy stromu, jako `plan delivery --at`, takže otevřené pull requesty se nečtou a zjištění říká, že není vyřešeno. `--gate head|trunk` posuzuje odpověď jako `scripts/ci/plan-drift-check`: na headu je sloučená práce, kterou plán nezaznamenal, čekající; na hlavní větvi ta, která byla sloučena dříve než před oknem, se odmítne s uvedením `majordomus plan verify|done <id>`, a chybějící okno odmítne s kódem 12.
```
$ majordomus plan drift --at HEAD
```
Co tvrdí: skončí s kódem 0; vypíše drift plánu, okno.
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 plan drift --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.