monol-plugin-scout 2.1.3 → 4.1.0

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

@@ -1,9 +1,10 @@
 {
   "name": "monol-plugin-scout",
-  "version": "2.1.2",
+  "version": "4.1.0",
   "description": "Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트",
   "author": "monol",
   "commands": "commands/",
   "skills": "skills/",
-  "hooks": "hooks/"
+  "hooks": "hooks/",
+  "lib": "lib/"
 }

package/monol-plugin-scout-pkg/skills/audit.md

@@ -2,6 +2,12 @@
 description: 설치된 플러그인 보안 및 업데이트 점검
 argument-hint: "[--security | --updates]"
 allowed-tools: [Read, Glob, Bash, WebFetch]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh audit"
+          timeout: 5
 ---
 
 # /scout audit - 보안 및 업데이트 점검

package/monol-plugin-scout-pkg/skills/cleanup.md

@@ -2,6 +2,12 @@
 description: 미사용 플러그인 정리 제안
 argument-hint: "[--dry-run | --force]"
 allowed-tools: [Read, Glob, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh cleanup"
+          timeout: 5
 ---
 
 # /scout cleanup - 미사용 플러그인 정리

package/monol-plugin-scout-pkg/skills/compare.md

@@ -2,6 +2,12 @@
 description: 플러그인 비교표 생성
 argument-hint: "<plugin1> <plugin2> [plugin3]"
 allowed-tools: [Read, Glob, Grep, WebFetch]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh compare"
+          timeout: 5
 ---
 
 # /scout compare - 플러그인 비교

package/monol-plugin-scout-pkg/skills/console.md

@@ -0,0 +1,315 @@
+---
+description: 플러그인 대시보드 콘솔 - 전체 현황 및 분석 (한글: 콘솔, 대시보드, 플러그인현황)
+argument-hint: "[--web | --view <dashboard|plugins|analytics|users> | --plugin <name> | --user <name>]"
+allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh console"
+          timeout: 5
+---
+
+# /scout console - 플러그인 대시보드 콘솔
+
+플러그인 현황을 대시보드 형태로 보여주고, 상세 정보 조회, 사용 분석, 인사이트를 제공합니다.
+
+## 사용법
+
+```
+/scout console                    # 메인 대시보드 (CLI)
+/scout console --web              # 웹 대시보드 (브라우저에서 열림)
+/scout console --view dashboard   # 대시보드 뷰
+/scout console --view plugins     # 플러그인 목록
+/scout console --view analytics   # 사용 분석
+/scout console --view users       # 사용자 분석
+/scout console --plugin <name>    # 특정 플러그인 상세
+/scout console --user <name>      # 특정 사용자 분석
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### --web 옵션 (웹 대시보드)
+
+`--web` 인자가 포함된 경우, 브라우저에서 웹 대시보드를 엽니다:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/hooks/open-console.sh
+```
+
+웹 대시보드 특징:
+- 모던 다크 테마 (GitHub Dark 스타일)
+- 네온 그린/사이안 액센트
+- Chart.js 기반 인터랙티브 차트
+- 반응형 디자인
+- 30초마다 자동 새로고침
+
+웹 대시보드를 연 후, 사용자에게 안내 메시지를 표시합니다:
+```
+웹 대시보드가 브라우저에서 열렸습니다.
+파일 위치: /tmp/plugin-scout-console.html
+```
+
+### CLI 대시보드 (기본)
+
+### Phase 1: 데이터 수집
+
+1. **설치된 플러그인 조회**:
+   ```bash
+   cat ~/.claude/plugins/installed_plugins.json
+   ```
+
+2. **활성화 상태 확인**:
+   ```bash
+   cat ~/.claude/settings.json | jq '.enabledPlugins'
+   ```
+
+3. **사용량 데이터 로드**:
+   ```
+   ${CLAUDE_PLUGIN_ROOT}/data/usage.json
+   ${CLAUDE_PLUGIN_ROOT}/data/analytics.json
+   ```
+
+4. **마켓플레이스 정보**:
+   ```bash
+   cat ~/.claude/plugins/known_marketplaces.json
+   ```
+
+### Phase 2: 대시보드 렌더링
+
+인자가 없거나 `--view dashboard`인 경우, 다음 형식으로 대시보드 표시:
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  PLUGIN SCOUT CONSOLE                               v2.5.0    ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Last Updated: [timestamp]                                    ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  OVERVIEW                       QUICK STATS                   ║
+║  ─────────────────────────────  ────────────────────────────  ║
+║  Total Plugins:    [N]          Usage This Week:  [N] times   ║
+║  ├─ Active:        [N]          Avg Daily:        [N] times   ║
+║  └─ Dormant:       [N]          Most Used:        [plugin]    ║
+║                                                               ║
+║  Users:            [N]          Sessions:         [N]         ║
+║  Marketplaces:     [N]          Avg Duration:     [N] min     ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  TOP PLUGINS (by usage)         TOP USERS (by activity)       ║
+║  ─────────────────────────────  ────────────────────────────  ║
+║  1. [plugin]         [N]        1. [user]          [N]        ║
+║  2. [plugin]         [N]        2. [user]          [N]        ║
+║  3. [plugin]         [N]        3. [user]          [N]        ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  INSIGHTS                                                     ║
+║  ─────────────────────────────────────────────────────────────║
+║  [insight-icon] [insight-message]                             ║
+║  [insight-icon] [insight-message]                             ║
+║  [insight-icon] [insight-message]                             ║
+╠═══════════════════════════════════════════════════════════════╣
+║  [1] 플러그인 상세  [2] 분석  [3] 사용자  [4] 탐색  [5] 정리  ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+### Phase 3: 인터랙티브 메뉴
+
+대시보드 표시 후 AskUserQuestion으로 다음 동작 선택:
+
+```yaml
+questions:
+  - question: "어떤 작업을 하시겠습니까?"
+    header: "Console"
+    options:
+      - label: "플러그인 상세보기"
+        description: "설치된 플러그인의 상세 정보 조회"
+      - label: "사용 분석"
+        description: "플러그인 사용 통계 및 트렌드 분석"
+      - label: "사용자 분석"
+        description: "팀원별 플러그인 사용 현황"
+      - label: "마켓플레이스 탐색"
+        description: "새 플러그인 찾기 (/scout explore)"
+      - label: "미사용 정리"
+        description: "오래된 플러그인 정리 (/scout cleanup)"
+    multiSelect: false
+```
+
+### Phase 4: 뷰별 상세 동작
+
+#### 4.1 플러그인 목록 뷰 (`--view plugins`)
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  INSTALLED PLUGINS                                            ║
+╠═══════════════════════════════════════════════════════════════╣
+║  #  │ Plugin            │ Ver   │ Usage │ Last Used  │ Status ║
+║ ────┼───────────────────┼───────┼───────┼────────────┼─────── ║
+║  1  │ commit-commands   │ 2.1.0 │   23  │ Today      │ Active ║
+║  2  │ code-review       │ 1.5.0 │   15  │ Today      │ Active ║
+║  3  │ typescript-lsp    │ 1.2.0 │    8  │ Yesterday  │ Active ║
+║  ...                                                          ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+플러그인 선택 메뉴:
+```yaml
+questions:
+  - question: "어떤 플러그인의 상세 정보를 볼까요?"
+    header: "플러그인"
+    options:
+      - label: "[plugin-name]"
+        description: "사용: [N]회 | [status]"
+      # 동적으로 생성
+    multiSelect: false
+```
+
+#### 4.2 플러그인 상세 뷰 (`--plugin <name>`)
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  PLUGIN DETAIL: [plugin-name]                                 ║
+╠═══════════════════════════════════════════════════════════════╣
+║  BASIC INFO                                                   ║
+║  ─────────────────────────────────────────────────────────────║
+║  Name:           [name]                                       ║
+║  Version:        [version] (Latest: [latest] [status])        ║
+║  Category:       [category]                                   ║
+║  Author:         [author]                                     ║
+║  License:        [license]                                    ║
+║  Installed:      [date] ([days] days ago)                     ║
+║  Source:         [marketplace] ([type])                       ║
+╠═══════════════════════════════════════════════════════════════╣
+║  DESCRIPTION                                                  ║
+║  ─────────────────────────────────────────────────────────────║
+║  [description]                                                ║
+╠═══════════════════════════════════════════════════════════════╣
+║  USAGE STATISTICS                                             ║
+║  ─────────────────────────────────────────────────────────────║
+║  Total Usage:      [N] times                                  ║
+║  This Week:        [N] times                                  ║
+║  Usage Share:      [N]% of all plugin usage                   ║
+║  Trend:            [arrow] [change]% vs last week             ║
+║                                                               ║
+║  Usage by User:                                               ║
+║  ├─ [user1]        [N] times                                  ║
+║  ├─ [user2]        [N] times                                  ║
+║  └─ [user3]        [N] times                                  ║
+╠═══════════════════════════════════════════════════════════════╣
+║  HEALTH & SECURITY                                            ║
+║  ─────────────────────────────────────────────────────────────║
+║  License:         [status] [license]                          ║
+║  Vulnerabilities: [status]                                    ║
+║  Author:          [status] [verification]                     ║
+║  Health Score:    [score]/100                                 ║
+╠═══════════════════════════════════════════════════════════════╣
+║  [U] 업데이트  [R] 제거  [C] 비교  [B] 뒤로                    ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+#### 4.3 분석 뷰 (`--view analytics`)
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  USAGE ANALYTICS                                              ║
+╠═══════════════════════════════════════════════════════════════╣
+║  Period: [start] ~ [end] ([N] days)                           ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  USAGE BY PLUGIN                                              ║
+║  ─────────────────────────────────────────────────────────────║
+║  [plugin]   [bar]  [N]                                        ║
+║  [plugin]   [bar]  [N]                                        ║
+║  ...                                                          ║
+║                                                               ║
+║  USAGE BY CATEGORY              USAGE TREND                   ║
+║  ─────────────────────────────  ────────────────────────────  ║
+║  productivity    [N]  [bar]     Week 1:  [N]                  ║
+║  development     [N]  [bar]     Week 2:  [N]                  ║
+║  external        [N]  [bar]     Week 3:  [N]                  ║
+║                                 Week 4:  [N]                  ║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  KEY INSIGHTS                                                 ║
+║  ─────────────────────────────────────────────────────────────║
+║  1. [insight]                                                 ║
+║  2. [insight]                                                 ║
+║  3. [insight]                                                 ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+#### 4.4 사용자 분석 뷰 (`--view users`)
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║  USER ANALYTICS                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║                                                               ║
+║  USER ACTIVITY                                                ║
+║  ─────────────────────────────────────────────────────────────║
+║  #  │ User      │ Usage │ Sessions │ Top Plugin    │ Active   ║
+║ ────┼───────────┼───────┼──────────┼───────────────┼───────── ║
+║  1  │ kent      │   50  │    12    │ commit-cmd    │ Today    ║
+║  2  │ john      │   42  │    10    │ code-review   │ Today    ║
+║  3  │ jane      │   38  │     8    │ typescript    │ Yesterday║
+║                                                               ║
+╠═══════════════════════════════════════════════════════════════╣
+║  TEAM INSIGHTS                                                ║
+║  ─────────────────────────────────────────────────────────────║
+║  - 팀 전체 사용량 증가 추세 (+15% vs 지난주)                  ║
+║  - commit-commands가 팀에서 가장 인기 있는 플러그인           ║
+║  - 3명의 사용자가 활발히 사용 중                              ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+## 인사이트 아이콘
+
+| 아이콘 | 타입 | 의미 |
+|--------|------|------|
+| 💡 | recommendation | 추천 |
+| ⚠️ | warning | 경고 (미사용, 보안) |
+| 🔄 | update | 업데이트 가능 |
+| 📈 | trend-up | 사용량 증가 |
+| 📉 | trend-down | 사용량 감소 |
+| 🔒 | security | 보안 관련 |
+| ✅ | success | 양호 |
+
+## 상태 정의
+
+| 상태 | 조건 |
+|------|------|
+| Active | lastUsed <= 7일 |
+| Low | 7일 < lastUsed <= 30일 |
+| Dormant | lastUsed > 30일 |
+| Unused | usageCount == 0 |
+
+## 에러 처리
+
+- **데이터 없음**:
+  ```
+  사용 데이터가 없습니다. 플러그인을 사용하면 자동으로 기록됩니다.
+  ```
+
+- **플러그인 없음**:
+  ```
+  '[name]' 플러그인을 찾을 수 없습니다.
+  설치된 플러그인: /plugin list
+  ```
+
+## 예시
+
+```
+/scout console
+→ 메인 대시보드 표시
+
+/scout console --view analytics
+→ 사용 분석 뷰
+
+/scout console --plugin commit-commands
+→ commit-commands 상세 정보
+
+/scout console --user kent
+→ kent 사용자 분석
+```

package/monol-plugin-scout-pkg/skills/explore.md

@@ -2,6 +2,12 @@
 description: 마켓플레이스 카테고리별 탐색
 argument-hint: "[category | --search <keyword>]"
 allowed-tools: [Read, Glob, WebFetch, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh explore"
+          timeout: 5
 ---
 
 # /scout explore - 마켓플레이스 탐색

package/monol-plugin-scout-pkg/skills/fork.md

@@ -2,6 +2,12 @@
 description: 플러그인 포크 및 커스터마이징
 argument-hint: "<source-plugin> <new-name> [--local]"
 allowed-tools: [Read, Write, Bash, Glob]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh fork"
+          timeout: 5
 ---
 
 # /scout fork - 플러그인 포크

package/monol-plugin-scout-pkg/skills/frequency.md

@@ -0,0 +1,93 @@
+---
+description: 추천 빈도 설정 - 세션/일일 추천 횟수 제한 (한글: 빈도, 횟수, 추천빈도)
+argument-hint: "[session | daily] <count>"
+allowed-tools: [Read, Bash]
+---
+
+# /scout frequency - 추천 빈도 설정
+
+플러그인 추천이 표시되는 빈도를 제어합니다.
+
+## 사용법
+
+```
+/scout frequency                     # 현재 설정 확인
+/scout frequency session <count>     # 세션당 최대 추천 횟수
+/scout frequency daily <count>       # 하루 최대 추천 횟수
+/scout frequency cooldown <minutes>  # 추천 간 최소 간격
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 현재 설정 확인 (기본)
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh status
+```
+
+### 세션당 빈도 설정
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh frequency session <count>
+```
+
+### 일일 빈도 설정
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh frequency daily <count>
+```
+
+### 쿨다운 설정
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/recommendation-controller.sh frequency cooldown <minutes>
+```
+
+## 기본값
+
+| 설정 | 기본값 | 설명 |
+|------|--------|------|
+| 세션당 | 1 | 한 세션에 1회만 추천 |
+| 일일 | 3 | 하루에 최대 3회 추천 |
+| 쿨다운 | 30분 | 추천 간 최소 30분 간격 |
+
+## 출력 형식
+
+```markdown
+## 추천 빈도 설정
+
+| 설정 | 현재 값 |
+|------|---------|
+| 세션당 최대 | 1회 |
+| 일일 최대 | 3회 |
+| 쿨다운 | 30분 |
+| 오늘 추천 횟수 | 2회 |
+
+### 설정 변경
+- `/scout frequency session 2` - 세션당 2회로 변경
+- `/scout frequency daily 5` - 일일 5회로 변경
+- `/scout frequency cooldown 60` - 1시간 간격으로 변경
+```
+
+## 예시
+
+```
+/scout frequency
+→ 현재 설정 표시
+
+/scout frequency session 2
+→ 세션당 최대 2회 추천으로 변경
+
+/scout frequency daily 5
+→ 하루 최대 5회로 변경
+
+/scout frequency cooldown 60
+→ 추천 간격을 1시간으로 변경
+```
+
+## 관련 명령어
+
+- `/scout quiet` - 무음 모드 (모든 추천 비활성화)
+- `/scout timing` - 스마트 타이밍 설정

package/monol-plugin-scout-pkg/skills/install.md

@@ -0,0 +1,127 @@
+---
+description: 플러그인 설치 - 추천된 플러그인을 설치합니다 (한글: 설치, 플러그인설치)
+argument-hint: "<plugin-name[@marketplace]>"
+allowed-tools: [Read, Bash, AskUserQuestion]
+hooks:
+  Stop:
+    - hooks:
+        - type: command
+          command: "bash ${CLAUDE_PLUGIN_ROOT}/hooks/track-usage.sh install"
+          timeout: 5
+---
+
+# /scout install - 플러그인 설치
+
+추천된 플러그인을 설치합니다.
+
+## 사용법
+
+```
+/scout install <plugin-name>                    # 기본 설치
+/scout install <plugin-name>@<marketplace>      # 마켓플레이스 지정
+/scout install --list                           # 설치된 플러그인 목록
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### Phase 1: 설치 전 확인
+
+1. **플러그인 존재 확인**:
+   - 마켓플레이스에서 플러그인 검색
+   - 이미 설치되어 있는지 확인
+
+2. **거절 이력 확인**:
+   ```bash
+   bash ${CLAUDE_PLUGIN_ROOT}/lib/rejection-learner.sh check <plugin-name>
+   ```
+
+3. **보안 점검**:
+   - 라이선스 확인
+   - 저자 신뢰도 확인
+   - 알려진 취약점 확인
+
+### Phase 2: 사용자 확인
+
+AskUserQuestion으로 설치 확인:
+
+```yaml
+questions:
+  - question: "<plugin-name> 플러그인을 설치하시겠습니까?"
+    header: "설치 확인"
+    options:
+      - label: "설치"
+        description: "지금 설치합니다"
+      - label: "취소"
+        description: "설치하지 않습니다"
+      - label: "나중에"
+        description: "30일 후 다시 추천받습니다"
+    multiSelect: false
+```
+
+### Phase 3: 설치 실행
+
+사용자가 "설치"를 선택한 경우:
+
+```bash
+bash ${CLAUDE_PLUGIN_ROOT}/lib/plugin-manager.sh install <plugin-name>[@marketplace] recommendation
+```
+
+### Phase 4: 결과 안내
+
+설치 완료 후 메시지:
+
+```markdown
+## 설치 완료
+
+**플러그인**: <plugin-name>
+**마켓플레이스**: <marketplace>
+
+Claude Code를 재시작하면 플러그인이 활성화됩니다.
+
+### 사용법
+- 해당 플러그인의 명령어와 기능을 안내
+```
+
+### Phase 5: 거절 시 기록
+
+사용자가 "취소" 또는 "나중에"를 선택한 경우:
+
+```bash
+# 취소 선택 시
+bash ${CLAUDE_PLUGIN_ROOT}/lib/rejection-learner.sh record <plugin-name> "not-relevant" <category>
+
+# 나중에 선택 시
+bash ${CLAUDE_PLUGIN_ROOT}/lib/rejection-learner.sh record <plugin-name> "later" <category>
+```
+
+## 거절 이유 코드
+
+| 코드 | 의미 |
+|------|------|
+| not-relevant | 프로젝트와 관련 없음 |
+| wrong-language | 사용하지 않는 언어 |
+| already-have | 유사한 플러그인 이미 있음 |
+| too-complex | 너무 복잡함 |
+| not-trusted | 신뢰할 수 없음 |
+| later | 나중에 설치 |
+
+## 예시
+
+```
+/scout install typescript-lsp
+→ typescript-lsp 설치
+
+/scout install code-review@monol
+→ monol 마켓플레이스에서 code-review 설치
+
+/scout install --list
+→ 설치된 플러그인 목록 표시
+```
+
+## 안전 규칙
+
+1. **항상 사용자 확인 필요** - 자동 설치 금지
+2. **백업 생성** - 설치 전 settings.json 백업
+3. **롤백 지원** - 문제 시 복원 가능