id          = "e1s"
name        = "e1s"
homepage    = "https://github.com/keidarcy/e1s"
description = "Terminal application to browse and manage AWS ECS resources"
executables      = ["e1s"]

[dotfiles]

# The upstream README documents the default Viper configuration file at
# ~/.config/e1s/config.yml. AWS credentials are read from the standard AWS
# files and are not stored by e1s itself.
# https://github.com/keidarcy/e1s
paths = ["~/.config/e1s/config.yml"]
secret = []
side_effect = false

[commands]
format = 1
label = "Browse ECS resources"
description = "Start the e1s terminal UI against an AWS profile, region, cluster and service. Theme, SSM custom command and startup splash options are not covered."
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/keidarcy/e1s#usage"
revision = "2026-10-27"
evidence = """
Usage:
  e1s [flags]

Flags:
      --cluster string         specify the default cluster
  -c, --config-file string     config file (default "$HOME/.config/e1s/config.yml")
  -d, --debug                  sets debug mode
      --exec-mode string       execution mode for ECS containers: ecs or ssm (default "ecs")
  -j, --json                   log output json format
  -l, --log-file string        specify the log file path (default "${TMPDIR}e1s.log")
      --profile string         specify the AWS profile
      --read-only              sets read only mode
  -r, --refresh int            specify the default refresh rate as an integer, sets -1 to stop auto refresh (sec) (default 30)
      --region string          specify the AWS region
      --service string         specify the default service (requires --cluster)
  -s, --shell string           specify interactive ecs exec shell (default "/bin/sh")
"""

[[commands.field]]
id = "profile"
label = "AWS profile"
type = "string"
option = ["--profile"]
sources = ["help"]

[[commands.field]]
id = "region"
label = "AWS region"
type = "string"
option = ["--region"]
suggestions = [{ value = "us-east-1", label = "us-east-1" }, { value = "us-east-2", label = "us-east-2" }, { value = "us-west-2", label = "us-west-2" }, { value = "eu-west-1", label = "eu-west-1" }]
sources = ["help"]

[[commands.field]]
id = "cluster"
label = "Default cluster"
type = "string"
option = ["--cluster"]
sources = ["help"]

[[commands.field]]
id = "service"
label = "Default service"
description = "Requires a default cluster."
type = "string"
option = ["--service"]
sources = ["help"]

[[commands.field]]
id = "read_only"
label = "Read-only mode"
type = "boolean"
option = ["--read-only"]
sources = ["help"]

[[commands.field]]
id = "refresh"
label = "Refresh rate (seconds)"
description = "Use -1 to stop auto refresh."
type = "integer"
option = ["--refresh", "-r"]
sources = ["help"]

[[commands.field]]
id = "exec_mode"
label = "Exec mode"
type = "enum"
option = ["--exec-mode"]
choices = [{ value = "ecs", label = "ECS Exec" }, { value = "ssm", label = "SSM" }]
sources = ["help"]

[[commands.field]]
id = "shell"
label = "Exec shell"
type = "string"
option = ["--shell", "-s"]
suggestions = [{ value = "/bin/sh", label = "/bin/sh" }, { value = "/bin/bash", label = "/bin/bash" }]
sources = ["help"]

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

[[commands.field]]
id = "debug"
label = "Debug mode"
type = "boolean"
option = ["--debug", "-d"]
sources = ["help"]

[[commands.field]]
id = "log_file"
label = "Log file"
type = "path"
option = ["--log-file", "-l"]
path = { kind = "file", role = "output", must_exist = false }
effect = "overwrite"
sources = ["help"]

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

[[commands.task]]
id = "browse"
label = "Browse a cluster"
fields = ["profile", "region", "cluster", "service"]
required = ["profile", "region"]

[[commands.task]]
id = "read_only"
label = "Browse read-only"
fields = ["profile", "region", "read_only"]
required = ["read_only"]
set = { read_only = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["profile", "region", "cluster", "service", "read_only", "refresh"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["exec_mode", "shell", "config_file", "debug", "log_file", "json"]