agileflow 3.3.0 → 3.4.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.4.1] - 2026-03-06
+
+### Added
+- DEPTH=extreme audit mode, CI feedback loops, and DX quick wins
+
+## [3.4.0] - 2026-02-28
+
+### Added
+- Ads audit system, SEO analysis, ultradeep concurrency controls, and domain-first command naming
+
 ## [3.3.0] - 2026-02-24
 
 ### 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-99-blue)](https://docs.agileflow.projectquestorg.com/docs/commands)
-[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-91-orange)](https://docs.agileflow.projectquestorg.com/docs/agents)
+[![Commands](https://img.shields.io/badge/commands-143-blue)](https://docs.agileflow.projectquestorg.com/docs/commands)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-131-orange)](https://docs.agileflow.projectquestorg.com/docs/agents)
 [![Skills](https://img.shields.io/badge/skills-dynamic-purple)](https://docs.agileflow.projectquestorg.com/docs/features/skills)
 
 **AI-driven agile development for Claude Code, Cursor, Windsurf, OpenAI Codex, and more.** Combining Scrum, Kanban, ADRs, and docs-as-code principles into one framework-agnostic system.
@@ -54,9 +54,9 @@ Traditional project management tools create friction between planning and execut
 
 | Component | Count | Description |
 |-----------|-------|-------------|
-| [Commands](https://docs.agileflow.projectquestorg.com/docs/commands) | 99 | Slash commands for agile workflows |
-| [Agents/Experts](https://docs.agileflow.projectquestorg.com/docs/agents) | 91 | Specialized agents with self-improving knowledge bases |
-| [Skills](https://docs.agileflow.projectquestorg.com/docs/features/skills) | Dynamic | Generated on-demand with `/agileflow:skill:create` |
+| [Commands](https://docs.agileflow.projectquestorg.com/docs/commands) | 143 | Slash commands for agile workflows |
+| [Agents/Experts](https://docs.agileflow.projectquestorg.com/docs/agents) | 131 | Specialized agents with self-improving knowledge bases |
+| [Skills](https://docs.agileflow.projectquestorg.com/docs/features/skills) | Dynamic | Browse and install from skills.sh marketplace via `/agileflow:skill:recommend` |
 
 ---
 
@@ -66,7 +66,7 @@ Traditional project management tools create friction between planning and execut
 |---------|-------------|------|
 | Agent Expertise | Self-improving agents that maintain domain knowledge | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/agent-expertise-system) |
 | Agent Teams | Multi-domain expert coordination with quality gates | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/agent-teams) |
-| Skills System | Custom AI prompts that learn from your feedback | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/skills) |
+| Skills System | Browse and install skills from the skills.sh marketplace | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/skills) |
 | Parallel Sessions | Isolated workspaces with boundary protection | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/parallel-sessions) |
 | Loop Mode | Autonomous story execution until epic completion | [Learn more](https://docs.agileflow.projectquestorg.com/docs/features/loop-mode) |
 | AI Council | Three-perspective strategic decision analysis | [Learn more](https://docs.agileflow.projectquestorg.com/docs/commands/council) |

package/lib/skill-loader.js

@@ -126,7 +126,6 @@ function loadSkill(skillDir) {
       path: skillDir,
       hasReferences: fs.existsSync(path.join(skillDir, 'references.md')),
       hasCookbook: fs.existsSync(path.join(skillDir, 'cookbook')),
-      hasMcp: fs.existsSync(path.join(skillDir, '.mcp.json')),
       metadata,
     };
   } catch {

package/package.json

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

package/scripts/agileflow-statusline.sh

@@ -88,6 +88,7 @@ SHOW_SESSION_TIME=false
 SHOW_COST=false
 SHOW_GIT=true
 SHOW_SCALE=true
+SHOW_ULTRADEEP=true
 
 # Check agileflow-metadata.json for component settings
 if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
@@ -106,6 +107,7 @@ if [ -f "docs/00-meta/agileflow-metadata.json" ]; then
     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')
     SHOW_SCALE=$(echo "$COMPONENTS" | jq -r '.scale | if . == null then true else . end')
+    SHOW_ULTRADEEP=$(echo "$COMPONENTS" | jq -r '.ultradeep | if . == null then true else . end')
   fi
 fi
 
@@ -669,6 +671,79 @@ if [ "$SHOW_SCALE" = "true" ] && [ -f "docs/09-agents/session-state.json" ]; the
   fi
 fi
 
+# ============================================================================
+# Ultradeep Audit Progress Detection
+# ============================================================================
+ULTRADEEP_DISPLAY=""
+if [ "$SHOW_ULTRADEEP" = "true" ]; then
+  ULTRADEEP_DIR="docs/09-agents/ultradeep"
+  if [ -d "$ULTRADEEP_DIR" ]; then
+    # Find most recent trace directory by modification time
+    LATEST_TRACE=$(ls -td "$ULTRADEEP_DIR"/*/ 2>/dev/null | head -1)
+    if [ -n "$LATEST_TRACE" ]; then
+      ULTRA_STATUS_FILE="${LATEST_TRACE}_status.json"
+      if [ -f "$ULTRA_STATUS_FILE" ]; then
+        ULTRA_STATUS=$(cat "$ULTRA_STATUS_FILE" 2>/dev/null)
+        ULTRA_AUDIT_TYPE=$(echo "$ULTRA_STATUS" | jq -r '.audit_type // empty' 2>/dev/null)
+        ULTRA_TOTAL=$(echo "$ULTRA_STATUS" | jq -r '.analyzers | length' 2>/dev/null)
+        ULTRA_COMPLETED=$(echo "$ULTRA_STATUS" | jq -r '.completed | length' 2>/dev/null)
+        ULTRA_STARTED=$(echo "$ULTRA_STATUS" | jq -r '.started_at // empty' 2>/dev/null)
+        ULTRA_LAST_CHECKED=$(echo "$ULTRA_STATUS" | jq -r '.last_checked // empty' 2>/dev/null)
+
+        # Validate we got numeric values
+        [[ "$ULTRA_TOTAL" =~ ^[0-9]+$ ]] || ULTRA_TOTAL=0
+        [[ "$ULTRA_COMPLETED" =~ ^[0-9]+$ ]] || ULTRA_COMPLETED=0
+
+        if [ "$ULTRA_TOTAL" -gt 0 ] && [ -n "$ULTRA_AUDIT_TYPE" ]; then
+          # Staleness check: skip if started >60 min ago and no recent activity
+          ULTRA_STALE=false
+          if [ -n "$ULTRA_STARTED" ]; then
+            ULTRA_START_EPOCH=$(to_epoch "$ULTRA_STARTED" 2>/dev/null)
+            ULTRA_NOW=$(date +%s)
+            if [ -n "$ULTRA_START_EPOCH" ] && [ $((ULTRA_NOW - ULTRA_START_EPOCH)) -gt 3600 ]; then
+              # Started over 60 min ago - check last_checked
+              if [ -n "$ULTRA_LAST_CHECKED" ] && [ "$ULTRA_LAST_CHECKED" != "null" ]; then
+                ULTRA_LC_EPOCH=$(to_epoch "$ULTRA_LAST_CHECKED" 2>/dev/null)
+                if [ -n "$ULTRA_LC_EPOCH" ] && [ $((ULTRA_NOW - ULTRA_LC_EPOCH)) -gt 120 ]; then
+                  ULTRA_STALE=true
+                fi
+              else
+                # No last_checked at all and started >60 min ago
+                ULTRA_STALE=true
+              fi
+            fi
+          fi
+
+          if [ "$ULTRA_STALE" = "false" ]; then
+            # Map audit type to color and prefix
+            case "$ULTRA_AUDIT_TYPE" in
+              logic)        ULTRA_COLOR="\033[38;2;122;162;247m"; ULTRA_PREFIX="Logic" ;;
+              security)     ULTRA_COLOR="\033[38;2;247;118;142m"; ULTRA_PREFIX="Sec" ;;
+              performance)  ULTRA_COLOR="\033[38;2;115;218;202m"; ULTRA_PREFIX="Perf" ;;
+              test)         ULTRA_COLOR="\033[38;2;224;175;104m"; ULTRA_PREFIX="Test" ;;
+              completeness) ULTRA_COLOR="\033[38;2;187;154;247m"; ULTRA_PREFIX="Comp" ;;
+              legal)        ULTRA_COLOR="\033[38;2;158;206;106m"; ULTRA_PREFIX="Legal" ;;
+              *)            ULTRA_COLOR="$DIM";                   ULTRA_PREFIX="Audit" ;;
+            esac
+
+            # Build display with progress coloring
+            if [ "$ULTRA_COMPLETED" -eq "$ULTRA_TOTAL" ]; then
+              # All complete - green checkmark
+              ULTRADEEP_DISPLAY="${ULTRA_COLOR}${ULTRA_PREFIX}${RESET} ${GREEN}${ULTRA_COMPLETED}/${ULTRA_TOTAL}✓${RESET}"
+            elif [ "$ULTRA_COMPLETED" -gt 0 ]; then
+              # In progress
+              ULTRADEEP_DISPLAY="${ULTRA_COLOR}${ULTRA_PREFIX}${RESET} ${ULTRA_COLOR}${ULTRA_COMPLETED}/${ULTRA_TOTAL}${RESET}"
+            else
+              # Just started (0 complete) - dim the fraction
+              ULTRADEEP_DISPLAY="${ULTRA_COLOR}${ULTRA_PREFIX}${RESET} ${DIM}${ULTRA_COMPLETED}/${ULTRA_TOTAL}${RESET}"
+            fi
+          fi
+        fi
+      fi
+    fi
+  fi
+fi
+
 # ============================================================================
 # Build Status Line
 # ============================================================================
@@ -759,6 +834,12 @@ if [ "$SHOW_SCALE" = "true" ] && [ -n "$SCALE_DISPLAY" ]; then
   OUTPUT="${OUTPUT}${SCALE_DISPLAY}"
 fi
 
+# Add ultradeep audit progress (if enabled and active)
+if [ "$SHOW_ULTRADEEP" = "true" ] && [ -n "$ULTRADEEP_DISPLAY" ]; then
+  [ -n "$OUTPUT" ] && OUTPUT="${OUTPUT}${SEP}"
+  OUTPUT="${OUTPUT}${ULTRADEEP_DISPLAY}"
+fi
+
 # Session health indicator (next to git branch)
 if [ "$SHOW_SESSION" = "true" ]; then
   SCRIPTS_DIR="$(dirname "$0")"

package/scripts/agileflow-welcome.js

@@ -1320,6 +1320,49 @@ function getExpertiseCountFast(rootDir) {
   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: [] };
@@ -1894,6 +1937,9 @@ function main() {
   }
   _mark('expertise');
 
+  const commandSync = checkCommandSync(rootDir);
+  _mark('cmdSync');
+
   const damageControl = checkDamageControl(rootDir, cache);
   _mark('damageCtl');
 
@@ -2057,6 +2103,21 @@ function main() {
     );
   }
 
+  // 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('');
@@ -2141,6 +2202,24 @@ function main() {
 
   _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 });

package/scripts/claude-tmux.sh

@@ -41,6 +41,7 @@ SHOW_HELP=false
 ATTACH_ONLY=false
 FORCE_NEW=false
 REFRESH_CONFIG=false
+CONFIGURE_SESSION=""
 USE_RESUME=false
 RESUME_SESSION_ID=""
 
@@ -74,6 +75,10 @@ for arg in "$@"; do
       REFRESH_CONFIG=true
       shift
       ;;
+    --configure-session=*)
+      CONFIGURE_SESSION="${arg#*=}"
+      shift
+      ;;
     --help|-h)
       SHOW_HELP=true
       shift
@@ -112,6 +117,7 @@ WINDOWS:
   Alt+n/p          Next/previous window
   Alt+r            Rename window
   Alt+w            Close window
+  Alt+W            Batch close windows (picker)
   Alt+t            Reopen closed window
 
 PANES:
@@ -121,9 +127,13 @@ PANES:
   Alt+z            Zoom/unzoom pane
   Alt+x            Close pane
 
+FREEZE RECOVERY:
+  Alt+k            Send Ctrl+C twice (soft unfreeze)
+  Alt+K            Force kill Claude process (keeps tab)
+  Alt+R            Respawn pane (fresh shell)
+
 OTHER:
-  Alt+[            Scroll mode
-  Alt+k            Send Ctrl+C twice (unfreeze)
+  Alt+h            Show keybind help panel
 EOF
   exit 0
 fi
@@ -186,19 +196,24 @@ build_tab_format() {
   # ── Inactive tab: gray text ─────────────────────────────────────────────
   # "  I:" prefix = 4 visible chars (wide); " I:" = 3 chars (narrow)
   # Width = prefix + pN(name) + 1(space)
-  local i0='#[fg=#8a8a8a]  #I:#{p35:#{=35:window_name}} '
-  local i1='#[fg=#8a8a8a]  #I:#{p22:#{=22:window_name}} '
-  local i2='#[fg=#8a8a8a]  #I:#{p15:#{=15:window_name}} '
-  local i3='#[fg=#8a8a8a] #I:#{p12:#{=12:window_name}} '
-  local i4='#[fg=#8a8a8a] #I:#{p9:#{=9:window_name}} '
-  local i5='#[fg=#8a8a8a] #I:#{p7:#{=7:window_name}} '
-  local i6='#[fg=#8a8a8a] #I:#{p6:#{=6:window_name}} '
-  local i7='#[fg=#8a8a8a] #I:#{p5:#{=5:window_name}} '
-  local i8='#[fg=#8a8a8a] #I:#{p4:#{=4:window_name}} '
-  local i9='#[fg=#8a8a8a] #I:#{p3:#{=3:window_name}} '
-  local i10='#[fg=#8a8a8a] #I:#{p2:#{=2:window_name}} '
-  local i11='#[fg=#8a8a8a] #I:#{p1:#{=1:window_name}} '
-  local i12='#[fg=#8a8a8a] #I '
+  #
+  # Group color support: when @group_color is set on a window (e.g. by
+  # spawn-audit-sessions.js), show a colored dot prefix to visually
+  # identify grouped windows (ULTRADEEP audit tabs in main session).
+  local gc='#{?#{@group_color},#[fg=#{@group_color}]•,}'
+  local i0="${gc}"'#[fg=#8a8a8a]  #I:#{p35:#{=35:window_name}} '
+  local i1="${gc}"'#[fg=#8a8a8a]  #I:#{p22:#{=22:window_name}} '
+  local i2="${gc}"'#[fg=#8a8a8a]  #I:#{p15:#{=15:window_name}} '
+  local i3="${gc}"'#[fg=#8a8a8a] #I:#{p12:#{=12:window_name}} '
+  local i4="${gc}"'#[fg=#8a8a8a] #I:#{p9:#{=9:window_name}} '
+  local i5="${gc}"'#[fg=#8a8a8a] #I:#{p7:#{=7:window_name}} '
+  local i6="${gc}"'#[fg=#8a8a8a] #I:#{p6:#{=6:window_name}} '
+  local i7="${gc}"'#[fg=#8a8a8a] #I:#{p5:#{=5:window_name}} '
+  local i8="${gc}"'#[fg=#8a8a8a] #I:#{p4:#{=4:window_name}} '
+  local i9="${gc}"'#[fg=#8a8a8a] #I:#{p3:#{=3:window_name}} '
+  local i10="${gc}"'#[fg=#8a8a8a] #I:#{p2:#{=2:window_name}} '
+  local i11="${gc}"'#[fg=#8a8a8a] #I:#{p1:#{=1:window_name}} '
+  local i12="${gc}"'#[fg=#8a8a8a] #I '
   local i13='#[fg=#565a6e]#I'
 
   # ── Tier selection: budget = width / windows ─────────────────────────────
@@ -241,6 +256,14 @@ configure_tmux_session() {
   # Enable mouse support
   tmux set-option -t "$target_session" mouse on
 
+  # Reduce escape-time from default 500ms to 10ms.
+  # The default causes two problems:
+  #   1) Arrow keys (which send \e[A etc.) get misinterpreted as Alt+[ if
+  #      there's any delivery delay, accidentally triggering copy-mode.
+  #   2) Pressing Escape in Claude Code has a 500ms lag before tmux forwards it.
+  # 10ms is enough to detect genuine escape sequences on localhost/fast SSH.
+  tmux set-option -t "$target_session" escape-time 10
+
   # Automatically renumber windows when one is closed (no gaps)
   tmux set-option -t "$target_session" renumber-windows on
 
@@ -312,6 +335,9 @@ configure_tmux_session() {
   # Alt+w to close current window (save state for Alt+T restore, then kill)
   tmux bind-key -n M-w confirm-before -p "Close window? (y/n)" "run-shell '\"\$AGILEFLOW_SCRIPTS/tmux-save-closed-window.sh\"' ; kill-window"
 
+  # Alt+W (uppercase) to batch-close windows via multi-select picker
+  tmux bind-key -n M-W display-popup -E -w 60 -h 20 "\"$AGILEFLOW_SCRIPTS/tmux-close-windows.sh\""
+
   # Alt+t to restore the most recently closed window (like Ctrl+Shift+T in browsers)
   tmux bind-key -n M-t run-shell '"$AGILEFLOW_SCRIPTS/tmux-restore-window.sh"'
 
@@ -325,9 +351,6 @@ configure_tmux_session() {
   # Alt+z to zoom/unzoom pane (fullscreen toggle)
   tmux bind-key -n M-z resize-pane -Z
 
-  # Alt+[ to enter copy mode (for scrolling)
-  tmux bind-key -n M-[ copy-mode
-
   # ─── Session Creation Keybindings ──────────────────────────────────────────
   # Alt+s to create a new Claude window (starts fresh, future re-runs in same pane resume)
   # Window gets sequential name (claude-2, claude-3, ...) so windows are distinguishable
@@ -335,11 +358,31 @@ configure_tmux_session() {
 
   # ─── Freeze Recovery Keybindings ───────────────────────────────────────────
   # Alt+k to send Ctrl+C twice (soft interrupt for frozen processes)
-  tmux bind-key -n M-k run-shell "tmux send-keys C-c; sleep 0.5; tmux send-keys C-c"
+  # Uses #{pane_id} to target the correct pane even if focus shifts during the sleep
+  tmux bind-key -n M-k run-shell "tmux send-keys -t '#{pane_id}' C-c; sleep 0.5; tmux send-keys -t '#{pane_id}' C-c"
+
+  # Alt+K (uppercase) to force kill Claude process in pane without closing tab
+  # Finds the claude child process under the pane's shell and kills it,
+  # leaving the shell prompt intact so the user can restart or continue.
+  # Uses ps -o pid=,args= with grep to find claude, then cuts the PID (avoids awk quoting issues in tmux run-shell).
+  tmux bind-key -n M-K run-shell '\
+    PANE_PID=$(tmux display-message -p "#{pane_pid}"); \
+    CLAUDE_PID=$(ps --ppid "$PANE_PID" -o pid=,args= 2>/dev/null | grep -v "watchdog" | grep "claude" | head -1 | sed "s/^[[:space:]]*//" | cut -d" " -f1); \
+    if [ -n "$CLAUDE_PID" ]; then \
+      kill -TERM "$CLAUDE_PID" 2>/dev/null; \
+      sleep 2; \
+      kill -0 "$CLAUDE_PID" 2>/dev/null && kill -KILL "$CLAUDE_PID" 2>/dev/null; \
+      tmux display-message "Killed Claude process (PID $CLAUDE_PID)"; \
+    else \
+      tmux display-message "No Claude process found in this pane"; \
+    fi'
+
+  # Alt+R to respawn pane (kills everything in the pane, starts fresh shell)
+  tmux bind-key -n M-R respawn-pane -k
 
   # ─── Help Panel ──────────────────────────────────────────────────────────
   # Alt+h to show all Alt keybindings in a popup
-  tmux bind-key -n M-h display-popup -E -w 52 -h 31 "\
+  tmux bind-key -n M-h display-popup -E -w 52 -h 32 "\
     printf '\\n';\
     printf '  \\033[1;38;5;208mSESSIONS\\033[0m\\n';\
     printf '  Alt+s      New Claude session\\n';\
@@ -352,6 +395,7 @@ configure_tmux_session() {
     printf '  Alt+n/p    Next / previous window\\n';\
     printf '  Alt+r      Rename window\\n';\
     printf '  Alt+w      Close window\\n';\
+    printf '  Alt+W      Batch close windows\\n';\
     printf '  Alt+t      Reopen closed window\\n';\
     printf '\\n';\
     printf '  \\033[1;38;5;208mPANES\\033[0m\\n';\
@@ -360,17 +404,23 @@ configure_tmux_session() {
     printf '  Alt+arrows Navigate panes\\n';\
     printf '  Alt+z      Zoom / unzoom\\n';\
     printf '  Alt+x      Close pane (confirm)\\n';\
-    printf '  Alt+K      Kill pane (no confirm)\\n';\
-    printf '  Alt+R      Restart pane\\n';\
+    printf '  Alt+K      Force kill process\\n';\
+    printf '  Alt+R      Respawn pane (fresh)\\n';\
     printf '\\n';\
     printf '  \\033[1;38;5;208mOTHER\\033[0m\\n';\
-    printf '  Alt+[      Scroll mode\\n';\
     printf '  Alt+k      Unfreeze (Ctrl+C x2)\\n';\
     printf '  Alt+h      This help\\n';\
     printf '\\n';\
     read -n 1 -s -r -p '  Press any key to close'"
 }
 
+# Handle --configure-session flag — apply theme to a specific session and exit
+# Used by spawn-audit-sessions.js to give audit sessions the same status bar
+if [ -n "$CONFIGURE_SESSION" ]; then
+  configure_tmux_session "$CONFIGURE_SESSION"
+  exit 0
+fi
+
 # Handle --refresh flag — re-apply config to all existing claude-* sessions
 if [ "$REFRESH_CONFIG" = true ]; then
   REFRESHED=0
@@ -378,6 +428,14 @@ if [ "$REFRESH_CONFIG" = true ]; then
     configure_tmux_session "$sid"
     # Ensure AGILEFLOW_SCRIPTS is set (needed by Alt+S keybind)
     tmux set-environment -t "$sid" AGILEFLOW_SCRIPTS "$SCRIPT_DIR" 2>/dev/null || true
+    # (Re)start watchdog if not running for this session
+    _EXISTING_WD=$(tmux show-environment -t "$sid" WATCHDOG_PID 2>/dev/null | cut -d= -f2)
+    if [ -z "$_EXISTING_WD" ] || ! kill -0 "$_EXISTING_WD" 2>/dev/null; then
+      "$SCRIPT_DIR/claude-watchdog.sh" "$sid" &
+      _WD_PID=$!
+      tmux set-environment -t "$sid" WATCHDOG_PID "$_WD_PID"
+      disown "$_WD_PID"
+    fi
     REFRESHED=$((REFRESHED + 1))
   done
   if [ "$REFRESHED" -gt 0 ]; then
@@ -650,6 +708,15 @@ if [ -n "$CLAUDE_SESSION_FLAGS" ]; then
   tmux set-environment -t "$SESSION_NAME" CLAUDE_SESSION_FLAGS "$CLAUDE_SESSION_FLAGS"
 fi
 
+# Start watchdog to auto-detect and kill frozen Claude processes
+EXISTING_WD=$(tmux show-environment -t "$SESSION_NAME" WATCHDOG_PID 2>/dev/null | cut -d= -f2)
+if [ -z "$EXISTING_WD" ] || ! kill -0 "$EXISTING_WD" 2>/dev/null; then
+  "$SCRIPT_DIR/claude-watchdog.sh" "$SESSION_NAME" &
+  _WD_PID=$!
+  tmux set-environment -t "$SESSION_NAME" WATCHDOG_PID "$_WD_PID"
+  disown "$_WD_PID"
+fi
+
 # Pre-seed @claude_uuid on initial pane if we found a recent conversation
 if [ "$USE_RESUME" = true ] && [ -n "$RESUME_SESSION_ID" ]; then
   tmux set-option -p -t "$SESSION_NAME" @claude_uuid "$RESUME_SESSION_ID" 2>/dev/null || true