id          = "kumactl"
name        = "kumactl"
homepage    = "https://kuma.io/"
description = "Kuma control plane command-line utility"
executables      = ["kumactl"]

[dotfiles]

# https://kuma.io/docs/2.13.x/explore/cli/ states that kumactl creates and
# updates its user control-plane configuration at ~/.kumactl/config.
paths = ["~/.kumactl/config"]
secret = []

[commands]
format = 1
label = "kumactl"
description = "Apply a Kuma resource file, optionally filling template variables. Only available against a Universal control plane; get, inspect and install are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["apply"]
label = "Apply a resource file"

[[commands.subcommand.source]]
id = "cli"
kind = "manual"
url = "https://kuma.io/docs/2.13.x/explore/cli/"
revision = "2.13.x"
evidence = """
kumactl apply [..]: used to change the state of Kuma. Only available on Universal.
kumactl apply -f ~/res/mesh.yaml -v caType=builtin
To change the path of the config file, run kumactl with --config-file /new-path/config.
"""

[[commands.subcommand.field]]
id = "file"
label = "Resource file"
type = "path"
option = ["-f"]
path = { kind = "file", role = "input" }
sources = ["cli"]

[[commands.subcommand.field]]
id = "var"
label = "Template variable (key=value)"
type = "string"
option = ["-v"]
multiple = true
sources = ["cli"]

[[commands.subcommand.field]]
id = "config_file"
label = "kumactl config file"
type = "path"
option = ["--config-file"]
path = { kind = "file", role = "input" }
sources = ["cli"]

[[commands.subcommand.task]]
id = "apply"
label = "Apply a file"
fields = ["file", "var"]
required = ["file"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["file", "var", "config_file"]