Add GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs

[bn-zr]

• Add GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs endpoint, matching the https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2026-03-10#list-workflow-runs-for-a-workflow

[silverwind]

This PR aims for GitHub API compatibility. A few items drift from that — implement what's feasible.

1. workflow_id numeric IDs. GitHub docs:

   The ID of the workflow. You can also pass the workflow file name as a string.

   Gitea stores workflow_id as a filename (models/actions/run.go:36) with no numeric ID concept. Implementing this is out of scope, but the swagger description should say "filename only (e.g. build.yml)" so users don't pass numeric IDs expecting them to work.

2. Missing query parameters. GitHub documents these; consider adding the feasible ones:

   • created — date-time range. Parse >=, <=, .. operators and add a created_unix range filter to FindRunOptions.
   • exclude_pull_requests — boolean. When true, add builder.Neq{"trigger_event": "pull_request"} in FindRunOptions.ToConds().

3. Nonexistent workflow returns 200 with empty list. ActionsGetWorkflow in this same file returns 404 for an unknown workflow_id. For consistency:

   workflowID := ctx.PathParam("workflow_id")
   if _, err := convert.GetActionWorkflow(ctx, ctx.Repo.GitRepo, ctx.Repo.Repository, workflowID); err != nil {
       if errors.Is(err, util.ErrNotExist) {
           ctx.APIError(http.StatusNotFound, err)
       } else {
           ctx.APIErrorInternal(err)
       }
       return
   }

   Replace the empty-list test assertion with a 404 check.

4. Test loop break. If the expected run appears first, filter checks on later runs are skipped. Drop the break:

   for _, run := range runList.Entries {
       verifyWorkflowRunCanbeFoundWithStatusFilter(t, workflowRunsURL, token, run.ID, "", run.Status, "", "", "", "")
       verifyWorkflowRunCanbeFoundWithStatusFilter(t, workflowRunsURL, token, run.ID, "", "", "", run.HeadBranch, "", "")
       verifyWorkflowRunCanbeFoundWithStatusFilter(t, workflowRunsURL, token, run.ID, "", "", run.Event, "", "", "")
       if run.ID == expectedRunID {
           found = true
       }
   }

5. Filter coverage. Add actor and head_sha checks to testAPIWorkflowRunsByWorkflowID, mirroring testAPIWorkflowRunBasic.

---

Comment written by Claude Opus 4.6.

[bircni]

passes locally @silverwind can you rerun? thats weird...

[silverwind]

Ensure you run without test cache: go test -count=1 ..., could also be flaky. Run a few times to verify that.

[silverwind]

Is it ready?

[silverwind]

Cleaned up and addressed outstanding review in 897e97e.

[wxiaoguang]

Does it really match GitHub's document?

If I understand correctly, ExcludePullRequests means "no PRs in the response", but doesn't mean filtering the runs.

[silverwind]

You're right, original review was a hallucination. Fixing it.

[wxiaoguang]

I don't want to be right.

I really hope maintainers can be more careful for the AI outputs, don't blindly trust them.

[silverwind]

Review was from lobotomized Opus 4.6, sorry. And yes we need to be more careful.

[silverwind]

Adding this seems to considerably increase this PR's scope, not sure it's worth. I'll push it, then we can decide whether to keep it or omit that flag for now.

[silverwind]

Done in 1e0262f. @lunny you should also re-review please for this PullRequestMinimal introduction.

[lunny]

Missed the right meaning of ExcludePullRequests