Task 001: dockerized monorepo foundation

apps/runner/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+COPY apps/runner/src ./src
+
+EXPOSE 8010
+
+CMD ["python", "-m", "src.presentation.main"]

apps/runner/src/__init__.py

@@ -0,0 +1 @@
+"""Runner service package."""

apps/runner/src/application/README.md

@@ -0,0 +1,3 @@
+# Application
+
+Runner use cases, job orchestration, and command policies belong in this layer.

apps/runner/src/application/__init__.py

@@ -0,0 +1 @@
+"""Application layer for runner use cases."""

apps/runner/src/domain/README.md

@@ -0,0 +1,3 @@
+# Domain
+
+Runner job entities and invariants belong in this layer.

apps/runner/src/domain/__init__.py

@@ -0,0 +1 @@
+"""Domain layer for runner job concepts."""

apps/runner/src/infrastructure/README.md

@@ -0,0 +1,4 @@
+# Infrastructure
+
+CLI execution, workspace, filesystem, and artifact storage adapters belong in
+this layer.

apps/runner/src/infrastructure/__init__.py

@@ -0,0 +1 @@
+"""Infrastructure adapters for runner execution."""

apps/runner/src/presentation/README.md

@@ -0,0 +1,3 @@
+# Presentation
+
+Runner HTTP routes and API wiring belong in this layer.

apps/runner/src/presentation/__init__.py

@@ -0,0 +1 @@
+"""Presentation layer for runner HTTP APIs."""

apps/runner/src/presentation/main.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import json
+import os
+from http import HTTPStatus
+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
+
+
+class HealthHandler(BaseHTTPRequestHandler):
+    def do_GET(self) -> None:
+        if self.path != "/health":
+            self.send_error(HTTPStatus.NOT_FOUND)
+            return
+
+        body = json.dumps({"service": "runner", "status": "ok"}).encode("utf-8")
+        self.send_response(HTTPStatus.OK)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(body)))
+        self.end_headers()
+        self.wfile.write(body)
+
+    def log_message(self, format: str, *args: object) -> None:
+        return
+
+
+def run() -> None:
+    port = int(os.environ.get("PORT", "8010"))
+    server = ThreadingHTTPServer(("0.0.0.0", port), HealthHandler)
+    server.serve_forever()
+
+
+if __name__ == "__main__":
+    run()

apps/runner/src/shared/README.md

@@ -0,0 +1,3 @@
+# Shared
+
+Cross-layer runner primitives belong here. Keep this layer small.

apps/runner/src/shared/__init__.py

@@ -0,0 +1 @@
+"""Shared runner primitives."""