Expose QUIC fabric capacity pressure

agents/rap-node-agent/internal/mesh/fabric_quic_transport.go

@@ -51,6 +51,9 @@ type QUICFabricTransportSnapshot struct {
 	SchemaVersion           string                   `json:"schema_version"`
 	ActiveCount             int                      `json:"active_count"`
 	ActiveStreams           int                      `json:"active_streams"`
+	MaxStreamsPerConn       int                      `json:"max_streams_per_conn"`
+	SaturatedConnections    int                      `json:"saturated_connections"`
+	CapacityPressurePercent int                      `json:"capacity_pressure_percent"`
 	Stats                   QUICFabricTransportStats `json:"stats"`
 }
 
@@ -334,8 +337,13 @@ func (t *QUICFabricTransport) Snapshot() QUICFabricTransportSnapshot {
 	t.mu.Lock()
 	defer t.mu.Unlock()
 	t.pruneIdleLocked(time.Now())
+	limit := t.MaxStreamsPerConn
+	if limit <= 0 {
+		limit = defaultQUICFabricMaxStreamsPerConn
+	}
 	snapshot := QUICFabricTransportSnapshot{
 		SchemaVersion:     "rap.quic_fabric_transport.v1",
+		MaxStreamsPerConn: limit,
 		Stats:             t.stats,
 	}
 	for key, entry := range t.conns {
@@ -350,6 +358,15 @@ func (t *QUICFabricTransport) Snapshot() QUICFabricTransportSnapshot {
 		default:
 			snapshot.ActiveCount++
 			snapshot.ActiveStreams += entry.activeStreams
+			if entry.activeStreams >= limit {
+				snapshot.SaturatedConnections++
+			}
+		}
+	}
+	if snapshot.ActiveCount > 0 && limit > 0 {
+		capacity := snapshot.ActiveCount * limit
+		if capacity > 0 {
+			snapshot.CapacityPressurePercent = (snapshot.ActiveStreams * 100) / capacity
 		}
 	}
 	return snapshot

agents/rap-node-agent/internal/mesh/fabric_quic_transport_test.go

@@ -267,7 +267,11 @@ func TestQUICFabricTransportLimitsStreamsPerConnection(t *testing.T) {
 		t.Fatal("second connect succeeded past stream limit")
 	}
 	snapshot := transport.Snapshot()
-	if snapshot.ActiveStreams != 1 || snapshot.Stats.StreamLimitRejects != 1 {
+	if snapshot.ActiveStreams != 1 ||
+		snapshot.MaxStreamsPerConn != 1 ||
+		snapshot.SaturatedConnections != 1 ||
+		snapshot.CapacityPressurePercent != 100 ||
+		snapshot.Stats.StreamLimitRejects != 1 {
 		t.Fatalf("unexpected stream limit snapshot: %+v", snapshot)
 	}
 	if err := first.Close(); err != nil {

docs/architecture/DISTRIBUTED_FABRIC_NODE_PROTOCOL_PLAN.md

@@ -416,6 +416,8 @@ gateway status.
 Receive-side fabric-session packet counters are reported by traffic class and
 stream id as well, so gateway status can compare TX and RX distribution under
 browser/RDP load.
+QUIC fabric transport snapshots expose the configured stream limit, saturated
+connection count, and capacity pressure percentage next to stream limit rejects.
 Endpoint ranking treats `capacity_limited` observations as a soft pressure
 penalty instead of a hard recent failure, enabling load spreading without
 marking the carrier unhealthy.