majordomus web
The repository's web surfaces: what is exposed, where it is mounted, what produced it, and whether the topology is valid
majordomus web
Usage
majordomus web [OPTIONS] [COMMAND]Commands
- majordomus web list Every discovered surface: id, kind, mount, producer
- majordomus web explain Why each surface exists and where each of its values came from
- majordomus web validate Check the topology's invariants; exit 10 on any error finding
- majordomus web manifest Write the resolved topology to the generated manifest
- majordomus web report Render a generated report into its own surface under the generated web root
- majordomus web compose Compose every published surface into one publishable tree
Arguments
| argument | value | default | description |
|---|---|---|---|
| --repo | <PATH> | — | Start the search for the repository root here (default: the current directory) (accepted by every subcommand) |
| --discovery | vcs | filesystem | vcs | How declarative files are enumerated (accepted by every subcommand)
|
| --strict | flag | — | Refuse to proceed when any file of the layer carries an error diagnostic (accepted by every subcommand) |
| --share | <DIR> | — | The tool distribution's share directory (kinds.yaml, schemas/); default: $MAJORDOMUS_SHARE, then the repository's own share/, then the one beside the executable (accepted by every subcommand) |
| --format | text | json | text | Output shape (accepted by every subcommand)
|
| --only | <ONLY> | — | Only these surfaces, by discovered id (repeat or separate with commas) (accepted by every subcommand) |
| --exclude | <EXCLUDE> | — | Every surface except these, by discovered id (accepted by every subcommand) |
Examples
-
The topology, from the command with no subcommand
`web` with nothing after it lists, because listing is what a person wants when they ask what this repository exposes.
$ majordomus webWhat it asserts: exits 0; prints ID, MOUNT.
Tested by apps/majordomus-cli/tests/cli_examples.rs, which runs the command against the built executable and asserts what the page states.
Where this comes from
Declared once in apps/majordomus-cli/src/cli.rs: clap for the structure, typed Rust metadata beside it for the examples. This page, majordomus web --help, docs/generated/cli.md and docs/generated/cli.json are projections of that one declaration.
The whole command line on one page: the registry's command-line page. The task lifecycle (init, start, finish, doctor, ...) belongs to the shell tool, a different program: Commands and its specification.