Jen kódy, které tento příkaz může vrátit. Úplný kontrakt je na indexu příkazů.
0ok
2použití
12chybějící artefakt
Kontrola, ne zápisník
Otázka se otevře, když jste blokováni na člověku. Každá nevyřešená otázka aktivní úlohy odmítne finish --outcome completed — to je celý smysl příkazu.
Otevření otázky proti aktivní úloze
aktivní úloha
ano
Pro tento repozitář platí
# ... and an active task scoped to lib, with work done inside that scope.
. "$FIXTURE_SETUP/installed.sh"
"$MJ" start "narrow the parser" --scope lib >/dev/null
echo work >> lib/a
Spustit
$ majordomus question add should tabs be an error or a warning?
Výstup obsahuje
^opened for t-
ukončení0
Od této chvíle nelze úlohu dokončit jako completed. Lze ji dokončit jako blocked, což je poctivý výsledek, když odpověď není na vás.
Bez aktivní úlohy
aktivní úloha
ne
Pro tento repozitář platí
# A repository with Majordomus installed and projections generated, and one commit of work.
"$MJ" init >/dev/null
"$MJ" update >/dev/null
mkdir -p lib docs
echo a > lib/a
echo d > docs/d
git add . && git commit -qm base
Spustit
$ majordomus question add who owns the parser?
Výstup obsahuje
žádná aktivní úloha
ukončení12
Otázka se otevírá proti úloze. Bez ní není co blokovat a nepřipojený blokátor by už nikdo nikdy neviděl.
Reference
Otevírat, řešit a vypisovat otázky, které blokují přijetí. Jeden měnitelný index: state/open-questions.md.
Nevyřešené otázky jsou explicitní stav, ne próza uvnitř předávky, protože finish --outcome completed odmítá, dokud některý záznam pojmenovává aktivní úlohu. Tato kontrola je důvodem, proč má soubor strojově psaný formát řádků, a důvodem, proč check, doctor a watch selžou na záznamu, který se nenaparsuje: kontrola, která záznam nepřečte, je kontrola, kterou lze obejít překlepem.
question resolve <n|"<text>"> --answer "<answer>" přepíše ten jeden řádek na [resolved <date>] a připojí odpověď. n je číslo, které vypsal question list. --answer je povinný a nejednoznačný selektor se odmítne, ne hádá.
question list [--all] [--task <id>] ukáže každou nevyřešenou položku, protože každá z nich zde odmítá dokončený finish; --task zúží na to, co otevřela jedna úloha, a --all přidá vyřešené. Číslování je to, co vybírá question resolve <n>. Vyřešit lze jakoukoli nevyřešenou otázku, nejen tu, kterou otevřela aktivní úloha: kontrola, kterou nikdo nemůže odstranit, je kontrola, která se obchází.
Vyřešení upravuje index, protože index toho, co je stále otevřené, se nesmí hromadit. Záznam jen pro připojování každého otevření a vyřešení s jeho odpovědí je ledger.
$ majordomus question add "Does the legacy mobile callback still require the old URI form?"opened for t-20260903193012-a4f1: Does the legacy mobile callback still require the old URI form?$ majordomus finish --outcome completed --verify-command "mix test"FAIL blockers t-20260903193012-a4f1 — unresolved entry in open-questions.md [reproduce: majordomus question list]finish: refused, 1 unmet
Důkazy
Každý případ níže běží v CI na Linuxu i macOS. Web se odmítne sestavit, pokud veřejný příkaz nemá behaviorální případ, negativní případ nebo ukázku.