feat: scaffold codespace backend

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

internal/api/router.go

@@ -0,0 +1,45 @@
+package api
+
+import (
+	"net/http"
+
+	"codespace/internal/service"
+
+	"github.com/gin-gonic/gin"
+)
+
+// NewRouter builds a Gin engine with all API routes registered.
+func NewRouter(workspaces *service.WorkspaceService, files *service.FileService, processes *service.ProcessService) *gin.Engine {
+	gin.SetMode(gin.ReleaseMode)
+	r := gin.New()
+	r.Use(gin.Recovery())
+
+	wsHandler := &workspaceHandler{svc: workspaces}
+	fileHandler := &fileHandler{svc: files}
+	procHandler := &processHandler{svc: processes}
+
+	r.GET("/healthz", healthHandler)
+
+	api := r.Group("/api")
+	api.POST("/workspaces", wsHandler.create)
+	api.GET("/workspaces/:id", wsHandler.get)
+	api.DELETE("/workspaces/:id", wsHandler.delete)
+
+	api.GET("/workspaces/:id/files", fileHandler.list)
+	api.GET("/workspaces/:id/files/read", fileHandler.read)
+	api.PUT("/workspaces/:id/files/write", fileHandler.write)
+	api.POST("/workspaces/:id/files/mkdir", fileHandler.mkdir)
+	api.DELETE("/workspaces/:id/files", fileHandler.remove)
+	api.POST("/workspaces/:id/files/rename", fileHandler.rename)
+
+	api.POST("/workspaces/:id/process/start", procHandler.start)
+	api.POST("/workspaces/:id/process/stop", procHandler.stop)
+	api.POST("/workspaces/:id/process/restart", procHandler.restart)
+	api.GET("/workspaces/:id/process/status", procHandler.status)
+
+	return r
+}
+
+func healthHandler(c *gin.Context) {
+	c.JSON(http.StatusOK, gin.H{"status": "ok"})
+}