@gitlab/opencode-gitlab-plugin 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/CHANGELOG.md +292 -0
  2. package/README.md +1283 -0
  3. package/dist/index.d.ts +26 -0
  4. package/dist/index.js +3853 -0
  5. package/package.json +87 -0
  6. package/scripts/postinstall.mjs +163 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,292 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
4
+
5
+ ## [1.0.1](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.0.0...v1.0.1) (2026-01-07)
6
+
7
+
8
+ ### 🐛 Bug Fixes
9
+
10
+ * add provenance flag to npm publish for OIDC authentication ([c0a011a](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/c0a011ab5ca2514969ddddf4c5ce5e72458fc68c))
11
+
12
+ ## 1.0.0 (2026-01-07)
13
+
14
+
15
+ ### ⚠ BREAKING CHANGES
16
+
17
+ * This is the first release with automated CI/CD pipeline
18
+
19
+ ### ✨ Features
20
+
21
+ * add gitlab-skills as dependency ([c177598](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/c1775988308eacc64381d92636b750ce35d70a24))
22
+ * add postinstall script to ensure skills installation ([3c1202c](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/3c1202cbd34e575caf5cbb4ae3c7ba7bfae48c56))
23
+ * added new tools ([645aa35](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/645aa350d6900e68e92b07f5ac67c1391a1e8deb))
24
+ * added tools ([36422ac](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/36422ac3f0c4a0c94f79b3f8865c2f0c3e4dd510))
25
+ * enable automated releases with semantic-release ([46fe768](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/46fe7686444574dc5deb8fbe471c250d4c787816))
26
+ * implement Enhanced Search tools (Issue [#6](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/issues/6) Phase 2) ([ba9ac18](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/ba9ac18b986bfde7b81958a66a3e3cd412bd577f))
27
+ * implement Git & CI Operations tools (Issue [#6](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/issues/6) Phase 1) ([4a80b1e](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/4a80b1ec725c3b4f7d7e0a77a911b57f1fdae883))
28
+ * implement GraphQL-based vulnerability management tools ([22536e9](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/22536e95b3d87c5f5a0e559d7cc4ffe0ce686464))
29
+ * improve ref parameter handling in gitlab_get_file ([027a682](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/027a682cfb70723b6215b26db64050a6b8f4f26e))
30
+ * modular approach ([7ecc37c](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/7ecc37c7a5f4eda81c3533349e21a674639d8ad1))
31
+ * publish to npmjs ([1b24d93](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/1b24d934c592f49264b549f90150dad1819a8605))
32
+ * restore git plugin and use custom GITLAB_TOKEN for semantic-release ([7b33e34](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/7b33e34464c61aacf02fd595368a58eff9f005c5))
33
+ * rolled back npm namespace ([00d6137](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/00d6137ae6ff491d4a6826c6fbd99f618d72183c))
34
+ * trigger release ([f53abf3](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/f53abf3b58c5ed2cf230da087791c9702f80cdfa))
35
+
36
+
37
+ ### 🐛 Bug Fixes
38
+
39
+ * add git authentication for semantic-release ([1b746ae](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/1b746aec9cf78963a706ef164e152ae52c0a7715))
40
+ * add GITLAB_TOKEN environment variable for semantic-release ([123c5b5](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/123c5b50bb30af1a953b3f8e410f1c452cc06868))
41
+ * add mock for @opencode-ai/plugin to fix tools tests ([8fb0409](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/8fb04097841aba42a1b5d155dec7a5cdf91052a9))
42
+ * added package lock ([4b59907](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/4b599077e0f332c20650259f423eb19f54563f0b))
43
+ * bun lock ([f870734](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/f8707343d74d3b35dcd08950fc764641c1ff4465))
44
+ * **ci:** disable husky hooks in release job ([6a33dd9](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/6a33dd9799816dbae8334b832a1978af1ab2178e))
45
+ * cleaning up index.ts file ([14316e4](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/14316e4efe009d701a882d44a5ec9354de6fd3c4))
46
+ * create release ([584eeb3](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/584eeb3ab0b00c9bcd0f3de59e068ef41a841da8))
47
+ * create release ([e74f8a7](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/e74f8a7550a6d2a58b3fb551fe4ad3a2db56e0c7))
48
+ * create release ([58a2abd](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/58a2abdd317c1a02644859baed4eb27be4661a1b))
49
+ * create release ([36e8aa9](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/36e8aa9c2f7a958bb4441dbcfaae9dfa98db0e48))
50
+ * disable husky hooks in publish-release job ([9e610f4](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/9e610f403db5b7687e1cc6140d3a602cd3aea524))
51
+ * fix postInstall script ([9f054c5](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/9f054c563b06c8c14bc0a13776ebf0d66cf62857))
52
+ * **hooks:** explicitly specify lint-staged config file ([1b71b62](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/1b71b625de947565c32687a983c1a0cedc83ff22))
53
+ * include .npmrc in published package for registry resolution ([db82b34](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/db82b3424c7839ae3be001e7e09b3f3110661a5d))
54
+ * remove git plugin to avoid protected branch push ([d24648d](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/d24648d66dfeecabe61e453deea0d56f5329ab5e))
55
+ * replace bun-types with @types/node in tsconfig ([a30208b](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/a30208b80d77c34b73057d2310d459e48bcd8973))
56
+ * switched to vitest ([f91d9fb](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/f91d9fb2a0aac01e9d0450fd465c4a6ffa216c14))
57
+ * updated locks ([6447d7e](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/6447d7e3ba3dc25d21f0559eccc56e97006f881a))
58
+ * updated skills dep ([27c59a4](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/27c59a4c6ff68b7b035d102f8859daf6b24c1128))
59
+
60
+
61
+ ### 📚 Documentation
62
+
63
+ * remove unused docs ([39d16d1](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/39d16d1eea6683872913080b4b6b3367d391ebff))
64
+ * Updated documentation ([bf5c8b9](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/bf5c8b9c32c5340155cb8b238f59988b29e25c89))
65
+
66
+ # [1.11.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.10.0...v1.11.0) (2025-12-16)
67
+
68
+
69
+ ### Features
70
+
71
+ * trigger release ([f53abf3](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/f53abf3b58c5ed2cf230da087791c9702f80cdfa))
72
+
73
+ # [1.10.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.9.0...v1.10.0) (2025-12-15)
74
+
75
+
76
+ ### Features
77
+
78
+ * implement GraphQL-based vulnerability management tools ([22536e9](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/22536e95b3d87c5f5a0e559d7cc4ffe0ce686464))
79
+
80
+ # [1.9.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.8.0...v1.9.0) (2025-12-15)
81
+
82
+
83
+ ### Features
84
+
85
+ * added tools ([36422ac](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/36422ac3f0c4a0c94f79b3f8865c2f0c3e4dd510))
86
+
87
+ # [1.8.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.7.0...v1.8.0) (2025-12-15)
88
+
89
+
90
+ ### Bug Fixes
91
+
92
+ * create release ([584eeb3](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/584eeb3ab0b00c9bcd0f3de59e068ef41a841da8))
93
+
94
+
95
+ ### Features
96
+
97
+ * implement Enhanced Search tools (Issue [#6](https://gitlab.com/vglafirov/opencode-gitlab-plugin/issues/6) Phase 2) ([ba9ac18](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/ba9ac18b986bfde7b81958a66a3e3cd412bd577f))
98
+
99
+ # [1.7.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.6.4...v1.7.0) (2025-12-14)
100
+
101
+
102
+ ### Features
103
+
104
+ * implement Git & CI Operations tools (Issue [#6](https://gitlab.com/vglafirov/opencode-gitlab-plugin/issues/6) Phase 1) ([4a80b1e](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/4a80b1ec725c3b4f7d7e0a77a911b57f1fdae883))
105
+
106
+ ## [1.6.4](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.6.3...v1.6.4) (2025-12-14)
107
+
108
+
109
+ ### Bug Fixes
110
+
111
+ * create release ([e74f8a7](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/e74f8a7550a6d2a58b3fb551fe4ad3a2db56e0c7))
112
+
113
+ ## [Unreleased]
114
+
115
+ ### Added
116
+ - **GraphQL API Support** - Added `fetchGraphQL()` method to base `GitLabApiClient` class
117
+ - Enables GraphQL queries and mutations with proper error handling
118
+ - Supports variables and returns typed responses
119
+ - Foundation for advanced GitLab features
120
+ - Enhanced JSDoc documentation with `@template` parameter
121
+ - **Vulnerability Management Tools** - 6 new GraphQL-based security tools:
122
+ - `gitlab_create_vulnerability_issue` - Create issue linked to vulnerabilities
123
+ - `gitlab_dismiss_vulnerability` - Dismiss vulnerability with reason (ACCEPTABLE_RISK, FALSE_POSITIVE, etc.)
124
+ - `gitlab_confirm_vulnerability` - Confirm a security vulnerability
125
+ - `gitlab_revert_vulnerability_to_detected` - Revert vulnerability state back to detected
126
+ - `gitlab_update_vulnerability_severity` - Update vulnerability severity level (CRITICAL, HIGH, MEDIUM, LOW, INFO, UNKNOWN)
127
+ - `gitlab_link_vulnerability_to_issue` - Link existing issue to vulnerabilities
128
+ - All tools require Developer role or higher
129
+ - Comprehensive test coverage with 29 new tests (22 security + 7 validation)
130
+ - **GID Validation Utilities** - New validation module for GitLab Global IDs
131
+ - `isValidGid()` - Validates GID format with optional type checking
132
+ - `validateGid()` - Validates and throws descriptive errors for invalid GIDs
133
+ - Integrated into all security methods that accept GIDs
134
+ - Provides better error messages for incorrect GID formats
135
+
136
+ ### Changed
137
+ - **Refactored Security Client** - Improved code maintainability
138
+ - Extracted all GraphQL mutation queries to constants
139
+ - Makes queries easier to update and maintain
140
+ - Improved code readability in security methods
141
+ - **Enhanced Type Safety** - Added validation for all GID parameters
142
+ - Validates vulnerability IDs format: `gid://gitlab/Vulnerability/{id}`
143
+ - Validates issue IDs format: `gid://gitlab/Issue/{id}`
144
+ - Prevents invalid GID formats from reaching GitLab API
145
+ - **Audit Events API** - 3 new tools for security and compliance monitoring:
146
+ - `gitlab_list_project_audit_events` - List audit events for a project (requires owner role)
147
+ - `gitlab_list_group_audit_events` - List audit events for a group (requires owner role)
148
+ - `gitlab_list_instance_audit_events` - List instance-level audit events (requires admin)
149
+ - Support for filtering by date range, entity type, entity ID, and author ID with pagination
150
+ - **Paginated MR Diffs** - `gitlab_list_merge_request_diffs` tool for handling large changesets
151
+ - Fetch merge request diffs with pagination support
152
+ - Useful for processing diffs in chunks when MRs have many changed files
153
+ - **Single Note Retrieval** - 3 new tools for granular comment access:
154
+ - `gitlab_get_epic_note` - Get a single note from an epic by ID
155
+ - `gitlab_get_issue_note` - Get a single note from an issue by ID
156
+ - `gitlab_get_commit_comments` - Get all comments on a specific commit
157
+ - Retrieve specific comments without fetching all notes
158
+ - **`gitlab_create_issue`** tool - Create new issues in GitLab projects with full support for:
159
+ - Required parameters: `project_id`, `title`
160
+ - Optional parameters: `description`, `assignee_ids`, `milestone_id`, `labels`, `due_date`, `confidential`, `weight`, `epic_id`, `issue_type`
161
+ - Support for different issue types: `issue`, `incident`, `test_case`, `task`
162
+ - Comprehensive test coverage for client and tool
163
+ - Detailed documentation in `docs/CREATE_ISSUE_TOOL.md`
164
+
165
+ ### Changed
166
+ - Updated README.md with `gitlab_create_issue` tool documentation
167
+ - Added usage example for creating and managing issues
168
+ - Updated tool count from 60+ to 68+ tools (7 new tools added)
169
+ - Updated index.ts comment to reflect new audit, paginated diffs, and single note retrieval capabilities
170
+ - Integrated `AuditClient` into `UnifiedGitLabClient` via mixins
171
+
172
+ ## [1.6.3](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.6.2...v1.6.3) (2025-12-14)
173
+
174
+
175
+ ### Bug Fixes
176
+
177
+ * create release ([58a2abd](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/58a2abdd317c1a02644859baed4eb27be4661a1b))
178
+
179
+ ## [1.6.2](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.6.1...v1.6.2) (2025-12-13)
180
+
181
+
182
+ ### Bug Fixes
183
+
184
+ * create release ([36e8aa9](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/36e8aa9c2f7a958bb4441dbcfaae9dfa98db0e48))
185
+
186
+ ## [1.6.1](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.6.0...v1.6.1) (2025-12-11)
187
+
188
+
189
+ ### Bug Fixes
190
+
191
+ * cleaning up index.ts file ([14316e4](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/14316e4efe009d701a882d44a5ec9354de6fd3c4))
192
+
193
+ # [1.6.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.5.0...v1.6.0) (2025-12-11)
194
+
195
+
196
+ ### Features
197
+
198
+ * added new tools ([645aa35](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/645aa350d6900e68e92b07f5ac67c1391a1e8deb))
199
+
200
+ # [1.5.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.4.0...v1.5.0) (2025-12-11)
201
+
202
+
203
+ ### Bug Fixes
204
+
205
+ * add mock for @opencode-ai/plugin to fix tools tests ([8fb0409](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/8fb04097841aba42a1b5d155dec7a5cdf91052a9))
206
+ * added package lock ([4b59907](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/4b599077e0f332c20650259f423eb19f54563f0b))
207
+ * replace bun-types with @types/node in tsconfig ([a30208b](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/a30208b80d77c34b73057d2310d459e48bcd8973))
208
+ * switched to vitest ([f91d9fb](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/f91d9fb2a0aac01e9d0450fd465c4a6ffa216c14))
209
+
210
+
211
+ ### Features
212
+
213
+ * modular approach ([7ecc37c](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/7ecc37c7a5f4eda81c3533349e21a674639d8ad1))
214
+
215
+ # [1.4.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.3.4...v1.4.0) (2025-12-11)
216
+
217
+
218
+ ### Features
219
+
220
+ * improve ref parameter handling in gitlab_get_file ([027a682](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/027a682cfb70723b6215b26db64050a6b8f4f26e))
221
+
222
+ ## [1.3.4](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.3.3...v1.3.4) (2025-12-10)
223
+
224
+
225
+ ### Bug Fixes
226
+
227
+ * updated locks ([6447d7e](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/6447d7e3ba3dc25d21f0559eccc56e97006f881a))
228
+ * updated skills dep ([27c59a4](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/27c59a4c6ff68b7b035d102f8859daf6b24c1128))
229
+
230
+ ## [1.3.3](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.3.2...v1.3.3) (2025-12-10)
231
+
232
+
233
+ ### Bug Fixes
234
+
235
+ * fix postInstall script ([9f054c5](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/9f054c563b06c8c14bc0a13776ebf0d66cf62857))
236
+
237
+ ## [1.3.2](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.3.1...v1.3.2) (2025-12-10)
238
+
239
+
240
+ ### Bug Fixes
241
+
242
+ * bun lock ([f870734](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/f8707343d74d3b35dcd08950fc764641c1ff4465))
243
+
244
+ ## [1.3.1](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.3.0...v1.3.1) (2025-12-10)
245
+
246
+
247
+ ### Bug Fixes
248
+
249
+ * include .npmrc in published package for registry resolution ([db82b34](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/db82b3424c7839ae3be001e7e09b3f3110661a5d))
250
+
251
+ # [1.3.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.2.0...v1.3.0) (2025-12-10)
252
+
253
+
254
+ ### Features
255
+
256
+ * add postinstall script to ensure skills installation ([3c1202c](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/3c1202cbd34e575caf5cbb4ae3c7ba7bfae48c56))
257
+
258
+ # [1.2.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.1.0...v1.2.0) (2025-12-10)
259
+
260
+
261
+ ### Features
262
+
263
+ * add gitlab-skills as dependency ([c177598](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/c1775988308eacc64381d92636b750ce35d70a24))
264
+
265
+ # [1.1.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v1.0.0...v1.1.0) (2025-12-06)
266
+
267
+
268
+ ### Features
269
+
270
+ * rolled back npm namespace ([00d6137](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/00d6137ae6ff491d4a6826c6fbd99f618d72183c))
271
+
272
+ # [1.0.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v0.1.0...v1.0.0) (2025-12-03)
273
+
274
+
275
+ ### Bug Fixes
276
+
277
+ * **ci:** disable husky hooks in release job ([6a33dd9](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/6a33dd9799816dbae8334b832a1978af1ab2178e))
278
+ * **hooks:** explicitly specify lint-staged config file ([1b71b62](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/1b71b625de947565c32687a983c1a0cedc83ff22))
279
+
280
+
281
+ ### Features
282
+
283
+ * enable automated releases with semantic-release ([46fe768](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/46fe7686444574dc5deb8fbe471c250d4c787816))
284
+
285
+
286
+ ### BREAKING CHANGES
287
+
288
+ * This is the first release with automated CI/CD pipeline
289
+
290
+ # Changelog
291
+
292
+ All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.