@walwal-harness/cli 2.5.0 → 3.2.0

package/scripts/harness-user-prompt-submit.sh

@@ -1,55 +1,31 @@
 #!/bin/bash
-# harness-user-prompt-submit.sh
-# ─────────────────────────────────────────
-# Claude Code UserPromptSubmit hook
-# 모든 사용자 프롬프트를 harness-dispatcher 로 라우팅하도록 Claude 에게
-# 지시하는 컨텍스트를 stdout 에 주입한다.
-#
-# 활성 조건:
-#   1) 현재 cwd 에 .harness/config.json 존재
-#   2) .harness/config.json 의 behavior.auto_route_dispatcher != false
-#
-# 비활성 상황에서는 아무것도 출력하지 않고 exit 0 (pass-through).
-# ─────────────────────────────────────────
+# harness-user-prompt-submit.sh — UserPromptSubmit hook (compact v3.2)
+# 핵심 상태 + 라우팅 지시만 주입. 장황한 설명 제거.
 set -e
 
-# stdin 의 JSON payload 읽기 (Claude Code 가 {prompt, cwd, session_id, ...} 전달)
 INPUT=$(cat)
-
-# cwd 추출 (payload 에 없으면 PWD fallback)
 CWD=$(echo "$INPUT" | jq -r '.cwd // empty' 2>/dev/null || true)
-if [ -z "$CWD" ]; then
-  CWD="$PWD"
-fi
+if [ -z "$CWD" ]; then CWD="$PWD"; fi
 
 # 조건 1: 하네스 초기화 확인
-if [ ! -f "$CWD/.harness/config.json" ]; then
-  exit 0
-fi
+if [ ! -f "$CWD/.harness/config.json" ]; then exit 0; fi
 
-# 조건 2: opt-out 플래그 확인 (기본값 true)
+# 조건 2: opt-out 플래그 확인
 AUTO_ROUTE="true"
 if command -v jq >/dev/null 2>&1; then
   AUTO_ROUTE=$(jq -r '.behavior.auto_route_dispatcher // true' "$CWD/.harness/config.json" 2>/dev/null || echo "true")
 fi
-if [ "$AUTO_ROUTE" != "true" ]; then
-  exit 0
-fi
+if [ "$AUTO_ROUTE" != "true" ]; then exit 0; fi
 
-# 프롬프트 내용 추출 (opt-out 문구 감지용)
+# 사용자 skip 감지
 PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty' 2>/dev/null || true)
-# 사용자가 명시적으로 건너뛰기 요청하면 pass-through
 if echo "$PROMPT" | grep -qiE "harness\s*(skip|off|bypass|없이)|without\s*harness|just\s*(answer|chat|reply)"; then
   exit 0
 fi
 
 # 현재 세션 상태 읽기
-PIPELINE="none"
-CURRENT_AGENT="none"
-NEXT_AGENT="none"
-SPRINT_NUM="0"
-SPRINT_STATUS="init"
-FE_STACK="react"
+PIPELINE="none"; CURRENT_AGENT="none"; NEXT_AGENT="none"
+SPRINT_NUM="0"; SPRINT_STATUS="init"; AGENT_STATUS="pending"
 
 if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   PIPELINE=$(jq -r '.pipeline // "none"' "$CWD/.harness/progress.json" 2>/dev/null || echo "none")
@@ -57,50 +33,33 @@ if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   NEXT_AGENT=$(jq -r '.next_agent // "none"' "$CWD/.harness/progress.json" 2>/dev/null || echo "none")
   SPRINT_NUM=$(jq -r '.sprint.number // 0' "$CWD/.harness/progress.json" 2>/dev/null || echo "0")
   SPRINT_STATUS=$(jq -r '.sprint.status // "init"' "$CWD/.harness/progress.json" 2>/dev/null || echo "init")
+  AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$CWD/.harness/progress.json" 2>/dev/null || echo "pending")
 fi
 
-if [ -f "$CWD/.harness/actions/pipeline.json" ] && command -v jq >/dev/null 2>&1; then
-  FE_STACK=$(jq -r '.fe_stack // "react"' "$CWD/.harness/actions/pipeline.json" 2>/dev/null || echo "react")
+# ── 컨텍스트 분리 가드레일 ──
+# 현재 에이전트가 활성인데 다른 에이전트 스킬을 호출하려는 경우 경고
+CONTEXT_WARNING=""
+if [ "$CURRENT_AGENT" != "none" ] && [ "$CURRENT_AGENT" != "null" ] && [ "$AGENT_STATUS" = "running" ]; then
+  # 프롬프트에서 /harness-* 패턴 추출
+  REQUESTED_SKILL=$(echo "$PROMPT" | grep -oE '/harness-[a-z-]+' | head -1 | sed 's|/harness-||')
+  if [ -n "$REQUESTED_SKILL" ] && [ "$REQUESTED_SKILL" != "$CURRENT_AGENT" ]; then
+    CONTEXT_WARNING="
+## !! Context Isolation Warning !!
+current_agent=${CURRENT_AGENT} (running) 인데 /harness-${REQUESTED_SKILL} 호출 감지.
+한 세션에서 다른 에이전트를 실행하면 컨텍스트가 오염됩니다.
+현재 에이전트를 먼저 완료(completed)하거나, 새 세션을 시작하세요."
+  fi
 fi
 
-# ─────────────────────────────────────────
-# Context 주입 (stdout → Claude 컨텍스트)
-# ─────────────────────────────────────────
+# ── Compact context 주입 ──
 cat <<EOF
-[walwal-harness] Auto-routing is ACTIVE for this project.
-
-이 프로젝트는 walwal-harness 가 초기화되어 있으며, auto_route_dispatcher 플래그가
-켜져 있습니다. 사용자의 모든 프롬프트는 **harness-dispatcher** 스킬을 통해
-분류/라우팅된 뒤 처리되어야 합니다.
-
-## 분류 규칙 (Dispatcher Request Classification)
-- **기능 요청** (만들어줘, 추가, 고쳐줘, PRD, OpenAPI) → Pipeline Flow
-- **실수 지적** (아니, 잘못됐어, 그렇게 하면 안 돼, X로 해야지) → Gotcha Flow
-- **혼합** → Gotcha 먼저 기록 → Pipeline 이어서
-- **메타/인사/Claude 자체 질문** → 짧게 일반 응답 (dispatcher skip 허용)
-
-## 현재 harness 세션 상태
-- pipeline: $PIPELINE
-- current_agent: $CURRENT_AGENT
-- next_agent: $NEXT_AGENT
-- sprint: $SPRINT_NUM ($SPRINT_STATUS)
-- fe_stack: $FE_STACK
-
-## 지시
-1. 먼저 위 상태를 읽고, 사용자 메시지가 어떤 분류에 해당하는지 판단
-2. **pipeline 이 'none' 또는 dispatcher 미실행 상태**면 harness-dispatcher 스킬 호출
-3. **pipeline 이 이미 활성**이면:
-   - 실수 지적이면 → dispatcher 로 gotcha 기록
-   - 기능 연속 작업이면 → next_agent 또는 current_agent 의 컨텍스트로 계속
-4. 응답 전 반드시 \`.harness/progress.json\` 을 읽고 세션 경계 프로토콜 준수
-
-## 이 라우팅을 건너뛰려면
-- **단일 메시지**: 사용자가 "harness skip", "without harness", "harness 없이", "just answer" 등을 명시
-- **전역 비활성**: \`.harness/config.json\` 에서 \`behavior.auto_route_dispatcher = false\` 설정
-
-## 참고
-이 안내는 \`scripts/harness-user-prompt-submit.sh\` UserPromptSubmit 훅에 의해
-매 프롬프트마다 자동 주입됩니다. 중복 안내처럼 보여도 무시하지 말고 위 규칙을 따르세요.
+[harness] S${SPRINT_NUM} | ${PIPELINE} | agent=${CURRENT_AGENT} (${AGENT_STATUS}) | next=${NEXT_AGENT}
+${CONTEXT_WARNING}
+## Route
+- pipeline=none/dispatcher 미실행 → harness-dispatcher 스킬 호출
+- 기능 요청 → pipeline flow | 실수 지적 → gotcha flow | 메타 질문 → 짧게 응답 (skip)
+- 활성 pipeline → next_agent/current_agent 컨텍스트로 계속
+- skip: "harness skip", "just answer" 등 명시 시 단일 메시지 건너뜀
 EOF
 
 exit 0

package/scripts/lib/harness-guardrail.sh

@@ -0,0 +1,143 @@
+#!/bin/bash
+# harness-guardrail.sh — 런타임 파일 소유권 검증
+# 에이전트 전환 시 이전 에이전트가 권한 밖 파일을 수정했는지 git diff로 검증.
+#
+# 사용법: source lib/harness-guardrail.sh && verify_file_ownership "$PROJECT_ROOT"
+# 반환값: 0=통과, 1=위반 발견 (위반 목록을 stdout에 출력)
+
+# ─────────────────────────────────────────
+# Agent → 허용 경로 매핑
+# ─────────────────────────────────────────
+get_allowed_paths() {
+  local agent="$1"
+  case "$agent" in
+    planner)
+      echo "AGENTS.md"
+      echo ".harness/actions/"
+      echo ".harness/progress.json"
+      echo ".harness/progress.log"
+      ;;
+    generator-backend)
+      echo "apps/gateway/"
+      echo "apps/service-"
+      echo "libs/"
+      echo ".harness/actions/sprint-contract.md"
+      echo ".harness/actions/feature-list.json"
+      echo ".harness/progress.json"
+      echo "package.json"
+      echo "nest-cli.json"
+      echo "tsconfig"
+      echo "docker-compose"
+      ;;
+    generator-frontend|generator-frontend-flutter)
+      echo "apps/web/"
+      echo "apps/flutter/"
+      echo ".harness/actions/sprint-contract.md"
+      echo ".harness/actions/feature-list.json"
+      echo ".harness/progress.json"
+      echo "package.json"
+      echo "tsconfig"
+      echo "pubspec"
+      ;;
+    evaluator-functional|evaluator-functional-flutter)
+      echo ".harness/actions/evaluation-functional.md"
+      echo ".harness/progress.json"
+      echo "tests/"
+      echo "test/"
+      echo "e2e/"
+      echo "playwright"
+      ;;
+    evaluator-visual)
+      echo ".harness/actions/evaluation-visual.md"
+      echo ".harness/progress.json"
+      ;;
+    dispatcher)
+      echo ".harness/"
+      ;;
+    *)
+      echo "**"  # unknown agent — allow all (safe fallback)
+      ;;
+  esac
+}
+
+# ─────────────────────────────────────────
+# verify_file_ownership — git diff 기반 검증
+#
+# Args:
+#   $1 — project root
+#
+# Reads:
+#   .harness/progress.json (current_agent)
+#
+# Returns: 0=pass, 1=violation found
+# ─────────────────────────────────────────
+verify_file_ownership() {
+  local PROJECT_ROOT="$1"
+  local PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+
+  if [ ! -f "$PROGRESS" ]; then return 0; fi
+
+  local agent
+  agent=$(jq -r '.current_agent // "null"' "$PROGRESS" 2>/dev/null)
+  if [ "$agent" = "null" ] || [ -z "$agent" ]; then return 0; fi
+
+  # git이 없으면 skip
+  if ! command -v git &>/dev/null; then return 0; fi
+
+  # 마지막 커밋 이후 변경된 파일 목록
+  local -a changed_files
+  mapfile -t changed_files < <(cd "$PROJECT_ROOT" && git diff --name-only HEAD 2>/dev/null)
+
+  # staged 파일도 포함
+  local -a staged_files
+  mapfile -t staged_files < <(cd "$PROJECT_ROOT" && git diff --name-only --cached 2>/dev/null)
+
+  # 합치기 (중복 제거)
+  local -a all_files
+  mapfile -t all_files < <(printf '%s\n' "${changed_files[@]}" "${staged_files[@]}" | sort -u | grep -v '^$')
+
+  if [ ${#all_files[@]} -eq 0 ]; then return 0; fi
+
+  # 허용 경로 목록
+  local -a allowed
+  mapfile -t allowed < <(get_allowed_paths "$agent")
+
+  # 위반 검사
+  local -a violations=()
+  for file in "${all_files[@]}"; do
+    local is_allowed=false
+    for pattern in "${allowed[@]}"; do
+      if [[ "$file" == $pattern* ]]; then
+        is_allowed=true
+        break
+      fi
+    done
+    if [ "$is_allowed" = false ]; then
+      violations+=("$file")
+    fi
+  done
+
+  if [ ${#violations[@]} -eq 0 ]; then
+    return 0
+  fi
+
+  # 위반 보고
+  echo ""
+  echo "  ── Guardrail Violation ────────────────"
+  echo "  Agent '$agent' modified files outside its allowed paths:"
+  echo ""
+  for v in "${violations[@]}"; do
+    echo "    ✗ $v"
+  done
+  echo ""
+  echo "  Allowed paths for $agent:"
+  for p in "${allowed[@]}"; do
+    echo "    ✓ $p*"
+  done
+  echo ""
+  echo "  Action: Review these changes before proceeding."
+  echo "  ─────────────────────────────────────────"
+  echo ""
+
+  return 1
+}