feat: Add shell completion support for Bash, Zsh, and Fish

[TWUW-b]

Summary

Implement tab completion functionality for the bmc command across all major shells (Bash, Zsh, Fish).

Features

• Bash completion (completions/bmc.bash)

  • Command and bookmark name completion
  • Tag completion for list --tag
  • Support for all aliases

• Zsh completion (completions/_bmc)

  • Detailed argument parsing with _arguments
  • Command descriptions
  • Alias normalization

• Fish completion (completions/bmc.fish)

  • Visual feedback
  • Rule-based completion definitions
  • Auto-loading from ~/.config/fish/completions/

• Test suite (tests/test_completion.bats)

  • Output parsing tests
  • Syntax validation
  • Performance tests

Implementation

• Leverages existing bmc list output (no core code changes)
• Uses NO_COLOR=1 for clean parsing
• Handles all command aliases (g/go, rm/remove, etc.)
• Supports bm command alias

Usage Examples

bmc <TAB>            # Show all commands
bmc g <TAB>          # Show bookmark list
bmc g sam<TAB>       # Complete to 'sample-project'
bmc list --tag <TAB> # Show available tags

Setup

Setup instructions for all three shells have been added to README.md.

Bash

source ~/.local/share/bookmark-cli/completions/bmc.bash

Zsh

fpath=(~/.local/share/bookmark-cli/completions $fpath)
autoload -Uz compinit && compinit

Fish

ln -s ~/.local/share/bookmark-cli/completions/bmc.fish ~/.config/fish/completions/

Test Plan

• Bash completion syntax validated
• Zsh completion syntax validated
• Bookmark name extraction tested
• All completion scripts created
• README.md updated with setup instructions
• Test suite created

Changes

• Added completions/bmc.bash (101 lines)
• Added completions/_bmc (123 lines)
• Added completions/bmc.fish (87 lines)
• Added tests/test_completion.bats (108 lines)
• Updated README.md (61 lines added)

Total: 480 insertions

[code-retriever]

Awesome work!