id          = "nexttrace"
name        = "NextTrace"
homepage    = "https://github.com/nxtrace/NTrace-core"
description = "An open source visual route tracking CLI tool."
executables      = ["nexttrace"]

[dotfiles]

# https://github.com/nxtrace/NTrace-core/blob/main/README.md documents the
# XDG_CONFIG_HOME search path: $XDG_CONFIG_HOME/nexttrace/nt_config.yaml. The
# configHome root follows that variable and its ~/.config default. nt_config.yaml
# contains reusable output/provider preferences; credentials are supplied through
# environment variables and the temporary `nexttrace -x` session files instead.
paths = ["[configHome]/nexttrace/nt_config.yaml"]

exclude = []
secret  = []

side_effect = false

[commands]
format = 1
label = "Trace route"
description = "Trace the network path to one host with traditional traceroute or MTR. Web console, speed test, Globalping, file targets and output logging are not in this form."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/nxtrace/NTrace-core"
revision = "README 2026-10-27"
evidence = """
  -4  --ipv4                         Use IPv4 only
  -6  --ipv6                         Use IPv6 only
  -T  --tcp                          Use TCP SYN for tracerouting (default
  -U  --udp                          Use UDP SYN for tracerouting (default
  -p  --port                         Set the destination port to use. With
  -q  --queries                      Traceroute: latency samples per hop
  -m  --max-hops
  -n  --no-rdns
  -j  --json
  -t  --mtr
  -r  --report
  -w  --wide
      --timeout                      Per-probe timeout [ms]. Raise to 2000-3000
  -C  --no-color
  -g|--language (en|cn)
  [-m|--max-hops <integer>] [-n|--no-rdns] [-j|--json] [-t|--mtr] [-r|--report] [-w|--wide] [-C|--no-color] [TARGET "<value>"]
nexttrace --first 5 --max-hops 10 www.decix.net
nexttrace -t --tcp --max-hops 20 --first 3 --no-rdns 8.8.8.8
"""

[[commands.field]]
id = "target"
label = "Target host or IP"
type = "string"
position = 0
sources = ["help"]

[[commands.field]]
id = "tcp"
label = "Use TCP SYN"
type = "boolean"
option = ["--tcp", "-T"]
sources = ["help"]

[[commands.field]]
id = "udp"
label = "Use UDP"
type = "boolean"
option = ["--udp", "-U"]
sources = ["help"]

[[commands.field]]
id = "ipv4"
label = "IPv4 only"
type = "boolean"
option = ["--ipv4", "-4"]
sources = ["help"]

[[commands.field]]
id = "ipv6"
label = "IPv6 only"
type = "boolean"
option = ["--ipv6", "-6"]
sources = ["help"]

[[commands.field]]
id = "port"
label = "Destination port"
type = "integer"
option = ["--port", "-p"]
sources = ["help"]

[[commands.field]]
id = "queries"
label = "Samples per hop"
type = "integer"
option = ["--queries", "-q"]
sources = ["help"]

[[commands.field]]
id = "max_hops"
label = "Max hops"
type = "integer"
option = ["--max-hops", "-m"]
sources = ["help"]

[[commands.field]]
id = "timeout"
label = "Per-probe timeout (ms)"
type = "integer"
option = ["--timeout"]
sources = ["help"]

[[commands.field]]
id = "no_rdns"
label = "Skip reverse DNS"
type = "boolean"
option = ["--no-rdns", "-n"]
sources = ["help"]

[[commands.field]]
id = "mtr"
label = "MTR mode"
type = "boolean"
option = ["--mtr", "-t"]
sources = ["help"]

[[commands.field]]
id = "report"
label = "MTR report"
type = "boolean"
option = ["--report", "-r"]
sources = ["help"]

[[commands.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json", "-j"]
sources = ["help"]

[[commands.field]]
id = "no_color"
label = "No color"
type = "boolean"
option = ["--no-color", "-C"]
sources = ["help"]

[[commands.task]]
id = "trace"
label = "Trace a host"
fields = ["target", "ipv4", "ipv6", "max_hops", "no_rdns"]
required = ["target"]

[[commands.task]]
id = "tcp443"
label = "TCP trace to port 443"
fields = ["target", "tcp", "port", "queries"]
required = ["target"]
set = { tcp = [true], port = [443] }

[[commands.task]]
id = "mtr_report"
label = "MTR report"
fields = ["target", "mtr", "report", "queries"]
required = ["target"]
set = { mtr = [true], report = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["target", "tcp", "udp", "ipv4", "ipv6", "port", "max_hops", "no_rdns"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["queries", "timeout", "mtr", "report", "json", "no_color"]