@walwal-harness/cli 6.0.3 → 6.0.5

package/scripts/init-ref-docs.sh

@@ -1,262 +0,0 @@
-#!/bin/bash
-# init-ref-docs.sh — 감지된 스택에 따라 .harness/ref/<role>-<stack>.md 를 준비한다.
-#
-# bash 혼자서는 Claude 의 WebSearch/WebFetch 를 호출할 수 없으므로 이 스크립트는:
-#   1. scan-result.json 에서 감지된 스택 목록을 계산
-#   2. --placeholder 모드: 최소 frontmatter + TODO 본문을 저장 (AC 검증용 · 파이프라인 unblock 용)
-#   3. --claude-prompt 모드: Claude 세션이 실제 WebSearch + WebFetch + synthesis 로 채울 수 있도록 프롬프트 템플릿을 stdout 출력
-#   4. --register 모드: Claude 가 실제 본문을 작성한 뒤 호출해 .generated.json 에 sources / generated_at 을 등록
-#
-# 사용 예:
-#   bash scripts/init-ref-docs.sh --dry-run .
-#   bash scripts/init-ref-docs.sh --yes --placeholder --stack swift --role fe .
-#   bash scripts/init-ref-docs.sh --claude-prompt --stack swift --role fe .
-#   bash scripts/init-ref-docs.sh --register --stack swift --role fe --sources "https://a,https://b" .
-set -e
-
-# ───── 옵션 파싱 ─────
-MODE="interactive"    # interactive | dry-run | placeholder | claude-prompt | register
-YES=false
-REFRESH=false
-STACK=""
-ROLE=""
-SOURCES=""
-PROJECT_ROOT="."
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dry-run)        MODE="dry-run"; shift ;;
-    --placeholder)    MODE="placeholder"; shift ;;
-    --claude-prompt)  MODE="claude-prompt"; shift ;;
-    --register)       MODE="register"; shift ;;
-    --yes)            YES=true; shift ;;
-    --refresh)        REFRESH=true; shift ;;
-    --stack)          STACK="$2"; shift 2 ;;
-    --role)           ROLE="$2"; shift 2 ;;
-    --sources)        SOURCES="$2"; shift 2 ;;
-    -h|--help)
-      sed -n '2,16p' "$0" | sed 's/^# //; s/^#//'
-      exit 0 ;;
-    *)                PROJECT_ROOT="$1"; shift ;;
-  esac
-done
-
-SCAN="${PROJECT_ROOT}/.harness/actions/scan-result.json"
-REF_DIR="${PROJECT_ROOT}/.harness/ref"
-META="${REF_DIR}/.generated.json"
-ARCHIVE_DIR="${PROJECT_ROOT}/.harness/archive"
-mkdir -p "$REF_DIR" "$ARCHIVE_DIR"
-[ -f "$META" ] || echo "{}" > "$META"
-
-# ───── 감지된 스택 목록 ─────
-detect_stacks() {
-  if [ ! -f "$SCAN" ]; then
-    echo "ERROR: scan-result.json 이 없습니다. 먼저 bash scripts/scan-project.sh ${PROJECT_ROOT} 실행하세요." >&2
-    exit 1
-  fi
-  local fe be native
-  fe=$(jq -r '.tech_stack.frontend' "$SCAN")
-  be=$(jq -r '.tech_stack.backend' "$SCAN")
-  native=$(jq -r '.tech_stack.is_native_app // false' "$SCAN")
-
-  # 네이티브 앱은 fe 만 기록 (be 는 null)
-  if [ "$fe" != "unknown" ] && [ "$fe" != "null" ]; then
-    echo "fe:$fe"
-  fi
-  if [ "$native" != "true" ] && [ "$be" != "unknown" ] && [ "$be" != "null" ]; then
-    echo "be:$be"
-  fi
-}
-
-# ───── placeholder 본문 ─────
-write_placeholder() {
-  local role="$1" stack="$2" path="$3"
-  local ts
-  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-  cat > "$path" <<REF
----
-docmeta:
-  id: ref-${role}-${stack}
-  stack: ${stack}
-  role: ${role}
-  language: ${stack}
-  generated_at: ${ts}
-  generator: init-ref-docs.sh (placeholder)
-  sources: []
-  version: 0
-runner:
-  dev_command: null
-  start_command: null
-  install_command: null
-paths:
-  source_roots: []
-  test_roots: []
-  config_files: []
-api:
-  base_url: null
-  gateway: null
-validation:
-  pre_eval_gate: []
-  functional_tests: []
-  visual:
-    enabled: false
-    reason: "placeholder — not yet filled by Claude"
-    manual_check: "bash init.sh refresh-ref ${role} ${stack} 실행 후 Claude 세션에서 WebSearch + WebFetch 로 채우기"
-  anti_pattern_rules: []
----
-
-# Ref — ${stack} (${role})
-
-> **Status**: PLACEHOLDER — Claude 가 WebSearch + WebFetch 로 채워야 함.
-> 실행: bash scripts/init-ref-docs.sh --claude-prompt --stack ${stack} --role ${role}
-
-## 1. Runner
-TODO
-
-## 2. Paths / Source Layout
-TODO
-
-## 3. Best Practices
-TODO
-
-## 4. Anti-Patterns (→ gotchas 시드 후보)
-TODO
-REF
-}
-
-# ───── Claude 용 프롬프트 ─────
-# React 계열 스택 (react / nextjs / vite-react) 일 때는
-# skills/generator-frontend/references/_web-react-legacy/ 의 4개 문서를
-# 로컬 seed 로 프롬프트에 포함시킨다. 이 seed 는 새 ref-docs 작성 시
-# "기존 웹 React 가이드" 참조용이며 WebSearch 결과와 병합된다.
-LEGACY_SEED_DIR="$(dirname "$0")/../skills/generator-frontend/references/_web-react-legacy"
-emit_claude_prompt() {
-  local role="$1" stack="$2" path="$3"
-  local legacy_hint=""
-  if [ "$role" = "fe" ] && [ -d "$LEGACY_SEED_DIR" ]; then
-    case "$stack" in
-      react|nextjs|vite-react|nuxt|vue|svelte|angular|*web*)
-        legacy_hint="
-Local seed (병합 대상 · 이미 검증된 웹/React best practice):
-$(ls "$LEGACY_SEED_DIR" 2>/dev/null | sed 's|^|  - '"$LEGACY_SEED_DIR"'/|')
-"
-        ;;
-    esac
-  fi
-  cat <<PROMPT
-───────────────────────────────────────────────
-Claude 세션에 아래 프롬프트를 전달하세요
-(또는 현재 세션이라면 그대로 실행):
-───────────────────────────────────────────────
-
-목표: ${path} 를 생성한다.
-
-1. WebSearch 로 다음 쿼리 실행: "${stack} best practices 2025 site:docs.*"
-2. 상위 3개 공식 문서 URL 을 WebFetch 로 가져온다.
-3. 결과를 종합해 다음 스키마로 YAML frontmatter + 본문을 작성한다:
-   - docmeta: { id, stack, role, language, generated_at, generator, sources, version }
-   - runner: { dev_command, start_command, install_command }
-   - paths: { source_roots, test_roots, config_files }
-   - api: { base_url, gateway }
-   - validation:
-       pre_eval_gate: [...]
-       functional_tests: [...]
-       visual: { enabled, reason, manual_check }
-       anti_pattern_rules: [{ id, pattern_type: "grep"|"lint_tool", pattern|tool+args, paths, severity }]
-4. 본문에는 Runner / Paths / Best Practices / Anti-Patterns 섹션 작성.
-5. 완료 후: bash scripts/init-ref-docs.sh --register --stack ${stack} --role ${role} --sources "<url1>,<url2>,<url3>" ${PROJECT_ROOT}
-${legacy_hint}
-───────────────────────────────────────────────
-PROMPT
-}
-
-# ───── register: 메타 기록 ─────
-register_meta() {
-  local role="$1" stack="$2" sources_csv="$3"
-  local ts key sources_json
-  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-  key="${role}-${stack}"
-  sources_json=$(echo "$sources_csv" | awk -F',' 'BEGIN{printf "["} {for(i=1;i<=NF;i++){printf (i>1?",":"") "\"" $i "\""}} END{printf "]"}')
-  [ -z "$sources_csv" ] && sources_json="[]"
-  jq --arg k "$key" --arg ts "$ts" --argjson s "$sources_json" '.[$k] = {"generated_at": $ts, "sources": $s, "status": "filled"}' "$META" > "${META}.tmp" && mv "${META}.tmp" "$META"
-  echo "registered: $key (sources=$(echo "$sources_json" | jq 'length'))"
-}
-
-# ───── 한 스택 처리 ─────
-process_one() {
-  local role="$1" stack="$2"
-  local path="${REF_DIR}/${role}-${stack}.md"
-
-  if [ -f "$path" ] && ! $REFRESH; then
-    echo "skip: $path 이미 존재 (--refresh 로 강제 재생성)"
-    return 0
-  fi
-  if [ -f "$path" ] && $REFRESH; then
-    local backup="${ARCHIVE_DIR}/ref-${role}-${stack}-$(date +%Y%m%d%H%M%S).md"
-    cp "$path" "$backup"
-    echo "archived: $backup"
-  fi
-
-  local answer="y"
-  if ! $YES; then
-    printf "Generate ref-docs for %s-%s? [y/N] " "$role" "$stack"
-    read -r answer </dev/tty || answer="n"
-  fi
-  case "$answer" in
-    y|Y|yes|YES) ;;
-    *) echo "skipped: $role-$stack"; return 3 ;;
-  esac
-
-  case "$MODE" in
-    placeholder)
-      write_placeholder "$role" "$stack" "$path"
-      local ts; ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-      jq --arg k "${role}-${stack}" --arg ts "$ts" '.[$k] = {"generated_at": $ts, "sources": [], "status": "placeholder"}' "$META" > "${META}.tmp" && mv "${META}.tmp" "$META"
-      echo "wrote: $path (placeholder)"
-      ;;
-    claude-prompt)
-      emit_claude_prompt "$role" "$stack" "$path"
-      ;;
-    *)
-      echo "ERROR: interactive 모드는 --placeholder 또는 --claude-prompt 중 하나를 지정하세요." >&2
-      return 1
-      ;;
-  esac
-}
-
-# ───── main ─────
-case "$MODE" in
-  dry-run)
-    echo "detected stacks:"
-    detect_stacks | sed 's/^/  - /'
-    echo ""
-    echo "ref files 예상 경로 (미존재 시 생성 대상):"
-    while IFS=':' read -r role stack; do
-      path="${REF_DIR}/${role}-${stack}.md"
-      if [ -f "$path" ]; then
-        echo "  [exists] $path"
-      else
-        echo "  [create] $path"
-      fi
-    done < <(detect_stacks)
-    ;;
-  register)
-    [ -z "$STACK" ] || [ -z "$ROLE" ] && { echo "ERROR: --register 는 --stack --role --sources 필요" >&2; exit 1; }
-    register_meta "$ROLE" "$STACK" "$SOURCES"
-    ;;
-  placeholder|claude-prompt)
-    if [ -n "$STACK" ] && [ -n "$ROLE" ]; then
-      process_one "$ROLE" "$STACK"
-    else
-      # 감지된 전체 스택을 순회
-      while IFS=':' read -r role stack; do
-        process_one "$role" "$stack"
-      done < <(detect_stacks)
-    fi
-    ;;
-  interactive)
-    echo "ERROR: 모드 지정 필요 — --dry-run | --placeholder | --claude-prompt | --register" >&2
-    echo "자세한 사용법: bash $0 --help" >&2
-    exit 1
-    ;;
-esac

package/scripts/lib/harness-audit.sh

@@ -1,113 +0,0 @@
-#!/bin/bash
-# harness-audit.sh — Audit log 헬퍼
-#
-# 라이프사이클: Planner 시작 → Eval 통과 (1 sprint cycle)
-# 새 Planner/Dispatcher 사이클 시작 시 이전 로그는 archive로 이동.
-#
-# 사용법:
-#   source scripts/lib/harness-audit.sh
-#   audit_log "gen-backend" "develop" "start" "apps/service-user/" "User 서비스 CRUD 구현"
-#   audit_log "eval-func"   "review"  "complete" "POST /api/auth" "FAIL: 409→400 contract 불일치"
-#   audit_log "gen-backend" "handoff" "start" "→eval-functional" ""
-
-AUDIT_LOG_FILE=""
-
-# ─────────────────────────────────────────
-# init_audit — audit.log 경로 설정 + 헤더 생성
-# Args: $1 = project root
-# ─────────────────────────────────────────
-init_audit() {
-  local project_root="${1:-.}"
-  AUDIT_LOG_FILE="$project_root/.harness/actions/audit.log"
-
-  # 디렉토리 보장
-  mkdir -p "$(dirname "$AUDIT_LOG_FILE")"
-}
-
-# ─────────────────────────────────────────
-# reset_audit — 새 사이클 시작 시 로그 초기화
-# 이전 로그가 있으면 archive로 이동
-# Args: $1 = project root, $2 = sprint number (optional)
-# ─────────────────────────────────────────
-reset_audit() {
-  local project_root="${1:-.}"
-  local sprint_num="${2:-0}"
-  init_audit "$project_root"
-
-  # 기존 로그가 있으면 archive로 이동
-  if [ -f "$AUDIT_LOG_FILE" ] && [ -s "$AUDIT_LOG_FILE" ]; then
-    local archive_dir="$project_root/.harness/archive"
-    mkdir -p "$archive_dir"
-    local ts
-    ts=$(date +%Y%m%d_%H%M%S)
-    mv "$AUDIT_LOG_FILE" "$archive_dir/audit_s${sprint_num}_${ts}.log"
-  fi
-
-  # 새 로그 헤더
-  cat > "$AUDIT_LOG_FILE" <<HEADER
-# Harness Audit Log
-# Cycle started: $(date -u +%Y-%m-%dT%H:%M:%SZ)
-# Format: TIMESTAMP | AGENT | ACTION | STATUS | TARGET | DETAIL
-#─────────────────────────────────────────────────────────────────────────
-HEADER
-}
-
-# ─────────────────────────────────────────
-# audit_log — 로그 엔트리 추가
-#
-# Args:
-#   $1 = agent     (planner, gen-backend, gen-frontend, eval-func, eval-visual)
-#   $2 = action    (develop, review, handoff, plan, gate)
-#   $3 = status    (start, complete, fail, skip)
-#   $4 = target    (파일 경로, 엔드포인트, 에이전트명 등)
-#   $5 = detail    (설명, 결과 등)
-# ─────────────────────────────────────────
-audit_log() {
-  if [ -z "$AUDIT_LOG_FILE" ] || [ ! -f "$AUDIT_LOG_FILE" ]; then
-    return 0  # audit 미초기화 시 silent pass
-  fi
-
-  local agent="${1:-unknown}"
-  local action="${2:-unknown}"
-  local log_status="${3:-unknown}"
-  local target="${4:-}"
-  local detail="${5:-}"
-  local ts
-  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-
-  # 고정폭 포맷
-  printf "%-20s | %-14s | %-8s | %-8s | %-30s | %s\n" \
-    "$ts" "$agent" "$action" "$log_status" "$target" "$detail" >> "$AUDIT_LOG_FILE"
-}
-
-# ─────────────────────────────────────────
-# audit_handoff — 핸즈오프 기록 (편의 함수)
-# Args: $1=from_agent, $2=to_agent, $3=status(start|complete)
-# ─────────────────────────────────────────
-audit_handoff() {
-  audit_log "$1" "handoff" "$3" "→${2}" ""
-}
-
-# ─────────────────────────────────────────
-# audit_gate — 게이트 체크 기록 (편의 함수)
-# Args: $1=gate_name, $2=status(pass|fail), $3=detail
-# ─────────────────────────────────────────
-audit_gate() {
-  audit_log "system" "gate" "$2" "$1" "$3"
-}
-
-# ─────────────────────────────────────────
-# render_audit — audit.log를 읽기 좋게 출력
-# Args: $1 = project root (optional)
-# ─────────────────────────────────────────
-render_audit() {
-  local project_root="${1:-.}"
-  local log_file="$project_root/.harness/actions/audit.log"
-
-  if [ ! -f "$log_file" ]; then
-    echo "  (audit log not yet created)"
-    return 0
-  fi
-
-  cat "$log_file"
-}

package/scripts/lib/harness-guardrail.sh

@@ -1,148 +0,0 @@
-#!/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)
-      echo "apps/web/"
-      echo "apps/flutter/"
-      echo "lib/"
-      echo ".harness/actions/sprint-contract.md"
-      echo ".harness/actions/feature-list.json"
-      echo ".harness/progress.json"
-      echo "package.json"
-      echo "tsconfig"
-      echo "pubspec"
-      ;;
-    evaluator-code-quality)
-      echo ".harness/actions/evaluation-code-quality.md"
-      echo ".harness/progress.json"
-      ;;
-    evaluator-functional)
-      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
-}

package/scripts/lib/harness-keywait.sh

@@ -1,57 +0,0 @@
-#!/bin/bash
-# harness-keywait.sh — 패널 refresh/quit 키 대기 헬퍼
-#
-# 사용법:
-#   source scripts/lib/harness-keywait.sh
-#   while true; do
-#     render_panel
-#     echo "  [r] refresh  [q] quit"
-#     if wait_or_refresh 3; then
-#       # 타임아웃 → 일반 주기 리프레시
-#       :
-#     else
-#       # 'r' 키 즉시 리프레시 (반환값 != 0)
-#       :
-#     fi
-#   done
-#
-# 키 처리:
-#   'r' / 'R' / Enter → 즉시 복귀 (return 1 — 강제 리프레시 신호)
-#   'q' / 'Q'         → exit 0 (패널 종료)
-#   그 외 / 타임아웃  → return 0 (정상 주기 리프레시)
-#
-# TTY 가 아니면 plain sleep 으로 동작 (Claude Code Bash 도구 등에서도 안전).
-
-wait_or_refresh() {
-  local secs="${1:-3}"
-
-  # Non-TTY fallback
-  if ! [ -t 0 ]; then
-    sleep "$secs"
-    return 0
-  fi
-
-  local key=""
-  # -t: timeout, -n 1: 1글자, -s: 에코 안함
-  # read 는 Enter 에서도 타임아웃 전에 즉시 복귀 (빈 키)
-  if IFS= read -rsn 1 -t "$secs" key 2>/dev/null; then
-    case "$key" in
-      q|Q)
-        # 커서 복원 후 종료
-        tput cnorm 2>/dev/null || true
-        clear
-        exit 0
-        ;;
-      r|R|"")
-        # 강제 리프레시 시그널
-        return 1
-        ;;
-      *)
-        # 기타 키는 무시하고 일반 복귀
-        return 0
-        ;;
-    esac
-  fi
-  # 타임아웃
-  return 0
-}