majordomus devcontext compile

Sestaví kontext pro kus práce: každý vybraný objekt s jeho původem, důvodem a jistotou, vše vynechané s důvodem, co bylo deduplikováno a rozpočet po vrstvách; návratový kód 10, když to, co se vypustit nesmí, už rozpočet překračuje

Použití

majordomus devcontext compile [OPTIONS]

Argumenty

argument	hodnota	výchozí	popis
--issue	<ISSUE>	—	Id úkolu (`I0301`) nebo jeho kanonický identifikátor
--milestone	<MILESTONE>	—	Id nebo slug milníku, nebo jeho kanonický identifikátor
--intent	<INTENT>	—	Co se relace snaží udělat, slovy; jediný vstup, ze kterého kompilátor usuzuje
--path	<PATHS>	—	Cesta relativní k repozitáři, které se práce dotýká; opakujte pro každou
--uri	<URIS>	—	Kanonický identifikátor, ze kterého se přímo vychází; opakujte pro každý
--budget-tokens	<BUDGET_TOKENS>	—	Strop v odhadovaných tokenech
--max-depth	<MAX_DEPTH>	—	Jak daleko od výchozího bodu průchod sahá
--floor	<FLOOR>	—	Relevance, pod kterou se záznam hlásí, ale nevrací, mezi 0 a 1
--all-blocking-rules	flag	—	Každé blokující pravidlo vrstvy, nejen ta, kterých se práce dotýká
--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

Kontext, který by měla dostat relace pracující na jednom úkolu

Úkol je zárodek. Jeho milník následuje po hraně `belongs_to` složeného grafu, kód a případy pod deklarovaným rozsahem vyplývají z cest a politika a rozsah jsou governance, kterou musí dodržet každá relace. Každý vybraný řádek uvádí selektor, který k němu dospěl, a proč; vše vynechané je vypsáno s důvodem.
```
$ majordomus devcontext compile --issue I0001
```
Co tvrdí: skončí s kódem 0; vypíše SELECTED, majordomus://issue/I0001, EXCLUDED.
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í.
Totéž, jako struktura, kterou odpovídá každé jiné rozhraní

Kanonická podoba: `GET /api/v1/devcontext` a nástroj `majordomus_devcontext` vracejí tento dokument. Položky si ponechávají kanonický identifikátor, původ z indexu, každou cestu objevení s její jistotou a cenu v odhadovaných tokenech; nic se nezplošťuje do prózy.
```
$ majordomus devcontext compile --issue I0001 --format json
```
Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON s /selected/0/uri, /selected/0/discovered_by/0/reason, /budget/limit_tokens, /fingerprint.
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 devcontext compile --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.