snow-flow 2.0.2 → 2.0.4

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 (173) hide show
  1. package/{.claude/mcp-config.json → .mcp.json} +13 -12
  2. package/.releaserc.json +47 -0
  3. package/README.md +48 -1
  4. package/package.json +1 -1
  5. package/.claude/claude-settings.json +0 -15
  6. package/.claude/commands/analysis/README.md +0 -9
  7. package/.claude/commands/automation/README.md +0 -9
  8. package/.claude/commands/github/README.md +0 -11
  9. package/.claude/commands/helpers/standard-checkpoint-hooks.sh +0 -179
  10. package/.claude/commands/hooks/README.md +0 -11
  11. package/.claude/commands/monitoring/README.md +0 -9
  12. package/.claude/commands/optimization/README.md +0 -9
  13. package/.claude/commands/training/README.md +0 -9
  14. package/.claude/commands/workflows/README.md +0 -9
  15. package/.claude/config.json +0 -36
  16. package/.claude/helpers/github-setup.sh +0 -28
  17. package/.claude/helpers/quick-start.sh +0 -19
  18. package/.claude/helpers/setup-mcp.sh +0 -18
  19. package/.claude/settings.json +0 -114
  20. package/.claude/settings.local.json +0 -33
  21. package/.claude-flow/metrics/agent-metrics.json +0 -1
  22. package/.claude-flow/metrics/performance.json +0 -9
  23. package/.claude-flow/metrics/system-metrics.json +0 -15986
  24. package/.claude-flow/metrics/task-metrics.json +0 -10
  25. package/.roo/README.md +0 -402
  26. package/.roo/mcp-list.txt +0 -257
  27. package/.roo/mcp.json +0 -32
  28. package/.roo/workflows/basic-tdd.json +0 -32
  29. package/.roomodes +0 -201
  30. package/CLAUDE.md +0 -393
  31. package/bin/snow-flow.js +0 -3
  32. package/dist/cli.js.bak +0 -2052
  33. package/dist/config/snow-flow-config.d.ts +0 -1492
  34. package/dist/config/snow-flow-config.js +0 -938
  35. package/scripts/create-env.js +0 -91
  36. package/scripts/postinstall.js +0 -30
  37. package/scripts/register-mcp-servers.js +0 -210
  38. package/scripts/reset-mcp-servers.js +0 -246
  39. package/scripts/setup-mcp.js +0 -106
  40. package/scripts/update-version.js +0 -31
  41. package/src/agents/README.md +0 -192
  42. package/src/agents/base-agent.ts +0 -251
  43. package/src/agents/coordinator.ts +0 -971
  44. package/src/agents/index.ts +0 -18
  45. package/src/agents/queen-403-handler.ts +0 -230
  46. package/src/agents/queen-agent.ts +0 -1399
  47. package/src/agents/script-writer-agent.ts +0 -769
  48. package/src/agents/security-agent.ts +0 -726
  49. package/src/agents/widget-creator-agent.ts +0 -568
  50. package/src/api/error-handling.ts +0 -1758
  51. package/src/api/natural-language-mapper.ts +0 -630
  52. package/src/api/performance-optimizer.ts +0 -891
  53. package/src/api/transaction-manager.ts +0 -754
  54. package/src/cli/deploy-artifact.ts +0 -304
  55. package/src/cli/snow-flow-cli-integration.ts +0 -434
  56. package/src/cli.ts +0 -4455
  57. package/src/cli.ts.bak +0 -5616
  58. package/src/compliance/advanced-compliance-system.ts +0 -1268
  59. package/src/compliance/index.ts +0 -19
  60. package/src/config/snow-flow-config.ts +0 -1019
  61. package/src/documentation/index.ts +0 -16
  62. package/src/documentation/self-documenting-system.ts +0 -1421
  63. package/src/dynamic-version.ts +0 -44
  64. package/src/healing/index.ts +0 -20
  65. package/src/healing/self-healing-system.ts +0 -1435
  66. package/src/health/README.md +0 -161
  67. package/src/health/system-health.ts +0 -995
  68. package/src/index.ts +0 -60
  69. package/src/intelligence/acl-analyzer.ts +0 -377
  70. package/src/intelligence/auto-resolution-engine.ts +0 -643
  71. package/src/intelligence/gap-analysis-engine.ts +0 -488
  72. package/src/intelligence/manual-instructions-generator.ts +0 -744
  73. package/src/intelligence/mcp-coverage-analyzer.ts +0 -708
  74. package/src/intelligence/multi-pass-requirements-analyzer.ts +0 -603
  75. package/src/intelligence/performance-recommendations-engine.ts +0 -1223
  76. package/src/intelligence/requirements-analyzer.ts +0 -1148
  77. package/src/intelligence/task-analyzer.ts +0 -628
  78. package/src/managers/scope-manager.ts +0 -555
  79. package/src/mcp/advanced/servicenow-advanced-features-mcp.ts +0 -16110
  80. package/src/mcp/base-mcp-server.ts +0 -660
  81. package/src/mcp/http-transport-wrapper.ts +0 -426
  82. package/src/mcp/service-discovery-client.ts +0 -312
  83. package/src/mcp/servicenow-automation-mcp-refactored.ts +0 -678
  84. package/src/mcp/servicenow-automation-mcp.ts +0 -838
  85. package/src/mcp/servicenow-deployment-mcp-refactored.ts +0 -1292
  86. package/src/mcp/servicenow-deployment-mcp.ts +0 -7244
  87. package/src/mcp/servicenow-graph-memory-mcp-refactored.ts +0 -721
  88. package/src/mcp/servicenow-graph-memory-mcp.ts +0 -832
  89. package/src/mcp/servicenow-integration-mcp-refactored.ts +0 -655
  90. package/src/mcp/servicenow-integration-mcp.ts +0 -819
  91. package/src/mcp/servicenow-intelligent-mcp-refactored.ts +0 -977
  92. package/src/mcp/servicenow-intelligent-mcp.ts +0 -4638
  93. package/src/mcp/servicenow-mcp-server.ts +0 -728
  94. package/src/mcp/servicenow-memory-mcp.ts +0 -474
  95. package/src/mcp/servicenow-operations-mcp-refactored.ts +0 -1995
  96. package/src/mcp/servicenow-operations-mcp.ts +0 -3384
  97. package/src/mcp/servicenow-platform-development-mcp-refactored.ts +0 -611
  98. package/src/mcp/servicenow-platform-development-mcp.ts +0 -970
  99. package/src/mcp/servicenow-progressive-indexer.ts +0 -370
  100. package/src/mcp/servicenow-reporting-analytics-mcp-refactored.ts +0 -695
  101. package/src/mcp/servicenow-reporting-analytics-mcp.ts +0 -1123
  102. package/src/mcp/servicenow-security-compliance-mcp-refactored.ts +0 -642
  103. package/src/mcp/servicenow-security-compliance-mcp.ts +0 -1157
  104. package/src/mcp/servicenow-update-set-mcp-refactored.ts +0 -751
  105. package/src/mcp/servicenow-update-set-mcp.ts +0 -811
  106. package/src/mcp/shared/agent-context-provider.ts +0 -365
  107. package/src/mcp/shared/base-mcp-server.ts +0 -2463
  108. package/src/mcp/shared/mcp-memory-manager.ts +0 -540
  109. package/src/mcp/shared/mcp-resource-manager.ts +0 -367
  110. package/src/mcp/snow-flow-mcp.ts +0 -911
  111. package/src/mcp/start-all-mcp-servers.ts +0 -102
  112. package/src/mcp/start-servicenow-mcp.ts +0 -67
  113. package/src/monitoring/enhanced-monitoring-system.ts +0 -1345
  114. package/src/monitoring/performance-tracker.ts +0 -777
  115. package/src/optimization/cost-optimization-engine.ts +0 -1125
  116. package/src/optimization/index.ts +0 -10
  117. package/src/queen/README.md +0 -403
  118. package/src/queen/agent-factory.ts +0 -574
  119. package/src/queen/index.ts +0 -94
  120. package/src/queen/mcp-execution-bridge.ts +0 -681
  121. package/src/queen/neural-learning.ts +0 -319
  122. package/src/queen/parallel-agent-engine.ts +0 -848
  123. package/src/queen/queen-memory-system.ts +0 -490
  124. package/src/queen/queen-memory.ts +0 -456
  125. package/src/queen/servicenow-queen.ts +0 -1029
  126. package/src/queen/types.ts +0 -87
  127. package/src/rollback/smart-rollback-system.ts +0 -866
  128. package/src/schemas/deployment.schema.json +0 -58
  129. package/src/schemas/flow.schema.json +0 -79
  130. package/src/schemas/widget.schema.json +0 -72
  131. package/src/snow-flow-system.ts +0 -541
  132. package/src/sparc/sparc-help.ts +0 -49
  133. package/src/sparc/team-sparc.ts +0 -88
  134. package/src/strategies/global-scope-strategy.ts +0 -736
  135. package/src/templates/base/application.template.json +0 -45
  136. package/src/templates/base/business_rule.template.json +0 -33
  137. package/src/templates/base/script_include.template.json +0 -18
  138. package/src/templates/base/table.template.json +0 -64
  139. package/src/templates/base/widget.template.json +0 -25
  140. package/src/templates/patterns/composite.incident-management.template.json +0 -140
  141. package/src/templates/patterns/widget.dashboard.template.json +0 -238
  142. package/src/templates/patterns/widget.datatable.template.json +0 -292
  143. package/src/testing/integration-test-suite.ts +0 -1276
  144. package/src/types/index.ts +0 -183
  145. package/src/types/neo4j-driver.d.ts +0 -23
  146. package/src/types/servicenow.types.ts +0 -307
  147. package/src/types/snow-flow.types.ts +0 -186
  148. package/src/types/todo.types.ts +0 -70
  149. package/src/utils/action-type-cache.ts +0 -286
  150. package/src/utils/agent-detector.ts +0 -573
  151. package/src/utils/artifact-tracker.ts +0 -379
  152. package/src/utils/dependency-detector.ts +0 -233
  153. package/src/utils/deployment-metadata-handler.ts +0 -518
  154. package/src/utils/error-recovery.ts +0 -680
  155. package/src/utils/logger.ts +0 -60
  156. package/src/utils/mcp-auth-middleware.ts +0 -262
  157. package/src/utils/mcp-config-manager.ts +0 -270
  158. package/src/utils/mcp-server-manager.ts +0 -446
  159. package/src/utils/mcp-tool-registry.ts +0 -298
  160. package/src/utils/migrate-snow-flow.ts +0 -98
  161. package/src/utils/oauth-html-templates.ts +0 -188
  162. package/src/utils/scope-utils.ts +0 -443
  163. package/src/utils/servicenow-client.ts +0 -3321
  164. package/src/utils/servicenow-id-generator.ts +0 -181
  165. package/src/utils/snow-memory-manager.ts +0 -605
  166. package/src/utils/snow-oauth.ts +0 -797
  167. package/src/utils/template-engine.ts +0 -463
  168. package/src/utils/theme-manager.ts +0 -295
  169. package/src/utils/unified-auth-store.ts +0 -222
  170. package/src/utils/update-set-importer.ts +0 -422
  171. package/src/utils/update-set-xml-packager.ts +0 -371
  172. package/src/utils/widget-template-generator.ts +0 -1744
  173. package/src/version.ts +0 -1950
@@ -1,811 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * ServiceNow Update Set Management MCP Server
4
- * Ensures all changes are tracked in Update Sets for safe deployment
5
- */
6
-
7
- import { Server } from '@modelcontextprotocol/sdk/server/index.js';
8
- import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
9
- import {
10
- CallToolRequestSchema,
11
- ErrorCode,
12
- ListToolsRequestSchema,
13
- McpError,
14
- } from '@modelcontextprotocol/sdk/types.js';
15
- import { ServiceNowClient } from '../utils/servicenow-client.js';
16
- import { ServiceNowOAuth } from '../utils/snow-oauth.js';
17
- import { Logger } from '../utils/logger.js';
18
- import { promises as fs } from 'fs';
19
- import { join } from 'path';
20
-
21
- interface UpdateSetSession {
22
- update_set_id: string;
23
- name: string;
24
- description: string;
25
- user_story?: string;
26
- created_at: string;
27
- state: 'in_progress' | 'complete' | 'released';
28
- artifacts: Array<{
29
- type: string;
30
- sys_id: string;
31
- name: string;
32
- created_at: string;
33
- }>;
34
- auto_switched?: boolean;
35
- active_session?: boolean;
36
- }
37
-
38
- class ServiceNowUpdateSetMCP {
39
- private server: Server;
40
- private client: ServiceNowClient;
41
- private oauth: ServiceNowOAuth;
42
- private logger: Logger;
43
- private currentSession: UpdateSetSession | null = null;
44
- private sessionsPath: string;
45
-
46
- constructor() {
47
- this.server = new Server(
48
- {
49
- name: 'servicenow-update-set',
50
- version: '1.0.0',
51
- },
52
- {
53
- capabilities: {
54
- tools: {},
55
- },
56
- }
57
- );
58
-
59
- this.client = new ServiceNowClient();
60
- this.oauth = new ServiceNowOAuth();
61
- this.logger = new Logger('ServiceNowUpdateSetMCP');
62
- this.sessionsPath = join(process.cwd(), 'memory', 'update-set-sessions');
63
-
64
- // Debug: Test credentials on startup
65
- this.testCredentials();
66
-
67
- this.setupHandlers();
68
- this.ensureSessionsDirectory();
69
- }
70
-
71
- /**
72
- * Test credentials on startup
73
- */
74
- private async testCredentials(): Promise<void> {
75
- console.log('🔍 [UPDATE-SET MCP] Testing credentials...');
76
- try {
77
- const credentials = await this.oauth.loadCredentials();
78
- if (credentials) {
79
- console.log('✅ [UPDATE-SET MCP] Credentials loaded successfully');
80
- const isAuth = await this.oauth.isAuthenticated();
81
- console.log(`🔐 [UPDATE-SET MCP] Authentication status: ${isAuth ? '✅ Valid' : '❌ Expired'}`);
82
- } else {
83
- console.log('❌ [UPDATE-SET MCP] No credentials found');
84
- }
85
- } catch (error) {
86
- console.error('❌ [UPDATE-SET MCP] Credential test failed:', error);
87
- }
88
- }
89
-
90
- private async ensureSessionsDirectory() {
91
- try {
92
- await fs.mkdir(this.sessionsPath, { recursive: true });
93
- } catch (error) {
94
- this.logger.error('Failed to create sessions directory', error);
95
- }
96
- }
97
-
98
- private setupHandlers() {
99
- this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
100
- tools: [
101
- {
102
- name: 'snow_update_set_create',
103
- description: 'Create a new Update Set for a user story or feature - ALWAYS use this before making changes',
104
- inputSchema: {
105
- type: 'object',
106
- properties: {
107
- name: {
108
- type: 'string',
109
- description: 'Update Set name (e.g., "STORY-123: Add incident widget")'
110
- },
111
- description: {
112
- type: 'string',
113
- description: 'Detailed description of changes'
114
- },
115
- user_story: {
116
- type: 'string',
117
- description: 'User story or ticket number'
118
- },
119
- release_date: {
120
- type: 'string',
121
- description: 'Target release date (optional)'
122
- },
123
- auto_switch: {
124
- type: 'boolean',
125
- description: 'Automatically switch to the created Update Set (default: true)',
126
- default: true
127
- }
128
- },
129
- required: ['name', 'description']
130
- }
131
- },
132
- {
133
- name: 'snow_update_set_switch',
134
- description: 'Switch to an existing Update Set - use this to continue work on a story',
135
- inputSchema: {
136
- type: 'object',
137
- properties: {
138
- update_set_id: {
139
- type: 'string',
140
- description: 'Update Set sys_id to switch to'
141
- }
142
- },
143
- required: ['update_set_id']
144
- }
145
- },
146
- {
147
- name: 'snow_update_set_current',
148
- description: 'Get the current active Update Set session',
149
- inputSchema: {
150
- type: 'object',
151
- properties: {}
152
- }
153
- },
154
- {
155
- name: 'snow_update_set_list',
156
- description: 'List all Update Sets (in progress and recent)',
157
- inputSchema: {
158
- type: 'object',
159
- properties: {
160
- state: {
161
- type: 'string',
162
- description: 'Filter by state: in_progress, complete, released',
163
- enum: ['in_progress', 'complete', 'released']
164
- },
165
- limit: {
166
- type: 'number',
167
- description: 'Maximum number of results (default: 10)'
168
- }
169
- }
170
- }
171
- },
172
- {
173
- name: 'snow_update_set_complete',
174
- description: 'Mark Update Set as complete and ready for testing',
175
- inputSchema: {
176
- type: 'object',
177
- properties: {
178
- update_set_id: {
179
- type: 'string',
180
- description: 'Update Set sys_id to complete (uses current if not specified)'
181
- },
182
- notes: {
183
- type: 'string',
184
- description: 'Completion notes or testing instructions'
185
- }
186
- }
187
- }
188
- },
189
- {
190
- name: 'snow_update_set_add_artifact',
191
- description: 'Track an artifact in the current Update Set session',
192
- inputSchema: {
193
- type: 'object',
194
- properties: {
195
- type: {
196
- type: 'string',
197
- description: 'Artifact type (widget, flow, script, etc.)'
198
- },
199
- sys_id: {
200
- type: 'string',
201
- description: 'ServiceNow sys_id of the artifact'
202
- },
203
- name: {
204
- type: 'string',
205
- description: 'Artifact name for tracking'
206
- }
207
- },
208
- required: ['type', 'sys_id', 'name']
209
- }
210
- },
211
- {
212
- name: 'snow_update_set_preview',
213
- description: 'Preview all changes in an Update Set',
214
- inputSchema: {
215
- type: 'object',
216
- properties: {
217
- update_set_id: {
218
- type: 'string',
219
- description: 'Update Set sys_id (uses current if not specified)'
220
- }
221
- }
222
- }
223
- },
224
- {
225
- name: 'snow_update_set_export',
226
- description: 'Export Update Set as XML for backup or migration',
227
- inputSchema: {
228
- type: 'object',
229
- properties: {
230
- update_set_id: {
231
- type: 'string',
232
- description: 'Update Set sys_id to export'
233
- },
234
- output_path: {
235
- type: 'string',
236
- description: 'Path to save the XML file'
237
- }
238
- }
239
- }
240
- },
241
- {
242
- name: 'snow_ensure_active_update_set',
243
- description: 'Ensure there is an active Update Set session - creates one automatically if needed',
244
- inputSchema: {
245
- type: 'object',
246
- properties: {
247
- context: {
248
- type: 'string',
249
- description: 'Context for auto-created Update Set (e.g., "widget development", "flow creation")'
250
- },
251
- auto_create: {
252
- type: 'boolean',
253
- description: 'Automatically create Update Set if none exists (default: true)',
254
- default: true
255
- }
256
- }
257
- }
258
- }
259
- ]
260
- }));
261
-
262
- this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
263
- const { name, arguments: args } = request.params;
264
-
265
- try {
266
- // Check authentication for all operations
267
- const isAuthenticated = await this.oauth.isAuthenticated();
268
- if (!isAuthenticated) {
269
- throw new McpError(
270
- ErrorCode.InvalidRequest,
271
- 'Not authenticated. Run "snow-flow auth login" first.'
272
- );
273
- }
274
-
275
- switch (name) {
276
- case 'snow_update_set_create':
277
- return await this.createUpdateSet(args);
278
- case 'snow_update_set_switch':
279
- return await this.switchUpdateSet(args);
280
- case 'snow_update_set_current':
281
- return await this.getCurrentUpdateSet();
282
- case 'snow_update_set_list':
283
- return await this.listUpdateSets(args);
284
- case 'snow_update_set_complete':
285
- return await this.completeUpdateSet(args);
286
- case 'snow_update_set_add_artifact':
287
- return await this.addArtifactToSession(args);
288
- case 'snow_update_set_preview':
289
- return await this.previewUpdateSet(args);
290
- case 'snow_update_set_export':
291
- return await this.exportUpdateSet(args);
292
- case 'snow_ensure_active_update_set':
293
- return await this.ensureActiveUpdateSet(args);
294
- default:
295
- throw new McpError(
296
- ErrorCode.MethodNotFound,
297
- `Unknown tool: ${name}`
298
- );
299
- }
300
- } catch (error) {
301
- if (error instanceof McpError) throw error;
302
-
303
- this.logger.error('Tool execution failed', { tool: name, error });
304
- throw new McpError(
305
- ErrorCode.InternalError,
306
- `Failed to execute ${name}: ${error instanceof Error ? error.message : String(error)}`
307
- );
308
- }
309
- });
310
- }
311
-
312
- private async createUpdateSet(args: any) {
313
- try {
314
- this.logger.info('Creating new Update Set', args);
315
-
316
- // Create Update Set in ServiceNow
317
- const response = await this.client.createUpdateSet({
318
- name: args.name,
319
- description: args.description,
320
- release_date: args.release_date,
321
- state: 'in_progress'
322
- });
323
-
324
- if (!response.success) {
325
- throw new Error(response.error || 'Failed to create Update Set');
326
- }
327
-
328
- // Validate response structure
329
- if (!response.data || !response.data.sys_id) {
330
- throw new Error(`Invalid Update Set response: missing data or sys_id. Response: ${JSON.stringify(response)}`);
331
- }
332
-
333
- // Auto-switch to Update Set if requested (default: true)
334
- const autoSwitch = args.auto_switch !== false;
335
- let switchedToUpdateSet = false;
336
-
337
- if (autoSwitch) {
338
- await this.client.setCurrentUpdateSet(response.data.sys_id);
339
- switchedToUpdateSet = true;
340
-
341
- // Create local session
342
- this.currentSession = {
343
- update_set_id: response.data.sys_id,
344
- name: args.name,
345
- description: args.description,
346
- user_story: args.user_story,
347
- created_at: new Date().toISOString(),
348
- state: 'in_progress',
349
- artifacts: [],
350
- auto_switched: true,
351
- active_session: true
352
- };
353
-
354
- // Save session
355
- await this.saveSession();
356
- }
357
-
358
- const credentials = await this.oauth.loadCredentials();
359
- const updateSetUrl = `https://${credentials?.instance}/sys_update_set.do?sys_id=${response.data.sys_id}`;
360
-
361
- return {
362
- content: [{
363
- type: 'text',
364
- text: `✅ **Update Set Created Successfully!**
365
-
366
- 📋 **Details:**
367
- - **Name**: ${args.name}
368
- - **ID**: ${response.data.sys_id}
369
- - **Description**: ${args.description}
370
- ${args.user_story ? `- **User Story**: ${args.user_story}` : ''}
371
- - **State**: In Progress
372
- ${switchedToUpdateSet ? '- **Auto-Switched**: ✅ Active session ready' : '- **Auto-Switch**: ❌ Manual switch required'}
373
-
374
- 🔗 **View in ServiceNow**: ${updateSetUrl}
375
-
376
- ${switchedToUpdateSet ? `⚡ **Current Session Active**
377
- All subsequent changes will be automatically tracked in this Update Set.` : `⚠️ **Manual Switch Required**
378
- Use \`snow_update_set_switch\` to activate this Update Set before making changes.`}
379
-
380
- 💡 **Best Practices:**
381
- 1. Keep Update Sets focused on a single story/feature
382
- 2. Test thoroughly before marking complete
383
- 3. Document all changes in the description
384
- 4. Use meaningful names that include story numbers`
385
- }]
386
- };
387
- } catch (error) {
388
- this.logger.error('Failed to create Update Set', error);
389
- throw error;
390
- }
391
- }
392
-
393
- private async switchUpdateSet(args: any) {
394
- try {
395
- this.logger.info('Switching to Update Set', { update_set_id: args.update_set_id });
396
-
397
- // Set as current in ServiceNow
398
- await this.client.setCurrentUpdateSet(args.update_set_id);
399
-
400
- // Load or create session
401
- const sessionFile = join(this.sessionsPath, `${args.update_set_id}.json`);
402
- try {
403
- const sessionData = await fs.readFile(sessionFile, 'utf-8');
404
- this.currentSession = JSON.parse(sessionData);
405
- } catch {
406
- // Create new session for existing Update Set
407
- const updateSet = await this.client.getUpdateSet(args.update_set_id);
408
- this.currentSession = {
409
- update_set_id: args.update_set_id,
410
- name: updateSet.data.name,
411
- description: updateSet.data.description,
412
- created_at: updateSet.data.sys_created_on,
413
- state: updateSet.data.state,
414
- artifacts: []
415
- };
416
- await this.saveSession();
417
- }
418
-
419
- return {
420
- content: [{
421
- type: 'text',
422
- text: `✅ **Switched to Update Set**
423
-
424
- 📋 **Current Update Set:**
425
- - **Name**: ${this.currentSession?.name || 'Unknown'}
426
- - **ID**: ${this.currentSession?.update_set_id || 'Unknown'}
427
- - **State**: ${this.currentSession?.state || 'Unknown'}
428
- - **Artifacts Tracked**: ${this.currentSession?.artifacts.length || 0}
429
-
430
- All subsequent changes will be tracked in this Update Set.`
431
- }]
432
- };
433
- } catch (error) {
434
- this.logger.error('Failed to switch Update Set', error);
435
- throw error;
436
- }
437
- }
438
-
439
- private async getCurrentUpdateSet() {
440
- if (!this.currentSession) {
441
- // Try to get from ServiceNow
442
- const current = await this.client.getCurrentUpdateSet();
443
- if (current.success && current.data) {
444
- return {
445
- content: [{
446
- type: 'text',
447
- text: `📋 **Current Update Set (from ServiceNow):**
448
- - **Name**: ${current.data.name}
449
- - **ID**: ${current.data.sys_id}
450
- - **State**: ${current.data.state}
451
-
452
- ⚠️ **Note**: No local session active. Use \`snow_update_set_switch\` to activate session tracking.`
453
- }]
454
- };
455
- }
456
-
457
- return {
458
- content: [{
459
- type: 'text',
460
- text: '❌ **No Update Set Active**\n\nUse `snow_update_set_create` to create a new Update Set for your changes.'
461
- }]
462
- };
463
- }
464
-
465
- return {
466
- content: [{
467
- type: 'text',
468
- text: `📋 **Current Update Set Session:**
469
- - **Name**: ${this.currentSession.name}
470
- - **ID**: ${this.currentSession.update_set_id}
471
- - **User Story**: ${this.currentSession.user_story || 'Not specified'}
472
- - **State**: ${this.currentSession.state}
473
- - **Created**: ${new Date(this.currentSession.created_at).toLocaleString()}
474
- - **Artifacts**: ${this.currentSession.artifacts.length}
475
-
476
- 📦 **Tracked Artifacts:**
477
- ${this.currentSession.artifacts.length > 0
478
- ? this.currentSession.artifacts.map(a => `- ${a.type}: ${a.name}`).join('\n')
479
- : '- No artifacts tracked yet'}`
480
- }]
481
- };
482
- }
483
-
484
- private async listUpdateSets(args: any) {
485
- try {
486
- const response = await this.client.listUpdateSets({
487
- state: args.state,
488
- limit: args.limit || 10
489
- });
490
-
491
- if (!response.success) {
492
- throw new Error(response.error || 'Failed to list Update Sets');
493
- }
494
-
495
- const updateSets = response.data || [];
496
- const credentials = await this.oauth.loadCredentials();
497
-
498
- return {
499
- content: [{
500
- type: 'text',
501
- text: `📋 **Update Sets** (${updateSets.length} found)
502
-
503
- ${updateSets.map((us: any) => `
504
- **${us.name}**
505
- - ID: ${us.sys_id}
506
- - State: ${us.state}
507
- - Created: ${new Date(us.sys_created_on).toLocaleDateString()}
508
- - Created By: ${us.sys_created_by}
509
- - 🔗 [View](https://${credentials?.instance}/sys_update_set.do?sys_id=${us.sys_id})
510
- `).join('\n---\n')}
511
-
512
- 💡 Use \`snow_update_set_switch\` to activate any Update Set.`
513
- }]
514
- };
515
- } catch (error) {
516
- this.logger.error('Failed to list Update Sets', error);
517
- throw error;
518
- }
519
- }
520
-
521
- private async completeUpdateSet(args: any) {
522
- try {
523
- const updateSetId = args.update_set_id || this.currentSession?.update_set_id;
524
- if (!updateSetId) {
525
- throw new Error('No Update Set specified and no active session');
526
- }
527
-
528
- // Mark as complete in ServiceNow
529
- const response = await this.client.completeUpdateSet(updateSetId, args.notes);
530
-
531
- if (!response.success) {
532
- throw new Error(response.error || 'Failed to complete Update Set');
533
- }
534
-
535
- // Update session
536
- if (this.currentSession && this.currentSession.update_set_id === updateSetId) {
537
- this.currentSession.state = 'complete';
538
- await this.saveSession();
539
- }
540
-
541
- const credentials = await this.oauth.loadCredentials();
542
- const updateSetUrl = `https://${credentials?.instance}/sys_update_set.do?sys_id=${updateSetId}`;
543
-
544
- return {
545
- content: [{
546
- type: 'text',
547
- text: `✅ **Update Set Completed!**
548
-
549
- 📋 **Summary:**
550
- - **Name**: ${response.data.name}
551
- - **ID**: ${updateSetId}
552
- - **State**: Complete
553
- ${args.notes ? `- **Notes**: ${args.notes}` : ''}
554
-
555
- 🔗 **View in ServiceNow**: ${updateSetUrl}
556
-
557
- 📝 **Next Steps:**
558
- 1. Test all changes thoroughly
559
- 2. Get peer review if required
560
- 3. Move to target instance when ready
561
- 4. Create new Update Set for next feature
562
-
563
- ⚠️ **Important**: This Update Set is now locked. Create a new one for additional changes.`
564
- }]
565
- };
566
- } catch (error) {
567
- this.logger.error('Failed to complete Update Set', error);
568
- throw error;
569
- }
570
- }
571
-
572
- private async addArtifactToSession(args: any) {
573
- // Intelligent session management - auto-create session if none exists
574
- if (!this.currentSession) {
575
- this.logger.info('No active session found, auto-creating Update Set session');
576
-
577
- try {
578
- // Create a default update set with smart naming
579
- const defaultName = `AUTO-${new Date().toISOString().split('T')[0]}-${Date.now().toString().slice(-6)}`;
580
- const defaultDescription = `Auto-created Update Set for ${args.type} deployment: ${args.name}`;
581
-
582
- await this.createUpdateSet({
583
- name: defaultName,
584
- description: defaultDescription,
585
- user_story: 'Automated artifact deployment'
586
- });
587
-
588
- this.logger.info('Auto-created Update Set session', {
589
- name: defaultName,
590
- updateSetId: this.currentSession?.update_set_id
591
- });
592
-
593
- } catch (error) {
594
- this.logger.error('Failed to auto-create Update Set session', { error });
595
- throw new Error(`No active Update Set session and auto-creation failed: ${error instanceof Error ? error.message : String(error)}`);
596
- }
597
- }
598
-
599
- // Add artifact to session
600
- this.currentSession.artifacts.push({
601
- type: args.type,
602
- sys_id: args.sys_id,
603
- name: args.name,
604
- created_at: new Date().toISOString()
605
- });
606
-
607
- await this.saveSession();
608
-
609
- const autoCreatedNotice = this.currentSession.name.startsWith('AUTO-')
610
- ? `\n🔄 **Smart Session Management:**\n- ✅ Update Set session auto-created (no manual setup required)\n- 📝 Naming: ${this.currentSession.name}\n- 🎯 Intelligent deployment tracking enabled\n`
611
- : '';
612
-
613
- return {
614
- content: [{
615
- type: 'text',
616
- text: `✅ **Artifact Added to Update Set Session**
617
-
618
- 📦 **Artifact Details:**
619
- - **Type**: ${args.type}
620
- - **Name**: ${args.name}
621
- - **Sys ID**: ${args.sys_id}
622
- ${autoCreatedNotice}
623
- 📋 **Current Session:**
624
- - **Update Set**: ${this.currentSession.name}
625
- - **Total Artifacts**: ${this.currentSession.artifacts.length}
626
- - **Session ID**: ${this.currentSession.update_set_id}`
627
- }]
628
- };
629
- }
630
-
631
- private async previewUpdateSet(args: any) {
632
- try {
633
- const updateSetId = args.update_set_id || this.currentSession?.update_set_id;
634
- if (!updateSetId) {
635
- throw new Error('No Update Set specified and no active session');
636
- }
637
-
638
- // Get Update Set details and changes
639
- const response = await this.client.previewUpdateSet(updateSetId);
640
-
641
- if (!response.success) {
642
- throw new Error(response.error || 'Failed to preview Update Set');
643
- }
644
-
645
- const changes = response.data.changes || [];
646
- const credentials = await this.oauth.loadCredentials();
647
-
648
- return {
649
- content: [{
650
- type: 'text',
651
- text: `📋 **Update Set Preview**
652
-
653
- **Update Set**: ${response.data.name}
654
- **Total Changes**: ${changes.length}
655
-
656
- 📦 **Changes by Type:**
657
- ${this.groupChangesByType(changes)}
658
-
659
- 📝 **Change Details:**
660
- ${changes.slice(0, 20).map((change: any) => `
661
- - **${change.type}**: ${change.target_name}
662
- - Action: ${change.action}
663
- - Table: ${change.target_table}
664
- - Updated: ${new Date(change.sys_updated_on).toLocaleString()}
665
- `).join('\n')}
666
- ${changes.length > 20 ? `\n... and ${changes.length - 20} more changes` : ''}
667
-
668
- 🔗 **Full Preview**: https://${credentials?.instance}/sys_update_set_preview.do?sysparm_set=${updateSetId}`
669
- }]
670
- };
671
- } catch (error) {
672
- this.logger.error('Failed to preview Update Set', error);
673
- throw error;
674
- }
675
- }
676
-
677
- private async exportUpdateSet(args: any) {
678
- try {
679
- const updateSetId = args.update_set_id;
680
- if (!updateSetId) {
681
- throw new Error('Update Set ID is required for export');
682
- }
683
-
684
- // Export Update Set as XML
685
- const response = await this.client.exportUpdateSet(updateSetId);
686
-
687
- if (!response.success) {
688
- throw new Error(response.error || 'Failed to export Update Set');
689
- }
690
-
691
- // Save to file
692
- const outputPath = args.output_path || join(process.cwd(), 'exports', `update_set_${updateSetId}_${Date.now()}.xml`);
693
- await fs.mkdir(join(process.cwd(), 'exports'), { recursive: true });
694
- await fs.writeFile(outputPath, response.data.xml);
695
-
696
- return {
697
- content: [{
698
- type: 'text',
699
- text: `✅ **Update Set Exported Successfully!**
700
-
701
- 📦 **Export Details:**
702
- - **Update Set**: ${response.data.name}
703
- - **File Size**: ${(response.data.xml.length / 1024).toFixed(2)} KB
704
- - **Changes**: ${response.data.change_count}
705
- - **Saved to**: ${outputPath}
706
-
707
- 💡 **Usage:**
708
- - Import this XML file to another ServiceNow instance
709
- - Keep as backup before major changes
710
- - Share with team members for review`
711
- }]
712
- };
713
- } catch (error) {
714
- this.logger.error('Failed to export Update Set', error);
715
- throw error;
716
- }
717
- }
718
-
719
- private async ensureActiveUpdateSet(args: any) {
720
- try {
721
- this.logger.info('Ensuring active Update Set session', args);
722
-
723
- // Check if we already have an active session
724
- if (this.currentSession?.state === 'in_progress') {
725
- return {
726
- content: [{
727
- type: 'text',
728
- text: `✅ **Active Update Set Session Found**
729
-
730
- 📋 **Current Session:**
731
- - **Name**: ${this.currentSession.name}
732
- - **ID**: ${this.currentSession.update_set_id}
733
- - **Created**: ${new Date(this.currentSession.created_at).toLocaleString()}
734
- - **Artifacts**: ${this.currentSession.artifacts?.length || 0} tracked
735
-
736
- ⚡ **Ready for Deployment**
737
- All subsequent changes will be tracked in this Update Set.`
738
- }]
739
- };
740
- }
741
-
742
- // Auto-create if requested (default: true)
743
- const autoCreate = args.auto_create !== false;
744
- if (autoCreate) {
745
- const context = args.context || 'automated deployment';
746
- const timestamp = new Date().toISOString().slice(0, 16).replace('T', ' ');
747
-
748
- return await this.createUpdateSet({
749
- name: `Auto-${context} (${timestamp})`,
750
- description: `Automatically created Update Set for ${context}`,
751
- user_story: 'Automated deployment workflow',
752
- auto_switch: true
753
- });
754
- } else {
755
- return {
756
- content: [{
757
- type: 'text',
758
- text: `❌ **No Active Update Set Session**
759
-
760
- ⚠️ **Manual Creation Required**
761
- Create an Update Set before making changes:
762
-
763
- \`\`\`
764
- snow_update_set_create({
765
- name: "Your feature name",
766
- description: "Description of changes"
767
- })
768
- \`\`\`
769
-
770
- 💡 **Why Update Sets Matter:**
771
- - Track all changes for rollback capability
772
- - Organize related changes together
773
- - Required for deployment to other environments`
774
- }]
775
- };
776
- }
777
- } catch (error) {
778
- this.logger.error('Failed to ensure active Update Set', error);
779
- throw error;
780
- }
781
- }
782
-
783
- private async saveSession() {
784
- if (!this.currentSession) return;
785
-
786
- const sessionFile = join(this.sessionsPath, `${this.currentSession.update_set_id}.json`);
787
- await fs.writeFile(sessionFile, JSON.stringify(this.currentSession, null, 2));
788
- }
789
-
790
- private groupChangesByType(changes: any[]): string {
791
- const grouped = changes.reduce((acc: any, change: any) => {
792
- const type = change.type || 'Other';
793
- acc[type] = (acc[type] || 0) + 1;
794
- return acc;
795
- }, {});
796
-
797
- return Object.entries(grouped)
798
- .sort((a: any, b: any) => b[1] - a[1])
799
- .map(([type, count]) => `- ${type}: ${count}`)
800
- .join('\n');
801
- }
802
-
803
- async run() {
804
- const transport = new StdioServerTransport();
805
- await this.server.connect(transport);
806
- this.logger.info('ServiceNow Update Set MCP Server running on stdio');
807
- }
808
- }
809
-
810
- const server = new ServiceNowUpdateSetMCP();
811
- server.run().catch(console.error);