@walwal-harness/cli 4.0.0-beta.7 → 4.0.0-beta.9

package/package.json

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

@@ -285,44 +285,44 @@ cleanup() {
 }
 trap cleanup EXIT INT TERM
 
-# v4 감지: feature-queue.json 존재 여부
-IS_V4=false
-if [ -f "$QUEUE" ]; then
-  IS_V4=true
-fi
+# 매 루프마다 v4/v3 동적 감지 — 시작 후에도 모드 전환 가능
+tput civis 2>/dev/null
+clear
+
+CURRENT_MODE=""
+
+while true; do
+  # 동적 모드 감지
+  if [ -f "$QUEUE" ]; then
+    NEW_MODE="v4"
+  else
+    NEW_MODE="v3"
+  fi
 
-if [ "$IS_V4" = true ]; then
-  # ── v4: 팀별 섹션, auto-refresh ──
-  tput civis 2>/dev/null
-  clear
+  # 모드 전환 시 화면 초기화
+  if [ "$NEW_MODE" != "$CURRENT_MODE" ]; then
+    clear
+    CURRENT_MODE="$NEW_MODE"
+    if [ "$CURRENT_MODE" = "v3" ]; then
+      # v3 초기화
+      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
+      stream_audit
+    fi
+  fi
 
-  while true; do
+  if [ "$CURRENT_MODE" = "v4" ]; then
     buf=$(render_v4 2>&1)
     tput cup 0 0 2>/dev/null
     echo "$buf"
     tput ed 2>/dev/null
-    sleep 3
-  done
-else
-  # ── v3: 단일 스트림, audit tail ──
-  print_v3_header
-
-  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)
-
-    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 ""
+  else
+    check_transitions
   fi
 
-  stream_audit
+  sleep 3
+done
 
-  while true; do
-    check_transitions
-    sleep 2
-  done
-fi

package/skills/team-action/SKILL.md

@@ -73,9 +73,34 @@ Agent({
 ## 할당된 Feature
 - Feature ID: {FEATURE_ID}
 - 프로젝트 루트: 현재 디렉토리 (worktree 복사본)
+- 하네스 루트: 메인 프로젝트 루트 (worktree가 아닌 원본)
+
+## 실시간 로깅 (필수)
+
+모든 Phase 전환 시 반드시 아래 두 명령을 실행하세요. Monitor 대시보드에 실시간 반영됩니다.
+
+**progress.log 기록** (하네스 루트의 progress.log에 append):
+```bash
+echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | {ACTION} | {DETAIL}" >> {HARNESS_ROOT}/.harness/progress.log
+```
+
+**queue phase 업데이트** (feature-queue.json의 팀 상태 갱신):
+```bash
+bash {HARNESS_ROOT}/scripts/harness-queue-manager.sh update_phase {FEATURE_ID} {PHASE} .
+```
+
+> {HARNESS_ROOT}는 worktree의 원본 프로젝트 경로입니다. `git worktree list` 첫 줄에서 확인 가능합니다.
+> 워커 시작 시 먼저 실행: `HARNESS_ROOT=$(git worktree list | head -1 | awk '{print $1}')`
 
 ## Phase 1: Generator (코드 생성)
 
+**시작 시 로깅:**
+```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"
+bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} gen "$HARNESS_ROOT"
+```
+
 1. Feature 정보 확인:
    - `jq '.features[] | select(.id == "{FEATURE_ID}")' .harness/actions/feature-list.json`
    - `.harness/actions/api-contract.json`에서 관련 엔드포인트 확인
@@ -90,8 +115,19 @@ Agent({
    - eslint (린트) 실행
    - 컴파일 에러가 있으면 직접 수정 (Eval에 넘기지 않음)
 
+**Gen 완료 로깅:**
+```bash
+echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | gen | {FEATURE_ID} done — {변경파일수} files" >> "$HARNESS_ROOT/.harness/progress.log"
+```
+
 ## Phase 2: Evaluator (독립 평가 — Agent 도구 사용)
 
+**Eval 시작 로깅:**
+```bash
+echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | eval | {FEATURE_ID} eval start" >> "$HARNESS_ROOT/.harness/progress.log"
+bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" update_phase {FEATURE_ID} eval "$HARNESS_ROOT"
+```
+
 코드 생성이 완료되면 **별도 Agent를 생성하여 평가**합니다.
 이 Evaluator Agent는 당신(Generator)의 추론 과정을 모릅니다.
 오직 코드와 AC만 보고 판단합니다.
@@ -137,15 +173,24 @@ FEEDBACK: (FAIL인 경우만) 구체적 수정 지시
 Evaluator Agent 결과를 확인합니다:
 
 ### PASS인 경우 (VERDICT: PASS, SCORE ≥ 2.80):
-1. `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행
-2. 변경 파일 목록과 AC 충족 요약을 Lead에게 반환
+```bash
+echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | pass | {FEATURE_ID} PASS score={SCORE}" >> "$HARNESS_ROOT/.harness/progress.log"
+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"
+```
 1. Evaluator의 FEEDBACK을 읽고 코드를 수정 (Phase 1로 돌아감)
 2. 수정 후 다시 Phase 2 (새 Evaluator Agent 생성 — 이전 Eval 컨텍스트 없음)
 3. 최대 3회 시도. 3회 모두 FAIL이면:
-   - `bash scripts/harness-queue-manager.sh fail {FEATURE_ID} .` 실행
-   - 실패 사유와 마지막 Eval 결과를 Lead에게 반환
+   ```bash
+   echo "$(date +'%Y-%m-%d %H:%M') | team-{N} | fail | {FEATURE_ID} FINAL FAIL after 3 attempts" >> "$HARNESS_ROOT/.harness/progress.log"
+   bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" fail {FEATURE_ID} "$HARNESS_ROOT"
+   ```
+   실패 사유와 마지막 Eval 결과를 Lead에게 반환.
 ```
 
 ## Step 4: 결과 수집 및 다음 라운드