majordomus devtask issue
Jeden úkol jako spustitelná vývojová úloha, každé pole nese, odkud pochází
majordomus devtask issue
Použití
majordomus devtask issue [OPTIONS] <ID>Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| <ID> | <ID> | povinné | Id úkolu tak, jak ho píše kanonický model. Id, které model nedeklaruje, se zodpoví, neodmítne se |
| --no-git | flag | — | Odpovědět výhradně z kanonických záznamů bez konzultace gitu — deterministická odpověď, která je na každém stroji stejná |
| --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)
|
| --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)
|
Příklady
-
Jeden úkol jako práce k vykonání, ne jako metadata
Identita, záměr, stav, milník, závislosti, blokátory, větve, commity, relace a připravenost v jedné odpovědi, složené z odvození, která už každou polovinu vlastní — plán pro graf, `trace` pro git, kanonický záznam pro vše, co napsal člověk. Nic se nevyrábí: klíč, který záznam nenese, je `unknown` s důvodem, nikdy prázdný řetězec, který by se četl jako napsaný.
$ majordomus devtask issue I0001Co tvrdí: skončí s kódem 0; vypíše readiness, explicit.
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éž, ve tvaru, v jakém odpovídají API a MCP
Jeden doménový model za každou projekcí: tento dokument vrací `GET /api/v1/devtask/issue` a odpovídá jím nástroj `majordomus_devtask`, se čtyřmi skupinami drženými od sebe typem — co napsal člověk, co plán odvozuje, co se stalo lokálně a kde stojí vnější projekce — a s původem u každého pole.
$ majordomus devtask issue I0001 --no-git --format jsonCo tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /declaration/title/provenance, /position/status/provenance, /readiness/state, /attestation/explicit.
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í.
-
Id, které model nedeklaruje, se zodpoví, neodmítne
Překlep, který se četl jako "nothing has been authored", je jediná odpověď, kterou pracovní povrch nesmí nikdy dát, a proto neznámé id odpoví s `declared: false`, připraveností `undeclared` a každým kanonickým polem `unknown` s důvodem u něj.
$ majordomus devtask issue I9999 --no-gitCo tvrdí: skončí s kódem 0; vypíše undeclared.
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 devtask issue --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.