docs: README missing update_issue, auth section outdated, no CLAUDE.md #26

New issue

Closed

opened 2026-06-13 18:06:29 +00:00 by ldraney · 0 comments

ldraney commented

2026-06-13 18:06:29 +00:00

Owner

Type

Bug

Lineage

Discovered during docs audit session 2026-06-13.

Repo

forgejo-mcp

What Broke

README tool list is stale — missing update_issue (added in 05b4a18). Auth section shows basic auth as primary despite token auth being preferred since create_api_token landed. No CLAUDE.md exists so Claude Code sessions don't pick up tool inventory.

Repro Steps

Open README.md — update_issue not listed
Auth section only shows FORGEJO_USER/FORGEJO_PASSWORD example
ls CLAUDE.md — file not found

Expected Behavior

All 14 tools listed in README
Auth section shows token auth as preferred
CLAUDE.md exists (symlink to README)

Environment

forgejo-mcp main @ 05b4a18

Acceptance Criteria

update_issue in README tool list
Auth section shows FORGEJO_TOKEN as preferred, basic auth as fallback
server.py docstring matches README auth description
CLAUDE.md symlink to README exists

05b4a18 feat: add update_issue MCP tool (#25)

### Type Bug ### Lineage Discovered during docs audit session 2026-06-13. ### Repo forgejo-mcp ### What Broke README tool list is stale — missing `update_issue` (added in 05b4a18). Auth section shows basic auth as primary despite token auth being preferred since `create_api_token` landed. No CLAUDE.md exists so Claude Code sessions don't pick up tool inventory. ### Repro Steps 1. Open README.md — `update_issue` not listed 2. Auth section only shows `FORGEJO_USER`/`FORGEJO_PASSWORD` example 3. `ls CLAUDE.md` — file not found ### Expected Behavior - All 14 tools listed in README - Auth section shows token auth as preferred - CLAUDE.md exists (symlink to README) ### Environment forgejo-mcp main @ 05b4a18 ### Acceptance Criteria - [ ] `update_issue` in README tool list - [ ] Auth section shows `FORGEJO_TOKEN` as preferred, basic auth as fallback - [ ] server.py docstring matches README auth description - [ ] CLAUDE.md symlink to README exists ### Related - 05b4a18 feat: add update_issue MCP tool (#25)