claude-code-automation/templates/automation/auto-recovery.js

🚀 Generic project automation system with anti-compaction protection and recovery capabilities. Automatically detects project type (React, Node.js, Python, Rust, Go, Java) and provides intelligent analysis. Claude Code optimized - run 'welcome' after inst

/**
 * Auto-Recovery System
 * Reconstructs project context and resumes development after compaction
 * Analyzes existing artifacts to rebuild complete understanding
 */

const fs = require('fs').promises;
const path = require('path');

class AutoRecoverySystem {
    constructor() {
        this.projectRoot = path.resolve(__dirname, '../..');
        this.stateDir = path.join(this.projectRoot, 'docs/state');
        this.recoveryDir = path.join(this.projectRoot, 'docs/recovery');
    }

    /**
     * Main recovery entry point - reconstructs full project context
     */
    async reconstructProjectContext() {
        console.log('🔄 Starting automatic project context reconstruction...');
        
        try {
            // Step 1: Analyze current project state
            const currentState = await this.analyzeCurrentProjectState();
            
            // Step 2: Locate and load previous state if available
            const previousState = await this.loadLatestKnownState();
            
            // Step 3: Reconstruct context by merging current and previous
            const reconstructedContext = await this.rebuildContext(currentState, previousState);
            
            // Step 4: Validate reconstruction
            const validationResults = await this.validateReconstruction(reconstructedContext);
            
            // Step 5: Generate recovery report
            const recoveryReport = await this.generateRecoveryReport(reconstructedContext, validationResults);
            
            console.log('✅ Project context reconstruction completed');
            
            return {
                context: reconstructedContext,
                validation: validationResults,
                report: recoveryReport,
                recommendations: this.generateRecommendations(reconstructedContext)
            };
            
        } catch (error) {
            console.error('❌ Context reconstruction failed:', error);
            return await this.handleRecoveryFailure(error);
        }
    }

    /**
     * Analyze current project state from existing files
     */
    async analyzeCurrentProjectState() {
        console.log('📊 Analyzing current project state...');
        
        const state = {
            timestamp: new Date().toISOString(),
            structure: await this.analyzeDirectoryStructure(),
            codebase: await this.analyzeCodebase(),
            configuration: await this.analyzeConfiguration(),
            tests: await this.analyzeTestingState(),
            dependencies: await this.analyzeDependencies(),
            calculators: await this.analyzeCalculatorImplementation(),
            automation: await this.analyzeAutomationState()
        };
        
        return state;
    }

    /**
     * Load the most recent preserved state
     */
    async loadLatestKnownState() {
        try {
            // Look for latest state file
            const stateFile = path.join(this.stateDir, 'current-state-summary.json');
            const stateContent = await fs.readFile(stateFile, 'utf8');
            return JSON.parse(stateContent);
        } catch (error) {
            console.log('⚠️ No previous state found, starting fresh analysis');
            return null;
        }
    }

    /**
     * Rebuild comprehensive context from available information
     */
    async rebuildContext(currentState, previousState) {
        console.log('🔧 Rebuilding project context...');
        
        const context = {
            // Project identification
            project: {
                name: 'Calculator Suite - Enterprise Grade',
                type: 'Electron Desktop Application',
                purpose: 'Multi-mode scientific calculator with 12 specialized modes'
            },
            
            // Current phase determination
            phase: await this.determineCurrentPhase(currentState, previousState),
            
            // Implementation status
            implementation: await this.assessImplementationStatus(currentState),
            
            // Architecture understanding
            architecture: await this.reconstructArchitecture(currentState),
            
            // Development workflow
            workflow: await this.reconstructWorkflow(currentState),
            
            // Quality state
            quality: await this.assessQualityState(currentState),
            
            // Next actions
            nextActions: await this.determineNextActions(currentState, previousState)
        };
        
        return context;
    }

    /**
     * Determine current development phase
     */
    async determineCurrentPhase(currentState, previousState) {
        const calculatorModes = currentState.calculators;
        const hasBasicUI = currentState.structure.hasModernHTML;
        const hasTestConfig = currentState.tests.hasVitestConfig;
        const hasAutomation = currentState.automation.level > 0;
        
        let phase = 'Phase 1: Foundation';
        let sprintGoal = 'Set up robust base system';
        
        if (hasBasicUI && calculatorModes.implemented.length >= 4) {
            phase = 'Phase 2: Core Calculator Engines';
            sprintGoal = 'Implement specialized calculator engines';
        }
        
        if (calculatorModes.implemented.length >= 8) {
            phase = 'Phase 3: Specialized Domain Calculators';
            sprintGoal = 'Complete remaining calculator modes';
        }
        
        if (calculatorModes.implemented.length >= 12) {
            phase = 'Phase 4: Advanced Features & Polish';
            sprintGoal = 'Enhance UX and prepare for production';
        }
        
        return {
            current: phase,
            goal: sprintGoal,
            progress: `${calculatorModes.implemented.length}/12 calculator modes`,
            confidence: this.calculatePhaseConfidence(currentState)
        };
    }

    /**
     * Assess current implementation status
     */
    async assessImplementationStatus(currentState) {
        return {
            calculatorModes: {
                total: 12,
                implemented: currentState.calculators.implemented,
                functional: currentState.calculators.functional,
                pending: currentState.calculators.pending,
                priority: this.prioritizeRemainingModes(currentState.calculators)
            },
            
            infrastructure: {
                electron: currentState.structure.hasElectronConfig,
                testing: currentState.tests.framework,
                automation: currentState.automation.level,
                cicd: currentState.automation.hasCICD
            },
            
            codeQuality: {
                structure: this.assessCodeStructure(currentState.codebase),
                patterns: this.identifyCodePatterns(currentState.codebase),
                maintainability: this.assessMaintainability(currentState.codebase)
            }
        };
    }

    /**
     * Reconstruct system architecture understanding
     */
    async reconstructArchitecture(currentState) {
        return {
            // Technology stack
            stack: {
                frontend: 'HTML/CSS/JavaScript (Vanilla)',
                backend: 'Node.js (Electron Main Process)',
                desktop: 'Electron Framework',
                testing: currentState.tests.framework || 'Vitest',
                build: 'Electron Builder'
            },
            
            // Module structure
            modules: {
                core: this.analyzeModule(currentState.codebase, 'core'),
                renderer: this.analyzeModule(currentState.codebase, 'renderer'),
                constants: this.analyzeModule(currentState.codebase, 'constants'),
                utils: this.analyzeModule(currentState.codebase, 'utils'),
                types: this.analyzeModule(currentState.codebase, 'types')
            },
            
            // Design patterns
            patterns: {
                architecture: 'Modular Electron Architecture',
                ui: 'Adaptive Multi-Mode Interface',
                calculations: 'Engine-Based Calculation System',
                state: 'Class-Based State Management'
            },
            
            // Key relationships
            relationships: this.identifyKeyRelationships(currentState.codebase)
        };
    }

    /**
     * Determine next recommended actions
     */
    async determineNextActions(currentState, previousState) {
        const actions = [];
        
        // Based on calculator implementation status
        if (currentState.calculators.implemented.length < 4) {
            actions.push({
                priority: 'HIGH',
                category: 'Core Development',
                action: 'Complete basic calculator modes (Scientific, Programmer, Financial)',
                timeEstimate: '2-3 hours',
                dependencies: []
            });
        }
        
        // Based on testing infrastructure
        if (!currentState.tests.hasComprehensiveTests) {
            actions.push({
                priority: 'HIGH',
                category: 'Quality Assurance',
                action: 'Set up comprehensive testing infrastructure',
                timeEstimate: '1-2 hours',
                dependencies: ['Vitest configuration']
            });
        }
        
        // Based on automation level
        if (currentState.automation.level < 0.5) {
            actions.push({
                priority: 'MEDIUM',
                category: 'Automation',
                action: 'Implement automated testing and deployment',
                timeEstimate: '2-3 hours',
                dependencies: ['Testing infrastructure']
            });
        }
        
        return actions.sort((a, b) => {
            const priorityOrder = { HIGH: 3, MEDIUM: 2, LOW: 1 };
            return priorityOrder[b.priority] - priorityOrder[a.priority];
        });
    }

    /**
     * Validate the reconstruction accuracy
     */
    async validateReconstruction(context) {
        const validations = {
            projectStructure: await this.validateProjectStructure(),
            calculatorFunctionality: await this.validateCalculatorFunctionality(),
            codeQuality: await this.validateCodeQuality(),
            dependencies: await this.validateDependencies()
        };
        
        const overallScore = Object.values(validations)
            .reduce((sum, validation) => sum + validation.score, 0) / Object.keys(validations).length;
        
        return {
            overall: {
                score: overallScore,
                status: overallScore > 0.8 ? 'EXCELLENT' : overallScore > 0.6 ? 'GOOD' : 'NEEDS_ATTENTION'
            },
            details: validations,
            recommendations: this.generateValidationRecommendations(validations)
        };
    }

    /**
     * Generate comprehensive recovery report
     */
    async generateRecoveryReport(context, validation) {
        const timestamp = new Date().toISOString();
        
        const report = `# Project Recovery Report
Generated: ${timestamp}

## 🎯 Project Overview
**Name**: ${context.project.name}
**Type**: ${context.project.type}
**Purpose**: ${context.project.purpose}

## 📊 Current Status
**Phase**: ${context.phase.current}
**Goal**: ${context.phase.goal}
**Progress**: ${context.phase.progress}
**Confidence**: ${context.phase.confidence}%

## 🛠 Implementation Status
### Calculator Modes (${context.implementation.calculatorModes.implemented.length}/12)
${context.implementation.calculatorModes.implemented.map(mode => `✅ ${mode}`).join('\n')}
${context.implementation.calculatorModes.pending.map(mode => `⏳ ${mode}`).join('\n')}

## 🏗 Architecture
**Stack**: ${Object.entries(context.architecture.stack).map(([key, value]) => `${key}: ${value}`).join(', ')}
**Pattern**: ${context.architecture.patterns.architecture}

## ✅ Validation Results
**Overall Score**: ${validation.overall.score.toFixed(2)} (${validation.overall.status})

## 🎯 Next Actions (Priority Order)
${context.nextActions.map(action => `
### ${action.priority}: ${action.action}
- **Category**: ${action.category}
- **Time**: ${action.timeEstimate}
- **Dependencies**: ${action.dependencies.join(', ') || 'None'}
`).join('')}

## 🚀 Quick Start Commands
\`\`\`bash
# Start the application
npm start

# Run tests
npm test

# Check current state
node scripts/automation/context-analysis.js
\`\`\`

## 📋 Recovery Checklist
- [ ] Dependencies installed (\`npm install\`)
- [ ] Application launches successfully
- [ ] All calculator modes accessible
- [ ] Basic calculations work
- [ ] Tests can be executed
- [ ] Automation scripts functional

---
*This report was auto-generated by the Auto-Recovery System*
`;

        // Save the report
        await fs.writeFile(
            path.join(this.recoveryDir, `recovery-report-${timestamp.replace(/[:.]/g, '-')}.md`),
            report
        );
        
        return report;
    }

    // Analysis helper methods
    async analyzeDirectoryStructure() {
        const structure = {
            hasElectronConfig: await this.fileExists('package.json'),
            hasModernHTML: await this.fileExists('src/renderer/modern.html'),
            hasScientificCalculator: await this.fileExists('src/core/ScientificCalculator.js'),
            hasMathEngine: await this.fileExists('src/core/MathEngine.js'),
            hasAutomationScripts: await this.fileExists('scripts/automation'),
            hasDocumentation: await this.fileExists('docs')
        };
        
        return structure;
    }

    async analyzeCalculatorImplementation() {
        try {
            const modernHtmlPath = path.join(this.projectRoot, 'src/renderer/modern.html');
            const modernHtml = await fs.readFile(modernHtmlPath, 'utf8');
            
            const allModes = [
                'basic', 'scientific', 'programmer', 'financial',
                'graphing', 'physics', 'chemistry', 'biology',
                'health', 'environmental', 'construction', 'astronomy'
            ];
            
            const implemented = allModes.filter(mode => 
                modernHtml.includes(`data-mode="${mode}"`)
            );
            
            // Check which ones are actually functional (have implementations)
            const functional = await this.checkFunctionalModes(implemented);
            
            return {
                implemented,
                functional,
                pending: allModes.filter(mode => !implemented.includes(mode)),
                total: allModes.length
            };
        } catch (error) {
            return {
                implemented: [],
                functional: [],
                pending: [],
                total: 12,
                error: error.message
            };
        }
    }

    async fileExists(filePath) {
        try {
            await fs.access(path.join(this.projectRoot, filePath));
            return true;
        } catch {
            return false;
        }
    }

    // Placeholder implementations for complex analysis methods
    async analyzeCodebase() { return { files: [], complexity: 'medium' }; }
    async analyzeConfiguration() { return { electron: true, vitest: true }; }
    async analyzeTestingState() { return { framework: 'vitest', hasVitestConfig: true }; }
    async analyzeDependencies() { return { npm: [], issues: [] }; }
    async analyzeAutomationState() { return { level: 0.3, hasCICD: false }; }
    async checkFunctionalModes(modes) { return modes.slice(0, 4); } // Assume first 4 are functional
    calculatePhaseConfidence(state) { return 85; }
    prioritizeRemainingModes(calculators) { return calculators.pending.slice(0, 3); }
    assessCodeStructure(codebase) { return 'good'; }
    identifyCodePatterns(codebase) { return ['modular', 'class-based']; }
    assessMaintainability(codebase) { return 'high'; }
    analyzeModule(codebase, moduleName) { return { exists: true, quality: 'good' }; }
    identifyKeyRelationships(codebase) { return []; }
    async validateProjectStructure() { return { score: 0.9, issues: [] }; }
    async validateCalculatorFunctionality() { return { score: 0.8, issues: [] }; }
    async validateCodeQuality() { return { score: 0.85, issues: [] }; }
    async validateDependencies() { return { score: 0.95, issues: [] }; }
    generateValidationRecommendations(validations) { return []; }
    async reconstructWorkflow(state) { return { type: 'agile', automation: 'partial' }; }
    async assessQualityState(state) { return { overall: 'good', coverage: 'unknown' }; }
    generateRecommendations(context) { 
        return [
            'Run comprehensive tests to validate functionality',
            'Continue with next priority calculator mode implementation',
            'Set up automated testing pipeline'
        ];
    }

    /**
     * Handle recovery failure gracefully
     */
    async handleRecoveryFailure(error) {
        const fallbackContext = {
            status: 'RECOVERY_FAILED',
            error: error.message,
            basicInfo: {
                project: 'Calculator Suite',
                phase: 'Unknown - Manual analysis required',
                recommendations: [
                    'Check package.json for project configuration',
                    'Examine src/ directory for implementation details',
                    'Run npm install to ensure dependencies',
                    'Try npm start to test basic functionality'
                ]
            }
        };
        
        console.log('⚠️ Recovery failed - providing fallback context');
        return fallbackContext;
    }
}

module.exports = AutoRecoverySystem;

// Auto-execute if run directly
if (require.main === module) {
    const recovery = new AutoRecoverySystem();
    recovery.reconstructProjectContext()
        .then(result => {
            console.log('✅ Recovery completed successfully');
            console.log('📊 Context reconstruction results:', result.validation.overall);
            console.log('🎯 Next recommended action:', result.context.nextActions[0]?.action);
        })
        .catch(error => console.error('❌ Recovery failed:', error));
}