@walwal-harness/cli 5.0.9 → 5.1.0

package/commands/harness-team.md

@@ -210,6 +210,22 @@ Agent({
   prompt: "당신은 독립 Evaluator입니다. Generator가 작성한 코드를 AC 기준으로 냉정하게 평가합니다.
 Generator의 의도나 추론 과정은 알 수 없습니다. 오직 코드와 결과만 봅니다.
 
+## 실시간 로깅 (필수)
+
+평가 진행 상황을 실시간으로 기록합니다. **각 AC 검증마다 반드시 logev를 호출**하세요.
+
+```bash
+HARNESS_ROOT=$(git worktree list | head -1 | awk '{print $1}')
+LOG=\"$HARNESS_ROOT/.harness/progress.log\"
+logev() { echo \"$(date +'%Y-%m-%d %H:%M') | team-{N} | $1 | $2\" >> \"$LOG\"; }
+```
+
+**로깅 시점:**
+1. 평가 시작 즉시: `logev eval-start \"{FEATURE_ID} evaluating — {AC수} ACs\"`
+2. 각 AC 검증 후: `logev eval-check \"{FEATURE_ID} AC-{N}: [PASS/FAIL] {근거 요약}\"`
+3. tsc/eslint 검증 후: `logev eval-check \"{FEATURE_ID} gate: tsc {OK/FAIL}, eslint {OK/FAIL}\"`
+4. 최종 판정: `logev eval-done \"{FEATURE_ID} VERDICT={PASS/FAIL} SCORE={X.XX}/3.00\"`
+
 ## 평가 대상
 - Feature ID: {FEATURE_ID}
 - AC: jq '.features[] | select(.id == \"{FEATURE_ID}\").acceptance_criteria' .harness/actions/feature-list.json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.0.9",
+  "version": "5.1.0",
   "description": "Production harness for AI agent engineering — Solo/Team mode, Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer. Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-dashboard.sh

@@ -40,7 +40,7 @@ strip_ansi() {
 }
 
 get_term_width() {
-  tput cols 2>/dev/null || echo 80
+  echo "${_COLS:-$(tput cols 2>/dev/null || echo 80)}"
 }
 
 get_mode() {
@@ -150,14 +150,28 @@ render_solo_prompt_history() {
       local short_ts icon color
       short_ts=$(echo "$ts" | sed 's/^[0-9]*-//')
 
-      case "$agent" in
-        dispatcher*)  icon="▸" ; color="$MAGENTA" ;;
-        planner*)     icon="□" ; color="$YELLOW" ;;
-        generator*)   icon="▶" ; color="$GREEN" ;;
-        eval*)        icon="✦" ; color="$RED" ;;
-        team-*)       icon="◆" ; color="$CYAN" ;;
-        user*)        icon="★" ; color="$BOLD" ;;
-        *)            icon="·" ; color="$DIM" ;;
+      # action 기반으로 먼저 분류 (team 모드에서 agent=team-N이므로)
+      case "$action" in
+        eval-start|eval-check|eval-done|eval)
+          icon="✦" ; color="$MAGENTA" ;;
+        gen-start|gen-read|gen-write|gen-test|gen-done|gen)
+          icon="▶" ; color="$GREEN" ;;
+        result|pass)
+          icon="✓" ; color="$GREEN" ;;
+        fail)
+          icon="✗" ; color="$RED" ;;
+        *)
+          # fallback: agent 기반
+          case "$agent" in
+            dispatcher*)  icon="▸" ; color="$MAGENTA" ;;
+            planner*)     icon="□" ; color="$YELLOW" ;;
+            generator*)   icon="▶" ; color="$GREEN" ;;
+            eval*)        icon="✦" ; color="$MAGENTA" ;;
+            team-*)       icon="◆" ; color="$CYAN" ;;
+            user*)        icon="★" ; color="$BOLD" ;;
+            *)            icon="·" ; color="$DIM" ;;
+          esac
+          ;;
       esac
 
       if [ ${#detail} -gt 40 ]; then detail="${detail:0:38}.."; fi
@@ -331,9 +345,10 @@ render_archive_prompts() {
   total_prompts=$(echo "$all_prompts" | wc -l | tr -d ' ')
 
   # 마지막 프롬프트를 제외한 모든 프롬프트 = archived (처리 완료)
+  # newest first (tac), 전체 출력 (제한 없음)
   local archived
   if [ "$total_prompts" -le 1 ]; then return; fi
-  archived=$(echo "$all_prompts" | head -n $((total_prompts - 1)) | tail -8)
+  archived=$(echo "$all_prompts" | head -n $((total_prompts - 1)) | tac)
 
   echo ""
   echo -e "${BOLD}Archive Prompt${RESET}  ${DIM}(처리 완료)${RESET}"
@@ -350,10 +365,6 @@ render_archive_prompts() {
 
     echo -e "  ${GREEN}✓${RESET} ${DIM}${short_ts}${RESET}  ${detail}"
   done
-
-  if [ "$total_prompts" -gt 9 ]; then
-    echo -e "  ${DIM}… +$((total_prompts - 9)) more${RESET}"
-  fi
 }
 
 # ══════════════════════════════════════════
@@ -396,6 +407,9 @@ trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
 clear
 
 while true; do
+  _ROWS=$(tput lines 2>/dev/null || echo 30)
+  _COLS=$(tput cols 2>/dev/null || echo 80)
+  export _ROWS _COLS
   buf=$(render_dashboard 2>&1)
   tput cup 0 0 2>/dev/null
   echo "$buf"

package/scripts/harness-monitor.sh

@@ -159,8 +159,14 @@ render_team_section() {
         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" ;;
+          eval-start)
+            a_icon="✦"; a_color="$MAGENTA"; a_label="Eval" ;;
+          eval-check)
+            a_icon="·"; a_color="$MAGENTA"; a_label="Eval" ;;
+          eval-done)
+            a_icon="✦"; a_color="${BOLD}${MAGENTA}"; a_label="Eval" ;;
+          eval)
+            a_icon="✦"; a_color="$MAGENTA"; a_label="Eval" ;;
           result|pass)
             a_icon="✓"; a_color="$GREEN"; a_label="Result" ;;
           fail)

package/scripts/harness-prompt-history.sh

@@ -96,34 +96,30 @@ render_processing_status() {
   echo ""
 }
 
-# 사용자 프롬프트만 필터하여 표시
+# 사용자 프롬프트만 필터하여 표시 (newest first, 전체 출력)
 render_user_prompts() {
   if [ ! -f "$PROGRESS_LOG" ]; then
     echo -e "  ${DIM}(프롬프트 기록 없음)${RESET}"
     return
   fi
 
-  local term_height
-  term_height=$(tput lines 2>/dev/null || echo 30)
-  local max_lines=$((term_height - 10))
-  if [ "$max_lines" -lt 5 ]; then max_lines=5; fi
-
-  # user-prompt 행만 필터
+  # user-prompt 행만 필터 → tac으로 newest first
   local prompts
-  prompts=$(grep '| user-prompt |' "$PROGRESS_LOG" 2>/dev/null | tail -"$max_lines")
+  prompts=$(grep '| user-prompt |' "$PROGRESS_LOG" 2>/dev/null | tac)
 
   if [ -z "$prompts" ]; then
     echo -e "  ${DIM}(사용자 프롬프트 없음)${RESET}"
     return
   fi
 
-  local line_num=0
   local total_prompts
-  total_prompts=$(grep -c '| user-prompt |' "$PROGRESS_LOG" 2>/dev/null || echo 0)
+  total_prompts=$(echo "$prompts" | wc -l | tr -d ' ')
 
-  echo "$prompts" | while IFS= read -r line; do
-    line_num=$((line_num + 1))
+  # 터미널 폭: main loop에서 측정한 _COLS 사용 (subshell 내 tput 불가 대비)
+  local max_width=$(( ${_COLS:-80} - 12 ))
+  if [ "$max_width" -lt 20 ]; then max_width=20; fi
 
+  echo "$prompts" | while IFS= read -r line; do
     local ts detail
     ts=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$1); print $1}')
     detail=$(echo "$line" | awk -F'|' '{gsub(/^ +| +$/,"",$4); print $4}')
@@ -131,20 +127,10 @@ render_user_prompts() {
     local short_ts
     short_ts=$(echo "$ts" | grep -oE '[0-9]{2}:[0-9]{2}' | tail -1 || echo "$ts")
 
-    # 프롬프트 내용 truncate
-    local max_width
-    max_width=$(( $(tput cols 2>/dev/null || echo 40) - 12 ))
-    if [ "$max_width" -lt 20 ]; then max_width=20; fi
     if [ ${#detail} -gt "$max_width" ]; then
       detail="${detail:0:$((max_width - 2))}.."
     fi
 
-    # 처리 상태 찾기: 이 프롬프트 이후의 첫 번째 에이전트 액션
-    local processed_by=""
-    local prompt_ts_epoch
-    prompt_ts_epoch=$(echo "$ts" | sed 's/[^0-9:]//g')
-
-    # 간단히: 마지막 프롬프트인지 확인 → 현재 처리 중 표시
     echo -e "  ${DIM}${short_ts}${RESET}  ${WHITE}${detail}${RESET}"
   done
 
@@ -164,6 +150,10 @@ trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
 clear
 
 while true; do
+  # subshell 내 tput 불가 → 미리 터미널 크기 측정
+  _ROWS=$(tput lines 2>/dev/null || echo 30)
+  _COLS=$(tput cols 2>/dev/null || echo 80)
+  export _ROWS _COLS
   buf=$(render_all 2>&1)
   tput cup 0 0 2>/dev/null
   echo "$buf"

package/skills/planner/SKILL.md

@@ -75,10 +75,58 @@ disable-model-invocation: true
 ## Constraints
 
 - 기술 구현 세부사항은 Generator에 위임
-- Sprint당 기능 3-5개 권장
 - 각 기능에 `layer`, `service`, `depends_on` 명시
 - API 계약의 스키마는 Pydantic/class-validator로 직접 변환 가능한 수준
 
+## Team 병렬 스케줄링 규칙 (필수)
+
+Team Mode는 **최대 3팀이 동시 작업**한다. Planner는 feature-list.json 설계 시 다음 규칙을 반드시 준수한다.
+
+### 핵심 원칙: Sprint 시작 시 ready ≥ 3
+
+Sprint 시작 시점에 `depends_on`이 모두 충족된(또는 비어 있는) feature가 **최소 3개** 있어야 3팀이 즉시 가동된다. ready가 1~2개이면 나머지 팀은 유휴 상태가 된다.
+
+### 의존성 그래프 형태
+
+**금지 — 직렬 체인:**
+```
+F-001 → F-002 → F-003 → F-004  (ready=1, 1팀만 작업)
+```
+
+**권장 — 넓은 DAG (fan-out):**
+```
+           ┌→ F-002 (no deps)
+Foundation → F-003 (no deps)      (ready=3, 3팀 동시)
+           └→ F-004 (no deps)
+                    ↓
+                  F-005 (depends_on: [F-002, F-003])
+```
+
+### Sprint 설계 체크리스트
+
+1. **Sprint당 feature 수**: `팀수 × 2` 이상 (3팀 = 최소 6개)
+   - 3개는 즉시 시작, 나머지는 앞선 feature 완료 시 투입
+   - 팀이 PASS 후 대기하지 않고 바로 다음 feature를 가져감
+2. **동시 ready 보장**: Sprint 내 feature 중 `depends_on: []`인 것이 ≥ 3개
+3. **의존성 깊이(critical path) 최소화**: 같은 Sprint 내 체인 깊이 ≤ 2단계
+4. **layer 분산**: 같은 Sprint에 backend-only, frontend-only, fullstack을 혼합하여 서로 독립적으로 작업 가능
+5. **Feature 분할**: 하나의 큰 feature 대신 독립 AC 그룹으로 분할
+   - 예: "대시보드 전체" (1개) → "통계 카드" + "차트 영역" + "최근 활동" (3개, 동시 작업 가능)
+
+### 검증: ready count 시뮬레이션
+
+feature-list.json 완성 후, Sprint별 ready count를 머릿속으로 시뮬레이션한다:
+
+```
+Sprint N 시작 → ready 목록 계산
+  ready ≥ 3  → OK (3팀 동시 가동)
+  ready = 2  → WARNING (1팀 유휴)
+  ready = 1  → FAIL → feature 분할 또는 의존성 제거 필요
+  ready = 0  → CRITICAL → 이전 Sprint 의존성 재설계 필요
+```
+
+ready가 3 미만인 Sprint가 있으면 **feature를 더 작게 분할하거나 의존성을 제거**하여 수정한다.
+
 ## After Completion
 
 1. 사용자에게 plan.md + api-contract.json 리뷰 요청