"""Runtime mode resolution for Basic Memory.
This module centralizes runtime mode detection, ensuring cloud/local/test
determination happens in one place rather than scattered across modules.
Composition roots (containers) read ConfigManager and use this module
to resolve the runtime mode, then pass the result downstream.
"""
from enum import Enum, auto
class RuntimeMode(Enum):
"""Runtime modes for Basic Memory."""
LOCAL = auto() # Local standalone mode (default)
CLOUD = auto() # Cloud mode with remote sync
TEST = auto() # Test environment
@property
def is_cloud(self) -> bool:
return self == RuntimeMode.CLOUD
@property
def is_local(self) -> bool:
return self == RuntimeMode.LOCAL
@property
def is_test(self) -> bool:
return self == RuntimeMode.TEST
def resolve_runtime_mode(
cloud_mode_enabled: bool,
is_test_env: bool,
) -> RuntimeMode:
"""Resolve the runtime mode from configuration flags.
This is the single source of truth for mode resolution.
Composition roots call this with config values they've read.
Args:
cloud_mode_enabled: Whether cloud mode is enabled in config
is_test_env: Whether running in test environment
Returns:
The resolved RuntimeMode
"""
# Trigger: test environment is detected
# Why: tests need special handling (no file sync, isolated DB)
# Outcome: returns TEST mode, skipping cloud mode check
if is_test_env:
return RuntimeMode.TEST
# Trigger: cloud mode is enabled in config
# Why: cloud mode changes auth, sync, and API behavior
# Outcome: returns CLOUD mode for remote-first behavior
if cloud_mode_enabled:
return RuntimeMode.CLOUD
return RuntimeMode.LOCAL
