agentic-forges/forgejo-mcp
Watch
5
0
Fork
You've already forked forgejo-mcp
 0
Code Issues 9 Pull requests 6 Projects Releases 32 Packages 1 Activity

docs: propose releases support (closes #127) #129

Merged
goern merged 0 commits from refs/pull/129/head into main 2026-05-11 14:24:46 +00:00
Conversation 0 Commits - Files changed 323 +2810 -34606
goern commented 2026-05-11 14:04:15 +00:00 (Migrated from codeberg.org)
Copy link

Summary

OpenSpec proposal for adding Forgejo releases support to forgejo-mcp, per issue #127.

Adds a new openspec change add-releases-support (proposal artifact only — design/specs/tasks follow in subsequent commits).

Capability

New: release-management — 13 MCP tools across two sub-surfaces:

  • Releases (8): list_releases, get_release_by_id, get_release_by_tag, get_latest_release, create_release, edit_release, delete_release, delete_release_by_tag
  • Release attachments (5): list_release_attachments, get_release_attachment, create_release_attachment, edit_release_attachment, delete_release_attachment

All list endpoints satisfy docs/design/output-bounding.md (client-controlled page + limit).

Dependencies

None new — codeberg.org/mvdkleijn/forgejo-sdk/forgejo/v3 v3.0.0 already exposes every required method.

Status

This PR is proposal-only. Implementation lands in a follow-up once the proposal is acknowledged.

  • proposal.md
  • design.md
  • specs/release-management/spec.md
  • tasks.md
  • implementation (operation/release/)
  • DEVELOPER.md + README tools-table updates

Test plan

  • openspec validate add-releases-support passes once specs + tasks land
  • Tool registrations show up in MCP server tool list
  • Manual smoke against a Codeberg repo: list/get/create/edit/delete
  • Attachment upload/download round-trip
## Summary OpenSpec proposal for adding Forgejo releases support to `forgejo-mcp`, per issue #127. Adds a new openspec change `add-releases-support` (proposal artifact only — design/specs/tasks follow in subsequent commits). ## Capability **New:** `release-management` — 13 MCP tools across two sub-surfaces: - **Releases (8):** `list_releases`, `get_release_by_id`, `get_release_by_tag`, `get_latest_release`, `create_release`, `edit_release`, `delete_release`, `delete_release_by_tag` - **Release attachments (5):** `list_release_attachments`, `get_release_attachment`, `create_release_attachment`, `edit_release_attachment`, `delete_release_attachment` All list endpoints satisfy `docs/design/output-bounding.md` (client-controlled `page` + `limit`). ## Dependencies None new — `codeberg.org/mvdkleijn/forgejo-sdk/forgejo/v3 v3.0.0` already exposes every required method. ## Status This PR is **proposal-only**. Implementation lands in a follow-up once the proposal is acknowledged. - [x] proposal.md - [ ] design.md - [ ] specs/release-management/spec.md - [ ] tasks.md - [ ] implementation (operation/release/) - [ ] DEVELOPER.md + README tools-table updates ## Test plan - [ ] `openspec validate add-releases-support` passes once specs + tasks land - [ ] Tool registrations show up in MCP server tool list - [ ] Manual smoke against a Codeberg repo: list/get/create/edit/delete - [ ] Attachment upload/download round-trip
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
Compat/Breaking
Breaking change that won't be backward compatible

  
Kind/Bug
Something is not working

  
Kind/Documentation
Documentation changes

  
Kind/Enhancement
Improve existing functionality

  
Kind/Feature
New functionality

  
Kind/OpenSpec
OpenSpec change proposal / spec-driven work

  
Kind/Security
This is security issue

  
Kind/Testing
Issue or pull request related to testing

  
Priority/Critical
The priority is critical

  
Priority/High
The priority is high

  
Priority/Low
The priority is low

  
Priority/Medium
The priority is medium

  
RFC - Request For Comments
Request For Comments — design/spec open for feedback before implementation

  
Reviewed/Confirmed
Issue has been confirmed

  
Reviewed/Duplicate
This issue or pull request already exists

  
Reviewed/Invalid
Invalid issue

  
Reviewed/Won't Fix
This issue won't be fixed

  
Status/Abandoned
Somebody has started to work on this but abandoned work

  
Status/Blocked
Something is blocking this issue or pull request

  
Status/Need More Info
Feedback is required to reproduce issue or to continue work

  
hermes-attempted
Hermes attempted but produced no changes

  
hermes-needs-clarification
Quality gate flagged, needs human input

  
hermes-ready
Ready for hermes to process

  
hermes-review
Hermes PR awaiting review

  
hermes-wip
Hermes is working on this

  
human-required
Hermes gave up after 3 attempts

No labels
Compat/Breaking
Kind/Bug
Kind/Documentation
Kind/Enhancement
Kind/Feature
Kind/OpenSpec
Kind/Security
Kind/Testing
Priority/Critical
Priority/High
Priority/Low
Priority/Medium
RFC - Request For Comments
Reviewed/Confirmed
Reviewed/Duplicate
Reviewed/Invalid
Reviewed/Won't Fix
Status/Abandoned
Status/Blocked
Status/Need More Info
hermes-attempted
hermes-needs-clarification
hermes-ready
hermes-review
hermes-wip
human-required
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
agentic-forges/forgejo-mcp!129
No description provided.