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,60 +0,0 @@
1
- /**
2
- * Logger utility for ServiceNow agents
3
- */
4
-
5
- import winston from 'winston';
6
- import path from 'path';
7
-
8
- export class Logger {
9
- private logger: winston.Logger;
10
-
11
- constructor(agentName: string) {
12
- const logDir = path.join(process.cwd(), 'logs');
13
-
14
- this.logger = winston.createLogger({
15
- level: process.env.LOG_LEVEL || 'info',
16
- format: winston.format.combine(
17
- winston.format.timestamp(),
18
- winston.format.errors({ stack: true }),
19
- winston.format.json()
20
- ),
21
- defaultMeta: { agent: agentName },
22
- transports: [
23
- // Console transport
24
- new winston.transports.Console({
25
- format: winston.format.combine(
26
- winston.format.colorize(),
27
- winston.format.simple()
28
- )
29
- }),
30
- // File transport
31
- new winston.transports.File({
32
- filename: path.join(logDir, `${agentName}-error.log`),
33
- level: 'error'
34
- }),
35
- new winston.transports.File({
36
- filename: path.join(logDir, `${agentName}.log`)
37
- })
38
- ]
39
- });
40
- }
41
-
42
- info(message: string, meta?: any): void {
43
- this.logger.info(message, meta);
44
- }
45
-
46
- error(message: string, meta?: any): void {
47
- this.logger.error(message, meta);
48
- }
49
-
50
- warn(message: string, meta?: any): void {
51
- this.logger.warn(message, meta);
52
- }
53
-
54
- debug(message: string, meta?: any): void {
55
- this.logger.debug(message, meta);
56
- }
57
- }
58
-
59
- // Create a default logger instance
60
- export const logger = new Logger('snow-flow');
@@ -1,262 +0,0 @@
1
- /**
2
- * Centralized MCP Authentication Middleware
3
- * Handles ServiceNow OAuth authentication across all MCP servers
4
- */
5
-
6
- import { ServiceNowOAuth } from './snow-oauth.js';
7
- import { mcpConfig } from './mcp-config-manager.js';
8
- import { Logger } from './logger.js';
9
-
10
- export interface AuthenticationResult {
11
- success: boolean;
12
- token?: string;
13
- error?: string;
14
- needsReauth?: boolean;
15
- }
16
-
17
- export class MCPAuthenticationMiddleware {
18
- private static instance: MCPAuthenticationMiddleware;
19
- private oauth: ServiceNowOAuth;
20
- private logger: Logger;
21
- private lastAuthCheck: Date | null = null;
22
- private authCheckInterval: number = 5 * 60 * 1000; // 5 minutes
23
-
24
- private constructor() {
25
- this.logger = new Logger('MCPAuthMiddleware');
26
- this.oauth = new ServiceNowOAuth();
27
- }
28
-
29
- public static getInstance(): MCPAuthenticationMiddleware {
30
- if (!MCPAuthenticationMiddleware.instance) {
31
- MCPAuthenticationMiddleware.instance = new MCPAuthenticationMiddleware();
32
- }
33
- return MCPAuthenticationMiddleware.instance;
34
- }
35
-
36
- /**
37
- * Ensure authentication is valid before MCP operations
38
- */
39
- async ensureAuthenticated(): Promise<AuthenticationResult> {
40
- try {
41
- // Check if we need to refresh authentication
42
- if (this.shouldCheckAuth()) {
43
- this.logger.debug('Checking authentication status...');
44
-
45
- const isAuthenticated = await this.oauth.isAuthenticated();
46
- if (!isAuthenticated) {
47
- this.logger.warn('Authentication expired or invalid');
48
- return {
49
- success: false,
50
- error: 'ServiceNow authentication expired. Please run "snow-flow auth login" again.',
51
- needsReauth: true
52
- };
53
- }
54
-
55
- this.lastAuthCheck = new Date();
56
- }
57
-
58
- // Get current token
59
- const token = await this.oauth.getAccessToken();
60
- if (!token) {
61
- return {
62
- success: false,
63
- error: 'No access token available. Please authenticate first.',
64
- needsReauth: true
65
- };
66
- }
67
-
68
- return {
69
- success: true,
70
- token
71
- };
72
-
73
- } catch (error) {
74
- this.logger.error('Authentication check failed:', error);
75
- return {
76
- success: false,
77
- error: error instanceof Error ? error.message : 'Authentication check failed',
78
- needsReauth: true
79
- };
80
- }
81
- }
82
-
83
- /**
84
- * Check if authentication status should be verified
85
- */
86
- private shouldCheckAuth(): boolean {
87
- if (!this.lastAuthCheck) return true;
88
-
89
- const timeSinceLastCheck = Date.now() - this.lastAuthCheck.getTime();
90
- return timeSinceLastCheck > this.authCheckInterval;
91
- }
92
-
93
- /**
94
- * Handle authentication errors with automatic retry
95
- */
96
- async handleAuthError(error: any): Promise<AuthenticationResult> {
97
- this.logger.warn('Handling authentication error:', error);
98
-
99
- // Check if this is an authentication-related error
100
- if (this.isAuthError(error)) {
101
- // Try to refresh token
102
- try {
103
- const credentials = await this.oauth.loadCredentials();
104
- if (credentials) {
105
- const refreshResult = await this.oauth.refreshAccessToken(credentials);
106
- if (refreshResult.success) {
107
- this.logger.info('Token refreshed successfully');
108
- return {
109
- success: true,
110
- token: refreshResult.accessToken
111
- };
112
- }
113
- }
114
- } catch (refreshError) {
115
- this.logger.error('Token refresh failed:', refreshError);
116
- }
117
-
118
- // If refresh failed, require re-authentication
119
- return {
120
- success: false,
121
- error: 'Authentication failed. Please run "snow-flow auth login" again.',
122
- needsReauth: true
123
- };
124
- }
125
-
126
- // Not an auth error, return original error
127
- return {
128
- success: false,
129
- error: error instanceof Error ? error.message : String(error)
130
- };
131
- }
132
-
133
- /**
134
- * Check if an error is authentication-related
135
- */
136
- private isAuthError(error: any): boolean {
137
- if (!error) return false;
138
-
139
- const errorMessage = error.message || error.toString() || '';
140
- const errorCode = error.status || error.code || 0;
141
-
142
- // Check for common authentication error patterns
143
- const authErrorPatterns = [
144
- 'unauthorized',
145
- 'authentication',
146
- 'expired',
147
- 'invalid token',
148
- 'access denied',
149
- 'forbidden'
150
- ];
151
-
152
- const isAuthMessage = authErrorPatterns.some(pattern =>
153
- errorMessage.toLowerCase().includes(pattern)
154
- );
155
-
156
- const isAuthCode = [401, 403].includes(errorCode);
157
-
158
- return isAuthMessage || isAuthCode;
159
- }
160
-
161
- /**
162
- * Get ServiceNow instance information
163
- */
164
- async getInstanceInfo(): Promise<{ instance: string; authenticated: boolean }> {
165
- const config = mcpConfig.getServiceNowConfig();
166
- const authenticated = await this.oauth.isAuthenticated();
167
-
168
- return {
169
- instance: config.instanceUrl || 'Not configured',
170
- authenticated
171
- };
172
- }
173
-
174
- /**
175
- * Wrapper for MCP operations with authentication
176
- */
177
- async withAuth<T>(operation: (token: string) => Promise<T>): Promise<T> {
178
- const authResult = await this.ensureAuthenticated();
179
-
180
- if (!authResult.success) {
181
- throw new Error(authResult.error || 'Authentication failed');
182
- }
183
-
184
- try {
185
- return await operation(authResult.token!);
186
- } catch (error) {
187
- // Handle potential authentication errors during operation
188
- const authErrorResult = await this.handleAuthError(error);
189
-
190
- if (authErrorResult.needsReauth) {
191
- throw new Error(authErrorResult.error || 'Authentication required');
192
- }
193
-
194
- // If we successfully refreshed the token, retry the operation
195
- if (authErrorResult.success && authErrorResult.token) {
196
- return await operation(authErrorResult.token);
197
- }
198
-
199
- // Re-throw original error if not auth-related
200
- throw error;
201
- }
202
- }
203
-
204
- /**
205
- * Get authentication headers for HTTP requests
206
- */
207
- async getAuthHeaders(): Promise<{ [key: string]: string }> {
208
- const authResult = await this.ensureAuthenticated();
209
-
210
- if (!authResult.success) {
211
- throw new Error(authResult.error || 'Authentication failed');
212
- }
213
-
214
- return {
215
- 'Authorization': `Bearer ${authResult.token}`,
216
- 'Content-Type': 'application/json',
217
- 'Accept': 'application/json'
218
- };
219
- }
220
-
221
- /**
222
- * Force authentication refresh
223
- */
224
- async forceRefresh(): Promise<AuthenticationResult> {
225
- this.logger.info('Forcing authentication refresh...');
226
- this.lastAuthCheck = null;
227
-
228
- try {
229
- const credentials = await this.oauth.loadCredentials();
230
- if (credentials) {
231
- const refreshResult = await this.oauth.refreshAccessToken(credentials);
232
- if (refreshResult.success) {
233
- return {
234
- success: true,
235
- token: refreshResult.accessToken
236
- };
237
- } else {
238
- return {
239
- success: false,
240
- error: 'Token refresh failed',
241
- needsReauth: true
242
- };
243
- }
244
- } else {
245
- return {
246
- success: false,
247
- error: 'No credentials available',
248
- needsReauth: true
249
- };
250
- }
251
- } catch (error) {
252
- return {
253
- success: false,
254
- error: error instanceof Error ? error.message : 'Refresh failed',
255
- needsReauth: true
256
- };
257
- }
258
- }
259
- }
260
-
261
- // Export singleton instance
262
- export const mcpAuth = MCPAuthenticationMiddleware.getInstance();
@@ -1,270 +0,0 @@
1
- /**
2
- * Centralized MCP Configuration Manager
3
- * Handles dynamic configuration loading for all MCP servers
4
- */
5
-
6
- import { config } from 'dotenv';
7
- import { readFileSync, existsSync } from 'fs';
8
- import { join } from 'path';
9
- import os from 'os';
10
- import { Logger } from './logger.js';
11
-
12
- // Load environment variables
13
- config();
14
-
15
- export interface MCPConfig {
16
- servicenow: {
17
- instanceUrl?: string;
18
- clientId?: string;
19
- clientSecret?: string;
20
- oauthRedirectUri?: string;
21
- maxRetries?: number;
22
- timeout?: number;
23
- };
24
- neo4j?: {
25
- uri?: string;
26
- username?: string;
27
- password?: string;
28
- database?: string;
29
- };
30
- memory: {
31
- provider: 'file' | 'neo4j' | 'redis';
32
- path?: string;
33
- connectionString?: string;
34
- maxSize?: number;
35
- ttl?: number;
36
- };
37
- performance: {
38
- connectionPoolSize?: number;
39
- requestTimeout?: number;
40
- retryAttempts?: number;
41
- cacheEnabled?: boolean;
42
- cacheTtl?: number;
43
- };
44
- logging: {
45
- level: 'debug' | 'info' | 'warn' | 'error';
46
- enableFileLogging?: boolean;
47
- logPath?: string;
48
- };
49
- }
50
-
51
- export class MCPConfigManager {
52
- private static instance: MCPConfigManager;
53
- private config: MCPConfig;
54
- private logger: Logger;
55
-
56
- private constructor() {
57
- this.logger = new Logger('MCPConfigManager');
58
- this.config = this.loadConfiguration();
59
- }
60
-
61
- public static getInstance(): MCPConfigManager {
62
- if (!MCPConfigManager.instance) {
63
- MCPConfigManager.instance = new MCPConfigManager();
64
- }
65
- return MCPConfigManager.instance;
66
- }
67
-
68
- /**
69
- * Load configuration from environment variables and config files
70
- */
71
- private loadConfiguration(): MCPConfig {
72
- const baseConfig: MCPConfig = {
73
- servicenow: {
74
- instanceUrl: process.env.SERVICENOW_INSTANCE_URL || process.env.SERVICENOW_INSTANCE,
75
- clientId: process.env.SERVICENOW_CLIENT_ID,
76
- clientSecret: process.env.SERVICENOW_CLIENT_SECRET,
77
- oauthRedirectUri: process.env.SERVICENOW_OAUTH_REDIRECT_URI || 'http://localhost:8080/auth/callback',
78
- maxRetries: parseInt(process.env.SERVICENOW_MAX_RETRIES || '3'),
79
- timeout: parseInt(process.env.SERVICENOW_TIMEOUT || '30000')
80
- },
81
- neo4j: {
82
- uri: process.env.NEO4J_URI || process.env.NEO4J_URL,
83
- username: process.env.NEO4J_USERNAME || process.env.NEO4J_USER,
84
- password: process.env.NEO4J_PASSWORD || process.env.NEO4J_PASS,
85
- database: process.env.NEO4J_DATABASE || 'neo4j'
86
- },
87
- memory: {
88
- provider: (process.env.MEMORY_PROVIDER as 'file' | 'neo4j' | 'redis') || 'file',
89
- path: process.env.MEMORY_PATH || join(process.env.SNOW_FLOW_HOME || join(os.homedir(), '.snow-flow'), 'memory'),
90
- connectionString: process.env.MEMORY_CONNECTION_STRING,
91
- maxSize: parseInt(process.env.MEMORY_MAX_SIZE || '1000'),
92
- ttl: parseInt(process.env.MEMORY_TTL || '86400') // 24 hours
93
- },
94
- performance: {
95
- connectionPoolSize: parseInt(process.env.CONNECTION_POOL_SIZE || '10'),
96
- requestTimeout: parseInt(process.env.REQUEST_TIMEOUT || '30000'),
97
- retryAttempts: parseInt(process.env.RETRY_ATTEMPTS || '3'),
98
- cacheEnabled: process.env.CACHE_ENABLED !== 'false',
99
- cacheTtl: parseInt(process.env.CACHE_TTL || '300') // 5 minutes
100
- },
101
- logging: {
102
- level: (process.env.LOG_LEVEL as 'debug' | 'info' | 'warn' | 'error') || 'info',
103
- enableFileLogging: process.env.ENABLE_FILE_LOGGING === 'true',
104
- logPath: process.env.LOG_PATH || join(process.env.SNOW_FLOW_HOME || join(os.homedir(), '.snow-flow'), 'logs')
105
- }
106
- };
107
-
108
- // Try to load from config file if it exists
109
- const configPath = join(process.env.SNOW_FLOW_HOME || join(os.homedir(), '.snow-flow'), 'config.json');
110
- if (existsSync(configPath)) {
111
- try {
112
- const fileConfig = JSON.parse(readFileSync(configPath, 'utf8'));
113
- this.logger.info('Loaded configuration from config.json');
114
- return this.mergeConfigs(baseConfig, fileConfig);
115
- } catch (error) {
116
- this.logger.warn('Failed to load config.json, using environment variables');
117
- }
118
- }
119
-
120
- return baseConfig;
121
- }
122
-
123
- /**
124
- * Merge base configuration with file configuration
125
- */
126
- private mergeConfigs(base: MCPConfig, override: Partial<MCPConfig>): MCPConfig {
127
- return {
128
- servicenow: { ...base.servicenow, ...override.servicenow },
129
- neo4j: { ...base.neo4j, ...override.neo4j },
130
- memory: { ...base.memory, ...override.memory },
131
- performance: { ...base.performance, ...override.performance },
132
- logging: { ...base.logging, ...override.logging }
133
- };
134
- }
135
-
136
- /**
137
- * Get the complete configuration
138
- */
139
- public getConfig(): MCPConfig {
140
- return this.config;
141
- }
142
-
143
- /**
144
- * Get ServiceNow configuration
145
- */
146
- public getServiceNowConfig() {
147
- return this.config.servicenow;
148
- }
149
-
150
- /**
151
- * Get Neo4j configuration
152
- */
153
- public getNeo4jConfig() {
154
- return this.config.neo4j;
155
- }
156
-
157
- /**
158
- * Get memory configuration
159
- */
160
- public getMemoryConfig() {
161
- return this.config.memory;
162
- }
163
-
164
- /**
165
- * Get performance configuration
166
- */
167
- public getPerformanceConfig() {
168
- return this.config.performance;
169
- }
170
-
171
- /**
172
- * Get logging configuration
173
- */
174
- public getLoggingConfig() {
175
- return this.config.logging;
176
- }
177
-
178
- /**
179
- * Validate configuration
180
- */
181
- public validateConfig(): { valid: boolean; errors: string[] } {
182
- const errors: string[] = [];
183
-
184
- // Validate ServiceNow configuration
185
- if (!this.config.servicenow.instanceUrl) {
186
- errors.push('ServiceNow instance URL is required (SERVICENOW_INSTANCE_URL)');
187
- }
188
- if (!this.config.servicenow.clientId) {
189
- errors.push('ServiceNow client ID is required (SERVICENOW_CLIENT_ID)');
190
- }
191
- if (!this.config.servicenow.clientSecret) {
192
- errors.push('ServiceNow client secret is required (SERVICENOW_CLIENT_SECRET)');
193
- }
194
-
195
- // Validate Neo4j configuration if enabled
196
- if (this.config.memory.provider === 'neo4j') {
197
- if (!this.config.neo4j?.uri) {
198
- errors.push('Neo4j URI is required when using Neo4j memory provider (NEO4J_URI)');
199
- }
200
- if (!this.config.neo4j?.username) {
201
- errors.push('Neo4j username is required when using Neo4j memory provider (NEO4J_USERNAME)');
202
- }
203
- if (!this.config.neo4j?.password) {
204
- errors.push('Neo4j password is required when using Neo4j memory provider (NEO4J_PASSWORD)');
205
- }
206
- }
207
-
208
- // Validate memory configuration
209
- if (!['file', 'neo4j', 'redis'].includes(this.config.memory.provider)) {
210
- errors.push('Memory provider must be one of: file, neo4j, redis');
211
- }
212
-
213
- return {
214
- valid: errors.length === 0,
215
- errors
216
- };
217
- }
218
-
219
- /**
220
- * Hot reload configuration
221
- */
222
- public async reloadConfig(): Promise<void> {
223
- this.logger.info('Reloading configuration...');
224
- this.config = this.loadConfiguration();
225
-
226
- const validation = this.validateConfig();
227
- if (!validation.valid) {
228
- this.logger.error('Configuration validation failed:', validation.errors);
229
- throw new Error(`Configuration validation failed: ${validation.errors.join(', ')}`);
230
- }
231
-
232
- this.logger.info('Configuration reloaded successfully');
233
- }
234
-
235
- /**
236
- * Get environment-specific configuration
237
- */
238
- public getEnvironmentConfig(): { environment: string; config: MCPConfig } {
239
- const environment = process.env.NODE_ENV || 'development';
240
-
241
- // Environment-specific overrides
242
- const envOverrides: Partial<MCPConfig> = {};
243
-
244
- if (environment === 'production') {
245
- envOverrides.logging = {
246
- ...this.config.logging,
247
- level: 'warn',
248
- enableFileLogging: true
249
- };
250
- envOverrides.performance = {
251
- ...this.config.performance,
252
- cacheEnabled: true,
253
- connectionPoolSize: 20
254
- };
255
- } else if (environment === 'development') {
256
- envOverrides.logging = {
257
- ...this.config.logging,
258
- level: 'debug'
259
- };
260
- }
261
-
262
- return {
263
- environment,
264
- config: this.mergeConfigs(this.config, envOverrides)
265
- };
266
- }
267
- }
268
-
269
- // Export singleton instance
270
- export const mcpConfig = MCPConfigManager.getInstance();