id       = "encore"
name     = "Encore"
homepage = "https://encore.dev"
description = "Infrastructure orchestration from local to your cloud."
# Encore's own branding icon, from its site's branding assets.
icon     = "https://encore.dev/assets/branding/icons/icon-no-padding.svg"
executables   = ["encore"]

[dotfiles]

# internal/userconfig/files.go builds `userPaths`: $XDG_CONFIG_HOME/encore/config
# when that variable is set, otherwise <home>/.config/encore/config, plus
# <home>/.encoreconfig in either case. Both are read with koanf's TOML parser and
# a "." delimiter, so `run.browser` is written as `browser` under `[run]`.
# `user.Current().HomeDir` is used directly, so the ~/.config spelling is the one
# Windows uses too.
paths = [
  "~/.config/encore/config",
  "~/.encoreconfig",
]

# internal/conf/conf.go Dir(): $ENCORE_CONFIG_DIR, else os.UserConfigDir()/encore.
# Write() marshals the whole Config — the platform OAuth access and refresh
# token, plus the WireGuard keypair `wg.priv` — into `.auth_token` there.
# os.UserConfigDir() is the [appData] base directory: ~/Library/Application
# Support on macOS, the XDG config home on Linux and %APPDATA% on Windows.
secret = ["[appData]/encore/.auth_token"]

# conf.CacheDir() and conf.DataDir() are os.UserCacheDir()/encore/{cache,data}:
# the cached dev-dashboard bundle and the local database volumes.
# os.UserCacheDir() is the [cacheHome] base directory.
exclude = ["[cacheHome]/encore/"]

# userconfig re-reads the files behind a one-second cache on every command.
side_effect = false

# No machine_lines: the two keys the config defines (internal/userconfig/config.go)
# are `run.browser` and `llm_rules`, both preferences that should follow the user.

[commands]
format = 1
label = "Encore"
description = "Run, check, test and stream logs of an Encore app. Other subcommands are left out."
quality = "ai-draft"
base = "fig:encore"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/encore.ts"
license = "MIT"

[[commands.subcommand]]
path = ["run"]
label = "Run app"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/encore.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port", "-p"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "listen"
label = "Listen address"
type = "string"
option = ["--listen"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "watch"
label = "Live reload"
type = "boolean"
option = ["--watch", "-w"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "debug"
label = "Debug build"
type = "boolean"
option = ["--debug"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "tunnel"
label = "Tunnel"
type = "boolean"
option = ["--tunnel"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "run"
label = "Run locally"
fields = ["port", "watch"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["port", "watch"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["listen", "debug", "tunnel"]

[[commands.subcommand]]
path = ["check"]
label = "Check for compile errors"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/encore.ts"
license = "MIT"

[[commands.subcommand]]
path = ["test"]
label = "Run tests"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/encore.ts"
license = "MIT"

[[commands.subcommand]]
path = ["logs"]
label = "Stream logs"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/encore.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "env"
label = "Environment"
type = "string"
option = ["--env", "-e"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "json"
label = "Raw JSON"
type = "boolean"
option = ["--json"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "logs"
label = "Stream logs"
fields = ["env", "json"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["env", "json"]