@versatil/sdlc-framework/dist/update/update-manager.js

🚀 AI-Native SDLC framework with 11-MCP ecosystem, RAG memory, OPERA orchestration, and 6 specialized agents achieving ZERO CONTEXT LOSS. Features complete CI/CD pipeline with 7 GitHub workflows (MCP testing, security scanning, performance benchmarking),

/**
 * VERSATIL SDLC Framework - Update Manager
 * Manages framework updates with backup and rollback capabilities
 */
import * as fs from 'fs/promises';
import * as path from 'path';
import * as os from 'os';
import { exec } from 'child_process';
import { promisify } from 'util';
import { GitHubReleaseChecker } from './github-release-checker.js';
import { compareVersions } from './semantic-version.js';
const execAsync = promisify(exec);
export class UpdateManager {
    constructor(config) {
        this.releaseChecker = new GitHubReleaseChecker();
        this.versatilHome = path.join(os.homedir(), '.versatil');
        this.updateHistoryFile = path.join(this.versatilHome, 'update-history.json');
        this.config = {
            autoCheck: true,
            checkInterval: 24 * 60 * 60 * 1000, // 24 hours
            includePrerelease: false,
            backupBeforeUpdate: true,
            autoUpdate: false,
            ...config
        };
    }
    /**
     * Check for available updates
     */
    async checkForUpdates(currentVersion) {
        return this.releaseChecker.checkForUpdate(currentVersion, this.config.includePrerelease);
    }
    /**
     * Perform framework update
     */
    async update(currentVersion, targetVersion) {
        try {
            // Get update information
            const updateCheck = await this.checkForUpdates(currentVersion);
            if (!updateCheck.hasUpdate && !targetVersion) {
                console.log('✅ Already on latest version');
                return true;
            }
            const versionToInstall = targetVersion || updateCheck.latestVersion;
            // Backup if configured
            if (this.config.backupBeforeUpdate) {
                await this.createBackup(currentVersion);
            }
            // Perform update
            console.log(`\n📥 Updating VERSATIL from v${currentVersion} to v${versionToInstall}...\n`);
            const success = await this.performUpdate(versionToInstall);
            // Record update history
            await this.recordUpdate(currentVersion, versionToInstall, success);
            if (success) {
                console.log(`\n✅ Successfully updated to v${versionToInstall}!\n`);
                console.log('Run: versatil doctor --verify\n');
            }
            return success;
        }
        catch (error) {
            console.error(`\n❌ Update failed: ${error.message}\n`);
            await this.recordUpdate(currentVersion, targetVersion || 'unknown', false, error.message);
            return false;
        }
    }
    /**
     * Create backup before update
     */
    async createBackup(version) {
        console.log('📦 Creating backup...');
        const backupDir = path.join(this.versatilHome, 'backups');
        await fs.mkdir(backupDir, { recursive: true });
        const timestamp = new Date().toISOString().replace(/:/g, '-').replace(/\..+/, '');
        const backupName = `versatil-v${version}-${timestamp}`;
        const backupPath = path.join(backupDir, `${backupName}.tar.gz`);
        try {
            // Backup ~/.versatil/ directory
            await execAsync(`tar -czf "${backupPath}" -C "${os.homedir()}" .versatil`);
            console.log(`✅ Backup created: ${backupPath}\n`);
            return backupPath;
        }
        catch (error) {
            console.warn(`⚠️  Backup failed: ${error.message}`);
            return '';
        }
    }
    /**
     * Perform npm update
     */
    async performUpdate(version) {
        try {
            // Update via npm
            const updateCommand = `npm update -g versatil-sdlc-framework@${version}`;
            const { stdout, stderr } = await execAsync(updateCommand);
            if (stderr && !stderr.includes('npm WARN')) {
                console.error('Update warnings:', stderr);
            }
            // Verify new version installed
            const { stdout: versionCheck } = await execAsync('versatil --version');
            const installedVersion = versionCheck.trim().replace(/^v/, '');
            if (installedVersion === version || compareVersions(installedVersion, version) === 0) {
                return true;
            }
            throw new Error(`Version mismatch after update: expected ${version}, got ${installedVersion}`);
        }
        catch (error) {
            throw new Error(`npm update failed: ${error.message}`);
        }
    }
    /**
     * Rollback to previous version (from backup)
     */
    async rollback(backupFile) {
        try {
            console.log('\n🔄 Rolling back to previous version...\n');
            let backupToRestore = backupFile;
            if (!backupToRestore) {
                // Find most recent backup
                const backupDir = path.join(this.versatilHome, 'backups');
                const backups = await fs.readdir(backupDir);
                if (backups.length === 0) {
                    throw new Error('No backups found');
                }
                // Sort by name (includes timestamp)
                backups.sort().reverse();
                backupToRestore = path.join(backupDir, backups[0]);
            }
            console.log(`Restoring from: ${backupToRestore}`);
            // Extract backup
            await execAsync(`tar -xzf "${backupToRestore}" -C "${os.homedir()}"`);
            console.log('✅ Rollback complete\n');
            return true;
        }
        catch (error) {
            console.error(`❌ Rollback failed: ${error.message}\n`);
            return false;
        }
    }
    /**
     * Record update in history
     */
    async recordUpdate(fromVersion, toVersion, success, error) {
        try {
            await fs.mkdir(this.versatilHome, { recursive: true });
            let history = [];
            try {
                const existing = await fs.readFile(this.updateHistoryFile, 'utf-8');
                history = JSON.parse(existing);
            }
            catch {
                // File doesn't exist yet
            }
            history.push({
                timestamp: new Date().toISOString(),
                fromVersion,
                toVersion,
                success,
                error
            });
            // Keep last 50 updates
            if (history.length > 50) {
                history = history.slice(-50);
            }
            await fs.writeFile(this.updateHistoryFile, JSON.stringify(history, null, 2));
        }
        catch (error) {
            // Don't fail update if history recording fails
            console.warn('Failed to record update history:', error);
        }
    }
    /**
     * Get update history
     */
    async getUpdateHistory() {
        try {
            const data = await fs.readFile(this.updateHistoryFile, 'utf-8');
            return JSON.parse(data);
        }
        catch {
            return [];
        }
    }
    /**
     * Get latest changelog
     */
    async getChangelog(version) {
        try {
            if (version) {
                const release = await this.releaseChecker.getReleaseByTag(`v${version}`);
                return release.changelog;
            }
            const latest = await this.releaseChecker.getLatestRelease(this.config.includePrerelease);
            return latest.changelog;
        }
        catch (error) {
            return 'Changelog not available';
        }
    }
    /**
     * List available backups
     */
    async listBackups() {
        try {
            const backupDir = path.join(this.versatilHome, 'backups');
            const backups = await fs.readdir(backupDir);
            return backups.filter(f => f.endsWith('.tar.gz')).sort().reverse();
        }
        catch {
            return [];
        }
    }
}
/**
 * Default update manager instance
 */
export const defaultUpdateManager = new UpdateManager();
//# sourceMappingURL=update-manager.js.map