Kernel Subsystems — Core Engines
Docs » Kernel Subsystems — Core Engines » pkg/loader
Raw .md

pkg/loader

Abstract component loader pattern: shared state as atomics, callback on state change, configurable timeouts (default config + profile/thematic overrides). The retryable component is implemented as Runner: one-shot load with wait-for-completion channel and timeout.

  • Design: Component loader pattern with atomic state, retryable Runner, and timeout cascading.
  • Types: LoadState, LoaderTimeoutConfig, StateChangeCallback, ComponentLoader, LoadFn
  • Runner: NewRunner(name, loadFn, opts...), Load(ctx), ResetLoaded(), WithCallback, WithTimeoutConfig
  • Config: LoadLoaderTimeoutConfig(configPath), MergeLoaderTimeoutOverrides(base, overrides), GetLoaderTimeoutConfig(loaderName)

Loaders using Runner: ID validator (id_patterns), BucketingConfigRegistry (bucketing_config), BucketStrategyLoader (bucket_strategy_loader), SpecLoader.EnsureReady (spec_loader), LifecycleLoader.EnsureReady (lifecycle), KindSynonymResolver.Initialize (kind_synonym_resolver).

Retries: This package configures timeouts only (wait-for-completion, publish-channel, load-operation). It does not configure retries (retry on load failure). Retries are in pkg/storage/operation_helper.go (RetryConfig), pkg/graph/provider/retry.go, and scheduler job config (retry_count, retry_delay_seconds).