docs: regenerate tool inventory after annotation overrides

README.md

@@ -323,17 +323,17 @@ Gitea are sanitized and truncated. Calling an unknown or filtered tool is a prot
 | admin | 33 | 14 | 19 |
 | hook | 20 | 8 | 12 |
 | issue | 73 | 25 | 48 |
-| misc | 20 | 15 | 5 |
+| misc | 20 | 18 | 2 |
 | notification | 7 | 4 | 3 |
 | org | 45 | 17 | 28 |
 | package | 9 | 5 | 4 |
 | pull | 26 | 11 | 15 |
 | release | 13 | 6 | 7 |
-| repo | 124 | 66 | 58 |
+| repo | 124 | 67 | 57 |
 | team | 15 | 8 | 7 |
 | user | 77 | 44 | 33 |
 | wiki | 6 | 3 | 3 |
-| **all** | **538** | **261** | **277** |
+| **all** | **538** | **265** | **273** |
 
 The full list with HTTP method, path and flags is in [docs/tools.md](docs/tools.md).
 <!-- tool-summary:end -->

docs/tools.md

@@ -20,17 +20,17 @@ Flags: read-only (maps to the MCP `readOnlyHint`), destructive (`destructiveHint
 | admin | 33 | 14 | 19 |
 | hook | 20 | 8 | 12 |
 | issue | 73 | 25 | 48 |
-| misc | 20 | 15 | 5 |
+| misc | 20 | 18 | 2 |
 | notification | 7 | 4 | 3 |
 | org | 45 | 17 | 28 |
 | package | 9 | 5 | 4 |
 | pull | 26 | 11 | 15 |
 | release | 13 | 6 | 7 |
-| repo | 124 | 66 | 58 |
+| repo | 124 | 67 | 57 |
 | team | 15 | 8 | 7 |
 | user | 77 | 44 | 33 |
 | wiki | 6 | 3 | 3 |
-| **all** | **538** | **261** | **277** |
+| **all** | **538** | **265** | **273** |
 
 ## actions
 
@@ -116,7 +116,7 @@ Instance administration: users, organizations, emails, cron tasks, system hooks,
 | Tool | Method | Path | Summary | Flags |
 |---|---|---|---|---|
 | `gitea_admin_add_user_badges` | POST | `/admin/users/{username}/badges` | Add a badge to a user | admin |
-| `gitea_admin_adopt_repository` | POST | `/admin/unadopted/{owner}/{repo}` | Adopt unadopted files as a repository | admin |
+| `gitea_admin_adopt_repository` | POST | `/admin/unadopted/{owner}/{repo}` | Adopt unadopted files as a repository | destructive, admin |
 | `gitea_admin_create_hook` | POST | `/admin/hooks` | Create a hook | admin |
 | `gitea_admin_create_org` | POST | `/admin/users/{username}/orgs` | Create an organization | admin |
 | `gitea_admin_create_public_key` | POST | `/admin/users/{username}/keys` | Add a public key on behalf of a user | admin |
@@ -124,7 +124,7 @@ Instance administration: users, organizations, emails, cron tasks, system hooks,
 | `gitea_admin_create_runner_registration_token` | POST | `/admin/actions/runners/registration-token` | Get a global actions runner registration token | admin |
 | `gitea_admin_create_user` | POST | `/admin/users` | Create a user | admin |
 | `gitea_admin_cron_list` | GET | `/admin/cron` | List cron tasks | read-only, paginated, admin |
-| `gitea_admin_cron_run` | POST | `/admin/cron/{task}` | Run cron task | admin |
+| `gitea_admin_cron_run` | POST | `/admin/cron/{task}` | Run cron task | destructive, admin |
 | `gitea_admin_delete_hook` | DELETE | `/admin/hooks/{id}` | Delete a hook | destructive, admin |
 | `gitea_admin_delete_runner` | DELETE | `/admin/actions/runners/{runner_id}` | Delete a global runner | destructive, admin |
 | `gitea_admin_delete_unadopted_repository` | DELETE | `/admin/unadopted/{owner}/{repo}` | Delete unadopted files | destructive, admin |
@@ -143,7 +143,7 @@ Instance administration: users, organizations, emails, cron tasks, system hooks,
 | `gitea_admin_list_user_badges` | GET | `/admin/users/{username}/badges` | List a user's badges | read-only, admin |
 | `gitea_admin_list_workflow_jobs` | GET | `/admin/actions/jobs` | Lists all jobs | read-only, paginated, admin |
 | `gitea_admin_list_workflow_runs` | GET | `/admin/actions/runs` | Lists all runs | read-only, paginated, admin |
-| `gitea_admin_rename_user` | POST | `/admin/users/{username}/rename` | Rename a user | admin |
+| `gitea_admin_rename_user` | POST | `/admin/users/{username}/rename` | Rename a user | destructive, admin |
 | `gitea_admin_search_emails` | GET | `/admin/emails/search` | Search all emails | read-only, paginated, admin |
 | `gitea_admin_search_users` | GET | `/admin/users` | Search users according filter conditions | read-only, paginated, admin |
 | `gitea_admin_unadopted_list` | GET | `/admin/unadopted` | List unadopted repositories | read-only, paginated, admin |
@@ -278,9 +278,9 @@ Version, settings, markdown rendering, license, gitignore and label templates, s
 | `gitea_misc_list_gitignores_templates` | GET | `/gitignore/templates` | Returns a list of all gitignore templates | read-only |
 | `gitea_misc_list_label_templates` | GET | `/label/templates` | Returns a list of all label templates | read-only |
 | `gitea_misc_list_license_templates` | GET | `/licenses` | Returns a list of all license templates | read-only |
-| `gitea_misc_render_markdown` | POST | `/markdown` | Render a markdown document as HTML |  |
+| `gitea_misc_render_markdown` | POST | `/markdown` | Render a markdown document as HTML | read-only |
-| `gitea_misc_render_markdown_raw` | POST | `/markdown/raw` | Render raw markdown as HTML |  |
+| `gitea_misc_render_markdown_raw` | POST | `/markdown/raw` | Render raw markdown as HTML | read-only |
-| `gitea_misc_render_markup` | POST | `/markup` | Render a markup document as HTML |  |
+| `gitea_misc_render_markup` | POST | `/markup` | Render a markup document as HTML | read-only |
 | `gitea_misc_topic_search` | GET | `/topics/search` | search topics via keyword | read-only, paginated |
 
 ## notification
@@ -344,7 +344,7 @@ Organizations, members, public members, blocks, labels, avatars and activity. 45
 | `gitea_org_move_project_issue` | POST | `/orgs/{org}/projects/{id}/issues/{issue_id}/move` | Move an issue between a project's columns |  |
 | `gitea_org_publicize_member` | PUT | `/orgs/{org}/public_members/{username}` | Publicize a user's membership | destructive |
 | `gitea_org_remove_issue_from_project_column` | DELETE | `/orgs/{org}/projects/{id}/columns/{column_id}/issues/{issue_id}` | Remove an issue from a project column | destructive |
-| `gitea_org_rename` | POST | `/orgs/{org}/rename` | Rename an organization |  |
+| `gitea_org_rename` | POST | `/orgs/{org}/rename` | Rename an organization | destructive |
 | `gitea_org_set_default_project_column` | POST | `/orgs/{org}/projects/{id}/columns/{column_id}/default` | Set a project's default column |  |
 | `gitea_org_unblock_user` | DELETE | `/orgs/{org}/blocks/{username}` | Unblock a user | destructive |
 | `gitea_org_update_avatar` | POST | `/orgs/{org}/avatar` | Update Avatar |  |
@@ -390,7 +390,7 @@ Pull requests, merging, reviews, review comments, requested reviewers, diffs. 26
 | `gitea_pull_list_pinned_pull_requests` | GET | `/repos/{owner}/{repo}/pulls/pinned` | List a repo's pinned pull requests | read-only |
 | `gitea_pull_list_pull_requests` | GET | `/repos/{owner}/{repo}/pulls` | List a repo's pull requests | read-only, paginated |
 | `gitea_pull_list_pull_reviews` | GET | `/repos/{owner}/{repo}/pulls/{index}/reviews` | List all reviews for a pull request | read-only, paginated |
-| `gitea_pull_merge_pull_request` | POST | `/repos/{owner}/{repo}/pulls/{index}/merge` | Merge a pull request |  |
+| `gitea_pull_merge_pull_request` | POST | `/repos/{owner}/{repo}/pulls/{index}/merge` | Merge a pull request | destructive |
 | `gitea_pull_pull_request_is_merged` | GET | `/repos/{owner}/{repo}/pulls/{index}/merge` | Check if a pull request has been merged | read-only |
 | `gitea_pull_resolve_pull_review_comment` | POST | `/repos/{owner}/{repo}/pulls/comments/{id}/resolve` | Resolve a pull request review comment |  |
 | `gitea_pull_submit_pull_review` | POST | `/repos/{owner}/{repo}/pulls/{index}/reviews/{id}` | Submit a pending review to a pull request |  |
@@ -424,7 +424,7 @@ Repositories: CRUD, contents, branches, tags, commits, forks, mirrors, collabora
 
 | Tool | Method | Path | Summary | Flags |
 |---|---|---|---|---|
-| `gitea_repo_accept_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer/accept` | Accept a repo transfer |  |
+| `gitea_repo_accept_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer/accept` | Accept a repo transfer | destructive |
 | `gitea_repo_add_collaborator` | PUT | `/repos/{owner}/{repo}/collaborators/{collaborator}` | Add or Update a collaborator to a repository | destructive |
 | `gitea_repo_add_issue_to_project_column` | POST | `/repos/{owner}/{repo}/projects/{id}/columns/{column_id}/issues/{issue_id}` | Add an issue to a project column |  |
 | `gitea_repo_add_push_mirror` | POST | `/repos/{owner}/{repo}/push_mirrors` | add a push mirror to the repository |  |
@@ -486,7 +486,7 @@ Repositories: CRUD, contents, branches, tags, commits, forks, mirrors, collabora
 | `gitea_repo_get_contents_list` | GET | `/repos/{owner}/{repo}/contents` | Gets the metadata of all the entries of the root dir. | read-only |
 | `gitea_repo_get_editor_config` | GET | `/repos/{owner}/{repo}/editorconfig/{filepath}` | Get the EditorConfig definitions of a file in a repository | read-only |
 | `gitea_repo_get_file_contents` | GET | `/repos/{owner}/{repo}/file-contents` | Get the metadata and contents of requested files | read-only |
-| `gitea_repo_get_file_contents_post` | POST | `/repos/{owner}/{repo}/file-contents` | Get the metadata and contents of requested files |  |
+| `gitea_repo_get_file_contents_post` | POST | `/repos/{owner}/{repo}/file-contents` | Get the metadata and contents of requested files | read-only |
 | `gitea_repo_get_issue_config` | GET | `/repos/{owner}/{repo}/issue_config` | Returns the issue config for a repo | read-only |
 | `gitea_repo_get_issue_templates` | GET | `/repos/{owner}/{repo}/issue_templates` | Get available issue templates for a repository | read-only |
 | `gitea_repo_get_key` | GET | `/repos/{owner}/{repo}/keys/{id}` | Get a repository's key by id | read-only |
@@ -525,15 +525,15 @@ Repositories: CRUD, contents, branches, tags, commits, forks, mirrors, collabora
 | `gitea_repo_list_teams` | GET | `/repos/{owner}/{repo}/teams` | List a repository's teams | read-only |
 | `gitea_repo_list_topics` | GET | `/repos/{owner}/{repo}/topics` | Get list of topics that a repository has | read-only, paginated |
 | `gitea_repo_list_user_tracked_times` | GET | `/repos/{owner}/{repo}/times/{user}` | List a user's tracked times in a repo | read-only |
-| `gitea_repo_merge_upstream` | POST | `/repos/{owner}/{repo}/merge-upstream` | Merge a branch from upstream |  |
+| `gitea_repo_merge_upstream` | POST | `/repos/{owner}/{repo}/merge-upstream` | Merge a branch from upstream | destructive |
 | `gitea_repo_migrate` | POST | `/repos/migrate` | Migrate a remote git repository |  |
-| `gitea_repo_mirror_sync` | POST | `/repos/{owner}/{repo}/mirror-sync` | Sync a mirrored repository |  |
+| `gitea_repo_mirror_sync` | POST | `/repos/{owner}/{repo}/mirror-sync` | Sync a mirrored repository | destructive |
 | `gitea_repo_move_project_columns` | POST | `/repos/{owner}/{repo}/projects/{id}/columns/move` | Reorder a project's columns |  |
 | `gitea_repo_move_project_issue` | POST | `/repos/{owner}/{repo}/projects/{id}/issues/{issue_id}/move` | Move an issue between a project's columns |  |
 | `gitea_repo_new_pin_allowed` | GET | `/repos/{owner}/{repo}/new_pin_allowed` | Returns if new Issue Pins are allowed | read-only |
-| `gitea_repo_push_mirror_sync` | POST | `/repos/{owner}/{repo}/push_mirrors-sync` | Sync all push mirrored repository |  |
+| `gitea_repo_push_mirror_sync` | POST | `/repos/{owner}/{repo}/push_mirrors-sync` | Sync all push mirrored repository | destructive |
 | `gitea_repo_put_subscription` | PUT | `/repos/{owner}/{repo}/subscription` | Watch a repo | destructive |
-| `gitea_repo_reject_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer/reject` | Reject a repo transfer |  |
+| `gitea_repo_reject_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer/reject` | Reject a repo transfer | destructive |
 | `gitea_repo_remove_issue_from_project_column` | DELETE | `/repos/{owner}/{repo}/projects/{id}/columns/{column_id}/issues/{issue_id}` | Remove an issue from a project column | destructive |
 | `gitea_repo_rename_branch` | PATCH | `/repos/{owner}/{repo}/branches/{branch}` | Rename a branch | destructive |
 | `gitea_repo_search` | GET | `/repos/search` | Search for repositories | read-only, paginated |
@@ -541,7 +541,7 @@ Repositories: CRUD, contents, branches, tags, commits, forks, mirrors, collabora
 | `gitea_repo_signing_key` | GET | `/repos/{owner}/{repo}/signing-key.gpg` | Get signing-key.gpg for given repository | read-only |
 | `gitea_repo_signing_key_ssh` | GET | `/repos/{owner}/{repo}/signing-key.pub` | Get signing-key.pub for given repository | read-only |
 | `gitea_repo_tracked_times` | GET | `/repos/{owner}/{repo}/times` | List a repo's tracked times | read-only, paginated |
-| `gitea_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer` | Transfer a repo ownership |  |
+| `gitea_repo_transfer` | POST | `/repos/{owner}/{repo}/transfer` | Transfer a repo ownership | destructive |
 | `gitea_repo_update_avatar` | POST | `/repos/{owner}/{repo}/avatar` | Update avatar |  |
 | `gitea_repo_update_branch` | PUT | `/repos/{owner}/{repo}/branches/{branch}` | Update a branch reference to a new commit | destructive |
 | `gitea_repo_update_branch_protection_priorities` | POST | `/repos/{owner}/{repo}/branch_protections/priority` | Update the priorities of branch protections for a repository. |  |