feat(cli): add shell completions (#14341)

scripts/clidocgen/command.tpl

@@ -43,7 +43,7 @@ Aliases:
 ### {{ with $opt.FlagShorthand}}-{{ . }}, {{end}}--{{ $opt.Flag }}
 {{" "}}
 {{ tableHeader }}
-| Type | {{ $opt.Value.Type | wrapCode }} |
+| Type | {{ typeHelper $opt | wrapCode }} |
 {{- with $opt.Env }}
 | Environment | {{ (print "$" .) | wrapCode }} |
 {{- end }}

scripts/clidocgen/gen.go

@@ -62,6 +62,16 @@ func init() {
 				return `| | |
 | --- | --- |`
 			},
+			"typeHelper": func(opt *serpent.Option) string {
+				switch v := opt.Value.(type) {
+				case *serpent.Enum:
+					return strings.Join(v.Choices, "\\|")
+				case *serpent.EnumArray:
+					return fmt.Sprintf("[%s]", strings.Join(v.Choices, "\\|"))
+				default:
+					return v.Type()
+				}
+			},
 		},
 		).Parse(strings.TrimSpace(commandTemplateRaw)),
 	)