tylersong 1.0.5 → 1.0.7

package/.github/workflows/publish.yml

@@ -9,6 +9,10 @@ on:
     types: [completed]
     branches: [main]
 
+permissions:
+  contents: write
+  packages: write
+
 jobs:
   check-ci:
     name: Check CI Status
@@ -33,56 +37,135 @@ jobs:
             echo "success=true" >> $GITHUB_OUTPUT
           fi
 
-  version-check:
-    name: Check Version Changes
+  auto-version:
+    name: Auto Version Update
     runs-on: ubuntu-latest
     if: |
       (github.event_name == 'push' && github.ref == 'refs/heads/main') ||
-      startsWith(github.ref, 'refs/tags/v') ||
       (github.event_name == 'workflow_run' && needs.check-ci.outputs.ci-success == 'true')
     needs:
       - check-ci
     outputs:
-      should-publish: ${{ steps.version-check.outputs.should-publish }}
-      current-version: ${{ steps.version-check.outputs.current-version }}
+      should-publish: ${{ steps.version-update.outputs.should-publish }}
+      current-version: ${{ steps.version-update.outputs.current-version }}
+      version-updated: ${{ steps.version-update.outputs.version-updated }}
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
 
       - name: Setup Node.js environment
         uses: ./.github/actions/setup-runtime
         with:
           runtime: node
 
-      - name: Check version changes
-        id: version-check
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Auto version update and check
+        id: version-update
         run: |
           CURRENT_VERSION=$(node -p "require('./package.json').version")
           PUBLISHED_VERSION=$(npm view tylersong version 2>/dev/null || echo "0.0.0")
-
-          echo "current-version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          
           echo "Current version: $CURRENT_VERSION"
           echo "Published version: $PUBLISHED_VERSION"
 
-          # Tag push는 항상 배포
+          # Tag push는 항상 배포 (버전 체크만)
           if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
             echo "should-publish=true" >> $GITHUB_OUTPUT
-            echo "Tag push detected: will publish"
-          # main 브랜치는 버전이 다를 때만 배포
-          elif [ "$CURRENT_VERSION" != "$PUBLISHED_VERSION" ]; then
-            echo "should-publish=true" >> $GITHUB_OUTPUT
-            echo "Version changed: will publish"
+            echo "current-version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+            echo "version-updated=false" >> $GITHUB_OUTPUT
+            echo "Tag push detected: will publish without version update"
+            exit 0
+          fi
+
+          # 이미 같은 버전이 배포되어 있으면 자동으로 버전 업데이트
+          if [ "$CURRENT_VERSION" == "$PUBLISHED_VERSION" ]; then
+            echo "Same version exists, auto-updating version..."
+            
+            # 최근 커밋 메시지 분석하여 semantic versioning 적용
+            LAST_COMMIT_MSG=$(git log -1 --pretty=%B)
+            echo "Last commit: $LAST_COMMIT_MSG"
+            
+            # 커밋 메시지에 따라 버전 업데이트 타입 결정
+            if echo "$LAST_COMMIT_MSG" | grep -qE "BREAKING CHANGE|feat!|fix!"; then
+              VERSION_TYPE="major"
+            elif echo "$LAST_COMMIT_MSG" | grep -qE "^feat(\(.+\))?:"; then
+              VERSION_TYPE="minor" 
+            else
+              VERSION_TYPE="patch"
+            fi
+            
+            echo "Detected version type: $VERSION_TYPE"
+            
+            # package.json 버전 업데이트
+            npm version $VERSION_TYPE --no-git-tag-version
+            NEW_VERSION=$(node -p "require('./package.json').version")
+            
+            # TypeScript 소스 코드의 하드코딩된 버전도 업데이트
+            if [ -f "src/index.ts" ]; then
+              sed -i.bak "s/program\.version(\".*\")/program.version(\"$NEW_VERSION\")/g" src/index.ts
+              rm -f src/index.ts.bak
+            fi
+            
+            echo "Updated version to: $NEW_VERSION"
+            echo "current-version=$NEW_VERSION" >> $GITHUB_OUTPUT
+            echo "should-publish=true" >> $GITHUB_OUTPUT 
+            echo "version-updated=true" >> $GITHUB_OUTPUT
+            
+            # 변경사항 커밋 및 푸시
+            git add package.json package-lock.json src/index.ts
+            git commit -m "chore: bump version to v$NEW_VERSION [skip ci]"
+            git push origin main
+            
           else
-            echo "should-publish=false" >> $GITHUB_OUTPUT
-            echo "Version unchanged: skipping publish"
+            echo "Version already different: will publish"
+            echo "current-version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+            echo "should-publish=true" >> $GITHUB_OUTPUT
+            echo "version-updated=false" >> $GITHUB_OUTPUT
           fi
 
+  version-check:
+    name: Check Version Changes (for tags)
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    outputs:
+      should-publish: ${{ steps.version-check.outputs.should-publish }}
+      current-version: ${{ steps.version-check.outputs.current-version }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js environment  
+        uses: ./.github/actions/setup-runtime
+        with:
+          runtime: node
+
+      - name: Check version for tag
+        id: version-check
+        run: |
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "current-version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "should-publish=true" >> $GITHUB_OUTPUT
+          echo "Tag push detected: will publish"
+
   publish:
     name: Publish Package
     runs-on: ubuntu-latest
-    needs: [version-check]
-    if: needs.version-check.outputs.should-publish == 'true'
+    needs: [auto-version, version-check]
+    if: |
+      always() && 
+      (
+        (needs.auto-version.outputs.should-publish == 'true') ||
+        (needs.version-check.outputs.should-publish == 'true')
+      )
 
     steps:
       - name: Checkout code
@@ -126,7 +209,7 @@ jobs:
           script: |
             const { owner, repo } = context.repo;
             const tagName = context.ref.replace('refs/tags/', '');
-            const version = '${{ needs.version-check.outputs.current-version }}';
+            const version = '${{ needs.auto-version.outputs.current-version || needs.version-check.outputs.current-version }}';
 
             await github.rest.repos.createRelease({
               owner,
@@ -149,8 +232,13 @@ jobs:
   notify:
     name: Notification
     runs-on: ubuntu-latest
-    needs: [publish, version-check]
-    if: always() && needs.version-check.outputs.should-publish == 'true'
+    needs: [publish, auto-version, version-check]
+    if: |
+      always() && 
+      (
+        (needs.auto-version.outputs.should-publish == 'true') ||
+        (needs.version-check.outputs.should-publish == 'true')
+      )
 
     steps:
       - name: Checkout code
@@ -162,11 +250,11 @@ jobs:
           if [ "${{ needs.publish.result }}" == "success" ]; then
             echo "status=success" >> $GITHUB_OUTPUT
             echo "title=패키지 배포 성공 🚀" >> $GITHUB_OUTPUT
-            echo "description=tylersong v${{ needs.version-check.outputs.current-version }}이 NPM에 성공적으로 배포되었습니다!" >> $GITHUB_OUTPUT
+            echo "description=tylersong v${{ needs.auto-version.outputs.current-version || needs.version-check.outputs.current-version }}이 NPM에 성공적으로 배포되었습니다!" >> $GITHUB_OUTPUT
           else
             echo "status=failure" >> $GITHUB_OUTPUT
             echo "title=패키지 배포 실패 💥" >> $GITHUB_OUTPUT
-            echo "description=tylersong v${{ needs.version-check.outputs.current-version }} 배포 중 오류가 발생했습니다." >> $GITHUB_OUTPUT
+            echo "description=tylersong v${{ needs.auto-version.outputs.current-version || needs.version-check.outputs.current-version }} 배포 중 오류가 발생했습니다." >> $GITHUB_OUTPUT
           fi
 
       - name: Create fields JSON
@@ -177,7 +265,7 @@ jobs:
           [
             {
               "name": "버전",
-              "value": "v${{ needs.version-check.outputs.current-version }}",
+              "value": "v${{ needs.auto-version.outputs.current-version || needs.version-check.outputs.current-version }}",
               "inline": true
             },
             {
@@ -224,7 +312,7 @@ jobs:
       - name: Console output
         run: |
           if [ "${{ needs.publish.result }}" == "success" ]; then
-            echo "✅ Package v${{ needs.version-check.outputs.current-version }} published successfully!"
+            echo "✅ Package v${{ needs.auto-version.outputs.current-version || needs.version-check.outputs.current-version }} published successfully!"
             echo "📦 NPM: https://www.npmjs.com/package/tylersong"
           else
             echo "❌ Package publish failed!"

package/README.md

@@ -1,47 +1,99 @@
-# tylersong CLI
+# 📝 tylersong
 
-## 개요
+> 안녕하세요! 프론트엔드 개발자 **송민성**의 자기소개 CLI 도구입니다 ✨
 
-송민성의 개발자 프로필을 터미널에서 확인할 수 있는 TypeScript CLI 도구입니다.
+[![NPM Version](https://img.shields.io/npm/v/tylersong)](https://www.npmjs.com/package/tylersong)
+[![NPM Downloads](https://img.shields.io/npm/dm/tylersong)](https://www.npmjs.com/package/tylersong)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## 빠른 시작
+터미널에서 간단한 명령어로 개발자 프로필을 확인하고, GitHub 링크에 빠르게 접근할 수 있습니다.
+
+## 🚀 빠른 시작
+
+### 즉시 실행 (권장)
 
 ```bash
 npx tylersong
 ```
 
-## 문서
+### 전역 설치
 
-- **사용법**: [docs/usage.md](./docs/usage.md)
-- **배포 가이드**: [docs/deployment.md](./docs/deployment.md)
-- **워크플로우**: [docs/workflows.md](./docs/workflows.md)
-- **Discord 알림**: [docs/discord-setup.md](./docs/discord-setup.md)
-- **GitHub Actions 수정사항**: [docs/github-actions-fixes.md](./docs/github-actions-fixes.md)
+```bash
+npm install -g tylersong
+tylersong
+```
 
-## 개발
+## 💻 사용법
 
-### NPM 사용
+### 기본 실행
 
 ```bash
-npm install
-npm run dev
-npm run build
+tylersong
+# ✨ 저에 대해 궁금하신가요? 라는 질문에 답하면 프로필이 표시됩니다
 ```
 
-### Bun 사용 (더 빠른 성능!)
+### 명령어 옵션
 
 ```bash
-bun install
-bun run dev:bun      # TypeScript 직접 실행
-bun run build:bun    # bun 번들러로 빌드
-bun run src/index.ts # 소스 직접 실행
+tylersong --help          # 도움말 보기
+tylersong --version       # 버전 정보 확인
+tylersong --github        # GitHub 프로필 바로 열기
+tylersong -g              # GitHub 프로필 바로 열기 (단축)
+```
+
+## 🎨 스크린샷
+
+```
+      ╭───────────────────────────────────────────╮
+      │    🚀 Frontend Developer Profile 🚀      │
+      ╰───────────────────────────────────────────╯
+
+      👋 안녕하세요!
+      💻 프론트엔드 개발자 송민성입니다.
+
+      📌 Github: https://github.com/alstjd0051
+      ✉️  E-mail: wsc7202@gmail.com
+
+      💡 더 많은 정보는 --help를 통해 확인해주세요.
 ```
 
-## 버전 업데이트
+## 👨‍💻 개발자 정보
+
+- **이름**: 송민성 (Tyler Song)
+- **직업**: Frontend Developer
+- **GitHub**: [@alstjd0051](https://github.com/alstjd0051)
+- **Email**: wsc7202@gmail.com
+
+## 🛠️ 기술 스택
+
+이 CLI 도구는 다음 기술로 제작되었습니다:
+
+- **TypeScript** - 타입 안전성
+- **Node.js** - 크로스 플랫폼 실행
+- **Commander.js** - CLI 인터페이스
+- **Inquirer.js** - 대화형 프롬프트
+- **Chalk** - 터미널 색상 및 스타일링
+
+## 📦 패키지 정보
+
+- **크기**: 작고 가벼운 패키지 (~20KB)
+- **의존성**: 최소한의 검증된 의존성만 사용
+- **호환성**: Node.js 14+ 지원
+- **플랫폼**: Windows, macOS, Linux 모두 지원
+
+## 🤝 피드백 및 연락
+
+버그 리포트나 기능 제안은 언제든 환영합니다!
+
+- **GitHub Issues**: [npm_readMe/issues](https://github.com/alstjd0051/npm_readMe/issues)
+- **Email**: wsc7202@gmail.com
+
+## 📄 라이센스
+
+MIT License - 자유롭게 사용하세요!
 
-1. 버전 업데이트: `npm version patch` (또는 minor/major)
-2. 태그와 함께 GitHub에 푸시: `git push origin main --tags`
+---
 
-## 라이센스
+**Made with ❤️ by Tyler Song**
 
-MIT
+<!-- Last updated: $(date) -->

package/dist/index.js

@@ -11,7 +11,7 @@ const openUrl = (url) => {
             : "xdg-open";
     exec(`${command} ${url}`);
 };
-program.version("1.0.5").description("송민성의 개발자 프로필 CLI");
+program.version("1.0.7");
 program.option("-g, --github", "GitHub 프로필 열기");
 program.parse(process.argv);
 const options = program.opts();

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,WAAW,CAAC,kBAAkB,CAAC,CAAC;AAEzD,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;qBACC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;;OAEtC,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":";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;qBACC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;;OAEtC,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"}

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/direct-deployment.md

@@ -0,0 +1,116 @@
+# NPM 직접 배포 가이드
+
+## 🎯 개요
+
+이 문서는 GitHub Actions 태그 자동화 없이 NPM에 직접 배포하는 방법을 설명합니다.
+
+## 📋 사전 준비사항
+
+- NPM 계정 및 로그인
+- TypeScript 프로젝트 빌드 환경
+- 적절한 권한(패키지 소유자 또는 메인테이너)
+
+## 🚀 배포 단계
+
+### 1. 버전 업데이트
+
+```bash
+# 패치 버전 자동 증가 (1.0.4 → 1.0.5)
+npm version patch
+
+# 또는 마이너 버전 증가 (1.0.4 → 1.1.0)
+npm version minor
+
+# 또는 메이저 버전 증가 (1.0.4 → 2.0.0)
+npm version major
+```
+
+### 2. TypeScript 소스 코드 수정
+
+버전이 하드코딩된 경우 소스코드도 업데이트:
+
+```typescript
+// src/index.ts
+program.version("1.0.5").description("송민성의 개발자 프로필 CLI");
+```
+
+### 3. 프로젝트 빌드
+
+```bash
+# TypeScript 컴파일
+npm run build
+```
+
+### 4. NPM 로그인 확인
+
+```bash
+# 현재 로그인 상태 확인
+npm whoami
+
+# 로그인되지 않은 경우 로그인
+npm login
+```
+
+### 5. NPM 배포
+
+```bash
+# 패키지 배포
+npm publish
+```
+
+## ✅ 배포 성공 확인
+
+### 배포된 패키지 정보 확인
+
+```bash
+# 최신 버전 정보 확인
+npm view tylersong
+
+# 모든 버전 목록 확인
+npm view tylersong versions --json
+```
+
+### 패키지 설치 및 테스트
+
+```bash
+# 전역 설치
+npm install -g tylersong@latest
+
+# 실행 테스트
+tylersong
+```
+
+## 📦 배포 결과 (2024.08.04)
+
+### 성공적으로 배포된 버전: `1.0.5`
+
+- **배포 시간**: 방금 전 (just now)
+- **패키지 크기**: 21.0 kB
+- **압축 해제 크기**: 58.1 kB
+- **포함된 파일**: 19개
+- **메인테이너**: miiinsseong <wsc7202@gmail.com>
+
+### 전체 버전 히스토리
+
+```json
+["1.0.0", "1.0.1", "1.0.3", "1.0.4", "1.0.5"]
+```
+
+## 🔧 주요 변경사항 (v1.0.5)
+
+- ✨ JavaScript에서 TypeScript로 완전 변환
+- 📦 타입 정의 파일 포함 (`dist/index.d.ts`)
+- 🛠️ 자동 빌드 스크립트 (`prepublishOnly`)
+- 📚 상세한 문서화 완료
+
+## 💡 팁
+
+1. **자동 빌드**: `prepublishOnly` 스크립트가 설정되어 있어 배포 시 자동으로 빌드됩니다.
+2. **타입 안전성**: TypeScript로 변환되어 더 안정적인 코드가 되었습니다.
+3. **버전 관리**: 소스코드의 하드코딩된 버전도 함께 업데이트해야 합니다.
+
+## 🚨 주의사항
+
+- 같은 버전을 두 번 배포할 수 없습니다.
+- 배포 전 반드시 빌드와 테스트를 수행하세요.
+- NPM 로그인 상태를 확인하세요.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tylersong",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "나의 CLI 자기소개 도구",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -23,7 +23,7 @@ const openUrl = (url: string): void => {
   exec(`${command} ${url}`);
 };
 
-program.version("1.0.5").description("송민성의 개발자 프로필 CLI");
+program.version("1.0.7");
 
 program.option("-g, --github", "GitHub 프로필 열기");