@vibecheckai/cli 3.7.0 → 3.8.0

package/bin/runners/lib/doctor/safe-repair.js

@@ -0,0 +1,384 @@
+/**
+ * Safe Repair Mode
+ * 
+ * Executes only safe, non-destructive repair actions.
+ * Actions that can cause data loss or require elevated permissions are excluded.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync, spawnSync } = require('child_process');
+const { SEVERITY, FIX_TYPE } = require('./types');
+
+const REPAIR_RESULT = {
+  SUCCESS: 'success',
+  FAILED: 'failed',
+  SKIPPED: 'skipped',
+  NOT_APPLICABLE: 'not_applicable',
+};
+
+/**
+ * Safe repair actions that can be automatically executed
+ */
+const SAFE_REPAIR_ACTIONS = [
+  {
+    id: 'clear-npm-cache',
+    name: 'Clear npm cache',
+    description: 'Removes npm cache to fix integrity issues',
+    applicableTo: ['npm-cache-corrupt', 'npm-permission-error'],
+    check: () => true, // Always applicable
+    execute: async (projectPath, options) => {
+      try {
+        execSync('npm cache clean --force', {
+          cwd: projectPath,
+          encoding: 'utf8',
+          timeout: 60000,
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'npm cache cleared' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'clear-node-modules-cache',
+    name: 'Clear node_modules cache directories',
+    description: 'Removes .cache directories inside node_modules',
+    applicableTo: ['cache-large', 'build-cache-corrupt'],
+    check: (projectPath) => {
+      const cachePath = path.join(projectPath, 'node_modules', '.cache');
+      return fs.existsSync(cachePath);
+    },
+    execute: async (projectPath, options) => {
+      const cachePath = path.join(projectPath, 'node_modules', '.cache');
+      try {
+        fs.rmSync(cachePath, { recursive: true, force: true });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'node_modules/.cache cleared' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'remove-eslint-cache',
+    name: 'Remove ESLint cache',
+    description: 'Removes .eslintcache file',
+    applicableTo: ['eslint-error', 'cache-large'],
+    check: (projectPath) => fs.existsSync(path.join(projectPath, '.eslintcache')),
+    execute: async (projectPath, options) => {
+      try {
+        fs.unlinkSync(path.join(projectPath, '.eslintcache'));
+        return { status: REPAIR_RESULT.SUCCESS, message: '.eslintcache removed' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'remove-tsbuildinfo',
+    name: 'Remove TypeScript build info',
+    description: 'Removes tsconfig.tsbuildinfo for clean TypeScript rebuild',
+    applicableTo: ['typescript-error', 'build-error'],
+    check: (projectPath) => {
+      // Check for any .tsbuildinfo file
+      return fs.existsSync(path.join(projectPath, 'tsconfig.tsbuildinfo')) ||
+        fs.existsSync(path.join(projectPath, '.tsbuildinfo'));
+    },
+    execute: async (projectPath, options) => {
+      const removed = [];
+      const files = ['tsconfig.tsbuildinfo', '.tsbuildinfo'];
+      
+      for (const file of files) {
+        const fullPath = path.join(projectPath, file);
+        if (fs.existsSync(fullPath)) {
+          try {
+            fs.unlinkSync(fullPath);
+            removed.push(file);
+          } catch {}
+        }
+      }
+      
+      if (removed.length > 0) {
+        return { status: REPAIR_RESULT.SUCCESS, message: `Removed: ${removed.join(', ')}` };
+      }
+      return { status: REPAIR_RESULT.NOT_APPLICABLE, message: 'No build info files found' };
+    },
+  },
+  {
+    id: 'remove-git-lock',
+    name: 'Remove git lock files',
+    description: 'Removes stale .git/*.lock files',
+    applicableTo: ['git-lock-file'],
+    check: (projectPath) => {
+      const gitDir = path.join(projectPath, '.git');
+      if (!fs.existsSync(gitDir)) return false;
+      
+      try {
+        const files = fs.readdirSync(gitDir);
+        return files.some(f => f.endsWith('.lock'));
+      } catch {
+        return false;
+      }
+    },
+    execute: async (projectPath, options) => {
+      const gitDir = path.join(projectPath, '.git');
+      const removed = [];
+      
+      try {
+        const files = fs.readdirSync(gitDir);
+        for (const file of files) {
+          if (file.endsWith('.lock')) {
+            fs.unlinkSync(path.join(gitDir, file));
+            removed.push(file);
+          }
+        }
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+      
+      if (removed.length > 0) {
+        return { status: REPAIR_RESULT.SUCCESS, message: `Removed: ${removed.join(', ')}` };
+      }
+      return { status: REPAIR_RESULT.NOT_APPLICABLE, message: 'No lock files found' };
+    },
+  },
+  {
+    id: 'create-vibecheck-dir',
+    name: 'Create .vibecheck directory',
+    description: 'Creates missing .vibecheck output directory',
+    applicableTo: ['vibecheck-dir-missing'],
+    check: (projectPath) => !fs.existsSync(path.join(projectPath, '.vibecheck')),
+    execute: async (projectPath, options) => {
+      try {
+        fs.mkdirSync(path.join(projectPath, '.vibecheck'), { recursive: true });
+        return { status: REPAIR_RESULT.SUCCESS, message: '.vibecheck directory created' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'fix-npm-registry',
+    name: 'Reset npm registry URL',
+    description: 'Sets npm registry to default npmjs.org',
+    applicableTo: ['npm-network-error'],
+    check: () => true,
+    execute: async (projectPath, options) => {
+      try {
+        execSync('npm config set registry https://registry.npmjs.org/', {
+          encoding: 'utf8',
+          timeout: 10000,
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'npm registry reset to default' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'npm-dedupe',
+    name: 'Deduplicate npm packages',
+    description: 'Runs npm dedupe to reduce duplicate packages',
+    applicableTo: ['dependencies-large', 'peer-deps'],
+    check: (projectPath) => fs.existsSync(path.join(projectPath, 'node_modules')),
+    execute: async (projectPath, options) => {
+      try {
+        execSync('npm dedupe', {
+          cwd: projectPath,
+          encoding: 'utf8',
+          timeout: 120000, // 2 minutes
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'npm dedupe completed' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'rebuild-native-modules',
+    name: 'Rebuild native modules',
+    description: 'Runs npm rebuild for native module issues',
+    applicableTo: ['native-module-build', 'node-version-mismatch'],
+    check: (projectPath) => fs.existsSync(path.join(projectPath, 'node_modules')),
+    execute: async (projectPath, options) => {
+      try {
+        execSync('npm rebuild', {
+          cwd: projectPath,
+          encoding: 'utf8',
+          timeout: 300000, // 5 minutes
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'npm rebuild completed' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+  {
+    id: 'prune-dev-dependencies',
+    name: 'Prune development dependencies',
+    description: 'Removes extraneous packages',
+    applicableTo: ['dependencies-large'],
+    check: (projectPath) => fs.existsSync(path.join(projectPath, 'node_modules')),
+    execute: async (projectPath, options) => {
+      try {
+        execSync('npm prune', {
+          cwd: projectPath,
+          encoding: 'utf8',
+          timeout: 60000,
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { status: REPAIR_RESULT.SUCCESS, message: 'npm prune completed' };
+      } catch (err) {
+        return { status: REPAIR_RESULT.FAILED, message: err.message };
+      }
+    },
+  },
+];
+
+/**
+ * Run safe repair on a project
+ * @param {object[]} diagnostics - Diagnostic results
+ * @param {string} projectPath - Project path
+ * @param {object} options - Repair options
+ * @returns {object} Repair results
+ */
+async function runSafeRepair(diagnostics, projectPath, options = {}) {
+  const {
+    dryRun = false,
+    verbose = false,
+    maxActions = 10,
+  } = options;
+  
+  const results = [];
+  let actionsRun = 0;
+  
+  // Identify which repairs are applicable
+  const applicableRepairs = [];
+  
+  for (const action of SAFE_REPAIR_ACTIONS) {
+    // Check if this repair applies to any diagnostics
+    const relevantDiag = diagnostics.find(d => 
+      (d.severity === SEVERITY.ERROR || d.severity === SEVERITY.WARNING) &&
+      action.applicableTo.some(pattern => d.id.includes(pattern) || d.message?.toLowerCase().includes(pattern))
+    );
+    
+    if (relevantDiag && action.check(projectPath)) {
+      applicableRepairs.push({
+        action,
+        diagnostic: relevantDiag,
+      });
+    }
+  }
+  
+  // Execute repairs
+  for (const { action, diagnostic } of applicableRepairs) {
+    if (actionsRun >= maxActions) break;
+    
+    const result = {
+      actionId: action.id,
+      actionName: action.name,
+      description: action.description,
+      relatedDiagnostic: diagnostic.id,
+    };
+    
+    if (dryRun) {
+      result.status = REPAIR_RESULT.SKIPPED;
+      result.message = 'Dry run - would execute';
+      results.push(result);
+      continue;
+    }
+    
+    try {
+      const execResult = await action.execute(projectPath, options);
+      result.status = execResult.status;
+      result.message = execResult.message;
+      
+      if (execResult.status === REPAIR_RESULT.SUCCESS) {
+        actionsRun++;
+      }
+    } catch (err) {
+      result.status = REPAIR_RESULT.FAILED;
+      result.message = err.message;
+    }
+    
+    results.push(result);
+  }
+  
+  // Summary
+  const summary = {
+    total: results.length,
+    succeeded: results.filter(r => r.status === REPAIR_RESULT.SUCCESS).length,
+    failed: results.filter(r => r.status === REPAIR_RESULT.FAILED).length,
+    skipped: results.filter(r => r.status === REPAIR_RESULT.SKIPPED).length,
+    notApplicable: results.filter(r => r.status === REPAIR_RESULT.NOT_APPLICABLE).length,
+  };
+  
+  return {
+    projectPath,
+    timestamp: new Date().toISOString(),
+    dryRun,
+    results,
+    summary,
+    needsRecheck: summary.succeeded > 0,
+  };
+}
+
+/**
+ * Get list of all available safe repair actions
+ * @returns {object[]} Safe repair actions
+ */
+function listSafeRepairActions() {
+  return SAFE_REPAIR_ACTIONS.map(a => ({
+    id: a.id,
+    name: a.name,
+    description: a.description,
+    applicableTo: a.applicableTo,
+  }));
+}
+
+/**
+ * Run a specific repair action by ID
+ * @param {string} actionId - Action ID to run
+ * @param {string} projectPath - Project path
+ * @param {object} options - Options
+ * @returns {object} Result
+ */
+async function runRepairAction(actionId, projectPath, options = {}) {
+  const action = SAFE_REPAIR_ACTIONS.find(a => a.id === actionId);
+  
+  if (!action) {
+    return {
+      status: REPAIR_RESULT.FAILED,
+      message: `Unknown repair action: ${actionId}`,
+    };
+  }
+  
+  if (!action.check(projectPath)) {
+    return {
+      status: REPAIR_RESULT.NOT_APPLICABLE,
+      message: 'Repair action not applicable to current project state',
+    };
+  }
+  
+  if (options.dryRun) {
+    return {
+      status: REPAIR_RESULT.SKIPPED,
+      message: 'Dry run - would execute',
+      action: action.name,
+    };
+  }
+  
+  return action.execute(projectPath, options);
+}
+
+module.exports = {
+  REPAIR_RESULT,
+  SAFE_REPAIR_ACTIONS,
+  runSafeRepair,
+  listSafeRepairActions,
+  runRepairAction,
+};