id       = "ggc"
name     = "ggc"
homepage = "https://github.com/bmf-san/ggc"
description = "Scriptable Git shortcuts with a searchable workflow builder."
executables   = ["ggc"]

[dotfiles]

# The project's configuration guide documents the XDG path, the ~/.config
# default, the legacy ~/.ggcconfig.yaml path, and %APPDATA% on Windows:
# https://bmf-san.github.io/ggc/guide/config/
paths = [
  "[configHome]/ggc/config.yaml",
  "~/.ggcconfig.yaml",
  "%APPDATA%/ggc/config.yaml",
]
secret = []

[commands]
format = 1
label = "ggc Git shortcuts"
description = "Stage files, commit and create branches with ggc. Destructive commands (reset, clean, branch delete) and the interactive picker are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]
path = ["add"]
label = "Stage files"

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://bmf-san.github.io/ggc/guide/commands/"
revision = "2026-10-27"
evidence = """
ggc add <file>
ggc add file.txt   # Add a specific file
ggc add .          # Add all changes to index
"""

[[commands.subcommand.field]]
id = "files"
label = "Files"
description = "Use . to stage everything."
type = "path"
path = { kind = "any", role = "input" }
position = 0
multiple = true
suggestions = [{ value = ".", label = "All changes" }]
sources = ["docs"]

[[commands.subcommand.task]]
id = "stage"
label = "Stage files"
fields = ["files"]
required = ["files"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["files"]

[[commands.subcommand]]
path = ["commit"]
label = "Commit"

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://bmf-san.github.io/ggc/guide/commands/"
revision = "2026-10-27"
evidence = """
ggc commit <message>
ggc commit "Update docs"        # Create commit with a message
"""

[[commands.subcommand.field]]
id = "message"
label = "Commit message"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.task]]
id = "commit"
label = "Commit staged changes"
fields = ["message"]
required = ["message"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["message"]

[[commands.subcommand]]
path = ["branch", "create"]
label = "Create and switch to a branch"

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://bmf-san.github.io/ggc/guide/commands/"
revision = "2026-10-27"
evidence = """
ggc branch create feature/login   # Create and checkout new branch
"""

[[commands.subcommand.field]]
id = "name"
label = "Branch name"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.task]]
id = "create"
label = "Create branch"
fields = ["name"]
required = ["name"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name"]