monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/lib/priority-scorer.sh

@@ -0,0 +1,262 @@
+#!/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"
+TEAM_FILE="$DATA_DIR/team.json"
+
+# 기본 가중치 설정
+WEIGHT_PROJECT_MATCH=40
+WEIGHT_TEAM_POPULARITY=25
+WEIGHT_PERSONAL_HISTORY=20
+WEIGHT_FRESHNESS=15
+
+# 프로젝트 매칭 점수 계산
+calc_project_match_score() {
+  local plugin="$1"
+  local project_types="$2"
+  local frameworks="$3"
+
+  # 간단한 매칭 로직 (실제로는 더 정교하게)
+  local score=50  # 기본 점수
+
+  # 플러그인-프레임워크 매핑
+  case "$plugin" in
+    *react*) echo "$frameworks" | grep -q "react" && score=90 ;;
+    *typescript*|*ts*) echo "$project_types" | grep -q "typescript" && score=90 ;;
+    *eslint*) echo "$frameworks" | grep -q "eslint" && score=85 ;;
+    *jest*|*vitest*|*test*) echo "$frameworks" | grep -qE "(jest|vitest|playwright)" && score=85 ;;
+    *docker*) echo "$project_types" | grep -q "docker" && score=80 ;;
+    *prisma*) echo "$frameworks" | grep -q "prisma" && score=85 ;;
+    *python*|*py*) echo "$project_types" | grep -q "python" && score=80 ;;
+    *) score=50 ;;
+  esac
+
+  echo "$score"
+}
+
+# 팀 인기도 점수 계산
+calc_team_popularity_score() {
+  local plugin="$1"
+
+  if [ ! -f "$TEAM_FILE" ] || ! command -v jq &> /dev/null; then
+    echo "50"  # 기본 점수
+    return
+  fi
+
+  # 팀 내 사용자 수 확인
+  local team_users=$(jq -r --arg p "$plugin" '
+    [.members | to_entries[] | select(.value.pluginsUsed | index($p))] | length
+  ' "$TEAM_FILE" 2>/dev/null || echo "0")
+
+  local total_members=$(jq -r '.stats.totalMembers // 1' "$TEAM_FILE" 2>/dev/null || echo "1")
+
+  # 팀 추천 확인
+  local is_shared=$(jq -r --arg p "$plugin" '
+    if (.sharedRecommendations | map(.plugin) | index($p)) != null then "1" else "0" end
+  ' "$TEAM_FILE" 2>/dev/null || echo "0")
+
+  # 점수 계산
+  local score=50
+  if [ "$total_members" -gt 0 ]; then
+    local usage_rate=$(( team_users * 100 / total_members ))
+    score=$(( 50 + usage_rate / 2 ))
+  fi
+
+  # 팀 추천이면 보너스
+  if [ "$is_shared" = "1" ]; then
+    score=$(( score + 15 ))
+  fi
+
+  # 0-100 범위로 제한
+  [ "$score" -gt 100 ] && score=100
+  [ "$score" -lt 0 ] && score=0
+
+  echo "$score"
+}
+
+# 개인 이력 점수 계산
+calc_personal_history_score() {
+  local plugin="$1"
+
+  if [ ! -f "$HISTORY_FILE" ] || ! command -v jq &> /dev/null; then
+    echo "50"
+    return
+  fi
+
+  # 거절 여부 확인
+  local declined_count=$(jq -r --arg p "$plugin" '.declined[$p].count // 0' "$HISTORY_FILE" 2>/dev/null || echo "0")
+
+  # 이전 사용 여부 확인
+  local was_installed=$(jq -r --arg p "$plugin" '
+    if .installed[$p] then "1" else "0" end
+  ' "$HISTORY_FILE" 2>/dev/null || echo "0")
+
+  # 점수 계산
+  local score=50
+
+  # 거절 이력이 있으면 감점
+  if [ "$declined_count" -gt 0 ]; then
+    score=$(( 50 - declined_count * 20 ))
+  fi
+
+  # 이전에 설치했었다면 가점
+  if [ "$was_installed" = "1" ]; then
+    score=$(( score + 20 ))
+  fi
+
+  # 0-100 범위로 제한
+  [ "$score" -gt 100 ] && score=100
+  [ "$score" -lt 0 ] && score=0
+
+  echo "$score"
+}
+
+# 신선도 점수 계산 (최근 업데이트)
+calc_freshness_score() {
+  local plugin="$1"
+  local last_update="$2"  # ISO 8601 날짜
+
+  if [ -z "$last_update" ]; then
+    echo "50"
+    return
+  fi
+
+  # 현재 시간과 비교 (일 단위)
+  local now=$(date +%s)
+  local update_ts=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$last_update" +%s 2>/dev/null || date -d "$last_update" +%s 2>/dev/null)
+
+  if [ -z "$update_ts" ]; then
+    echo "50"
+    return
+  fi
+
+  local days_old=$(( (now - update_ts) / 86400 ))
+
+  # 최근 업데이트일수록 높은 점수
+  local score
+  if [ "$days_old" -lt 7 ]; then
+    score=95
+  elif [ "$days_old" -lt 30 ]; then
+    score=85
+  elif [ "$days_old" -lt 90 ]; then
+    score=70
+  elif [ "$days_old" -lt 180 ]; then
+    score=55
+  else
+    score=40
+  fi
+
+  echo "$score"
+}
+
+# 종합 점수 계산
+calc_total_score() {
+  local plugin="$1"
+  local project_types="${2:-}"
+  local frameworks="${3:-}"
+  local last_update="${4:-}"
+
+  # 각 요소별 점수 계산
+  local project_score=$(calc_project_match_score "$plugin" "$project_types" "$frameworks")
+  local team_score=$(calc_team_popularity_score "$plugin")
+  local history_score=$(calc_personal_history_score "$plugin")
+  local fresh_score=$(calc_freshness_score "$plugin" "$last_update")
+
+  # 가중 평균 계산
+  local total=$((
+    project_score * WEIGHT_PROJECT_MATCH / 100 +
+    team_score * WEIGHT_TEAM_POPULARITY / 100 +
+    history_score * WEIGHT_PERSONAL_HISTORY / 100 +
+    fresh_score * WEIGHT_FRESHNESS / 100
+  ))
+
+  echo "$total"
+}
+
+# 점수 상세 분석
+score_breakdown() {
+  local plugin="$1"
+  local project_types="${2:-}"
+  local frameworks="${3:-}"
+  local last_update="${4:-}"
+
+  local project_score=$(calc_project_match_score "$plugin" "$project_types" "$frameworks")
+  local team_score=$(calc_team_popularity_score "$plugin")
+  local history_score=$(calc_personal_history_score "$plugin")
+  local fresh_score=$(calc_freshness_score "$plugin" "$last_update")
+  local total=$(calc_total_score "$plugin" "$project_types" "$frameworks" "$last_update")
+
+  echo "=== Score Breakdown: $plugin ==="
+  echo ""
+  printf "%-20s %3d (weight: %d%%)\n" "Project Match:" "$project_score" "$WEIGHT_PROJECT_MATCH"
+  printf "%-20s %3d (weight: %d%%)\n" "Team Popularity:" "$team_score" "$WEIGHT_TEAM_POPULARITY"
+  printf "%-20s %3d (weight: %d%%)\n" "Personal History:" "$history_score" "$WEIGHT_PERSONAL_HISTORY"
+  printf "%-20s %3d (weight: %d%%)\n" "Freshness:" "$fresh_score" "$WEIGHT_FRESHNESS"
+  echo "---"
+  printf "%-20s %3d\n" "TOTAL:" "$total"
+}
+
+# 플러그인 목록 정렬
+sort_by_score() {
+  local plugins_json="$1"
+  local project_types="${2:-}"
+  local frameworks="${3:-}"
+
+  if [ -z "$plugins_json" ] || ! command -v jq &> /dev/null; then
+    echo "$plugins_json"
+    return
+  fi
+
+  # 각 플러그인에 점수 추가 후 정렬
+  echo "$plugins_json" | jq -r '.[]' | while read plugin; do
+    local score=$(calc_total_score "$plugin" "$project_types" "$frameworks")
+    echo "$score $plugin"
+  done | sort -rn | awk '{print $2}' | jq -R -s -c 'split("\n") | map(select(. != ""))'
+}
+
+# CLI 인터페이스
+case "$1" in
+  score)
+    calc_total_score "$2" "$3" "$4" "$5"
+    ;;
+  breakdown)
+    score_breakdown "$2" "$3" "$4" "$5"
+    ;;
+  project)
+    calc_project_match_score "$2" "$3" "$4"
+    ;;
+  team)
+    calc_team_popularity_score "$2"
+    ;;
+  history)
+    calc_personal_history_score "$2"
+    ;;
+  fresh)
+    calc_freshness_score "$2" "$3"
+    ;;
+  sort)
+    sort_by_score "$2" "$3" "$4"
+    ;;
+  *)
+    echo "Usage: $0 {score|breakdown|project|team|history|fresh|sort}"
+    echo ""
+    echo "Commands:"
+    echo "  score <plugin> [types] [frameworks] [update]  - Calculate total score"
+    echo "  breakdown <plugin> [...]                      - Show score breakdown"
+    echo "  project <plugin> <types> <frameworks>         - Project match score"
+    echo "  team <plugin>                                 - Team popularity score"
+    echo "  history <plugin>                              - Personal history score"
+    echo "  fresh <plugin> <last_update>                  - Freshness score"
+    echo "  sort <plugins_json> [types] [frameworks]      - Sort plugins by score"
+    echo ""
+    echo "Score Weights:"
+    echo "  Project Match:    $WEIGHT_PROJECT_MATCH%"
+    echo "  Team Popularity:  $WEIGHT_TEAM_POPULARITY%"
+    echo "  Personal History: $WEIGHT_PERSONAL_HISTORY%"
+    echo "  Freshness:        $WEIGHT_FRESHNESS%"
+    ;;
+esac

package/monol-plugin-scout-pkg/lib/profile-learner.sh

@@ -0,0 +1,339 @@
+#!/bin/bash
+# Plugin Scout - 프로필 학습 시스템
+# 사용자 선호도 및 활동 패턴을 학습하여 개인화된 추천 제공
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+PROFILE_FILE="$DATA_DIR/profile.json"
+
+# 프로필 초기화
+init_profile() {
+  if [ ! -f "$PROFILE_FILE" ]; then
+    mkdir -p "$DATA_DIR"
+    echo '{
+  "version": "1.0.0",
+  "lastUpdated": "'$(date -u +"%Y-%m-%dT%H:%M:%SZ")'",
+  "preferences": {
+    "categories": {},
+    "projectTypes": {},
+    "tags": {}
+  },
+  "activityPatterns": {
+    "hourly": {},
+    "daily": {},
+    "weekly": {}
+  },
+  "installHistory": [],
+  "usageStats": {
+    "totalInstalls": 0,
+    "totalRecommendations": 0,
+    "acceptRate": 0
+  }
+}' > "$PROFILE_FILE"
+  fi
+}
+
+# 카테고리 선호도 업데이트
+update_category_preference() {
+  local category="$1"
+  local action="$2"  # accept, reject, install, uninstall
+  local weight=1
+
+  case "$action" in
+    accept) weight=2 ;;
+    install) weight=5 ;;
+    reject) weight=-1 ;;
+    uninstall) weight=-3 ;;
+  esac
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local current=$(jq -r ".preferences.categories[\"$category\"] // 0" "$PROFILE_FILE")
+    local new_score=$((current + weight))
+
+    # 점수는 -100 ~ 100 범위로 제한
+    if [ "$new_score" -gt 100 ]; then new_score=100; fi
+    if [ "$new_score" -lt -100 ]; then new_score=-100; fi
+
+    jq --arg cat "$category" \
+       --argjson score "$new_score" \
+       --arg ts "$timestamp" \
+       '
+       .lastUpdated = $ts |
+       .preferences.categories[$cat] = $score
+       ' "$PROFILE_FILE" > "$PROFILE_FILE.tmp" && mv "$PROFILE_FILE.tmp" "$PROFILE_FILE"
+
+    echo "Updated category preference: $category = $new_score"
+  fi
+}
+
+# 프로젝트 타입 선호도 업데이트
+update_project_type_preference() {
+  local project_type="$1"
+  local plugin_name="$2"
+  local success="$3"  # true/false
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local weight=1
+    if [ "$success" = "true" ]; then weight=1; else weight=-1; fi
+
+    local current=$(jq -r ".preferences.projectTypes[\"$project_type\"].score // 0" "$PROFILE_FILE")
+    local new_score=$((current + weight))
+
+    jq --arg pt "$project_type" \
+       --arg plugin "$plugin_name" \
+       --argjson score "$new_score" \
+       --arg ts "$timestamp" \
+       '
+       .lastUpdated = $ts |
+       .preferences.projectTypes[$pt].score = $score |
+       .preferences.projectTypes[$pt].plugins = ((.preferences.projectTypes[$pt].plugins // []) + [$plugin] | unique)
+       ' "$PROFILE_FILE" > "$PROFILE_FILE.tmp" && mv "$PROFILE_FILE.tmp" "$PROFILE_FILE"
+
+    echo "Updated project type preference: $project_type"
+  fi
+}
+
+# 활동 패턴 기록
+record_activity() {
+  local action="$1"
+  local hour=$(date +"%H")
+  local day=$(date +"%u")  # 1-7 (월-일)
+  local week=$(date +"%W")
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    jq --arg hour "$hour" \
+       --arg day "$day" \
+       --arg week "$week" \
+       --arg action "$action" \
+       --arg ts "$timestamp" \
+       '
+       .lastUpdated = $ts |
+       .activityPatterns.hourly[$hour] = ((.activityPatterns.hourly[$hour] // 0) + 1) |
+       .activityPatterns.daily[$day] = ((.activityPatterns.daily[$day] // 0) + 1) |
+       .activityPatterns.weekly[$week] = ((.activityPatterns.weekly[$week] // 0) + 1)
+       ' "$PROFILE_FILE" > "$PROFILE_FILE.tmp" && mv "$PROFILE_FILE.tmp" "$PROFILE_FILE"
+  fi
+}
+
+# 설치 이력 기록
+record_install() {
+  local plugin_name="$1"
+  local category="$2"
+  local project_type="$3"
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    jq --arg plugin "$plugin_name" \
+       --arg cat "$category" \
+       --arg pt "$project_type" \
+       --arg ts "$timestamp" \
+       '
+       .lastUpdated = $ts |
+       .installHistory = ([{
+         "plugin": $plugin,
+         "category": $cat,
+         "projectType": $pt,
+         "installedAt": $ts
+       }] + .installHistory) | .[0:100] |
+       .usageStats.totalInstalls = (.usageStats.totalInstalls + 1)
+       ' "$PROFILE_FILE" > "$PROFILE_FILE.tmp" && mv "$PROFILE_FILE.tmp" "$PROFILE_FILE"
+
+    # 카테고리/프로젝트 타입 선호도도 업데이트
+    update_category_preference "$category" "install"
+    update_project_type_preference "$project_type" "$plugin_name" "true"
+    record_activity "install"
+
+    echo "Recorded install: $plugin_name"
+  fi
+}
+
+# 추천 수락률 업데이트
+update_accept_rate() {
+  local accepted="$1"  # true/false
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local total=$(jq -r '.usageStats.totalRecommendations // 0' "$PROFILE_FILE")
+    local current_rate=$(jq -r '.usageStats.acceptRate // 0' "$PROFILE_FILE")
+    local new_total=$((total + 1))
+
+    local add_to_rate=0
+    if [ "$accepted" = "true" ]; then add_to_rate=1; fi
+
+    # 이동 평균 계산
+    local new_rate=$(echo "scale=2; ($current_rate * $total + $add_to_rate) / $new_total" | bc 2>/dev/null || echo "$current_rate")
+
+    jq --arg ts "$timestamp" \
+       --argjson total "$new_total" \
+       --arg rate "$new_rate" \
+       '
+       .lastUpdated = $ts |
+       .usageStats.totalRecommendations = $total |
+       .usageStats.acceptRate = ($rate | tonumber)
+       ' "$PROFILE_FILE" > "$PROFILE_FILE.tmp" && mv "$PROFILE_FILE.tmp" "$PROFILE_FILE"
+  fi
+}
+
+# 선호 카테고리 목록 반환
+get_preferred_categories() {
+  local min_score="${1:-10}"
+
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    jq -r --argjson min "$min_score" '
+      .preferences.categories | to_entries |
+      map(select(.value >= $min)) |
+      sort_by(-.value) |
+      .[].key
+    ' "$PROFILE_FILE"
+  fi
+}
+
+# 가장 활동적인 시간대 반환
+get_peak_hours() {
+  init_profile
+
+  if command -v jq &> /dev/null; then
+    jq -r '
+      .activityPatterns.hourly | to_entries |
+      sort_by(-.value) |
+      .[0:3] |
+      .[].key
+    ' "$PROFILE_FILE"
+  fi
+}
+
+# 프로필 요약 출력
+get_profile_summary() {
+  init_profile
+
+  if [ ! -f "$PROFILE_FILE" ]; then
+    echo "No profile data"
+    return
+  fi
+
+  if ! command -v jq &> /dev/null; then
+    echo "jq required for profile summary"
+    return
+  fi
+
+  echo "=== Profile Summary ==="
+  echo ""
+  echo "Preferred Categories (top 5):"
+  jq -r '.preferences.categories | to_entries | sort_by(-.value) | .[0:5] | .[] | "  \(.key): \(.value)"' "$PROFILE_FILE"
+  echo ""
+  echo "Project Types:"
+  jq -r '.preferences.projectTypes | to_entries | .[0:5] | .[] | "  \(.key): \(.value.score // 0) (\(.value.plugins | length) plugins)"' "$PROFILE_FILE"
+  echo ""
+  echo "Activity Patterns:"
+  echo "  Peak hours: $(get_peak_hours | tr '\n' ', ' | sed 's/,$//')"
+  echo ""
+  echo "Stats:"
+  jq -r '"  Total installs: \(.usageStats.totalInstalls)\n  Accept rate: \(.usageStats.acceptRate | . * 100 | floor)%"' "$PROFILE_FILE"
+}
+
+# 프로필 기반 추천 점수 조정
+get_score_adjustment() {
+  local plugin_name="$1"
+  local category="$2"
+  local project_type="$3"
+
+  init_profile
+
+  if ! command -v jq &> /dev/null; then
+    echo "0"
+    return
+  fi
+
+  local cat_score=$(jq -r ".preferences.categories[\"$category\"] // 0" "$PROFILE_FILE")
+  local pt_score=$(jq -r ".preferences.projectTypes[\"$project_type\"].score // 0" "$PROFILE_FILE")
+
+  # 선호도에 따라 -20 ~ +20 범위로 점수 조정
+  local adjustment=$(echo "scale=0; ($cat_score + $pt_score) / 10" | bc 2>/dev/null || echo "0")
+
+  if [ "$adjustment" -gt 20 ]; then adjustment=20; fi
+  if [ "$adjustment" -lt -20 ]; then adjustment=-20; fi
+
+  echo "$adjustment"
+}
+
+# 프로필 초기화 (리셋)
+reset_profile() {
+  if [ -f "$PROFILE_FILE" ]; then
+    rm "$PROFILE_FILE"
+    init_profile
+    echo "Profile reset successfully"
+  else
+    echo "No profile to reset"
+  fi
+}
+
+# CLI 인터페이스
+case "$1" in
+  init)
+    init_profile
+    echo "Profile initialized"
+    ;;
+  category)
+    update_category_preference "$2" "$3"
+    ;;
+  project-type)
+    update_project_type_preference "$2" "$3" "$4"
+    ;;
+  activity)
+    record_activity "$2"
+    ;;
+  install)
+    record_install "$2" "$3" "$4"
+    ;;
+  accept-rate)
+    update_accept_rate "$2"
+    ;;
+  preferred-categories)
+    get_preferred_categories "$2"
+    ;;
+  peak-hours)
+    get_peak_hours
+    ;;
+  summary)
+    get_profile_summary
+    ;;
+  score-adjustment)
+    get_score_adjustment "$2" "$3" "$4"
+    ;;
+  reset)
+    reset_profile
+    ;;
+  *)
+    echo "Usage: $0 {init|category|project-type|activity|install|accept-rate|preferred-categories|peak-hours|summary|score-adjustment|reset}"
+    echo ""
+    echo "Commands:"
+    echo "  init                                    - Initialize profile"
+    echo "  category <cat> <action>                 - Update category preference (accept|reject|install|uninstall)"
+    echo "  project-type <type> <plugin> <success>  - Update project type preference"
+    echo "  activity <action>                       - Record activity pattern"
+    echo "  install <plugin> <cat> <project_type>   - Record plugin install"
+    echo "  accept-rate <true|false>                - Update recommendation accept rate"
+    echo "  preferred-categories [min_score]        - Get preferred categories"
+    echo "  peak-hours                              - Get peak activity hours"
+    echo "  summary                                 - Show profile summary"
+    echo "  score-adjustment <plugin> <cat> <pt>    - Get score adjustment based on profile"
+    echo "  reset                                   - Reset profile"
+    ;;
+esac