ReadonlyargsTop-level positionals for flat verbs. Empty array for zero-arg verbs and subcommanded verbs.
ReadonlyasyncDefault async-dispatch mode for this verb (default false). When
true, CommandGiverMixin._executeOne detaches the controller body
from the giver's own input chain at accept-time. Overridden
per-invocation by the reserved --async / --sync flags.
ReadonlycontrollerVerb-level controller template name. May be undefined when the
verb declares subcommands and every subcommand carries its own
controller: (Option E — analyze, measure).
ReadonlydescriptionReadonlyexamplesWorked invocations shown under an Examples heading (optional).
ReadonlyfallthroughOpt-in flag permitting top-level args: AND subcommands: to
coexist. When true, the matcher tries the subcommand map first;
an unknown first token does NOT error — it falls through to
Phase 3a, binding the token + remaining tokens against
this.args. Schema-enforced: the flag REQUIRES both fields.
ReadonlyfileReadonlyhelpMulti-line authored help prose for the verb (optional).
ReadonlypayloadStructured-form-only fields. Populated exclusively through
CommandApi.assembleFromStructured — the text-input path
doesn't surface these to the matcher at all. See
command-spec.md § payload for the full shape.
ReadonlysubcommandsReadonlyvalidatorsVerb-level validator path specs from the YAML. Resolved into
_resolvedValidators by CommandApi.preloadAll; the dispatch
pipeline reads only the resolved form.
ReadonlyverbReadonlyverbsResolve the controller template name for a given subcommand.
Per-subcommand controller: wins; otherwise falls back to the
verb-level controller. Returns undefined when neither is set
(load-time validation prevents this for declared subcommands).
Set of all field names this verb may produce, across positional
args, verb-scoped options, every subcommand's options, and every
subcommand's positional args. Used by assembleFromStructured
to validate incoming fields keys.
Multi-line help text — verb header, aliases, then per-syntax / per-subcommand lines.
Resolve an option by long-name OR short-flag char within a scope ('verb' or a subcommand name). Returns the canonical name and its definition, or undefined when the scope doesn't declare it.
Verb-scoped options for the assemble() phase. The map keys are
option names; pre-resolve short-flag aliases via getOption.
Render man-page-style usage from the args block. Format is the output of the schema, not part of it.
StaticfromStaticfromParse CommandDefinition from YAML string. The parsed view is
validated against cmd/command.schema.json; schema failures
throw with the full Ajv error trail so authoring mistakes
surface at boot, not at first verb invocation.
Parsed command definition.