@gitlab/opencode-gitlab-plugin 1.5.5 → 1.5.6

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.5.6](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.5...v1.5.6) (2026-02-03)
+
+
+### ♻️ Code Refactoring
+
+* consolidate search tools into unified interface ([bb75def](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/bb75def68290ea740a04d09afc5d7efa9da02020))
+* implement GitLab Duo review suggestions ([8fa6738](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/8fa67382436d8edb9bce1868c3330d8853255606))
+
 ## [1.5.5](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.4...v1.5.5) (2026-02-03)
 
 

package/README.md

@@ -134,7 +134,7 @@ graph LR
     B --> B1[readTokenFromAuthStorage]
     B --> B2[getGitLabClient]
 
-    C --> C1[78 Tool Definitions]
+    C --> C1[69 Tool Definitions]
 
     D --> A
     D --> B
@@ -287,7 +287,7 @@ Or for API tokens:
 
 ## 🛠️ Available Tools
 
-The plugin provides **78 tools** organized into the following categories:
+The plugin provides **69 tools** organized into the following categories:
 
 ### Merge Request Tools (9 tools)
 
@@ -348,21 +348,12 @@ The plugin provides **78 tools** organized into the following categories:
 | `gitlab_list_branches`        | List all branches in a repository                      |
 | `gitlab_get_commit_comments`  | Get all commit comments in flat structure              |
 
-### Search Tools (11 tools)
-
-| Tool                          | Description                                                                    |
-| ----------------------------- | ------------------------------------------------------------------------------ |
-| `gitlab_search`               | Universal search across projects, issues, MRs, code, commits, users, and wikis |
-| `gitlab_issue_search`         | Specialized issue search with better filtering                                 |
-| `gitlab_merge_request_search` | Specialized merge request search with better filtering                         |
-| `gitlab_blob_search`          | Search code/text within repository files                                       |
-| `gitlab_commit_search`        | Search commits by message, author, or SHA                                      |
-| `gitlab_group_project_search` | Search projects within a specific group                                        |
-| `gitlab_milestone_search`     | Search milestones by title or description                                      |
-| `gitlab_note_search`          | Search comments across issues, MRs, and commits (Premium/Ultimate)             |
-| `gitlab_user_search`          | Search users by name or email                                                  |
-| `gitlab_wiki_blob_search`     | Search wiki content with advanced filters                                      |
-| `gitlab_documentation_search` | Search GitLab official documentation                                           |
+### Search Tools (2 tools)
+
+| Tool                          | Description                                                                                                                                                                     |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gitlab_search`               | Unified search across all GitLab resources with scope-specific options (projects, issues, merge_requests, milestones, users, blobs, commits, notes, wiki_blobs, group_projects) |
+| `gitlab_documentation_search` | Search GitLab official documentation at docs.gitlab.com                                                                                                                         |
 
 ### Work Item Tools (6 tools)
 

package/dist/index.js

@@ -2734,10 +2734,83 @@ This is different from discussions - it returns individual comments in a flat st
 // src/tools/search.ts
 import { tool as tool6 } from "@opencode-ai/plugin";
 var z6 = tool6.schema;
+var GENERIC_SEARCH_SCOPES = ["projects", "issues", "merge_requests", "blobs"];
+var SPECIALIZED_SCOPES = [
+  "milestones",
+  "users",
+  "commits",
+  "notes",
+  "wiki_blobs",
+  "group_projects"
+];
+var ALL_SCOPES = [...GENERIC_SEARCH_SCOPES, ...SPECIALIZED_SCOPES];
+var REF_SUPPORTED_SCOPES = ["commits", "wiki_blobs"];
+var STATE_SUPPORTED_SCOPES = ["milestones"];
+function validationError(param, scope) {
+  return new Error(`Missing required parameter: '${param}' is required for scope '${scope}'`);
+}
+function invalidParamError(param, validScopes) {
+  return new Error(
+    `Invalid parameter: '${param}' is only valid for scopes: ${validScopes.join(", ")}`
+  );
+}
+function validateSearchParams(scope, args) {
+  switch (scope) {
+    case "notes":
+      if (!args.project_id) throw validationError("project_id", scope);
+      break;
+    case "group_projects":
+      if (!args.group_id) throw validationError("group_id", scope);
+      break;
+  }
+  if (args.ref && !REF_SUPPORTED_SCOPES.includes(scope)) {
+    throw invalidParamError("ref", REF_SUPPORTED_SCOPES);
+  }
+  if (args.state && !STATE_SUPPORTED_SCOPES.includes(scope)) {
+    throw invalidParamError("state", STATE_SUPPORTED_SCOPES);
+  }
+}
 var searchTools = {
+  /**
+   * Unified search across all GitLab resources
+   *
+   * @example
+   * // Search for issues in a project
+   * gitlab_search({ scope: "issues", search: "bug", project_id: "my-group/project" })
+   *
+   * @example
+   * // Search commits on specific branch
+   * gitlab_search({ scope: "commits", search: "fix", ref: "main" })
+   *
+   * @example
+   * // Search for projects within a group
+   * gitlab_search({ scope: "group_projects", group_id: "gitlab-org", search: "runner" })
+   *
+   * @example
+   * // Search notes/comments in a project
+   * gitlab_search({ scope: "notes", search: "LGTM", project_id: "my-group/project" })
+   */
   gitlab_search: tool6({
-    description: `Search across GitLab for various resources.
-Scopes: projects, issues, merge_requests, milestones, users, blobs (code), commits, notes, wiki_blobs`,
+    description: `Search across GitLab for various resources with scope-specific options.
+
+Scopes and their requirements:
+- projects: Search projects by name/description
+- issues: Search issues by title/description
+- merge_requests: Search MRs by title/description
+- milestones: Search milestones (supports state filter)
+- users: Search users by name/email
+- blobs: Search file content (code search)
+- commits: Search commits by message/author/SHA (supports ref filter)
+- notes: Search comments/notes (requires project_id)
+- wiki_blobs: Search wiki content (supports ref filter)
+- group_projects: Search projects within a group (requires group_id)
+
+Examples:
+- Issues: scope="issues", search="bug", project_id="my-group/my-project"
+- Code: scope="blobs", search="function calculateTotal"
+- Commits: scope="commits", search="fix login", ref="main"
+- Group projects: scope="group_projects", group_id="gitlab-org", search="runner"
+- Notes: scope="notes", search="LGTM", project_id="my-group/my-project"`,
     args: {
       scope: z6.enum([
         "projects",
@@ -2748,238 +2821,104 @@ Scopes: projects, issues, merge_requests, milestones, users, blobs (code), commi
         "blobs",
         "commits",
         "notes",
-        "wiki_blobs"
-      ]).describe("The scope of the search"),
-      search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search(args.scope, args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_issue_search: tool6({
-    description: `Search issues by keyword across GitLab.
-Specialized search for issues with better filtering than the generic search.`,
-    args: {
-      search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["opened", "closed", "all"]).optional().describe("Filter by issue state"),
-      labels: z6.string().optional().describe("Comma-separated list of labels to filter by"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search("issues", args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_blob_search: tool6({
-    description: `Search file content in repositories.
-Search for code/text within files across projects.`,
-    args: {
-      search: z6.string().describe("The search query (code/text to find)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search("blobs", args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_merge_request_search: tool6({
-    description: `Search merge requests by keyword.
-Specialized search for merge requests with better filtering than the generic search.`,
-    args: {
+        "wiki_blobs",
+        "group_projects"
+      ]).describe("The type of resource to search"),
       search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["opened", "closed", "merged", "all"]).optional().describe("Filter by MR state"),
-      labels: z6.string().optional().describe("Comma-separated list of labels to filter by"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search(
-        "merge_requests",
-        args.search,
-        args.project_id,
-        args.limit
-      );
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_commit_search: tool6({
-    description: `Search for commits in a project or across GitLab.
-Returns commits matching the search query with commit details including SHA, title, message, author, and dates.
-
-Supports searching by:
-- Commit message content
-- Author name or email
-- Commit SHA (partial or full)
-
-Note: Advanced search features (Premium/Ultimate) provide better commit search capabilities.`,
-    args: {
-      search: z6.string().describe("The search query (commit message, author, or SHA)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      ref: z6.string().optional().describe("Branch or tag name to search on (defaults to default branch)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
+      // Context parameters
+      project_id: z6.string().optional().describe("Limit search to a specific project. Required for notes scope"),
+      group_id: z6.string().optional().describe("Group ID or path. Required for group_projects scope"),
+      // Common options
+      limit: z6.number().optional().describe("Maximum number of results (default: 20)"),
+      order_by: z6.enum(["created_at"]).optional().describe(
+        "Order results by field (for milestones, users, commits, notes, wiki_blobs, group_projects)"
+      ),
+      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (for milestones, users, commits, notes, wiki_blobs, group_projects)"),
+      // Scope-specific options
+      ref: z6.string().optional().describe("Branch or tag name (for commits, wiki_blobs scopes)"),
+      state: z6.enum(["active", "closed", "all"]).optional().describe("Filter by state (for milestones scope)")
     },
     execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchCommits(args.search, args.project_id, {
+      validateSearchParams(args.scope, {
+        project_id: args.project_id,
+        group_id: args.group_id,
         ref: args.ref,
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
+        state: args.state
       });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_group_project_search: tool6({
-    description: `Search for projects within a specific group.
-Returns projects matching the search query within the specified group and its subgroups.
-
-Useful for:
-- Finding projects by name or description within a group
-- Discovering projects in large group hierarchies
-- Filtering group projects by keywords`,
-    args: {
-      group_id: z6.string().describe("The group ID or URL-encoded path"),
-      search: z6.string().describe("The search query (project name or description)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const results = await client.searchGroupProjects(args.group_id, args.search, {
+      const commonOptions = {
         order_by: args.order_by,
         sort: args.sort,
         limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_milestone_search: tool6({
-    description: `Search for milestones in a project or across GitLab.
-Returns milestones matching the search query with details including title, description, state, and dates.
-
-Useful for:
-- Finding milestones by title or description
-- Discovering active or closed milestones
-- Planning and tracking project milestones`,
-    args: {
-      search: z6.string().describe("The search query (milestone title or description)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["active", "closed", "all"]).optional().describe("Filter by milestone state"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchMilestones(args.search, args.project_id, {
-        state: args.state,
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_note_search: tool6({
-    description: `Search for notes/comments in a project.
-Returns notes (comments) matching the search query from issues, merge requests, commits, and snippets.
-
-Useful for:
-- Finding specific comments or discussions
-- Tracking feedback and review comments
-- Searching for mentions or keywords in conversations
-
-Note: This scope requires Premium or Ultimate tier with advanced search enabled.`,
-    args: {
-      search: z6.string().describe("The search query (comment text)"),
-      project_id: z6.string().describe("The project ID or URL-encoded path to search in"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchNotes(args.search, args.project_id, {
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_user_search: tool6({
-    description: `Search for users by name or email across GitLab.
-Returns users matching the search query with details including username, name, state, and avatar.
-
-Useful for:
-- Finding users to assign to issues or merge requests
-- Looking up user information by name or email
-- Discovering team members and collaborators`,
-    args: {
-      search: z6.string().describe("The search query (user name or email)"),
-      project_id: z6.string().optional().describe("Limit search to project members (optional)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchUsers(args.search, args.project_id, {
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_wiki_blob_search: tool6({
-    description: `Search for wiki content (blobs) in a project or across GitLab.
-Returns wiki pages matching the search query with content snippets and file information.
-
-Supports advanced filters (use in search query):
-- filename:some_name* - Filter by filename with wildcards
-- path:some/path* - Filter by path with wildcards
-- extension:md - Filter by file extension
-
-Examples:
-- "installation" - Search for "installation" in wiki content
-- "setup filename:getting-started*" - Search in files starting with "getting-started"
-- "api extension:md" - Search for "api" in markdown files
-
-Note: Advanced search (Premium/Ultimate) provides better wiki search capabilities.`,
-    args: {
-      search: z6.string().describe(
-        "The search query (supports filters: filename:, path:, extension: with wildcards)"
-      ),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      ref: z6.string().optional().describe("Branch or tag name to search on (defaults to default branch)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchWikiBlobs(args.search, args.project_id, {
-        ref: args.ref,
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
+      };
+      switch (args.scope) {
+        // Generic search API scopes
+        case "projects":
+        case "issues":
+        case "merge_requests":
+        case "blobs":
+          return JSON.stringify(
+            await client.search(args.scope, args.search, args.project_id, args.limit),
+            null,
+            2
+          );
+        // Specialized scopes with dedicated client methods
+        case "milestones":
+          return JSON.stringify(
+            await client.searchMilestones(args.search, args.project_id, {
+              ...commonOptions,
+              state: args.state
+            }),
+            null,
+            2
+          );
+        case "users":
+          return JSON.stringify(
+            await client.searchUsers(args.search, args.project_id, commonOptions),
+            null,
+            2
+          );
+        case "commits":
+          return JSON.stringify(
+            await client.searchCommits(args.search, args.project_id, {
+              ...commonOptions,
+              ref: args.ref
+            }),
+            null,
+            2
+          );
+        case "notes":
+          return JSON.stringify(
+            await client.searchNotes(args.search, args.project_id, commonOptions),
+            null,
+            2
+          );
+        case "wiki_blobs":
+          return JSON.stringify(
+            await client.searchWikiBlobs(args.search, args.project_id, {
+              ...commonOptions,
+              ref: args.ref
+            }),
+            null,
+            2
+          );
+        case "group_projects":
+          return JSON.stringify(
+            await client.searchGroupProjects(args.group_id, args.search, commonOptions),
+            null,
+            2
+          );
+        default:
+          throw new Error(
+            `Invalid scope '${args.scope}'. Must be one of: ${ALL_SCOPES.join(", ")}`
+          );
+      }
     }
   }),
+  /**
+   * Search GitLab official documentation
+   * Separate tool because it uses a completely different API (docs.gitlab.com)
+   */
   gitlab_documentation_search: tool6({
     description: `Search GitLab official documentation at docs.gitlab.com.
 Returns relevant documentation pages matching the search query.
@@ -3757,7 +3696,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 validationError(param, resourceType) {
+function validationError2(param, resourceType) {
   return new Error(
     `Missing required parameter: '${param}' is required for resource_type '${resourceType}'`
   );
@@ -3771,16 +3710,16 @@ function validateListCreateParams(resourceType, args) {
   switch (resourceType) {
     case "merge_request":
     case "issue":
-      if (!args.project_id) throw validationError("project_id", resourceType);
-      if (args.iid == null) throw validationError("iid", resourceType);
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError("group_id", resourceType);
-      if (args.iid == null) throw validationError("iid", resourceType);
+      if (!args.group_id) throw validationError2("group_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
       break;
     case "snippet":
-      if (!args.project_id) throw validationError("project_id", resourceType);
-      if (args.snippet_id == null) throw validationError("snippet_id", resourceType);
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.snippet_id == null) throw validationError2("snippet_id", resourceType);
       break;
   }
 }
@@ -3790,15 +3729,15 @@ function validateGetNoteParams(resourceType, args) {
       `Invalid resource_type '${resourceType}'. Must be one of: ${VALID_GET_NOTE_TYPES.join(", ")}`
     );
   }
-  if (args.note_id == null) throw validationError("note_id", resourceType);
+  if (args.note_id == null) throw validationError2("note_id", resourceType);
   switch (resourceType) {
     case "issue":
-      if (!args.project_id) throw validationError("project_id", resourceType);
-      if (args.iid == null) throw validationError("iid", resourceType);
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError("group_id", resourceType);
-      if (args.iid == null) throw validationError("iid", resourceType);
+      if (!args.group_id) throw validationError2("group_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
       break;
   }
 }

package/package.json

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