api: add comprehensive actions runner management endpoints

This commit adds full API support for GitHub Actions-compatible
workflow run management, providing CLI equivalent functionality
to GitHub's 'gh run' command for Gitea instances.

New API endpoints:
- POST /api/v1/repos/{owner}/{repo}/actions/runs/{run_number}/rerun
- POST /api/v1/repos/{owner}/{repo}/actions/runs/{run_number}/cancel
- POST /api/v1/repos/{owner}/{repo}/actions/runs/{run_number}/approve
- POST /api/v1/repos/{owner}/{repo}/actions/runs/{run_number}/jobs/{job_id}/rerun
- POST /api/v1/repos/{owner}/{repo}/actions/runs/{run_number}/logs (streaming)

Features:
- Intelligent dependency-aware job rerunning using existing GetAllRerunJobs()
- Real-time log streaming with cursor-based pagination
- Comprehensive permission checking (repository write access required)
- Full compatibility with existing web UI business logic
- Support for 'latest' keyword for most recent workflow run
- Streaming logs endpoint for real-time monitoring

Implementation highlights:
- Leverages existing web controller logic for maximum reliability
- Ultra-lean approach: 822 lines of new code with comprehensive functionality
- Full integration test coverage (180 lines)
- Swagger/OpenAPI documentation included
- Follows Gitea's existing API patterns and error handling
- Uses Gitea's modules/json for depguard compliance

This enables full CLI workflow management for Gitea Actions,
matching GitHub's runner management capabilities while
maintaining consistency with Gitea's architecture and patterns.

Fixes: Enables equivalent functionality to GitHub CLI 'gh run' commands
Test coverage: Comprehensive integration tests included

Author: rossigee

routers/api/v1/swagger/action.go

@@ -46,3 +46,17 @@ type swaggerResponseActionWorkflowList struct {
 	// in:body
 	Body api.ActionWorkflowResponse `json:"body"`
 }
+
+// WorkflowRunRerunRequest
+// swagger:model WorkflowRunRerunRequest
+type swaggerWorkflowRunRerunRequest struct {
+	// Enable debug logging for the re-run
+	EnableDebugLogging bool `json:"enable_debug_logging"`
+}
+
+// WorkflowRunLogsRequest
+// swagger:model WorkflowRunLogsRequest
+type swaggerWorkflowRunLogsRequest struct {
+	// Log cursors for incremental log streaming
+	LogCursors []map[string]interface{} `json:"logCursors"`
+}

tests/integration/api_actions_run_test.go

@@ -6,6 +6,7 @@ package integration
 import (
 	"fmt"
 	"net/http"
+	"strings"
 	"testing"
 
 	auth_model "code.gitea.io/gitea/models/auth"
@@ -291,9 +292,8 @@ func TestAPIActionsGetWorkflowRunLogsStream(t *testing.T) {
 	token := getTokenForLoggedInUser(t, session, auth_model.AccessTokenScopeWriteRepository)
 
 	// Test streaming logs with empty cursor request
-	req := NewRequest(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/795/logs", repo.FullName())).
-		AddTokenAuth(token).
-		SetBody(`{"logCursors": []}`)
+	req := NewRequestWithBody(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/795/logs", repo.FullName()), strings.NewReader(`{"logCursors": []}`)).
+		AddTokenAuth(token)
 	resp := MakeRequest(t, req, http.StatusOK)
 
 	// Parse response to verify structure
@@ -303,14 +303,12 @@ func TestAPIActionsGetWorkflowRunLogsStream(t *testing.T) {
 	assert.Contains(t, logResp, "stepsLog")
 
 	// Test streaming logs with cursor request
-	req = NewRequest(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/795/logs", repo.FullName())).
-		AddTokenAuth(token).
-		SetBody(`{"logCursors": [{"step": 0, "cursor": 0, "expanded": true}]}`)
+	req = NewRequestWithBody(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/795/logs", repo.FullName()), strings.NewReader(`{"logCursors": [{"step": 0, "cursor": 0, "expanded": true}]}`)).
+		AddTokenAuth(token)
 	MakeRequest(t, req, http.StatusOK)
 
 	// Test streaming logs for non-existent run
-	req = NewRequest(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/999999/logs", repo.FullName())).
-		AddTokenAuth(token).
-		SetBody(`{"logCursors": []}`)
+	req = NewRequestWithBody(t, "POST", fmt.Sprintf("/api/v1/repos/%s/actions/runs/999999/logs", repo.FullName()), strings.NewReader(`{"logCursors": []}`)).
+		AddTokenAuth(token)
 	MakeRequest(t, req, http.StatusNotFound)
 }