feat(engine): scaffold runtime skeleton

Data/Engine/services/API/__init__.py

@@ -0,0 +1,21 @@
+"""API service stubs for the Borealis Engine runtime.
+
+Stage 1 only establishes the package layout. Future stages will populate this
+module with blueprint factories that wrap the legacy API helpers.
+"""
+from __future__ import annotations
+
+from flask import Flask
+
+from ...server import EngineContext
+
+
+def register_api(app: Flask, context: EngineContext) -> None:
+    """Placeholder hook for API blueprint registration.
+
+    Later migration stages will import domain-specific blueprint modules and
+    attach them to ``app`` using the shared :class:`EngineContext`. For now we
+    simply log the intent so tooling can verify the hook is wired.
+    """
+
+    context.logger.debug("Engine API services are not yet implemented.")

Data/Engine/services/WebSocket/__init__.py

@@ -0,0 +1,17 @@
+"""WebSocket service stubs for the Borealis Engine runtime.
+
+Future stages will move Socket.IO namespaces and event handlers here. Stage 1
+only keeps a placeholder so the Engine bootstrapper can stub registration
+without touching legacy behaviour.
+"""
+from __future__ import annotations
+
+from flask_socketio import SocketIO
+
+from ...server import EngineContext
+
+
+def register_realtime(socket_server: SocketIO, context: EngineContext) -> None:
+    """Placeholder hook for Socket.IO namespace registration."""
+
+    context.logger.debug("Engine WebSocket services are not yet implemented.")

Data/Engine/services/WebUI/__init__.py

@@ -0,0 +1,17 @@
+"""WebUI service stubs for the Borealis Engine runtime.
+
+The future WebUI migration will centralise static asset serving, template
+rendering, and dev-server proxying here. Stage 1 keeps the placeholder so the
+application factory can stub out registration calls.
+"""
+from __future__ import annotations
+
+from flask import Flask
+
+from ...server import EngineContext
+
+
+def register_web_ui(app: Flask, context: EngineContext) -> None:
+    """Placeholder hook for WebUI route registration."""
+
+    context.logger.debug("Engine WebUI services are not yet implemented.")

Data/Engine/services/__init__.py

@@ -0,0 +1,5 @@
+"""Service registration hooks for the Borealis Engine runtime."""
+
+from . import API, WebSocket, WebUI
+
+__all__ = ["API", "WebSocket", "WebUI"]