release.yml

name: Release

on:
  push:
    tags:
      - 'v*'  # Triggers on version tags like v0.3.0

env:
  FLUTTER_VERSION: '3.24.0'
  JAVA_VERSION: '17'

jobs:
  # Extract version from tag
  prepare:
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.version.outputs.version }}
    steps:
      - name: Extract version from tag
        id: version
        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT

  # Sync documentation to all distribution channels
  sync-docs:
    needs: prepare
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Dart
        uses: dart-lang/setup-dart@v1
        with:
          sdk: stable

      - name: Sync documentation
        run: dart scripts/sync_docs.dart

      - name: Upload synced docs
        uses: actions/upload-artifact@v4
        with:
          name: synced-docs
          path: |
            vscode-extension/README.md
            packaging/npm/README.md
            intellij-plugin/src/main/resources/META-INF/plugin.xml

  # Publish to pub.dev
  publish-pub-dev:
    needs: [prepare, sync-docs]
    runs-on: ubuntu-latest
    continue-on-error: true  # Don't block release if rate-limited or already published
    steps:
      - uses: actions/checkout@v4

      - name: Setup Flutter
        uses: subosito/flutter-action@v2
        with:
          flutter-version: ${{ env.FLUTTER_VERSION }}

      - name: Install dependencies
        run: flutter pub get

      - name: Verify version matches tag
        run: |
          PKG_VERSION=$(grep '^version:' pubspec.yaml | sed 's/version: //')
          TAG_VERSION=${{ needs.prepare.outputs.version }}
          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
            echo "Error: pubspec.yaml version ($PKG_VERSION) doesn't match tag ($TAG_VERSION)"
            exit 1
          fi

      - name: Setup pub.dev credentials
        run: |
          mkdir -p ~/.config/dart
          echo '${{ secrets.PUB_DEV_CREDENTIALS }}' > ~/.config/dart/pub-credentials.json

      - name: Publish to pub.dev
        run: dart pub publish --force

  # Publish to npm
  publish-npm:
    needs: [prepare, sync-docs]
    runs-on: ubuntu-latest
    continue-on-error: true  # Don't block if already published
    defaults:
      run:
        working-directory: packaging/npm
    steps:
      - uses: actions/checkout@v4

      - name: Download synced docs
        uses: actions/download-artifact@v4
        with:
          name: synced-docs
          path: .

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          registry-url: 'https://registry.npmjs.org'

      - name: Verify version matches tag
        run: |
          PKG_VERSION=$(node -p "require('./package.json').version")
          TAG_VERSION=${{ needs.prepare.outputs.version }}
          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
            echo "Error: package.json version ($PKG_VERSION) doesn't match tag ($TAG_VERSION)"
            exit 1
          fi

      - name: Publish to npm
        run: npm publish --access public
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

  # Publish VSCode extension
  publish-vscode:
    needs: [prepare, sync-docs]
    runs-on: ubuntu-latest
    continue-on-error: true  # Don't block if already published
    defaults:
      run:
        working-directory: vscode-extension
    steps:
      - uses: actions/checkout@v4

      - name: Download synced docs
        uses: actions/download-artifact@v4
        with:
          name: synced-docs
          path: .

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm install

      - name: Verify version matches tag
        run: |
          PKG_VERSION=$(node -p "require('./package.json').version")
          TAG_VERSION=${{ needs.prepare.outputs.version }}
          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
            echo "Error: package.json version ($PKG_VERSION) doesn't match tag ($TAG_VERSION)"
            exit 1
          fi

      - name: Install vsce
        run: npm install -g @vscode/vsce

      - name: Build and publish
        run: vsce publish -p ${{ secrets.VSCE_PAT }}

  # Publish IntelliJ plugin
  publish-intellij:
    needs: [prepare, sync-docs]
    runs-on: ubuntu-latest
    continue-on-error: true  # Don't block if already published
    defaults:
      run:
        working-directory: intellij-plugin
    steps:
      - uses: actions/checkout@v4

      - name: Download synced docs
        uses: actions/download-artifact@v4
        with:
          name: synced-docs
          path: .

      - name: Setup Java
        uses: actions/setup-java@v4
        with:
          distribution: 'temurin'
          java-version: ${{ env.JAVA_VERSION }}

      - name: Setup Gradle
        uses: gradle/actions/setup-gradle@v3

      - name: Verify version matches tag
        run: |
          PKG_VERSION=$(grep '^version' build.gradle.kts | head -1 | sed 's/.*"\(.*\)".*/\1/')
          TAG_VERSION=${{ needs.prepare.outputs.version }}
          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
            echo "Error: build.gradle.kts version ($PKG_VERSION) doesn't match tag ($TAG_VERSION)"
            exit 1
          fi

      - name: Build plugin
        run: ./gradlew buildPlugin

      - name: Publish to JetBrains Marketplace
        run: ./gradlew publishPlugin --info
        env:
          PUBLISH_TOKEN: ${{ secrets.JETBRAINS_MARKETPLACE_TOKEN }}

      - name: Upload plugin zip as artifact
        uses: actions/upload-artifact@v4
        with:
          name: intellij-plugin
          path: intellij-plugin/build/distributions/*.zip

  # Update Homebrew tap with native binaries
  update-homebrew:
    needs: [prepare, build-native-binaries]  # Wait for native binaries to be built
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Download native binaries for SHA256
        uses: actions/download-artifact@v4
        with:
          path: ./binaries

      - name: Calculate SHA256 for all binaries
        id: sha256
        run: |
          cd binaries
          SHA256_ARM64=$(sha256sum flutter-skill-macos-arm64/flutter-skill-macos-arm64 | cut -d' ' -f1)
          SHA256_X64=$(sha256sum flutter-skill-macos-x64/flutter-skill-macos-x64 | cut -d' ' -f1)
          SHA256_LINUX=$(sha256sum flutter-skill-linux-x64/flutter-skill-linux-x64 | cut -d' ' -f1)
          echo "sha256_arm64=$SHA256_ARM64" >> $GITHUB_OUTPUT
          echo "sha256_x64=$SHA256_X64" >> $GITHUB_OUTPUT
          echo "sha256_linux=$SHA256_LINUX" >> $GITHUB_OUTPUT

      - name: Checkout Homebrew tap
        uses: actions/checkout@v4
        with:
          repository: ai-dashboad/homebrew-flutter-skill
          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
          path: homebrew-tap

      - name: Update Homebrew formula
        run: |
          VERSION=${{ needs.prepare.outputs.version }}
          SHA256_ARM64=${{ steps.sha256.outputs.sha256_arm64 }}
          SHA256_X64=${{ steps.sha256.outputs.sha256_x64 }}
          SHA256_LINUX=${{ steps.sha256.outputs.sha256_linux }}

          # Write the new formula
          cat > homebrew-tap/Formula/flutter-skill.rb << 'FORMULA'
          class FlutterSkill < Formula
            desc "MCP Server for Flutter app automation - AI Agent control for Flutter apps"
            homepage "https://github.com/ai-dashboad/flutter-skill"
            version "VERSION_PLACEHOLDER"
            license "MIT"

            on_macos do
              on_arm do
                url "https://github.com/ai-dashboad/flutter-skill/releases/download/vVERSION_PLACEHOLDER/flutter-skill-macos-arm64"
                sha256 "SHA256_ARM64_PLACEHOLDER"
              end
              on_intel do
                url "https://github.com/ai-dashboad/flutter-skill/releases/download/vVERSION_PLACEHOLDER/flutter-skill-macos-x64"
                sha256 "SHA256_X64_PLACEHOLDER"
              end
            end

            on_linux do
              url "https://github.com/ai-dashboad/flutter-skill/releases/download/vVERSION_PLACEHOLDER/flutter-skill-linux-x64"
              sha256 "SHA256_LINUX_PLACEHOLDER"
            end

            def install
              bin.install Dir["flutter-skill-*"].first => "flutter-skill"
            end

            def caveats
              <<~EOS
                flutter-skill is now installed as a native binary for instant startup!

                MCP Configuration (add to ~/.claude/settings.json):
                  {
                    "mcpServers": {
                      "flutter-skill": {
                        "command": "flutter-skill",
                        "args": ["server"]
                      }
                    }
                  }

                CLI Usage:
                  flutter-skill launch /path/to/flutter/project
                  flutter-skill inspect
                  flutter-skill act tap "button_key"
              EOS
            end

            test do
              system "#{bin}/flutter-skill", "server", "--help"
            end
          end
          FORMULA

          # Replace placeholders
          sed -i "s/VERSION_PLACEHOLDER/${VERSION}/g" homebrew-tap/Formula/flutter-skill.rb
          sed -i "s/SHA256_ARM64_PLACEHOLDER/${SHA256_ARM64}/g" homebrew-tap/Formula/flutter-skill.rb
          sed -i "s/SHA256_X64_PLACEHOLDER/${SHA256_X64}/g" homebrew-tap/Formula/flutter-skill.rb
          sed -i "s/SHA256_LINUX_PLACEHOLDER/${SHA256_LINUX}/g" homebrew-tap/Formula/flutter-skill.rb

      - name: Commit and push
        run: |
          cd homebrew-tap
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add Formula/flutter-skill.rb
          git commit -m "Update flutter-skill to v${{ needs.prepare.outputs.version }} with native binaries" || echo "No changes to commit"
          git push

  # Build native binaries for all platforms
  build-native-binaries:
    needs: prepare
    strategy:
      matrix:
        include:
          - os: macos-latest
            arch: arm64
            artifact: flutter-skill-macos-arm64
          - os: macos-15
            arch: x64
            artifact: flutter-skill-macos-x64
          - os: ubuntu-latest
            arch: x64
            artifact: flutter-skill-linux-x64
          - os: windows-latest
            arch: x64
            artifact: flutter-skill-windows-x64.exe
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4

      - name: Setup Flutter
        uses: subosito/flutter-action@v2
        with:
          flutter-version: ${{ env.FLUTTER_VERSION }}

      - name: Install dependencies
        run: flutter pub get

      - name: Compile native binary
        run: dart compile exe bin/flutter_skill.dart -o ${{ matrix.artifact }}

      - name: Compile fs-ios-bridge (macOS only)
        if: startsWith(matrix.os, 'macos')
        run: |
          clang -framework Foundation -framework CoreGraphics \
            -F/Library/Developer/PrivateFrameworks -framework SimulatorKit \
            -rpath /Library/Developer/PrivateFrameworks \
            -o fs-ios-bridge native/ios-hid/fs_ios_bridge.m
        continue-on-error: true

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: ${{ matrix.artifact }}
          path: |
            ${{ matrix.artifact }}
            fs-ios-bridge

  # Submit to Microsoft Winget official repository
  update-winget:
    needs: [prepare, create-release]
    runs-on: windows-latest
    continue-on-error: true
    steps:
      - name: Publish to WinGet
        uses: vedantmgoyal9/winget-releaser@main
        with:
          identifier: AIDashboard.FlutterSkill
          version: ${{ needs.prepare.outputs.version }}
          installers-regex: 'flutter-skill-windows-x64\.exe$'
          token: ${{ secrets.WINGET_SUBMIT_TOKEN }}
          release-tag: v${{ needs.prepare.outputs.version }}

  # Update Scoop bucket
  update-scoop:
    needs: [prepare, build-native-binaries]
    runs-on: ubuntu-latest
    continue-on-error: true
    steps:
      - name: Download Windows binary
        uses: actions/download-artifact@v4
        with:
          name: flutter-skill-windows-x64.exe
          path: ./

      - name: Calculate SHA256
        id: sha256
        run: |
          hash=$(sha256sum flutter-skill-windows-x64.exe | cut -d' ' -f1)
          echo "sha256=$hash" >> $GITHUB_OUTPUT

      - name: Checkout Scoop bucket
        uses: actions/checkout@v4
        with:
          repository: ai-dashboad/scoop-flutter-skill
          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
          path: scoop-bucket

      - name: Update Scoop manifest
        run: |
          VERSION=${{ needs.prepare.outputs.version }}
          SHA256=${{ steps.sha256.outputs.sha256 }}

          cat > scoop-bucket/bucket/flutter-skill.json << EOF
          {
              "version": "$VERSION",
              "description": "AI Agent Bridge for Flutter Apps - Connect Claude, Cursor, and other AI agents to running Flutter applications",
              "homepage": "https://github.com/ai-dashboad/flutter-skill",
              "license": "MIT",
              "architecture": {
                  "64bit": {
                      "url": "https://github.com/ai-dashboad/flutter-skill/releases/download/v$VERSION/flutter-skill-windows-x64.exe",
                      "hash": "$SHA256"
                  }
              },
              "bin": [["flutter-skill-windows-x64.exe", "flutter-skill"]],
              "checkver": {
                  "github": "https://github.com/ai-dashboad/flutter-skill"
              },
              "autoupdate": {
                  "architecture": {
                      "64bit": {
                          "url": "https://github.com/ai-dashboad/flutter-skill/releases/download/v\$version/flutter-skill-windows-x64.exe"
                      }
                  }
              }
          }
          EOF

      - name: Commit and push
        run: |
          cd scoop-bucket
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add bucket/flutter-skill.json
          git commit -m "Update flutter-skill to v${{ needs.prepare.outputs.version }}" || echo "No changes"
          git push

  # Create GitHub Release
  create-release:
    needs: [prepare, publish-pub-dev, publish-npm, publish-vscode, publish-intellij, update-homebrew, build-native-binaries]
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4

      - name: Download all native binaries
        uses: actions/download-artifact@v4
        with:
          path: ./artifacts

      - name: Prepare release assets
        run: |
          mkdir -p release-assets
          # Move all binaries to release-assets with proper names
          find artifacts -type f -name "flutter-skill-*" -exec mv {} release-assets/ \;
          # Move fs-ios-bridge if built (macOS only)
          find artifacts -type f -name "fs-ios-bridge" -exec mv {} release-assets/ \; 2>/dev/null || true
          # Move IntelliJ plugin zip if exists
          find artifacts -type f -name "*.zip" -exec mv {} release-assets/ \; 2>/dev/null || true
          ls -la release-assets/

      - name: Create Release
        uses: softprops/action-gh-release@v1
        with:
          name: v${{ needs.prepare.outputs.version }}
          generate_release_notes: true
          files: |
            release-assets/*
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

  # Publish to Open VSX Registry
  publish-openvsx:
    needs: [prepare, sync-docs]
    runs-on: ubuntu-latest
    continue-on-error: true
    defaults:
      run:
        working-directory: vscode-extension
    steps:
      - uses: actions/checkout@v4

      - name: Download synced docs
        uses: actions/download-artifact@v4
        with:
          name: synced-docs
          path: .

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm install

      - name: Install ovsx
        run: npm install -g @vscode/vsce ovsx

      - name: Package extension
        run: vsce package

      - name: Publish to Open VSX
        run: ovsx publish *.vsix -p ${{ secrets.OVSX_TOKEN }}

  # Publish to MCP Registry
  publish-mcp-registry:
    needs: [prepare, publish-npm]  # Wait for npm publish first
    runs-on: ubuntu-latest
    continue-on-error: true
    permissions:
      contents: read
      id-token: write  # Required for GitHub OIDC authentication
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install mcp-publisher
        run: |
          curl -sL https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz -o /tmp/mcp-publisher.tar.gz
          tar -xzf /tmp/mcp-publisher.tar.gz -C /tmp
          mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher
          chmod +x /usr/local/bin/mcp-publisher
          mcp-publisher --version

      - name: Verify version in server.json
        run: |
          PKG_VERSION=$(node -p "require('./server.json').version")
          TAG_VERSION=${{ needs.prepare.outputs.version }}
          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
            echo "Error: server.json version ($PKG_VERSION) doesn't match tag ($TAG_VERSION)"
            exit 1
          fi

      - name: Authenticate with MCP Registry
        run: mcp-publisher login github-oidc

      - name: Publish to MCP Registry (CLI)
        id: mcp-cli
        continue-on-error: true
        run: mcp-publisher publish server.json

      - name: Publish to MCP Registry (Action fallback)
        if: steps.mcp-cli.outcome == 'failure'
        uses: OtherVibes/mcp-publish-action@v1
        with:
          name: io.github.ai-dashboad/flutter-skill
          description: "AI-powered E2E testing for 10 platforms. 253 MCP tools. Zero config. Test Flutter, React Native, iOS, Android, Web, Electron, Tauri, KMP, .NET MAUI from natural language."
          version: ${{ needs.prepare.outputs.version }}
          registry_type: npm
          identifier: flutter-skill
          transport_type: stdio
          website_url: https://github.com/ai-dashboad/flutter-skill

  # Post release announcement
  # Note: Twitter/X API free tier no longer supports posting (402 Payment Required).
  # To re-enable, upgrade to a paid X API plan and uncomment below.
  # Alternative: use Discord webhook or Bluesky for announcements.
  post-announcement:
    needs: [prepare, create-release]
    runs-on: ubuntu-latest
    continue-on-error: true
    env:
      DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
    steps:
      - uses: actions/checkout@v4

      - name: Post to Discord (if webhook configured)
        if: env.DISCORD_WEBHOOK_URL != ''
        run: |
          VERSION="${{ needs.prepare.outputs.version }}"
          curl -H "Content-Type: application/json" \
            -d "{\"content\": \"🚀 **Flutter Skill v${VERSION}** released!\\n\\nAI agents → Flutter apps bridge via Dart VM Service\\n\\n📦 Install:\\n\`npm i -g flutter-skill\`\\n\`brew install ai-dashboad/flutter-skill/flutter-skill\`\\n\\n🔗 https://github.com/ai-dashboad/flutter-skill/releases/tag/v${VERSION}\"}" \
            "$DISCORD_WEBHOOK_URL"

      - name: Summary
        run: |
          echo "## 🚀 Release v${{ needs.prepare.outputs.version }} published!" >> $GITHUB_STEP_SUMMARY
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "| Channel | Status |" >> $GITHUB_STEP_SUMMARY
          echo "|---------|--------|" >> $GITHUB_STEP_SUMMARY
          echo "| pub.dev | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| npm | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| VSCode | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| JetBrains | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| Homebrew | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| Scoop | ✅ |" >> $GITHUB_STEP_SUMMARY
          echo "| GitHub Release | ✅ |" >> $GITHUB_STEP_SUMMARY

  # Post-release smoke test — installs from pub.dev and npm and verifies the
  # published package actually works from a clean environment.
  post-release-smoke-test:
    needs: [prepare, publish-pub-dev, publish-npm, create-release]
    runs-on: ubuntu-latest
    continue-on-error: true  # Informational — don't block the release
    strategy:
      matrix:
        channel: [pubdev, npm]
    steps:
      - name: Setup Dart
        uses: dart-lang/setup-dart@v1
        with:
          sdk: stable

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      # pub.dev channel: wait up to 3 minutes for pub.dev CDN propagation, then install
      - name: Install from pub.dev
        if: matrix.channel == 'pubdev'
        run: |
          VERSION=${{ needs.prepare.outputs.version }}
          echo "Waiting for pub.dev to propagate v${VERSION}..."
          for i in $(seq 1 6); do
            sleep 30
            if dart pub global activate flutter_skill $VERSION 2>&1 | grep -q "Activated"; then
              echo "Installed flutter_skill v${VERSION} from pub.dev"
              break
            fi
            echo "Attempt $i/6 — not yet available, retrying..."
          done
          dart pub global activate flutter_skill $VERSION  # final attempt (will error if still unavailable)
          echo "$HOME/.pub-cache/bin" >> $GITHUB_PATH

      # npm channel: wait up to 3 minutes for npm CDN propagation, then install
      - name: Install from npm
        if: matrix.channel == 'npm'
        run: |
          VERSION=${{ needs.prepare.outputs.version }}
          echo "Waiting for npm to propagate flutter-skill@${VERSION}..."
          for i in $(seq 1 6); do
            sleep 30
            if npm install -g flutter-skill@$VERSION 2>&1 | grep -q "added"; then
              echo "Installed flutter-skill@${VERSION} from npm"
              break
            fi
            echo "Attempt $i/6 — not yet available, retrying..."
          done
          npm install -g flutter-skill@$VERSION

      - name: Verify version string
        run: |
          VERSION=${{ needs.prepare.outputs.version }}
          OUTPUT=$(flutter_skill --version 2>&1 || flutter-skill --version 2>&1 || true)
          echo "Output: $OUTPUT"
          echo "$OUTPUT" | grep -q "$VERSION" \
            || echo "⚠️ Version mismatch or not found — manual check recommended"

      - name: Smoke — server initialize
        timeout-minutes: 2
        run: |
          CMD=$(command -v flutter_skill || command -v flutter-skill)
          RESPONSE=$(echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"post-release-smoke","version":"1.0"}}}' \
            | timeout 15 $CMD server 2>/dev/null || true)
          echo "Response: $RESPONSE"
          echo "$RESPONSE" | grep -q '"result"' \
            && echo "✅ ${{ matrix.channel }} post-release smoke test PASSED" \
            || echo "❌ ${{ matrix.channel }} post-release smoke test FAILED — check publish logs"