@walwal-harness/cli 3.5.0 → 3.6.1

package/bin/init.js

@@ -14,9 +14,11 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 const PKG_ROOT = path.resolve(__dirname, '..');
-const isAuto = process.argv.includes('--auto');
-const isForce = process.argv.includes('--force');
-const isHelp = process.argv.includes('--help') || process.argv.includes('-h');
+const args = process.argv.slice(2);
+const subcommand = args.find(a => !a.startsWith('-')) || null;
+const isAuto = args.includes('--auto');
+const isForce = args.includes('--force');
+const isHelp = args.includes('--help') || args.includes('-h');
 
 // ─────────────────────────────────────────
 // Resolve project root
@@ -551,9 +553,11 @@ function showHelp() {
 ╚══════════════════════════════════════╝
 
 Usage:
-  npx walwal-harness           Initialize project for harness engineering
-  npx walwal-harness --force   Re-initialize (overwrites existing files)
-  npx walwal-harness --help    Show this help
+  npx walwal-harness            Initialize project for harness engineering
+  npx walwal-harness --force    Re-initialize (overwrites existing files)
+  npx walwal-harness studio     Launch Harness Studio (tmux 4-pane monitor)
+  npx walwal-harness studio --ai  Studio + AI eval summary (API cost)
+  npx walwal-harness --help     Show this help
 
 What it does:
   1. Scaffolds .harness/ directory (actions, archive, gotchas, config)
@@ -580,12 +584,39 @@ After init:
 // ─────────────────────────────────────────
 // Main
 // ─────────────────────────────────────────
+function runStudio() {
+  const useAi = args.includes('--ai') ? '--ai' : '';
+  const scriptsDir = path.join(PKG_ROOT, 'scripts');
+  const tmuxScript = path.join(scriptsDir, 'harness-tmux.sh');
+
+  if (!fs.existsSync(tmuxScript)) {
+    log('ERROR: harness-tmux.sh not found. Update @walwal-harness/cli to >= 3.6.0');
+    process.exit(1);
+  }
+
+  try {
+    execSync('which tmux', { stdio: 'ignore' });
+  } catch {
+    log('ERROR: tmux is required. Install with: brew install tmux');
+    process.exit(1);
+  }
+
+  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}" ${useAi}`.trim();
+  log(`Launching Harness Studio...`);
+  execSync(cmd, { stdio: 'inherit' });
+}
+
 function main() {
   if (isHelp) {
     showHelp();
     return;
   }
 
+  if (subcommand === 'studio') {
+    runStudio();
+    return;
+  }
+
   const pkg = require(path.join(PKG_ROOT, 'package.json'));
   console.log('');
   console.log('╔══════════════════════════════════════╗');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "3.5.0",
+  "version": "3.6.1",
   "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"

package/scripts/harness-dashboard.sh

@@ -0,0 +1,179 @@
+#!/bin/bash
+# harness-dashboard.sh — Panel 1: 실시간 대시보드
+# progress.json + feature-list.json 을 2초 간격으로 시각화
+# Usage: bash scripts/harness-dashboard.sh [project-root]
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="${1:-}"
+if [ -z "$PROJECT_ROOT" ]; then
+  PROJECT_ROOT="$(resolve_harness_root ".")" || {
+    echo "[dashboard] .harness/ not found. Pass project root as argument."
+    exit 1
+  }
+fi
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+FEATURES="$PROJECT_ROOT/.harness/actions/feature-list.json"
+
+# ── ANSI helpers ──
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+RESET="\033[0m"
+
+render_header() {
+  local now
+  now=$(date +"%H:%M:%S")
+  local project_name
+  project_name=$(jq -r '.project_name // "Unknown"' "$PROGRESS" 2>/dev/null)
+
+  echo -e "${BOLD}╔══════════════════════════════════════╗${RESET}"
+  echo -e "${BOLD}║  HARNESS DASHBOARD                   ║${RESET}"
+  echo -e "${BOLD}╚══════════════════════════════════════╝${RESET}"
+  echo -e "  ${DIM}${project_name}  |  Updated: ${now}${RESET}"
+  echo ""
+}
+
+render_sprint_overview() {
+  if [ ! -f "$PROGRESS" ]; then
+    echo -e "  ${DIM}(waiting for harness init...)${RESET}"
+    return
+  fi
+
+  local pipeline sprint_num sprint_status current_agent agent_status retry_count
+  pipeline=$(jq -r '.pipeline // "?"' "$PROGRESS")
+  sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
+  sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS")
+  current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS")
+  agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS")
+  retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS")
+
+  # Status color
+  local status_color="$RESET"
+  case "$agent_status" in
+    running)   status_color="$GREEN" ;;
+    completed) status_color="$CYAN" ;;
+    failed)    status_color="$RED" ;;
+    blocked)   status_color="$RED" ;;
+    *)         status_color="$YELLOW" ;;
+  esac
+
+  echo -e "  ${BOLD}Pipeline${RESET}  ${pipeline}"
+  echo -e "  ${BOLD}Sprint${RESET}    ${sprint_num} (${sprint_status})"
+  echo -e "  ${BOLD}Agent${RESET}     ${status_color}${current_agent} [${agent_status}]${RESET}"
+  if [ "$retry_count" -gt 0 ]; then
+    echo -e "  ${BOLD}Retries${RESET}   ${RED}${retry_count}${RESET}"
+  fi
+  echo ""
+}
+
+render_sprint_map() {
+  if [ ! -f "$PROGRESS" ]; then return; fi
+
+  local sprint_keys
+  sprint_keys=$(jq -r '.sprint_progress // {} | keys[]' "$PROGRESS" 2>/dev/null | sort -n)
+  if [ -z "$sprint_keys" ]; then return; fi
+
+  echo -e "  ${BOLD}Sprint Map${RESET}"
+
+  while IFS= read -r s; do
+    local status features_csv notes
+    status=$(jq -r ".sprint_progress[\"${s}\"].status // \"pending\"" "$PROGRESS")
+    features_csv=$(jq -r ".sprint_progress[\"${s}\"].features // [] | join(\",\")" "$PROGRESS")
+    notes=$(jq -r ".sprint_progress[\"${s}\"].notes // \"\"" "$PROGRESS")
+
+    # Status icon
+    local icon="○"
+    case "$status" in
+      completed)   icon="●" ;;
+      in_progress) icon="◐" ;;
+      scaffolded)  icon="◑" ;;
+      pending)     icon="○" ;;
+    esac
+
+    # Count features
+    local feat_count
+    feat_count=$(jq ".sprint_progress[\"${s}\"].features // [] | length" "$PROGRESS")
+
+    # Truncate notes
+    if [ ${#notes} -gt 40 ]; then
+      notes="${notes:0:38}.."
+    fi
+
+    printf "  %s S%-2s  %2d feat  %-12s %s\n" "$icon" "$s" "$feat_count" "$status" "$notes"
+  done <<< "$sprint_keys"
+
+  echo ""
+}
+
+render_build_status() {
+  if [ ! -f "$PROGRESS" ]; then return; fi
+
+  local build_status tsc_status routes_total last_build
+  build_status=$(jq -r '.build.build_status // "unknown"' "$PROGRESS" 2>/dev/null)
+  tsc_status=$(jq -r '.build.tsc_status // "unknown"' "$PROGRESS" 2>/dev/null)
+  routes_total=$(jq -r '.build.routes_total // 0' "$PROGRESS" 2>/dev/null)
+  last_build=$(jq -r '.build.last_build // "n/a"' "$PROGRESS" 2>/dev/null)
+
+  if [ "$build_status" = "null" ] || [ "$build_status" = "unknown" ]; then return; fi
+
+  local build_color="$GREEN"
+  if [ "$build_status" != "passing" ]; then build_color="$RED"; fi
+  local tsc_color="$GREEN"
+  if [ "$tsc_status" != "clean" ]; then tsc_color="$RED"; fi
+
+  echo -e "  ${BOLD}Build${RESET}"
+  echo -e "  Build: ${build_color}${build_status}${RESET}  |  TSC: ${tsc_color}${tsc_status}${RESET}  |  Routes: ${routes_total}"
+  echo ""
+}
+
+render_failure_info() {
+  if [ ! -f "$PROGRESS" ]; then return; fi
+
+  local failure_agent
+  failure_agent=$(jq -r '.failure.agent // empty' "$PROGRESS" 2>/dev/null)
+
+  if [ -n "$failure_agent" ] && [ "$failure_agent" != "null" ]; then
+    local failure_loc failure_msg
+    failure_loc=$(jq -r '.failure.location // ""' "$PROGRESS")
+    failure_msg=$(jq -r '.failure.message // ""' "$PROGRESS")
+
+    echo -e "  ${RED}${BOLD}╔═ FAILURE ═══════════════════════════╗${RESET}"
+    echo -e "  ${RED}  Agent: ${failure_agent}${RESET}"
+    echo -e "  ${RED}  Where: ${failure_loc}${RESET}"
+    if [ -n "$failure_msg" ] && [ "$failure_msg" != "null" ]; then
+      echo -e "  ${RED}  ${failure_msg}${RESET}"
+    fi
+    echo -e "  ${RED}${BOLD}╚════════════════════════════════════╝${RESET}"
+    echo ""
+  fi
+}
+
+# ── Main Loop ──
+while true; do
+  clear
+  render_header
+  render_sprint_overview
+  render_build_status
+  render_failure_info
+  render_sprint_map
+
+  # Feature progress (reuse existing lib)
+  if [ -f "$FEATURES" ]; then
+    render_progress "$PROJECT_ROOT" 2>/dev/null
+  fi
+
+  # Agent sequence bar
+  render_agent_bar "$PROJECT_ROOT" 2>/dev/null
+  echo ""
+
+  echo -e "  ${DIM}Refreshing every 2s  |  Ctrl+C to exit${RESET}"
+  sleep 2
+done

package/scripts/harness-eval-watcher.sh

@@ -0,0 +1,230 @@
+#!/bin/bash
+# harness-eval-watcher.sh — Panel 3: Evaluation 결과 Summary 리뷰
+# evaluation-*.md 파일 변경 감지 → 요약 출력 (또는 claude -p 호출)
+# Usage: bash scripts/harness-eval-watcher.sh [project-root] [--ai]
+#   --ai  evaluation 완료 시 claude -p 로 AI 요약 생성 (API 비용 발생)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+PROJECT_ROOT="${1:-}"
+USE_AI=false
+for arg in "$@"; do
+  if [ "$arg" = "--ai" ]; then USE_AI=true; fi
+done
+
+if [ -z "$PROJECT_ROOT" ] || [ "$PROJECT_ROOT" = "--ai" ]; then
+  source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+  PROJECT_ROOT="$(resolve_harness_root ".")" || {
+    echo "[eval-watcher] .harness/ not found. Pass project root as argument."
+    exit 1
+  }
+fi
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+EVAL_FUNC="$PROJECT_ROOT/.harness/actions/evaluation-functional.md"
+EVAL_VISUAL="$PROJECT_ROOT/.harness/actions/evaluation-visual.md"
+
+# ── ANSI helpers ──
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+RESET="\033[0m"
+
+LAST_FUNC_HASH=""
+LAST_VISUAL_HASH=""
+EVAL_COUNT=0
+
+print_header() {
+  echo -e "${BOLD}╔══════════════════════════════════════╗${RESET}"
+  echo -e "${BOLD}║  EVALUATION REVIEW                   ║${RESET}"
+  echo -e "${BOLD}╚══════════════════════════════════════╝${RESET}"
+  echo ""
+}
+
+file_hash() {
+  if [ -f "$1" ]; then
+    md5 -q "$1" 2>/dev/null || md5sum "$1" 2>/dev/null | awk '{print $1}' || echo ""
+  else
+    echo ""
+  fi
+}
+
+# ── Extract eval summary from markdown ──
+extract_eval_summary() {
+  local file="$1" type="$2"
+
+  if [ ! -f "$file" ]; then return; fi
+
+  EVAL_COUNT=$((EVAL_COUNT + 1))
+  local now
+  now=$(date +"%H:%M:%S")
+
+  echo -e "  ${BOLD}═══ ${type} Evaluation #${EVAL_COUNT} ═══${RESET}  ${DIM}(${now})${RESET}"
+  echo ""
+
+  # Extract Verdict (PASS/FAIL)
+  local verdict
+  verdict=$(grep -i "verdict\|result\|판정" "$file" | head -3)
+  if [ -n "$verdict" ]; then
+    if echo "$verdict" | grep -qi "PASS"; then
+      echo -e "  ${GREEN}${BOLD}VERDICT: PASS${RESET}"
+    elif echo "$verdict" | grep -qi "FAIL"; then
+      echo -e "  ${RED}${BOLD}VERDICT: FAIL${RESET}"
+    else
+      echo -e "  ${YELLOW}VERDICT: ${verdict}${RESET}"
+    fi
+    echo ""
+  fi
+
+  # Extract Score
+  local score_line
+  score_line=$(grep -iE "score|점수|weighted|가중" "$file" | head -3)
+  if [ -n "$score_line" ]; then
+    echo -e "  ${BOLD}Score${RESET}"
+    echo "$score_line" | while IFS= read -r line; do
+      # Color by score value
+      local num
+      num=$(echo "$line" | grep -oE '[0-9]+\.[0-9]+' | head -1)
+      if [ -n "$num" ]; then
+        local int_part
+        int_part=$(echo "$num" | cut -d. -f1)
+        if [ "${int_part:-0}" -ge 3 ] || ([ "${int_part:-0}" -eq 2 ] && [ "$(echo "$num >= 2.80" | bc 2>/dev/null)" = "1" ]); then
+          echo -e "    ${GREEN}${line}${RESET}"
+        else
+          echo -e "    ${RED}${line}${RESET}"
+        fi
+      else
+        echo "    $line"
+      fi
+    done
+    echo ""
+  fi
+
+  # Extract individual rubric items (R1-R5 or V1-V5)
+  local rubric_lines
+  rubric_lines=$(grep -E "^[|#].*[RV][1-5]" "$file" | head -10)
+  if [ -n "$rubric_lines" ]; then
+    echo -e "  ${BOLD}Rubric${RESET}"
+    echo "$rubric_lines" | while IFS= read -r line; do
+      echo "    $line"
+    done
+    echo ""
+  fi
+
+  # Extract FAIL reasons
+  local fail_lines
+  fail_lines=$(grep -iE "fail|실패|regression|불일치|위반" "$file" | head -5)
+  if [ -n "$fail_lines" ]; then
+    echo -e "  ${RED}${BOLD}Issues${RESET}"
+    echo "$fail_lines" | while IFS= read -r line; do
+      echo -e "    ${RED}• ${line}${RESET}"
+    done
+    echo ""
+  fi
+
+  # Extract action items / recommendations
+  local action_lines
+  action_lines=$(grep -iE "recommend|action|수정|개선|필요|re-generate" "$file" | head -5)
+  if [ -n "$action_lines" ]; then
+    echo -e "  ${YELLOW}${BOLD}Actions${RESET}"
+    echo "$action_lines" | while IFS= read -r line; do
+      echo -e "    ${YELLOW}→ ${line}${RESET}"
+    done
+    echo ""
+  fi
+
+  echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+  echo ""
+}
+
+# ── AI Summary (optional) ──
+generate_ai_summary() {
+  local file="$1" type="$2"
+
+  if [ "$USE_AI" != true ]; then return; fi
+  if ! command -v claude &>/dev/null; then
+    echo -e "  ${DIM}(claude CLI not found — skipping AI summary)${RESET}"
+    return
+  fi
+
+  echo -e "  ${CYAN}Generating AI summary...${RESET}"
+
+  local summary
+  summary=$(claude -p "다음 ${type} Evaluation 문서를 3줄 이내로 요약해줘. 핵심 결과(PASS/FAIL), 주요 문제점, 다음 액션을 포함:
+
+$(cat "$file")" --output-format text 2>/dev/null || echo "(AI summary failed)")
+
+  echo -e "  ${CYAN}${BOLD}AI Summary:${RESET}"
+  echo "$summary" | while IFS= read -r line; do
+    echo -e "    ${CYAN}${line}${RESET}"
+  done
+  echo ""
+}
+
+# ── Main ──
+print_header
+
+# Show existing evals on startup
+if [ -f "$EVAL_FUNC" ]; then
+  echo -e "  ${DIM}Found existing functional evaluation${RESET}"
+  extract_eval_summary "$EVAL_FUNC" "Functional"
+  LAST_FUNC_HASH=$(file_hash "$EVAL_FUNC")
+fi
+
+if [ -f "$EVAL_VISUAL" ]; then
+  echo -e "  ${DIM}Found existing visual evaluation${RESET}"
+  extract_eval_summary "$EVAL_VISUAL" "Visual"
+  LAST_VISUAL_HASH=$(file_hash "$EVAL_VISUAL")
+fi
+
+if [ -z "$LAST_FUNC_HASH" ] && [ -z "$LAST_VISUAL_HASH" ]; then
+  echo -e "  ${DIM}Waiting for evaluation files...${RESET}"
+  echo -e "  ${DIM}  ${EVAL_FUNC}${RESET}"
+  echo -e "  ${DIM}  ${EVAL_VISUAL}${RESET}"
+  echo ""
+fi
+
+echo -e "  ${DIM}Watching for changes every 3s  |  Ctrl+C to exit${RESET}"
+if [ "$USE_AI" = true ]; then
+  echo -e "  ${CYAN}AI summary enabled (claude -p)${RESET}"
+fi
+echo ""
+
+# ── Poll for changes ──
+while true; do
+  # Check functional eval
+  local_func_hash=$(file_hash "$EVAL_FUNC")
+  if [ "$local_func_hash" != "$LAST_FUNC_HASH" ] && [ -n "$local_func_hash" ]; then
+    LAST_FUNC_HASH="$local_func_hash"
+    extract_eval_summary "$EVAL_FUNC" "Functional"
+    generate_ai_summary "$EVAL_FUNC" "Functional"
+  fi
+
+  # Check visual eval
+  local_visual_hash=$(file_hash "$EVAL_VISUAL")
+  if [ "$local_visual_hash" != "$LAST_VISUAL_HASH" ] && [ -n "$local_visual_hash" ]; then
+    LAST_VISUAL_HASH="$local_visual_hash"
+    extract_eval_summary "$EVAL_VISUAL" "Visual"
+    generate_ai_summary "$EVAL_VISUAL" "Visual"
+  fi
+
+  # Check agent status for eval-related transitions
+  if [ -f "$PROGRESS" ]; then
+    local agent
+    agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
+    local status
+    status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+
+    if [[ "$agent" == evaluator-* ]] && [ "$status" = "running" ]; then
+      # Show that evaluator is active
+      :
+    fi
+  fi
+
+  sleep 3
+done

package/scripts/harness-monitor.sh

@@ -0,0 +1,193 @@
+#!/bin/bash
+# harness-monitor.sh — Panel 2: Task & Agent Lifecycle 모니터링
+# audit.log 스트리밍 + progress.json 변경 감지
+# Usage: bash scripts/harness-monitor.sh [project-root]
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+PROJECT_ROOT="${1:-}"
+if [ -z "$PROJECT_ROOT" ]; then
+  source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+  PROJECT_ROOT="$(resolve_harness_root ".")" || {
+    echo "[monitor] .harness/ not found. Pass project root as argument."
+    exit 1
+  }
+fi
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+AUDIT_LOG="$PROJECT_ROOT/.harness/actions/audit.log"
+HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
+
+# ── ANSI helpers ──
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+MAGENTA="\033[35m"
+RESET="\033[0m"
+
+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() {
+  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
+
+  local agent status sprint
+  agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
+  status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+  sprint=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
+
+  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="•"
+    case "$status" in
+      running)   status_color="$GREEN";  status_icon=" ▶ " ;;
+      completed) status_color="$CYAN";   status_icon=" ✓ " ;;
+      failed)    status_color="$RED";    status_icon=" ✗ " ;;
+      blocked)   status_color="$RED";    status_icon=" ! " ;;
+      pending)   status_color="$YELLOW"; status_icon=" … " ;;
+    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)
+      if [ -n "$fail_msg" ] && [ "$fail_msg" != "null" ]; then
+        echo -e "         ${RED}${fail_msg}${RESET}"
+      fi
+    fi
+  fi
+
+  LAST_AGENT="$agent"
+  LAST_STATUS="$status"
+  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
+    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="–" ;;
+    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}"
+  done &
+  AUDIT_TAIL_PID=$!
+}
+
+# ── Cleanup ──
+cleanup() {
+  if [ -n "${AUDIT_TAIL_PID:-}" ]; then
+    kill "$AUDIT_TAIL_PID" 2>/dev/null || true
+  fi
+  exit 0
+}
+trap cleanup EXIT INT TERM
+
+# ── Main ──
+print_header
+
+# 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
+
+# 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
+
+# Start audit log streaming
+stream_audit
+
+# Poll progress.json for transitions
+while true; do
+  check_transitions
+  sleep 2
+done

package/scripts/harness-tmux.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+# harness-tmux.sh — tmux 4-pane 레이아웃 자동 구성
+#
+# ┌──────────────────────┬──────────────────────┐
+# │                      │ Panel 1: Dashboard   │
+# │  Main Terminal       ├──────────────────────┤
+# │  (claude 대화형)      │ Panel 2: Monitor     │
+# │                      ├──────────────────────┤
+# │                      │ Panel 3: Eval Review │
+# └──────────────────────┴──────────────────────┘
+#
+# Usage:
+#   bash scripts/harness-tmux.sh [project-root]
+#   bash scripts/harness-tmux.sh /path/to/project --ai   (AI eval summary 활성화)
+#
+# Options:
+#   --ai        Panel 3에서 claude -p 로 AI 요약 생성 (API 비용 발생)
+#   --detach    세션 생성 후 attach 하지 않음
+#   --kill      기존 harness-studio 세션 종료
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SESSION_NAME="harness-studio"
+
+PROJECT_ROOT=""
+USE_AI=""
+DETACH=false
+KILL=false
+
+for arg in "$@"; do
+  case "$arg" in
+    --ai)     USE_AI="--ai" ;;
+    --detach) DETACH=true ;;
+    --kill)
+      tmux kill-session -t "$SESSION_NAME" 2>/dev/null && echo "Session '$SESSION_NAME' killed." || echo "No session to kill."
+      exit 0
+      ;;
+    *)
+      if [ -d "$arg" ]; then PROJECT_ROOT="$arg"; fi
+      ;;
+  esac
+done
+
+# Auto-detect project root
+if [ -z "$PROJECT_ROOT" ]; then
+  dir="$(pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then PROJECT_ROOT="$dir"; break; fi
+    dir="$(dirname "$dir")"
+  done
+fi
+
+if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
+  echo "Error: .harness/ directory not found."
+  echo "Usage: bash scripts/harness-tmux.sh [project-root]"
+  exit 1
+fi
+
+echo "Project: $PROJECT_ROOT"
+echo "Session: $SESSION_NAME"
+
+# Kill existing session if any
+tmux kill-session -t "$SESSION_NAME" 2>/dev/null || true
+
+# ── Create tmux session ──
+# Pane 0 (left, Main): interactive shell at project root
+tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 200 -y 50
+
+# Split right column (40% width)
+tmux split-window -h -l 80 -t "$SESSION_NAME" -c "$PROJECT_ROOT"
+
+# Pane 1 (top-right): Dashboard
+tmux send-keys -t "${SESSION_NAME}.1" "bash ${SCRIPT_DIR}/harness-dashboard.sh '${PROJECT_ROOT}'" Enter
+
+# Split pane 1 vertically for Monitor
+tmux split-window -v -t "${SESSION_NAME}.1" -c "$PROJECT_ROOT"
+
+# Pane 2 (mid-right): Monitor
+tmux send-keys -t "${SESSION_NAME}.2" "bash ${SCRIPT_DIR}/harness-monitor.sh '${PROJECT_ROOT}'" Enter
+
+# Split pane 2 vertically for Eval
+tmux split-window -v -t "${SESSION_NAME}.2" -c "$PROJECT_ROOT"
+
+# Pane 3 (bottom-right): Eval Watcher
+tmux send-keys -t "${SESSION_NAME}.3" "bash ${SCRIPT_DIR}/harness-eval-watcher.sh '${PROJECT_ROOT}' ${USE_AI}" Enter
+
+# ── Layout adjustments ──
+# Select left pane (Main) — this is where the user works
+tmux select-pane -t "${SESSION_NAME}.0"
+
+# Set pane titles (requires tmux >= 3.2 with pane-border-format)
+tmux select-pane -t "${SESSION_NAME}.0" -T "Main"
+tmux select-pane -t "${SESSION_NAME}.1" -T "Dashboard"
+tmux select-pane -t "${SESSION_NAME}.2" -T "Monitor"
+tmux select-pane -t "${SESSION_NAME}.3" -T "Eval Review"
+
+# Enable pane border titles
+tmux set-option -t "$SESSION_NAME" pane-border-status top 2>/dev/null || true
+tmux set-option -t "$SESSION_NAME" pane-border-format " #{pane_title} " 2>/dev/null || true
+
+# ── Attach or print info ──
+if [ "$DETACH" = true ]; then
+  echo ""
+  echo "Session created. Attach with:"
+  echo "  tmux attach -t $SESSION_NAME"
+else
+  # If already in tmux, switch; otherwise attach
+  if [ -n "${TMUX:-}" ]; then
+    tmux switch-client -t "$SESSION_NAME"
+  else
+    echo ""
+    echo "Launching harness-studio..."
+    echo "  Main (left)        : Interactive terminal — run 'claude' here"
+    echo "  Dashboard (right↑) : Real-time progress"
+    echo "  Monitor (right↔)   : Agent lifecycle events"
+    echo "  Eval (right↓)      : Evaluation summaries"
+    echo ""
+    tmux attach -t "$SESSION_NAME"
+  fi
+fi