mcp-sentinel-qa 2.0.2 → 2.0.3
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.
- package/CHANGELOG.md +12 -0
- package/README.md +19 -10
- package/dist/package.json +1 -1
- package/dist/tools/test-cases.js +104 -10
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.0.3 — 2026-11-03
|
|
4
|
+
|
|
5
|
+
### Complete test-case fields
|
|
6
|
+
|
|
7
|
+
- Support all test-case form fields through MCP creation and partial updates,
|
|
8
|
+
including tags, objectives, preconditions, estimated time and assignee.
|
|
9
|
+
- Create and edit both Gherkin and structured-step cases, including step ordering.
|
|
10
|
+
- Return saved metadata in lists and complete content, including steps, in details.
|
|
11
|
+
- Validate assigned users against the API key's workspace.
|
|
12
|
+
|
|
13
|
+
Version 2.0.3 expands the existing test-case tools without changing their names.
|
|
14
|
+
|
|
3
15
|
## 2.0.2 — 2026-10-29
|
|
4
16
|
|
|
5
17
|
### Multi-level functionality hierarchy
|
package/README.md
CHANGED
|
@@ -27,7 +27,7 @@ Add the following server entry to your MCP client's configuration:
|
|
|
27
27
|
"mcpServers": {
|
|
28
28
|
"sentinel": {
|
|
29
29
|
"command": "pnpm",
|
|
30
|
-
"args": ["dlx", "mcp-sentinel-qa@2.0.
|
|
30
|
+
"args": ["dlx", "mcp-sentinel-qa@2.0.3"],
|
|
31
31
|
"env": {
|
|
32
32
|
"SENTINEL_API_KEY": "YOUR_SENTINEL_API_KEY"
|
|
33
33
|
}
|
|
@@ -43,14 +43,14 @@ secret storage or environment-variable references, use those instead.
|
|
|
43
43
|
For a manual launch, provide the key through your environment and run:
|
|
44
44
|
|
|
45
45
|
```sh
|
|
46
|
-
pnpm dlx mcp-sentinel-qa@2.0.
|
|
46
|
+
pnpm dlx mcp-sentinel-qa@2.0.3
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
The process waits for MCP messages on stdin; it is not an interactive terminal UI
|
|
50
50
|
or an HTTP server. The API endpoint is currently fixed to
|
|
51
51
|
`https://sentinel-qa.vercel.app`; `SENTINEL_API_URL` is not supported.
|
|
52
52
|
|
|
53
|
-
## Tools in 2.0.
|
|
53
|
+
## Tools in 2.0.3
|
|
54
54
|
|
|
55
55
|
The package provides thirteen tools:
|
|
56
56
|
|
|
@@ -66,14 +66,23 @@ The package provides thirteen tools:
|
|
|
66
66
|
| `sentinel_move_functionality_test_cases` | Atomically transfer selected test cases to another functionality. |
|
|
67
67
|
| `sentinel_list_test_cases` | Search and paginate test cases, with project, functionality, priority, status and type filters. |
|
|
68
68
|
| `sentinel_get_test_case` | Retrieve a test case by UUID. |
|
|
69
|
-
| `sentinel_create_test_case` | Create a test case with
|
|
70
|
-
| `sentinel_update_test_case` |
|
|
69
|
+
| `sentinel_create_test_case` | Create a Gherkin or structured-step test case with all Sentinel fields, including tags. |
|
|
70
|
+
| `sentinel_update_test_case` | Partially update all test-case fields, including tags, Gherkin and structured steps. |
|
|
71
71
|
| `sentinel_delete_test_case` | Permanently delete a test case by UUID. |
|
|
72
72
|
|
|
73
73
|
Tool schemas expose required fields and allowed values. Test-case lists support
|
|
74
74
|
`page` and `page_size` (maximum 100); functionality lists use the same pagination
|
|
75
75
|
with a default page size of 20.
|
|
76
76
|
|
|
77
|
+
Test-case creation and editing cover the fields in Sentinel's form: `ct_id`,
|
|
78
|
+
functionality, title, scenario type, Gherkin or ordered steps, priority, test and
|
|
79
|
+
scenario status, automation flag, platforms, notes, objective, preconditions,
|
|
80
|
+
estimated time, tags and assignee. Tags are plain strings (up to 10, 50 characters
|
|
81
|
+
each); pass `tags: []` when editing to remove all tags. For step-based cases, set
|
|
82
|
+
`description_mode` to `steps` and provide at least one action; switching back to
|
|
83
|
+
`gherkin` requires non-empty Gherkin text. List responses include tags and saved
|
|
84
|
+
metadata; `sentinel_get_test_case` returns the complete content and ordered steps.
|
|
85
|
+
|
|
77
86
|
Functionalities can be nested at any depth. `parent_id` identifies the immediate
|
|
78
87
|
parent, which may be any functionality in the same project; an omitted or null
|
|
79
88
|
parent creates or promotes a root. The paginated list is flat, so follow every
|
|
@@ -117,11 +126,11 @@ replace it in your client configuration.
|
|
|
117
126
|
## Upgrade from 1.x
|
|
118
127
|
|
|
119
128
|
Version 2.0.0 introduced the Node.js 22 minimum; Node.js 18 and 20 are not
|
|
120
|
-
supported. Version 2.0.1 added functionality management tools
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
`mcp-sentinel-qa@2.0.
|
|
129
|
+
supported. Version 2.0.1 added functionality management tools, and 2.0.2 updated
|
|
130
|
+
their hierarchy guidance for trees at any depth. Version 2.0.3 completes the
|
|
131
|
+
test-case fields available through MCP, including tags and structured steps.
|
|
132
|
+
Update a pinned `mcp-sentinel-qa@2.0.2` configuration to
|
|
133
|
+
`mcp-sentinel-qa@2.0.3`, then restart or reconnect your MCP client. Older
|
|
125
134
|
examples using `mcp-server-sentinel` should use `mcp-sentinel-qa` instead.
|
|
126
135
|
|
|
127
136
|
## Development and release checks
|
package/dist/package.json
CHANGED
package/dist/tools/test-cases.js
CHANGED
|
@@ -109,13 +109,41 @@ export function registerTestCaseTools(server) {
|
|
|
109
109
|
// sentinel_create_test_case
|
|
110
110
|
// =========================================================================
|
|
111
111
|
server.registerTool('sentinel_create_test_case', {
|
|
112
|
-
description: 'Create a
|
|
112
|
+
description: 'Create a test case with Sentinel form fields, including tags, objective, preconditions, assignee and estimated time. Set description_mode to steps and provide steps for structured cases; otherwise provide Gherkin. Requires project_id; use the project and functionality list tools for IDs.',
|
|
113
113
|
inputSchema: z.object({
|
|
114
114
|
project_id: z.string().uuid().describe('Project UUID (required)'),
|
|
115
|
-
|
|
116
|
-
|
|
115
|
+
ct_id: z
|
|
116
|
+
.string()
|
|
117
|
+
.max(20)
|
|
118
|
+
.optional()
|
|
119
|
+
.describe('Optional test case identifier; generated when omitted'),
|
|
120
|
+
functionality_id: z
|
|
121
|
+
.string()
|
|
122
|
+
.uuid()
|
|
123
|
+
.nullable()
|
|
124
|
+
.optional()
|
|
125
|
+
.describe('Functionality UUID, or null to leave the case unassigned'),
|
|
126
|
+
title: z.string().min(5).max(200).describe('Test case title (5–200 chars)'),
|
|
117
127
|
scenario_type: z.enum(['Positivo', 'Negativo']).describe('Scenario type'),
|
|
118
|
-
|
|
128
|
+
description_mode: z
|
|
129
|
+
.enum(['gherkin', 'steps'])
|
|
130
|
+
.optional()
|
|
131
|
+
.describe('Use gherkin for BDD text (default) or steps for structured action/result steps'),
|
|
132
|
+
gherkin: z
|
|
133
|
+
.string()
|
|
134
|
+
.max(10000)
|
|
135
|
+
.nullable()
|
|
136
|
+
.optional()
|
|
137
|
+
.describe('Required when description_mode is gherkin'),
|
|
138
|
+
steps: z
|
|
139
|
+
.array(z.object({
|
|
140
|
+
step_number: z.number().int().min(1),
|
|
141
|
+
action: z.string().min(1).max(500),
|
|
142
|
+
expected_result: z.string().max(500).nullable().optional(),
|
|
143
|
+
}))
|
|
144
|
+
.min(1)
|
|
145
|
+
.optional()
|
|
146
|
+
.describe('Required when description_mode is steps; order is preserved'),
|
|
119
147
|
priority: z.enum(['Baixa', 'Média', 'Alta']).describe('Priority level'),
|
|
120
148
|
test_status: z.enum(['Automatizado', 'Manual']).describe('Test status'),
|
|
121
149
|
should_automate: z.boolean().describe('Whether this test should be automated'),
|
|
@@ -127,8 +155,28 @@ export function registerTestCaseTools(server) {
|
|
|
127
155
|
.enum(['Ativo', 'Inativo', 'Descontinuado'])
|
|
128
156
|
.default('Ativo')
|
|
129
157
|
.describe('Scenario status (default: Ativo)'),
|
|
130
|
-
notes: z.string().optional().describe('Additional notes'),
|
|
131
|
-
|
|
158
|
+
notes: z.string().max(5000).optional().describe('Additional notes'),
|
|
159
|
+
objective: z.string().max(10000).nullable().optional().describe('Test objective'),
|
|
160
|
+
preconditions: z.string().max(10000).nullable().optional().describe('Preconditions'),
|
|
161
|
+
estimated_time: z
|
|
162
|
+
.number()
|
|
163
|
+
.int()
|
|
164
|
+
.min(0)
|
|
165
|
+
.max(9999)
|
|
166
|
+
.nullable()
|
|
167
|
+
.optional()
|
|
168
|
+
.describe('Estimated time in minutes'),
|
|
169
|
+
tags: z
|
|
170
|
+
.array(z.string().max(50))
|
|
171
|
+
.max(10)
|
|
172
|
+
.optional()
|
|
173
|
+
.describe('Up to 10 tags, each up to 50 characters'),
|
|
174
|
+
assigned_to: z
|
|
175
|
+
.string()
|
|
176
|
+
.uuid()
|
|
177
|
+
.optional()
|
|
178
|
+
.nullable()
|
|
179
|
+
.describe('User UUID to assign the test case to'),
|
|
132
180
|
}),
|
|
133
181
|
}, async (params) => {
|
|
134
182
|
try {
|
|
@@ -150,19 +198,35 @@ export function registerTestCaseTools(server) {
|
|
|
150
198
|
// sentinel_update_test_case
|
|
151
199
|
// =========================================================================
|
|
152
200
|
server.registerTool('sentinel_update_test_case', {
|
|
153
|
-
description: '
|
|
201
|
+
description: 'Partially update all Sentinel test-case fields, including tags and either Gherkin or structured steps. Omitted fields are preserved; pass tags: [] to clear tags. Use sentinel_get_test_case first to see current values.',
|
|
154
202
|
inputSchema: z.object({
|
|
155
203
|
id: z.string().uuid().describe('Test case UUID to update'),
|
|
156
204
|
project_id: z.string().uuid().optional().describe('Project UUID'),
|
|
205
|
+
ct_id: z.string().max(20).optional().describe('Test case identifier'),
|
|
157
206
|
functionality_id: z
|
|
158
207
|
.string()
|
|
159
208
|
.uuid()
|
|
160
209
|
.optional()
|
|
161
210
|
.nullable()
|
|
162
211
|
.describe('Functionality UUID (null to remove)'),
|
|
163
|
-
title: z.string().min(5).max(
|
|
212
|
+
title: z.string().min(5).max(200).optional().describe('Test case title'),
|
|
164
213
|
scenario_type: z.enum(['Positivo', 'Negativo']).optional().describe('Scenario type'),
|
|
165
|
-
|
|
214
|
+
description_mode: z.enum(['gherkin', 'steps']).optional().describe('Test content format'),
|
|
215
|
+
gherkin: z
|
|
216
|
+
.string()
|
|
217
|
+
.max(10000)
|
|
218
|
+
.nullable()
|
|
219
|
+
.optional()
|
|
220
|
+
.describe('Gherkin text; required when switching to gherkin mode'),
|
|
221
|
+
steps: z
|
|
222
|
+
.array(z.object({
|
|
223
|
+
step_number: z.number().int().min(1),
|
|
224
|
+
action: z.string().min(1).max(500),
|
|
225
|
+
expected_result: z.string().max(500).nullable().optional(),
|
|
226
|
+
}))
|
|
227
|
+
.min(1)
|
|
228
|
+
.optional()
|
|
229
|
+
.describe('Structured steps; set description_mode to steps'),
|
|
166
230
|
priority: z.enum(['Baixa', 'Média', 'Alta']).optional().describe('Priority level'),
|
|
167
231
|
test_status: z.enum(['Automatizado', 'Manual']).optional().describe('Test status'),
|
|
168
232
|
should_automate: z.boolean().optional().describe('Whether this test should be automated'),
|
|
@@ -175,7 +239,37 @@ export function registerTestCaseTools(server) {
|
|
|
175
239
|
.enum(['Ativo', 'Inativo', 'Descontinuado'])
|
|
176
240
|
.optional()
|
|
177
241
|
.describe('Scenario status'),
|
|
178
|
-
notes: z
|
|
242
|
+
notes: z
|
|
243
|
+
.string()
|
|
244
|
+
.max(5000)
|
|
245
|
+
.optional()
|
|
246
|
+
.nullable()
|
|
247
|
+
.describe('Additional notes (null to remove)'),
|
|
248
|
+
objective: z
|
|
249
|
+
.string()
|
|
250
|
+
.max(10000)
|
|
251
|
+
.optional()
|
|
252
|
+
.nullable()
|
|
253
|
+
.describe('Test objective (null to clear)'),
|
|
254
|
+
preconditions: z
|
|
255
|
+
.string()
|
|
256
|
+
.max(10000)
|
|
257
|
+
.optional()
|
|
258
|
+
.nullable()
|
|
259
|
+
.describe('Preconditions (null to clear)'),
|
|
260
|
+
estimated_time: z
|
|
261
|
+
.number()
|
|
262
|
+
.int()
|
|
263
|
+
.min(0)
|
|
264
|
+
.max(9999)
|
|
265
|
+
.optional()
|
|
266
|
+
.nullable()
|
|
267
|
+
.describe('Estimated time in minutes (null to clear)'),
|
|
268
|
+
tags: z
|
|
269
|
+
.array(z.string().max(50))
|
|
270
|
+
.max(10)
|
|
271
|
+
.optional()
|
|
272
|
+
.describe('Replace all tags; pass [] to remove all tags'),
|
|
179
273
|
assigned_to: z
|
|
180
274
|
.string()
|
|
181
275
|
.uuid()
|