tylersong 1.0.9 → 1.0.11

package/dist/index.js

@@ -3,15 +3,37 @@ import inquirer from "inquirer";
 import chalk from "chalk";
 import { program } from "commander";
 import { exec } from "child_process";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+// package.json에서 버전 동적으로 읽기
+const getPackageVersion = () => {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packagePath = join(__dirname, "..", "package.json");
+        const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
+        return packageJson.version;
+    }
+    catch (error) {
+        console.error(chalk.red("⚠️  버전 정보를 읽을 수 없습니다."));
+        return "1.0.0";
+    }
+};
 const openUrl = (url) => {
     const command = process.platform === "win32"
         ? "start"
         : process.platform === "darwin"
             ? "open"
             : "xdg-open";
-    exec(`${command} ${url}`);
+    exec(`${command} ${url}`, (error) => {
+        if (error) {
+            console.error(chalk.red("❌ 브라우저를 열 수 없습니다."));
+            console.error(chalk.yellow(`수동으로 방문해주세요: ${url}`));
+        }
+    });
 };
-program.version("1.0.9");
+program.version(getPackageVersion());
 program.option("-g, --github", "GitHub 프로필 열기");
 program.parse(process.argv);
 const options = program.opts();
@@ -21,9 +43,10 @@ if (Object.keys(options).length > 0) {
     process.exit(0);
 }
 const main = async () => {
-    // 도움말 옵션 체크
-    if (process.argv.includes("--help")) {
-        console.log(chalk.yellow(`
+    try {
+        // 도움말 옵션 체크
+        if (process.argv.includes("--help")) {
+            console.log(chalk.yellow(`
       ╭───────────────────────────────╮
       │         사용 방법             │
       ├───────────────────────────────┤
@@ -35,36 +58,51 @@ const main = async () => {
       │   -h, --help     도움말       │
       ╰───────────────────────────────╯
     `));
-        process.exit(0);
-    }
-    // 사용자 질문
-    const answer = await inquirer.prompt([
-        {
-            type: "confirm",
-            name: "showInfo",
-            message: chalk.cyan("✨ 저에 대해 궁금하신가요?"),
-            default: true,
-        },
-    ]);
-    if (answer.showInfo) {
-        console.log(chalk.bold.cyan(`
+            process.exit(0);
+        }
+        // 사용자 질문
+        const answer = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "showInfo",
+                message: chalk.cyan("✨ 저에 대해 궁금하신가요?"),
+                default: true,
+            },
+        ]);
+        if (answer.showInfo) {
+            console.log(chalk.bold.cyan(`
       ╭───────────────────────────────────────────╮
       │    🚀 Developer Profile 🚀      │
       ╰───────────────────────────────────────────╯
       
       `) +
-            chalk.green(`👋 안녕하세요!
+                chalk.green(`👋 안녕하세요!
       💻 개발자 ${chalk.bold.yellow("송민성")}입니다.
 
       `) +
-            chalk.hex("#fef6e1")(`📌 Github: ${chalk.underline.whiteBright(`https://github.com/alstjd0051`)}
+                chalk.hex("#fef6e1")(`📌 Github: ${chalk.underline.whiteBright(`https://github.com/alstjd0051`)}
       `) +
-            chalk.blue(`✉️  E-mail: ${chalk.underline.whiteBright(`wsc7202@gmail.com`)}
+                chalk.blue(`✉️  E-mail: ${chalk.underline.whiteBright(`wsc7202@gmail.com`)}
       `) +
-            chalk.magenta(`
+                chalk.magenta(`
       💡 더 많은 정보는 ${chalk.bold("--help")}를 통해 확인해주세요.
       `));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("\n❌ 오류가 발생했습니다:"));
+        if (error instanceof Error) {
+            console.error(chalk.yellow(error.message));
+        }
+        else {
+            console.error(chalk.yellow("알 수 없는 오류가 발생했습니다."));
+        }
+        process.exit(1);
     }
 };
-main().catch(console.error);
+main().catch((error) => {
+    console.error(chalk.red("\n❌ 치명적인 오류가 발생했습니다:"));
+    console.error(error);
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAUrC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAQ,EAAE;IACpC,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;YAC/B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,UAAU,CAAC;IACjB,IAAI,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAEhD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,MAAM,OAAO,GAAmB,OAAO,CAAC,IAAI,EAAE,CAAC;AAE/C,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,YAAY;IACZ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC;;;;;;;;;;;KAWd,CAAC,CACD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,SAAS;IACT,MAAM,MAAM,GAAe,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC/C;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;YACtC,OAAO,EAAE,IAAI;SACd;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;OAKf,CAAC;YACA,KAAK,CAAC,KAAK,CAAC;eACL,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;;OAEhC,CAAC;YACA,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,WAAW,CAC5D,+BAA+B,CAChC;OACF,CAAC;YACA,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,SAAS,CAAC,WAAW,CACnD,mBAAmB,CACpB;OACF,CAAC;YACA,KAAK,CAAC,OAAO,CAAC;oBACF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;OACjC,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/docs/auto-deployment.md

@@ -0,0 +1,191 @@
+# 자동 배포 시스템 가이드
+
+## 🎯 개요
+이 시스템은 main 브랜치에 PR이 merge될 때 자동으로 버전을 업데이트하고 NPM에 배포하는 완전 자동화된 배포 시스템입니다.
+
+## 🚀 작동 방식
+
+### 1. 자동 트리거
+- **main 브랜치로의 PR merge**: CI 완료 후 자동 배포 시작
+- **main 브랜치로의 직접 push**: 즉시 자동 배포 시작
+- **태그 push**: 기존 태그 기반 배포 유지
+
+### 2. 자동 버전 결정 (Semantic Versioning)
+커밋 메시지를 분석하여 자동으로 버전 타입을 결정합니다:
+
+#### 🔴 Major 버전 (X.0.0)
+```bash
+# Breaking changes
+git commit -m "feat!: completely new API structure"
+git commit -m "fix!: remove deprecated method"
+git commit -m "feat: add new feature
+
+BREAKING CHANGE: This removes the old API"
+```
+
+#### 🟡 Minor 버전 (0.X.0)  
+```bash
+# New features
+git commit -m "feat: add user profile management"
+git commit -m "feat(auth): implement OAuth login"
+```
+
+#### 🟢 Patch 버전 (0.0.X)
+```bash
+# Bug fixes, docs, chores (default)
+git commit -m "fix: resolve login redirect issue"
+git commit -m "docs: update README"
+git commit -m "chore: update dependencies"
+git commit -m "style: fix code formatting"
+```
+
+### 3. 자동 실행 과정
+1. **CI 실행**: 테스트, 빌드, 린팅
+2. **버전 분석**: 현재 버전 vs NPM 배포 버전 비교
+3. **자동 버전 업데이트**: 필요 시 package.json 및 소스코드 버전 업데이트
+4. **자동 커밋**: 버전 업데이트 커밋 생성 및 푸시
+5. **빌드 및 배포**: TypeScript 빌드 후 NPM 배포
+6. **알림**: Discord 및 콘솔 알림
+
+## 📋 사전 설정 요구사항
+
+### 1. GitHub Secrets 설정
+```bash
+# NPM 토큰 설정 (필수)
+NPM_TOKEN=your_npm_token_here
+
+# Discord 알림 (선택사항)
+DISCORD_WEBHOOK_URL=your_discord_webhook_url
+```
+
+### 2. NPM 토큰 생성 방법
+1. [npmjs.com](https://www.npmjs.com)에 로그인
+2. Profile → Access Tokens → Generate New Token
+3. **Automation** 타입 선택
+4. 생성된 토큰을 GitHub Repository Settings → Secrets에 `NPM_TOKEN`으로 추가
+
+## 🎨 Conventional Commits 가이드
+
+### 기본 형식
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### 주요 타입들
+| 타입 | 설명 | 버전 영향 |
+|------|------|-----------|
+| `feat` | 새로운 기능 | Minor |
+| `fix` | 버그 수정 | Patch |
+| `docs` | 문서 변경 | Patch |
+| `style` | 코드 스타일 변경 | Patch |
+| `refactor` | 코드 리팩토링 | Patch |
+| `test` | 테스트 추가/수정 | Patch |
+| `chore` | 빌드/설정 변경 | Patch |
+| `!` | Breaking Change | Major |
+
+### 실제 예시
+```bash
+# 새 기능 추가 (Minor 버전 증가)
+git commit -m "feat: add interactive CLI menu"
+
+# 버그 수정 (Patch 버전 증가)  
+git commit -m "fix: resolve command parsing error"
+
+# Breaking Change (Major 버전 증가)
+git commit -m "feat!: redesign CLI interface"
+
+# 상세한 설명이 있는 커밋
+git commit -m "feat: add color themes
+
+- Add dark and light theme options
+- Implement theme persistence
+- Update help text with theme info"
+```
+
+## 🔧 워크플로우 파일 구성
+
+### 주요 작업들
+1. **check-ci**: CI 상태 확인
+2. **auto-version**: 자동 버전 업데이트 및 결정
+3. **version-check**: 태그 기반 배포용 버전 확인
+4. **publish**: NPM 배포 실행
+5. **notify**: 결과 알림
+
+### 트리거 조건
+```yaml
+on:
+  push:
+    branches: [main]        # main 브랜치 직접 push
+    tags: ["v*"]           # 태그 push
+  workflow_run:
+    workflows: ["Continuous Integration"]
+    types: [completed]      # CI 완료 후
+    branches: [main]
+```
+
+## 📊 배포 시나리오
+
+### 시나리오 1: 첫 PR merge
+```
+현재 NPM: v1.0.5
+현재 코드: v1.0.5
+→ 자동으로 v1.0.6으로 업데이트 후 배포
+```
+
+### 시나리오 2: 이미 다른 버전인 경우
+```
+현재 NPM: v1.0.5  
+현재 코드: v1.0.6
+→ 버전 업데이트 없이 v1.0.6 즉시 배포
+```
+
+### 시나리오 3: 태그 기반 배포
+```
+태그 push: v1.1.0
+→ 버전 체크만 하고 즉시 배포
+```
+
+## 🚨 주의사항
+
+### 1. 권한 설정
+- GitHub Actions에 repository write 권한 필요
+- NPM 토큰이 올바르게 설정되어야 함
+
+### 2. 커밋 메시지 규칙
+- Conventional Commits 형식 권장
+- 명확하고 일관된 메시지 작성
+
+### 3. CI/CD 최적화  
+- `[skip ci]` 태그로 무한 루프 방지
+- 버전 업데이트 커밋은 자동으로 CI 건너뛰기
+
+## 🎉 장점
+
+### ✅ 완전 자동화
+- 수동 버전 관리 불필요
+- 실수 방지 및 일관성 보장
+
+### ✅ Semantic Versioning 준수
+- 커밋 메시지 기반 자동 버전 결정
+- 표준화된 버전 관리
+
+### ✅ 실시간 알림
+- Discord 및 콘솔 배포 상태 알림
+- 성공/실패 즉시 확인
+
+## 🔍 디버깅
+
+### 로그 확인 위치
+- GitHub Actions → 해당 워크플로우 실행 → 각 작업 로그
+
+### 일반적인 문제들
+1. **NPM 토큰 오류**: Secrets 설정 확인
+2. **버전 충돌**: NPM에서 같은 버전 이미 배포됨
+3. **빌드 실패**: TypeScript 컴파일 오류 확인
+4. **권한 오류**: GitHub token 권한 확인
+
+이제 PR만 merge하면 자동으로 버전이 업데이트되고 NPM에 배포됩니다! 🚀

package/docs/deployment.md

@@ -0,0 +1,82 @@
+# 배포 가이드
+
+## CI/CD 파이프라인
+
+이 프로젝트는 모듈화된 GitHub Actions를 사용한 자동 배포 시스템을 구축했습니다.
+
+> 📖 **워크플로우 구조**: 자세한 내용은 [docs/workflows.md](./workflows.md)를 참고해주세요.
+
+### 트리거 조건
+
+#### 1. Pull Request
+
+- `main` 브랜치로의 PR 시 테스트와 빌드만 실행
+- Node.js와 Bun 두 환경에서 모두 테스트
+
+#### 2. Main 브랜치 Push
+
+- `main` 브랜치에 직접 push 시
+- 버전이 변경된 경우에만 NPM에 자동 배포
+- package.json의 버전과 NPM에 이미 배포된 버전을 비교
+
+#### 3. 태그 Push
+
+- `v*` 형태의 태그 push 시 무조건 NPM에 배포
+- 예: `v1.0.5`, `v2.1.0`
+
+### 배포 워크플로우
+
+```mermaid
+graph LR
+    A[Code Push] --> B{브랜치 확인}
+    B -->|main| C[버전 체크]
+    B -->|태그| F[즉시 배포]
+    C -->|변경됨| D[테스트 & 빌드]
+    C -->|동일함| E[배포 스킵]
+    D --> F[NPM 배포]
+```
+
+### 수동 배포 방법
+
+#### 1. 버전 업데이트 후 main 브랜치 배포
+
+```bash
+# 버전 업데이트
+npm version patch  # 또는 minor, major
+
+# main 브랜치에 push (자동 배포됨)
+git push origin main
+```
+
+#### 2. 태그를 통한 배포
+
+```bash
+# 버전 업데이트
+npm version patch
+
+# 태그와 함께 push (즉시 배포됨)
+git push origin main --tags
+```
+
+### 환경 변수 설정
+
+GitHub Repository Settings에서 다음 Secret을 설정해야 합니다:
+
+- `NPM_TOKEN`: NPM 계정의 액세스 토큰
+
+### 지원 런타임
+
+- **Node.js 20.x**: 메인 런타임
+- **Bun Latest**: 성능 테스트 및 대안 빌드
+
+### 빌드 산출물
+
+- TypeScript 컴파일된 JavaScript 파일들
+- 타입 정의 파일 (.d.ts)
+- 소스맵 파일
+
+### 주의사항
+
+1. **버전 관리**: package.json의 버전을 먼저 업데이트해야 배포됩니다
+2. **테스트 통과**: 모든 테스트가 통과해야 배포가 진행됩니다
+3. **권한**: NPM_TOKEN이 올바르게 설정되어야 합니다