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,866 +0,0 @@
1
- /**
2
- * 🚀 Smart Rollback System for Deployment Failures
3
- *
4
- * Advanced rollback system that automatically detects deployment failures,
5
- * creates recovery plans, and executes intelligent rollback strategies
6
- * with minimal downtime and data preservation.
7
- */
8
-
9
- import { Logger } from '../utils/logger.js';
10
- import { ServiceNowClient } from '../utils/servicenow-client.js';
11
- import { MemorySystem } from '../memory/memory-system.js';
12
- // Flow generator removed in v1.4.0
13
- // import { XMLFlowDefinition } from '../utils/xml-first-flow-generator.js';
14
-
15
- export interface RollbackPoint {
16
- id: string;
17
- name: string;
18
- description: string;
19
- createdAt: string;
20
- type: 'automatic' | 'manual' | 'scheduled';
21
- trigger: RollbackTrigger;
22
- snapshot: SystemSnapshot;
23
- metadata: {
24
- deploymentId?: string;
25
- updateSetId?: string;
26
- userId: string;
27
- environment: string;
28
- artifacts: ArtifactBackup[];
29
- };
30
- status: 'active' | 'used' | 'expired' | 'corrupted';
31
- retentionPolicy: RetentionPolicy;
32
- }
33
-
34
- export interface RollbackTrigger {
35
- type: 'deployment_failure' | 'performance_degradation' | 'error_threshold' | 'manual' | 'scheduled';
36
- condition?: string;
37
- threshold?: {
38
- metric: string;
39
- value: number;
40
- operator: '<' | '>' | '=' | '<=' | '>=';
41
- };
42
- timeWindow?: number; // milliseconds
43
- severity: 'low' | 'medium' | 'high' | 'critical';
44
- }
45
-
46
- export interface SystemSnapshot {
47
- timestamp: string;
48
- version: string;
49
- components: ComponentSnapshot[];
50
- dependencies: DependencyMap[];
51
- configuration: ConfigurationSnapshot;
52
- data: DataSnapshot;
53
- integrity: IntegrityCheck;
54
- }
55
-
56
- export interface ComponentSnapshot {
57
- type: 'flow' | 'widget' | 'script' | 'table' | 'business_rule' | 'client_script';
58
- id: string;
59
- name: string;
60
- state: any;
61
- version: string;
62
- dependencies: string[];
63
- checksum: string;
64
- }
65
-
66
- export interface DependencyMap {
67
- from: string;
68
- to: string;
69
- type: 'required' | 'optional' | 'circular';
70
- version?: string;
71
- }
72
-
73
- export interface ConfigurationSnapshot {
74
- updateSets: UpdateSetBackup[];
75
- systemProperties: Record<string, any>;
76
- userPermissions: PermissionSnapshot[];
77
- activeSchedules: ScheduleSnapshot[];
78
- }
79
-
80
- export interface DataSnapshot {
81
- criticalTables: TableBackup[];
82
- recentChanges: ChangeRecord[];
83
- transactionLog: TransactionEntry[];
84
- consistencyCheck: ConsistencyResult;
85
- }
86
-
87
- export interface ArtifactBackup {
88
- type: string;
89
- id: string;
90
- name: string;
91
- content: string;
92
- checksum: string;
93
- dependencies: string[];
94
- backupLocation: string;
95
- }
96
-
97
- export interface UpdateSetBackup {
98
- sys_id: string;
99
- name: string;
100
- state: string;
101
- xml: string;
102
- changes: ChangeRecord[];
103
- }
104
-
105
- export interface PermissionSnapshot {
106
- userId: string;
107
- roles: string[];
108
- groups: string[];
109
- permissions: string[];
110
- }
111
-
112
- export interface ScheduleSnapshot {
113
- id: string;
114
- name: string;
115
- type: string;
116
- schedule: string;
117
- active: boolean;
118
- }
119
-
120
- export interface TableBackup {
121
- name: string;
122
- records: Record<string, any>[];
123
- schema: TableSchema;
124
- indexes: IndexDefinition[];
125
- }
126
-
127
- export interface ChangeRecord {
128
- table: string;
129
- sys_id: string;
130
- operation: 'insert' | 'update' | 'delete';
131
- before?: any;
132
- after?: any;
133
- timestamp: string;
134
- user: string;
135
- }
136
-
137
- export interface TransactionEntry {
138
- id: string;
139
- timestamp: string;
140
- operation: string;
141
- success: boolean;
142
- error?: string;
143
- rollbackable: boolean;
144
- }
145
-
146
- export interface TableSchema {
147
- fields: FieldDefinition[];
148
- relationships: RelationshipDefinition[];
149
- constraints: ConstraintDefinition[];
150
- }
151
-
152
- export interface FieldDefinition {
153
- name: string;
154
- type: string;
155
- nullable: boolean;
156
- defaultValue?: any;
157
- }
158
-
159
- export interface RelationshipDefinition {
160
- type: 'one_to_one' | 'one_to_many' | 'many_to_many';
161
- fromTable: string;
162
- toTable: string;
163
- fromField: string;
164
- toField: string;
165
- }
166
-
167
- export interface ConstraintDefinition {
168
- name: string;
169
- type: 'primary_key' | 'foreign_key' | 'unique' | 'check';
170
- fields: string[];
171
- reference?: string;
172
- }
173
-
174
- export interface IndexDefinition {
175
- name: string;
176
- fields: string[];
177
- unique: boolean;
178
- type: 'btree' | 'hash' | 'gist' | 'gin';
179
- }
180
-
181
- export interface IntegrityCheck {
182
- checksum: string;
183
- timestamp: string;
184
- valid: boolean;
185
- errors: string[];
186
- }
187
-
188
- export interface ConsistencyResult {
189
- valid: boolean;
190
- issues: ConsistencyIssue[];
191
- recommendations: string[];
192
- }
193
-
194
- export interface ConsistencyIssue {
195
- severity: 'low' | 'medium' | 'high' | 'critical';
196
- type: 'referential_integrity' | 'data_corruption' | 'orphaned_records' | 'duplicate_keys';
197
- description: string;
198
- affectedRecords: string[];
199
- autoFixable: boolean;
200
- }
201
-
202
- export interface RetentionPolicy {
203
- maxAge: number; // milliseconds
204
- maxCount: number;
205
- compressionEnabled: boolean;
206
- archiveLocation?: string;
207
- }
208
-
209
- export interface RollbackPlan {
210
- id: string;
211
- name: string;
212
- description: string;
213
- createdAt: string;
214
- rollbackPointId: string;
215
- strategy: RollbackStrategy;
216
- steps: RollbackStep[];
217
- estimatedTime: number;
218
- riskLevel: 'low' | 'medium' | 'high' | 'critical';
219
- impactAssessment: ImpactAssessment;
220
- validationChecks: ValidationCheck[];
221
- }
222
-
223
- export interface RollbackStrategy {
224
- type: 'full_restore' | 'selective_restore' | 'incremental_rollback' | 'blue_green_switch';
225
- approach: 'aggressive' | 'conservative' | 'minimal_impact';
226
- preserveData: boolean;
227
- maintainSessions: boolean;
228
- downtime: 'zero' | 'minimal' | 'scheduled';
229
- }
230
-
231
- export interface RollbackStep {
232
- order: number;
233
- name: string;
234
- description: string;
235
- action: string;
236
- parameters: Record<string, any>;
237
- reversible: boolean;
238
- critical: boolean;
239
- estimatedTime: number;
240
- dependencies: string[];
241
- validationRequired: boolean;
242
- }
243
-
244
- export interface ImpactAssessment {
245
- affectedUsers: number;
246
- affectedSystems: string[];
247
- dataLoss: 'none' | 'minimal' | 'moderate' | 'significant';
248
- downtime: number; // milliseconds
249
- businessImpact: 'low' | 'medium' | 'high' | 'critical';
250
- complianceViolations: string[];
251
- }
252
-
253
- export interface ValidationCheck {
254
- name: string;
255
- description: string;
256
- type: 'pre_rollback' | 'post_rollback' | 'continuous';
257
- script: string;
258
- expectedResult: any;
259
- critical: boolean;
260
- timeout: number;
261
- }
262
-
263
- export interface RollbackExecution {
264
- planId: string;
265
- executionId: string;
266
- startTime: string;
267
- endTime?: string;
268
- status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
269
- progress: number;
270
- currentStep?: number;
271
- results: StepResult[];
272
- issues: ExecutionIssue[];
273
- metrics: ExecutionMetrics;
274
- }
275
-
276
- export interface StepResult {
277
- stepOrder: number;
278
- name: string;
279
- status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
280
- startTime: string;
281
- endTime?: string;
282
- result?: any;
283
- error?: string;
284
- validationResults: ValidationResult[];
285
- }
286
-
287
- export interface ValidationResult {
288
- check: string;
289
- passed: boolean;
290
- message: string;
291
- expected: any;
292
- actual: any;
293
- }
294
-
295
- export interface ExecutionIssue {
296
- severity: 'low' | 'medium' | 'high' | 'critical';
297
- type: 'validation_failure' | 'step_failure' | 'timeout' | 'dependency_error';
298
- description: string;
299
- step?: number;
300
- resolution?: string;
301
- autoResolved: boolean;
302
- }
303
-
304
- export interface ExecutionMetrics {
305
- totalSteps: number;
306
- completedSteps: number;
307
- failedSteps: number;
308
- skippedSteps: number;
309
- totalTime: number;
310
- averageStepTime: number;
311
- resourceUsage: ResourceUsage;
312
- }
313
-
314
- export interface ResourceUsage {
315
- memory: number;
316
- cpu: number;
317
- disk: number;
318
- network: number;
319
- }
320
-
321
- export class SmartRollbackSystem {
322
- private logger: Logger;
323
- private client: ServiceNowClient;
324
- private memory: MemorySystem;
325
- private rollbackPoints: Map<string, RollbackPoint> = new Map();
326
- private rollbackPlans: Map<string, RollbackPlan> = new Map();
327
- private activeExecutions: Map<string, RollbackExecution> = new Map();
328
- private monitoringEnabled: boolean = true;
329
-
330
- constructor(client: ServiceNowClient, memory: MemorySystem) {
331
- this.logger = new Logger('SmartRollbackSystem');
332
- this.client = client;
333
- this.memory = memory;
334
-
335
- // Start monitoring for automatic rollback triggers
336
- this.startMonitoring();
337
- }
338
-
339
- /**
340
- * Create a new rollback point before deployment
341
- */
342
- async createRollbackPoint(
343
- name: string,
344
- description: string,
345
- options: {
346
- type?: 'automatic' | 'manual' | 'scheduled';
347
- triggers?: RollbackTrigger[];
348
- includeData?: boolean;
349
- compressionEnabled?: boolean;
350
- } = {}
351
- ): Promise<RollbackPoint> {
352
- this.logger.info('🔄 Creating rollback point', { name, options });
353
-
354
- const rollbackPointId = `rb_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
355
-
356
- try {
357
- // Create system snapshot
358
- const snapshot = await this.createSystemSnapshot(options.includeData || false);
359
-
360
- // Create rollback point
361
- const rollbackPoint: RollbackPoint = {
362
- id: rollbackPointId,
363
- name,
364
- description,
365
- createdAt: new Date().toISOString(),
366
- type: options.type || 'manual',
367
- trigger: {
368
- type: 'manual',
369
- severity: 'medium'
370
- },
371
- snapshot,
372
- metadata: {
373
- userId: 'system',
374
- environment: process.env.NODE_ENV || 'development',
375
- artifacts: []
376
- },
377
- status: 'active',
378
- retentionPolicy: {
379
- maxAge: 604800000, // 7 days
380
- maxCount: 10,
381
- compressionEnabled: options.compressionEnabled || true
382
- }
383
- };
384
-
385
- // Store rollback point
386
- this.rollbackPoints.set(rollbackPointId, rollbackPoint);
387
- await this.memory.store(`rollback_point_${rollbackPointId}`, rollbackPoint, rollbackPoint.retentionPolicy.maxAge);
388
-
389
- // Clean up old rollback points
390
- await this.cleanupOldRollbackPoints();
391
-
392
- this.logger.info('✅ Rollback point created successfully', {
393
- id: rollbackPointId,
394
- snapshotSize: JSON.stringify(snapshot).length,
395
- artifactsCount: rollbackPoint.metadata.artifacts.length
396
- });
397
-
398
- return rollbackPoint;
399
-
400
- } catch (error) {
401
- this.logger.error('❌ Failed to create rollback point', error);
402
- throw error;
403
- }
404
- }
405
-
406
- /**
407
- * Generate intelligent rollback plan
408
- */
409
- async generateRollbackPlan(
410
- rollbackPointId: string,
411
- options: {
412
- strategy?: 'conservative' | 'aggressive' | 'minimal_impact';
413
- preserveData?: boolean;
414
- targetDowntime?: number;
415
- } = {}
416
- ): Promise<RollbackPlan> {
417
- this.logger.info('📋 Generating rollback plan', { rollbackPointId, options });
418
-
419
- const rollbackPoint = this.rollbackPoints.get(rollbackPointId);
420
- if (!rollbackPoint) {
421
- throw new Error(`Rollback point not found: ${rollbackPointId}`);
422
- }
423
-
424
- const planId = `plan_${Date.now()}_${Math.random().toString(36).substr(2, 6)}`;
425
-
426
- try {
427
- // Analyze current system state vs rollback point
428
- const currentSnapshot = await this.createSystemSnapshot(false);
429
- const differences = this.analyzeDifferences(rollbackPoint.snapshot, currentSnapshot);
430
-
431
- // Determine rollback strategy
432
- const strategy = this.determineOptimalStrategy(differences, options);
433
-
434
- // Generate rollback steps
435
- const steps = await this.generateRollbackSteps(differences, strategy);
436
-
437
- // Assess impact
438
- const impactAssessment = this.assessRollbackImpact(differences, strategy);
439
-
440
- // Generate validation checks
441
- const validationChecks = this.generateValidationChecks(rollbackPoint, steps);
442
-
443
- const rollbackPlan: RollbackPlan = {
444
- id: planId,
445
- name: `Rollback to: ${rollbackPoint.name}`,
446
- description: `Intelligent rollback plan generated for rollback point: ${rollbackPoint.name}`,
447
- createdAt: new Date().toISOString(),
448
- rollbackPointId,
449
- strategy,
450
- steps,
451
- estimatedTime: steps.reduce((total, step) => total + step.estimatedTime, 0),
452
- riskLevel: this.calculateRiskLevel(impactAssessment, strategy),
453
- impactAssessment,
454
- validationChecks
455
- };
456
-
457
- // Store rollback plan
458
- this.rollbackPlans.set(planId, rollbackPlan);
459
- await this.memory.store(`rollback_plan_${planId}`, rollbackPlan, 86400000); // 24 hours
460
-
461
- this.logger.info('✅ Rollback plan generated', {
462
- planId,
463
- stepsCount: steps.length,
464
- estimatedTime: rollbackPlan.estimatedTime,
465
- riskLevel: rollbackPlan.riskLevel
466
- });
467
-
468
- return rollbackPlan;
469
-
470
- } catch (error) {
471
- this.logger.error('❌ Failed to generate rollback plan', error);
472
- throw error;
473
- }
474
- }
475
-
476
- /**
477
- * Execute rollback plan with monitoring
478
- */
479
- async executeRollbackPlan(
480
- planId: string,
481
- options: {
482
- dryRun?: boolean;
483
- skipValidation?: boolean;
484
- continueOnError?: boolean;
485
- } = {}
486
- ): Promise<RollbackExecution> {
487
- this.logger.info('🚀 Executing rollback plan', { planId, options });
488
-
489
- const plan = this.rollbackPlans.get(planId);
490
- if (!plan) {
491
- throw new Error(`Rollback plan not found: ${planId}`);
492
- }
493
-
494
- const executionId = `exec_${Date.now()}_${Math.random().toString(36).substr(2, 6)}`;
495
-
496
- const execution: RollbackExecution = {
497
- planId,
498
- executionId,
499
- startTime: new Date().toISOString(),
500
- status: 'pending',
501
- progress: 0,
502
- results: [],
503
- issues: [],
504
- metrics: {
505
- totalSteps: plan.steps.length,
506
- completedSteps: 0,
507
- failedSteps: 0,
508
- skippedSteps: 0,
509
- totalTime: 0,
510
- averageStepTime: 0,
511
- resourceUsage: {
512
- memory: 0,
513
- cpu: 0,
514
- disk: 0,
515
- network: 0
516
- }
517
- }
518
- };
519
-
520
- this.activeExecutions.set(executionId, execution);
521
-
522
- try {
523
- execution.status = 'running';
524
-
525
- // Pre-rollback validation
526
- if (!options.skipValidation) {
527
- await this.runValidationChecks(plan, 'pre_rollback', execution);
528
- }
529
-
530
- // Execute rollback steps
531
- for (let i = 0; i < plan.steps.length; i++) {
532
- const step = plan.steps[i];
533
- execution.currentStep = i + 1;
534
- execution.progress = ((i + 1) / plan.steps.length) * 100;
535
-
536
- this.logger.info(`Executing step ${i + 1}/${plan.steps.length}: ${step.name}`);
537
-
538
- const stepResult = await this.executeRollbackStep(step, options.dryRun || false, execution);
539
- execution.results.push(stepResult);
540
-
541
- if (stepResult.status === 'failed') {
542
- execution.metrics.failedSteps++;
543
-
544
- if (step.critical && !options.continueOnError) {
545
- execution.issues.push({
546
- severity: 'critical',
547
- type: 'step_failure',
548
- description: `Critical step failed: ${step.name}`,
549
- step: i + 1,
550
- autoResolved: false
551
- });
552
-
553
- execution.status = 'failed';
554
- break;
555
- }
556
- } else if (stepResult.status === 'completed') {
557
- execution.metrics.completedSteps++;
558
- } else if (stepResult.status === 'skipped') {
559
- execution.metrics.skippedSteps++;
560
- }
561
-
562
- // Update metrics
563
- await this.updateExecutionMetrics(execution);
564
- }
565
-
566
- // Post-rollback validation
567
- if (!options.skipValidation && execution.status !== 'failed') {
568
- await this.runValidationChecks(plan, 'post_rollback', execution);
569
- }
570
-
571
- // Finalize execution
572
- if (execution.status === 'running') {
573
- execution.status = 'completed';
574
- }
575
-
576
- execution.endTime = new Date().toISOString();
577
- execution.progress = 100;
578
- execution.metrics.totalTime = Date.now() - new Date(execution.startTime).getTime();
579
- execution.metrics.averageStepTime = execution.metrics.totalTime / execution.metrics.totalSteps;
580
-
581
- this.logger.info('✅ Rollback execution completed', {
582
- executionId,
583
- status: execution.status,
584
- completedSteps: execution.metrics.completedSteps,
585
- failedSteps: execution.metrics.failedSteps,
586
- totalTime: execution.metrics.totalTime
587
- });
588
-
589
- return execution;
590
-
591
- } catch (error) {
592
- execution.status = 'failed';
593
- execution.endTime = new Date().toISOString();
594
- execution.issues.push({
595
- severity: 'critical',
596
- type: 'step_failure',
597
- description: `Rollback execution failed: ${error instanceof Error ? error.message : String(error)}`,
598
- autoResolved: false
599
- });
600
-
601
- this.logger.error('❌ Rollback execution failed', error);
602
- throw error;
603
-
604
- } finally {
605
- // Store execution results
606
- await this.memory.store(`rollback_execution_${executionId}`, execution, 604800000); // 7 days
607
- this.activeExecutions.delete(executionId);
608
- }
609
- }
610
-
611
- /**
612
- * Get rollback points with filtering
613
- */
614
- getRollbackPoints(filter?: {
615
- type?: string;
616
- status?: string;
617
- maxAge?: number;
618
- }): RollbackPoint[] {
619
- let points = Array.from(this.rollbackPoints.values());
620
-
621
- if (filter) {
622
- if (filter.type) {
623
- points = points.filter(p => p.type === filter.type);
624
- }
625
- if (filter.status) {
626
- points = points.filter(p => p.status === filter.status);
627
- }
628
- if (filter.maxAge) {
629
- const cutoff = Date.now() - filter.maxAge;
630
- points = points.filter(p => new Date(p.createdAt).getTime() > cutoff);
631
- }
632
- }
633
-
634
- return points.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
635
- }
636
-
637
- /**
638
- * Get active rollback executions
639
- */
640
- getActiveExecutions(): RollbackExecution[] {
641
- return Array.from(this.activeExecutions.values());
642
- }
643
-
644
- /**
645
- * Cancel active rollback execution
646
- */
647
- async cancelExecution(executionId: string): Promise<boolean> {
648
- const execution = this.activeExecutions.get(executionId);
649
- if (!execution) {
650
- return false;
651
- }
652
-
653
- execution.status = 'cancelled';
654
- execution.endTime = new Date().toISOString();
655
-
656
- this.logger.info('🛑 Rollback execution cancelled', { executionId });
657
- return true;
658
- }
659
-
660
- /**
661
- * Private helper methods
662
- */
663
-
664
- private async createSystemSnapshot(includeData: boolean): Promise<SystemSnapshot> {
665
- // Implementation for creating comprehensive system snapshot
666
- return {
667
- timestamp: new Date().toISOString(),
668
- version: '1.0.0',
669
- components: [],
670
- dependencies: [],
671
- configuration: {
672
- updateSets: [],
673
- systemProperties: {},
674
- userPermissions: [],
675
- activeSchedules: []
676
- },
677
- data: {
678
- criticalTables: [],
679
- recentChanges: [],
680
- transactionLog: [],
681
- consistencyCheck: {
682
- valid: true,
683
- issues: [],
684
- recommendations: []
685
- }
686
- },
687
- integrity: {
688
- checksum: 'placeholder',
689
- timestamp: new Date().toISOString(),
690
- valid: true,
691
- errors: []
692
- }
693
- };
694
- }
695
-
696
- private analyzeDifferences(originalSnapshot: SystemSnapshot, currentSnapshot: SystemSnapshot): any {
697
- // Implementation for analyzing differences between snapshots
698
- return {
699
- componentChanges: [],
700
- configurationChanges: [],
701
- dataChanges: [],
702
- severity: 'medium'
703
- };
704
- }
705
-
706
- private determineOptimalStrategy(differences: any, options: any): RollbackStrategy {
707
- // Implementation for determining optimal rollback strategy
708
- return {
709
- type: 'selective_restore',
710
- approach: options.strategy || 'conservative',
711
- preserveData: options.preserveData !== false,
712
- maintainSessions: true,
713
- downtime: 'minimal'
714
- };
715
- }
716
-
717
- private async generateRollbackSteps(differences: any, strategy: RollbackStrategy): Promise<RollbackStep[]> {
718
- // Implementation for generating rollback steps
719
- return [
720
- {
721
- order: 1,
722
- name: 'Create backup',
723
- description: 'Create backup of current state before rollback',
724
- action: 'backup_current_state',
725
- parameters: {},
726
- reversible: false,
727
- critical: true,
728
- estimatedTime: 30000,
729
- dependencies: [],
730
- validationRequired: true
731
- }
732
- ];
733
- }
734
-
735
- private assessRollbackImpact(differences: any, strategy: RollbackStrategy): ImpactAssessment {
736
- // Implementation for assessing rollback impact
737
- return {
738
- affectedUsers: 0,
739
- affectedSystems: [],
740
- dataLoss: 'none',
741
- downtime: 0,
742
- businessImpact: 'low',
743
- complianceViolations: []
744
- };
745
- }
746
-
747
- private generateValidationChecks(rollbackPoint: RollbackPoint, steps: RollbackStep[]): ValidationCheck[] {
748
- // Implementation for generating validation checks
749
- return [
750
- {
751
- name: 'System Health Check',
752
- description: 'Verify system is healthy after rollback',
753
- type: 'post_rollback',
754
- script: 'return system.isHealthy();',
755
- expectedResult: true,
756
- critical: true,
757
- timeout: 30000
758
- }
759
- ];
760
- }
761
-
762
- private calculateRiskLevel(impact: ImpactAssessment, strategy: RollbackStrategy): 'low' | 'medium' | 'high' | 'critical' {
763
- // Implementation for calculating risk level
764
- return 'medium';
765
- }
766
-
767
- private async executeRollbackStep(step: RollbackStep, dryRun: boolean, execution: RollbackExecution): Promise<StepResult> {
768
- const stepResult: StepResult = {
769
- stepOrder: step.order,
770
- name: step.name,
771
- status: 'running',
772
- startTime: new Date().toISOString(),
773
- validationResults: []
774
- };
775
-
776
- try {
777
- if (dryRun) {
778
- this.logger.info(`[DRY RUN] Would execute: ${step.name}`);
779
- stepResult.status = 'completed';
780
- stepResult.result = { dryRun: true, message: 'Step would be executed' };
781
- } else {
782
- // Actual step execution logic would go here
783
- stepResult.status = 'completed';
784
- stepResult.result = { success: true };
785
- }
786
-
787
- stepResult.endTime = new Date().toISOString();
788
- return stepResult;
789
-
790
- } catch (error) {
791
- stepResult.status = 'failed';
792
- stepResult.error = error instanceof Error ? error.message : String(error);
793
- stepResult.endTime = new Date().toISOString();
794
-
795
- this.logger.error(`Step failed: ${step.name}`, error);
796
- return stepResult;
797
- }
798
- }
799
-
800
- private async runValidationChecks(plan: RollbackPlan, type: string, execution: RollbackExecution): Promise<void> {
801
- const checks = plan.validationChecks.filter(check => check.type === type);
802
-
803
- for (const check of checks) {
804
- try {
805
- // Run validation check logic
806
- this.logger.info(`Running validation: ${check.name}`);
807
- } catch (error) {
808
- if (check.critical) {
809
- throw error;
810
- }
811
- this.logger.warn(`Non-critical validation failed: ${check.name}`, error);
812
- }
813
- }
814
- }
815
-
816
- private async updateExecutionMetrics(execution: RollbackExecution): Promise<void> {
817
- // Update execution metrics with current resource usage
818
- execution.metrics.resourceUsage = {
819
- memory: process.memoryUsage().heapUsed,
820
- cpu: 0, // Would be calculated from system metrics
821
- disk: 0,
822
- network: 0
823
- };
824
- }
825
-
826
- private async cleanupOldRollbackPoints(): Promise<void> {
827
- const now = Date.now();
828
- const pointsToDelete: string[] = [];
829
-
830
- for (const [id, point] of this.rollbackPoints.entries()) {
831
- const age = now - new Date(point.createdAt).getTime();
832
- if (age > point.retentionPolicy.maxAge) {
833
- pointsToDelete.push(id);
834
- }
835
- }
836
-
837
- for (const id of pointsToDelete) {
838
- this.rollbackPoints.delete(id);
839
- await this.memory.delete(`rollback_point_${id}`);
840
- }
841
-
842
- if (pointsToDelete.length > 0) {
843
- this.logger.info(`Cleaned up ${pointsToDelete.length} expired rollback points`);
844
- }
845
- }
846
-
847
- private startMonitoring(): void {
848
- if (!this.monitoringEnabled) return;
849
-
850
- // Start monitoring for automatic rollback triggers
851
- setInterval(async () => {
852
- try {
853
- await this.checkAutomaticTriggers();
854
- } catch (error) {
855
- this.logger.error('Error in automatic trigger monitoring', error);
856
- }
857
- }, 30000); // Check every 30 seconds
858
- }
859
-
860
- private async checkAutomaticTriggers(): Promise<void> {
861
- // Implementation for checking automatic rollback triggers
862
- // This would monitor system health, performance metrics, error rates, etc.
863
- }
864
- }
865
-
866
- export default SmartRollbackSystem;