@walwal-harness/cli 4.0.0-alpha.2 → 4.0.0-alpha.20

package/assets/templates/config.json

@@ -133,62 +133,15 @@
         ]
       }
     },
-    "generator-frontend-flutter": {
-      "role": "Flutter 앱 개발 — Riverpod, integrated_data_layer(Retrofit), i18n(ARB), build_runner",
-      "skill": "harness-generator-frontend-flutter",
-      "inputs": ["actions/plan.md", "actions/feature-list.json", "actions/api-contract.json", "actions/sprint-contract.md"],
-      "outputs": ["code:flutter", "actions/sprint-contract.md"],
-      "order": 2,
-      "fe_stack": "flutter",
-      "model": "sonnet",
-      "thinking_mode": null
-    },
-    "evaluator-functional-flutter": {
-      "role": "Flutter 앱 검증 — flutter analyze, flutter test, build_runner 일관성, 안티패턴 정적 검증",
-      "skill": "harness-evaluator-functional-flutter",
-      "tools": ["bash:flutter", "bash:dart"],
-      "inputs": ["actions/sprint-contract.md"],
-      "outputs": ["actions/evaluation-functional.md"],
-      "fe_stack": "flutter",
-      "model": "opus",
-      "thinking_mode": "ultrathink"
-    }
   },
   "flow": {
     "sequence": ["dispatcher", "planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
     "pipeline_selection": {
-      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정. fe_stack 필드로 React/Flutter를 구분. harness-next.sh가 pipeline.json.fe_stack 을 읽어 generator-frontend/evaluator-functional 을 Flutter 변형으로 치환한다.",
+      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정.",
       "pipelines": {
         "FULLSTACK": ["planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "FE-ONLY": ["planner:light", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "BE-ONLY": ["planner", "generator-backend", "evaluator-functional:api-only"]
-      },
-      "fe_stack_substitution": {
-        "comment": "pipeline.json.fe_stack + fe_target 에 따라 FE 에이전트 치환. Flutter Web 은 React 와 동일한 Playwright 기반 evaluator 를 사용한다.",
-        "flutter": {
-          "_doc": "fe_target = web | mobile | desktop. by_target 으로 분기.",
-          "by_target": {
-            "web": {
-              "_doc": "Flutter Web — 컴파일 결과가 HTML+JS+CSS 이므로 Playwright evaluator 사용 가능",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional",
-              "evaluator-visual": "evaluator-visual"
-            },
-            "mobile": {
-              "_doc": "Flutter Mobile (Android/iOS) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            },
-            "desktop": {
-              "_doc": "Flutter Desktop (macOS/Windows/Linux) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            }
-          },
-          "_default_target": "mobile"
-        }
       }
     },
     "sprint_execution": {

package/assets/templates/gitignore-append.txt

@@ -0,0 +1 @@
+# For consumer projects, add .worktrees/ to .gitignore

package/bin/init.js

@@ -231,6 +231,7 @@ function installScripts() {
     'harness-control-v4.sh',
     'harness-queue-manager.sh',
     'harness-team-worker.sh',
+    'harness-prompts-v4.sh',
   ]);
 
   if (fs.existsSync(scriptsSrc)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0-alpha.20",
   "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-v4.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
-# harness-dashboard-v4.sh — v4 Dashboard: Feature Queue + Team Status
-# Auto-refresh 3초 간격. feature-queue.json + feature-list.json 시각화.
+# harness-dashboard-v4.sh — v4 Dashboard 상단: Planner Progress
+# Queue + Teams + Features 를 auto-refresh. 고정 영역, 스크롤 없음.
 
 set -uo pipefail
 
@@ -30,39 +30,34 @@ render_header() {
   now=$(date +"%H:%M:%S")
   project_name=$(jq -r '.project_name // "Unknown"' "$PROGRESS" 2>/dev/null)
 
-  echo -e "${BOLD}╔════════════════════════════════════════════════╗${RESET}"
-  echo -e "${BOLD}║  HARNESS v4 — Parallel Agent Teams             ║${RESET}"
-  echo -e "${BOLD}╚════════════════════════════════════════════════╝${RESET}"
-  echo -e "  ${DIM}${project_name}  |  ${now}${RESET}"
-  echo ""
+  echo -e "${BOLD}HARNESS v4${RESET} ${DIM}${project_name} | ${now}${RESET}"
 }
 
 render_queue_summary() {
   if [ ! -f "$QUEUE" ]; then
-    echo -e "  ${DIM}(queue not initialized — run 'init' in Control)${RESET}"
+    echo -e "  ${DIM}(queue not initialized)${RESET}"
     return
   fi
 
-  local ready blocked in_prog passed failed total concurrency
-  ready=$(jq '.queue.ready | length' "$QUEUE" 2>/dev/null)
-  blocked=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null)
-  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null)
-  passed=$(jq '.queue.passed | length' "$QUEUE" 2>/dev/null)
-  failed=$(jq '.queue.failed | length' "$QUEUE" 2>/dev/null)
-  concurrency=$(jq '.concurrency // 3' "$QUEUE" 2>/dev/null)
+  local ready blocked in_prog passed failed total
+  ready=$(jq '.queue.ready | length' "$QUEUE" 2>/dev/null || echo 0)
+  blocked=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
+  passed=$(jq '.queue.passed | length' "$QUEUE" 2>/dev/null || echo 0)
+  failed=$(jq '.queue.failed | length' "$QUEUE" 2>/dev/null || echo 0)
+  ready=${ready:-0}; blocked=${blocked:-0}; in_prog=${in_prog:-0}; passed=${passed:-0}; failed=${failed:-0}
   total=$((ready + blocked + in_prog + passed + failed))
 
-  # Progress bar
   local pct=0
   if [ "$total" -gt 0 ]; then pct=$(( passed * 100 / total )); fi
-  local bar_w=20 filled=$(( pct * bar_w / 100 )) empty=$(( bar_w - filled ))
+  local bar_w=16
+  local filled=$(( pct * bar_w / 100 ))
+  local empty=$(( bar_w - filled ))
   local bar=""
   for ((i=0; i<filled; i++)); do bar+="█"; done
   for ((i=0; i<empty; i++)); do bar+="░"; done
 
-  echo -e "  ${BOLD}Queue${RESET}  ${bar}  ${passed}/${total} (${pct}%)  ${DIM}concurrency=${concurrency}${RESET}"
-  echo -e "  Ready:${GREEN}${ready}${RESET}  Blocked:${YELLOW}${blocked}${RESET}  Progress:${CYAN}${in_prog}${RESET}  Pass:${GREEN}${passed}${RESET}  Fail:${RED}${failed}${RESET}"
-  echo ""
+  echo -e "  ${bar} ${passed}/${total} (${pct}%)  R:${GREEN}${ready}${RESET} B:${YELLOW}${blocked}${RESET} P:${CYAN}${in_prog}${RESET} ${GREEN}✓${passed}${RESET} ${RED}✗${failed}${RESET}"
 }
 
 render_teams() {
@@ -72,105 +67,87 @@ render_teams() {
   team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null)
   if [ "${team_count:-0}" -eq 0 ]; then return; fi
 
-  echo -e "  ${BOLD}Teams${RESET}"
-
   for i in $(seq 1 "$team_count"); do
     local t_status t_feature t_phase t_attempt
     t_status=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
     t_feature=$(jq -r ".teams[\"$i\"].feature // \"—\"" "$QUEUE" 2>/dev/null)
 
-    # Get phase from in_progress
     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)
     else
-      t_phase="—"
-      t_attempt="—"
+      t_phase="—"; t_attempt=""
     fi
 
     local icon color
     case "$t_status" in
-      busy)   icon="▶" ; color="$GREEN" ;;
-      idle)   icon="○" ; color="$DIM" ;;
-      paused) icon="⏸" ; color="$YELLOW" ;;
-      *)      icon="?" ; color="$RESET" ;;
+      busy)   icon="▶"; color="$GREEN" ;;
+      idle)   icon="○"; color="$DIM" ;;
+      *)      icon="?"; color="$RESET" ;;
     esac
 
-    local phase_display=""
+    local phase_short=""
     case "$t_phase" in
-      gen)  phase_display="${CYAN}GEN${RESET}" ;;
-      gate) phase_display="${YELLOW}GATE${RESET}" ;;
-      eval) phase_display="${MAGENTA}EVAL${RESET}" ;;
-      *)    phase_display="${DIM}${t_phase}${RESET}" ;;
+      gen)  phase_short="${CYAN}G${RESET}" ;;
+      gate) phase_short="${YELLOW}K${RESET}" ;;
+      eval) phase_short="${MAGENTA}E${RESET}" ;;
+      *)    phase_short="${DIM}-${RESET}" ;;
     esac
 
-    printf "  %b %b Team %d  %-8s %b  attempt %s\n" "$color" "$icon" "$i" "$t_feature" "$phase_display" "$t_attempt"
+    printf "  %b%b T%d %-7s %b" "$color" "$icon" "$i" "$t_feature" "$phase_short"
+    if [ -n "$t_attempt" ] && [ "$t_attempt" != "—" ]; then
+      printf " #%s" "$t_attempt"
+    fi
+    echo ""
   done
-  echo ""
 }
 
-render_feature_list() {
+render_features() {
   if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
 
-  local total
-  total=$(jq '.features | length' "$FEATURES" 2>/dev/null)
-  if [ "${total:-0}" -eq 0 ]; then return; fi
-
-  echo -e "  ${BOLD}Features${RESET}"
-
-  local i=0
-  while [ "$i" -lt "$total" ]; do
-    local fid fname status_icon
-    fid=$(jq -r ".features[$i].id" "$FEATURES" 2>/dev/null)
-    fname=$(jq -r ".features[$i].name // .features[$i].description // \"\"" "$FEATURES" 2>/dev/null)
-    if [ ${#fname} -gt 22 ]; then fname="${fname:0:20}.."; fi
-
-    # Determine status from queue
-    local in_passed in_failed in_progress in_ready in_blocked
-    in_passed=$(jq -r --arg f "$fid" '.queue.passed // [] | map(select(. == $f)) | length' "$QUEUE" 2>/dev/null)
-    in_failed=$(jq -r --arg f "$fid" '.queue.failed // [] | map(select(. == $f)) | length' "$QUEUE" 2>/dev/null)
-    in_progress=$(jq -r --arg f "$fid" '.queue.in_progress[$f] // empty' "$QUEUE" 2>/dev/null)
-    in_ready=$(jq -r --arg f "$fid" '.queue.ready // [] | map(select(. == $f)) | length' "$QUEUE" 2>/dev/null)
-
-    if [ "${in_passed:-0}" -gt 0 ]; then
-      status_icon="${GREEN}●${RESET}"
-    elif [ -n "$in_progress" ] && [ "$in_progress" != "" ]; then
-      local team phase
-      team=$(echo "$in_progress" | jq -r '.team // "?"' 2>/dev/null)
-      phase=$(echo "$in_progress" | jq -r '.phase // "?"' 2>/dev/null)
-      status_icon="${CYAN}◐${RESET} T${team}:${phase}"
-    elif [ "${in_failed:-0}" -gt 0 ]; then
-      status_icon="${RED}✗${RESET}"
-    elif [ "${in_ready:-0}" -gt 0 ]; then
-      status_icon="${YELLOW}○${RESET}"
-    else
-      status_icon="${DIM}◌${RESET}"  # blocked
-    fi
-
-    printf "  %b %-6s %-24s\n" "$status_icon" "$fid" "$fname"
-
-    i=$((i + 1))
+  jq -r --slurpfile q "$QUEUE" '
+    ($q[0].queue.passed // []) as $passed |
+    ($q[0].queue.failed // []) as $failed |
+    ($q[0].queue.ready // []) as $ready |
+    ($q[0].queue.in_progress // {}) as $prog |
+    .features[] |
+    .id as $fid |
+    (.name // .description // "?" | if length > 18 then .[0:16] + ".." else . end) as $fname |
+    (if ($fid | IN($passed[])) then "P"
+     elif $prog[$fid] then "I|\($prog[$fid].team)|\($prog[$fid].phase)"
+     elif ($fid | IN($failed[])) then "F"
+     elif ($fid | IN($ready[])) then "R"
+     else "B" end) as $st |
+    "\($st)\t\($fid)\t\($fname)"
+  ' "$FEATURES" 2>/dev/null | while IFS=$'\t' read -r st fid fname; do
+    case "$st" in
+      P)    printf "  ${GREEN}●${RESET} %-6s %s\n" "$fid" "$fname" ;;
+      F)    printf "  ${RED}✗${RESET} %-6s %s\n" "$fid" "$fname" ;;
+      R)    printf "  ${YELLOW}○${RESET} %-6s %s\n" "$fid" "$fname" ;;
+      B)    printf "  ${DIM}◌${RESET} %-6s %s\n" "$fid" "$fname" ;;
+      I\|*) team=$(echo "$st" | cut -d'|' -f2)
+            phase=$(echo "$st" | cut -d'|' -f3)
+            printf "  ${CYAN}◐${RESET} %-6s %-14s T%s:%s\n" "$fid" "$fname" "$team" "$phase" ;;
+      *)    printf "  ? %-6s %s\n" "$fid" "$fname" ;;
+    esac
   done
-  echo ""
 }
 
 render_all() {
   render_header
   render_queue_summary
   render_teams
-  render_feature_list
-  echo -e "  ${DIM}Refreshing every 3s${RESET}"
+  echo ""
+  render_features
 }
 
 # ── Main loop ──
 tput civis 2>/dev/null
 trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
-
 clear
 
 while true; do
-  local buf
-  buf=$(render_all 2>/dev/null)
+  buf=$(render_all 2>&1)
   tput cup 0 0 2>/dev/null
   echo "$buf"
   tput ed 2>/dev/null

package/scripts/harness-next.sh

@@ -59,21 +59,10 @@ if [ -f "$PIPELINE_JSON" ]; then
 fi
 
 # ─────────────────────────────────────────
-# fe_stack + fe_target 치환 헬퍼
-#   pipeline_selection.pipelines 에서 읽은 에이전트명을 fe_stack/fe_target 에 따라 치환
-#   - react: 그대로
-#   - flutter+web: generator-frontend → generator-frontend-flutter 만 치환, eval 은 그대로 (Playwright 사용 가능)
-#   - flutter+mobile/desktop: eval 도 정적 분석용으로 치환, evaluator-visual 은 __skip__
+# fe_stack 치환 (no-op — Flutter 지원 제거됨, 하위 호환용 stub)
 # ─────────────────────────────────────────
 substitute_fe_stack() {
-  local agent="$1"
-  if [ "$fe_stack" != "flutter" ]; then
-    echo "$agent"
-    return
-  fi
-  local sub
-  sub=$(jq -r ".flow.pipeline_selection.fe_stack_substitution.${fe_stack}.by_target[\"${fe_target}\"][\"${agent}\"] // \"${agent}\"" "$CONFIG" 2>/dev/null)
-  echo "$sub"
+  echo "$1"
 }
 
 # ─────────────────────────────────────────
@@ -105,7 +94,7 @@ run_pre_eval_gate() {
   # current_agent가 generator가 아닌 경우 (예: dispatcher로 리라우팅된 상태),
   # completed_agents에서 마지막 generator를 찾는다
   case "$source_agent" in
-    generator-frontend|generator-frontend-flutter)
+    generator-frontend)
       location="frontend"
       checks_key="frontend_checks"
       ;;
@@ -118,7 +107,7 @@ run_pre_eval_gate() {
       local last_gen
       last_gen=$(jq -r '.completed_agents // [] | map(select(startswith("generator-"))) | last // empty' "$PROGRESS" 2>/dev/null)
       case "$last_gen" in
-        generator-frontend|generator-frontend-flutter)
+        generator-frontend)
           location="frontend"
           checks_key="frontend_checks"
           ;;

package/scripts/harness-prompts-v4.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+# harness-prompts-v4.sh — v4 Dashboard 하단: Manual Prompts + Activity
+# progress.log에서 user-prompt와 team 활동을 newest-first로 표시.
+# 스크롤 가능 영역 — 프롬프트가 많아져도 상단 Progress를 가리지 않음.
+
+set -uo 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 "[prompts] .harness/ not found."; exit 1; }
+fi
+
+LOG_FILE="$PROJECT_ROOT/.harness/progress.log"
+
+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_LINE_COUNT=0
+
+render_prompts() {
+  if [ ! -f "$LOG_FILE" ]; then
+    echo -e "  ${DIM}(progress.log not found)${RESET}"
+    return
+  fi
+
+  local term_h
+  term_h=$(tput lines 2>/dev/null || echo 20)
+  local max_lines=$((term_h - 3))  # Leave room for header
+  if [ "$max_lines" -lt 5 ]; then max_lines=5; fi
+
+  echo -e "${BOLD}Prompts & Activity${RESET} ${DIM}(newest first)${RESET}"
+  echo ""
+
+  # Read all entries, reverse, limit to terminal height
+  grep -v '^#' "$LOG_FILE" 2>/dev/null | grep -v '^$' | \
+  tail -r 2>/dev/null | head -"$max_lines" | \
+  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 icon color
+    short_ts=$(echo "$ts" | sed 's/^[0-9]*-//')
+
+    case "$agent" in
+      user-prompt)
+        icon="★"; color="$BOLD"
+        # User prompts get full width, highlighted
+        if [ ${#detail} -gt 60 ]; then detail="${detail:0:58}.."; fi
+        echo -e "  ${color}${icon} ${short_ts}${RESET} ${detail}"
+        ;;
+      dispatcher*)
+        icon="▸"; color="$MAGENTA"
+        if [ ${#detail} -gt 50 ]; then detail="${detail:0:48}.."; fi
+        echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
+        ;;
+      team-*)
+        icon="⚡"; color="$CYAN"
+        if [ ${#detail} -gt 50 ]; then detail="${detail:0:48}.."; fi
+        # Color by action type
+        case "$action" in
+          *pass*)  color="$GREEN"; icon="✓" ;;
+          *fail*)  color="$RED";   icon="✗" ;;
+          *eval*)  color="$MAGENTA"; icon="✦" ;;
+          *gen*)   color="$CYAN";  icon="▶" ;;
+          *merge*) color="$GREEN"; icon="⊕" ;;
+        esac
+        echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
+        ;;
+      manual)
+        icon="★"; color="$YELLOW"
+        if [ ${#detail} -gt 50 ]; then detail="${detail:0:48}.."; fi
+        echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${detail}"
+        ;;
+      *)
+        icon="·"; color="$DIM"
+        if [ ${#detail} -gt 50 ]; then detail="${detail:0:48}.."; fi
+        echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
+        ;;
+    esac
+  done
+}
+
+# ── Main loop ──
+tput civis 2>/dev/null
+trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
+clear
+
+while true; do
+  buf=$(render_prompts 2>&1)
+  tput cup 0 0 2>/dev/null
+  echo "$buf"
+  tput ed 2>/dev/null
+  sleep 3
+done

package/scripts/harness-queue-manager.sh

@@ -42,6 +42,25 @@ fi
 FEATURES="$PROJECT_ROOT/.harness/actions/feature-list.json"
 QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
 CONFIG="$PROJECT_ROOT/.harness/config.json"
+QUEUE_LOCK="$PROJECT_ROOT/.harness/.queue-lock"
+
+# ── Atomic queue lock — prevent race conditions between teams ──
+acquire_queue_lock() {
+  local max_wait=30 waited=0
+  while ! mkdir "$QUEUE_LOCK" 2>/dev/null; do
+    sleep 0.1
+    waited=$((waited + 1))
+    if [ "$waited" -ge $((max_wait * 10)) ]; then
+      rm -rf "$QUEUE_LOCK"
+      mkdir "$QUEUE_LOCK" 2>/dev/null || true
+      break
+    fi
+  done
+}
+
+release_queue_lock() {
+  rm -rf "$QUEUE_LOCK" 2>/dev/null || true
+}
 
 # ── Concurrency from config ──
 CONCURRENCY=3
@@ -122,12 +141,14 @@ cmd_dequeue() {
   if [ -z "$team_id" ]; then echo "[queue] Usage: dequeue <team_id>"; exit 1; fi
   if [ ! -f "$QUEUE" ]; then echo "[queue] Run 'init' first."; exit 1; fi
 
+  acquire_queue_lock
+
   local feature
   feature=$(jq -r '.queue.ready[0] // empty' "$QUEUE")
 
   if [ -z "$feature" ]; then
+    release_queue_lock
     echo "[queue] No features in ready queue."
-    # Check if all done
     local in_prog blocked
     in_prog=$(jq '.queue.in_progress | length' "$QUEUE")
     blocked=$(jq '.queue.blocked | length' "$QUEUE")
@@ -137,13 +158,13 @@ cmd_dequeue() {
     return 1
   fi
 
-  # Move feature from ready → in_progress, assign to team
   jq --arg fid "$feature" --arg tid "$team_id" '
     .queue.ready -= [$fid] |
     .queue.in_progress[$fid] = { team: ($tid | tonumber), phase: "gen", attempt: 1 } |
     .teams[$tid] = { status: "busy", feature: $fid, branch: ("feature/" + $fid), pid: null }
   ' "$QUEUE" > "${QUEUE}.tmp" && mv "${QUEUE}.tmp" "$QUEUE"
 
+  release_queue_lock
   echo "$feature"
 }
 
@@ -155,11 +176,11 @@ cmd_pass() {
   if [ -z "$fid" ]; then echo "[queue] Usage: pass <feature_id>"; exit 1; fi
   if [ ! -f "$QUEUE" ]; then echo "[queue] Run 'init' first."; exit 1; fi
 
-  # Get team that was working on this feature
+  acquire_queue_lock
+
   local team_id
   team_id=$(jq -r --arg fid "$fid" '.queue.in_progress[$fid].team // empty' "$QUEUE")
 
-  # Move from in_progress → passed, free team, unblock dependents
   jq --arg fid "$fid" --arg tid "${team_id:-0}" '
     # Remove from in_progress
     del(.queue.in_progress[$fid]) |
@@ -188,6 +209,7 @@ cmd_pass() {
 
   local newly_ready
   newly_ready=$(jq -r '.queue.ready | join(", ")' "$QUEUE")
+  release_queue_lock
   echo "[queue] $fid PASSED. Ready: [$newly_ready]"
 }
 
@@ -199,6 +221,8 @@ cmd_fail() {
   if [ -z "$fid" ]; then echo "[queue] Usage: fail <feature_id>"; exit 1; fi
   if [ ! -f "$QUEUE" ]; then exit 1; fi
 
+  acquire_queue_lock
+
   local team_id
   team_id=$(jq -r --arg fid "$fid" '.queue.in_progress[$fid].team // empty' "$QUEUE")
 
@@ -211,6 +235,7 @@ cmd_fail() {
     else . end)
   ' "$QUEUE" > "${QUEUE}.tmp" && mv "${QUEUE}.tmp" "$QUEUE"
 
+  release_queue_lock
   echo "[queue] $fid FAILED."
 }
 
@@ -239,6 +264,8 @@ cmd_update_phase() {
     exit 1
   fi
 
+  acquire_queue_lock
+
   local jq_expr
   jq_expr=".queue.in_progress[\"$fid\"].phase = \"$phase\""
   if [ -n "$attempt" ]; then
@@ -246,6 +273,7 @@ cmd_update_phase() {
   fi
 
   jq "$jq_expr" "$QUEUE" > "${QUEUE}.tmp" && mv "${QUEUE}.tmp" "$QUEUE"
+  release_queue_lock
 }
 
 # ══════════════════════════════════════════
@@ -297,6 +325,31 @@ cmd_status() {
   fi
 }
 
+# ══════════════════════════════════════════
+# recover — Move stale in_progress back to ready (after studio restart)
+# ══════════════════════════════════════════
+cmd_recover() {
+  if [ ! -f "$QUEUE" ]; then echo "[queue] Not initialized."; return; fi
+
+  local stale_count
+  stale_count=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null)
+
+  if [ "${stale_count:-0}" -eq 0 ]; then
+    echo "[queue] No stale in_progress entries."
+    return
+  fi
+
+  # Move all in_progress → ready, reset all teams to idle
+  jq '
+    .queue.ready += [.queue.in_progress | keys[]] |
+    .queue.ready |= unique |
+    .queue.in_progress = {} |
+    .teams |= with_entries(.value = { status: "idle", feature: null, branch: null, pid: null })
+  ' "$QUEUE" > "${QUEUE}.tmp" && mv "${QUEUE}.tmp" "$QUEUE"
+
+  echo "[queue] Recovered ${stale_count} stale features back to ready queue."
+}
+
 # ── Dispatch ──
 case "$CMD" in
   init)         cmd_init ;;
@@ -305,9 +358,10 @@ case "$CMD" in
   fail)         cmd_fail "$@" ;;
   requeue)      cmd_requeue "$@" ;;
   update_phase) cmd_update_phase "$@" ;;
+  recover)      cmd_recover ;;
   status)       cmd_status ;;
   *)
-    echo "Usage: harness-queue-manager.sh <init|dequeue|pass|fail|requeue|update_phase|status> [args]"
+    echo "Usage: harness-queue-manager.sh <init|dequeue|pass|fail|requeue|recover|update_phase|status> [args]"
     exit 1
     ;;
 esac

package/scripts/harness-session-start.sh

@@ -26,6 +26,24 @@ current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
 next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
 agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
 
+# ─────────────────────────────────────────
+# v4 Parallel Mode — feature-queue.json이 존재하면 v4 안내
+# ─────────────────────────────────────────
+FEATURE_QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+if [ -f "$FEATURE_QUEUE" ]; then
+  passed=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  total=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  failed=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+
+  echo "# Harness v4 — Parallel Agent Teams active"
+  echo "# Queue: ${passed}/${total} passed, ${in_prog} in progress, ${failed} failed"
+  echo "# Teams are running autonomously. You are the orchestrator."
+  echo "# Role: Monitor dashboard, resolve failures, manual interventions only."
+  echo "# Do NOT run /harness-generator-* or /harness-evaluator-* — Teams handle Gen+Eval."
+  exit 0
+fi
+
 # ─────────────────────────────────────────
 # init 상태: 첫 안내
 # ─────────────────────────────────────────