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 start

Zahájí jednu úlohu s rozsahem pod profilem a odmítne to, dokud je aktivní jiná.

Zahájí jednu úlohu s rozsahem pod profilem a odmítne to, dokud je aktivní jiná.

  • mění stav
  • úloha

Jedna aktivní úloha na checkout. Cesty rozsahu se normalizují a překryv s aktivními úlohami jiných worktree se hlásí, nikoli odmítá. --requires zaznamenává, co úloha dluží, ze slovníku v share/obligations.yaml; token, který neuvádí, se odmítne zde, a ne v okamžiku, kdy se jej pracovník pokusí splnit.

Syntaxe

majordomus start "<task>" --scope <path>[,<path>...] [--requires <token>[,<token>...]] [--profile <name>] [--owner <who>]

Životní cyklus

  1. Nastavit
  2. Začít
  3. Pracovat
  4. Ověřit
  5. Uzavřít
  6. Prozkoumat

Další příkazy v této fázi:plan, session.

Čte

  • .ai/repo/policy.yaml
  • .ai/repo/profiles/
  • .ai/local/state/current.yaml
  • share/obligations.yaml
  • git worktree list

Zapisuje

  • .ai/local/state/current.yaml
  • .ai/local/state/archive/
  • .ai/local/state/ledger.jsonl

Návratové kódy

Jen kódy, které tento příkaz může vrátit. Úplný kontrakt je na indexu příkazů.

  • 0 ok
  • 2 použití
  • 10 kontrakt nesplněn
  • 12 chybějící artefakt
  • 15 odmítnuto

Vždy jedna úloha s rozsahem

start zaznamená, co se chystáte udělat a kterých cest se smí dotknout. Rozsah je tvrzení, k jehož dodržení vás budou držet check a finish.

Zahájení úlohy

úloha už je aktivní
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 start narrow the parser --scope lib

Výstup obsahuje

  • ^started t-
  • profile=implementation
  • scope=lib

ukončení 0

Identitní pole — repozitář, větev, hlava, worktree — se počítají z gitu a nikdy se nepíší ručně. Dodáváte popis, rozsah a profil.

Zahájení druhé úlohy, když jedna je aktivní

úloha už je aktivní
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 start something else --scope lib

Výstup obsahuje

  • je aktivní

ukončení 15

Jedna aktivní úloha na checkout. Dva otevřené claimy na téže pracovní kopii nelze vynutit oba, takže druhý se odmítne a dostane řečeno, co udělat nejdřív.

Reference

Zahájit úlohu s rozsahem.

Argumenty: <task> jeden řádek. --scope <path>[,<path>...] povinné. --profile <name> výchozí z policy.profiles.default. --owner <string> volný text, výchozí $USER. --issue <id>, --intent <id> nebo --exempt <class> --because "<reason>" pojmenovávají, čemu úloha slouží.

Čte: politiku, profil, stav gitu a intents.binding přes sestavený spustitelný soubor, když se žádá o vazbu. Zapisuje: state/current.yaml a jeden řádek task.started do state/ledger.jsonl.

Behaviour:

  • Odmítne (15), pokud state/current.yaml existuje a jeho výsledek není koncový. Jedna aktivní úloha na checkout: stávající úlohu předejte (handover --close) nebo ji nejdřív dokončete. Žádný přepínač aktivní úlohu nezahodí.
  • Normalizuje každou cestu rozsahu: odstraní koncové /, kanonizuje, odmítne cesty mimo repozitář. Zaznamená normalizovanou podobu.
  • Čte každý další worktree z git worktree list a tam, kde má aktivní úlohu, hlásí každý rozsah, který tento rozsah obsahuje nebo je jím obsažen. Hlásí se, neblokuje: je to koordinační fakt pro člověka, ne pravidlo. Git je registr; žádný pomocný soubor neexistuje.
  • Zaznamenává repository_id, branch, head, working_tree z gitu. Nikdy z argumentů.
  • Ptá se, k čemu je úloha navázána (ADR 0111), když je zadáno --issue, --intent nebo --exempt, a při každém startu, když je intent.binding z politiky advisory nebo required. Odmítnutá odpověď na otázku, kterou pracovník položil, nebo jakákoli odmítnutá či nečitelná odpověď pod required odmítne (15) a nic nezapíše, přičemž pojmenuje každou příčinu a tři cesty, jak dál. Pod advisory je odmítnutí varováním. Záznam drží, co bylo pojmenováno, postavení a dvě připnutí (plan_revision, evidence_standing); nic ze samotného záměru se neukládá. Plánování má postavení a příčiny.
$ majordomus start "fix OAuth callback" --scope lib/auth --profile debugging
started t-20260903-193012-a4f1  profile=debugging  scope=lib/auth
INFO overlap  ../wt-alice-oauth-refresh claims lib/auth/oauth — contained by your scope  [reproduce: majordomus check --overlap]
next: worker reads AGENTS.md; checkpoint every 15m; majordomus check

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.

Záruky, které tento příkaz nese

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