PROJECT-COMMON-README-VERSION-UPDATE.yaml

# ===================================================================
# README 파일 버전 자동 업데이트 워크플로우
# ===================================================================
#
# 이 워크플로우는 deploy 브랜치로 푸시가 발생할 때 README.md 파일의
# 버전 정보를 version_manager.sh를 통해 가져와 자동으로 업데이트합니다.
#
# 작동 방식:
# 1. deploy 브랜치 푸시 시 트리거
# 2. version_manager.sh를 통해 최신 버전 정보 추출
# 3. README.md 파일의 버전 정보 업데이트
# 4. 변경사항 커밋 및 푸시
#
# ⚠️ README.md 파일 버전 표기 가이드라인:
#
# ✅ 지원되는 버전 표기 형식들:
# - ## 최신 버전 : v1.0.0 (2025-08-15)
# - ## 최신버전 : v1.0.0 (2025-08-15)
# - ## Current Version : v1.0.0 (2025-08-15)
# - ## Recent Version : v1.0.0 (2025-08-15)
# - ## Version : v1.0.0 (2025-08-15)
# - ## 버전 : v1.0.0 (2025-08-15)
#
# - 대소문자 구분 없음
# - 콜론(:) 앞뒤 공백 자유롭게 허용
# - "version", "버전", "최신", "current", "recent" 등의 키워드 포함 시 자동 인식
# - 주석 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->가 자동으로 추가됩니다.
#
# ❌ 지원되지 않는 형식 (에러 발생):
# - ## 최신 버전: v1.0.0** (마크다운 볼드 문자 사용 금지)
# - ## 최신 버전 v1.0.0 (콜론 누락)
# - 정규표현식 특수문자(*, [, ], ^, $) 포함된 버전 표기
#
# 🔧 환경변수 설정:
# - SHOW_DATE: 버전에 날짜 표시 여부 (true/false, 기본값: true)
#   * true: v1.0.0 (2025-08-16) 형식
#   * false: v1.0.0 형식
#
# ===================================================================

name: README VERSION UPDATE

# 환경변수 설정 - 사용자 맞춤 설정
env:
  # 버전에 날짜 표시 여부 (true/false)
  SHOW_DATE: true  # 🔧 이 값을 false로 변경하면 날짜가 표시되지 않습니다

on:
  push:
    branches: ["deploy"]

permissions:
  contents: write
  pull-requests: write

jobs:
  update-readme:
    name: README 버전 정보 업데이트
    runs-on: ubuntu-latest
    steps:
      - name: 저장소 체크아웃
        uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          fetch-depth: 0
          ref: ${{ github.event.repository.default_branch || 'main' }}

      - name: Git 설정
        run: |
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"

      - name: version_manager.sh를 통해 최신 버전 정보 가져오기
        id: version_info
        run: |
          # 버전 관리 스크립트에 실행 권한 부여
          chmod +x .github/scripts/version_manager.sh
          
          # version_manager.sh를 통해 최신 버전 가져오기
          LATEST_VERSION=$(.github/scripts/version_manager.sh get | tail -n 1)
          
          # 현재 날짜를 릴리즈 날짜로 사용
          RELEASE_DATE=$(date '+%Y-%m-%d')
          
          # 버전 정보 저장
          echo "latest_version=$LATEST_VERSION" >> $GITHUB_OUTPUT
          echo "release_date=$RELEASE_DATE" >> $GITHUB_OUTPUT

      - name: README.md 파일 버전 정보 업데이트
        run: |
          LATEST_VERSION="${{ steps.version_info.outputs.latest_version }}"
          RELEASE_DATE="${{ steps.version_info.outputs.release_date }}"
          SHOW_DATE="${{ env.SHOW_DATE }}"

          # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
          # 에러 메시지 출력 함수
          # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
          print_error_message() {
            local error_type="$1"
            local version_line="$2"
            local header_part="$3"
            local version_text="$4"

            echo ""
            echo "❌ README.md 버전 업데이트 실패"
            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
            echo ""
            echo "🔍 에러 유형: $error_type"
            echo ""
            echo "📋 진단 정보:"
            echo "   • 현재 버전 라인: $version_line"
            echo "   • 추출된 헤더: $header_part"
            echo "   • 새 버전 텍스트: $version_text"
            echo ""
            echo "💡 해결 방법:"
            echo "   README.md의 버전 표기가 아래 형식 중 하나와 일치하는지 확인하세요:"
            echo ""
            echo "   ✅ 지원되는 형식 예시:"
            echo "      • ## 최신 버전 : v1.0.0 (2025-08-15)"
            echo "      • ## 최신버전 : v1.0.0"
            echo "      • ## Version : v1.0.0"
            echo "      • ## Current Version : v1.0.0 (2025-08-15)"
            echo ""
            echo "   ⚠️ 주의사항:"
            echo "      • 마크다운 볼드(**) 문자 사용 금지"
            echo "      • 정규표현식 특수문자(*, [, ], ^, $) 사용 금지"
            echo "      • 콜론(:) 뒤에 버전 정보가 바로 와야 합니다"
            echo ""
            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
          }

          # 날짜 표시 여부에 따라 버전 형식 결정
          if [ "$SHOW_DATE" = "true" ]; then
            VERSION_TEXT="v${LATEST_VERSION} (${RELEASE_DATE})"
            echo "🗓️ 날짜 포함 버전 형식: $VERSION_TEXT"
          else
            VERSION_TEXT="v${LATEST_VERSION}"
            echo "📋 버전만 표시 형식: $VERSION_TEXT"
          fi

          # 다양한 버전 표기 패턴을 찾기 위한 정규표현식
          # 대소문자 무시, 공백 유연하게 처리
          VERSION_PATTERNS=(
            "^##[[:space:]]*최신[[:space:]]*버전[[:space:]]*:"
            "^##[[:space:]]*최신버전[[:space:]]*:"
            "^##[[:space:]]*[Cc]urrent[[:space:]]*[Vv]ersion[[:space:]]*:"
            "^##[[:space:]]*[Rr]ecent[[:space:]]*[Vv]ersion[[:space:]]*:"
            "^##[[:space:]]*[Vv]ersion[[:space:]]*:"
            "^##[[:space:]]*버전[[:space:]]*:"
            "^##[[:space:]]*[Ll]atest[[:space:]]*[Vv]ersion[[:space:]]*:"
          )

          # 버전 라인 찾기
          VERSION_LINE=""
          PATTERN_FOUND=""

          for pattern in "${VERSION_PATTERNS[@]}"; do
            if grep -qi "$pattern" README.md; then
              VERSION_LINE=$(grep -i "$pattern" README.md | head -n 1)
              PATTERN_FOUND="$pattern"
              echo "✅ 버전 패턴 발견: $VERSION_LINE"
              break
            fi
          done

          # 버전 라인이 없으면 기본 형식으로 추가
          if [ -z "$VERSION_LINE" ]; then
            echo "📝 버전 정보가 없어 새로 추가합니다"

            # 파일 맨 앞에 제목이 있는지 확인 후 그 다음에 추가
            if grep -q "^# " README.md; then
              # 첫 번째 제목 다음에 추가
              sed -i '/^# /a\\n<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## 최신 버전 : '"$VERSION_TEXT" README.md
            else
              # 파일 맨 앞에 추가
              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## 최신 버전 : '"$VERSION_TEXT"'\n' README.md
            fi
            echo "✅ 기본 버전 정보 추가 완료: $VERSION_TEXT"
          else
            # 기존 버전 라인 업데이트

            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            # 버전 라인 형식 검증 및 경고
            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            if [[ "$VERSION_LINE" =~ \*\* ]]; then
              echo ""
              echo "⚠️ 경고: 버전 라인에 마크다운 볼드(**) 문자가 포함되어 있습니다"
              echo "   현재 버전 라인: $VERSION_LINE"
              echo "   이로 인해 버전 업데이트가 실패할 수 있습니다"
              echo ""
            fi

            # HTML 주석이 해당 라인 위에 있는지 확인
            LINE_NUMBER=$(grep -n -i "$PATTERN_FOUND" README.md | head -n 1 | cut -d: -f1)
            PREV_LINE_NUMBER=$((LINE_NUMBER - 1))

            if [ $PREV_LINE_NUMBER -gt 0 ]; then
              PREV_LINE=$(sed -n "${PREV_LINE_NUMBER}p" README.md)
              if [[ "$PREV_LINE" != *"AUTO-VERSION-SECTION"* ]]; then
                # 주석이 없으면 버전 라인 위에 추가
                sed -i "${PREV_LINE_NUMBER}a\\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->" README.md
                echo "✅ 자동 업데이트 주석 추가 완료"
                # 주석 추가로 라인 번호가 변경됨
                LINE_NUMBER=$((LINE_NUMBER + 1))
              fi
            else
              # 첫 번째 라인이면 그 위에 추가
              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->' README.md
              echo "✅ 자동 업데이트 주석 추가 완료"
              # 주석 추가로 라인 번호가 변경됨
              LINE_NUMBER=$((LINE_NUMBER + 1))
            fi

            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            # 헤더 부분 추출 (콜론까지만 추출하여 안전하게 처리)
            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            HEADER_PART=$(echo "$VERSION_LINE" | sed 's/\(.*:\).*/\1 /')

            # 헤더 추출 실패 검증
            if [ -z "$HEADER_PART" ] || [[ "$HEADER_PART" == "$VERSION_LINE" ]]; then
              print_error_message "헤더 추출 실패 - 콜론(:)을 찾을 수 없습니다" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
              exit 1
            fi

            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            # 라인 번호 기반으로 직접 교체 (정규표현식 특수문자 문제 회피)
            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            NEW_LINE="${HEADER_PART}${VERSION_TEXT}"

            if ! sed -i "${LINE_NUMBER}s|.*|${NEW_LINE}|" README.md 2>/tmp/sed_error.log; then
              SED_ERROR=$(cat /tmp/sed_error.log 2>/dev/null || echo "알 수 없는 sed 오류")
              print_error_message "sed 명령어 실행 실패 - $SED_ERROR" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
              exit 1
            fi

            # 변경 결과 검증
            UPDATED_LINE=$(sed -n "${LINE_NUMBER}p" README.md)
            if [[ "$UPDATED_LINE" != *"$VERSION_TEXT"* ]]; then
              print_error_message "버전 정보 교체 검증 실패" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
              echo "   • 업데이트된 라인: $UPDATED_LINE"
              exit 1
            fi

            echo "✅ 버전 정보 업데이트 완료: $VERSION_TEXT"
          fi

      - name: 변경사항 커밋 및 푸시
        run: |
          DEFAULT_BRANCH="${{ github.event.repository.default_branch || 'main' }}"
          git add README.md

          if git diff --staged --quiet; then
            echo "📝 README.md에 변경사항이 없습니다"
          else
            REPO_NAME=$(basename "${{ github.repository }}")
            VERSION="${{ steps.version_info.outputs.latest_version }}"

            git commit -m "$REPO_NAME 버전 관리 : docs : v$VERSION README 버전 정보 업데이트 [skip ci]"

            # Race Condition 방지: pull-rebase 후 push (최대 3회 재시도)
            MAX_RETRIES=3
            RETRY_COUNT=0
            PUSH_SUCCESS=false

            while [ $RETRY_COUNT -lt $MAX_RETRIES ]; do
              RETRY_COUNT=$((RETRY_COUNT + 1))
              echo "🔄 Push 시도 $RETRY_COUNT/$MAX_RETRIES..."

              if git push origin HEAD:$DEFAULT_BRANCH; then
                PUSH_SUCCESS=true
                echo "✅ README.md 버전 정보 업데이트 완료"
                break
              else
                echo "⚠️ Push 실패, remote 변경사항 동기화 중..."

                if git pull --rebase origin $DEFAULT_BRANCH; then
                  echo "✅ Rebase 성공, 다시 push 시도..."
                else
                  echo "❌ Rebase 실패, 충돌 해결 필요"
                  git rebase --abort 2>/dev/null || true
                  exit 1
                fi
              fi
            done

            if [ "$PUSH_SUCCESS" = false ]; then
              echo "❌ $MAX_RETRIES회 시도 후에도 push 실패"
              exit 1
            fi
          fi