snow-flow 3.0.10 → 3.0.14

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.
@@ -0,0 +1,316 @@
1
+ "use strict";
2
+ /**
3
+ * Anti-Mock Data Validator
4
+ *
5
+ * This utility ensures NO mock, demo, sample, or fake data is ever used in any MCP tools.
6
+ * All data must come from real ServiceNow instances.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.generateDataReport = exports.checkDataIntegrity = exports.validateRealData = exports.antiMockValidator = exports.AntiMockDataValidator = void 0;
10
+ const logger_js_1 = require("./logger.js");
11
+ class AntiMockDataValidator {
12
+ constructor() {
13
+ // Patterns that indicate mock/demo/test data
14
+ this.MOCK_DATA_PATTERNS = [
15
+ // Explicit mock indicators
16
+ /\bmock\b/i,
17
+ /\bdemo\b/i,
18
+ /\bsample\b/i,
19
+ /\btest\b/i,
20
+ /\bfake\b/i,
21
+ /\bplaceholder\b/i,
22
+ /\bdummy\b/i,
23
+ /\bexample\b/i,
24
+ // Common test values
25
+ /^test$/i,
26
+ /^demo$/i,
27
+ /test.*user/i,
28
+ /demo.*user/i,
29
+ /sample.*data/i,
30
+ /example.*com/i,
31
+ /test@test\.com/i,
32
+ /demo@demo\.com/i,
33
+ // Sequential test patterns
34
+ /test\d+/i,
35
+ /demo\d+/i,
36
+ /user\d+$/i,
37
+ /item\d+$/i,
38
+ // Placeholder values
39
+ /^n\/a$/i,
40
+ /^tbd$/i,
41
+ /^to.*be.*determined/i,
42
+ /^pending$/i,
43
+ /^xxx+$/i,
44
+ /^temp/i,
45
+ // Mock ServiceNow patterns
46
+ /^INC\d{7}000\d+$/, // Sequential incident numbers indicating test data
47
+ /^CHG\d{7}000\d+$/, // Sequential change numbers indicating test data
48
+ /^PRB\d{7}000\d+$/, // Sequential problem numbers indicating test data
49
+ ];
50
+ // Suspicious numeric patterns that might indicate generated/mock data
51
+ this.SUSPICIOUS_NUMERIC_PATTERNS = [
52
+ /^123+$/, // 123, 1234, 12345...
53
+ /^999+$/, // 999, 9999, 99999...
54
+ /^111+$/, // 111, 1111, 11111...
55
+ /^000+$/, // 000, 0000, 00000...
56
+ /^(12){2,}$/, // 121212...
57
+ /^(99){2,}$/, // 999999...
58
+ ];
59
+ this.logger = new logger_js_1.Logger('AntiMockDataValidator');
60
+ }
61
+ /**
62
+ * Validate that dataset contains only real ServiceNow data
63
+ */
64
+ validateDataset(data, source = 'unknown') {
65
+ if (!data || data.length === 0) {
66
+ return {
67
+ isValid: false,
68
+ violations: ['Empty dataset - no real data to validate'],
69
+ suspiciousFields: [],
70
+ suspiciousValues: []
71
+ };
72
+ }
73
+ const violations = [];
74
+ const suspiciousFields = [];
75
+ const suspiciousValues = [];
76
+ // Check each record
77
+ data.forEach((record, index) => {
78
+ if (!record || typeof record !== 'object') {
79
+ violations.push(`Record ${index}: Invalid record structure`);
80
+ return;
81
+ }
82
+ // Check each field in the record
83
+ Object.entries(record).forEach(([field, value]) => {
84
+ const fieldViolations = this.validateFieldValue(field, value, source);
85
+ if (fieldViolations.length > 0) {
86
+ violations.push(`Record ${index}, Field '${field}': ${fieldViolations.join(', ')}`);
87
+ if (!suspiciousFields.includes(field)) {
88
+ suspiciousFields.push(field);
89
+ }
90
+ if (!suspiciousValues.includes(value)) {
91
+ suspiciousValues.push(value);
92
+ }
93
+ }
94
+ });
95
+ });
96
+ // Additional dataset-level checks
97
+ const datasetViolations = this.validateDatasetPatterns(data, source);
98
+ violations.push(...datasetViolations);
99
+ return {
100
+ isValid: violations.length === 0,
101
+ violations,
102
+ suspiciousFields,
103
+ suspiciousValues
104
+ };
105
+ }
106
+ /**
107
+ * Validate individual field value
108
+ */
109
+ validateFieldValue(field, value, source) {
110
+ const violations = [];
111
+ if (value === null || value === undefined) {
112
+ return violations; // Null values are acceptable
113
+ }
114
+ const stringValue = String(value);
115
+ // Check for mock data patterns
116
+ for (const pattern of this.MOCK_DATA_PATTERNS) {
117
+ if (pattern.test(stringValue)) {
118
+ violations.push(`Matches mock data pattern: ${pattern.source}`);
119
+ }
120
+ }
121
+ // Check numeric patterns for suspicious sequences
122
+ if (typeof value === 'number' || /^\d+$/.test(stringValue)) {
123
+ for (const pattern of this.SUSPICIOUS_NUMERIC_PATTERNS) {
124
+ if (pattern.test(stringValue)) {
125
+ violations.push(`Suspicious numeric pattern: ${stringValue}`);
126
+ }
127
+ }
128
+ }
129
+ // Field-specific validation
130
+ if (field.toLowerCase().includes('email') && stringValue.includes('@')) {
131
+ if (/@(test|demo|example|mock|fake)\.(com|org|net)$/i.test(stringValue)) {
132
+ violations.push('Test/demo email domain detected');
133
+ }
134
+ }
135
+ if (field.toLowerCase().includes('name') || field.toLowerCase().includes('user')) {
136
+ if (/^(test|demo|sample|mock|fake|admin|user)\d*$/i.test(stringValue)) {
137
+ violations.push('Generic test/demo name pattern');
138
+ }
139
+ }
140
+ return violations;
141
+ }
142
+ /**
143
+ * Validate patterns across the entire dataset
144
+ */
145
+ validateDatasetPatterns(data, source) {
146
+ const violations = [];
147
+ // Check for suspiciously uniform data
148
+ if (data.length > 10) {
149
+ const firstRecord = data[0];
150
+ const identicalCount = data.filter(record => JSON.stringify(record) === JSON.stringify(firstRecord)).length;
151
+ if (identicalCount > data.length * 0.8) {
152
+ violations.push('Dataset appears to have too many identical records (possible mock data)');
153
+ }
154
+ }
155
+ // Check for sequential IDs indicating generated data
156
+ const sysIds = data.map(record => record.sys_id).filter(id => id);
157
+ if (sysIds.length > 5) {
158
+ const sequentialCount = this.countSequentialIds(sysIds);
159
+ if (sequentialCount > sysIds.length * 0.7) {
160
+ violations.push('Too many sequential sys_id values (indicates generated test data)');
161
+ }
162
+ }
163
+ // Check creation dates for suspicious patterns
164
+ const createdDates = data.map(record => record.sys_created_on).filter(date => date);
165
+ if (createdDates.length > 5) {
166
+ const simultaneousCreations = this.countSimultaneousCreations(createdDates);
167
+ if (simultaneousCreations > createdDates.length * 0.8) {
168
+ violations.push('Too many records created simultaneously (indicates bulk test data creation)');
169
+ }
170
+ }
171
+ return violations;
172
+ }
173
+ /**
174
+ * Count sequential sys_id patterns
175
+ */
176
+ countSequentialIds(sysIds) {
177
+ let sequentialCount = 0;
178
+ const sortedIds = sysIds.sort();
179
+ for (let i = 1; i < sortedIds.length; i++) {
180
+ const current = sortedIds[i];
181
+ const previous = sortedIds[i - 1];
182
+ // Check if IDs follow a sequential pattern
183
+ if (this.areIdsSequential(previous, current)) {
184
+ sequentialCount++;
185
+ }
186
+ }
187
+ return sequentialCount;
188
+ }
189
+ /**
190
+ * Check if two sys_ids are sequential
191
+ */
192
+ areIdsSequential(id1, id2) {
193
+ if (id1.length !== id2.length)
194
+ return false;
195
+ if (id1.length !== 32)
196
+ return false; // ServiceNow sys_ids are 32 chars
197
+ // Convert hex to numbers and check if they're sequential
198
+ try {
199
+ const num1 = parseInt(id1.slice(-8), 16);
200
+ const num2 = parseInt(id2.slice(-8), 16);
201
+ return Math.abs(num2 - num1) === 1;
202
+ }
203
+ catch {
204
+ return false;
205
+ }
206
+ }
207
+ /**
208
+ * Count records created at exactly the same time
209
+ */
210
+ countSimultaneousCreations(dates) {
211
+ const dateMap = new Map();
212
+ dates.forEach(date => {
213
+ const normalizedDate = new Date(date).toISOString();
214
+ dateMap.set(normalizedDate, (dateMap.get(normalizedDate) || 0) + 1);
215
+ });
216
+ let simultaneousCount = 0;
217
+ dateMap.forEach(count => {
218
+ if (count > 1) {
219
+ simultaneousCount += count;
220
+ }
221
+ });
222
+ return simultaneousCount;
223
+ }
224
+ /**
225
+ * Perform comprehensive data integrity check
226
+ */
227
+ performDataIntegrityCheck(data, source = 'unknown') {
228
+ const validation = this.validateDataset(data, source);
229
+ let qualityScore = 100;
230
+ // Deduct points for violations
231
+ qualityScore -= validation.violations.length * 10;
232
+ qualityScore -= validation.suspiciousFields.length * 5;
233
+ qualityScore -= validation.suspiciousValues.length * 2;
234
+ // Ensure score doesn't go below 0
235
+ qualityScore = Math.max(0, qualityScore);
236
+ return {
237
+ hasRealData: validation.isValid && qualityScore > 70,
238
+ dataQualityScore: qualityScore,
239
+ mockDataDetected: !validation.isValid,
240
+ details: [
241
+ `Validation result: ${validation.isValid ? 'PASSED' : 'FAILED'}`,
242
+ `Total violations: ${validation.violations.length}`,
243
+ `Suspicious fields: ${validation.suspiciousFields.length}`,
244
+ `Data quality score: ${qualityScore}/100`,
245
+ `Source: ${source}`,
246
+ ...validation.violations.slice(0, 5) // Show first 5 violations
247
+ ]
248
+ };
249
+ }
250
+ /**
251
+ * Enforce zero tolerance policy for mock data
252
+ */
253
+ enforceZeroTolerancePolicy(data, source = 'unknown') {
254
+ const validation = this.validateDataset(data, source);
255
+ if (!validation.isValid) {
256
+ const errorMessage = [
257
+ '🚨 MOCK DATA DETECTED - ZERO TOLERANCE POLICY VIOLATED!',
258
+ `Source: ${source}`,
259
+ `Violations found: ${validation.violations.length}`,
260
+ '',
261
+ 'Violations:',
262
+ ...validation.violations.slice(0, 10),
263
+ '',
264
+ '❌ This operation has been BLOCKED.',
265
+ '✅ Only REAL ServiceNow data is allowed.',
266
+ '',
267
+ 'Please verify your data source and try again with actual ServiceNow records.'
268
+ ].join('\n');
269
+ this.logger.error(errorMessage);
270
+ throw new Error(`Mock data detected in ${source}. Only real ServiceNow data allowed.`);
271
+ }
272
+ this.logger.info(`✅ Data validation passed for ${source} - ${data.length} real records confirmed`);
273
+ }
274
+ /**
275
+ * Generate validation report
276
+ */
277
+ generateValidationReport(data, source = 'unknown') {
278
+ const integrityCheck = this.performDataIntegrityCheck(data, source);
279
+ return [
280
+ '🔥 ANTI-MOCK DATA VALIDATION REPORT',
281
+ '='.repeat(50),
282
+ `📊 Source: ${source}`,
283
+ `📈 Records Analyzed: ${data.length}`,
284
+ `🎯 Data Quality Score: ${integrityCheck.dataQualityScore}/100`,
285
+ `✅ Real Data Status: ${integrityCheck.hasRealData ? 'CONFIRMED' : 'SUSPICIOUS'}`,
286
+ `🚨 Mock Data Detected: ${integrityCheck.mockDataDetected ? 'YES - BLOCKED' : 'NO - SAFE'}`,
287
+ '',
288
+ '📝 Details:',
289
+ ...integrityCheck.details.map(detail => ` - ${detail}`),
290
+ '',
291
+ integrityCheck.hasRealData
292
+ ? '🎉 VALIDATION PASSED - Real ServiceNow data confirmed!'
293
+ : '❌ VALIDATION FAILED - Suspicious data patterns detected!',
294
+ '',
295
+ '🔐 Zero Mock Data Policy: ENFORCED',
296
+ '📋 Only 100% real ServiceNow data allowed'
297
+ ].join('\n');
298
+ }
299
+ }
300
+ exports.AntiMockDataValidator = AntiMockDataValidator;
301
+ // Export singleton instance
302
+ exports.antiMockValidator = new AntiMockDataValidator();
303
+ // Export validation utilities for use in MCP servers
304
+ const validateRealData = (data, source = 'MCP Operation') => {
305
+ return exports.antiMockValidator.enforceZeroTolerancePolicy(data, source);
306
+ };
307
+ exports.validateRealData = validateRealData;
308
+ const checkDataIntegrity = (data, source = 'MCP Operation') => {
309
+ return exports.antiMockValidator.performDataIntegrityCheck(data, source);
310
+ };
311
+ exports.checkDataIntegrity = checkDataIntegrity;
312
+ const generateDataReport = (data, source = 'MCP Operation') => {
313
+ return exports.antiMockValidator.generateValidationReport(data, source);
314
+ };
315
+ exports.generateDataReport = generateDataReport;
316
+ //# sourceMappingURL=anti-mock-data-validator.js.map
@@ -0,0 +1,120 @@
1
+ /**
2
+ * ServiceNow Eventual Consistency Handler
3
+ *
4
+ * ServiceNow uses a distributed database architecture with eventual consistency:
5
+ * - Write operations go to primary database (immediate)
6
+ * - Read operations may use read replicas (1-3 second lag)
7
+ * - This causes race conditions in deployment verification
8
+ */
9
+ import { ServiceNowClient } from './servicenow-client.js';
10
+ export interface RetryConfig {
11
+ maxRetries?: number;
12
+ baseDelay?: number;
13
+ maxDelay?: number;
14
+ backoffMultiplier?: number;
15
+ }
16
+ export interface VerificationResult {
17
+ success: boolean;
18
+ attempts: number;
19
+ finalAttemptError?: any;
20
+ isLikelyTimingIssue: boolean;
21
+ }
22
+ export declare class ServiceNowEventualConsistency {
23
+ private logger;
24
+ constructor(loggerName?: string);
25
+ /**
26
+ * Retry a ServiceNow operation with exponential backoff
27
+ * Designed specifically for post-deployment verification
28
+ */
29
+ retryWithBackoff<T>(operation: () => Promise<T>, config?: RetryConfig): Promise<{
30
+ result: T | null;
31
+ success: boolean;
32
+ attempts: number;
33
+ }>;
34
+ /**
35
+ * Verify a ServiceNow record exists with retry logic
36
+ */
37
+ verifyRecordExists(client: ServiceNowClient, table: string, sys_id: string, config?: RetryConfig): Promise<VerificationResult>;
38
+ /**
39
+ * Verify multiple records exist (batch verification)
40
+ */
41
+ verifyMultipleRecords(client: ServiceNowClient, verifications: Array<{
42
+ table: string;
43
+ sys_id: string;
44
+ name?: string;
45
+ }>, config?: RetryConfig): Promise<Array<VerificationResult & {
46
+ table: string;
47
+ sys_id: string;
48
+ name?: string;
49
+ }>>;
50
+ /**
51
+ * Execute operation with eventual consistency retry
52
+ * Generic wrapper for any ServiceNow operation that might fail due to timing
53
+ */
54
+ executeWithRetry<T>(operationName: string, operation: () => Promise<T>, validator: (result: T) => boolean, config?: RetryConfig): Promise<{
55
+ result: T | null;
56
+ success: boolean;
57
+ metadata: any;
58
+ }>;
59
+ /**
60
+ * Sleep utility
61
+ */
62
+ private sleep;
63
+ /**
64
+ * Determine if an error indicates a permanent failure vs timing issue
65
+ */
66
+ private isPermanentError;
67
+ /**
68
+ * Get user-friendly error description
69
+ */
70
+ private getErrorDescription;
71
+ /**
72
+ * Assess if failure is likely due to timing issues
73
+ */
74
+ private assessIfTimingIssue;
75
+ /**
76
+ * Create a pre-configured instance for widget deployments
77
+ */
78
+ static createForWidgets(): ServiceNowEventualConsistency;
79
+ /**
80
+ * Create a pre-configured instance for flow deployments
81
+ */
82
+ static createForFlows(): ServiceNowEventualConsistency;
83
+ /**
84
+ * Create a pre-configured instance for application deployments
85
+ */
86
+ static createForApplications(): ServiceNowEventualConsistency;
87
+ }
88
+ /**
89
+ * Default configuration for different deployment types
90
+ */
91
+ export declare const CONSISTENCY_CONFIGS: {
92
+ WIDGET: {
93
+ maxRetries: number;
94
+ baseDelay: number;
95
+ maxDelay: number;
96
+ backoffMultiplier: number;
97
+ };
98
+ FLOW: {
99
+ maxRetries: number;
100
+ baseDelay: number;
101
+ maxDelay: number;
102
+ backoffMultiplier: number;
103
+ };
104
+ APPLICATION: {
105
+ maxRetries: number;
106
+ baseDelay: number;
107
+ maxDelay: number;
108
+ backoffMultiplier: number;
109
+ };
110
+ BATCH: {
111
+ maxRetries: number;
112
+ baseDelay: number;
113
+ maxDelay: number;
114
+ backoffMultiplier: number;
115
+ };
116
+ };
117
+ export declare const widgetConsistency: ServiceNowEventualConsistency;
118
+ export declare const flowConsistency: ServiceNowEventualConsistency;
119
+ export declare const appConsistency: ServiceNowEventualConsistency;
120
+ //# sourceMappingURL=servicenow-eventual-consistency.d.ts.map
@@ -0,0 +1,220 @@
1
+ "use strict";
2
+ /**
3
+ * ServiceNow Eventual Consistency Handler
4
+ *
5
+ * ServiceNow uses a distributed database architecture with eventual consistency:
6
+ * - Write operations go to primary database (immediate)
7
+ * - Read operations may use read replicas (1-3 second lag)
8
+ * - This causes race conditions in deployment verification
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.appConsistency = exports.flowConsistency = exports.widgetConsistency = exports.CONSISTENCY_CONFIGS = exports.ServiceNowEventualConsistency = void 0;
12
+ const logger_js_1 = require("./logger.js");
13
+ class ServiceNowEventualConsistency {
14
+ constructor(loggerName = 'EventualConsistency') {
15
+ this.logger = new logger_js_1.Logger(loggerName);
16
+ }
17
+ /**
18
+ * Retry a ServiceNow operation with exponential backoff
19
+ * Designed specifically for post-deployment verification
20
+ */
21
+ async retryWithBackoff(operation, config = {}) {
22
+ const { maxRetries = 5, baseDelay = 1000, maxDelay = 8000, backoffMultiplier = 1.5 } = config;
23
+ let lastError;
24
+ for (let attempt = 0; attempt < maxRetries; attempt++) {
25
+ try {
26
+ if (attempt > 0) {
27
+ const delay = Math.min(baseDelay * Math.pow(backoffMultiplier, attempt), maxDelay);
28
+ this.logger.info(`⏳ Retry attempt ${attempt + 1}/${maxRetries} (waiting ${delay}ms for consistency)`);
29
+ await this.sleep(delay);
30
+ }
31
+ const result = await operation();
32
+ if (result) {
33
+ this.logger.info(`✅ Operation succeeded on attempt ${attempt + 1}`);
34
+ return { result, success: true, attempts: attempt + 1 };
35
+ }
36
+ }
37
+ catch (error) {
38
+ lastError = error;
39
+ if (this.isPermanentError(error)) {
40
+ this.logger.error(`❌ Permanent error detected:`, error);
41
+ return { result: null, success: false, attempts: attempt + 1 };
42
+ }
43
+ if (attempt === 0) {
44
+ this.logger.info(`⏳ ${this.getErrorDescription(error)} - typical ServiceNow consistency issue`);
45
+ }
46
+ else {
47
+ this.logger.info(`⏳ Still getting ${error.status || 'error'}, retrying...`);
48
+ }
49
+ }
50
+ }
51
+ this.logger.warn(`⚠️ Operation failed after ${maxRetries} attempts`);
52
+ this.logger.warn(`⚠️ Last error: ${lastError?.message || 'Unknown'}`);
53
+ return { result: null, success: false, attempts: maxRetries };
54
+ }
55
+ /**
56
+ * Verify a ServiceNow record exists with retry logic
57
+ */
58
+ async verifyRecordExists(client, table, sys_id, config = {}) {
59
+ this.logger.info(`🔍 Verifying ${table} record ${sys_id} (handling eventual consistency)`);
60
+ const operation = async () => {
61
+ const response = await client.getRecord(table, sys_id);
62
+ return response && response.sys_id === sys_id ? response : null;
63
+ };
64
+ const { result, success, attempts } = await this.retryWithBackoff(operation, config);
65
+ if (!success) {
66
+ const isLikelyTimingIssue = this.assessIfTimingIssue(attempts, config.maxRetries);
67
+ if (isLikelyTimingIssue) {
68
+ this.logger.warn(`⚠️ This appears to be a ServiceNow consistency issue, not a deployment failure`);
69
+ this.logger.warn(`⚠️ Check directly: /${table}.do?sys_id=${sys_id}`);
70
+ }
71
+ return {
72
+ success: false,
73
+ attempts,
74
+ isLikelyTimingIssue
75
+ };
76
+ }
77
+ return {
78
+ success: true,
79
+ attempts,
80
+ isLikelyTimingIssue: false
81
+ };
82
+ }
83
+ /**
84
+ * Verify multiple records exist (batch verification)
85
+ */
86
+ async verifyMultipleRecords(client, verifications, config = {}) {
87
+ const results = [];
88
+ for (const verification of verifications) {
89
+ const result = await this.verifyRecordExists(client, verification.table, verification.sys_id, config);
90
+ results.push({
91
+ ...result,
92
+ table: verification.table,
93
+ sys_id: verification.sys_id,
94
+ name: verification.name
95
+ });
96
+ // Small delay between verifications to avoid rate limiting
97
+ if (verifications.length > 1) {
98
+ await this.sleep(200);
99
+ }
100
+ }
101
+ return results;
102
+ }
103
+ /**
104
+ * Execute operation with eventual consistency retry
105
+ * Generic wrapper for any ServiceNow operation that might fail due to timing
106
+ */
107
+ async executeWithRetry(operationName, operation, validator, config = {}) {
108
+ this.logger.info(`🚀 Executing ${operationName} with consistency handling`);
109
+ const { result, success, attempts } = await this.retryWithBackoff(async () => {
110
+ const opResult = await operation();
111
+ return validator(opResult) ? opResult : null;
112
+ }, config);
113
+ return {
114
+ result,
115
+ success,
116
+ metadata: {
117
+ operationName,
118
+ attempts,
119
+ isLikelyTimingIssue: !success && this.assessIfTimingIssue(attempts, config.maxRetries)
120
+ }
121
+ };
122
+ }
123
+ /**
124
+ * Sleep utility
125
+ */
126
+ sleep(ms) {
127
+ return new Promise(resolve => setTimeout(resolve, ms));
128
+ }
129
+ /**
130
+ * Determine if an error indicates a permanent failure vs timing issue
131
+ */
132
+ isPermanentError(error) {
133
+ // Permanent errors that shouldn't be retried
134
+ if (error.status === 401)
135
+ return true; // Authentication
136
+ if (error.status === 400 && !error.message?.includes('null'))
137
+ return true; // Bad request
138
+ if (error.message?.includes('table does not exist'))
139
+ return true; // Invalid table
140
+ if (error.message?.includes('permission denied') && error.status !== 403)
141
+ return true; // Real permission issues
142
+ return false;
143
+ }
144
+ /**
145
+ * Get user-friendly error description
146
+ */
147
+ getErrorDescription(error) {
148
+ if (error.status === 403)
149
+ return 'Access temporarily denied (403)';
150
+ if (error.status === 404)
151
+ return 'Record not found (404)';
152
+ if (error.message?.includes('null'))
153
+ return 'Null response received';
154
+ return `Error ${error.status || 'unknown'}`;
155
+ }
156
+ /**
157
+ * Assess if failure is likely due to timing issues
158
+ */
159
+ assessIfTimingIssue(attempts, maxRetries = 5) {
160
+ // If we exhausted all retries and got timing-related errors, it's likely a timing issue
161
+ return attempts >= maxRetries;
162
+ }
163
+ /**
164
+ * Create a pre-configured instance for widget deployments
165
+ */
166
+ static createForWidgets() {
167
+ return new ServiceNowEventualConsistency('WidgetConsistency');
168
+ }
169
+ /**
170
+ * Create a pre-configured instance for flow deployments
171
+ */
172
+ static createForFlows() {
173
+ return new ServiceNowEventualConsistency('FlowConsistency');
174
+ }
175
+ /**
176
+ * Create a pre-configured instance for application deployments
177
+ */
178
+ static createForApplications() {
179
+ return new ServiceNowEventualConsistency('AppConsistency');
180
+ }
181
+ }
182
+ exports.ServiceNowEventualConsistency = ServiceNowEventualConsistency;
183
+ /**
184
+ * Default configuration for different deployment types
185
+ */
186
+ exports.CONSISTENCY_CONFIGS = {
187
+ // Fast retry for simple records
188
+ WIDGET: {
189
+ maxRetries: 5,
190
+ baseDelay: 800,
191
+ maxDelay: 6000,
192
+ backoffMultiplier: 1.4
193
+ },
194
+ // Medium retry for complex records
195
+ FLOW: {
196
+ maxRetries: 6,
197
+ baseDelay: 1200,
198
+ maxDelay: 8000,
199
+ backoffMultiplier: 1.5
200
+ },
201
+ // Longer retry for applications with dependencies
202
+ APPLICATION: {
203
+ maxRetries: 8,
204
+ baseDelay: 1500,
205
+ maxDelay: 12000,
206
+ backoffMultiplier: 1.6
207
+ },
208
+ // Quick check for batch operations
209
+ BATCH: {
210
+ maxRetries: 3,
211
+ baseDelay: 500,
212
+ maxDelay: 3000,
213
+ backoffMultiplier: 1.3
214
+ }
215
+ };
216
+ // Export singleton instances
217
+ exports.widgetConsistency = ServiceNowEventualConsistency.createForWidgets();
218
+ exports.flowConsistency = ServiceNowEventualConsistency.createForFlows();
219
+ exports.appConsistency = ServiceNowEventualConsistency.createForApplications();
220
+ //# sourceMappingURL=servicenow-eventual-consistency.js.map
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "snow-flow",
3
- "version": "3.0.10",
4
- "description": "Snow-Flow v3.0.10: REPORTING & DASHBOARD FIXES! Complete overhaul of reporting and dashboard MCPs. Fixed dashboard visibility in ServiceNow (now uses pa_dashboards, sys_portal_page with intelligent fallback). Reports now properly fetch data with correct field configuration. KPIs and Performance Analytics work correctly. All dashboard and report creation tools now functional with proper ServiceNow API integration. Plus all previous features: Codespaces support, Claude Code integration, 100+ MCP tools.",
3
+ "version": "3.0.14",
4
+ "description": "Snow-Flow v3.0.14: WRITE PERMISSIONS FIX! 🔧 Fixed 'this.client.create is not a function' error that was blocking all deployments. Corrected API method calls to use createRecord/deleteRecord. Write permissions diagnostic now works correctly. Plus all features: Zero Mock Data Guarantee, race condition fixes, intelligent reporting, and 100+ MCP tools.",
5
5
  "main": "dist/index.js",
6
6
  "type": "commonjs",
7
7
  "bin": {
@@ -358,7 +358,8 @@
358
358
  "mcpCapabilities": {
359
359
  "realApiIntegration": true,
360
360
  "noMockData": true,
361
- "mockDataNote": "NO MOCK DATA - All ML operations require real ServiceNow PA/PI licenses",
361
+ "mockDataNote": "🔥 ZERO MOCK DATA GUARANTEE - All reports, dashboards, and analytics use 100% REAL ServiceNow data from your actual instance. NO demo/sample/test data ever used.",
362
+ "reportingDataPolicy": "ALL LIVE DATA - Every report, dashboard, chart, and KPI populated exclusively with real records from your ServiceNow tables",
362
363
  "productionReady": true,
363
364
  "batchOptimization": true,
364
365
  "intelligentAnalysis": true,