id          = "pueue"
name        = "Pueue"
homepage    = "https://github.com/Nukesor/pueue"
description = "Pueue is a command-line task management tool for sequential and parallel execution of long-running tasks."
executables      = ["pueue", "pueued"]

[dotfiles]

# Pueue's official source uses dirs::config_dir()/pueue/pueue.yml and
# pueue_aliases.yml, and dirs::data_local_dir()/pueue for state. The source
# also defines the daemon key and shared-secret files below.
# https://github.com/Nukesor/pueue/blob/main/pueue_lib/src/settings.rs
paths = [
  "[appData]/pueue/pueue.yml",
  "[appData]/pueue/pueue_aliases.yml",
]
exclude = ["[dataHome]/pueue/"]
secret = [
  "[dataHome]/pueue/shared_secret",
  "[dataHome]/pueue/certs/daemon.key",
]

[commands]
format = 1
label = "pueue"
description = "Queue a shell command with pueue add. Other subcommands, groups, dependencies and delays are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["add"]
label = "Queue a command"
description = "Add a command to the pueue queue. The daemon must be running."

[[commands.subcommand.source]]
id = "changelog"
kind = "manual"
url = "https://github.com/Nukesor/pueue/blob/main/CHANGELOG.md"
revision = "2026-10-27"
evidence = """
- `pueue add` Canonicalize `--working-directory` paths.
`pueue add --immediate install_something && pueue send 0 'y\\n'`
- Add `add --follow` flag that may be called in combination with `--immediate`
- Add the `--working-directory` parameter to the `pueue add` command
`task add --label $LABEL` option, which will be displayed when calling `pueue status`.
`--start-immediately` and `--stashed` collided.
"""

[[commands.subcommand.field]]
id = "command"
label = "Command"
description = "The command to queue, as one shell string (quote it)."
type = "string"
position = 0
min = 1
sources = ["changelog"]

[[commands.subcommand.field]]
id = "label"
label = "Label"
description = "Shown in pueue status."
type = "string"
option = ["--label"]
sources = ["changelog"]

[[commands.subcommand.field]]
id = "working_directory"
label = "Working directory"
type = "path"
option = ["--working-directory"]
path = { kind = "directory", role = "input" }
sources = ["changelog"]

[[commands.subcommand.field]]
id = "immediate"
label = "Start immediately"
type = "boolean"
option = ["--immediate"]
sources = ["changelog"]

[[commands.subcommand.field]]
id = "follow"
label = "Follow output (with immediate)"
type = "boolean"
option = ["--follow"]
sources = ["changelog"]

[[commands.subcommand.field]]
id = "stashed"
label = "Add as stashed"
type = "boolean"
option = ["--stashed"]
sources = ["changelog"]

[[commands.subcommand.task]]
id = "queue"
label = "Queue a command"
fields = ["command", "label"]
required = ["command"]

[[commands.subcommand.task]]
id = "run_now"
label = "Run now and follow"
fields = ["command", "immediate", "follow"]
required = ["command"]
set = { immediate = [true], follow = [true] }

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["command", "label", "working_directory"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["immediate", "follow", "stashed"]