claude-pro-minmax 1.0.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pro-minmax",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Quota-first routing and safety layer for Claude Code Pro workflows.",
   "author": "donghoon <move-hoon@users.noreply.github.com>",
   "license": "MIT",
@@ -9,20 +9,20 @@
     "cpmm": "bin/cpmm.js"
   },
   "files": [
-    "bin",
+    "bin/",
+    "lib/",
+    ".claude.json",
+    "install.sh",
     ".claude/CLAUDE.md",
     ".claude/settings.json",
     ".claude/settings.local.example.json",
-    ".claude/agents",
-    ".claude/commands",
-    ".claude/contexts",
-    ".claude/rules",
-    ".claude/sessions",
-    ".claude/skills",
-    ".claude.json",
+    ".claude/agents/",
+    ".claude/commands/",
+    ".claude/contexts/",
+    ".claude/rules/",
+    ".claude/skills/cli-wrappers/",
     ".claudeignore",
-    "install.sh",
-    "scripts",
+    "scripts/",
     "README.md",
     "README.ko.md",
     "LICENSE"
@@ -32,6 +32,7 @@
   },
   "scripts": {
     "help": "node bin/cpmm.js --help",
+    "setup": "node bin/cpmm.js setup",
     "doctor": "node bin/cpmm.js doctor",
     "test": "node bin/cpmm.js --version && node bin/cpmm.js --help"
   },
@@ -56,4 +57,4 @@
     "url": "https://github.com/move-hoon/claude-pro-minmax/issues"
   },
   "homepage": "https://github.com/move-hoon/claude-pro-minmax#readme"
-}
+}

package/.claude/sessions/2025-01-27-auth-jwt-refresh.md

@@ -1,32 +0,0 @@
----
-session_id: example-session
-date: 2025-01-29 14:30
-name: auth-jwt-implementation
-project: pro-plan-v3-final
----
-
-# Session: auth-jwt-implementation
-
-## Completed Tasks
-- [x] Created JWT utility class in `src/auth/jwt.ts`
-- [x] Implemented login endpoint with token generation
-- [x] Added refresh token rotation logic
-- [x] Wrote unit tests for token validation
-
-## Current State
-JWT authentication is fully implemented. Ready for integration testing.
-
-## Next Actions
-- [ ] Add rate limiting to login endpoint
-- [ ] Implement token blacklist for logout
-- [ ] Add integration tests with database
-
-## Context
-- Files: `src/auth/jwt.ts`, `src/auth/login.ts`, `tests/auth.test.ts`
-- Decisions: Using HS256 for simplicity, will migrate to RS256 for production
-
-## Loaded Contexts
-- backend: active
-
-## Learned Patterns
-- Always validate token expiry before processing

package/.claude/sessions/README.ko.md

@@ -1,195 +0,0 @@
-> **[English Version](README.md)**
-
-# Sessions Directory
-
-## 목적
-`/session-save`에 의해 생성된 세션 상태 파일을 저장합니다. 세션 간에 연속성을 가능하게 합니다.
-
-> **경로 안내:** 예시에는 설치 경로(`~/.claude/...`)가 포함됩니다. 이 저장소 기준 소스 경로는 `./.claude/...`, `./scripts/...`입니다.
-
-## 세션 생명주기
-
-```mermaid
-flowchart TB
-    %% 스타일 정의 %%
-    classDef command fill:#e8f5e9,stroke:#43a047,stroke-width:2px;
-    classDef file fill:#fff3e0,stroke:#fb8c00,stroke-width:2px;
-    classDef process fill:#e3f2fd,stroke:#1e88e5,stroke-width:2px;
-    classDef hook fill:#ffebee,stroke:#e53935,stroke-width:2px;
-    classDef builtin fill:#f3e5f5,stroke:#8e24aa,stroke-width:2px;
-    classDef note fill:#fffde7,stroke:#fdd835,stroke-width:1px,stroke-dasharray: 3 3;
-
-    %% 메인 세션 플로우 %%
-    Start((🚀 세션 시작)):::process
-    Start --> Work[🔨 작업 진행]:::process
-    
-    Work --> Decision{세션 저장?}:::process
-    Decision -->|Yes| SaveCmd[/"💾 /session-save auth-feature"/]:::command
-    Decision -->|No| Continue[작업 계속]:::process
-    Continue --> Work
-    
-    %% 저장 프로세스 %%
-    SaveCmd --> Collect["📋 상태 수집<br/>• 완료된 작업<br/>• 현재 상태<br/>• 다음 액션<br/>• 주요 파일"]:::process
-    Collect --> Scrub{{"🔐 scrub-secrets.js<br/>15+ 시크릿 패턴 제거"}}:::hook
-    Scrub --> Write["✍️ 파일 작성<br/>.claude/sessions/<br/>2025-01-28-auth-feature.md"]:::file
-    Write --> Notify["✅ 세션 저장 완료!<br/>스크러빙: N개 시크릿"]:::note
-    
-    %% 로드 프로세스 %%
-    Notify -.->|"나중에..."| LoadStart((📂 새 세션)):::process
-    LoadStart --> LoadCmd[/"📂 /session-load auth-feature"/]:::command
-    LoadCmd --> Read["📖 세션 파일 읽기"]:::process
-    Read --> Restore["🔄 컨텍스트 복원<br/>• 완료된 작업 설정<br/>• 다음 액션 로드<br/>• 주요 파일 참조"]:::process
-    Restore --> Ready["✅ 작업 재개 준비 완료!"]:::note
-    
-    %% 내장 CLI 대안 %%
-    subgraph BuiltInCLI["🔧 대안: 내장 CLI"]
-        direction TB
-        BuiltinNote["정확한 대화 재생용<br/>(사람이 읽을 수 있는 요약 아님)"]:::note
-        CLI1["claude -c / --continue<br/>→ 가장 최근 세션 재개"]:::builtin
-        CLI2["claude -r abc123 / --resume abc123<br/>→ 특정 세션 재개"]:::builtin
-        JSONL["~/.claude/projects/*.jsonl<br/>(원본 대화 기록)"]:::file
-        CLI1 --> JSONL
-        CLI2 --> JSONL
-    end
-```
-
-### 커스텀 vs 내장 세션
-
-| 기능 | `/session-save` + `/session-load` | `claude --continue` |
-|------|-----------------------------------|---------------------|
-| **형식** | 사람이 읽을 수 있는 `.md` | 원본 `.jsonl` |
-| **위치** | `.claude/sessions/` (프로젝트) | `~/.claude/projects/` (전역) |
-| **내용** | 요약 (작업, 결정, 다음 단계) | 전체 대화 기록 |
-| **시크릿 스크러빙** | ✅ 자동 | ❌ 스크러빙 없음 |
-| **적합한 용도** | 컨텍스트 공유, 문서화 | 정확한 대화 재생 |
-
-### 언제 무엇을 사용할까?
-
-| 상황 | 추천 | 이유 |
-|------|------|------|
-| 짧은 휴식 후 재개 (같은 날) | `claude -c` | 빠르고 정확한 대화 이어가기 |
-| 긴 휴식 후 재개 (다음 날) | `/session-load` | 핵심 컨텍스트만 로드, 비용 절약 |
-| 팀원과 컨텍스트 공유 | `/session-save` | 사람이 읽을 수 있는 `.md` 공유 가능 |
-| 시크릿 포함한 작업 후 | `/session-save` | 자동 스크러빙으로 안전 |
-| 정확한 대화 기록 필요 | `claude --resume` | 전체 대화 그대로 복원 |
-
-### 추천 워크플로우
-
-```
-📅 1일차 오전: 새 작업 시작
-📅 1일차 오후: 점심 후 → claude -c (내장 CLI로 빠른 재개)
-📅 1일차 저녁: /session-save feature-v1 (작업 요약 저장)
-
-📅 2일차: /session-load feature-v1 (깔끔한 컨텍스트로 시작)
-📅 2일차 오후: claude -c (같은 날 빠른 재개)
-📅 2일차 저녁: /session-save feature-v2 (진행 상황 저장)
-```
-
-> **💡 Tip**: 둘은 **경쟁이 아니라 보완 관계**입니다. 상황에 맞게 골라 쓰세요!
-
-## 파일 명명
-
-```
-YYYY-MM-DD-[name].md
-```
-
-예시:
-- `2025-01-27-auth-jwt.md`
-- `2025-01-27-payment-integration.md`
-
-## 보안
-
-**모든 세션 파일은 기록되기 전에 자동으로 스크러빙(민감 정보 제거)됩니다.**
-
-스크러빙되는 패턴:
-- API 키 (OpenAI, Anthropic, Stripe, GitHub, AWS)
-- 자격 증명이 포함된 데이터베이스 URL
-- JWT 토큰
-- 비밀번호 필드
-- 개인 키 (Private keys)
-
-## 사용법
-
-```bash
-# 현재 세션 저장
-/session-save auth-feature
-
-# 가장 최근 세션 로드
-/session-load
-
-# 특정 세션 로드
-/session-load auth-feature
-
-# 사용 가능한 세션 목록
-/session-load --list
-```
-
-## 세션 파일 형식
-
-```markdown
-# Session: [name]
-Date: [timestamp]
-Duration: [messages]
-Security: [items scrubbed]
-
-## Context
-- Project: [name]
-- Branch: [branch]
-- Focus: [description]
-
-## Completed
-- [x] [task]
-
-## In Progress
-- [ ] [task] - [status]
-
-## Decisions Made
-- [decision]: [reasoning]
-
-## Next Steps
-1. [action]
-
-## Key Files
-- [file]: [why relevant]
-
-## Loaded Contexts
-- [type]: [status]
-
-## Learned Patterns
-- [pattern]
-```
-
-## 유지 관리
-
-```bash
-# 세션 목록 조회
-ls -la .claude/sessions/
-
-# 오래된 세션 삭제 (>30일)
-find .claude/sessions/ -mtime +30 -delete
-
-# 수동 스크러빙 (필요한 경우)
-node scripts/scrub-secrets.js < session.md > clean.md
-# 설치 경로: node ~/.claude/scripts/scrub-secrets.js < session.md > clean.md
-```
-
-## Claude 내장 세션 명령어
-
-커스텀 `/session-save`, `/session-load` 외에도 Claude Code 내장 세션 기능이 있습니다:
-
-| 명령어 | 목적 |
-|--------|------|
-| `claude -c` / `--continue` | 가장 최근 세션 재개 |
-| `claude -r "id"` / `--resume "id"` | 특정 세션 ID로 재개 |
-| `claude --resume` | 최근 세션 목록에서 선택 |
-
-> **참고:** 내장 세션은 `~/.claude/projects/.../*.jsonl`에 저장됩니다. 커스텀 `/session-save`는 `.claude/sessions/`에 사람이 읽을 수 있는 `.md` 요약을 생성합니다.
-
-## 모범 사례
-
-1. 논리적 단계가 완료된 후 저장
-2. 긴 휴식 전 (>4시간) 저장
-3. 설명적인 이름 사용
-4. 주기적으로 오래된 세션 정리
-5. **스크립트 실행 권한 확인**: `chmod +x scripts/hooks/*.sh`  
-   (설치 경로: `chmod +x ~/.claude/scripts/hooks/*.sh`)

package/.claude/sessions/README.md

@@ -1,195 +0,0 @@
-> **[한국어 버전](README.ko.md)**
-
-# Sessions Directory
-
-## Purpose
-Stores session state files created by `/session-save`. Enables continuity across sessions.
-
-> **Path note:** Examples include installed paths (`~/.claude/...`). In this repository, source paths are `./.claude/...` and `./scripts/...`.
-
-## Session Lifecycle
-
-```mermaid
-flowchart TB
-    %% Style definitions %%
-    classDef command fill:#e8f5e9,stroke:#43a047,stroke-width:2px;
-    classDef file fill:#fff3e0,stroke:#fb8c00,stroke-width:2px;
-    classDef process fill:#e3f2fd,stroke:#1e88e5,stroke-width:2px;
-    classDef hook fill:#ffebee,stroke:#e53935,stroke-width:2px;
-    classDef builtin fill:#f3e5f5,stroke:#8e24aa,stroke-width:2px;
-    classDef note fill:#fffde7,stroke:#fdd835,stroke-width:1px,stroke-dasharray: 3 3;
-
-    %% Main Session Flow %%
-    Start((🚀 Session Start)):::process
-    Start --> Work[🔨 Working on Tasks]:::process
-    
-    Work --> Decision{Save Session?}:::process
-    Decision -->|Yes| SaveCmd[/"💾 /session-save auth-feature"/]:::command
-    Decision -->|No| Continue[Continue Working]:::process
-    Continue --> Work
-    
-    %% Save Process %%
-    SaveCmd --> Collect["📋 Collect State<br/>• Completed tasks<br/>• Current state<br/>• Next actions<br/>• Key files"]:::process
-    Collect --> Scrub{{"🔐 scrub-secrets.js<br/>Remove 15+ secret patterns"}}:::hook
-    Scrub --> Write["✍️ Write to<br/>.claude/sessions/<br/>2025-01-28-auth-feature.md"]:::file
-    Write --> Notify["✅ Session saved!<br/>Scrubbed: N secrets"]:::note
-    
-    %% Load Process %%
-    Notify -.->|"Later..."| LoadStart((📂 New Session)):::process
-    LoadStart --> LoadCmd[/"📂 /session-load auth-feature"/]:::command
-    LoadCmd --> Read["📖 Read session file"]:::process
-    Read --> Restore["🔄 Restore Context<br/>• Set completed tasks<br/>• Load next actions<br/>• Reference key files"]:::process
-    Restore --> Ready["✅ Ready to continue!"]:::note
-    
-    %% Built-in Alternative %%
-    subgraph BuiltInCLI["🔧 Alternative: Built-in CLI"]
-        direction TB
-        BuiltinNote["For exact conversation replay<br/>(not human-readable summary)"]:::note
-        CLI1["claude -c / --continue<br/>→ Resume most recent"]:::builtin
-        CLI2["claude -r abc123 / --resume abc123<br/>→ Resume specific session"]:::builtin
-        JSONL["~/.claude/projects/*.jsonl<br/>(raw conversation history)"]:::file
-        CLI1 --> JSONL
-        CLI2 --> JSONL
-    end
-```
-
-### Custom vs Built-in Sessions
-
-| Feature | `/session-save` + `/session-load` | `claude --continue` |
-|---------|-----------------------------------|---------------------|
-| **Format** | Human-readable `.md` | Raw `.jsonl` |
-| **Location** | `.claude/sessions/` (project) | `~/.claude/projects/` (global) |
-| **Content** | Summary (tasks, decisions, next steps) | Full conversation transcript |
-| **Secret Scrubbing** | ✅ Automatic | ❌ Not scrubbed |
-| **Best For** | Sharing context, documentation | Exact conversation replay |
-
-### When to Use What?
-
-| Situation | Recommended | Why |
-|-----------|-------------|-----|
-| Short break (same day) | `claude -c` | Fast, exact conversation resume |
-| Long break (next day) | `/session-load` | Load only key context, reduce cost |
-| Share context with team | `/session-save` | Human-readable `.md` for sharing |
-| After working with secrets | `/session-save` | Auto-scrubbing for safety |
-| Need exact conversation | `claude --resume` | Full transcript replay |
-
-### Recommended Workflow
-
-```
-📅 Day 1 Morning: Start new task
-📅 Day 1 Afternoon: After lunch → claude -c (quick resume with built-in CLI)
-📅 Day 1 Evening: /session-save feature-v1 (save work summary)
-
-📅 Day 2: /session-load feature-v1 (start fresh with clean context)
-📅 Day 2 Afternoon: claude -c (quick resume same day)
-📅 Day 2 Evening: /session-save feature-v2 (save progress)
-```
-
-> **💡 Tip**: These two systems are **complementary, not competing**. Use both based on the situation!
-
-## File Naming
-
-```
-YYYY-MM-DD-[name].md
-```
-
-Examples:
-- `2025-01-27-auth-jwt.md`
-- `2025-01-27-payment-integration.md`
-
-## Security
-
-**All session files are automatically scrubbed before writing.**
-
-Scrubbed patterns include:
-- API keys (OpenAI, Anthropic, Stripe, GitHub, AWS)
-- Database URLs with credentials
-- JWT tokens
-- Password fields
-- Private keys
-
-## Usage
-
-```bash
-# Save current session
-/session-save auth-feature
-
-# Load most recent
-/session-load
-
-# Load specific session
-/session-load auth-feature
-
-# List available sessions
-/session-load --list
-```
-
-## Session File Format
-
-```markdown
-# Session: [name]
-Date: [timestamp]
-Duration: [messages]
-Security: [items scrubbed]
-
-## Context
-- Project: [name]
-- Branch: [branch]
-- Focus: [description]
-
-## Completed
-- [x] [task]
-
-## In Progress
-- [ ] [task] - [status]
-
-## Decisions Made
-- [decision]: [reasoning]
-
-## Next Steps
-1. [action]
-
-## Key Files
-- [file]: [why relevant]
-
-## Loaded Contexts
-- [type]: [status]
-
-## Learned Patterns
-- [pattern]
-```
-
-## Maintenance
-
-```bash
-# List sessions
-ls -la .claude/sessions/
-
-# Delete old sessions (>30 days)
-find .claude/sessions/ -mtime +30 -delete
-
-# Manual scrub (if needed)
-node scripts/scrub-secrets.js < session.md > clean.md
-# Installed path: node ~/.claude/scripts/scrub-secrets.js < session.md > clean.md
-```
-
-## Claude Built-in Session Commands
-
-In addition to custom `/session-save` and `/session-load`, Claude Code has built-in session features:
-
-| Command | Purpose |
-|---------|---------|
-| `claude -c` / `--continue` | Resume most recent session |
-| `claude -r "id"` / `--resume "id"` | Resume specific session by ID |
-| `claude --resume` | Show recent sessions to select |
-
-> **Note:** Built-in sessions are stored in `~/.claude/projects/.../*.jsonl`. Custom `/session-save` creates human-readable `.md` summaries in `.claude/sessions/`.
-
-## Best Practices
-
-1. Save after completing logical phases
-2. Save before long breaks (>4 hours)
-3. Use descriptive names
-4. Prune old sessions periodically
-5. **Ensure scripts are executable**: `chmod +x scripts/hooks/*.sh`  
-   (Installed path: `chmod +x ~/.claude/scripts/hooks/*.sh`)

package/.claude/skills/learned/README.ko.md

@@ -1,64 +0,0 @@
-# 학습된 패턴 데이터베이스 (Learned Patterns)
-
-이 디렉토리는 Claude Code 환경의 **장기 기억(Long-Term Memory)** 저장소입니다. `/learn` 명령어를 통해 추출된 반복적인 코딩 패턴, 아키텍처 결정 사항, 그리고 개인적인 코딩 스타일 선호도를 보관합니다.
-
-## 핵심 개념: 지식 순환 아키텍처
-
-1. **감지 (Detection)**: 작업 도중 반복되는 패턴이나 중요한 규칙을 발견합니다.
-2. **추출 (Extraction)**: `/learn` 명령어를 실행하여 해당 지식을 정형화합니다.
-3. **저장 (Persistence)**: 메타데이터가 포함된 마크다운 파일로 이 폴더에 저장됩니다.
-4. **부활 (Resurrection)**: 다음 세션이 시작될 때 Claude는 이 폴더를 인덱싱하여, **과거의 실수를 반복하지 않고 이미 결정된 규칙을 다시 묻지 않습니다.**
-
-## 사용 방법 및 실행
-
-### 1. 명시적 학습 (Manual Learning)
-기억해야 할 규칙이 생겼을 때 직접 입력합니다:
-`> /learn "API 에러 핸들링 시 항상 try-catch와 전역 로거를 사용해줘"`
-
-### 2. 세션 분석 (Session Analysis)
-복잡한 작업을 마친 후, Claude에게 패턴을 찾아내라고 시킵니다:
-`> /learn`
-Claude가 전체 대화 기록을 분석하여 저장할만한 패턴을 제안합니다.
-
-### 3. 목록 확인 (Management)
-`> /learn --show` (현재 저장된 모든 패턴 목록을 확인합니다.)
-
-## 분류 체계 및 저장 위치
-
-| 카테고리 | 저장 위치 | 용도 |
-| :--- | :--- | :--- |
-| **CONVENTION** | `.claude/rules/` | 구조적 규칙 (예: 폴더 구조, 네이밍 컨벤션) |
-| **PATTERN** | **이 폴더 (learned/)** | 재사용 가능한 로직 블록 (예: 인증 흐름, 에러 처리 패턴) |
-| **PREFERENCE** | `.claude/rules/` | 개인적 취향 (예: "나는 trailing comma를 선호함") |
-
-## 패턴 파일 구조
-
-모든 패턴 파일은 Claude가 읽기 최적화된 아래 형식을 따릅니다:
-
-```markdown
----
-name: api-response-format
-category: PATTERN
-tags: [api, nodejs, json]
----
-# 패턴: 표준 API 응답 형식
-
-## 문제점
-API 응답 형식이 일관되지 않아 프론트엔드에서 파싱 에러가 자주 발생함.
-
-## 해결책
-`src/types/api.ts`에 정의된 `BaseResponse` 인터페이스를 반드시 사용함.
-
-## 예시
-```typescript
-res.json({
-  success: true,
-  data: result,
-  error: null
-});
-```
-```
-
-## ⚠️ 주의 사항
-- **비밀번호/키 제외**: `/learn` 명령어 실행 시 `scrub-secrets.js`가 자동으로 작동하여 API 키나 토큰이 저장되지 않도록 검열합니다.
-- **프로젝트 컨텍스트**: 패턴은 사용자 홈 디렉토리에 저장되지만, Claude는 현재 프로젝트와 연관된 패턴을 우선적으로 인덱싱합니다.

package/.claude/skills/learned/README.md

@@ -1,64 +0,0 @@
-# Learned Patterns Database
-
-This directory serves as the **Long-Term Memory** for your Claude Code environment. It stores recurring patterns, specific architectural decisions, and coding style preferences extracted through the `/learn` command.
-
-## Core Concept: The Knowledge Cycle
-
-1. **Detection**: During a session, you (or the `Stop hook`) identify a reusable pattern.
-2. **Extraction**: You run `/learn` to formalize that insight.
-3. **Persistence**: The pattern is saved as a Markdown file with specific metadata.
-4. **Resurrection**: In future sessions, Claude automatically indexes these files, ensuring it doesn't repeat past mistakes or ask the same questions.
-
-## Usage & Implementation
-
-### 1. Manual Learning
-If you notice a convention you want to keep:
-`> /learn "Always use useServerSideProps for data fetching in /pages"`
-
-### 2. Session Analysis
-If you've just finished a complex task and want to extract the "how-to":
-`> /learn`
-Claude will analyze the transcript and propose patterns to save.
-
-### 3. Management
-`> /learn --show` (Lists all active patterns)
-
-## Categorization Logic
-
-| Category | Storage Target | Purpose |
-| :--- | :--- | :--- |
-| **CONVENTION** | `.claude/rules/` | Structural rules (e.g., Folder structure, Naming). |
-| **PATTERN** | **This folder** | Reusable logic blocks (e.g., Auth flow, Error handling). |
-| **PREFERENCE** | `.claude/rules/` | Personal taste (e.g., "I prefer trailing commas"). |
-
-## Pattern File Structure
-
-Every learned file follows this high-efficiency schema for LLM ingestion:
-
-```markdown
----
-name: auth-error-handling
-category: PATTERN
-tags: [auth, nextjs, security]
----
-# Pattern: Centralized Auth Error Handling
-
-## Problem
-Auth errors were being handled inconsistently across different API routes.
-
-## Solution
-Use the `handleAuthError` utility located in `src/utils/auth`.
-
-## Example
-```typescript
-try {
-  // ... auth logic
-} catch (e) {
-  return handleAuthError(e);
-}
-```
-```
-
-## ⚠️ Important Notes
-- **No Secrets**: The `/learn` command automatically triggers `scrub-secrets.js` to ensure no API keys or tokens are stored in the patterns.
-- **Project Specific**: While saved in your user home, these patterns are indexed based on project context.