monol-plugin-scout 2.1.3 → 4.1.0

package/monol-plugin-scout-pkg/data/.cache/676d5ab664292155e5f509c69d4edae1

@@ -0,0 +1,10 @@
+{
+  "projectRoot": "/Users/kent/Work/monol/monol-plugin-scout/monol-plugin-scout-pkg",
+  "analyzedAt": "2026-01-21T23:41:49Z",
+  "projectTypes": ["claude-plugin"],
+  "frameworks": [],
+  "dependencies": [],
+  "complexity": {"files": 7, "directories": 18, "size": "small"},
+  "suggestedCategories": ["productivity"],
+  "recommendedPlugins": []
+}

package/monol-plugin-scout-pkg/data/.session

@@ -0,0 +1,8 @@
+{
+  "started": "2026-01-21T23:16:11Z",
+  "user": "Taehun Kim",
+  "recommended": false,
+  "skills_used": [
+    "scout"
+  ]
+}

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

@@ -0,0 +1,102 @@
+{
+  "version": "1.0.0",
+  "lastUpdated": "2026-01-18T19:46:25Z",
+  "summary": {
+    "totalPlugins": 11,
+    "activePlugins": 9,
+    "dormantPlugins": 2,
+    "totalUsageCount": 62,
+    "avgDailyUsage": 4.7
+  },
+  "trends": {
+    "weekly": [
+      {
+        "week": "2026-W02",
+        "usageCount": 25,
+        "activePlugins": 5
+      },
+      {
+        "week": "2026-W03",
+        "usageCount": 31,
+        "activePlugins": 6
+      }
+    ],
+    "monthly": [
+      {
+        "month": "2026-01",
+        "usageCount": 56,
+        "newInstalls": 2,
+        "uninstalls": 0
+      }
+    ]
+  },
+  "pluginStats": {
+    "commit-commands": {
+      "usageCount": 23,
+      "usageShare": 41.1,
+      "trend": "up",
+      "lastWeekUsage": 12
+    },
+    "code-review": {
+      "usageCount": 15,
+      "usageShare": 26.8,
+      "trend": "stable",
+      "lastWeekUsage": 8
+    },
+    "typescript-lsp": {
+      "usageCount": 8,
+      "usageShare": 14.3,
+      "trend": "up",
+      "lastWeekUsage": 3
+    },
+    "scout": {
+      "usageCount": 5,
+      "usageShare": 8.9,
+      "trend": "up",
+      "lastWeekUsage": 2
+    },
+    "audit": {
+      "usageCount": 3,
+      "usageShare": 5.4,
+      "trend": "stable",
+      "lastWeekUsage": 2
+    },
+    "console": {
+      "usageCount": 2,
+      "usageShare": 3.6,
+      "trend": "new",
+      "lastWeekUsage": 0
+    }
+  },
+  "userStats": {},
+  "insights": [
+    {
+      "type": "cleanup",
+      "severity": "warning",
+      "message": "plugin-dev이 오래 미사용 상태입니다 (마지막: never)",
+      "action": "/scout cleanup",
+      "generated": "2026-01-18T19:46:25Z"
+    },
+    {
+      "type": "cleanup",
+      "severity": "warning",
+      "message": "old-unused-plugin이 오래 미사용 상태입니다 (마지막: 2025-10-15)",
+      "action": "/scout cleanup",
+      "generated": "2026-01-18T19:46:25Z"
+    },
+    {
+      "type": "trend-up",
+      "severity": "info",
+      "message": "commit-commands이 가장 활발히 사용됩니다 (23회)",
+      "action": "",
+      "generated": "2026-01-18T19:46:25Z"
+    },
+    {
+      "type": "cleanup",
+      "severity": "warning",
+      "message": "plugin-dev이 설치 후 한 번도 사용되지 않았습니다",
+      "action": "/scout cleanup",
+      "generated": "2026-01-18T19:46:25Z"
+    }
+  ]
+}

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

@@ -1,36 +1,92 @@
 {
-  "version": "1.0.0",
-  "lastUpdated": "2026-01-07T00:00:00.000Z",
-
+  "version": "2.0.0",
+  "lastUpdated": "2026-01-21T17:51:30Z",
   "declined": {
     "pyright-lsp": {
       "count": 2,
       "lastDeclined": "2026-01-06",
-      "reason": "Python 프로젝트 아님"
+      "reason": "not-relevant",
+      "category": "development",
+      "declinedAt": [
+        "2026-01-05T10:00:00Z",
+        "2026-01-06T14:30:00Z"
+      ]
+    },
+    "ruby-lsp": {
+      "count": 1,
+      "lastDeclined": "2026-01-10",
+      "reason": "wrong-language",
+      "category": "development",
+      "declinedAt": [
+        "2026-01-10T09:00:00Z"
+      ]
     }
   },
-
   "installed": {
     "typescript-lsp": {
       "date": "2026-01-07",
       "context": "typescript-project",
-      "source": "recommendation"
+      "source": "recommendation",
+      "installedAt": "2026-01-07T10:00:00Z"
     },
     "code-review": {
       "date": "2026-01-07",
       "context": "productivity",
-      "source": "recommendation"
+      "source": "recommendation",
+      "installedAt": "2026-01-07T10:05:00Z"
     },
     "sentry": {
       "date": "2026-01-07",
       "context": "existing-integration",
-      "source": "project-scan"
+      "source": "project-scan",
+      "installedAt": "2026-01-07T10:10:00Z"
+    },
+    "commit-commands": {
+      "date": "2026-01-07",
+      "context": "productivity",
+      "source": "manual",
+      "installedAt": "2026-01-07T10:15:00Z"
     }
   },
-
   "preferences": {
-    "favoriteCategories": ["development", "productivity"],
+    "favoriteCategories": [
+      "development",
+      "productivity"
+    ],
+    "blockedCategories": [],
     "autoRecommend": true,
-    "quietMode": false
+    "quietMode": false,
+    "recommendationCooldown": 30,
+    "maxRejectionsBeforeBlock": 3,
+    "maxRecommendationsPerSession": 2,
+    "maxRecommendationsPerDay": 5,
+    "smartTiming": {
+      "onlyAfterCommit": false,
+      "onlyAfterPR": false
+    },
+    "trustedAutoInstall": false
+  },
+  "trustedInstallLog": [],
+  "skills": {
+    "installed": [],
+    "declined": []
+  },
+  "rejectionPatterns": {
+    "byCategory": {
+      "development": 4
+    },
+    "byReason": {
+      "not-relevant": 1,
+      "wrong-language": 3
+    }
+  },
+  "rejectionReasons": {
+    "not-relevant": "프로젝트와 관련 없음",
+    "wrong-language": "사용하지 않는 언어",
+    "already-have": "유사한 플러그인 이미 있음",
+    "too-complex": "너무 복잡함",
+    "not-trusted": "신뢰할 수 없음",
+    "later": "나중에 설치",
+    "other": "기타"
   }
 }

package/monol-plugin-scout-pkg/data/logs/scout.log

@@ -0,0 +1 @@
+[2026-01-21T23:43:59Z] [INFO] Plugin Scout started | version=3.1

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

@@ -0,0 +1,17 @@
+{
+  "version": "1.0.0",
+  "tasks": [
+    {
+      "id": "779653a6",
+      "type": "cleanup",
+      "interval": "weekly",
+      "target": "all",
+      "message": "Weekly cleanup task",
+      "createdAt": "2026-01-22T00:19:35Z",
+      "nextRun": "2026-01-29T00:19:35Z",
+      "lastRun": null,
+      "enabled": true
+    }
+  ],
+  "lastRun": null
+}

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

@@ -0,0 +1,53 @@
+{
+  "version": "1.0.0",
+  "teamName": "Plugin Scout Team",
+  "members": {
+    "kent": {
+      "name": "Taehun Kim",
+      "email": "thkim@nextedition.co.kr",
+      "joinedAt": "2026-01-21T23:11:28Z",
+      "lastActive": "2026-01-21T23:11:28Z",
+      "sessions": 1,
+      "pluginsUsed": [],
+      "topPlugins": []
+    },
+    "Taehun Kim": {
+      "name": "Taehun Kim",
+      "email": "thkim@nextedition.co.kr",
+      "joinedAt": "2026-01-21T23:16:11Z",
+      "lastActive": "2026-01-21T23:16:34Z",
+      "sessions": 1,
+      "pluginsUsed": [
+        "scout"
+      ],
+      "topPlugins": []
+    }
+  },
+  "sharedRecommendations": [
+    {
+      "plugin": "eslint-fix",
+      "reason": "코드 품질 향상 필수!",
+      "sharedBy": "kent",
+      "sharedAt": "2026-01-21T23:13:23Z",
+      "votes": 1
+    }
+  ],
+  "sharedSettings": {
+    "defaultPlugins": [],
+    "blockedPlugins": [],
+    "categories": []
+  },
+  "stats": {
+    "totalMembers": 2,
+    "activeMembers": 2,
+    "totalPluginsUsed": 1,
+    "topPlugins": [
+      {
+        "plugin": "scout",
+        "count": 1
+      }
+    ]
+  },
+  "createdAt": "2026-01-21T23:11:28Z",
+  "updatedAt": "2026-01-21T23:22:39Z"
+}

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

@@ -1,5 +1,5 @@
 {
-  "lastUpdated": "2026-01-07T00:00:00.000Z",
+  "lastUpdated": "2026-01-18T19:43:41Z",
   "config": {
     "unusedThresholdDays": 30,
     "lowUsageThreshold": 3
@@ -8,27 +8,27 @@
     "typescript-lsp": {
       "installed": "2026-01-07",
       "usageCount": 8,
-      "lastUsed": "2026-01-07"
+      "lastUsed": "2026-01-19"
     },
     "code-review": {
       "installed": "2026-01-07",
       "usageCount": 15,
-      "lastUsed": "2026-01-07"
+      "lastUsed": "2026-01-19"
     },
     "commit-commands": {
       "installed": "2026-01-07",
       "usageCount": 23,
-      "lastUsed": "2026-01-07"
+      "lastUsed": "2026-01-19"
     },
     "sentry": {
       "installed": "2026-01-07",
       "usageCount": 5,
-      "lastUsed": "2026-01-06"
+      "lastUsed": "2026-01-18"
     },
     "slack": {
       "installed": "2026-01-07",
       "usageCount": 3,
-      "lastUsed": "2026-01-05"
+      "lastUsed": "2026-01-15"
     },
     "plugin-dev": {
       "installed": "2025-11-15",
@@ -38,12 +38,105 @@
     "hookify": {
       "installed": "2026-01-07",
       "usageCount": 1,
-      "lastUsed": "2026-01-07"
+      "lastUsed": "2026-01-10"
     },
     "old-unused-plugin": {
       "installed": "2025-10-01",
       "usageCount": 2,
       "lastUsed": "2025-10-15"
+    },
+    "scout": {
+      "installed": "2026-01-19",
+      "usageCount": 3,
+      "lastUsed": "2026-01-19"
+    },
+    "audit": {
+      "installed": "2026-01-19",
+      "usageCount": 1,
+      "lastUsed": "2026-01-19"
+    },
+    "console": {
+      "installed": "2026-01-19",
+      "usageCount": 1,
+      "lastUsed": "2026-01-19"
     }
+  },
+  "users": {
+    "kent": {
+      "plugins": {
+        "commit-commands": {
+          "usageCount": 15,
+          "lastUsed": "2026-01-19"
+        },
+        "code-review": {
+          "usageCount": 10,
+          "lastUsed": "2026-01-19"
+        },
+        "typescript-lsp": {
+          "usageCount": 5,
+          "lastUsed": "2026-01-19"
+        },
+        "scout": {
+          "usageCount": 3,
+          "lastUsed": "2026-01-19"
+        }
+      },
+      "sessions": 12,
+      "lastActive": "2026-01-19",
+      "firstSeen": "2026-01-07"
+    },
+    "john": {
+      "plugins": {
+        "commit-commands": {
+          "usageCount": 5,
+          "lastUsed": "2026-01-18"
+        },
+        "code-review": {
+          "usageCount": 3,
+          "lastUsed": "2026-01-18"
+        },
+        "sentry": {
+          "usageCount": 3,
+          "lastUsed": "2026-01-18"
+        }
+      },
+      "sessions": 8,
+      "lastActive": "2026-01-18",
+      "firstSeen": "2026-01-10"
+    },
+    "jane": {
+      "plugins": {
+        "commit-commands": {
+          "usageCount": 3,
+          "lastUsed": "2026-01-17"
+        },
+        "typescript-lsp": {
+          "usageCount": 3,
+          "lastUsed": "2026-01-17"
+        },
+        "code-review": {
+          "usageCount": 2,
+          "lastUsed": "2026-01-17"
+        }
+      },
+      "sessions": 5,
+      "lastActive": "2026-01-17",
+      "firstSeen": "2026-01-12"
+    },
+    "김태훈": {
+      "plugins": {
+        "console": {
+          "usageCount": 1,
+          "lastUsed": "2026-01-19"
+        }
+      },
+      "sessions": 1,
+      "lastActive": "2026-01-19",
+      "firstSeen": "2026-01-19"
+    }
+  },
+  "sessions": {
+    "total": 26,
+    "thisWeek": 15
   }
 }

package/monol-plugin-scout-pkg/docs/ARCHITECTURE.md

@@ -0,0 +1,201 @@
+# Plugin Scout Console - 아키텍처
+
+## 역할 분리
+
+### 플러그인 (로컬)
+클라이언트 사이드에서 처리되는 기능
+
+| 기능 | 데이터 소스 | 설명 |
+|------|-------------|------|
+| 설치된 플러그인 목록 | `~/.claude/plugins/installed_plugins.json` | 로컬에 설치된 플러그인 |
+| 플러그인 활성화 상태 | `~/.claude/settings.json` | 활성/비활성 상태 |
+| 사용량 추적 | `${PLUGIN_ROOT}/data/usage.json` | 로컬 사용 기록 |
+| 세션 기록 | `${PLUGIN_ROOT}/data/sessions/` | 세션별 사용 로그 |
+| 사용자 정보 | `$USER`, `git config user.name` | 현재 사용자 |
+| 콘솔 UI 렌더링 | `web/console.html` | 브라우저에서 표시 |
+| 데이터 내보내기 | 로컬 JSON 생성 | Export 기능 |
+
+### 서버 (API)
+원격 서버에서 제공해야 하는 기능
+
+| API | 엔드포인트 | 설명 |
+|-----|-----------|------|
+| 마켓플레이스 목록 | `GET /api/marketplace` | 전체 플러그인 카탈로그 |
+| 플러그인 검색 | `GET /api/marketplace/search?q=` | 마켓플레이스 검색 |
+| 플러그인 상세 | `GET /api/marketplace/{name}` | 플러그인 상세 정보 |
+| 카테고리 목록 | `GET /api/categories` | 카테고리 분류 |
+| 트렌딩 | `GET /api/marketplace/trending` | 인기 플러그인 |
+| 다운로드 수 | `GET /api/stats/{name}` | 플러그인 통계 |
+| 팀 통계 | `GET /api/team/{teamId}/stats` | 팀 사용 현황 (옵션) |
+| 인사이트 | `GET /api/insights` | 추천/알림 |
+
+## API 스키마
+
+### GET /api/marketplace
+```json
+{
+  "plugins": [
+    {
+      "name": "string",
+      "description": "string",
+      "version": "string",
+      "author": "string",
+      "category": "string",
+      "downloads": "number",
+      "rating": "number",
+      "trending": "boolean",
+      "tags": ["string"],
+      "createdAt": "ISO8601",
+      "updatedAt": "ISO8601"
+    }
+  ],
+  "total": "number",
+  "page": "number",
+  "pageSize": "number"
+}
+```
+
+### GET /api/marketplace/search?q={query}&category={category}
+```json
+{
+  "results": [/* plugin objects */],
+  "total": "number",
+  "query": "string"
+}
+```
+
+### GET /api/marketplace/{name}
+```json
+{
+  "name": "string",
+  "description": "string",
+  "longDescription": "string",
+  "version": "string",
+  "author": "string",
+  "repository": "string",
+  "homepage": "string",
+  "category": "string",
+  "tags": ["string"],
+  "downloads": "number",
+  "rating": "number",
+  "reviewCount": "number",
+  "trending": "boolean",
+  "screenshots": ["string"],
+  "changelog": "string",
+  "dependencies": ["string"],
+  "createdAt": "ISO8601",
+  "updatedAt": "ISO8601"
+}
+```
+
+### GET /api/categories
+```json
+{
+  "categories": [
+    {
+      "id": "string",
+      "name": "string",
+      "icon": "string",
+      "count": "number"
+    }
+  ]
+}
+```
+
+### GET /api/marketplace/trending
+```json
+{
+  "trending": [/* plugin objects with trendScore */],
+  "period": "week|month"
+}
+```
+
+### GET /api/insights
+```json
+{
+  "insights": [
+    {
+      "type": "recommendation|warning|info|security",
+      "severity": "low|medium|high",
+      "message": "string",
+      "action": "string|null",
+      "plugin": "string|null",
+      "createdAt": "ISO8601"
+    }
+  ]
+}
+```
+
+## 데이터 흐름
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      Plugin Scout Console                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│  ┌──────────────┐          ┌──────────────────────────┐     │
+│  │   로컬 데이터  │          │      서버 API (Mock)      │     │
+│  ├──────────────┤          ├──────────────────────────┤     │
+│  │ usage.json   │◄────┐    │ GET /api/marketplace     │     │
+│  │ sessions/    │     │    │ GET /api/search          │     │
+│  │ analytics.json│    │    │ GET /api/categories      │     │
+│  └──────┬───────┘    │    │ GET /api/trending        │     │
+│         │            │    │ GET /api/insights        │     │
+│         ▼            │    └───────────┬──────────────┘     │
+│  ┌──────────────┐    │                │                     │
+│  │ open-console │    │                │                     │
+│  │    .sh       │────┼────────────────┤                     │
+│  └──────┬───────┘    │                │                     │
+│         │            │                ▼                     │
+│         ▼            │    ┌──────────────────────────┐     │
+│  ┌──────────────┐    │    │    console.html          │     │
+│  │ /tmp/console │    │    │  ┌────────────────────┐  │     │
+│  │    .html     │◄───┼────┤  │ 로컬 데이터 주입     │  │     │
+│  └──────┬───────┘    │    │  │ (USAGE_DATA)       │  │     │
+│         │            │    │  └────────────────────┘  │     │
+│         ▼            │    │  ┌────────────────────┐  │     │
+│  ┌──────────────┐    │    │  │ API fetch          │  │     │
+│  │   Browser    │    │    │  │ (Marketplace)      │  │     │
+│  └──────────────┘    │    │  └────────────────────┘  │     │
+│                      │    └──────────────────────────┘     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 목업 API 사용
+
+개발 환경에서는 `api/mock/` 폴더의 JSON 파일을 사용:
+
+```javascript
+// console.html 내 API 호출
+const API_BASE = '__API_BASE__'; // 주입되는 값
+
+// 프로덕션: https://api.scout.monol.dev
+// 개발/목업: file:///path/to/api/mock/
+
+async function fetchMarketplace() {
+  const res = await fetch(`${API_BASE}/marketplace.json`);
+  return res.json();
+}
+```
+
+## 파일 구조
+
+```
+monol-plugin-scout-pkg/
+├── api/
+│   └── mock/
+│       ├── marketplace.json      # 마켓플레이스 전체 목록
+│       ├── categories.json       # 카테고리 목록
+│       ├── trending.json         # 트렌딩 플러그인
+│       ├── insights.json         # 인사이트/추천
+│       └── plugins/
+│           ├── commit-commands.json
+│           └── ...
+├── data/
+│   ├── usage.json               # 로컬 사용량
+│   └── analytics.json           # 로컬 분석
+├── web/
+│   └── console.html             # 콘솔 UI
+└── hooks/
+    └── open-console.sh          # 콘솔 실행 스크립트
+```