Function parseArgs

internal/cmdhelp/json.go:272–363

(cmd *cobra.Command)

var argRE = regexp.MustCompile(`<([^<>]+)>(\.\.\.)?|\[([^\[\]]+)\](\.\.\.)?`)

func parseArgs(cmd *cobra.Command) []Arg {
	matches := argRE.FindAllStringSubmatch(cmd.Use, -1)
	args := make([]Arg, 0, len(matches))
	for _, m := range matches {
		var inner, ellipsis string
		var required bool
		switch {
		case m[1] != "":
			inner = m[1]
			ellipsis = m[2]
			required = true
		case m[3] != "":
			inner = m[3]
			ellipsis = m[4]
			required = false
		default:
			continue
		}
		inner = strings.TrimSpace(inner)
		if inner == "" {
			continue
		}

		// Filter cobra-conventional placeholders that are not real args.
		lower := strings.ToLower(inner)
		if !required && (lower == "flags" || lower == "options" || lower == "command") {
			continue
		}
		// Filter embedded flag-like fragments such as `[--status X]`.
		if strings.HasPrefix(inner, "-") {
			continue
		}

		// Alternation: <a|b|c> or [a|b|c] → enum-typed positional.
		if strings.Contains(inner, "|") {
			parts := strings.Split(inner, "|")
			values := make([]interface{}, 0, len(parts))
			for _, p := range parts {
				p = strings.TrimSpace(p)
				if p != "" {
					values = append(values, p)
				}
			}
			if len(values) > 0 {
				args = append(args, Arg{
					Name:       "value", // synthesized; cobra Use doesn't carry a name here
					Type:       "enum",
					Required:   required,
					Enum:       values,
					Repeatable: ellipsis != "",
				})
				continue
			}
		}

		// Plain <name> / [name]. Reject anything that looks like prose
		// (spaces, punctuation that wouldn't be in an arg identifier).
		if !validArgName(inner) {