id          = "cobo-cli"
name        = "Cobo CLI"
homepage    = "https://github.com/CoboGlobal/cobo-cli"
description = "Command-line interface for building and managing Cobo WaaS integrations."
executables      = ["cobo"]

[dotfiles]

# Cobo's official Developer Hub says the CLI stores its default configuration
# at ~/.cobo/config.toml and uses it for environment, authentication, and key
# settings.  The file can contain API credentials and access tokens.
# https://www.cobo.com/developers/v2/developer-tools/cobo-cli/configuration
paths = []
secret = ["~/.cobo/config.toml"]
side_effect = false

[commands]
format = 1
label = "Run a Cobo command"
description = "Run a Cobo CLI command with its global options. The command name and its arguments are typed as given in the Cobo CLI documentation."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "manual"
url = "https://github.com/CoboGlobal/cobo-cli#readme"
revision = "2026-10-27"
evidence = """
cobo [OPTIONS] COMMAND [ARGS]...
- `-e, --env [dev|prod]`: Override the environment for this command.
- `-a, --auth [apikey|user|org]`: Override the authentication method for this command.
- `--enable-debug`: Enable debug mode for verbose logging.
- `--config-file FILEPATH`: Specify the path to the config file.
- `--spec PATH`: Path to a custom OpenAPI specification file.
Commands: app, auth, config, login, logout, get, post, put, delete, graphql, doc, env, logs, webhook, skill, open, keys
"""

[[commands.field]]
id = "command"
label = "Command"
type = "string"
position = 0
min = 1
suggestions = [{ value = "app", label = "app" }, { value = "auth", label = "auth" }, { value = "config", label = "config" }, { value = "login", label = "login" }, { value = "logout", label = "logout" }, { value = "get", label = "get" }, { value = "post", label = "post" }, { value = "put", label = "put" }, { value = "delete", label = "delete" }, { value = "graphql", label = "graphql" }, { value = "doc", label = "doc" }, { value = "env", label = "env" }, { value = "logs", label = "logs" }, { value = "webhook", label = "webhook" }, { value = "skill", label = "skill" }, { value = "open", label = "open" }, { value = "keys", label = "keys" }]
sources = ["help"]

[[commands.field]]
id = "args"
label = "Arguments"
description = "Subcommand and its arguments."
type = "string"
position = 1
multiple = true
sources = ["help"]

[[commands.field]]
id = "env"
label = "Environment"
type = "enum"
option = ["--env", "-e"]
choices = [{ value = "dev", label = "dev" }, { value = "prod", label = "prod" }]
sources = ["help"]

[[commands.field]]
id = "auth"
label = "Authentication method"
type = "enum"
option = ["--auth", "-a"]
choices = [{ value = "apikey", label = "apikey" }, { value = "user", label = "user" }, { value = "org", label = "org" }]
sources = ["help"]

[[commands.field]]
id = "debug"
label = "Debug logging"
type = "boolean"
option = ["--enable-debug"]
sources = ["help"]

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

[[commands.field]]
id = "spec"
label = "OpenAPI spec file"
type = "path"
option = ["--spec"]
path = { kind = "file", role = "input" }
sources = ["help"]

[[commands.task]]
id = "run"
label = "Run command"
fields = ["command", "args", "env", "auth"]
required = ["command"]

[[commands.task]]
id = "debug"
label = "Run with debug logging"
set = { debug = [true] }
fields = ["command", "args", "debug", "env"]
required = ["command"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["command", "args", "env", "auth"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["debug", "config_file", "spec"]