majordomus evidence record

Zapsat do ledgeru běh, který proběhl

Použití

majordomus evidence record [OPTIONS]

Argumenty

argument	hodnota	výchozí	popis
--suite	<SUITE>	—	TSV report runneru (`MJ_TEST_REPORT=<file> bash test/run.sh`)
--crate-output	<CRATE_OUTPUT>	—	Soubor s výstupem `cargo test` pro vlastní integrační testy crate
--origin	<ORIGIN>	—	Kde běh proběhl: local (výchozí), ci nebo release
--provenance	<[PRODUCER=]FILE>	—	Soubor, který zapsal `evidence stamp --out`; s prefixem `suite=`, `crate=` nebo `coverage=`, když soubor nejmenuje producenta a zadáno je více zpráv
--coverage	<COVERAGE>	—	Souhrn, který zapsal `scripts/rust-coverage --summary-json`
--ledger	<LEDGER>	—	repo (výchozí) nebo local
--run-record	<RUN_RECORD>	—	Zapsat záznam běhu také do tohoto souboru
--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

Zaznamenání reportu, který tam není

Recorder čte, co běh už zapsal — TSV zprávu sady, výstup `cargo test` — a opatří to provenancí, kterou běh nenesl. Zprávu, kterou nedokáže přečíst, odmítne: nezaznamenat nic by nechalo každé tvrzení ve stavu `not run` po běhu, který proběhl, což je lež v bezpečném směru, ale stále lež.
```
$ majordomus evidence record --suite target/no-such-run.tsv
```
Co tvrdí: skončí s kódem 13.
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 evidence record --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.