agileflow 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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-124-blue)](https://docs.agileflow.projectquestorg.com/docs/commands)
+[![Agents/Experts](https://img.shields.io/badge/agents%2Fexperts-111-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) | 124 | Slash commands for agile workflows |
+| [Agents/Experts](https://docs.agileflow.projectquestorg.com/docs/agents) | 111 | 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.0",
   "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/claude-tmux.sh

@@ -112,6 +112,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 +122,14 @@ 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+b            Scroll mode (browse history)
+  Alt+h            Show keybind help panel
 EOF
   exit 0
 fi
@@ -186,19 +192,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 +252,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 +331,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,8 +347,39 @@ 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
+  # Alt+b to enter copy mode (for scrolling / browsing history)
+  # NOTE: Do NOT use Alt+[ here — \e[ is the CSI prefix for arrow keys and
+  # function keys. Binding M-[ in the root table causes accidental copy-mode
+  # entry whenever an escape sequence is split by network latency, making the
+  # terminal appear to "lose focus" until Escape is pressed.
+  tmux bind-key -n M-b copy-mode
+
+  # Disable ALL command-prompt bindings in copy mode — they open a text input
+  # in the status bar which intercepts keystrokes and confuses the workflow.
+  # Navigation (arrows, scroll, mouse, PgUp/PgDn) and exit (q/Escape) still work.
+  #
+  # Emacs copy-mode: goto-line, search, jump-to-char, repeat-count
+  tmux unbind-key -T copy-mode g
+  tmux unbind-key -T copy-mode C-r
+  tmux unbind-key -T copy-mode C-s
+  tmux unbind-key -T copy-mode f
+  tmux unbind-key -T copy-mode F
+  tmux unbind-key -T copy-mode t
+  tmux unbind-key -T copy-mode T
+  for i in 1 2 3 4 5 6 7 8 9; do
+    tmux unbind-key -T copy-mode "M-$i"
+  done
+  # Vi copy-mode: goto-line, search, jump-to-char, repeat-count
+  tmux unbind-key -T copy-mode-vi :
+  tmux unbind-key -T copy-mode-vi /
+  tmux unbind-key -T copy-mode-vi ?
+  tmux unbind-key -T copy-mode-vi f
+  tmux unbind-key -T copy-mode-vi F
+  tmux unbind-key -T copy-mode-vi t
+  tmux unbind-key -T copy-mode-vi T
+  for i in 1 2 3 4 5 6 7 8 9; do
+    tmux unbind-key -T copy-mode-vi "$i"
+  done
 
   # ─── Session Creation Keybindings ──────────────────────────────────────────
   # Alt+s to create a new Claude window (starts fresh, future re-runs in same pane resume)
@@ -335,11 +388,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 +425,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,11 +434,11 @@ 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+b      Scroll mode\\n';\
     printf '  Alt+k      Unfreeze (Ctrl+C x2)\\n';\
     printf '  Alt+h      This help\\n';\
     printf '\\n';\
@@ -378,6 +452,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 +732,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

package/scripts/claude-watchdog.sh

@@ -0,0 +1,225 @@
+#!/bin/bash
+# claude-watchdog.sh - Background watchdog that detects and kills frozen Claude processes
+#
+# Usage: claude-watchdog.sh <session-name>
+#
+# Runs in the background, checking every WATCHDOG_INTERVAL seconds for Claude
+# processes that appear frozen. A process is considered frozen when ALL of:
+#   1. Running for > WATCHDOG_MAX_AGE_HOURS hours
+#   2. Using > WATCHDOG_MAX_MEMORY_MB megabytes of RSS
+#   3. No JSONL file modification in > WATCHDOG_MAX_IDLE_MINUTES minutes
+#
+# Recovery sequence: Ctrl+C x2 (5s wait) → SIGTERM (5s wait) → SIGKILL
+# After kill, the pane stays open with a shell prompt (tab is NOT closed).
+#
+# Logs kills to ~/.claude/watchdog.log
+#
+# Environment variable configuration:
+#   WATCHDOG_INTERVAL           Check interval in seconds (default: 120)
+#   WATCHDOG_MAX_AGE_HOURS      Minimum process age to consider (default: 6)
+#   WATCHDOG_MAX_MEMORY_MB      Minimum RSS in MB to consider (default: 400)
+#   WATCHDOG_MAX_IDLE_MINUTES   Minutes since last JSONL write (default: 60)
+#
+# NOTE: Linux-only (requires /proc filesystem and GNU ps). macOS not supported.
+
+set -euo pipefail
+
+SESSION_NAME="${1:-}"
+if [ -z "$SESSION_NAME" ]; then
+  echo "Usage: claude-watchdog.sh <session-name>" >&2
+  exit 1
+fi
+
+# Configuration (all overridable via environment)
+INTERVAL="${WATCHDOG_INTERVAL:-120}"
+MAX_AGE_HOURS="${WATCHDOG_MAX_AGE_HOURS:-6}"
+MAX_MEMORY_MB="${WATCHDOG_MAX_MEMORY_MB:-400}"
+MAX_IDLE_MINUTES="${WATCHDOG_MAX_IDLE_MINUTES:-60}"
+
+# Validate numeric configuration
+for _var_name in INTERVAL MAX_AGE_HOURS MAX_MEMORY_MB MAX_IDLE_MINUTES; do
+  _var_val="${!_var_name}"
+  if ! [[ "$_var_val" =~ ^[0-9]+$ ]]; then
+    echo "ERROR: $_var_name must be a positive integer, got: '$_var_val'" >&2
+    exit 1
+  fi
+done
+
+LOG_FILE="$HOME/.claude/watchdog.log"
+mkdir -p "$(dirname "$LOG_FILE")"
+
+log() {
+  local timestamp
+  timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+  echo "[$timestamp] [watchdog:$SESSION_NAME] $*" >> "$LOG_FILE"
+}
+
+log "Started (interval=${INTERVAL}s, max_age=${MAX_AGE_HOURS}h, max_mem=${MAX_MEMORY_MB}MB, max_idle=${MAX_IDLE_MINUTES}m)"
+
+# Clean exit when session is destroyed
+cleanup() {
+  log "Stopping (session gone or signal received)" || true
+  exit 0
+}
+trap cleanup INT TERM
+
+# Check if a process's JSONL files have been modified recently
+# Returns 0 if idle (no recent writes), 1 if active
+is_process_idle() {
+  local pid="$1"
+  local idle_minutes="$2"
+
+  # Find the working directory of the process to locate .claude/ project dirs
+  local cwd
+  cwd=$(readlink "/proc/$pid/cwd" 2>/dev/null) || return 1
+
+  # Build the project path Claude Code uses for JSONL session files
+  local proj_dir
+  proj_dir=$(echo "$cwd" | sed 's|/|-|g' | sed 's|^-||')
+  local sessions_dir="$HOME/.claude/projects/-$proj_dir"
+
+  if [ ! -d "$sessions_dir" ]; then
+    # No session dir means no activity tracking — assume idle
+    return 0
+  fi
+
+  # Check if any JSONL file was modified within idle_minutes
+  local recent_file
+  recent_file=$(find "$sessions_dir" -name '*.jsonl' -mmin "-$idle_minutes" -print -quit 2>/dev/null)
+
+  if [ -n "$recent_file" ]; then
+    # Recently modified — process is active
+    return 1
+  fi
+
+  # No recent modifications — process is idle
+  return 0
+}
+
+# Get process RSS in MB (Linux /proc-based, ps fallback)
+get_rss_mb() {
+  local pid="$1"
+  local rss_kb
+  if [ -f "/proc/$pid/status" ]; then
+    rss_kb=$(awk '/^VmRSS:/ { print $2 }' "/proc/$pid/status" 2>/dev/null) || return 1
+    [ -z "$rss_kb" ] && return 1  # process died between stat and read
+    echo $(( rss_kb / 1024 ))
+  else
+    rss_kb=$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ') || return 1
+    [ -z "$rss_kb" ] && return 1
+    echo $(( rss_kb / 1024 ))
+  fi
+}
+
+# Get process age in hours
+get_age_hours() {
+  local pid="$1"
+  local elapsed_seconds
+  elapsed_seconds=$(ps -o etimes= -p "$pid" 2>/dev/null | tr -d ' ') || return 1
+  [ -z "$elapsed_seconds" ] && return 1
+  echo $(( elapsed_seconds / 3600 ))
+}
+
+# Gracefully kill a frozen process with escalating signals
+kill_frozen_process() {
+  local pid="$1"
+  local pane_id="$2"
+  local age_h="$3"
+  local mem_mb="$4"
+
+  log "FROZEN DETECTED: PID=$pid pane=$pane_id age=${age_h}h mem=${mem_mb}MB"
+  log "Recovery: sending Ctrl+C x2 to pane $pane_id"
+
+  # Step 1: Try Ctrl+C twice via tmux (gentlest approach)
+  tmux send-keys -t "$pane_id" C-c 2>/dev/null || true
+  sleep 1
+  tmux send-keys -t "$pane_id" C-c 2>/dev/null || true
+  sleep 4
+
+  # Check if process is still alive
+  if ! kill -0 "$pid" 2>/dev/null; then
+    log "Process $pid terminated after Ctrl+C"
+    return 0
+  fi
+
+  # Step 2: SIGTERM
+  log "Recovery: sending SIGTERM to PID $pid"
+  kill -TERM "$pid" 2>/dev/null || true
+  sleep 5
+
+  if ! kill -0 "$pid" 2>/dev/null; then
+    log "Process $pid terminated after SIGTERM"
+    return 0
+  fi
+
+  # Step 3: SIGKILL (last resort)
+  log "Recovery: sending SIGKILL to PID $pid"
+  kill -KILL "$pid" 2>/dev/null || true
+  sleep 1
+
+  if ! kill -0 "$pid" 2>/dev/null; then
+    log "Process $pid terminated after SIGKILL"
+  else
+    log "WARNING: Process $pid survived SIGKILL — zombie or kernel issue"
+  fi
+
+  return 0
+}
+
+# Main check loop
+while true; do
+  # Exit if session no longer exists
+  if ! tmux has-session -t "$SESSION_NAME" 2>/dev/null; then
+    log "Session '$SESSION_NAME' no longer exists"
+    break
+  fi
+
+  # Iterate over all panes in the session
+  while IFS= read -r pane_info; do
+    [ -z "$pane_info" ] && continue
+
+    pane_id="${pane_info%% *}"
+    pane_pid="${pane_info#* }"
+
+    # Find claude child processes under this pane's shell
+    # Look for processes whose command contains "claude" under the pane PID
+    while IFS= read -r child_line; do
+      [ -z "$child_line" ] && continue
+
+      child_pid="${child_line%% *}"
+      child_cmd="${child_line#* }"
+
+      # Skip non-claude processes and skip ourselves
+      case "$child_cmd" in
+        *claude-watchdog*|*watchdog*) continue ;;
+        *claude*) ;;  # This is a Claude process — check it
+        *) continue ;;
+      esac
+
+      # Criterion 1: Age check
+      age_h=$(get_age_hours "$child_pid" 2>/dev/null) || continue
+      if [ "$age_h" -lt "$MAX_AGE_HOURS" ]; then
+        continue
+      fi
+
+      # Criterion 2: Memory check
+      mem_mb=$(get_rss_mb "$child_pid" 2>/dev/null) || continue
+      if [ "$mem_mb" -lt "$MAX_MEMORY_MB" ]; then
+        continue
+      fi
+
+      # Criterion 3: Idle check (most important — prevents killing active work)
+      if ! is_process_idle "$child_pid" "$MAX_IDLE_MINUTES"; then
+        # Process has recent JSONL activity — NOT frozen, just long-running
+        continue
+      fi
+
+      # All three criteria met — this process is frozen
+      kill_frozen_process "$child_pid" "$pane_id" "$age_h" "$mem_mb"
+
+    done < <(ps --ppid "$pane_pid" -o pid=,args= 2>/dev/null || true)
+
+  done < <(tmux list-panes -t "$SESSION_NAME" -F '#{pane_id} #{pane_pid}' 2>/dev/null || true)
+
+  sleep "$INTERVAL"
+done

package/scripts/generators/agent-registry.js

@@ -15,6 +15,19 @@ const path = require('path');
 const { extractFrontmatter, normalizeTools } = require('../lib/frontmatter-parser');
 const { getCached, setCached } = require('../../lib/registry-cache');
 
+// Lazy-load model-profiles to avoid circular deps and missing-module crashes
+let _resolveModel;
+function getResolveModel() {
+  if (_resolveModel === undefined) {
+    try {
+      _resolveModel = require('../lib/model-profiles').resolveModel;
+    } catch (_) {
+      _resolveModel = null;
+    }
+  }
+  return _resolveModel;
+}
+
 // Debug mode: set DEBUG_REGISTRY=1 to see why files are skipped
 const DEBUG = process.env.DEBUG_REGISTRY === '1';
 
@@ -110,7 +123,7 @@ async function scanAgents(agentsDir) {
       displayName: frontmatter.name || name,
       description: frontmatter.description || '',
       tools,
-      model: frontmatter.model || 'haiku',
+      model: (getResolveModel() || ((_, fm) => fm || 'haiku'))(null, frontmatter.model),
       color: frontmatter.color || 'blue',
       category: categorizeAgent(name, frontmatter.description || ''),
     });