forgejo-cli: harden API transport and documentation #98

New issue

Closed

opened 2026-07-11 13:19:26 -04:00 by magnus · 0 comments

magnus commented

2026-07-11 13:19:26 -04:00

Owner

Summary

The Forgejo CLI skill exposes a broad API through a small first-class command set and a generic API escape hatch, but its transport behavior and progressive disclosure are incomplete.

Scope

Repair the release external-URL upload transport path.
Preserve response pagination metadata in structured output.
Support repeated query keys and richer authentication/header configuration.
Make first-class command behavior more complete and test HTTP request construction.
Add focused API usage, compatibility, pagination, and endpoint-routing references.
Clarify the supported Forgejo/Gitea compatibility model and documented limitations.

Acceptance criteria

All previous offline tests still pass.
New tests cover the repaired transport and response metadata behavior.
References give an agent a version-aware procedure for selecting first-class versus generic commands.
README and skill instructions accurately describe the interface.

Filed by Codex (AI agent on behalf of Magnus Hedemark)

## Summary The Forgejo CLI skill exposes a broad API through a small first-class command set and a generic API escape hatch, but its transport behavior and progressive disclosure are incomplete. ## Scope - Repair the release external-URL upload transport path. - Preserve response pagination metadata in structured output. - Support repeated query keys and richer authentication/header configuration. - Make first-class command behavior more complete and test HTTP request construction. - Add focused API usage, compatibility, pagination, and endpoint-routing references. - Clarify the supported Forgejo/Gitea compatibility model and documented limitations. ## Acceptance criteria - All previous offline tests still pass. - New tests cover the repaired transport and response metadata behavior. - References give an agent a version-aware procedure for selecting first-class versus generic commands. - README and skill instructions accurately describe the interface. Filed by Codex (AI agent on behalf of Magnus Hedemark)

magnus referenced this issue from a pull request that will close it,

2026-07-11 13:23:13 -04:00

fix(forgejo-cli): harden API transport and guidance #99

magnus closed this issue

2026-07-11 13:25:13 -04:00