Merge pull request #285 from finos/feat/provider-extension-points

feat(providers): extension points, orthogonal filter flags, and provider-agnostic resilience

Author: fgogolli

docs/root/api/multi-provider-api.md

@@ -754,24 +754,24 @@ Fields by Source:
 #### Validate Templates
 ```bash
 # Validate template against provider
-orb templates validate web-server --provider aws-us-east-1
+orb templates validate web-server --provider-name aws-us-east-1
 
 # Validate with strict mode
-orb templates validate web-server --provider aws-us-east-1 --strict
+orb templates validate web-server --provider-name aws-us-east-1 --strict
 
 # Validate against multiple providers
 orb templates validate web-server --providers aws-us-east-1,aws-us-west-2
 
 # Validate all templates
-orb templates validate --all --provider aws-us-east-1
+orb templates validate --all --provider-name aws-us-east-1
 ```
 
 ### Request Management
 
 #### Create Requests with Provider Selection
 ```bash
 # Create request with explicit provider
-orb requests create --template web-server --count 5 --provider aws-us-east-1
+orb requests create --template web-server --count 5 --provider-name aws-us-east-1
 
 # Create request with provider type (load balanced)
 orb requests create --template web-server --count 5 --provider-type aws

docs/root/architecture/multi-provider-design.md

@@ -347,7 +347,7 @@ orb templates list --provider-name aws-us-east-1
 orb templates show web-server --source-info
 
 # Validate template against provider
-orb templates validate web-server --provider aws-us-east-1
+orb templates validate web-server --provider-name aws-us-east-1
 ```
 
 ## Error Handling and Validation
@@ -429,7 +429,7 @@ orb templates validate web-server --provider aws-us-east-1
 orb templates migrate --from templates.json --to-provider aws-us-east-1
 
 # Validate migrated templates
-orb templates validate --all --provider aws-us-east-1
+orb templates validate --all --provider-name aws-us-east-1
 ```
 
 ## Best Practices

docs/root/cli/README.md

@@ -5,7 +5,7 @@ Complete documentation for the Open Resource Broker command-line interface.
 ## Quick Reference
 
 - **[CLI Reference](cli-reference.md)** - Complete command and flag reference
-- **[Provider Override](provider-override.md)** - Using `--provider` flag functionality  
+- **[Provider Override](provider-override.md)** - Using `--provider-name` flag functionality  
 - **[Multi-Provider Templates](multi-provider-templates.md)** - Multi-provider template generation
 
 ## Detailed Guides
@@ -17,7 +17,7 @@ Complete documentation for the Open Resource Broker command-line interface.
 
 ### Global Overrides
 - **`--scheduler`** - Override scheduler strategy for any command
-- **`--provider`** - Override provider instance for any command
+- **`--provider-name`** - Override provider instance for any command
 - **`--format`** - Control output format (json, yaml, table, list)
 
 ### Argument Patterns
@@ -27,14 +27,14 @@ Complete documentation for the Open Resource Broker command-line interface.
 
 ### Multi-Provider Support
 - **Default Generation** - `orb templates generate` (all active providers)
-- **Specific Provider** - `orb templates generate --provider aws-prod`
+- **Specific Provider** - `orb templates generate --provider-name aws-prod`
 - **Specific API** - `orb templates generate --provider-api EC2Fleet`
 
 ## Common Commands
 
 ### Setup and Configuration
 ```bash
-orb init --scheduler hostfactory --provider aws --region us-east-1
+orb init --scheduler hostfactory --provider-type aws --region us-east-1
 orb config show --format yaml
 orb system health --detailed
 ```
@@ -56,8 +56,8 @@ orb requests status req-123
 ### Provider Operations
 ```bash
 orb providers list --detailed --format table
-orb --provider aws-prod providers health
-orb --provider aws-dev templates generate
+orb --provider-name aws-prod providers health
+orb --provider-name aws-dev templates generate
 ```
 
 ## Getting Started
@@ -92,12 +92,12 @@ orb --provider aws-dev templates generate
 ### Environment-Specific Operations
 ```bash
 # Development
-orb --provider aws-dev templates generate --provider-api SpotFleet
-orb --provider aws-dev machines request spot-template 5
+orb --provider-name aws-dev templates generate --provider-api SpotFleet
+orb --provider-name aws-dev machines request spot-template 5
 
 # Production  
-orb --provider aws-prod templates generate --provider-api EC2Fleet
-orb --provider aws-prod machines request prod-template 10
+orb --provider-name aws-prod templates generate --provider-api EC2Fleet
+orb --provider-name aws-prod machines request prod-template 10
 ```
 
 ### Scheduler Comparison

docs/root/cli/cli-reference.md

@@ -24,7 +24,7 @@ Available for all commands:
 | `--region` | AWS region override | `--region us-west-2` |
 | `--profile` | AWS profile override | `--profile production` |
 | `--scheduler` | Override scheduler strategy (`default`, `hostfactory`, `hf`) | `--scheduler hostfactory` |
-| `--provider` | Override provider instance | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Override provider instance by name | `--provider-name aws_prod_us-east-1` |
 | `--completion` | Generate shell completion script (`bash`, `zsh`) | `--completion bash` |
 | `--version` | Show version and exit | `--version` |
 
@@ -226,7 +226,7 @@ orb templates generate [OPTIONS]
 **Options:**
 | Flag | Description | Example |
 |------|-------------|---------|
-| `--provider` | Generate for specific provider instance | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Generate for specific provider instance | `--provider-name aws_prod_us-east-1` |
 | `--all-providers` | Explicitly generate for all active providers | `--all-providers` |
 | `--provider-api` | Specific provider API | `--provider-api EC2Fleet` |
 
@@ -236,7 +236,7 @@ orb templates generate [OPTIONS]
 orb templates generate
 
 # Generate for specific provider
-orb templates generate --provider aws_prod_us-east-1
+orb templates generate --provider-name aws_prod_us-east-1
 
 # Generate for specific API
 orb templates generate --provider-api SpotFleet
@@ -768,7 +768,7 @@ orb providers show [OPTIONS]
 | Flag | Description | Example |
 |------|-------------|---------|
 | `--format` | Output format | `--format yaml` |
-| `--provider` | Show specific provider details | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Show specific provider details | `--provider-name aws_prod_us-east-1` |
 
 #### `providers health`
 
@@ -783,7 +783,7 @@ orb providers health [OPTIONS]
 | Flag | Description | Example |
 |------|-------------|---------|
 | `--format` | Output format | `--format table` |
-| `--provider` | Check specific provider health | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Check specific provider health | `--provider-name aws_prod_us-east-1` |
 
 #### `providers add`
 
@@ -923,7 +923,7 @@ orb providers exec OPERATION [OPTIONS]
 **Options:**
 | Flag | Description | Example |
 |------|-------------|---------|
-| `--provider` | Provider to execute operation on | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Provider to execute operation on | `--provider-name aws_prod_us-east-1` |
 | `--params` | Operation parameters (JSON format) | `--params '{"count":5}'` |
 
 #### `providers metrics`
@@ -939,7 +939,7 @@ orb providers metrics [OPTIONS]
 | Flag | Description | Example |
 |------|-------------|---------|
 | `--format` | Output format | `--format table` |
-| `--provider` | Show metrics for specific provider | `--provider aws_prod_us-east-1` |
+| `--provider-name` | Show metrics for specific provider | `--provider-name aws_prod_us-east-1` |
 
 ### Storage
 
@@ -1235,7 +1235,7 @@ orb init [OPTIONS]
 | `--non-interactive` | Non-interactive mode | `--non-interactive` |
 | `--force` | Force overwrite existing config | `--force` |
 | `--scheduler` | Scheduler type | `--scheduler hostfactory` |
-| `--provider` | Provider type | `--provider aws` |
+| `--provider-type` | Provider type | `--provider-type aws` |
 | `--region` | AWS region | `--region us-west-2` |
 | `--profile` | AWS profile | `--profile production` |
 | `--config-dir` | Custom configuration directory | `--config-dir /custom/config` |
@@ -1250,7 +1250,7 @@ orb init [OPTIONS]
 **Examples:**
 ```bash
 # Interactive init (discovers infrastructure from AWS)
-orb init --scheduler hostfactory --provider aws --region us-east-1
+orb init --scheduler hostfactory --provider-type aws --region us-east-1
 
 # Non-interactive init with pre-known infrastructure values
 orb init --non-interactive --region us-east-1 \
@@ -1323,17 +1323,17 @@ orb --scheduler hf requests status req-123
 
 ### Provider Override
 
-Use `--provider` to override the selected provider instance for any command:
+Use `--provider-name` to override the selected provider instance for any command:
 
 ```bash
 # Use specific provider instance
-orb --provider aws_prod_us-east-1 templates list
+orb --provider-name aws_prod_us-east-1 templates list
 
 # Override for machine requests
-orb --provider aws_dev_us-east-1 machines request template-id 3
+orb --provider-name aws_dev_us-east-1 machines request template-id 3
 
 # Combined with scheduler override
-orb --scheduler hostfactory --provider aws_prod_us-east-1 requests status req-123
+orb --scheduler hostfactory --provider-name aws_prod_us-east-1 requests status req-123
 ```
 
 **Provider Instance Names:**
@@ -1358,7 +1358,7 @@ orb templates generate
 ### Provider-Specific Generation
 ```bash
 # Generate for specific provider instance
-orb templates generate --provider aws_prod_us-east-1
+orb templates generate --provider-name aws_prod_us-east-1
 
 # Generate for specific provider API
 orb templates generate --provider-api EC2Fleet
@@ -1450,7 +1450,7 @@ orb --completion zsh > ~/.zsh/completions/_orb
 ### Basic Workflow
 ```bash
 # Initialize configuration
-orb init --scheduler hostfactory --provider aws --region us-east-1
+orb init --scheduler hostfactory --provider-type aws --region us-east-1
 
 # Generate example templates
 orb templates generate
@@ -1474,10 +1474,10 @@ orb system health --detailed
 orb templates generate --all-providers
 
 # Use specific provider
-orb --provider aws_prod_us-east-1 machines request template-id 5
+orb --provider-name aws_prod_us-east-1 machines request template-id 5
 
 # Check provider health
-orb providers health --provider aws_prod_us-east-1
+orb providers health --provider-name aws_prod_us-east-1
 ```
 
 ### Development Workflow

docs/root/cli/infrastructure-commands.md

@@ -35,7 +35,7 @@ orb infra discover [OPTIONS]
 | `--show` | Display specific resource types without updating config: `vpcs`, `subnets`, `security-groups` (or `sg`), or `all` | `--show subnets` |
 | `--summary` | Show only counts per resource type, no details | `--summary` |
 | `--all-providers` | Run discovery across all configured providers | `--all-providers` |
-| `--provider` | Run discovery for a specific provider instance | `--provider aws-prod` |
+| `--provider-name` | Run discovery for a specific provider instance | `--provider-name aws-prod` |
 | `--region` | AWS region override | `--region eu-west-1` |
 | `--profile` | AWS profile override | `--profile production` |
 
@@ -57,7 +57,7 @@ orb infrastructure discover --show security-groups
 orb infrastructure discover --summary
 
 # Discover for a specific provider
-orb infrastructure discover --provider aws-prod
+orb infrastructure discover --provider-name aws-prod
 
 # Discover across all providers
 orb infrastructure discover --all-providers
@@ -103,7 +103,7 @@ orb infra show [OPTIONS]
 | Flag | Description | Example |
 |------|-------------|---------|
 | `--all-providers` | Show configuration for all providers | `--all-providers` |
-| `--provider` | Show configuration for a specific provider | `--provider aws-prod` |
+| `--provider-name` | Show configuration for a specific provider | `--provider-name aws-prod` |
 | `--format` | Output format (`json`, `yaml`, `table`) | `--format table` |
 
 **Examples:**
@@ -145,7 +145,7 @@ orb infra validate [OPTIONS]
 **Options:**
 | Flag | Description | Example |
 |------|-------------|---------|
-| `--provider` | Validate for a specific provider | `--provider aws-prod` |
+| `--provider-name` | Validate for a specific provider | `--provider-name aws-prod` |
 | `--region` | AWS region override | `--region us-east-1` |
 | `--profile` | AWS profile override | `--profile production` |
 | `--format` | Output format | `--format table` |
@@ -156,7 +156,7 @@ orb infra validate [OPTIONS]
 orb infrastructure validate
 
 # Validate for a specific provider
-orb infrastructure validate --provider aws-prod
+orb infrastructure validate --provider-name aws-prod
 ```
 
 Validation checks that each configured resource ID resolves in AWS. Resources that no longer exist (deleted subnets, removed security groups) are reported so you can re-run discovery and update your config.