agileflow 2.73.0 → 2.74.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.73.0",
+  "version": "2.74.0",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/scripts/agileflow-configure.js

@@ -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',
@@ -811,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
 // ============================================================================
@@ -907,6 +1169,12 @@ ${c.cyan}Maintenance:${c.reset}
   --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 .agileflow/scripts/agileflow-configure.js --profile=full
@@ -934,6 +1202,18 @@ ${c.cyan}Examples:${c.reset}
 
   # 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
 `);
 }
 
@@ -956,6 +1236,10 @@ function main() {
   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];
@@ -985,6 +1269,13 @@ function main() {
     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) {
@@ -992,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();

package/src/core/commands/configure.md

@@ -1,6 +1,6 @@
 ---
 description: Configure advanced AgileFlow features (git, hooks, archival, CI, status line)
-argument-hint: [--profile=full|basic|minimal|none] [--enable/--disable=features] [--migrate] [--upgrade]
+argument-hint: [--profile=full|basic|minimal|none] [--enable/--disable=features] [--migrate] [--upgrade] [--repair] [--version] [--list-scripts]
 ---
 
 <!-- COMPACT_SUMMARY_START -->
@@ -26,6 +26,10 @@ node .agileflow/scripts/agileflow-configure.js --profile=full       # Enable all
 node .agileflow/scripts/agileflow-configure.js --profile=none       # Disable all
 node .agileflow/scripts/agileflow-configure.js --enable=sessionstart  # Enable specific
 node .agileflow/scripts/agileflow-configure.js --disable=archival   # Disable specific
+node .agileflow/scripts/agileflow-configure.js --list-scripts       # Show all scripts status
+node .agileflow/scripts/agileflow-configure.js --version            # Version info
+node .agileflow/scripts/agileflow-configure.js --repair             # Fix missing scripts
+node .agileflow/scripts/agileflow-configure.js --repair=statusline  # Fix specific feature
 ```
 
 **Note:** All scripts are located in `.agileflow/scripts/` - no files in project root `scripts/`.
@@ -343,3 +347,86 @@ Upgrading precompact...
 
 ✅ Upgraded 2 feature(s) to v2.71.0
 ```
+
+## Repair & Diagnostics
+
+When scripts are accidentally deleted or corrupted, use these commands:
+
+### List Scripts Status
+
+```bash
+node .agileflow/scripts/agileflow-configure.js --list-scripts
+```
+
+Shows all scripts with their status (present/missing/modified):
+
+```
+📋 Installed Scripts
+  ✅ agileflow-welcome.js: present
+  ✅ precompact-context.sh: present
+  ❌ agileflow-statusline.sh: MISSING
+     └─ Feature: statusline
+  ⚠️  obtain-context.js: modified (local changes)
+
+Summary: 15 present, 1 modified, 1 missing
+
+💡 Run with --repair to restore missing scripts
+```
+
+### Show Version Info
+
+```bash
+node .agileflow/scripts/agileflow-configure.js --version
+```
+
+Shows installed vs latest versions:
+
+```
+📊 Version Information
+Installed:  v2.71.0
+CLI:        v2.73.0
+Latest:     v2.73.0
+
+🔄 Update available! Run: npx agileflow update
+
+Feature Versions:
+  ✅ sessionstart: v2.73.0
+  🔄 precompact: v2.68.0 → v2.73.0
+  ✅ archival: v2.73.0
+  ❌ statusline: disabled
+```
+
+### Repair Missing Scripts
+
+```bash
+# Repair all missing scripts
+node .agileflow/scripts/agileflow-configure.js --repair
+
+# Repair scripts for a specific feature only
+node .agileflow/scripts/agileflow-configure.js --repair=statusline
+```
+
+Output:
+
+```
+🔧 Repairing Scripts...
+✅ Restored agileflow-statusline.sh
+
+Repaired: 1, Errors: 0, Skipped: 18
+
+═══════════════════════════════════════════════════════
+🔴 RESTART CLAUDE CODE NOW!
+   Quit completely, wait 5 seconds, restart
+═══════════════════════════════════════════════════════
+```
+
+### When to Use Each Command
+
+| Scenario | Command |
+|----------|---------|
+| Accidentally deleted a script | `--repair` |
+| Want to see what's installed | `--list-scripts` |
+| Check if update is available | `--version` |
+| Scripts outdated (feature version differs) | `--upgrade` |
+| Settings format broken | `--migrate` |
+| Major corruption/reinstall needed | `npx agileflow update --force`