id       = "juju"
name     = "Juju"
homepage = "https://canonical.com/juju"
description = "DevOps management tool"
executables   = ["juju"]

[dotfiles]

# https://documentation.ubuntu.com/juju/2.9/howto/manage-clouds/ — client cloud
# definitions are written to JUJU_DATA, whose documented default is
# ~/.local/share/juju/clouds.yaml. https://documentation.ubuntu.com/juju/2.9/
# reference/credential/ documents the same data directory for credentials and
# identifies credentials.yaml as the file containing cloud authentication.
paths = ["~/.local/share/juju/clouds.yaml"]
secret = ["~/.local/share/juju/credentials.yaml"]

[commands]
format = 1
label = "Juju"
description = "Report model status. Other commands (deploy, integrate, ssh and so on) are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["status"]
label = "Show model status"
description = "Report the status of the model, optionally filtered by machine, application or unit."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://documentation.ubuntu.com/juju/latest/reference/juju-cli/list-of-juju-cli-commands/status/"
revision = "latest 2026-10-27"
evidence = """
juju status [options] [<selector> [...]]
--format
tabular
Specify output format (json|line|oneline|short|summary|tabular|yaml)
-m , --model
Model to operate in. Accepts [<controller name>:]<model name>|<model UUID>
-o , --output
Specify an output file
--relations
Show relations section in tabular output
--storage
Show storage section in tabular output
--utc
Display timestamps in the UTC timezone
--color
Use ANSI color codes in tabular output
-m , --model -o , --output (rendered as -m, -o)
"""

[[commands.subcommand.field]]
id = "selector"
label = "Selectors"
description = "Machine, application or unit names such as 0, mysql or mysql/0."
type = "string"
position = 0
multiple = true
sources = ["docs"]

[[commands.subcommand.field]]
id = "model"
label = "Model"
description = "[controller:]model name or model UUID."
type = "string"
option = ["--model", "-m"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "format"
label = "Output format"
type = "enum"
option = ["--format"]
choices = [{ value = "tabular", label = "Tabular" }, { value = "json", label = "JSON" }, { value = "yaml", label = "YAML" }, { value = "summary", label = "Summary" }, { value = "short", label = "Short" }, { value = "line", label = "Line" }, { value = "oneline", label = "One line" }]
sources = ["docs"]

[[commands.subcommand.field]]
id = "relations"
label = "Show relations"
type = "boolean"
option = ["--relations"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "storage"
label = "Show storage"
type = "boolean"
option = ["--storage"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "utc"
label = "UTC timestamps"
type = "boolean"
option = ["--utc"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "output"
label = "Output file"
type = "path"
option = ["--output", "-o"]
path = { kind = "file", role = "output" }
effect = "overwrite"
sources = ["docs"]

[[commands.subcommand.task]]
id = "full"
label = "Full status with relations and storage"
set = { relations = [true], storage = [true] }
fields = ["selector", "model", "relations", "storage"]
required = []

[[commands.subcommand.task]]
id = "json"
label = "Status as JSON"
set = { format = ["json"] }
lock = ["format"]
fields = ["selector", "model", "format", "output"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["selector", "model", "format", "relations", "storage"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["utc", "output"]