@walwal-harness/cli 3.7.4 → 4.0.0-alpha.10

package/assets/templates/config.json

@@ -209,6 +209,17 @@
       "frontend_cwd": "",
       "timeout_seconds": 120,
       "on_fail": "reroute_to_generator"
+    },
+    "parallel": {
+      "comment": "v4 Parallel Agent Teams 설정. npx walwal-harness v4 로 실행.",
+      "enabled": false,
+      "concurrency": 3,
+      "max_attempts_per_feature": 3,
+      "gen_model": "sonnet",
+      "eval_model": "opus",
+      "branch_strategy": "feature-branch",
+      "merge_on_pass": true,
+      "rebase_on_conflict": true
     }
   },
   "evaluation": {

package/bin/init.js

@@ -226,6 +226,11 @@ function installScripts() {
     'harness-eval-watcher.sh',
     'harness-tmux.sh',
     'harness-control.sh',
+    'harness-studio-v4.sh',
+    'harness-dashboard-v4.sh',
+    'harness-control-v4.sh',
+    'harness-queue-manager.sh',
+    'harness-team-worker.sh',
   ]);
 
   if (fs.existsSync(scriptsSrc)) {
@@ -568,8 +573,9 @@ function showHelp() {
 Usage:
   npx walwal-harness            Initialize project for harness engineering
   npx walwal-harness --force    Re-initialize (overwrites existing files)
-  npx walwal-harness studio     Launch Harness Studio (tmux 4-pane monitor)
-  npx walwal-harness studio --ai  Studio + AI eval summary (API cost)
+  npx walwal-harness studio     Launch Harness Studio v3 (tmux 5-pane)
+  npx walwal-harness studio --ai  Studio v3 + AI eval summary
+  npx walwal-harness v4          Launch Studio v4 (3 Parallel Agent Teams)
   npx walwal-harness --help     Show this help
 
 What it does:
@@ -619,6 +625,27 @@ function runStudio() {
   execSync(cmd, { stdio: 'inherit' });
 }
 
+function runStudioV4() {
+  const scriptsDir = path.join(PKG_ROOT, 'scripts');
+  const tmuxScript = path.join(scriptsDir, 'harness-studio-v4.sh');
+
+  if (!fs.existsSync(tmuxScript)) {
+    log('ERROR: harness-studio-v4.sh not found. Update @walwal-harness/cli to >= 4.0.0');
+    process.exit(1);
+  }
+
+  try {
+    execSync('which tmux', { stdio: 'ignore' });
+  } catch {
+    log('ERROR: tmux is required. Install with: brew install tmux');
+    process.exit(1);
+  }
+
+  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}"`.trim();
+  log('Launching Harness Studio v4 (Parallel Agent Teams)...');
+  execSync(cmd, { stdio: 'inherit' });
+}
+
 function main() {
   if (isHelp) {
     showHelp();
@@ -630,6 +657,11 @@ function main() {
     return;
   }
 
+  if (subcommand === 'studio-v4' || subcommand === 'v4') {
+    runStudioV4();
+    return;
+  }
+
   const pkg = require(path.join(PKG_ROOT, 'package.json'));
   console.log('');
   console.log('╔══════════════════════════════════════╗');

package/package.json

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

@@ -0,0 +1,97 @@
+#!/bin/bash
+# harness-control-v4.sh — v4 Control Center
+#
+# Commands:
+#   init              Initialize feature queue
+#   start             Launch all idle team workers
+#   pause <team>      Pause team worker
+#   resume <team>     Resume team worker
+#   assign <fid> <t>  Force-assign feature to team
+#   requeue <fid>     Move failed feature back to ready
+#   concurrency <N>   Change parallel team count
+#   status / s        Show queue status
+#   log <message>     Add manual note
+#   help / h          Show help
+#   quit / q          Exit
+
+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 "[control] .harness/ not found."; exit 1; }
+fi
+
+QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+PROGRESS_LOG="$PROJECT_ROOT/.harness/progress.log"
+QUEUE_MGR="$SCRIPT_DIR/harness-queue-manager.sh"
+
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+RESET="\033[0m"
+
+cmd_init() {
+  bash "$QUEUE_MGR" init "$PROJECT_ROOT"
+}
+
+cmd_status() {
+  bash "$QUEUE_MGR" status "$PROJECT_ROOT"
+}
+
+cmd_requeue() {
+  local fid="${1:-}"
+  if [ -z "$fid" ]; then echo -e "  ${RED}Usage: requeue <feature_id>${RESET}"; return; fi
+  bash "$QUEUE_MGR" requeue "$fid" "$PROJECT_ROOT"
+}
+
+cmd_log() {
+  local msg="$1"
+  if [ -z "$msg" ]; then echo -e "  ${RED}Usage: log <message>${RESET}"; return; fi
+  local ts
+  ts=$(date +"%Y-%m-%d")
+  echo "${ts} | manual | note | ${msg}" >> "$PROGRESS_LOG"
+  echo -e "  ${GREEN}Logged:${RESET} ${msg}"
+}
+
+show_help() {
+  echo ""
+  echo -e "  ${BOLD}Harness v4 Control${RESET}"
+  echo -e "  ${CYAN}init${RESET}                Initialize feature queue from feature-list.json"
+  echo -e "  ${CYAN}status${RESET}  / ${CYAN}s${RESET}         Show queue + team status"
+  echo -e "  ${CYAN}requeue${RESET} <fid>       Move failed feature back to ready"
+  echo -e "  ${CYAN}log${RESET} <message>       Add manual note to progress.log"
+  echo -e "  ${CYAN}help${RESET}   / ${CYAN}h${RESET}         Show this help"
+  echo -e "  ${CYAN}quit${RESET}   / ${CYAN}q${RESET}         Exit control"
+  echo ""
+  echo -e "  ${DIM}Teams auto-start when studio launches.${RESET}"
+  echo -e "  ${DIM}Workers auto-dequeue from the ready queue.${RESET}"
+  echo ""
+}
+
+# ── Main ──
+echo ""
+echo -e "  ${BOLD}Harness v4 Control${RESET}  ${DIM}(type 'help' for commands)${RESET}"
+echo ""
+
+while true; do
+  echo -ne "  ${BOLD}v4>${RESET} "
+  read -r input || exit 0
+  input=$(echo "$input" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+  case "$input" in
+    init)           cmd_init ;;
+    status|s)       cmd_status ;;
+    requeue\ *)     cmd_requeue "${input#requeue }" ;;
+    log\ *)         cmd_log "${input#log }" ;;
+    help|h)         show_help ;;
+    quit|q)         echo -e "  ${DIM}Goodbye.${RESET}"; exit 0 ;;
+    "")             ;; # empty
+    *)              echo -e "  ${DIM}Unknown command. Type 'help'.${RESET}" ;;
+  esac
+done

package/scripts/harness-dashboard-v4.sh

@@ -0,0 +1,243 @@
+#!/bin/bash
+# harness-dashboard-v4.sh — v4 Dashboard: Feature Queue + Team Status
+# Auto-refresh 3초 간격. feature-queue.json + feature-list.json 시각화.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="${1:-}"
+if [ -z "$PROJECT_ROOT" ]; then
+  PROJECT_ROOT="$(resolve_harness_root ".")" || { echo "[dash] .harness/ not found."; exit 1; }
+fi
+
+QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+FEATURES="$PROJECT_ROOT/.harness/actions/feature-list.json"
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+
+BOLD="\033[1m"
+DIM="\033[2m"
+GREEN="\033[32m"
+YELLOW="\033[33m"
+RED="\033[31m"
+CYAN="\033[36m"
+MAGENTA="\033[35m"
+RESET="\033[0m"
+
+render_header() {
+  local now project_name
+  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 ""
+}
+
+render_queue_summary() {
+  if [ ! -f "$QUEUE" ]; then
+    echo -e "  ${DIM}(queue not initialized — run 'init' in Control)${RESET}"
+    return
+  fi
+
+  local ready blocked in_prog passed failed total concurrency
+  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)
+  concurrency=$(jq '.concurrency // 3' "$QUEUE" 2>/dev/null || echo 3)
+  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
+  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 ""
+}
+
+render_teams() {
+  if [ ! -f "$QUEUE" ]; then return; fi
+
+  local team_count
+  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="—"
+    fi
+
+    local icon color
+    case "$t_status" in
+      busy)   icon="▶" ; color="$GREEN" ;;
+      idle)   icon="○" ; color="$DIM" ;;
+      paused) icon="⏸" ; color="$YELLOW" ;;
+      *)      icon="?" ; color="$RESET" ;;
+    esac
+
+    local phase_display=""
+    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}" ;;
+    esac
+
+    printf "  %b %b Team %d  %-8s %b  attempt %s\n" "$color" "$icon" "$i" "$t_feature" "$phase_display" "$t_attempt"
+  done
+  echo ""
+}
+
+render_feature_list() {
+  if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
+
+  echo -e "  ${BOLD}Features${RESET}"
+
+  # Single jq call: merge feature-list + queue state → pre-formatted lines
+  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 > 22 then .[0:20] + ".." 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\|*) # in_progress: extract team and phase
+            team=$(echo "$st" | cut -d'|' -f2)
+            phase=$(echo "$st" | cut -d'|' -f3)
+            printf "  ${CYAN}◐${RESET} %-6s %-18s T%s:%s\n" "$fid" "$fname" "$team" "$phase" ;;
+      *)    printf "  ? %-6s %s\n" "$fid" "$fname" ;;
+    esac
+  done
+
+  echo ""
+}
+
+render_user_prompts() {
+  local log_file="$PROJECT_ROOT/.harness/progress.log"
+  if [ ! -f "$log_file" ]; then return; fi
+
+  # Extract user-prompt entries (newest first, max 5)
+  local user_lines
+  user_lines=$(grep 'user-prompt' "$log_file" 2>/dev/null | tail -r 2>/dev/null | head -5)
+
+  if [ -z "$user_lines" ]; then return; fi
+
+  echo -e "  ${BOLD}Manual Prompts${RESET} ${DIM}(newest first)${RESET}"
+
+  echo "$user_lines" | 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}')
+
+    # Short timestamp (HH:MM or MM-DD HH:MM)
+    local short_ts
+    short_ts=$(echo "$ts" | sed 's/^[0-9]*-//')
+
+    if [ ${#detail} -gt 55 ]; then detail="${detail:0:53}.."; fi
+
+    echo -e "  ${BOLD}★${RESET} ${DIM}${short_ts}${RESET} ${detail}"
+  done
+
+  echo ""
+}
+
+render_team_activity() {
+  local log_file="$PROJECT_ROOT/.harness/progress.log"
+  if [ ! -f "$log_file" ]; then return; fi
+
+  local max_lines=8
+
+  echo -e "  ${BOLD}Activity${RESET} ${DIM}(newest first)${RESET}"
+
+  # All non-user-prompt entries, newest first
+  grep -v '^#' "$log_file" 2>/dev/null | grep -v '^$' | grep -v 'user-prompt' | \
+  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
+      dispatcher*) icon="▸"; color="$MAGENTA" ;;
+      team-*)      icon="⚡"; color="$CYAN" ;;
+      manual)      icon="★"; color="$BOLD" ;;
+      planner*)    icon="□"; color="$YELLOW" ;;
+      gen*)        icon="▶"; color="$GREEN" ;;
+      eval*)       icon="✦"; color="$RED" ;;
+      system)      icon="⚙"; color="$DIM" ;;
+      *)           icon="·"; color="$DIM" ;;
+    esac
+
+    if [ ${#detail} -gt 45 ]; then detail="${detail:0:43}.."; fi
+
+    echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
+  done
+
+  echo ""
+}
+
+render_all() {
+  render_header
+  render_queue_summary
+  render_teams
+  render_user_prompts
+  render_team_activity
+  render_feature_list
+  echo -e "  ${DIM}Refreshing every 3s${RESET}"
+}
+
+# ── Main loop ──
+tput civis 2>/dev/null
+trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
+
+clear
+
+while true; do
+  buf=$(render_all 2>&1)
+  tput cup 0 0 2>/dev/null
+  echo "$buf"
+  tput ed 2>/dev/null
+  sleep 3
+done