sinapse-ai 1.12.2 → 1.14.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 (244) hide show
  1. package/.claude/CLAUDE.md +2 -2
  2. package/.claude/rules/agent-memory-imports.md +4 -0
  3. package/.sinapse-ai/cli/commands/pro/index.js +8 -48
  4. package/.sinapse-ai/constitution.md +6 -2
  5. package/.sinapse-ai/data/entity-registry.yaml +63 -429
  6. package/.sinapse-ai/development/agents/analyst/MEMORY.md +19 -0
  7. package/.sinapse-ai/development/agents/architect/MEMORY.md +52 -0
  8. package/.sinapse-ai/development/agents/data-engineer/MEMORY.md +55 -0
  9. package/.sinapse-ai/development/agents/developer/MEMORY.md +53 -0
  10. package/.sinapse-ai/development/agents/devops/MEMORY.md +56 -0
  11. package/.sinapse-ai/development/agents/product-lead/MEMORY.md +53 -0
  12. package/.sinapse-ai/development/agents/project-lead/MEMORY.md +53 -0
  13. package/.sinapse-ai/development/agents/quality-gate/MEMORY.md +52 -0
  14. package/.sinapse-ai/development/agents/snps-orqx.md +15 -0
  15. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +53 -0
  16. package/.sinapse-ai/development/agents/squad-creator.md +15 -0
  17. package/.sinapse-ai/development/agents/ux/MEMORY.md +21 -0
  18. package/.sinapse-ai/development/templates/chrome-brain/knowledge-base/chrome-brain.md +2 -2
  19. package/.sinapse-ai/infrastructure/scripts/ide-sync/index.js +15 -0
  20. package/.sinapse-ai/infrastructure/scripts/validate-agents.js +159 -8
  21. package/.sinapse-ai/install-manifest.yaml +16 -152
  22. package/AGENTS.md +13 -2
  23. package/CHANGELOG.md +135 -3
  24. package/README.en.md +1 -1
  25. package/README.md +6 -26
  26. package/bin/cli.js +2 -7
  27. package/bin/commands/install.js +19 -257
  28. package/bin/commands/update.js +18 -78
  29. package/bin/lib/command-generator.js +261 -0
  30. package/bin/lib/prompts.js +2 -65
  31. package/bin/modules/chrome-brain-installer.js +2 -1
  32. package/bin/postinstall.js +6 -6
  33. package/docs/getting-started.md +0 -1
  34. package/docs/pt/getting-started.md +1 -1
  35. package/docs/security/dependabot-triage.md +17 -17
  36. package/package.json +6 -3
  37. package/packages/installer/src/wizard/i18n.js +3 -204
  38. package/packages/installer/src/wizard/index.js +1 -1
  39. package/packages/installer/src/wizard/questions.js +5 -368
  40. package/packages/installer/src/wizard/wizard.js +0 -9
  41. package/scripts/generate-install-manifest.js +6 -0
  42. package/scripts/validate-changelog-tags.js +97 -0
  43. package/scripts/validate-no-personal-leaks.js +184 -28
  44. package/scripts/validate-schemas.js +55 -10
  45. package/scripts/validate-story-meta.js +25 -12
  46. package/squads/claude-code-mastery/agents/claude-mastery-chief.md +15 -1
  47. package/squads/claude-code-mastery/agents/config-engineer.md +15 -0
  48. package/squads/claude-code-mastery/agents/hooks-architect.md +27 -20
  49. package/squads/claude-code-mastery/agents/mcp-integrator.md +15 -0
  50. package/squads/claude-code-mastery/agents/project-integrator.md +15 -0
  51. package/squads/claude-code-mastery/agents/roadmap-sentinel.md +15 -0
  52. package/squads/claude-code-mastery/agents/skill-craftsman.md +15 -0
  53. package/squads/claude-code-mastery/agents/swarm-orqx.md +15 -0
  54. package/squads/claude-code-mastery/tasks/audit-setup.md +1 -1
  55. package/squads/squad-animations/agents/animation-interpreter.md +15 -0
  56. package/squads/squad-animations/agents/animation-performance-engineer.md +15 -0
  57. package/squads/squad-animations/agents/animations-orqx.md +13 -0
  58. package/squads/squad-animations/agents/css-motion-artist.md +15 -0
  59. package/squads/squad-animations/agents/generative-particle-engineer.md +15 -0
  60. package/squads/squad-animations/agents/motion-choreographer.md +15 -0
  61. package/squads/squad-animations/agents/scroll-narrative-engineer.md +15 -0
  62. package/squads/squad-animations/agents/shader-artist.md +15 -0
  63. package/squads/squad-animations/agents/threejs-architect.md +15 -0
  64. package/squads/squad-brand/agents/brand-archetype-strategist.md +13 -0
  65. package/squads/squad-brand/agents/brand-auditor.md +15 -0
  66. package/squads/squad-brand/agents/brand-collateral-designer.md +15 -0
  67. package/squads/squad-brand/agents/brand-compiler.md +13 -0
  68. package/squads/squad-brand/agents/brand-creative-engineer.md +15 -0
  69. package/squads/squad-brand/agents/brand-culture-architect.md +15 -0
  70. package/squads/squad-brand/agents/brand-growth-strategist.md +15 -0
  71. package/squads/squad-brand/agents/brand-identity-designer.md +15 -0
  72. package/squads/squad-brand/agents/brand-motion-vfx.md +15 -0
  73. package/squads/squad-brand/agents/brand-naming-specialist.md +15 -0
  74. package/squads/squad-brand/agents/brand-orqx.md +13 -0
  75. package/squads/squad-brand/agents/brand-positioning-strategist.md +15 -0
  76. package/squads/squad-brand/agents/brand-sonic-designer.md +15 -0
  77. package/squads/squad-brand/agents/brand-strategist.md +15 -0
  78. package/squads/squad-brand/agents/brand-system-architect.md +15 -0
  79. package/squads/squad-cloning/agents/agent-forger.md +15 -0
  80. package/squads/squad-cloning/agents/cloning-orqx.md +15 -0
  81. package/squads/squad-cloning/agents/cognitive-extractor.md +15 -0
  82. package/squads/squad-cloning/agents/content-capturer.md +15 -0
  83. package/squads/squad-cloning/agents/kb-architect.md +15 -0
  84. package/squads/squad-cloning/agents/mind-synthesizer.md +15 -0
  85. package/squads/squad-cloning/agents/sop-extractor.md +15 -0
  86. package/squads/squad-cloning/agents/source-hunter.md +13 -0
  87. package/squads/squad-cloning/agents/squad-assembler.md +15 -0
  88. package/squads/squad-commercial/agents/commercial-orqx.md +13 -0
  89. package/squads/squad-commercial/agents/cs-business-auditor.md +15 -0
  90. package/squads/squad-commercial/agents/cs-client-success.md +15 -0
  91. package/squads/squad-commercial/agents/cs-crm-specialist.md +15 -0
  92. package/squads/squad-commercial/agents/cs-funnel-architect.md +15 -0
  93. package/squads/squad-commercial/agents/cs-lead-generation-strategist.md +15 -0
  94. package/squads/squad-commercial/agents/cs-offer-designer.md +15 -0
  95. package/squads/squad-commercial/agents/cs-revops-analyst.md +15 -0
  96. package/squads/squad-commercial/agents/cs-sales-closer.md +13 -0
  97. package/squads/squad-commercial/agents/cs-sales-enablement.md +15 -0
  98. package/squads/squad-content/agents/content-analyst.md +13 -0
  99. package/squads/squad-content/agents/content-engineer.md +15 -0
  100. package/squads/squad-content/agents/content-governor.md +13 -0
  101. package/squads/squad-content/agents/content-orqx.md +13 -0
  102. package/squads/squad-content/agents/editorial-strategist.md +15 -0
  103. package/squads/squad-content/agents/platform-specialist.md +15 -0
  104. package/squads/squad-content/agents/signal-intelligence.md +13 -0
  105. package/squads/squad-copy/agents/ad-copywriter.md +13 -0
  106. package/squads/squad-copy/agents/brand-voice-writer.md +15 -0
  107. package/squads/squad-copy/agents/conversion-writer.md +13 -0
  108. package/squads/squad-copy/agents/copy-editor.md +15 -0
  109. package/squads/squad-copy/agents/copy-orqx.md +13 -0
  110. package/squads/squad-copy/agents/copy-strategist.md +15 -0
  111. package/squads/squad-copy/agents/direct-response-writer.md +15 -0
  112. package/squads/squad-copy/agents/email-sequence-strategist.md +15 -0
  113. package/squads/squad-copy/agents/funnel-copywriter.md +15 -0
  114. package/squads/squad-copy/agents/headline-specialist.md +13 -0
  115. package/squads/squad-copy/agents/long-form-writer.md +15 -0
  116. package/squads/squad-copy/agents/persuasion-psychologist.md +15 -0
  117. package/squads/squad-copy/agents/proof-architect.md +15 -0
  118. package/squads/squad-council/agents/brene-brown.md +13 -0
  119. package/squads/squad-council/agents/charlie-munger.md +13 -0
  120. package/squads/squad-council/agents/council-orqx.md +13 -0
  121. package/squads/squad-council/agents/derek-sivers.md +13 -0
  122. package/squads/squad-council/agents/naval-ravikant.md +13 -0
  123. package/squads/squad-council/agents/patrick-lencioni.md +15 -0
  124. package/squads/squad-council/agents/peter-thiel.md +13 -0
  125. package/squads/squad-council/agents/ray-dalio.md +13 -0
  126. package/squads/squad-council/agents/reid-hoffman.md +13 -0
  127. package/squads/squad-council/agents/simon-sinek.md +15 -0
  128. package/squads/squad-council/agents/yvon-chouinard.md +13 -0
  129. package/squads/squad-courses/agents/assessment-creator.md +15 -0
  130. package/squads/squad-courses/agents/content-writer.md +15 -0
  131. package/squads/squad-courses/agents/courses-orqx.md +15 -0
  132. package/squads/squad-courses/agents/curriculum-designer.md +15 -0
  133. package/squads/squad-courses/agents/launch-strategist.md +15 -0
  134. package/squads/squad-courses/agents/lesson-architect.md +15 -0
  135. package/squads/squad-courses/agents/production-director.md +13 -0
  136. package/squads/squad-courses/agents/slide-designer.md +15 -0
  137. package/squads/squad-cybersecurity/agents/cloud-security-engineer.md +15 -0
  138. package/squads/squad-cybersecurity/agents/compliance-officer.md +15 -0
  139. package/squads/squad-cybersecurity/agents/cyber-orqx.md +15 -0
  140. package/squads/squad-cybersecurity/agents/incident-responder.md +15 -0
  141. package/squads/squad-cybersecurity/agents/network-security-engineer.md +15 -0
  142. package/squads/squad-cybersecurity/agents/penetration-tester.md +15 -0
  143. package/squads/squad-cybersecurity/agents/soc-analyst.md +15 -0
  144. package/squads/squad-cybersecurity/agents/threat-analyst.md +15 -0
  145. package/squads/squad-design/agents/cro-persuasion.md +15 -0
  146. package/squads/squad-design/agents/design-orqx.md +13 -0
  147. package/squads/squad-design/agents/design-system.md +15 -0
  148. package/squads/squad-design/agents/dx-accessibility-specialist.md +15 -0
  149. package/squads/squad-design/agents/dx-design-system-architect.md +15 -0
  150. package/squads/squad-design/agents/dx-frontend-engineer.md +15 -0
  151. package/squads/squad-design/agents/dx-interaction-designer.md +15 -0
  152. package/squads/squad-design/agents/dx-performance-engineer.md +15 -0
  153. package/squads/squad-design/agents/dx-ui-designer.md +15 -0
  154. package/squads/squad-design/agents/dx-ux-strategist.md +15 -0
  155. package/squads/squad-design/agents/platform-aesthetic-director.md +15 -0
  156. package/squads/squad-design/agents/premium-packaging-strategist.md +15 -0
  157. package/squads/squad-design/agents/product-surface-director.md +15 -0
  158. package/squads/squad-design/agents/ux-designer.md +15 -0
  159. package/squads/squad-finance/agents/budget-controller.md +15 -0
  160. package/squads/squad-finance/agents/cost-optimizer.md +15 -0
  161. package/squads/squad-finance/agents/finance-orqx.md +15 -0
  162. package/squads/squad-finance/agents/fiscal-compliance-br.md +15 -0
  163. package/squads/squad-finance/agents/forecast-strategist.md +15 -0
  164. package/squads/squad-finance/agents/pricing-strategist.md +15 -0
  165. package/squads/squad-finance/agents/profitability-analyst.md +15 -0
  166. package/squads/squad-finance/agents/revenue-analyst.md +15 -0
  167. package/squads/squad-growth/agents/ga-analytics-engineer.md +15 -0
  168. package/squads/squad-growth/agents/ga-campaign-analyst.md +15 -0
  169. package/squads/squad-growth/agents/ga-cro-specialist.md +15 -0
  170. package/squads/squad-growth/agents/ga-data-analyst.md +13 -0
  171. package/squads/squad-growth/agents/ga-growth-hacker.md +15 -0
  172. package/squads/squad-growth/agents/ga-seo-strategist.md +15 -0
  173. package/squads/squad-growth/agents/growth-orqx.md +15 -0
  174. package/squads/squad-paidmedia/agents/campaign-analyst.md +15 -0
  175. package/squads/squad-paidmedia/agents/creative-strategist.md +15 -0
  176. package/squads/squad-paidmedia/agents/cro-specialist.md +15 -0
  177. package/squads/squad-paidmedia/agents/google-ads-specialist.md +15 -0
  178. package/squads/squad-paidmedia/agents/meta-ads-specialist.md +15 -0
  179. package/squads/squad-paidmedia/agents/paidmedia-orqx.md +15 -0
  180. package/squads/squad-paidmedia/agents/performance-engineer.md +15 -0
  181. package/squads/squad-paidmedia/agents/pm-creative-performance-analyst.md +15 -0
  182. package/squads/squad-paidmedia/agents/pm-youtube-ads-specialist.md +15 -0
  183. package/squads/squad-product/agents/product-orqx.md +13 -1
  184. package/squads/squad-product/agents/ps-client-product-manager.md +13 -1
  185. package/squads/squad-product/agents/ps-delivery-manager.md +13 -1
  186. package/squads/squad-product/agents/ps-discovery-lead.md +15 -1
  187. package/squads/squad-product/agents/ps-product-analyst.md +15 -1
  188. package/squads/squad-product/agents/ps-product-ops-specialist.md +15 -1
  189. package/squads/squad-product/agents/ps-product-strategist.md +15 -1
  190. package/squads/squad-research/agents/audience-intelligence.md +15 -0
  191. package/squads/squad-research/agents/competitive-intelligence.md +15 -0
  192. package/squads/squad-research/agents/data-synthesizer.md +15 -0
  193. package/squads/squad-research/agents/deep-researcher.md +15 -0
  194. package/squads/squad-research/agents/market-analyst.md +15 -0
  195. package/squads/squad-research/agents/research-orqx.md +15 -0
  196. package/squads/squad-research/agents/trend-forecaster.md +15 -0
  197. package/squads/squad-storytelling/agents/blake-snyder.md +13 -0
  198. package/squads/squad-storytelling/agents/dan-harmon.md +13 -0
  199. package/squads/squad-storytelling/agents/joseph-campbell.md +13 -0
  200. package/squads/squad-storytelling/agents/keith-johnstone.md +13 -0
  201. package/squads/squad-storytelling/agents/kindra-hall.md +15 -0
  202. package/squads/squad-storytelling/agents/marshall-ganz.md +15 -0
  203. package/squads/squad-storytelling/agents/nancy-duarte.md +15 -0
  204. package/squads/squad-storytelling/agents/oren-klaff.md +15 -0
  205. package/squads/squad-storytelling/agents/park-howell.md +13 -0
  206. package/squads/squad-storytelling/agents/storytelling-orqx.md +13 -0
  207. package/.sinapse-ai/core/grounding/README.md +0 -83
  208. package/.sinapse-ai/core/grounding/brand.cjs +0 -29
  209. package/.sinapse-ai/core/grounding/config-loader.cjs +0 -52
  210. package/.sinapse-ai/core/grounding/design-system.cjs +0 -29
  211. package/.sinapse-ai/core/grounding/vault.cjs +0 -36
  212. package/.sinapse-ai/development/scripts/approval-workflow.js +0 -643
  213. package/.sinapse-ai/development/scripts/backup-manager.js +0 -607
  214. package/.sinapse-ai/development/scripts/branch-manager.js +0 -390
  215. package/.sinapse-ai/development/scripts/code-quality-improver.js +0 -1329
  216. package/.sinapse-ai/development/scripts/commit-message-generator.js +0 -850
  217. package/.sinapse-ai/development/scripts/conflict-resolver.js +0 -675
  218. package/.sinapse-ai/development/scripts/dependency-analyzer.js +0 -638
  219. package/.sinapse-ai/development/scripts/diff-generator.js +0 -352
  220. package/.sinapse-ai/development/scripts/git-wrapper.js +0 -462
  221. package/.sinapse-ai/development/scripts/modification-validator.js +0 -555
  222. package/.sinapse-ai/development/scripts/performance-analyzer.js +0 -758
  223. package/.sinapse-ai/development/scripts/refactoring-suggester.js +0 -1148
  224. package/.sinapse-ai/development/scripts/rollback-handler.js +0 -531
  225. package/.sinapse-ai/development/scripts/security-checker.js +0 -359
  226. package/.sinapse-ai/development/scripts/template-engine.js +0 -240
  227. package/.sinapse-ai/development/scripts/template-validator.js +0 -279
  228. package/.sinapse-ai/development/scripts/test-generator.js +0 -844
  229. package/.sinapse-ai/development/scripts/transaction-manager.js +0 -590
  230. package/.sinapse-ai/development/scripts/yaml-validator.js +0 -397
  231. package/.sinapse-ai/hooks/sinapse-brand-grounding.cjs +0 -162
  232. package/.sinapse-ai/hooks/sinapse-ds-grounding.cjs +0 -211
  233. package/.sinapse-ai/hooks/sinapse-vault-grounding.cjs +0 -194
  234. package/bin/lib/register-grounding-hooks.js +0 -145
  235. package/docs/guides/agents/traces/execution-traces.zip +0 -0
  236. package/docs/guides/grounding-setup.md +0 -154
  237. package/docs/guides/workflows/SINAPSE-WORKFLOWS.zip +0 -0
  238. package/packages/installer/src/pro/pro-scaffolder.js +0 -449
  239. package/packages/installer/src/wizard/grounding-config.js +0 -131
  240. package/packages/installer/src/wizard/pro-setup.js +0 -1439
  241. package/packages/installer/templates/README.md +0 -16
  242. package/packages/installer/templates/brand-routing.example.json +0 -12
  243. package/packages/installer/templates/ds-routing.example.json +0 -12
  244. package/packages/installer/templates/vault-routing.example.json +0 -12
@@ -1,607 +0,0 @@
1
- const fs = require('fs').promises;
2
- const path = require('path');
3
- const chalk = require('chalk');
4
- const crypto = require('crypto');
5
- const tar = require('tar');
6
- const { promisify } = require('util');
7
- const zlib = require('zlib');
8
- const _gzip = promisify(zlib.gzip);
9
- const _gunzip = promisify(zlib.gunzip);
10
-
11
- /**
12
- * Manages backups for safe self-modification rollback
13
- */
14
- class BackupManager {
15
- constructor(options = {}) {
16
- this.rootPath = options.rootPath || process.cwd();
17
- this.backupDir = path.join(this.rootPath, '.sinapse', 'backup');
18
- this.maxBackups = options.maxBackups || 10;
19
- this.compressionLevel = options.compressionLevel || 6;
20
-
21
- // Active backup tracking
22
- this.activeBackup = null;
23
-
24
- // Backup metadata
25
- this.metadataFile = path.join(this.backupDir, 'backup-metadata.json');
26
- }
27
-
28
- /**
29
- * Initialize backup system
30
- * @returns {Promise<void>}
31
- */
32
- async initialize() {
33
- try {
34
- await fs.mkdir(this.backupDir, { recursive: true });
35
-
36
- // Initialize metadata if not exists
37
- try {
38
- await fs.access(this.metadataFile);
39
- } catch {
40
- await this.saveMetadata({
41
- version: '1.0.0',
42
- backups: [],
43
- statistics: {
44
- total_backups: 0,
45
- successful_restores: 0,
46
- failed_restores: 0,
47
- total_size: 0
48
- }
49
- });
50
- }
51
- } catch (error) {
52
- console.error(chalk.red(`Failed to initialize backup system: ${error.message}`));
53
- }
54
- }
55
-
56
- /**
57
- * Create full backup of specified files
58
- * @param {Object} params - Backup parameters
59
- * @returns {Promise<string>} Backup ID
60
- */
61
- async createFullBackup(params) {
62
- const { files, metadata = {} } = params;
63
-
64
- await this.initialize();
65
-
66
- console.log(chalk.blue('📦 Creating backup...'));
67
-
68
- const backupId = this.generateBackupId();
69
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
70
- const backupInfo = {
71
- id: backupId,
72
- timestamp: new Date().toISOString(),
73
- files: files.map(f => path.relative(this.rootPath, f)),
74
- metadata,
75
- size: 0,
76
- checksums: {},
77
- compressed: true,
78
- status: 'creating'
79
- };
80
-
81
- try {
82
- // Create temporary directory for backup files
83
- const tempDir = path.join(this.backupDir, `temp-${backupId}`);
84
- await fs.mkdir(tempDir, { recursive: true });
85
-
86
- // Copy files to temp directory maintaining structure
87
- for (const file of files) {
88
- const relPath = path.relative(this.rootPath, file);
89
- const tempPath = path.join(tempDir, relPath);
90
-
91
- await fs.mkdir(path.dirname(tempPath), { recursive: true });
92
-
93
- try {
94
- await fs.copyFile(file, tempPath);
95
-
96
- // Calculate checksum
97
- const content = await fs.readFile(file);
98
- const checksum = crypto.createHash('sha256').update(content).digest('hex');
99
- backupInfo.checksums[relPath] = checksum;
100
- } catch (error) {
101
- console.warn(chalk.yellow(`Warning: Could not backup ${file}: ${error.message}`));
102
- }
103
- }
104
-
105
- // Create backup manifest
106
- await fs.writeFile(
107
- path.join(tempDir, 'backup-manifest.json'),
108
- JSON.stringify(backupInfo, null, 2)
109
- );
110
-
111
- // Create tar archive
112
- await tar.create(
113
- {
114
- gzip: { level: this.compressionLevel },
115
- file: backupPath,
116
- cwd: tempDir
117
- },
118
- ['.']
119
- );
120
-
121
- // Get backup size
122
- const stats = await fs.stat(backupPath);
123
- backupInfo.size = stats.size;
124
- backupInfo.status = 'completed';
125
-
126
- // Clean up temp directory
127
- await fs.rm(tempDir, { recursive: true, force: true });
128
-
129
- // Update metadata
130
- await this.addBackupToMetadata(backupInfo);
131
-
132
- // Set as active backup
133
- this.activeBackup = backupId;
134
-
135
- // Clean old backups
136
- await this.cleanOldBackups();
137
-
138
- console.log(chalk.green(`✅ Backup created: ${backupId}`));
139
- console.log(chalk.gray(` Files: ${files.length}, Size: ${this.formatSize(backupInfo.size)}`));
140
-
141
- return backupId;
142
-
143
- } catch (error) {
144
- // Clean up on failure
145
- try {
146
- await fs.unlink(backupPath);
147
- } catch {}
148
-
149
- throw new Error(`Backup creation failed: ${error.message}`);
150
- }
151
- }
152
-
153
- /**
154
- * Restore backup
155
- * @param {string} backupId - Backup ID to restore
156
- * @param {Object} options - Restore options
157
- * @returns {Promise<Object>} Restore result
158
- */
159
- async restoreBackup(backupId, options = {}) {
160
- const { targetPath = this.rootPath, dryRun = false } = options;
161
-
162
- console.log(chalk.blue(`🔄 Restoring backup: ${backupId}`));
163
-
164
- const result = {
165
- success: true,
166
- backupId,
167
- restored_files: [],
168
- failed_files: [],
169
- warnings: []
170
- };
171
-
172
- try {
173
- // Load backup metadata
174
- const metadata = await this.loadMetadata();
175
- const backupInfo = metadata.backups.find(b => b.id === backupId);
176
-
177
- if (!backupInfo) {
178
- throw new Error(`Backup not found: ${backupId}`);
179
- }
180
-
181
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
182
-
183
- // Verify backup exists
184
- try {
185
- await fs.access(backupPath);
186
- } catch {
187
- throw new Error(`Backup file missing: ${backupPath}`);
188
- }
189
-
190
- // Create restore temp directory
191
- const restoreTemp = path.join(this.backupDir, `restore-${Date.now()}`);
192
- await fs.mkdir(restoreTemp, { recursive: true });
193
-
194
- // Extract backup
195
- await tar.extract({
196
- file: backupPath,
197
- cwd: restoreTemp
198
- });
199
-
200
- // Load manifest
201
- const manifestPath = path.join(restoreTemp, 'backup-manifest.json');
202
- const manifest = JSON.parse(await fs.readFile(manifestPath, 'utf-8'));
203
-
204
- // Verify checksums
205
- for (const [relPath, expectedChecksum] of Object.entries(manifest.checksums)) {
206
- const tempFile = path.join(restoreTemp, relPath);
207
- try {
208
- const content = await fs.readFile(tempFile);
209
- const actualChecksum = crypto.createHash('sha256').update(content).digest('hex');
210
-
211
- if (actualChecksum !== expectedChecksum) {
212
- result.warnings.push(`Checksum mismatch for ${relPath}`);
213
- }
214
- } catch (error) {
215
- result.warnings.push(`Could not verify ${relPath}: ${error.message}`);
216
- }
217
- }
218
-
219
- if (!dryRun) {
220
- // Restore files
221
- for (const relPath of manifest.files) {
222
- const sourcePath = path.join(restoreTemp, relPath);
223
- const destPath = path.join(targetPath, relPath);
224
-
225
- try {
226
- // Create backup of current file if it exists
227
- try {
228
- await fs.access(destPath);
229
- await fs.copyFile(destPath, `${destPath}.pre-restore`);
230
- } catch {}
231
-
232
- // Ensure directory exists
233
- await fs.mkdir(path.dirname(destPath), { recursive: true });
234
-
235
- // Restore file
236
- await fs.copyFile(sourcePath, destPath);
237
- result.restored_files.push(relPath);
238
-
239
- } catch (error) {
240
- result.failed_files.push({
241
- file: relPath,
242
- error: error.message
243
- });
244
- result.success = false;
245
- }
246
- }
247
- }
248
-
249
- // Clean up
250
- await fs.rm(restoreTemp, { recursive: true, force: true });
251
-
252
- // Update statistics
253
- if (!dryRun && result.success) {
254
- metadata.statistics.successful_restores++;
255
- } else if (!dryRun) {
256
- metadata.statistics.failed_restores++;
257
- }
258
- await this.saveMetadata(metadata);
259
-
260
- console.log(chalk.green(`✅ Restore ${dryRun ? 'preview' : 'completed'}`));
261
- console.log(chalk.gray(` Restored: ${result.restored_files.length} files`));
262
- if (result.failed_files.length > 0) {
263
- console.log(chalk.red(` Failed: ${result.failed_files.length} files`));
264
- }
265
-
266
- } catch (error) {
267
- result.success = false;
268
- result.error = error.message;
269
- console.error(chalk.red(`Restore failed: ${error.message}`));
270
- }
271
-
272
- return result;
273
- }
274
-
275
- /**
276
- * Emergency restore - restores the last active backup
277
- * @returns {Promise<Object>} Restore result
278
- */
279
- async emergencyRestore() {
280
- console.log(chalk.red('🚨 EMERGENCY RESTORE INITIATED'));
281
-
282
- if (!this.activeBackup) {
283
- // Find most recent backup
284
- const metadata = await this.loadMetadata();
285
- const backups = metadata.backups
286
- .filter(b => b.status === 'completed')
287
- .sort((a, b) => new Date(b.timestamp) - new Date(a.timestamp));
288
-
289
- if (backups.length === 0) {
290
- throw new Error('No backups available for emergency restore');
291
- }
292
-
293
- this.activeBackup = backups[0].id;
294
- }
295
-
296
- console.log(chalk.yellow(`Restoring backup: ${this.activeBackup}`));
297
- return await this.restoreBackup(this.activeBackup);
298
- }
299
-
300
- /**
301
- * List available backups
302
- * @param {Object} filter - Filter options
303
- * @returns {Promise<Array>} List of backups
304
- */
305
- async listBackups(filter = {}) {
306
- const metadata = await this.loadMetadata();
307
- let backups = metadata.backups;
308
-
309
- // Apply filters
310
- if (filter.status) {
311
- backups = backups.filter(b => b.status === filter.status);
312
- }
313
-
314
- if (filter.after) {
315
- const afterDate = new Date(filter.after);
316
- backups = backups.filter(b => new Date(b.timestamp) > afterDate);
317
- }
318
-
319
- if (filter.metadata) {
320
- backups = backups.filter(b => {
321
- return Object.entries(filter.metadata).every(([key, value]) =>
322
- b.metadata[key] === value
323
- );
324
- });
325
- }
326
-
327
- // Sort by timestamp (newest first)
328
- backups.sort((a, b) => new Date(b.timestamp) - new Date(a.timestamp));
329
-
330
- return backups.map(b => ({
331
- id: b.id,
332
- timestamp: b.timestamp,
333
- files: b.files.length,
334
- size: this.formatSize(b.size),
335
- metadata: b.metadata,
336
- isActive: b.id === this.activeBackup
337
- }));
338
- }
339
-
340
- /**
341
- * Delete specific backup
342
- * @param {string} backupId - Backup ID to delete
343
- * @returns {Promise<boolean>} Success status
344
- */
345
- async deleteBackup(backupId) {
346
- try {
347
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
348
- await fs.unlink(backupPath);
349
-
350
- // Remove from metadata
351
- const metadata = await this.loadMetadata();
352
- const index = metadata.backups.findIndex(b => b.id === backupId);
353
-
354
- if (index !== -1) {
355
- const backup = metadata.backups[index];
356
- metadata.statistics.total_size -= backup.size;
357
- metadata.backups.splice(index, 1);
358
- await this.saveMetadata(metadata);
359
- }
360
-
361
- // Clear active backup if deleted
362
- if (this.activeBackup === backupId) {
363
- this.activeBackup = null;
364
- }
365
-
366
- console.log(chalk.gray(`Deleted backup: ${backupId}`));
367
- return true;
368
-
369
- } catch (error) {
370
- console.error(chalk.red(`Failed to delete backup: ${error.message}`));
371
- return false;
372
- }
373
- }
374
-
375
- /**
376
- * Get backup details
377
- * @param {string} backupId - Backup ID
378
- * @returns {Promise<Object>} Backup details
379
- */
380
- async getBackupDetails(backupId) {
381
- const metadata = await this.loadMetadata();
382
- const backup = metadata.backups.find(b => b.id === backupId);
383
-
384
- if (!backup) {
385
- throw new Error(`Backup not found: ${backupId}`);
386
- }
387
-
388
- return backup;
389
- }
390
-
391
- /**
392
- * Verify backup integrity
393
- * @param {string} backupId - Backup ID to verify
394
- * @returns {Promise<Object>} Verification result
395
- */
396
- async verifyBackup(backupId) {
397
- console.log(chalk.blue(`🔍 Verifying backup: ${backupId}`));
398
-
399
- const result = {
400
- valid: true,
401
- backupId,
402
- errors: [],
403
- warnings: []
404
- };
405
-
406
- try {
407
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
408
-
409
- // Check file exists
410
- try {
411
- await fs.access(backupPath);
412
- } catch {
413
- result.valid = false;
414
- result.errors.push('Backup file not found');
415
- return result;
416
- }
417
-
418
- // Try to list archive contents
419
- try {
420
- const entries = [];
421
- await tar.list({
422
- file: backupPath,
423
- onentry: entry => entries.push(entry.path)
424
- });
425
-
426
- if (!entries.includes('./backup-manifest.json')) {
427
- result.valid = false;
428
- result.errors.push('Missing backup manifest');
429
- }
430
- } catch (error) {
431
- result.valid = false;
432
- result.errors.push(`Archive corrupted: ${error.message}`);
433
- }
434
-
435
- } catch (error) {
436
- result.valid = false;
437
- result.errors.push(`Verification failed: ${error.message}`);
438
- }
439
-
440
- return result;
441
- }
442
-
443
- /**
444
- * Check if has active backup
445
- * @returns {boolean}
446
- */
447
- hasActiveBackup() {
448
- return this.activeBackup !== null;
449
- }
450
-
451
- /**
452
- * Load metadata
453
- * @private
454
- */
455
- async loadMetadata() {
456
- try {
457
- const content = await fs.readFile(this.metadataFile, 'utf-8');
458
- return JSON.parse(content);
459
- } catch {
460
- return {
461
- version: '1.0.0',
462
- backups: [],
463
- statistics: {
464
- total_backups: 0,
465
- successful_restores: 0,
466
- failed_restores: 0,
467
- total_size: 0
468
- }
469
- };
470
- }
471
- }
472
-
473
- /**
474
- * Save metadata
475
- * @private
476
- */
477
- async saveMetadata(metadata) {
478
- await fs.writeFile(
479
- this.metadataFile,
480
- JSON.stringify(metadata, null, 2)
481
- );
482
- }
483
-
484
- /**
485
- * Add backup to metadata
486
- * @private
487
- */
488
- async addBackupToMetadata(backupInfo) {
489
- const metadata = await this.loadMetadata();
490
-
491
- metadata.backups.push(backupInfo);
492
- metadata.statistics.total_backups++;
493
- metadata.statistics.total_size += backupInfo.size;
494
-
495
- await this.saveMetadata(metadata);
496
- }
497
-
498
- /**
499
- * Clean old backups
500
- * @private
501
- */
502
- async cleanOldBackups() {
503
- const metadata = await this.loadMetadata();
504
- const backups = metadata.backups
505
- .filter(b => b.status === 'completed')
506
- .sort((a, b) => new Date(b.timestamp) - new Date(a.timestamp));
507
-
508
- if (backups.length > this.maxBackups) {
509
- const toDelete = backups.slice(this.maxBackups);
510
-
511
- for (const backup of toDelete) {
512
- await this.deleteBackup(backup.id);
513
- }
514
-
515
- console.log(chalk.gray(`Cleaned ${toDelete.length} old backups`));
516
- }
517
- }
518
-
519
- /**
520
- * Generate backup ID
521
- * @private
522
- */
523
- generateBackupId() {
524
- const timestamp = Date.now();
525
- const random = crypto.randomBytes(4).toString('hex');
526
- return `backup-${timestamp}-${random}`;
527
- }
528
-
529
- /**
530
- * Format file size
531
- * @private
532
- */
533
- formatSize(bytes) {
534
- const units = ['B', 'KB', 'MB', 'GB'];
535
- let size = bytes;
536
- let unitIndex = 0;
537
-
538
- while (size >= 1024 && unitIndex < units.length - 1) {
539
- size /= 1024;
540
- unitIndex++;
541
- }
542
-
543
- return `${size.toFixed(2)} ${units[unitIndex]}`;
544
- }
545
-
546
- /**
547
- * Export backup for external storage
548
- * @param {string} backupId - Backup ID to export
549
- * @param {string} exportPath - Path to export to
550
- * @returns {Promise<Object>} Export result
551
- */
552
- async exportBackup(backupId, exportPath) {
553
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
554
- const metadataPath = path.join(this.backupDir, `${backupId}-metadata.json`);
555
-
556
- try {
557
- // Copy backup file
558
- await fs.copyFile(backupPath, exportPath);
559
-
560
- // Export metadata
561
- const metadata = await this.getBackupDetails(backupId);
562
- await fs.writeFile(
563
- metadataPath,
564
- JSON.stringify(metadata, null, 2)
565
- );
566
-
567
- return {
568
- success: true,
569
- exported: exportPath,
570
- metadata: metadataPath,
571
- size: metadata.size
572
- };
573
-
574
- } catch (error) {
575
- throw new Error(`Export failed: ${error.message}`);
576
- }
577
- }
578
-
579
- /**
580
- * Import external backup
581
- * @param {string} importPath - Path to backup file
582
- * @param {Object} metadata - Backup metadata
583
- * @returns {Promise<string>} Imported backup ID
584
- */
585
- async importBackup(importPath, metadata) {
586
- const backupId = metadata.id || this.generateBackupId();
587
- const backupPath = path.join(this.backupDir, `${backupId}.tar.gz`);
588
-
589
- try {
590
- // Copy backup file
591
- await fs.copyFile(importPath, backupPath);
592
-
593
- // Update metadata
594
- metadata.id = backupId;
595
- metadata.imported = new Date().toISOString();
596
-
597
- await this.addBackupToMetadata(metadata);
598
-
599
- return backupId;
600
-
601
- } catch (error) {
602
- throw new Error(`Import failed: ${error.message}`);
603
- }
604
- }
605
- }
606
-
607
- module.exports = BackupManager;