opencode-gitlab-plugin 2.0.0 → 2.0.1

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.
 
+## [2.0.1](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v2.0.0...v2.0.1) (2026-03-22)
+
+
+### 🐛 Bug Fixes
+
+* **work-items:** address review comments ([0173f25](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/0173f25afbecf9b01a61a0239a4112c22e96864f))
+* **work-items:** switch to GraphQL API to resolve iid-vs-id 404 bug ([fcd3417](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/fcd3417792e9fcea1ef0a08de2e09d483e769e25))
+
 ## [2.0.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.9.0...v2.0.0) (2026-03-02)
 
 

package/dist/index.js

@@ -718,63 +718,356 @@ var IssuesClient = class extends GitLabApiClient {
 };
 
 // src/client/work-items.ts
+function toGid(type, id) {
+  return `gid://gitlab/${type}/${id}`;
+}
+var WORK_ITEM_LIST_FIELDS = `
+  id
+  iid
+  title
+  description
+  state
+  createdAt
+  updatedAt
+  workItemType {
+    id
+    name
+  }
+  author {
+    id
+    username
+    name
+  }
+  assignees {
+    nodes {
+      id
+      username
+      name
+    }
+  }
+  labels {
+    nodes {
+      id
+      title
+      color
+    }
+  }
+  webUrl
+`;
+var GET_WORK_ITEM_QUERY = `
+  query getWorkItem($fullPath: ID!, $iid: String!) {
+    workspace: project(fullPath: $fullPath) {
+      workItem(iid: $iid) {
+        id
+        iid
+        title
+        description
+        state
+        createdAt
+        updatedAt
+        closedAt
+        confidential
+        workItemType {
+          id
+          name
+        }
+        author {
+          id
+          username
+          name
+        }
+        assignees {
+          nodes {
+            id
+            username
+            name
+          }
+        }
+        labels {
+          nodes {
+            id
+            title
+            color
+          }
+        }
+        webUrl
+      }
+    }
+  }
+`;
+var LIST_WORK_ITEMS_QUERY = `
+  query listWorkItems(
+    $fullPath: ID!
+    $state: WorkItemState
+    $search: String
+    $types: [WorkItemTypeEnum!]
+    $labelNames: [String!]
+    $first: Int
+  ) {
+    workspace: project(fullPath: $fullPath) {
+      workItems(
+        state: $state
+        search: $search
+        types: $types
+        labelName: $labelNames
+        first: $first
+      ) {
+        nodes {
+          ${WORK_ITEM_LIST_FIELDS}
+        }
+      }
+    }
+  }
+`;
+var LIST_GROUP_WORK_ITEMS_QUERY = `
+  query listGroupWorkItems(
+    $fullPath: ID!
+    $state: WorkItemState
+    $search: String
+    $types: [WorkItemTypeEnum!]
+    $labelNames: [String!]
+    $first: Int
+  ) {
+    workspace: group(fullPath: $fullPath) {
+      workItems(
+        state: $state
+        search: $search
+        types: $types
+        labelName: $labelNames
+        first: $first
+      ) {
+        nodes {
+          ${WORK_ITEM_LIST_FIELDS}
+        }
+      }
+    }
+  }
+`;
+var GET_WORK_ITEM_NOTES_QUERY = `
+  query getWorkItemNotes($fullPath: ID!, $iid: String!) {
+    workspace: project(fullPath: $fullPath) {
+      workItem(iid: $iid) {
+        id
+        iid
+        notes {
+          nodes {
+            id
+            body
+            createdAt
+            updatedAt
+            author {
+              id
+              username
+              name
+            }
+            system
+            resolvable
+            resolved
+          }
+        }
+      }
+    }
+  }
+`;
+var CREATE_WORK_ITEM_MUTATION = `
+  mutation createWorkItem(
+    $projectPath: ID!
+    $title: String!
+    $workItemTypeId: WorkItemsTypeID!
+    $description: String
+    $labelIds: [LabelID!]
+    $assigneeIds: [UserID!]
+  ) {
+    workItemCreate(input: {
+      projectPath: $projectPath
+      title: $title
+      workItemTypeId: $workItemTypeId
+      descriptionWidget: { description: $description }
+      labelsWidget: { labelIds: $labelIds }
+      assigneesWidget: { assigneeIds: $assigneeIds }
+    }) {
+      workItem {
+        id
+        iid
+        title
+        description
+        state
+        createdAt
+        updatedAt
+        workItemType {
+          id
+          name
+        }
+        author {
+          id
+          username
+          name
+        }
+        webUrl
+      }
+      errors
+    }
+  }
+`;
+var UPDATE_WORK_ITEM_MUTATION = `
+  mutation updateWorkItem(
+    $id: WorkItemID!
+    $title: String
+    $description: String
+    $stateEvent: WorkItemStateEvent
+    $labelIds: [LabelID!]
+    $assigneeIds: [UserID!]
+  ) {
+    workItemUpdate(input: {
+      id: $id
+      title: $title
+      descriptionWidget: { description: $description }
+      stateEvent: $stateEvent
+      labelsWidget: { labelIds: $labelIds }
+      assigneesWidget: { assigneeIds: $assigneeIds }
+    }) {
+      workItem {
+        id
+        iid
+        title
+        description
+        state
+        updatedAt
+        workItemType {
+          id
+          name
+        }
+        webUrl
+      }
+      errors
+    }
+  }
+`;
+var CREATE_NOTE_MUTATION = `
+  mutation createWorkItemNote($noteableId: NoteableID!, $body: String!) {
+    createNote(input: { noteableId: $noteableId, body: $body }) {
+      note {
+        id
+        body
+        createdAt
+        author {
+          id
+          username
+          name
+        }
+      }
+      errors
+    }
+  }
+`;
+var GET_WORK_ITEM_GID_QUERY = `
+  query getWorkItemGid($fullPath: ID!, $iid: String!) {
+    workspace: project(fullPath: $fullPath) {
+      workItem(iid: $iid) {
+        id
+      }
+    }
+  }
+`;
 var WorkItemsClient = class extends GitLabApiClient {
-  async getWorkItem(projectId, workItemId) {
-    const encodedProject = this.encodeProjectId(projectId);
-    return this.fetch(
-      "GET",
-      `/projects/${encodedProject}/work_items/${workItemId}`
-    );
+  async getWorkItem(projectId, workItemIid) {
+    const result = await this.fetchGraphQL(GET_WORK_ITEM_QUERY, {
+      fullPath: projectId,
+      iid: String(workItemIid)
+    });
+    const workItem = result.workspace?.workItem;
+    if (!workItem) {
+      throw new Error(`Work item with iid ${workItemIid} not found in project ${projectId}`);
+    }
+    return workItem;
   }
   async listWorkItems(options) {
-    const params = new URLSearchParams();
-    params.set("per_page", String(options.limit || 20));
-    if (options.state) params.set("state", options.state);
-    if (options.search) params.set("search", options.search);
-    if (options.labels) params.set("labels", options.labels);
-    if (options.work_item_type) params.set("type", options.work_item_type);
-    let path2;
+    const variables = {
+      state: options.state ? options.state.toUpperCase() : void 0,
+      search: options.search,
+      types: options.work_item_type ? [options.work_item_type.toUpperCase()] : void 0,
+      labelNames: options.labels ? options.labels.split(",").map((l) => l.trim()) : void 0,
+      first: options.limit || 20
+    };
     if (options.projectId) {
-      const encodedProject = this.encodeProjectId(options.projectId);
-      path2 = `/projects/${encodedProject}/work_items?${params}`;
+      const result = await this.fetchGraphQL(LIST_WORK_ITEMS_QUERY, { fullPath: options.projectId, ...variables });
+      return result.workspace?.workItems?.nodes ?? [];
     } else if (options.groupId) {
-      const encodedGroup = encodeURIComponent(options.groupId);
-      path2 = `/groups/${encodedGroup}/work_items?${params}`;
+      const result = await this.fetchGraphQL(LIST_GROUP_WORK_ITEMS_QUERY, { fullPath: options.groupId, ...variables });
+      return result.workspace?.workItems?.nodes ?? [];
     } else {
       throw new Error("Either projectId or groupId must be provided");
     }
-    return this.fetch("GET", path2);
   }
-  async getWorkItemNotes(projectId, workItemId) {
-    const encodedProject = this.encodeProjectId(projectId);
-    return this.fetch(
-      "GET",
-      `/projects/${encodedProject}/work_items/${workItemId}/notes`
-    );
+  async getWorkItemNotes(projectId, workItemIid) {
+    const result = await this.fetchGraphQL(GET_WORK_ITEM_NOTES_QUERY, {
+      fullPath: projectId,
+      iid: String(workItemIid)
+    });
+    const workItem = result.workspace?.workItem;
+    if (!workItem) {
+      throw new Error(`Work item with iid ${workItemIid} not found in project ${projectId}`);
+    }
+    return workItem.notes?.nodes ?? [];
   }
   async createWorkItem(projectId, options) {
-    const encodedProject = this.encodeProjectId(projectId);
-    return this.fetch(
-      "POST",
-      `/projects/${encodedProject}/work_items`,
-      options
-    );
+    const labelIds = options.labels?.map((l) => toGid("Label", l));
+    const assigneeIds = options.assignee_ids?.map((id) => toGid("User", id));
+    const result = await this.fetchGraphQL(CREATE_WORK_ITEM_MUTATION, {
+      projectPath: projectId,
+      title: options.title,
+      workItemTypeId: toGid("WorkItems::Type", options.work_item_type_id),
+      description: options.description,
+      labelIds: labelIds?.length ? labelIds : void 0,
+      assigneeIds: assigneeIds?.length ? assigneeIds : void 0
+    });
+    if (result.workItemCreate.errors.length > 0) {
+      throw new Error(`Failed to create work item: ${result.workItemCreate.errors.join(", ")}`);
+    }
+    return result.workItemCreate.workItem;
   }
-  async updateWorkItem(projectId, workItemId, options) {
-    const encodedProject = this.encodeProjectId(projectId);
-    return this.fetch(
-      "PUT",
-      `/projects/${encodedProject}/work_items/${workItemId}`,
-      options
-    );
+  async updateWorkItem(projectId, workItemIid, options) {
+    const gidResult = await this.fetchGraphQL(GET_WORK_ITEM_GID_QUERY, {
+      fullPath: projectId,
+      iid: String(workItemIid)
+    });
+    const gid = gidResult.workspace?.workItem?.id;
+    if (!gid) {
+      throw new Error(`Work item with iid ${workItemIid} not found in project ${projectId}`);
+    }
+    const stateEvent = options.state_event ? options.state_event === "close" ? "CLOSE" : "REOPEN" : void 0;
+    const labelIds = options.labels?.map((l) => toGid("Label", l));
+    const assigneeIds = options.assignee_ids?.map((id) => toGid("User", id));
+    const result = await this.fetchGraphQL(UPDATE_WORK_ITEM_MUTATION, {
+      id: gid,
+      title: options.title,
+      description: options.description,
+      stateEvent,
+      labelIds: labelIds?.length ? labelIds : void 0,
+      assigneeIds: assigneeIds?.length ? assigneeIds : void 0
+    });
+    if (result.workItemUpdate.errors.length > 0) {
+      throw new Error(`Failed to update work item: ${result.workItemUpdate.errors.join(", ")}`);
+    }
+    return result.workItemUpdate.workItem;
   }
-  async createWorkItemNote(projectId, workItemId, body) {
-    const encodedProject = this.encodeProjectId(projectId);
-    return this.fetch(
-      "POST",
-      `/projects/${encodedProject}/work_items/${workItemId}/notes`,
-      { body }
-    );
+  async createWorkItemNote(projectId, workItemIid, body) {
+    const gidResult = await this.fetchGraphQL(GET_WORK_ITEM_GID_QUERY, {
+      fullPath: projectId,
+      iid: String(workItemIid)
+    });
+    const gid = gidResult.workspace?.workItem?.id;
+    if (!gid) {
+      throw new Error(`Work item with iid ${workItemIid} not found in project ${projectId}`);
+    }
+    const result = await this.fetchGraphQL(CREATE_NOTE_MUTATION, {
+      noteableId: gid,
+      body
+    });
+    if (result.createNote.errors.length > 0) {
+      throw new Error(`Failed to create note: ${result.createNote.errors.join(", ")}`);
+    }
+    return result.createNote.note;
   }
 };
 
@@ -3598,8 +3891,10 @@ var workItemTools = {
     description: `Get a single work item (issue, epic, task, etc.).
 Work items are the new unified model for issues, epics, tasks, and other work tracking items in GitLab.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item")
+      project_id: z12.string().describe('The project ID or full path (e.g. "gitlab-org/gitlab")'),
+      work_item_id: z12.number().describe(
+        "The IID of the work item \u2014 the number visible in the GitLab URL (e.g. for https://gitlab.com/group/project/-/work_items/52, use 52). This is NOT the global database ID."
+      )
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3637,8 +3932,10 @@ Work items include issues, epics, tasks, and other work tracking items.`,
     description: `Get all comments for a work item.
 Returns all notes/comments on the work item in chronological order.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item")
+      project_id: z12.string().describe('The project ID or full path (e.g. "gitlab-org/gitlab")'),
+      work_item_id: z12.number().describe(
+        "The IID of the work item \u2014 the number visible in the GitLab URL (e.g. for https://gitlab.com/group/project/-/work_items/52, use 52). This is NOT the global database ID."
+      )
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3673,8 +3970,10 @@ Work items are the new unified model for issues, epics, tasks, and other work tr
     description: `Update an existing work item.
 Can update title, description, state, labels, and assignees.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item"),
+      project_id: z12.string().describe('The project ID or full path (e.g. "gitlab-org/gitlab")'),
+      work_item_id: z12.number().describe(
+        "The IID of the work item \u2014 the number visible in the GitLab URL (e.g. for https://gitlab.com/group/project/-/work_items/52, use 52). This is NOT the global database ID."
+      ),
       title: z12.string().optional().describe("The new title"),
       description: z12.string().optional().describe("The new description (supports Markdown)"),
       state_event: z12.enum(["close", "reopen"]).optional().describe("Change the state (close or reopen)"),
@@ -3696,8 +3995,10 @@ Can update title, description, state, labels, and assignees.`,
   gitlab_create_work_item_note: tool12({
     description: `Create a comment on a work item.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item"),
+      project_id: z12.string().describe('The project ID or full path (e.g. "gitlab-org/gitlab")'),
+      work_item_id: z12.number().describe(
+        "The IID of the work item \u2014 the number visible in the GitLab URL (e.g. for https://gitlab.com/group/project/-/work_items/52, use 52). This is NOT the global database ID."
+      ),
       body: z12.string().describe("The content of the note/comment (supports Markdown)")
     },
     execute: async (args, _ctx) => {

package/package.json

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