Crate wyvern 

Wyvern CLI library — load → validate → run → emit pipeline.

main.rs is a thin binary wrapper around pipeline::run_from_loaded.

Modules

extensions

CLI extension registry, match, preexec, and expand (ADR-0022). CLI extension registry: load, merge, match, expand, and dispatch.

Structs

CliArgs

Parsed CLI invocation: host options + remaining positional/stdin args.

ExtensionRegistry

Merged, extends-resolved extension registry.

Enums

BrowsersError

CLI browsers subcommand failure.

BuiltinDomain

Built-in CLI family that owns subcommands (browsers, extensions).

EmitError

Failure serializing stdout or structured stderr JSON at the CLI emit boundary.

ExtensionError

Structured extension-engine failure.

ExtensionMatch

Successful argv match against one extension.

LoadError

Failure while loading command input from argv or stdin.

NearMissKind

Why remainder argv did not match an extension (REQ-0136).

PipelineError

Pipeline failure after load: stage stderr + exit, or emit-boundary serialize failure.

PreexecFailureKind

Why a preexec subprocess failed.

UsageErrorKind

Host-flag / env usage failure kind for structured stderr recovery (RBP-F009).

ViewerSpawnError

Failure locating or launching wyvern-viewer.

Functions

apply_host_overrides

Apply extension host.ui_root over CLI --ui-root when set (contract §7).

browsers_usage_message

Usage text for wyvern browsers --help / -h.

emit_extension_error

Serialize an extension-engine error as stderr JSON.

emit_fatal_internal

Emit static internal stderr JSON and exit with code 8 (REQ-0078).

emit_host_error

Serialize a wyvern_host::HostError as stderr JSON (REQ-0073).

emit_io_error

Serialize an I/O load error as stderr JSON.

emit_near_miss

Serialize a near-miss as the existing StderrError envelope.

emit_parse_error

Serialize a parse load error as stderr JSON.

emit_stdout

Serialize a successful wyvern_schema::CommandResult for stdout.

emit_usage_error

Serialize LoadError::Usage as stderr JSON with flag-specific recovery.

emit_usage_message

Serialize a usage / unknown-subcommand error as stderr JSON (exit 2).

emit_validation_error

Serialize a validation/state error as stderr JSON.

load_command_input

Load a command Value from positional args or stdin.

parse_cli_args

Split argv into host flags and positionals.

resolve_viewer_bin

Resolve wyvern-viewer via sibling → CARGO_BIN_EXE → WYVERN_VIEWER_BIN → PATH.

run_browsers_command

Run a browsers subcommand; returns stdout text on success.

run_from_loaded

Validate value, run the host, and return stdout JSON on success.

set_pipeline_correlation_id

Bind the session correlation id for pipeline tracing events (binary calls after init).

spawn_embedded_viewer

Spawn wyvern-viewer for dialog_url with optional size hints.

usage_message

Canonical usage text for --help / -h / help and invalid argv.