@walwal-harness/cli 4.0.0-beta.12 → 4.0.0-beta.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.12",
+  "version": "4.0.0-beta.13",
   "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-monitor.sh

@@ -10,7 +10,19 @@ set -uo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
-PROJECT_ROOT="${1:-}"
+# ── Args ──
+# Usage: harness-monitor.sh [project-root] [--team N]
+#   --team N  → 단일 팀만 렌더 (tmux per-team pane 용도)
+PROJECT_ROOT=""
+TEAM_FILTER=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --team) TEAM_FILTER="$2"; shift 2 ;;
+    --team=*) TEAM_FILTER="${1#--team=}"; shift ;;
+    *) [ -z "$PROJECT_ROOT" ] && PROJECT_ROOT="$1"; shift ;;
+  esac
+done
+
 if [ -z "$PROJECT_ROOT" ]; then
   source "$SCRIPT_DIR/lib/harness-render-progress.sh"
   PROJECT_ROOT="$(resolve_harness_root ".")" || {
@@ -58,8 +70,18 @@ render_v4_header() {
   echo ""
 }
 
+# 고정폭 배너 구분선 (터미널 너비에 맞춰 채움)
+banner_line() {
+  local cols
+  cols=$(tput cols 2>/dev/null || echo 78)
+  local line=""
+  for ((i=0; i<cols; i++)); do line+="━"; done
+  echo "$line"
+}
+
 render_team_section() {
   local team_num="$1"
+  local log_lines="${2:-10}"
   local color
   color=$(team_color "$team_num")
 
@@ -90,89 +112,115 @@ render_team_section() {
     *)    phase_str="" ;;
   esac
 
-  # 헤더 라인
-  printf "%b%b T%s%b " "$color" "$icon" "$team_num" "$RESET"
+  # ── 큰 배너 ──
+  local bar
+  bar=$(banner_line)
+  printf "%b%s%b\n" "$color" "$bar" "$RESET"
+
+  printf "%b%b TEAM %s%b" "$color$BOLD" "$icon" "$team_num" "$RESET"
   if [ "$t_feature" != "—" ] && [ "$t_feature" != "null" ]; then
-    printf "%s " "$t_feature"
+    printf "  %b%s%b" "$BOLD" "$t_feature" "$RESET"
     if [ -n "$phase_str" ]; then
-      printf "%b%s%b" "$color" "$phase_str" "$RESET"
+      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"
+      printf " %battempt #%s%b" "$YELLOW" "$t_attempt" "$RESET"
     fi
   else
-    printf "%bidle%b" "$DIM" "$RESET"
+    printf "  %bidle%b" "$DIM" "$RESET"
   fi
   echo ""
+  printf "%b%s%b\n" "$color" "$bar" "$RESET"
 
-  # 팀 로그 (progress.log에서 team-N 엔트리만 추출)
+  # ── 팀 로그 ──
+  local have_logs=0
   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
+    local matched
+    matched=$(grep -E "team-${team_num}\b|team_${team_num}\b" "$PROGRESS_LOG" 2>/dev/null | tail -"$log_lines")
+    if [ -n "$matched" ]; then
+      have_logs=1
+      local cols
+      cols=$(tput cols 2>/dev/null || echo 78)
+      # 포맷: [ts] [icon agent] detail (너무 길면 터미널 너비에서 줄바꿈)
+      local prefix_w=18  # "  HH:MM  ✦ eval  "
+      local detail_w=$(( cols - prefix_w ))
+      [ "$detail_w" -lt 20 ] && detail_w=20
+
+      echo "$matched" | 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")
+
+        local a_icon="·" a_color="$DIM" a_label="$action"
+        case "$action" in
+          gen|gen-start|gen-read|gen-write|gen-test|gen-done)
+            a_icon="▶"; a_color="$GREEN"; a_label="Gen" ;;
+          eval|eval-start|eval-check|eval-done)
+            a_icon="✦"; a_color="$BLUE"; a_label="Eval" ;;
+          result|pass)
+            a_icon="✓"; a_color="$GREEN"; a_label="Result" ;;
+          fail)
+            a_icon="✗"; a_color="$RED"; a_label="Result" ;;
+          dequeue)  a_icon="→"; a_color="$CYAN"; a_label="Queue" ;;
+          gate)     a_icon="◆"; a_color="$YELLOW"; a_label="Gate" ;;
+          *)        a_icon="·"; a_color="$DIM"; a_label="$action" ;;
+        esac
+
+        # 첫 줄
+        local first="${detail:0:$detail_w}"
+        printf "  %b%s%b %b%s%b %-6s %s\n" \
+          "$DIM" "$short_ts" "$RESET" \
+          "$a_color" "$a_icon" "$RESET" \
+          "$a_label" "$first"
+        # 이어질 줄 (긴 detail 은 접지 않고 들여쓰기로 이어서 출력)
+        local rest="${detail:$detail_w}"
+        while [ -n "$rest" ]; do
+          local chunk="${rest:0:$detail_w}"
+          rest="${rest:$detail_w}"
+          printf "  %*s%s\n" "$prefix_w" "" "$chunk"
+        done
+      done
+    fi
+  fi
+  if [ "$have_logs" -eq 0 ]; then
+    printf "  %b(no activity)%b\n" "$DIM" "$RESET"
   fi
 }
 
 render_v4() {
+  # 단일 팀 모드 (tmux per-team pane)
+  if [ -n "$TEAM_FILTER" ]; then
+    local rows log_lines
+    rows=$(tput lines 2>/dev/null || echo 20)
+    log_lines=$(( rows - 5 ))
+    [ "$log_lines" -lt 3 ] && log_lines=3
+    render_team_section "$TEAM_FILTER" "$log_lines"
+    return
+  fi
+
   render_v4_header
 
-  # 팀 수 확인
   local team_count=3
   if [ -f "$QUEUE" ]; then
     team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 3)
   fi
+  [ "$team_count" -lt 1 ] && team_count=3
+
+  local rows per_team log_lines
+  rows=$(tput lines 2>/dev/null || echo 40)
+  per_team=$(( (rows - 2) / team_count ))
+  log_lines=$(( per_team - 5 ))
+  if [ "$log_lines" -lt 3 ]; then log_lines=3; fi
+  if [ "$log_lines" -gt 15 ]; then log_lines=15; fi
 
   for i in $(seq 1 "$team_count"); do
-    render_team_section "$i"
+    render_team_section "$i" "$log_lines"
     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
 }
 
 # ══════════════════════════════════════════
@@ -292,8 +340,8 @@ clear
 CURRENT_MODE=""
 
 while true; do
-  # 동적 모드 감지
-  if [ -f "$QUEUE" ]; then
+  # 동적 모드 감지 (--team 지정 시 항상 v4)
+  if [ -n "$TEAM_FILTER" ] || [ -f "$QUEUE" ]; then
     NEW_MODE="v4"
   else
     NEW_MODE="v3"

package/scripts/harness-tmux-v4.sh

@@ -2,11 +2,11 @@
 # harness-tmux-v4.sh — v4 Agent Teams: 원커맨드 실행
 #
 # ┌──────────────┬──────────────┬──────────────┐
-# │              │  Dashboard   │              │
-# │  Main Claude │  (v4 queue)  │  Team Monitor│
-# │  (Lead)      ├──────────────┤  (lifecycle) │
-# │              │  Prompt      │              │
-# │              │  History     │              │
+# │              │  Dashboard   │   TEAM 1     │
+# │  Main Claude │  (v4 queue)  ├──────────────┤
+# │  (Lead)      ├──────────────┤   TEAM 2     │
+# │              │  Prompt      ├──────────────┤
+# │              │  History     │   TEAM 3     │
 # └──────────────┴──────────────┴──────────────┘
 #
 # Usage:
@@ -80,10 +80,20 @@ PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y
 PANE_MID=$(tmux split-window -h -p 65 -t "$PANE_MAIN" -c "$PROJECT_ROOT" \
   -P -F '#{pane_id}')
 
-# 3. Split right section: Middle 45% | Right 55%
-PANE_RIGHT=$(tmux split-window -h -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
+# 3. Split right section: Middle 45% | Right 55% — Right는 TEAM 1 으로 시작
+PANE_T1=$(tmux split-window -h -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
   -P -F '#{pane_id}' \
-  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 1'")
+
+# 3b. Split TEAM 1 세로로 → TEAM 2 (하단 66%)
+PANE_T2=$(tmux split-window -v -p 66 -t "$PANE_T1" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 2'")
+
+# 3c. Split TEAM 2 세로로 → TEAM 3 (하단 50%)
+PANE_T3=$(tmux split-window -v -p 50 -t "$PANE_T2" -c "$PROJECT_ROOT" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\" --team 3'")
 
 # 4. Split middle pane vertically: Dashboard (top 45%) | Prompt History (bottom 55%)
 PANE_HISTORY=$(tmux split-window -v -p 55 -t "$PANE_MID" -c "$PROJECT_ROOT" \
@@ -109,7 +119,9 @@ fi
 tmux select-pane -t "$PANE_MAIN"    -T "Lead (Main Claude)"
 tmux select-pane -t "$PANE_MID"     -T "Dashboard"
 tmux select-pane -t "$PANE_HISTORY" -T "Prompt History"
-tmux select-pane -t "$PANE_RIGHT"   -T "Team Monitor"
+tmux select-pane -t "$PANE_T1"      -T "TEAM 1"
+tmux select-pane -t "$PANE_T2"      -T "TEAM 2"
+tmux select-pane -t "$PANE_T3"      -T "TEAM 3"
 
 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

package/skills/team-action/SKILL.md

@@ -66,7 +66,27 @@ Agent({
 
 ## 실시간 로깅 (필수)
 
-모든 Phase 전환 시 반드시 아래 두 명령을 실행하세요. Monitor 대시보드에 실시간 반영됩니다.
+Monitor 패널에서 **각 에이전트(Gen / Eval / Result)가 지금 무엇을 하고 있는지**가 보여야 합니다.
+Phase 전환뿐 아니라 **내부 하위 단계**(파일 읽기, 파일 쓰기, 테스트 실행, AC 검증 등)까지
+progress.log에 한 줄씩 남기세요. 대시보드는 3초마다 tail합니다.
+
+**로깅 원칙**
+- 의미 있는 동작마다 **한 줄씩** 즉시 기록 (파일 단위가 아니라 행위 단위)
+- ACTION 토큰은 아래 표에서 선택 (Monitor가 아이콘/색을 매핑)
+- DETAIL은 구체적으로 — 파일명, AC 번호, 에러 메시지 요약, 결정 사유
+
+| ACTION | 사용 시점 | DETAIL 예시 |
+|--------|-----------|-------------|
+| `gen-start`  | Gen Phase 시작 | `F-001 start — 6 AC` |
+| `gen-read`   | 소스/계약 읽기 | `read api-contract.json (POST /users)` |
+| `gen-write`  | 파일 생성/수정 | `write apps/service-user/src/user.controller.ts` |
+| `gen-test`   | 자체 게이트(tsc/eslint/jest) | `tsc OK · eslint 0 · jest 12/12` |
+| `gen-done`   | Gen Phase 종료 | `F-001 done — 5 files, 142 LOC` |
+| `eval-start` | Evaluator Agent 호출 시작 | `F-001 spawning evaluator` |
+| `eval-check` | AC 개별 검증 진행 | `AC-3 — verify POST /users returns 201` |
+| `eval-done`  | Eval 결과 수신 | `verdict=PASS score=2.95` |
+| `result` / `pass` | PASS 확정 | `F-001 PASS — queue.pass` |
+| `fail`       | FAIL 확정(재시도/최종) | `FAIL #1 — AC-2 missing` |
 
 **progress.log 기록** (하네스 루트의 progress.log에 append):
 ```bash
@@ -86,35 +106,53 @@ bash {HARNESS_ROOT}/scripts/harness-queue-manager.sh update_phase {FEATURE_ID} {
 **시작 시 로깅:**
 ```bash
 HARNESS_ROOT=$(git worktree list | head -1 | awk '{print $1}')
-echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | gen | {FEATURE_ID} start" >> "$HARNESS_ROOT/.harness/progress.log"
+LOG="$HARNESS_ROOT/.harness/progress.log"
+logev() { echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | $1 | $2" >> "$LOG"; }
+
+logev gen-start "{FEATURE_ID} start"
 bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} gen "$HARNESS_ROOT"
 ```
 
-1. Feature 정보 확인:
+1. Feature 정보 확인 — **각 읽기마다 로그**:
+   ```bash
+   logev gen-read "feature-list.json → {FEATURE_ID}"
+   logev gen-read "api-contract.json → {관련 엔드포인트}"
+   ```
    - `jq '.features[] | select(.id == "{FEATURE_ID}")' .harness/actions/feature-list.json`
    - `.harness/actions/api-contract.json`에서 관련 엔드포인트 확인
    - AC(Acceptance Criteria) 목록을 정확히 파악
 
-2. 코드 생성:
+2. 코드 생성 — **파일 쓰기마다 로그**:
+   ```bash
+   logev gen-write "apps/service-user/src/user.controller.ts"
+   logev gen-write "libs/shared-dto/src/user.dto.ts"
+   ```
    - AGENTS.md의 IA-MAP에 따라 올바른 디렉토리에 코드 작성
    - AC의 모든 항목을 충족하도록 구현
 
-3. Pre-eval 게이트 (자체):
+3. Pre-eval 게이트 (자체) — **결과 로그**:
+   ```bash
+   logev gen-test "tsc OK · eslint 0w 0e · jest 12/12"
+   ```
    - tsc (타입 체크) 실행
    - eslint (린트) 실행
    - 컴파일 에러가 있으면 직접 수정 (Eval에 넘기지 않음)
 
 **Gen 완료 로깅:**
 ```bash
-echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | gen | {FEATURE_ID} done — {변경파일수} files" >> "$HARNESS_ROOT/.harness/progress.log"
+logev gen-done "{FEATURE_ID} done — {변경파일수} files, {LOC} LOC"
 ```
 
 ## Phase 2: Evaluator (독립 평가 — Agent 도구 사용)
 
-**Eval 시작 로깅:**
+**Eval 시작 로깅 (하위 단계 포함):**
 ```bash
-echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | eval | {FEATURE_ID} eval start" >> "$HARNESS_ROOT/.harness/progress.log"
+logev eval-start "{FEATURE_ID} spawning evaluator"
 bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} eval "$HARNESS_ROOT"
+# Evaluator가 AC를 하나씩 검증할 때마다:
+# logev eval-check "AC-3 — POST /users returns 201"
+# 최종:
+# logev eval-done "verdict=PASS score=2.95"
 ```
 
 코드 생성이 완료되면 **별도 Agent를 생성하여 평가**합니다.
@@ -163,20 +201,20 @@ Evaluator Agent 결과를 확인합니다:
 
 ### PASS인 경우 (VERDICT: PASS, SCORE ≥ 2.80):
 ```bash
-echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | pass | {FEATURE_ID} PASS score={SCORE}" >> "$HARNESS_ROOT/.harness/progress.log"
+logev result "{FEATURE_ID} PASS score={SCORE} — merging"
 bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" pass {FEATURE_ID} "$HARNESS_ROOT"
 ```
 변경 파일 목록과 AC 충족 요약을 Lead에게 반환.
 
 ### FAIL인 경우:
 ```bash
-echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | fail | {FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}" >> "$HARNESS_ROOT/.harness/progress.log"
+logev fail "{FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}"
 ```
 1. Evaluator의 FEEDBACK을 읽고 코드를 수정 (Phase 1로 돌아감)
 2. 수정 후 다시 Phase 2 (새 Evaluator Agent 생성 — 이전 Eval 컨텍스트 없음)
 3. 최대 3회 시도. 3회 모두 FAIL이면:
    ```bash
-   echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | fail | {FEATURE_ID} FINAL FAIL after 3 attempts" >> "$HARNESS_ROOT/.harness/progress.log"
+   logev fail "{FEATURE_ID} FINAL FAIL after 3 attempts"
    bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" fail {FEATURE_ID} "$HARNESS_ROOT"
    ```
    실패 사유와 마지막 Eval 결과를 Lead에게 반환.