git.stella-ops.org/docs/features/unchecked/router/microservice-endpoint-yaml-configuration-overrides.md

Microservice Endpoint YAML Configuration Overrides

Module

Router

Status

IMPLEMENTED

Description

Per-endpoint YAML configuration overrides for timeouts, claim requirements, streaming enablement, and payload limits. Merges code-level [StellaEndpoint] attributes with YAML overrides at runtime.

Implementation Details

• Modules: src/Router/__Libraries/StellaOps.Microservice/
• Key Classes:
  • EndpointOverrideMerger (src/Router/__Libraries/StellaOps.Microservice/EndpointOverrideMerger.cs) - merges code-level [StellaEndpoint] attributes with YAML configuration overrides
  • EndpointOverrideConfig (src/Router/__Libraries/StellaOps.Microservice/MicroserviceYamlConfig.cs) - YAML model for per-endpoint overrides (timeouts, claims, streaming, payload limits)
• Interfaces: IEndpointOverrideMerger
• Source: batch_52/file_08.md

E2E Test Plan

• Define a YAML override for an endpoint timeout and verify EndpointOverrideMerger applies it
• Define a YAML override for claim requirements and verify they are merged with attribute-defined claims
• Enable streaming via YAML for a non-streaming endpoint and verify the override takes effect
• Set payload limits via YAML and verify requests exceeding the limit are rejected
• Verify code-level attributes are preserved when no YAML override is defined