@walwal-harness/cli 4.0.0-alpha.9 → 4.0.0-beta.10

package/scripts/harness-studio.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# harness-studio.sh — 하네스 통합 진입점
+#
+# 사용자가 기억할 명령: 이것 하나.
+#
+#   bash scripts/harness-studio.sh          # 자동 감지: v3 or v4
+#   bash scripts/harness-studio.sh --kill   # 세션 종료
+#   bash scripts/harness-studio.sh --v3     # v3 강제
+#   bash scripts/harness-studio.sh --v4     # v4 강제
+#
+# 자동 감지 기준:
+#   feature-queue.json 존재 → v4 (Agent Teams 병렬 모드)
+#   없으면 → v3 (순차 파이프라인 모드)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+FORCE_MODE=""
+
+# ── Parse args (pass through to sub-script) ──
+PASSTHROUGH_ARGS=()
+for arg in "$@"; do
+  case "$arg" in
+    --v3)   FORCE_MODE="v3" ;;
+    --v4)   FORCE_MODE="v4" ;;
+    --kill)
+      tmux kill-session -t "harness-studio" 2>/dev/null && echo "v3 killed." || true
+      tmux kill-session -t "harness-v4" 2>/dev/null && echo "v4 killed." || true
+      exit 0
+      ;;
+    *)
+      PASSTHROUGH_ARGS+=("$arg")
+      ;;
+  esac
+done
+
+# ── Auto-detect mode ──
+detect_mode() {
+  local dir="${1:-.}"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then
+      if [ -f "$dir/.harness/actions/feature-queue.json" ]; then
+        echo "v4"
+      else
+        echo "v3"
+      fi
+      return
+    fi
+    dir="$(dirname "$dir")"
+  done
+  echo "v3"  # default
+}
+
+MODE="${FORCE_MODE:-$(detect_mode "$(pwd)")}"
+
+echo "Harness Studio — mode: $MODE"
+echo ""
+
+case "$MODE" in
+  v4)
+    exec bash "$SCRIPT_DIR/harness-tmux-v4.sh" "${PASSTHROUGH_ARGS[@]}"
+    ;;
+  v3)
+    exec bash "$SCRIPT_DIR/harness-tmux.sh" "${PASSTHROUGH_ARGS[@]}"
+    ;;
+esac

package/scripts/harness-tmux-v4.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+# harness-tmux-v4.sh — v4 Agent Teams: 원커맨드 실행
+#
+# ┌──────────────┬──────────────┬──────────────┐
+# │              │  Dashboard   │              │
+# │  Main Claude │  (v4 queue)  │  Team Monitor│
+# │  (Lead)      ├──────────────┤  (lifecycle) │
+# │              │  Prompt      │              │
+# │              │  History     │              │
+# └──────────────┴──────────────┴──────────────┘
+#
+# Usage:
+#   bash scripts/harness-tmux-v4.sh              # 레이아웃 + Claude 자동 실행 + team-action 자동 시작
+#   bash scripts/harness-tmux-v4.sh --no-auto    # 레이아웃만 (Claude 수동 실행)
+#   bash scripts/harness-tmux-v4.sh --kill       # 세션 종료
+#
+# 이것만 기억하세요:
+#   bash scripts/harness-tmux-v4.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SESSION_NAME="harness-v4"
+
+PROJECT_ROOT=""
+DETACH=false
+AUTO_START=true
+
+for arg in "$@"; do
+  case "$arg" in
+    --detach)   DETACH=true ;;
+    --no-auto)  AUTO_START=false ;;
+    --kill)
+      tmux kill-session -t "$SESSION_NAME" 2>/dev/null && echo "Killed." || echo "No session."
+      exit 0
+      ;;
+    *)
+      if [ -d "$arg" ]; then PROJECT_ROOT="$arg"; fi
+      ;;
+  esac
+done
+
+if [ -z "$PROJECT_ROOT" ]; then
+  dir="$(pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then PROJECT_ROOT="$dir"; break; fi
+    dir="$(dirname "$dir")"
+  done
+fi
+
+if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.harness" ]; then
+  echo "Error: .harness/ not found."
+  exit 1
+fi
+
+echo "Project: $PROJECT_ROOT"
+echo "Session: $SESSION_NAME"
+
+tmux kill-session -t "$SESSION_NAME" 2>/dev/null || true
+
+# ── Resolve Claude command ──
+HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
+CLAUDE_CMD="claude --dangerously-skip-permissions"
+if [ -f "$HANDOFF" ]; then
+  _model=$(jq -r '.model // empty' "$HANDOFF" 2>/dev/null)
+  if [ -n "$_model" ] && [ "$_model" != "null" ]; then
+    CLAUDE_CMD="$CLAUDE_CMD --model $_model"
+  fi
+fi
+
+# ══════════════════════════════════════════
+# Build 3-column layout
+# ══════════════════════════════════════════
+
+# 1. Create session → Left pane (Main Claude Lead)
+PANE_MAIN=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 220 -y 55 \
+  -P -F '#{pane_id}')
+
+# 2. Split horizontally: Left 35% | Right 65%
+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" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
+
+# 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" \
+  -P -F '#{pane_id}' \
+  "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
+
+# 5. Start dashboard in the middle-top pane
+tmux send-keys -t "$PANE_MID" "bash \"${SCRIPT_DIR}/harness-dashboard-v4.sh\" \"${PROJECT_ROOT}\"" Enter
+
+# 6. Main pane — Claude 자동 실행
+tmux send-keys -t "$PANE_MAIN" "unset npm_config_prefix 2>/dev/null" Enter
+tmux send-keys -t "$PANE_MAIN" "clear" Enter
+
+if [ "$AUTO_START" = true ]; then
+  # Claude 실행 → 시작 후 자동으로 /harness-team-action 전송
+  tmux send-keys -t "$PANE_MAIN" "$CLAUDE_CMD" Enter
+  # Claude가 초기화될 시간을 준 뒤 team-action 명령 전송
+  sleep 3
+  tmux send-keys -t "$PANE_MAIN" "/harness-team-action" Enter
+fi
+
+# ── Pane titles ──
+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 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
+
+# ── Focus on Main pane ──
+tmux select-pane -t "$PANE_MAIN"
+
+# ── Attach ──
+if [ "$DETACH" = true ]; then
+  echo ""
+  echo "Session created. Attach: tmux attach -t $SESSION_NAME"
+else
+  if [ -n "${TMUX:-}" ]; then
+    tmux switch-client -t "$SESSION_NAME"
+  else
+    echo ""
+    echo "harness-v4 starting..."
+    echo ""
+    echo "  All automatic. Just watch."
+    echo "  Stop: bash scripts/harness-tmux-v4.sh --kill"
+    echo ""
+    tmux attach -t "$SESSION_NAME"
+  fi
+fi

package/scripts/harness-user-prompt-submit.sh

@@ -36,6 +36,19 @@ if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$CWD/.harness/progress.json" 2>/dev/null || echo "pending")
 fi
 
+# ── 명령 히스토리 기록 (모든 모드 공통) ──
+PROGRESS_LOG="$CWD/.harness/progress.log"
+if [ -n "$PROMPT" ] && [ -d "$CWD/.harness" ]; then
+  # progress.log가 없으면 생성
+  if [ ! -f "$PROGRESS_LOG" ]; then
+    echo "# Harness Command History — $(date +%Y-%m-%d)" > "$PROGRESS_LOG"
+  fi
+  PROMPT_SHORT=$(echo "$PROMPT" | tr '\n' ' ' | sed 's/  */ /g' | cut -c1-80)
+  if [ ${#PROMPT_SHORT} -gt 2 ]; then
+    echo "$(date +"%Y-%m-%d %H:%M") | user-prompt | input | ${PROMPT_SHORT}" >> "$PROGRESS_LOG"
+  fi
+fi
+
 # ── 컨텍스트 분리 가드레일 ──
 # 현재 에이전트가 활성인데 다른 에이전트 스킬을 호출하려는 경우 경고
 CONTEXT_WARNING=""

package/skills/dispatcher/SKILL.md

@@ -25,8 +25,13 @@ disable-model-invocation: false
    - `pipeline` → 선택된 파이프라인 (FULLSTACK/FE-ONLY/BE-ONLY)
    - `sprint.number` → `1`, `sprint.status` → `"in_progress"` (신규 파이프라인인 경우에만)
 2. `.harness/progress.log`에 요약 한 줄 추가
-3. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
-4. 출력: `"✓ Dispatcher 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+3. **v4 모드 감지**: `.harness/actions/feature-queue.json` 파일이 존재하는지 확인
+   - **존재**: v4 Parallel Agent Teams 활성 상태. 별도 안내 없이 즉시 STOP.
+     출력: `"✓ Dispatcher 완료. Agent Teams가 자율 실행 중입니다."`
+   - **미존재**: v3 Classic 모드.
+     출력: `"✓ Dispatcher 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+   - v4 모드에서는 `/harness-team 실행하시겠습니까?` 같은 **질문을 하지 않는다**. Teams는 이미 실행 중이거나 사용자가 별도로 시작한다.
 
 ## Auto-Routing (UserPromptSubmit Hook)
 

package/skills/team-action/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: harness-team-action
+description: "v4 Agent Teams 가동. Studio 레이아웃 구축 → Queue 초기화 → Gen↔Eval 분리 사이클 팀 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
+disable-model-invocation: false
+---
+
+# /harness-team-action — Agent Teams 가동
+
+## Step 0: Studio 레이아웃 자동 구축
+
+3-column 대시보드 레이아웃을 자동 구축합니다:
+
+```bash
+bash scripts/harness-studio-setup.sh .
+```
+
+스크립트 출력을 확인합니다:
+
+- **`Layout ready`** → 현재 터미널에 split 완료. 바로 Step 1로.
+- **`ATTACH_TMUX=harness-studio`** → 새 tmux 세션이 생성됨 (tmux 밖에서 실행한 경우).
+  사용자에게 아래 안내를 출력하고 **STOP**합니다:
+
+  ```
+  Studio 레이아웃이 준비되었습니다!
+  다른 터미널에서 아래 명령을 실행하세요:
+
+    tmux attach -t harness-studio
+
+  새 창에서 Claude가 자동 실행됩니다. 거기서 "팀 가동"을 입력하면 Teams가 시작됩니다.
+  ```
+
+- **`already set up`** → 이미 구축됨. 바로 Step 1로.
+
+## Step 1: Queue 초기화
+
+```bash
+if [ ! -f .harness/actions/feature-queue.json ]; then bash scripts/harness-queue-manager.sh init .; else bash scripts/harness-queue-manager.sh recover .; fi && bash scripts/harness-queue-manager.sh status .
+```
+
+## Step 2: Feature 할당 (dequeue)
+
+Queue status 결과를 확인하여 `ready` 큐에 feature가 있는지 확인합니다.
+ready feature 수와 설정된 concurrency 중 작은 값만큼 팀을 생성합니다 (최대 3).
+
+**각 팀마다** dequeue 명령으로 feature를 원자적으로 할당합니다:
+
+```bash
+bash scripts/harness-queue-manager.sh dequeue {TEAM_NUMBER} .
+```
+
+dequeue 결과로 feature ID가 반환됩니다. 빈 결과면 해당 팀은 생성하지 않습니다.
+
+## Step 3: Agent 도구로 팀 생성 (Gen↔Eval 분리 사이클)
+
+dequeue로 할당받은 feature마다 **Agent 도구**를 호출합니다.
+**반드시 `isolation: "worktree"`를 사용**하여 각 팀이 독립된 코드 복사본에서 작업합니다.
+
+**독립적인 팀들은 단일 메시지에서 병렬로 호출**하세요 (한 번의 응답에 여러 Agent 도구 호출).
+
+```
+Agent({
+  description: "Team-{N}: {FEATURE_ID}",
+  isolation: "worktree",
+  prompt: "<아래 Team Worker 프롬프트>"
+})
+```
+
+### Team Worker 프롬프트
+
+```
+당신은 Harness Team-{N} 워커입니다. 하나의 Feature에 대해 Gen→Eval 사이클을 수행합니다.
+
+## 할당된 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`에서 관련 엔드포인트 확인
+   - AC(Acceptance Criteria) 목록을 정확히 파악
+
+2. 코드 생성:
+   - AGENTS.md의 IA-MAP에 따라 올바른 디렉토리에 코드 작성
+   - AC의 모든 항목을 충족하도록 구현
+
+3. Pre-eval 게이트 (자체):
+   - tsc (타입 체크) 실행
+   - 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만 보고 판단합니다.
+
+```
+Agent({
+  description: "Eval: {FEATURE_ID}",
+  prompt: "<아래 Evaluator 프롬프트>"
+})
+```
+
+#### Evaluator 프롬프트
+
+```
+당신은 독립 Evaluator입니다. Generator가 작성한 코드를 AC 기준으로 냉정하게 평가합니다.
+Generator의 의도나 추론 과정은 알 수 없습니다. 오직 코드와 결과만 봅니다.
+
+## 평가 대상
+- Feature ID: {FEATURE_ID}
+- AC 확인: `jq '.features[] | select(.id == "{FEATURE_ID}").acceptance_criteria' .harness/actions/feature-list.json`
+
+## 평가 기준
+1. AC 100% 충족 여부 (부분 통과 = FAIL)
+2. api-contract.json과의 일치 여부 (엔드포인트, 요청/응답 스키마)
+3. tsc, eslint 통과 여부
+4. 보안 취약점 여부 (OWASP Top 10)
+5. 기존 코드와의 regression 여부
+
+## 출력 형식
+반드시 아래 형식으로 결과를 반환하세요:
+
+VERDICT: PASS 또는 FAIL
+SCORE: X.XX / 3.00
+EVIDENCE:
+- AC-1: [PASS/FAIL] 근거
+- AC-2: [PASS/FAIL] 근거
+- ...
+FEEDBACK: (FAIL인 경우만) 구체적 수정 지시
+```
+
+## Phase 3: 결과 처리
+
+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"
+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
+   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: 결과 수집 및 다음 라운드
+
+모든 Team Agent가 완료되면:
+1. 각 Agent 반환 메시지에서 PASS/FAIL 확인
+2. Queue 상태 재확인: `bash scripts/harness-queue-manager.sh status .`
+3. ready 큐에 새로 unblock된 feature가 있으면 → **Step 2로 돌아가서** 추가 팀 생성
+4. ready=0, in_progress=0이면 → 최종 결과 보고
+
+## 핵심 원칙
+
+### 자기 의식 편향 차단
+- Generator가 자기 코드를 평가하지 않음
+- Evaluator는 항상 새 Agent (Generator의 추론 과정을 모름)
+- FAIL 후 재시도 시에도 새 Evaluator를 생성 (이전 Eval 기억 없음)
+
+### 중복 방지
+- dequeue는 원자적 (lock 사용) — 같은 feature를 두 번 할당 불가
+- ready가 0이면 팀을 생성하지 않음
+
+### 격리
+- 각 팀은 `isolation: "worktree"`로 독립 코드 복사본에서 작업
+- 팀 간 코드 충돌 없음

package/skills/team-stop/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: harness-team-stop
+description: "v4 Agent Teams 중지. 실행 중인 Teammate를 모두 해산한다. 트리거: '/harness-team-stop', 'team 중지', 'agent team 멈춰', '팀 멈춰', '팀 중지'"
+disable-model-invocation: false
+---
+
+# /harness-team-stop — Agent Teams 중지
+
+## 실행
+
+모든 Teammate에게 현재 작업을 마무리하고 종료하라고 메시지를 보내세요.
+
+Queue 상태는 보존되므로, `/harness-team-action`으로 다시 시작할 수 있습니다.
+
+## 재시작
+
+```
+❯ /harness-team-action
+```

package/scripts/harness-control-v4.sh

@@ -1,97 +0,0 @@
-#!/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