majordomus intent propose
Napsat nový, neplánovaný záměr: co se musí stát pravdou (ADR 0144)
majordomus intent propose
Použití
majordomus intent propose [OPTIONS]Argumenty
| argument | hodnota | výchozí | popis |
|---|---|---|---|
| --statement | <STATEMENT> | povinné | Co se musí stát pravdou, ponecháno doslovně |
| --title | <TITLE> | — | Jeden řádek, který ji jmenuje; první řádek tvrzení, když chybí |
| --id | <ID> | — | Identita a název souboru; bez zadání slug názvu |
| --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)
|
| --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)
|
Příklady
-
Navrhnout záměr: co se musí stát pravdou
Zapíše nový záznam pod `.ai/repo/project/intents/` obsahující prohlášení a zatím nic víc (ADR 0144): žádný milník, kritérium ani invariant. Jeho fáze se odvodí jako `declared`, `intent validate` hlásí obě absence jako varování a žádná práce mu nemůže sloužit, dokud není naplánován. `--title` a `--id` mají jako výchozí první řádek prohlášení a slug tohoto řádku; existující identita je odmítnuta, nikdy přepsána.
$ majordomus intent propose --statement 'Every page answers within 100 ms when warm'Co tvrdí: skončí s kódem 0; vypíše proposed every-page-answers-within-100-ms-when-warm, .ai/repo/project/intents/every-page-answers-within-100-ms-when-warm.yaml.
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 intent propose --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.