feat(workitems): extend manage_work_item with date, time tracking, and tier-specific widgets by polaz · Pull Request #163 · structured-world/gitlab-mcp

polaz · 2026-01-23T22:52:40Z

Summary

Add date (startDate/dueDate), time tracking (timeEstimate/timeSpent), hierarchy (parentId/childrenIds), and tier-specific widget parameters to manage_work_item create/update actions
Add add_link/remove_link actions for work item relationships (BLOCKS/IS_BLOCKED_BY/RELATES_TO)
Add GraphQL mutations workItemAddLinkedItems and workItemRemoveLinkedItems
Fix tier matrix: LINKED_ITEMS→free, COLOR→ultimate, PROGRESS→premium
Extend UPDATE_WORK_ITEM response with all widget fragments

New Parameters

Free tier: startDate, dueDate, parentId, childrenIds, timeEstimate, timeSpent, timeSpentAt, timeSpentSummary
Premium tier: isFixed, weight, iterationId, progressCurrentValue
Ultimate tier: healthStatus, color

New Actions

Action	Description
`add_link`	Add BLOCKS/IS_BLOCKED_BY/RELATES_TO relationship between work items
`remove_link`	Remove relationship link between work items

Test plan

yarn lint — 0 errors
yarn test — 3743/3743 tests passed
yarn build — successful
Integration tests with real GitLab instance (dates, hierarchy, time tracking, linked items)

Closes #135

…erarchy, and linked items Add widget parameters for create/update actions: - Free tier: startDate, dueDate, parentId, childrenIds, timeEstimate, timeSpent, timeSpentAt, timeSpentSummary - Premium: isFixed, weight, iterationId, progressCurrentValue - Ultimate: healthStatus, color Add new actions for work item relationships: - add_link: create BLOCKS/IS_BLOCKED_BY/RELATES_TO links between items - remove_link: remove relationship links GraphQL layer updates: - Add WORK_ITEM_ADD_LINKED_ITEMS and WORK_ITEM_REMOVE_LINKED_ITEMS mutations - Extend UPDATE_WORK_ITEM response with all widget fragments - Fix WorkItemLinkedItemsWidget interface to include linkType field - Add WorkItemIterationWidget and WorkItemTimelog interfaces - Add Iteration to GID entity types Fix tier matrix: LINKED_ITEMS -> free, COLOR -> ultimate, PROGRESS -> premium Closes #135

github-actions · 2026-01-23T22:53:54Z

Test Coverage Report

Overall Coverage: 93.34%

Metric	Percentage
Statements	92.85%
Branches	84.52%
Functions	82.73%
Lines	93.34%

View detailed coverage report

codecov · 2026-01-23T22:54:17Z

Codecov Report

❌ Patch coverage is 89.24731% with 10 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/entities/workitems/registry.ts	89.02%	0 Missing and 9 partials ⚠️
src/utils/idConversion.ts	80.00%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

…m-with-date-time

Copilot

Pull request overview

Extends the manage_work_item tool to support additional work item widget fields (dates, hierarchy, time tracking, progress, color, iteration/weight/health) and adds new actions to link/unlink work items via dedicated GraphQL mutations, alongside a corrected tier availability matrix.

Changes:

Added add_link / remove_link actions and expanded create/update inputs to cover more widget-backed fields.
Extended GraphQL types and mutations (including linked-item mutations) and expanded the update response to include additional widget fragments.
Updated widget tier availability rules (LINKED_ITEMS free, PROGRESS premium, COLOR ultimate) and related unit tests; added Iteration GID support.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
tests/unit/services/WidgetAvailability.test.ts	Updates tier expectations and parameter→widget mapping assertions.
src/utils/idConversion.ts	Adds Iteration GID prefix support for ID conversion.
src/services/WidgetAvailability.ts	Updates parameter→widget mapping and tier requirements for widgets.
src/graphql/workItems.ts	Adds new widget input shapes/types, linked-items node typing, and linked-items mutations; expands update widget fragments.
src/entities/workitems/schema.ts	Extends `manage_work_item` Zod schema with new fields and new actions.
src/entities/workitems/registry.ts	Implements new widget input wiring for create/update and adds link/unlink action handlers.

src/entities/workitems/registry.ts

src/entities/workitems/schema.ts

tests/unit/services/WidgetAvailability.test.ts

…ms-extend-manageworkitem-with-date-time

…apping, add unit tests - Throw error when timeSpentAt/timeSpentSummary provided without timeSpent - Remove linkedItemIds from PARAMETER_WIDGET_MAP (linked items use add_link/remove_link actions) - Add 23 unit tests for add_link, remove_link, and all new widget parameters

…anageworkitem-with-date-time' into feat/#135-featworkitems-extend-manageworkitem-with-date-time

…m-with-date-time

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 12 comments.

src/services/WidgetAvailability.ts

src/entities/workitems/registry.ts

src/entities/workitems/schema.ts

src/entities/workitems/registry.ts

…date tests - Add .min(1) to parentId, childrenIds, iterationId in create and update schemas to prevent empty strings producing invalid GIDs - Add unit tests for update with weight, healthStatus, progress, color widgets - Add unit test for create with childrenIds - Add unit test for remove_link with empty workItem response

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

src/entities/workitems/schema.ts

src/graphql/workItems.ts

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.

src/graphql/workItems.ts

src/entities/workitems/registry.ts

src/entities/workitems/schema.ts

src/entities/workitems/registry.ts

…e in responses - Add LINKED_ITEMS widget handling to cleanWorkItemResponse: extract simple IDs from nested workItem.id fields - Map GraphQL RELATED linkType back to user-facing RELATES_TO for consistency with add_link/remove_link input schema - Extend GitLabWidget interface with linkedItems typing

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

src/entities/workitems/schema.ts

src/entities/workitems/registry.ts

…actions

Copilot

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Copilot · 2026-01-24T00:28:33Z

docs/TOOLS.md


+[02:18:39.959] [32mINFO[39m (gitlab-mcp): [36mUsing in-memory session storage (sessions will be lost on restart)[39m


The generated TOOLS.md contains a runtime log line with ANSI color codes at the end ([02:18:39.959] INFO ...). This breaks the markdown and will keep changing between runs, creating noisy diffs. Remove this line and adjust the doc generation pipeline to ensure only the markdown output is written (e.g., suppress logger output / write logs to stderr).

Suggested change

[02:18:39.959] �[32mINFO�[39m (gitlab-mcp): �[36mUsing in-memory session storage (sessions will be lost on restart)�[39m

Copilot · 2026-01-24T00:28:34Z

src/entities/workitems/registry.ts

+            if (parentId !== undefined || (childrenIds !== undefined && childrenIds.length > 0)) {
+              createInput.hierarchyWidget = {};
+              if (parentId !== undefined) {
+                createInput.hierarchyWidget.parentId = toGid(parentId, "WorkItem");
+              }
+              if (childrenIds !== undefined && childrenIds.length > 0) {


childrenIds can be passed as an empty array (schema allows it), but this childrenIds.length > 0 guard means the value is silently ignored. Either enforce childrenIds to be non-empty in the Zod schema, or handle “provided but empty” explicitly (pass through if meaningful, or throw a validation error).

Suggested change

if (parentId !== undefined || (childrenIds !== undefined && childrenIds.length > 0)) {

createInput.hierarchyWidget = {};

if (parentId !== undefined) {

createInput.hierarchyWidget.parentId = toGid(parentId, "WorkItem");

}

if (childrenIds !== undefined && childrenIds.length > 0) {

if (parentId !== undefined || childrenIds !== undefined) {

createInput.hierarchyWidget = {};

if (parentId !== undefined) {

createInput.hierarchyWidget.parentId = toGid(parentId, "WorkItem");

}

if (childrenIds !== undefined) {

Copilot · 2026-01-24T00:28:34Z

src/entities/workitems/registry.ts

+            if (parentId !== undefined || (childrenIds !== undefined && childrenIds.length > 0)) {
+              updateInput.hierarchyWidget = {};
+              if (parentId !== undefined) {
+                // null means unlink parent, string means set parent
+                updateInput.hierarchyWidget.parentId =
+                  parentId === null ? null : toGid(parentId, "WorkItem");
+              }
+              if (childrenIds !== undefined && childrenIds.length > 0) {


On update, childrenIds can be provided as an empty array (schema allows it), but the childrenIds.length > 0 check prevents sending hierarchyWidget.childrenIds, so the request ignores the user input. Align schema + handler behavior (non-empty schema, or pass through/explicitly reject empty arrays).

Suggested change

if (parentId !== undefined || (childrenIds !== undefined && childrenIds.length > 0)) {

updateInput.hierarchyWidget = {};

if (parentId !== undefined) {

// null means unlink parent, string means set parent

updateInput.hierarchyWidget.parentId =

parentId === null ? null : toGid(parentId, "WorkItem");

}

if (childrenIds !== undefined && childrenIds.length > 0) {

if (parentId !== undefined || childrenIds !== undefined) {

updateInput.hierarchyWidget = {};

if (parentId !== undefined) {

// null means unlink parent, string means set parent

updateInput.hierarchyWidget.parentId =

parentId === null ? null : toGid(parentId, "WorkItem");

}

if (childrenIds !== undefined) {

## [6.37.0](v6.36.0...v6.37.0) (2026-01-24) ### Features * **workitems:** extend manage_work_item with date, time tracking, and tier-specific widgets ([#163](#163)) ([d63a757](d63a757)), closes [#135](#135)

sw-release-bot · 2026-01-24T00:32:22Z

🎉 This PR is included in version 6.37.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Copilot AI review requested due to automatic review settings January 23, 2026 22:52

Copilot started reviewing on behalf of polaz January 23, 2026 22:53 View session

Merge branch 'main' into feat/#135-featworkitems-extend-manageworkite…

25c95c6

…m-with-date-time

Copilot AI reviewed Jan 23, 2026

View reviewed changes

polaz added 4 commits January 24, 2026 01:03

Merge remote-tracking branch 'origin/main' into feat/#135-featworkite…

22ffbf3

…ms-extend-manageworkitem-with-date-time

Merge remote-tracking branch 'origin/feat/#135-featworkitems-extend-m…

893497e

…anageworkitem-with-date-time' into feat/#135-featworkitems-extend-manageworkitem-with-date-time

Merge branch 'main' into feat/#135-featworkitems-extend-manageworkite…

74df674

…m-with-date-time

polaz requested a review from Copilot January 23, 2026 23:12

Copilot started reviewing on behalf of polaz January 23, 2026 23:13 View session

Copilot AI reviewed Jan 23, 2026

View reviewed changes

polaz requested a review from Copilot January 23, 2026 23:30

Copilot started reviewing on behalf of polaz January 23, 2026 23:31 View session

Copilot AI reviewed Jan 23, 2026

View reviewed changes

src/entities/workitems/schema.ts Show resolved Hide resolved

src/graphql/workItems.ts Show resolved Hide resolved

polaz requested a review from Copilot January 23, 2026 23:52

Copilot started reviewing on behalf of polaz January 23, 2026 23:52 View session

Copilot AI reviewed Jan 24, 2026

View reviewed changes

polaz requested a review from Copilot January 24, 2026 00:10

Copilot started reviewing on behalf of polaz January 24, 2026 00:10 View session

Copilot AI reviewed Jan 24, 2026

View reviewed changes

src/entities/workitems/schema.ts Show resolved Hide resolved

src/entities/workitems/registry.ts Show resolved Hide resolved

docs(workitems): regenerate TOOLS.md with new widget params and link …

6ad69d5

…actions

polaz requested a review from Copilot January 24, 2026 00:24

Copilot started reviewing on behalf of polaz January 24, 2026 00:24 View session

polaz merged commit d63a757 into main Jan 24, 2026
23 checks passed

polaz deleted the feat/#135-featworkitems-extend-manageworkitem-with-date-time branch January 24, 2026 00:25

Copilot AI reviewed Jan 24, 2026

View reviewed changes

sw-release-bot bot added the released label Jan 24, 2026

sw-release-bot bot mentioned this pull request Mar 29, 2026

chore(main): release gitlab-mcp 7.0.0 #368

Open


		[02:18:39.959] [32mINFO[39m (gitlab-mcp): [36mUsing in-memory session storage (sessions will be lost on restart)[39m


	[02:18:39.959] �[32mINFO�[39m (gitlab-mcp): �[36mUsing in-memory session storage (sessions will be lost on restart)�[39m

Conversation

polaz commented Jan 23, 2026

Summary

New Parameters

New Actions

Test plan

Uh oh!

github-actions bot commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Coverage Report

Uh oh!

codecov bot commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

sw-release-bot bot commented Jan 24, 2026

Uh oh!

Reviewers

Assignees

github-actions bot commented Jan 23, 2026 •

edited

Loading

codecov bot commented Jan 23, 2026 •

edited

Loading