Skip to main content

Module LandFixTier

Module LandFixTier 

Source
Expand description

§LandFixTier

Emits a single ISO-timestamped boot banner listing the compiled-in value of every tier variable. Because all env!("Tier…") calls are resolved by build.rs::PropagateTierGating at compile time, the banner always reflects the exact configuration baked into this binary - not whatever the host environment happens to export at runtime.

§Design Rationale

Three distinct audiences depend on this banner:

AudienceWhy it matters
Log readers (humans)A pasted session log must show at-a-glance which tier was active when the problem occurred.
Regression triageConfirms the binary on disk was built from the same .env.Land that shipped.
Cross-element agreementPairs with Cocoon’s [LandFix:Tier] Cocoon tier set resolved: and Sky’s [LandFix:Tier] Sky tier set:. A mismatch between any two signals configuration drift as the root cause.

§Call Site

LogResolvedTiers() is called unconditionally from Binary/Main/Entry::Fn before the Tokio runtime begins spawning tasks. dev_log! is synchronous, so the banner is guaranteed to land in the log before any extension code runs.

Runtime overhead is zero - all env!(...) invocations become string literals at compile time and are inlined into a single write call.

§References

See Documentation/GitHub/Workflow/TierGatedImplementationSelection.md for the end-to-end tier-gating workflow and the matching call sites in Cocoon, Wind, and Sky. Every capability listed in the boot banner maps to one or more // Tier:<Capability>:<Value> comments at its dispatch site.

Functions§

LogResolvedTiers
Emits one ISO-timestamped line at boot listing the compiled-in value of all 17 tier variables (TierRemoteProcedureCallTierTelemetry). Call once, from Binary/Main/Entry::Fn, after the logging infrastructure is ready and before the Tokio runtime spawns any tasks.