@walwal-harness/cli 4.0.0-beta.1 → 4.0.0-beta.11

package/bin/init.js

@@ -129,17 +129,56 @@ function scaffoldHarness() {
     }
   }
 
-  // Copy config.json
+  // config.json — ALWAYS update (harness system file, not user data)
+  // But preserve user's custom settings (pre_eval_gate.frontend_cwd, behavior, etc.)
   const configSrc = path.join(PKG_ROOT, 'assets', 'templates', 'config.json');
   const configDest = path.join(HARNESS_DIR, 'config.json');
-  if (fs.existsSync(configSrc) && (!fileExists(configDest) || isForce)) {
-    copyFile(configSrc, configDest);
+  if (fs.existsSync(configSrc)) {
+    if (fileExists(configDest) && !isForce) {
+      // Merge: keep user's customizations, update harness structure
+      try {
+        const existing = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        const template = JSON.parse(fs.readFileSync(configSrc, 'utf8'));
+        // Preserve user customizations
+        const userPreserve = {
+          behavior: existing.behavior,
+          'flow.pre_eval_gate.frontend_cwd': existing?.flow?.pre_eval_gate?.frontend_cwd,
+          'flow.pre_eval_gate.backend_cwd': existing?.flow?.pre_eval_gate?.backend_cwd,
+          'flow.pre_eval_gate.frontend_checks': existing?.flow?.pre_eval_gate?.frontend_checks,
+          'flow.pre_eval_gate.backend_checks': existing?.flow?.pre_eval_gate?.backend_checks,
+        };
+        // Write template, then re-apply user settings
+        fs.writeFileSync(configDest, JSON.stringify(template, null, 2) + '\n');
+        // Re-apply preserved user settings
+        const merged = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        if (userPreserve.behavior) merged.behavior = userPreserve.behavior;
+        if (userPreserve['flow.pre_eval_gate.frontend_cwd']) {
+          merged.flow.pre_eval_gate.frontend_cwd = userPreserve['flow.pre_eval_gate.frontend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_cwd']) {
+          merged.flow.pre_eval_gate.backend_cwd = userPreserve['flow.pre_eval_gate.backend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.frontend_checks']) {
+          merged.flow.pre_eval_gate.frontend_checks = userPreserve['flow.pre_eval_gate.frontend_checks'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_checks']) {
+          merged.flow.pre_eval_gate.backend_checks = userPreserve['flow.pre_eval_gate.backend_checks'];
+        }
+        fs.writeFileSync(configDest, JSON.stringify(merged, null, 2) + '\n');
+        log('config.json updated (user settings preserved)');
+      } catch (e) {
+        copyFile(configSrc, configDest);
+        log('config.json replaced (merge failed)');
+      }
+    } else {
+      copyFile(configSrc, configDest);
+    }
   }
 
-  // Copy HARNESS.md
+  // HARNESS.md — ALWAYS update
   const harnessMdSrc = path.join(PKG_ROOT, 'assets', 'templates', 'HARNESS.md');
   const harnessMdDest = path.join(HARNESS_DIR, 'HARNESS.md');
-  if (fs.existsSync(harnessMdSrc) && (!fileExists(harnessMdDest) || isForce)) {
+  if (fs.existsSync(harnessMdSrc)) {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
@@ -186,6 +225,17 @@ function installSkills() {
     return;
   }
 
+  // harness- 프리픽스 스킬 전체 삭제 후 재복사 — 잔류 방지
+  if (fs.existsSync(CLAUDE_SKILLS_DIR)) {
+    const existing = fs.readdirSync(CLAUDE_SKILLS_DIR, { withFileTypes: true });
+    for (const entry of existing) {
+      if (entry.isDirectory() && entry.name.startsWith('harness-')) {
+        fs.rmSync(path.join(CLAUDE_SKILLS_DIR, entry.name), { recursive: true, force: true });
+      }
+    }
+    log('  Cleared existing harness-* skills');
+  }
+
   const skills = fs.readdirSync(skillsSrc, { withFileTypes: true })
     .filter(d => d.isDirectory())
     .map(d => d.name);
@@ -193,13 +243,8 @@ function installSkills() {
   for (const skill of skills) {
     const src = path.join(skillsSrc, skill);
     const dest = path.join(CLAUDE_SKILLS_DIR, `harness-${skill}`);
-
-    if (!fileExists(dest) || isForce) {
-      copyDir(src, dest);
-      log(`  Installed: harness-${skill}`);
-    } else {
-      log(`  Skipped (exists): harness-${skill}`);
-    }
+    copyDir(src, dest);
+    log(`  Installed: harness-${skill}`);
   }
 
   log('Skills installation complete');
@@ -214,48 +259,28 @@ function installScripts() {
   const scriptsSrc = path.join(PKG_ROOT, 'scripts');
   const scriptsDest = path.join(PROJECT_ROOT, 'scripts');
 
-  // Core scripts are ALWAYS overwritten on update (not user-editable)
-  // These contain harness logic that must stay in sync with the CLI version
-  const coreScripts = new Set([
-    'harness-next.sh',
-    'harness-session-start.sh',
-    'harness-statusline.sh',
-    'harness-user-prompt-submit.sh',
-    'harness-dashboard.sh',
-    'harness-monitor.sh',
-    'harness-eval-watcher.sh',
-    'harness-tmux.sh',
-    'harness-control.sh',
-    'harness-dashboard-v4.sh',
-    'harness-queue-manager.sh',
-  ]);
+  // 전체 삭제 후 재복사 — 버전 간 잔류 파일 방지
+  if (fs.existsSync(scriptsDest)) {
+    fs.rmSync(scriptsDest, { recursive: true, force: true });
+    log('  Cleared existing scripts/');
+  }
 
   if (fs.existsSync(scriptsSrc)) {
-    ensureDir(scriptsDest);
-    const entries = fs.readdirSync(scriptsSrc, { withFileTypes: true });
-    for (const entry of entries) {
-      const srcPath = path.join(scriptsSrc, entry.name);
-      const destPath = path.join(scriptsDest, entry.name);
-      if (entry.isDirectory()) {
-        // lib/ and other subdirectories — always overwrite
-        copyDir(srcPath, destPath);
-        try {
-          const subFiles = fs.readdirSync(destPath);
-          for (const f of subFiles) {
-            if (f.endsWith('.sh')) {
-              fs.chmodSync(path.join(destPath, f), '755');
-            }
-          }
-        } catch (e) {}
-      } else {
-        // Core scripts: always overwrite. Others: skip if exists (unless --force)
-        const isCore = coreScripts.has(entry.name);
-        if (isCore || !fileExists(destPath) || isForce) {
-          copyFile(srcPath, destPath);
-          try { fs.chmodSync(destPath, '755'); } catch (e) {}
+    copyDir(scriptsSrc, scriptsDest);
+
+    // chmod +x for all .sh files (recursive)
+    function chmodRecursive(dir) {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          chmodRecursive(full);
+        } else if (entry.name.endsWith('.sh')) {
+          try { fs.chmodSync(full, '755'); } catch (e) {}
         }
       }
     }
+    chmodRecursive(scriptsDest);
   }
 
   log('Scripts installation complete');
@@ -421,6 +446,28 @@ function installUserPromptSubmitHook() {
 // ─────────────────────────────────────────
 // 4. AGENTS.md + CLAUDE.md
 // ─────────────────────────────────────────
+// ─────────────────────────────────────────
+// 3d. Agent Teams env var
+// ─────────────────────────────────────────
+function installAgentTeamsEnv() {
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  let settings = {};
+  if (fileExists(settingsPath)) {
+    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
+  }
+
+  if (!settings.env) settings.env = {};
+
+  if (settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] !== '1') {
+    settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+    ensureDir(path.dirname(settingsPath));
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    log('Agent Teams enabled (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)');
+  } else {
+    log('Agent Teams already enabled');
+  }
+}
+
 function setupAgentsMd() {
   const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
   const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
@@ -703,6 +750,7 @@ function main() {
   installSessionHook();
   installStatusline();
   installUserPromptSubmitHook();
+  installAgentTeamsEnv();
   setupAgentsMd();
   checkPlaywrightMcp();
   checkRecommendedSkills();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.1",
+  "version": "4.0.0-beta.11",
   "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"
@@ -9,7 +9,9 @@
     "postinstall": "node bin/init.js --auto",
     "init": "node bin/init.js",
     "scan": "bash scripts/scan-project.sh .",
-    "reset": "node bin/init.js --force"
+    "reset": "node bin/init.js --force",
+    "studio": "bash scripts/harness-studio.sh",
+    "studio:kill": "bash scripts/harness-studio.sh --kill"
   },
   "keywords": [
     "harness-engineering",

package/scripts/harness-dashboard-v4.sh

@@ -133,10 +133,55 @@ render_features() {
   done
 }
 
+render_bottleneck_alert() {
+  if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
+
+  local failed_list blocked_count idle_teams in_prog
+  failed_list=$(jq -r '.queue.failed[]' "$QUEUE" 2>/dev/null)
+  blocked_count=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
+  idle_teams=0
+
+  # Count idle teams
+  local team_count
+  team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 0)
+  for i in $(seq 1 "$team_count"); do
+    local ts
+    ts=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
+    if [ "$ts" = "idle" ]; then idle_teams=$((idle_teams + 1)); fi
+  done
+
+  if [ -z "$failed_list" ]; then return; fi
+
+  # Check each failed feature for blocking impact
+  while IFS= read -r fid; do
+    [ -z "$fid" ] && continue
+    # Count how many blocked features depend on this fid
+    local deps_on_this
+    deps_on_this=$(jq --arg fid "$fid" '[.queue.blocked | to_entries[] | select(.value | index($fid))] | length' "$QUEUE" 2>/dev/null || echo 0)
+
+    if [ "$deps_on_this" -gt 0 ]; then
+      echo ""
+      echo -e "  ${RED}${BOLD}⚠ BOTTLENECK${RESET} ${RED}${fid}${RESET} failed → ${YELLOW}${deps_on_this} features blocked${RESET}"
+      if [ "$idle_teams" -gt 0 ]; then
+        echo -e "  ${BOLD}→ requeue:${RESET} bash scripts/harness-queue-manager.sh requeue ${fid} ."
+      fi
+    fi
+  done <<< "$failed_list"
+
+  # All teams idle + nothing in progress = stalled
+  if [ "$idle_teams" -eq "$team_count" ] && [ "$in_prog" -eq 0 ] && [ "$blocked_count" -gt 0 ]; then
+    echo ""
+    echo -e "  ${RED}${BOLD}!! STALLED${RESET} — All teams idle, ${blocked_count} features blocked"
+    echo -e "  ${BOLD}→ requeue failed features or check dependency graph${RESET}"
+  fi
+}
+
 render_all() {
   render_header
   render_queue_summary
   render_teams
+  render_bottleneck_alert
   echo ""
   render_features
 }

package/scripts/harness-monitor.sh

@@ -1,6 +1,9 @@
 #!/bin/bash
-# harness-monitor.sh — Panel 2: Task & Agent Lifecycle 모니터링
-# audit.log 스트리밍 + progress.json 변경 감지
+# harness-monitor.sh — Agent Lifecycle Monitor
+#
+# v3 모드: 단일 이벤트 스트림 (progress.json 변경 감지 + audit.log)
+# v4 모드: 팀별 섹션 분리 (feature-queue.json + progress.log 기반)
+#
 # Usage: bash scripts/harness-monitor.sh [project-root]
 
 set -uo pipefail
@@ -17,8 +20,9 @@ if [ -z "$PROJECT_ROOT" ]; then
 fi
 
 PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+PROGRESS_LOG="$PROJECT_ROOT/.harness/progress.log"
 AUDIT_LOG="$PROJECT_ROOT/.harness/actions/audit.log"
-HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
+QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
 
 # ── ANSI helpers ──
 BOLD="\033[1m"
@@ -28,28 +32,169 @@ YELLOW="\033[33m"
 RED="\033[31m"
 CYAN="\033[36m"
 MAGENTA="\033[35m"
+BLUE="\033[34m"
 RESET="\033[0m"
 
+# ── Team colors ──
+T1_COLOR="$CYAN"
+T2_COLOR="$MAGENTA"
+T3_COLOR="$YELLOW"
+
+team_color() {
+  case "$1" in
+    1|team-1) echo "$T1_COLOR" ;;
+    2|team-2) echo "$T2_COLOR" ;;
+    3|team-3) echo "$T3_COLOR" ;;
+    *)        echo "$DIM" ;;
+  esac
+}
+
+# ══════════════════════════════════════════
+# v4 모드: 팀별 섹션 렌더링
+# ══════════════════════════════════════════
+
+render_v4_header() {
+  echo -e "${BOLD}TEAM MONITOR${RESET}  ${DIM}$(date +%H:%M:%S)${RESET}"
+  echo ""
+}
+
+render_team_section() {
+  local team_num="$1"
+  local color
+  color=$(team_color "$team_num")
+
+  # 팀 상태 from queue
+  local t_status="idle" t_feature="—" t_phase="—" t_attempt=""
+  if [ -f "$QUEUE" ]; then
+    t_status=$(jq -r ".teams[\"$team_num\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
+    t_feature=$(jq -r ".teams[\"$team_num\"].feature // \"—\"" "$QUEUE" 2>/dev/null)
+    if [ "$t_feature" != "—" ] && [ "$t_feature" != "null" ]; then
+      t_phase=$(jq -r --arg f "$t_feature" '.queue.in_progress[$f].phase // "?"' "$QUEUE" 2>/dev/null)
+      t_attempt=$(jq -r --arg f "$t_feature" '.queue.in_progress[$f].attempt // 1' "$QUEUE" 2>/dev/null)
+    fi
+  fi
+
+  # 상태 아이콘
+  local icon="○"
+  case "$t_status" in
+    busy) icon="▶" ;;
+    idle) icon="○" ;;
+  esac
+
+  # Phase 표시
+  local phase_str=""
+  case "$t_phase" in
+    gen)  phase_str="Gen" ;;
+    gate) phase_str="Gate" ;;
+    eval) phase_str="Eval" ;;
+    *)    phase_str="" ;;
+  esac
+
+  # 헤더 라인
+  printf "%b%b T%s%b " "$color" "$icon" "$team_num" "$RESET"
+  if [ "$t_feature" != "—" ] && [ "$t_feature" != "null" ]; then
+    printf "%s " "$t_feature"
+    if [ -n "$phase_str" ]; then
+      printf "%b%s%b" "$color" "$phase_str" "$RESET"
+    fi
+    if [ -n "$t_attempt" ] && [ "$t_attempt" != "—" ] && [ "$t_attempt" != "1" ]; then
+      printf " %b#%s%b" "$DIM" "$t_attempt" "$RESET"
+    fi
+  else
+    printf "%bidle%b" "$DIM" "$RESET"
+  fi
+  echo ""
+
+  # 팀 로그 (progress.log에서 team-N 엔트리만 추출)
+  if [ -f "$PROGRESS_LOG" ]; then
+    grep -i "team-${team_num}\|team_${team_num}" "$PROGRESS_LOG" 2>/dev/null | tail -5 | while IFS= read -r line; do
+      local ts action detail
+      ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
+      action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
+      detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
+
+      local short_ts
+      short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
+
+      if [ ${#detail} -gt 35 ]; then detail="${detail:0:33}.."; fi
+
+      # 액션별 아이콘
+      local a_icon="·" a_color="$DIM"
+      case "$action" in
+        gen)      a_icon="▶"; a_color="$GREEN" ;;
+        eval)     a_icon="✦"; a_color="$BLUE" ;;
+        pass)     a_icon="✓"; a_color="$GREEN" ;;
+        fail)     a_icon="✗"; a_color="$RED" ;;
+        dequeue)  a_icon="→"; a_color="$CYAN" ;;
+        gate)     a_icon="◆"; a_color="$YELLOW" ;;
+        *)        a_icon="·"; a_color="$DIM" ;;
+      esac
+
+      printf "  %b%s%b %b%s%b %b%s%b\n" \
+        "$DIM" "$short_ts" "$RESET" \
+        "$a_color" "$a_icon" "$RESET" \
+        "$DIM" "$detail" "$RESET"
+    done
+  fi
+}
+
+render_v4() {
+  render_v4_header
+
+  # 팀 수 확인
+  local team_count=3
+  if [ -f "$QUEUE" ]; then
+    team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 3)
+  fi
+
+  for i in $(seq 1 "$team_count"); do
+    render_team_section "$i"
+    echo ""
+  done
+
+  # Lead/시스템 이벤트 (team이 아닌 엔트리)
+  echo -e "${BOLD}SYSTEM${RESET}"
+  if [ -f "$PROGRESS_LOG" ]; then
+    grep -v 'team-[0-9]' "$PROGRESS_LOG" 2>/dev/null | grep -v '^#' | grep -v '^$' | tail -5 | while IFS= read -r line; do
+      local ts agent action detail
+      ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
+      agent=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$2); print $2}')
+      action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
+      detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
+
+      local short_ts
+      short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
+
+      if [ ${#detail} -gt 35 ]; then detail="${detail:0:33}.."; fi
+
+      printf "  %b%s%b %s %b%s%b\n" \
+        "$DIM" "$short_ts" "$RESET" \
+        "$agent" \
+        "$DIM" "$detail" "$RESET"
+    done
+  fi
+}
+
+# ══════════════════════════════════════════
+# v3 모드: 단일 스트림 (기존 동작)
+# ══════════════════════════════════════════
+
 LAST_AGENT=""
 LAST_STATUS=""
 LAST_SPRINT=""
-EVENT_COUNT=0
 
 print_event() {
   local ts="$1" icon="$2" color="$3" msg="$4"
-  EVENT_COUNT=$((EVENT_COUNT + 1))
   echo -e "  ${DIM}${ts}${RESET}  ${color}${icon}${RESET}  ${msg}"
 }
 
-# ── Header ──
-print_header() {
+print_v3_header() {
   echo -e "${BOLD}╔══════════════════════════════════════╗${RESET}"
   echo -e "${BOLD}║  AGENT LIFECYCLE MONITOR             ║${RESET}"
   echo -e "${BOLD}╚══════════════════════════════════════╝${RESET}"
   echo ""
 }
 
-# ── Detect agent transitions from progress.json ──
 check_transitions() {
   if [ ! -f "$PROGRESS" ]; then return; fi
 
@@ -61,39 +206,22 @@ check_transitions() {
   local now
   now=$(date +"%H:%M:%S")
 
-  # Sprint change
   if [ "$sprint" != "$LAST_SPRINT" ] && [ -n "$LAST_SPRINT" ]; then
     print_event "$now" ">>>" "$MAGENTA" "${BOLD}Sprint ${sprint} started${RESET}"
     echo ""
   fi
 
-  # Agent change
   if [ "$agent" != "$LAST_AGENT" ] && [ -n "$LAST_AGENT" ]; then
     if [ "$LAST_AGENT" != "none" ] && [ "$LAST_AGENT" != "null" ]; then
       print_event "$now" " ✓ " "$GREEN" "${LAST_AGENT} → ${BOLD}done${RESET}"
     fi
     if [ "$agent" != "none" ] && [ "$agent" != "null" ]; then
       print_event "$now" " ▶ " "$CYAN" "${BOLD}${agent}${RESET} started"
-
-      # Show handoff context if available
-      if [ -f "$HANDOFF" ]; then
-        local from focus
-        from=$(jq -r '.from // empty' "$HANDOFF" 2>/dev/null)
-        focus=$(jq -r '.focus_features // [] | join(", ")' "$HANDOFF" 2>/dev/null)
-        if [ -n "$from" ] && [ "$from" != "null" ]; then
-          echo -e "         ${DIM}handoff from: ${from}${RESET}"
-        fi
-        if [ -n "$focus" ] && [ "$focus" != "null" ]; then
-          echo -e "         ${DIM}focus: ${focus}${RESET}"
-        fi
-      fi
     fi
   fi
 
-  # Status change (same agent)
   if [ "$agent" = "$LAST_AGENT" ] && [ "$status" != "$LAST_STATUS" ] && [ -n "$LAST_STATUS" ]; then
-    local status_color="$RESET"
-    local status_icon="•"
+    local status_color="$RESET" status_icon="•"
     case "$status" in
       running)   status_color="$GREEN";  status_icon=" ▶ " ;;
       completed) status_color="$CYAN";   status_icon=" ✓ " ;;
@@ -103,7 +231,6 @@ check_transitions() {
     esac
     print_event "$now" "$status_icon" "$status_color" "${agent} → ${BOLD}${status}${RESET}"
 
-    # Show failure detail
     if [ "$status" = "failed" ]; then
       local fail_msg
       fail_msg=$(jq -r '.failure.message // empty' "$PROGRESS" 2>/dev/null)
@@ -118,76 +245,84 @@ check_transitions() {
   LAST_SPRINT="$sprint"
 }
 
-# ── Stream audit.log new lines ──
 stream_audit() {
   if [ ! -f "$AUDIT_LOG" ]; then return; fi
-
-  # Use tail -f in background, parse each new line
   tail -n 0 -f "$AUDIT_LOG" 2>/dev/null | while IFS= read -r line; do
-    # Skip comments/headers
     if [[ "$line" == "#"* ]] || [[ -z "$line" ]]; then continue; fi
-
-    # Parse: TIMESTAMP | AGENT | ACTION | STATUS | TARGET | DETAIL
-    local ts agent action status target detail
+    local ts agent action status target
     ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
     agent=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$2); print $2}')
     action=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$3); print $3}')
     status=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
     target=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$5); print $5}')
-    detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$6); print $6}')
 
-    # Color by status
     local color="$RESET" icon="•"
     case "$status" in
-      start)    color="$CYAN";   icon="▶" ;;
-      complete) color="$GREEN";  icon="✓" ;;
-      fail)     color="$RED";    icon="✗" ;;
-      pass)     color="$GREEN";  icon="✓" ;;
-      skip)     color="$DIM";    icon="–" ;;
+      start)    color="$CYAN";  icon="▶" ;;
+      complete) color="$GREEN"; icon="✓" ;;
+      fail)     color="$RED";   icon="✗" ;;
+      pass)     color="$GREEN"; icon="✓" ;;
+      skip)     color="$DIM";   icon="–" ;;
     esac
 
-    # Short timestamp (HH:MM:SS from ISO)
     local short_ts
     short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}:[0-9]{2}' || echo "$ts")
-
-    echo -e "  ${DIM}${short_ts}${RESET}  ${color}${icon}${RESET}  ${BOLD}${agent}${RESET} ${action} ${target} ${DIM}${detail}${RESET}"
+    echo -e "  ${DIM}${short_ts}${RESET}  ${color}${icon}${RESET}  ${BOLD}${agent}${RESET} ${action} ${target}"
   done &
   AUDIT_TAIL_PID=$!
 }
 
-# ── Cleanup ──
+# ══════════════════════════════════════════
+# Mode detection & main loop
+# ══════════════════════════════════════════
+
 cleanup() {
   if [ -n "${AUDIT_TAIL_PID:-}" ]; then
     kill "$AUDIT_TAIL_PID" 2>/dev/null || true
   fi
+  tput cnorm 2>/dev/null
   exit 0
 }
 trap cleanup EXIT INT TERM
 
-# ── Main ──
-print_header
+# 매 루프마다 v4/v3 동적 감지 — 시작 후에도 모드 전환 가능
+tput civis 2>/dev/null
+clear
 
-# Initialize state
-if [ -f "$PROGRESS" ]; then
-  LAST_AGENT=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
-  LAST_STATUS=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
-  LAST_SPRINT=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
-fi
+CURRENT_MODE=""
 
-# Show existing history
-if [ -f "$PROGRESS" ]; then
-  echo -e "  ${BOLD}History${RESET}"
-  jq -r '.history // [] | .[] | "  \(.timestamp)  \(.agent) — \(.action): \(.detail)"' "$PROGRESS" 2>/dev/null
-  echo ""
-  echo -e "  ${DIM}── Live events below ──${RESET}"
-  echo ""
-fi
+while true; do
+  # 동적 모드 감지
+  if [ -f "$QUEUE" ]; then
+    NEW_MODE="v4"
+  else
+    NEW_MODE="v3"
+  fi
 
-# Start audit log streaming
-stream_audit
+  # 모드 전환 시 화면 초기화
+  if [ "$NEW_MODE" != "$CURRENT_MODE" ]; then
+    clear
+    CURRENT_MODE="$NEW_MODE"
+    if [ "$CURRENT_MODE" = "v3" ]; then
+      # v3 초기화
+      if [ -f "$PROGRESS" ]; then
+        LAST_AGENT=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
+        LAST_STATUS=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+        LAST_SPRINT=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
+      fi
+      stream_audit
+    fi
+  fi
 
-# Poll progress.json for transitions
-while true; do
-  check_transitions
-  sleep 2
+  if [ "$CURRENT_MODE" = "v4" ]; then
+    buf=$(render_v4 2>&1)
+    tput cup 0 0 2>/dev/null
+    echo "$buf"
+    tput ed 2>/dev/null
+  else
+    check_transitions
+  fi
+
+  sleep 3
 done
+