@walwal-harness/cli 5.7.1 → 5.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.7.1",
+  "version": "5.7.3",
   "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

@@ -1,6 +1,7 @@
 #!/bin/bash
-# harness-gotcha-memory.sh — Gotcha & Memory pane (index view)
+# 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]
 
 set -uo pipefail
@@ -16,6 +17,7 @@ fi
 
 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"
@@ -45,6 +47,12 @@ compute_signature() {
         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"
 }
 
@@ -115,6 +123,55 @@ render_gotcha_entry() {
   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}"
@@ -145,7 +202,7 @@ render() {
   active_file=""
   [ -n "$active" ] && active_file=$(file_for_agent "$active")
 
-  echo -e "${BOLD}${MAGENTA}GOTCHA INDEX${RESET}  ${DIM}$(date +%H:%M:%S) · recent=${RECENT_N} · refresh ${REFRESH_SEC}s${RESET}"
+  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
@@ -171,6 +228,11 @@ render() {
     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

package/scripts/harness-tmux.sh

@@ -142,6 +142,10 @@ APPLESCRIPT
 }
 
 launch_iterm2_solo() {
+  # Solo 레이아웃 (Team 모드와 동일 구조, 우측만 단일 Monitor 패널):
+  #   Left col : Dashboard (top) + Prompt History (bottom)
+  #   Middle   : Gotcha · Memory · Conventions
+  #   Right    : Monitor (lifecycle stream, 단일 에이전트)
   osascript <<APPLESCRIPT
     tell application "iTerm2"
       activate
@@ -153,22 +157,22 @@ launch_iterm2_solo() {
           set name to "harness-studio"
           write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-dashboard.sh' '${PROJECT_ROOT}'"
 
-          -- Split right → Monitor
-          set monPane to (split vertically with default profile)
-          tell monPane
-            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-monitor.sh' '${PROJECT_ROOT}'"
-
-            -- Split right → Agent Session
-            set agentPane to (split vertically with default profile)
-            tell agentPane
-              write text "cd '${PROJECT_ROOT}' && clear"
-            end tell
+          -- Split down (bottom of Dashboard column) → Prompt History
+          set archivePane to (split horizontally with default profile)
+          tell archivePane
+            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-prompt-history.sh' '${PROJECT_ROOT}'"
           end tell
 
-          -- Split down → Prompt History (bottom-left)
-          set histPane to (split horizontally with default profile)
-          tell histPane
-            write text "cd '${PROJECT_ROOT}' && bash '${SCRIPT_DIR}/harness-prompt-history.sh' '${PROJECT_ROOT}'"
+          -- 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 → Monitor (solo 단일 에이전트 라이프사이클)
+            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
           end tell
         end tell
       end tell
@@ -199,7 +203,7 @@ launch_tmux_team() {
 
   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"
+  tmux select-pane -t "$PANE_GOTCHA"  -T "Gotcha · Memory · Conventions"
   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"
@@ -210,23 +214,24 @@ launch_tmux_team() {
 }
 
 launch_tmux_solo() {
+  # Solo 레이아웃 (Team 모드와 동일 구조, 우측만 단일 Monitor 패널).
   tmux kill-session -t "$SESSION_NAME" 2>/dev/null || true
 
-  PANE_DASHBOARD=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 200 -y 50 -P -F '#{pane_id}' \
-    "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-dashboard.sh\" \"${PROJECT_ROOT}\"'")
-  PANE_MONITOR=$(tmux split-window -h -p 60 -t "$PANE_DASHBOARD" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+  PANE_DASH=$(tmux new-session -d -s "$SESSION_NAME" -c "$PROJECT_ROOT" -x 200 -y 50 -P -F '#{pane_id}')
+  PANE_GOTCHA=$(tmux split-window -h -p 70 -t "$PANE_DASH" -c "$PROJECT_ROOT" -P -F '#{pane_id}')
+  PANE_MONITOR=$(tmux split-window -h -p 50 -t "$PANE_GOTCHA" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
     "bash --norc --noprofile -c 'exec bash \"${SCRIPT_DIR}/harness-monitor.sh\" \"${PROJECT_ROOT}\"'")
-  PANE_HISTORY=$(tmux split-window -v -p 30 -t "$PANE_DASHBOARD" -c "$PROJECT_ROOT" -P -F '#{pane_id}' \
+  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}\"'")
-  PANE_AGENT=$(tmux split-window -v -p 85 -t "$PANE_MONITOR" -c "$PROJECT_ROOT" -P -F '#{pane_id}')
 
-  tmux send-keys -t "$PANE_AGENT" "clear" Enter
+  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 select-pane -t "$PANE_DASHBOARD" -T "Dashboard"
-  tmux select-pane -t "$PANE_MONITOR"   -T "Monitor"
-  tmux select-pane -t "$PANE_HISTORY"   -T "Prompt History"
-  tmux select-pane -t "$PANE_AGENT"     -T "Agent Session"
-  tmux select-pane -t "$PANE_AGENT"
+  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_MONITOR" -T "Monitor"
+  tmux select-pane -t "$PANE_DASH"
 
   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