42 lines
2.7 KiB
Markdown
42 lines
2.7 KiB
Markdown
# 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`
|