monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/hooks/generate-insights.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+# Plugin Scout - 인사이트 생성 스크립트
+# 세션 시작 시 또는 콘솔 실행 시 호출
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+USAGE_FILE="$DATA_DIR/usage.json"
+ANALYTICS_FILE="$DATA_DIR/analytics.json"
+
+# jq가 없으면 종료
+if ! command -v jq &> /dev/null; then
+  exit 0
+fi
+
+# 파일 존재 확인
+if [ ! -f "$USAGE_FILE" ] || [ ! -f "$ANALYTICS_FILE" ]; then
+  exit 0
+fi
+
+NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+TODAY=$(date +"%Y-%m-%d")
+THIRTY_DAYS_AGO=$(date -v-30d +"%Y-%m-%d" 2>/dev/null || date -d "30 days ago" +"%Y-%m-%d" 2>/dev/null)
+
+# 인사이트 배열 초기화
+INSIGHTS="[]"
+
+# 1. 미사용 플러그인 체크 (30일 이상)
+UNUSED_PLUGINS=$(jq -r --arg threshold "$THIRTY_DAYS_AGO" '
+  .plugins | to_entries |
+  map(select(.value.lastUsed < $threshold or .value.lastUsed == null)) |
+  .[].key
+' "$USAGE_FILE" 2>/dev/null)
+
+for plugin in $UNUSED_PLUGINS; do
+  if [ -n "$plugin" ]; then
+    DAYS_AGO=$(jq -r --arg p "$plugin" '.plugins[$p].lastUsed // "never"' "$USAGE_FILE")
+    INSIGHT=$(jq -n --arg plugin "$plugin" --arg days "$DAYS_AGO" --arg now "$NOW" '{
+      "type": "cleanup",
+      "severity": "warning",
+      "message": "\($plugin)이 오래 미사용 상태입니다 (마지막: \($days))",
+      "action": "/scout cleanup",
+      "generated": $now
+    }')
+    INSIGHTS=$(echo "$INSIGHTS" | jq --argjson insight "$INSIGHT" '. + [$insight]')
+  fi
+done
+
+# 2. 가장 많이 사용된 플러그인 분석
+TOP_PLUGIN=$(jq -r '.plugins | to_entries | sort_by(.value.usageCount) | reverse | .[0].key // ""' "$USAGE_FILE" 2>/dev/null)
+if [ -n "$TOP_PLUGIN" ]; then
+  TOP_COUNT=$(jq -r --arg p "$TOP_PLUGIN" '.plugins[$p].usageCount // 0' "$USAGE_FILE")
+  INSIGHT=$(jq -n --arg plugin "$TOP_PLUGIN" --arg count "$TOP_COUNT" --arg now "$NOW" '{
+    "type": "trend-up",
+    "severity": "info",
+    "message": "\($plugin)이 가장 활발히 사용됩니다 (\($count)회)",
+    "action": "",
+    "generated": $now
+  }')
+  INSIGHTS=$(echo "$INSIGHTS" | jq --argjson insight "$INSIGHT" '. + [$insight]')
+fi
+
+# 3. 사용량 없는 플러그인 체크
+ZERO_USAGE=$(jq -r '.plugins | to_entries | map(select(.value.usageCount == 0)) | .[].key' "$USAGE_FILE" 2>/dev/null)
+for plugin in $ZERO_USAGE; do
+  if [ -n "$plugin" ]; then
+    INSIGHT=$(jq -n --arg plugin "$plugin" --arg now "$NOW" '{
+      "type": "cleanup",
+      "severity": "warning",
+      "message": "\($plugin)이 설치 후 한 번도 사용되지 않았습니다",
+      "action": "/scout cleanup",
+      "generated": $now
+    }')
+    INSIGHTS=$(echo "$INSIGHTS" | jq --argjson insight "$INSIGHT" '. + [$insight]')
+  fi
+done
+
+# 4. 전체 통계 업데이트
+TOTAL_PLUGINS=$(jq '.plugins | length' "$USAGE_FILE" 2>/dev/null || echo 0)
+TOTAL_USAGE=$(jq '[.plugins[].usageCount] | add // 0' "$USAGE_FILE" 2>/dev/null || echo 0)
+ACTIVE_PLUGINS=$(jq --arg threshold "$THIRTY_DAYS_AGO" '
+  [.plugins | to_entries[] | select(.value.lastUsed >= $threshold)] | length
+' "$USAGE_FILE" 2>/dev/null || echo 0)
+DORMANT_PLUGINS=$((TOTAL_PLUGINS - ACTIVE_PLUGINS))
+
+# analytics.json 업데이트
+TEMP_FILE=$(mktemp)
+jq --arg now "$NOW" \
+   --argjson total "$TOTAL_PLUGINS" \
+   --argjson active "$ACTIVE_PLUGINS" \
+   --argjson dormant "$DORMANT_PLUGINS" \
+   --argjson usage "$TOTAL_USAGE" \
+   --argjson insights "$INSIGHTS" '
+  .lastUpdated = $now |
+  .summary.totalPlugins = $total |
+  .summary.activePlugins = $active |
+  .summary.dormantPlugins = $dormant |
+  .summary.totalUsageCount = $usage |
+  .insights = $insights
+' "$ANALYTICS_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$ANALYTICS_FILE"
+
+# 결과 출력 (디버그용, 필요시 주석 처리)
+# echo "Insights generated: $(echo "$INSIGHTS" | jq length)"

package/monol-plugin-scout-pkg/hooks/hooks.json

@@ -1,3 +1,38 @@
 {
-  "hooks": {}
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat ${CLAUDE_PLUGIN_ROOT}/hooks/on-stop.md",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/on-session-start.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/on-session-end.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
 }

package/monol-plugin-scout-pkg/hooks/on-session-end.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+# Plugin Scout - 세션 종료 시 사용 이력 기록
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+USAGE_FILE="$DATA_DIR/usage.json"
+ANALYTICS_FILE="$DATA_DIR/analytics.json"
+SESSION_FILE="$DATA_DIR/.session"
+
+# usage.json이 없으면 초기화 (users 섹션 포함)
+if [ ! -f "$USAGE_FILE" ]; then
+  cat > "$USAGE_FILE" << 'EOF'
+{
+  "lastUpdated": "",
+  "config": {
+    "unusedThresholdDays": 30,
+    "lowUsageThreshold": 3
+  },
+  "plugins": {},
+  "users": {},
+  "sessions": {
+    "total": 0,
+    "thisWeek": 0
+  }
+}
+EOF
+fi
+
+# analytics.json이 없으면 초기화
+if [ ! -f "$ANALYTICS_FILE" ]; then
+  cat > "$ANALYTICS_FILE" << 'EOF'
+{
+  "version": "1.0.0",
+  "lastUpdated": "",
+  "summary": {
+    "totalPlugins": 0,
+    "activePlugins": 0,
+    "totalUsageCount": 0
+  },
+  "trends": {
+    "weekly": [],
+    "monthly": []
+  },
+  "pluginStats": {},
+  "userStats": {},
+  "insights": []
+}
+EOF
+fi
+
+# 세션 파일에서 데이터 읽기
+if [ -f "$SESSION_FILE" ] && command -v jq &> /dev/null; then
+  TODAY=$(date +"%Y-%m-%d")
+  NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # 세션에서 사용자 및 스킬 추출
+  SESSION_USER=$(jq -r '.user // "unknown"' "$SESSION_FILE" 2>/dev/null)
+  SKILLS=$(jq -r '.skills_used[]' "$SESSION_FILE" 2>/dev/null)
+
+  # 세션 카운트 증가
+  TEMP_FILE=$(mktemp)
+  jq --arg now "$NOW" '
+    .lastUpdated = $now |
+    .sessions.total += 1
+  ' "$USAGE_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$USAGE_FILE"
+
+  # 사용자별 세션 카운트
+  if [ -n "$SESSION_USER" ] && [ "$SESSION_USER" != "unknown" ]; then
+    TEMP_FILE=$(mktemp)
+    jq --arg user "$SESSION_USER" --arg today "$TODAY" --arg now "$NOW" '
+      .lastUpdated = $now |
+      if .users[$user] then
+        .users[$user].sessions += 1 |
+        .users[$user].lastActive = $today
+      else
+        .users[$user] = {
+          "plugins": {},
+          "sessions": 1,
+          "lastActive": $today,
+          "firstSeen": $today
+        }
+      end
+    ' "$USAGE_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$USAGE_FILE"
+  fi
+
+  # 스킬별 사용량 업데이트
+  if [ -n "$SKILLS" ]; then
+    for skill in $SKILLS; do
+      if [ -n "$skill" ]; then
+        # 플러그인 전체 사용량 업데이트
+        TEMP_FILE=$(mktemp)
+        jq --arg skill "$skill" --arg today "$TODAY" --arg now "$NOW" '
+          .lastUpdated = $now |
+          if .plugins[$skill] then
+            .plugins[$skill].usageCount += 1 |
+            .plugins[$skill].lastUsed = $today
+          else
+            .plugins[$skill] = {
+              "installed": $today,
+              "usageCount": 1,
+              "lastUsed": $today
+            }
+          end
+        ' "$USAGE_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$USAGE_FILE"
+
+        # 사용자별 플러그인 사용량 업데이트
+        if [ -n "$SESSION_USER" ] && [ "$SESSION_USER" != "unknown" ]; then
+          TEMP_FILE=$(mktemp)
+          jq --arg user "$SESSION_USER" --arg skill "$skill" --arg today "$TODAY" '
+            if .users[$user].plugins[$skill] then
+              .users[$user].plugins[$skill].usageCount += 1 |
+              .users[$user].plugins[$skill].lastUsed = $today
+            else
+              .users[$user].plugins[$skill] = {
+                "usageCount": 1,
+                "lastUsed": $today
+              }
+            end
+          ' "$USAGE_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$USAGE_FILE"
+        fi
+
+        # analytics.json 총 사용량 업데이트
+        TEMP_FILE=$(mktemp)
+        jq --arg now "$NOW" '
+          .lastUpdated = $now |
+          .summary.totalUsageCount += 1
+        ' "$ANALYTICS_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$ANALYTICS_FILE"
+      fi
+    done
+  fi
+
+  # 세션 파일 정리
+  rm -f "$SESSION_FILE"
+fi
+
+# 조용히 종료 (출력 없음)

package/monol-plugin-scout-pkg/hooks/on-session-start.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Plugin Scout - 세션 시작 시 초기화
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+SESSION_FILE="$DATA_DIR/.session"
+
+# 데이터 디렉토리 확인
+mkdir -p "$DATA_DIR"
+
+# 사용자 정보 캡처
+CURRENT_USER="${USER:-unknown}"
+GIT_USER=$(git config user.name 2>/dev/null || echo "")
+if [ -n "$GIT_USER" ]; then
+  CURRENT_USER="$GIT_USER"
+fi
+
+# 세션 정보 초기화 (사용자 정보 포함)
+cat > "$SESSION_FILE" << EOF
+{
+  "started": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "user": "$CURRENT_USER",
+  "recommended": false,
+  "skills_used": []
+}
+EOF
+
+# 팀에 사용자 등록 (조용히)
+if [ -f "$PLUGIN_ROOT/lib/team-manager.sh" ]; then
+  bash "$PLUGIN_ROOT/lib/team-manager.sh" register "$CURRENT_USER" >/dev/null 2>&1
+fi
+
+# Trusted auto-install (silent, background)
+if [ -f "$PLUGIN_ROOT/lib/trusted-installer.sh" ]; then
+  bash "$PLUGIN_ROOT/lib/trusted-installer.sh" run >/dev/null 2>&1 &
+fi
+
+# Skill scout auto-install (silent, background)
+if [ -f "$PLUGIN_ROOT/lib/skill-scout.sh" ]; then
+  bash "$PLUGIN_ROOT/lib/skill-scout.sh" auto >/dev/null 2>&1 &
+fi
+
+# 조용히 시작 (출력 없음)

package/monol-plugin-scout-pkg/hooks/on-stop.md

@@ -0,0 +1,79 @@
+# Plugin Scout - 작업 완료 후 추천 체크 (v2.1)
+
+작업이 완료되었습니다. 아래 절차에 따라 플러그인 추천 여부를 결정하세요.
+
+## 1단계: 추천 제한 확인 (필수)
+
+먼저 recommendation-controller를 통해 추천 가능 여부를 확인합니다:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh can-recommend session
+```
+
+결과 해석:
+- `true` → 추천 가능, 2단계로 진행
+- `blocked:quiet_mode` → 무음 모드 활성화됨, 추천 중단
+- `blocked:session_limit` → 세션 추천 한도 도달, 추천 중단
+- `blocked:daily_limit` → 일일 추천 한도 도달, 추천 중단
+
+**중요**: `blocked:`로 시작하면 즉시 중단하고 아무것도 출력하지 마세요.
+
+## 2단계: 스마트 타이밍 확인
+
+이벤트 기반 추천이 설정된 경우:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh timing task-complete
+```
+
+결과 해석:
+- `true` → 타이밍 조건 충족, 3단계로 진행
+- `blocked:not_after_commit` → 커밋 후에만 추천 설정됨, 추천 중단
+- `blocked:not_after_pr` → PR 후에만 추천 설정됨, 추천 중단
+
+## 3단계: 추천 조건 검증
+
+다음 조건이 모두 충족되어야 추천:
+
+1. **의미 있는 작업 완료** - 단순 질문/답변이 아닌 코드 작성, 파일 수정 등
+2. **프로젝트 컨텍스트 존재** - package.json, pyproject.toml 등 감지됨
+3. **플러그인 관련 작업 중이 아님** - `/scout`, 플러그인 설치 등 진행 중이 아님
+
+## 4단계: 추천 실행
+
+조건 충족 시 간단히 제안:
+
+```
+💡 이 프로젝트에 [plugin-name] 플러그인이 도움될 수 있어요.
+   [한 줄 설명]
+   관심있으시면 `/scout`로 더 알아보세요.
+```
+
+## 5단계: 추천 기록
+
+추천 후 반드시 기록:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh record 1 post-task
+```
+
+## 설정 변경 안내
+
+사용자가 추천 빈도에 불만을 표시하면:
+
+- **완전 중단**: `/scout quiet on`
+- **빈도 조절**: `/scout frequency session 2` 또는 `/scout frequency daily 5`
+- **타이밍 변경**: `/scout timing after-commit on`
+
+## 현재 상태 확인
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh status
+```
+
+## 추천 안 하는 경우
+
+- recommendation-controller가 `blocked:*` 반환
+- 단순 질문/답변 세션
+- 프로젝트 파일이 없음
+- 사용자가 플러그인 관련 작업 중

package/monol-plugin-scout-pkg/hooks/open-console.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# Plugin Scout - 웹 콘솔 열기
+# 로컬 데이터를 HTML에 주입하고 브라우저에서 열기
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+WEB_DIR="$PLUGIN_ROOT/web"
+API_DIR="$PLUGIN_ROOT/api/mock"
+TEMPLATE="$WEB_DIR/console.html"
+OUTPUT="/tmp/plugin-scout-console.html"
+
+# 데이터 파일 확인
+USAGE_FILE="$DATA_DIR/usage.json"
+ANALYTICS_FILE="$DATA_DIR/analytics.json"
+
+if [ ! -f "$USAGE_FILE" ]; then
+  echo "Error: usage.json not found"
+  exit 1
+fi
+
+if [ ! -f "$ANALYTICS_FILE" ]; then
+  echo "Error: analytics.json not found"
+  exit 1
+fi
+
+if [ ! -f "$TEMPLATE" ]; then
+  echo "Error: console.html template not found"
+  exit 1
+fi
+
+# JSON 데이터 읽기
+if command -v jq &> /dev/null; then
+  USAGE_JSON=$(jq -c '.' "$USAGE_FILE")
+  ANALYTICS_JSON=$(jq -c '.' "$ANALYTICS_FILE")
+
+  # Mock API 데이터 읽기
+  if [ -f "$API_DIR/marketplace.json" ]; then
+    MARKETPLACE_JSON=$(jq -c '.' "$API_DIR/marketplace.json")
+  else
+    MARKETPLACE_JSON='{"plugins":[],"total":0}'
+  fi
+
+  if [ -f "$API_DIR/categories.json" ]; then
+    CATEGORIES_JSON=$(jq -c '.' "$API_DIR/categories.json")
+  else
+    CATEGORIES_JSON='{"categories":[]}'
+  fi
+
+  if [ -f "$API_DIR/trending.json" ]; then
+    TRENDING_JSON=$(jq -c '.' "$API_DIR/trending.json")
+  else
+    TRENDING_JSON='{"plugins":[]}'
+  fi
+
+  if [ -f "$API_DIR/insights.json" ]; then
+    INSIGHTS_JSON=$(jq -c '.' "$API_DIR/insights.json")
+  else
+    INSIGHTS_JSON='{"insights":[]}'
+  fi
+else
+  USAGE_JSON=$(cat "$USAGE_FILE" | tr -d '\n')
+  ANALYTICS_JSON=$(cat "$ANALYTICS_FILE" | tr -d '\n')
+
+  # Mock API 데이터 읽기 (jq 없이)
+  if [ -f "$API_DIR/marketplace.json" ]; then
+    MARKETPLACE_JSON=$(cat "$API_DIR/marketplace.json" | tr -d '\n')
+  else
+    MARKETPLACE_JSON='{"plugins":[],"total":0}'
+  fi
+
+  if [ -f "$API_DIR/categories.json" ]; then
+    CATEGORIES_JSON=$(cat "$API_DIR/categories.json" | tr -d '\n')
+  else
+    CATEGORIES_JSON='{"categories":[]}'
+  fi
+
+  if [ -f "$API_DIR/trending.json" ]; then
+    TRENDING_JSON=$(cat "$API_DIR/trending.json" | tr -d '\n')
+  else
+    TRENDING_JSON='{"plugins":[]}'
+  fi
+
+  if [ -f "$API_DIR/insights.json" ]; then
+    INSIGHTS_JSON=$(cat "$API_DIR/insights.json" | tr -d '\n')
+  else
+    INSIGHTS_JSON='{"insights":[]}'
+  fi
+fi
+
+# HTML 생성 (데이터 주입)
+sed -e "s|__USAGE_DATA__|$USAGE_JSON|g" \
+    -e "s|__ANALYTICS_DATA__|$ANALYTICS_JSON|g" \
+    -e "s|__MARKETPLACE_DATA__|$MARKETPLACE_JSON|g" \
+    -e "s|__CATEGORIES_DATA__|$CATEGORIES_JSON|g" \
+    -e "s|__TRENDING_DATA__|$TRENDING_JSON|g" \
+    -e "s|__INSIGHTS_DATA__|$INSIGHTS_JSON|g" \
+    "$TEMPLATE" > "$OUTPUT"
+
+# 브라우저에서 열기
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  open "$OUTPUT"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  xdg-open "$OUTPUT" 2>/dev/null || sensible-browser "$OUTPUT" 2>/dev/null
+elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]]; then
+  start "$OUTPUT"
+else
+  echo "Console generated: $OUTPUT"
+  echo "Please open this file in your browser."
+fi
+
+echo "Console opened: $OUTPUT"

package/monol-plugin-scout-pkg/hooks/open-dashboard.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+# Plugin Scout - 웹 대시보드 열기
+# 데이터를 HTML에 주입하고 브라우저에서 열기
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+WEB_DIR="$PLUGIN_ROOT/web"
+TEMPLATE="$WEB_DIR/dashboard.html"
+OUTPUT="/tmp/plugin-scout-dashboard.html"
+
+# 데이터 파일 확인
+USAGE_FILE="$DATA_DIR/usage.json"
+ANALYTICS_FILE="$DATA_DIR/analytics.json"
+
+if [ ! -f "$USAGE_FILE" ]; then
+  echo "Error: usage.json not found"
+  exit 1
+fi
+
+if [ ! -f "$ANALYTICS_FILE" ]; then
+  echo "Error: analytics.json not found"
+  exit 1
+fi
+
+if [ ! -f "$TEMPLATE" ]; then
+  echo "Error: dashboard.html template not found"
+  exit 1
+fi
+
+# JSON 데이터 읽기 (한 줄로 압축)
+USAGE_DATA=$(cat "$USAGE_FILE" | tr -d '\n' | sed 's/"/\\"/g' | sed "s/'/\\'/g")
+ANALYTICS_DATA=$(cat "$ANALYTICS_FILE" | tr -d '\n' | sed 's/"/\\"/g' | sed "s/'/\\'/g")
+
+# 템플릿에 데이터 주입
+# jq가 있으면 사용, 없으면 cat 사용
+if command -v jq &> /dev/null; then
+  USAGE_JSON=$(jq -c '.' "$USAGE_FILE")
+  ANALYTICS_JSON=$(jq -c '.' "$ANALYTICS_FILE")
+else
+  USAGE_JSON=$(cat "$USAGE_FILE" | tr -d '\n')
+  ANALYTICS_JSON=$(cat "$ANALYTICS_FILE" | tr -d '\n')
+fi
+
+# HTML 생성 (데이터 주입)
+sed -e "s|__USAGE_DATA__|$USAGE_JSON|g" \
+    -e "s|__ANALYTICS_DATA__|$ANALYTICS_JSON|g" \
+    "$TEMPLATE" > "$OUTPUT"
+
+# 브라우저에서 열기
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  open "$OUTPUT"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  xdg-open "$OUTPUT" 2>/dev/null || sensible-browser "$OUTPUT" 2>/dev/null
+elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]]; then
+  start "$OUTPUT"
+else
+  echo "Dashboard generated: $OUTPUT"
+  echo "Please open this file in your browser."
+fi
+
+echo "Dashboard opened: $OUTPUT"

package/monol-plugin-scout-pkg/hooks/track-usage.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Plugin Scout - 스킬 사용 추적
+# 사용법: track-usage.sh <skill-name>
+
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")/..}"
+DATA_DIR="$PLUGIN_ROOT/data"
+SESSION_FILE="$DATA_DIR/.session"
+SKILL_NAME="${1:-unknown}"
+
+# sync 모듈 로드
+if [ -f "$PLUGIN_ROOT/lib/sync.sh" ]; then
+  source "$PLUGIN_ROOT/lib/sync.sh"
+fi
+
+# 데이터 디렉토리 확인
+mkdir -p "$DATA_DIR"
+
+# 세션 파일이 없으면 생성
+if [ ! -f "$SESSION_FILE" ]; then
+  cat > "$SESSION_FILE" << EOF
+{
+  "started": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
+  "recommended": false,
+  "skills_used": []
+}
+EOF
+fi
+
+# jq가 있으면 사용, 없으면 sed로 대체
+if command -v jq &> /dev/null; then
+  TEMP_FILE=$(mktemp)
+  jq --arg skill "$SKILL_NAME" '
+    if (.skills_used | index($skill)) then .
+    else .skills_used += [$skill]
+    end
+  ' "$SESSION_FILE" > "$TEMP_FILE" && mv "$TEMP_FILE" "$SESSION_FILE"
+else
+  # jq 없이 간단한 추가 (중복 체크 없음)
+  if grep -q '"skills_used": \[\]' "$SESSION_FILE"; then
+    sed -i.bak "s/\"skills_used\": \[\]/\"skills_used\": [\"$SKILL_NAME\"]/" "$SESSION_FILE"
+  elif ! grep -q "\"$SKILL_NAME\"" "$SESSION_FILE"; then
+    sed -i.bak "s/\"skills_used\": \[/\"skills_used\": [\"$SKILL_NAME\", /" "$SESSION_FILE"
+  fi
+  rm -f "$SESSION_FILE.bak"
+fi
+
+# 서버에 스킬 사용 이벤트 전송
+if type sync_skill_used &>/dev/null; then
+  sync_skill_used "$SKILL_NAME"
+fi
+
+# 팀 통계에 플러그인 사용 기록
+if [ -f "$PLUGIN_ROOT/lib/team-manager.sh" ]; then
+  CURRENT_USER="${USER:-unknown}"
+  if command -v jq &> /dev/null && [ -f "$SESSION_FILE" ]; then
+    CURRENT_USER=$(jq -r '.user // "unknown"' "$SESSION_FILE")
+  fi
+  bash "$PLUGIN_ROOT/lib/team-manager.sh" record "$CURRENT_USER" "$SKILL_NAME" >/dev/null 2>&1
+fi