feat(cli): implement VSR CLI tool for semantic router management

This PR introduces the VSR (vLLM Semantic Router) CLI tool - a comprehensive
command-line interface that reduces setup time from hours to minutes and provides
a unified interface for deployment, monitoring, and troubleshooting across multiple
environments.

## Key Features

### Core Commands
- **deploy**: Multi-environment deployment (Local, Docker Compose, Kubernetes, Helm)
- **config**: Configuration management with validation and templates
- **model**: Model lifecycle management (download, list, validate, remove, inspect)
- **status**: Health monitoring and status checks
- **debug**: Interactive debugging and diagnostic tools
- **dashboard**: Dashboard management and access
- **test**: Prompt testing and validation
- **upgrade**: Seamless version upgrades
- **get**: Resource inspection (logs, pods, services)

### Implementation Details
- Built with Go and Cobra framework for robust CLI experience
- Comprehensive test coverage with 3,400+ lines of test code
- Support for multiple deployment targets with environment detection
- Process lifecycle management with orphan process prevention
- Integrated health checking and diagnostics
- Shell completion support (bash, zsh, fish, powershell)

### Documentation
- Complete CLI documentation with quickstart guide
- Command reference with examples
- Troubleshooting guide
- Integration with existing semantic-router documentation

### Files Changed
- 49 files changed, 11,531 insertions(+), 16 deletions(-)
- New CLI implementation in src/semantic-router/cmd/vsr/
- New CLI packages in src/semantic-router/pkg/cli/
- Documentation in website/docs/cli/
- Build system integration in tools/make/build-run-test.mk

Resolves #234

Signed-off-by: Srinivas A <[email protected]>

Author: srini-abhiram

README.md

@@ -93,7 +93,58 @@ Watch the quick demo of the dashboard below:
 
 ## Quick Start 🚀
 
-Get up and running in seconds with our interactive setup script:
+### Using VSR CLI (Recommended)
+
+The `vsr` CLI tool provides a unified interface for managing the vLLM Semantic Router across all environments. It reduces setup time from hours to minutes with intelligent auto-detection, comprehensive diagnostics, and beautiful CLI output.
+
+#### Installation
+
+```bash
+# Clone and build
+cd semantic-router/src/semantic-router
+make build-cli
+export PATH=$PATH:$(pwd)/bin
+
+# Verify installation
+vsr --version
+```
+
+#### Get Started in 4 Commands
+
+```bash
+vsr init                    # Initialize configuration
+make download-models        # Download AI models
+vsr config validate        # Validate setup
+vsr deploy docker          # Deploy with Docker Compose
+```
+
+#### Key Features
+
+- **Multi-Environment Support**: Deploy to Local, Docker, Kubernetes, or Helm
+- **Model Management**: Download, validate, list, and inspect models
+- **Health Monitoring**: Status checks, diagnostics, and health reports
+- **Debug Tools**: Interactive debugging and troubleshooting
+- **Dashboard Integration**: Auto-detect and open dashboard in browser
+- **Enhanced Logging**: Multi-environment log fetching with filtering
+
+#### Common Commands
+
+```bash
+vsr status                  # Check deployment status
+vsr logs --follow          # View logs in real-time
+vsr health                 # Quick health check
+vsr dashboard              # Open dashboard
+vsr model list             # List available models
+vsr debug                  # Run diagnostics
+vsr upgrade docker         # Upgrade deployment
+vsr undeploy docker        # Stop deployment
+```
+
+For complete CLI documentation, see [src/semantic-router/cmd/vsr/README.md](src/semantic-router/cmd/vsr/README.md) or [Quick Start Guide](src/semantic-router/cmd/vsr/QUICKSTART.md).
+
+### Using Quickstart Script
+
+Alternatively, get up and running in seconds with our interactive setup script:
 
 ```bash
 bash ./scripts/quickstart.sh

src/semantic-router/cmd/vsr/QUICKSTART.md

@@ -0,0 +1,165 @@
+# VSR Quick Start Guide
+
+Get the vLLM Semantic Router up and running in minutes.
+
+## Prerequisites
+
+- **Go 1.21+** (for building)
+- **Docker** (for Docker deployments)
+- **kubectl** (for Kubernetes deployments)
+- **Helm** (for Helm deployments)
+
+## 1. Build VSR
+
+```bash
+cd semantic-router/src/semantic-router
+make build-cli
+export PATH=$PATH:$(pwd)/bin
+```
+
+## 2. Initialize Configuration
+
+```bash
+vsr init
+```
+
+This creates `config/config.yaml`. Edit it to configure your model and endpoints.
+
+## 3. Download Models
+
+```bash
+make download-models
+```
+
+## 4. Validate Configuration
+
+```bash
+vsr config validate
+```
+
+Fix any errors reported before proceeding.
+
+## 5. Deploy
+
+Choose your deployment environment:
+
+### Local (Development)
+
+```bash
+vsr deploy local
+```
+
+### Docker Compose (Recommended)
+
+```bash
+vsr deploy docker
+```
+
+### Kubernetes
+
+```bash
+vsr deploy kubernetes --namespace default
+```
+
+### Helm
+
+```bash
+vsr deploy helm --namespace default
+```
+
+## 6. Check Status
+
+```bash
+vsr status
+```
+
+## 7. Test the Router
+
+```bash
+vsr test-prompt "What is the weather today?"
+```
+
+## 8. View Logs
+
+```bash
+vsr logs --follow
+```
+
+## Common Commands
+
+| Command | Purpose |
+|---------|---------|
+| `vsr status` | Check deployment status |
+| `vsr logs` | View logs |
+| `vsr health` | Quick health check |
+| `vsr dashboard` | Open dashboard in browser |
+| `vsr model list` | List available models |
+| `vsr undeploy [env]` | Stop deployment |
+| `vsr upgrade [env]` | Upgrade to latest version |
+| `vsr debug` | Run diagnostics |
+
+## Troubleshooting
+
+### Configuration Issues
+
+```bash
+vsr config validate --verbose
+```
+
+### Deployment Issues
+
+```bash
+vsr debug
+```
+
+### Port Conflicts
+
+Check which ports are in use:
+
+```bash
+vsr debug
+```
+
+### Can't Connect to Dashboard
+
+```bash
+# For Docker/Local
+vsr dashboard
+
+# For Kubernetes/Helm
+vsr dashboard --namespace [your-namespace]
+```
+
+## Next Steps
+
+- Read the [full documentation](README.md) for advanced features
+- Learn about [model management](README.md#model-commands)
+- Explore [deployment options](README.md#-deployment)
+- Set up [monitoring and metrics](README.md#monitoring-commands)
+
+## Getting Help
+
+```bash
+# General help
+vsr --help
+
+# Command-specific help
+vsr deploy --help
+vsr model --help
+```
+
+## Quick Reference
+
+```bash
+# Full workflow
+vsr init                        # Initialize config
+make download-models            # Download models
+vsr config validate            # Validate
+vsr deploy docker              # Deploy
+vsr status                     # Check status
+vsr test-prompt "hello"        # Test
+vsr logs --follow              # Monitor
+vsr undeploy docker            # Clean up
+```
+
+For complete documentation, see [README.md](README.md).