Příkazová řádka

majordomus

Řídicí rovina Majordomus: datově řízený MCP server nad vrstvou .ai/ repozitáře

Spustitelný soubor Majordomus v Rustu. Čte provider-neutrální AI vrstvu repozitáře pod .ai/ a zpřístupňuje ji klientům MCP přes stdio. Téměř každá schopnost je dotaz; těch několik, které cokoli mění, se deklaruje jako příkazy a vypisuje je `capabilities list --kind command`. Většina životního cyklu úlohy (init, start, check, finish, doctor, ...) je shellový nástroj bin/majordomus ve stejném repozitáři. Vývojová sémantika se po jedné sbíhá do schopností tohoto registru (ADR 0040); dokud to u některého příkazu neproběhlo, tento spustitelný soubor jej neimplementuje.

majordomus <COMMAND>

/docs/cli/ — tento příkaz na vlastní stránce

Podpříkazy: mcp, serve, capabilities, generate, bench, scope, web, why, devtask, distribution, env, commands, completion, worktree, prs, offload, convergence, commit, product, release, quality, run, executions, devcontext, guard, mesh, monitor, models, reasoning, evidence, served, rules, intent, delivery, plan, economics, entity, shell, pack, dashboard, brief, skills, knowledge, continuity.

Argumenty: žádné.

majordomus mcp

Zpřístupnit AI vrstvu repozitáře klientovi MCP přes stdio

majordomus mcp [OPTIONS]

/docs/cli/mcp/ — tento příkaz na vlastní stránce

Příklady

• Podívejte se, co by se obsluhovalo, aniž by se obsluhovalo

  Sestaví registr a index repozitáře v pracovním adresáři, vypíše repozitář, schopnosti, objekty a každou diagnostiku a skončí. Nic se neservíruje a nic se nezapisuje.

  $ majordomus mcp --inspect

  Co tvrdí: skončí s kódem 0; vypíše repository, capabilities.

  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í.

• Totéž jako jeden dokument JSON pro skript

  Tvar, který `--inspect` vypisuje pro člověka, jako JSON: repozitář, jeho režim objevování, schopnosti a diagnostiky, deterministický a bezpečný k porovnání diffem.

  $ majordomus mcp --inspect --format json

  Co tvrdí: skončí kódem 0; vypíše jeden dokument JSON nesoucí /repository/repository/root, /tools.

  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í.

• Obsluhovat jednoho klienta MCP přes stdio

  Podoba, kterou spouští klient MCP: rámce JSON-RPC na stdin, rámce ven na stdout, logy na stderr a relace končí koncem vstupu. `--standalone` nechá tento proces jen pro sebe: žádný sdílený server, žádné HTTP, nic se nikam nezapisuje.

  $ majordomus mcp --standalone

  Co tvrdí: odpovídá na initialize a tools/list na stdio a na konci vstupu skončí kódem 0.

  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í.

majordomus serve

Poskytuje tytéž schopnosti přes HTTP na loopback rozhraní, s domovskou stránkou, /openapi.json, /swagger a dokumentací pod /docs/

majordomus serve [OPTIONS] [COMMAND]

/docs/cli/serve/ — tento příkaz na vlastní stránce

Podpříkazy: status, ensure, stop.

Příklady

• Servírovat stejné schopnosti přes HTTP na volném portu

  Port 0 požádá operační systém o volný port; adresa se loguje na stderr. `/` je domovská stránka vygenerovaná z povrchů, které tento proces rozřešil; dokument na /openapi.json je tentýž, který commituje `majordomus generate`; /swagger je nad ním Swagger UI; /docs/ je dokumentace tohoto repozitáře, když byla pro tento mount sestavena.

  $ majordomus serve --port 0

  Co tvrdí: naváže port, odpovídá na GET /openapi.json, po zastavení skončí kódem 0.

  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í.

majordomus serve status

Kde stojí server tohoto checkoutu (chybí, startuje, připraven, zastaralý nebo mrtvý) a každý server repozitáře

majordomus serve status [OPTIONS]

/docs/cli/serve/status/ — tento příkaz na vlastní stránce

Příklady

• Kde stojí server tohoto checkoutu a každý server repozitáře

  Postavení serveru tohoto checkoutu měřené proti tomu, co by tento spustitelný soubor servíroval, lease, který drží, a každý checkout, který git pro repozitář eviduje, s jeho vlastním serverem. Ptá se běžícího serveru, je-li nějaký, takže odpověď zahrnuje lease, který tento proces drží; jinak se odpovídá lokálně.

  $ majordomus serve status

  Co tvrdí: skončí s kódem 0; vypíše standing.

  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í.

majordomus serve ensure

Zajistí, aby tento checkout obsluhoval připravený server: spustí ho, když žádný není nebo je lease zastaralý, počká na ten, který startuje, a ohlásí, kde stojí

majordomus serve ensure [OPTIONS]

/docs/cli/serve/ensure/ — tento příkaz na vlastní stránce

Příklady

• Zajistit, aby tento checkout obsluhoval server, a nechat ho skončit při nečinnosti

  Spustí server jako samostatný proces, když žádný neodpovídá, počká, až je připraven, a vypíše jeden řádek: stav, adresu, pid. Spuštěno znovu, najde server připravený a nespustí nic. `--idle` je doba, po kterou spuštěný server přežije svého posledního peera; tady jedna sekunda, aby příklad po sobě nic nenechal.

  $ majordomus serve ensure --idle 1 --wait 30

  Co tvrdí: skončí s kódem 0; vypíše ready.

  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í.

majordomus serve stop

Zastavit server tohoto checkoutu — ten, který jmenuje jeho lease, pokud odpovídá za tento checkout — a počkat, až jeho lease zmizí, což převzetí checkoutu jiným procesem nevrátí zpět

majordomus serve stop [OPTIONS]

/docs/cli/serve/stop/ — tento příkaz na vlastní stránce

Příklady

• Zastavit server tohoto checkoutu, pokud nějaký je

  Signalizuje serveru, který lease tohoto checkoutu jmenuje, když odpovídá za tento checkout, a čeká, až lease tohoto serveru zmizí — tu, kterou přečetl, podle jejího tokenu, takže druhý proces, který checkout ve stejném okamžiku převezme, se ohlásí a nezamění se za server, který by se nezastavil. Checkout bez lease nemá co zastavit a řekne to.

  $ majordomus serve stop

  Co tvrdí: skončí s kódem 0; netiskne nic, co by zastavilo.

  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í.

majordomus capabilities

Introspekce registru schopností: co existuje, odkud to pochází, jak je to vystaveno

majordomus capabilities [OPTIONS] <COMMAND>

/docs/cli/capabilities/ — tento příkaz na vlastní stránce

Podpříkazy: list, describe, schema, projections, validate.

majordomus capabilities list

Každá schopnost, po jednom řádku, s jejími projekcemi

majordomus capabilities list [OPTIONS]

/docs/cli/capabilities/list/ — tento příkaz na vlastní stránce

Příklady

• Na které schopnosti deleguje samotná příkazová řádka

  Jeden řádek na schopnost zpřístupněnou přes projekci `cli`, s projekcemi každé. Odpovídá na to registr; seznam schopností není napsán ve vlastní deklaraci příkazového řádku.

  $ majordomus capabilities list --exposure cli

  Co tvrdí: skončí kódem 0; vypíše capabilities.list, capabilities.describe.

  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í.

• Každá schopnost jako jeden JSON dokument

  Celý registr pro skript: každá schopnost s jejím druhem, původem a každou projekcí, kterou má.

  $ majordomus capabilities list --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /capabilities.

  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í.

majordomus capabilities describe

Jedna schopnost podle kanonického id: schémata, původ, každá projekce

majordomus capabilities describe [OPTIONS] <ID>

/docs/cli/capabilities/describe/ — tento příkaz na vlastní stránce

Příklady

• Jedna schopnost celá, podle kanonického id

  Její druh, vstupní a výstupní schémata, kde byla složena, a každá její projekce: nástroj nebo resource MCP, route HTTP, cesta CLI.

  $ majordomus capabilities describe objects.get

  Co tvrdí: skončí s kódem 0; vypíše objects.get, GET /api/v1/object.

  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í.

majordomus capabilities schema

Kanonické vstupní nebo výstupní schéma JSON jedné schopnosti

majordomus capabilities schema [OPTIONS] <ID>

/docs/cli/capabilities/schema/ — tento příkaz na vlastní stránce

Příklady

• Kanonické výstupní schéma schopnosti

  JSON Schema, ze kterého jsou odvozeny projekce MCP a OpenAPI; `--side input` vypíše schéma toho, co schopnost přijímá.

  $ majordomus capabilities schema objects.get --side output

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /title.

  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í.

majordomus capabilities projections

Kam se každá schopnost promítá a každé tvrzení, na které její povrch neodpovídá

majordomus capabilities projections [OPTIONS]

/docs/cli/capabilities/projections/ — tento příkaz na vlastní stránce

Příklady

• Každá expozice, kterou si schopnost nárokuje a jeho povrch ji nezodpovídá

  `rows: 0` je uzávěr, o který žádá `project.interfaces-are-projections`: každý deklarovaný příkaz příkazové řádky, routa a nástroj má odpověď od povrchu, který ho nese. Příkazy, které žádná schopnost nenárokuje, se hlásí vedle něj jako míra toho, kolik příkazové řádky je stále psáno ručně.

  $ majordomus capabilities projections --unmet

  Co tvrdí: skončí s kódem 0.

  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í.

• Kde se schopnosti jednoho modulu objevují

  Řádek na schopnost s příkazovou řádkou, HTTP trasou a nástrojem MCP, ke kterým vede, takže schopnost, která existuje, ale není odnikud dosažitelná, je jako taková vidět.

  $ majordomus capabilities projections --module worktree

  Co tvrdí: skončí s kódem 0; vypíše worktree.topology, majordomus worktree topology.

  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í.

majordomus capabilities validate

Sestavit registr a každou projekci; exit 10 s pojmenováním každého porušení

majordomus capabilities validate [OPTIONS]

/docs/cli/capabilities/validate/ — tento příkaz na vlastní stránce

Příklady

• Dokázat registr a každou jeho projekci

  Sestaví registr, povrchy MCP a HTTP, dokument OpenAPI, dokumentaci příkazové řádky a pokrytí měřením výkonu a pojmenuje každé selhání. Skončí kódem 10, pokud cokoli není splněno.

  $ majordomus capabilities validate

  Co tvrdí: skončí s kódem 0; vypíše validate: 0 failure(s), OK cli.

  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í.

majordomus generate

Zapíše commitnuté projekce registru (docs/generated), nebo zkontroluje, že jsou aktuální

majordomus generate [OPTIONS] [TARGET]

/docs/cli/generate/ — tento příkaz na vlastní stránce

Příklady

• Zapsat každou commitovanou projekci

  Dokument OpenAPI, reference schopností, reference příkazové řádky a její JSON, manifest registru, matice měření výkonu, seznamy povolených shellového nástroje, bootstrapy poskytovatelů a datová sada registru webu — vše z jednoho registru a jedné deklarace clap.

  $ majordomus generate

  Co tvrdí: skončí s kódem 0.

  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í.

• Odmítnout strom se zastaralými projekcemi

  Nic nezapisuje a místo toho porovnává: exit 0, když je každá commitnutá projekce tím, co vytvářejí zdroje, exit 10 s pojmenováním každého zastaralého souboru. Toto je forma, kterou spouští CI.

  $ majordomus generate
  $ majordomus generate --check

  Co tvrdí: skončí s kódem 0.

  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í.

• Jen jeden cíl

  Každý cíl lze zapsat samostatně, zatímco se změna ladí; `majordomus generate` bez cíle zapíše všechny.

  $ majordomus generate openapi

  Co tvrdí: skončí s kódem 0.

  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í.

• Zkontrolovat jeden cíl bez jeho zápisu

  `--check` se skládá s cílem: zde se s tím, co produkují zdroje, porovnává jen datová sada registru, kterou web vykresluje, a když je zastaralá, skončí kódem 10 s jejím pojmenováním.

  $ majordomus generate site
  $ majordomus generate site --check

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus bench

Měřit čas každé externě volatelné operace (každé schopnosti přímo, přes MCP a přes HTTP a vlastních operací transportů), hlásit pokrytí a porovnat s přijatým základem

majordomus bench [OPTIONS] [COMMAND] [ID]

/docs/cli/bench/ — tento příkaz na vlastní stránce

Podpříkazy: coverage, baseline.

Příklady

• Změřit čas schopností v procesu

  Rychlý profil bere málo vzorků a `--transport direct` měří exekutor bez spouštění serveru. S `--no-write` se pod .ai/local/ nezapisuje nic.

  $ majordomus bench --transport direct --profile quick --no-write --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden JSON dokument obsahující /results, /profile.

  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í.

majordomus bench coverage

Každý požadovaný cíl a zda je pokrytý; jmenovatel je generován z registru

majordomus bench coverage [OPTIONS]

/docs/cli/bench/coverage/ — tento příkaz na vlastní stránce

Příklady

• Každý povinný cíl měření a zda je pokrytý

  Jmenovatel se generuje z registru: každá spustitelná schopnost, na každém transportu, na němž je vystavena, plus vlastní operace transportů.

  $ majordomus bench coverage --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON nesoucí /lines, /tallies.

  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í.

• Selhat, když cíl chybí

  Kód 10, když je jakýkoli povinný cíl nepokrytý nebo prominutý, takže schopnost, kterou nic neměří, nelze sloučit.

  $ majordomus bench coverage --check

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus bench baseline

Přijatá základní hodnota této platformy v .ai/repo/benchmarks/rust/

majordomus bench baseline [OPTIONS] <COMMAND>

/docs/cli/bench/baseline/ — tento příkaz na vlastní stránce

Podpříkazy: update.

majordomus bench baseline update

Spustit měření výkonu a zaznamenat je jako základní hodnotu této platformy (revidovatelný, sledovaný soubor)

majordomus bench baseline update [OPTIONS]

/docs/cli/bench/baseline/update/ — tento příkaz na vlastní stránce

Příklady

• Zaznamenat přijatou základní hodnotu této platformy

  Spustí měření výkonu a zapíše výsledek do .ai/repo/benchmarks/rust/ jako sledovaný, prověřitelný soubor. Výchozí je plný profil; rychlý profil je na vyzkoušení cesty. Špinavý pracovní strom se odmítne, pokud --allow-dirty neřekne jinak.

  $ majordomus bench baseline update --profile quick --allow-dirty

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus scope

Rozsah repozitáře: co pracovník čte a co nikdy nečte; s cestami, zda je každá uvnitř, nebo vně, a proč

majordomus scope [OPTIONS] [PATHS]

/docs/cli/scope/ — tento příkaz na vlastní stránce

Příklady

• Co pracovník čte z tohoto repozitáře

  Bez cesty samotná deklarace a součet: kolik sledovaných souborů je v rozsahu a kolik mimo.

  $ majordomus scope

  Co tvrdí: skončí s kódem 0.

  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í.

• Posoudit cesty a říct, které pravidlo rozhodlo

  Pro každou cestu: uvnitř nebo vně a pravidlo, které rozhodlo. `--check` skončí s kódem 10, je-li kterákoli zadaná cesta vně, čímž hook odmítne ji číst.

  $ majordomus scope docs/CLI.md --format json

  Co tvrdí: končí kódem 0; vypíše jeden JSON dokument nesoucí /0/verdict, /0/rule.

  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í.

majordomus web

Webové povrchy repozitáře: co je vystaveno, kde je připojeno, co to vytvořilo a zda je topologie platná

majordomus web [OPTIONS] [COMMAND]

/docs/cli/web/ — tento příkaz na vlastní stránce

Podpříkazy: list, explain, validate, manifest, report, compose.

Příklady

• Topologie, z příkazu bez podpříkazu

  `web` bez čehokoli za sebou vypisuje, protože výpis je to, co člověk chce, když se ptá, co tento repozitář zpřístupňuje.

  $ majordomus web

  Co tvrdí: skončí s kódem 0; vypíše ID, MOUNT.

  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í.

majordomus web list

Každý objevený povrch: id, druh, mount, producent

majordomus web list [OPTIONS]

/docs/cli/web/list/ — tento příkaz na vlastní stránce

Příklady

• Každý webový povrch, který tento repozitář vystavuje

  Vyřešená topologie v pořadí přednosti rout: routy, které spustitelný soubor obsluhuje sám, web aplikace a každá generovaná zpráva, která se deklarovala pod generovaným webovým kořenem. Nic se nikde neregistruje; každý řádek byl objeven.

  $ majordomus web list

  Co tvrdí: skončí kódem 0; vypíše MOUNT, /api/v1, /swagger.

  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í.

majordomus web explain

Proč každý povrch existuje a odkud pochází každá jeho hodnota

majordomus web explain [OPTIONS] [ID]

/docs/cli/web/explain/ — tento příkaz na vlastní stránce

Příklady

• Proč povrch existuje a odkud pochází každá jeho hodnota

  Pro každé pole, které by mohlo čtenáře překvapit — mount, druh, adresář — zdroj, který o něm rozhodl: vlastní deklarace producenta, konfigurace webu, registr schopností, nebo zdokumentovaná výchozí hodnota modelu.

  $ majordomus web explain swagger

  Co tvrdí: skončí s kódem 0; vypíše swagger, came from.

  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í.

majordomus web validate

Zkontroluje invarianty topologie; skončí s kódem 10 při jakémkoli nálezu typu chyba

majordomus web validate [OPTIONS]

/docs/cli/web/validate/ — tento příkaz na vlastní stránce

Příklady

• Zkontrolovat topologii, než ji cokoli servíruje nebo publikuje

  Dva povrchy nárokující si jednu cestu, povrch vnořený do podstromu jiného, adresář mimo generovaný kořen nebo takový, který vychází z repozitáře: každé je pojmenovaný nález s povrchem, hodnotou, zdrojem a opravou. Kód 10 při jakémkoli nálezu úrovně error. `--artifacts` navíc vyžaduje, aby existoval adresář a index každého statického povrchu, což potřebuje obsluha i publikace.

  $ majordomus web validate

  Co tvrdí: skončí s kódem 0; vypíše no conflict.

  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í.

majordomus web manifest

Zapsat vyřešenou topologii do generovaného manifestu

majordomus web manifest [OPTIONS]

/docs/cli/web/manifest/ — tento příkaz na vlastní stránce

Příklady

• Zapsat vyřešenou topologii, aby ji mohl číst jiný nástroj

  Manifest pod generovaným webovým kořenem je odvozený stav: publisher nebo úloha CI ho může číst místo opětovného řešení topologie a nikdo ho nesmí upravovat, protože další běh ho přepíše ze stejného zjišťování.

  $ majordomus web manifest

  Co tvrdí: skončí s kódem 0; vypíše web manifest, surface.

  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í.

majordomus web report

Vykreslit vygenerovaný report do vlastního povrchu pod generovaným webovým kořenem

majordomus web report [OPTIONS] <COMMAND>

/docs/cli/web/report/ — tento příkaz na vlastní stránce

Podpříkazy: tests, benchmarks, ui, ui-snapshot, cockpit-snapshot.

majordomus web report tests

Běh testů: zpráva behaviorálních případů a vlastní součty crate

majordomus web report tests [OPTIONS]

/docs/cli/web/report/tests/ — tento příkaz na vlastní stránce

Příklady

• Vykreslit vlastní výsledky sady na povrchu /tests

  Runner zapisuje svou zprávu pomocí `MJ_TEST_REPORT=<file> bash test/run.sh`; toto ji vykreslí, ponechá strojově čitelné výsledky vedle stránky a deklaruje adresář, aby ho objevení našlo. Bez toho souboru není co vykreslit a příkaz to říká, místo aby publikoval prázdnou stránku.

  $ majordomus web report tests --suite target/web/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í.

majordomus web report benchmarks

Běh měření: dokument s výsledky, nebo přijatá základní hodnota

majordomus web report benchmarks [OPTIONS]

/docs/cli/web/report/benchmarks/ — tento příkaz na vlastní stránce

Příklady

• Vykreslit běh měření výkonu na povrch /benchmarks

  Čte dokument s výsledky — vlastní výstup běhu, nebo přijatou základní hodnotu v sekci měření výkonu vrstvy, které mají stejný tvar — a vykreslí každý změřený cíl seřazený podle mediánu. Sám nic neměří: číslo na stránce je číslo, které vytvořil běh.

  $ majordomus web report benchmarks --from .ai/repo/benchmarks/rust/baseline.macos-aarch64-debug.json

  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í.

majordomus web report ui

Audit shody UI, vykreslený jako sekce testovacího povrchu (/tests/ui)

majordomus web report ui [OPTIONS]

/docs/cli/web/report/ui/ — tento příkaz na vlastní stránce

Příklady

• Vykreslit audit shody UI do /tests/ui

  `scripts/ui audit` projede prohlížečem každou stránku sestaveného webu při každé šířce, kterou implikují breakpointy zkompilované stylopisu, a zapíše jeden dokument s výsledky; toto jej vykreslí. Vykreslení je sekce testovacího povrchu, a ne povrch sám o sobě, protože běh konformity je testovací běh a topologie odmítá povrch připojený uvnitř podstromu jiného. Bez toho dokumentu není co vykreslit a příkaz to říká.

  $ majordomus web report ui --from target/web/run-ui.json

  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í.

majordomus web report ui-snapshot

Samotné UI, jednou přečtené při tomto commitu a zapsané jako statické stránky, které publikace nese na /ui (ADR 0141)

majordomus web report ui-snapshot [OPTIONS]

/docs/cli/web/report/ui-snapshot/ — tento příkaz na vlastní stránce

Příklady

• Přečíst UI jednou a zapsat ho jako stránky, které publikace nese na /ui

  Zeptá se UI v procesu na každou obrazovku a panel a pak, vždy po jedné stránce z každé rodiny, dokud se nedosáhne `--limit` stránek nebo `--budget-seconds`, na stránky, na které odkazují, a každou zapíše jako soubor pod target/web/ui-snapshot: odkazy mezi nimi jsou relativní, odkaz, na který odpovídá jen běžící proces, vede na stránku snímku o živém UI, skriptu je řečeno, aby se znovu nečetl, a každá stránka je opatřena commitem, časem a spustitelným souborem, který ji přečetl. Deklarace vedle něj činí z adresáře povrch každé publikace a žádného procesu.

  $ majordomus web report ui-snapshot --limit 20

  Co tvrdí: skončí s kódem 0; vypíše web report, ui-snapshot.

  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í.

majordomus web report cockpit-snapshot

Samotný Cockpit, jednou přečtený v tomto commitu a zapsaný jako statické stránky, které publikace nese na /cockpit (ADR 0147)

majordomus web report cockpit-snapshot [OPTIONS]

/docs/cli/web/report/cockpit-snapshot/ — tento příkaz na vlastní stránce

Příklady

• Přečíst Cockpit jednou a zapsat ho jako stránky, které publikace nese na /cockpit

  Zeptá se Cockpitu v procesu na každou statickou trasu kromě jediné stránky o tomto stroji, pak na stránky, na které odkazuje snímek UI, pak, vždy po jedné stránce z každé rodiny, dokud se nedosáhne `--limit` stránek nebo `--budget-seconds`, na stránky, na které ty odkazují, a každou zapíše jako soubor pod target/web/cockpit-snapshot. Odkazy mezi nimi jsou relativní; odkaz do UI vede na snímek UI, když ten stránku drží; formulář, dotaz nebo stránka za mezí vedou na stránku snímku o živém Cockpitu; žádná stránka nenese skript, protože skripty Cockpitu mluví s procesem; a každá stránka je opatřena commitem, časem a spustitelným souborem, který ji přečetl.

  $ majordomus web report cockpit-snapshot --limit 12

  Co tvrdí: skončí s kódem 0; vypíše web report, cockpit-snapshot.

  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í.

majordomus web compose

Složí každý publikovaný povrch do jednoho publikovatelného stromu

majordomus web compose [OPTIONS]

/docs/cli/web/compose/ — tento příkaz na vlastní stránce

Příklady

• Složí každý publikovaný povrch do jednoho publikovatelného stromu

  Každý producent vlastní svůj výstupní adresář; publikace potřebuje jeden strom a mapování je rozřešený mount a nic jiného. Objevený povrch se publikuje bez kopírovacího kroku napsaného kdekoli, a repozitář, v němž zatím nic nebylo vygenerováno, složí prázdný strom místo chyby. Kde povrch existuje a jeho adresář ne, skládání odmítne a pojmenuje producenta, který je třeba spustit.

  $ majordomus web compose --destination target/site

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus why

Provozní okamžiky, na které tento nástroj odpovídá: katalog, jeden okamžik, publika a oblasti, diagnóza vašeho vlastního týdne a validace samotného katalogu

majordomus why [OPTIONS] [COMMAND]

/docs/cli/why/ — tento příkaz na vlastní stránce

Podpříkazy: list, show, audiences, areas, diagnose, validate.

Příklady

• Provozní momenty, které tento repozitář drží

  `why` bez čehokoli za sebou vypíše seznam, protože výpis je to, co člověk chce, když se ptá, co tato sekce je. Počet na posledním řádku se počítá z katalogu; žádné číslo není nikde napsáno natvrdo.

  $ majordomus why

  Co tvrdí: skončí s kódem 0; vypíše SLUG, moment(s).

  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í.

majordomus why list

Každý provozní moment, zúžený libovolnou fasetou, kterou katalog hlásí

majordomus why list [OPTIONS]

/docs/cli/why/list/ — tento příkaz na vlastní stránce

Příklady

• Každý veřejný okamžik v pořadí prezentace

  Koncepty se vynechávají, pokud není zadáno `--all`. Fasety, podle nichž lze výpis zúžit, jsou ty, které hlásí samotný katalog, takže publikum nebo oblast přidané jako soubor je filtrem, aniž by se cokoli registrovalo.

  $ majordomus why list

  Co tvrdí: skončí s kódem 0; vypíše SLUG.

  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í.

• Jen to, co pozná jedno publikum

  Členství deklaruje každý moment a nikdy se neuvádí v souboru samotného publika, takže tato odpověď je odvozená. Publikum, které katalog nemá, je neplatný vstup, který jmenuje ta, která má, nikoli prázdná odpověď.

  $ majordomus why list --audience fixture-team

  Co tvrdí: skončí s kódem 0; vypíše SLUG.

  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í.

• Totéž, ve tvaru, v jakém odpovídají API a MCP

  Jeden doménový model za každou projekcí: tento dokument je to, co vrací `GET /api/v1/why` a na co odpovídá nástroj `majordomus_why`, včetně odvozených fasetů a otisku katalogu.

  $ majordomus why list --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /counts/moments, /facets/audiences, /fingerprint.

  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í.

majordomus why show

Jeden okamžik celý, s každou relací odvozenou z jeho metadat

majordomus why show [OPTIONS] <ID>

/docs/cli/why/show/ — tento příkaz na vlastní stránce

Příklady

• Jeden okamžik se všemi vztahy odvozenými z jeho metadat

  Záznam tak, jak ho deklaruje jeho soubor, a pak to, co nikdo nenapsal: odpovědnosti, do kterých patří jeho tvrzení, momenty, které ho jmenují, a momenty jemu nejbližší podle sdílené oblasti, publika a štítku.

  $ majordomus why show fixture-moment

  Co tvrdí: skončí s kódem 0; vypíše fixture-moment, derived.

  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í.

majordomus why audiences

Každé publikum s momenty, které ho jmenují

majordomus why audiences [OPTIONS]

/docs/cli/why/audiences/ — tento příkaz na vlastní stránce

Příklady

• Kdo co rozpoznává, s odvozenými počty

  Každé publikum s počtem veřejných momentů, které je jmenují. Číslo se počítá z momentů; vlastní soubor publika žádné neuvádí.

  $ majordomus why audiences

  Co tvrdí: skončí s kódem 0; vypíše SLUG, TITLE.

  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í.

majordomus why areas

Každá provozní oblast s momenty, které pod ni spadají

majordomus why areas [OPTIONS]

/docs/cli/why/areas/ — tento příkaz na vlastní stránce

Příklady

• Provozní oblasti s odvozenými počty

  Tentýž vztah čtený opačně: každá oblast s veřejnými okamžiky, které pod ni spadají.

  $ majordomus why areas

  Co tvrdí: skončí s kódem 0; vypíše SLUG, TITLE.

  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í.

majordomus why diagnose

Co z příznaků, které poznáváte, plyne: oblasti, k nimž se přiklánějí, a mechanismy, které na ně odpovídají

majordomus why diagnose [OPTIONS]

/docs/cli/why/diagnose/ — tento příkaz na vlastní stránce

Příklady

• Dotazník sestavený z vlastních signálů katalogu

  Bez výběru není co diagnostikovat, takže se místo prázdné odpovědi vypíší otázky. Každý řádek je signál, který moment deklaruje; nic zde není seznam otázek.

  $ majordomus why diagnose

  Co tvrdí: skončí s kódem 0; vypíše Which of these happened to you this week?.

  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í.

• Co znamenají příznaky, které poznáváte

  Jméno je id signálu nebo id momentu. Odpovědí je počítání, ne odhad: každé doporučení nese momenty, které jej vyvolaly, a není tu žádné procento, protože za ním není žádný model.

  $ majordomus why diagnose --signal fixture-signal

  Co tvrdí: skončí s kódem 0; vypíše moment(s) matched, fixture-moment.

  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í.

majordomus why validate

Každé zjištění nad katalogem; návratový kód 10, pokud je některé z nich chyba

majordomus why validate [OPTIONS]

/docs/cli/why/validate/ — tento příkaz na vlastní stránce

Příklady

• Zkontrolovat katalog dřív, než ho cokoli promítne

  Reference, která se nerozřeší na nic, s nejbližším kandidátem; duplicitní identita; název souboru, který si odporuje s jeho id; veřejný záznam, který nesplňuje laťku, kterou jeho stav slibuje. Při jakékoli chybě kód 10.

  $ majordomus why validate

  Co tvrdí: skončí kódem 0; vypíše moment(s), valid.

  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í.

majordomus devtask

Jeden úkol nebo jeden milník jako spustitelný vývojový rozsah: co bylo napsáno, kam jej staví graf plánu, co se s ním stalo, zda jej worker smí začít — s původem každé hodnoty přímo u hodnoty

majordomus devtask [OPTIONS] <COMMAND>

/docs/cli/devtask/ — tento příkaz na vlastní stránce

Podpříkazy: issue, milestone.

majordomus devtask issue

Jeden úkol jako spustitelná vývojová úloha, každé pole nese, odkud pochází

majordomus devtask issue [OPTIONS] <ID>

/docs/cli/devtask/issue/ — tento příkaz na vlastní stránce

Příklady

• Jeden úkol jako práce k vykonání, ne jako metadata

  Identita, záměr, stav, milník, závislosti, blokátory, větve, commity, relace a připravenost v jedné odpovědi, složené z odvození, která už každou polovinu vlastní — plán pro graf, `trace` pro git, kanonický záznam pro vše, co napsal člověk. Nic se nevyrábí: klíč, který záznam nenese, je `unknown` s důvodem, nikdy prázdný řetězec, který by se četl jako napsaný.

  $ majordomus devtask issue I0001

  Co tvrdí: skončí s kódem 0; vypíše readiness, explicit.

  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í.

• Totéž, ve tvaru, v jakém odpovídají API a MCP

  Jeden doménový model za každou projekcí: tento dokument vrací `GET /api/v1/devtask/issue` a odpovídá jím nástroj `majordomus_devtask`, se čtyřmi skupinami drženými od sebe typem — co napsal člověk, co plán odvozuje, co se stalo lokálně a kde stojí vnější projekce — a s původem u každého pole.

  $ majordomus devtask issue I0001 --no-git --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /declaration/title/provenance, /position/status/provenance, /readiness/state, /attestation/explicit.

  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í.

• Id, které model nedeklaruje, se zodpoví, neodmítne

  Překlep, který se četl jako "nothing has been authored", je jediná odpověď, kterou pracovní povrch nesmí nikdy dát, a proto neznámé id odpoví s `declared: false`, připraveností `undeclared` a každým kanonickým polem `unknown` s důvodem u něj.

  $ majordomus devtask issue I9999 --no-git

  Co tvrdí: skončí s kódem 0; vypíše undeclared.

  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í.

majordomus devtask milestone

Jeden milník jako proveditelný graf závislostí: připravené, blokované, paralelizovatelné, kritické blokátory, cykly

majordomus devtask milestone [OPTIONS] <ID>

/docs/cli/devtask/milestone/ — tento příkaz na vlastní stránce

Příklady

• Na čem pracovat dál v jednom výsledku a co odblokovat jako první

  Úkoly rozdělené podle připravenosti, kritické blokátory seřazené podle toho, kolik nedokončené práce každý zdržuje, a spustitelná práce rozdělená do podmnožin, které mohou skutečně běžet současně. Čistá funkce kanonických záznamů — bez gitu, bez hodin, bez sítě — takže dva běhy na dvou strojích dají stejné bajty a čtenář si nic neodvozuje sám.

  $ majordomus devtask milestone foundation

  Co tvrdí: skončí s kódem 0; vypíše READINESS.

  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í.

• Graf ve tvaru, v jakém odpovídají API a MCP

  Každé rozdělení, které plán implikuje a žádný povrch by je neměl přepočítávat: `ready`, `blocked`, `waiting`, `active`, `review`, `completion_blocked`, `complete`, `cancelled`, dále `critical_blockers`, `parallelizable` s cestou rozsahu za každou serializací a `cycles` jako silně souvislé komponenty.

  $ majordomus devtask milestone foundation --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /counts/total, /ready, /critical_blockers, /parallelizable.

  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í.

majordomus distribution

Jak je tento projekt balen, publikován a instalován: platformy, názvy artefaktů, instalátor, releasy

majordomus distribution [OPTIONS] [COMMAND]

/docs/cli/distribution/ — tento příkaz na vlastní stránce

Podpříkazy: show, status, validate, targets, matrix, artifact, releases, metadata, build.

Příklady

• Jak je tento projekt nainstalován

  `distribution` bez čehokoli dalšího ukáže model: jednořádkový instalační příkaz, kam instalace jde a pro kolik platforem release staví. Každá hodnota pochází ze share/distribution.yaml, což je jediné místo, kde je kterákoli z nich zapsána.

  $ majordomus distribution

  Co tvrdí: skončí s kódem 0; vypíše binary, install, targets.

  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í.

majordomus distribution show

Model: příkaz instalace, kam instalace míří a každý deklarovaný cíl

majordomus distribution show [OPTIONS]

/docs/cli/distribution/show/ — tento příkaz na vlastní stránce

Příklady

• Model distribuce jako jeden dokument JSON

  Tatáž odpověď jako dokument, který skript přečte: instalační příkaz, výchozí umístění a každý deklarovaný cíl s názvem artefaktu, který pro něj odvozuje funkce pojmenování. Toto vykresluje instalační blok webu a instalační karta cockpitu.

  $ majordomus distribution show --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON nesoucí /install_command, /targets.

  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í.

majordomus distribution status

Zda inzerovaná jednořádková instalace právě teď funguje a co chybí, když nefunguje

majordomus distribution status [OPTIONS]

/docs/cli/distribution/status/ — tento příkaz na vlastní stránce

Příklady

• Zda publikovaná jednořádková instalace právě teď funguje

  Otázka operátora — *může stroj, který tento projekt nikdy neviděl, nainstalovat jej inzerovaným příkazem?* — zodpovězená z distribučního modelu a záznamů release, bez dotyku sítě. Každá kontrola pojmenovává, co bylo pozorováno; selhávající pojmenovává svou příčinu a příkaz, který ji změní. Ukázáno v repozitáři, který nic nepublikoval, kde je odpověď ne a kód ukončení 10, díky čemuž je použitelný jako kontrola, ne jako próza. `distribution validate` je kontrola nad samotným modelem; tato je kontrolou nad stavem, s nímž se uživatel setkává.

  $ majordomus distribution status

  Co tvrdí: exit 10.

  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í.

majordomus distribution validate

Každá invariantní vlastnost modelu a záznamů o release; exit 10 s pojmenováním každého porušení

majordomus distribution validate [OPTIONS]

/docs/cli/distribution/validate/ — tento příkaz na vlastní stránce

Příklady

• Každý invariant modelu a záznamů o release

  Odmítne duplicitní id nebo triple cíle, dva cíle odvozující jeden název artefaktu, cíl pro Linux bez knihovny C, publikovaný cíl bez čeho jej sestavit, nesestavený cíl bez zaznamenaného důvodu, základní URL, které není HTTPS, a záznam o release, který chybí podporovaný cíl, přejmenuje artefakt nebo jej obslouží z jiného hostitele. Skončí s kódem 10 a pojmenuje každé porušení.

  $ majordomus distribution validate

  Co tvrdí: skončí kódem 0; vypíše distribuci.

  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í.

majordomus distribution targets

Každý deklarovaný cíl, jeden řádek na cíl, s názvem artefaktu, který z něj plyne

majordomus distribution targets [OPTIONS]

/docs/cli/distribution/targets/ — tento příkaz na vlastní stránce

Příklady

• Každá platforma a zda ji release buildí

  Jeden řádek na deklarovaný cíl: jeho id, jeho Rust target triple, zda je podporovaný, experimentální nebo nedostupný, a jak se píše v textu. Tabulka podporovaných platforem v dokumentaci i vlastní odmítavá zpráva instalátoru se vykreslují z týchž řádků.

  $ majordomus distribution targets

  Co tvrdí: skončí s kódem 0; vypíše RUST TARGET, supported.

  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í.

majordomus distribution matrix

Matice sestavení release tak, jak ji čte release workflow

majordomus distribution matrix [OPTIONS]

/docs/cli/distribution/matrix/ — tento příkaz na vlastní stránce

Příklady

• Matice sestavení releasu, kterou workflow spouští

  Jedna položka na publikovaný cíl, s runnerem, na němž se staví, balíčky, které runner potřebuje, a názvem artefaktu s `{tag}` tam, kam patří tag releasu. Workflow releasu to čte a neuvádí žádnou vlastní platformu; přidání cíle do modelu přidá build zde a nikde jinde.

  $ majordomus distribution matrix

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON s /include, /binary.

  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í.

majordomus distribution artifact

Název archivu a kořenový adresář, které odvozuje cíl a tag

majordomus distribution artifact [OPTIONS]

/docs/cli/distribution/artifact/ — tento příkaz na vlastní stránce

Příklady

• Jak se jmenuje jeden cíl a jeden tag

  Jediná pojmenovávací funkce, zeptaná přímo: název archivu, adresář, do kterého se rozbalí, a kam ho release publikuje. `scripts/release-package` se ptá na toto, místo aby název skládal sám, takže změna pojmenovávací funkce se do balení promítne bez úpravy.

  $ majordomus distribution artifact --target aarch64-apple-darwin --tag v0.2.0 --format json

  Co tvrdí: skončí kódem 0; vypíše jeden dokument JSON nesoucí /name, /root, /url.

  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í.

majordomus distribution releases

Každý zaznamenaný release, nejnovější první, a ten, na který se rozliší nepřipnutá instalace

majordomus distribution releases [OPTIONS]

/docs/cli/distribution/releases/ — tento příkaz na vlastní stránce

Příklady

• Co bylo publikováno a na co se přeloží nepřipnutá instalace

  Každý záznam releasu, který tento repozitář drží, od nejnovějšího, a který z nich jmenuje stabilní ukazatel: nejvyšší verzi mezi stabilními, nestaženými záznamy. Ukazatel se odvozuje při každém čtení a nikde se neautoruje.

  $ majordomus distribution releases

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus distribution metadata

Veřejná metadata, která publikuje jeden záznam o release, vykreslená výhradně ze samotného záznamu

majordomus distribution metadata [OPTIONS]

/docs/cli/distribution/metadata/ — tento příkaz na vlastní stránce

Příklady

• Co publikuje jeden záznam release

  Veřejná metadata, na která se záznam promění, vykreslená pouze ze záznamu a modelu: release pipeline je vypíše dřív, než cokoli commitne, a testy instalátoru je servírují jako release, který nikdy neexistoval. Zde ukázáno v repozitáři, který nic nepublikoval, kde záznam neexistuje a příkaz řekne, který soubor chtěl, a skončí kódem 10 místo vymýšlení.

  $ majordomus distribution metadata --record .ai/repo/releases/v0.2.0.yaml

  Co tvrdí: exit 10.

  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í.

majordomus distribution build

Čím tento spustitelný soubor je: verze, target triple, profil, commit

majordomus distribution build [OPTIONS]

/docs/cli/distribution/build/ — tento příkaz na vlastní stránce

Příklady

• Čím tento spustitelný soubor je

  Verze crate, cílový triple Rustu, profil a commit, vše zakompilované při sestavení. Nainstalovaná binárka na to odpoví bez repozitáře, toolchainu nebo gitu, a právě proto lze zodpovědět dotaz na podporu.

  $ majordomus distribution build

  Co tvrdí: skončí s kódem 0; vypíše version, target, commit.

  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í.

majordomus env

Čím tento checkout je: projekt, správa verzí, toolchainy, které deklaruje, co vrstva obsahuje, workflow, projekce providerů a lokální služby

majordomus env [OPTIONS] [COMMAND]

/docs/cli/env/ — tento příkaz na vlastní stránce

Podpříkazy: status, banner, export, enter, explain, preflight.

Příklady

• Co tento checkout je

  `env` bez čehokoli dalšího vyřeší celý snímek: projekt a jeho verzi, repozitář a jeho vrstvu, správu verzí, toolchainy, které repozitář deklaruje, co vrstva drží spočítané podle druhu, pracovní postupy, které runner popisuje, projekce poskytovatelů proti politice, která je vykresluje, a lokální služby. Toto je řešení, které vrstvu počítá, takže staví index a zapisuje cache, kterou čte banner.

  $ majordomus env

  Co tvrdí: skončí kódem 0; vypíše project, repository, resolution.

  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í.

majordomus env status

Celý snímek, vyřešený v plném rozsahu: spočítá se, co vrstva obsahuje, a zapíše se cache, kterou čte banner

majordomus env status [OPTIONS]

/docs/cli/env/status/ — tento příkaz na vlastní stránce

Příklady

• Snímek jako jeden dokument

  Tatáž hodnota, kterou odpovídá HTTP trasa `/api/v1/environment` a zdroj MCP `majordomus://environment` a kterou vykresluje banner. Každé pole nese, odkud pochází, pod `provenance`, a hodnota, kterou nic nedokázalo vyřešit, chybí, místo aby byla nulová.

  $ majordomus env status --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON nesoucí /schema, /project/version, /repository/name, /provenance.

  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í.

majordomus env banner

Vykreslit snímek pro terminál. Jde na standardní chybový výstup, nikdy na standardní výstup, protože direnv čte standardní výstup jako prostředí, které nastavuje

majordomus env banner [OPTIONS]

/docs/cli/env/banner/ — tento příkaz na vlastní stránce

Příklady

• Dvouřádková forma, v šířce, kterou zvolíte

  Co `direnv` vykreslí při vstupu do repozitáře. Rozhoduje se rychle — nikdy nesestavuje index — a píše na standardní chybový výstup, protože direnv čte standardní výstup `.envrc` jako prostředí, které aplikuje. `--width` vykreslí, jako by terminál byl tak široký, a právě to činí rozvržení testovatelným.

  $ majordomus env banner --mode compact --width 80

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus env export

Přiřazení proměnných, z nichž má shell v tomto repozitáři užitek, pro `eval`. Pouze přiřazení: žádný příkaz, žádný vedlejší efekt

majordomus env export [OPTIONS]

/docs/cli/env/export/ — tento příkaz na vlastní stránce

Příklady

• Přiřazení, která shell v tomto repozitáři chce

  Přiřazení a nic jiného, bezpečné pro `eval`: žádný příkaz se nespustí, žádný soubor se nedotkne a každá hodnota je uvozena, takže cesta repozitáře obsahující uvozovku nebo `$(...)` se nemůže stát shellovým kódem. To je celé, co `.envrc` od Majordomus potřebuje.

  $ majordomus env export --shell direnv

  Co tvrdí: skončí s kódem 0; vypíše export MAJORDOMUS_ROOT=.

  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í.

majordomus env enter

Vstoupit do repozitáře: přiřazení, ze kterých má shell zde prospěch, na standardní výstup, banner na standardní chybový výstup, workflow bridge obnovený, když se pohnula deklarace za ním, a zajištěný runtime — celý obsah vstupu do tohoto repozitáře jako jedno volání, aby si žádný člověk ani agent nemusel pamatovat posloupnost. Nikdy nebuilduje, nikdy nesahá na vzdálenou síť a nikdy nečeká, až odpoví server, který sám spustil

majordomus env enter [OPTIONS]

/docs/cli/env/enter/ — tento příkaz na vlastní stránce

Příklady

• Vše, co do tohoto repozitáře vstupuje, je jedním voláním

  Co spouští soubor, který shell vyhodnocuje při vstupu, a jediné volání, které provádí (ADR 0043): přiřazení na standardním výstupu pro `eval`, banner na standardní chybě, obnovený bridge workflow, když se pohnula deklarace za ním, a zajištěný sdílený server repozitáře, když tento checkout nic neobsluhuje. Nikdy nesestavuje, nikdy nezajišťuje ze spustitelného souboru staršího než jeho zdroje, nikdy nečeká, až server, který spustil, odpoví, a nikdy nekončí nenulově — nenulový kód by zde způsobil, že direnv ohlásí selhání celého prostředí. `--no-runtime` je to, co tento příklad předává, protože příklad není místo, kde se spouští server.

  $ majordomus env enter --shell direnv --no-banner --no-bridge --no-runtime

  Co tvrdí: skončí s kódem 0; vypíše export MAJORDOMUS_ROOT=.

  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í.

majordomus env explain

Odkud každá hodnota pochází: soubor, příkaz nebo konstanta, která ji určila, resolver, který ji přečetl, a jak moc jí lze věřit

majordomus env explain [OPTIONS] [FIELD]

/docs/cli/env/explain/ — tento příkaz na vlastní stránce

Příklady

• Odkud pochází jedna hodnota

  Odvozený systém bez provenience je magie. Každé pole snapshotu může jmenovat soubor, příkaz nebo konstantu doby kompilace, které o něm rozhodly, resolver, který je přečetl, a zda bylo přečteno nyní, vzato z cache, nebo vůbec nerozřešeno.

  $ majordomus env explain project.version

  Co tvrdí: skončí s kódem 0; vypíše project.version, source, resolver.

  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í.

majordomus env preflight

Zda je Majordomus v tomto checkoutu v platnosti, tvrzení po tvrzení, s důkazy za každým verdiktem: git, epizoda a její briefing, úloha a předávka, politika, pravidla a ADR, sdílený server a povrchy, které servíruje, nástěnka peerů, zaznamenané testovací běhy, vynucování pravidel, projekce providerů a nasazení. Verdikt, který tvrdí, že něco platí, vždy uvádí své důkazy. Odpovídá rychle, z celkového součtu pravidel, který uložil běh s `--full`; HTTP trasa `/api/v1/environment/preflight` a nástroj MCP `majordomus_preflight` odpovídají stejnou hodnotou

majordomus env preflight [OPTIONS]

/docs/cli/env/preflight/ — tento příkaz na vlastní stránce

Příklady

• Co zde platí a co to dokazuje

  Jeden verdikt na tvrzení — `verified`, `active`, `fresh`, `stale`, `degraded`, `unavailable`, `failed`, `unknown` nebo `not_applicable` — a důkazy, na kterých spočívá: soubor, příkaz nebo odpověď loopbacku, které byly přečteny. Soubor pravidla na disku není pravidlo, které cokoli vynucuje, adresa, která přijímá spojení, není server této verze, a zaznamenaný běh testu na jiném commitu neověřuje tento strom, takže se žádné z nich nehlásí jako takové. `attention` vypisuje, na co je třeba se podívat, nejnaléhavější první.

  $ majordomus env preflight --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON obsahující /schema, /sections/0/checks/0/verdict, /attention.

  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í.

majordomus commands

Každý příkaz, který tento repozitář nabízí, z kteréhokoli programu, který ho nabízí: graf, jeden příkaz, kam se každý promítá, a z něj odvozený most do workflow

majordomus commands [OPTIONS] [COMMAND]

/docs/cli/commands/ — tento příkaz na vlastní stránce

Podpříkazy: list, show, explain, graph, bridge.

Příklady

• Každý příkaz, který tento repozitář nabízí

  Graf příkazů složený ze tří deklarací, které už existují: strom clap tohoto spustitelného souboru, dodávaný registr příkazů shellového nástroje a recepty, které popisuje workflow runner. Jeden řádek na příkaz, s programem, který jej spouští, a tím, co jeho spuštění mění.

  $ majordomus commands

  Co tvrdí: skončí s kódem 0; vypíše commands, executable, read-only.

  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í.

majordomus commands list

Každý příkaz, jeden řádek: co to je, co jeho spuštění mění a kde je promítnut

majordomus commands list [OPTIONS]

/docs/cli/commands/list/ — tento příkaz na vlastní stránce

Příklady

• Pouze to, co čte

  Filtry jsou vlastním slovníkem grafu, ne hledání v textu: `--effect read-only` je každý příkaz, který nikde nic nemění, což je stejný predikát, jakým politika vystavení rozhoduje, co smí volat strojový povrch.

  $ majordomus commands list --effect read-only

  Co tvrdí: skončí s kódem 0; vypíše read-only.

  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í.

majordomus commands show

Jeden příkaz celý: jeho argumenty, efekt, potřeby a každý povrch, který jej nese

majordomus commands show [OPTIONS] <ID>

/docs/cli/commands/show/ — tento příkaz na vlastní stránce

Příklady

• Jeden příkaz a každý povrch, který ho nese

  Argumenty se zdrojem hodnot každého z nich, účinek a projekce: příkazová řádka, recept workflow, nástroj MCP, trasa HTTP, Cockpit a stránka. Povrch, který to zadržuje, říká proč.

  $ majordomus commands show executable.worktree.status

  Co tvrdí: skončí s kódem 0; vypíše executable.worktree.status, projections.

  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í.

majordomus commands explain

Proč se jeden příkaz objevuje právě tam, kde se objevuje: deklarace, ze které pochází, politika, která ho umístila, a důvod každého povrchu, který ho zadržuje

majordomus commands explain [OPTIONS] <ID>

/docs/cli/commands/explain/ — tento příkaz na vlastní stránce

Příklady

• Proč se příkaz objevuje tam, kde se objevuje

  Tentýž příkaz s jeho původem: soubor, který jej deklaruje, čtenář, který jej našel, schopnost za ním, když nějaká je, co vyžaduje, a soubor, v němž žije politika vystavení. Nic na umístění příkazu není záhada, kterou by musel řešit grep.

  $ majordomus commands explain executable.serve

  Co tvrdí: skončí s kódem 0; vypíše declared in, policy.

  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í.

majordomus commands graph

Celý graf jako jeden dokument, s jeho otiskem a každou diagnostikou

majordomus commands graph [OPTIONS]

/docs/cli/commands/graph/ — tento příkaz na vlastní stránce

Příklady

• Celý graf jako jeden dokument

  Deterministické a s otiskem: dvě sestavení nad jedním stromem dají stejné bajty, což dovoluje, aby se bridge workflow, index doplňování i Cockpit řídily otiskem místo opětovné generace.

  $ majordomus commands graph --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden dokument JSON s /schema, /fingerprint, /commands.

  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í.

majordomus commands bridge

Zhmotnit most workflow z grafu a obnovit cache, kterou čte dokončení; nezapíše nic, když se graf nezměnil

majordomus commands bridge [OPTIONS]

/docs/cli/commands/bridge/ — tento příkaz na vlastní stránce

Příklady

• Recepty spouštěče workflow, odvozené

  Každý příkaz obou programů, zapsaný jako recept, který spustí kanonický program s vlastními argumenty volajícího. Ukládá se pod .ai/local/cache/, které žádný commit nenese, a přepisuje se jen tehdy, když se změní otisk grafu.

  $ majordomus commands bridge

  Co tvrdí: skončí s kódem 0; vypíše bridge, recipe.

  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í.

majordomus completion

Doplňování pro jakýkoli povrch, zodpovídané z grafu příkazů: kandidáti, které shell žádá, a jednorázová integrace, která o ně žádá

majordomus completion [OPTIONS] [COMMAND]

/docs/cli/completion/ — tento příkaz na vlastní stránce

Podpříkazy: query, init, install.

Příklady

• Integrace, kterou člověk instaluje jednou

  Bez podpříkazu integrace shellu pro zsh. Neobsahuje žádný příkaz, příznak ani identifikátor: každý kandidát pochází z dotazu na graf příkazů repozitáře, v němž shell je, takže jedna integrace obslouží každý checkout a nikdy nezastará.

  $ majordomus completion

  Co tvrdí: končí kódem 0; vypíše completion query, compdef.

  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í.

majordomus completion query

Kandidáti pro jednu příkazovou řádku z grafu příkazů. Co shellový adaptér volá při každém TAB

majordomus completion query [OPTIONS] [WORD]

/docs/cli/completion/query/ — tento příkaz na vlastní stránce

Příklady

• Na co se shell ptá při každém TAB

  Slova příkazové řádky a pozice kurzoru; zpět přicházejí kandidáti s popisy. Stejné volání obsluhuje doplňování workflow runneru s `--surface workflow`: vyřeší název receptu na příkaz, který přemosťuje, a pak doplní argumenty tohoto příkazu.

  $ majordomus completion query --surface cli -- majordomus work

  Co tvrdí: skončí s kódem 0; vypíše worktree.

  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í.

majordomus completion init

Shellová integrace, která se načte jednou, nenese žádný vlastní příkaz a na každého kandidáta se ptá tohoto executable

majordomus completion init [OPTIONS]

/docs/cli/completion/init/ — tento příkaz na vlastní stránce

Příklady

• Totéž, pro bash

  Protokol jiného shellu, táž otázka. Oba adaptéry čtou slova, která se doplňují, najdou kurzor, zeptají se tohoto spustitelného souboru a vypíšou, co se vrátí.

  $ majordomus completion init --shell bash

  Co tvrdí: skončí kódem 0; vypíše completion query, complete -F.

  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í.

majordomus completion install

Vložit tuto integraci do spouštěcího souboru shellu mezi spravované značky, aby ji nikdo neudržoval ručně

majordomus completion install [OPTIONS]

/docs/cli/completion/install/ — tento příkaz na vlastní stránce

Příklady

• Jeden řádek, který si člověk přidá do svého shellu, přidaný za něj

  Zapíše integraci do startovacího souboru shellu mezi značky `# >>> MAJORDOMUS >>>`: nic mimo ně se nemění, dvojí spuštění nic nezmění a `--remove` ji zase odstraní. Nikdy to není vedlejší efekt ničeho jiného — instalace do domovského adresáře člověka je samostatné rozhodnutí, a proto je to samostatný příkaz. `--dry-run` řekne, co by se změnilo, a nic nezapíše.

  $ majordomus completion install --shell zsh --dry-run

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus worktree

Topologie větev–worktree: kam patří každý propojený worktree (`<repo>-wt/<branch>`), kde který je, a životní cyklus: create, migrate, repair, guard

majordomus worktree [OPTIONS] [COMMAND]

/docs/cli/worktree/ — tento příkaz na vlastní stránce

Podpříkazy: status, list, topology, root, path, inspect, create, ensure, migrate, validate, doctor, guard, repair, remove, cleanup, uncommitted, trunk, branches.

Příklady

• Kde jsem a je to místo, kam patřím?

  `worktree` bez čehokoli dalšího odpovídá na otázku, kterou si pracovník klade před startem: která větev to je, zda je tento adresář kanonickým worktree té větve (nebo primárním checkoutem na trunku), co je zde necommitnuto a kolik chyb nese celá topologie. Stejná odpověď z primárního checkoutu i ze čtyř adresářů hluboko uvnitř propojeného worktree.

  $ majordomus worktree

  Co tvrdí: skončí s kódem 0; vypíše branch, worktree, container.

  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í.

majordomus worktree status

Kde toto volání je — větev, worktree, zda kanonický, necommitovaná práce — a kolik chyb nese celá topologie; exit 10, když je tento worktree na nesprávném místě

majordomus worktree status [OPTIONS]

/docs/cli/worktree/status/ — tento příkaz na vlastní stránce

Příklady

• Aktuální worktree jako jeden dokument

  Tatáž odpověď jako JSON: repozitář, kontejner, trunk a jak se určil, tento worktree s jeho postavením a diagnostikou a zda je tam, kam patří. To odpovídá nástroj MCP `majordomus_worktree_status` a `GET /api/v1/worktrees/status`.

  $ majordomus worktree status --format json

  Co tvrdí: skončí s kódem 0; vypíše jeden JSON dokument obsahující /worktree/standing, /container/path, /trunk/source, /canonical.

  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í.

majordomus worktree list

Každý registrovaný worktree s jeho stavem, jeden řádek na worktree; exit 10, když má topologie chybu

majordomus worktree list [OPTIONS]

/docs/cli/worktree/list/ — tento příkaz na vlastní stránce

Příklady

• Každý worktree, ty na špatném místě na první pohled

  Nejdřív primární checkout, pak každý připojený worktree s jeho stavem, větví, místem, kam patří, pokud je jinde, a jeho nepotvrzenou prací. Primární checkout je vyňat z pravidla cesty a podléhá místo něj pravidlu hlavní větve.

  $ majordomus worktree create feature/example
  $ majordomus worktree list

  Co tvrdí: skončí s kódem 0; vypíše PRIMARY, CANONICAL, -wt/feature/example.

  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í.

majordomus worktree topology

Celá topologie: repozitář, kontejner, trunk, každý worktree, každá větev bez worktree, každá diagnostika; exit 10, když obsahuje chybu

majordomus worktree topology [OPTIONS]

/docs/cli/worktree/topology/ — tento příkaz na vlastní stránce

Příklady

• Celá topologie jako jeden dokument

  Repozitář, kontejner, trunk, každý worktree, každá větev s worktree i bez něj, každá diagnostika s kódem a nápravou a součty. To je to, co vykreslují zdroj MCP `majordomus://worktrees`, nástroj `majordomus_worktrees`, `GET /api/v1/worktrees` a Cockpit.

  $ majordomus worktree topology --format json

  Co tvrdí: končí kódem 0; vypíše jeden JSON dokument nesoucí /container/path, /trunk/branch, /worktrees/0/standing, /branches/0/name, /tallies/worktrees, /valid.

  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í.

majordomus worktree root

Vypsat kontejner, pod který patří každý propojený worktree, a nic jiného: `cd "$(majordomus worktree root)"`

majordomus worktree root [OPTIONS]

/docs/cli/worktree/root/ — tento příkaz na vlastní stránce

Příklady

• Kontejner pro shell

  Vypíše kontejner a nic jiného, aby ho mohl použít shell: `cd "$(majordomus worktree root)"`. Je to sourozenec primárního checkoutu s příponou `-wt`, odvozený z vlastní identity gitu a nikdy z aktuálního adresáře — proto spuštění uvnitř propojeného worktree neodpoví kontejnerem uvnitř tohoto worktree.

  $ majordomus worktree root

  Co tvrdí: skončí s kódem 0; vypíše -wt.

  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í.

majordomus worktree path

Vypsat kanonickou cestu větve a nic jiného: `cd "$(majordomus worktree path feature/x)"`. Odvozeno z názvu; větev nemusí existovat

majordomus worktree path [OPTIONS] <BRANCH>

/docs/cli/worktree/path/ — tento příkaz na vlastní stránce

Příklady

• Kanonická cesta větve, pro shell

  Podřízený proces nemůže změnit adresář nadřazeného shellu, takže se zde nic nepředstírá: vypíše se jedna cesta a zbytek udělá shell — `cd "$(majordomus worktree path feature/x)"`. Cesta je název větve pod kontejnerem, s hierarchií zachovanou; větev zatím nemusí existovat.

  $ majordomus worktree path feature/providers/streaming

  Co tvrdí: končí kódem 0; vypíše -wt/feature/providers/streaming.

  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í.

majordomus worktree inspect

Jedna větev: její kanonická cesta, zda existuje, co cestu zabírá, worktree, který ji drží, a co stojí v cestě

majordomus worktree inspect [OPTIONS] <BRANCH>

/docs/cli/worktree/inspect/ — tento příkaz na vlastní stránce

Příklady

• Jedna větev, před vytvořením jejího worktree

  Kam worktree větve patří, zda větev existuje, zda cestu něco zabírá a co by stálo v cestě. Pro větev, která ještě neexistuje, je odpovědí cesta, kterou by použil `worktree create`, a příkaz ke spuštění.

  $ majordomus worktree inspect feature/new-dashboard

  Co tvrdí: skončí s kódem 0; vypíše -wt/feature/new-dashboard, does not exist yet.

  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í.

majordomus worktree create

Vytvoří kanonický worktree větve. Větev, která zde neexistuje, se stáhne ze vzdáleného repozitáře trunku a převezme se, pokud ji vzdálený repozitář má; jinak se vytvoří z --base, případně z právě stažené trunk větve vzdáleného repozitáře (z lokálního trunku jen když vzdálený nelze přečíst, a pak se to uvede i s tím, o kolik zaostává). Cesta se odvodí; žádnou zadat nelze

majordomus worktree create [OPTIONS] [BRANCH]

/docs/cli/worktree/create/ — tento příkaz na vlastní stránce

Příklady

• Začít práci na větvi, aniž by se rozhodovalo, kam patří

  Vytvoří větev `feature/improve-cli` z trunku a checkoutuje ji do nového worktree v `<repository>-wt/feature/improve-cli`. Cesta se nezadává a nesmí se: cíl vyplývá z identity repozitáře a názvu větve, takže stejný příkaz ve stejném repozitáři vždy dá stejnou cestu — z primárního checkoutu i zevnitř jiného worktree.

  $ majordomus worktree create feature/improve-cli

  Co tvrdí: skončí kódem 0; vypíše -wt/feature/improve-cli, feature/improve-cli (new.

  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í.

majordomus worktree ensure

Kanonický worktree branche: vytvoří se, když chybí, vrátí se, když existuje, a odmítne se, když je branch checkoutnutý jinde

majordomus worktree ensure [OPTIONS] <BRANCH>

/docs/cli/worktree/ensure/ — tento příkaz na vlastní stránce

Příklady

• Kanonický worktree, ať už už existuje, nebo ne

  `ensure` je `create` pro volajícího, kterému nezáleží na tom, zda worktree už existuje: vytvoří ho, když chybí, a odpoví existujícím, když je přítomen. To, co skript nebo agent spouští před zahájením práce na větvi.

  $ majordomus worktree create feature/improve-cli
  $ majordomus worktree ensure feature/improve-cli

  Co tvrdí: skončí s kódem 0; vypíše exists, -wt/feature/improve-cli.

  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í.

majordomus worktree migrate

Přenese každý špatně umístěný worktree na jeho kanonickou cestu, včetně necommitovaného stavu, s otiskem pořízeným před každým přesunem a po něm; --plan ukáže kroky a nic nezmění

majordomus worktree migrate [OPTIONS]

/docs/cli/worktree/migrate/ — tento příkaz na vlastní stránce

Příklady

• Co by bylo potřeba, aby se každý worktree vrátil domů

  `--plan` ukáže každý špatně umístěný worktree s tím, kam patří, jak by se přesunul, necommitnutou prací, která se přesune s ním, a tím, co mu brání, a nic nemění. Bez `--plan` se provedou přesunutelné kroky: každý worktree se otiskne, přesune pomocí `git worktree move`, znovu otiskne na nové cestě a ohlásí se jako přesunutý, jen když jsou oba otisky shodné.

  $ majordomus worktree migrate --plan

  Co tvrdí: skončí s kódem 0; vypíše nothing to migrate.

  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í.

majordomus worktree validate

Každá chyba topologie a nic jiného; exit 10, když nějaká je

majordomus worktree validate [OPTIONS]

/docs/cli/worktree/validate/ — tento příkaz na vlastní stránce

Příklady

• Je topologie platná?

  Každá diagnostika úrovně error a nic jiného, pak verdikt; kód 10, pokud existuje chyba. To, podle čeho skript rozhoduje.

  $ majordomus worktree validate

  Co tvrdí: skončí s kódem 0; vypíše worktree topology: valid.

  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í.

majordomus worktree doctor

Každá diagnostika topologie, chyby, varování i fakta, každá s kódem a nápravou; exit 10, když je chyba

majordomus worktree doctor [OPTIONS]

/docs/cli/worktree/doctor/ — tento příkaz na vlastní stránce

Příklady

• Každá diagnostika s kódem a nápravou

  Chyby, varování a fakta — špatně umístěný worktree, zastaralá registrace, detached HEAD, primární checkout mimo trunk, neznámý trunk — každé pod stabilním kódem, který nesou i API a Cockpit, každé s příkazem, který je řeší.

  $ majordomus worktree doctor

  Co tvrdí: skončí s kódem 0; vypíše worktree topology: valid.

  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í.

majordomus worktree guard

Smí odsud pokračovat mutace? Exit 0 v kanonickém worktree, v primárním checkoutu na trunku nebo v detached stavu; jinak exit 10 s důvodem. Na co se ptá pre-commit hook

majordomus worktree guard [OPTIONS]

/docs/cli/worktree/guard/ — tento příkaz na vlastní stránce

Příklady

• Smí odsud commit pokračovat?

  Otázka pre-commit hooku. Skončí s kódem 0 v kanonickém worktree větve, v primárním checkoutu na trunku nebo na odpojeném HEAD; skončí s kódem 10 s diagnostikou a nápravou, když se na feature větvi pracuje někde, kam nepatří. Hook zůstává jednořádkový; tohle je logika.

  $ majordomus worktree guard

  Co tvrdí: skončí s kódem 0; vypíše worktree guard: ok.

  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í.

majordomus worktree repair

Zahodit registrace worktree v gitu, jejichž adresáře zmizely, a opravit administrativní odkazy těch, které existují. Nesmaže žádný adresář

majordomus worktree repair [OPTIONS]

/docs/cli/worktree/repair/ — tento příkaz na vlastní stránce

Příklady

• Co by git zapomněl

  `repair` zahodí registrace worktrees v gitu, jejichž adresáře už neexistují, a nechá git opravit administrativní odkazy těch, které existují. Nemaže žádný adresář a nedotýká se žádné větve; `--dry-run` ohlásí, co by zahodil, a nic nezmění.

  $ majordomus worktree repair --dry-run

  Co tvrdí: skončí kódem 0; vypíše, že není co mazat.

  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í.

majordomus worktree remove

Odstraní jeden propojený worktree podle branche nebo cesty. Nikdy primární checkout, nikdy branch, nikdy necommitnutou práci bez --force

majordomus worktree remove [OPTIONS] <SELECTOR>

/docs/cli/worktree/remove/ — tento příkaz na vlastní stránce

Příklady

• Odstranit worktree a ponechat jeho větev

  Odstraní worktree a nic víc. Větev, kterou držel, stále existuje: životní cyklus worktree a životní cyklus větve jsou oddělené a smazání větve je příkaz gitu, který člověk píše záměrně. Worktree s necommitnutou prací je odmítnut, místo aby byl odstraněn.

  $ majordomus worktree create feature/improve-cli
  $ majordomus worktree remove feature/improve-cli

  Co tvrdí: skončí s kódem 0; vypíše removed, feature/improve-cli still exists.

  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í.

majordomus worktree cleanup

Branche sloučené do trunku, jejichž worktree je čistý nebo chybí: co by se dalo odstranit. Bez --remove nic neodstraní

majordomus worktree cleanup [OPTIONS]

/docs/cli/worktree/cleanup/ — tento příkaz na vlastní stránce

Příklady

• Co by mohlo pryč a co by to vyžadovalo

  Každá větev sloučená do trunku, jejíž worktree je čistý nebo chybí, se dvěma příkazy, které by odstranily worktree a pak větev. Pouze odvozený stav: nic se zde nemaže a špinavý nebo nesloučený worktree se nikdy neuvádí.

  $ majordomus worktree cleanup

  Co tvrdí: končí kódem 0; vypíše cleanup-eligible.

  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í.

majordomus worktree uncommitted

Každý propojený worktree s necommitnutou prací: kolik cest, jak stará je nejstarší změna, co ji drží (aktivní úloha, otevřená epizoda, proces uvnitř) a zda je opuštěná, s příkazem, který by ji dostal na vzdálený ref. Čte každý worktree a žádný nezapisuje

majordomus worktree uncommitted [OPTIONS]

/docs/cli/worktree/uncommitted/ — tento příkaz na vlastní stránce

Příklady

• Práce, kterou žádný commit nenese, a zda ji něco drží

  Každý připojený worktree držící staged, unstaged, untracked nebo konfliktní cesty, s počtem, stářím nejstarší změny, úlohou, epizodou nebo procesem, který je drží, a `abandoned`, když je nedrží nic a je starší než session.stranded_after politiky. Repozitář bez připojeného worktree nemá co vypsat; čtení tak či onak nic nezapisuje.

  $ majordomus worktree uncommitted

  Co tvrdí: skončí s kódem 0; vytiskne 0 s necommitnutou prací, nic se nezměnilo.

  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í.

majordomus worktree trunk

Jak daleko je tento checkout a lokální trunk od vzdáleného trunku, k poslednímu fetchi, posuzováno podle checkout.trunk_distance v politice: aktuální, zaostává, zastaralý, neposouzeno nebo neměřeno, s příkazy, které jej zaktualizují. Nic nestahuje; exit 10, když je zastaralý

majordomus worktree trunk [OPTIONS]

/docs/cli/worktree/trunk/ — tento příkaz na vlastní stránce

Příklady

• Jak daleko je tento checkout od vzdáleného trunku

  HEAD checkoutu a lokální trunk spočtené proti vzdálenému sledovacímu trunku, ke stavu posledního fetche, a posouzené podle checkout.trunk_distance z politiky. Repozitář bez remote nemá proti čemu měřit a řekne to — `unmeasured`, nikdy `current`; v obou případech se nic nefetchuje.

  $ majordomus worktree trunk

  Co tvrdí: skončí s kódem 0; vypíše unmeasured, no remote-tracking branch.

  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í.

majordomus worktree branches

Každý lokální branch, jeden na řádek, pro shellové doplňování, které chce aktuální množinu

majordomus worktree branches [OPTIONS]

/docs/cli/worktree/branches/ — tento příkaz na vlastní stránce

Příklady

• Živá sada větví pro doplňování

  Každá lokální větev, jedna na řádek, nic jiného. Shell completion pro `worktree path`, `create` nebo `remove` čte toto místo seznamu vedeného kdekoli jinde, takže se doplní i větev vytvořená před vteřinou.

  $ majordomus worktree branches

  Co tvrdí: skončí s kódem 0.

  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í.

majordomus prs

Integrace pull requestů: každý otevřený pull request klasifikovaný vůči aktuálnímu masteru spolu s důkazy, seřazený plán a executor, který slučuje další prokazatelně bezpečný pull request — vždy jeden, s přeplánováním po každém (ADR 0101)

majordomus prs [OPTIONS] [COMMAND]

/docs/cli/prs/ — tento příkaz na vlastní stránce

Podpříkazy: status, plan, explain, refresh, drain, cleanup, repair, events, trains, brief, prove-dry-run.

Příklady

• Fronta, než byl forge kdy pozorován

  `prs` bez čehokoli dalšího je `prs status`. Čte poslední zaznamenané pozorování forgeu a nikdy nesahá do sítě, takže v checkoutu, kde `prs refresh` nikdy neběžel, nemá co řadit: řekne to, jmenuje příkaz, který pozoruje, a skončí kódem 10.

  $ majordomus prs

  Co tvrdí: exit 10.

  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í.

majordomus prs status

Každý otevřený pull request s jeho dispozicí, rizikem a důvodem, v pořadí podle priority, z posledního zaznamenaného pozorování; exit 10, když je pozorování zastaralé nebo chybí

majordomus prs status [OPTIONS]

/docs/cli/prs/status/ — tento příkaz na vlastní stránce

Příklady

• Seřazená fronta jako jeden dokument

  Posouzení každého otevřeného pull requestu v pořadí podle priority — dispozice, lane, důvody, master a head, vůči nimž bylo rozhodnuto, důkazy, riziko, překryvy — s dalším merge a součty. Stejnou hodnotu vrací `GET /api/v1/pull-requests` a nástroj MCP `majordomus_pull_requests`. Pokud není zaznamenáno žádné pozorování, skončí s kódem 10.

  $ majordomus prs status --format json

  Co tvrdí: exit 10.

  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í.

majordomus prs plan

Co by exekutor udělal dál: další merge, pull requesty, do nichž je třeba zanést master, a lanes; nic se nemění

majordomus prs plan [OPTIONS]

/docs/cli/prs/plan/ — tento příkaz na vlastní stránce

Příklady

• Co by executor udělal dál

  Další merge, pull requesty, které potřebují zapracovat master, a dráhy oprav, úklidu a pozastavené. Plán je po jakémkoli merge neplatný: exekutor před dalším krokem znovu pozoruje. Bez zaznamenaného pozorování skončí s kódem 10.

  $ majordomus prs plan

  Co tvrdí: exit 10.

  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í.

majordomus prs explain

Proč je jeden pull request tam, kde je: revize, proti kterým se rozhodovalo, každý důkaz, jeho pořadí a faktory za ním

majordomus prs explain [OPTIONS] <NUMBER>

/docs/cli/prs/explain/ — tento příkaz na vlastní stránce

Příklady

• Proč je jeden pull request tam, kde je

  Revize, vůči nimž se rozhodovalo, každý důkaz, jeho pořadí a faktory za ním. Tatáž odpověď, kterou dává `GET /api/v1/pull-requests/explain?number=`. Bez zaznamenaného pozorování skončí kódem 10.

  $ majordomus prs explain 1

  Co tvrdí: exit 10.

  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í.

majordomus prs refresh

Pozorovat forge teď (GitHub CLI a jeden `git fetch`) a pozorování zaznamenat; jediné čtení, které sahá do sítě

majordomus prs refresh [OPTIONS]

/docs/cli/prs/refresh/ — tento příkaz na vlastní stránce

Příklady

• Pozorování forge, kde žádný není

  `refresh` je jeden ze tří příkazů `prs`, které sahají do sítě: ptá se GitHub CLI na repozitář, jeho ochranu větví a jeho otevřené pull requesty a stahuje jejich hlavy. Repozitář bez GitHub remote nelze pozorovat a odpovědí je kód 12 — nepoužitelné, nikdy prázdná fronta.

  $ majordomus prs refresh

  Co tvrdí: exit 12.

  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í.

majordomus prs drain

Sloučit další připravený pull request, ověřit, že přistál, znovu pozorovat a opakovat — nejvýše `--max` sloučení; `--dry-run` rozhodne bez jednání

majordomus prs drain [OPTIONS]

/docs/cli/prs/drain/ — tento příkaz na vlastní stránce

Příklady

• Nanečisto začíná čerstvým pozorováním

  I zkušební běh nejprve pozoruje forge — rozhodnutí se nikdy nepřijímá ze zaznamenaného pozorování — takže když je forge nedostupný, skončí s kódem 12 dřív, než cokoli rozhodne, a nic se neslučuje, neobnovuje ani nezaznamenává.

  $ majordomus prs drain --dry-run

  Co tvrdí: exit 12.

  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í.

majordomus prs cleanup

Uzavřít pull requesty, jejichž práce je prokazatelně už na masteru; bez `--apply` je pouze vypíše

majordomus prs cleanup [OPTIONS]

/docs/cli/prs/cleanup/ — tento příkaz na vlastní stránce

Příklady

• Úklid vypisuje dřív, než zavře, a pozoruje dřív, než vypíše

  Bez `--apply` cleanup jen vypíše pull requesty, jejichž práce je prokazatelně na masteru; tak či tak nejdřív pozoruje forge, takže tam, kde žádný není, skončí kódem 12.

  $ majordomus prs cleanup

  Co tvrdí: exit 12.

  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í.

majordomus prs repair

Přenést master do jednoho pojmenovaného pull requestu, jehož jediný konflikt s ním je nad odvozenými (`merge=derived`) soubory. Způsobilý jen tehdy, když klasifikace říká, že zaostává za masterem a jeho merge nekonfliktuje na žádné autorské cestě; autorský konflikt se odmítne s pojmenováním souborů. Ve výchozím stavu nanečisto, rozhodnuto offline na posledním zaznamenaném pozorování, jako `status`. S `--apply` převezme integrační lease, znovu pozoruje forge, nejdřív zaznamená čin na stopu a sloučí master v pracovním worktree, provede derive, commit a push jako fast-forward s lease na pozorované hlavě; nikdy nesloučí do masteru. Exit 10 při odmítnutí nebo chybějícím pozorování, 12, když nemohl jednat

majordomus prs repair [OPTIONS] <TARGET>

/docs/cli/prs/repair/ — tento příkaz na vlastní stránce

Příklady

• Oprava se rozhoduje na zaznamenaném pozorování, nebo vůbec

  Zkušební běh, který je výchozí, je čtení: rozhoduje, zda smí pojmenovaný pull request dostat master z fronty, kterou sestavilo poslední zaznamenané pozorování, jako to dělá `prs status`, a nesahá na síť. Kde nebylo nikdy nic pozorováno, není z čeho klasifikaci rozhodnout, takže končí kódem 10 a pojmenuje `prs refresh`; nic se nemerguje, nepushuje ani nezaznamenává.

  $ majordomus prs repair 1

  Co tvrdí: exit 10.

  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í.

majordomus prs events

Auditní stopa: každý výběr, sloučení, odmítnutí, zastaralé rozhodnutí a uzavření, které executor tohoto checkoutu zaznamenal

majordomus prs events [OPTIONS]

/docs/cli/prs/events/ — tento příkaz na vlastní stránce

Příklady

• Auditní stopa executoru tohoto checkoutu

  Každý výběr, zastaralé rozhodnutí, merge s masterem před i po, odmítnutí, obnovení a uzavření, od nejstaršího. Checkout, jehož executor nikdy nebežel, žádné nemá a říká to.

  $ majordomus prs events

  Co tvrdí: skončí s kódem 0; vypíše no integration action.

  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í.