snow-flow 1.4.49 → 2.0.0

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 (595) hide show
  1. package/.claude/helpers/github-setup.sh +28 -0
  2. package/.claude/helpers/quick-start.sh +19 -0
  3. package/.claude/helpers/setup-mcp.sh +18 -0
  4. package/.claude/settings.local.json +33 -0
  5. package/.claude-flow/metrics/system-metrics.json +1992 -0
  6. package/.env.example +21 -0
  7. package/.roo/README.md +402 -0
  8. package/.roo/mcp-list.txt +257 -0
  9. package/.roo/mcp.json +32 -0
  10. package/.roo/workflows/basic-tdd.json +32 -0
  11. package/.roomodes +201 -0
  12. package/README.md +114 -628
  13. package/activate-mcp.sh +15 -0
  14. package/dist/cli.js.bak +2052 -0
  15. package/manual-register-mcp.js +134 -0
  16. package/mcp-wrapper.sh +12 -0
  17. package/package.json +2 -2
  18. package/scripts/create-env.js +6 -1
  19. package/scripts/reset-mcp-servers.js +246 -0
  20. package/scripts/update-version.js +31 -0
  21. package/src/agents/README.md +192 -0
  22. package/src/agents/base-agent.ts +251 -0
  23. package/src/agents/coordinator.ts +971 -0
  24. package/src/agents/index.ts +18 -0
  25. package/src/agents/queen-403-handler.ts +230 -0
  26. package/src/agents/queen-agent.ts +1399 -0
  27. package/src/agents/script-writer-agent.ts +769 -0
  28. package/src/agents/security-agent.ts +726 -0
  29. package/src/agents/widget-creator-agent.ts +568 -0
  30. package/src/api/error-handling.ts +1758 -0
  31. package/src/api/natural-language-mapper.ts +630 -0
  32. package/src/api/performance-optimizer.ts +891 -0
  33. package/src/api/transaction-manager.ts +754 -0
  34. package/src/cli/deploy-artifact.ts +304 -0
  35. package/src/cli/snow-flow-cli-integration.ts +434 -0
  36. package/src/cli.ts +4455 -0
  37. package/src/cli.ts.bak +5616 -0
  38. package/src/compliance/advanced-compliance-system.ts +1268 -0
  39. package/src/compliance/index.ts +19 -0
  40. package/src/config/snow-flow-config.ts +1019 -0
  41. package/src/documentation/index.ts +16 -0
  42. package/src/documentation/self-documenting-system.ts +1421 -0
  43. package/src/dynamic-version.ts +44 -0
  44. package/src/healing/index.ts +20 -0
  45. package/src/healing/self-healing-system.ts +1435 -0
  46. package/src/health/README.md +161 -0
  47. package/src/health/system-health.ts +995 -0
  48. package/src/index.ts +60 -0
  49. package/src/intelligence/acl-analyzer.ts +377 -0
  50. package/src/intelligence/auto-resolution-engine.ts +643 -0
  51. package/src/intelligence/gap-analysis-engine.ts +488 -0
  52. package/src/intelligence/manual-instructions-generator.ts +744 -0
  53. package/src/intelligence/mcp-coverage-analyzer.ts +708 -0
  54. package/src/intelligence/multi-pass-requirements-analyzer.ts +603 -0
  55. package/src/intelligence/performance-recommendations-engine.ts +1223 -0
  56. package/src/intelligence/requirements-analyzer.ts +1148 -0
  57. package/src/intelligence/task-analyzer.ts +628 -0
  58. package/src/managers/scope-manager.ts +555 -0
  59. package/src/mcp/advanced/servicenow-advanced-features-mcp.ts +16110 -0
  60. package/src/mcp/base-mcp-server.ts +660 -0
  61. package/src/mcp/http-transport-wrapper.ts +426 -0
  62. package/src/mcp/service-discovery-client.ts +312 -0
  63. package/src/mcp/servicenow-automation-mcp-refactored.ts +678 -0
  64. package/src/mcp/servicenow-automation-mcp.ts +838 -0
  65. package/src/mcp/servicenow-deployment-mcp-refactored.ts +1292 -0
  66. package/src/mcp/servicenow-deployment-mcp.ts +7244 -0
  67. package/src/mcp/servicenow-graph-memory-mcp-refactored.ts +721 -0
  68. package/src/mcp/servicenow-graph-memory-mcp.ts +832 -0
  69. package/src/mcp/servicenow-integration-mcp-refactored.ts +655 -0
  70. package/src/mcp/servicenow-integration-mcp.ts +819 -0
  71. package/src/mcp/servicenow-intelligent-mcp-refactored.ts +977 -0
  72. package/src/mcp/servicenow-intelligent-mcp.ts +4638 -0
  73. package/src/mcp/servicenow-mcp-server.ts +728 -0
  74. package/src/mcp/servicenow-memory-mcp.ts +474 -0
  75. package/src/mcp/servicenow-operations-mcp-refactored.ts +1995 -0
  76. package/src/mcp/servicenow-operations-mcp.ts +3384 -0
  77. package/src/mcp/servicenow-platform-development-mcp-refactored.ts +611 -0
  78. package/src/mcp/servicenow-platform-development-mcp.ts +970 -0
  79. package/src/mcp/servicenow-progressive-indexer.ts +370 -0
  80. package/src/mcp/servicenow-reporting-analytics-mcp-refactored.ts +695 -0
  81. package/src/mcp/servicenow-reporting-analytics-mcp.ts +1123 -0
  82. package/src/mcp/servicenow-security-compliance-mcp-refactored.ts +642 -0
  83. package/src/mcp/servicenow-security-compliance-mcp.ts +1157 -0
  84. package/src/mcp/servicenow-update-set-mcp-refactored.ts +751 -0
  85. package/src/mcp/servicenow-update-set-mcp.ts +811 -0
  86. package/src/mcp/shared/agent-context-provider.ts +365 -0
  87. package/src/mcp/shared/base-mcp-server.ts +2463 -0
  88. package/src/mcp/shared/mcp-memory-manager.ts +540 -0
  89. package/src/mcp/shared/mcp-resource-manager.ts +367 -0
  90. package/src/mcp/snow-flow-mcp.ts +911 -0
  91. package/src/mcp/start-all-mcp-servers.ts +102 -0
  92. package/src/mcp/start-servicenow-mcp.ts +67 -0
  93. package/src/monitoring/enhanced-monitoring-system.ts +1345 -0
  94. package/src/monitoring/performance-tracker.ts +777 -0
  95. package/src/optimization/cost-optimization-engine.ts +1125 -0
  96. package/src/optimization/index.ts +10 -0
  97. package/src/queen/README.md +403 -0
  98. package/src/queen/agent-factory.ts +574 -0
  99. package/src/queen/index.ts +94 -0
  100. package/src/queen/mcp-execution-bridge.ts +681 -0
  101. package/src/queen/neural-learning.ts +319 -0
  102. package/src/queen/parallel-agent-engine.ts +848 -0
  103. package/src/queen/queen-memory-system.ts +490 -0
  104. package/src/queen/queen-memory.ts +456 -0
  105. package/src/queen/servicenow-queen.ts +1029 -0
  106. package/src/queen/types.ts +87 -0
  107. package/src/rollback/smart-rollback-system.ts +866 -0
  108. package/src/schemas/deployment.schema.json +58 -0
  109. package/src/schemas/flow.schema.json +79 -0
  110. package/src/schemas/widget.schema.json +72 -0
  111. package/src/snow-flow-system.ts +541 -0
  112. package/src/sparc/sparc-help.ts +49 -0
  113. package/src/sparc/team-sparc.ts +88 -0
  114. package/src/strategies/global-scope-strategy.ts +736 -0
  115. package/src/templates/base/application.template.json +45 -0
  116. package/src/templates/base/business_rule.template.json +33 -0
  117. package/src/templates/base/script_include.template.json +18 -0
  118. package/src/templates/base/table.template.json +64 -0
  119. package/src/templates/base/widget.template.json +25 -0
  120. package/src/templates/patterns/composite.incident-management.template.json +140 -0
  121. package/src/templates/patterns/widget.dashboard.template.json +238 -0
  122. package/src/templates/patterns/widget.datatable.template.json +292 -0
  123. package/src/testing/integration-test-suite.ts +1276 -0
  124. package/src/types/index.ts +183 -0
  125. package/src/types/neo4j-driver.d.ts +23 -0
  126. package/src/types/servicenow.types.ts +307 -0
  127. package/src/types/snow-flow.types.ts +186 -0
  128. package/src/types/todo.types.ts +70 -0
  129. package/src/utils/action-type-cache.ts +286 -0
  130. package/src/utils/agent-detector.ts +573 -0
  131. package/src/utils/artifact-tracker.ts +379 -0
  132. package/src/utils/dependency-detector.ts +233 -0
  133. package/src/utils/deployment-metadata-handler.ts +518 -0
  134. package/src/utils/error-recovery.ts +680 -0
  135. package/src/utils/logger.ts +60 -0
  136. package/src/utils/mcp-auth-middleware.ts +262 -0
  137. package/src/utils/mcp-config-manager.ts +270 -0
  138. package/src/utils/mcp-server-manager.ts +446 -0
  139. package/src/utils/mcp-tool-registry.ts +298 -0
  140. package/src/utils/migrate-snow-flow.ts +98 -0
  141. package/src/utils/oauth-html-templates.ts +188 -0
  142. package/src/utils/scope-utils.ts +443 -0
  143. package/src/utils/servicenow-client.ts +3321 -0
  144. package/src/utils/servicenow-id-generator.ts +181 -0
  145. package/src/utils/snow-memory-manager.ts +605 -0
  146. package/src/utils/snow-oauth.ts +797 -0
  147. package/src/utils/template-engine.ts +463 -0
  148. package/src/utils/theme-manager.ts +295 -0
  149. package/src/utils/unified-auth-store.ts +222 -0
  150. package/src/utils/update-set-importer.ts +422 -0
  151. package/src/utils/update-set-xml-packager.ts +371 -0
  152. package/src/utils/widget-template-generator.ts +1744 -0
  153. package/src/version.ts +1950 -0
  154. package/.claude/commands/memory/README.md +0 -9
  155. package/dist/agents/app-creator.agent.d.ts.map +0 -1
  156. package/dist/agents/app-creator.agent.js.map +0 -1
  157. package/dist/agents/base/base-snow-agent.d.ts.map +0 -1
  158. package/dist/agents/base/base-snow-agent.js.map +0 -1
  159. package/dist/agents/base-agent.d.ts.map +0 -1
  160. package/dist/agents/base-agent.js.map +0 -1
  161. package/dist/agents/base-snow-agent.d.ts.map +0 -1
  162. package/dist/agents/base-snow-agent.js.map +0 -1
  163. package/dist/agents/coordinator.d.ts.map +0 -1
  164. package/dist/agents/coordinator.js.map +0 -1
  165. package/dist/agents/flow-builder-agent.d.ts.map +0 -1
  166. package/dist/agents/flow-builder-agent.js.map +0 -1
  167. package/dist/agents/index.d.ts.map +0 -1
  168. package/dist/agents/index.js.map +0 -1
  169. package/dist/agents/queen-403-handler.d.ts.map +0 -1
  170. package/dist/agents/queen-403-handler.js.map +0 -1
  171. package/dist/agents/queen-agent-example.d.ts.map +0 -1
  172. package/dist/agents/queen-agent-example.js.map +0 -1
  173. package/dist/agents/queen-agent.d.ts.map +0 -1
  174. package/dist/agents/queen-agent.js.map +0 -1
  175. package/dist/agents/queen-agent.test.d.ts.map +0 -1
  176. package/dist/agents/queen-agent.test.js.map +0 -1
  177. package/dist/agents/script-generator.agent.d.ts.map +0 -1
  178. package/dist/agents/script-generator.agent.js.map +0 -1
  179. package/dist/agents/script-writer-agent.d.ts.map +0 -1
  180. package/dist/agents/script-writer-agent.js.map +0 -1
  181. package/dist/agents/security-agent.d.ts.map +0 -1
  182. package/dist/agents/security-agent.js.map +0 -1
  183. package/dist/agents/specialists/automation-specialist.agent.d.ts.map +0 -1
  184. package/dist/agents/specialists/automation-specialist.agent.js.map +0 -1
  185. package/dist/agents/specialists/data-specialist.agent.d.ts.map +0 -1
  186. package/dist/agents/specialists/data-specialist.agent.js.map +0 -1
  187. package/dist/agents/specialists/integration-specialist.agent.d.ts.map +0 -1
  188. package/dist/agents/specialists/integration-specialist.agent.js.map +0 -1
  189. package/dist/agents/specialists/reporting-specialist.agent.d.ts.map +0 -1
  190. package/dist/agents/specialists/reporting-specialist.agent.js.map +0 -1
  191. package/dist/agents/specialists/security-specialist.agent.d.ts.map +0 -1
  192. package/dist/agents/specialists/security-specialist.agent.js.map +0 -1
  193. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.d.ts.map +0 -1
  194. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.js.map +0 -1
  195. package/dist/agents/teams/base-team.d.ts.map +0 -1
  196. package/dist/agents/teams/base-team.js.map +0 -1
  197. package/dist/agents/teams/team-types.d.ts.map +0 -1
  198. package/dist/agents/teams/team-types.js.map +0 -1
  199. package/dist/agents/teams/widget/widget-architect.agent.d.ts.map +0 -1
  200. package/dist/agents/teams/widget/widget-architect.agent.js.map +0 -1
  201. package/dist/agents/teams/widget/widget-backend.agent.d.ts.map +0 -1
  202. package/dist/agents/teams/widget/widget-backend.agent.js.map +0 -1
  203. package/dist/agents/teams/widget/widget-frontend.agent.d.ts.map +0 -1
  204. package/dist/agents/teams/widget/widget-frontend.agent.js.map +0 -1
  205. package/dist/agents/teams/widget/widget-platform.agent.d.ts.map +0 -1
  206. package/dist/agents/teams/widget/widget-platform.agent.js.map +0 -1
  207. package/dist/agents/teams/widget/widget-uiux.agent.d.ts.map +0 -1
  208. package/dist/agents/teams/widget/widget-uiux.agent.js.map +0 -1
  209. package/dist/agents/test-agent.d.ts.map +0 -1
  210. package/dist/agents/test-agent.js.map +0 -1
  211. package/dist/agents/test-agents.d.ts.map +0 -1
  212. package/dist/agents/test-agents.js.map +0 -1
  213. package/dist/agents/ui-builder.agent.d.ts.map +0 -1
  214. package/dist/agents/ui-builder.agent.js.map +0 -1
  215. package/dist/agents/widget-builder.agent.d.ts.map +0 -1
  216. package/dist/agents/widget-builder.agent.js.map +0 -1
  217. package/dist/agents/widget-creator-agent.d.ts.map +0 -1
  218. package/dist/agents/widget-creator-agent.js.map +0 -1
  219. package/dist/agents/workflow-designer.agent.d.ts.map +0 -1
  220. package/dist/agents/workflow-designer.agent.js.map +0 -1
  221. package/dist/api/error-handling.d.ts.map +0 -1
  222. package/dist/api/error-handling.js.map +0 -1
  223. package/dist/api/flow-designer-api.d.ts.map +0 -1
  224. package/dist/api/flow-designer-api.js.map +0 -1
  225. package/dist/api/natural-language-mapper.d.ts.map +0 -1
  226. package/dist/api/natural-language-mapper.js.map +0 -1
  227. package/dist/api/performance-optimizer.d.ts.map +0 -1
  228. package/dist/api/performance-optimizer.js.map +0 -1
  229. package/dist/api/transaction-manager.d.ts.map +0 -1
  230. package/dist/api/transaction-manager.js.map +0 -1
  231. package/dist/assembly/team-assembler.d.ts.map +0 -1
  232. package/dist/assembly/team-assembler.js.map +0 -1
  233. package/dist/cli/deploy-artifact.d.ts.map +0 -1
  234. package/dist/cli/deploy-artifact.js.map +0 -1
  235. package/dist/cli/snow-flow-cli-integration.d.ts.map +0 -1
  236. package/dist/cli/snow-flow-cli-integration.js.map +0 -1
  237. package/dist/cli.d.ts.map +0 -1
  238. package/dist/cli.js.map +0 -1
  239. package/dist/compliance/advanced-compliance-system.d.ts.map +0 -1
  240. package/dist/compliance/advanced-compliance-system.js.map +0 -1
  241. package/dist/compliance/index.d.ts.map +0 -1
  242. package/dist/compliance/index.js.map +0 -1
  243. package/dist/config/snow-flow-config.d.ts.map +0 -1
  244. package/dist/config/snow-flow-config.js.map +0 -1
  245. package/dist/documentation/index.d.ts.map +0 -1
  246. package/dist/documentation/index.js.map +0 -1
  247. package/dist/documentation/self-documenting-system.d.ts.map +0 -1
  248. package/dist/documentation/self-documenting-system.js.map +0 -1
  249. package/dist/dynamic-version.d.ts.map +0 -1
  250. package/dist/dynamic-version.js.map +0 -1
  251. package/dist/healing/index.d.ts.map +0 -1
  252. package/dist/healing/index.js.map +0 -1
  253. package/dist/healing/self-healing-system.d.ts.map +0 -1
  254. package/dist/healing/self-healing-system.js.map +0 -1
  255. package/dist/health/system-health.d.ts.map +0 -1
  256. package/dist/health/system-health.js.map +0 -1
  257. package/dist/index.d.ts.map +0 -1
  258. package/dist/index.js.map +0 -1
  259. package/dist/intelligence/acl-analyzer.d.ts.map +0 -1
  260. package/dist/intelligence/acl-analyzer.js.map +0 -1
  261. package/dist/intelligence/auto-resolution-engine.d.ts.map +0 -1
  262. package/dist/intelligence/auto-resolution-engine.js.map +0 -1
  263. package/dist/intelligence/gap-analysis-engine.d.ts.map +0 -1
  264. package/dist/intelligence/gap-analysis-engine.js.map +0 -1
  265. package/dist/intelligence/manual-instructions-generator.d.ts.map +0 -1
  266. package/dist/intelligence/manual-instructions-generator.js.map +0 -1
  267. package/dist/intelligence/mcp-coverage-analyzer.d.ts.map +0 -1
  268. package/dist/intelligence/mcp-coverage-analyzer.js.map +0 -1
  269. package/dist/intelligence/multi-pass-requirements-analyzer.d.ts.map +0 -1
  270. package/dist/intelligence/multi-pass-requirements-analyzer.js.map +0 -1
  271. package/dist/intelligence/performance-recommendations-engine.d.ts.map +0 -1
  272. package/dist/intelligence/performance-recommendations-engine.js.map +0 -1
  273. package/dist/intelligence/requirements-analyzer.d.ts.map +0 -1
  274. package/dist/intelligence/requirements-analyzer.js.map +0 -1
  275. package/dist/intelligence/task-analyzer.d.ts.map +0 -1
  276. package/dist/intelligence/task-analyzer.js.map +0 -1
  277. package/dist/managers/scope-manager.d.ts.map +0 -1
  278. package/dist/managers/scope-manager.js.map +0 -1
  279. package/dist/mcp/advanced/servicenow-advanced-features-mcp.d.ts.map +0 -1
  280. package/dist/mcp/advanced/servicenow-advanced-features-mcp.js.map +0 -1
  281. package/dist/mcp/base-mcp-server.d.ts.map +0 -1
  282. package/dist/mcp/base-mcp-server.js.map +0 -1
  283. package/dist/mcp/example-refactored-server.d.ts.map +0 -1
  284. package/dist/mcp/example-refactored-server.js.map +0 -1
  285. package/dist/mcp/http-transport-wrapper.d.ts.map +0 -1
  286. package/dist/mcp/http-transport-wrapper.js.map +0 -1
  287. package/dist/mcp/mcp-wrapper.d.ts.map +0 -1
  288. package/dist/mcp/mcp-wrapper.js.map +0 -1
  289. package/dist/mcp/service-discovery-client.d.ts.map +0 -1
  290. package/dist/mcp/service-discovery-client.js.map +0 -1
  291. package/dist/mcp/servicenow-automation-mcp-refactored.d.ts.map +0 -1
  292. package/dist/mcp/servicenow-automation-mcp-refactored.js.map +0 -1
  293. package/dist/mcp/servicenow-automation-mcp.d.ts.map +0 -1
  294. package/dist/mcp/servicenow-automation-mcp.js.map +0 -1
  295. package/dist/mcp/servicenow-deployment-mcp-refactored.d.ts.map +0 -1
  296. package/dist/mcp/servicenow-deployment-mcp-refactored.js.map +0 -1
  297. package/dist/mcp/servicenow-deployment-mcp.d.ts.map +0 -1
  298. package/dist/mcp/servicenow-deployment-mcp.js.map +0 -1
  299. package/dist/mcp/servicenow-flow-composer-mcp-refactored.d.ts.map +0 -1
  300. package/dist/mcp/servicenow-flow-composer-mcp-refactored.js.map +0 -1
  301. package/dist/mcp/servicenow-flow-composer-mcp.d.ts.map +0 -1
  302. package/dist/mcp/servicenow-flow-composer-mcp.js.map +0 -1
  303. package/dist/mcp/servicenow-graph-memory-mcp-refactored.d.ts.map +0 -1
  304. package/dist/mcp/servicenow-graph-memory-mcp-refactored.js.map +0 -1
  305. package/dist/mcp/servicenow-graph-memory-mcp.d.ts.map +0 -1
  306. package/dist/mcp/servicenow-graph-memory-mcp.js.map +0 -1
  307. package/dist/mcp/servicenow-integration-mcp-refactored.d.ts.map +0 -1
  308. package/dist/mcp/servicenow-integration-mcp-refactored.js.map +0 -1
  309. package/dist/mcp/servicenow-integration-mcp.d.ts.map +0 -1
  310. package/dist/mcp/servicenow-integration-mcp.js.map +0 -1
  311. package/dist/mcp/servicenow-intelligent-mcp-refactored.d.ts.map +0 -1
  312. package/dist/mcp/servicenow-intelligent-mcp-refactored.js.map +0 -1
  313. package/dist/mcp/servicenow-intelligent-mcp.d.ts.map +0 -1
  314. package/dist/mcp/servicenow-intelligent-mcp.js.map +0 -1
  315. package/dist/mcp/servicenow-mcp-server.d.ts.map +0 -1
  316. package/dist/mcp/servicenow-mcp-server.js.map +0 -1
  317. package/dist/mcp/servicenow-memory-mcp.d.ts.map +0 -1
  318. package/dist/mcp/servicenow-memory-mcp.js.map +0 -1
  319. package/dist/mcp/servicenow-operations-mcp-refactored.d.ts.map +0 -1
  320. package/dist/mcp/servicenow-operations-mcp-refactored.js.map +0 -1
  321. package/dist/mcp/servicenow-operations-mcp.d.ts.map +0 -1
  322. package/dist/mcp/servicenow-operations-mcp.js.map +0 -1
  323. package/dist/mcp/servicenow-platform-development-mcp-refactored.d.ts.map +0 -1
  324. package/dist/mcp/servicenow-platform-development-mcp-refactored.js.map +0 -1
  325. package/dist/mcp/servicenow-platform-development-mcp.d.ts.map +0 -1
  326. package/dist/mcp/servicenow-platform-development-mcp.js.map +0 -1
  327. package/dist/mcp/servicenow-progressive-indexer.d.ts.map +0 -1
  328. package/dist/mcp/servicenow-progressive-indexer.js.map +0 -1
  329. package/dist/mcp/servicenow-reporting-analytics-mcp-refactored.d.ts.map +0 -1
  330. package/dist/mcp/servicenow-reporting-analytics-mcp-refactored.js.map +0 -1
  331. package/dist/mcp/servicenow-reporting-analytics-mcp.d.ts.map +0 -1
  332. package/dist/mcp/servicenow-reporting-analytics-mcp.js.map +0 -1
  333. package/dist/mcp/servicenow-security-compliance-mcp-refactored.d.ts.map +0 -1
  334. package/dist/mcp/servicenow-security-compliance-mcp-refactored.js.map +0 -1
  335. package/dist/mcp/servicenow-security-compliance-mcp.d.ts.map +0 -1
  336. package/dist/mcp/servicenow-security-compliance-mcp.js.map +0 -1
  337. package/dist/mcp/servicenow-update-set-mcp-refactored.d.ts.map +0 -1
  338. package/dist/mcp/servicenow-update-set-mcp-refactored.js.map +0 -1
  339. package/dist/mcp/servicenow-update-set-mcp.d.ts.map +0 -1
  340. package/dist/mcp/servicenow-update-set-mcp.js.map +0 -1
  341. package/dist/mcp/servicenow-xml-flow-mcp.d.ts.map +0 -1
  342. package/dist/mcp/servicenow-xml-flow-mcp.js.map +0 -1
  343. package/dist/mcp/shared/agent-context-provider.d.ts.map +0 -1
  344. package/dist/mcp/shared/agent-context-provider.js.map +0 -1
  345. package/dist/mcp/shared/base-mcp-server.d.ts.map +0 -1
  346. package/dist/mcp/shared/base-mcp-server.js.map +0 -1
  347. package/dist/mcp/shared/mcp-memory-manager.d.ts.map +0 -1
  348. package/dist/mcp/shared/mcp-memory-manager.js.map +0 -1
  349. package/dist/mcp/shared/mcp-resource-manager.d.ts.map +0 -1
  350. package/dist/mcp/shared/mcp-resource-manager.js.map +0 -1
  351. package/dist/mcp/snow-flow-mcp.d.ts.map +0 -1
  352. package/dist/mcp/snow-flow-mcp.js.map +0 -1
  353. package/dist/mcp/start-all-mcp-servers.d.ts.map +0 -1
  354. package/dist/mcp/start-all-mcp-servers.js.map +0 -1
  355. package/dist/mcp/start-servicenow-mcp.d.ts.map +0 -1
  356. package/dist/mcp/start-servicenow-mcp.js.map +0 -1
  357. package/dist/mcp/test-simple-mcp.d.ts.map +0 -1
  358. package/dist/mcp/test-simple-mcp.js.map +0 -1
  359. package/dist/memory/hierarchical-memory-system.d.ts +0 -90
  360. package/dist/memory/hierarchical-memory-system.d.ts.map +0 -1
  361. package/dist/memory/hierarchical-memory-system.js +0 -400
  362. package/dist/memory/hierarchical-memory-system.js.map +0 -1
  363. package/dist/memory/index.d.ts +0 -9
  364. package/dist/memory/index.d.ts.map +0 -1
  365. package/dist/memory/index.js +0 -20
  366. package/dist/memory/index.js.map +0 -1
  367. package/dist/memory/mcp-integration-example.d.ts +0 -6
  368. package/dist/memory/mcp-integration-example.d.ts.map +0 -1
  369. package/dist/memory/mcp-integration-example.js +0 -281
  370. package/dist/memory/mcp-integration-example.js.map +0 -1
  371. package/dist/memory/memory-client.d.ts +0 -199
  372. package/dist/memory/memory-client.d.ts.map +0 -1
  373. package/dist/memory/memory-client.js +0 -364
  374. package/dist/memory/memory-client.js.map +0 -1
  375. package/dist/memory/memory-manager.d.ts +0 -29
  376. package/dist/memory/memory-manager.d.ts.map +0 -1
  377. package/dist/memory/memory-manager.js +0 -280
  378. package/dist/memory/memory-manager.js.map +0 -1
  379. package/dist/memory/memory-operations.d.ts +0 -179
  380. package/dist/memory/memory-operations.d.ts.map +0 -1
  381. package/dist/memory/memory-operations.js +0 -691
  382. package/dist/memory/memory-operations.js.map +0 -1
  383. package/dist/memory/memory-system.d.ts +0 -152
  384. package/dist/memory/memory-system.d.ts.map +0 -1
  385. package/dist/memory/memory-system.js +0 -632
  386. package/dist/memory/memory-system.js.map +0 -1
  387. package/dist/memory/memory-test.d.ts +0 -6
  388. package/dist/memory/memory-test.d.ts.map +0 -1
  389. package/dist/memory/memory-test.js +0 -161
  390. package/dist/memory/memory-test.js.map +0 -1
  391. package/dist/memory/servicenow-artifact-indexer.d.ts +0 -119
  392. package/dist/memory/servicenow-artifact-indexer.d.ts.map +0 -1
  393. package/dist/memory/servicenow-artifact-indexer.js +0 -560
  394. package/dist/memory/servicenow-artifact-indexer.js.map +0 -1
  395. package/dist/memory/snow-flow-memory-patterns.d.ts +0 -213
  396. package/dist/memory/snow-flow-memory-patterns.d.ts.map +0 -1
  397. package/dist/memory/snow-flow-memory-patterns.js +0 -200
  398. package/dist/memory/snow-flow-memory-patterns.js.map +0 -1
  399. package/dist/memory/snow-memory.d.ts +0 -54
  400. package/dist/memory/snow-memory.d.ts.map +0 -1
  401. package/dist/memory/snow-memory.js +0 -301
  402. package/dist/memory/snow-memory.js.map +0 -1
  403. package/dist/memory/swarm-memory.d.ts +0 -135
  404. package/dist/memory/swarm-memory.d.ts.map +0 -1
  405. package/dist/memory/swarm-memory.js +0 -378
  406. package/dist/memory/swarm-memory.js.map +0 -1
  407. package/dist/monitoring/enhanced-monitoring-system.d.ts.map +0 -1
  408. package/dist/monitoring/enhanced-monitoring-system.js.map +0 -1
  409. package/dist/monitoring/performance-tracker.d.ts.map +0 -1
  410. package/dist/monitoring/performance-tracker.js.map +0 -1
  411. package/dist/optimization/cost-optimization-engine.d.ts.map +0 -1
  412. package/dist/optimization/cost-optimization-engine.js.map +0 -1
  413. package/dist/optimization/index.d.ts.map +0 -1
  414. package/dist/optimization/index.js.map +0 -1
  415. package/dist/orchestration/discovery/service-discovery.d.ts.map +0 -1
  416. package/dist/orchestration/discovery/service-discovery.js.map +0 -1
  417. package/dist/orchestration/distributed-orchestrator.d.ts.map +0 -1
  418. package/dist/orchestration/distributed-orchestrator.js.map +0 -1
  419. package/dist/orchestration/distribution/task-distribution-engine.d.ts.map +0 -1
  420. package/dist/orchestration/distribution/task-distribution-engine.js.map +0 -1
  421. package/dist/orchestration/interfaces/distributed-orchestration.interface.d.ts.map +0 -1
  422. package/dist/orchestration/interfaces/distributed-orchestration.interface.js.map +0 -1
  423. package/dist/orchestration/protocols/mcpx-protocol.d.ts.map +0 -1
  424. package/dist/orchestration/protocols/mcpx-protocol.js.map +0 -1
  425. package/dist/orchestration/state/distributed-state-manager.d.ts.map +0 -1
  426. package/dist/orchestration/state/distributed-state-manager.js.map +0 -1
  427. package/dist/orchestrator/flow-composer.d.ts.map +0 -1
  428. package/dist/orchestrator/flow-composer.js.map +0 -1
  429. package/dist/orchestrator/flow-pattern-templates.d.ts.map +0 -1
  430. package/dist/orchestrator/flow-pattern-templates.js.map +0 -1
  431. package/dist/orchestrator/flow-subflow-decision-engine.d.ts.map +0 -1
  432. package/dist/orchestrator/flow-subflow-decision-engine.js.map +0 -1
  433. package/dist/orchestrator/flow-validation-engine.d.ts.map +0 -1
  434. package/dist/orchestrator/flow-validation-engine.js.map +0 -1
  435. package/dist/orchestrator/snow-orchestrator.d.ts.map +0 -1
  436. package/dist/orchestrator/snow-orchestrator.js.map +0 -1
  437. package/dist/orchestrator/subflow-creation-handler.d.ts.map +0 -1
  438. package/dist/orchestrator/subflow-creation-handler.js.map +0 -1
  439. package/dist/patterns/adaptive-patterns.d.ts.map +0 -1
  440. package/dist/patterns/adaptive-patterns.js.map +0 -1
  441. package/dist/queen/advanced-integration-test.d.ts.map +0 -1
  442. package/dist/queen/advanced-integration-test.js.map +0 -1
  443. package/dist/queen/agent-factory.d.ts.map +0 -1
  444. package/dist/queen/agent-factory.js.map +0 -1
  445. package/dist/queen/index.d.ts.map +0 -1
  446. package/dist/queen/index.js.map +0 -1
  447. package/dist/queen/integration-example.d.ts.map +0 -1
  448. package/dist/queen/integration-example.js.map +0 -1
  449. package/dist/queen/integration-test.d.ts.map +0 -1
  450. package/dist/queen/integration-test.js.map +0 -1
  451. package/dist/queen/mcp-execution-bridge.d.ts.map +0 -1
  452. package/dist/queen/mcp-execution-bridge.js.map +0 -1
  453. package/dist/queen/mock-mcp-client.d.ts.map +0 -1
  454. package/dist/queen/mock-mcp-client.js.map +0 -1
  455. package/dist/queen/neural-learning.d.ts.map +0 -1
  456. package/dist/queen/neural-learning.js.map +0 -1
  457. package/dist/queen/parallel-agent-engine.d.ts.map +0 -1
  458. package/dist/queen/parallel-agent-engine.js.map +0 -1
  459. package/dist/queen/queen-memory-system.d.ts.map +0 -1
  460. package/dist/queen/queen-memory-system.js.map +0 -1
  461. package/dist/queen/queen-memory.d.ts.map +0 -1
  462. package/dist/queen/queen-memory.js.map +0 -1
  463. package/dist/queen/run-integration-tests.d.ts.map +0 -1
  464. package/dist/queen/run-integration-tests.js.map +0 -1
  465. package/dist/queen/servicenow-queen.d.ts.map +0 -1
  466. package/dist/queen/servicenow-queen.js.map +0 -1
  467. package/dist/queen/types.d.ts.map +0 -1
  468. package/dist/queen/types.js.map +0 -1
  469. package/dist/rollback/smart-rollback-system.d.ts.map +0 -1
  470. package/dist/rollback/smart-rollback-system.js.map +0 -1
  471. package/dist/snow-flow-system.d.ts.map +0 -1
  472. package/dist/snow-flow-system.js.map +0 -1
  473. package/dist/sparc/coordinators/adaptive-coordinator.d.ts.map +0 -1
  474. package/dist/sparc/coordinators/adaptive-coordinator.js.map +0 -1
  475. package/dist/sparc/coordinators/team-coordinator.d.ts.map +0 -1
  476. package/dist/sparc/coordinators/team-coordinator.js.map +0 -1
  477. package/dist/sparc/modes/team-modes.d.ts.map +0 -1
  478. package/dist/sparc/modes/team-modes.js.map +0 -1
  479. package/dist/sparc/sparc-help.d.ts.map +0 -1
  480. package/dist/sparc/sparc-help.js.map +0 -1
  481. package/dist/sparc/team-sparc.d.ts.map +0 -1
  482. package/dist/sparc/team-sparc.js.map +0 -1
  483. package/dist/sparc/teams/application-team.d.ts.map +0 -1
  484. package/dist/sparc/teams/application-team.js.map +0 -1
  485. package/dist/sparc/teams/flow-team.d.ts.map +0 -1
  486. package/dist/sparc/teams/flow-team.js.map +0 -1
  487. package/dist/sparc/teams/widget-team.d.ts.map +0 -1
  488. package/dist/sparc/teams/widget-team.js.map +0 -1
  489. package/dist/specialists/app-specialists.d.ts.map +0 -1
  490. package/dist/specialists/app-specialists.js.map +0 -1
  491. package/dist/specialists/base-specialist.d.ts.map +0 -1
  492. package/dist/specialists/base-specialist.js.map +0 -1
  493. package/dist/specialists/flow-specialists.d.ts.map +0 -1
  494. package/dist/specialists/flow-specialists.js.map +0 -1
  495. package/dist/specialists/individual-specialists.d.ts.map +0 -1
  496. package/dist/specialists/individual-specialists.js.map +0 -1
  497. package/dist/specialists/widget-specialists.d.ts.map +0 -1
  498. package/dist/specialists/widget-specialists.js.map +0 -1
  499. package/dist/strategies/global-scope-strategy.d.ts.map +0 -1
  500. package/dist/strategies/global-scope-strategy.js.map +0 -1
  501. package/dist/teams/adaptive-team.d.ts.map +0 -1
  502. package/dist/teams/adaptive-team.js.map +0 -1
  503. package/dist/teams/application-team.d.ts.map +0 -1
  504. package/dist/teams/application-team.js.map +0 -1
  505. package/dist/teams/base-team.d.ts.map +0 -1
  506. package/dist/teams/base-team.js.map +0 -1
  507. package/dist/teams/flow-team.d.ts.map +0 -1
  508. package/dist/teams/flow-team.js.map +0 -1
  509. package/dist/teams/widget-team.d.ts.map +0 -1
  510. package/dist/teams/widget-team.js.map +0 -1
  511. package/dist/testing/integration-test-suite.d.ts.map +0 -1
  512. package/dist/testing/integration-test-suite.js.map +0 -1
  513. package/dist/types/index.d.ts.map +0 -1
  514. package/dist/types/index.js.map +0 -1
  515. package/dist/types/servicenow.types.d.ts.map +0 -1
  516. package/dist/types/servicenow.types.js.map +0 -1
  517. package/dist/types/snow-flow.types.d.ts.map +0 -1
  518. package/dist/types/snow-flow.types.js.map +0 -1
  519. package/dist/types/todo.types.d.ts.map +0 -1
  520. package/dist/types/todo.types.js.map +0 -1
  521. package/dist/utils/action-type-cache.d.ts.map +0 -1
  522. package/dist/utils/action-type-cache.js.map +0 -1
  523. package/dist/utils/agent-detector.d.ts.map +0 -1
  524. package/dist/utils/agent-detector.js.map +0 -1
  525. package/dist/utils/artifact-tracker.d.ts.map +0 -1
  526. package/dist/utils/artifact-tracker.js.map +0 -1
  527. package/dist/utils/dependency-detector.d.ts.map +0 -1
  528. package/dist/utils/dependency-detector.js.map +0 -1
  529. package/dist/utils/deployment-metadata-handler.d.ts.map +0 -1
  530. package/dist/utils/deployment-metadata-handler.js.map +0 -1
  531. package/dist/utils/error-recovery.d.ts.map +0 -1
  532. package/dist/utils/error-recovery.js.map +0 -1
  533. package/dist/utils/flow-api-discovery.d.ts.map +0 -1
  534. package/dist/utils/flow-api-discovery.js.map +0 -1
  535. package/dist/utils/flow-xml-generator.d.ts.map +0 -1
  536. package/dist/utils/flow-xml-generator.js.map +0 -1
  537. package/dist/utils/logger.d.ts.map +0 -1
  538. package/dist/utils/logger.js.map +0 -1
  539. package/dist/utils/mcp-auth-middleware.d.ts.map +0 -1
  540. package/dist/utils/mcp-auth-middleware.js.map +0 -1
  541. package/dist/utils/mcp-config-manager.d.ts.map +0 -1
  542. package/dist/utils/mcp-config-manager.js.map +0 -1
  543. package/dist/utils/mcp-server-manager.d.ts.map +0 -1
  544. package/dist/utils/mcp-server-manager.js.map +0 -1
  545. package/dist/utils/mcp-tool-registry.d.ts.map +0 -1
  546. package/dist/utils/mcp-tool-registry.js.map +0 -1
  547. package/dist/utils/migrate-claude-flow.d.ts.map +0 -1
  548. package/dist/utils/migrate-claude-flow.js.map +0 -1
  549. package/dist/utils/migrate-snow-flow.d.ts.map +0 -1
  550. package/dist/utils/migrate-snow-flow.js.map +0 -1
  551. package/dist/utils/oauth-html-templates.d.ts.map +0 -1
  552. package/dist/utils/oauth-html-templates.js.map +0 -1
  553. package/dist/utils/scope-utils.d.ts.map +0 -1
  554. package/dist/utils/scope-utils.js.map +0 -1
  555. package/dist/utils/servicenow-client.d.ts.map +0 -1
  556. package/dist/utils/servicenow-client.js.map +0 -1
  557. package/dist/utils/servicenow-id-generator.d.ts.map +0 -1
  558. package/dist/utils/servicenow-id-generator.js.map +0 -1
  559. package/dist/utils/snow-memory-manager.d.ts.map +0 -1
  560. package/dist/utils/snow-memory-manager.js.map +0 -1
  561. package/dist/utils/snow-oauth-old.d.ts.map +0 -1
  562. package/dist/utils/snow-oauth-old.js.map +0 -1
  563. package/dist/utils/snow-oauth.d.ts.map +0 -1
  564. package/dist/utils/snow-oauth.js.map +0 -1
  565. package/dist/utils/template-engine.d.ts.map +0 -1
  566. package/dist/utils/template-engine.js.map +0 -1
  567. package/dist/utils/theme-manager.d.ts.map +0 -1
  568. package/dist/utils/theme-manager.js.map +0 -1
  569. package/dist/utils/unified-auth-store.d.ts.map +0 -1
  570. package/dist/utils/unified-auth-store.js.map +0 -1
  571. package/dist/utils/update-set-importer.d.ts.map +0 -1
  572. package/dist/utils/update-set-importer.js.map +0 -1
  573. package/dist/utils/update-set-xml-packager.d.ts.map +0 -1
  574. package/dist/utils/update-set-xml-packager.js.map +0 -1
  575. package/dist/utils/widget-template-generator.d.ts.map +0 -1
  576. package/dist/utils/widget-template-generator.js.map +0 -1
  577. package/dist/version.d.ts.map +0 -1
  578. package/dist/version.js.map +0 -1
  579. package/memory/agents/README.md +0 -31
  580. package/memory/claude-flow-data.json +0 -5
  581. package/memory/servicenow_artifacts/000d9224c895221055906c7518aa2d3d.json +0 -30
  582. package/memory/servicenow_artifacts/0196b66173303010e46b4a2214f6a7a2.json +0 -36
  583. package/memory/servicenow_artifacts/125e5d1d837e2a102a7ea130ceaad397.json +0 -30
  584. package/memory/servicenow_artifacts/7637c1f2b7112210a5e5911cde11a972.json +0 -30
  585. package/memory/servicenow_artifacts/default_documentation_tables_1754056582292.json +0 -55
  586. package/memory/servicenow_artifacts/default_documentation_tables_1754057477189.json +0 -55
  587. package/memory/sessions/README.md +0 -32
  588. package/memory/update-set-sessions/01f82af583faea102a7ea130ceaad3d4.json +0 -9
  589. package/memory/update-set-sessions/27718fb983faea102a7ea130ceaad34b.json +0 -9
  590. package/memory/update-set-sessions/412e9bf6833e22502a7ea130ceaad30a.json +0 -8
  591. package/memory/update-set-sessions/66fc5a79837aea102a7ea130ceaad3ab.json +0 -9
  592. package/memory/update-set-sessions/71a30ff5837eea102a7ea130ceaad37f.json +0 -9
  593. package/memory/update-set-sessions/74fba27983faea102a7ea130ceaad3bd.json +0 -9
  594. package/memory/update-set-sessions/a0b147b5837eea102a7ea130ceaad344.json +0 -58
  595. package/memory/update-set-sessions/b13f5eb983baea102a7ea130ceaad33e.json +0 -9
@@ -0,0 +1,811 @@
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);