feat(profiles/gitlab): add snippet notes endpoints to close note_id dead-end

- openapi.yaml: add GET /snippets/{id}/notes and GET /snippets/{id}/notes/{note_id} (218 operationIds)
- retrieve_content: add list_snippet_notes, get_snippet_note actions with response_fields, required_for
- manage_snippets: add list_notes, get_note actions with response_fields, required_for
- Fix owned/membership params: remove incorrect required_for so they remain optional filters
- Both test files: add list/get snippet note scenarios

Agent authored

Author: David Ruzicka

profiles/gitlab/developer-profile-oauth.json

@@ -407,7 +407,7 @@
 
     {
       "name": "manage_snippets",
-      "description": "Work with project snippets. Actions: 'list_snippets', 'get_snippet', 'download_snippet', 'list_award_emoji', 'get_award_emoji', 'create_award_emoji', 'delete_award_emoji', 'list_note_award_emoji', 'get_note_award_emoji', 'create_note_award_emoji', 'delete_note_award_emoji'. For snippet-specific actions, pass 'snippet_id'. For note award emoji actions, also pass 'note_id'.",
+      "description": "Work with project snippets. Actions: 'list_snippets', 'get_snippet', 'download_snippet', 'list_notes', 'get_note', 'list_award_emoji', 'get_award_emoji', 'create_award_emoji', 'delete_award_emoji', 'list_note_award_emoji', 'get_note_award_emoji', 'create_note_award_emoji', 'delete_note_award_emoji'. For snippet-specific actions, pass 'snippet_id'. For note actions, also pass 'note_id'.",
       "metadata_params": ["action", "project_id", "snippet_id", "note_id", "award_id"],
       "operations": {
         "list_snippets": "getApiV4ProjectsIdSnippets",
@@ -417,6 +417,8 @@
           "metadata_endpoint": "getApiV4ProjectsIdSnippetsSnippetId",
           "download_endpoint": "getApiV4ProjectsIdSnippetsSnippetIdRaw"
         },
+        "list_notes": "getApiV4ProjectsIdSnippetsSnippetIdNotes",
+        "get_note": "getApiV4ProjectsIdSnippetsSnippetIdNotesNoteId",
         "list_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdAwardEmoji",
         "get_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdAwardEmojiAwardId",
         "create_award_emoji": "postApiV4ProjectsIdSnippetsSnippetIdAwardEmoji",
@@ -429,6 +431,8 @@
       "response_fields": {
         "list_snippets": ["id", "title", "file_name", "visibility"],
         "get_snippet": ["id", "title", "file_name", "description", "visibility"],
+        "list_notes": ["id", "body", "author", "created_at", "updated_at", "system"],
+        "get_note": ["id", "body", "author", "created_at", "updated_at", "system", "attachment"],
         "list_award_emoji": ["id", "name", "user", "created_at"],
         "get_award_emoji": ["id", "name", "user", "created_at"],
         "create_award_emoji": ["id", "name", "user", "created_at"],
@@ -439,7 +443,7 @@
       "parameters": {
         "action": {
           "type": "string",
-          "enum": ["list_snippets", "get_snippet", "download_snippet", "list_award_emoji", "get_award_emoji", "create_award_emoji", "delete_award_emoji", "list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"],
+          "enum": ["list_snippets", "get_snippet", "download_snippet", "list_notes", "get_note", "list_award_emoji", "get_award_emoji", "create_award_emoji", "delete_award_emoji", "list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"],
           "description": "Action to perform",
           "required": true
         },
@@ -451,12 +455,12 @@
         "snippet_id": {
           "type": "integer",
           "description": "Snippet ID",
-          "required_for": ["get_snippet", "download_snippet", "list_award_emoji", "get_award_emoji", "create_award_emoji", "delete_award_emoji", "list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"]
+          "required_for": ["get_snippet", "download_snippet", "list_notes", "get_note", "list_award_emoji", "get_award_emoji", "create_award_emoji", "delete_award_emoji", "list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"]
         },
         "note_id": {
           "type": "integer",
           "description": "The ID of the snippet note",
-          "required_for": ["list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"]
+          "required_for": ["get_note", "list_note_award_emoji", "get_note_award_emoji", "create_note_award_emoji", "delete_note_award_emoji"]
         },
         "award_id": {
           "type": "integer",

profiles/gitlab/developer-profile-oauth.test.json

@@ -3472,6 +3472,50 @@
         "success": true
       }
     },
+    {
+      "name": "Snippets - List Notes",
+      "tool": "manage_snippets",
+      "arguments": {
+        "action": "list_notes",
+        "project_id": "{{projectId}}",
+        "snippet_id": 1
+      },
+      "mocks": [
+        {
+          "operationId": "getApiV4ProjectsIdSnippetsSnippetIdNotes",
+          "response": {
+            "body": [{"id": 10, "body": "Great snippet!", "author": {"username": "alice"}}]
+          }
+        }
+      ],
+      "expect": {
+        "success": true,
+        "result": [{"id": 10, "body": "Great snippet!", "author": {"username": "alice"}}]
+      }
+    },
+    {
+      "name": "Snippets - Get Note",
+      "tool": "manage_snippets",
+      "arguments": {
+        "action": "get_note",
+        "project_id": "{{projectId}}",
+        "snippet_id": 1,
+        "note_id": 10
+      },
+      "mocks": [
+        {
+          "operationId": "getApiV4ProjectsIdSnippetsSnippetIdNotesNoteId",
+          "response": {
+            "status": 200,
+            "body": {"id": 10, "body": "Great snippet!", "author": {"username": "alice"}}
+          }
+        }
+      ],
+      "expect": {
+        "success": true,
+        "result": {"id": 10, "body": "Great snippet!", "author": {"username": "alice"}}
+      }
+    },
     {
       "name": "Snippets - List Award Emoji",
       "tool": "manage_snippets",

profiles/gitlab/openapi.yaml

@@ -7598,6 +7598,89 @@ paths:
       responses:
         "204":
           description: Award emoji removed
+  /projects/{id}/snippets/{snippet_id}/notes:
+    get:
+      tags:
+        - snippets
+      summary: List snippet notes
+      description: Get all notes (comments) for a snippet
+      operationId: getApiV4ProjectsIdSnippetsSnippetIdNotes
+      parameters:
+        - $ref: "#/components/parameters/ProjectIdOrPath"
+        - name: snippet_id
+          in: path
+          required: true
+          schema:
+            type: integer
+        - name: page
+          in: query
+          description: Page number
+          schema:
+            type: integer
+            default: 1
+        - name: per_page
+          in: query
+          description: Number of items per page
+          schema:
+            type: integer
+            default: 20
+        - name: sort
+          in: query
+          description: Return notes sorted in created order
+          schema:
+            type: string
+            enum:
+              - asc
+              - desc
+            default: desc
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/API_Entities_Note"
+        "404":
+          description: Snippet not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/API_Error"
+  /projects/{id}/snippets/{snippet_id}/notes/{note_id}:
+    get:
+      tags:
+        - snippets
+      summary: Get a single snippet note
+      description: Get details of a specific snippet note
+      operationId: getApiV4ProjectsIdSnippetsSnippetIdNotesNoteId
+      parameters:
+        - $ref: "#/components/parameters/ProjectIdOrPath"
+        - name: snippet_id
+          in: path
+          required: true
+          schema:
+            type: integer
+        - name: note_id
+          in: path
+          required: true
+          description: The ID of the note
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/API_Entities_Note"
+        "404":
+          description: Note not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/API_Error"
   /projects/{id}/snippets/{snippet_id}/notes/{note_id}/award_emoji:
     get:
       tags:

profiles/gitlab/profile-optimized-oauth.json

@@ -27,7 +27,7 @@
   "tools": [
     {
       "name": "retrieve_content",
-      "description": "Read-only access to GitLab content (projects, issues, merge requests, snippets, repository, members, labels, milestones, pipelines, hooks, variables). Actions: 'list_projects', 'get_project', 'list_project_members', 'list_project_hooks', 'get_project_hook', 'list_project_variables', 'get_project_variable', 'list_issues', 'list_issues_global', 'get_issue', 'list_issue_notes', 'get_issue_note', 'list_issue_discussions', 'get_issue_discussion', 'list_issue_award_emoji', 'get_issue_award_emoji', 'list_issue_note_award_emoji', 'get_issue_note_award_emoji', 'list_merge_requests', 'get_merge_request', 'list_merge_request_notes', 'get_merge_request_note', 'list_merge_request_commits', 'list_merge_request_diffs', 'list_merge_request_raw_diffs', 'list_merge_request_pipelines', 'list_merge_request_discussions', 'get_merge_request_discussion', 'list_merge_request_award_emoji', 'get_merge_request_award_emoji', 'list_merge_request_note_award_emoji', 'get_merge_request_note_award_emoji', 'list_snippets', 'get_snippet', 'download_snippet', 'list_snippet_award_emoji', 'get_snippet_award_emoji', 'list_snippet_note_award_emoji', 'get_snippet_note_award_emoji', 'get_file', 'download_file', 'list_repository_tree', 'compare_refs', 'get_commit', 'list_pipelines', 'list_pipeline_jobs', 'get_job', 'download_job_artifacts', 'download_job_artifact', 'list_project_labels', 'list_group_labels', 'list_project_milestones', 'list_group_milestones'.",
+      "description": "Read-only access to GitLab content (projects, issues, merge requests, snippets, repository, members, labels, milestones, pipelines, hooks, variables). Actions: 'list_projects', 'get_project', 'list_project_members', 'list_project_hooks', 'get_project_hook', 'list_project_variables', 'get_project_variable', 'list_issues', 'list_issues_global', 'get_issue', 'list_issue_notes', 'get_issue_note', 'list_issue_discussions', 'get_issue_discussion', 'list_issue_award_emoji', 'get_issue_award_emoji', 'list_issue_note_award_emoji', 'get_issue_note_award_emoji', 'list_merge_requests', 'get_merge_request', 'list_merge_request_notes', 'get_merge_request_note', 'list_merge_request_commits', 'list_merge_request_diffs', 'list_merge_request_raw_diffs', 'list_merge_request_pipelines', 'list_merge_request_discussions', 'get_merge_request_discussion', 'list_merge_request_award_emoji', 'get_merge_request_award_emoji', 'list_merge_request_note_award_emoji', 'get_merge_request_note_award_emoji', 'list_snippets', 'get_snippet', 'download_snippet', 'list_snippet_award_emoji', 'get_snippet_award_emoji', 'list_snippet_notes', 'get_snippet_note', 'list_snippet_note_award_emoji', 'get_snippet_note_award_emoji', 'get_file', 'download_file', 'list_repository_tree', 'compare_refs', 'get_commit', 'list_pipelines', 'list_pipeline_jobs', 'get_job', 'download_job_artifacts', 'download_job_artifact', 'list_project_labels', 'list_group_labels', 'list_project_milestones', 'list_group_milestones'.",
       "metadata_params": ["action", "project_id", "issue_iid", "merge_request_iid", "note_id", "discussion_id", "snippet_id", "award_id", "file_path", "pipeline_id", "job_id", "hook_id", "key"],
       "operations": {
         "list_projects": "getApiV4Projects",
@@ -71,6 +71,8 @@
         },
         "list_snippet_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdAwardEmoji",
         "get_snippet_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdAwardEmojiAwardId",
+        "list_snippet_notes": "getApiV4ProjectsIdSnippetsSnippetIdNotes",
+        "get_snippet_note": "getApiV4ProjectsIdSnippetsSnippetIdNotesNoteId",
         "list_snippet_note_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdNotesNoteIdAwardEmoji",
         "get_snippet_note_award_emoji": "getApiV4ProjectsIdSnippetsSnippetIdNotesNoteIdAwardEmojiAwardId",
         "get_file": "getApiV4ProjectsIdRepositoryFilesFilePath",
@@ -131,6 +133,8 @@
         "get_snippet": ["id", "title", "file_name", "description", "visibility"],
         "list_snippet_award_emoji": ["id", "name", "user", "created_at"],
         "get_snippet_award_emoji": ["id", "name", "user", "created_at"],
+        "list_snippet_notes": ["id", "body", "author", "created_at", "updated_at", "system"],
+        "get_snippet_note": ["id", "body", "author", "created_at", "updated_at", "system", "attachment"],
         "list_snippet_note_award_emoji": ["id", "name", "user", "created_at"],
         "get_snippet_note_award_emoji": ["id", "name", "user", "created_at"],
         "get_file": ["file_name", "file_path", "size", "encoding", "content", "ref", "blob_id", "commit_id", "last_commit_id"],
@@ -145,24 +149,22 @@
       "parameters": {
         "action": {
           "type": "string",
-          "enum": ["list_projects", "get_project", "list_project_members", "list_project_hooks", "get_project_hook", "list_project_variables", "get_project_variable", "list_issues", "list_issues_global", "get_issue", "list_issue_notes", "get_issue_note", "list_issue_discussions", "get_issue_discussion", "list_issue_award_emoji", "get_issue_award_emoji", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_requests", "get_merge_request", "list_merge_request_notes", "get_merge_request_note", "list_merge_request_commits", "list_merge_request_diffs", "list_merge_request_raw_diffs", "list_merge_request_pipelines", "list_merge_request_discussions", "get_merge_request_discussion", "list_merge_request_award_emoji", "get_merge_request_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "list_snippets", "get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji", "get_file", "download_file", "list_repository_tree", "compare_refs", "get_commit", "list_pipelines", "list_pipeline_jobs", "get_job", "download_job_artifacts", "download_job_artifact", "list_project_labels", "list_group_labels", "list_project_milestones", "list_group_milestones"],
+          "enum": ["list_projects", "get_project", "list_project_members", "list_project_hooks", "get_project_hook", "list_project_variables", "get_project_variable", "list_issues", "list_issues_global", "get_issue", "list_issue_notes", "get_issue_note", "list_issue_discussions", "get_issue_discussion", "list_issue_award_emoji", "get_issue_award_emoji", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_requests", "get_merge_request", "list_merge_request_notes", "get_merge_request_note", "list_merge_request_commits", "list_merge_request_diffs", "list_merge_request_raw_diffs", "list_merge_request_pipelines", "list_merge_request_discussions", "get_merge_request_discussion", "list_merge_request_award_emoji", "get_merge_request_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "list_snippets", "get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_notes", "get_snippet_note", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji", "get_file", "download_file", "list_repository_tree", "compare_refs", "get_commit", "list_pipelines", "list_pipeline_jobs", "get_job", "download_job_artifacts", "download_job_artifact", "list_project_labels", "list_group_labels", "list_project_milestones", "list_group_milestones"],
           "description": "Action to perform",
           "required": true
         },
         "owned": {
           "type": "boolean",
-          "description": "Limit by projects explicitly owned by the current user",
-          "required_for": ["list_projects"]
+          "description": "Limit by projects explicitly owned by the current user"
         },
         "membership": {
           "type": "boolean",
-          "description": "Limit by projects that the current user is a member of",
-          "required_for": ["list_projects"]
+          "description": "Limit by projects that the current user is a member of"
         },
         "project_id": {
           "type": "string",
           "description": "Project ID. Use numeric ID (e.g. '123') or URL-encoded path (e.g. 'group%2Fproject').",
-          "required_for": ["get_project", "list_project_members", "list_project_hooks", "get_project_hook", "list_project_variables", "get_project_variable", "list_issues", "get_issue", "list_issue_notes", "get_issue_note", "list_issue_discussions", "get_issue_discussion", "list_issue_award_emoji", "get_issue_award_emoji", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_requests", "get_merge_request", "list_merge_request_notes", "get_merge_request_note", "list_merge_request_commits", "list_merge_request_diffs", "list_merge_request_raw_diffs", "list_merge_request_pipelines", "list_merge_request_discussions", "get_merge_request_discussion", "list_merge_request_award_emoji", "get_merge_request_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "list_snippets", "get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji", "get_file", "download_file", "list_repository_tree", "compare_refs", "get_commit", "list_pipelines", "list_pipeline_jobs", "get_job", "download_job_artifacts", "download_job_artifact", "list_project_labels", "list_project_milestones"],
+          "required_for": ["get_project", "list_project_members", "list_project_hooks", "get_project_hook", "list_project_variables", "get_project_variable", "list_issues", "get_issue", "list_issue_notes", "get_issue_note", "list_issue_discussions", "get_issue_discussion", "list_issue_award_emoji", "get_issue_award_emoji", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_requests", "get_merge_request", "list_merge_request_notes", "get_merge_request_note", "list_merge_request_commits", "list_merge_request_diffs", "list_merge_request_raw_diffs", "list_merge_request_pipelines", "list_merge_request_discussions", "get_merge_request_discussion", "list_merge_request_award_emoji", "get_merge_request_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "list_snippets", "get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_notes", "get_snippet_note", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji", "get_file", "download_file", "list_repository_tree", "compare_refs", "get_commit", "list_pipelines", "list_pipeline_jobs", "get_job", "download_job_artifacts", "download_job_artifact", "list_project_labels", "list_project_milestones"],
           "example": "123"
         },
         "issue_iid": {
@@ -178,7 +180,7 @@
         "note_id": {
           "type": "integer",
           "description": "The ID of the note",
-          "required_for": ["get_issue_note", "get_merge_request_note", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji"]
+          "required_for": ["get_issue_note", "get_merge_request_note", "list_issue_note_award_emoji", "get_issue_note_award_emoji", "list_merge_request_note_award_emoji", "get_merge_request_note_award_emoji", "get_snippet_note", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji"]
         },
         "discussion_id": {
           "type": "string",
@@ -208,7 +210,7 @@
         "snippet_id": {
           "type": "integer",
           "description": "Snippet ID",
-          "required_for": ["get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji"]
+          "required_for": ["get_snippet", "download_snippet", "list_snippet_award_emoji", "get_snippet_award_emoji", "list_snippet_notes", "get_snippet_note", "list_snippet_note_award_emoji", "get_snippet_note_award_emoji"]
         },
         "file_path": {
           "type": "string",