@walwal-harness/cli 6.0.5 → 6.1.0

package/scripts/lib/harness-audit.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+# harness-audit.sh — Audit log 헬퍼
+#
+# 라이프사이클: Planner 시작 → Eval 통과 (1 sprint cycle)
+# 새 Planner/Dispatcher 사이클 시작 시 이전 로그는 archive로 이동.
+#
+# 사용법:
+#   source scripts/lib/harness-audit.sh
+#   audit_log "gen-backend" "develop" "start" "apps/service-user/" "User 서비스 CRUD 구현"
+#   audit_log "eval-func"   "review"  "complete" "POST /api/auth" "FAIL: 409→400 contract 불일치"
+#   audit_log "gen-backend" "handoff" "start" "→eval-functional" ""
+
+AUDIT_LOG_FILE=""
+
+# ─────────────────────────────────────────
+# init_audit — audit.log 경로 설정 + 헤더 생성
+# Args: $1 = project root
+# ─────────────────────────────────────────
+init_audit() {
+  local project_root="${1:-.}"
+  AUDIT_LOG_FILE="$project_root/.harness/actions/audit.log"
+
+  # 디렉토리 보장
+  mkdir -p "$(dirname "$AUDIT_LOG_FILE")"
+}
+
+# ─────────────────────────────────────────
+# reset_audit — 새 사이클 시작 시 로그 초기화
+# 이전 로그가 있으면 archive로 이동
+# Args: $1 = project root, $2 = sprint number (optional)
+# ─────────────────────────────────────────
+reset_audit() {
+  local project_root="${1:-.}"
+  local sprint_num="${2:-0}"
+  init_audit "$project_root"
+
+  # 기존 로그가 있으면 archive로 이동
+  if [ -f "$AUDIT_LOG_FILE" ] && [ -s "$AUDIT_LOG_FILE" ]; then
+    local archive_dir="$project_root/.harness/archive"
+    mkdir -p "$archive_dir"
+    local ts
+    ts=$(date +%Y%m%d_%H%M%S)
+    mv "$AUDIT_LOG_FILE" "$archive_dir/audit_s${sprint_num}_${ts}.log"
+  fi
+
+  # 새 로그 헤더
+  cat > "$AUDIT_LOG_FILE" <<HEADER
+# Harness Audit Log
+# Cycle started: $(date -u +%Y-%m-%dT%H:%M:%SZ)
+# Format: TIMESTAMP | AGENT | ACTION | STATUS | TARGET | DETAIL
+#─────────────────────────────────────────────────────────────────────────
+HEADER
+}
+
+# ─────────────────────────────────────────
+# audit_log — 로그 엔트리 추가
+#
+# Args:
+#   $1 = agent     (planner, gen-backend, gen-frontend, eval-func, eval-visual)
+#   $2 = action    (develop, review, handoff, plan, gate)
+#   $3 = status    (start, complete, fail, skip)
+#   $4 = target    (파일 경로, 엔드포인트, 에이전트명 등)
+#   $5 = detail    (설명, 결과 등)
+# ─────────────────────────────────────────
+audit_log() {
+  if [ -z "$AUDIT_LOG_FILE" ] || [ ! -f "$AUDIT_LOG_FILE" ]; then
+    return 0  # audit 미초기화 시 silent pass
+  fi
+
+  local agent="${1:-unknown}"
+  local action="${2:-unknown}"
+  local log_status="${3:-unknown}"
+  local target="${4:-}"
+  local detail="${5:-}"
+  local ts
+  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+  # 고정폭 포맷
+  printf "%-20s | %-14s | %-8s | %-8s | %-30s | %s\n" \
+    "$ts" "$agent" "$action" "$log_status" "$target" "$detail" >> "$AUDIT_LOG_FILE"
+}
+
+# ─────────────────────────────────────────
+# audit_handoff — 핸즈오프 기록 (편의 함수)
+# Args: $1=from_agent, $2=to_agent, $3=status(start|complete)
+# ─────────────────────────────────────────
+audit_handoff() {
+  audit_log "$1" "handoff" "$3" "→${2}" ""
+}
+
+# ─────────────────────────────────────────
+# audit_gate — 게이트 체크 기록 (편의 함수)
+# Args: $1=gate_name, $2=status(pass|fail), $3=detail
+# ─────────────────────────────────────────
+audit_gate() {
+  audit_log "system" "gate" "$2" "$1" "$3"
+}
+
+# ─────────────────────────────────────────
+# render_audit — audit.log를 읽기 좋게 출력
+# Args: $1 = project root (optional)
+# ─────────────────────────────────────────
+render_audit() {
+  local project_root="${1:-.}"
+  local log_file="$project_root/.harness/actions/audit.log"
+
+  if [ ! -f "$log_file" ]; then
+    echo "  (audit log not yet created)"
+    return 0
+  fi
+
+  cat "$log_file"
+}

package/scripts/lib/harness-guardrail.sh

@@ -0,0 +1,148 @@
+#!/bin/bash
+# harness-guardrail.sh — 런타임 파일 소유권 검증
+# 에이전트 전환 시 이전 에이전트가 권한 밖 파일을 수정했는지 git diff로 검증.
+#
+# 사용법: source lib/harness-guardrail.sh && verify_file_ownership "$PROJECT_ROOT"
+# 반환값: 0=통과, 1=위반 발견 (위반 목록을 stdout에 출력)
+
+# ─────────────────────────────────────────
+# Agent → 허용 경로 매핑
+# ─────────────────────────────────────────
+get_allowed_paths() {
+  local agent="$1"
+  case "$agent" in
+    planner)
+      echo "AGENTS.md"
+      echo ".harness/actions/"
+      echo ".harness/progress.json"
+      echo ".harness/progress.log"
+      ;;
+    generator-backend)
+      echo "apps/gateway/"
+      echo "apps/service-"
+      echo "libs/"
+      echo ".harness/actions/sprint-contract.md"
+      echo ".harness/actions/feature-list.json"
+      echo ".harness/progress.json"
+      echo "package.json"
+      echo "nest-cli.json"
+      echo "tsconfig"
+      echo "docker-compose"
+      ;;
+    generator-frontend)
+      echo "apps/web/"
+      echo "apps/flutter/"
+      echo "lib/"
+      echo ".harness/actions/sprint-contract.md"
+      echo ".harness/actions/feature-list.json"
+      echo ".harness/progress.json"
+      echo "package.json"
+      echo "tsconfig"
+      echo "pubspec"
+      ;;
+    evaluator-code-quality)
+      echo ".harness/actions/evaluation-code-quality.md"
+      echo ".harness/progress.json"
+      ;;
+    evaluator-functional)
+      echo ".harness/actions/evaluation-functional.md"
+      echo ".harness/progress.json"
+      echo "tests/"
+      echo "test/"
+      echo "e2e/"
+      echo "playwright"
+      ;;
+    evaluator-visual)
+      echo ".harness/actions/evaluation-visual.md"
+      echo ".harness/progress.json"
+      ;;
+    dispatcher)
+      echo ".harness/"
+      ;;
+    *)
+      echo "**"  # unknown agent — allow all (safe fallback)
+      ;;
+  esac
+}
+
+# ─────────────────────────────────────────
+# verify_file_ownership — git diff 기반 검증
+#
+# Args:
+#   $1 — project root
+#
+# Reads:
+#   .harness/progress.json (current_agent)
+#
+# Returns: 0=pass, 1=violation found
+# ─────────────────────────────────────────
+verify_file_ownership() {
+  local PROJECT_ROOT="$1"
+  local PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+
+  if [ ! -f "$PROGRESS" ]; then return 0; fi
+
+  local agent
+  agent=$(jq -r '.current_agent // "null"' "$PROGRESS" 2>/dev/null)
+  if [ "$agent" = "null" ] || [ -z "$agent" ]; then return 0; fi
+
+  # git이 없으면 skip
+  if ! command -v git &>/dev/null; then return 0; fi
+
+  # 마지막 커밋 이후 변경된 파일 목록
+  local -a changed_files
+  mapfile -t changed_files < <(cd "$PROJECT_ROOT" && git diff --name-only HEAD 2>/dev/null)
+
+  # staged 파일도 포함
+  local -a staged_files
+  mapfile -t staged_files < <(cd "$PROJECT_ROOT" && git diff --name-only --cached 2>/dev/null)
+
+  # 합치기 (중복 제거)
+  local -a all_files
+  mapfile -t all_files < <(printf '%s\n' "${changed_files[@]}" "${staged_files[@]}" | sort -u | grep -v '^$')
+
+  if [ ${#all_files[@]} -eq 0 ]; then return 0; fi
+
+  # 허용 경로 목록
+  local -a allowed
+  mapfile -t allowed < <(get_allowed_paths "$agent")
+
+  # 위반 검사
+  local -a violations=()
+  for file in "${all_files[@]}"; do
+    local is_allowed=false
+    for pattern in "${allowed[@]}"; do
+      if [[ "$file" == $pattern* ]]; then
+        is_allowed=true
+        break
+      fi
+    done
+    if [ "$is_allowed" = false ]; then
+      violations+=("$file")
+    fi
+  done
+
+  if [ ${#violations[@]} -eq 0 ]; then
+    return 0
+  fi
+
+  # 위반 보고
+  echo ""
+  echo "  ── Guardrail Violation ────────────────"
+  echo "  Agent '$agent' modified files outside its allowed paths:"
+  echo ""
+  for v in "${violations[@]}"; do
+    echo "    ✗ $v"
+  done
+  echo ""
+  echo "  Allowed paths for $agent:"
+  for p in "${allowed[@]}"; do
+    echo "    ✓ $p*"
+  done
+  echo ""
+  echo "  Action: Review these changes before proceeding."
+  echo "  ─────────────────────────────────────────"
+  echo ""
+
+  return 1
+}

package/scripts/lib/harness-keywait.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# harness-keywait.sh — 패널 refresh/quit 키 대기 헬퍼
+#
+# 사용법:
+#   source scripts/lib/harness-keywait.sh
+#   while true; do
+#     render_panel
+#     echo "  [r] refresh  [q] quit"
+#     if wait_or_refresh 3; then
+#       # 타임아웃 → 일반 주기 리프레시
+#       :
+#     else
+#       # 'r' 키 즉시 리프레시 (반환값 != 0)
+#       :
+#     fi
+#   done
+#
+# 키 처리:
+#   'r' / 'R' / Enter → 즉시 복귀 (return 1 — 강제 리프레시 신호)
+#   'q' / 'Q'         → exit 0 (패널 종료)
+#   그 외 / 타임아웃  → return 0 (정상 주기 리프레시)
+#
+# TTY 가 아니면 plain sleep 으로 동작 (Claude Code Bash 도구 등에서도 안전).
+
+wait_or_refresh() {
+  local secs="${1:-3}"
+
+  # Non-TTY fallback
+  if ! [ -t 0 ]; then
+    sleep "$secs"
+    return 0
+  fi
+
+  local key=""
+  # -t: timeout, -n 1: 1글자, -s: 에코 안함
+  # read 는 Enter 에서도 타임아웃 전에 즉시 복귀 (빈 키)
+  if IFS= read -rsn 1 -t "$secs" key 2>/dev/null; then
+    case "$key" in
+      q|Q)
+        # 커서 복원 후 종료
+        tput cnorm 2>/dev/null || true
+        clear
+        exit 0
+        ;;
+      r|R|"")
+        # 강제 리프레시 시그널
+        return 1
+        ;;
+      *)
+        # 기타 키는 무시하고 일반 복귀
+        return 0
+        ;;
+    esac
+  fi
+  # 타임아웃
+  return 0
+}

package/scripts/lib/harness-render-progress.sh

@@ -0,0 +1,346 @@
+#!/bin/bash
+# harness-render-progress.sh — Feature-level 프로그래스 렌더링 (공통 함수)
+# source로 포함하여 사용: source "$(dirname "$0")/lib/harness-render-progress.sh"
+
+# ─────────────────────────────────────────
+# Dependencies: jq
+# ─────────────────────────────────────────
+check_jq() {
+  if ! command -v jq &>/dev/null; then
+    echo "[harness] ERROR: jq is required. Install with: brew install jq" >&2
+    return 1
+  fi
+}
+
+# ─────────────────────────────────────────
+# resolve_harness_root — .harness/ 디렉토리 찾기
+# ─────────────────────────────────────────
+resolve_harness_root() {
+  local dir="${1:-.}"
+  dir="$(cd "$dir" && pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  return 1
+}
+
+# ─────────────────────────────────────────
+# render_progress — Feature-level 프로그래스 출력
+#
+# Args:
+#   $1 — project root (optional, defaults to auto-detect)
+#
+# Reads:
+#   .harness/progress.json
+#   .harness/config.json
+#   .harness/actions/feature-list.json (if exists)
+# ─────────────────────────────────────────
+render_progress() {
+  check_jq || return 1
+
+  local PROJECT_ROOT
+  PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || {
+    echo "[harness] .harness/ directory not found" >&2
+    return 1
+  }
+
+  local PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+  local CONFIG="$PROJECT_ROOT/.harness/config.json"
+  local FEATURES="$PROJECT_ROOT/.harness/actions/feature-list.json"
+
+  if [ ! -f "$PROGRESS" ]; then
+    return 1
+  fi
+
+  # Read progress.json
+  local pipeline sprint_num sprint_status retry_count
+  local current_agent agent_status next_agent
+  local failure_agent failure_location failure_message
+
+  pipeline=$(jq -r '.pipeline // "unknown"' "$PROGRESS")
+  sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
+  sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS")
+  retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS")
+  current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS")
+  agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS")
+  next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS")
+  failure_agent=$(jq -r '.failure.agent // empty' "$PROGRESS")
+  failure_location=$(jq -r '.failure.location // empty' "$PROGRESS")
+  failure_message=$(jq -r '.failure.message // empty' "$PROGRESS")
+
+  # Read max retries from config
+  local max_retries=10
+  if [ -f "$CONFIG" ]; then
+    max_retries=$(jq -r '.flow.max_retries_per_sprint // 10' "$CONFIG")
+  fi
+
+  # Pipeline agents for progress bar
+  local -a pipeline_agents
+  if [ -f "$CONFIG" ] && [ "$pipeline" != "null" ] && [ "$pipeline" != "unknown" ]; then
+    mapfile -t pipeline_agents < <(jq -r ".flow.pipeline_selection.pipelines[\"${pipeline}\"][]" "$CONFIG" 2>/dev/null | sed 's/:.*//')
+  fi
+
+  # ── Header ──
+  local header="Sprint ${sprint_num} / ${pipeline}"
+  local pad_len=$(( 40 - ${#header} ))
+  local padding=""
+  for ((i=0; i<pad_len; i++)); do padding+="═"; done
+  echo ""
+  echo "  ═══ ${header} ${padding}"
+  echo ""
+
+  # ── Feature Progress ──
+  if [ -f "$FEATURES" ]; then
+    local total_features completed_features=0 in_progress_features=0
+    total_features=$(jq '.features | length' "$FEATURES" 2>/dev/null || echo 0)
+
+    if [ "$total_features" -gt 0 ]; then
+      # Determine columns based on pipeline
+      local show_be=true show_fe=true
+      case "$pipeline" in
+        BE-ONLY)  show_fe=false ;;
+        FE-ONLY)  show_be=false ;;
+      esac
+
+      # Build feature lines
+      local i=0
+      while [ $i -lt "$total_features" ]; do
+        local fid fname passes be_pass fe_pass eval_func_pass eval_visual_pass
+        fid=$(jq -r ".features[$i].id // \"F-$((i+1))\"" "$FEATURES")
+        fname=$(jq -r ".features[$i].name // .features[$i].title // .features[$i].description // \"Feature $((i+1))\"" "$FEATURES")
+        passes=$(jq -r ".features[$i].passes // [] | .[]" "$FEATURES" 2>/dev/null)
+
+        # Truncate name to 20 chars
+        if [ ${#fname} -gt 20 ]; then
+          fname="${fname:0:18}.."
+        fi
+
+        # Check passes
+        be_pass="○"; fe_pass="○"; eval_cq_pass="○"; eval_func_pass="○"; eval_visual_pass="○"
+        local eval_done=false
+
+        while IFS= read -r p; do
+          case "$p" in
+            generator-backend)       be_pass="✓" ;;
+            generator-frontend)      fe_pass="✓" ;;
+            evaluator-code-quality)  eval_cq_pass="✓" ;;
+            evaluator-functional)    eval_func_pass="✓" ;;
+            evaluator-visual)        eval_visual_pass="✓" ;;
+          esac
+        done <<< "$passes"
+
+        # Eval column: chain 내 존재하는 평가자 모두 PASS 여야 ✓
+        local eval_pass="○"
+        local eval_passed_count=0
+        local eval_total=3
+        [ "$eval_cq_pass" = "✓" ]      && eval_passed_count=$((eval_passed_count + 1))
+        [ "$eval_func_pass" = "✓" ]    && eval_passed_count=$((eval_passed_count + 1))
+        [ "$eval_visual_pass" = "✓" ]  && eval_passed_count=$((eval_passed_count + 1))
+        if [ "$eval_passed_count" -eq "$eval_total" ]; then
+          eval_pass="✓"
+        elif [ "$eval_passed_count" -gt 0 ]; then
+          eval_pass="◐"
+        fi
+
+        # Feature status icon
+        local icon="○"
+        local is_complete=false
+        if [ "$show_be" = true ] && [ "$show_fe" = true ]; then
+          # FULLSTACK: all must pass
+          if [ "$be_pass" = "✓" ] && [ "$fe_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$be_pass" = "✓" ] || [ "$fe_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        elif [ "$show_be" = true ]; then
+          # BE-ONLY
+          if [ "$be_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$be_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        else
+          # FE-ONLY
+          if [ "$fe_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$fe_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        fi
+
+        if [ "$is_complete" = true ]; then
+          completed_features=$((completed_features + 1))
+        fi
+
+        # Build columns
+        local cols=""
+        if [ "$show_be" = true ]; then cols+="BE${be_pass}  "; fi
+        if [ "$show_fe" = true ]; then cols+="FE${fe_pass}  "; fi
+        cols+="Eval${eval_pass}"
+
+        printf "  %s %-5s %-22s %s\n" "$icon" "$fid" "$fname" "$cols"
+
+        i=$((i + 1))
+      done
+
+      echo ""
+
+      # ── Progress Bar ──
+      local steps_per_feature=0
+      if [ "$show_be" = true ]; then steps_per_feature=$((steps_per_feature + 1)); fi
+      if [ "$show_fe" = true ]; then steps_per_feature=$((steps_per_feature + 1)); fi
+      steps_per_feature=$((steps_per_feature + 1))  # eval
+
+      local total_steps=$((total_features * steps_per_feature))
+      local done_steps=0
+
+      # Count individual passes across all features
+      i=0
+      while [ $i -lt "$total_features" ]; do
+        passes=$(jq -r ".features[$i].passes // [] | .[]" "$FEATURES" 2>/dev/null)
+        while IFS= read -r p; do
+          case "$p" in
+            generator-backend)
+              if [ "$show_be" = true ]; then done_steps=$((done_steps + 1)); fi
+              ;;
+            generator-frontend)
+              if [ "$show_fe" = true ]; then done_steps=$((done_steps + 1)); fi
+              ;;
+            evaluator-code-quality|evaluator-functional|evaluator-visual)
+              # Chain 내 평가자. 아래에서 통합 집계.
+              ;;
+          esac
+        done <<< "$passes"
+
+        # Check eval completion — 체인상의 3개 평가자 모두 통과 시에만 1 step 인정
+        local ecq ef ev
+        ecq=$(jq -r ".features[$i].passes // [] | map(select(. == \"evaluator-code-quality\")) | length" "$FEATURES" 2>/dev/null)
+        ef=$(jq -r ".features[$i].passes // [] | map(select(. == \"evaluator-functional\")) | length" "$FEATURES" 2>/dev/null)
+        ev=$(jq -r ".features[$i].passes // [] | map(select(. == \"evaluator-visual\")) | length" "$FEATURES" 2>/dev/null)
+        if [ "${ecq:-0}" -gt 0 ] && [ "${ef:-0}" -gt 0 ] && [ "${ev:-0}" -gt 0 ]; then
+          done_steps=$((done_steps + 1))
+        fi
+
+        i=$((i + 1))
+      done
+
+      local pct=0
+      if [ "$total_steps" -gt 0 ]; then
+        pct=$(( done_steps * 100 / total_steps ))
+      fi
+
+      local bar_width=16
+      local filled=$(( pct * bar_width / 100 ))
+      local empty=$(( bar_width - filled ))
+      local bar=""
+      for ((j=0; j<filled; j++)); do bar+="█"; done
+      for ((j=0; j<empty; j++)); do bar+="░"; done
+
+      echo "  Features: ${completed_features}/${total_features} completed"
+      echo "  Pipeline: ${bar}  ${pct}%"
+    fi
+  else
+    echo "  (feature-list.json not yet created — run Planner first)"
+  fi
+
+  echo ""
+
+  # ── Current Agent Status ──
+  if [ "$current_agent" != "none" ] && [ "$current_agent" != "null" ]; then
+    echo "  Current:  ${current_agent} [${agent_status}] (retry ${retry_count}/${max_retries})"
+  fi
+
+  # ── Failure Info ──
+  if [ -n "$failure_agent" ] && [ "$failure_agent" != "null" ]; then
+    echo ""
+    echo "  ⚠ FAIL: ${failure_agent} → ${failure_location}"
+    if [ -n "$failure_message" ] && [ "$failure_message" != "null" ]; then
+      echo "    ${failure_message}"
+    fi
+  fi
+
+  # ── Blocked ──
+  if [ "$agent_status" = "blocked" ]; then
+    echo ""
+    echo "  ✖ BLOCKED: retry limit (${max_retries}) reached — user intervention required"
+  fi
+
+  # ── Next Action ──
+  if [ "$next_agent" != "none" ] && [ "$next_agent" != "null" ] && [ "$agent_status" != "blocked" ]; then
+    # Read model & thinking mode from config
+    local next_model="opus"
+    local next_thinking="null"
+    if [ -f "$CONFIG" ]; then
+      next_model=$(jq -r ".agents[\"${next_agent}\"].model // \"opus\"" "$CONFIG" 2>/dev/null || echo "opus")
+      next_thinking=$(jq -r ".agents[\"${next_agent}\"].thinking_mode // \"null\"" "$CONFIG" 2>/dev/null || echo "null")
+    fi
+
+    local mode_str=""
+    if [ "$next_thinking" != "null" ]; then
+      mode_str=" [/${next_thinking}]"
+    fi
+
+    echo ""
+    echo "  Next → /harness-${next_agent}  (${next_model}${mode_str})"
+    echo "  Tip  → 새 세션을 시작하면 자동으로 안내됩니다"
+  fi
+
+  echo ""
+}
+
+# ─────────────────────────────────────────
+# render_agent_bar — 에이전트 시퀀스 바 (compact)
+# ─────────────────────────────────────────
+render_agent_bar() {
+  local PROGRESS="${1:-.}/.harness/progress.json"
+  local CONFIG="${1:-.}/.harness/config.json"
+  local PIPELINE_JSON="${1:-.}/.harness/actions/pipeline.json"
+
+  if [ ! -f "$PROGRESS" ] || [ ! -f "$CONFIG" ]; then return 1; fi
+
+  local pipeline current_agent fe_stack fe_target
+  pipeline=$(jq -r '.pipeline // "unknown"' "$PROGRESS")
+  current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS")
+  fe_stack="react"
+  fe_target="web"
+  if [ -f "$PIPELINE_JSON" ]; then
+    fe_stack=$(jq -r '.fe_stack // "react"' "$PIPELINE_JSON" 2>/dev/null || echo "react")
+    fe_target=$(jq -r '.fe_target // empty' "$PIPELINE_JSON" 2>/dev/null || true)
+    if [ -z "$fe_target" ]; then
+      fe_target="web"  # v5.6.5+: 치환 로직 제거. 기본 web.
+    fi
+  fi
+
+  local completed_agents
+  completed_agents=$(jq -r '.completed_agents // [] | .[]' "$PROGRESS")
+
+  if [ "$pipeline" = "null" ] || [ "$pipeline" = "unknown" ]; then return 1; fi
+
+  local agents_line="  Agents: "
+  local first=true
+
+  while IFS= read -r agent; do
+    agent=$(echo "$agent" | sed 's/:.*//')  # strip mode suffix like :light, :api-only
+    # v5.6.5+: fe_stack 에이전트 치환 제거. 스택별 동작은 ref-docs 로 조절.
+
+    if [ "$first" = true ]; then
+      first=false
+    else
+      agents_line+=" → "
+    fi
+
+    if echo "$completed_agents" | grep -q "^${agent}$"; then
+      agents_line+="${agent}✓"
+    elif [ "$agent" = "$current_agent" ]; then
+      agents_line+="[${agent}]"
+    else
+      agents_line+="${agent}"
+    fi
+  done < <(jq -r ".flow.pipeline_selection.pipelines[\"${pipeline}\"][]" "$CONFIG" 2>/dev/null)
+
+  echo "$agents_line"
+}