agileflow 2.75.0 → 2.77.0

package/package.json

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

package/scripts/agileflow-configure.js

@@ -23,7 +23,7 @@
  *   --detect                            Show current status
  *   --help                              Show help
  *
- * Features: sessionstart, precompact, archival, statusline, autoupdate
+ * Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate
  */
 
 const fs = require('fs');
@@ -71,7 +71,8 @@ const VERSION = getVersion();
 const FEATURES = {
   sessionstart: { hook: 'SessionStart', script: 'agileflow-welcome.js', type: 'node' },
   precompact: { hook: 'PreCompact', script: 'precompact-context.sh', type: 'bash' },
-  // Note: Stop hook removed due to Claude Code reliability issues (see GitHub issues #6974, #11544)
+  ralphloop: { hook: 'Stop', script: 'ralph-loop.js', type: 'node' },
+  selfimprove: { hook: 'Stop', script: 'auto-self-improve.js', type: 'node' },
   archival: { script: 'archive-completed-stories.sh', requiresHook: 'sessionstart' },
   statusline: { script: 'agileflow-statusline.sh' },
   autoupdate: { metadataOnly: true }, // Stored in metadata.updates.autoUpdate
@@ -82,6 +83,8 @@ const ALL_SCRIPTS = {
   // Core feature scripts (linked to FEATURES)
   'agileflow-welcome.js': { feature: 'sessionstart', required: true },
   'precompact-context.sh': { feature: 'precompact', required: true },
+  'ralph-loop.js': { feature: 'ralphloop', required: true },
+  'auto-self-improve.js': { feature: 'selfimprove', required: true },
   'archive-completed-stories.sh': { feature: 'archival', required: true },
   'agileflow-statusline.sh': { feature: 'statusline', required: true },
 
@@ -119,25 +122,25 @@ const STATUSLINE_COMPONENTS = [
 
 const PROFILES = {
   full: {
-    description: 'All features enabled',
-    enable: ['sessionstart', 'precompact', 'archival', 'statusline'],
+    description: 'All features enabled (including experimental Stop hooks)',
+    enable: ['sessionstart', 'precompact', 'archival', 'statusline', 'ralphloop', 'selfimprove'],
     archivalDays: 30,
   },
   basic: {
     description: 'Essential hooks + archival (SessionStart + PreCompact + Archival)',
     enable: ['sessionstart', 'precompact', 'archival'],
-    disable: ['statusline'],
+    disable: ['statusline', 'ralphloop', 'selfimprove'],
     archivalDays: 30,
   },
   minimal: {
     description: 'SessionStart + archival only',
     enable: ['sessionstart', 'archival'],
-    disable: ['precompact', 'statusline'],
+    disable: ['precompact', 'statusline', 'ralphloop', 'selfimprove'],
     archivalDays: 30,
   },
   none: {
     description: 'Disable all AgileFlow features',
-    disable: ['sessionstart', 'precompact', 'archival', 'statusline'],
+    disable: ['sessionstart', 'precompact', 'archival', 'statusline', 'ralphloop', 'selfimprove'],
   },
 };
 
@@ -208,6 +211,8 @@ function detectConfig() {
     features: {
       sessionstart: { enabled: false, valid: true, issues: [], version: null, outdated: false },
       precompact: { enabled: false, valid: true, issues: [], version: null, outdated: false },
+      ralphloop: { enabled: false, valid: true, issues: [], version: null, outdated: false },
+      selfimprove: { enabled: false, valid: true, issues: [], version: null, outdated: false },
       archival: { enabled: false, threshold: null, version: null, outdated: false },
       statusline: { enabled: false, valid: true, issues: [], version: null, outdated: false },
     },
@@ -276,7 +281,23 @@ function detectConfig() {
           }
         }
 
-        // Note: Stop hook removed due to reliability issues
+        // Stop hooks (ralphloop and selfimprove)
+        if (settings.hooks.Stop) {
+          if (Array.isArray(settings.hooks.Stop) && settings.hooks.Stop.length > 0) {
+            const hook = settings.hooks.Stop[0];
+            if (hook.matcher !== undefined && hook.hooks) {
+              // Check for each Stop hook feature
+              for (const h of hook.hooks) {
+                if (h.command?.includes('ralph-loop')) {
+                  status.features.ralphloop.enabled = true;
+                }
+                if (h.command?.includes('auto-self-improve')) {
+                  status.features.selfimprove.enabled = true;
+                }
+              }
+            }
+          }
+        }
       }
 
       // StatusLine
@@ -370,6 +391,8 @@ function printStatus(status) {
 
   printFeature('sessionstart', 'SessionStart Hook');
   printFeature('precompact', 'PreCompact Hook');
+  printFeature('ralphloop', 'RalphLoop (Stop)');
+  printFeature('selfimprove', 'SelfImprove (Stop)');
 
   const arch = status.features.archival;
   log(
@@ -417,9 +440,9 @@ function migrateSettings() {
 
   let migrated = false;
 
-  // Migrate hooks (Stop hook removed due to reliability issues)
+  // Migrate hooks to new format
   if (settings.hooks) {
-    ['SessionStart', 'PreCompact', 'UserPromptSubmit'].forEach(hookName => {
+    ['SessionStart', 'PreCompact', 'UserPromptSubmit', 'Stop'].forEach(hookName => {
       const hook = settings.hooks[hookName];
       if (!hook) return;
 
@@ -556,16 +579,45 @@ function enableFeature(feature, options = {}) {
       return false;
     }
 
-    // Configure hook
-    const command = config.type === 'node' ? `node ${scriptPath}` : `bash ${scriptPath}`;
+    // Use absolute path so hooks work from any subdirectory
+    const absoluteScriptPath = path.join(process.cwd(), scriptPath);
+
+    // Stop hooks use error suppression to avoid blocking Claude
+    const isStoHook = config.hook === 'Stop';
+    const command =
+      config.type === 'node'
+        ? `node ${absoluteScriptPath}${isStoHook ? ' 2>/dev/null || true' : ''}`
+        : `bash ${absoluteScriptPath}${isStoHook ? ' 2>/dev/null || true' : ''}`;
+
+    if (isStoHook) {
+      // Stop hooks stack - add to existing hooks instead of replacing
+      if (!settings.hooks.Stop) {
+        settings.hooks.Stop = [{ matcher: '', hooks: [] }];
+      } else if (!Array.isArray(settings.hooks.Stop) || settings.hooks.Stop.length === 0) {
+        settings.hooks.Stop = [{ matcher: '', hooks: [] }];
+      } else if (!settings.hooks.Stop[0].hooks) {
+        settings.hooks.Stop[0].hooks = [];
+      }
+
+      // Check if this script is already added
+      const hasHook = settings.hooks.Stop[0].hooks.some(h => h.command?.includes(config.script));
 
-    settings.hooks[config.hook] = [
-      {
-        matcher: '',
-        hooks: [{ type: 'command', command }],
-      },
-    ];
-    success(`${config.hook} hook enabled (${config.script})`);
+      if (!hasHook) {
+        settings.hooks.Stop[0].hooks.push({ type: 'command', command });
+        success(`Stop hook added (${config.script})`);
+      } else {
+        info(`${feature} already enabled`);
+      }
+    } else {
+      // Other hooks (SessionStart, PreCompact) replace entirely
+      settings.hooks[config.hook] = [
+        {
+          matcher: '',
+          hooks: [{ type: 'command', command }],
+        },
+      ];
+      success(`${config.hook} hook enabled (${config.script})`);
+    }
   }
 
   // Handle archival
@@ -579,7 +631,8 @@ function enableFeature(feature, options = {}) {
       return false;
     }
 
-    // Add to SessionStart hook
+    // Use absolute path so hooks work from any subdirectory
+    const absoluteScriptPath = path.join(process.cwd(), scriptPath);
     if (settings.hooks.SessionStart?.[0]?.hooks) {
       const hasArchival = settings.hooks.SessionStart[0].hooks.some(h =>
         h.command?.includes('archive-completed-stories')
@@ -587,7 +640,7 @@ function enableFeature(feature, options = {}) {
       if (!hasArchival) {
         settings.hooks.SessionStart[0].hooks.push({
           type: 'command',
-          command: `bash ${scriptPath} --quiet`,
+          command: `bash ${absoluteScriptPath} --quiet`,
         });
       }
     }
@@ -607,9 +660,11 @@ function enableFeature(feature, options = {}) {
       return false;
     }
 
+    // Use absolute path so hooks work from any subdirectory
+    const absoluteScriptPath = path.join(process.cwd(), scriptPath);
     settings.statusLine = {
       type: 'command',
-      command: `bash ${scriptPath}`,
+      command: `bash ${absoluteScriptPath}`,
       padding: 0,
     };
     success('Status line enabled');
@@ -656,8 +711,28 @@ function disableFeature(feature) {
 
   // Disable hook
   if (config.hook && settings.hooks?.[config.hook]) {
-    delete settings.hooks[config.hook];
-    success(`${config.hook} hook disabled`);
+    if (config.hook === 'Stop') {
+      // Stop hooks stack - remove only this script, not the entire hook
+      if (settings.hooks.Stop?.[0]?.hooks) {
+        const before = settings.hooks.Stop[0].hooks.length;
+        settings.hooks.Stop[0].hooks = settings.hooks.Stop[0].hooks.filter(
+          h => !h.command?.includes(config.script)
+        );
+        const after = settings.hooks.Stop[0].hooks.length;
+
+        if (before > after) {
+          success(`Stop hook removed (${config.script})`);
+        }
+
+        // If no more Stop hooks, remove the entire Stop hook
+        if (settings.hooks.Stop[0].hooks.length === 0) {
+          delete settings.hooks.Stop;
+        }
+      }
+    } else {
+      delete settings.hooks[config.hook];
+      success(`${config.hook} hook disabled`);
+    }
   }
 
   // Disable archival
@@ -951,9 +1026,11 @@ function showVersionInfo() {
       const installed = installedVersion.split('.').map(Number);
       const latest = latestVersion.split('.').map(Number);
 
-      if (latest[0] > installed[0] ||
-          (latest[0] === installed[0] && latest[1] > installed[1]) ||
-          (latest[0] === installed[0] && latest[1] === installed[1] && latest[2] > installed[2])) {
+      if (
+        latest[0] > installed[0] ||
+        (latest[0] === installed[0] && latest[1] > installed[1]) ||
+        (latest[0] === installed[0] && latest[1] === installed[1] && latest[2] > installed[2])
+      ) {
         log('\n🔄 Update available! Run: npx agileflow update', c.yellow);
       }
     }
@@ -1142,8 +1219,8 @@ ${c.cyan}Usage:${c.reset}
   node .agileflow/scripts/agileflow-configure.js [options]
 
 ${c.cyan}Profiles:${c.reset}
-  --profile=full      All features (hooks, archival, statusline)
-  --profile=basic     SessionStart + PreCompact + archival
+  --profile=full      All features (hooks, Stop hooks, archival, statusline)
+  --profile=basic     SessionStart + PreCompact + archival (no Stop hooks)
   --profile=minimal   SessionStart + archival only
   --profile=none      Disable all AgileFlow features
 
@@ -1151,7 +1228,9 @@ ${c.cyan}Feature Control:${c.reset}
   --enable=<list>     Enable features (comma-separated)
   --disable=<list>    Disable features (comma-separated)
 
-  Features: sessionstart, precompact, archival, statusline
+  Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline
+
+  Stop hooks (ralphloop, selfimprove) run when Claude completes/pauses
 
 ${c.cyan}Statusline Components:${c.reset}
   --show=<list>       Show statusline components (comma-separated)
@@ -1273,8 +1352,7 @@ function main() {
     else if (arg.startsWith('--repair=')) {
       repair = true;
       repairFeature = arg.split('=')[1].trim().toLowerCase();
-    }
-    else if (arg === '--version' || arg === '-v') showVersion = true;
+    } else if (arg === '--version' || arg === '-v') showVersion = true;
     else if (arg === '--list-scripts' || arg === '--scripts') listScriptsMode = true;
   });
 

package/scripts/agileflow-statusline.sh

@@ -29,7 +29,7 @@ MAGENTA="\033[35m"
 CYAN="\033[36m"
 WHITE="\033[37m"
 
-# Bright foreground colors
+# Bright foreground colors (standard ANSI)
 BRIGHT_RED="\033[91m"
 BRIGHT_GREEN="\033[92m"
 BRIGHT_YELLOW="\033[93m"
@@ -37,9 +37,74 @@ BRIGHT_BLUE="\033[94m"
 BRIGHT_MAGENTA="\033[95m"
 BRIGHT_CYAN="\033[96m"
 
+# 256-color palette (vibrant modern colors from cc-statusline)
+# Use these for context/session indicators for better visibility
+CTX_GREEN="\033[38;5;158m"      # Mint green - healthy context
+CTX_YELLOW="\033[38;5;215m"     # Peach - moderate usage
+CTX_ORANGE="\033[38;5;215m"     # Peach/orange - high usage
+CTX_RED="\033[38;5;203m"        # Coral red - critical
+
+SESSION_GREEN="\033[38;5;194m"  # Light green - plenty of time
+SESSION_YELLOW="\033[38;5;228m" # Light yellow - getting low
+SESSION_RED="\033[38;5;210m"    # Light pink/red - critical
+
 # Brand color (burnt orange #e8683a = RGB 232,104,58)
 BRAND="\033[38;2;232;104;58m"
 
+# ============================================================================
+# Helper Functions
+# ============================================================================
+
+# Progress bar with custom characters: ▓ (filled) ░ (empty)
+# Usage: progress_bar <percent> <width>
+# Example: progress_bar 75 10 → "▓▓▓▓▓▓▓░░░"
+progress_bar() {
+  local pct="${1:-0}"
+  local width="${2:-10}"
+
+  # Validate and clamp percentage
+  [[ "$pct" =~ ^[0-9]+$ ]] || pct=0
+  ((pct < 0)) && pct=0
+  ((pct > 100)) && pct=100
+
+  local filled=$(( pct * width / 100 ))
+  local empty=$(( width - filled ))
+
+  # Build bar with custom characters
+  local bar=""
+  for ((i=0; i<filled; i++)); do bar+="▓"; done
+  for ((i=0; i<empty; i++)); do bar+="░"; done
+
+  echo "$bar"
+}
+
+# Convert ISO timestamp to epoch seconds (cross-platform)
+to_epoch() {
+  local ts="$1"
+  # Try gdate first (macOS with coreutils)
+  if command -v gdate >/dev/null 2>&1; then
+    gdate -d "$ts" +%s 2>/dev/null && return
+  fi
+  # Try BSD date (macOS)
+  date -u -j -f "%Y-%m-%dT%H:%M:%S%z" "${ts/Z/+0000}" +%s 2>/dev/null && return
+  # Fallback to Python
+  python3 - "$ts" <<'PY' 2>/dev/null
+import sys, datetime
+s=sys.argv[1].replace('Z','+00:00')
+print(int(datetime.datetime.fromisoformat(s).timestamp()))
+PY
+}
+
+# Format epoch to HH:MM
+fmt_time_hm() {
+  local epoch="$1"
+  if date -r 0 +%s >/dev/null 2>&1; then
+    date -r "$epoch" +"%H:%M"
+  else
+    date -d "@$epoch" +"%H:%M"
+  fi
+}
+
 # ============================================================================
 # Read Component Configuration
 # ============================================================================
@@ -50,6 +115,8 @@ SHOW_STORY=true
 SHOW_EPIC=true
 SHOW_WIP=true
 SHOW_CONTEXT=true
+SHOW_CONTEXT_BAR=true
+SHOW_SESSION_TIME=true
 SHOW_COST=true
 SHOW_GIT=true
 
@@ -65,6 +132,8 @@ if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
     SHOW_EPIC=$(echo "$COMPONENTS" | jq -r '.epic | if . == null then true else . end')
     SHOW_WIP=$(echo "$COMPONENTS" | jq -r '.wip | if . == null then true else . end')
     SHOW_CONTEXT=$(echo "$COMPONENTS" | jq -r '.context | if . == null then true else . end')
+    SHOW_CONTEXT_BAR=$(echo "$COMPONENTS" | jq -r '.context_bar | if . == null then true else . end')
+    SHOW_SESSION_TIME=$(echo "$COMPONENTS" | jq -r '.session_time | if . == null then true else . end')
     SHOW_COST=$(echo "$COMPONENTS" | jq -r '.cost | if . == null then true else . end')
     SHOW_GIT=$(echo "$COMPONENTS" | jq -r '.git | if . == null then true else . end')
   fi
@@ -132,24 +201,29 @@ CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size // 200
 USAGE=$(echo "$input" | jq '.context_window.current_usage // null')
 
 CTX_DISPLAY=""
-CTX_COLOR="$GREEN"
+CTX_BAR_DISPLAY=""
+CTX_COLOR="$CTX_GREEN"
 if [ "$USAGE" != "null" ]; then
   CURRENT_TOKENS=$(echo "$USAGE" | jq '.input_tokens + (.cache_creation_input_tokens // 0) + (.cache_read_input_tokens // 0)')
   if [ "$CURRENT_TOKENS" != "null" ] && [ "$CURRENT_TOKENS" -gt 0 ] 2>/dev/null; then
     PERCENT_USED=$((CURRENT_TOKENS * 100 / CONTEXT_SIZE))
 
-    # Color based on usage level
+    # Color based on usage level (using vibrant 256-color palette)
     if [ "$PERCENT_USED" -ge 80 ]; then
-      CTX_COLOR="$BRIGHT_RED"
+      CTX_COLOR="$CTX_RED"      # Coral red - critical
     elif [ "$PERCENT_USED" -ge 60 ]; then
-      CTX_COLOR="$YELLOW"
+      CTX_COLOR="$CTX_ORANGE"   # Peach - high usage
     elif [ "$PERCENT_USED" -ge 40 ]; then
-      CTX_COLOR="$BRIGHT_YELLOW"
+      CTX_COLOR="$CTX_YELLOW"   # Peach - moderate
     else
-      CTX_COLOR="$GREEN"
+      CTX_COLOR="$CTX_GREEN"    # Mint green - healthy
     fi
 
     CTX_DISPLAY="${CTX_COLOR}${PERCENT_USED}%${RESET}"
+
+    # Generate progress bar (8 chars wide for compactness)
+    CTX_BAR=$(progress_bar "$PERCENT_USED" 8)
+    CTX_BAR_DISPLAY="${DIM}[${RESET}${CTX_COLOR}${CTX_BAR}${RESET}${DIM}]${RESET}"
   fi
 fi
 
@@ -166,6 +240,67 @@ if [ "$TOTAL_COST" != "0" ] && [ "$TOTAL_COST" != "null" ]; then
   fi
 fi
 
+# ============================================================================
+# Session Time Remaining (via ccusage if available)
+# ============================================================================
+SESSION_DISPLAY=""
+if [ "$SHOW_SESSION_TIME" = "true" ]; then
+  # Try to get session info from ccusage (fast cached check)
+  if command -v npx >/dev/null 2>&1 && command -v jq >/dev/null 2>&1; then
+    # Use timeout to prevent blocking - ccusage should be fast
+    BLOCKS_OUTPUT=$(timeout 3 npx ccusage@latest blocks --json 2>/dev/null || true)
+
+    if [ -n "$BLOCKS_OUTPUT" ]; then
+      ACTIVE_BLOCK=$(echo "$BLOCKS_OUTPUT" | jq -c '.blocks[] | select(.isActive == true)' 2>/dev/null | head -n1)
+
+      if [ -n "$ACTIVE_BLOCK" ]; then
+        # Get reset time
+        RESET_TIME_STR=$(echo "$ACTIVE_BLOCK" | jq -r '.usageLimitResetTime // .endTime // empty')
+        START_TIME_STR=$(echo "$ACTIVE_BLOCK" | jq -r '.startTime // empty')
+
+        if [ -n "$RESET_TIME_STR" ] && [ -n "$START_TIME_STR" ]; then
+          START_SEC=$(to_epoch "$START_TIME_STR")
+          END_SEC=$(to_epoch "$RESET_TIME_STR")
+          NOW_SEC=$(date +%s)
+
+          if [ -n "$START_SEC" ] && [ -n "$END_SEC" ] && [ "$START_SEC" -gt 0 ] && [ "$END_SEC" -gt 0 ]; then
+            TOTAL=$(( END_SEC - START_SEC ))
+            [ "$TOTAL" -lt 1 ] && TOTAL=1
+
+            ELAPSED=$(( NOW_SEC - START_SEC ))
+            [ "$ELAPSED" -lt 0 ] && ELAPSED=0
+            [ "$ELAPSED" -gt "$TOTAL" ] && ELAPSED=$TOTAL
+
+            SESSION_PCT=$(( ELAPSED * 100 / TOTAL ))
+            REMAINING=$(( END_SEC - NOW_SEC ))
+            [ "$REMAINING" -lt 0 ] && REMAINING=0
+
+            # Format remaining time
+            RH=$(( REMAINING / 3600 ))
+            RM=$(( (REMAINING % 3600) / 60 ))
+
+            # Color based on time remaining (using vibrant 256-color palette)
+            if [ "$RH" -eq 0 ] && [ "$RM" -lt 30 ]; then
+              SESSION_COLOR="$SESSION_RED"     # Light pink - critical
+            elif [ "$RH" -eq 0 ]; then
+              SESSION_COLOR="$SESSION_YELLOW"  # Light yellow - getting low
+            else
+              SESSION_COLOR="$SESSION_GREEN"   # Light green - plenty of time
+            fi
+
+            # Build compact display: "⏱2h15m" or "⏱45m"
+            if [ "$RH" -gt 0 ]; then
+              SESSION_DISPLAY="${SESSION_COLOR}⏱${RH}h${RM}m${RESET}"
+            else
+              SESSION_DISPLAY="${SESSION_COLOR}⏱${RM}m${RESET}"
+            fi
+          fi
+        fi
+      fi
+    fi
+  fi
+fi
+
 # ============================================================================
 # AgileFlow Status - Read from status.json
 # ============================================================================
@@ -334,10 +469,21 @@ if [ "$SHOW_WIP" = "true" ] && [ -n "$WIP_DISPLAY" ]; then
   OUTPUT="${OUTPUT}${WIP_DISPLAY}"
 fi
 
-# Add context usage (if enabled)
+# Add context usage (if enabled) - percentage and/or bar
 if [ "$SHOW_CONTEXT" = "true" ] && [ -n "$CTX_DISPLAY" ]; then
   [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
-  OUTPUT="${OUTPUT}${CTX_DISPLAY}"
+  if [ "$SHOW_CONTEXT_BAR" = "true" ] && [ -n "$CTX_BAR_DISPLAY" ]; then
+    # Show both percentage and bar: "45% [▓▓▓▓░░░░]"
+    OUTPUT="${OUTPUT}${CTX_DISPLAY} ${CTX_BAR_DISPLAY}"
+  else
+    OUTPUT="${OUTPUT}${CTX_DISPLAY}"
+  fi
+fi
+
+# Add session time remaining (if enabled and available)
+if [ "$SHOW_SESSION_TIME" = "true" ] && [ -n "$SESSION_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${SESSION_DISPLAY}"
 fi
 
 # Add cost (if enabled)