monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/lib/project-analyzer.sh

@@ -0,0 +1,281 @@
+#!/bin/bash
+# Plugin Scout - 프로젝트 분석기
+# 프로젝트 구조와 의존성을 분석하여 추천에 활용
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+PROJECT_ROOT="${PWD}"
+
+# 프로젝트 타입 감지
+detect_project_type() {
+  local types=()
+
+  # Node.js/JavaScript/TypeScript
+  if [ -f "$PROJECT_ROOT/package.json" ]; then
+    types+=("nodejs")
+    if [ -f "$PROJECT_ROOT/tsconfig.json" ]; then
+      types+=("typescript")
+    fi
+  fi
+
+  # Python
+  if [ -f "$PROJECT_ROOT/requirements.txt" ] || [ -f "$PROJECT_ROOT/pyproject.toml" ] || [ -f "$PROJECT_ROOT/setup.py" ]; then
+    types+=("python")
+  fi
+
+  # Rust
+  if [ -f "$PROJECT_ROOT/Cargo.toml" ]; then
+    types+=("rust")
+  fi
+
+  # Go
+  if [ -f "$PROJECT_ROOT/go.mod" ]; then
+    types+=("go")
+  fi
+
+  # Java
+  if [ -f "$PROJECT_ROOT/pom.xml" ] || [ -f "$PROJECT_ROOT/build.gradle" ]; then
+    types+=("java")
+  fi
+
+  # PHP
+  if [ -f "$PROJECT_ROOT/composer.json" ]; then
+    types+=("php")
+  fi
+
+  # Ruby
+  if [ -f "$PROJECT_ROOT/Gemfile" ]; then
+    types+=("ruby")
+  fi
+
+  # Claude Code Plugin
+  if [ -f "$PROJECT_ROOT/plugin.json" ] || [ -d "$PROJECT_ROOT/.claude" ]; then
+    types+=("claude-plugin")
+  fi
+
+  # Docker
+  if [ -f "$PROJECT_ROOT/Dockerfile" ] || [ -f "$PROJECT_ROOT/docker-compose.yml" ]; then
+    types+=("docker")
+  fi
+
+  # 결과 출력 (JSON)
+  printf '%s\n' "${types[@]}" | jq -R -s -c 'split("\n") | map(select(. != ""))'
+}
+
+# 프레임워크 감지
+detect_frameworks() {
+  local frameworks=()
+
+  # Node.js 프레임워크 (package.json에서)
+  if [ -f "$PROJECT_ROOT/package.json" ]; then
+    local deps=$(cat "$PROJECT_ROOT/package.json" | grep -E '"(dependencies|devDependencies)"' -A 100 | head -100)
+
+    # Frontend
+    echo "$deps" | grep -q '"react"' && frameworks+=("react")
+    echo "$deps" | grep -q '"vue"' && frameworks+=("vue")
+    echo "$deps" | grep -q '"@angular/core"' && frameworks+=("angular")
+    echo "$deps" | grep -q '"svelte"' && frameworks+=("svelte")
+    echo "$deps" | grep -q '"next"' && frameworks+=("nextjs")
+    echo "$deps" | grep -q '"nuxt"' && frameworks+=("nuxtjs")
+    echo "$deps" | grep -q '"astro"' && frameworks+=("astro")
+
+    # Backend
+    echo "$deps" | grep -q '"express"' && frameworks+=("express")
+    echo "$deps" | grep -q '"fastify"' && frameworks+=("fastify")
+    echo "$deps" | grep -q '"@nestjs/core"' && frameworks+=("nestjs")
+    echo "$deps" | grep -q '"hono"' && frameworks+=("hono")
+    echo "$deps" | grep -q '"koa"' && frameworks+=("koa")
+
+    # Testing
+    echo "$deps" | grep -q '"jest"' && frameworks+=("jest")
+    echo "$deps" | grep -q '"vitest"' && frameworks+=("vitest")
+    echo "$deps" | grep -q '"mocha"' && frameworks+=("mocha")
+    echo "$deps" | grep -q '"playwright"' && frameworks+=("playwright")
+    echo "$deps" | grep -q '"cypress"' && frameworks+=("cypress")
+
+    # Build tools
+    echo "$deps" | grep -q '"webpack"' && frameworks+=("webpack")
+    echo "$deps" | grep -q '"vite"' && frameworks+=("vite")
+    echo "$deps" | grep -q '"esbuild"' && frameworks+=("esbuild")
+    echo "$deps" | grep -q '"turbo"' && frameworks+=("turborepo")
+
+    # Styling
+    echo "$deps" | grep -q '"tailwindcss"' && frameworks+=("tailwind")
+    echo "$deps" | grep -q '"styled-components"' && frameworks+=("styled-components")
+
+    # State management
+    echo "$deps" | grep -q '"redux"' && frameworks+=("redux")
+    echo "$deps" | grep -q '"zustand"' && frameworks+=("zustand")
+    echo "$deps" | grep -q '"jotai"' && frameworks+=("jotai")
+
+    # Database/ORM
+    echo "$deps" | grep -q '"prisma"' && frameworks+=("prisma")
+    echo "$deps" | grep -q '"drizzle-orm"' && frameworks+=("drizzle")
+    echo "$deps" | grep -q '"mongoose"' && frameworks+=("mongoose")
+    echo "$deps" | grep -q '"typeorm"' && frameworks+=("typeorm")
+
+    # API
+    echo "$deps" | grep -q '"graphql"' && frameworks+=("graphql")
+    echo "$deps" | grep -q '"trpc"' && frameworks+=("trpc")
+  fi
+
+  # Python 프레임워크
+  if [ -f "$PROJECT_ROOT/requirements.txt" ]; then
+    local reqs=$(cat "$PROJECT_ROOT/requirements.txt")
+    echo "$reqs" | grep -qi "django" && frameworks+=("django")
+    echo "$reqs" | grep -qi "flask" && frameworks+=("flask")
+    echo "$reqs" | grep -qi "fastapi" && frameworks+=("fastapi")
+    echo "$reqs" | grep -qi "pytest" && frameworks+=("pytest")
+  fi
+
+  printf '%s\n' "${frameworks[@]}" | jq -R -s -c 'split("\n") | map(select(. != ""))'
+}
+
+# 의존성 추출 (상위 20개)
+get_dependencies() {
+  local deps=()
+
+  if [ -f "$PROJECT_ROOT/package.json" ] && command -v jq &> /dev/null; then
+    # dependencies
+    local prod_deps=$(jq -r '.dependencies // {} | keys[]' "$PROJECT_ROOT/package.json" 2>/dev/null | head -10)
+    # devDependencies
+    local dev_deps=$(jq -r '.devDependencies // {} | keys[]' "$PROJECT_ROOT/package.json" 2>/dev/null | head -10)
+
+    for dep in $prod_deps $dev_deps; do
+      deps+=("$dep")
+    done
+  fi
+
+  printf '%s\n' "${deps[@]}" | jq -R -s -c 'split("\n") | map(select(. != "")) | unique | .[:20]'
+}
+
+# 프로젝트 크기/복잡도 분석
+analyze_complexity() {
+  local file_count=$(find "$PROJECT_ROOT" -type f -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" -o -name "*.py" -o -name "*.rs" -o -name "*.go" 2>/dev/null | wc -l | tr -d ' ')
+  local dir_count=$(find "$PROJECT_ROOT" -type d 2>/dev/null | wc -l | tr -d ' ')
+
+  local size="small"
+  if [ "$file_count" -gt 100 ]; then
+    size="large"
+  elif [ "$file_count" -gt 30 ]; then
+    size="medium"
+  fi
+
+  echo "{\"files\": $file_count, \"directories\": $dir_count, \"size\": \"$size\"}"
+}
+
+# 추천할 플러그인 카테고리 결정
+suggest_categories() {
+  local categories=()
+  local types=$(detect_project_type)
+  local frameworks=$(detect_frameworks)
+
+  # TypeScript 프로젝트면 development 추천
+  echo "$types" | grep -q "typescript" && categories+=("development")
+
+  # 테스트 프레임워크 있으면 testing 추천
+  echo "$frameworks" | grep -qE "(jest|vitest|pytest|playwright|cypress)" && categories+=("testing")
+
+  # Frontend 프레임워크 있으면 frontend 추천
+  echo "$frameworks" | grep -qE "(react|vue|angular|svelte)" && categories+=("frontend")
+
+  # Docker 있으면 devops 추천
+  echo "$types" | grep -q "docker" && categories+=("devops")
+
+  # Database/ORM 사용하면 database 추천
+  echo "$frameworks" | grep -qE "(prisma|drizzle|mongoose|typeorm)" && categories+=("database")
+
+  # GraphQL 사용하면 api 추천
+  echo "$frameworks" | grep -qE "(graphql|trpc)" && categories+=("api")
+
+  # AI/ML 관련이면 ai 추천
+  echo "$frameworks" | grep -qE "(openai|langchain|huggingface)" && categories+=("ai")
+
+  # 기본적으로 productivity 추천
+  categories+=("productivity")
+
+  printf '%s\n' "${categories[@]}" | jq -R -s -c 'split("\n") | map(select(. != "")) | unique'
+}
+
+# 의존성 기반 플러그인 추천
+recommend_by_deps() {
+  local deps=$(get_dependencies)
+
+  # 의존성 → 플러그인 매핑
+  local recommendations=()
+
+  echo "$deps" | jq -r '.[]' 2>/dev/null | while read dep; do
+    case "$dep" in
+      typescript|@types/*) echo "typescript-lsp" ;;
+      react|react-dom) echo "react-devtools" ;;
+      eslint) echo "eslint-fix" ;;
+      prettier) echo "prettier-format" ;;
+      jest|vitest) echo "test-runner" ;;
+      prisma) echo "prisma-helper" ;;
+      docker*) echo "docker-helper" ;;
+      @sentry/*|sentry) echo "sentry" ;;
+      @slack/*|slack*) echo "slack" ;;
+      graphql) echo "graphql-helper" ;;
+      tailwindcss) echo "tailwind-assist" ;;
+    esac
+  done | sort -u | jq -R -s -c 'split("\n") | map(select(. != ""))'
+}
+
+# 전체 프로젝트 분석 (JSON 출력)
+full_analysis() {
+  local types=$(detect_project_type)
+  local frameworks=$(detect_frameworks)
+  local deps=$(get_dependencies)
+  local complexity=$(analyze_complexity)
+  local suggested=$(suggest_categories)
+  local recommended=$(recommend_by_deps)
+
+  cat <<EOF
+{
+  "projectRoot": "$PROJECT_ROOT",
+  "analyzedAt": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "projectTypes": $types,
+  "frameworks": $frameworks,
+  "dependencies": $deps,
+  "complexity": $complexity,
+  "suggestedCategories": $suggested,
+  "recommendedPlugins": $recommended
+}
+EOF
+}
+
+# CLI 인터페이스
+case "$1" in
+  types)
+    detect_project_type
+    ;;
+  frameworks)
+    detect_frameworks
+    ;;
+  deps|dependencies)
+    get_dependencies
+    ;;
+  complexity)
+    analyze_complexity
+    ;;
+  suggest)
+    suggest_categories
+    ;;
+  recommend)
+    recommend_by_deps
+    ;;
+  full|analyze)
+    full_analysis
+    ;;
+  *)
+    echo "Usage: $0 {types|frameworks|deps|complexity|suggest|recommend|full}"
+    echo ""
+    echo "Commands:"
+    echo "  types       - Detect project types (nodejs, typescript, python, etc.)"
+    echo "  frameworks  - Detect frameworks (react, express, jest, etc.)"
+    echo "  deps        - Extract dependencies"
+    echo "  complexity  - Analyze project size/complexity"
+    echo "  suggest     - Suggest plugin categories"
+    echo "  recommend   - Recommend plugins based on dependencies"
+    echo "  full        - Full analysis (JSON)"
+    ;;
+esac

package/monol-plugin-scout-pkg/lib/recommendation-controller.sh

@@ -0,0 +1,290 @@
+#!/bin/bash
+# Plugin Scout - 추천 컨트롤러
+# 추천 빈도, 무음 모드, 스마트 타이밍 관리
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+HISTORY_FILE="$DATA_DIR/history.json"
+SESSION_FILE="$DATA_DIR/.session"
+RECOMMENDATION_LOG="$DATA_DIR/.recommendations"
+
+# 무음 모드 설정
+set_quiet_mode() {
+  local mode="$1"  # on, off, toggle
+
+  if [ ! -f "$HISTORY_FILE" ]; then
+    echo "History file not found"
+    return 1
+  fi
+
+  if ! command -v jq &> /dev/null; then
+    echo "jq required"
+    return 1
+  fi
+
+  local current=$(jq -r '.preferences.quietMode // false' "$HISTORY_FILE")
+
+  case "$mode" in
+    on)
+      jq '.preferences.quietMode = true' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Quiet mode enabled. No recommendations will be shown."
+      ;;
+    off)
+      jq '.preferences.quietMode = false' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Quiet mode disabled. Recommendations will be shown."
+      ;;
+    toggle)
+      if [ "$current" = "true" ]; then
+        jq '.preferences.quietMode = false' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+        echo "Quiet mode disabled."
+      else
+        jq '.preferences.quietMode = true' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+        echo "Quiet mode enabled."
+      fi
+      ;;
+    status)
+      if [ "$current" = "true" ]; then
+        echo "on"
+      else
+        echo "off"
+      fi
+      ;;
+  esac
+}
+
+# 추천 가능 여부 확인 (빈도 제한)
+can_show_recommendation() {
+  local limit_type="${1:-session}"  # session, daily, weekly
+
+  # 무음 모드 확인
+  if [ -f "$HISTORY_FILE" ] && command -v jq &> /dev/null; then
+    local quiet=$(jq -r '.preferences.quietMode // false' "$HISTORY_FILE")
+    if [ "$quiet" = "true" ]; then
+      echo "blocked:quiet_mode"
+      return
+    fi
+  fi
+
+  # 추천 로그 확인
+  if [ ! -f "$RECOMMENDATION_LOG" ]; then
+    echo "true"
+    return
+  fi
+
+  local today=$(date +"%Y-%m-%d")
+  local session_id=""
+  if [ -f "$SESSION_FILE" ]; then
+    session_id=$(jq -r '.sessionId // ""' "$SESSION_FILE" 2>/dev/null)
+  fi
+
+  case "$limit_type" in
+    session)
+      # 세션당 1회 제한
+      local session_count=$(grep -c "session:$session_id" "$RECOMMENDATION_LOG" 2>/dev/null || echo "0")
+      local max_per_session=$(jq -r '.preferences.maxRecommendationsPerSession // 1' "$HISTORY_FILE" 2>/dev/null || echo "1")
+      if [ "$session_count" -ge "$max_per_session" ]; then
+        echo "blocked:session_limit"
+        return
+      fi
+      ;;
+    daily)
+      # 하루 N회 제한
+      local daily_count=$(grep -c "date:$today" "$RECOMMENDATION_LOG" 2>/dev/null || echo "0")
+      local max_per_day=$(jq -r '.preferences.maxRecommendationsPerDay // 3' "$HISTORY_FILE" 2>/dev/null || echo "3")
+      if [ "$daily_count" -ge "$max_per_day" ]; then
+        echo "blocked:daily_limit"
+        return
+      fi
+      ;;
+  esac
+
+  echo "true"
+}
+
+# 추천 기록
+record_recommendation() {
+  local plugin_count="$1"
+  local trigger="$2"  # post-task, manual, auto
+
+  local today=$(date +"%Y-%m-%d")
+  local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  local session_id=""
+
+  if [ -f "$SESSION_FILE" ]; then
+    session_id=$(jq -r '.sessionId // ""' "$SESSION_FILE" 2>/dev/null)
+  fi
+
+  echo "date:$today session:$session_id time:$timestamp count:$plugin_count trigger:$trigger" >> "$RECOMMENDATION_LOG"
+}
+
+# 스마트 타이밍 체크
+check_timing() {
+  local event="$1"  # commit, pr, task-complete
+
+  if [ ! -f "$HISTORY_FILE" ] || ! command -v jq &> /dev/null; then
+    echo "true"
+    return
+  fi
+
+  local smart_timing=$(jq -r '.preferences.smartTiming // {}' "$HISTORY_FILE")
+  local only_after_commit=$(echo "$smart_timing" | jq -r '.onlyAfterCommit // false')
+  local only_after_pr=$(echo "$smart_timing" | jq -r '.onlyAfterPR // false')
+
+  # 특정 이벤트 후에만 추천하도록 설정된 경우
+  if [ "$only_after_commit" = "true" ] && [ "$event" != "commit" ]; then
+    echo "blocked:not_after_commit"
+    return
+  fi
+
+  if [ "$only_after_pr" = "true" ] && [ "$event" != "pr" ]; then
+    echo "blocked:not_after_pr"
+    return
+  fi
+
+  echo "true"
+}
+
+# 미니 모드 출력
+show_mini_notification() {
+  local count="$1"
+
+  if [ "$count" -eq 0 ]; then
+    return
+  fi
+
+  echo "💡 $count개의 플러그인 추천이 있습니다. \`/scout\`로 확인하세요."
+}
+
+# 추천 빈도 설정
+set_frequency() {
+  local key="$1"
+  local value="$2"
+
+  if [ ! -f "$HISTORY_FILE" ] || ! command -v jq &> /dev/null; then
+    echo "Error: history file or jq not found"
+    return 1
+  fi
+
+  case "$key" in
+    session)
+      jq --argjson val "$value" '.preferences.maxRecommendationsPerSession = $val' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Max recommendations per session: $value"
+      ;;
+    daily)
+      jq --argjson val "$value" '.preferences.maxRecommendationsPerDay = $val' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Max recommendations per day: $value"
+      ;;
+    cooldown)
+      jq --argjson val "$value" '.preferences.recommendationCooldown = $val' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Recommendation cooldown: $value minutes"
+      ;;
+  esac
+}
+
+# 스마트 타이밍 설정
+set_smart_timing() {
+  local key="$1"
+  local value="$2"
+
+  if [ ! -f "$HISTORY_FILE" ] || ! command -v jq &> /dev/null; then
+    echo "Error: history file or jq not found"
+    return 1
+  fi
+
+  case "$key" in
+    after-commit)
+      jq --argjson val "$value" '.preferences.smartTiming.onlyAfterCommit = $val' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Only recommend after commit: $value"
+      ;;
+    after-pr)
+      jq --argjson val "$value" '.preferences.smartTiming.onlyAfterPR = $val' "$HISTORY_FILE" > "$HISTORY_FILE.tmp" && mv "$HISTORY_FILE.tmp" "$HISTORY_FILE"
+      echo "Only recommend after PR: $value"
+      ;;
+  esac
+}
+
+# 추천 로그 정리 (7일 이상 된 기록 삭제)
+cleanup_logs() {
+  if [ ! -f "$RECOMMENDATION_LOG" ]; then
+    return
+  fi
+
+  local week_ago=$(date -v-7d +"%Y-%m-%d" 2>/dev/null || date -d "7 days ago" +"%Y-%m-%d" 2>/dev/null)
+
+  if [ -n "$week_ago" ]; then
+    grep -v "date:$week_ago" "$RECOMMENDATION_LOG" | grep -v "date:$(date -v-8d +%Y-%m-%d 2>/dev/null)" > "$RECOMMENDATION_LOG.tmp" 2>/dev/null
+    mv "$RECOMMENDATION_LOG.tmp" "$RECOMMENDATION_LOG" 2>/dev/null
+  fi
+}
+
+# 상태 요약
+status() {
+  echo "=== Recommendation Controller Status ==="
+  echo ""
+
+  if [ -f "$HISTORY_FILE" ] && command -v jq &> /dev/null; then
+    local quiet=$(jq -r '.preferences.quietMode // false' "$HISTORY_FILE")
+    local max_session=$(jq -r '.preferences.maxRecommendationsPerSession // 1' "$HISTORY_FILE")
+    local max_daily=$(jq -r '.preferences.maxRecommendationsPerDay // 3' "$HISTORY_FILE")
+    local cooldown=$(jq -r '.preferences.recommendationCooldown // 30' "$HISTORY_FILE")
+
+    echo "Quiet Mode: $quiet"
+    echo "Max per Session: $max_session"
+    echo "Max per Day: $max_daily"
+    echo "Cooldown: $cooldown min"
+    echo ""
+
+    if [ -f "$RECOMMENDATION_LOG" ]; then
+      local today=$(date +"%Y-%m-%d")
+      local today_count=$(grep -c "date:$today" "$RECOMMENDATION_LOG" 2>/dev/null || echo "0")
+      echo "Today's Recommendations: $today_count"
+    fi
+  else
+    echo "Configuration not available"
+  fi
+}
+
+# CLI 인터페이스
+case "$1" in
+  quiet)
+    set_quiet_mode "${2:-status}"
+    ;;
+  can-recommend)
+    can_show_recommendation "${2:-session}"
+    ;;
+  record)
+    record_recommendation "$2" "$3"
+    ;;
+  timing)
+    check_timing "$2"
+    ;;
+  mini)
+    show_mini_notification "$2"
+    ;;
+  frequency)
+    set_frequency "$2" "$3"
+    ;;
+  smart-timing)
+    set_smart_timing "$2" "$3"
+    ;;
+  cleanup)
+    cleanup_logs
+    ;;
+  status)
+    status
+    ;;
+  *)
+    echo "Usage: $0 {quiet|can-recommend|record|timing|mini|frequency|smart-timing|cleanup|status}"
+    echo ""
+    echo "Commands:"
+    echo "  quiet [on|off|toggle|status]      - Set quiet mode"
+    echo "  can-recommend [session|daily]     - Check if can show recommendation"
+    echo "  record <count> <trigger>          - Record a recommendation"
+    echo "  timing <event>                    - Check smart timing"
+    echo "  mini <count>                      - Show mini notification"
+    echo "  frequency <session|daily> <value> - Set frequency limit"
+    echo "  smart-timing <key> <value>        - Set smart timing"
+    echo "  cleanup                           - Clean old logs"
+    echo "  status                            - Show status"
+    ;;
+esac