@walwal-harness/cli 5.0.6 → 5.0.8

package/commands/harness-team.md

@@ -242,16 +242,48 @@ logev fail "{FEATURE_ID} FAIL #{ATTEMPT} — {사유요약}"
    NEW_FEATURE=$(bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" dequeue {N} "$HARNESS_ROOT")
    logev gen-start "$NEW_FEATURE auto-acquired"
    ```
-3. `ready=0`이면 → "Team-{N} 대기 중 — 모든 할당 피처 완료" 반환
+3. `ready=0`이면 → next-sprint 시도:
+   ```bash
+   NEXT=$(bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" next-sprint "$HARNESS_ROOT" 2>&1)
+   if echo "$NEXT" | grep -q "Advancing"; then
+     NEW_FEATURE=$(bash "$HARNESS_ROOT/scripts/harness-queue-manager.sh" dequeue {N} "$HARNESS_ROOT")
+     logev gen-start "$NEW_FEATURE auto-acquired (next sprint)"
+   else
+     logev result "Team-{N} 완료 — 모든 Sprint 처리됨"
+   fi
+   ```
 ```
 
-### Step 5: 결과 수집 및 다음 라운드
+### Step 5: 결과 수집 + 재투입 루프 (반드시 반복)
+
+**중요: 이 Step은 모든 Agent가 반환될 때마다 반복 실행해야 합니다.**
+피처 PASS 시 blocked 피처가 unblock되므로, 유휴 팀에 즉시 새 피처를 할당해야 합니다.
+
+```
+LOOP:
+  1. 현재 라운드의 모든 Team Agent 결과 수집 (PASS/FAIL 확인)
+  2. Queue 상태 재확인:
+     bash scripts/harness-queue-manager.sh status .
+
+  3. ready > 0 이면:
+     → Step 3으로 돌아감 (새로 unblock된 피처를 dequeue하여 팀 생성)
+     → 최대 3팀까지 병렬 Agent 재생성
+     → 생성 후 다시 이 LOOP의 1번으로 돌아와 결과 대기
+
+  4. ready = 0 AND in_progress > 0 이면:
+     → 아직 작업 중인 팀이 있음. 해당 Agent 결과를 기다림
+     → 결과 수신 후 다시 이 LOOP의 1번으로 돌아감
+
+  5. ready = 0 AND in_progress = 0 이면:
+     → 현재 Sprint의 모든 피처 처리 완료
+     → 자동 Sprint 전환 시도:
+       bash scripts/harness-queue-manager.sh next-sprint .
+       - "Advancing to Sprint N" → Step 3으로 돌아가 팀 생성
+       - "ALL SPRINTS COMPLETE" → 전체 프로젝트 완료 보고. LOOP 종료.
+       - "Cannot advance: N failed" → 실패 피처 사용자 개입 요청. LOOP 종료.
+```
 
-모든 Team Agent가 완료되면:
-1. 각 Agent 반환 메시지에서 PASS/FAIL 확인
-2. Queue 상태 재확인: `bash scripts/harness-queue-manager.sh status .`
-3. ready 큐에 새로 unblock된 feature가 있으면 → **Step 3으로 돌아가서** 추가 팀 생성
-4. ready=0, in_progress=0이면 → 최종 결과 보고
+**이 LOOP를 건너뛰지 마세요.** 1개 팀만 시작했더라도, 그 팀이 PASS하면 blocked가 풀려서 2~3개 팀을 동시에 돌릴 수 있습니다. LOOP를 돌아야 유휴 팀이 즉시 새 피처를 받습니다.
 
 ## 핵심 원칙
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.0.6",
+  "version": "5.0.8",
   "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-queue-manager.sh

@@ -65,14 +65,18 @@ release_queue_lock() {
 # ── Concurrency from config ──
 CONCURRENCY=3
 if [ -f "$CONFIG" ]; then
-  _c=$(jq -r '.flow.parallel.concurrency // 3' "$CONFIG" 2>/dev/null)
+  _c=$(jq -r '.flow.team.concurrency // .flow.parallel.concurrency // 3' "$CONFIG" 2>/dev/null)
   if [ "$_c" -gt 0 ] 2>/dev/null; then CONCURRENCY=$_c; fi
 fi
 
 # ══════════════════════════════════════════
 # init — Build queue from feature-list.json
+# Usage: init [sprint_number]
+#   sprint_number: optional, filter features by sprint (default: all)
 # ══════════════════════════════════════════
 cmd_init() {
+  local sprint_filter="${1:-all}"
+
   if [ ! -f "$FEATURES" ]; then
     echo "[queue] feature-list.json not found."
     exit 1
@@ -80,7 +84,7 @@ cmd_init() {
 
   # Build dependency graph and topological sort
   # Output: feature-queue.json with ready (no deps) and blocked (has deps)
-  jq --argjson concurrency "$CONCURRENCY" '
+  jq --argjson concurrency "$CONCURRENCY" --arg sprint "$sprint_filter" '
     # Build passed set (features already passed by evaluator)
     def passed_set:
       [.features[] | select(
@@ -88,9 +92,15 @@ cmd_init() {
         ((.passes // []) | any(. == "evaluator-functional"))
       ) | .id] ;
 
+    # Filter features by sprint if specified
+    def target_features:
+      if $sprint == "all" then .features
+      else [.features[] | select((.sprint // 1) == ($sprint | tonumber))]
+      end ;
+
     # Separate ready vs blocked
-    def classify(passed):
-      reduce .features[] as $f (
+    def classify(features; passed):
+      reduce features[] as $f (
         { ready: [], blocked: {} };
         ($f.depends_on // []) as $deps |
         if ($f.id | IN(passed[])) then .  # already passed, skip
@@ -104,10 +114,12 @@ cmd_init() {
       ) ;
 
     passed_set as $passed |
-    classify($passed) as $classified |
+    target_features as $targets |
+    classify($targets; $passed) as $classified |
     {
-      version: "4.0",
+      version: "5.0",
       concurrency: $concurrency,
+      current_sprint: (if $sprint == "all" then null else ($sprint | tonumber) end),
       queue: {
         ready: $classified.ready,
         blocked: $classified.blocked,
@@ -129,10 +141,69 @@ cmd_init() {
   blocked_count=$(jq '.queue.blocked | length' "$QUEUE")
   passed_count=$(jq '.queue.passed | length' "$QUEUE")
 
-  echo "[queue] Initialized: $ready_count ready, $blocked_count blocked, $passed_count already passed"
+  echo "[queue] Initialized (sprint=$sprint_filter): $ready_count ready, $blocked_count blocked, $passed_count already passed"
   echo "[queue] Concurrency: $CONCURRENCY teams"
 }
 
+# ══════════════════════════════════════════
+# next-sprint — Auto-advance to next sprint
+# Checks if current sprint is complete, loads next sprint features
+# ══════════════════════════════════════════
+cmd_next_sprint() {
+  if [ ! -f "$QUEUE" ]; then echo "[queue] Run 'init' first."; exit 1; fi
+  if [ ! -f "$FEATURES" ]; then echo "[queue] feature-list.json not found."; exit 1; fi
+
+  acquire_queue_lock
+
+  local ready in_prog failed
+  ready=$(jq '.queue.ready | length' "$QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
+  failed=$(jq '.queue.failed | length' "$QUEUE" 2>/dev/null || echo 0)
+
+  # Current sprint still has work
+  if [ "$ready" -gt 0 ] || [ "$in_prog" -gt 0 ]; then
+    release_queue_lock
+    echo "[queue] Current sprint still active: $ready ready, $in_prog in progress"
+    return 1
+  fi
+
+  # Failed features block advancement
+  if [ "$failed" -gt 0 ]; then
+    release_queue_lock
+    echo "[queue] Cannot advance: $failed failed features. Requeue or fix them first."
+    return 1
+  fi
+
+  # Find current sprint number
+  local current_sprint
+  current_sprint=$(jq -r '.current_sprint // 0' "$QUEUE" 2>/dev/null)
+  if [ "$current_sprint" = "null" ] || [ "$current_sprint" = "0" ]; then
+    # Detect from passed features
+    current_sprint=$(jq -r --slurpfile q "$QUEUE" '
+      [.features[] | select(.id as $fid | $q[0].queue.passed | index($fid)) | .sprint // 1] | max // 1
+    ' "$FEATURES" 2>/dev/null)
+  fi
+
+  local next_sprint=$((current_sprint + 1))
+
+  # Check if next sprint features exist
+  local next_count
+  next_count=$(jq --arg s "$next_sprint" '[.features[] | select((.sprint // 1) == ($s | tonumber))] | length' "$FEATURES" 2>/dev/null)
+
+  if [ "$next_count" -eq 0 ]; then
+    release_queue_lock
+    echo "[queue] ALL SPRINTS COMPLETE. No Sprint $next_sprint features found."
+    echo "[queue] Total passed: $(jq '.queue.passed | length' "$QUEUE")"
+    return 0
+  fi
+
+  release_queue_lock
+
+  # Re-init with next sprint (preserves passed from previous sprints)
+  echo "[queue] Sprint $current_sprint complete! Advancing to Sprint $next_sprint ($next_count features)"
+  cmd_init "$next_sprint"
+}
+
 # ══════════════════════════════════════════
 # dequeue — Assign next ready feature to team
 # ══════════════════════════════════════════
@@ -355,16 +426,17 @@ cmd_recover() {
 
 # ── Dispatch ──
 case "$CMD" in
-  init)         cmd_init ;;
-  dequeue)      cmd_dequeue "$@" ;;
-  pass)         cmd_pass "$@" ;;
-  fail)         cmd_fail "$@" ;;
-  requeue)      cmd_requeue "$@" ;;
-  update_phase) cmd_update_phase "$@" ;;
-  recover)      cmd_recover ;;
-  status)       cmd_status ;;
+  init)          cmd_init "$@" ;;
+  dequeue)       cmd_dequeue "$@" ;;
+  pass)          cmd_pass "$@" ;;
+  fail)          cmd_fail "$@" ;;
+  requeue)       cmd_requeue "$@" ;;
+  update_phase)  cmd_update_phase "$@" ;;
+  recover)       cmd_recover ;;
+  next-sprint)   cmd_next_sprint ;;
+  status)        cmd_status ;;
   *)
-    echo "Usage: harness-queue-manager.sh <init|dequeue|pass|fail|requeue|recover|update_phase|status> [args]"
+    echo "Usage: harness-queue-manager.sh <init|dequeue|pass|fail|requeue|recover|next-sprint|update_phase|status> [args]"
     exit 1
     ;;
 esac