id       = "dive"
name     = "Dive"
homepage = "https://github.com/wagoodman/dive"
description = "A tool for exploring each layer in a Docker image."
executables   = ["dive"]

[dotfiles]

# Dive's official README documents XDG_CONFIG_HOME/dive/*.yaml and the legacy
# ~/.dive.yaml location for UI configuration.
# https://github.com/wagoodman/dive
paths = ["[configHome]/dive/*.yaml", "~/.dive.yaml"]
secret = []

[commands]
format = 1
label = "Analyze image"
description = "Explore a container image layer by layer. Build mode (dive build) and CI rule files other than the config path are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/wagoodman/dive/blob/main/README.md"
evidence = """
dive <your-image-tag>
With the `--source` option, you can select where to fetch the container image from:
dive <your-image> --source <source>
- `docker`: Docker engine (the default option)
- `docker-archive`: A Docker Tar Archive from disk
- `podman`: Podman engine (linux only)
You can override the CI config path with the `--ci-config` option.
"""

[[commands.field]]
id = "image"
label = "Image tag, id or digest"
description = "For the docker-archive source this is a tar file path."
type = "string"
position = 0
sources = ["readme"]

[[commands.field]]
id = "source"
label = "Image source"
type = "enum"
option = ["--source"]
choices = [{ value = "docker", label = "Docker engine" }, { value = "docker-archive", label = "Docker tar archive" }, { value = "podman", label = "Podman engine (Linux only)" }]
sources = ["readme"]

[[commands.field]]
id = "ci_config"
label = "CI config file"
description = "Only used when CI=true is set in the environment."
type = "path"
option = ["--ci-config"]
path = { kind = "file", role = "input" }
sources = ["readme"]

[[commands.task]]
id = "analyze"
label = "Analyze an image"
fields = ["image", "source"]
required = ["image"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["image", "source", "ci_config"]