Files

Defame1297 d5954d3d99 refactor(gitea-files): retrofit to the ADR-0020 context contract

Description 787 -> 263 chars, body 922 -> 302 words, Gotchas 9 entries/69% of
body -> 3/24.8%. Clears both size FAILs and both Gotchas suggestions.

Deleted the second trigger register outright -- ~300 chars re-quoting the same
six verbs as user phrasings, which ADR-0020 names this skill for specifically.

Split the body on the read/write boundary: one invocation cannot both read and
write, so a dispatch table is mandatory. Six operations collapse into two flow
files rather than six -- create/update/delete share one tool pair and one
SHA-first lifecycle whose preamble would otherwise be triplicated, and the three
read tools share ref selection plus a 'neither listing is a SHA source'
comparison that only exists between them.

references/examples.md removed; all eight of its content blocks and all nine
named parameters carry into references/writing.md, verified against git HEAD.
Two deltas are corrections: the repo tree is now ruled out as a SHA source, and
reusing a SHA captured earlier in the conversation is now forbidden.

Four Gotchas relocated to the flow file that needs them; two promoted to gates
(SHA-as-concurrency-token opens writing.md; owner/repo became ## Inputs).

Refs #99

2026-08-30 12:09:52 +00:00

2.5 KiB

Raw Blame History

Sources

gitea-mcp-repo

Description: Official gitea-mcp repository (v1.3.0); operation/*.go source files documenting all 55 MCP tools, their parameters, and CLI flags.

Source: https://gitea.com/gitea/gitea-mcp

Research doc: plugins/gitea/docs/research/docs/gitea/sources.md

Contributing files: (tool parameters and SHA/concurrency behavior cross-checked live against the deployed MCP tool schemas via ToolSearch)

SKILL.md (Gotchas — cross-flow parameter and encoding traps; Dispatch)
references/reading.md (read-tool parameters, ref/tree_sha selection, tree pagination)
references/writing.md (write-tool parameters, SHA/concurrency behavior, canonical call sequences, failed-write triage)

gitea-mcp-slim-go

Description: Slim response shape structs from gitea-mcp source; defines exactly which fields the MCP server returns for files (top-level sha, no nested content.sha) and directory/tree entries.

Source: https://gitea.com/gitea/gitea-mcp/raw/branch/main/operation/repo/slim.go

Research doc: plugins/gitea/docs/research/docs/gitea/sources.md

Contributing files:

SKILL.md (Gotchas — base64 response encoding)
references/reading.md (top-level sha field location, get_dir_contents/get_repository_tree not being usable SHA sources for a file write)
references/writing.md (SHA-first update/delete sequences)

context7-websites-gitea

Description: Official Gitea docs mirror on Context7 (docs.gitea.com content) — confirms direct-commit file editing through the web UI is a first-class, expected workflow rather than an API-only escape hatch.

Source: context7:/websites/gitea

Research doc: plugins/gitea/docs/research/docs/gitea/sources.md

Contributing files:

SKILL.md (Handoff — committing straight to a branch is the normal path, not an escape hatch)

context7-gitea-tea-cli

Description: Official tea CLI (reference Gitea client) docs on Context7 — practitioner command patterns for issues, PRs, and releases, including semver tag/release conventions, draft/prerelease flags, and release-notes-from-file conventions. Consulted alongside context7-websites-gitea while researching workflow-conventions.md (both sources contribute to that research doc, backing gitea-workflow); its file-command patterns did not end up informing any gitea-files content.

Source: context7:/git_gitea_com/gitea_tea

Research doc: plugins/gitea/docs/research/docs/gitea/sources.md

Contributing files: (none)

2.5 KiB Raw Blame History