feat(api): add resolve/unresolve review comment endpoints

[bircni]

Summary

I added API endpoints to resolve and unresolve pull request review comments.
This mirrors the UI conversation resolve behavior and returns the updated PullReviewComment with resolver information.

Usage

New endpoints:

• POST /repos/{owner}/{repo}/pulls/{index}/comments/{id}/resolve
• POST /repos/{owner}/{repo}/pulls/{index}/comments/{id}/unresolve

Example:

curl -X POST -H "Authorization: token $TOKEN" -H "Accept: application/json" http://localhost:3000/api/v1/repos/OWNER/REPO/pulls/PR_INDEX/comments/COMMENT_ID/resolve

[Copilot]

Pull request overview

This PR adds API endpoints to resolve and unresolve pull request review comments, providing programmatic access to functionality that previously existed only in the UI.

Changes:

• Added POST endpoints /repos/{owner}/{repo}/pulls/{index}/comments/{id}/resolve and /repos/{owner}/{repo}/pulls/{index}/comments/{id}/unresolve
• Refactored ToPullReviewCommentList to extract a new ToPullReviewComment function for converting single comments
• Updated Swagger documentation to reflect the new API endpoints

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
routers/api/v1/api.go	Registers the new resolve/unresolve routes with appropriate middleware for authentication and archive checks
routers/api/v1/repo/pull_review.go	Implements the handler functions with permission checks, validation, and response formatting
services/convert/pull_review.go	Refactors comment conversion logic to support both list and single comment conversion
templates/swagger/v1_json.tmpl	Adds OpenAPI/Swagger documentation for the new endpoints

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[lunny]

It's better to add some tests

[bircni]

@lunny added some tests 😄

[wxiaoguang]

It doesn't need issue index, see the /issues/comments/{id}

[lafriks]

Should it better go under /pulls/reviews as only review comments can be marked resolved?

[lafriks]

While it could be not very useful to provide review id in url but there is already /pulls/review/{id}/comments endpoint that can be base for this

[wxiaoguang]

Issue endpoints have already deprecated the unnecessary index

// EditIssueCommentDeprecated modify a comment of an issue
func EditIssueCommentDeprecated(ctx *context.APIContext) {
	// swagger:operation PATCH /repos/{owner}/{repo}/issues/{index}/comments/{id} issue issueEditCommentDeprecated

[wxiaoguang]

By the way, no need to rebase: https://github.com/go-gitea/gitea/blob/main/CONTRIBUTING.md#maintaining-open-prs

[bircni]

whoops sorry 👍

[lafriks]

Blocking currently so we can discuss the best endpoint name

[wxiaoguang]

Blocking currently so we can discuss the best endpoint name

If you'd like to edit this PR to update the endpoints, feel free to do so. But I think the current design is good enough, I don't think adding issue index makes sense, I don't think "review id" is related or necessary. Update: I have objection for adding any other unnecessary id into the endpoint.

If you don't want to edit this PR, I think we can go with this.