claude-pro-minmax 1.0.2 → 1.2.0

package/README.ko.md

@@ -3,6 +3,7 @@
 <!-- Badges -->
 [![npm version](https://img.shields.io/npm/v/claude-pro-minmax.svg)](https://www.npmjs.com/package/claude-pro-minmax)
 [![npm downloads](https://img.shields.io/npm/dm/claude-pro-minmax.svg)](https://www.npmjs.com/package/claude-pro-minmax)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Compatible-purple.svg)
 ![Pro Plan](https://img.shields.io/badge/Pro_Plan-Optimized-green.svg)
@@ -27,73 +28,93 @@ CPMM은 모델 라우팅, 출력 제어, 로컬 안전장치로 리셋 전까지
 
 ## 🛠 설치 (Installation)
 
-### 1. 필수 도구 준비
+### 1. 설치 (권장)
 ```bash
-npm install -g @anthropic-ai/claude-code
-npm install -g @mixedbread/mgrep  # 선택, 권장: 출력 토큰 ~50% 절감
-mgrep install-claude-code
-brew install jq   # macOS (Linux: sudo apt-get install jq)
-brew install tmux # 선택: /watch 사용 시 필요 (Linux: sudo apt-get install tmux)
+npm install -g claude-pro-minmax@latest
+cpmm setup
+cpmm doctor
 ```
 
-### 2. npm / npx 설치 (권장)
+### 2. 업데이트
 ```bash
-npx claude-pro-minmax@latest install
+npm install -g claude-pro-minmax@latest
+cpmm setup
 ```
 
-전역 설치 후 실행:
+### 3. 트러블슈팅 (빠른 복구)
 ```bash
-npm install -g claude-pro-minmax
-cpmm install
+# 누락된 의존성 재설치
+cpmm setup
+
+# 상태 확인만
+cpmm doctor
 ```
 
-### 3. One-Line Install (curl)
+의존성 정책:
+- `required`: `jq`, `mgrep`, `tmux`
+- `optional` (확인만): `claude` (사전 설치 가정)
+- 자동 설치 지원: `npm` (mgrep), `brew` (macOS), Linux 패키지 매니저 `apt-get`, `dnf`, `pacman`, `apk`
+- macOS에서 Homebrew가 없으면 설치 명령을 안내합니다
+
+### 4. Perplexity/언어 설정 (선택)
+- 최초 인터랙티브 설치 시 `cpmm setup`이 출력 언어와 Perplexity API 키를 묻습니다.
+- 영어(기본): 파일이 필요 없습니다. `~/.claude/rules/language.md`가 있으면 삭제하세요.
+- 비영어: `~/.claude/rules/language.md`를 만들어 원하는 언어를 지정하세요.
+- Perplexity를 수동으로 설정하려면 `~/.claude.json`의 `mcpServers`에 아래를 추가하세요:
+
+```json
+"perplexity": {
+  "command": "npx",
+  "args": ["-y", "@perplexity-ai/mcp-server"],
+  "env": {
+    "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
+  }
+}
+```
+
+### 5. 고급 (선택)
+<details>
+<summary>수동 의존성 설치와 소스 설치 보기</summary>
+
+수동 의존성 설치:
 ```bash
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/move-hoon/claude-pro-minmax/main/install.sh)"
+# jq
+brew install jq                 # macOS
+sudo apt-get install -y jq      # Ubuntu/Debian
+sudo dnf install -y jq          # Fedora/RHEL
+sudo pacman -S --noconfirm jq   # Arch
+sudo apk add jq                 # Alpine
+
+# mgrep
+npm install -g @mixedbread/mgrep
+mgrep install-claude-code
+
+# tmux
+brew install tmux               # macOS
+sudo apt-get install -y tmux    # Ubuntu/Debian
+sudo dnf install -y tmux        # Fedora/RHEL
+sudo pacman -S --noconfirm tmux # Arch
+sudo apk add tmux               # Alpine
 ```
 
-### 4. Manual Install
+소스에서 수동 설치:
 ```bash
 git clone https://github.com/move-hoon/claude-pro-minmax.git
 cd claude-pro-minmax
-less install.sh
-bash install.sh
+node bin/cpmm.js setup
+# 고급/디버그 경로 (동일한 내부 설치기):
+# bash install.sh
 ```
 
-### 5. 설치 후 설정 (선택 사항)
-**설치 스크립트 실행 중 Perplexity API 키와 출력 언어를 선택합니다.**
-설치 시 언어를 건너뛰었다면 수동으로 설정할 수 있습니다:
-- **비영어:** `~/.claude/rules/language.md`를 생성하여 원하는 언어 지정
-- **영어 (기본값):** 파일 불필요. `~/.claude/rules/language.md`가 있으면 삭제
-
-Perplexity를 설치 시 건너뛰었다면 나중에 수동으로 설정할 수 있습니다:
-1. `~/.claude.json` 파일을 엽니다.
-2. `mcpServers` 객체 안에 다음 내용을 추가하세요:
-   ```json
-   "perplexity": {
-     "command": "npx",
-     "args": ["-y", "@perplexity-ai/mcp-server"],
-     "env": {
-       "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
-     }
-   }
-   ```
-
-> **함께 포함된 MCP 서버 (기본 활성화):**
-> - **Sequential Thinking**: 복잡한 로직 처리를 위한 강력한 추론 도구
-> - **Context7**: 고급 문서 조회 및 컨텍스트 관리 도구
-
-> **Note:** 설치 스크립트가 기존 `~/.claude` 설정을 자동으로 백업(`~/.claude-backup-{timestamp}`)합니다.
-
-### 6. 프로젝트 초기화
-> **Tip:** `claude` 실행 전, 이 저장소의 `project-templates/`를 참고해 프로젝트를 초기화하세요. (`install.sh`는 `project-templates`를 `~/.claude`로 복사하지 않습니다.)
-
-### 7. 설치 확인
-```bash
-npx claude-pro-minmax@latest doctor
-# 또는 (전역 설치한 경우)
-cpmm doctor
-```
+설치 동작:
+- `cpmm setup`은 누락된 의존성을 설치한 뒤, CPMM 설정(설정 파일 복사, 언어 선택, Perplexity 설정)까지 진행합니다.
+- `cpmm doctor`는 수정 없이 의존성 상태만 확인합니다.
+- 재실행 시 CPMM 관리 파일만 갱신하고, `language.md`, `settings.local.json`, `skills/learned/`, `sessions/` 등 사용자 파일은 보존합니다.
+
+프로젝트 초기화 팁:
+- `claude` 실행 전에 `project-templates/`를 참고해 프로젝트를 초기화하세요. (설치기는 `project-templates`를 `~/.claude`로 복사하지 않습니다.)
+
+</details>
 
 ---
 
@@ -237,10 +258,16 @@ claude-pro-minmax
 ├── .claude.json                # 글로벌 MCP 설정 (User Scope)
 ├── .claudeignore               # Claude 컨텍스트 제외 규칙
 ├── .gitignore                  # Git ignore 규칙
-├── install.sh                  # 원클릭 설치 스크립트
+├── CONTRIBUTING.md             # 기여 가이드
+├── install.sh                  # 핵심 설치 스크립트 (`cpmm setup`이 내부 호출)
 ├── LICENSE                     # MIT 라이선스
 ├── README.md                   # 영문 문서
 ├── README.ko.md                # 국문 문서
+├── package.json                # npm 패키지 매니페스트
+├── bin/                        # CPMM CLI 엔트리포인트
+│   ├── cpmm.js                 # `cpmm` 실행 진입점
+├── lib/                        # CPMM CLI 코어 구현
+│   └── cli.js                  # setup/doctor 명령 로직
 ├── .claude/
 │   ├── CLAUDE.md               # 핵심 지침 (모든 세션에 로드됨)
 │   ├── settings.json           # 프로젝트 설정 (권한, 훅, 환경변수)
@@ -386,7 +413,7 @@ A: 네, 하지만 이러한 최적화가 필요하지 않을 수 있습니다. M
 <details>
 <summary><strong>Q: 기존 Claude Code 설정과 충돌하나요?</strong></summary>
 
-A: `~/.claude/` 디렉토리를 덮어씁니다. 다만 `install.sh`가 교체 전에 `~/.claude-backup-{timestamp}`로 자동 백업합니다.
+A: 최초 `cpmm setup` 시 기존 `~/.claude`를 `~/.claude.pre-cpmm`으로 백업합니다. 재실행 시 CPMM 관리 파일만 갱신하고, 언어 설정·로컬 설정·학습된 패턴·세션 기록은 보존됩니다.
 </details>
 
 <details>

package/README.md

@@ -3,6 +3,7 @@
 <!-- Badges -->
 [![npm version](https://img.shields.io/npm/v/claude-pro-minmax.svg)](https://www.npmjs.com/package/claude-pro-minmax)
 [![npm downloads](https://img.shields.io/npm/dm/claude-pro-minmax.svg)](https://www.npmjs.com/package/claude-pro-minmax)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Compatible-purple.svg)
 ![Pro Plan](https://img.shields.io/badge/Pro_Plan-Optimized-green.svg)
@@ -27,73 +28,93 @@ CPMM helps Pro users complete more verified tasks before reset through model rou
 
 ## 🛠 Installation
 
-### 1. Prerequisites
+### 1. Install (Recommended)
 ```bash
-npm install -g @anthropic-ai/claude-code
-npm install -g @mixedbread/mgrep  # optional, recommended: ~50% output reduction
-mgrep install-claude-code
-brew install jq   # macOS (Linux: sudo apt-get install jq)
-brew install tmux # optional: required for /watch (Linux: sudo apt-get install tmux)
+npm install -g claude-pro-minmax@latest
+cpmm setup
+cpmm doctor
 ```
 
-### 2. npm / npx Install (Recommended)
+### 2. Update
 ```bash
-npx claude-pro-minmax@latest install
+npm install -g claude-pro-minmax@latest
+cpmm setup
 ```
 
-Or install globally:
+### 3. Troubleshooting (Quick)
 ```bash
-npm install -g claude-pro-minmax
-cpmm install
+# re-run setup to install any missing deps
+cpmm setup
+
+# check status only
+cpmm doctor
 ```
 
-### 3. One-Line Install (curl)
+Dependency policy:
+- `required`: `jq`, `mgrep`, `tmux`
+- `optional` (check only): `claude` (assumed pre-installed)
+- auto-install supports `npm` (mgrep), `brew` (macOS), and Linux package managers `apt-get`, `dnf`, `pacman`, `apk`
+- on macOS without Homebrew, setup prints the Homebrew install command
+
+### 4. Perplexity and Language (Optional)
+- On fresh interactive installs, `cpmm setup` asks for output language and Perplexity API key.
+- English (default): no file needed; remove `~/.claude/rules/language.md` if it exists.
+- Non-English: create `~/.claude/rules/language.md` with your preferred language.
+- To configure Perplexity manually, add this under `mcpServers` in `~/.claude.json`:
+
+```json
+"perplexity": {
+  "command": "npx",
+  "args": ["-y", "@perplexity-ai/mcp-server"],
+  "env": {
+    "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
+  }
+}
+```
+
+### 5. Advanced (Optional)
+<details>
+<summary>Show manual dependency setup and source install</summary>
+
+Manual dependency setup:
 ```bash
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/move-hoon/claude-pro-minmax/main/install.sh)"
+# jq
+brew install jq                 # macOS
+sudo apt-get install -y jq      # Ubuntu/Debian
+sudo dnf install -y jq          # Fedora/RHEL
+sudo pacman -S --noconfirm jq   # Arch
+sudo apk add jq                 # Alpine
+
+# mgrep
+npm install -g @mixedbread/mgrep
+mgrep install-claude-code
+
+# tmux
+brew install tmux               # macOS
+sudo apt-get install -y tmux    # Ubuntu/Debian
+sudo dnf install -y tmux        # Fedora/RHEL
+sudo pacman -S --noconfirm tmux # Arch
+sudo apk add tmux               # Alpine
 ```
 
-### 4. Manual Install
+Manual install from source:
 ```bash
 git clone https://github.com/move-hoon/claude-pro-minmax.git
 cd claude-pro-minmax
-less install.sh
-bash install.sh
+node bin/cpmm.js setup
+# advanced/debug path (same underlying installer):
+# bash install.sh
 ```
 
-### 5. Post-Install Configuration (Optional)
-**The installation script will ask for your Perplexity API Key and output language.**
-If you skipped language selection, you can configure it manually:
-- **Non-English:** Create `~/.claude/rules/language.md` with your preferred language
-- **English (default):** No file needed. Remove `~/.claude/rules/language.md` if it exists
-
-If you skipped Perplexity setup during installation, you can set it up manually:
-1. Open `~/.claude.json`.
-2. Add the following to the `mcpServers` object:
-   ```json
-   "perplexity": {
-     "command": "npx",
-     "args": ["-y", "@perplexity-ai/mcp-server"],
-     "env": {
-       "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
-     }
-   }
-   ```
-
-> **Other included MCP servers (Enabled by default):**
-> - **Sequential Thinking**: Powerful reasoning tool for complex logic.
-> - **Context7**: Advanced documentation fetching and context management.
-
-> **Note:** The installation script automatically backs up your existing `~/.claude` settings (`~/.claude-backup-{timestamp}`).
-
-### 6. Project Initialization
-> **Tip:** Before running `claude`, initialize your project by referencing templates in this repository's `project-templates/` directory. (`install.sh` does not copy `project-templates` into `~/.claude`.)
-
-### 7. Verify Installation
-```bash
-npx claude-pro-minmax@latest doctor
-# or (if installed globally)
-cpmm doctor
-```
+Install behavior:
+- `cpmm setup` installs missing dependencies, then configures CPMM (copies config files, language selection, Perplexity setup).
+- `cpmm doctor` checks dependency status without modifying anything.
+- Re-running `cpmm setup` updates CPMM-managed files in place and preserves user-owned files like `language.md`, `settings.local.json`, `skills/learned/`, and `sessions/`.
+
+Project initialization tip:
+- Before running `claude`, initialize your project with templates in `project-templates/` (not copied into `~/.claude`).
+
+</details>
 
 ---
 
@@ -237,10 +258,16 @@ claude-pro-minmax
 ├── .claude.json                # Global MCP Settings (User Scope)
 ├── .claudeignore               # Files excluded from Claude's context
 ├── .gitignore                  # Git ignore rules
-├── install.sh                  # One-click installation script
+├── CONTRIBUTING.md             # Contribution guide
+├── install.sh                  # Core installer (invoked by `cpmm setup`)
 ├── LICENSE                     # MIT License
 ├── README.md                   # English Documentation
 ├── README.ko.md                # Korean Documentation
+├── package.json                # npm package manifest
+├── bin/                        # CPMM CLI entrypoints
+│   ├── cpmm.js                 # `cpmm` executable entry
+├── lib/                        # CPMM CLI core implementation
+│   └── cli.js                  # setup/doctor command logic
 ├── .claude/
 │   ├── CLAUDE.md               # Core Instructions (Loaded in all sessions)
 │   ├── settings.json           # Project Settings (Permissions, hooks, env vars)
@@ -386,7 +413,7 @@ This configuration is specifically designed for the Pro Plan's 5-hour rolling re
 <details>
 <summary><strong>Q: Does it conflict with existing Claude Code settings?</strong></summary>
 
-A: It overwrites the `~/.claude/` directory, but `install.sh` automatically creates a backup as `~/.claude-backup-{timestamp}` before replacing it.
+A: On first `cpmm setup`, CPMM backs up your existing `~/.claude` to `~/.claude.pre-cpmm`. Re-running `cpmm setup` updates CPMM-managed files in place — your language settings, local config, learned patterns, and session history are preserved.
 </details>
 
 <details>

package/bin/cpmm.js

@@ -1,171 +1,5 @@
 #!/usr/bin/env node
 
-const fs = require("node:fs");
-const path = require("node:path");
-const os = require("node:os");
-const { spawnSync } = require("node:child_process");
+const { runCli } = require("../lib/cli");
 
-const pkg = require("../package.json");
-const argv = process.argv.slice(2);
-const command = argv[0] || "install";
-const installScript = path.resolve(__dirname, "..", "install.sh");
-const HOME = os.homedir();
-
-function printHelp() {
-  console.log(`CPMM CLI v${pkg.version}
-
-Usage:
-  cpmm install    Install CPMM to ~/.claude
-  cpmm doctor     Verify installation
-  cpmm --help     Show this help
-  cpmm --version  Show version
-`);
-}
-
-if (command === "--help" || command === "-h" || command === "help") {
-  printHelp();
-  process.exit(0);
-}
-
-if (command === "--version" || command === "-v" || command === "version") {
-  console.log(pkg.version);
-  process.exit(0);
-}
-
-if (process.platform === "win32") {
-  console.error(
-    "CPMM installer requires macOS/Linux. Windows users: use WSL (https://learn.microsoft.com/windows/wsl/install)"
-  );
-  process.exit(1);
-}
-
-if (command === "doctor") {
-  runDoctor();
-  process.exit(0);
-}
-
-if (!fs.existsSync(installScript)) {
-  console.error(`Install script not found: ${installScript}`);
-  process.exit(1);
-}
-
-if (command !== "install") {
-  console.error(`Unknown command: ${command}`);
-  printHelp();
-  process.exit(1);
-}
-
-const filteredEnv = buildFilteredEnv();
-const result = spawnSync("bash", [installScript], {
-  stdio: "inherit",
-  env: filteredEnv,
-});
-
-if (result.error) {
-  console.error(result.error.message);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 1);
-
-function buildFilteredEnv() {
-  const allowed = [
-    "PATH", "HOME", "SHELL", "USER", "TERM",
-    "LANG", "LC_ALL", "TMPDIR", "XDG_CONFIG_HOME",
-  ];
-  return Object.fromEntries(
-    allowed
-      .filter((k) => process.env[k] !== undefined)
-      .map((k) => [k, process.env[k]])
-  );
-}
-
-function checkFile(filePath) {
-  return fs.existsSync(filePath);
-}
-
-function checkExecutable(filePath) {
-  if (!fs.existsSync(filePath)) return false;
-  try {
-    fs.accessSync(filePath, fs.constants.X_OK);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function checkCli(name) {
-  const r = spawnSync("which", [name], { encoding: "utf8" });
-  return r.status === 0 && r.stdout.trim().length > 0;
-}
-
-function parseMcpServers() {
-  const claudeJson = path.join(HOME, ".claude.json");
-  if (!fs.existsSync(claudeJson)) return [];
-  try {
-    const data = JSON.parse(fs.readFileSync(claudeJson, "utf8"));
-    return Object.keys(data.mcpServers || {});
-  } catch {
-    return [];
-  }
-}
-
-function formatLine(symbol, label, note) {
-  const base = `  ${symbol} ${label}`;
-  return note ? base.padEnd(46) + note : base;
-}
-
-function runDoctor() {
-  const results = { pass: 0, fail: 0, warn: 0 };
-
-  function check(symbol, label, note) {
-    if (symbol === "✓") results.pass++;
-    else if (symbol === "✗") results.fail++;
-    else results.warn++;
-    console.log(formatLine(symbol, label, note));
-  }
-
-  function required(ok, label) {
-    check(ok ? "✓" : "✗", label, ok ? null : "(required — missing)");
-  }
-
-  function optional(ok, label, note) {
-    check(ok ? "✓" : "⚠", label, ok ? null : note);
-  }
-
-  console.log(`CPMM Doctor v${pkg.version}\n`);
-
-  console.log("Core Files:");
-  required(checkFile(`${HOME}/.claude/CLAUDE.md`), "~/.claude/CLAUDE.md");
-  required(checkFile(`${HOME}/.claude/settings.json`), "~/.claude/settings.json");
-
-  console.log("\nRules:");
-  required(checkFile(`${HOME}/.claude/rules/critical-actions.md`), "~/.claude/rules/critical-actions.md");
-  required(checkFile(`${HOME}/.claude/rules/security.md`), "~/.claude/rules/security.md");
-  required(checkFile(`${HOME}/.claude/rules/code-style.md`), "~/.claude/rules/code-style.md");
-  optional(checkFile(`${HOME}/.claude/rules/language.md`), "~/.claude/rules/language.md", "(optional)");
-
-  console.log("\nScripts:");
-  required(checkExecutable(`${HOME}/.claude/scripts/verify.sh`), "~/.claude/scripts/verify.sh");
-  required(checkExecutable(`${HOME}/.claude/scripts/runtime/detect.sh`), "~/.claude/scripts/runtime/detect.sh");
-
-  console.log("\nSkills:");
-  required(checkFile(`${HOME}/.claude/skills/`), "~/.claude/skills/");
-
-  const mcpServers = parseMcpServers();
-  console.log("\nMCP Servers:");
-  required(mcpServers.includes("context7"), "context7");
-  required(mcpServers.includes("sequential-thinking"), "sequential-thinking");
-  optional(mcpServers.includes("perplexity"), "perplexity", "(optional — set API key)");
-
-  console.log("\nCLI Tools:");
-  required(checkCli("claude"), "claude");
-  required(checkCli("jq"), "jq");
-  optional(checkCli("mgrep"), "mgrep", "(optional — npm install -g @mixedbread/mgrep)");
-  optional(checkCli("tmux"), "tmux", "(optional)");
-
-  const total = results.pass + results.fail + results.warn;
-  console.log(`\nResult: ${results.pass}/${total} passed, ${results.warn} optional skipped`);
-
-  if (results.fail > 0) process.exit(1);
-}
+process.exit(runCli(process.argv.slice(2)));