monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/lib/data-validator.sh

@@ -0,0 +1,360 @@
+#!/bin/bash
+# Plugin Scout - 데이터 검증 유틸리티
+# JSON 파일 검증 및 복구
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+BACKUP_DIR="$DATA_DIR/backups"
+
+# 백업 디렉토리 생성
+mkdir -p "$BACKUP_DIR"
+
+# JSON 파일 유효성 검사
+validate_json() {
+  local file="$1"
+
+  if [ ! -f "$file" ]; then
+    echo "error:not_found"
+    return 1
+  fi
+
+  if ! command -v jq &> /dev/null; then
+    echo "error:jq_not_found"
+    return 1
+  fi
+
+  if jq empty "$file" 2>/dev/null; then
+    echo "valid"
+    return 0
+  else
+    echo "error:invalid_json"
+    return 1
+  fi
+}
+
+# 파일 백업
+backup_file() {
+  local file="$1"
+  local filename=$(basename "$file")
+  local timestamp=$(date +"%Y%m%d_%H%M%S")
+  local backup_path="$BACKUP_DIR/${filename}.${timestamp}.bak"
+
+  if [ -f "$file" ]; then
+    cp "$file" "$backup_path"
+    echo "$backup_path"
+  fi
+}
+
+# history.json 스키마 검증
+validate_history() {
+  local file="$DATA_DIR/history.json"
+
+  if ! validate_json "$file" >/dev/null; then
+    echo "invalid"
+    return 1
+  fi
+
+  # 필수 필드 검증
+  local has_version=$(jq -r 'has("version")' "$file")
+  local has_declined=$(jq -r 'has("declined")' "$file")
+  local has_preferences=$(jq -r 'has("preferences")' "$file")
+
+  if [ "$has_version" = "true" ] && [ "$has_declined" = "true" ] && [ "$has_preferences" = "true" ]; then
+    echo "valid"
+    return 0
+  else
+    echo "missing_fields"
+    return 1
+  fi
+}
+
+# usage.json 스키마 검증
+validate_usage() {
+  local file="$DATA_DIR/usage.json"
+
+  if ! validate_json "$file" >/dev/null; then
+    echo "invalid"
+    return 1
+  fi
+
+  # 필수 필드 검증
+  local has_plugins=$(jq -r 'has("plugins")' "$file")
+  local has_sessions=$(jq -r 'has("sessions")' "$file")
+
+  if [ "$has_plugins" = "true" ] && [ "$has_sessions" = "true" ]; then
+    echo "valid"
+    return 0
+  else
+    echo "missing_fields"
+    return 1
+  fi
+}
+
+# team.json 스키마 검증
+validate_team() {
+  local file="$DATA_DIR/team.json"
+
+  if ! validate_json "$file" >/dev/null; then
+    echo "invalid"
+    return 1
+  fi
+
+  # 필수 필드 검증
+  local has_version=$(jq -r 'has("version")' "$file")
+  local has_members=$(jq -r 'has("members")' "$file")
+  local has_stats=$(jq -r 'has("stats")' "$file")
+
+  if [ "$has_version" = "true" ] && [ "$has_members" = "true" ] && [ "$has_stats" = "true" ]; then
+    echo "valid"
+    return 0
+  else
+    echo "missing_fields"
+    return 1
+  fi
+}
+
+# history.json 초기화
+init_history() {
+  local file="$DATA_DIR/history.json"
+  local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # 기존 파일 백업
+  if [ -f "$file" ]; then
+    backup_file "$file"
+  fi
+
+  cat > "$file" << EOF
+{
+  "version": "2.0.0",
+  "declined": {},
+  "installed": {},
+  "viewed": [],
+  "rejectionPatterns": {
+    "byCategory": {},
+    "byReason": {}
+  },
+  "rejectionReasons": {
+    "not-relevant": "프로젝트에 관련 없음",
+    "wrong-language": "다른 언어용",
+    "already-have": "유사 플러그인 보유",
+    "too-complex": "복잡함",
+    "security": "보안 우려",
+    "other": "기타"
+  },
+  "preferences": {
+    "categories": [],
+    "autoInstall": false,
+    "quietMode": false,
+    "recommendationCooldown": 30,
+    "maxRejectionsBeforeBlock": 3,
+    "maxRecommendationsPerSession": 1,
+    "maxRecommendationsPerDay": 3,
+    "smartTiming": {
+      "onlyAfterCommit": false,
+      "onlyAfterPR": false
+    }
+  },
+  "updatedAt": "$now"
+}
+EOF
+
+  echo "initialized"
+}
+
+# usage.json 초기화
+init_usage() {
+  local file="$DATA_DIR/usage.json"
+  local now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # 기존 파일 백업
+  if [ -f "$file" ]; then
+    backup_file "$file"
+  fi
+
+  cat > "$file" << EOF
+{
+  "plugins": {},
+  "users": {},
+  "sessions": {
+    "total": 0,
+    "thisWeek": 0
+  },
+  "lastUpdated": "$now"
+}
+EOF
+
+  echo "initialized"
+}
+
+# 모든 데이터 파일 검증
+validate_all() {
+  echo "=== Data Validation ==="
+  echo ""
+
+  local all_valid=true
+
+  # history.json
+  echo -n "history.json: "
+  if [ -f "$DATA_DIR/history.json" ]; then
+    local result=$(validate_history)
+    echo "$result"
+    [ "$result" != "valid" ] && all_valid=false
+  else
+    echo "not_found"
+    all_valid=false
+  fi
+
+  # usage.json
+  echo -n "usage.json: "
+  if [ -f "$DATA_DIR/usage.json" ]; then
+    local result=$(validate_usage)
+    echo "$result"
+    [ "$result" != "valid" ] && all_valid=false
+  else
+    echo "not_found"
+    all_valid=false
+  fi
+
+  # team.json
+  echo -n "team.json: "
+  if [ -f "$DATA_DIR/team.json" ]; then
+    local result=$(validate_team)
+    echo "$result"
+    [ "$result" != "valid" ] && all_valid=false
+  else
+    echo "not_found (optional)"
+  fi
+
+  # .session
+  echo -n ".session: "
+  if [ -f "$DATA_DIR/.session" ]; then
+    local result=$(validate_json "$DATA_DIR/.session")
+    echo "$result"
+    [ "$result" != "valid" ] && all_valid=false
+  else
+    echo "not_found (runtime)"
+  fi
+
+  echo ""
+  if [ "$all_valid" = "true" ]; then
+    echo "All data files are valid."
+  else
+    echo "Some data files need attention."
+  fi
+}
+
+# 손상된 파일 복구
+repair() {
+  local file="$1"
+
+  case "$file" in
+    history)
+      echo "Repairing history.json..."
+      init_history
+      ;;
+    usage)
+      echo "Repairing usage.json..."
+      init_usage
+      ;;
+    all)
+      echo "Repairing all data files..."
+      init_history
+      init_usage
+      ;;
+    *)
+      echo "Usage: repair {history|usage|all}"
+      ;;
+  esac
+}
+
+# 백업 목록
+list_backups() {
+  echo "=== Backups ==="
+  if [ -d "$BACKUP_DIR" ] && [ "$(ls -A "$BACKUP_DIR" 2>/dev/null)" ]; then
+    ls -la "$BACKUP_DIR"
+  else
+    echo "No backups found"
+  fi
+}
+
+# 백업에서 복원
+restore_backup() {
+  local backup_file="$1"
+
+  if [ -z "$backup_file" ]; then
+    echo "Usage: restore <backup-file>"
+    list_backups
+    return 1
+  fi
+
+  local full_path="$BACKUP_DIR/$backup_file"
+  if [ ! -f "$full_path" ]; then
+    echo "Backup not found: $backup_file"
+    return 1
+  fi
+
+  # 파일명에서 원본 파일명 추출
+  local original_name=$(echo "$backup_file" | sed 's/\.[0-9]*_[0-9]*\.bak$//')
+  local target_file="$DATA_DIR/$original_name"
+
+  # 현재 파일 백업 후 복원
+  if [ -f "$target_file" ]; then
+    backup_file "$target_file"
+  fi
+
+  cp "$full_path" "$target_file"
+  echo "Restored: $original_name from $backup_file"
+}
+
+# CLI 인터페이스
+case "$1" in
+  validate)
+    validate_all
+    ;;
+  check)
+    validate_json "$2"
+    ;;
+  history)
+    validate_history
+    ;;
+  usage)
+    validate_usage
+    ;;
+  team)
+    validate_team
+    ;;
+  init)
+    case "$2" in
+      history) init_history ;;
+      usage) init_usage ;;
+      *) echo "Usage: init {history|usage}" ;;
+    esac
+    ;;
+  repair)
+    repair "$2"
+    ;;
+  backup)
+    backup_file "$2"
+    ;;
+  backups)
+    list_backups
+    ;;
+  restore)
+    restore_backup "$2"
+    ;;
+  *)
+    echo "Usage: $0 {validate|check|history|usage|team|init|repair|backup|backups|restore}"
+    echo ""
+    echo "Commands:"
+    echo "  validate              - Validate all data files"
+    echo "  check <file>          - Check if JSON file is valid"
+    echo "  history               - Validate history.json schema"
+    echo "  usage                 - Validate usage.json schema"
+    echo "  team                  - Validate team.json schema"
+    echo "  init <type>           - Initialize data file (history|usage)"
+    echo "  repair <type>         - Repair corrupted file (history|usage|all)"
+    echo "  backup <file>         - Create backup of file"
+    echo "  backups               - List all backups"
+    echo "  restore <backup>      - Restore from backup"
+    ;;
+esac

package/monol-plugin-scout-pkg/lib/error-handler.sh

@@ -0,0 +1,296 @@
+#!/bin/bash
+# Plugin Scout - 에러 처리 유틸리티
+# 에러 로깅, 복구, 알림
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+LOG_DIR="$DATA_DIR/logs"
+ERROR_LOG="$LOG_DIR/error.log"
+
+# 로그 디렉토리 생성
+mkdir -p "$LOG_DIR"
+
+# 에러 코드 정의 (bash 3.x 호환)
+get_error_message() {
+  local code="$1"
+  case "$code" in
+    E001) echo "jq not found" ;;
+    E002) echo "Invalid JSON file" ;;
+    E003) echo "File not found" ;;
+    E004) echo "Permission denied" ;;
+    E005) echo "Network error" ;;
+    E006) echo "Data corruption" ;;
+    E007) echo "Unknown error" ;;
+    *) echo "Unknown error" ;;
+  esac
+}
+
+# 에러 로그 기록
+log_error() {
+  local code="$1"
+  local default_msg=$(get_error_message "$code")
+  local message="${2:-$default_msg}"
+  local context="$3"
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # 로그 파일에 기록
+  echo "[$timestamp] [$code] $message ${context:+| Context: $context}" >> "$ERROR_LOG"
+
+  # stderr로도 출력 (디버깅용)
+  if [ "$SCOUT_DEBUG" = "true" ]; then
+    echo "ERROR [$code]: $message" >&2
+  fi
+}
+
+# 에러 처리 및 복구 시도
+handle_error() {
+  local code="$1"
+  local context="$2"
+
+  log_error "$code" "" "$context"
+
+  case "$code" in
+    E001)
+      echo "jq is required. Install with: brew install jq"
+      return 1
+      ;;
+    E002)
+      # Invalid JSON - 복구 시도
+      echo "Attempting to recover invalid JSON..."
+      if [ -f "$PLUGIN_ROOT/lib/data-validator.sh" ]; then
+        bash "$PLUGIN_ROOT/lib/data-validator.sh" repair all
+      fi
+      ;;
+    E003)
+      # File not found - 초기화
+      echo "File not found. Initializing..."
+      if [ -f "$PLUGIN_ROOT/lib/data-validator.sh" ]; then
+        bash "$PLUGIN_ROOT/lib/data-validator.sh" init history
+        bash "$PLUGIN_ROOT/lib/data-validator.sh" init usage
+      fi
+      ;;
+    E004)
+      echo "Permission denied. Check file permissions."
+      return 1
+      ;;
+    E005)
+      echo "Network error. Will retry later."
+      return 1
+      ;;
+    E006)
+      echo "Data corruption detected. Attempting recovery..."
+      if [ -f "$PLUGIN_ROOT/lib/data-validator.sh" ]; then
+        bash "$PLUGIN_ROOT/lib/data-validator.sh" repair all
+      fi
+      ;;
+    *)
+      echo "Unknown error: $code"
+      return 1
+      ;;
+  esac
+}
+
+# 안전한 JSON 읽기
+safe_json_read() {
+  local file="$1"
+  local query="${2:-.}"
+  local default="${3:-null}"
+
+  if [ ! -f "$file" ]; then
+    log_error "E003" "File not found" "$file"
+    echo "$default"
+    return 1
+  fi
+
+  if ! command -v jq &> /dev/null; then
+    log_error "E001" "jq not found"
+    echo "$default"
+    return 1
+  fi
+
+  local result
+  result=$(jq -r "$query" "$file" 2>/dev/null)
+  local exit_code=$?
+
+  if [ $exit_code -ne 0 ] || [ "$result" = "null" ] && [ "$default" != "null" ]; then
+    log_error "E002" "JSON read failed" "$file: $query"
+    echo "$default"
+    return 1
+  fi
+
+  echo "$result"
+}
+
+# 안전한 JSON 쓰기
+safe_json_write() {
+  local file="$1"
+  local query="$2"
+
+  if ! command -v jq &> /dev/null; then
+    log_error "E001" "jq not found"
+    return 1
+  fi
+
+  if [ ! -f "$file" ]; then
+    log_error "E003" "File not found" "$file"
+    return 1
+  fi
+
+  local temp_file="${file}.tmp"
+
+  if ! jq "$query" "$file" > "$temp_file" 2>/dev/null; then
+    log_error "E002" "JSON write failed" "$file: $query"
+    rm -f "$temp_file"
+    return 1
+  fi
+
+  if ! mv "$temp_file" "$file"; then
+    log_error "E004" "Permission denied" "$file"
+    rm -f "$temp_file"
+    return 1
+  fi
+
+  return 0
+}
+
+# 에러 로그 조회
+view_errors() {
+  local lines="${1:-20}"
+
+  if [ ! -f "$ERROR_LOG" ]; then
+    echo "No errors logged yet."
+    return
+  fi
+
+  echo "=== Recent Errors (last $lines) ==="
+  tail -n "$lines" "$ERROR_LOG"
+}
+
+# 에러 로그 정리
+cleanup_errors() {
+  local days="${1:-7}"
+
+  if [ ! -f "$ERROR_LOG" ]; then
+    echo "No error log to clean."
+    return
+  fi
+
+  local cutoff_date=$(date -v-${days}d +"%Y-%m-%d" 2>/dev/null || date -d "$days days ago" +"%Y-%m-%d" 2>/dev/null)
+
+  if [ -n "$cutoff_date" ]; then
+    # 날짜 이후 로그만 유지
+    grep -E "^\[${cutoff_date}|^\[$(date +%Y-)" "$ERROR_LOG" > "$ERROR_LOG.tmp" 2>/dev/null
+    mv "$ERROR_LOG.tmp" "$ERROR_LOG"
+    echo "Cleaned errors older than $days days."
+  else
+    echo "Could not determine cutoff date."
+  fi
+}
+
+# 에러 통계
+error_stats() {
+  if [ ! -f "$ERROR_LOG" ]; then
+    echo "No errors logged yet."
+    return
+  fi
+
+  echo "=== Error Statistics ==="
+  echo ""
+  echo "By Error Code:"
+  grep -oE '\[E[0-9]+\]' "$ERROR_LOG" | sort | uniq -c | sort -rn
+  echo ""
+  echo "By Date:"
+  grep -oE '^\[[0-9]{4}-[0-9]{2}-[0-9]{2}' "$ERROR_LOG" | sort | uniq -c | tail -7
+  echo ""
+  echo "Total Errors: $(wc -l < "$ERROR_LOG" | tr -d ' ')"
+}
+
+# 시스템 상태 확인
+health_check() {
+  echo "=== Health Check ==="
+  echo ""
+
+  # jq 확인
+  echo -n "jq: "
+  if command -v jq &> /dev/null; then
+    echo "OK ($(jq --version))"
+  else
+    echo "NOT FOUND"
+  fi
+
+  # 데이터 디렉토리 확인
+  echo -n "Data directory: "
+  if [ -d "$DATA_DIR" ] && [ -w "$DATA_DIR" ]; then
+    echo "OK (writable)"
+  else
+    echo "ERROR (not writable)"
+  fi
+
+  # JSON 파일 확인
+  echo ""
+  echo "Data Files:"
+  for file in history.json usage.json team.json; do
+    echo -n "  $file: "
+    if [ -f "$DATA_DIR/$file" ]; then
+      if jq empty "$DATA_DIR/$file" 2>/dev/null; then
+        echo "OK"
+      else
+        echo "INVALID JSON"
+      fi
+    else
+      echo "NOT FOUND"
+    fi
+  done
+
+  # 최근 에러 확인
+  echo ""
+  echo -n "Recent errors (24h): "
+  if [ -f "$ERROR_LOG" ]; then
+    local today=$(date +"%Y-%m-%d")
+    local count=$(grep -c "^\[$today" "$ERROR_LOG" 2>/dev/null || echo "0")
+    echo "$count"
+  else
+    echo "0"
+  fi
+}
+
+# CLI 인터페이스
+case "$1" in
+  log)
+    log_error "$2" "$3" "$4"
+    ;;
+  handle)
+    handle_error "$2" "$3"
+    ;;
+  read)
+    safe_json_read "$2" "$3" "$4"
+    ;;
+  write)
+    safe_json_write "$2" "$3"
+    ;;
+  view)
+    view_errors "$2"
+    ;;
+  cleanup)
+    cleanup_errors "$2"
+    ;;
+  stats)
+    error_stats
+    ;;
+  health)
+    health_check
+    ;;
+  *)
+    echo "Usage: $0 {log|handle|read|write|view|cleanup|stats|health}"
+    echo ""
+    echo "Commands:"
+    echo "  log <code> [msg] [ctx]  - Log an error"
+    echo "  handle <code> [ctx]     - Handle error with recovery"
+    echo "  read <file> [query]     - Safe JSON read"
+    echo "  write <file> <query>    - Safe JSON write"
+    echo "  view [lines]            - View recent errors"
+    echo "  cleanup [days]          - Clean old error logs"
+    echo "  stats                   - Show error statistics"
+    echo "  health                  - System health check"
+    ;;
+esac