fix(completions): add git gtr completion command to solve zsh timing issue

[helizaga]

Summary by CodeRabbit

• New Features

  • Added a built-in "completion" command to generate shell completions and made that command itself tab-completable for Bash, Zsh, and Fish.

• Documentation

  • Simplified completion setup to use runtime generation (one-line commands for Bash/Zsh and redirect for Fish), removed manual file/symlink steps, and clarified troubleshooting and Zsh ordering notes.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Adds a runtime completion command git gtr completion <shell> with generation for bash, zsh, and fish; updates completion scripts to include the new subcommand and revises documentation to show dynamic invocation (source/eval/write) instead of manual file installs.

Changes

Cohort / File(s)	Summary
Core Implementation bin/gtr	Added cmd_completion() and dispatcher entry to emit shell-specific completion scripts at runtime
Completion Definitions completions/_git-gtr, completions/gtr.bash, completions/git-gtr.fish	Registered new completion subcommand and added shell-name argument completions (bash, zsh, fish) for zsh, bash, and fish completion files
Documentation README.md, docs/configuration.md	Reworked shell completions guidance to use runtime generation (examples: source <(git gtr completion bash), eval "$(git gtr completion zsh)", git gtr completion fish > <path>/.../git-gtr.fish) and updated troubleshooting link

Sequence Diagram(s)

sequenceDiagram
  participant User as User
  participant Shell as Shell (interactive)
  participant GTR as git gtr

  User->>Shell: run "source <(git gtr completion bash)"\nor "eval \"$(git gtr completion zsh)\"" or "git gtr completion fish > /path/.../git-gtr.fish"
  Shell->>GTR: execute "git gtr completion <shell>"
  GTR-->>Shell: output generated completion script
  Shell->>Shell: evaluate or write completion script (register completions)
  Shell-->>User: completions available for "git gtr"

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• fix(completions): add git gtr completion command to solve zsh timing issue #87 — Adds cmd_completion() handler and updates completions/docs to expose the completion subcommand.

Suggested reviewers

• NatoBoram

Poem

🐰 Hopping through the terminal bright,

I print completions through the night,
Source, eval, or write with glee,
Tab-complete now, swift and free,
— a rabbit's code-made light ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding a new git gtr completion command to address a zsh timing issue with shell completions.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/zsh-completion-timing

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@docs/configuration.md`:
- Around line 340-342: Update the docs to ensure the target completions
directory exists before redirecting the output of the git gtr completion fish
command: explicitly create the directory ~/.config/fish/completions (using the
mkdir -p pattern) prior to writing to ~/.config/fish/completions/git-gtr.fish so
the redirect cannot fail on fresh systems.