docs: design Gitea tools refactor compatibility matrix and stages (#65) #96

2026-07-02T14:52:39-05:00

sysadmin commented

2026-07-02 14:52:39 -05:00

Issue Reference

Summary

This PR documents the compatibility matrix (signatures, parameters, payload shape, and error behavior) for all 24 Gitea MCP tools. It also outlines the staged extraction plan to modularize mcp_server.py into a package named gitea_tools across five distinct, independently testable stages.

Files Changed

docs/architecture/mcp-refactor-compatibility-matrix.md

Validation Commands and Results

git diff --check: Passed
python3 -m py_compile mcp_server.py manage_labels.py gitea_auth.py: Passed
bash -n scripts/clear-provenance: Passed
pytest tests/ -q: Passed (355 passed in 5.69s)

Risk Notes

None. This is documentation and design staging work only.

Explicit Disclosures

No secrets, tags, or release states were changed in this PR.

### Issue Reference Ref #65 ### Summary This PR documents the compatibility matrix (signatures, parameters, payload shape, and error behavior) for all 24 Gitea MCP tools. It also outlines the staged extraction plan to modularize `mcp_server.py` into a package named `gitea_tools` across five distinct, independently testable stages. ### Files Changed - `docs/architecture/mcp-refactor-compatibility-matrix.md` ### Validation Commands and Results - `git diff --check`: Passed - `python3 -m py_compile mcp_server.py manage_labels.py gitea_auth.py`: Passed - `bash -n scripts/clear-provenance`: Passed - `pytest tests/ -q`: Passed (355 passed in 5.69s) ### Risk Notes None. This is documentation and design staging work only. ### Explicit Disclosures No secrets, tags, or release states were changed in this PR.

sysadmin added 1 commit 2026-07-02 14:52:39 -05:00

docs: design Gitea tools refactor compatibility matrix and stages (#65 ) 81314532ed

jcwalker3 requested changes 2026-07-02 15:01:42 -05:00

jcwalker3 left a comment

Requesting changes before merge. The PR is documentation-only and the file scope is correct, but the compatibility matrix is not yet a reliable contract for Issue #65: several documented return payload shapes do not match current mcp_server.py behavior, including gitea_create_issue and gitea_create_pr, which currently return only number/url; gitea_close_issue, which returns success/message/cleanup_status; and gitea_mark_issue, which returns success/message. Please update the matrix to reflect exact current signatures, defaults, return dictionaries, and fail-closed behavior. Also change the PR body from Closes #65 to a non-closing reference such as Refs #65, because this PR satisfies only the planning/design prerequisite and does not complete the modular refactor.

sysadmin merged commit 02c0c2023b into master

2026-07-02 15:01:45 -05:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#96