from amplifier_config import ConfigManager, ConfigPaths, Scope
from pathlib import Path
# Define paths for your application (CLI example)
paths = ConfigPaths(
    user=Path.home() / ".amplifier" / "settings.yaml",
    project=Path(".amplifier/settings.yaml"),
    local=Path(".amplifier/settings.local.yaml"),
)
# Create configuration manager
config = ConfigManager(paths=paths)
# Get active profile (LOCAL > PROJECT > USER > None)
active_profile = config.get_active_profile()
# Set profile at local scope
config.set_active_profile("dev", scope=Scope.LOCAL)
# Get merged settings across all scopes
all_settings = config.get_merged_settings()
# Manage module source overrides
config.add_source_override(
    module_id="provider-anthropic",
    source="git+https://github.com/user/custom-provider@main",
    scope=Scope.PROJECT
)

from amplifier_config import Scope
class Scope(Enum):
    """Configuration scope levels."""
    USER = "user"       # User-global settings
    PROJECT = "project" # Project-shared settings
    LOCAL = "local"     # Developer-local overrides

from amplifier_config import ConfigPaths
from pathlib import Path
@dataclass(frozen=True)
class ConfigPaths:
    """Injectable path configuration.

    Apps provide these paths based on their conventions.
    Library uses paths without knowing their semantic meanings.
    """
    user: Path      # Where user-global settings live
    project: Path   # Where project-shared settings live
    local: Path     # Where local overrides live

cli_paths = ConfigPaths(
    user=Path.home() / ".amplifier" / "settings.yaml",
    project=Path(".amplifier/settings.yaml"),
    local=Path(".amplifier/settings.local.yaml"),
)

from amplifier_config import ConfigManager, ConfigPaths, Scope
class ConfigManager:
    """Configuration management mechanism.

    Provides hierarchical resolution, deep merge, and file I/O.
    Does not make decisions about paths, display, or storage backend.
    """
    def __init__(self, paths: ConfigPaths):
        """Initialize with injectable paths.

        Args:
            paths: ConfigPaths defining where settings files live
        """

# Get active profile
active = config.get_active_profile()
# Returns: str | None (None if no profile active at any scope)
# Set active profile
config.set_active_profile("dev", scope=Scope.LOCAL)
# Clear active profile
config.clear_active_profile(scope=Scope.LOCAL)
# Get project default profile
default = config.get_project_default()
# Returns: str | None
# Set project default
config.set_project_default("base")
# Clear project default
config.clear_project_default()

# Get merged settings
settings = config.get_merged_settings()
# Returns: dict[str, Any] - Deep merge of USER < PROJECT < LOCAL
# Get module source overrides
sources = config.get_module_sources()
# Returns: dict[str, str] mapping module_id -> source_uri

# Add source override
config.add_source_override(
    module_id="provider-anthropic",
    source="git+https://github.com/user/custom-provider@main",
    scope=Scope.PROJECT
)
# Remove source override
removed = config.remove_source_override(
    module_id="provider-anthropic",
    scope=Scope.PROJECT
)
# Returns: True if removed, False if not found

# Update arbitrary settings at a scope
config.update_settings(
    updates={"custom": {"feature": "enabled"}},
    scope=Scope.PROJECT
)
# Deep merges updates into PROJECT scope settings
# Get path for a scope
path = config.scope_to_path(Scope.LOCAL)
# Returns: Path object for the LOCAL scope

from amplifier_config import deep_merge
result = deep_merge(
    base={"a": {"b": 1, "c": 2}},
    overlay={"a": {"b": 999, "d": 3}}
)
# Returns: {"a": {"b": 999, "c": 2, "d": 3}}
# Overlay values replace base; unmodified base values preserved

from amplifier_config import ConfigError, ConfigFileError, ConfigValidationError
try:
    config.set_active_profile("dev", scope=Scope.LOCAL)
except ConfigFileError as e:
    # Raised when file I/O fails (write errors, permission denied, etc.)
    print(f"File error: {e}")
except ConfigValidationError as e:
    # Raised when configuration data is invalid
    print(f"Validation error: {e}")
except ConfigError as e:
    # Base exception for all config errors
    print(f"Config error: {e}")