cmdutil

type Spec[Req any] struct {
	Use   string
	Short string
	Long  string

	// JSONRequired causes an error when --json is absent.
	// Set false for list/read commands where the request body is optional.
	JSONRequired bool

	// ErrTransform optionally remaps errors returned by json.Unmarshal before
	// they are surfaced to the user. Use it to replace Go type names in SDK
	// enum validation errors with human-readable messages. The transform must
	// return an error (never nil); return fmt.Errorf("invalid --json: %w", err)
	// as the fallback to preserve the default behavior.
	ErrTransform func(err error) error

	// Run calls the SDK method and returns the response payload to serialize.
	// The payload must be the inner component field — NOT the operation wrapper
	// (e.g. return resp.ListCollectionsResponse, not resp).
	// Return (nil, nil) for operations with no response body (delete, etc.).
	Run func(ctx context.Context, sdk *glean.Glean, req Req) (any, error)
}