feat: runtime manager

game/internal/router/handler/handler.go

@@ -4,6 +4,7 @@ import (
 	"errors"
 	"net/http"
 	"os"
+	"strings"
 
 	"galaxy/model/order"
 	"galaxy/model/report"
@@ -33,9 +34,25 @@ type executor struct {
 	cfg controller.Configurer
 }
 
+// ResolveStoragePath returns the engine storage path resolved from
+// STORAGE_PATH (preferred, historical name) or GAME_STATE_PATH (canonical
+// name written by Runtime Manager). It returns an error when neither
+// variable is set; callers are expected to fail fast at startup.
+func ResolveStoragePath() (string, error) {
+	if v := strings.TrimSpace(os.Getenv("STORAGE_PATH")); v != "" {
+		return v, nil
+	}
+	if v := strings.TrimSpace(os.Getenv("GAME_STATE_PATH")); v != "" {
+		return v, nil
+	}
+	return "", errors.New("storage path is not set: provide STORAGE_PATH or GAME_STATE_PATH")
+}
+
 func initConfig() controller.Configurer {
 	return func(p *controller.Param) {
-		p.StoragePath = os.Getenv("STORAGE_PATH")
+		// Validated once at startup by ResolveStoragePath; the error
+		// is dropped here to keep the Configurer signature simple.
+		p.StoragePath, _ = ResolveStoragePath()
 	}
 }
 

game/internal/router/handler/healthz.go

@@ -0,0 +1,14 @@
+package handler
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+// HealthzHandler is the technical liveness probe used by Runtime Manager
+// and operator tooling. It returns 200 with {"status":"ok"} regardless
+// of whether the engine has been initialised through POST /api/v1/init.
+func HealthzHandler(c *gin.Context) {
+	c.JSON(http.StatusOK, gin.H{"status": "ok"})
+}