Update app.py

app.py

@@ -57,33 +57,35 @@ def _patch_relative_imports(project_root: str):
 # --- END ABSOLUTE-IMPORT & ENV HOTFIX ---
 
 
-# --- BEGIN runtime compatibility: ensure "utilities" maps to "utils" ----------
-# Some modules still do `import utilities`. If the utilities package/file
-# wasn't created or found, map the runtime name "utilities" to the real
-# top-level utils module so legacy imports succeed.
+# --- BEGIN runtime compatibility: lazy proxy for "utilities" -> "utils" -------
+# Some modules still do `import utilities`. Create a lazy proxy that will import
+# the real `utils` only when attributes are accessed, avoiding recursive
+# import-time interactions with any lazy `utils` implementation.
 import importlib
-import types
+from types import ModuleType
 
 if "utilities" not in sys.modules:
-    try:
-        _utils_mod = importlib.import_module("utils")
-        sys.modules["utilities"] = _utils_mod
-        # optional log: print("Mapped 'utilities' ->", getattr(_utils_mod, "__name__", "<utils?>"))
-    except Exception:
-        # fallback lazy proxy: import utils on first attribute access
-        class _LazyUtilities(types.ModuleType):
-            def __getattr__(self, name):
-                mod = importlib.import_module("utils")
-                sys.modules["utilities"] = mod
-                return getattr(mod, name)
-            def __dir__(self):
-                try:
-                    mod = importlib.import_module("utils")
-                    return dir(mod)
-                except Exception:
-                    return list(super().__dir__())
-
-        sys.modules["utilities"] = _LazyUtilities("utilities")
+    class _LazyUtilities(ModuleType):
+        def __getattr__(self, name):
+            # Import the real utils once on first attribute access and replace
+            # the 'utilities' entry in sys.modules with it so subsequent
+            # imports refer to the real module.
+            real = importlib.import_module("utils")
+            sys.modules["utilities"] = real
+            # Alias already-imported utils submodules as utilities.<submodule>
+            for modname, module in list(sys.modules.items()):
+                if modname.startswith("utils.") and isinstance(module, ModuleType):
+                    suffix = modname.partition(".")[2]
+                    sys.modules[f"utilities.{suffix}"] = module
+            return getattr(real, name)
+        def __dir__(self):
+            try:
+                real = importlib.import_module("utils")
+                return dir(real)
+            except Exception:
+                return list(super().__dir__())
+
+    sys.modules["utilities"] = _LazyUtilities("utilities")
 # --- END runtime compatibility ---------------------------------------------