mirror of
https://github.com/basicmachines-co/basic-memory
synced 2026-06-21 13:47:35 +00:00
Paul Hernandez
863e0a4e24
Signed-off-by: phernandez <paul@basicmachines.co> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
62 lines
1.7 KiB
Python
62 lines
1.7 KiB
Python
"""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
|