agileflow 3.4.3 → 4.0.0-alpha.1

package/scripts/agileflow-welcome.js

@@ -1,2246 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * agileflow-welcome.js - Beautiful SessionStart welcome display
- *
- * Shows a transparent ASCII table with:
- * - Project info (name, version, branch, commit)
- * - Story stats (WIP, blocked, completed)
- * - Archival status
- * - Session cleanup status
- * - Last commit
- *
- * PERFORMANCE OPTIMIZATION (US-0356):
- * Phase 1: Table display + instant notifications (~300-350ms)
- * Phase 2: Cached update check + instant post-table notifications
- * Phase 3: Background deferred work via welcome-deferred.js
- *   - npm update check (with cache write)
- *   - Session health warnings
- *   - Duplicate process detection
- *   - Story claiming/file tracking cleanup
- *   - Epic completion, ideation sync, automations
- *   Deferred warnings saved to session-state.json, displayed next session.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { executeCommandSync, git, spawnBackground } = require('../lib/process-executor');
-
-// Shared utilities
-const { c, box } = require('../lib/colors');
-const {
-  getProjectRoot,
-  getStatusPath,
-  getMetadataPath,
-  getSessionStatePath,
-  getAgileflowDir,
-  getClaudeDir,
-} = require('../lib/paths');
-const { readJSONCached, readFileCached } = require('../lib/file-cache');
-const { tryOptional } = require('../lib/errors');
-const { createLogger } = require('../lib/logger');
-const log = createLogger('welcome');
-
-// PERFORMANCE OPTIMIZATION (US-0356): Profiling helper
-// Only active when AGILEFLOW_DEBUG=welcome is set
-const _profiling = process.env.AGILEFLOW_DEBUG === 'welcome';
-const _timings = {};
-function _mark(label) {
-  if (_profiling) _timings[label] = process.hrtime.bigint();
-}
-function _elapsed(from, to) {
-  if (!_profiling) return '';
-  const ns = Number((_timings[to] || process.hrtime.bigint()) - (_timings[from] || 0n));
-  return `${(ns / 1e6).toFixed(1)}ms`;
-}
-function _logTimings() {
-  if (!_profiling) return;
-  const labels = Object.keys(_timings);
-  const pairs = [];
-  for (let i = 1; i < labels.length; i++) {
-    pairs.push(`${labels[i]}=${_elapsed(labels[i - 1], labels[i])}`);
-  }
-  if (labels.length >= 2) {
-    pairs.push(`TOTAL=${_elapsed(labels[0], labels[labels.length - 1])}`);
-  }
-  // Output to stderr so it doesn't mix with the welcome table
-  console.error(`[welcome:timing] ${pairs.join(' ')}`);
-}
-
-// Hook metrics module (kept at top level - needed early for timer)
-let hookMetrics;
-try {
-  hookMetrics = require('./lib/hook-metrics.js');
-} catch (e) {
-  // Hook metrics not available
-}
-
-/**
- * PERFORMANCE OPTIMIZATION: Load all project files using LRU cache
- * Uses file-cache module for automatic caching with 15s TTL.
- * Files are cached across script invocations within TTL window.
- * Estimated savings: 60-120ms on cache hits
- *
- * Additional optimizations in this file (US-0356):
- * - Git batching: 3 subprocess calls → 1 (~20-40ms savings)
- * - Session-manager inline: subprocess → direct require() (~50-150ms savings)
- * - Tmux cache: subprocess → session-state lookup (~10-20ms after first run)
- * Total estimated savings: ~130-260ms
- */
-function loadProjectFiles(rootDir) {
-  const paths = {
-    status: getStatusPath(rootDir),
-    metadata: getMetadataPath(rootDir),
-    settings: path.join(getClaudeDir(rootDir), 'settings.json'),
-    sessionState: getSessionStatePath(rootDir),
-    configYaml: path.join(getAgileflowDir(rootDir), 'config.yaml'),
-    cliPackage: path.join(rootDir, 'packages', 'cli', 'package.json'),
-  };
-
-  return {
-    status: readJSONCached(paths.status),
-    metadata: readJSONCached(paths.metadata),
-    settings: readJSONCached(paths.settings),
-    sessionState: readJSONCached(paths.sessionState),
-    configYaml: readFileCached(paths.configYaml),
-    cliPackage: readJSONCached(paths.cliPackage),
-  };
-}
-
-/**
- * Detect the user's platform for install guidance
- */
-function detectPlatform() {
-  const platform = process.platform;
-
-  if (platform === 'darwin') {
-    return { os: 'macOS', installCmd: 'brew install tmux', hasSudo: true };
-  }
-
-  if (platform === 'linux') {
-    // Try to detect Linux distribution
-    try {
-      const osRelease = fs.readFileSync('/etc/os-release', 'utf8');
-      if (
-        osRelease.includes('Ubuntu') ||
-        osRelease.includes('Debian') ||
-        osRelease.includes('Pop!_OS') ||
-        osRelease.includes('Mint')
-      ) {
-        return { os: 'Ubuntu/Debian', installCmd: 'sudo apt install tmux', hasSudo: true };
-      }
-      if (
-        osRelease.includes('Fedora') ||
-        osRelease.includes('Red Hat') ||
-        osRelease.includes('CentOS') ||
-        osRelease.includes('Rocky')
-      ) {
-        return { os: 'Fedora/RHEL', installCmd: 'sudo dnf install tmux', hasSudo: true };
-      }
-      if (osRelease.includes('Arch')) {
-        return { os: 'Arch', installCmd: 'sudo pacman -S tmux', hasSudo: true };
-      }
-    } catch (e) {
-      // Can't read /etc/os-release
-    }
-    return { os: 'Linux', installCmd: 'sudo apt install tmux', hasSudo: true };
-  }
-
-  // Windows WSL or unknown
-  return { os: 'Unknown', installCmd: null, hasSudo: false };
-}
-
-/**
- * Check if tmux is installed
- * PERFORMANCE OPTIMIZATION: Caches result in session-state.json (~10-20ms savings on subsequent runs)
- * Returns object with availability info and platform-specific install suggestion
- */
-function checkTmuxAvailability(cache) {
-  // Check session state cache first (tmux availability doesn't change within a session)
-  if (cache?.sessionState?.tmux_available !== undefined) {
-    if (cache.sessionState.tmux_available) return { available: true };
-    return {
-      available: false,
-      platform: detectPlatform(),
-      noSudoCmd: 'conda install -c conda-forge tmux',
-    };
-  }
-
-  // Actually check (first run or no cache)
-  const result = executeCommandSync('which', ['tmux'], { fallback: null });
-  const available = result.data !== null;
-
-  // Cache in session state for next invocation
-  try {
-    const rootDir = getProjectRoot();
-    const sessionStatePath = getSessionStatePath(rootDir);
-    if (fs.existsSync(sessionStatePath)) {
-      const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-      state.tmux_available = available;
-      fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-    }
-  } catch (e) {
-    // Cache write failed, non-critical
-  }
-
-  if (available) return { available: true };
-  return {
-    available: false,
-    platform: detectPlatform(),
-    noSudoCmd: 'conda install -c conda-forge tmux',
-  };
-}
-
-/**
- * PERFORMANCE OPTIMIZATION: Batch git commands into single call
- * Uses `git log -1 --format=%D%n%h%n%s` to get branch, short hash, and subject
- * in a single subprocess instead of 3 separate calls.
- * Savings: ~20-40ms (eliminates 2 subprocess spawns)
- */
-function getGitInfo(rootDir) {
-  const opts = { cwd: rootDir, timeout: 5000, fallback: '' };
-  const result = git(['log', '-1', '--format=%D%n%h%n%s'], opts);
-  if (result.data) {
-    const lines = result.data.split('\n');
-    // %D gives decorations like "HEAD -> main, origin/main, tag: v3.0.0"
-    const branchMatch = (lines[0] || '').match(/HEAD -> ([^,\s]+)/);
-    return {
-      branch: branchMatch ? branchMatch[1] : 'detached',
-      commit: (lines[1] || 'unknown').trim(),
-      lastCommit: lines.slice(2).join('\n').trim(),
-    };
-  }
-  return { branch: 'unknown', commit: 'unknown', lastCommit: '' };
-}
-
-function getProjectInfo(rootDir, cache = null) {
-  const info = {
-    name: 'agileflow',
-    version: 'unknown',
-    branch: 'unknown',
-    commit: 'unknown',
-    lastCommit: '',
-    wipCount: 0,
-    blockedCount: 0,
-    completedCount: 0,
-    readyCount: 0,
-    totalStories: 0,
-    currentStory: null,
-  };
-
-  // Get AgileFlow version (check multiple sources in priority order)
-  // 1. .agileflow/config.yaml (installed user projects - primary source)
-  // 2. AgileFlow metadata (installed user projects - legacy)
-  // 3. packages/cli/package.json (AgileFlow dev project)
-  try {
-    // Primary: .agileflow/config.yaml (use cache if available)
-    if (cache?.configYaml) {
-      const versionMatch = cache.configYaml.match(/^version:\s*['"]?([0-9.]+)/m);
-      if (versionMatch) {
-        info.version = versionMatch[1];
-      }
-    } else if (cache?.metadata?.version) {
-      // Fallback: metadata from cache
-      info.version = cache.metadata.version;
-    } else if (cache?.cliPackage?.version) {
-      // Dev project: from cache
-      info.version = cache.cliPackage.version;
-    } else {
-      // No cache - fall back to file reads (for backwards compatibility)
-      const configPath = path.join(getAgileflowDir(rootDir), 'config.yaml');
-      if (fs.existsSync(configPath)) {
-        const content = fs.readFileSync(configPath, 'utf8');
-        const versionMatch = content.match(/^version:\s*['"]?([0-9.]+)/m);
-        if (versionMatch) {
-          info.version = versionMatch[1];
-        }
-      } else {
-        const metadataPath = getMetadataPath(rootDir);
-        if (fs.existsSync(metadataPath)) {
-          const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-          info.version = metadata.version || info.version;
-        } else {
-          const pkg = JSON.parse(
-            fs.readFileSync(path.join(rootDir, 'packages/cli/package.json'), 'utf8')
-          );
-          info.version = pkg.version || info.version;
-        }
-      }
-    }
-  } catch (e) {
-    // Silently fail - version will remain 'unknown'
-  }
-
-  // Get git info (batched into single command for performance)
-  const gitInfo = getGitInfo(rootDir);
-  info.branch = gitInfo.branch;
-  info.commit = gitInfo.commit;
-  info.lastCommit = gitInfo.lastCommit;
-
-  // Get status info (use cache if available)
-  try {
-    const status = cache?.status;
-    if (status?.stories) {
-      for (const [id, story] of Object.entries(status.stories)) {
-        info.totalStories++;
-        if (story.status === 'in_progress') {
-          info.wipCount++;
-          if (!info.currentStory) {
-            info.currentStory = { id, title: story.title };
-          }
-        } else if (story.status === 'blocked') {
-          info.blockedCount++;
-        } else if (story.status === 'completed') {
-          info.completedCount++;
-        } else if (story.status === 'ready') {
-          info.readyCount++;
-        }
-      }
-    } else if (!cache) {
-      // No cache - fall back to file read
-      const statusPath = getStatusPath(rootDir);
-      if (fs.existsSync(statusPath)) {
-        const statusData = JSON.parse(fs.readFileSync(statusPath, 'utf8'));
-        if (statusData.stories) {
-          for (const [id, story] of Object.entries(statusData.stories)) {
-            info.totalStories++;
-            if (story.status === 'in_progress') {
-              info.wipCount++;
-              if (!info.currentStory) {
-                info.currentStory = { id, title: story.title };
-              }
-            } else if (story.status === 'blocked') {
-              info.blockedCount++;
-            } else if (story.status === 'completed') {
-              info.completedCount++;
-            } else if (story.status === 'ready') {
-              info.readyCount++;
-            }
-          }
-        }
-      }
-    }
-  } catch (e) {
-    log.debug('getProjectInfo:', e?.message || String(e));
-  }
-
-  return info;
-}
-
-function runArchival(rootDir, cache = null) {
-  const result = { ran: false, threshold: 7, archived: 0, remaining: 0 };
-
-  try {
-    // Use cached metadata if available
-    const metadata = cache?.metadata;
-    if (metadata) {
-      if (metadata.archival?.enabled === false) {
-        result.disabled = true;
-        return result;
-      }
-      result.threshold = metadata.archival?.threshold_days || 7;
-    } else {
-      // No cache - fall back to file read
-      const metadataPath = getMetadataPath(rootDir);
-      if (fs.existsSync(metadataPath)) {
-        const metadataData = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-        if (metadataData.archival?.enabled === false) {
-          result.disabled = true;
-          return result;
-        }
-        result.threshold = metadataData.archival?.threshold_days || 7;
-      }
-    }
-
-    // Use cached status if available
-    const status = cache?.status;
-    if (!status && !cache) {
-      const statusPath = getStatusPath(rootDir);
-      if (!fs.existsSync(statusPath)) return result;
-    }
-
-    const stories = (status || {}).stories || {};
-
-    const cutoffDate = new Date();
-    cutoffDate.setDate(cutoffDate.getDate() - result.threshold);
-
-    let toArchiveCount = 0;
-    for (const [id, story] of Object.entries(stories)) {
-      if (story.status === 'completed' && story.completed_at) {
-        if (new Date(story.completed_at) < cutoffDate) {
-          toArchiveCount++;
-        }
-      }
-    }
-
-    result.ran = true;
-    result.remaining = Object.keys(stories).length;
-
-    if (toArchiveCount > 0) {
-      // Run archival
-      const archiveResult = executeCommandSync('bash', ['scripts/archive-completed-stories.sh'], {
-        cwd: rootDir,
-      });
-      if (archiveResult.ok) {
-        result.archived = toArchiveCount;
-        result.remaining -= toArchiveCount;
-      }
-    }
-  } catch (e) {
-    log.debug('runArchival:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-function clearActiveCommands(rootDir, cache = null) {
-  const result = { ran: false, cleared: 0, commandNames: [], preserved: false };
-
-  try {
-    const sessionStatePath = getSessionStatePath(rootDir);
-
-    // Use cached sessionState if available, but we still need to read fresh for clearing
-    // because we need to write back. Cache is only useful to check if file exists.
-    let state;
-    if (cache?.sessionState) {
-      state = cache.sessionState;
-      result.ran = true;
-    } else {
-      if (!fs.existsSync(sessionStatePath)) return result;
-      state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-      result.ran = true;
-    }
-
-    // Check if PreCompact just ran (within last 30 seconds)
-    // If so, preserve active_commands instead of clearing them (post-compact session start)
-    if (state.last_precompact_at) {
-      const precompactTime = new Date(state.last_precompact_at).getTime();
-      const now = Date.now();
-      const secondsSincePrecompact = (now - precompactTime) / 1000;
-
-      if (secondsSincePrecompact < 600) {
-        // 10 minutes - compacts can take a while with background tasks
-        // This is a post-compact session start - preserve active commands
-        result.preserved = true;
-        // Capture command names for display (but don't clear)
-        if (state.active_commands && state.active_commands.length > 0) {
-          for (const cmd of state.active_commands) {
-            if (cmd.name) result.commandNames.push(cmd.name);
-          }
-        }
-        // Clear the precompact timestamp so next true session start will clear
-        delete state.last_precompact_at;
-        fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-        return result;
-      }
-      // Precompact was too long ago - clear as normal
-      delete state.last_precompact_at;
-    }
-
-    // Handle new array format (active_commands)
-    if (state.active_commands && state.active_commands.length > 0) {
-      result.cleared = state.active_commands.length;
-      // Capture command names before clearing
-      for (const cmd of state.active_commands) {
-        if (cmd.name) result.commandNames.push(cmd.name);
-      }
-      state.active_commands = [];
-    }
-
-    // Handle legacy singular format (active_command) - only capture if not already in array
-    if (state.active_command !== undefined) {
-      const legacyName = state.active_command.name;
-      // Only add to count/names if not already captured from array (avoid duplicates)
-      if (legacyName && !result.commandNames.includes(legacyName)) {
-        result.cleared++;
-        result.commandNames.push(legacyName);
-      }
-      delete state.active_command;
-    }
-
-    if (result.cleared > 0) {
-      fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-    }
-  } catch (e) {
-    log.debug('clearActiveCommands:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-/**
- * PERFORMANCE OPTIMIZATION (US-0356): Lightweight session check
- *
- * Replaces the full session-manager require chain (~3,600 lines across 8 modules)
- * with direct file I/O on the registry.json and lock files (~30 lines).
- * Only checks active session count and current session info.
- * Full registration, cleanup, and worktree detection deferred to Phase 3 (welcome-deferred.js).
- *
- * Estimated savings: 100-200ms
- */
-function checkParallelSessionsFast(rootDir) {
-  const result = {
-    available: false,
-    registered: false,
-    otherActive: 0,
-    currentId: null,
-    cleaned: 0,
-    cleanedSessions: [],
-    isMain: true,
-    nickname: null,
-    branch: null,
-    sessionPath: null,
-    mainPath: rootDir,
-  };
-
-  try {
-    const sessionsDir = path.join(getAgileflowDir(rootDir), 'sessions');
-    const registryPath = path.join(sessionsDir, 'registry.json');
-
-    if (!fs.existsSync(registryPath)) return result;
-
-    const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
-    if (!registry.sessions) return result;
-
-    result.available = true;
-    const cwd = process.cwd();
-    const staleLocks = [];
-
-    for (const [id, session] of Object.entries(registry.sessions)) {
-      if (session.path === cwd) {
-        // Found current session
-        result.registered = true;
-        result.currentId = id;
-        result.isMain = session.is_main === true;
-        result.nickname = session.nickname || null;
-        result.branch = session.branch || null;
-        result.sessionPath = session.path;
-      } else {
-        // Check if other session is alive via lock file
-        const lockPath = path.join(sessionsDir, `${id}.lock`);
-        if (fs.existsSync(lockPath)) {
-          try {
-            const content = fs.readFileSync(lockPath, 'utf8');
-            const pidMatch = content.match(/^pid=(\d+)/m);
-            if (pidMatch) {
-              const pid = parseInt(pidMatch[1], 10);
-              try {
-                process.kill(pid, 0); // Signal 0 = check alive
-                result.otherActive++;
-              } catch (e) {
-                // Process dead - collect for cleanup
-                staleLocks.push({ id, lockPath, pid });
-              }
-            }
-          } catch (e) {
-            // Lock read failed
-          }
-        }
-      }
-    }
-
-    // Quick cleanup of stale locks (prevents ghost session counts)
-    for (const stale of staleLocks) {
-      try {
-        fs.unlinkSync(stale.lockPath);
-        result.cleaned++;
-        result.cleanedSessions.push({
-          id: stale.id,
-          pid: stale.pid,
-          reason: 'pid_dead',
-        });
-      } catch (e) {
-        // Cleanup failed, deferred will retry
-      }
-    }
-  } catch (e) {
-    log.debug('checkParallelSessionsFast:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-function checkPreCompact(rootDir, cache = null) {
-  const result = { configured: false, scriptExists: false, version: null, outdated: false };
-
-  try {
-    // Check if PreCompact hook is configured in settings (use cache if available)
-    const settings = cache?.settings;
-    if (settings) {
-      if (settings.hooks?.PreCompact?.length > 0) {
-        result.configured = true;
-      }
-    } else {
-      // No cache - fall back to file read
-      const settingsPath = path.join(getClaudeDir(rootDir), 'settings.json');
-      if (fs.existsSync(settingsPath)) {
-        const settingsData = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-        if (settingsData.hooks?.PreCompact?.length > 0) {
-          result.configured = true;
-        }
-      }
-    }
-
-    // Check if the script exists (must always check filesystem)
-    const scriptPath = path.join(rootDir, 'scripts', 'precompact-context.sh');
-    if (fs.existsSync(scriptPath)) {
-      result.scriptExists = true;
-    }
-
-    // Check configured version from metadata (use cache if available)
-    const metadata = cache?.metadata;
-    if (metadata) {
-      if (metadata.features?.precompact?.configured_version) {
-        result.version = metadata.features.precompact.configured_version;
-        // PreCompact v2.40.0+ has multi-command support
-        result.outdated = compareVersions(result.version, '2.40.0') < 0;
-      } else if (result.configured) {
-        // Hook exists but no version tracked = definitely outdated
-        result.outdated = true;
-        result.version = 'unknown';
-      }
-    } else if (!cache) {
-      // No cache - fall back to file read
-      const metadataPath = getMetadataPath(rootDir);
-      if (fs.existsSync(metadataPath)) {
-        const metadataData = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-        if (metadataData.features?.precompact?.configured_version) {
-          result.version = metadataData.features.precompact.configured_version;
-          result.outdated = compareVersions(result.version, '2.40.0') < 0;
-        } else if (result.configured) {
-          result.outdated = true;
-          result.version = 'unknown';
-        }
-      }
-    }
-  } catch (e) {
-    log.debug('checkPreCompact:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-function checkDamageControl(rootDir, cache = null) {
-  const result = { configured: false, level: 'standard', patternCount: 0, scriptsOk: true };
-
-  try {
-    // Check if PreToolUse hooks are configured in settings (use cache if available)
-    let settings = cache?.settings;
-    if (!settings && !cache) {
-      // No cache - fall back to file read
-      const settingsPath = path.join(getClaudeDir(rootDir), 'settings.json');
-      if (fs.existsSync(settingsPath)) {
-        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
-      }
-    }
-
-    if (settings) {
-      if (settings.hooks?.PreToolUse && Array.isArray(settings.hooks.PreToolUse)) {
-        // Check for damage-control hooks
-        const hasDamageControlHooks = settings.hooks.PreToolUse.some(h =>
-          h.hooks?.some(hk => hk.command?.includes('damage-control'))
-        );
-        if (hasDamageControlHooks) {
-          result.configured = true;
-
-          // Count how many hooks are present (should be 3: Bash, Edit, Write)
-          const dcHooks = settings.hooks.PreToolUse.filter(h =>
-            h.hooks?.some(hk => hk.command?.includes('damage-control'))
-          );
-          result.hooksCount = dcHooks.length;
-
-          // Check for enhanced mode (has prompt hook)
-          const hasPromptHook = settings.hooks.PreToolUse.some(h =>
-            h.hooks?.some(hk => hk.type === 'prompt')
-          );
-          if (hasPromptHook) {
-            result.level = 'enhanced';
-          }
-
-          // Check if all required scripts exist (in .claude/hooks/damage-control/)
-          const hooksDir = path.join(getClaudeDir(rootDir), 'hooks', 'damage-control');
-          const requiredScripts = [
-            'bash-tool-damage-control.js',
-            'edit-tool-damage-control.js',
-            'write-tool-damage-control.js',
-          ];
-          for (const script of requiredScripts) {
-            if (!fs.existsSync(path.join(hooksDir, script))) {
-              result.scriptsOk = false;
-              break;
-            }
-          }
-        }
-      }
-    }
-
-    // Count patterns in patterns.yaml
-    const patternsLocations = [
-      path.join(getClaudeDir(rootDir), 'hooks', 'damage-control', 'patterns.yaml'),
-      path.join(getAgileflowDir(rootDir), 'scripts', 'damage-control', 'patterns.yaml'),
-    ];
-    for (const patternsPath of patternsLocations) {
-      if (fs.existsSync(patternsPath)) {
-        const content = fs.readFileSync(patternsPath, 'utf8');
-        // Count pattern entries (lines starting with "  - pattern:")
-        const patternMatches = content.match(/^\s*-\s*pattern:/gm);
-        result.patternCount = patternMatches ? patternMatches.length : 0;
-        break;
-      }
-    }
-  } catch (e) {
-    log.debug('checkDamageControl:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-// Compare semantic versions: returns -1 if a < b, 0 if equal, 1 if a > b
-function compareVersions(a, b) {
-  if (!a || !b) return 0;
-  const partsA = a.split('.').map(Number);
-  const partsB = b.split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    const numA = partsA[i] || 0;
-    const numB = partsB[i] || 0;
-    if (numA < numB) return -1;
-    if (numA > numB) return 1;
-  }
-  return 0;
-}
-
-/**
- * All available config options with their version requirements
- * These are the options that can be configured through /agileflow:configure
- */
-const ALL_CONFIG_OPTIONS = {
-  claudeMdReinforcement: {
-    since: '2.92.0',
-    description: 'Add /babysit rules to CLAUDE.md',
-    autoApplyable: true,
-  },
-  sessionStartHook: {
-    since: '2.35.0',
-    description: 'Welcome display on session start',
-    autoApplyable: false,
-  },
-  precompactHook: {
-    since: '2.40.0',
-    description: 'Context preservation during /compact',
-    autoApplyable: false,
-  },
-  damageControlHooks: {
-    since: '2.50.0',
-    description: 'Block destructive commands',
-    autoApplyable: false,
-  },
-  statusLine: { since: '2.35.0', description: 'Custom status bar display', autoApplyable: false },
-  autoArchival: {
-    since: '2.35.0',
-    description: 'Auto-archive completed stories',
-    autoApplyable: false,
-  },
-  autoUpdate: {
-    since: '2.70.0',
-    description: 'Auto-update on session start',
-    autoApplyable: false,
-  },
-  ralphLoop: { since: '2.60.0', description: 'Autonomous story processing', autoApplyable: false },
-  tmuxAutoSpawn: {
-    since: '2.92.0',
-    description: 'Auto-start Claude in tmux session',
-    autoApplyable: true,
-  },
-};
-
-/**
- * Check for new config options that haven't been presented to the user
- * Returns info about outdated config and whether to auto-apply (for "full" profile)
- */
-function checkConfigStaleness(rootDir, currentVersion, cache = null) {
-  const result = {
-    outdated: false,
-    newOptionsCount: 0,
-    newOptions: [],
-    configSchemaVersion: null,
-    activeProfile: null,
-    autoApply: false,
-  };
-
-  try {
-    const metadata = cache?.metadata;
-    if (!metadata) return result;
-
-    result.configSchemaVersion = metadata.config_schema_version || null;
-    result.activeProfile = metadata.active_profile || null;
-
-    const configOptions = metadata.agileflow?.config_options || {};
-
-    // If no config_schema_version, this is an old installation - all options are "new"
-    if (!result.configSchemaVersion) {
-      // For old installations, detect which features are actually configured via settings.json
-      const settings = cache?.settings || {};
-      const hooks = settings.hooks || {};
-
-      // Check each option against actual configuration
-      for (const [name, optionInfo] of Object.entries(ALL_CONFIG_OPTIONS)) {
-        const isConfigured = isOptionActuallyConfigured(name, hooks, settings);
-        if (!isConfigured) {
-          result.outdated = true;
-          result.newOptionsCount++;
-          result.newOptions.push({
-            name,
-            description: optionInfo.description,
-            autoApplyable: optionInfo.autoApplyable,
-          });
-        }
-      }
-    } else {
-      // Check for unconfigured options in metadata
-      for (const [name, option] of Object.entries(configOptions)) {
-        if (option.configured === false) {
-          const optionInfo = ALL_CONFIG_OPTIONS[name] || {
-            description: name,
-            autoApplyable: false,
-          };
-          result.outdated = true;
-          result.newOptionsCount++;
-          result.newOptions.push({
-            name,
-            description: optionInfo.description,
-            autoApplyable: optionInfo.autoApplyable,
-          });
-        }
-      }
-
-      // Check for options that might not be in metadata yet (added after their install)
-      for (const [name, optionInfo] of Object.entries(ALL_CONFIG_OPTIONS)) {
-        if (!configOptions[name]) {
-          // Option doesn't exist in metadata - check if it was added after their config_schema_version
-          if (compareVersions(result.configSchemaVersion, optionInfo.since) < 0) {
-            const alreadyAdded = result.newOptions.some(o => o.name === name);
-            if (!alreadyAdded) {
-              result.outdated = true;
-              result.newOptionsCount++;
-              result.newOptions.push({
-                name,
-                description: optionInfo.description,
-                autoApplyable: optionInfo.autoApplyable,
-              });
-            }
-          }
-        }
-      }
-    }
-
-    // If profile is "full", auto-apply features that support it
-    if (result.outdated && result.activeProfile === 'full') {
-      const autoApplyableOptions = result.newOptions.filter(o => o.autoApplyable);
-      if (autoApplyableOptions.length > 0) {
-        result.autoApply = true;
-        // Only auto-apply the auto-applyable ones
-        result.autoApplyOptions = autoApplyableOptions;
-      }
-    }
-  } catch (e) {
-    // Silently fail - config check is non-critical
-  }
-
-  return result;
-}
-
-/**
- * Check if a config option is actually configured in settings
- */
-function isOptionActuallyConfigured(optionName, hooks, settings) {
-  switch (optionName) {
-    case 'sessionStartHook':
-      return hooks.SessionStart && hooks.SessionStart.length > 0;
-    case 'precompactHook':
-      return hooks.PreCompact && hooks.PreCompact.length > 0;
-    case 'damageControlHooks':
-      return (
-        hooks.PreToolUse &&
-        hooks.PreToolUse.some(h => h.hooks?.some(hk => hk.command?.includes('damage-control')))
-      );
-    case 'statusLine':
-      return settings.statusLine && settings.statusLine.command;
-    case 'autoArchival':
-      // Archival is tied to SessionStart hook running archive script
-      return (
-        hooks.SessionStart &&
-        hooks.SessionStart.some(h => h.hooks?.some(hk => hk.command?.includes('archive')))
-      );
-    case 'autoUpdate':
-      // Would need to check metadata for autoUpdate setting
-      return false; // Default to not configured
-    case 'ralphLoop':
-      return (
-        hooks.Stop && hooks.Stop.some(h => h.hooks?.some(hk => hk.command?.includes('ralph-loop')))
-      );
-    case 'claudeMdReinforcement':
-      // Check if CLAUDE.md has the marker - can't easily check from here
-      return false; // Let welcome script handle this
-    case 'tmuxAutoSpawn':
-      // Check metadata for tmuxAutoSpawn setting (default is enabled)
-      return false; // Let welcome script handle this via metadata
-    default:
-      return false;
-  }
-}
-
-/**
- * Auto-apply new config options for "full" profile
- * Returns true if any options were applied
- */
-function autoApplyConfigOptions(rootDir, newOptions) {
-  let applied = 0;
-
-  for (const option of newOptions) {
-    try {
-      if (option.name === 'claudeMdReinforcement') {
-        // Apply CLAUDE.md reinforcement
-        const claudeMdPath = path.join(rootDir, 'CLAUDE.md');
-        const marker = '<!-- AGILEFLOW_BABYSIT_RULES -->';
-        const content = `
-
-${marker}
-## AgileFlow /babysit Context Preservation Rules
-
-When \`/agileflow:babysit\` is active (check session-state.json), these rules are MANDATORY:
-
-1. **ALWAYS end responses with the AskUserQuestion tool** - Not text like "What next?" but the ACTUAL TOOL CALL
-2. **Use Plan Mode for non-trivial tasks** - Call \`EnterPlanMode\` before complex implementations
-3. **Delegate complex work to domain experts** - Use \`Task\` tool with appropriate \`subagent_type\`
-4. **Track progress with TaskCreate/TaskUpdate** - For any task with 3+ steps
-
-These rules persist across conversation compaction. Check \`docs/09-agents/session-state.json\` for active commands.
-${marker}
-`;
-
-        let existingContent = '';
-        if (fs.existsSync(claudeMdPath)) {
-          existingContent = fs.readFileSync(claudeMdPath, 'utf8');
-        }
-
-        if (!existingContent.includes(marker)) {
-          fs.appendFileSync(claudeMdPath, content);
-          applied++;
-        }
-      } else if (option.name === 'tmuxAutoSpawn') {
-        // Auto-enable tmux auto-spawn via metadata
-        const metadataPath = getMetadataPath(rootDir);
-        if (fs.existsSync(metadataPath)) {
-          const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-          if (!metadata.features) metadata.features = {};
-          if (
-            !metadata.features.tmuxAutoSpawn ||
-            metadata.features.tmuxAutoSpawn.enabled === undefined
-          ) {
-            metadata.features.tmuxAutoSpawn = {
-              enabled: true,
-              version: metadata.version || '2.92.0',
-              at: new Date().toISOString(),
-            };
-            fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2) + '\n');
-            applied++;
-          }
-        }
-      }
-      // Add more option handlers here as new options are added
-    } catch (e) {
-      // Silently fail individual options
-    }
-  }
-
-  // Update metadata to mark options as configured
-  if (applied > 0) {
-    try {
-      const metadataPath = getMetadataPath(rootDir);
-      if (fs.existsSync(metadataPath)) {
-        const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-
-        // Get current CLI version for updating config_schema_version
-        let currentVersion = '2.92.0';
-        try {
-          const pkgPath = path.join(__dirname, '..', 'package.json');
-          if (fs.existsSync(pkgPath)) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-            currentVersion = pkg.version;
-          }
-        } catch (e) {
-          log.debug('getPackageVersion:', e?.message || String(e));
-        }
-
-        // Update config_schema_version
-        metadata.config_schema_version = currentVersion;
-
-        // Mark applied options as configured
-        if (!metadata.agileflow) metadata.agileflow = {};
-        if (!metadata.agileflow.config_options) metadata.agileflow.config_options = {};
-
-        for (const option of newOptions) {
-          metadata.agileflow.config_options[option.name] = {
-            ...metadata.agileflow.config_options[option.name],
-            configured: true,
-            enabled: true,
-            configured_at: new Date().toISOString(),
-          };
-        }
-
-        fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2) + '\n');
-      }
-    } catch (e) {
-      // Silently fail metadata update
-    }
-  }
-
-  return applied;
-}
-
-/**
- * PERFORMANCE OPTIMIZATION: Check update cache in session-state.json (1-hour TTL)
- * Avoids ~139ms npm registry network call when cache is fresh.
- * Returns cached update result or null if stale/missing.
- */
-function getUpdateFromCache(cache) {
-  try {
-    const updateCache = cache?.sessionState?.update_cache;
-    if (!updateCache || typeof updateCache !== 'object') return null;
-    if (!updateCache.checked_at || !updateCache.result) return null;
-
-    const checkedAt = new Date(updateCache.checked_at).getTime();
-    if (!Number.isFinite(checkedAt)) return null;
-
-    const age = Date.now() - checkedAt;
-    const ONE_HOUR = 60 * 60 * 1000;
-
-    // Reject negative age (future timestamps from clock skew) or absurdly old
-    if (age < 0 || age > 24 * ONE_HOUR) return null;
-
-    if (age < ONE_HOUR) {
-      return updateCache.result;
-    }
-  } catch (e) {
-    // Cache read failed
-  }
-  return null;
-}
-
-/**
- * Display deferred warnings from previous session's background work.
- * Warnings are saved by welcome-deferred.js and displayed here on next start.
- * Clears warnings after display.
- */
-function displayDeferredWarnings(rootDir) {
-  try {
-    const sessionStatePath = getSessionStatePath(rootDir);
-    if (!fs.existsSync(sessionStatePath)) return;
-
-    const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-    const deferredWarnings = state.deferred_warnings;
-    if (!deferredWarnings || !Array.isArray(deferredWarnings) || deferredWarnings.length === 0)
-      return;
-
-    for (const warning of deferredWarnings) {
-      if (!warning.lines || warning.lines.length === 0) continue;
-
-      console.log('');
-      switch (warning.type) {
-        case 'update_available':
-          console.log(`${c.amber}↑ ${warning.lines[0]}${c.reset}`);
-          if (warning.lines[1]) console.log(`  ${c.skyBlue}${warning.lines[1]}${c.reset}`);
-          break;
-        case 'session_health':
-          for (const line of warning.lines) {
-            if (line.startsWith('  ')) {
-              console.log(`${c.dim}   └─ ${line.trim()}${c.reset}`);
-            } else {
-              console.log(`${c.coral}⚠️  ${line}${c.reset}`);
-            }
-          }
-          break;
-        case 'process_cleanup':
-          console.log(`${c.amber}⚠️  ${warning.lines[0]}${c.reset}`);
-          if (warning.lines.length > 1) {
-            for (const line of warning.lines.slice(1)) {
-              console.log(`${c.slate}   ${line}${c.reset}`);
-            }
-          }
-          break;
-        case 'epic_completion':
-          for (const line of warning.lines) {
-            console.log(`${c.mintGreen}✅ ${line}${c.reset}`);
-          }
-          break;
-        case 'ideation_sync':
-          console.log(`${c.dim}📊 ${warning.lines[0]}${c.reset}`);
-          break;
-        case 'automations':
-          console.log(`${c.teal}🤖 ${warning.lines[0]}${c.reset}`);
-          for (const line of warning.lines.slice(1)) {
-            console.log(`${c.dim}   └─ ${line}${c.reset}`);
-          }
-          break;
-        case 'story_claiming':
-          console.log(`${c.amber}🔒 ${warning.lines[0]}${c.reset}`);
-          for (const line of warning.lines.slice(1)) {
-            console.log(`${c.dim}   └─ ${line.trim()}${c.reset}`);
-          }
-          break;
-        case 'file_tracking':
-          console.log(`${c.amber}📁 ${warning.lines[0]}${c.reset}`);
-          break;
-        default:
-          for (const line of warning.lines) {
-            console.log(`${c.dim}${line}${c.reset}`);
-          }
-      }
-    }
-
-    // Clear deferred warnings after display
-    delete state.deferred_warnings;
-    fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-  } catch (e) {
-    // Display failed, non-critical
-  }
-}
-
-// Check for updates (now handled by welcome-deferred.js, kept for backward compatibility)
-async function checkUpdates() {
-  const result = {
-    available: false,
-    installed: null,
-    latest: null,
-    justUpdated: false,
-    previousVersion: null,
-    autoUpdate: false,
-    changelog: [],
-  };
-
-  const updateChecker = tryOptional(() => require('./check-update.js'), 'check-update');
-  if (!updateChecker) return result;
-
-  try {
-    const updateInfo = await updateChecker.checkForUpdates();
-    result.installed = updateInfo.installed;
-    result.latest = updateInfo.latest;
-    result.available = updateInfo.updateAvailable;
-    result.justUpdated = updateInfo.justUpdated;
-    result.previousVersion = updateInfo.previousVersion;
-    result.autoUpdate = updateInfo.autoUpdate;
-
-    // If just updated, try to get changelog entries
-    if (result.justUpdated && result.installed) {
-      result.changelog = getChangelogEntries(result.installed);
-    }
-  } catch (e) {
-    // Silently fail - update check is non-critical
-  }
-
-  return result;
-}
-
-// Parse CHANGELOG.md for entries of a specific version
-function getChangelogEntries(version) {
-  const entries = [];
-
-  try {
-    // Look for CHANGELOG.md in .agileflow or package location
-    const possiblePaths = [
-      path.join(__dirname, '..', 'CHANGELOG.md'),
-      path.join(__dirname, 'CHANGELOG.md'),
-    ];
-
-    let changelogContent = null;
-    for (const p of possiblePaths) {
-      if (fs.existsSync(p)) {
-        changelogContent = fs.readFileSync(p, 'utf8');
-        break;
-      }
-    }
-
-    if (!changelogContent) return entries;
-
-    // Find the section for this version
-    const versionPattern = new RegExp(`## \\[${version}\\].*?\\n([\\s\\S]*?)(?=## \\[|$)`);
-    const match = changelogContent.match(versionPattern);
-
-    if (match) {
-      // Extract bullet points from Added/Changed/Fixed sections
-      const lines = match[1].split('\n');
-      for (const line of lines) {
-        const bulletMatch = line.match(/^- (.+)$/);
-        if (bulletMatch && entries.length < 3) {
-          entries.push(bulletMatch[1]);
-        }
-      }
-    }
-  } catch (e) {
-    // Silently fail
-  }
-
-  return entries;
-}
-
-// Run auto-update if enabled (quiet mode - minimal output)
-// DEPRECATED: Use spawnAutoUpdateInBackground() instead for non-blocking updates
-async function runAutoUpdate(rootDir, fromVersion, toVersion) {
-  const runUpdate = () => {
-    return executeCommandSync('npx', ['agileflow@latest', 'update', '--force'], {
-      cwd: rootDir,
-      timeout: 120000,
-    });
-  };
-
-  console.log(
-    `${c.skyBlue}Updating AgileFlow${c.reset} ${c.dim}v${fromVersion} → v${toVersion}${c.reset}`
-  );
-  const result = runUpdate();
-  if (result.ok) {
-    console.log(`${c.mintGreen}✓ Update complete${c.reset}`);
-    return true;
-  }
-
-  // Check if this is a stale npm cache issue (ETARGET = version not found)
-  if (result.error && (result.error.includes('ETARGET') || result.error.includes('notarget'))) {
-    console.log(`${c.dim}  Clearing npm cache and retrying...${c.reset}`);
-    executeCommandSync('npm', ['cache', 'clean', '--force'], { timeout: 30000 });
-    const retryResult = runUpdate();
-    if (retryResult.ok) {
-      console.log(`${c.mintGreen}✓ Update complete${c.reset}`);
-      return true;
-    }
-    console.log(`${c.peach}Auto-update failed after cache clean${c.reset}`);
-    console.log(`${c.dim}  Run manually: npx agileflow update${c.reset}`);
-    return false;
-  }
-  console.log(`${c.peach}Auto-update failed${c.reset}`);
-  console.log(`${c.dim}  Run manually: npx agileflow update${c.reset}`);
-  return false;
-}
-
-/**
- * Spawn auto-update in a detached background process
- * This allows the welcome hook to return immediately while the update runs
- *
- * @param {string} rootDir - Project root directory
- * @param {string} fromVersion - Current version
- * @param {string} toVersion - Target version
- */
-function spawnAutoUpdateInBackground(rootDir, fromVersion, toVersion) {
-  // Track pending update in session-state.json
-  try {
-    const sessionStatePath = getSessionStatePath(rootDir);
-    let state = {};
-    if (fs.existsSync(sessionStatePath)) {
-      state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-    }
-    state.pending_update = {
-      from: fromVersion,
-      to: toVersion,
-      started_at: new Date().toISOString(),
-    };
-    fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-  } catch (e) {
-    // Silently continue - tracking is optional
-  }
-
-  // Create detached subprocess that survives parent exit
-  spawnBackground('npx', ['agileflow@latest', 'update', '--force'], { cwd: rootDir });
-
-  console.log(`${c.dim}  Auto-update starting in background...${c.reset}`);
-}
-
-/**
- * PERFORMANCE OPTIMIZATION: Fast expertise count (directory scan only)
- * Just counts expert directories without reading/validating each expertise.yaml.
- * Saves ~50-150ms by avoiding 29 file reads.
- * Full validation is available via /agileflow:validate-expertise command.
- */
-function getExpertiseCountFast(rootDir) {
-  const result = { total: 0, passed: 0, warnings: 0, failed: 0, issues: [], validated: false };
-
-  // Find experts directory
-  let expertsDir = path.join(getAgileflowDir(rootDir), 'experts');
-  if (!fs.existsSync(expertsDir)) {
-    expertsDir = path.join(rootDir, 'packages', 'cli', 'src', 'core', 'experts');
-  }
-  if (!fs.existsSync(expertsDir)) {
-    return result;
-  }
-
-  try {
-    const domains = fs
-      .readdirSync(expertsDir, { withFileTypes: true })
-      .filter(d => d.isDirectory() && d.name !== 'templates');
-
-    result.total = domains.length;
-
-    // Quick check: just verify expertise.yaml exists in each directory
-    // Full validation (staleness, required fields) deferred to separate command
-    for (const domain of domains) {
-      const filePath = path.join(expertsDir, domain.name, 'expertise.yaml');
-      if (!fs.existsSync(filePath)) {
-        result.failed++;
-        result.issues.push(`${domain.name}: missing file`);
-      } else {
-        // Spot-check first few files for staleness (sample 3 max for speed)
-        if (result.passed < 3) {
-          try {
-            const content = fs.readFileSync(filePath, 'utf8');
-            const lastUpdatedMatch = content.match(/^last_updated:\s*['"]?(\d{4}-\d{2}-\d{2})/m);
-            if (lastUpdatedMatch) {
-              const lastDate = new Date(lastUpdatedMatch[1]);
-              const daysSince = Math.floor(
-                (Date.now() - lastDate.getTime()) / (1000 * 60 * 60 * 24)
-              );
-              if (daysSince > 30) {
-                result.warnings++;
-                result.issues.push(`${domain.name}: stale (${daysSince}d)`);
-              } else {
-                result.passed++;
-              }
-            } else {
-              result.passed++;
-            }
-          } catch (e) {
-            result.passed++;
-          }
-        } else {
-          // Assume rest are ok for fast display
-          result.passed++;
-        }
-      }
-    }
-  } catch (e) {
-    // Silently fail
-  }
-
-  return result;
-}
-
-/**
- * Check if installed commands are in sync with source.
- * Counts .md files in three directories:
- * - .agileflow/commands/ (core install)
- * - .claude/commands/agileflow/ excluding agents/ (IDE install)
- * - packages/cli/src/core/commands/ (dogfooding source, if exists)
- * Returns { sourceCount, coreCount, ideCount, stale, staleCoreInstall } or null on error.
- */
-function checkCommandSync(rootDir) {
-  try {
-    const countMdFiles = dir => {
-      if (!fs.existsSync(dir)) return 0;
-      return fs.readdirSync(dir, { recursive: true }).filter(f => String(f).endsWith('.md')).length;
-    };
-
-    const agileflowDir = getAgileflowDir(rootDir);
-    const coreCount = countMdFiles(path.join(agileflowDir, 'commands'));
-
-    // IDE install: .claude/commands/agileflow/ excluding agents/ subdir
-    const ideDir = path.join(rootDir, '.claude', 'commands', 'agileflow');
-    let ideCount = 0;
-    if (fs.existsSync(ideDir)) {
-      ideCount = fs.readdirSync(ideDir, { recursive: true }).filter(f => {
-        const s = String(f);
-        return s.endsWith('.md') && !s.startsWith('agents/') && !s.startsWith('agents\\');
-      }).length;
-    }
-
-    // Dogfooding source (only exists in the AgileFlow repo itself)
-    const sourceDir = path.join(rootDir, 'packages', 'cli', 'src', 'core', 'commands');
-    const sourceCount = countMdFiles(sourceDir);
-
-    // Determine staleness
-    const referenceCount = sourceCount > 0 ? sourceCount : coreCount;
-    const stale = referenceCount > 0 && ideCount < referenceCount;
-    const staleCoreInstall = sourceCount > 0 && coreCount < sourceCount;
-
-    return { sourceCount, coreCount, ideCount, stale, staleCoreInstall };
-  } catch (e) {
-    return null;
-  }
-}
-
-// Full validation function (kept for /agileflow:validate-expertise command)
-function validateExpertise(rootDir) {
-  const result = { total: 0, passed: 0, warnings: 0, failed: 0, issues: [] };
-
-  // Find experts directory
-  let expertsDir = path.join(getAgileflowDir(rootDir), 'experts');
-  if (!fs.existsSync(expertsDir)) {
-    expertsDir = path.join(rootDir, 'packages', 'cli', 'src', 'core', 'experts');
-  }
-  if (!fs.existsSync(expertsDir)) {
-    return result; // No experts directory found
-  }
-
-  const STALE_DAYS = 30;
-  const MAX_LINES = 200;
-
-  try {
-    const domains = fs
-      .readdirSync(expertsDir, { withFileTypes: true })
-      .filter(d => d.isDirectory() && d.name !== 'templates')
-      .map(d => d.name);
-
-    for (const domain of domains) {
-      const filePath = path.join(expertsDir, domain, 'expertise.yaml');
-      if (!fs.existsSync(filePath)) {
-        result.total++;
-        result.failed++;
-        result.issues.push(`${domain}: missing file`);
-        continue;
-      }
-
-      result.total++;
-      const content = fs.readFileSync(filePath, 'utf8');
-      const lines = content.split('\n');
-      let status = 'pass';
-      let issue = '';
-
-      // Check required fields (use multiline flag)
-      const hasVersion = /^version:/m.test(content);
-      const hasDomain = /^domain:/m.test(content);
-      const hasLastUpdated = /^last_updated:/m.test(content);
-
-      if (!hasVersion || !hasDomain || !hasLastUpdated) {
-        status = 'fail';
-        issue = 'missing required fields';
-      }
-
-      // Check staleness
-      const lastUpdatedMatch = content.match(/^last_updated:\s*['"]?(\d{4}-\d{2}-\d{2})/m);
-      if (lastUpdatedMatch && status !== 'fail') {
-        const lastDate = new Date(lastUpdatedMatch[1]);
-        const daysSince = Math.floor((Date.now() - lastDate.getTime()) / (1000 * 60 * 60 * 24));
-        if (daysSince > STALE_DAYS) {
-          status = 'warn';
-          issue = `stale (${daysSince}d)`;
-        }
-      }
-
-      // Check file size
-      if (lines.length > MAX_LINES && status === 'pass') {
-        status = 'warn';
-        issue = `large (${lines.length} lines)`;
-      }
-
-      if (status === 'pass') {
-        result.passed++;
-      } else if (status === 'warn') {
-        result.warnings++;
-        result.issues.push(`${domain}: ${issue}`);
-      } else {
-        result.failed++;
-        result.issues.push(`${domain}: ${issue}`);
-      }
-    }
-  } catch (e) {
-    // Silently fail
-  }
-
-  return result;
-}
-
-function getFeatureVersions(rootDir) {
-  const result = {
-    hooks: { version: null, outdated: false },
-    archival: { version: null, outdated: false },
-    statusline: { version: null, outdated: false },
-    precompact: { version: null, outdated: false },
-  };
-
-  // Minimum compatible versions for each feature
-  const minVersions = {
-    hooks: '2.35.0',
-    archival: '2.35.0',
-    statusline: '2.35.0',
-    precompact: '2.40.0', // Multi-command support
-  };
-
-  try {
-    const metadataPath = getMetadataPath(rootDir);
-    if (fs.existsSync(metadataPath)) {
-      const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
-
-      for (const feature of Object.keys(result)) {
-        if (metadata.features?.[feature]?.configured_version) {
-          result[feature].version = metadata.features[feature].configured_version;
-          result[feature].outdated =
-            compareVersions(result[feature].version, minVersions[feature]) < 0;
-        }
-      }
-    }
-  } catch (e) {
-    log.debug('getFeatureVersions:', e?.message || String(e));
-  }
-
-  return result;
-}
-
-function pad(str, len, align = 'left') {
-  const stripped = str.replace(/\x1b\[[0-9;]*m/g, '');
-  const diff = len - stripped.length;
-  if (diff <= 0) return str;
-  if (align === 'right') return ' '.repeat(diff) + str;
-  if (align === 'center')
-    return ' '.repeat(Math.floor(diff / 2)) + str + ' '.repeat(Math.ceil(diff / 2));
-  return str + ' '.repeat(diff);
-}
-
-// Truncate string to max length, respecting ANSI codes
-function truncate(str, maxLen, suffix = '..') {
-  const stripped = str.replace(/\x1b\[[0-9;]*m/g, '');
-  if (stripped.length <= maxLen) return str;
-
-  // Find position in original string that corresponds to maxLen - suffix.length visible chars
-  const targetLen = maxLen - suffix.length;
-  let visibleCount = 0;
-  let cutIndex = 0;
-  let inEscape = false;
-
-  for (let i = 0; i < str.length; i++) {
-    if (str[i] === '\x1b') {
-      inEscape = true;
-    } else if (inEscape && str[i] === 'm') {
-      inEscape = false;
-    } else if (!inEscape) {
-      visibleCount++;
-      if (visibleCount >= targetLen) {
-        cutIndex = i + 1;
-        break;
-      }
-    }
-  }
-
-  return str.substring(0, cutIndex) + suffix;
-}
-
-function formatTable(
-  info,
-  archival,
-  session,
-  precompact,
-  parallelSessions,
-  updateInfo = {},
-  expertise = {},
-  damageControl = {},
-  agentTeamsInfo = {},
-  scaleDetection = {}
-) {
-  const W = 58; // inner width (total table = W + 2 = 60)
-  const R = W - 25; // right column width (33 chars) to match total of 60
-  const lines = [];
-
-  // Helper to create a row (auto-truncates right content to fit)
-  const row = (left, right, leftColor = '', rightColor = '') => {
-    const leftStr = `${leftColor}${left}${leftColor ? c.reset : ''}`;
-    const rightTrunc = truncate(right, R);
-    const rightStr = `${rightColor}${rightTrunc}${rightColor ? c.reset : ''}`;
-    return `${c.dim}${box.v}${c.reset} ${pad(leftStr, 20)} ${c.dim}${box.v}${c.reset} ${pad(rightStr, R)} ${c.dim}${box.v}${c.reset}`;
-  };
-
-  // Helper for full-width row (spans both columns)
-  // Content width = W - 2 (for the two spaces after │ and before │)
-  const fullRow = (content, color = '') => {
-    const contentStr = `${color}${content}${color ? c.reset : ''}`;
-    return `${c.dim}${box.v}${c.reset} ${pad(contentStr, W - 2)} ${c.dim}${box.v}${c.reset}`;
-  };
-
-  // Two-column dividers: ├ + 22 dashes + ┼ + 35 dashes + ┤ = 60 total
-  const divider = () =>
-    `${c.dim}${box.lT}${box.h.repeat(22)}${box.cross}${box.h.repeat(W - 23)}${box.rT}${c.reset}`;
-  // Full-width divider: ├ + 58 dashes + ┤ = 60 total
-  const fullDivider = () => `${c.dim}${box.lT}${box.h.repeat(W)}${box.rT}${c.reset}`;
-  // Transition: full-width TO two-column
-  const splitDivider = () =>
-    `${c.dim}${box.lT}${box.h.repeat(22)}${box.tT}${box.h.repeat(W - 23)}${box.rT}${c.reset}`;
-  // Transition: two-column TO full-width
-  const mergeDivider = () =>
-    `${c.dim}${box.lT}${box.h.repeat(22)}${box.bT}${box.h.repeat(W - 23)}${box.rT}${c.reset}`;
-  // Borders
-  const topBorder = `${c.dim}${box.tl}${box.h.repeat(W)}${box.tr}${c.reset}`;
-  const bottomBorder = `${c.dim}${box.bl}${box.h.repeat(22)}${box.bT}${box.h.repeat(W - 23)}${box.br}${c.reset}`;
-
-  // Header with version and optional update indicator
-  // Use vibrant colors for branch
-  const branchColor =
-    info.branch === 'main' ? c.mintGreen : info.branch.startsWith('fix') ? c.coral : c.skyBlue;
-
-  // Build version string with update status (vibrant colors)
-  let versionStr = `v${info.version}`;
-  if (updateInfo.justUpdated && updateInfo.previousVersion) {
-    versionStr = `v${info.version} ${c.mintGreen}✓${c.reset}${c.slate} (was v${updateInfo.previousVersion})`;
-  } else if (updateInfo.available && updateInfo.latest) {
-    versionStr = `v${info.version} ${c.amber}↑${updateInfo.latest}${c.reset}`;
-  }
-
-  // Calculate remaining space for branch
-  const versionVisibleLen = updateInfo.justUpdated
-    ? info.version.length + 20 + (updateInfo.previousVersion?.length || 0)
-    : updateInfo.available
-      ? info.version.length + 3 + (updateInfo.latest?.length || 0)
-      : info.version.length;
-  const maxBranchLen = W - 1 - 15 - versionVisibleLen;
-  const branchDisplay =
-    info.branch.length > maxBranchLen
-      ? info.branch.substring(0, Math.max(5, maxBranchLen - 2)) + '..'
-      : info.branch;
-
-  const header = `${c.brand}${c.bold}agileflow${c.reset} ${c.dim}${versionStr}${c.reset}  ${branchColor}${branchDisplay}${c.reset} ${c.dim}(${info.commit})${c.reset}`;
-  const headerLine = `${c.dim}${box.v}${c.reset} ${pad(header, W - 2)} ${c.dim}${box.v}${c.reset}`;
-
-  lines.push(topBorder);
-  lines.push(headerLine);
-
-  // Show update available notification (using vibrant colors)
-  if (updateInfo.available && updateInfo.latest && !updateInfo.justUpdated) {
-    lines.push(fullDivider());
-    lines.push(
-      fullRow(
-        `${c.amber}↑${c.reset} Update available: ${c.softGold}v${updateInfo.latest}${c.reset}`,
-        ''
-      )
-    );
-    lines.push(fullRow(`  Run: ${c.skyBlue}npx agileflow update${c.reset}`, ''));
-  }
-
-  // Always show "What's new" section with current version changelog
-  // Get changelog entries for current version (even if not just updated)
-  const changelogEntries =
-    updateInfo.changelog && updateInfo.changelog.length > 0
-      ? updateInfo.changelog
-      : getChangelogEntries(info.version);
-
-  if (changelogEntries && changelogEntries.length > 0) {
-    lines.push(fullDivider());
-    const headerText = updateInfo.justUpdated
-      ? `${c.mintGreen}✨${c.reset} Just updated to ${c.softGold}v${info.version}${c.reset}:`
-      : `${c.teal}📋${c.reset} What's new in ${c.softGold}v${info.version}${c.reset}:`;
-    lines.push(fullRow(headerText, ''));
-    for (const entry of changelogEntries.slice(0, 2)) {
-      lines.push(fullRow(`  ${c.teal}•${c.reset} ${truncate(entry, W - 6)}`, ''));
-    }
-    lines.push(fullRow(`  Run ${c.skyBlue}/agileflow:whats-new${c.reset} for full changelog`, ''));
-  }
-
-  // Transition from full-width sections to two-column stories section
-  lines.push(splitDivider());
-
-  // Stories section (always colorful labels like obtain-context)
-  lines.push(
-    row(
-      'In Progress',
-      info.wipCount > 0 ? `${info.wipCount}` : '0',
-      c.peach,
-      info.wipCount > 0 ? c.peach : c.dim
-    )
-  );
-  lines.push(
-    row(
-      'Blocked',
-      info.blockedCount > 0 ? `${info.blockedCount}` : '0',
-      c.coral,
-      info.blockedCount > 0 ? c.coral : c.dim
-    )
-  );
-  lines.push(
-    row(
-      'Ready',
-      info.readyCount > 0 ? `${info.readyCount}` : '0',
-      c.skyBlue,
-      info.readyCount > 0 ? c.skyBlue : c.dim
-    )
-  );
-  const completedColor = `${c.bold}${c.mintGreen}`;
-  lines.push(
-    row(
-      'Completed',
-      info.completedCount > 0 ? `${info.completedCount}` : '0',
-      completedColor,
-      info.completedCount > 0 ? completedColor : c.dim
-    )
-  );
-
-  lines.push(divider());
-
-  // System section (colorful labels like obtain-context)
-  if (archival.disabled) {
-    lines.push(row('Auto-archival', 'disabled', c.lavender, c.slate));
-  } else if (archival.skippedByScale) {
-    lines.push(row('Auto-archival', 'skipped (small project)', c.lavender, c.dim));
-  } else {
-    const archivalStatus =
-      archival.archived > 0 ? `archived ${archival.archived} stories` : `nothing to archive`;
-    lines.push(
-      row('Auto-archival', archivalStatus, c.lavender, archival.archived > 0 ? c.mintGreen : c.dim)
-    );
-  }
-
-  // Session cleanup
-  let sessionStatus, sessionColor;
-  if (session.preserved) {
-    sessionStatus = `preserved ${session.commandNames.length} command(s)`;
-    sessionColor = c.mintGreen;
-  } else if (session.cleared > 0) {
-    sessionStatus = `cleared ${session.cleared} command(s)`;
-    sessionColor = c.mintGreen;
-  } else {
-    sessionStatus = `clean`;
-    sessionColor = c.dim;
-  }
-  lines.push(row('Session state', sessionStatus, c.lavender, sessionColor));
-
-  // PreCompact status with version check
-  if (precompact.configured && precompact.scriptExists) {
-    if (precompact.outdated) {
-      const verStr = precompact.version ? ` (v${precompact.version})` : '';
-      lines.push(row('Context preserve', `outdated${verStr}`, c.peach, c.peach));
-    } else if (session.commandNames && session.commandNames.length > 0) {
-      // Show the preserved command names
-      const cmdDisplay = session.commandNames.map(n => `/agileflow:${n}`).join(', ');
-      lines.push(row('Context preserve', cmdDisplay, c.lavender, c.mintGreen));
-    } else {
-      lines.push(row('Context preserve', 'ready', c.lavender, c.dim));
-    }
-  } else if (precompact.configured) {
-    lines.push(row('Context preserve', 'script missing', c.peach, c.peach));
-  } else {
-    lines.push(row('Context preserve', 'not configured', c.slate, c.slate));
-  }
-
-  // Parallel sessions status
-  if (parallelSessions && parallelSessions.available) {
-    if (parallelSessions.otherActive > 0) {
-      const sessionStr = `⚠️ ${parallelSessions.otherActive} other active`;
-      lines.push(row('Sessions', sessionStr, c.peach, c.peach));
-    } else {
-      const sessionStr = parallelSessions.currentId
-        ? `✓ Session ${parallelSessions.currentId} (only)`
-        : '✓ Only session';
-      lines.push(row('Sessions', sessionStr, c.lavender, c.mintGreen));
-    }
-  }
-
-  // Agent expertise validation (always show with color)
-  if (expertise && expertise.total > 0) {
-    if (expertise.failed > 0) {
-      const expertStr = `❌ ${expertise.failed} failed, ${expertise.warnings} warnings`;
-      lines.push(row('Expertise', expertStr, c.coral, c.coral));
-    } else if (expertise.warnings > 0) {
-      const expertStr = `⚠️ ${expertise.warnings} warnings (${expertise.passed} ok)`;
-      lines.push(row('Expertise', expertStr, c.peach, c.peach));
-    } else {
-      lines.push(row('Expertise', `✓ ${expertise.total} valid`, c.lavender, c.mintGreen));
-    }
-  }
-
-  // Damage control status (PreToolUse hooks for dangerous command protection)
-  if (damageControl && damageControl.configured) {
-    if (!damageControl.scriptsOk) {
-      lines.push(row('Damage control', '⚠️ scripts missing', c.coral, c.coral));
-    } else {
-      const levelStr = damageControl.level || 'standard';
-      const patternStr =
-        damageControl.patternCount > 0 ? `${damageControl.patternCount} patterns` : '';
-      const dcStatus = `🛡️ ${levelStr}${patternStr ? ` (${patternStr})` : ''}`;
-      lines.push(row('Damage control', dcStatus, c.lavender, c.mintGreen));
-    }
-  } else {
-    lines.push(row('Damage control', 'not configured', c.slate, c.slate));
-  }
-
-  // Agent Teams status
-  if (agentTeamsInfo && agentTeamsInfo.status === 'enabled') {
-    lines.push(row('Agent Teams', `${agentTeamsInfo.value}`, c.lavender, c.mintGreen));
-  } else if (agentTeamsInfo && agentTeamsInfo.status === 'fallback') {
-    lines.push(row('Agent Teams', `${agentTeamsInfo.value}`, c.lavender, c.dim));
-  }
-
-  // Scale detection (EP-0033)
-  if (scaleDetection && scaleDetection.scale) {
-    const scaleColors = {
-      micro: c.cyan,
-      small: c.teal,
-      medium: c.mintGreen,
-      large: c.peach,
-      enterprise: c.coral,
-    };
-    const scaleIcons = {
-      micro: '◦',
-      small: '○',
-      medium: '◎',
-      large: '●',
-      enterprise: '◉',
-    };
-    const scale = scaleDetection.scale;
-    const icon = scaleIcons[scale] || '◎';
-    const label = scale.charAt(0).toUpperCase() + scale.slice(1);
-    const cacheNote = scaleDetection.fromCache ? '' : ` (${scaleDetection.detection_ms}ms)`;
-    lines.push(
-      row('Scale', `${icon} ${label}${cacheNote}`, c.lavender, scaleColors[scale] || c.dim)
-    );
-  }
-
-  lines.push(divider());
-
-  // Current story (colorful like obtain-context)
-  if (info.currentStory) {
-    lines.push(
-      row(
-        'Current',
-        `${c.lightYellow}${info.currentStory.id}${c.reset}: ${info.currentStory.title}`,
-        c.skyBlue,
-        ''
-      )
-    );
-  } else {
-    lines.push(row('Current', 'No active story', c.skyBlue, c.dim));
-  }
-
-  // Last commit (colorful like obtain-context)
-  lines.push(
-    row('Last commit', `${c.peach}${info.commit}${c.reset} ${info.lastCommit}`, c.lavender, '')
-  );
-
-  lines.push(bottomBorder);
-
-  return lines.join('\n');
-}
-
-// Format session banner for non-main sessions
-function formatSessionBanner(parallelSessions) {
-  if (!parallelSessions.available || parallelSessions.isMain) {
-    return null;
-  }
-
-  const W = 62; // banner width
-  const lines = [];
-
-  // Get display name
-  const sessionName = parallelSessions.nickname
-    ? `SESSION ${parallelSessions.currentId} "${parallelSessions.nickname}"`
-    : `SESSION ${parallelSessions.currentId}`;
-
-  lines.push(`${c.dim}${box.tl}${box.h.repeat(W)}${box.tr}${c.reset}`);
-  lines.push(
-    `${c.dim}${box.v}${c.reset} ${c.teal}${c.bold}${pad(sessionName, W - 2)}${c.reset} ${c.dim}${box.v}${c.reset}`
-  );
-  lines.push(
-    `${c.dim}${box.v}${c.reset}    ${c.slate}Branch:${c.reset} ${pad(parallelSessions.branch || 'unknown', W - 13)} ${c.dim}${box.v}${c.reset}`
-  );
-
-  // Show relative path to main
-  if (parallelSessions.sessionPath) {
-    const relPath = path.relative(parallelSessions.sessionPath, parallelSessions.mainPath) || '.';
-    lines.push(
-      `${c.dim}${box.v}${c.reset}    ${c.slate}Main at:${c.reset} ${pad(relPath, W - 14)} ${c.dim}${box.v}${c.reset}`
-    );
-  }
-
-  lines.push(`${c.dim}${box.bl}${box.h.repeat(W)}${box.br}${c.reset}`);
-
-  return lines.join('\n');
-}
-
-// Main (synchronous - async work deferred to welcome-deferred.js)
-function main() {
-  _mark('start');
-
-  // Start hook timer for metrics
-  const timer = hookMetrics ? hookMetrics.startHookTimer('SessionStart', 'welcome') : null;
-
-  const rootDir = getProjectRoot();
-
-  // PERFORMANCE: Load all project files once into cache
-  // This eliminates 6-8 duplicate file reads across functions
-  const cache = loadProjectFiles(rootDir);
-  _mark('loadFiles');
-
-  // ============================================
-  // PHASE 1: INSTANT WELCOME (< 300ms)
-  // All fast operations - no network, no auto-update
-  // ============================================
-  const info = getProjectInfo(rootDir, cache);
-  _mark('getInfo');
-
-  // PERFORMANCE OPTIMIZATION (US-0356): Read scale from session-state cache
-  // Avoids requiring scale-detector module + git subprocess when cache is fresh (< 5 min)
-  let earlyScale = null;
-  const cachedScale = cache?.sessionState?.scale_detection;
-  const scaleFresh =
-    cachedScale &&
-    cachedScale.detected_at &&
-    Date.now() - new Date(cachedScale.detected_at).getTime() < 300000; // 5 min
-  if (scaleFresh) {
-    earlyScale = { ...cachedScale, fromCache: true };
-  } else {
-    try {
-      const scaleDetector = require('./lib/scale-detector');
-      earlyScale = scaleDetector.detectScale({
-        rootDir,
-        statusJson: cache?.status,
-        sessionState: cache?.sessionState,
-      });
-    } catch (e) {
-      // Scale detection not available
-    }
-  }
-
-  const scaleRecommendations = earlyScale
-    ? (() => {
-        try {
-          return require('./lib/scale-detector').getScaleRecommendations(earlyScale.scale);
-        } catch {
-          return null;
-        }
-      })()
-    : null;
-  _mark('scale');
-
-  const archival =
-    scaleRecommendations && scaleRecommendations.skipArchival
-      ? { ran: false, threshold: 0, archived: 0, remaining: 0, skippedByScale: true }
-      : runArchival(rootDir, cache);
-  _mark('archival');
-
-  const session = clearActiveCommands(rootDir, cache);
-  _mark('clearCmds');
-
-  const precompact = checkPreCompact(rootDir, cache);
-  _mark('precompact');
-
-  // PERFORMANCE OPTIMIZATION (US-0356): Use lightweight session check
-  // Reads registry.json + lock files directly (~30 lines) instead of
-  // requiring the full session-manager module chain (~3,600 lines across 8 modules).
-  // Full session registration deferred to Phase 3 (welcome-deferred.js).
-  const parallelSessions = checkParallelSessionsFast(rootDir);
-  _mark('sessions');
-
-  // PERFORMANCE OPTIMIZATION (US-0356): Defer expertise count to Phase 3
-  // Directory scan with file reads is non-critical for the table.
-  // Use cached result from session-state if available, otherwise show placeholder.
-  let expertise;
-  const cachedExpertise = cache?.sessionState?.expertise_count;
-  const validExpertiseCache =
-    cachedExpertise &&
-    cachedExpertise.total > 0 &&
-    typeof cachedExpertise.passed === 'number' &&
-    typeof cachedExpertise.warnings === 'number' &&
-    typeof cachedExpertise.failed === 'number';
-  if (validExpertiseCache) {
-    expertise = cachedExpertise;
-  } else {
-    expertise = getExpertiseCountFast(rootDir);
-  }
-  _mark('expertise');
-
-  const commandSync = checkCommandSync(rootDir);
-  _mark('cmdSync');
-
-  const damageControl = checkDamageControl(rootDir, cache);
-  _mark('damageCtl');
-
-  // Use early scale detection result (already computed for hook scheduling)
-  const scaleDetection = earlyScale || { scale: 'medium' };
-
-  // PERFORMANCE OPTIMIZATION (US-0356): Read Agent Teams mode from metadata cache
-  // Avoids requiring feature-flags module when metadata is already loaded.
-  // Uses same { label, value, status } format as getAgentTeamsDisplayInfo().
-  let agentTeamsInfo = {};
-  const envTeams = process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;
-  const envTeamsEnabled = envTeams === '1' || envTeams === 'true' || envTeams === 'yes';
-  const metaTeamsEnabled = cache?.metadata?.features?.agentTeams?.enabled === true;
-  if (envTeamsEnabled || metaTeamsEnabled) {
-    agentTeamsInfo = { label: 'Agent Teams', value: 'ENABLED (native)', status: 'enabled' };
-  } else {
-    agentTeamsInfo = { label: 'Agent Teams', value: 'subagent mode', status: 'fallback' };
-  }
-  _mark('agentTeams');
-
-  // Check if a previous background update completed successfully
-  // This allows us to show "just updated" even for background updates
-  let updateInfo = {};
-  try {
-    // Use already-loaded session state from cache instead of re-reading
-    const state = cache?.sessionState;
-    if (state?.pending_update) {
-      const pendingUpdate = state.pending_update;
-      const startedAt = new Date(pendingUpdate.started_at);
-      const minutesAgo = (Date.now() - startedAt.getTime()) / (1000 * 60);
-
-      if (info.version === pendingUpdate.to) {
-        updateInfo.justUpdated = true;
-        updateInfo.previousVersion = pendingUpdate.from;
-        updateInfo.changelog = getChangelogEntries(info.version);
-        // Clear pending update
-        const sessionStatePath = getSessionStatePath(rootDir);
-        delete state.pending_update;
-        fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-      } else if (minutesAgo > 5) {
-        const sessionStatePath = getSessionStatePath(rootDir);
-        delete state.pending_update;
-        fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
-      }
-    }
-  } catch (e) {
-    // Silently continue - pending update check is non-critical
-  }
-  _mark('updateInfo');
-
-  // PERFORMANCE OPTIMIZATION (US-0356): Defer config staleness to Phase 3
-  // Only produces a notification; not needed for the main table.
-  // Read cached result from session-state if available.
-  let configStaleness = { outdated: false, autoApply: false };
-  let configAutoApplied = 0;
-  const cachedConfigStaleness = cache?.sessionState?.config_staleness;
-  const configCacheAge = cachedConfigStaleness?.cached_at
-    ? Date.now() - new Date(cachedConfigStaleness.cached_at).getTime()
-    : Infinity;
-  const configCacheFresh = configCacheAge < 300000; // 5 min TTL
-  if (cachedConfigStaleness && configCacheFresh) {
-    configStaleness = cachedConfigStaleness;
-  } else {
-    try {
-      configStaleness = checkConfigStaleness(rootDir, info.version, cache);
-
-      // Auto-apply new options if profile is "full" (only auto-applyable ones)
-      if (configStaleness.autoApply && configStaleness.autoApplyOptions?.length > 0) {
-        configAutoApplied = autoApplyConfigOptions(rootDir, configStaleness.autoApplyOptions);
-        if (configAutoApplied > 0) {
-          configStaleness.newOptions = configStaleness.newOptions.filter(o => !o.autoApplyable);
-          configStaleness.newOptionsCount = configStaleness.newOptions.length;
-          if (configStaleness.newOptionsCount === 0) {
-            configStaleness.outdated = false;
-          }
-        }
-      }
-    } catch (e) {
-      // Config check failed - continue without it
-    }
-  }
-  _mark('configStale');
-
-  // Check tmux availability (only if tmuxAutoSpawn is enabled)
-  let tmuxCheck = { available: true };
-  const tmuxAutoSpawnEnabled = cache?.metadata?.features?.tmuxAutoSpawn?.enabled !== false;
-  if (tmuxAutoSpawnEnabled) {
-    tmuxCheck = checkTmuxAvailability(cache);
-  }
-  _mark('tmux');
-
-  // Show session banner FIRST if in a non-main session
-  const sessionBanner = formatSessionBanner(parallelSessions);
-  if (sessionBanner) {
-    console.log(sessionBanner);
-  }
-
-  console.log(
-    formatTable(
-      info,
-      archival,
-      session,
-      precompact,
-      parallelSessions,
-      updateInfo,
-      expertise,
-      damageControl,
-      agentTeamsInfo,
-      scaleDetection
-    )
-  );
-
-  // ============================================
-  // PHASE 2: FAST POST-TABLE NOTIFICATIONS + DEFERRED BACKGROUND WORK
-  // Only instant operations here. Expensive work deferred to welcome-deferred.js
-  // ============================================
-
-  // Display deferred warnings from previous session's background work
-  displayDeferredWarnings(rootDir);
-
-  // Check update cache (1-hour TTL) - instant if cached, skipped if stale
-  let skipUpdateInDeferred = false;
-  try {
-    const cachedUpdate = getUpdateFromCache(cache);
-    if (cachedUpdate) {
-      skipUpdateInDeferred = true;
-      // Use cached result for notification
-      if (cachedUpdate.available && cachedUpdate.latest && !updateInfo.justUpdated) {
-        console.log('');
-        console.log(
-          `${c.amber}↑ Update available:${c.reset} v${info.version} → ${c.softGold}v${cachedUpdate.latest}${c.reset}`
-        );
-        console.log(`  Run: ${c.skyBlue}npx agileflow update${c.reset}`);
-      }
-    }
-    // If no cache or stale, the deferred script will check and cache the result
-  } catch (e) {
-    // Cache check failed, deferred script will handle it
-  }
-
-  // Show config auto-apply confirmation (for "full" profile)
-  if (configAutoApplied > 0) {
-    console.log('');
-    console.log(
-      `${c.mintGreen}✨ Auto-applied ${configAutoApplied} new config option(s)${c.reset}`
-    );
-    console.log(`   ${c.slate}Profile "full" enables all new features automatically.${c.reset}`);
-  }
-
-  // Show config staleness notification (for custom profiles)
-  if (configStaleness.outdated && configStaleness.newOptionsCount > 0) {
-    console.log('');
-    console.log(
-      `${c.amber}⚙️  ${configStaleness.newOptionsCount} new configuration option(s) available${c.reset}`
-    );
-    for (const opt of configStaleness.newOptions.slice(0, 3)) {
-      console.log(`   ${c.dim}• ${opt.description}${c.reset}`);
-    }
-    console.log(
-      `   ${c.slate}Run ${c.skyBlue}/agileflow:configure${c.reset}${c.slate} to enable them.${c.reset}`
-    );
-  }
-
-  // Show command sync staleness notification
-  if (commandSync && commandSync.stale) {
-    const ref = commandSync.sourceCount > 0 ? commandSync.sourceCount : commandSync.coreCount;
-    console.log('');
-    console.log(
-      `${c.amber}⚠️  ${ref - commandSync.ideCount} command(s) out of sync${c.reset} ${c.dim}(IDE has ${commandSync.ideCount}/${ref})${c.reset}`
-    );
-    if (commandSync.staleCoreInstall) {
-      console.log(
-        `   ${c.dim}Core install also stale: ${commandSync.coreCount}/${commandSync.sourceCount}${c.reset}`
-      );
-    }
-    console.log(`   ${c.slate}Auto-syncing in background...${c.reset}`);
-  }
-
-  // Show tmux installation notice if tmux auto-spawn is enabled but tmux not installed
-  if (tmuxAutoSpawnEnabled && !tmuxCheck.available) {
-    console.log('');
-    console.log(
-      `${c.amber}📦 tmux not installed${c.reset} ${c.dim}(enables parallel sessions in one terminal)${c.reset}`
-    );
-
-    // Show platform-specific install command
-    if (tmuxCheck.platform?.installCmd) {
-      console.log(`   ${c.slate}Install for ${tmuxCheck.platform.os}:${c.reset}`);
-      console.log(`   ${c.cyan}${tmuxCheck.platform.installCmd}${c.reset}`);
-      console.log('');
-      console.log(`   ${c.dim}No sudo? Use: ${c.cyan}${tmuxCheck.noSudoCmd}${c.reset}`);
-    } else {
-      // Unknown platform - show all options
-      console.log(`   ${c.slate}Install with one of:${c.reset}`);
-      console.log(`   ${c.dim}• macOS:${c.reset}  ${c.cyan}brew install tmux${c.reset}`);
-      console.log(`   ${c.dim}• Ubuntu:${c.reset} ${c.cyan}sudo apt install tmux${c.reset}`);
-      console.log(`   ${c.dim}• No sudo:${c.reset} ${c.cyan}${tmuxCheck.noSudoCmd}${c.reset}`);
-    }
-    console.log(
-      `   ${c.dim}Or disable this notice: ${c.skyBlue}/agileflow:configure --disable=tmuxautospawn${c.reset}`
-    );
-  }
-
-  // Show warning and tip if other sessions are active (vibrant colors)
-  if (parallelSessions.otherActive > 0) {
-    console.log('');
-    console.log(`${c.amber}⚠️  Other Claude session(s) active in this repo.${c.reset}`);
-    console.log(
-      `${c.slate}   Run ${c.skyBlue}/agileflow:session:status${c.reset}${c.slate} to see all sessions.${c.reset}`
-    );
-    console.log(
-      `${c.slate}   Run ${c.skyBlue}/agileflow:session:new${c.reset}${c.slate} to create isolated workspace.${c.reset}`
-    );
-  }
-
-  // Show detailed message if sessions were cleaned (VISIBLE - not hidden!)
-  if (parallelSessions.cleaned > 0 && parallelSessions.cleanedSessions) {
-    console.log('');
-    console.log(`${c.amber}📋 Cleaned ${parallelSessions.cleaned} inactive session(s):${c.reset}`);
-    parallelSessions.cleanedSessions.forEach(sess => {
-      const name = sess.nickname ? `${sess.id} "${sess.nickname}"` : `Session ${sess.id}`;
-      const reason = sess.reason === 'pid_dead' ? 'process ended' : sess.reason;
-      console.log(`   ${c.dim}└─ ${name} (${reason}, PID ${sess.pid})${c.reset}`);
-    });
-    console.log(
-      `   ${c.slate}Sessions are cleaned when their Claude Code process is no longer running.${c.reset}`
-    );
-  }
-
-  _mark('postTable');
-
-  // ============================================
-  // PHASE 3: SPAWN DEFERRED BACKGROUND WORK
-  // Session health, process cleanup, story claiming, file tracking,
-  // epic completion, ideation sync, automations, update check (if stale)
-  // Also: full session registration, expertise re-scan, config staleness check
-  // Results saved to session-state.json for next session display.
-  // ============================================
-  try {
-    const deferredScript = path.join(__dirname, 'welcome-deferred.js');
-    if (fs.existsSync(deferredScript)) {
-      const deferredArgs = [deferredScript, rootDir, `--version=${info.version}`];
-      if (skipUpdateInDeferred) {
-        deferredArgs.push('--skip-update');
-      }
-      if (updateInfo.justUpdated) {
-        deferredArgs.push('--just-updated');
-      }
-      // US-0356: Signal deferred to run full session registration and expertise scan
-      deferredArgs.push('--run-session-register');
-      deferredArgs.push('--run-expertise-scan');
-      if (!cachedConfigStaleness || !configCacheFresh) {
-        deferredArgs.push('--run-config-staleness');
-      }
-      spawnBackground('node', deferredArgs, { cwd: rootDir });
-    }
-  } catch (e) {
-    // Deferred script spawn failed, non-critical
-  }
-
-  _mark('deferred');
-
-  // Spawn background command sync if stale
-  if (commandSync && commandSync.stale) {
-    try {
-      const isDogfooding = commandSync.sourceCount > 0;
-      if (isDogfooding) {
-        const cliPath = path.join(rootDir, 'packages', 'cli', 'tools', 'cli', 'agileflow-cli.js');
-        if (fs.existsSync(cliPath)) {
-          spawnBackground('node', [cliPath, 'update', '--force', '-d', rootDir], { cwd: rootDir });
-        }
-      } else {
-        spawnBackground('npx', ['agileflow', 'update', '--force'], { cwd: rootDir });
-      }
-    } catch (e) {
-      // Command sync spawn failed, non-critical
-    }
-  }
-  _mark('cmdSyncSpawn');
-
-  // Record hook metrics
-  if (timer && hookMetrics) {
-    hookMetrics.recordHookMetrics(timer, 'success', null, { rootDir });
-  }
-
-  // Output profiling data if enabled
-  _logTimings();
-}
-
-try {
-  main();
-} catch (err) {
-  log.error(err.message || String(err));
-  // Record error in metrics if possible
-  if (hookMetrics) {
-    try {
-      const rootDir = getProjectRoot();
-      const timer = hookMetrics.startHookTimer('SessionStart', 'welcome');
-      hookMetrics.recordHookMetrics(timer, 'error', err.message, { rootDir });
-    } catch (e) {
-      // Silently ignore metrics errors
-    }
-  }
-}