id          = "netwatch"
name        = "NetWatch"
homepage    = "https://www.netwatchlabs.com/labs/netwatch"
description = "Cross-platform realtime network diagnostics TUI."
executables      = ["netwatch"]

[dotfiles]

# NetWatch's official source documents NetwatchConfig::path() as
# dirs::config_dir()/netwatch/config.toml: ~/.config on Linux,
# ~/Library/Application Support on macOS, and %APPDATA% on Windows.
# https://raw.githubusercontent.com/matthart1983/netwatch/main/src/config.rs
paths = ["[configHome]/netwatch/config.toml"]

# Runtime cache is explicitly written below the XDG cache directory and is
# rebuildable machine state, not user configuration.
# https://github.com/matthart1983/netwatch/blob/main/docs/REFERENCE.md
exclude = ["[xdgCache]/netwatch/"]
secret  = []

[commands]
format = 1
label = "Start NetWatch"
description = "Start the TUI in a chosen view, or the demo replay. Daemon, diagnose, doctor, uptime and remote streaming are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "help"
kind = "manual"
url = "https://raw.githubusercontent.com/matthart1983/netwatch/HEAD/docs/REFERENCE.md"
revision = "HEAD 2026-10"
evidence = """
| `--view full|lite|dense`, `--lite` | Start in that view. |
| `--demo` | Replay a recorded Diagnose incident instead of watching this host. |
| `--no-sandbox`, `--sandbox-strict` | Turn the Linux sandbox off, or refuse to start unless it is enforced. |
"""

[[commands.field]]
id = "view"
label = "View"
type = "enum"
option = ["--view"]
choices = [{ value = "full", label = "Full" }, { value = "lite", label = "Lite (80x24)" }, { value = "dense", label = "Dense (130x44+)" }]
sources = ["help"]

[[commands.field]]
id = "demo"
label = "Demo replay"
description = "Replay a recorded incident instead of watching this host."
type = "boolean"
option = ["--demo"]
sources = ["help"]

[[commands.field]]
id = "sandbox_strict"
label = "Require Linux sandbox (Linux only)"
type = "boolean"
option = ["--sandbox-strict"]
sources = ["help"]

[[commands.task]]
id = "dense"
label = "Dense view"
fields = ["view"]
set = { view = ["dense"] }

[[commands.task]]
id = "demo"
label = "Try the demo"
fields = ["demo"]
set = { demo = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["view", "demo", "sandbox_strict"]