Upstream sync

backend/app/config.py

@@ -70,9 +70,9 @@ class Config:
     REPORT_AGENT_TEMPERATURE = float(os.environ.get('REPORT_AGENT_TEMPERATURE', '0.5'))
 
     @classmethod
-    def validate(cls):
+    def validate(cls) -> list[str]:
         """Validate required configuration"""
-        errors = []
+        errors: list[str] = []
         if not cls.LLM_API_KEY:
             errors.append("LLM_API_KEY not configured (set to any non-empty value, e.g. 'ollama')")
         if not cls.NEO4J_URI:

backend/app/utils/file_parser.py

@@ -63,6 +63,20 @@ class FileParser:
 
     SUPPORTED_EXTENSIONS = {'.pdf', '.md', '.markdown', '.txt'}
 
+    @classmethod
+    def is_supported(cls, file_path: str) -> bool:
+        """
+        Check whether the file is a supported format
+
+        Args:
+            file_path: Path to the file
+
+        Returns:
+            True if the file format is supported
+        """
+        suffix = Path(file_path).suffix.lower()
+        return suffix in cls.SUPPORTED_EXTENSIONS
+
     @classmethod
     def extract_text(cls, file_path: str) -> str:
         """

backend/app/utils/logger.py

@@ -109,18 +109,18 @@ def get_logger(name: str = 'mirofish') -> logging.Logger:
 
 
 # Convenience functions
-def debug(msg, *args, **kwargs):
+def debug(msg: str, *args, **kwargs) -> None:
     logger.debug(msg, *args, **kwargs)
 
-def info(msg, *args, **kwargs):
+def info(msg: str, *args, **kwargs) -> None:
     logger.info(msg, *args, **kwargs)
 
-def warning(msg, *args, **kwargs):
+def warning(msg: str, *args, **kwargs) -> None:
     logger.warning(msg, *args, **kwargs)
 
-def error(msg, *args, **kwargs):
+def error(msg: str, *args, **kwargs) -> None:
     logger.error(msg, *args, **kwargs)
 
-def critical(msg, *args, **kwargs):
+def critical(msg: str, *args, **kwargs) -> None:
     logger.critical(msg, *args, **kwargs)
 

backend/pyproject.toml

@@ -2,7 +2,7 @@
 name = "mirofish-offline-backend"
 version = "0.2.0"
 description = "MiroFish-Offline - Offline-first fork running on Neo4j + Ollama"
-requires-python = ">=3.11"
+requires-python = ">=3.11,<3.13"
 license = { text = "AGPL-3.0" }
 authors = [
     { name = "MiroFish Team" }