Files

Defame1297 547a653fa0 fix(gitea): fill provenance gap in gitea-branches sources.md

The gitea-branches skill was authored before the context7 research
backfill (workflow-conventions.md) landed on this branch, so its
sources.md was missing context7-websites-gitea and
context7-gitea-tea-cli — both present with status `extracted` in the
upstream research doc, which validate-provenance.sh requires every
consuming skill to account for. Adds context7-websites-gitea (credited
for the protected-branch gotcha) and context7-gitea-tea-cli (marked
`(none)` — its release/tag content is out of scope for branches/commits).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-05 13:57:12 +00:00

2.7 KiB

Raw Blame History

Sources

Note on call signatures: per docs/adr/0011-gitea-skill-deep-modules.md, the tool parameter signatures in references/branches.md and references/commits.md were re-verified live via ToolSearch against the deployed gitea-mcp server at authoring time — they are not copied verbatim from api-reference.md below. This resolves issue #6 comment #849's root-cause finding that a prior skill was authored from API docs that had drifted from the actual MCP tool schema. The research docs cited here informed gotchas, response shapes, and workflow context, not the parameter lists themselves.

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. Informed the dispatch table and pagination / 404-may-mean-403 gotchas in SKILL.md, and the list/create/delete branch and list/get commit mechanics (including 409 conflict and default-branch fallback behavior) in references/branches.md and references/commits.md.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: SKILL.md, references/branches.md, references/commits.md
Status: extracted

gitea-mcp-slim-go

URL: https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/repo/slim.go
Description: Slim response shape structs from gitea-mcp source; defines exactly which fields the MCP server returns for branches (name, protected, commit_sha) and commits (sha, html_url, created, message, author), and informed get_commit's always-populated guarantee vs. list_commits' conditional fields.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: references/branches.md, references/commits.md
Status: extracted

context7-websites-gitea

URL: context7:/websites/gitea
Description: Official Gitea docs mirror on Context7 — informed the protected-branch gotcha in SKILL.md (protected branches can block server-side operations regardless of client-side checks; admins aren't exempt by default).
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: SKILL.md
Status: extracted

context7-gitea-tea-cli

URL: context7:/git_gitea_com/gitea_tea
Description: Official tea CLI docs on Context7 — practitioner conventions for issues, PRs, and releases (semver tags, draft/prerelease flags). Consulted as part of the shared research pass but its content is scoped to releases/tags, out of scope for branches/commits — no content from it was used in this skill.
Research doc: plugins/gitea/docs/research/docs/gitea/sources.md
Contributing files: (none)
Status: extracted

2.7 KiB Raw Blame History