feat: enhance configuration system with version validation and CLI overrides

- Add version validation to prevent config file mismatches
- Allow CLI arguments to override base_url and api_key from config files
- Import project version for validation in config module
- Improve config loading with better parameter handling and documentation
- Maintain backward compatibility while adding new validation features

Author: S1M0N38

src/balatrollm/__init__.py

@@ -145,7 +145,16 @@ def _validate_config_file(config_path: str) -> None:
 async def run_bot(args) -> None:
     """Run the Balatro bot with the given arguments."""
     if args.from_config:
-        config = Config.from_config_file(args.from_config)
+        # Load config from file, but allow CLI arguments to override base_url and api_key
+        config = Config.from_config_file(
+            args.from_config,
+            base_url=args.base_url
+            if args.base_url != os.getenv("LITELLM_BASE_URL", "http://localhost:4000")
+            else None,
+            api_key=args.api_key
+            if args.api_key != os.getenv("LITELLM_API_KEY", "sk-balatrollm-proxy-key")
+            else None,
+        )
     else:
         config = Config(
             model=args.model,

src/balatrollm/config.py

@@ -5,6 +5,8 @@
 from dataclasses import dataclass
 from pathlib import Path
 
+from . import __version__
+
 
 @dataclass
 class Config:
@@ -26,20 +28,40 @@ def from_environment(cls) -> "Config":
         )
 
     @classmethod
-    def from_config_file(cls, config_path: str) -> "Config":
-        """Create configuration from a previous run's config.json file."""
+    def from_config_file(
+        cls, config_path: str, base_url: str | None = None, api_key: str | None = None
+    ) -> "Config":
+        """Create configuration from a previous run's config.json file.
+
+        Loads model and strategy from config.json, uses CLI overrides if provided,
+        otherwise falls back to environment defaults for base_url and api_key.
+
+        Args:
+            config_path: Path to the config.json file
+            base_url: Optional CLI override for base_url
+            api_key: Optional CLI override for api_key
+        """
         config_file = Path(config_path)
         if not config_file.exists():
             raise FileNotFoundError(f"Config file not found: {config_file}")
 
         with config_file.open() as f:
             config_data = json.load(f)
 
-        # Map the config.json fields to Config fields
-        # config.json uses 'base_url' and 'strategy' (updated field names)
+        # Version validation - check if config version matches current repo version
+        if "version" in config_data:
+            config_version = config_data["version"]
+            if config_version != __version__:
+                raise ValueError(
+                    f"Version mismatch: Config file version '{config_version}' "
+                    f"does not match current repository version '{__version__}'. "
+                    f"Please use a config file from the same version or update your repository."
+                )
+
+        # Create config with values from file, CLI overrides, or environment defaults
         return cls(
             model=config_data["model"],
-            base_url=config_data["base_url"],
-            api_key=config_data["api_key"],
+            base_url=base_url or os.getenv("LITELLM_BASE_URL", "http://localhost:4000"),
+            api_key=api_key or os.getenv("LITELLM_API_KEY", "sk-balatrollm-proxy-key"),
             strategy=config_data["strategy"],
         )