feat(tiers): add action-level tier requirements for consolidated tools by polaz · Pull Request #77 · structured-world/gitlab-mcp

polaz · 2026-01-20T21:34:34Z

Summary

Add action-level tier requirements mapping for all consolidated tools
Display tier information per action in --export documentation
Support action-specific tier lookups for runtime availability checks

Features

Action-Level Tier Requirements

Each consolidated tool now has tier requirements defined at the action level:

manage_merge_request: {
  default: { tier: "free", minVersion: 8.0 },
},
browse_milestones: {
  default: { tier: "free", minVersion: 8.0 },
  actions: {
    burndown: { tier: "premium", minVersion: 12.0, notes: "Burndown charts" },
  },
},

New API Methods

getActionRequirement(toolName, action?) - Get tier requirement for specific action
getHighestTier(toolName) - Get highest tier required by any action
getTierRestrictedActions(toolName, tier) - List actions requiring premium/ultimate

Export Documentation

Actions table now includes Tier column:

| Action | Tier | Description |
|--------|------|-------------|
| `list` | Free | List items |
| `burndown` | Premium | Get burndown chart data |

Test plan

All 2262 unit tests pass
Lint and build pass
Verified tier badges show correctly in --export output
Updated list-tools tests for new tier functionality

Closes #48

Add action-level tier requirements mapping: - Add ToolActionRequirements interface for action-specific tiers - Add actionRequirements map with all consolidated tools - Add getActionRequirement() for action-specific tier lookups - Add getHighestTier() to get max tier for any tool action - Add getTierRestrictedActions() to list premium/ultimate actions - Update getToolRequirement() to support action parameter - Update isToolAvailable() to check action-specific tiers - Update getToolTierInfo() in list-tools.ts for action tiers - Add Tier column to actions table in --export output - Update tests for new tier functionality Closes #48

src/cli/list-tools.ts

codecov · 2026-01-20T21:36:47Z

Codecov Report

❌ Patch coverage is 86.00000% with 7 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/cli/list-tools.ts	62.50%	3 Missing and 3 partials ⚠️
src/services/ToolAvailability.ts	97.05%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

github-actions · 2026-01-20T21:37:40Z

📊 Test Coverage Report

Overall Coverage: 89.6%

Coverage Details

Metric	Percentage
Statements	89.6%
Branches	82.46%
Functions	77.32%
Lines	90.05%

Coverage Report: View detailed coverage report

This report was generated automatically from your PR changes.

Copilot

Pull request overview

This PR adds action-level tier requirements for consolidated tools in the GitLab MCP server, enabling more granular tier tracking per action. The changes support displaying tier information for individual actions in exported documentation and enable runtime availability checks based on action-specific requirements.

Changes:

Added action-level tier requirement data structures and methods (getActionRequirement, getHighestTier, getTierRestrictedActions)
Updated --export mode to display tier information in the Actions table
Modified tier display logic to show asterisk for tools with mixed-tier actions

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
src/services/ToolAvailability.ts	Adds new interfaces (ActionRequirement, ToolActionRequirements), comprehensive action-level tier mapping for 30+ tools, and new methods for querying tier requirements at action and tool levels
src/cli/list-tools.ts	Updates getToolTierInfo to support action-specific tier lookups and modifies export markdown generation to include tier column in actions table
tests/unit/cli/list-tools.test.ts	Updates test mocks to support new ToolAvailability methods and adjusts test expectations for new Tier column in actions table

src/cli/list-tools.ts

…el tests - Use replaceAll for complete bracket removal in tier display - Fix mixed tier detection to compare default vs highest tier - Add tests for getActionRequirement, getHighestTier, getTierRestrictedActions - Add tests for isToolAvailable with action parameter

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot

Pull request overview

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

src/services/ToolAvailability.ts

src/cli/list-tools.ts

src/services/ToolAvailability.ts

- Extract TIER_ORDER constant to avoid duplication in tier comparison methods - Fix getAvailableTools to include tools from both legacy and action requirements - Add JSDoc documenting asterisk notation for mixed tiers in getTierBadge - Replace replaceAll with regex replace for broader Node.js compatibility - Add tests for getToolRequirement with action parameter - Add tests for isToolAvailable version checking with actions - Add tests for getAvailableTools combining both requirement sources

Copilot

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

## [6.18.0](v6.17.0...v6.18.0) (2026-01-21) ### Features * **errors:** add structured error handling with tier awareness ([#75](#75)) ([2b5088c](2b5088c)), closes [#50](#50) [#50](#50) * **mrs:** implement GitLab Suggestions API integration ([#70](#70)) ([b9ca090](b9ca090)), closes [#66](#66) * **tiers:** add action-level tier requirements for consolidated tools ([#77](#77)) ([8e5ae0e](8e5ae0e)), closes [#48](#48)

Copilot AI review requested due to automatic review settings January 20, 2026 21:34

polaz mentioned this pull request Jan 20, 2026

feat: Tags management entity (browse_tags, manage_tag) #80

Closed

7 tasks

github-advanced-security bot found potential problems Jan 20, 2026

View reviewed changes

src/cli/list-tools.ts Fixed Show fixed Hide fixed

Copilot started reviewing on behalf of polaz January 20, 2026 21:36 View session

Copilot AI reviewed Jan 20, 2026

View reviewed changes

src/cli/list-tools.ts Outdated Show resolved Hide resolved

polaz requested a review from Copilot January 20, 2026 22:00

Copilot started reviewing on behalf of polaz January 20, 2026 22:11 View session

Copilot AI reviewed Jan 20, 2026

View reviewed changes

polaz requested a review from Copilot January 20, 2026 23:27

Copilot AI reviewed Jan 20, 2026

View reviewed changes

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

polaz requested a review from Copilot January 21, 2026 06:37

Copilot started reviewing on behalf of polaz January 21, 2026 06:38 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

polaz requested a review from Copilot January 21, 2026 07:07

Copilot started reviewing on behalf of polaz January 21, 2026 07:08 View session

Copilot AI reviewed Jan 21, 2026

View reviewed changes

polaz merged commit 8e5ae0e into main Jan 21, 2026
20 checks passed

polaz deleted the feat/48-cqrs-tier-requirements branch January 21, 2026 07:21

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

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

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(tiers): add action-level tier requirements for consolidated tools#77

feat(tiers): add action-level tier requirements for consolidated tools#77
polaz merged 3 commits intomainfrom
feat/48-cqrs-tier-requirements

polaz commented Jan 20, 2026

Uh oh!

Uh oh!

codecov bot commented Jan 20, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 20, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

polaz commented Jan 20, 2026

Summary

Features

Action-Level Tier Requirements

New API Methods

Export Documentation

Test plan

Uh oh!

Uh oh!

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

Uh oh!

Codecov Report

Uh oh!

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

Uh oh!

📊 Test Coverage Report

Coverage Details

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

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!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

codecov bot commented Jan 20, 2026 •

edited

Loading

github-actions bot commented Jan 20, 2026 •

edited

Loading