@walwal-harness/cli 5.9.0 → 5.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.9.0",
+  "version": "5.9.2",
   "description": "Production harness for AI agent engineering — Solo/Team mode, Planner, Generator(BE/FE), Evaluator chain (Code-Quality → Functional → Visual), optional Brainstormer. Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-gotcha-memory.sh

@@ -2,7 +2,15 @@
 # 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]
+#
+# 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
 
@@ -10,11 +18,26 @@ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 source "$SCRIPT_DIR/lib/harness-render-progress.sh"
 source "$SCRIPT_DIR/lib/harness-keywait.sh"
 
-PROJECT_ROOT="${1:-}"
+# 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"
@@ -190,54 +213,117 @@ render_memory_summary() {
   fi
 }
 
-render() {
-  # clear 대신 커서 홈 + 화면 끝까지 지우기 — 깜빡임 최소화
-  printf '\033[H\033[2J\033[3J'
+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}"
+}
 
-  local active active_file
-  active=$(get_active_agent)
-  active_file=""
-  [ -n "$active" ] && active_file=$(file_for_agent "$active")
-
-  echo -e "${BOLD}${MAGENTA}RULES INDEX${RESET} ${DIM}Gotcha · Memory · Conventions · $(date +%H:%M:%S) · recent=${RECENT_N} · refresh ${REFRESH_SEC}s${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}"
-  else
-    echo -e "${DIM}active agent: (none)${RESET}"
   fi
   echo -e "${DIM}${hr}${RESET}"
 
-  # 활성 에이전트 gotcha 최상단
   if [ -n "$active_file" ]; then
     render_gotcha_entry "$active_file" "true"
     echo ""
   fi
-
-  # 나머지 gotcha
   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)
+      local base; base=$(basename "$f" .md)
       [ "$base" = "README" ] && continue
       render_gotcha_entry "$f" "false"
     done
   fi
+}
 
-  echo ""
+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}"
-  echo -e "${BOLD}${CYAN}▣ CONVENTIONS${RESET} ${DIM}(.harness/conventions)${RESET}"
   render_conventions_summary "$active"
+}
 
-  echo ""
+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

package/scripts/harness-tmux.sh

@@ -112,28 +112,37 @@ launch_iterm2_team() {
             write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-prompt-history.sh' '${PROJECT_ROOT}'"
           end tell
 
-          -- Split right → Gotcha & Memory
-          set dashPane to (split vertically with default profile)
-          tell dashPane
-            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}'"
+          -- Split right → Gotchas (top of Rules column, full-height initially)
+          set gotchaPane to (split vertically with default profile)
+          tell gotchaPane
+            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode gotcha"
 
-            -- Split right → Team 1
+            -- IMPORTANT: Team 컬럼을 먼저 분리 (전체 높이 유지). 그 후에 gotchaPane 을 horizontal 분할.
             set t1Pane to (split vertically with default profile)
             tell t1Pane
               write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-monitor.sh' '${PROJECT_ROOT}' --team 1"
 
-              -- Split down → Team 2
               set t2Pane to (split horizontally with default profile)
               tell t2Pane
                 write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-monitor.sh' '${PROJECT_ROOT}' --team 2"
 
-                -- Split down → Team 3
                 set t3Pane to (split horizontally with default profile)
                 tell t3Pane
                   write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-monitor.sh' '${PROJECT_ROOT}' --team 3"
                 end tell
               end tell
             end tell
+
+            -- Team 컬럼 분리 후, gotchaPane (Rules 컬럼) 을 horizontal 두 번 split → Conventions / Memory
+            set convPane to (split horizontally with default profile)
+            tell convPane
+              write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode conventions"
+
+              set memPane to (split horizontally with default profile)
+              tell memPane
+                write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode memory"
+              end tell
+            end tell
           end tell
         end tell
       end tell
@@ -163,16 +172,27 @@ launch_iterm2_solo() {
             write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-prompt-history.sh' '${PROJECT_ROOT}'"
           end tell
 
-          -- Split right → Gotcha · Memory · Conventions
-          set dashPane to (split vertically with default profile)
-          tell dashPane
-            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}'"
+          -- Split right → Gotchas (top of Rules column, full-height initially)
+          set gotchaPane to (split vertically with default profile)
+          tell gotchaPane
+            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode gotcha"
 
-            -- Split right → Monitor (solo 단일 에이전트 라이프사이클)
+            -- Monitor 컬럼을 먼저 분리 (전체 높이 유지)
             set monPane to (split vertically with default profile)
             tell monPane
               write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-monitor.sh' '${PROJECT_ROOT}'"
             end tell
+
+            -- Monitor 분리 후, gotchaPane (Rules 컬럼) 을 horizontal 두 번 split → Conventions / Memory
+            set convPane to (split horizontally with default profile)
+            tell convPane
+              write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode conventions"
+
+              set memPane to (split horizontally with default profile)
+              tell memPane
+                write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-gotcha-memory.sh' '${PROJECT_ROOT}' --mode memory"
+              end tell
+            end tell
           end tell
         end tell
       end tell
@@ -198,12 +218,21 @@ launch_tmux_team() {
   PANE_ARCHIVE=$(tmux split-window -v -p 35 -t "$PANE_DASH" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
     "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
 
+  # Gotcha 패널을 3 개 sub-pane 으로 수직 분할: Gotchas / Conventions / Memory
+  # 각 pane 은 tmux copy-mode (prefix + [) 로 독립 스크롤 가능
+  PANE_CONV=$(tmux split-window -v -p 60 -t "$PANE_GOTCHA" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+    "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode conventions'")
+  PANE_MEM=$(tmux split-window -v -p 50 -t "$PANE_CONV" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+    "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode memory'")
+
   tmux send-keys -t "$PANE_DASH"   "bash \"${SCRIPT_DIR}/harness-dashboard.sh\" \"${PROJECT_ROOT}\"" Enter
-  tmux send-keys -t "$PANE_GOTCHA" "bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\"" Enter
+  tmux send-keys -t "$PANE_GOTCHA" "bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode gotcha" Enter
 
   tmux select-pane -t "$PANE_DASH"    -T "Dashboard"
   tmux select-pane -t "$PANE_ARCHIVE" -T "Archive Prompt"
-  tmux select-pane -t "$PANE_GOTCHA"  -T "Gotcha · Memory · Conventions"
+  tmux select-pane -t "$PANE_GOTCHA"  -T "Gotchas (scrollable: prefix + [ )"
+  tmux select-pane -t "$PANE_CONV"    -T "Conventions (scrollable: prefix + [ )"
+  tmux select-pane -t "$PANE_MEM"     -T "Shared Memory (scrollable: prefix + [ )"
   tmux select-pane -t "$PANE_T1"      -T "TEAM 1"
   tmux select-pane -t "$PANE_T2"      -T "TEAM 2"
   tmux select-pane -t "$PANE_T3"      -T "TEAM 3"
@@ -224,12 +253,20 @@ launch_tmux_solo() {
   PANE_HISTORY=$(tmux split-window -v -p 35 -t "$PANE_DASH" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
     "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-prompt-history.sh\" \"${PROJECT_ROOT}\"'")
 
+  # Gotcha 패널을 3 개 sub-pane 으로 수직 분할: Gotchas / Conventions / Memory
+  PANE_CONV=$(tmux split-window -v -p 60 -t "$PANE_GOTCHA" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+    "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode conventions'")
+  PANE_MEM=$(tmux split-window -v -p 50 -t "$PANE_CONV" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+    "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode memory'")
+
   tmux send-keys -t "$PANE_DASH"   "bash \"${SCRIPT_DIR}/harness-dashboard.sh\" \"${PROJECT_ROOT}\"" Enter
-  tmux send-keys -t "$PANE_GOTCHA" "bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\"" Enter
+  tmux send-keys -t "$PANE_GOTCHA" "bash \"${SCRIPT_DIR}/harness-gotcha-memory.sh\" \"${PROJECT_ROOT}\" --mode gotcha" Enter
 
   tmux select-pane -t "$PANE_DASH"    -T "Dashboard"
   tmux select-pane -t "$PANE_HISTORY" -T "Prompt History"
-  tmux select-pane -t "$PANE_GOTCHA"  -T "Gotcha · Memory · Conventions"
+  tmux select-pane -t "$PANE_GOTCHA"  -T "Gotchas (scrollable: prefix + [ )"
+  tmux select-pane -t "$PANE_CONV"    -T "Conventions (scrollable: prefix + [ )"
+  tmux select-pane -t "$PANE_MEM"     -T "Shared Memory (scrollable: prefix + [ )"
   tmux select-pane -t "$PANE_MONITOR" -T "Monitor"
   tmux select-pane -t "$PANE_DASH"