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.

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

argumenthodnotavý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)
  • 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

  • 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 I0001

    Co 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 json

    Co 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-git

    Co 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.

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