Models

A block may declare one BlockCategory. The closed enum supplies the shared functional taxonomy used by Stackie clients and topology views.

Platform-conditional values

Several fields support per-platform values via PlatformOrString:

  • Block::tool_env — environment variable values that differ by OS
  • BlockVersionEntry::version — block versions unavailable on some platforms

A platform-conditional value is written as a YAML map keyed by OS name:

versions:
  - alias: "28"
    version:
      linux: "28.0.1"
      macos: "27.2.4"   # macOS Intel has no OTP 28 builds
      windows: "28.0.1"

Use PlatformOrString::resolve or BlockVersionEntry::resolved_version to obtain the value for the current OS at runtime.