monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/lib/logger.sh

@@ -0,0 +1,263 @@
+#!/bin/bash
+# Plugin Scout - 로깅 시스템
+# 구조화된 로그 기록 및 분석
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+LOG_DIR="$DATA_DIR/logs"
+LOG_FILE="$LOG_DIR/scout.log"
+LOG_LEVEL="${SCOUT_LOG_LEVEL:-INFO}"  # DEBUG, INFO, WARN, ERROR
+
+# 로그 디렉토리 생성
+mkdir -p "$LOG_DIR"
+
+# 로그 레벨 숫자 변환
+get_level_num() {
+  case "$1" in
+    DEBUG) echo 0 ;;
+    INFO) echo 1 ;;
+    WARN) echo 2 ;;
+    ERROR) echo 3 ;;
+    *) echo 1 ;;
+  esac
+}
+
+# 현재 로그 레벨 확인
+should_log() {
+  local msg_level="$1"
+  local current_level_num=$(get_level_num "$LOG_LEVEL")
+  local msg_level_num=$(get_level_num "$msg_level")
+
+  [ "$msg_level_num" -ge "$current_level_num" ]
+}
+
+# 로그 기록
+log() {
+  local level="$1"
+  local message="$2"
+  local context="$3"
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # 로그 레벨 필터링
+  if ! should_log "$level"; then
+    return 0
+  fi
+
+  # 로그 포맷: [timestamp] [level] message | context
+  local log_line="[$timestamp] [$level] $message"
+  if [ -n "$context" ]; then
+    log_line="$log_line | $context"
+  fi
+
+  # 파일에 기록
+  echo "$log_line" >> "$LOG_FILE"
+
+  # DEBUG 모드면 stdout에도 출력
+  if [ "$SCOUT_DEBUG" = "true" ]; then
+    echo "$log_line"
+  fi
+}
+
+# 편의 함수들
+log_debug() { log "DEBUG" "$1" "$2"; }
+log_info() { log "INFO" "$1" "$2"; }
+log_warn() { log "WARN" "$1" "$2"; }
+log_error() { log "ERROR" "$1" "$2"; }
+
+# 이벤트 로깅 (구조화된 JSON)
+log_event() {
+  local event_type="$1"
+  local event_data="$2"
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  local user="${USER:-unknown}"
+  local session_id=""
+
+  # 세션 ID 가져오기
+  if [ -f "$DATA_DIR/.session" ] && command -v jq &> /dev/null; then
+    session_id=$(jq -r '.sessionId // ""' "$DATA_DIR/.session" 2>/dev/null)
+  fi
+
+  # JSON 이벤트 로그
+  local event_log="$LOG_DIR/events.jsonl"
+  echo "{\"timestamp\":\"$timestamp\",\"type\":\"$event_type\",\"user\":\"$user\",\"session\":\"$session_id\",\"data\":$event_data}" >> "$event_log"
+}
+
+# 로그 조회
+view_logs() {
+  local lines="${1:-50}"
+  local level="${2:-}"
+
+  if [ ! -f "$LOG_FILE" ]; then
+    echo "No logs found"
+    return
+  fi
+
+  if [ -n "$level" ]; then
+    grep "\[$level\]" "$LOG_FILE" | tail -n "$lines"
+  else
+    tail -n "$lines" "$LOG_FILE"
+  fi
+}
+
+# 로그 검색
+search_logs() {
+  local pattern="$1"
+  local lines="${2:-20}"
+
+  if [ ! -f "$LOG_FILE" ]; then
+    echo "No logs found"
+    return
+  fi
+
+  grep -i "$pattern" "$LOG_FILE" | tail -n "$lines"
+}
+
+# 이벤트 조회
+view_events() {
+  local count="${1:-20}"
+  local event_type="$2"
+  local event_log="$LOG_DIR/events.jsonl"
+
+  if [ ! -f "$event_log" ]; then
+    echo "No events found"
+    return
+  fi
+
+  if [ -n "$event_type" ]; then
+    grep "\"type\":\"$event_type\"" "$event_log" | tail -n "$count" | jq -r '"\(.timestamp) [\(.type)] \(.data)"'
+  else
+    tail -n "$count" "$event_log" | jq -r '"\(.timestamp) [\(.type)] \(.data)"'
+  fi
+}
+
+# 로그 통계
+log_stats() {
+  echo "=== Log Statistics ==="
+  echo ""
+
+  if [ -f "$LOG_FILE" ]; then
+    echo "Log File: $LOG_FILE"
+    echo "Log Level: $LOG_LEVEL"
+    echo ""
+    echo "By Level:"
+    for level in DEBUG INFO WARN ERROR; do
+      local count=$(grep -c "\[$level\]" "$LOG_FILE" 2>/dev/null || echo "0")
+      echo "  $level: $count"
+    done
+    echo ""
+    echo "Total Lines: $(wc -l < "$LOG_FILE" | tr -d ' ')"
+    echo "File Size: $(du -h "$LOG_FILE" | cut -f1)"
+  else
+    echo "No log file found"
+  fi
+
+  echo ""
+  local event_log="$LOG_DIR/events.jsonl"
+  if [ -f "$event_log" ]; then
+    echo "Events:"
+    echo "  Total: $(wc -l < "$event_log" | tr -d ' ')"
+    if command -v jq &> /dev/null; then
+      echo "  By Type:"
+      jq -r '.type' "$event_log" 2>/dev/null | sort | uniq -c | sort -rn | head -5 | while read count type; do
+        echo "    $type: $count"
+      done
+    fi
+  fi
+}
+
+# 로그 정리 (오래된 로그 삭제)
+cleanup_logs() {
+  local days="${1:-30}"
+
+  echo "Cleaning logs older than $days days..."
+
+  # 메인 로그 로테이션
+  if [ -f "$LOG_FILE" ]; then
+    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
+      # 백업 후 정리
+      cp "$LOG_FILE" "$LOG_FILE.bak"
+      grep -E "^\[${cutoff_date}|^\[$(date +%Y-)" "$LOG_FILE.bak" > "$LOG_FILE" 2>/dev/null || true
+      rm -f "$LOG_FILE.bak"
+      echo "Main log cleaned"
+    fi
+  fi
+
+  # 이벤트 로그 정리
+  local event_log="$LOG_DIR/events.jsonl"
+  if [ -f "$event_log" ] && command -v jq &> /dev/null; then
+    local cutoff_ts=$(date -v-${days}d -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -d "$days days ago" -u +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null)
+    if [ -n "$cutoff_ts" ]; then
+      cp "$event_log" "$event_log.bak"
+      jq -c --arg ts "$cutoff_ts" 'select(.timestamp >= $ts)' "$event_log.bak" > "$event_log" 2>/dev/null || true
+      rm -f "$event_log.bak"
+      echo "Event log cleaned"
+    fi
+  fi
+
+  echo "Done"
+}
+
+# 로그 파일 초기화
+clear_logs() {
+  rm -f "$LOG_FILE"
+  rm -f "$LOG_DIR/events.jsonl"
+  echo "Logs cleared"
+}
+
+# CLI 인터페이스
+case "$1" in
+  debug)
+    log_debug "$2" "$3"
+    ;;
+  info)
+    log_info "$2" "$3"
+    ;;
+  warn)
+    log_warn "$2" "$3"
+    ;;
+  error)
+    log_error "$2" "$3"
+    ;;
+  event)
+    log_event "$2" "$3"
+    ;;
+  view)
+    view_logs "$2" "$3"
+    ;;
+  search)
+    search_logs "$2" "$3"
+    ;;
+  events)
+    view_events "$2" "$3"
+    ;;
+  stats)
+    log_stats
+    ;;
+  cleanup)
+    cleanup_logs "$2"
+    ;;
+  clear)
+    clear_logs
+    ;;
+  *)
+    echo "Usage: $0 {debug|info|warn|error|event|view|search|events|stats|cleanup|clear}"
+    echo ""
+    echo "Commands:"
+    echo "  debug <msg> [ctx]      - Log debug message"
+    echo "  info <msg> [ctx]       - Log info message"
+    echo "  warn <msg> [ctx]       - Log warning message"
+    echo "  error <msg> [ctx]      - Log error message"
+    echo "  event <type> <json>    - Log structured event"
+    echo "  view [lines] [level]   - View recent logs"
+    echo "  search <pattern>       - Search logs"
+    echo "  events [count] [type]  - View events"
+    echo "  stats                  - Show log statistics"
+    echo "  cleanup [days]         - Clean old logs"
+    echo "  clear                  - Clear all logs"
+    echo ""
+    echo "Environment:"
+    echo "  SCOUT_LOG_LEVEL        - Set log level (DEBUG, INFO, WARN, ERROR)"
+    echo "  SCOUT_DEBUG            - Enable debug output to stdout"
+    ;;
+esac

package/monol-plugin-scout-pkg/lib/plugin-manager.sh

@@ -0,0 +1,239 @@
+#!/bin/bash
+# Plugin Scout - 플러그인 매니저
+# 플러그인 설치/제거/업데이트 자동화
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+HISTORY_FILE="$DATA_DIR/history.json"
+USAGE_FILE="$DATA_DIR/usage.json"
+
+CLAUDE_SETTINGS="$HOME/.claude/settings.json"
+CLAUDE_PLUGINS_DIR="$HOME/.claude/plugins"
+
+# 플러그인 설치
+install_plugin() {
+  local plugin_spec="$1"  # format: plugin-name@marketplace or plugin-name
+  local source="${2:-recommendation}"
+
+  # 플러그인명과 마켓플레이스 분리
+  local plugin_name="${plugin_spec%@*}"
+  local marketplace="${plugin_spec#*@}"
+
+  if [ "$marketplace" = "$plugin_spec" ]; then
+    marketplace=""
+  fi
+
+  echo "Installing plugin: $plugin_name"
+
+  # settings.json 백업
+  if [ -f "$CLAUDE_SETTINGS" ]; then
+    cp "$CLAUDE_SETTINGS" "$CLAUDE_SETTINGS.bak"
+  fi
+
+  # enabledPlugins에 추가
+  if command -v jq &> /dev/null && [ -f "$CLAUDE_SETTINGS" ]; then
+    local plugin_key="$plugin_name"
+    if [ -n "$marketplace" ]; then
+      plugin_key="${plugin_name}@${marketplace}"
+    fi
+
+    jq --arg key "$plugin_key" '.enabledPlugins[$key] = true' "$CLAUDE_SETTINGS" > "$CLAUDE_SETTINGS.tmp" && mv "$CLAUDE_SETTINGS.tmp" "$CLAUDE_SETTINGS"
+
+    # history.json에 설치 기록
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local date_only=$(date +"%Y-%m-%d")
+
+    if [ -f "$HISTORY_FILE" ]; then
+      jq --arg plugin "$plugin_name" \
+         --arg date "$date_only" \
+         --arg source "$source" \
+         --arg ts "$timestamp" \
+         '
+         .lastUpdated = $ts |
+         .installed[$plugin] = {
+           date: $date,
+           source: $source,
+           installedAt: $ts
+         }
+         ' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+    fi
+
+    # usage.json에 추가
+    if [ -f "$USAGE_FILE" ]; then
+      jq --arg plugin "$plugin_name" \
+         --arg date "$date_only" \
+         --arg ts "$timestamp" \
+         '
+         .lastUpdated = $ts |
+         .plugins[$plugin] = (.plugins[$plugin] // {
+           installed: $date,
+           usageCount: 0,
+           lastUsed: null
+         })
+         ' "$USAGE_FILE" > "$USAGE_FILE.tmp" && mv "$USAGE_FILE.tmp" "$USAGE_FILE"
+    fi
+
+    echo "Installed: $plugin_key"
+    echo "Restart Claude Code to activate the plugin."
+    return 0
+  else
+    echo "Error: jq required or settings.json not found"
+    return 1
+  fi
+}
+
+# 플러그인 제거
+uninstall_plugin() {
+  local plugin_name="$1"
+
+  echo "Uninstalling plugin: $plugin_name"
+
+  if command -v jq &> /dev/null && [ -f "$CLAUDE_SETTINGS" ]; then
+    # settings.json 백업
+    cp "$CLAUDE_SETTINGS" "$CLAUDE_SETTINGS.bak"
+
+    # enabledPlugins에서 제거 (정확한 키 또는 @가 포함된 키)
+    jq --arg plugin "$plugin_name" '
+      .enabledPlugins |= with_entries(
+        select(
+          .key != $plugin and
+          (.key | startswith($plugin + "@") | not)
+        )
+      )
+    ' "$CLAUDE_SETTINGS" > "$CLAUDE_SETTINGS.tmp" && mv "$CLAUDE_SETTINGS.tmp" "$CLAUDE_SETTINGS"
+
+    # history.json에서 installed 제거
+    if [ -f "$HISTORY_FILE" ]; then
+      local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+      jq --arg plugin "$plugin_name" --arg ts "$timestamp" '
+        .lastUpdated = $ts |
+        del(.installed[$plugin])
+      ' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+    fi
+
+    echo "Uninstalled: $plugin_name"
+    echo "Restart Claude Code to complete removal."
+    return 0
+  else
+    echo "Error: jq required or settings.json not found"
+    return 1
+  fi
+}
+
+# 설치된 플러그인 목록
+list_installed() {
+  if command -v jq &> /dev/null && [ -f "$CLAUDE_SETTINGS" ]; then
+    echo "Installed Plugins:"
+    jq -r '.enabledPlugins | to_entries | .[] | select(.value == true) | "  - \(.key)"' "$CLAUDE_SETTINGS"
+  else
+    echo "Error: jq required or settings.json not found"
+  fi
+}
+
+# 플러그인 상태 확인
+check_status() {
+  local plugin_name="$1"
+
+  if command -v jq &> /dev/null && [ -f "$CLAUDE_SETTINGS" ]; then
+    local enabled=$(jq -r --arg plugin "$plugin_name" '
+      .enabledPlugins | to_entries | .[] |
+      select(.key == $plugin or (.key | startswith($plugin + "@"))) |
+      .value
+    ' "$CLAUDE_SETTINGS")
+
+    if [ "$enabled" = "true" ]; then
+      echo "enabled"
+    else
+      echo "disabled"
+    fi
+  else
+    echo "unknown"
+  fi
+}
+
+# 플러그인 활성화/비활성화
+toggle_plugin() {
+  local plugin_name="$1"
+  local action="$2"  # enable or disable
+
+  if command -v jq &> /dev/null && [ -f "$CLAUDE_SETTINGS" ]; then
+    local value="true"
+    [ "$action" = "disable" ] && value="false"
+
+    jq --arg plugin "$plugin_name" --argjson val "$value" '
+      .enabledPlugins |= with_entries(
+        if .key == $plugin or (.key | startswith($plugin + "@"))
+        then .value = $val
+        else .
+        end
+      )
+    ' "$CLAUDE_SETTINGS" > "$CLAUDE_SETTINGS.tmp" && mv "$CLAUDE_SETTINGS.tmp" "$CLAUDE_SETTINGS"
+
+    echo "Plugin $plugin_name: $action"
+  else
+    echo "Error: jq required or settings.json not found"
+  fi
+}
+
+# 설치 명령 생성 (dry-run)
+generate_install_command() {
+  local plugin_name="$1"
+  local marketplace="$2"
+
+  if [ -n "$marketplace" ]; then
+    echo "/plugin install ${plugin_name}@${marketplace}"
+  else
+    echo "/plugin install ${plugin_name}"
+  fi
+}
+
+# 복원 (백업에서)
+restore_backup() {
+  if [ -f "$CLAUDE_SETTINGS.bak" ]; then
+    cp "$CLAUDE_SETTINGS.bak" "$CLAUDE_SETTINGS"
+    echo "Restored from backup"
+  else
+    echo "No backup found"
+  fi
+}
+
+# CLI 인터페이스
+case "$1" in
+  install)
+    install_plugin "$2" "$3"
+    ;;
+  uninstall|remove)
+    uninstall_plugin "$2"
+    ;;
+  list)
+    list_installed
+    ;;
+  status)
+    check_status "$2"
+    ;;
+  enable)
+    toggle_plugin "$2" "enable"
+    ;;
+  disable)
+    toggle_plugin "$2" "disable"
+    ;;
+  command)
+    generate_install_command "$2" "$3"
+    ;;
+  restore)
+    restore_backup
+    ;;
+  *)
+    echo "Usage: $0 {install|uninstall|list|status|enable|disable|command|restore}"
+    echo ""
+    echo "Commands:"
+    echo "  install <plugin[@marketplace]> [source]  - Install a plugin"
+    echo "  uninstall <plugin>                        - Uninstall a plugin"
+    echo "  list                                      - List installed plugins"
+    echo "  status <plugin>                           - Check plugin status"
+    echo "  enable <plugin>                           - Enable a plugin"
+    echo "  disable <plugin>                          - Disable a plugin"
+    echo "  command <plugin> [marketplace]            - Generate install command"
+    echo "  restore                                   - Restore from backup"
+    ;;
+esac