Module command_def 

Declarative command metadata used for help and policy resolution. Declarative command metadata shared by help, completion, and plugin layers.

This module exists to describe commands in a neutral in-memory form before any one presentation or transport layer gets involved. Help rendering, completion tree building, and plugin describe payloads can all consume the same structure instead of each inventing their own command model.

In broad terms:

• crate::core::command_def::CommandDef describes one command node plus nested subcommands
• crate::core::command_def::ArgDef and crate::core::command_def::FlagDef describe the user-facing invocation surface
• crate::core::command_def::CommandPolicyDef carries the coarse visibility/auth requirements that travel with a command definition

Contract:

• this module owns declarative command shape, not runtime dispatch
• the types here should stay presentation-neutral and broadly reusable
• richer runtime policy evaluation lives in crate::core::command_policy, not here

Structs

ArgDef

Positional argument definition for a command.

CommandDef

Declarative command description used for help, completion, and plugin metadata.

CommandPolicyDef

Simplified policy description attached to a CommandDef.

FlagDef

Flag or option definition for a command.

ValueChoice

Suggested value for an argument or flag.

Enums

ValueKind

Semantic type hint for argument and option values.