id       = "jnv"
name     = "jnv"
homepage = "https://github.com/ynqa/jnv"
executables   = ["jnv"]

[dotfiles]

# jnv's official README documents dirs-based defaults: ~/.config/jnv on Linux,
# ~/Library/Application Support/jnv on macOS, and AppData\Roaming on Windows.
# https://github.com/ynqa/jnv#configuration
paths = [
  "[configHome]/jnv/config.toml",
  "[appData]/jnv/config.toml",
]
secret = []

[commands]
format = 1
label = "Explore JSON"
description = "Open a JSON file in the interactive jq filter navigator. Configuration-file contents are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/ynqa/jnv/blob/main/README.md"
revision = "2026-10-27"
evidence = """
Usage: jnv [OPTIONS] [INPUT]
Arguments:
  [INPUT]  Optional path to a JSON file. If not provided or if "-" is specified, reads from standard input
Options:
  -c, --config <CONFIG_FILE>             Path to the configuration file.
      --default-filter <DEFAULT_FILTER>  Default jq filter to apply to the input data
      --write-to-stdout                  Write the current JSON result to stdout when exiting
"""

[[commands.field]]
id = "input"
label = "JSON file"
description = "Reads standard input when empty."
type = "path"
path = { kind = "file", role = "input" }
position = 0
sources = ["help"]

[[commands.field]]
id = "config"
label = "Configuration file"
type = "path"
path = { kind = "file", role = "input" }
option = ["--config", "-c"]
sources = ["help"]

[[commands.field]]
id = "default_filter"
label = "Initial jq filter"
type = "string"
option = ["--default-filter"]
sources = ["help"]

[[commands.field]]
id = "write_to_stdout"
label = "Print result on exit"
description = "Write the current JSON result to stdout when exiting."
type = "boolean"
option = ["--write-to-stdout"]
sources = ["help"]

[[commands.task]]
id = "explore"
label = "Explore a file"
fields = ["input", "default_filter"]
required = ["input"]

[[commands.task]]
id = "filter_out"
label = "Filter and print result"
fields = ["input", "default_filter", "write_to_stdout"]
required = ["input"]
set = { write_to_stdout = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["input", "default_filter", "write_to_stdout"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["config"]