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

package/assets/templates/config.json

@@ -133,62 +133,15 @@
         ]
       }
     },
-    "generator-frontend-flutter": {
-      "role": "Flutter 앱 개발 — Riverpod, integrated_data_layer(Retrofit), i18n(ARB), build_runner",
-      "skill": "harness-generator-frontend-flutter",
-      "inputs": ["actions/plan.md", "actions/feature-list.json", "actions/api-contract.json", "actions/sprint-contract.md"],
-      "outputs": ["code:flutter", "actions/sprint-contract.md"],
-      "order": 2,
-      "fe_stack": "flutter",
-      "model": "sonnet",
-      "thinking_mode": null
-    },
-    "evaluator-functional-flutter": {
-      "role": "Flutter 앱 검증 — flutter analyze, flutter test, build_runner 일관성, 안티패턴 정적 검증",
-      "skill": "harness-evaluator-functional-flutter",
-      "tools": ["bash:flutter", "bash:dart"],
-      "inputs": ["actions/sprint-contract.md"],
-      "outputs": ["actions/evaluation-functional.md"],
-      "fe_stack": "flutter",
-      "model": "opus",
-      "thinking_mode": "ultrathink"
-    }
   },
   "flow": {
     "sequence": ["dispatcher", "planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
     "pipeline_selection": {
-      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정. fe_stack 필드로 React/Flutter를 구분. harness-next.sh가 pipeline.json.fe_stack 을 읽어 generator-frontend/evaluator-functional 을 Flutter 변형으로 치환한다.",
+      "comment": "Dispatcher가 pipeline.json으로 활성 에이전트를 결정.",
       "pipelines": {
         "FULLSTACK": ["planner", "generator-backend", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "FE-ONLY": ["planner:light", "generator-frontend", "evaluator-functional", "evaluator-visual"],
         "BE-ONLY": ["planner", "generator-backend", "evaluator-functional:api-only"]
-      },
-      "fe_stack_substitution": {
-        "comment": "pipeline.json.fe_stack + fe_target 에 따라 FE 에이전트 치환. Flutter Web 은 React 와 동일한 Playwright 기반 evaluator 를 사용한다.",
-        "flutter": {
-          "_doc": "fe_target = web | mobile | desktop. by_target 으로 분기.",
-          "by_target": {
-            "web": {
-              "_doc": "Flutter Web — 컴파일 결과가 HTML+JS+CSS 이므로 Playwright evaluator 사용 가능",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional",
-              "evaluator-visual": "evaluator-visual"
-            },
-            "mobile": {
-              "_doc": "Flutter Mobile (Android/iOS) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            },
-            "desktop": {
-              "_doc": "Flutter Desktop (macOS/Windows/Linux) — 브라우저 없음, 정적 분석 evaluator 사용",
-              "generator-frontend": "generator-frontend-flutter",
-              "evaluator-functional": "evaluator-functional-flutter",
-              "evaluator-visual": "__skip__"
-            }
-          },
-          "_default_target": "mobile"
-        }
       }
     },
     "sprint_execution": {

package/assets/templates/gitignore-append.txt

@@ -0,0 +1 @@
+# For consumer projects, add .worktrees/ to .gitignore

package/bin/init.js

@@ -129,17 +129,56 @@ function scaffoldHarness() {
     }
   }
 
-  // Copy config.json
+  // config.json — ALWAYS update (harness system file, not user data)
+  // But preserve user's custom settings (pre_eval_gate.frontend_cwd, behavior, etc.)
   const configSrc = path.join(PKG_ROOT, 'assets', 'templates', 'config.json');
   const configDest = path.join(HARNESS_DIR, 'config.json');
-  if (fs.existsSync(configSrc) && (!fileExists(configDest) || isForce)) {
-    copyFile(configSrc, configDest);
+  if (fs.existsSync(configSrc)) {
+    if (fileExists(configDest) && !isForce) {
+      // Merge: keep user's customizations, update harness structure
+      try {
+        const existing = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        const template = JSON.parse(fs.readFileSync(configSrc, 'utf8'));
+        // Preserve user customizations
+        const userPreserve = {
+          behavior: existing.behavior,
+          'flow.pre_eval_gate.frontend_cwd': existing?.flow?.pre_eval_gate?.frontend_cwd,
+          'flow.pre_eval_gate.backend_cwd': existing?.flow?.pre_eval_gate?.backend_cwd,
+          'flow.pre_eval_gate.frontend_checks': existing?.flow?.pre_eval_gate?.frontend_checks,
+          'flow.pre_eval_gate.backend_checks': existing?.flow?.pre_eval_gate?.backend_checks,
+        };
+        // Write template, then re-apply user settings
+        fs.writeFileSync(configDest, JSON.stringify(template, null, 2) + '\n');
+        // Re-apply preserved user settings
+        const merged = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        if (userPreserve.behavior) merged.behavior = userPreserve.behavior;
+        if (userPreserve['flow.pre_eval_gate.frontend_cwd']) {
+          merged.flow.pre_eval_gate.frontend_cwd = userPreserve['flow.pre_eval_gate.frontend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_cwd']) {
+          merged.flow.pre_eval_gate.backend_cwd = userPreserve['flow.pre_eval_gate.backend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.frontend_checks']) {
+          merged.flow.pre_eval_gate.frontend_checks = userPreserve['flow.pre_eval_gate.frontend_checks'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_checks']) {
+          merged.flow.pre_eval_gate.backend_checks = userPreserve['flow.pre_eval_gate.backend_checks'];
+        }
+        fs.writeFileSync(configDest, JSON.stringify(merged, null, 2) + '\n');
+        log('config.json updated (user settings preserved)');
+      } catch (e) {
+        copyFile(configSrc, configDest);
+        log('config.json replaced (merge failed)');
+      }
+    } else {
+      copyFile(configSrc, configDest);
+    }
   }
 
-  // Copy HARNESS.md
+  // HARNESS.md — ALWAYS update
   const harnessMdSrc = path.join(PKG_ROOT, 'assets', 'templates', 'HARNESS.md');
   const harnessMdDest = path.join(HARNESS_DIR, 'HARNESS.md');
-  if (fs.existsSync(harnessMdSrc) && (!fileExists(harnessMdDest) || isForce)) {
+  if (fs.existsSync(harnessMdSrc)) {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
@@ -186,6 +225,17 @@ function installSkills() {
     return;
   }
 
+  // harness- 프리픽스 스킬 전체 삭제 후 재복사 — 잔류 방지
+  if (fs.existsSync(CLAUDE_SKILLS_DIR)) {
+    const existing = fs.readdirSync(CLAUDE_SKILLS_DIR, { withFileTypes: true });
+    for (const entry of existing) {
+      if (entry.isDirectory() && entry.name.startsWith('harness-')) {
+        fs.rmSync(path.join(CLAUDE_SKILLS_DIR, entry.name), { recursive: true, force: true });
+      }
+    }
+    log('  Cleared existing harness-* skills');
+  }
+
   const skills = fs.readdirSync(skillsSrc, { withFileTypes: true })
     .filter(d => d.isDirectory())
     .map(d => d.name);
@@ -193,13 +243,8 @@ function installSkills() {
   for (const skill of skills) {
     const src = path.join(skillsSrc, skill);
     const dest = path.join(CLAUDE_SKILLS_DIR, `harness-${skill}`);
-
-    if (!fileExists(dest) || isForce) {
-      copyDir(src, dest);
-      log(`  Installed: harness-${skill}`);
-    } else {
-      log(`  Skipped (exists): harness-${skill}`);
-    }
+    copyDir(src, dest);
+    log(`  Installed: harness-${skill}`);
   }
 
   log('Skills installation complete');
@@ -214,51 +259,28 @@ function installScripts() {
   const scriptsSrc = path.join(PKG_ROOT, 'scripts');
   const scriptsDest = path.join(PROJECT_ROOT, 'scripts');
 
-  // Core scripts are ALWAYS overwritten on update (not user-editable)
-  // These contain harness logic that must stay in sync with the CLI version
-  const coreScripts = new Set([
-    'harness-next.sh',
-    'harness-session-start.sh',
-    'harness-statusline.sh',
-    'harness-user-prompt-submit.sh',
-    'harness-dashboard.sh',
-    'harness-monitor.sh',
-    '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(scriptsDest)) {
+    fs.rmSync(scriptsDest, { recursive: true, force: true });
+    log('  Cleared existing scripts/');
+  }
 
   if (fs.existsSync(scriptsSrc)) {
-    ensureDir(scriptsDest);
-    const entries = fs.readdirSync(scriptsSrc, { withFileTypes: true });
-    for (const entry of entries) {
-      const srcPath = path.join(scriptsSrc, entry.name);
-      const destPath = path.join(scriptsDest, entry.name);
-      if (entry.isDirectory()) {
-        // lib/ and other subdirectories — always overwrite
-        copyDir(srcPath, destPath);
-        try {
-          const subFiles = fs.readdirSync(destPath);
-          for (const f of subFiles) {
-            if (f.endsWith('.sh')) {
-              fs.chmodSync(path.join(destPath, f), '755');
-            }
-          }
-        } catch (e) {}
-      } else {
-        // Core scripts: always overwrite. Others: skip if exists (unless --force)
-        const isCore = coreScripts.has(entry.name);
-        if (isCore || !fileExists(destPath) || isForce) {
-          copyFile(srcPath, destPath);
-          try { fs.chmodSync(destPath, '755'); } catch (e) {}
+    copyDir(scriptsSrc, scriptsDest);
+
+    // chmod +x for all .sh files (recursive)
+    function chmodRecursive(dir) {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          chmodRecursive(full);
+        } else if (entry.name.endsWith('.sh')) {
+          try { fs.chmodSync(full, '755'); } catch (e) {}
         }
       }
     }
+    chmodRecursive(scriptsDest);
   }
 
   log('Scripts installation complete');
@@ -424,6 +446,28 @@ function installUserPromptSubmitHook() {
 // ─────────────────────────────────────────
 // 4. AGENTS.md + CLAUDE.md
 // ─────────────────────────────────────────
+// ─────────────────────────────────────────
+// 3d. Agent Teams env var
+// ─────────────────────────────────────────
+function installAgentTeamsEnv() {
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  let settings = {};
+  if (fileExists(settingsPath)) {
+    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
+  }
+
+  if (!settings.env) settings.env = {};
+
+  if (settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] !== '1') {
+    settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+    ensureDir(path.dirname(settingsPath));
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    log('Agent Teams enabled (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)');
+  } else {
+    log('Agent Teams already enabled');
+  }
+}
+
 function setupAgentsMd() {
   const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
   const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
@@ -575,7 +619,7 @@ Usage:
   npx walwal-harness --force    Re-initialize (overwrites existing files)
   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 v4          Enable Agent Teams (set env var + init queue)
   npx walwal-harness --help     Show this help
 
 What it does:
@@ -626,24 +670,51 @@ function runStudio() {
 }
 
 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);
+  // Enable Agent Teams in project settings
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  let settings = {};
+  if (fileExists(settingsPath)) {
+    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
   }
 
-  try {
-    execSync('which tmux', { stdio: 'ignore' });
-  } catch {
-    log('ERROR: tmux is required. Install with: brew install tmux');
-    process.exit(1);
+  if (!settings.env) settings.env = {};
+  settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+  ensureDir(path.dirname(settingsPath));
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+
+  // Initialize feature queue if feature-list.json exists
+  const featureList = path.join(PROJECT_ROOT, '.harness', 'actions', 'feature-list.json');
+  const featureQueue = path.join(PROJECT_ROOT, '.harness', 'actions', 'feature-queue.json');
+  const queueMgr = path.join(PKG_ROOT, 'scripts', 'harness-queue-manager.sh');
+
+  if (fs.existsSync(featureList) && fs.existsSync(queueMgr)) {
+    if (!fs.existsSync(featureQueue)) {
+      log('Initializing feature queue...');
+      try { execSync(`bash "${queueMgr}" init "${PROJECT_ROOT}"`, { stdio: 'inherit' }); } catch (e) {}
+    } else {
+      log('Recovering feature queue...');
+      try { execSync(`bash "${queueMgr}" recover "${PROJECT_ROOT}"`, { stdio: 'inherit' }); } catch (e) {}
+    }
   }
 
-  const cmd = `bash "${tmuxScript}" "${PROJECT_ROOT}"`.trim();
-  log('Launching Harness Studio v4 (Parallel Agent Teams)...');
-  execSync(cmd, { stdio: 'inherit' });
+  console.log('');
+  log('╔═══════════════════════════════════════════════════════════╗');
+  log('║  Agent Teams v4 ENABLED                                  ║');
+  log('╠═══════════════════════════════════════════════════════════╣');
+  log('║                                                          ║');
+  log('║  CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 set in           ║');
+  log('║  .claude/settings.json                                   ║');
+  log('║                                                          ║');
+  log('║  Next steps:                                             ║');
+  log('║  1. Restart Claude Code (/exit → re-enter)               ║');
+  log('║  2. Run Planner: "하네스 엔지니어링 시작"                 ║');
+  log('║  3. Start Teams: /harness-team-action                    ║');
+  log('║                                                          ║');
+  log('║  Or use --teammate-mode tmux for split panes:            ║');
+  log('║  $ claude --teammate-mode tmux                           ║');
+  log('║                                                          ║');
+  log('╚═══════════════════════════════════════════════════════════╝');
+  console.log('');
 }
 
 function main() {
@@ -679,6 +750,7 @@ function main() {
   installSessionHook();
   installStatusline();
   installUserPromptSubmitHook();
+  installAgentTeamsEnv();
   setupAgentsMd();
   checkPlaywrightMcp();
   checkRecommendedSkills();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-alpha.9",
+  "version": "4.0.0-beta.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"
@@ -9,7 +9,9 @@
     "postinstall": "node bin/init.js --auto",
     "init": "node bin/init.js",
     "scan": "bash scripts/scan-project.sh .",
-    "reset": "node bin/init.js --force"
+    "reset": "node bin/init.js --force",
+    "studio": "bash scripts/harness-studio.sh",
+    "studio:kill": "bash scripts/harness-studio.sh --kill"
   },
   "keywords": [
     "harness-engineering",

package/scripts/harness-dashboard-v4.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
-# harness-dashboard-v4.sh — v4 Dashboard: Feature Queue + Team Status
-# Auto-refresh 3초 간격. feature-queue.json + feature-list.json 시각화.
+# harness-dashboard-v4.sh — v4 Dashboard 상단: Planner Progress
+# Queue + Teams + Features 를 auto-refresh. 고정 영역, 스크롤 없음.
 
 set -uo pipefail
 
@@ -30,42 +30,34 @@ render_header() {
   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 ""
+  echo -e "${BOLD}HARNESS v4${RESET} ${DIM}${project_name} | ${now}${RESET}"
 }
 
 render_queue_summary() {
   if [ ! -f "$QUEUE" ]; then
-    echo -e "  ${DIM}(queue not initialized — run 'init' in Control)${RESET}"
+    echo -e "  ${DIM}(queue not initialized)${RESET}"
     return
   fi
 
-  local ready blocked in_prog passed failed total concurrency
+  local ready blocked in_prog passed failed total
   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 bar_w=16
   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 ""
+  echo -e "  ${bar} ${passed}/${total} (${pct}%)  R:${GREEN}${ready}${RESET} B:${YELLOW}${blocked}${RESET} P:${CYAN}${in_prog}${RESET} ${GREEN}✓${passed}${RESET} ${RED}✗${failed}${RESET}"
 }
 
 render_teams() {
@@ -75,49 +67,44 @@ render_teams() {
   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="—"
+      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" ;;
+      busy)   icon="▶"; color="$GREEN" ;;
+      idle)   icon="○"; color="$DIM" ;;
+      *)      icon="?"; color="$RESET" ;;
     esac
 
-    local phase_display=""
+    local phase_short=""
     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}" ;;
+      gen)  phase_short="${CYAN}G${RESET}" ;;
+      gate) phase_short="${YELLOW}K${RESET}" ;;
+      eval) phase_short="${MAGENTA}E${RESET}" ;;
+      *)    phase_short="${DIM}-${RESET}" ;;
     esac
 
-    printf "  %b %b Team %d  %-8s %b  attempt %s\n" "$color" "$icon" "$i" "$t_feature" "$phase_display" "$t_attempt"
+    printf "  %b%b T%d %-7s %b" "$color" "$icon" "$i" "$t_feature" "$phase_short"
+    if [ -n "$t_attempt" ] && [ "$t_attempt" != "—" ]; then
+      printf " #%s" "$t_attempt"
+    fi
+    echo ""
   done
-  echo ""
 }
 
-render_feature_list() {
+render_features() {
   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 |
@@ -125,7 +112,7 @@ render_feature_list() {
     ($q[0].queue.in_progress // {}) as $prog |
     .features[] |
     .id as $fid |
-    (.name // .description // "?" | if length > 22 then .[0:20] + ".." else . end) as $fname |
+    (.name // .description // "?" | if length > 18 then .[0:16] + ".." 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"
@@ -138,73 +125,70 @@ render_feature_list() {
       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)
+      I\|*) 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 "  ${CYAN}◐${RESET} %-6s %-14s T%s:%s\n" "$fid" "$fname" "$team" "$phase" ;;
       *)    printf "  ? %-6s %s\n" "$fid" "$fname" ;;
     esac
   done
-
-  echo ""
 }
 
-render_prompt_history() {
-  local log_file="$PROJECT_ROOT/.harness/progress.log"
-  if [ ! -f "$log_file" ]; then return; fi
-
-  # Get terminal height to limit display
-  local term_h
-  term_h=$(tput lines 2>/dev/null || echo 50)
-  local max_lines=10  # show latest 10 entries
-
-  echo -e "  ${BOLD}Prompt History${RESET} ${DIM}(newest first)${RESET}"
-
-  # Read non-comment lines, reverse (newest first), take max_lines
-  grep -v '^#' "$log_file" 2>/dev/null | grep -v '^$' | tail -r 2>/dev/null | head -"$max_lines" | \
-  while IFS= read -r line; do
-    # Parse: date | agent | action | detail
-    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*|dispatch) icon="▸"; color="$MAGENTA" ;;
-      team-*)               icon="⚡"; color="$CYAN" ;;
-      manual|user)          icon="★"; color="$BOLD" ;;
-      planner*)             icon="□"; color="$YELLOW" ;;
-      generator*|gen*)      icon="▶"; color="$GREEN" ;;
-      eval*)                icon="✦"; color="$RED" ;;
-      system)               icon="⚙"; color="$DIM" ;;
-      *)                    icon="·"; color="$DIM" ;;
-    esac
+render_bottleneck_alert() {
+  if [ ! -f "$QUEUE" ] || [ ! -f "$FEATURES" ]; then return; fi
 
-    if [ ${#detail} -gt 45 ]; then detail="${detail:0:43}.."; fi
+  local failed_list blocked_count idle_teams in_prog
+  failed_list=$(jq -r '.queue.failed[]' "$QUEUE" 2>/dev/null)
+  blocked_count=$(jq '.queue.blocked | length' "$QUEUE" 2>/dev/null || echo 0)
+  in_prog=$(jq '.queue.in_progress | length' "$QUEUE" 2>/dev/null || echo 0)
+  idle_teams=0
 
-    echo -e "  ${color}${icon}${RESET} ${DIM}${short_ts}${RESET} ${agent} ${DIM}${action}${RESET} ${detail}"
+  # Count idle teams
+  local team_count
+  team_count=$(jq '.teams | length' "$QUEUE" 2>/dev/null || echo 0)
+  for i in $(seq 1 "$team_count"); do
+    local ts
+    ts=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$QUEUE" 2>/dev/null)
+    if [ "$ts" = "idle" ]; then idle_teams=$((idle_teams + 1)); fi
   done
 
-  echo ""
+  if [ -z "$failed_list" ]; then return; fi
+
+  # Check each failed feature for blocking impact
+  while IFS= read -r fid; do
+    [ -z "$fid" ] && continue
+    # Count how many blocked features depend on this fid
+    local deps_on_this
+    deps_on_this=$(jq --arg fid "$fid" '[.queue.blocked | to_entries[] | select(.value | index($fid))] | length' "$QUEUE" 2>/dev/null || echo 0)
+
+    if [ "$deps_on_this" -gt 0 ]; then
+      echo ""
+      echo -e "  ${RED}${BOLD}⚠ BOTTLENECK${RESET} ${RED}${fid}${RESET} failed → ${YELLOW}${deps_on_this} features blocked${RESET}"
+      if [ "$idle_teams" -gt 0 ]; then
+        echo -e "  ${BOLD}→ requeue:${RESET} bash scripts/harness-queue-manager.sh requeue ${fid} ."
+      fi
+    fi
+  done <<< "$failed_list"
+
+  # All teams idle + nothing in progress = stalled
+  if [ "$idle_teams" -eq "$team_count" ] && [ "$in_prog" -eq 0 ] && [ "$blocked_count" -gt 0 ]; then
+    echo ""
+    echo -e "  ${RED}${BOLD}!! STALLED${RESET} — All teams idle, ${blocked_count} features blocked"
+    echo -e "  ${BOLD}→ requeue failed features or check dependency graph${RESET}"
+  fi
 }
 
 render_all() {
   render_header
   render_queue_summary
   render_teams
-  render_prompt_history
-  render_feature_list
-  echo -e "  ${DIM}Refreshing every 3s${RESET}"
+  render_bottleneck_alert
+  echo ""
+  render_features
 }
 
 # ── Main loop ──
 tput civis 2>/dev/null
 trap 'tput cnorm 2>/dev/null; exit 0' EXIT INT TERM
-
 clear
 
 while true; do