Files

Defame1297 0079f3508c fix(gitea-prs): correct reference drift against gitea-mcp v1.7.0

The reference files were last verified against v1.3.0 -- references/sources.md
still said so. PR #106 re-verified the write side only, so three defects had
accumulated on the read/review side. All three reproduced against the deployed
server before being fixed; get_gitea_mcp_server_version reports v1.7.0.

- reviews.md forbade review_comments on the "get" response and directed callers
  to review_scomments, which does not exist. The upstream slim.go typo was
  corrected; a live pull_request_read on PR #106 returns "review_comments":1 and
  no review_scomments key. review_comments is an integer count, not comment
  objects -- distinct from the get_review_comments method. Also fixed in
  pull-requests.md's response-shape list.
- pull_request_review_write grants seven methods; only four were documented.
  reply_comment, resolve_thread, unresolve_thread and the comment_id parameter
  had zero mentions anywhere in the skill. Documented from the schema, in a
  Comment threads section kept outside the numbered review state machine --
  they are not lifecycle states.
- review_id was documented as required for get_review_comments. It is optional;
  omitting it lists every inline comment on the PR. Confirmed behaviourally:
  get_review without it errors, get_review_comments without it returns [].

sources.md now records v1.7.0 as the last-verified version, so the next reader
knows what these files were checked against.

Refs #99

2026-08-30 12:21:11 +00:00

2.3 KiB

Raw Blame History

Sources

gitea-mcp-repo

URL: https://gitea.com/gitea/gitea-mcp
Description: Official gitea-mcp repository — operation/*.go source files documenting the MCP tools, their parameters, and CLI flags. Live tool schemas (list_pull_requests, pull_request_read, pull_request_write, pull_request_review_write) are verified directly against the deployed MCP server via ToolSearch, per this repo's process for resolving schema-vs-docs drift, rather than copied from the derived research doc. Last verified against v1.7.0, as reported by get_gitea_mcp_server_version; the files were originally authored against v1.3.0 and the read/review side had drifted by three defects before that re-verification.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: SKILL.md, references/pull-requests.md, references/reviews.md, references/merging.md
Status: extracted

gitea-mcp-slim-go

URL: https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/pull/slim.go
Description: Slim response shape structs from gitea-mcp source — defines exactly which fields the MCP server returns for PRs and reviews, including the PR-response milestone-as-title-string quirk. The review_scomments misspelling this file documented at v1.3.0 was corrected upstream; v1.7.0 returns review_comments.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: SKILL.md, references/pull-requests.md, references/reviews.md
Status: extracted

context7-websites-gitea

URL: context7:/websites/gitea
Description: Official Gitea docs mirror on Context7 — branch protection rules, PR review/merge gating behavior, and automatic issue/PR cross-reference linking. Backfills the external/best-practice gap left by the original docs.gitea.com fetch timeout.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: references/merging.md
Status: extracted

context7-gitea-tea-cli

URL: context7:/git_gitea_com/gitea_tea
Description: Official tea CLI (reference Gitea client) docs on Context7 — practitioner command patterns for PR review workflows.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: references/merging.md
Status: extracted

2.3 KiB Raw Blame History

Sources

gitea-mcp-repo

gitea-mcp-slim-go

context7-websites-gitea

context7-gitea-tea-cli

2.3 KiB

Raw Blame History