Function buildCommand

internal/cmdhelp/json.go:152–181

(cmd *cobra.Command)

}

func buildCommand(cmd *cobra.Command) Command {
	out := Command{
		Summary: firstLine(cmd.Short),
	}

	// Long-form description: only emit if it adds something beyond Short.
	if longTrimmed := strings.TrimSpace(cmd.Long); longTrimmed != "" && longTrimmed != cmd.Short && firstLine(longTrimmed) != cmd.Short {
		out.Description = longTrimmed
	}

	out.Args = parseArgs(cmd)
	if flags := collectFlags(cmd.LocalFlags()); len(flags) > 0 {
		out.Flags = flags
	}

	// Examples come from cobra's dedicated Example field when set.
	// Many CLIs (pad included, historically) embed an "Examples:"
	// section in Long instead. Fall back to parsing that block so
	// existing commands populate examples in cmdhelp output without a
	// Long → Example migration. Long stays the canonical Long; the
	// extracted examples become the Examples field, leaving room for
	// commands to migrate to cobra's structured field on their own
	// schedule.
	out.Examples = parseExamples(cmd.Example)
	if len(out.Examples) == 0 {
		out.Examples = parseExamplesFromLong(cmd.Long)
	}

	return out
}

// examplesHeaderRE matches a stand-alone "Examples:" or "Example:"
// section header in a cobra Long string. Anchored to a line on its own