Expand description
Runtime-mode and verbosity primitives. Runtime hint model shared across host, native commands, and plugin boundaries.
This module exists so runtime-facing behavior like verbosity, output mode, and terminal identity can travel through the system as normalized data instead of ad hoc environment parsing in each caller.
High-level flow:
- parse runtime-oriented environment hints into
crate::core::runtime::RuntimeHints - normalize those values into enums and bounded scalar settings
- export the same normalized hints back into environment pairs when needed
Contract:
- environment parsing rules for runtime hints live here
- callers should consume
crate::core::runtime::RuntimeHintsinstead of reparsing raw env vars
Public API shape:
crate::core::runtime::RuntimeHints::newis the exact constructor for already-resolved runtime settingscrate::core::runtime::RuntimeHints::from_envandcrate::core::runtime::RuntimeHints::from_env_iterare the probing and adaptation factories- optional metadata such as profile and terminal identity uses
with_*refinements instead of raw ad hoc assembly
Structs§
- Runtime
Hints - Normalized runtime settings loaded from environment variables.
Enums§
- Runtime
Terminal Kind - Runtime terminal mode exposed through environment hints.
- UiVerbosity
- UI message verbosity derived from runtime hints and environment.
Constants§
- ENV_
OSP_ COLOR - Environment variable carrying the color-mode hint.
- ENV_
OSP_ DEBUG_ LEVEL - Environment variable carrying the debug level hint.
- ENV_
OSP_ FORMAT - Environment variable carrying the preferred output format.
- ENV_
OSP_ PROFILE - Environment variable carrying the active profile name.
- ENV_
OSP_ TERMINAL - Environment variable carrying the active terminal identifier.
- ENV_
OSP_ TERMINAL_ KIND - Environment variable carrying the terminal kind hint.
- ENV_
OSP_ UI_ VERBOSITY - Environment variable carrying the UI verbosity hint.
- ENV_
OSP_ UNICODE - Environment variable carrying the Unicode-mode hint.