tylersong 1.0.4 → 1.0.5

package/.github/actions/discord-notify/action.yml

@@ -0,0 +1,119 @@
+name: "Discord Notification"
+description: "Send notification to Discord webhook"
+
+inputs:
+  webhook-url:
+    description: "Discord webhook URL"
+    required: true
+  status:
+    description: "Status of the workflow (success, failure, cancelled)"
+    required: true
+  title:
+    description: "Notification title"
+    required: true
+  description:
+    description: "Notification description"
+    required: false
+    default: ""
+  color:
+    description: "Embed color (hex without #)"
+    required: false
+    default: "5865F2"
+  fields:
+    description: "Additional fields in JSON format"
+    required: false
+    default: "[]"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set color based on status
+      shell: bash
+      id: color
+      run: |
+        case "${{ inputs.status }}" in
+          success)
+            echo "color=00FF00" >> $GITHUB_OUTPUT
+            echo "emoji=✅" >> $GITHUB_OUTPUT
+            ;;
+          failure)
+            echo "color=FF0000" >> $GITHUB_OUTPUT
+            echo "emoji=❌" >> $GITHUB_OUTPUT
+            ;;
+          cancelled)
+            echo "color=FFA500" >> $GITHUB_OUTPUT
+            echo "emoji=⚠️" >> $GITHUB_OUTPUT
+            ;;
+          *)
+            echo "color=${{ inputs.color }}" >> $GITHUB_OUTPUT
+            echo "emoji=ℹ️" >> $GITHUB_OUTPUT
+            ;;
+        esac
+
+    - name: Send Discord notification
+      shell: bash
+      env:
+        WEBHOOK_URL: ${{ inputs.webhook-url }}
+        STATUS: ${{ inputs.status }}
+        TITLE: ${{ inputs.title }}
+        DESCRIPTION: ${{ inputs.description }}
+        COLOR: ${{ steps.color.outputs.color }}
+        EMOJI: ${{ steps.color.outputs.emoji }}
+        FIELDS: ${{ inputs.fields }}
+      run: |
+        # 16진수 색상을 10진수로 변환
+        COLOR_DEC=$((16#$COLOR))
+
+        # 안전한 JSON 페이로드 생성 (임시 파일 사용)
+        TEMP_FILE=$(mktemp)
+
+        # 기본 구조 생성
+        jq -n \
+          --arg emoji "$EMOJI" \
+          --arg title "$TITLE" \
+          --arg description "$DESCRIPTION" \
+          --argjson color "$COLOR_DEC" \
+          '{
+            embeds: [{
+              title: ($emoji + " " + $title),
+              description: $description,
+              color: $color,
+              footer: {
+                text: "GitHub Actions",
+                icon_url: "https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png"
+              },
+              timestamp: (now | strftime("%Y-%m-%dT%H:%M:%S.000Z"))
+            }]
+          }' > "$TEMP_FILE"
+
+        # fields가 비어있지 않으면 추가
+        if [ "$FIELDS" != "[]" ] && [ -n "$FIELDS" ]; then
+          jq --argjson fields "$FIELDS" '.embeds[0].fields = $fields' "$TEMP_FILE" > "${TEMP_FILE}.tmp" && mv "${TEMP_FILE}.tmp" "$TEMP_FILE"
+        fi
+
+        # Discord 웹훅으로 전송 (디버그 정보 포함)
+        echo "Sending payload:"
+        cat "$TEMP_FILE"
+        echo ""
+
+        RESPONSE=$(curl -s -w "%{http_code}" -H "Content-Type: application/json" \
+                       -d @"$TEMP_FILE" \
+                       "$WEBHOOK_URL")
+
+        HTTP_CODE="${RESPONSE: -3}"
+        RESPONSE_BODY="${RESPONSE%???}"
+
+        echo "HTTP Status: $HTTP_CODE"
+        echo "Response: $RESPONSE_BODY"
+
+        # 임시 파일 정리
+        rm -f "$TEMP_FILE"
+
+        # 상태 코드 확인
+        if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ]; then
+          echo "✅ Discord 알림 전송 성공"
+        else
+          echo "❌ Discord 알림 전송 실패: HTTP $HTTP_CODE"
+          echo "Response: $RESPONSE_BODY"
+          exit 1
+        fi

package/.github/actions/setup-runtime/action.yml

@@ -0,0 +1,41 @@
+name: "Setup Runtime Environment"
+description: "Setup Node.js or Bun runtime with dependencies"
+
+inputs:
+  runtime:
+    description: "Runtime to setup (node or bun)"
+    required: true
+  node-version:
+    description: "Node.js version"
+    required: false
+    default: "20.x"
+  bun-version:
+    description: "Bun version"
+    required: false
+    default: "latest"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup Node.js
+      if: inputs.runtime == 'node'
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: "npm"
+
+    - name: Setup Bun
+      if: inputs.runtime == 'bun'
+      uses: oven-sh/setup-bun@v1
+      with:
+        bun-version: ${{ inputs.bun-version }}
+
+    - name: Install dependencies (Node.js)
+      if: inputs.runtime == 'node'
+      shell: bash
+      run: npm ci
+
+    - name: Install dependencies (Bun)
+      if: inputs.runtime == 'bun'
+      shell: bash
+      run: bun install

package/.github/workflows/ci.yml

@@ -0,0 +1,176 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        runtime: [node, bun]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup runtime environment
+        uses: ./.github/actions/setup-runtime
+        with:
+          runtime: ${{ matrix.runtime }}
+
+      - name: Run tests (Node.js)
+        if: matrix.runtime == 'node'
+        run: npm test
+
+      - name: Run tests (Bun)
+        if: matrix.runtime == 'bun'
+        run: bun test || echo "No bun tests specified"
+
+      - name: Test CLI functionality (Node.js)
+        if: matrix.runtime == 'node'
+        run: |
+          npm run build
+          node dist/index.js --version
+          node dist/index.js --help
+
+      - name: Test CLI functionality (Bun)
+        if: matrix.runtime == 'bun'
+        run: |
+          bun run build:bun
+          bun run dist/index.js --version
+          bun run dist/index.js --help
+
+  build:
+    name: Build & Upload Artifacts
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js environment
+        uses: ./.github/actions/setup-runtime
+        with:
+          runtime: node
+
+      - name: Build TypeScript
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-files-${{ github.sha }}
+          path: dist/
+          retention-days: 30
+
+      - name: Upload type definitions
+        uses: actions/upload-artifact@v4
+        with:
+          name: types-${{ github.sha }}
+          path: |
+            dist/*.d.ts
+            dist/*.d.ts.map
+          retention-days: 30
+
+  lint:
+    name: Code Quality
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js environment
+        uses: ./.github/actions/setup-runtime
+        with:
+          runtime: node
+
+      - name: Check TypeScript compilation
+        run: npx tsc --noEmit
+
+      - name: Check code formatting (if prettier is added)
+        run: echo "Add prettier check here if needed"
+
+      - name: Security audit
+        run: npm audit --audit-level=moderate
+
+  notify:
+    name: Notify Results
+    runs-on: ubuntu-latest
+    needs: [test, build, lint]
+    if: always()
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Determine overall status
+        id: status
+        run: |
+          if [ "${{ needs.test.result }}" == "success" ] && [ "${{ needs.build.result }}" == "success" ] && [ "${{ needs.lint.result }}" == "success" ]; then
+            echo "status=success" >> $GITHUB_OUTPUT
+            echo "title=CI 성공 🎉" >> $GITHUB_OUTPUT
+            echo "description=모든 테스트, 빌드, 린팅이 성공적으로 완료되었습니다." >> $GITHUB_OUTPUT
+          else
+            echo "status=failure" >> $GITHUB_OUTPUT
+            echo "title=CI 실패 💥" >> $GITHUB_OUTPUT
+            echo "description=CI 파이프라인에서 오류가 발생했습니다. 로그를 확인해주세요." >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create fields JSON
+        id: fields
+        run: |
+          FIELDS=$(cat << EOF
+          [
+            {
+              "name": "브랜치",
+              "value": "${{ github.ref_name }}",
+              "inline": true
+            },
+            {
+              "name": "커밋",
+              "value": "[\`${GITHUB_SHA:0:7}\`](https://github.com/${{ github.repository }}/commit/${{ github.sha }})",
+              "inline": true
+            },
+            {
+              "name": "테스트",
+              "value": "${{ needs.test.result == 'success' && '✅ 성공' || '❌ 실패' }}",
+              "inline": true
+            },
+            {
+              "name": "빌드",
+              "value": "${{ needs.build.result == 'success' && '✅ 성공' || '❌ 실패' }}",
+              "inline": true
+            },
+            {
+              "name": "린팅",
+              "value": "${{ needs.lint.result == 'success' && '✅ 성공' || '❌ 실패' }}",
+              "inline": true
+            },
+            {
+              "name": "작업자",
+              "value": "${{ github.actor }}",
+              "inline": true
+            }
+          ]
+          EOF
+          )
+          echo "fields<<EOF" >> $GITHUB_OUTPUT
+          echo "$FIELDS" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Send Discord notification
+        uses: ./.github/actions/discord-notify
+        with:
+          webhook-url: ${{ secrets.DISCORD_WEBHOOK_URL }}
+          status: ${{ steps.status.outputs.status }}
+          title: ${{ steps.status.outputs.title }}
+          description: ${{ steps.status.outputs.description }}
+          fields: ${{ steps.fields.outputs.fields }}

package/.github/workflows/publish.yml

@@ -0,0 +1,232 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  workflow_run:
+    workflows: ["Continuous Integration"]
+    types: [completed]
+    branches: [main]
+
+jobs:
+  check-ci:
+    name: Check CI Status
+    runs-on: ubuntu-latest
+    if: always()
+    outputs:
+      ci-success: ${{ steps.ci-check.outputs.success }}
+
+    steps:
+      - name: Check CI workflow status
+        id: ci-check
+        run: |
+          if [ "${{ github.event_name }}" == "workflow_run" ]; then
+            if [ "${{ github.event.workflow_run.conclusion }}" == "success" ]; then
+              echo "success=true" >> $GITHUB_OUTPUT
+            else
+              echo "success=false" >> $GITHUB_OUTPUT
+              exit 1
+            fi
+          else
+            # For push and tag events, assume CI will run or has run
+            echo "success=true" >> $GITHUB_OUTPUT
+          fi
+
+  version-check:
+    name: Check Version Changes
+    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 }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js environment
+        uses: ./.github/actions/setup-runtime
+        with:
+          runtime: node
+
+      - name: Check version changes
+        id: version-check
+        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는 항상 배포
+          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"
+          else
+            echo "should-publish=false" >> $GITHUB_OUTPUT
+            echo "Version unchanged: skipping publish"
+          fi
+
+  publish:
+    name: Publish Package
+    runs-on: ubuntu-latest
+    needs: [version-check]
+    if: needs.version-check.outputs.should-publish == 'true'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js for publishing
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          registry-url: "https://registry.npmjs.org/"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build for publishing
+        run: npm run build
+
+      - name: Verify build artifacts
+        run: |
+          ls -la dist/
+          test -f dist/index.js || (echo "Build artifact missing!" && exit 1)
+
+      - name: Publish to NPM (Dry Run)
+        if: github.event_name == 'pull_request'
+        run: npm publish --dry-run
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to NPM
+        if: github.event_name != 'pull_request'
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const { owner, repo } = context.repo;
+            const tagName = context.ref.replace('refs/tags/', '');
+            const version = '${{ needs.version-check.outputs.current-version }}';
+
+            await github.rest.repos.createRelease({
+              owner,
+              repo,
+              tag_name: tagName,
+              name: `Release v${version}`,
+              body: `🚀 **tylersong CLI v${version}**
+
+            ### 설치
+            \`\`\`bash
+            npx tylersong
+            \`\`\`
+
+            ### 변경사항
+            이 릴리스의 전체 변경사항은 [커밋 히스토리](https://github.com/${owner}/${repo}/commits/v${version})를 확인해주세요.`,
+              draft: false,
+              prerelease: false
+            });
+
+  notify:
+    name: Notification
+    runs-on: ubuntu-latest
+    needs: [publish, version-check]
+    if: always() && needs.version-check.outputs.should-publish == 'true'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Determine publish status
+        id: status
+        run: |
+          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
+          else
+            echo "status=failure" >> $GITHUB_OUTPUT
+            echo "title=패키지 배포 실패 💥" >> $GITHUB_OUTPUT
+            echo "description=tylersong v${{ needs.version-check.outputs.current-version }} 배포 중 오류가 발생했습니다." >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create fields JSON
+        id: fields
+        run: |
+          RELEASE_TYPE="${{ startsWith(github.ref, 'refs/tags/v') && 'Tag Release' || 'Auto Deploy' }}"
+          FIELDS=$(cat << EOF
+          [
+            {
+              "name": "버전",
+              "value": "v${{ needs.version-check.outputs.current-version }}",
+              "inline": true
+            },
+            {
+              "name": "배포 타입",
+              "value": "$RELEASE_TYPE",
+              "inline": true
+            },
+            {
+              "name": "브랜치/태그",
+              "value": "${{ github.ref_name }}",
+              "inline": true
+            },
+            {
+              "name": "NPM",
+              "value": "[tylersong 패키지](https://www.npmjs.com/package/tylersong)",
+              "inline": false
+            },
+            {
+              "name": "설치 명령어",
+              "value": "\`npx tylersong\`",
+              "inline": false
+            },
+            {
+              "name": "배포자",
+              "value": "${{ github.actor }}",
+              "inline": true
+            }
+          ]
+          EOF
+          )
+          echo "fields<<EOF" >> $GITHUB_OUTPUT
+          echo "$FIELDS" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Send Discord notification
+        uses: ./.github/actions/discord-notify
+        with:
+          webhook-url: ${{ secrets.DISCORD_WEBHOOK_URL }}
+          status: ${{ steps.status.outputs.status }}
+          title: ${{ steps.status.outputs.title }}
+          description: ${{ steps.status.outputs.description }}
+          fields: ${{ steps.fields.outputs.fields }}
+
+      - name: Console output
+        run: |
+          if [ "${{ needs.publish.result }}" == "success" ]; then
+            echo "✅ Package v${{ needs.version-check.outputs.current-version }} published successfully!"
+            echo "📦 NPM: https://www.npmjs.com/package/tylersong"
+          else
+            echo "❌ Package publish failed!"
+            exit 1
+          fi

package/README.md

@@ -1,7 +1,47 @@
-# 버전 업데이트
+# tylersong CLI
 
-`npm version patch` # 또는 minor/major
+## 개요
 
-# 태그와 함께 GitHub에 푸시
+송민성의 개발자 프로필을 터미널에서 확인할 수 있는 TypeScript CLI 도구입니다.
 
-`git push origin main --tags`
+## 빠른 시작
+
+```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)
+
+## 개발
+
+### NPM 사용
+
+```bash
+npm install
+npm run dev
+npm run build
+```
+
+### Bun 사용 (더 빠른 성능!)
+
+```bash
+bun install
+bun run dev:bun      # TypeScript 직접 실행
+bun run build:bun    # bun 번들러로 빌드
+bun run src/index.ts # 소스 직접 실행
+```
+
+## 버전 업데이트
+
+1. 버전 업데이트: `npm version patch` (또는 minor/major)
+2. 태그와 함께 GitHub에 푸시: `git push origin main --tags`
+
+## 라이센스
+
+MIT