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 history

Přečte zpět ledger určený jen k připojování, filtrovaný podle úlohy, události nebo času.

Přečte zpět ledger určený jen k připojování, filtrovaný podle úlohy, události nebo času.

  • jen pro čtení
  • paměť
  • aktivní úloha volitelná
  • --json

--validate hlásí poškozené řádky a končí kódem 10. --rotate archivuje staré řádky a je jediným podpříkazem, který zapisuje; nikdy nemaže a odmítá, dokud je pod limitem.

Syntaxe

majordomus history [--task <id>] [--event <name>] [--since <n>m|h|d] [--limit <n>|--all] [--json]

Ž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:doctor, watch, search, doctrine, version, knowledge, rules, bench, archive.

Čte

  • .ai/local/state/ledger.jsonl

Zapisuje

Nic. Tento příkaz je jen pro čtení.

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
  • 13 interní chyba
  • 15 odmítnuto

Zpětné čtení účetní knihy

Účetní kniha je pouze doplňovaná a je kanonickým záznamem toho, co se stalo. Slovník událostí je uzavřený, takže filtr dokáže odlišit neznámý název od názvu, který zatím nenastal.

Co tato úloha dosud udělala

název události je registrován
ano

Pro tento repozitář platí

# An active task that has already produced a checkpoint, a decision and an open question.
. "$FIXTURE_SETUP/active-task.sh"
printf 'the parser now refuses tabs\n' | "$MJ" checkpoint >/dev/null
"$MJ" decision add "refuse tabs in the parser" --why "two encodings for one token" >/dev/null
"$MJ" question add "should tabs be an error or a warning?" >/dev/null

Spustit

$ majordomus history

Výstup obsahuje

  • task.started
  • decision.recorded
  • question.opened

ukončení 0

Nejstarší první, každý řádek nese časové razítko, událost, úlohu a git head, při kterém se stala.

Filtrování podle jména, které není registrováno

název události je registrován
ne

Pro tento repozitář platí

# An active task that has already produced a checkpoint, a decision and an open question.
. "$FIXTURE_SETUP/active-task.sh"
printf 'the parser now refuses tabs\n' | "$MJ" checkpoint >/dev/null
"$MJ" decision add "refuse tabs in the parser" --why "two encodings for one token" >/dev/null
"$MJ" question add "should tabs be an error or a warning?" >/dev/null

Spustit

$ majordomus history --event task.startd

Výstup obsahuje

  • neznámá událost
  • jedno z:

ukončení 2

Odpověď "no matching events" by byla stejná odpověď, jakou dává registrovaný název, který nenastal. Filtr, který tyto dva případy nerozliší, není filtr, takže se to odmítne a vytiskne se slovník.

Reference

Přečíst knihu pouze pro připisování zpět. Pouze čtení.

Provozní rekonstrukce, ne přepis. Odpovídá, co se stalo, kdy, pro jakou úlohu, na jaké hlavě gitu a co bylo přijato — a nic o tom, co kdo řekl.

Filtry: --task <id>, --event <name>, --since <n>m|h|d nebo časové razítko ISO, --limit <n> (výchozí 20, nejnovější), --all. Výstup je od nejstaršího řádku, takže filtrovaný běh se čte jako vyprávění. --json vypíše odpovídající řádky knihy doslovně.

--validate hlásí každý řádek, který není dobře utvořenou událostí, a skončí s kódem 10, pokud nějaký je; doctor, check a watch provádějí stejný test, protože kniha, kterou nástroj neumí zpracovat, je kniha, kterou nelze použít jako důkaz.

--rotate přesune všechny řádky kromě nejnovějších ledger.retention_max_lines do ledger.<utc>.jsonl.archived a připojí událost ledger.rotated zaznamenávající, kolik se jich přesunulo. Nikdy nemaže, odmítne přepsat existující archiv a nedělá nic, když je kniha pod stropem.

$ majordomus history --task t-20260903193012-a4f1
2026-09-03T19:30:12Z  task.started         t-20260903193012-a4f1  3f2a9c1  profile=debugging scope=lib/auth
2026-09-03T19:45:00Z  task.checkpoint      t-20260903193012-a4f1  3f2a9c1  20260903T194500Z--main--3f2a9c1--8c1d0e4a2b6f9317.md
2026-09-03T19:52:31Z  decision.recorded    t-20260903193012-a4f1  3f2a9c1  Normalise the callback URI before comparing state
2026-09-03T20:14:08Z  task.finished        t-20260903193012-a4f1  b71e0c9  outcome=completed verify_exit=0

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.