@walwal-harness/cli 6.0.5 → 6.1.0

package/scripts/harness-session-start.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# harness-session-start.sh — SessionStart 훅
+# 새 세션 시작 시 자동으로:
+#   1) 이전 에이전트가 completed이면 harness-next.sh 실행 (게이트 + handoff)
+#   2) Planner/Dispatcher 사이클이면 audit 리셋
+#   3) 모드별 안내 출력
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB="$SCRIPT_DIR/lib/harness-render-progress.sh"
+AUDIT_LIB="$SCRIPT_DIR/lib/harness-audit.sh"
+
+if [ ! -f "$LIB" ]; then exit 0; fi
+source "$LIB"
+[ -f "$AUDIT_LIB" ] && source "$AUDIT_LIB"
+command -v jq &>/dev/null || exit 0
+
+PROJECT_ROOT="$(resolve_harness_root "." 2>/dev/null)" || exit 0
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+CONFIG="$PROJECT_ROOT/.harness/config.json"
+HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
+[ -f "$PROGRESS" ] || exit 0
+
+sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null)
+sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
+current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
+next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
+agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+mode=$(jq -r '.mode // "team"' "$PROGRESS" 2>/dev/null)
+conductor_state=$(jq -r '.conductor.state // "idle"' "$PROGRESS" 2>/dev/null)
+
+# ─────────────────────────────────────────
+# Auto-heal mode drift — Team 상태 유실 복구
+#   feature-queue.json 에 활성 작업(in_progress)이 있는데 mode 가 solo/paused 면
+#   누군가 progress.json 을 통째로 덮어써서 team_state 를 날린 것. mode=team 으로
+#   자동 복원하고 경고 로그 남김.
+# ─────────────────────────────────────────
+FEATURE_QUEUE_HEAL="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+if [ -f "$FEATURE_QUEUE_HEAL" ] && [ "$mode" != "team" ]; then
+  active_count=$(jq -r '(.queue.in_progress | length) // 0' "$FEATURE_QUEUE_HEAL" 2>/dev/null || echo 0)
+  if [ "${active_count:-0}" -gt 0 ]; then
+    heal_teams=$active_count
+    [ "$heal_teams" -gt 3 ] && heal_teams=3
+    bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+      ".mode = \"team\" | .team_state.active_teams = ${heal_teams} | .team_state.paused_at = null" \
+      2>/dev/null
+    mode="team"
+    echo "# Harness: mode auto-healed to 'team' (feature-queue has ${active_count} active, but mode was drifted)" >&2
+    if [ -f "$PROJECT_ROOT/.harness/progress.log" ]; then
+      echo "$(date +'%Y-%m-%d %H:%M') | system | heal | mode | reset solo→team (queue had ${active_count} in_progress)" >> "$PROJECT_ROOT/.harness/progress.log"
+    fi
+  fi
+fi
+
+# ─────────────────────────────────────────
+# Team Mode — 팀이 자율 실행 중이면 오케스트레이터 안내
+# ─────────────────────────────────────────
+if [ "$mode" = "team" ]; then
+  FEATURE_QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+  passed=0; total=0; in_prog=0; failed=0
+  if [ -f "$FEATURE_QUEUE" ]; then
+    passed=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+    total=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+    in_prog=$(jq '.queue.in_progress | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+    failed=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  fi
+
+  echo "# Harness Team Mode active"
+  echo "# Queue: ${passed}/${total} passed, ${in_prog} in progress, ${failed} failed"
+  echo "# Worker pool runs autonomously (Gen-Eval loop, max 5 retries). Control-plane Cxx agents are outside this limit."
+  echo "# Stop: /harness-stop | Emergency fallback: /harness-solo"
+  exit 0
+fi
+
+# ─────────────────────────────────────────
+# Paused Mode — 중단 상태 안내
+# ─────────────────────────────────────────
+if [ "$mode" = "paused" ]; then
+  echo "# Harness paused — resume with /harness-team"
+  exit 0
+fi
+
+# ─────────────────────────────────────────
+# init 상태: 첫 안내
+# ─────────────────────────────────────────
+if [ "$sprint_status" = "init" ]; then
+  echo "# Harness ready — say \"하네스 엔지니어링 시작\" or /harness-dispatcher"
+  echo "# 기본 경로는 회사 루프입니다: dispatch -> CEO meeting -> COO/CTO 분배 -> gen/eval -> CQO -> service-ops -> batch meeting."
+  exit 0
+fi
+
+# ─────────────────────────────────────────
+# Audit lifecycle: Planner/Dispatcher 시작 시 리셋
+# ─────────────────────────────────────────
+init_audit "$PROJECT_ROOT"
+if [ "$next_agent" = "planner" ] || [ "$next_agent" = "dispatcher" ]; then
+  # 새 사이클 — 이전 audit을 archive로 이동하고 새로 시작
+  reset_audit "$PROJECT_ROOT" "$sprint_num"
+  audit_log "system" "cycle" "start" "sprint-${sprint_num}" "new plan/dispatch cycle"
+fi
+
+# ─────────────────────────────────────────
+# 이전 에이전트가 completed/failed → 자동 전환
+# ─────────────────────────────────────────
+if [ "$agent_status" = "completed" ] || [ "$agent_status" = "failed" ]; then
+  bash "$SCRIPT_DIR/harness-next.sh" "$PROJECT_ROOT" 2>/dev/null
+
+  next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
+  agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+fi
+
+# ─────────────────────────────────────────
+# Conductor running/queued → refresh routing once on session start
+# ─────────────────────────────────────────
+if [ "$conductor_state" = "running" ] || [ "$next_agent" = "conductor" ]; then
+  if [ -x "$SCRIPT_DIR/conductor-tick.sh" ]; then
+    bash "$SCRIPT_DIR/conductor-tick.sh" "$PROJECT_ROOT" >/dev/null 2>&1 || true
+    next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
+  fi
+fi
+
+# ─────────────────────────────────────────
+# 상태별 안내 출력
+# ─────────────────────────────────────────
+if [ "$agent_status" = "blocked" ]; then
+  echo "# Harness BLOCKED — retry limit reached, user intervention required"
+
+elif [ -f "$HANDOFF" ] && [ "$next_agent" != "none" ] && [ "$next_agent" != "null" ]; then
+  handoff_model=$(jq -r '.model // "opus"' "$HANDOFF" 2>/dev/null)
+  handoff_thinking=$(jq -r '.thinking_mode // empty' "$HANDOFF" 2>/dev/null)
+
+  mode_str=""
+  if [ -n "$handoff_thinking" ] && [ "$handoff_thinking" != "null" ]; then
+    mode_str=" /${handoff_thinking}"
+  fi
+
+  echo "# Harness: next → /harness-${next_agent}  (${handoff_model}${mode_str})"
+
+elif [ "$current_agent" != "none" ] && [ "$current_agent" != "null" ]; then
+  echo "# Harness: ${current_agent} [${agent_status}]"
+fi

package/scripts/harness-statusline.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# harness-statusline.sh — Claude Code statusline hook (v5 unified)
+# 터미널 하단에 항상 고정되는 1줄 compact 상태 표시.
+# Solo: [S1] FULL | solo | >backend | sonnet | 2/5 feat | ctx 45% | $1.23
+# Team: [S1] FULL | team | T1:gen T2:eval T3:idle | 2/5 feat | ctx 45% | $1.23
+
+# Read Claude Code session data from stdin
+input=$(cat)
+
+# Extract Claude Code built-in data
+context_pct=$(echo "$input" | jq -r '.context_window.used_percentage // 0' 2>/dev/null | cut -d. -f1)
+cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0' 2>/dev/null)
+
+# Resolve project root (walk up from cwd)
+CWD=$(echo "$input" | jq -r '.workspace.current_dir // empty' 2>/dev/null)
+if [ -z "$CWD" ]; then CWD="$PWD"; fi
+
+PROJECT_ROOT="$CWD"
+while [ "$PROJECT_ROOT" != "/" ]; do
+  if [ -d "$PROJECT_ROOT/.harness" ]; then break; fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+FEATURE_LIST="$PROJECT_ROOT/.harness/actions/feature-list.json"
+PIPELINE_JSON="$PROJECT_ROOT/.harness/actions/pipeline.json"
+
+# No harness → minimal status
+if [ ! -f "$PROGRESS" ]; then
+  echo "harness: not initialized | ctx ${context_pct}%"
+  exit 0
+fi
+
+# Read harness state
+sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
+sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null)
+pipeline=$(jq -r '.pipeline // "?"' "$PROGRESS" 2>/dev/null)
+current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
+agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
+next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
+retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS" 2>/dev/null)
+harness_mode=$(jq -r '.mode // "solo"' "$PROGRESS" 2>/dev/null)
+
+# Pipeline short name
+case "$pipeline" in
+  FULLSTACK) pl="FULL" ;;
+  FE-ONLY)   pl="FE" ;;
+  BE-ONLY)   pl="BE" ;;
+  null|"?")  pl="?" ;;
+  *)         pl="$pipeline" ;;
+esac
+
+# Agent short name (strip harness prefix)
+agent_short="${current_agent#generator-}"
+agent_short="${agent_short#evaluator-}"
+if [ "$current_agent" = "none" ] || [ "$current_agent" = "null" ]; then
+  agent_short="$next_agent"
+  if [ "$agent_short" = "none" ] || [ "$agent_short" = "null" ]; then
+    agent_short="idle"
+  fi
+fi
+
+# Feature progress
+total_features=0
+completed_features=0
+if [ -f "$FEATURE_LIST" ]; then
+  total_features=$(jq '.features | length' "$FEATURE_LIST" 2>/dev/null || echo 0)
+  completed_features=$(jq '[.features[]? | select(
+    (.passes // []) | (
+      (map(select(. == "evaluator-code-quality")) | length > 0) and
+      (map(select(. == "evaluator-functional")) | length > 0) and
+      (map(select(. == "evaluator-visual")) | length > 0)
+    )
+  )] | length' "$FEATURE_LIST" 2>/dev/null || echo 0)
+fi
+
+# Status indicator
+status_icon=""
+case "$agent_status" in
+  running)   status_icon=">" ;;
+  completed) status_icon="v" ;;
+  failed)    status_icon="x" ;;
+  blocked)   status_icon="!" ;;
+  *)         status_icon="-" ;;
+esac
+
+# Retry indicator
+retry_str=""
+if [ "$retry_count" -gt 0 ]; then
+  retry_str=" R${retry_count}"
+fi
+
+# Model/mode for current or next agent
+CONFIG="$PROJECT_ROOT/.harness/config.json"
+active_agent="$current_agent"
+if [ "$active_agent" = "none" ] || [ "$active_agent" = "null" ]; then
+  active_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
+fi
+model_short=""
+if [ -f "$CONFIG" ] && [ "$active_agent" != "none" ] && [ "$active_agent" != "null" ]; then
+  am=$(jq -r ".agents[\"${active_agent}\"].model // empty" "$CONFIG" 2>/dev/null)
+  at=$(jq -r ".agents[\"${active_agent}\"].thinking_mode // empty" "$CONFIG" 2>/dev/null)
+  if [ -n "$am" ]; then
+    model_short="${am}"
+    if [ -n "$at" ] && [ "$at" != "null" ]; then
+      model_short+="/${at}"
+    fi
+  fi
+fi
+
+# Build compact status line based on mode
+FEATURE_QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+
+if [ "$harness_mode" = "team" ] && [ -f "$FEATURE_QUEUE" ]; then
+  # Team mode: show team status instead of single agent
+  team_info=""
+  for i in 1 2 3; do
+    t_status=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$FEATURE_QUEUE" 2>/dev/null)
+    t_feature=$(jq -r ".teams[\"$i\"].feature // \"\"" "$FEATURE_QUEUE" 2>/dev/null)
+    if [ "$t_status" = "busy" ] && [ -n "$t_feature" ] && [ "$t_feature" != "null" ]; then
+      t_phase=$(jq -r --arg f "$t_feature" '.queue.in_progress[$f].phase // "?"' "$FEATURE_QUEUE" 2>/dev/null)
+      team_info+="T${i}:${t_phase} "
+    else
+      team_info+="T${i}:- "
+    fi
+  done
+  t_passed=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  t_total=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+
+  echo "[S${sprint_num}] ${pl} | team | ${team_info}| ${t_passed}/${t_total} feat | ctx ${context_pct}% | \$${cost}"
+else
+  # Solo/paused mode: show single agent status
+  mode_tag="${harness_mode}"
+  if [ -n "$model_short" ]; then
+    echo "[S${sprint_num}] ${pl} | ${mode_tag} | ${status_icon}${agent_short}${retry_str} | ${model_short} | ${completed_features}/${total_features} feat | ctx ${context_pct}% | \$${cost}"
+  else
+    echo "[S${sprint_num}] ${pl} | ${mode_tag} | ${status_icon}${agent_short}${retry_str} | ${completed_features}/${total_features} feat | ctx ${context_pct}% | \$${cost}"
+  fi
+fi

package/scripts/harness-task-session.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# harness-task-session.sh — create per-agent task session document
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || exit 1
+AGENT="${2:-}"
+SOURCE="${3:-}"
+
+[ -n "$AGENT" ] || exit 2
+command -v jq >/dev/null 2>&1 || exit 1
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+TASK_ROOT="$PROJECT_ROOT/.harness/actions/task-sessions/$AGENT"
+mkdir -p "$TASK_ROOT"
+
+dispatch_id=$(jq -r '.dispatch.id // "D-000"' "$PROGRESS")
+sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
+ts=$(date -u +%Y%m%dT%H%M%SZ)
+session_id="${AGENT}-S$(printf '%03d' "$sprint_num")-${ts}"
+session_path="$TASK_ROOT/${session_id}.md"
+
+cat > "$session_path" <<EOF
+# Task Session — $session_id
+
+- agent: $AGENT
+- dispatch: $dispatch_id
+- sprint: $sprint_num
+- source: ${SOURCE:-none}
+- created_at: $(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+## Allowed Inputs
+- .harness/handoff.json
+- .harness/progress.json
+- assigned evidence documents only
+
+## Rule
+- 이전 대화 기억이 아니라 문서와 evidence만 근거로 판단할 것
+- 사실과 추론을 분리해서 기록할 것
+EOF
+
+bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+  ".task_sessions.current = {\"agent\":\"$AGENT\",\"id\":\"$session_id\",\"path\":\"${session_path#$PROJECT_ROOT/}\",\"source\":$(jq -Rn --arg v "${SOURCE:-}" '$v')} |
+   .task_sessions.history = ((.task_sessions.history // []) + [{\"agent\":\"$AGENT\",\"id\":\"$session_id\",\"path\":\"${session_path#$PROJECT_ROOT/}\",\"source\":$(jq -Rn --arg v "${SOURCE:-}" '$v')}])" >/dev/null
+
+echo "${session_path#$PROJECT_ROOT/}"