package.yml

name: package

on:
  workflow_dispatch:
    inputs:
      npm_version:
        description: npm version to backfill after a full package build (must match CMakeLists.txt)
        required: false
        type: string
  push:
    tags:
      - "v*"

permissions:
  contents: write

concurrency:
  group: package-${{ github.ref }}
  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/v') }}

jobs:
  build-web-ui:
    name: web-dist
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Check bundled models.dev freshness for release
        if: startsWith(github.ref, 'refs/tags/v')
        shell: bash
        run: |
          python3 - <<'PY'
          import datetime as dt
          import json
          from pathlib import Path

          manifest_path = Path("assets/models_dev/MANIFEST.json")
          try:
              manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
              generated_at = dt.datetime.fromisoformat(
                  manifest["generated_at"].replace("Z", "+00:00")
              )
          except (OSError, KeyError, TypeError, ValueError, json.JSONDecodeError) as exc:
              raise SystemExit(f"Invalid {manifest_path}: {exc}")

          if generated_at.tzinfo is None:
              raise SystemExit(f"{manifest_path}: generated_at must include a timezone")
          now = dt.datetime.now(dt.timezone.utc)
          age = now - generated_at.astimezone(dt.timezone.utc)
          if age < -dt.timedelta(minutes=5):
              raise SystemExit(f"{manifest_path}: generated_at is in the future")
          if age > dt.timedelta(days=30):
              raise SystemExit(
                  f"Bundled models.dev registry is {age.days} days old; "
                  "run scripts/sync_models_dev before creating a release tag"
              )
          print(f"Bundled models.dev registry age: {age.days} days")
          PY

      - name: Install pnpm
        uses: pnpm/action-setup@v4
        with:
          version: '10.32.1'

      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: pnpm
          cache-dependency-path: web/pnpm-lock.yaml

      - name: Build web UI
        shell: bash
        run: |
          cd web
          pnpm install --frozen-lockfile
          pnpm build

      - name: Upload web UI
        uses: actions/upload-artifact@v4
        with:
          name: web-dist
          path: web/dist
          if-no-files-found: error

  build-and-package:
    name: ${{ matrix.id }}
    needs: build-web-ui
    runs-on: ${{ matrix.os }}
    env:
      VCPKG_BINARY_SOURCES: clear;default,readwrite
    strategy:
      fail-fast: false
      matrix:
        include:
          - id: linux-x64
            os: ubuntu-22.04
            triplet: x64-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: -DACECODE_BUILD_DESKTOP=ON
          - id: linux-arm64
            os: ubuntu-22.04-arm
            triplet: arm64-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: -DACECODE_BUILD_DESKTOP=ON
          - id: linux-armv7
            os: ubuntu-22.04
            triplet: arm-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: false
            cmake_extra_args: >-
              -DACECODE_BUILD_DESKTOP=OFF
              -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/toolchains/linux.cmake"
              -DVCPKG_TARGET_ARCHITECTURE=arm
          - id: windows-x64
            os: windows-2022
            triplet: x64-windows-static
            executable: acecode.exe
            archive_extension: zip
            msvc_arch: amd64
            build_desktop: true
            cmake_extra_args: -DACECODE_BUILD_DESKTOP=ON
          - id: windows-arm64
            os: windows-2022
            triplet: arm64-windows-static
            executable: acecode.exe
            archive_extension: zip
            msvc_arch: amd64_arm64
            build_desktop: true
            cmake_extra_args: -DACECODE_BUILD_DESKTOP=ON
          - id: macos-x64
            os: macos-15
            triplet: x64-osx
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: -DCMAKE_OSX_ARCHITECTURES=x86_64 -DACECODE_BUILD_DESKTOP=ON
          - id: macos-arm64
            os: macos-15
            triplet: arm64-osx
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: -DACECODE_BUILD_DESKTOP=ON

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive

      - name: Resolve package version
        id: package-version
        shell: bash
        run: |
          declared_version="$(awk '$1 == "project(acecode" && $2 == "VERSION" { print $3; exit }' CMakeLists.txt)"
          if [ -z "$declared_version" ]; then
            echo "::error::Unable to read the ACECode version from CMakeLists.txt"
            exit 1
          fi
          if [[ "$GITHUB_REF" == refs/tags/v* && "${GITHUB_REF_NAME#v}" != "$declared_version" ]]; then
            echo "::error::Tag $GITHUB_REF_NAME does not match CMake version $declared_version"
            exit 1
          fi
          echo "version=$declared_version" >> "$GITHUB_OUTPUT"

      - name: Check macOS release credentials
        if: runner.os == 'macOS'
        id: macos-release
        shell: bash
        env:
          MACOS_CERTIFICATE_BASE64: ${{ secrets.MACOS_CERTIFICATE_BASE64 }}
          MACOS_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_CERTIFICATE_PASSWORD }}
          MACOS_INSTALLER_CERTIFICATE_BASE64: ${{ secrets.MACOS_INSTALLER_CERTIFICATE_BASE64 }}
          MACOS_INSTALLER_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_INSTALLER_CERTIFICATE_PASSWORD }}
          APPLE_ID: ${{ secrets.APPLE_ID }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
        run: |
          application_missing=()
          for name in \
            MACOS_CERTIFICATE_BASE64 \
            MACOS_CERTIFICATE_PASSWORD \
            APPLE_ID \
            APPLE_TEAM_ID \
            APPLE_APP_SPECIFIC_PASSWORD; do
            if [ -z "${!name}" ]; then
              application_missing+=("$name")
            fi
          done

          if [ "${#application_missing[@]}" -ne 0 ]; then
            if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
              echo "::error::Tagged macOS application releases require secrets: ${application_missing[*]}"
              exit 1
            fi
            echo "::notice::macOS signing/notarization disabled; missing: ${application_missing[*]}"
            echo "enabled=false" >> "$GITHUB_OUTPUT"
          else
            echo "enabled=true" >> "$GITHUB_OUTPUT"
          fi

          installer_certificate_set=false
          installer_password_set=false
          if [ -n "$MACOS_INSTALLER_CERTIFICATE_BASE64" ]; then
            installer_certificate_set=true
          fi
          if [ -n "$MACOS_INSTALLER_CERTIFICATE_PASSWORD" ]; then
            installer_password_set=true
          fi

          if [ "$installer_certificate_set" != "$installer_password_set" ]; then
            echo "::error::macOS Installer credentials must configure both MACOS_INSTALLER_CERTIFICATE_BASE64 and MACOS_INSTALLER_CERTIFICATE_PASSWORD"
            exit 1
          fi
          if [ "$installer_certificate_set" = "true" ]; then
            if [ "${#application_missing[@]}" -eq 0 ]; then
              echo "pkg_enabled=true" >> "$GITHUB_OUTPUT"
            else
              echo "::notice::macOS PKG creation disabled because application signing/notarization is disabled"
              echo "pkg_enabled=false" >> "$GITHUB_OUTPUT"
            fi
          else
            echo "::notice::macOS PKG creation disabled; Developer ID Installer credentials are not configured"
            echo "pkg_enabled=false" >> "$GITHUB_OUTPUT"
          fi

      - name: Configure MSVC
        if: runner.os == 'Windows'
        uses: ilammy/msvc-dev-cmd@v1
        with:
          arch: ${{ matrix.msvc_arch }}

      - name: Install Linux ARMv7 cross toolchain
        if: matrix.id == 'linux-armv7'
        shell: bash
        run: |
          sudo apt-get update
          sudo apt-get install -y \
            binutils-arm-linux-gnueabihf \
            gcc-arm-linux-gnueabihf \
            g++-arm-linux-gnueabihf \
            qemu-user

      - name: Run vcpkg
        uses: lukka/run-vcpkg@v11

      - name: Restore vcpkg binary cache
        uses: actions/cache@v4
        with:
          path: ${{ env.VCPKG_DEFAULT_BINARY_CACHE }}
          key: vcpkg-v2-${{ matrix.os }}-${{ matrix.triplet }}-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json', 'ports/**') }}
          restore-keys: |
            vcpkg-v2-${{ matrix.os }}-${{ matrix.triplet }}-

      - name: Install Linux desktop dependencies
        if: runner.os == 'Linux' && matrix.build_desktop
        shell: bash
        run: |
          sudo apt-get update
          sudo apt-get install -y libwebkit2gtk-4.1-dev

      - name: Download web UI
        uses: actions/download-artifact@v4
        with:
          name: web-dist
          path: web/dist

      - name: Configure
        shell: bash
        run: |
          cmake -S . -B build -G Ninja \
            -DCMAKE_BUILD_TYPE=MinSizeRel \
            -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake" \
            -DVCPKG_TARGET_TRIPLET="${{ matrix.triplet }}" \
            -DBUILD_TESTING=OFF \
            ${{ matrix.cmake_extra_args }}

      - name: Build
        shell: bash
        run: cmake --build build --config MinSizeRel --target acecode

      - name: Build desktop
        if: matrix.build_desktop
        shell: bash
        run: cmake --build build --config MinSizeRel --target acecode-desktop

      - name: Verify Linux ARMv7 executable
        if: matrix.id == 'linux-armv7'
        shell: bash
        run: |
          export LC_ALL=C
          elf_header="$(arm-linux-gnueabihf-readelf -h build/acecode)"
          arm_attributes="$(arm-linux-gnueabihf-readelf -A build/acecode)"
          program_headers="$(arm-linux-gnueabihf-readelf -l build/acecode)"

          printf '%s\n' "$elf_header"
          printf '%s\n' "$arm_attributes"

          grep -Eq 'Class:[[:space:]]+ELF32' <<<"$elf_header"
          grep -Eq 'Machine:[[:space:]]+ARM' <<<"$elf_header"
          grep -Eq 'Tag_CPU_arch:[[:space:]]+v7' <<<"$arm_attributes"
          grep -Eq 'Tag_ABI_VFP_args:[[:space:]]+VFP registers' <<<"$arm_attributes"
          grep -Fq '/lib/ld-linux-armhf.so.3' <<<"$program_headers"

          version_output="$(qemu-arm -L /usr/arm-linux-gnueabihf build/acecode --version)"
          printf '%s\n' "$version_output"
          grep -Eq '^acecode v[^[:space:]]+$' <<<"$version_output"

      - name: Verify bundled resources in macOS app
        if: runner.os == 'macOS' && matrix.build_desktop
        shell: bash
        run: |
          registry_dir="build/ACECode.app/Contents/Resources/share/acecode/models_dev"
          file_count="$(find "$registry_dir" -type f | wc -l | tr -d '[:space:]')"
          if [ "$file_count" != "3" ]; then
            echo "Expected exactly 3 models.dev resources in $registry_dir, found $file_count" >&2
            exit 1
          fi
          for file in api.json MANIFEST.json LICENSE; do
            if [ ! -f "$registry_dir/$file" ] ||
               ! cmp -s "assets/models_dev/$file" "$registry_dir/$file"; then
              echo "Missing or mismatched macOS app models.dev resource: $file" >&2
              exit 1
            fi
          done
          python3 scripts/verify_seed_bundle.py \
            --source assets/seed \
            --packaged build/ACECode.app/Contents/Resources/share/acecode/seed

      - name: Extract debug symbols (Linux)
        if: runner.os == 'Linux'
        shell: bash
        run: |
          binutils_prefix=""
          if [ "${{ matrix.id }}" = "linux-armv7" ]; then
            binutils_prefix="arm-linux-gnueabihf-"
          fi
          "${binutils_prefix}objcopy" --only-keep-debug \
            "build/${{ matrix.executable }}" \
            "build/${{ matrix.executable }}.debug"
          "${binutils_prefix}strip" --strip-unneeded "build/${{ matrix.executable }}"
          "${binutils_prefix}objcopy" \
            --add-gnu-debuglink="build/${{ matrix.executable }}.debug" \
            "build/${{ matrix.executable }}"

      - name: Extract desktop debug symbols (Linux)
        if: runner.os == 'Linux' && matrix.build_desktop
        shell: bash
        run: |
          objcopy --only-keep-debug "build/acecode-desktop" "build/acecode-desktop.debug"
          strip --strip-unneeded "build/acecode-desktop"
          objcopy --add-gnu-debuglink="build/acecode-desktop.debug" "build/acecode-desktop"

      - name: Extract debug symbols (macOS)
        if: runner.os == 'macOS'
        shell: bash
        run: |
          dsymutil "build/${{ matrix.executable }}" -o "build/${{ matrix.executable }}.dSYM"
          strip "build/${{ matrix.executable }}"

      - name: Extract desktop debug symbols (macOS)
        if: runner.os == 'macOS' && matrix.build_desktop
        shell: bash
        run: |
          app_exec="build/ACECode.app/Contents/MacOS/ACECode"
          app_daemon="build/ACECode.app/Contents/MacOS/acecode-daemon"
          if [ ! -f "$app_exec" ]; then
            echo "Missing desktop app executable: $app_exec" >&2
            exit 1
          fi
          if [ ! -f "$app_daemon" ]; then
            echo "Missing desktop app daemon: $app_daemon" >&2
            exit 1
          fi
          dsymutil "$app_exec" -o "build/ACECode.app.dSYM"
          strip "$app_exec"
          dsymutil "$app_daemon" -o "build/acecode-daemon.dSYM"
          strip "$app_daemon"

      - name: Import Developer ID identities (macOS)
        if: runner.os == 'macOS' && steps.macos-release.outputs.enabled == 'true'
        id: macos-keychain
        shell: bash
        env:
          MACOS_CERTIFICATE_BASE64: ${{ secrets.MACOS_CERTIFICATE_BASE64 }}
          MACOS_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_CERTIFICATE_PASSWORD }}
          MACOS_INSTALLER_CERTIFICATE_BASE64: ${{ secrets.MACOS_INSTALLER_CERTIFICATE_BASE64 }}
          MACOS_INSTALLER_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_INSTALLER_CERTIFICATE_PASSWORD }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
          MACOS_CODESIGN_IDENTITY: ${{ vars.MACOS_CODESIGN_IDENTITY }}
          MACOS_INSTALLER_SIGNING_IDENTITY: ${{ vars.MACOS_INSTALLER_SIGNING_IDENTITY }}
        run: |
          set +x
          certificate_path="$RUNNER_TEMP/acecode-developer-id.p12"
          installer_certificate_path="$RUNNER_TEMP/acecode-developer-id-installer.p12"
          keychain_path="$RUNNER_TEMP/acecode-signing.keychain-db"
          keychain_password="$(openssl rand -hex 32)"

          printf '%s' "$MACOS_CERTIFICATE_BASE64" | /usr/bin/base64 -D > "$certificate_path"
          chmod 600 "$certificate_path"
          if [ "${{ steps.macos-release.outputs.pkg_enabled }}" = "true" ]; then
            printf '%s' "$MACOS_INSTALLER_CERTIFICATE_BASE64" | /usr/bin/base64 -D > "$installer_certificate_path"
            chmod 600 "$installer_certificate_path"
          fi
          security create-keychain -p "$keychain_password" "$keychain_path"
          security set-keychain-settings -lut 21600 "$keychain_path"
          security unlock-keychain -p "$keychain_password" "$keychain_path"

          existing_user_keychains=()
          while IFS= read -r existing_keychain; do
            if [ -n "$existing_keychain" ]; then
              existing_user_keychains+=("$existing_keychain")
            fi
          done < <(
            security list-keychains -d user |
              sed -E 's/^[[:space:]]*"//; s/"[[:space:]]*$//'
          )
          security list-keychains -d user -s \
            "$keychain_path" \
            "${existing_user_keychains[@]}"

          security import "$certificate_path" \
            -k "$keychain_path" \
            -P "$MACOS_CERTIFICATE_PASSWORD" \
            -f pkcs12 \
            -T /usr/bin/codesign \
            -T /usr/bin/security
          if [ "${{ steps.macos-release.outputs.pkg_enabled }}" = "true" ]; then
            security import "$installer_certificate_path" \
              -k "$keychain_path" \
              -P "$MACOS_INSTALLER_CERTIFICATE_PASSWORD" \
              -f pkcs12 \
              -T /usr/bin/pkgbuild \
              -T /usr/bin/productbuild \
              -T /usr/bin/security
          fi
          security set-key-partition-list \
            -S apple-tool:,apple: \
            -s \
            -k "$keychain_password" \
            "$keychain_path"

          identity_record="$(security find-identity -v -p codesigning "$keychain_path" |
            awk '/Developer ID Application:/ { print; exit }')"
          identity_fingerprint="$(printf '%s\n' "$identity_record" | awk '{ print $2 }')"
          identity_name="$(printf '%s\n' "$identity_record" | awk -F '"' '{ print $2 }')"
          if [[ ! "$identity_fingerprint" =~ ^[[:xdigit:]]{40}$ ]] || [ -z "$identity_name" ]; then
            echo "::error::No Developer ID Application identity found in the imported certificate"
            exit 1
          fi
          if [ -n "$MACOS_CODESIGN_IDENTITY" ] && [ "$identity_name" != "$MACOS_CODESIGN_IDENTITY" ]; then
            echo "::error::Imported signing identity does not match MACOS_CODESIGN_IDENTITY"
            exit 1
          fi
          if [ -n "$APPLE_TEAM_ID" ] && [[ "$identity_name" != *"($APPLE_TEAM_ID)" ]]; then
            echo "::error::Developer ID Application identity does not match APPLE_TEAM_ID"
            exit 1
          fi

          if [ "${{ steps.macos-release.outputs.pkg_enabled }}" = "true" ]; then
            installer_identity_record="$(security find-identity -v -p basic "$keychain_path" |
              awk '/Developer ID Installer:/ { print; exit }')"
            installer_identity_fingerprint="$(printf '%s\n' "$installer_identity_record" | awk '{ print $2 }')"
            installer_identity_name="$(printf '%s\n' "$installer_identity_record" | awk -F '"' '{ print $2 }')"
            if [[ ! "$installer_identity_fingerprint" =~ ^[[:xdigit:]]{40}$ ]] || [ -z "$installer_identity_name" ]; then
              echo "::error::No Developer ID Installer identity found in the imported certificate"
              exit 1
            fi
            if [ -n "$MACOS_INSTALLER_SIGNING_IDENTITY" ] && [ "$installer_identity_name" != "$MACOS_INSTALLER_SIGNING_IDENTITY" ]; then
              echo "::error::Imported Installer identity does not match MACOS_INSTALLER_SIGNING_IDENTITY"
              exit 1
            fi
            if [ -n "$APPLE_TEAM_ID" ] && [[ "$installer_identity_name" != *"($APPLE_TEAM_ID)" ]]; then
              echo "::error::Developer ID Installer identity does not match APPLE_TEAM_ID"
              exit 1
            fi
            echo "installer_identity=$installer_identity_name" >> "$GITHUB_OUTPUT"
          fi

          echo "keychain=$keychain_path" >> "$GITHUB_OUTPUT"
          # Sign by the certificate fingerprint. codesign can fail to resolve a
          # human-readable identity name inside an isolated temporary keychain.
          echo "identity=$identity_fingerprint" >> "$GITHUB_OUTPUT"

      - name: Sign macOS release payloads
        if: runner.os == 'macOS' && steps.macos-release.outputs.enabled == 'true'
        shell: bash
        run: |
          scripts/macos_codesign.sh \
            --identity "${{ steps.macos-keychain.outputs.identity }}" \
            --keychain "${{ steps.macos-keychain.outputs.keychain }}" \
            --binary "build/${{ matrix.executable }}" \
            --app "build/ACECode.app"

      - name: Notarize and staple macOS app
        if: runner.os == 'macOS' && steps.macos-release.outputs.enabled == 'true'
        shell: bash
        env:
          APPLE_ID: ${{ secrets.APPLE_ID }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
        run: scripts/macos_notarize_app.sh --app "build/ACECode.app"

      - name: Create macOS self-update archive
        if: runner.os == 'macOS'
        id: macos-update
        shell: bash
        run: |
          unsigned_suffix=""
          trust_args=()
          if [ "${{ steps.macos-release.outputs.enabled }}" = "true" ]; then
            trust_args+=(--require-trusted)
          else
            unsigned_suffix="-unsigned"
          fi
          update_path="ACECode-${{ steps.package-version.outputs.version }}-${{ matrix.id }}-update${unsigned_suffix}.zip"
          scripts/macos_create_update_zip.sh \
            --app "build/ACECode.app" \
            --output "$update_path" \
            "${trust_args[@]}"
          echo "path=$update_path" >> "$GITHUB_OUTPUT"

      - name: Package (Unix)
        if: runner.os != 'Windows'
        shell: bash
        run: |
          package_dir="dist/acecode-${{ matrix.id }}"
          mkdir -p "$package_dir"

          validate_models_dev_registry() {
            registry_dir="$1"
            file_count="$(find "$registry_dir" -type f | wc -l | tr -d '[:space:]')"
            if [ "$file_count" != "3" ]; then
              echo "Expected exactly 3 models.dev files in $registry_dir, found $file_count" >&2
              exit 1
            fi
            for file in api.json MANIFEST.json LICENSE; do
              if [ ! -f "$registry_dir/$file" ] ||
                 ! cmp -s "assets/models_dev/$file" "$registry_dir/$file"; then
                echo "Missing or mismatched models.dev package file: $registry_dir/$file" >&2
                exit 1
              fi
            done
          }

          if [ ! -f "build/${{ matrix.executable }}" ]; then
            echo "Missing terminal executable: build/${{ matrix.executable }}" >&2
            exit 1
          fi
          cp "build/${{ matrix.executable }}" "$package_dir/"
          cp README.md README_CN.md "$package_dir/"
          cmake --install build \
            --config MinSizeRel \
            --prefix "$PWD/$package_dir" \
            --component models_dev_registry
          cmake --install build \
            --config MinSizeRel \
            --prefix "$PWD/$package_dir" \
            --component default_seed_bundle
          validate_models_dev_registry "$package_dir/share/acecode/models_dev"
          python3 scripts/verify_seed_bundle.py \
            --source assets/seed \
            --packaged "$package_dir/share/acecode/seed"

          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            if [ "$RUNNER_OS" = "macOS" ]; then
              if [ ! -d "build/ACECode.app" ]; then
                echo "Missing desktop app bundle: build/ACECode.app" >&2
                exit 1
              fi
              cp -r "build/ACECode.app" "$package_dir/"
            else
              if [ ! -f "build/acecode-desktop" ]; then
                echo "Missing desktop executable: build/acecode-desktop" >&2
                exit 1
              fi
              cp "build/acecode-desktop" "$package_dir/"
              cp "web/dist/acecode-logo.png" "$package_dir/"
            fi
          fi
          legacy="$(find "$package_dir" -maxdepth 1 -iname 'ace-browser-*' -print -quit)"
          if [ -n "$legacy" ]; then
            echo "Legacy browser artifact must not be packaged: $legacy" >&2
            exit 1
          fi
          tar -C dist -czf "acecode-${{ matrix.id }}.tar.gz" "acecode-${{ matrix.id }}"

          verify_root="$(mktemp -d)"
          tar -xzf "acecode-${{ matrix.id }}.tar.gz" -C "$verify_root"
          extracted_package="$verify_root/acecode-${{ matrix.id }}"
          validate_models_dev_registry "$extracted_package/share/acecode/models_dev"
          python3 scripts/verify_seed_bundle.py \
            --source assets/seed \
            --packaged "$extracted_package/share/acecode/seed"
          if [ "$RUNNER_OS" = "macOS" ]; then
            validate_models_dev_registry \
              "$extracted_package/ACECode.app/Contents/Resources/share/acecode/models_dev"
            python3 scripts/verify_seed_bundle.py \
              --source assets/seed \
              --packaged "$extracted_package/ACECode.app/Contents/Resources/share/acecode/seed"
          fi
          rm -rf -- "$verify_root"

      - name: Create Linux self-update archive
        if: matrix.id == 'linux-x64' || matrix.id == 'linux-arm64'
        id: linux-update
        shell: bash
        run: |
          update_path="acecode-${{ steps.package-version.outputs.version }}-${{ matrix.id }}-update.zip"
          bash scripts/linux_create_update_zip.sh \
            --package-dir "dist/acecode-${{ matrix.id }}" \
            --output "$update_path" \
            --expected-version "${{ steps.package-version.outputs.version }}"
          echo "path=$update_path" >> "$GITHUB_OUTPUT"

      - name: Create current-user macOS PKG
        if: runner.os == 'macOS' && steps.macos-release.outputs.pkg_enabled == 'true'
        id: macos-pkg
        shell: bash
        run: |
          pkg_path="ACECode-${{ steps.package-version.outputs.version }}-${{ matrix.id }}.pkg"
          scripts/macos_create_pkg.sh \
            --app "build/ACECode.app" \
            --output "$pkg_path" \
            --installer-identity "${{ steps.macos-keychain.outputs.installer_identity }}" \
            --keychain "${{ steps.macos-keychain.outputs.keychain }}"
          echo "path=$pkg_path" >> "$GITHUB_OUTPUT"

      - name: Notarize and validate macOS PKG
        if: runner.os == 'macOS' && steps.macos-release.outputs.pkg_enabled == 'true'
        shell: bash
        env:
          APPLE_ID: ${{ secrets.APPLE_ID }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
        run: scripts/macos_notarize_pkg.sh --pkg "${{ steps.macos-pkg.outputs.path }}"

      - name: Clean up macOS signing material
        if: always() && runner.os == 'macOS'
        shell: bash
        run: |
          set +e
          security delete-keychain "$RUNNER_TEMP/acecode-signing.keychain-db" 2>/dev/null
          rm -f -- \
            "$RUNNER_TEMP/acecode-developer-id.p12" \
            "$RUNNER_TEMP/acecode-developer-id-installer.p12"

      - name: Package (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          $packageDir = "dist/acecode-${{ matrix.id }}"
          New-Item -ItemType Directory -Force -Path $packageDir | Out-Null

          function Assert-ModelsDevRegistry([string] $RegistryDir) {
            if (-not (Test-Path -LiteralPath $RegistryDir -PathType Container)) {
              throw "Missing models.dev directory: $RegistryDir"
            }
            $actualFiles = @(Get-ChildItem -LiteralPath $RegistryDir -File -Recurse)
            if ($actualFiles.Count -ne 3) {
              throw "Expected exactly 3 models.dev files in ${RegistryDir}, found $($actualFiles.Count)"
            }
            foreach ($name in @("api.json", "MANIFEST.json", "LICENSE")) {
              $source = Join-Path "assets/models_dev" $name
              $packaged = Join-Path $RegistryDir $name
              if (-not (Test-Path -LiteralPath $packaged -PathType Leaf)) {
                throw "Missing models.dev package file: $packaged"
              }
              $sourceHash = (Get-FileHash -LiteralPath $source -Algorithm SHA256).Hash
              $packagedHash = (Get-FileHash -LiteralPath $packaged -Algorithm SHA256).Hash
              if ($sourceHash -ne $packagedHash) {
                throw "Mismatched models.dev package file: $packaged"
              }
            }
          }

          $terminalExe = "build/${{ matrix.executable }}"
          if (-not (Test-Path -LiteralPath $terminalExe)) {
            throw "Missing terminal executable: $terminalExe"
          }
          Copy-Item -LiteralPath $terminalExe -Destination "$packageDir/"
          Copy-Item "README.md","README_CN.md" "$packageDir/"
          $packageRoot = (Resolve-Path -LiteralPath $packageDir).Path
          & cmake --install build --config MinSizeRel --prefix $packageRoot --component models_dev_registry
          if ($LASTEXITCODE -ne 0) {
            throw "Failed to install the bundled models.dev registry"
          }
          & cmake --install build --config MinSizeRel --prefix $packageRoot --component default_seed_bundle
          if ($LASTEXITCODE -ne 0) {
            throw "Failed to install the default seed bundle"
          }
          Assert-ModelsDevRegistry (Join-Path $packageDir "share/acecode/models_dev")
          & python scripts/verify_seed_bundle.py `
            --source assets/seed `
            --packaged (Join-Path $packageDir "share/acecode/seed")
          if ($LASTEXITCODE -ne 0) {
            throw "Failed to verify the packaged default seed bundle"
          }

          if ("${{ matrix.build_desktop }}" -eq "true") {
            $desktopCandidates = @(
              "build/acecode-desktop.exe",
              "build/Release/acecode-desktop.exe",
              "build/Debug/acecode-desktop.exe",
              "build/RelWithDebInfo/acecode-desktop.exe",
              "build/MinSizeRel/acecode-desktop.exe"
            )
            $desktopExe = $desktopCandidates | Where-Object { Test-Path -LiteralPath $_ } | Select-Object -First 1
            if (-not $desktopExe) {
              $desktopExe = Get-ChildItem -Path "build" -Recurse -Filter "acecode-desktop.exe" -File |
                Select-Object -ExpandProperty FullName -First 1
            }
            if (-not $desktopExe) {
              throw "Missing desktop executable: acecode-desktop.exe"
            }
            Copy-Item -LiteralPath $desktopExe -Destination "$packageDir/"
          }
          $legacyBrowserArtifact = Get-ChildItem -LiteralPath $packageDir -Filter "ace-browser-*" -Force |
            Select-Object -First 1
          if ($legacyBrowserArtifact) {
            throw "Legacy browser artifact must not be packaged: $($legacyBrowserArtifact.FullName)"
          }
          Compress-Archive -Path "$packageDir/*" -DestinationPath "acecode-${{ matrix.id }}.zip" -Force

          $verifyRoot = Join-Path $env:RUNNER_TEMP ("acecode-package-verify-" + [Guid]::NewGuid().ToString("N"))
          New-Item -ItemType Directory -Path $verifyRoot | Out-Null
          Expand-Archive -LiteralPath "acecode-${{ matrix.id }}.zip" -DestinationPath $verifyRoot
          Assert-ModelsDevRegistry (Join-Path $verifyRoot "share/acecode/models_dev")
          & python scripts/verify_seed_bundle.py `
            --source assets/seed `
            --packaged (Join-Path $verifyRoot "share/acecode/seed")
          if ($LASTEXITCODE -ne 0) {
            throw "Failed to verify the archived default seed bundle"
          }

      - name: Verify Windows ARM64 package
        if: matrix.id == 'windows-arm64'
        shell: pwsh
        run: |
          $packageDir = "dist/acecode-${{ matrix.id }}"
          $expectedExecutables = @(
            "acecode.exe",
            "acecode-desktop.exe"
          )
          foreach ($name in $expectedExecutables) {
            $path = Join-Path $packageDir $name
            if (-not (Test-Path -LiteralPath $path)) {
              throw "Missing ARM64 package executable: $path"
            }
            $headers = (& dumpbin /headers $path | Out-String)
            if ($LASTEXITCODE -ne 0 -or $headers -notmatch '(?im)\bAA64 machine\b') {
              throw "$name is not an ARM64 PE executable"
            }
            Write-Host "${name}: ARM64"
          }

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}
          path: acecode-${{ matrix.id }}.${{ matrix.archive_extension }}
          if-no-files-found: error

      - name: Upload Linux self-update archive
        if: matrix.id == 'linux-x64' || matrix.id == 'linux-arm64'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-update
          path: ${{ steps.linux-update.outputs.path }}
          if-no-files-found: error

      - name: Upload macOS PKG
        if: runner.os == 'macOS' && steps.macos-release.outputs.pkg_enabled == 'true'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-pkg
          path: ${{ steps.macos-pkg.outputs.path }}
          if-no-files-found: error

      - name: Upload macOS self-update archive
        if: runner.os == 'macOS'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-update
          path: ${{ steps.macos-update.outputs.path }}
          if-no-files-found: error

      - name: Upload PDB
        if: runner.os == 'Windows'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-pdb
          path: build/**/acecode.pdb
          if-no-files-found: warn

      - name: Upload desktop PDB
        if: runner.os == 'Windows' && matrix.build_desktop
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-desktop-pdb
          path: build/**/acecode-desktop.pdb
          if-no-files-found: warn

      - name: Upload debug symbols (Linux)
        if: runner.os == 'Linux'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-debug
          path: build/${{ matrix.executable }}.debug
          if-no-files-found: warn

      - name: Upload desktop debug symbols (Linux)
        if: runner.os == 'Linux' && matrix.build_desktop
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-desktop-debug
          path: build/acecode-desktop.debug
          if-no-files-found: warn

      - name: Upload dSYM (macOS)
        if: runner.os == 'macOS'
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-dsym
          path: build/${{ matrix.executable }}.dSYM
          if-no-files-found: warn

      - name: Upload desktop dSYM (macOS)
        if: runner.os == 'macOS' && matrix.build_desktop
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-desktop-dsym
          path: |
            build/ACECode.app.dSYM
            build/acecode-daemon.dSYM
          if-no-files-found: warn

  build-linux-old-package:
    name: ${{ matrix.id }}
    needs: build-web-ui
    runs-on: ${{ matrix.os }}
    container:
      image: buildpack-deps:buster
    env:
      DEBIAN_FRONTEND: noninteractive
      VCPKG_BINARY_SOURCES: clear;default,readwrite
      VCPKG_FORCE_SYSTEM_BINARIES: 1
    strategy:
      fail-fast: false
      matrix:
        include:
          - id: linux-old-x64
            os: ubuntu-22.04
            triplet: x64-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: >-
              -DACECODE_BUILD_DESKTOP=ON
              -DWEBVIEW_WEBKITGTK_API=4.0
          - id: linux-old-arm64
            os: ubuntu-22.04-arm
            triplet: arm64-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: true
            cmake_extra_args: >-
              -DACECODE_BUILD_DESKTOP=ON
              -DWEBVIEW_WEBKITGTK_API=4.0
          - id: linux-old-armv7
            os: ubuntu-22.04
            triplet: arm-linux
            executable: acecode
            archive_extension: tar.gz
            build_desktop: false
            cmake_extra_args: >-
              -DACECODE_BUILD_DESKTOP=OFF
              -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/toolchains/linux.cmake"
              -DVCPKG_TARGET_ARCHITECTURE=arm
              -DCMAKE_C_COMPILER=clang-11
              -DCMAKE_CXX_COMPILER=clang++-11
              -DCMAKE_C_COMPILER_TARGET=arm-linux-gnueabihf
              -DCMAKE_CXX_COMPILER_TARGET=arm-linux-gnueabihf
              -DCMAKE_C_STANDARD_INCLUDE_DIRECTORIES=/usr/arm-linux-gnueabihf/include
              -DCMAKE_CXX_STANDARD_INCLUDE_DIRECTORIES="/usr/arm-linux-gnueabihf/include/c++/8;/usr/arm-linux-gnueabihf/include/c++/8/arm-linux-gnueabihf;/usr/arm-linux-gnueabihf/include"

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive

      - name: Install old Linux dependencies
        shell: bash
        run: |
          sed -i \
            -e 's|http://deb.debian.org/debian|http://archive.debian.org/debian|g' \
            -e 's|http://security.debian.org/debian-security|http://archive.debian.org/debian-security|g' \
            -e 's|http://deb.debian.org/debian-security|http://archive.debian.org/debian-security|g' \
            /etc/apt/sources.list
          printf 'Acquire::Check-Valid-Until "false";\n' > /etc/apt/apt.conf.d/99no-check-valid-until
          apt-get update
          packages=(
            binutils \
            build-essential \
            ca-certificates \
            curl \
            file \
            git \
            ninja-build \
            perl \
            pkg-config \
            python3 \
            python3-pip \
            tar \
            unzip \
            zip
          )
          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            packages+=(libgtk-3-dev libwebkit2gtk-4.0-dev)
          fi
          if [ "${{ matrix.id }}" = "linux-old-armv7" ]; then
            packages+=(
              binutils-arm-linux-gnueabihf
              clang-11
              gcc-arm-linux-gnueabihf
              g++-arm-linux-gnueabihf
              qemu-user
            )
          fi
          apt-get install -y --no-install-recommends "${packages[@]}"
          rm -rf /var/lib/apt/lists/*

      - name: Set up CMake
        uses: jwlawson/actions-setup-cmake@v2
        with:
          cmake-version: '3.29.x'

      - name: Run vcpkg
        uses: lukka/run-vcpkg@v11

      - name: Restore vcpkg binary cache
        uses: actions/cache@v4
        with:
          path: ${{ env.VCPKG_DEFAULT_BINARY_CACHE }}
          key: vcpkg-v2-buster-${{ matrix.os }}-${{ matrix.triplet }}-${{ hashFiles('vcpkg.json', 'vcpkg-configuration.json', 'ports/**') }}
          restore-keys: |
            vcpkg-v2-buster-${{ matrix.os }}-${{ matrix.triplet }}-

      - name: Download web UI
        uses: actions/download-artifact@v4
        with:
          name: web-dist
          path: web/dist

      - name: Configure
        shell: bash
        run: |
          cmake -S . -B build -G Ninja \
            -DCMAKE_BUILD_TYPE=MinSizeRel \
            -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake" \
            -DVCPKG_TARGET_TRIPLET="${{ matrix.triplet }}" \
            -DBUILD_TESTING=OFF \
            ${{ matrix.cmake_extra_args }}

      - name: Build
        shell: bash
        run: cmake --build build --config MinSizeRel --target acecode

      - name: Build desktop
        if: matrix.build_desktop
        shell: bash
        run: cmake --build build --config MinSizeRel --target acecode-desktop

      - name: Verify old Linux ABI
        shell: bash
        run: |
          abi_binaries=(build/acecode)
          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            abi_binaries+=(build/acecode-desktop)
          fi
          max_glibc="$(
            strings "${abi_binaries[@]}" |
              grep -Eo 'GLIBC_[0-9]+\.[0-9]+' |
              sed 's/GLIBC_//' |
              sort -Vu |
              tail -n1
          )"
          if [ -z "$max_glibc" ]; then
            echo "No GLIBC symbol versions found" >&2
            exit 1
          fi
          echo "Max GLIBC symbol: GLIBC_$max_glibc"
          if [ "$(printf '%s\n%s\n' "$max_glibc" "2.28" | sort -V | tail -n1)" != "2.28" ]; then
            echo "Old Linux package requires GLIBC_$max_glibc, expected <= GLIBC_2.28" >&2
            exit 1
          fi

          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            ldd build/acecode-desktop | tee build/acecode-desktop.ldd
            grep -E 'libwebkit2gtk-4\.0\.so\.37' build/acecode-desktop.ldd
            if grep -E 'libwebkit2gtk-4\.1|libwebkitgtk-6' build/acecode-desktop.ldd; then
              echo "Old Linux desktop linked against a newer WebKitGTK ABI" >&2
              exit 1
            fi
          fi

      - name: Verify old Linux ARMv7 executable
        if: matrix.id == 'linux-old-armv7'
        shell: bash
        run: |
          export LC_ALL=C
          elf_header="$(arm-linux-gnueabihf-readelf -h build/acecode)"
          arm_attributes="$(arm-linux-gnueabihf-readelf -A build/acecode)"
          program_headers="$(arm-linux-gnueabihf-readelf -l build/acecode)"

          printf '%s\n' "$elf_header"
          printf '%s\n' "$arm_attributes"

          grep -Eq 'Class:[[:space:]]+ELF32' <<<"$elf_header"
          grep -Eq 'Machine:[[:space:]]+ARM' <<<"$elf_header"
          grep -Eq 'Tag_CPU_arch:[[:space:]]+v7' <<<"$arm_attributes"
          grep -Eq 'Tag_ABI_VFP_args:[[:space:]]+VFP registers' <<<"$arm_attributes"
          grep -Fq '/lib/ld-linux-armhf.so.3' <<<"$program_headers"

          version_output="$(qemu-arm -L /usr/arm-linux-gnueabihf build/acecode --version)"
          printf '%s\n' "$version_output"
          grep -Eq '^acecode v[^[:space:]]+$' <<<"$version_output"

      - name: Extract debug symbols
        shell: bash
        run: |
          binutils_prefix=""
          if [ "${{ matrix.id }}" = "linux-old-armv7" ]; then
            binutils_prefix="arm-linux-gnueabihf-"
          fi
          "${binutils_prefix}objcopy" --only-keep-debug \
            "build/${{ matrix.executable }}" \
            "build/${{ matrix.executable }}.debug"
          "${binutils_prefix}strip" --strip-unneeded "build/${{ matrix.executable }}"
          "${binutils_prefix}objcopy" \
            --add-gnu-debuglink="build/${{ matrix.executable }}.debug" \
            "build/${{ matrix.executable }}"

          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            objcopy --only-keep-debug "build/acecode-desktop" "build/acecode-desktop.debug"
            strip --strip-unneeded "build/acecode-desktop"
            objcopy --add-gnu-debuglink="build/acecode-desktop.debug" "build/acecode-desktop"
          fi

      - name: Package
        shell: bash
        run: |
          package_dir="dist/acecode-${{ matrix.id }}"
          mkdir -p "$package_dir"

          validate_models_dev_registry() {
            registry_dir="$1"
            file_count="$(find "$registry_dir" -type f | wc -l | tr -d '[:space:]')"
            if [ "$file_count" != "3" ]; then
              echo "Expected exactly 3 models.dev files in $registry_dir, found $file_count" >&2
              exit 1
            fi
            for file in api.json MANIFEST.json LICENSE; do
              if [ ! -f "$registry_dir/$file" ] ||
                 ! cmp -s "assets/models_dev/$file" "$registry_dir/$file"; then
                echo "Missing or mismatched models.dev package file: $registry_dir/$file" >&2
                exit 1
              fi
            done
          }

          if [ ! -f "build/${{ matrix.executable }}" ]; then
            echo "Missing terminal executable: build/${{ matrix.executable }}" >&2
            exit 1
          fi
          cp "build/${{ matrix.executable }}" "$package_dir/"
          cp README.md README_CN.md "$package_dir/"
          cmake --install build \
            --config MinSizeRel \
            --prefix "$PWD/$package_dir" \
            --component models_dev_registry
          cmake --install build \
            --config MinSizeRel \
            --prefix "$PWD/$package_dir" \
            --component default_seed_bundle
          validate_models_dev_registry "$package_dir/share/acecode/models_dev"
          python3 scripts/verify_seed_bundle.py \
            --source assets/seed \
            --packaged "$package_dir/share/acecode/seed"

          if [ "${{ matrix.build_desktop }}" = "true" ]; then
            if [ ! -f "build/acecode-desktop" ]; then
              echo "Missing desktop executable: build/acecode-desktop" >&2
              exit 1
            fi
            cp "build/acecode-desktop" "$package_dir/"
            cp "web/dist/acecode-logo.png" "$package_dir/"
          fi

          legacy="$(find "$package_dir" -maxdepth 1 -iname 'ace-browser-*' -print -quit)"
          if [ -n "$legacy" ]; then
            echo "Legacy browser artifact must not be packaged: $legacy" >&2
            exit 1
          fi
          tar -C dist -czf "acecode-${{ matrix.id }}.tar.gz" "acecode-${{ matrix.id }}"

          verify_root="$(mktemp -d)"
          tar -xzf "acecode-${{ matrix.id }}.tar.gz" -C "$verify_root"
          validate_models_dev_registry \
            "$verify_root/acecode-${{ matrix.id }}/share/acecode/models_dev"
          python3 scripts/verify_seed_bundle.py \
            --source assets/seed \
            --packaged "$verify_root/acecode-${{ matrix.id }}/share/acecode/seed"
          rm -rf -- "$verify_root"

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}
          path: acecode-${{ matrix.id }}.${{ matrix.archive_extension }}
          if-no-files-found: error

      - name: Upload debug symbols
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-debug
          path: build/${{ matrix.executable }}.debug
          if-no-files-found: warn

      - name: Upload desktop debug symbols
        if: matrix.build_desktop
        uses: actions/upload-artifact@v4
        with:
          name: acecode-${{ matrix.id }}-desktop-debug
          path: build/acecode-desktop.debug
          if-no-files-found: warn

  release:
    if: startsWith(github.ref, 'refs/tags/v')
    needs:
      - build-and-package
      - build-linux-old-package
    runs-on: ubuntu-latest
    steps:
      - name: Download all artifacts
        uses: actions/download-artifact@v4
        with:
          path: artifacts
          merge-multiple: false

      - name: Collect release assets
        shell: bash
        run: |
          mkdir -p release-assets

          unexpected_dmg="$(find artifacts -type f -name '*.dmg' -print -quit)"
          if [ -n "$unexpected_dmg" ]; then
            echo "::error::DMG artifacts are no longer permitted in tagged releases: $unexpected_dmg"
            exit 1
          fi

          unsigned_pkg="$(find artifacts -type f -name '*-unsigned.pkg' -print -quit)"
          if [ -n "$unsigned_pkg" ]; then
            echo "::error::Unsigned PKG artifacts must not be published: $unsigned_pkg"
            exit 1
          fi

          unsigned_update="$(find artifacts -type f -name '*-update-unsigned.zip' -print -quit)"
          if [ -n "$unsigned_update" ]; then
            echo "::error::Unsigned macOS update artifacts must not be published: $unsigned_update"
            exit 1
          fi

          release_version="${GITHUB_REF_NAME#v}"
          pkg_count="$(find artifacts -type f -name '*.pkg' | wc -l | tr -d '[:space:]')"
          if [ "$pkg_count" -ne 0 ] && [ "$pkg_count" -ne 2 ]; then
            echo "::error::Tagged releases allow either zero or two signed macOS PKGs; found $pkg_count"
            exit 1
          fi
          if [ "$pkg_count" -eq 2 ]; then
            for arch in x64 arm64; do
              expected_pkg="ACECode-${release_version}-macos-${arch}.pkg"
              matching_count="$(find artifacts -type f -name "$expected_pkg" | wc -l | tr -d '[:space:]')"
              if [ "$matching_count" -ne 1 ]; then
                echo "::error::Expected exactly one $expected_pkg; found $matching_count"
                exit 1
              fi
            done
          else
            echo "::notice::No macOS PKGs were produced; publishing the remaining trusted assets"
          fi

          find artifacts -type f \( -name '*.tar.gz' -o -name '*.zip' -o -name '*.pkg' \) -print0 |
            while IFS= read -r -d '' file; do
              cp "$file" "release-assets/$(basename "$file")"
            done

          find artifacts -type f \( -name '*.pdb' -o -name '*.debug' \) -print0 |
            while IFS= read -r -d '' file; do
              relative="${file#artifacts/}"
              artifact_name="${relative%%/*}"
              cp "$file" "release-assets/[dev_only]${artifact_name}-$(basename "$file")"
            done

          # Package dSYM directories as tar.gz
          find artifacts -type d -name '*.dSYM' -print0 |
            while IFS= read -r -d '' dsym; do
              relative="${dsym#artifacts/}"
              artifact_name="${relative%%/*}"
              dsym_name="$(basename "$dsym")"
              tar -czf "release-assets/[dev_only]${artifact_name}-${dsym_name}.tar.gz" -C "$(dirname "$dsym")" "$dsym_name"
            done

          (
            cd release-assets
            LC_ALL=C find . -maxdepth 1 -type f ! -name 'SHA256SUMS.txt' -print0 |
              sort -z |
              xargs -0 sha256sum |
              sed 's#  \./#  #' > SHA256SUMS.txt
          )

          ls -lh release-assets/

      - name: Create GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          generate_release_notes: true
          prerelease: ${{ contains(github.ref_name, '-') }}
          make_latest: ${{ contains(github.ref_name, '-') && 'false' || 'true' }}
          files: release-assets/*

  publish-npm:
    name: publish npm
    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.npm_version != '')
    needs:
      - build-and-package
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

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

      - name: Resolve npm version
        id: npm-version
        shell: bash
        env:
          INPUT_NPM_VERSION: ${{ inputs.npm_version }}
        run: |
          declared_version="$(awk '$1 == "project(acecode" && $2 == "VERSION" { print $3; exit }' CMakeLists.txt)"
          if [ -z "$declared_version" ]; then
            echo "::error::无法从 CMakeLists.txt 读取 ACECode 版本"
            exit 1
          fi

          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
            version="${GITHUB_REF_NAME#v}"
          else
            version="$INPUT_NPM_VERSION"
            if [ "$version" != "$declared_version" ]; then
              echo "::error::手动 npm 版本 $version 与 CMakeLists.txt 版本 $declared_version 不一致"
              exit 1
            fi
          fi

          if [ -z "$version" ]; then
            echo "::error::npm 版本不能为空"
            exit 1
          fi

          dist_tag=latest
          case "$version" in *-*) dist_tag=next ;; esac
          echo "version=$version" >> "$GITHUB_OUTPUT"
          echo "dist_tag=$dist_tag" >> "$GITHUB_OUTPUT"

      - name: Download artifacts
        uses: actions/download-artifact@v4
        with:
          path: artifacts
          pattern: acecode-*
          merge-multiple: false

      - name: Extract archives
        shell: bash
        run: |
          mkdir -p extracted
          for id in linux-x64 linux-arm64 macos-x64 macos-arm64; do
            tar -xzf "artifacts/acecode-$id/acecode-$id.tar.gz" -C extracted
          done
          # Windows zip 打包时没有顶层目录(Compress-Archive $dir/*),解到显式目录
          for id in windows-x64 windows-arm64; do
            mkdir -p "extracted/acecode-$id"
            unzip -q "artifacts/acecode-$id/acecode-$id.zip" -d "extracted/acecode-$id"
          done

      - name: Prepare npm packages
        shell: bash
        run: |
          node scripts/npm/prepare-npm-packages.mjs \
            --version "${{ steps.npm-version.outputs.version }}" \
            --input extracted \
            --output npm-staging

      - name: Publish to npm
        shell: bash
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
          NPM_VERSION: ${{ steps.npm-version.outputs.version }}
          NPM_DIST_TAG: ${{ steps.npm-version.outputs.dist_tag }}
        run: |
          if [ -z "$NODE_AUTH_TOKEN" ]; then
            echo "::error::NPM_TOKEN secret 未配置,无法发布 npm 包"
            exit 1
          fi
          # 顺序:先平台二进制包,再 cli / desktop 主包,主包才引用得到平台包
          for dir in npm-staging/platform/*/ npm-staging/cli npm-staging/desktop; do
            name="$(node -p "require('./$dir/package.json').name")"
            if npm view "$name@$NPM_VERSION" version >/dev/null 2>&1; then
              echo "skip $name@$NPM_VERSION (already published)"
              continue
            fi
            echo "publishing $name@$NPM_VERSION (dist-tag: $NPM_DIST_TAG)"
            (cd "$dir" && npm publish --access public --tag "$NPM_DIST_TAG")
          done