agileflow 2.92.1 → 2.93.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ 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

package/README.md

@@ -3,7 +3,7 @@
 </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-77-blue)](docs/04-architecture/commands.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)
 
@@ -65,7 +65,7 @@ AgileFlow combines three proven methodologies:
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](docs/04-architecture/commands.md) | 77 | Slash commands for agile workflows |
+| [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,7 +76,7 @@ AgileFlow combines three proven methodologies:
 Full documentation lives in [`docs/04-architecture/`](docs/04-architecture/):
 
 ### Reference
-- [Commands](docs/04-architecture/commands.md) - All 77 slash commands
+- [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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.92.1",
+  "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

@@ -1753,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 {