Release Management Workflow

on:
  push:
    branches: [main]    # Automatic on main branch changes
  workflow_dispatch:    # Manual trigger capability

permissions:
  contents: write       # Repository content and tags
  pull-requests: write  # Release PR management

env:
  RELEASE_TYPE: 'simple'  # Non-library project versioning

# Ensure repository is properly initialized
- name: Check initialization status
  run: |
    if [ ! -f ".github/workflow.env" ]; then
      echo "::warning::Repository not initialized - skipping release"
      exit 0
    fi

    # Verify upstream configuration for correlation
    source .github/workflow.env
    if [ -z "$UPSTREAM_REPO_URL" ]; then
      echo "::warning::Upstream repository not configured"
    fi

- name: Run Release Please
  uses: googleapis/release-please-action@v4
  with:
    release-type: simple
    package-name: ${{ github.event.repository.name }}

    # Comprehensive changelog configuration
    changelog-types: |
      [
        {"type": "feat", "section": "🚀 Features", "hidden": false},
        {"type": "fix", "section": "🐛 Bug Fixes", "hidden": false},
        {"type": "perf", "section": "⚡ Performance Improvements", "hidden": false},
        {"type": "revert", "section": "🔄 Reverts", "hidden": false},
        {"type": "docs", "section": "📚 Documentation", "hidden": false},
        {"type": "style", "section": "💎 Style", "hidden": false},
        {"type": "refactor", "section": "♻️ Code Refactoring", "hidden": false},
        {"type": "test", "section": "🧪 Tests", "hidden": false},
        {"type": "build", "section": "🏗️ Build System", "hidden": false},
        {"type": "ci", "section": "🤖 CI/CD", "hidden": false},
        {"type": "chore", "section": "🧹 Miscellaneous", "hidden": false},
        {"type": "upstream", "section": "⬆️ Upstream Updates", "hidden": false}
      ]

    # Release PR configuration
    pull-request-title-pattern: "chore: release ${version}"
    version-file: "version.txt"

- name: Get upstream version correlation
  if: steps.release.outputs.release_created
  run: |
    # Source repository configuration
    source .github/workflow.env

    # Configure upstream remote
    if ! git remote | grep -q upstream; then
      git remote add upstream "$UPSTREAM_REPO_URL"
    fi

    # Fetch latest upstream tags
    git fetch upstream --tags --quiet

    # Determine latest upstream version
    UPSTREAM_VERSION=$(git describe --tags --abbrev=0 upstream/main 2>/dev/null || echo "unknown")
    UPSTREAM_VERSION=${UPSTREAM_VERSION#v}  # Remove 'v' prefix

    echo "upstream_version=$UPSTREAM_VERSION" >> $GITHUB_OUTPUT
    echo "Detected upstream version: $UPSTREAM_VERSION"

- name: Create upstream-correlated tag
  if: steps.release.outputs.release_created
  run: |
    RELEASE_TAG="${{ steps.release.outputs.tag_name }}"
    UPSTREAM_VERSION="${{ steps.get-upstream.outputs.upstream_version }}"

    # Create comprehensive correlation tag
    CORRELATED_TAG="${RELEASE_TAG}-upstream-${UPSTREAM_VERSION}"

    # Tag the release commit with correlation
    git tag "$CORRELATED_TAG" "${{ github.sha }}"
    git push origin "$CORRELATED_TAG"

    echo "Created correlated tag: $CORRELATED_TAG"

- name: Update release with upstream correlation
  if: steps.release.outputs.release_created
  uses: actions/github-script@v7
  with:
    script: |
      const releaseId = ${{ steps.release.outputs.id }};
      const upstreamVersion = '${{ steps.get-upstream.outputs.upstream_version }}';
      const correlatedTag = '${{ steps.create-tag.outputs.correlated_tag }}';

      // Get current release data
      const { data: release } = await github.rest.repos.getRelease({
        owner: context.repo.owner,
        repo: context.repo.repo,
        release_id: releaseId
      });

      // Enhance with upstream correlation information
      const enhancedBody = release.body + `

      ## 📌 Upstream Correlation

      - **Upstream Version**: \`${upstreamVersion}\`
      - **Correlated Tag**: \`${correlatedTag}\`
      - **Upstream Repository**: ${{ env.UPSTREAM_REPO_URL }}

      This release includes all changes from upstream version ${upstreamVersion}.
      `;

      // Update the GitHub release
      await github.rest.repos.updateRelease({
        owner: context.repo.owner,
        repo: context.repo.repo,
        release_id: releaseId,
        body: enhancedBody
      });

- name: Validate commit history for releases
  run: |
    COMMITS=$(git log --format=%s ${{ github.event.before }}..${{ github.sha }})
    if ! echo "$COMMITS" | grep -qE '^(feat|fix|perf|revert)(\(.+\))?!?:'; then
      echo "::notice::No releasable commits found - skipping release"
      echo "Commits must use 'feat:', 'fix:', 'perf:', or 'revert:' for releases"
    fi

- name: Handle upstream fetch failures gracefully
  continue-on-error: true
  run: |
    if ! git fetch upstream --tags --timeout=30; then
      echo "::warning::Could not fetch upstream tags - using fallback"
      echo "upstream_version=unavailable" >> $GITHUB_OUTPUT
    fi

- name: Resolve release PR conflicts automatically
  if: steps.release.outputs.pr && steps.release.outputs.pr_has_conflicts
  run: |
    # Checkout release PR branch
    gh pr checkout ${{ steps.release.outputs.pr }}

    # Attempt automatic rebase
    git pull origin main --rebase

    # Force push if successful
    git push --force-with-lease

- name: Validate release integrity
  if: steps.release.outputs.release_created
  run: |
    # Verify tag creation
    git fetch --tags
    if ! git tag -l | grep -q "^${{ steps.release.outputs.tag_name }}$"; then
      echo "::error::Release tag not found after creation"
      exit 1
    fi

    # Verify changelog update
    if ! git diff HEAD^ HEAD -- CHANGELOG.md | grep -q "+## "; then
      echo "::warning::Changelog may not have been updated properly"
    fi

    # Verify version file update
    if [ -f "version.txt" ]; then
      if ! grep -q "${{ steps.release.outputs.version }}" version.txt; then
        echo "::warning::Version file not updated correctly"
      fi
    fi

- name: Optimize execution based on change detection
  run: |
    # Skip if no commits since last release
    LAST_RELEASE=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
    if [ -n "$LAST_RELEASE" ]; then
      CHANGES=$(git rev-list --count $LAST_RELEASE..HEAD)
      if [ "$CHANGES" -eq 0 ]; then
        echo "::notice::No commits since last release - skipping"
        exit 0
      fi
    fi

- name: Cache Release Please data
  uses: actions/cache@v4
  with:
    path: |
      .release-please/
      .release-please-manifest.json
    key: release-please-${{ github.ref }}-${{ hashFiles('**/*.md', '**/*.json') }}
    restore-keys: |
      release-please-${{ github.ref }}-
      release-please-

- name: Collect comprehensive release metrics
  if: steps.release.outputs.release_created
  run: |
    # Calculate time since last release
    LAST_RELEASE_DATE=$(git log -1 --format=%ai $(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo HEAD))
    DAYS_SINCE_RELEASE=$(( ($(date +%s) - $(date -d "$LAST_RELEASE_DATE" +%s)) / 86400 ))

    # Count commits included in release
    LAST_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
    COMMIT_COUNT=$(git rev-list --count ${LAST_TAG:+$LAST_TAG..}HEAD)

    # Categorize changes by type
    FEAT_COUNT=$(git log --format=%s ${LAST_TAG:+$LAST_TAG..}HEAD | grep -c "^feat:" || echo 0)
    FIX_COUNT=$(git log --format=%s ${LAST_TAG:+$LAST_TAG..}HEAD | grep -c "^fix:" || echo 0)
    UPSTREAM_COUNT=$(git log --format=%s ${LAST_TAG:+$LAST_TAG..}HEAD | grep -c "^upstream:" || echo 0)

    echo "📊 Release Metrics:"
    echo "- Days since last release: $DAYS_SINCE_RELEASE"
    echo "- Total commits: $COMMIT_COUNT"
    echo "- Features: $FEAT_COUNT"
    echo "- Bug fixes: $FIX_COUNT"  
    echo "- Upstream updates: $UPSTREAM_COUNT"

- name: Notify team of new release
  if: steps.release.outputs.release_created
  run: |
    # Create comprehensive release summary
    RELEASE_URL="${{ steps.release.outputs.html_url }}"
    VERSION="${{ steps.release.outputs.version }}"
    CORRELATED_TAG="${{ steps.create-tag.outputs.correlated_tag }}"

    echo "🎉 New release published: v$VERSION"
    echo "📋 Release URL: $RELEASE_URL"
    echo "🔗 Correlated tag: $CORRELATED_TAG"
    echo "⬆️ Upstream version: ${{ steps.get-upstream.outputs.upstream_version }}"