Function flagDefinedInTree

cmd/root.go:504–525

flagDefinedInTree reports whether name is defined on cmd, its inherited (persistent) flags, or any direct subcommand. The subcommand case covers a user who merely omitted the subcommand — e.g. `sheets --format json`, where --format is injected on every leaf shortcut, not on the group — so only a gen

(cmd *cobra.Command, name string)

// --format is injected on every leaf shortcut, not on the group — so only a
// genuinely unknown flag like `sheets --badflag` is reported.
func flagDefinedInTree(cmd *cobra.Command, name string) bool {
	short := len(name) == 1
	known := func(c *cobra.Command, inherited bool) bool {
		fs := c.Flags()
		if inherited {
			fs = c.InheritedFlags()
		}
		if short {
			return fs.ShorthandLookup(name) != nil
		}
		return fs.Lookup(name) != nil
	}
	if known(cmd, false) || known(cmd, true) {
		return true
	}
	for _, c := range cmd.Commands() {
		if known(c, false) {
			return true
		}
	}
	return false
}

// availableSubcommandNames returns the invokable subcommand names of cmd, split
// into current commands and backward-compatibility aliases (those tagged into