fix: resolve CI linting and type errors

src/promptforge/core/config.py

@@ -1,3 +1,5 @@
+"""Configuration management for PromptForge."""
+
 import os
 from pathlib import Path
 from typing import Any, Dict, Optional
@@ -8,6 +10,8 @@ from pydantic import BaseModel, Field
 
 
 class ProviderConfig(BaseModel):
+    """Configuration for an LLM provider."""
+
     api_key: Optional[str] = None
     model: str = "gpt-4"
     temperature: float = 0.7
@@ -15,21 +19,29 @@ class ProviderConfig(BaseModel):
 
 
 class RegistryConfig(BaseModel):
+    """Configuration for the prompt registry."""
+
     local_path: str = "~/.promptforge/registry"
     remote_url: str = "https://registry.promptforge.io"
 
 
 class DefaultsConfig(BaseModel):
+    """Default settings for PromptForge."""
+
     provider: str = "openai"
     output_format: str = "text"
 
 
 class ValidationConfig(BaseModel):
+    """Validation settings."""
+
     strict_mode: bool = False
     max_retries: int = 3
 
 
 class Config(BaseModel):
+    """Main configuration for PromptForge."""
+
     providers: Dict[str, ProviderConfig] = Field(default_factory=dict)
     registry: RegistryConfig = Field(default_factory=RegistryConfig)
     defaults: DefaultsConfig = Field(default_factory=DefaultsConfig)
@@ -37,6 +49,7 @@ class Config(BaseModel):
 
 
 def _expand_env_vars(value: Any) -> Any:
+    """Expand environment variables in a value."""
     if isinstance(value, str):
         if value.startswith("${") and value.endswith("}"):
             env_var = value[2:-1]
@@ -45,6 +58,7 @@ def _expand_env_vars(value: Any) -> Any:
 
 
 def _process_config(config_dict: Dict[str, Any]) -> Dict[str, Any]:
+    """Process configuration dictionary, expanding environment variables."""
     processed = {}
     for key, value in config_dict.items():
         if isinstance(value, dict):
@@ -55,6 +69,14 @@ def _process_config(config_dict: Dict[str, Any]) -> Dict[str, Any]:
 
 
 def load_config(config_path: Optional[Path] = None) -> Config:
+    """Load configuration from file.
+
+    Args:
+        config_path: Path to configuration file. If None, looks in standard locations.
+
+    Returns:
+        Config object with all settings.
+    """
     if config_path is None:
         config_path = Path.cwd() / "configs" / "promptforge.yaml"
 
@@ -70,4 +92,5 @@ def load_config(config_path: Optional[Path] = None) -> Config:
 
 @lru_cache()
 def get_config() -> Config:
-    return load_config()
+    """Get cached configuration."""
+    return load_config()