agileflow 2.92.0 → 2.93.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.93.0] - 2026-01-24
+
+### Added
+- RLM document analysis and session health improvements
+
+## [2.92.1] - 2026-01-23
+
+### Added
+- Session worktree timeout, progress feedback, and docs folder copy
+
 ## [2.92.0] - 2026-01-23
 
 ### Added

package/README.md

@@ -3,8 +3,8 @@
 </p>
 
 [![npm version](https://img.shields.io/npm/v/agileflow?color=brightgreen)](https://www.npmjs.com/package/agileflow)
-[![Commands](https://img.shields.io/badge/commands-76-blue)](docs/04-architecture/commands.md)
-[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-30-orange)](docs/04-architecture/subagents.md)
+[![Commands](https://img.shields.io/badge/commands-78-blue)](docs/04-architecture/commands.md)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-31-orange)](docs/04-architecture/subagents.md)
 [![Skills](https://img.shields.io/badge/skills-dynamic-purple)](docs/04-architecture/skills.md)
 
 **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex CLI, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
@@ -65,8 +65,8 @@ AgileFlow combines three proven methodologies:
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](docs/04-architecture/commands.md) | 76 | Slash commands for agile workflows |
-| [Agents/Experts](docs/04-architecture/subagents.md) | 30 | Specialized agents with self-improving knowledge bases |
+| [Commands](docs/04-architecture/commands.md) | 78 | Slash commands for agile workflows |
+| [Agents/Experts](docs/04-architecture/subagents.md) | 31 | Specialized agents with self-improving knowledge bases |
 | [Skills](docs/04-architecture/skills.md) | Dynamic | Generated on-demand with `/agileflow:skill:create` |
 
 ---
@@ -76,8 +76,8 @@ AgileFlow combines three proven methodologies:
 Full documentation lives in [`docs/04-architecture/`](docs/04-architecture/):
 
 ### Reference
-- [Commands](docs/04-architecture/commands.md) - All 76 slash commands
-- [Agents/Experts](docs/04-architecture/subagents.md) - 30 specialized agents with self-improving knowledge
+- [Commands](docs/04-architecture/commands.md) - All 78 slash commands
+- [Agents/Experts](docs/04-architecture/subagents.md) - 31 specialized agents with self-improving knowledge
 - [Skills](docs/04-architecture/skills.md) - Dynamic skill generator with MCP integration
 
 ### Architecture

package/lib/codebase-indexer.js

@@ -643,7 +643,8 @@ function updateIndex(projectRoot, options = {}) {
         existingIndex.tags[tag].push(filePath);
       }
       for (const exp of fileData.exports || []) {
-        if (!Object.hasOwn(existingIndex.symbols.exports, exp)) existingIndex.symbols.exports[exp] = [];
+        if (!Object.hasOwn(existingIndex.symbols.exports, exp))
+          existingIndex.symbols.exports[exp] = [];
         existingIndex.symbols.exports[exp].push(filePath);
       }
     }

package/package.json

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

package/scripts/agileflow-statusline.sh

@@ -381,6 +381,91 @@ PYTHON
   fi
 fi
 
+# ============================================================================
+# Task Complexity Assessment (RLM-inspired)
+# ============================================================================
+# Detects task complexity based on:
+# - Current story dependencies and blockers
+# - File count affected
+# - Cross-references needed
+#
+# Maps to context threshold recommendations:
+# - LOW complexity: 70% context is fine
+# - MEDIUM complexity: stay under 60%
+# - HIGH complexity: stay under 40% (dumb zone starts sooner)
+#
+COMPLEXITY_DISPLAY=""
+SHOW_COMPLEXITY=true
+
+# Check component setting
+if [ "$COMPONENTS" != "null" ] && [ -n "$COMPONENTS" ]; then
+  SHOW_COMPLEXITY=$(echo "$COMPONENTS" | jq -r '.complexity | if . == null then true else . end')
+fi
+
+if [ "$SHOW_COMPLEXITY" = "true" ]; then
+  TASK_COMPLEXITY="LOW"
+  COMPLEXITY_SCORE=0
+
+  # Check session-state.json for active task info
+  if [ -f "docs/09-agents/session-state.json" ]; then
+    SESSION_STATE=$(cat docs/09-agents/session-state.json 2>/dev/null)
+
+    # Check active commands (some commands are inherently complex)
+    # Get most recent active command name from array
+    ACTIVE_CMD=$(echo "$SESSION_STATE" | jq -r '.active_commands[-1].name // empty' 2>/dev/null)
+    case "$ACTIVE_CMD" in
+      babysit|mentor|orchestrator|multi-expert|rlm)
+        COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 2))
+        ;;
+      research*|ideate|rpi)
+        COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 1))
+        ;;
+    esac
+
+    # Check current story's dependencies
+    CURRENT_STORY=$(echo "$SESSION_STATE" | jq -r '.current_story // empty' 2>/dev/null)
+    if [ -n "$CURRENT_STORY" ] && [ -f "docs/09-agents/status.json" ]; then
+      STATUS_JSON=$(cat docs/09-agents/status.json 2>/dev/null)
+
+      # Count dependencies
+      DEP_COUNT=$(echo "$STATUS_JSON" | jq -r ".stories[\"$CURRENT_STORY\"].depends_on // [] | length" 2>/dev/null)
+      [ -n "$DEP_COUNT" ] && [ "$DEP_COUNT" -gt 2 ] 2>/dev/null && COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 1))
+
+      # Count acceptance criteria
+      AC_COUNT=$(echo "$STATUS_JSON" | jq -r ".stories[\"$CURRENT_STORY\"].acceptance_criteria // [] | length" 2>/dev/null)
+      [ -n "$AC_COUNT" ] && [ "$AC_COUNT" -gt 5 ] 2>/dev/null && COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 1))
+
+      # Check for blockers
+      BLOCKER_COUNT=$(echo "$STATUS_JSON" | jq -r ".stories[\"$CURRENT_STORY\"].blockers // [] | length" 2>/dev/null)
+      [ -n "$BLOCKER_COUNT" ] && [ "$BLOCKER_COUNT" -gt 0 ] 2>/dev/null && COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 1))
+    fi
+
+    # Check ralph loop mode (more complex)
+    LOOP_ENABLED=$(echo "$SESSION_STATE" | jq -r '.ralph_loop.enabled // false' 2>/dev/null)
+    [ "$LOOP_ENABLED" = "true" ] && COMPLEXITY_SCORE=$((COMPLEXITY_SCORE + 1))
+  fi
+
+  # Determine complexity level
+  if [ "$COMPLEXITY_SCORE" -ge 4 ]; then
+    TASK_COMPLEXITY="HIGH"
+    COMPLEXITY_COLOR="$RED"
+    COMPLEXITY_ICON="◆"  # Diamond for high complexity
+  elif [ "$COMPLEXITY_SCORE" -ge 2 ]; then
+    TASK_COMPLEXITY="MED"
+    COMPLEXITY_COLOR="$YELLOW"
+    COMPLEXITY_ICON="◇"  # Outline diamond for medium
+  else
+    TASK_COMPLEXITY="LOW"
+    COMPLEXITY_COLOR="$GREEN"
+    COMPLEXITY_ICON="○"  # Circle for low
+  fi
+
+  # Only show if not LOW (to reduce noise)
+  if [ "$TASK_COMPLEXITY" != "LOW" ]; then
+    COMPLEXITY_DISPLAY="${COMPLEXITY_COLOR}${COMPLEXITY_ICON}${TASK_COMPLEXITY}${RESET}"
+  fi
+fi
+
 # ============================================================================
 # AgileFlow Status - Read from status.json
 # ============================================================================
@@ -583,6 +668,21 @@ if [ "$SHOW_SESSION" = "true" ] && [ -n "$SESSION_INFO" ]; then
   fi
 fi
 
+# Session health indicator (shows warning icon + count if issues exist)
+if [ "$SHOW_SESSION" = "true" ]; then
+  SCRIPTS_DIR="$(dirname "$0")"
+  HEALTH_OUTPUT=$(node "$SCRIPTS_DIR/session-manager.js" health 2>/dev/null)
+  if [ -n "$HEALTH_OUTPUT" ]; then
+    HEALTH_ISSUES=$(echo "$HEALTH_OUTPUT" | jq -r '
+      (.uncommitted | length) + (.stale | length) + (.orphanedRegistry | length)
+    ' 2>/dev/null)
+    if [ -n "$HEALTH_ISSUES" ] && [ "$HEALTH_ISSUES" != "0" ] && [ "$HEALTH_ISSUES" != "null" ]; then
+      [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT} "
+      OUTPUT="${OUTPUT}${YELLOW}⚠${HEALTH_ISSUES}${RESET}"
+    fi
+  fi
+fi
+
 # Model with subtle styling (if enabled and available)
 if [ "$SHOW_MODEL" = "true" ] && [ -n "$MODEL_DISPLAY" ]; then
   [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
@@ -623,6 +723,12 @@ if [ "$SHOW_CONTEXT" = "true" ] && [ -n "$CTX_DISPLAY" ]; then
   fi
 fi
 
+# Add task complexity indicator (if enabled and not LOW)
+if [ "$SHOW_COMPLEXITY" = "true" ] && [ -n "$COMPLEXITY_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${COMPLEXITY_DISPLAY}"
+fi
+
 # Add session time remaining (if enabled and available)
 if [ "$SHOW_SESSION_TIME" = "true" ] && [ -n "$SESSION_DISPLAY" ]; then
   [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"

package/scripts/agileflow-welcome.js

@@ -102,10 +102,20 @@ function detectPlatform() {
     // 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')) {
+      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')) {
+      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')) {
@@ -662,15 +672,43 @@ function compareVersions(a, b) {
  * 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 },
+  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 },
+  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 },
+  tmuxAutoSpawn: {
+    since: '2.92.0',
+    description: 'Auto-start Claude in tmux session',
+    autoApplyable: true,
+  },
 };
 
 /**
@@ -719,7 +757,10 @@ function checkConfigStaleness(rootDir, currentVersion, cache = null) {
       // 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 };
+          const optionInfo = ALL_CONFIG_OPTIONS[name] || {
+            description: name,
+            autoApplyable: false,
+          };
           result.outdated = true;
           result.newOptionsCount++;
           result.newOptions.push({
@@ -776,22 +817,24 @@ function isOptionActuallyConfigured(optionName, hooks, settings) {
     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'))
+      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'))
+      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'))
+      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
@@ -848,7 +891,10 @@ ${marker}
         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) {
+          if (
+            !metadata.features.tmuxAutoSpawn ||
+            metadata.features.tmuxAutoSpawn.enabled === undefined
+          ) {
             metadata.features.tmuxAutoSpawn = {
               enabled: true,
               version: metadata.version || '2.92.0',
@@ -1636,24 +1682,32 @@ async function main() {
   // 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.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}`);
+    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}`);
+    console.log(
+      `   ${c.slate}Run ${c.skyBlue}/agileflow:configure${c.reset}${c.slate} to enable them.${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}`);
+    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) {
@@ -1668,7 +1722,9 @@ async function main() {
       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}`);
+    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)
@@ -1697,6 +1753,63 @@ async function main() {
     );
   }
 
+  // === SESSION HEALTH WARNINGS ===
+  // Check for forgotten sessions with uncommitted changes, stale sessions, orphaned entries
+  try {
+    const healthResult = spawnSync(
+      'node',
+      [SESSION_MANAGER_PATH, 'health'],
+      { encoding: 'utf8', timeout: 10000 }
+    );
+
+    if (healthResult.stdout) {
+      const health = JSON.parse(healthResult.stdout);
+      const hasIssues =
+        health.uncommitted.length > 0 ||
+        health.stale.length > 0 ||
+        health.orphanedRegistry.length > 0;
+
+      if (hasIssues) {
+        console.log('');
+
+        // Uncommitted changes - MOST IMPORTANT (potential data loss)
+        if (health.uncommitted.length > 0) {
+          console.log(
+            `${c.coral}⚠️  ${health.uncommitted.length} session(s) have uncommitted changes:${c.reset}`
+          );
+          health.uncommitted.slice(0, 3).forEach((sess) => {
+            const name = sess.nickname ? `"${sess.nickname}"` : `Session ${sess.id}`;
+            console.log(`${c.dim}   └─ ${name}: ${sess.changeCount} file(s)${c.reset}`);
+          });
+          if (health.uncommitted.length > 3) {
+            console.log(
+              `${c.dim}   └─ ... and ${health.uncommitted.length - 3} more${c.reset}`
+            );
+          }
+          console.log(
+            `${c.slate}   Run: ${c.skyBlue}/agileflow:session:status${c.slate} to see details${c.reset}`
+          );
+        }
+
+        // Stale sessions (inactive 7+ days)
+        if (health.stale.length > 0) {
+          console.log(
+            `${c.amber}📅 ${health.stale.length} session(s) inactive for 7+ days${c.reset}`
+          );
+        }
+
+        // Orphaned registry entries (path doesn't exist)
+        if (health.orphanedRegistry.length > 0) {
+          console.log(
+            `${c.peach}🗑️  ${health.orphanedRegistry.length} session(s) have missing directories${c.reset}`
+          );
+        }
+      }
+    }
+  } catch (e) {
+    // Health check failed, skip silently
+  }
+
   // Story claiming: cleanup stale claims and show warnings
   if (storyClaiming) {
     try {