agentic-qe 1.7.0 → 1.8.0

package/dist/scripts/backup-helper.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Backup Helper for Database Migration
+ * Integrates backup system with migration scripts
+ */
+export interface BackupResult {
+    success: boolean;
+    timestamp: string;
+    files: string[];
+    totalSize: number;
+    compressed: boolean;
+    error?: string;
+}
+export interface RestoreResult {
+    success: boolean;
+    timestamp: string;
+    filesRestored: number;
+    error?: string;
+}
+export declare class BackupHelper {
+    private backupDir;
+    private scriptsDir;
+    /**
+     * Create a database backup before migration
+     */
+    createBackup(options?: {
+        compress?: boolean;
+        verify?: boolean;
+    }): Promise<BackupResult>;
+    /**
+     * Restore database from backup
+     */
+    restoreBackup(timestamp: string, options?: {
+        verify?: boolean;
+        force?: boolean;
+    }): Promise<RestoreResult>;
+    /**
+     * List available backups
+     */
+    listBackups(): Promise<Array<{
+        timestamp: string;
+        date: string;
+        files: number;
+        size: number;
+        metadata?: any;
+    }>>;
+    /**
+     * Verify backup integrity
+     */
+    verifyBackup(timestamp: string): Promise<boolean>;
+    /**
+     * Clean old backups
+     */
+    cleanOldBackups(keepLast?: number): Promise<number>;
+    /**
+     * Get backup files for a specific timestamp
+     */
+    private getBackupFiles;
+    /**
+     * Create automatic backup before dangerous operation
+     */
+    createSafetyBackup(operationName: string): Promise<BackupResult>;
+}
+export declare const backupHelper: BackupHelper;
+//# sourceMappingURL=backup-helper.d.ts.map

package/dist/scripts/backup-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-helper.d.ts","sourceRoot":"","sources":["../../src/scripts/backup-helper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;KACb,GAAG,OAAO,CAAC,YAAY,CAAC;IA4D9B;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;QAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC,CAAC;IAkDH;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcvD;;OAEG;IACG,eAAe,CAAC,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAe7D;;OAEG;YACW,cAAc;IAa5B;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAevE;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/scripts/backup-helper.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Backup Helper for Database Migration
+ * Integrates backup system with migration scripts
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.backupHelper = exports.BackupHelper = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+class BackupHelper {
+    constructor() {
+        this.backupDir = '.agentic-qe/backups';
+        this.scriptsDir = 'scripts';
+    }
+    /**
+     * Create a database backup before migration
+     */
+    async createBackup(options = {}) {
+        const { compress = true, verify = true } = options;
+        try {
+            console.log('🔒 Creating database backup...');
+            const flags = [
+                compress ? '--compress' : '',
+                !verify ? '--no-verify' : ''
+            ].filter(Boolean).join(' ');
+            const backupScript = path.join(this.scriptsDir, 'backup-databases.sh');
+            // Make script executable
+            await execAsync(`chmod +x ${backupScript}`);
+            // Run backup
+            const { stdout, stderr } = await execAsync(`${backupScript} ${flags}`);
+            console.log(stdout);
+            if (stderr) {
+                console.warn('Backup warnings:', stderr);
+            }
+            // Parse output to get timestamp
+            const timestampMatch = stdout.match(/Timestamp: (\d{8}-\d{6})/);
+            const timestamp = timestampMatch ? timestampMatch[1] : '';
+            // Get backup files
+            const files = await this.getBackupFiles(timestamp);
+            // Calculate total size
+            let totalSize = 0;
+            for (const file of files) {
+                const stats = await fs.stat(file);
+                totalSize += stats.size;
+            }
+            return {
+                success: true,
+                timestamp,
+                files,
+                totalSize,
+                compressed: compress
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error('❌ Backup failed:', errorMessage);
+            return {
+                success: false,
+                timestamp: '',
+                files: [],
+                totalSize: 0,
+                compressed: false,
+                error: errorMessage
+            };
+        }
+    }
+    /**
+     * Restore database from backup
+     */
+    async restoreBackup(timestamp, options = {}) {
+        const { verify = true, force = false } = options;
+        try {
+            console.log(`🔄 Restoring database backup: ${timestamp}...`);
+            const flags = [
+                !verify ? '--no-verify' : '',
+                force ? '--force' : ''
+            ].filter(Boolean).join(' ');
+            const restoreScript = path.join(this.scriptsDir, 'restore-databases.sh');
+            // Make script executable
+            await execAsync(`chmod +x ${restoreScript}`);
+            // Run restore (with force flag to skip confirmation)
+            const { stdout, stderr } = await execAsync(`${restoreScript} ${timestamp} ${flags}`);
+            console.log(stdout);
+            if (stderr) {
+                console.warn('Restore warnings:', stderr);
+            }
+            // Count restored files
+            const filesRestored = await this.getBackupFiles(timestamp);
+            return {
+                success: true,
+                timestamp,
+                filesRestored: filesRestored.length
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error('❌ Restore failed:', errorMessage);
+            return {
+                success: false,
+                timestamp,
+                filesRestored: 0,
+                error: errorMessage
+            };
+        }
+    }
+    /**
+     * List available backups
+     */
+    async listBackups() {
+        try {
+            const backupFiles = await fs.readdir(this.backupDir);
+            const backupPattern = /\.backup\.(\d{8}-\d{6})/;
+            const timestamps = new Set();
+            for (const file of backupFiles) {
+                const match = file.match(backupPattern);
+                if (match) {
+                    timestamps.add(match[1]);
+                }
+            }
+            const backups = [];
+            for (const timestamp of Array.from(timestamps).sort().reverse()) {
+                const files = await this.getBackupFiles(timestamp);
+                let totalSize = 0;
+                for (const file of files) {
+                    const stats = await fs.stat(file);
+                    totalSize += stats.size;
+                }
+                let metadata;
+                const metadataFile = path.join(this.backupDir, `backup-metadata.${timestamp}.json`);
+                try {
+                    const metadataContent = await fs.readFile(metadataFile, 'utf-8');
+                    metadata = JSON.parse(metadataContent);
+                }
+                catch {
+                    // Metadata not available
+                }
+                backups.push({
+                    timestamp,
+                    date: metadata?.date || timestamp,
+                    files: files.length,
+                    size: totalSize,
+                    metadata
+                });
+            }
+            return backups;
+        }
+        catch (error) {
+            console.error('Failed to list backups:', error);
+            return [];
+        }
+    }
+    /**
+     * Verify backup integrity
+     */
+    async verifyBackup(timestamp) {
+        try {
+            const manageScript = path.join(this.scriptsDir, 'manage-backups.sh');
+            await execAsync(`chmod +x ${manageScript}`);
+            const { stdout } = await execAsync(`${manageScript} verify ${timestamp}`);
+            return stdout.includes('All files verified');
+        }
+        catch (error) {
+            console.error('Backup verification failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Clean old backups
+     */
+    async cleanOldBackups(keepLast = 10) {
+        try {
+            const manageScript = path.join(this.scriptsDir, 'manage-backups.sh');
+            await execAsync(`chmod +x ${manageScript}`);
+            const { stdout } = await execAsync(`${manageScript} clean ${keepLast}`);
+            const removedMatch = stdout.match(/Removed (\d+) old backup/);
+            return removedMatch ? parseInt(removedMatch[1]) : 0;
+        }
+        catch (error) {
+            console.error('Failed to clean old backups:', error);
+            return 0;
+        }
+    }
+    /**
+     * Get backup files for a specific timestamp
+     */
+    async getBackupFiles(timestamp) {
+        try {
+            const allFiles = await fs.readdir(this.backupDir);
+            const backupFiles = allFiles.filter(f => f.includes(`.backup.${timestamp}`) && !f.endsWith('.sha256'));
+            return backupFiles.map(f => path.join(this.backupDir, f));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Create automatic backup before dangerous operation
+     */
+    async createSafetyBackup(operationName) {
+        console.log(`🛡️ Creating safety backup before: ${operationName}`);
+        const result = await this.createBackup({
+            compress: true,
+            verify: true
+        });
+        if (result.success) {
+            console.log(`✅ Safety backup created: ${result.timestamp}`);
+            console.log(`   Use this to rollback: ./scripts/restore-databases.sh ${result.timestamp}`);
+        }
+        return result;
+    }
+}
+exports.BackupHelper = BackupHelper;
+// Export singleton instance
+exports.backupHelper = new BackupHelper();
+//# sourceMappingURL=backup-helper.js.map

package/dist/scripts/backup-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-helper.js","sourceRoot":"","sources":["../../src/scripts/backup-helper.ts"],"names":[],"mappings":"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"}

package/dist/scripts/migrate-with-backup.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Database Migration with Integrated Backup System
+ *
+ * This script demonstrates how to safely perform database migrations
+ * with automatic backup and restore capabilities.
+ */
+interface MigrationOptions {
+    skipBackup?: boolean;
+    autoRestore?: boolean;
+    verifyBackup?: boolean;
+}
+declare function performDatabaseMigration(options?: MigrationOptions): Promise<void>;
+export { performDatabaseMigration };
+//# sourceMappingURL=migrate-with-backup.d.ts.map

package/dist/scripts/migrate-with-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-with-backup.d.ts","sourceRoot":"","sources":["../../src/scripts/migrate-with-backup.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAIH,UAAU,gBAAgB;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,iBAAe,wBAAwB,CAAC,OAAO,GAAE,gBAAqB,iBAyGrE;AA4GD,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/scripts/migrate-with-backup.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Database Migration with Integrated Backup System
+ *
+ * This script demonstrates how to safely perform database migrations
+ * with automatic backup and restore capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performDatabaseMigration = performDatabaseMigration;
+const backup_helper_1 = require("./backup-helper");
+async function performDatabaseMigration(options = {}) {
+    const { skipBackup = false, autoRestore = true, verifyBackup = true } = options;
+    let backupTimestamp;
+    try {
+        console.log('🚀 Starting Database Migration');
+        console.log('================================');
+        console.log('');
+        // Step 1: Create safety backup
+        if (!skipBackup) {
+            console.log('📦 Step 1: Creating pre-migration backup...');
+            const backupResult = await backup_helper_1.backupHelper.createSafetyBackup('database-migration');
+            if (!backupResult.success) {
+                console.error('❌ Backup failed! Aborting migration.');
+                console.error('Error:', backupResult.error);
+                process.exit(1);
+            }
+            backupTimestamp = backupResult.timestamp;
+            console.log(`✅ Backup created: ${backupTimestamp}`);
+            console.log(`   Files: ${backupResult.files.length}`);
+            console.log(`   Size: ${formatBytes(backupResult.totalSize)}`);
+            console.log('');
+            // Verify backup if requested
+            if (verifyBackup) {
+                console.log('🔍 Verifying backup integrity...');
+                const isValid = await backup_helper_1.backupHelper.verifyBackup(backupTimestamp);
+                if (!isValid) {
+                    console.error('❌ Backup verification failed! Aborting migration.');
+                    process.exit(1);
+                }
+                console.log('✅ Backup verified');
+                console.log('');
+            }
+        }
+        else {
+            console.log('⚠️  Skipping backup (--skip-backup flag)');
+            console.log('');
+        }
+        // Step 2: Perform migration
+        console.log('🔄 Step 2: Performing migration...');
+        await executeMigrationSteps();
+        console.log('✅ Migration completed successfully');
+        console.log('');
+        // Step 3: Verify migration
+        console.log('✅ Step 3: Verifying migration...');
+        await verifyMigration();
+        console.log('✅ Migration verification passed');
+        console.log('');
+        // Success!
+        console.log('🎉 Migration Complete!');
+        console.log('=====================');
+        if (backupTimestamp) {
+            console.log(`Safety backup: ${backupTimestamp}`);
+            console.log(`To rollback: ./scripts/restore-databases.sh ${backupTimestamp} --force`);
+        }
+    }
+    catch (error) {
+        console.error('');
+        console.error('❌ Migration Failed!');
+        console.error('====================');
+        console.error('Error:', error instanceof Error ? error.message : String(error));
+        console.error('');
+        // Automatic restore if enabled and backup exists
+        if (autoRestore && backupTimestamp) {
+            console.log('🔄 Auto-restore enabled. Restoring from backup...');
+            try {
+                const restoreResult = await backup_helper_1.backupHelper.restoreBackup(backupTimestamp, {
+                    verify: true,
+                    force: true
+                });
+                if (restoreResult.success) {
+                    console.log('✅ Database restored to pre-migration state');
+                    console.log(`   Files restored: ${restoreResult.filesRestored}`);
+                }
+                else {
+                    console.error('❌ Auto-restore failed!');
+                    console.error('Manual restore required:');
+                    console.error(`   ./scripts/restore-databases.sh ${backupTimestamp} --force`);
+                }
+            }
+            catch (restoreError) {
+                console.error('❌ Auto-restore failed with error:', restoreError);
+                console.error('Manual restore required:');
+                console.error(`   ./scripts/restore-databases.sh ${backupTimestamp} --force`);
+            }
+        }
+        else if (backupTimestamp) {
+            console.log('ℹ️  To restore manually:');
+            console.log(`   ./scripts/restore-databases.sh ${backupTimestamp} --force`);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Execute actual migration steps
+ * Replace this with your actual migration logic
+ */
+async function executeMigrationSteps() {
+    // Example migration steps:
+    // 1. Update schema
+    // 2. Migrate data
+    // 3. Update indexes
+    // 4. Clean up old data
+    console.log('   - Updating schema...');
+    await simulateStep(1000);
+    console.log('   - Migrating data...');
+    await simulateStep(2000);
+    console.log('   - Creating indexes...');
+    await simulateStep(1000);
+    console.log('   - Cleaning up...');
+    await simulateStep(500);
+}
+/**
+ * Verify migration success
+ */
+async function verifyMigration() {
+    console.log('   - Checking schema integrity...');
+    await simulateStep(500);
+    console.log('   - Validating data...');
+    await simulateStep(500);
+    console.log('   - Testing queries...');
+    await simulateStep(500);
+}
+/**
+ * Simulate async step
+ */
+function simulateStep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Format bytes to human readable
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+/**
+ * CLI entry point
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    const options = {
+        skipBackup: args.includes('--skip-backup'),
+        autoRestore: !args.includes('--no-auto-restore'),
+        verifyBackup: !args.includes('--no-verify')
+    };
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+Database Migration with Backup
+
+Usage: node migrate-with-backup.js [options]
+
+Options:
+  --skip-backup        Skip pre-migration backup (dangerous!)
+  --no-auto-restore    Disable automatic restore on failure
+  --no-verify          Skip backup verification
+  --help, -h           Show this help message
+
+Examples:
+  # Normal migration with backup
+  node migrate-with-backup.js
+
+  # Migration without verification (faster)
+  node migrate-with-backup.js --no-verify
+
+  # Migration without auto-restore
+  node migrate-with-backup.js --no-auto-restore
+    `);
+        process.exit(0);
+    }
+    await performDatabaseMigration(options);
+}
+// Run if called directly
+if (require.main === module) {
+    main().catch(error => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=migrate-with-backup.js.map

package/dist/scripts/migrate-with-backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-with-backup.js","sourceRoot":"","sources":["../../src/scripts/migrate-with-backup.ts"],"names":[],"mappings":"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"}