feat: Architecture enhancements - CLI framework, plugins, TUI, testing

[xaoscience]

Architecture Enhancements

This PR implements 8 major architecture improvements to transform git-control into a modern, extensible CLI toolkit.

Summary of Changes

1. ✅ Modular CLI Framework

• New gc entry point as unified command dispatcher
• Commands organized in commands/ directory
• Automatic command discovery and help generation
• Global flags support (--json, --quiet, --verbose)

2. ✅ Configuration System

• scripts/lib/config.sh - hierarchical config management
• Pure bash YAML parser (no external dependencies)
• Config hierarchy: global → project → CLI flags
• Locations: ~/.config/git-control/config.yaml, .gc-init.yaml

3. ✅ Plugin Architecture

• plugins/ directory with auto-discovery
• Plugin manifest format (plugin.yaml)
• gc plugin command for management
• Example plugin included as template

4. ✅ Interactive TUI Mode

• scripts/lib/tui.sh - rich terminal UI library
• Auto-detects gum → fzf → bash fallbacks
• Functions: tui_choose(), tui_confirm(), tui_input(), tui_spin()
• Works in any terminal environment

5. ✅ Output Format Support

• scripts/lib/output.sh - consistent output handling
• Modes: --json (machine), --quiet (minimal), --verbose (debug)
• Functions: out(), verbose(), debug(), json_output()

6. ✅ Install Script

• Single-file install.sh for easy distribution
• curl-pipe-bash installation support
• Options: --prefix, --bin, --uninstall, --upgrade
• Auto-installs bash aliases

7. ✅ Testing Framework

• bats-core integration with auto-install
• tests/lib/*.bats - unit tests for libraries
• tests/gc.bats - integration tests
• .github/workflows/test.yml - CI automation

8. ✅ Version Management

• scripts/lib/version.sh - version utilities
• gc version command with subcommands
• Update checking from GitHub releases
• CHANGELOG.md following Keep a Changelog format

New Files

gc                              # Main entry point
commands/
├── config.sh                   # Interactive config management
├── plugin.sh                   # Plugin management
├── status.sh                   # Status with output formats
└── version.sh                  # Version/update commands
scripts/lib/
├── config.sh                   # Config library
├── output.sh                   # Output format library
├── tui.sh                      # TUI library
└── version.sh                  # Version library
plugins/example/
├── plugin.yaml                 # Example plugin manifest
└── commands/hello.sh           # Example plugin command
tests/
├── gc.bats                     # Integration tests
├── run_tests.sh                # Test runner
└── lib/*.bats                  # Unit tests
config/
├── example-global.config.yaml  # Global config example
└── example-project.gc-init.yaml # Project config example
install.sh                      # Installer
CHANGELOG.md                    # Changelog
docs/INSTALL.md                 # Installation guide
docs/TESTING.md                 # Testing guide
.github/workflows/test.yml      # CI workflow

Installation (after merge)

curl -sSL https://raw.githubusercontent.com/xaoscience/git-control/Main/install.sh | bash

Usage Examples

gc --help                    # Show all commands
gc init                      # Initialize repo
gc config show               # Show configuration
gc config set defaults.license MIT  # Set config value
gc plugin list               # List plugins
gc version check             # Check for updates
gc status --json             # JSON output

Breaking Changes

None - all existing scripts remain functional.

Testing

./tests/run_tests.sh         # Run all tests

---

Closes: N/A (feature enhancement)