feat(routing): publish provider selection modes

charts/grid-operator/crds/gridnetwork.yaml

@@ -381,6 +381,24 @@ spec:
                   items:
                     type: string
                   type: array
+                selectionPolicy:
+                  description: |-
+                    Local request distribution policy for the active selection group.
+
+                    This is independent of scoring. When absent, the overlay carries no
+                    selection override and Praxis uses deterministic selection.
+                  nullable: true
+                  properties:
+                    mode:
+                      description: Local selection mode used by the data-plane gateway.
+                      enum:
+                        - deterministic
+                        - roundRobin
+                        - random
+                      type: string
+                  required:
+                    - mode
+                  type: object
                 staleCandidateTtlSeconds:
                   description: |-
                     Maximum age in seconds before a stale (`fresh=false`) remote routing

charts/grid-site/templates/gridnetwork.yaml

@@ -1,4 +1,15 @@
 {{- if .Values.gridNetwork.name }}
+{{- $existing := lookup "grid.praxis-proxy.io/v1alpha1" "GridNetwork" .Release.Namespace .Values.gridNetwork.name }}
+{{- $configuredSelectionPolicy := .Values.gridNetwork.selectionPolicy }}
+{{- $existingSelectionPolicy := dig "spec" "selectionPolicy" nil $existing }}
+{{- $selectionPolicy := $configuredSelectionPolicy }}
+{{- if not $selectionPolicy }}
+  {{- if $existingSelectionPolicy }}
+    {{- $selectionPolicy = $existingSelectionPolicy }}
+  {{- else if not $existing }}
+    {{- $selectionPolicy = dict "mode" "roundRobin" }}
+  {{- end }}
+{{- end }}
 apiVersion: grid.praxis-proxy.io/v1alpha1
 kind: GridNetwork
 metadata:
@@ -33,6 +44,12 @@ spec:
   admissionPolicy:
     {{- toYaml . | nindent 4 }}
   {{- end }}
+  {{- with $selectionPolicy }}
+  {{- if .mode }}
+  selectionPolicy:
+    mode: {{ .mode | quote }}
+  {{- end }}
+  {{- end }}
   {{- with .Values.gridNetwork.metricsRefreshInterval }}
   {{- if . }}
   metricsRefreshInterval: {{ . | quote }}

charts/grid-site/tests/gridnetwork_test.yaml

@@ -32,6 +32,15 @@ tests:
           path: spec.gridId
           value: ""
 
+  - it: defaults a new GridNetwork to roundRobin selection
+    set:
+      gridNetwork.name: prod-grid
+      gridSite.name: prod-site
+    asserts:
+      - equal:
+          path: spec.selectionPolicy.mode
+          value: roundRobin
+
   - it: renders budgetPolicy.tenants verbatim when set
     set:
       gridNetwork.name: prod-grid

charts/grid-site/values.schema.json

@@ -71,6 +71,17 @@
             }
           }
         },
+        "selectionPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode"],
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": ["deterministic", "roundRobin", "random"]
+            }
+          }
+        },
         "metricsRefreshInterval": {
           "type": "string",
           "pattern": "^([1-9][0-9]*s|[1-9][0-9]{3,}ms)$"

deploy/crds/gridnetwork.yaml

@@ -381,6 +381,24 @@ spec:
                   items:
                     type: string
                   type: array
+                selectionPolicy:
+                  description: |-
+                    Local request distribution policy for the active selection group.
+
+                    This is independent of scoring. When absent, the overlay carries no
+                    selection override and Praxis uses deterministic selection.
+                  nullable: true
+                  properties:
+                    mode:
+                      description: Local selection mode used by the data-plane gateway.
+                      enum:
+                        - deterministic
+                        - roundRobin
+                        - random
+                      type: string
+                  required:
+                    - mode
+                  type: object
                 staleCandidateTtlSeconds:
                   description: |-
                     Maximum age in seconds before a stale (`fresh=false`) remote routing

docs/README.md

@@ -9,6 +9,9 @@
 - [Routing](architecture/routing.md) — versioned overlay contract, revision
   lifecycle, candidate ordering, `intelligent_route`, `peer_identity_trust`, and
   provider-side request forwarding.
+- [Provider Selection and Load Balancing](architecture/provider-selection-and-load-balancing.md) —
+  eligibility, routing groups, scoring, selection modes, affinity, and
+  overlay lifecycle.
 - [Scoring](architecture/scoring.md) — operator-side candidate scoring,
   metrics input, and request-time scoring boundaries.
 - [Auth and Policy](architecture/auth.md) — provider authentication strategies,
@@ -30,6 +33,9 @@
 
 ## Demos
 
+- [Provider Traffic Selection](../tests/e2e/topologies/grid-provider-traffic/README.md) —
+  runnable three-cluster topology for Grid selection groups and request-time
+  round-robin provider choice.
 - [Grid QuickStarts](https://github.com/praxis-proxy/demos) — deployable
   demonstrations with automated runtime proofs of routing, failover, security
   boundaries, and provider lifecycle.