@gitlab/opencode-gitlab-plugin 1.5.6 → 1.5.8

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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)
+
+
+### ♻️ Code Refactoring
+
+* consolidate epic issue management tools into unified interface ([b8708d7](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/b8708d7fa65e4fcc5fda0e46daaf2391d8bbc094))
+
 ## [1.5.6](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.5...v1.5.6) (2026-02-03)
 
 

package/README.md

@@ -287,9 +287,9 @@ Or for API tokens:
 
 ## 🛠️ Available Tools
 
-The plugin provides **69 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 **69 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                                                            |
 
@@ -311,30 +310,27 @@ The plugin provides **69 tools** organized into the following categories:
 | `gitlab_get_issue`    | Get issue details including state, author, assignees, labels, and comments   |
 | `gitlab_list_issues`  | List issues with filtering by state, labels, assignee, and milestone         |
 
-### Epic Tools (7 tools)
-
-| Tool                            | Description                                                                   |
-| ------------------------------- | ----------------------------------------------------------------------------- |
-| `gitlab_get_epic`               | Get epic details with title, description, state, dates, and associated issues |
-| `gitlab_list_epics`             | List epics with filtering by state, author, and labels                        |
-| `gitlab_create_epic`            | Create a new epic in a group                                                  |
-| `gitlab_update_epic`            | Update epic title, description, labels, dates, and state                      |
-| `gitlab_list_epic_issues`       | Get all issues linked to an epic                                              |
-| `gitlab_add_issue_to_epic`      | Link an issue to an epic                                                      |
-| `gitlab_remove_issue_from_epic` | Unlink an issue from an epic                                                  |
-
-### Pipeline Tools (8 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           |
+### Epic Tools (5 tools)
+
+| Tool                        | Description                                                                   |
+| --------------------------- | ----------------------------------------------------------------------------- |
+| `gitlab_get_epic`           | Get epic details with title, description, state, dates, and associated issues |
+| `gitlab_list_epics`         | List epics with filtering by state, author, and labels                        |
+| `gitlab_create_epic`        | Create a new epic in a group                                                  |
+| `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 (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 config with mode parameter (content or existing repository) |
 
 ### Repository Tools (7 tools)
 
@@ -381,14 +377,13 @@ The plugin provides **69 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({
@@ -2309,6 +2312,9 @@ Can filter by state, labels, assignee, milestone.`,
 // src/tools/epics.ts
 import { tool as tool3 } from "@opencode-ai/plugin";
 var z3 = tool3.schema;
+function validationError(message) {
+  return JSON.stringify({ error: message }, null, 2);
+}
 var epicTools = {
   gitlab_get_epic: tool3({
     description: `Get details of a specific epic by group and epic IID.
@@ -2402,49 +2408,55 @@ Can update title, description, labels, dates, state, and confidentiality.`,
       return JSON.stringify(epic, null, 2);
     }
   }),
-  gitlab_list_epic_issues: tool3({
-    description: `Get all issues associated with an epic.
-Returns the list of issues that are linked to the epic.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const issues = await client.listEpicIssues(args.group_id, args.epic_iid);
-      return JSON.stringify(issues, null, 2);
-    }
-  }),
-  gitlab_add_issue_to_epic: tool3({
-    description: `Link an existing issue to an epic.
-The issue can be from any project within the group hierarchy.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      issue_id: z3.number().describe("The global ID of the issue to add")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.addIssueToEpic(args.group_id, args.epic_iid, args.issue_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_remove_issue_from_epic: tool3({
-    description: `Unlink an issue from an epic.
-Removes the association between the issue and the epic.`,
+  gitlab_manage_epic_issues: tool3({
+    description: `Manage issues linked to a GitLab epic.
+
+Actions:
+- list: Get all issues associated with the epic
+- add: Link an existing issue to the epic (issue can be from any project within the group hierarchy)
+- remove: Unlink an issue from the epic
+
+Examples:
+- List issues: action="list", group_id="gitlab-org", epic_iid=123
+- Add issue: action="add", group_id="gitlab-org", epic_iid=123, issue_id=456
+- Remove issue: action="remove", group_id="gitlab-org", epic_iid=123, epic_issue_id=789
+
+Note: The epic_issue_id (for remove) is the ID of the epic-issue association, which can be obtained from the list action response.`,
     args: {
+      action: z3.enum(["list", "add", "remove"]).describe("The action to perform"),
       group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      epic_issue_id: z3.number().describe("The ID of the epic-issue association (from list_epic_issues)")
+      epic_iid: z3.number().describe("The internal ID of the epic within the group"),
+      issue_id: z3.number().optional().describe('The global ID of the issue to add (required for "add" action)'),
+      epic_issue_id: z3.number().optional().describe(
+        'The ID of the epic-issue association to remove (required for "remove" action, from list response)'
+      )
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const result = await client.removeIssueFromEpic(
-        args.group_id,
-        args.epic_iid,
-        args.epic_issue_id
-      );
-      return JSON.stringify(result, null, 2);
+      switch (args.action) {
+        case "list": {
+          const issues = await client.listEpicIssues(args.group_id, args.epic_iid);
+          return JSON.stringify(issues, null, 2);
+        }
+        case "add": {
+          if (args.issue_id === void 0) {
+            return validationError('issue_id is required for "add" action');
+          }
+          const result = await client.addIssueToEpic(args.group_id, args.epic_iid, args.issue_id);
+          return JSON.stringify(result, null, 2);
+        }
+        case "remove": {
+          if (args.epic_issue_id === void 0) {
+            return validationError('epic_issue_id is required for "remove" action');
+          }
+          const result = await client.removeIssueFromEpic(
+            args.group_id,
+            args.epic_iid,
+            args.epic_issue_id
+          );
+          return JSON.stringify(result, null, 2);
+        }
+      }
     }
   })
 };
@@ -2550,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);
+        }
+      }
     }
   })
 };
@@ -2746,7 +2750,7 @@ var SPECIALIZED_SCOPES = [
 var ALL_SCOPES = [...GENERIC_SEARCH_SCOPES, ...SPECIALIZED_SCOPES];
 var REF_SUPPORTED_SCOPES = ["commits", "wiki_blobs"];
 var STATE_SUPPORTED_SCOPES = ["milestones"];
-function validationError(param, scope) {
+function validationError2(param, scope) {
   return new Error(`Missing required parameter: '${param}' is required for scope '${scope}'`);
 }
 function invalidParamError(param, validScopes) {
@@ -2757,10 +2761,10 @@ function invalidParamError(param, validScopes) {
 function validateSearchParams(scope, args) {
   switch (scope) {
     case "notes":
-      if (!args.project_id) throw validationError("project_id", scope);
+      if (!args.project_id) throw validationError2("project_id", scope);
       break;
     case "group_projects":
-      if (!args.group_id) throw validationError("group_id", scope);
+      if (!args.group_id) throw validationError2("group_id", scope);
       break;
   }
   if (args.ref && !REF_SUPPORTED_SCOPES.includes(scope)) {
@@ -3202,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({
@@ -3696,7 +3709,7 @@ import { tool as tool13 } from "@opencode-ai/plugin";
 var z13 = tool13.schema;
 var VALID_LIST_CREATE_TYPES = ["merge_request", "issue", "epic", "snippet"];
 var VALID_GET_NOTE_TYPES = ["issue", "epic"];
-function validationError2(param, resourceType) {
+function validationError3(param, resourceType) {
   return new Error(
     `Missing required parameter: '${param}' is required for resource_type '${resourceType}'`
   );
@@ -3710,16 +3723,16 @@ function validateListCreateParams(resourceType, args) {
   switch (resourceType) {
     case "merge_request":
     case "issue":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError2("group_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.group_id) throw validationError3("group_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "snippet":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.snippet_id == null) throw validationError2("snippet_id", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.snippet_id == null) throw validationError3("snippet_id", resourceType);
       break;
   }
 }
@@ -3729,15 +3742,15 @@ function validateGetNoteParams(resourceType, args) {
       `Invalid resource_type '${resourceType}'. Must be one of: ${VALID_GET_NOTE_TYPES.join(", ")}`
     );
   }
-  if (args.note_id == null) throw validationError2("note_id", resourceType);
+  if (args.note_id == null) throw validationError3("note_id", resourceType);
   switch (resourceType) {
     case "issue":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError2("group_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.group_id) throw validationError3("group_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/opencode-gitlab-plugin",
-  "version": "1.5.6",
+  "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",