@gitlab/opencode-gitlab-plugin 1.5.7 → 1.5.8

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.5.8](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.7...v1.5.8) (2026-02-03)
+
+
+### ♻️ Code Refactoring
+
+* consolidate MR details, CI lint, and todo tools ([46d830f](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/46d830fd6d9fabf851d7f6e8cc00836e55c7f266))
+
 ## [1.5.7](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.6...v1.5.7) (2026-02-03)
 
 

package/README.md

@@ -287,9 +287,9 @@ Or for API tokens:
 
 ## 🛠️ Available Tools
 
-The plugin provides **67 tools** organized into the following categories:
+The plugin provides **64 tools** organized into the following categories:
 
-### Merge Request Tools (9 tools)
+### Merge Request Tools (8 tools)
 
 | Tool                              | Description                                                                                                                  |
 | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
@@ -298,8 +298,7 @@ The plugin provides **67 tools** organized into the following categories:
 | `gitlab_create_merge_request`     | Create a new merge request                                                                                                   |
 | `gitlab_update_merge_request`     | Update merge request title, description, state, assignees, reviewers, and labels                                             |
 | `gitlab_get_mr_changes`           | Get file changes/diffs for a merge request                                                                                   |
-| `gitlab_get_mr_commits`           | Get all commits in a merge request                                                                                           |
-| `gitlab_get_mr_pipelines`         | Get all pipelines for a merge request                                                                                        |
+| `gitlab_get_mr_details`           | Get additional MR details (commits or pipelines) with detail_type parameter                                                  |
 | `gitlab_list_merge_request_diffs` | List file diffs with pagination support for large changesets                                                                 |
 | `gitlab_set_mr_auto_merge`        | Enable auto-merge (MWPS) using GraphQL API when pipeline succeeds                                                            |
 
@@ -321,18 +320,17 @@ The plugin provides **67 tools** organized into the following categories:
 | `gitlab_update_epic`        | Update epic title, description, labels, dates, and state                      |
 | `gitlab_manage_epic_issues` | Manage issues linked to an epic (list, add, remove) with action parameter     |
 
-### Pipeline Tools (8 tools)
+### Pipeline Tools (7 tools)
 
-| Tool                               | Description                                                |
-| ---------------------------------- | ---------------------------------------------------------- |
-| `gitlab_list_pipelines`            | List pipelines with filtering by status, ref, and username |
-| `gitlab_get_pipeline`              | Get pipeline details with jobs and status                  |
-| `gitlab_list_pipeline_jobs`        | List all jobs in a pipeline with optional scope filtering  |
-| `gitlab_get_job_log`               | Get the log output of a specific CI job                    |
-| `gitlab_retry_job`                 | Retry a failed or canceled job                             |
-| `gitlab_get_pipeline_failing_jobs` | Get only failed jobs for easier debugging                  |
-| `gitlab_lint_ci_config`            | Validate CI/CD YAML configuration with project context     |
-| `gitlab_lint_existing_ci_config`   | Validate existing .gitlab-ci.yml from repository           |
+| Tool                               | Description                                                                     |
+| ---------------------------------- | ------------------------------------------------------------------------------- |
+| `gitlab_list_pipelines`            | List pipelines with filtering by status, ref, and username                      |
+| `gitlab_get_pipeline`              | Get pipeline details with jobs and status                                       |
+| `gitlab_list_pipeline_jobs`        | List all jobs in a pipeline with optional scope filtering                       |
+| `gitlab_get_job_log`               | Get the log output of a specific CI job                                         |
+| `gitlab_retry_job`                 | Retry a failed or canceled job                                                  |
+| `gitlab_get_pipeline_failing_jobs` | Get only failed jobs for easier debugging                                       |
+| `gitlab_lint_ci_config`            | Validate CI/CD YAML config with mode parameter (content or existing repository) |
 
 ### Repository Tools (7 tools)
 
@@ -379,14 +377,13 @@ The plugin provides **67 tools** organized into the following categories:
 
 **Note**: All GraphQL-based security tools include automatic GID (Global ID) format validation.
 
-### TODO Tools (4 tools)
+### TODO Tools (3 tools)
 
-| Tool                         | Description                                            |
-| ---------------------------- | ------------------------------------------------------ |
-| `gitlab_list_todos`          | List TODO items with cursor-based pagination (GraphQL) |
-| `gitlab_mark_todo_done`      | Mark a specific TODO as completed                      |
-| `gitlab_mark_all_todos_done` | Mark all pending TODOs as completed                    |
-| `gitlab_get_todo_count`      | Get count of pending TODOs (GraphQL)                   |
+| Tool                    | Description                                            |
+| ----------------------- | ------------------------------------------------------ |
+| `gitlab_list_todos`     | List TODO items with cursor-based pagination (GraphQL) |
+| `gitlab_mark_todo_done` | Mark TODOs as done with action parameter (one or all)  |
+| `gitlab_get_todo_count` | Get count of pending TODOs (GraphQL)                   |
 
 ### Project & User Tools (3 tools)
 

package/dist/index.js

@@ -2155,30 +2155,33 @@ Can update title, description, state, assignees, reviewers, labels, and more.`,
       return JSON.stringify(mr, null, 2);
     }
   }),
-  gitlab_get_mr_commits: tool({
-    description: `Get the list of commits in a merge request.
-Returns all commits that are part of the merge request.`,
-    args: {
-      project_id: z.string().describe("The project ID or URL-encoded path"),
-      mr_iid: z.number().describe("The internal ID of the merge request")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const commits = await client.getMrCommits(args.project_id, args.mr_iid);
-      return JSON.stringify(commits, null, 2);
-    }
-  }),
-  gitlab_get_mr_pipelines: tool({
-    description: `Get the list of pipelines for a merge request.
-Returns all pipelines that ran for the merge request.`,
+  gitlab_get_mr_details: tool({
+    description: `Get additional details for a merge request.
+
+Detail types:
+- commits: List all commits in the MR
+- pipelines: List all pipelines that ran for the MR
+
+Examples:
+- Get commits: detail_type="commits", project_id="group/project", mr_iid=123
+- Get pipelines: detail_type="pipelines", project_id="group/project", mr_iid=123`,
     args: {
+      detail_type: z.enum(["commits", "pipelines"]).describe("Type of details to fetch"),
       project_id: z.string().describe("The project ID or URL-encoded path"),
       mr_iid: z.number().describe("The internal ID of the merge request")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const pipelines = await client.getMrPipelines(args.project_id, args.mr_iid);
-      return JSON.stringify(pipelines, null, 2);
+      switch (args.detail_type) {
+        case "commits": {
+          const commits = await client.getMrCommits(args.project_id, args.mr_iid);
+          return JSON.stringify(commits, null, 2);
+        }
+        case "pipelines": {
+          const pipelines = await client.getMrPipelines(args.project_id, args.mr_iid);
+          return JSON.stringify(pipelines, null, 2);
+        }
+      }
     }
   }),
   gitlab_list_merge_request_diffs: tool({
@@ -2559,66 +2562,58 @@ This validates the configuration in the context of the project, including:
 - Optionally simulating pipeline creation (dry_run)
 - Optionally including the list of jobs that would be created
 
+Modes:
+- content: Validate provided YAML content (requires 'content' parameter)
+- existing: Validate the existing .gitlab-ci.yml from the repository
+
 Returns validation result with:
 - valid: boolean indicating if configuration is valid
 - errors: array of error messages
 - warnings: array of warning messages
 - merged_yaml: the final merged YAML after processing includes (optional)
-- jobs: list of jobs that would be created (optional, requires include_jobs=true)`,
+- includes: list of included files (for existing mode)
+- jobs: list of jobs that would be created (optional, requires include_jobs=true)
+
+Examples:
+- Validate content: mode="content", project_id="group/project", content="stages: [build]..."
+- Validate existing: mode="existing", project_id="group/project"`,
     args: {
+      mode: z4.enum(["content", "existing"]).describe('Validation mode: "content" for provided YAML, "existing" for repo file'),
       project_id: z4.string().describe("The project ID or URL-encoded path"),
-      content: z4.string().describe("The CI/CD configuration content (YAML as string)"),
+      content: z4.string().optional().describe('The CI/CD configuration content (YAML as string) - required for mode="content"'),
       dry_run: z4.boolean().optional().describe("Run pipeline creation simulation instead of just static check (default: false)"),
       include_jobs: z4.boolean().optional().describe("Include list of jobs that would be created in the response (default: false)"),
       ref: z4.string().optional().describe(
         "Branch or tag context to use for validation (defaults to project default branch)"
-      )
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.lintCiConfig(args.project_id, args.content, {
-        dry_run: args.dry_run,
-        include_jobs: args.include_jobs,
-        ref: args.ref
-      });
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_lint_existing_ci_config: tool4({
-    description: `Validate an existing .gitlab-ci.yml configuration from the repository.
-This validates the configuration in the context of the project, including:
-- Using the project's CI/CD variables
-- Searching the project's files for include:local entries
-- Optionally simulating pipeline creation (dry_run)
-- Optionally including the list of jobs that would be created
-
-Returns validation result with:
-- valid: boolean indicating if configuration is valid
-- errors: array of error messages
-- warnings: array of warning messages
-- merged_yaml: the final merged YAML after processing includes (optional)
-- includes: list of included files with their locations (optional)
-- jobs: list of jobs that would be created (optional, requires include_jobs=true)`,
-    args: {
-      project_id: z4.string().describe("The project ID or URL-encoded path"),
-      content_ref: z4.string().optional().describe(
-        "Commit SHA, branch or tag to get CI config from (defaults to project default branch)"
       ),
-      dry_run: z4.boolean().optional().describe("Run pipeline creation simulation instead of just static check (default: false)"),
-      dry_run_ref: z4.string().optional().describe(
-        "Branch or tag context to use for validation when dry_run is true (defaults to project default branch)"
-      ),
-      include_jobs: z4.boolean().optional().describe("Include list of jobs that would be created in the response (default: false)")
+      content_ref: z4.string().optional().describe(
+        'For mode="existing": Commit SHA, branch or tag to get CI config from (defaults to project default branch)'
+      )
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const result = await client.lintExistingCiConfig(args.project_id, {
-        content_ref: args.content_ref,
-        dry_run: args.dry_run,
-        dry_run_ref: args.dry_run_ref,
-        include_jobs: args.include_jobs
-      });
-      return JSON.stringify(result, null, 2);
+      switch (args.mode) {
+        case "content": {
+          if (!args.content) {
+            return JSON.stringify({ error: 'content is required when mode is "content"' }, null, 2);
+          }
+          const result = await client.lintCiConfig(args.project_id, args.content, {
+            dry_run: args.dry_run,
+            include_jobs: args.include_jobs,
+            ref: args.ref
+          });
+          return JSON.stringify(result, null, 2);
+        }
+        case "existing": {
+          const result = await client.lintExistingCiConfig(args.project_id, {
+            content_ref: args.content_ref,
+            dry_run: args.dry_run,
+            dry_run_ref: args.ref,
+            include_jobs: args.include_jobs
+          });
+          return JSON.stringify(result, null, 2);
+        }
+      }
     }
   })
 };
@@ -3211,25 +3206,34 @@ Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
     }
   }),
   gitlab_mark_todo_done: tool9({
-    description: `Mark a specific TODO item as done.
-Use this to mark a single TODO as completed.`,
+    description: `Mark TODO items as done.
+
+Actions:
+- one: Mark a specific TODO item as done (requires todo_id)
+- all: Mark all pending TODO items as done
+
+Examples:
+- Mark one: action="one", todo_id=123
+- Mark all: action="all"`,
     args: {
-      todo_id: z9.number().describe("The ID of the TODO item to mark as done")
+      action: z9.enum(["one", "all"]).describe('Action to perform: "one" for single TODO, "all" for all TODOs'),
+      todo_id: z9.number().optional().describe('The ID of the TODO item (required for action="one")')
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const result = await client.markTodoAsDone(args.todo_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_mark_all_todos_done: tool9({
-    description: `Mark all TODO items as done.
-Use this to mark all pending TODOs for the current user as completed.`,
-    args: {},
-    execute: async (_args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.markAllTodosAsDone();
-      return JSON.stringify(result, null, 2);
+      switch (args.action) {
+        case "one": {
+          if (args.todo_id === void 0) {
+            return JSON.stringify({ error: 'todo_id is required when action is "one"' }, null, 2);
+          }
+          const result = await client.markTodoAsDone(args.todo_id);
+          return JSON.stringify(result, null, 2);
+        }
+        case "all": {
+          const result = await client.markAllTodosAsDone();
+          return JSON.stringify(result, null, 2);
+        }
+      }
     }
   }),
   gitlab_get_todo_count: tool9({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/opencode-gitlab-plugin",
-  "version": "1.5.7",
+  "version": "1.5.8",
   "description": "GitLab tools plugin for OpenCode - provides GitLab API access for merge requests, issues, pipelines, and more",
   "type": "module",
   "main": "dist/index.js",