Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
Files
d578d6b2f2e0f2342f94c0c6f8f09771a419ebbd
holocron/plugins/gitea/.apm/skills/gitea-prs/references/sources.md
Defame1297 d578d6b2f2 refactor(gitea-prs): retrofit to the ADR-0020 context contract 
Description 709 -> 161 chars, body 683 -> 353 words, Gotchas 8 entries/56% of
body -> 2/24.9%. Clears the description FAIL and both Vale CompositionNote
errors.

Fixes the three stale claims recorded on issue #99, all re-verified against the
deployed gitea-mcp schema during review:

- The description no longer advertises 'reviewers' as an update capability.
  editPullRequestFn never reads reviewers or team_reviewers; only
  add_reviewers/remove_reviewers do.
- milestone is now marked honoured on "update" only, in the Gotcha, the body
  and the dispatch table's create row. On "create" the server discards it and
  omits the key from the response, so the drop is indistinguishable from never
  passing it -- and labels DOES apply on create, so labels landing is no
  evidence the milestone did. The old text told callers to resolve a milestone
  before any write, wasting the lookup on create.
- The superseded un-draft workaround is gone. "update" with draft:false and no
  title makes the server strip the prefix itself, including [WIP],
  case-insensitively -- carried by references/pull-requests.md, corrected in
  PR #106.

The 22-row tool/method table becomes a 5-row dispatch table; all 20 operations
it named remain reachable, including update_branch and the reviewer methods.

Refs #99
2026-08-30 12:10:21 +00:00

2.1 KiB
Raw Blame History

Sources

gitea-mcp-repo

  • URL: https://gitea.com/gitea/gitea-mcp
  • Description: Official gitea-mcp repository (v1.3.0) — operation/*.go source files documenting all 55 MCP tools, their parameters, and CLI flags. Live tool schemas (list_pull_requests, pull_request_read, pull_request_write, pull_request_review_write) were verified directly against the deployed MCP server via ToolSearch at authoring time, per this repo's process for resolving schema-vs-docs drift, rather than copied from the derived research doc.
  • 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 review_scomments typo and the PR-response milestone-as-title-string quirk.
  • 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
Reference in New Issue View Git Blame Copy Permalink