Spaces:
Paused
Paused
| """Orthogonal runtime state and observability modes.""" | |
| from __future__ import annotations | |
| from enum import StrEnum | |
| from typing import Final | |
| class StateMode(StrEnum): | |
| """Persistence and lifecycle boundary for a running Brain-5D state.""" | |
| OPERATOR = "operator" | |
| EXPERIMENT = "experiment" | |
| DEV = "dev" | |
| class ObservabilityProfile(StrEnum): | |
| """Independent amount of telemetry and rendering work.""" | |
| FULL = "full" | |
| SCIENTIFIC = "scientific" | |
| MINIMAL = "minimal" | |
| COMPUTE = "compute" | |
| STATE_MODES: Final[tuple[str, ...]] = tuple(item.value for item in StateMode) | |
| OBSERVABILITY_PROFILES: Final[tuple[str, ...]] = tuple( | |
| item.value for item in ObservabilityProfile | |
| ) | |
| def validate_modes(state_mode: str, observability: str) -> None: | |
| """Reject invalid mode values at configuration boundaries.""" | |
| if state_mode not in STATE_MODES: | |
| raise ValueError(f"state_mode must be one of {STATE_MODES}, got {state_mode!r}") | |
| if observability not in OBSERVABILITY_PROFILES: | |
| raise ValueError( | |
| "observability must be one of " | |
| f"{OBSERVABILITY_PROFILES}, got {observability!r}" | |
| ) | |