@walwal-harness/cli 6.0.5 → 6.1.0

package/scripts/harness-goal-show.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# harness-goal-show.sh — 현재 active GOAL + 적합도 요약 출력
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PROGRESS="$ROOT/.harness/progress.json"
+GOAL_FILE="$ROOT/.harness/actions/goals.md"
+
+if [ ! -f "$PROGRESS" ]; then
+  echo "progress.json 없음. bash init.sh 먼저 실행." >&2; exit 1
+fi
+
+ACTIVE_ID=$(jq -r '.goals.active_id // ""' "$PROGRESS")
+ADHERENCE=$(jq -r '.goals.current_adherence // "n/a"' "$PROGRESS")
+
+if [ -z "$ACTIVE_ID" ]; then
+  echo "Active GOAL 없음. CEO(Dispatcher)가 첫 발화에서 발급."
+  echo "  bash scripts/harness-goal-init.sh \"<title>\""
+  exit 0
+fi
+
+echo "Active GOAL: $ACTIVE_ID"
+echo "Adherence:   $ADHERENCE"
+echo ""
+
+# progress.json 의 GOAL 메타 출력
+jq -r --arg id "$ACTIVE_ID" '
+  .goals.list[] | select(.id == $id) |
+  "title:           \(.title)",
+  "status:          \(.status)",
+  "owner_confirmed: \(.owner_confirmed)",
+  "cto_feasibility: \(.cto_feasibility // "pending")",
+  "created_at:      \(.created_at // "?")"
+' "$PROGRESS"
+
+echo ""
+echo "본문: $GOAL_FILE 에서 ## $ACTIVE_ID 섹션 참조"

package/scripts/harness-gotcha-memory.sh

@@ -0,0 +1,348 @@
+#!/bin/bash
+# harness-gotcha-memory.sh — Gotcha · Memory · Conventions pane (index view)
+# 활성 에이전트의 gotcha를 최상단으로, 나머지는 요약(최근 3항목+총개수)으로 표시
+# + Shared Memory 요약 + Conventions 요약 (shared + 활성 에이전트별)
+#
+# Usage:
+#   bash scripts/harness-gotcha-memory.sh [project-root]            # 전체 (legacy)
+#   bash scripts/harness-gotcha-memory.sh [project-root] --mode gotcha       # gotcha 만
+#   bash scripts/harness-gotcha-memory.sh [project-root] --mode conventions  # conventions 만
+#   bash scripts/harness-gotcha-memory.sh [project-root] --mode memory       # memory 만
+#
+# tmux 분할 환경에서는 각 sub-pane 이 한 mode 만 렌더 → 좁은 창에서도 잘리지 않음.
+# tmux copy-mode (prefix + [) 로 각 pane 독립 스크롤.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+source "$SCRIPT_DIR/lib/harness-keywait.sh"
+
+# Args parsing — first non-flag = project root, --mode = view mode
+PROJECT_ROOT=""
+MODE="all"
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --mode) MODE="$2"; shift 2 ;;
+    --mode=*) MODE="${1#--mode=}"; shift ;;
+    *) [ -z "$PROJECT_ROOT" ] && PROJECT_ROOT="$1"; shift ;;
+  esac
+done
+
+if [ -z "$PROJECT_ROOT" ]; then
+  PROJECT_ROOT="$(resolve_harness_root ".")" || { echo "[gotcha] .harness/ not found."; exit 1; }
+fi
+
+case "$MODE" in
+  all|gotcha|conventions|memory) ;;
+  *) echo "[gotcha] unknown mode: $MODE" >&2; exit 1 ;;
+esac
+
+MEMORY_FILE="$PROJECT_ROOT/.harness/memory.md"
+GOTCHAS_DIR="$PROJECT_ROOT/.harness/gotchas"
+CONVENTIONS_DIR="$PROJECT_ROOT/.harness/conventions"
+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"
+BG_YELLOW="\033[43m"
+
+REFRESH_SEC="${HARNESS_REFRESH:-5}"
+# 단독 mode 패널은 전체 표시 (충분한 세로 공간), 통합 뷰만 최근 3 개로 압축.
+if [ "$MODE" = "all" ]; then
+  RECENT_N="${HARNESS_GOTCHA_RECENT:-3}"
+else
+  RECENT_N="${HARNESS_GOTCHA_RECENT:-9999}"
+fi
+
+# 렌더 캐시 — 내용이 바뀌지 않으면 redraw 스킵
+LAST_SIG=""
+
+# 입력 시그니처: gotchas + memory + 활성 에이전트의 mtime/size 해시
+compute_signature() {
+  {
+    [ -f "$PROGRESS" ] && stat -f '%m %z' "$PROGRESS" 2>/dev/null
+    [ -f "$MEMORY_FILE" ] && stat -f '%m %z' "$MEMORY_FILE" 2>/dev/null
+    if [ -d "$GOTCHAS_DIR" ]; then
+      for f in "$GOTCHAS_DIR"/*.md; do
+        [ -e "$f" ] || continue
+        stat -f '%N %m %z' "$f" 2>/dev/null
+      done
+    fi
+    if [ -d "$CONVENTIONS_DIR" ]; then
+      for f in "$CONVENTIONS_DIR"/*.md; do
+        [ -e "$f" ] || continue
+        stat -f '%N %m %z' "$f" 2>/dev/null
+      done
+    fi
+  } | md5 -q 2>/dev/null || echo "$RANDOM"
+}
+
+# 활성 에이전트 결정: current_agent > next_agent
+get_active_agent() {
+  [ -f "$PROGRESS" ] || { echo ""; return; }
+  command -v jq &>/dev/null || { echo ""; return; }
+  local cur nxt
+  cur=$(jq -r '.current_agent // ""' "$PROGRESS" 2>/dev/null)
+  nxt=$(jq -r '.next_agent // ""' "$PROGRESS" 2>/dev/null)
+  if [ -n "$cur" ] && [ "$cur" != "null" ] && [ "$cur" != "none" ]; then
+    echo "$cur"
+  elif [ -n "$nxt" ] && [ "$nxt" != "null" ] && [ "$nxt" != "none" ]; then
+    echo "$nxt"
+  else
+    echo ""
+  fi
+}
+
+# gotcha 파일에서 '### ' 헤딩 개수 = 항목 총수
+count_items() {
+  local f="$1"
+  local n
+  n=$(grep -c '^### ' "$f" 2>/dev/null)
+  echo "${n:-0}"
+}
+
+# 최근 N개 항목 제목 추출 (### 헤딩 — 파일 하단부가 최신이라 tail)
+# rule_id 마커 주석(<!-- rule_id: ... -->) 은 시각적 노이즈라 제거
+recent_titles() {
+  local f="$1" n="$2"
+  grep '^### ' "$f" 2>/dev/null \
+    | tail -n "$n" \
+    | sed -E 's/^### //; s/[[:space:]]*<!--[[:space:]]*rule_id:[[:space:]]*[^>]*-->[[:space:]]*$//'
+}
+
+# agent 이름 → 파일 basename 매핑 (정확/접두 일치)
+file_for_agent() {
+  local agent="$1"
+  local f="$GOTCHAS_DIR/${agent}.md"
+  [ -f "$f" ] && { echo "$f"; return; }
+  # 접두 일치 (예: current_agent=generator → generator-backend/frontend 중 하나)
+  for cand in "$GOTCHAS_DIR"/*.md; do
+    [ -e "$cand" ] || continue
+    local base
+    base=$(basename "$cand" .md)
+    [ "$base" = "README" ] && continue
+    case "$base" in
+      "$agent"*|*"$agent"*) echo "$cand"; return ;;
+    esac
+  done
+  echo ""
+}
+
+render_gotcha_entry() {
+  local f="$1" active="$2"
+  local name count
+  name=$(basename "$f" .md)
+  count=$(count_items "$f")
+  if [ "$active" = "true" ]; then
+    echo -e "${BOLD}${BG_YELLOW} ▸ ${name} ${RESET} ${DIM}(${count} items · ACTIVE)${RESET}"
+  else
+    echo -e "${BOLD}${GREEN}▸ ${name}${RESET} ${DIM}(${count} items)${RESET}"
+  fi
+  if [ "$count" -eq 0 ]; then
+    echo -e "  ${DIM}(항목 없음)${RESET}"
+  else
+    recent_titles "$f" "$RECENT_N" | while IFS= read -r t; do
+      echo -e "  ${DIM}·${RESET} $t"
+    done
+  fi
+}
+
+render_conventions_summary() {
+  if [ ! -d "$CONVENTIONS_DIR" ]; then
+    echo -e "${DIM}(conventions/ 없음)${RESET}"
+    return
+  fi
+
+  local active="$1"
+  local any=false
+
+  # Shared 먼저, 그다음 활성 에이전트, 그다음 나머지
+  local ordered_files=()
+  [ -f "$CONVENTIONS_DIR/shared.md" ] && ordered_files+=("$CONVENTIONS_DIR/shared.md")
+  if [ -n "$active" ] && [ -f "$CONVENTIONS_DIR/${active}.md" ]; then
+    ordered_files+=("$CONVENTIONS_DIR/${active}.md")
+  fi
+  for cand in "$CONVENTIONS_DIR"/*.md; do
+    [ -e "$cand" ] || continue
+    local base; base=$(basename "$cand" .md)
+    [ "$base" = "README" ] && continue
+    [ "$cand" = "$CONVENTIONS_DIR/shared.md" ] && continue
+    [ -n "$active" ] && [ "$cand" = "$CONVENTIONS_DIR/${active}.md" ] && continue
+    ordered_files+=("$cand")
+  done
+
+  for f in "${ordered_files[@]}"; do
+    [ -e "$f" ] || continue
+    local name count
+    name=$(basename "$f" .md)
+    count=$(count_items "$f")
+    if [ "$name" = "shared" ]; then
+      echo -e "${BOLD}${CYAN}▸ ${name}${RESET} ${DIM}(${count} items · shared)${RESET}"
+    elif [ -n "$active" ] && [ "$name" = "$active" ]; then
+      echo -e "${BOLD}${BG_YELLOW} ▸ ${name} ${RESET} ${DIM}(${count} items · ACTIVE)${RESET}"
+    else
+      echo -e "${BOLD}${GREEN}▸ ${name}${RESET} ${DIM}(${count} items)${RESET}"
+    fi
+    if [ "$count" -eq 0 ]; then
+      echo -e "  ${DIM}(항목 없음)${RESET}"
+    else
+      recent_titles "$f" "$RECENT_N" | while IFS= read -r t; do
+        echo -e "  ${DIM}·${RESET} $t"
+      done
+    fi
+    any=true
+  done
+
+  [ "$any" = "false" ] && echo -e "${DIM}(항목 없음)${RESET}"
+}
+
+render_memory_summary() {
+  if [ ! -f "$MEMORY_FILE" ]; then
+    echo -e "${DIM}(memory.md 없음)${RESET}"
+    return
+  fi
+  local count
+  count=$(grep -c '^### ' "$MEMORY_FILE" 2>/dev/null)
+  count="${count:-0}"
+  echo -e "${BOLD}${CYAN}▣ SHARED MEMORY${RESET} ${DIM}(${count} items · memory.md)${RESET}"
+  if [ "$count" -eq 0 ]; then
+    echo -e "  ${DIM}(항목 없음)${RESET}"
+  else
+    grep '^### ' "$MEMORY_FILE" | tail -n "$RECENT_N" | sed 's/^### //' | while IFS= read -r t; do
+      echo -e "  ${DIM}·${RESET} $t"
+    done
+  fi
+}
+
+render_header() {
+  local title="$1"
+  local cols hr
+  cols=$(tput cols 2>/dev/null || echo 80)
+  hr=$(printf '─%.0s' $(seq 1 "$cols"))
+  echo -e "${BOLD}${MAGENTA}${title}${RESET} ${DIM}$(date +%H:%M:%S) · recent=${RECENT_N} · refresh ${REFRESH_SEC}s${RESET}"
+  local active="$1_active"
+  [ -n "${2:-}" ] && echo -e "${DIM}active agent:${RESET} ${BOLD}${YELLOW}$2${RESET}"
+  echo -e "${DIM}${hr}${RESET}"
+}
+
+render_gotcha_section() {
+  local active="$1" active_file="$2"
+  local cols hr
+  cols=$(tput cols 2>/dev/null || echo 80)
+  hr=$(printf '─%.0s' $(seq 1 "$cols"))
+  echo -e "${BOLD}${MAGENTA}▣ GOTCHAS${RESET} ${DIM}(.harness/gotchas) · $(date +%H:%M:%S) · refresh ${REFRESH_SEC}s${RESET}"
+  if [ -n "$active" ]; then
+    echo -e "${DIM}active agent:${RESET} ${BOLD}${YELLOW}${active}${RESET}"
+  fi
+  echo -e "${DIM}${hr}${RESET}"
+
+  if [ -n "$active_file" ]; then
+    render_gotcha_entry "$active_file" "true"
+    echo ""
+  fi
+  if [ -d "$GOTCHAS_DIR" ]; then
+    for f in "$GOTCHAS_DIR"/*.md; do
+      [ -e "$f" ] || continue
+      [ "$f" = "$active_file" ] && continue
+      local base; base=$(basename "$f" .md)
+      [ "$base" = "README" ] && continue
+      render_gotcha_entry "$f" "false"
+    done
+  fi
+}
+
+render_conventions_section() {
+  local active="$1"
+  local cols hr
+  cols=$(tput cols 2>/dev/null || echo 80)
+  hr=$(printf '─%.0s' $(seq 1 "$cols"))
+  echo -e "${BOLD}${CYAN}▣ CONVENTIONS${RESET} ${DIM}(.harness/conventions) · $(date +%H:%M:%S) · refresh ${REFRESH_SEC}s${RESET}"
+  echo -e "${DIM}${hr}${RESET}"
+  render_conventions_summary "$active"
+}
+
+render_memory_section() {
+  local cols hr
+  cols=$(tput cols 2>/dev/null || echo 80)
+  hr=$(printf '─%.0s' $(seq 1 "$cols"))
+  echo -e "${BOLD}${CYAN}▣ SHARED MEMORY${RESET} ${DIM}(memory.md) · $(date +%H:%M:%S) · refresh ${REFRESH_SEC}s${RESET}"
+  echo -e "${DIM}${hr}${RESET}"
+  render_memory_summary
+}
+
+render() {
+  # clear 대신 커서 홈 + 화면 끝까지 지우기 — 깜빡임 최소화
+  printf '\033[H\033[2J\033[3J'
+
+  local active active_file
+  active=$(get_active_agent)
+  active_file=""
+  [ -n "$active" ] && active_file=$(file_for_agent "$active")
+
+  case "$MODE" in
+    gotcha)
+      render_gotcha_section "$active" "$active_file"
+      ;;
+    conventions)
+      render_conventions_section "$active"
+      ;;
+    memory)
+      render_memory_section
+      ;;
+    all)
+      local cols hr
+      cols=$(tput cols 2>/dev/null || echo 80)
+      hr=$(printf '─%.0s' $(seq 1 "$cols"))
+      echo -e "${BOLD}${MAGENTA}RULES INDEX${RESET} ${DIM}Gotcha · Memory · Conventions · $(date +%H:%M:%S) · recent=${RECENT_N} · refresh ${REFRESH_SEC}s${RESET}"
+      if [ -n "$active" ]; then
+        echo -e "${DIM}active agent:${RESET} ${BOLD}${YELLOW}${active}${RESET}"
+      else
+        echo -e "${DIM}active agent: (none)${RESET}"
+      fi
+      echo -e "${DIM}${hr}${RESET}"
+
+      if [ -n "$active_file" ]; then
+        render_gotcha_entry "$active_file" "true"
+        echo ""
+      fi
+      if [ -d "$GOTCHAS_DIR" ]; then
+        for f in "$GOTCHAS_DIR"/*.md; do
+          [ -e "$f" ] || continue
+          [ "$f" = "$active_file" ] && continue
+          local base; base=$(basename "$f" .md)
+          [ "$base" = "README" ] && continue
+          render_gotcha_entry "$f" "false"
+        done
+      fi
+      echo ""
+      echo -e "${DIM}${hr}${RESET}"
+      echo -e "${BOLD}${CYAN}▣ CONVENTIONS${RESET} ${DIM}(.harness/conventions)${RESET}"
+      render_conventions_summary "$active"
+      echo ""
+      echo -e "${DIM}${hr}${RESET}"
+      render_memory_summary
+      ;;
+  esac
+}
+
+trap 'exit 0' INT TERM
+
+while true; do
+  sig=$(compute_signature)
+  if [ "$sig" != "$LAST_SIG" ]; then
+    render
+    printf "${DIM}  [r] refresh  [q] quit${RESET}\033[K\n"
+    LAST_SIG="$sig"
+  fi
+  if ! wait_or_refresh "$REFRESH_SEC"; then
+    # 'r' 키 → 캐시 무효화해서 다음 루프에서 강제 렌더
+    LAST_SIG=""
+  fi
+done