agileflow 2.72.0 → 2.74.0

package/scripts/agileflow-configure.js

@@ -11,7 +11,7 @@
  *   - RECONFIGURE: Change settings (archival days, etc.)
  *
  * Usage:
- *   node scripts/agileflow-configure.js [options]
+ *   node .agileflow/scripts/agileflow-configure.js [options]
  *
  * Options:
  *   --profile=full|basic|minimal|none   Apply a preset
@@ -77,6 +77,34 @@ const FEATURES = {
   autoupdate: { metadataOnly: true }, // Stored in metadata.updates.autoUpdate
 };
 
+// Complete registry of all scripts that may need repair
+const ALL_SCRIPTS = {
+  // Core feature scripts (linked to FEATURES)
+  'agileflow-welcome.js': { feature: 'sessionstart', required: true },
+  'precompact-context.sh': { feature: 'precompact', required: true },
+  'archive-completed-stories.sh': { feature: 'archival', required: true },
+  'agileflow-statusline.sh': { feature: 'statusline', required: true },
+
+  // Support scripts (used by commands/agents)
+  'obtain-context.js': { usedBy: ['/babysit', '/mentor', '/sprint'] },
+  'session-manager.js': { usedBy: ['/session:new', '/session:resume'] },
+  'check-update.js': { usedBy: ['SessionStart hook'] },
+  'get-env.js': { usedBy: ['SessionStart hook'] },
+  'clear-active-command.js': { usedBy: ['session commands'] },
+
+  // Utility scripts
+  'compress-status.sh': { usedBy: ['/compress'] },
+  'validate-expertise.sh': { usedBy: ['/validate-expertise'] },
+  'expertise-metrics.sh': { usedBy: ['agent experts'] },
+  'session-coordinator.sh': { usedBy: ['session management'] },
+  'validate-tokens.sh': { usedBy: ['token validation'] },
+  'worktree-create.sh': { usedBy: ['/session:new'] },
+  'resume-session.sh': { usedBy: ['/session:resume'] },
+  'init.sh': { usedBy: ['/session:init'] },
+  'agileflow-configure.js': { usedBy: ['/configure'] },
+  'generate-all.sh': { usedBy: ['content generation'] },
+};
+
 // Statusline component names
 const STATUSLINE_COMPONENTS = [
   'agileflow',
@@ -93,19 +121,19 @@ const PROFILES = {
   full: {
     description: 'All features enabled',
     enable: ['sessionstart', 'precompact', 'archival', 'statusline'],
-    archivalDays: 7,
+    archivalDays: 30,
   },
   basic: {
     description: 'Essential hooks + archival (SessionStart + PreCompact + Archival)',
     enable: ['sessionstart', 'precompact', 'archival'],
     disable: ['statusline'],
-    archivalDays: 7,
+    archivalDays: 30,
   },
   minimal: {
     description: 'SessionStart + archival only',
     enable: ['sessionstart', 'archival'],
     disable: ['precompact', 'statusline'],
-    archivalDays: 7,
+    archivalDays: 30,
   },
   none: {
     description: 'Disable all AgileFlow features',
@@ -155,22 +183,16 @@ const writeJSON = (filePath, data) => {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
 };
 
-const copyTemplate = (templateName, destPath) => {
-  const sources = [
-    path.join(process.cwd(), '.agileflow', 'templates', templateName),
-    path.join(__dirname, templateName),
-    path.join(__dirname, '..', 'templates', templateName),
-  ];
-  for (const src of sources) {
-    if (fs.existsSync(src)) {
-      fs.copyFileSync(src, destPath);
-      try {
-        fs.chmodSync(destPath, '755');
-      } catch {}
-      return true;
-    }
-  }
-  return false;
+// Scripts are located in .agileflow/scripts/ (installed by AgileFlow)
+const SCRIPTS_DIR = path.join(process.cwd(), '.agileflow', 'scripts');
+
+const scriptExists = scriptName => {
+  const scriptPath = path.join(SCRIPTS_DIR, scriptName);
+  return fs.existsSync(scriptPath);
+};
+
+const getScriptPath = scriptName => {
+  return `.agileflow/scripts/${scriptName}`;
 };
 
 // ============================================================================
@@ -184,12 +206,14 @@ function detectConfig() {
     settingsValid: true,
     settingsIssues: [],
     features: {
-      sessionstart: { enabled: false, valid: true, issues: [] },
-      precompact: { enabled: false, valid: true, issues: [] },
-      archival: { enabled: false, threshold: null },
-      statusline: { enabled: false, valid: true, issues: [] },
+      sessionstart: { enabled: false, valid: true, issues: [], version: null, outdated: false },
+      precompact: { enabled: false, valid: true, issues: [], version: null, outdated: false },
+      archival: { enabled: false, threshold: null, version: null, outdated: false },
+      statusline: { enabled: false, valid: true, issues: [], version: null, outdated: false },
     },
     metadata: { exists: false, version: null },
+    currentVersion: VERSION,
+    hasOutdated: false,
   };
 
   // Git
@@ -280,6 +304,20 @@ function detectConfig() {
         status.features.archival.enabled = true;
         status.features.archival.threshold = meta.archival.threshold_days;
       }
+
+      // Read feature versions from metadata and check if outdated
+      if (meta.features) {
+        Object.entries(meta.features).forEach(([feature, data]) => {
+          if (status.features[feature] && data.version) {
+            status.features[feature].version = data.version;
+            // Check if feature version differs from current VERSION
+            if (data.version !== VERSION && status.features[feature].enabled) {
+              status.features[feature].outdated = true;
+              status.hasOutdated = true;
+            }
+          }
+        });
+      }
     }
   }
 
@@ -317,6 +355,10 @@ function printStatus(status) {
       statusIcon = '⚠️';
       statusText = 'INVALID FORMAT';
       color = c.yellow;
+    } else if (f.enabled && f.outdated) {
+      statusIcon = '🔄';
+      statusText = `outdated (v${f.version} → v${status.currentVersion})`;
+      color = c.yellow;
     }
 
     log(`  ${statusIcon} ${label}: ${statusText}`, color);
@@ -348,7 +390,11 @@ function printStatus(status) {
     log('\n⚠️  Format issues detected! Run with --migrate to fix.', c.yellow);
   }
 
-  return hasIssues;
+  if (status.hasOutdated) {
+    log('\n🔄 Outdated scripts detected! Run with --upgrade to update.', c.yellow);
+  }
+
+  return { hasIssues, hasOutdated: status.hasOutdated };
 }
 
 // ============================================================================
@@ -454,6 +500,34 @@ function migrateSettings() {
   return migrated;
 }
 
+// ============================================================================
+// UPGRADE FEATURES
+// ============================================================================
+
+function upgradeFeatures(status) {
+  header('🔄 Upgrading Outdated Features...');
+
+  let upgraded = 0;
+
+  Object.entries(status.features).forEach(([feature, data]) => {
+    if (data.enabled && data.outdated) {
+      log(`\nUpgrading ${feature}...`, c.cyan);
+      // Re-enable the feature to deploy latest scripts
+      if (enableFeature(feature, { archivalDays: data.threshold || 30, isUpgrade: true })) {
+        upgraded++;
+      }
+    }
+  });
+
+  if (upgraded === 0) {
+    info('No features needed upgrading');
+  } else {
+    success(`Upgraded ${upgraded} feature(s) to v${VERSION}`);
+  }
+
+  return upgraded > 0;
+}
+
 // ============================================================================
 // ENABLE/DISABLE FEATURES
 // ============================================================================
@@ -466,7 +540,6 @@ function enableFeature(feature, options = {}) {
   }
 
   ensureDir('.claude');
-  ensureDir('scripts');
 
   const settings = readJSON('.claude/settings.json') || {};
   settings.hooks = settings.hooks || {};
@@ -474,25 +547,13 @@ function enableFeature(feature, options = {}) {
 
   // Handle hook-based features
   if (config.hook) {
-    const scriptPath = `scripts/${config.script}`;
-
-    // Deploy script
-    if (!copyTemplate(config.script, scriptPath)) {
-      // Create minimal version
-      if (feature === 'sessionstart') {
-        fs.writeFileSync(
-          scriptPath,
-          `#!/usr/bin/env node\nconsole.log('AgileFlow v${VERSION} loaded');\n`
-        );
-      } else if (feature === 'precompact') {
-        fs.writeFileSync(scriptPath, '#!/bin/bash\necho "PreCompact: preserving context"\n');
-      }
-      try {
-        fs.chmodSync(scriptPath, '755');
-      } catch {}
-      warn(`Created minimal ${config.script}`);
-    } else {
-      success(`Deployed ${config.script}`);
+    const scriptPath = getScriptPath(config.script);
+
+    // Verify script exists
+    if (!scriptExists(config.script)) {
+      error(`Script not found: ${scriptPath}`);
+      info('Run "npx agileflow update" to reinstall scripts');
+      return false;
     }
 
     // Configure hook
@@ -504,18 +565,18 @@ function enableFeature(feature, options = {}) {
         hooks: [{ type: 'command', command }],
       },
     ];
-    success(`${config.hook} hook enabled`);
+    success(`${config.hook} hook enabled (${config.script})`);
   }
 
   // Handle archival
   if (feature === 'archival') {
-    const days = options.archivalDays || 7;
-    const scriptPath = 'scripts/archive-completed-stories.sh';
+    const days = options.archivalDays || 30;
+    const scriptPath = getScriptPath('archive-completed-stories.sh');
 
-    if (!copyTemplate('archive-completed-stories.sh', scriptPath)) {
-      warn('Archival script template not found');
-    } else {
-      success('Deployed archive-completed-stories.sh');
+    if (!scriptExists('archive-completed-stories.sh')) {
+      error(`Script not found: ${scriptPath}`);
+      info('Run "npx agileflow update" to reinstall scripts');
+      return false;
     }
 
     // Add to SessionStart hook
@@ -526,7 +587,7 @@ function enableFeature(feature, options = {}) {
       if (!hasArchival) {
         settings.hooks.SessionStart[0].hooks.push({
           type: 'command',
-          command: 'bash scripts/archive-completed-stories.sh --quiet',
+          command: `bash ${scriptPath} --quiet`,
         });
       }
     }
@@ -538,28 +599,17 @@ function enableFeature(feature, options = {}) {
 
   // Handle statusLine
   if (feature === 'statusline') {
-    const scriptPath = 'scripts/agileflow-statusline.sh';
-
-    if (!copyTemplate('agileflow-statusline.sh', scriptPath)) {
-      fs.writeFileSync(
-        scriptPath,
-        `#!/bin/bash
-input=$(cat)
-MODEL=$(echo "$input" | jq -r '.model.display_name // "Claude"')
-echo "[$MODEL] AgileFlow"
-`
-      );
-      try {
-        fs.chmodSync(scriptPath, '755');
-      } catch {}
-      warn('Created minimal statusline script');
-    } else {
-      success('Deployed agileflow-statusline.sh');
+    const scriptPath = getScriptPath('agileflow-statusline.sh');
+
+    if (!scriptExists('agileflow-statusline.sh')) {
+      error(`Script not found: ${scriptPath}`);
+      info('Run "npx agileflow update" to reinstall scripts');
+      return false;
     }
 
     settings.statusLine = {
       type: 'command',
-      command: 'bash scripts/agileflow-statusline.sh',
+      command: `bash ${scriptPath}`,
       padding: 0,
     };
     success('Status line enabled');
@@ -789,6 +839,240 @@ function listStatuslineComponents() {
   log(`Components: ${STATUSLINE_COMPONENTS.join(', ')}`, c.dim);
 }
 
+// ============================================================================
+// REPAIR & DIAGNOSTICS
+// ============================================================================
+
+const crypto = require('crypto');
+
+/**
+ * Calculate SHA256 hash of a file
+ */
+function sha256(data) {
+  return crypto.createHash('sha256').update(data).digest('hex');
+}
+
+/**
+ * Get the source scripts directory (from npm package)
+ */
+function getSourceScriptsDir() {
+  // When running from installed package, __dirname is .agileflow/scripts
+  // The source is the same directory since it was copied during install
+  // But for repair, we need the npm package source
+
+  // Try to find the npm package (when run via npx or global install)
+  const possiblePaths = [
+    path.join(__dirname, '..', '..', 'scripts'), // npm package structure
+    path.join(__dirname), // Same directory (for development)
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p) && fs.existsSync(path.join(p, 'agileflow-welcome.js'))) {
+      return p;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * List all scripts with their status (present/missing/modified)
+ */
+function listScripts() {
+  header('📋 Installed Scripts');
+
+  const scriptsDir = path.join(process.cwd(), '.agileflow', 'scripts');
+  const fileIndexPath = path.join(process.cwd(), '.agileflow', '_cfg', 'files.json');
+  const fileIndex = readJSON(fileIndexPath);
+
+  let missing = 0;
+  let modified = 0;
+  let present = 0;
+
+  Object.entries(ALL_SCRIPTS).forEach(([script, info]) => {
+    const scriptPath = path.join(scriptsDir, script);
+    const exists = fs.existsSync(scriptPath);
+
+    // Check if modified (compare to file index hash)
+    let isModified = false;
+    if (exists && fileIndex?.files?.[`scripts/${script}`]) {
+      try {
+        const currentHash = sha256(fs.readFileSync(scriptPath));
+        const indexHash = fileIndex.files[`scripts/${script}`].sha256;
+        isModified = currentHash !== indexHash;
+      } catch {}
+    }
+
+    // Print status
+    if (!exists) {
+      log(`  ❌ ${script}: MISSING`, c.red);
+      if (info.usedBy) log(`     └─ Used by: ${info.usedBy.join(', ')}`, c.dim);
+      if (info.feature) log(`     └─ Feature: ${info.feature}`, c.dim);
+      missing++;
+    } else if (isModified) {
+      log(`  ⚠️  ${script}: modified (local changes)`, c.yellow);
+      modified++;
+    } else {
+      log(`  ✅ ${script}: present`, c.green);
+      present++;
+    }
+  });
+
+  // Summary
+  log('');
+  log(`Summary: ${present} present, ${modified} modified, ${missing} missing`, c.dim);
+
+  if (missing > 0) {
+    log('\n💡 Run with --repair to restore missing scripts', c.yellow);
+  }
+}
+
+/**
+ * Show version information
+ */
+function showVersionInfo() {
+  header('📊 Version Information');
+
+  const meta = readJSON('docs/00-meta/agileflow-metadata.json') || {};
+  const manifest = readJSON('.agileflow/_cfg/manifest.yaml');
+
+  const installedVersion = meta.version || 'unknown';
+
+  log(`Installed:  v${installedVersion}`);
+  log(`CLI:        v${VERSION}`);
+
+  // Check npm for latest
+  let latestVersion = null;
+  try {
+    latestVersion = execSync('npm view agileflow version 2>/dev/null', { encoding: 'utf8' }).trim();
+    log(`Latest:     v${latestVersion}`);
+
+    if (installedVersion !== 'unknown' && latestVersion && installedVersion !== latestVersion) {
+      const installed = installedVersion.split('.').map(Number);
+      const latest = latestVersion.split('.').map(Number);
+
+      if (latest[0] > installed[0] ||
+          (latest[0] === installed[0] && latest[1] > installed[1]) ||
+          (latest[0] === installed[0] && latest[1] === installed[1] && latest[2] > installed[2])) {
+        log('\n🔄 Update available! Run: npx agileflow update', c.yellow);
+      }
+    }
+  } catch {
+    log('Latest:     (could not check npm)', c.dim);
+  }
+
+  // Show per-feature versions
+  if (meta.features && Object.keys(meta.features).length > 0) {
+    header('Feature Versions:');
+    Object.entries(meta.features).forEach(([feature, data]) => {
+      if (!data) return;
+      const featureVersion = data.version || 'unknown';
+      const enabled = data.enabled !== false;
+      const outdated = featureVersion !== VERSION && enabled;
+
+      let icon = '❌';
+      let color = c.dim;
+      let statusText = `v${featureVersion}`;
+
+      if (!enabled) {
+        statusText = 'disabled';
+      } else if (outdated) {
+        icon = '🔄';
+        color = c.yellow;
+        statusText = `v${featureVersion} → v${VERSION}`;
+      } else {
+        icon = '✅';
+        color = c.green;
+      }
+
+      log(`  ${icon} ${feature}: ${statusText}`, color);
+    });
+  }
+
+  // Show installation metadata
+  if (meta.created || meta.updated) {
+    header('Installation:');
+    if (meta.created) log(`  Created:  ${new Date(meta.created).toLocaleDateString()}`, c.dim);
+    if (meta.updated) log(`  Updated:  ${new Date(meta.updated).toLocaleDateString()}`, c.dim);
+  }
+}
+
+/**
+ * Repair missing or corrupted scripts
+ */
+function repairScripts(targetFeature = null) {
+  header('🔧 Repairing Scripts...');
+
+  const scriptsDir = path.join(process.cwd(), '.agileflow', 'scripts');
+  const sourceDir = getSourceScriptsDir();
+
+  if (!sourceDir) {
+    warn('Could not find source scripts directory');
+    info('Try running: npx agileflow@latest update');
+    return false;
+  }
+
+  let repaired = 0;
+  let errors = 0;
+  let skipped = 0;
+
+  // Determine which scripts to check
+  const scriptsToCheck = targetFeature
+    ? Object.entries(ALL_SCRIPTS).filter(([_, info]) => info.feature === targetFeature)
+    : Object.entries(ALL_SCRIPTS);
+
+  if (scriptsToCheck.length === 0 && targetFeature) {
+    error(`Unknown feature: ${targetFeature}`);
+    log(`Available features: ${Object.keys(FEATURES).join(', ')}`, c.dim);
+    return false;
+  }
+
+  // Ensure scripts directory exists
+  ensureDir(scriptsDir);
+
+  for (const [script, info] of scriptsToCheck) {
+    const destPath = path.join(scriptsDir, script);
+    const srcPath = path.join(sourceDir, script);
+
+    if (!fs.existsSync(destPath)) {
+      // Script is missing - reinstall from source
+      if (fs.existsSync(srcPath)) {
+        try {
+          fs.copyFileSync(srcPath, destPath);
+          // Make executable
+          try {
+            fs.chmodSync(destPath, 0o755);
+          } catch {}
+          success(`Restored ${script}`);
+          repaired++;
+        } catch (err) {
+          error(`Failed to restore ${script}: ${err.message}`);
+          errors++;
+        }
+      } else {
+        warn(`Source not found for ${script}`);
+        errors++;
+      }
+    } else {
+      skipped++;
+    }
+  }
+
+  // Summary
+  log('');
+  if (repaired === 0 && errors === 0) {
+    info('All scripts present - nothing to repair');
+  } else {
+    log(`Repaired: ${repaired}, Errors: ${errors}, Skipped: ${skipped}`, c.dim);
+  }
+
+  if (errors > 0) {
+    log('\n💡 For comprehensive repair, run: npx agileflow update --force', c.yellow);
+  }
+
+  return repaired > 0;
+}
+
 // ============================================================================
 // PROFILES
 // ============================================================================
@@ -855,7 +1139,7 @@ function printHelp() {
 ${c.bold}AgileFlow Configure${c.reset} - Manage AgileFlow features
 
 ${c.cyan}Usage:${c.reset}
-  node scripts/agileflow-configure.js [options]
+  node .agileflow/scripts/agileflow-configure.js [options]
 
 ${c.cyan}Profiles:${c.reset}
   --profile=full      All features (hooks, archival, statusline)
@@ -877,37 +1161,59 @@ ${c.cyan}Statusline Components:${c.reset}
   Components: agileflow, model, story, epic, wip, context, cost, git
 
 ${c.cyan}Settings:${c.reset}
-  --archival-days=N   Set archival threshold (default: 7)
+  --archival-days=N   Set archival threshold (default: 30)
 
 ${c.cyan}Maintenance:${c.reset}
   --migrate           Fix old/invalid formats
+  --upgrade           Re-deploy all enabled features with latest scripts
   --validate          Check for issues (same as --detect)
   --detect            Show current configuration
 
+${c.cyan}Repair & Diagnostics:${c.reset}
+  --repair              Check for and restore missing scripts
+  --repair=<feature>    Repair scripts for a specific feature (e.g., statusline)
+  --version             Show installed vs latest version info
+  --list-scripts        List all scripts with their status (missing/present/modified)
+
 ${c.cyan}Examples:${c.reset}
   # Quick setup with all features
-  node scripts/agileflow-configure.js --profile=full
+  node .agileflow/scripts/agileflow-configure.js --profile=full
 
   # Enable specific features
-  node scripts/agileflow-configure.js --enable=sessionstart,precompact,archival
+  node .agileflow/scripts/agileflow-configure.js --enable=sessionstart,precompact,archival
 
   # Disable a feature
-  node scripts/agileflow-configure.js --disable=statusline
+  node .agileflow/scripts/agileflow-configure.js --disable=statusline
 
   # Show only agileflow branding and context in statusline
-  node scripts/agileflow-configure.js --hide=model,story,epic,wip,cost,git
+  node .agileflow/scripts/agileflow-configure.js --hide=model,story,epic,wip,cost,git
 
   # Re-enable git branch in statusline
-  node scripts/agileflow-configure.js --show=git
+  node .agileflow/scripts/agileflow-configure.js --show=git
 
   # List component status
-  node scripts/agileflow-configure.js --components
+  node .agileflow/scripts/agileflow-configure.js --components
 
   # Fix format issues
-  node scripts/agileflow-configure.js --migrate
+  node .agileflow/scripts/agileflow-configure.js --migrate
 
   # Check current status
-  node scripts/agileflow-configure.js --detect
+  node .agileflow/scripts/agileflow-configure.js --detect
+
+  # Upgrade outdated scripts to latest version
+  node .agileflow/scripts/agileflow-configure.js --upgrade
+
+  # List all scripts with status
+  node .agileflow/scripts/agileflow-configure.js --list-scripts
+
+  # Show version information
+  node .agileflow/scripts/agileflow-configure.js --version
+
+  # Repair missing scripts
+  node .agileflow/scripts/agileflow-configure.js --repair
+
+  # Repair scripts for a specific feature
+  node .agileflow/scripts/agileflow-configure.js --repair=statusline
 `);
 }
 
@@ -924,11 +1230,16 @@ function main() {
   let disable = [];
   let show = [];
   let hide = [];
-  let archivalDays = 7;
+  let archivalDays = 30;
   let migrate = false;
   let detect = false;
+  let upgrade = false;
   let components = false;
   let help = false;
+  let repair = false;
+  let repairFeature = null;
+  let showVersion = false;
+  let listScriptsMode = false;
 
   args.forEach(arg => {
     if (arg.startsWith('--profile=')) profile = arg.split('=')[1];
@@ -952,11 +1263,19 @@ function main() {
         .split('=')[1]
         .split(',')
         .map(s => s.trim().toLowerCase());
-    else if (arg.startsWith('--archival-days=')) archivalDays = parseInt(arg.split('=')[1]) || 7;
+    else if (arg.startsWith('--archival-days=')) archivalDays = parseInt(arg.split('=')[1]) || 30;
     else if (arg === '--migrate') migrate = true;
     else if (arg === '--detect' || arg === '--validate') detect = true;
+    else if (arg === '--upgrade') upgrade = true;
     else if (arg === '--components') components = true;
     else if (arg === '--help' || arg === '-h') help = true;
+    else if (arg === '--repair') repair = true;
+    else if (arg.startsWith('--repair=')) {
+      repair = true;
+      repairFeature = arg.split('=')[1].trim().toLowerCase();
+    }
+    else if (arg === '--version' || arg === '-v') showVersion = true;
+    else if (arg === '--list-scripts' || arg === '--scripts') listScriptsMode = true;
   });
 
   if (help) {
@@ -964,6 +1283,30 @@ function main() {
     return;
   }
 
+  // List scripts mode (standalone, doesn't need detection)
+  if (listScriptsMode) {
+    listScripts();
+    return;
+  }
+
+  // Version info mode (standalone, doesn't need detection)
+  if (showVersion) {
+    showVersionInfo();
+    return;
+  }
+
+  // Repair mode (standalone, doesn't need detection)
+  if (repair) {
+    const needsRestart = repairScripts(repairFeature);
+    if (needsRestart) {
+      log('\n' + '═'.repeat(55), c.red);
+      log('🔴 RESTART CLAUDE CODE NOW!', c.red + c.bold);
+      log('   Quit completely, wait 5 seconds, restart', c.red);
+      log('═'.repeat(55), c.red);
+    }
+    return;
+  }
+
   // Components list mode
   if (components && show.length === 0 && hide.length === 0) {
     listStatuslineComponents();
@@ -979,10 +1322,16 @@ function main() {
 
   // Always detect first
   const status = detectConfig();
-  const hasIssues = printStatus(status);
+  const { hasIssues, hasOutdated } = printStatus(status);
 
   // Detect only mode
-  if (detect && !migrate && !profile && enable.length === 0 && disable.length === 0) {
+  if (detect && !migrate && !upgrade && !profile && enable.length === 0 && disable.length === 0) {
+    return;
+  }
+
+  // Upgrade mode
+  if (upgrade) {
+    upgradeFeatures(status);
     return;
   }