Interface: CliSubcommandDefinition<T>

Makaio Framework / kernel/cli / CliSubcommandDefinition

A single CLI subcommand with a Zod schema and strongly-typed handler.

The schema defines both the data shape (for type inference) and CLI metadata (descriptions, short flags) via Zod’s .meta() on each field.

Type Parameters

T extends z.ZodObject<z.ZodRawShape>

A z.ZodObject whose shape defines the command’s options/args.

readonly description: string

One-line description shown in help text.

readonly handler: (ctx) => Promise<void>

Handler invoked with the parsed, validated context.

Promise<void>

readonly name: string

Subcommand name (e.g. 'list', 'switch').

readonly schema: T

Zod object schema defining the command’s options and arguments.