_package-linux.yml

name: Package Linux

on:
  workflow_call:
    inputs:
      source-sha:
        description: Immutable 40-character source commit.
        required: true
        type: string
      arch:
        description: Target architecture (x64 or arm64).
        required: true
        type: string
      artifact-purpose:
        description: Package intent (distribution or verification).
        required: true
        type: string
      enforce-installer-size:
        description: Compare installers with the committed package-size baseline.
        required: true
        type: boolean
    secrets:
      RTK_GITHUB_TOKEN:
        required: false
      DC_GITHUB_CLIENT_ID:
        required: false
      DC_GITHUB_CLIENT_SECRET:
        required: false
      DC_GITHUB_REDIRECT_URI:
        required: false

permissions:
  contents: read

env:
  CI: 'true'
  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'

jobs:
  package:
    name: package-linux(${{ inputs.arch }}, ${{ inputs.artifact-purpose }})
    runs-on: ${{ inputs.arch == 'arm64' && 'ubuntu-24.04-arm' || 'ubuntu-24.04' }}
    timeout-minutes: 75
    permissions:
      contents: read
    env:
      SOURCE_SHA: ${{ inputs.source-sha }}
      TARGET_PLATFORM: linux
      TARGET_ARCH: ${{ inputs.arch }}
      PACKAGE_PURPOSE: ${{ inputs.artifact-purpose }}
      UNPACKED_DIRECTORY: ${{ inputs.arch == 'arm64' && 'linux-arm64-unpacked' || 'linux-unpacked' }}
    steps:
      - name: Validate immutable source input
        run: |
          [[ "${SOURCE_SHA}" =~ ^[a-f0-9]{40}$ ]] || {
            echo 'source-sha must be a 40-character lowercase Git SHA' >&2
            exit 1
          }

      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false
          ref: ${{ inputs.source-sha }}
          fetch-depth: 1

      - name: Setup Node.js
        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version: '24.21.0'
          package-manager-cache: false

      - name: Validate package request
        run: >-
          node --input-type=module -e
          "const contract = await import('./scripts/ci/package-contract.mjs');
          contract.validateSourceSha(process.env.SOURCE_SHA);
          contract.validateArtifactPurpose(process.env.PACKAGE_PURPOSE);
          contract.getTargetDefinition(process.env.TARGET_PLATFORM, process.env.TARGET_ARCH);"

      - name: Setup pnpm
        uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Configure pnpm workspace for Linux
        run: pnpm run install:sharp
        env:
          TARGET_OS: linux
          TARGET_ARCH: ${{ inputs.arch }}

      - name: Reinstall target dependencies
        run: pnpm install --frozen-lockfile

      - name: Report RTK install token source
        env:
          RTK_INSTALL_GITHUB_TOKEN_SOURCE: ${{ secrets.RTK_GITHUB_TOKEN != '' && 'RTK_GITHUB_TOKEN' || 'GITHUB_TOKEN' }}
        run: |
          echo "RTK runtime install token source: ${RTK_INSTALL_GITHUB_TOKEN_SOURCE}"

      - name: Verify OpenDAL native package
        run: pnpm run smoke:opendal:native -- --platform linux --arch ${{ inputs.arch }}

      - name: Install Linux runtimes
        run: pnpm run installRuntime:linux:${{ inputs.arch }}
        env:
          GITHUB_TOKEN: ${{ secrets.RTK_GITHUB_TOKEN || github.token }}

      - name: Install and verify DuckDB VSS
        run: |
          pnpm run installRuntime:duckdb:vss -- --platform linux --arch ${{ inputs.arch }}
          pnpm run smoke:duckdb:vss -- --platform linux --arch ${{ inputs.arch }}

      - name: Build Linux application
        run: pnpm run build
        env:
          VITE_GITHUB_CLIENT_ID: ${{ secrets.DC_GITHUB_CLIENT_ID }}
          VITE_GITHUB_CLIENT_SECRET: ${{ secrets.DC_GITHUB_CLIENT_SECRET }}
          VITE_GITHUB_REDIRECT_URI: ${{ secrets.DC_GITHUB_REDIRECT_URI }}

      - name: Bundle CUA plugin
        if: inputs.arch == 'x64'
        run: pnpm run plugin:bundle -- --name cua --platform linux --arch ${{ inputs.arch }}

      - name: Bundle Feishu plugin
        run: pnpm run plugin:bundle -- --name feishu --platform linux --arch ${{ inputs.arch }}

      - name: Bundle Nowledge Mem plugin
        run: pnpm run plugin:bundle -- --name nowledge-mem --platform linux --arch ${{ inputs.arch }}

      - name: Bundle Memcode plugin
        run: pnpm run plugin:bundle -- --name memcode --platform linux --arch ${{ inputs.arch }}

      - name: Package Linux
        run: pnpm exec electron-builder --linux --${{ inputs.arch }} --publish=never

      - name: Verify packaged DuckDB VSS
        run: |
          extension_path="dist/${UNPACKED_DIRECTORY}/resources/app.asar.unpacked/runtime/duckdb/extensions/vss.duckdb_extension"
          test -f "${extension_path}"
          pnpm run smoke:duckdb:vss -- --platform linux --arch "${TARGET_ARCH}" --extension-path "${extension_path}"

      - name: Verify packaged OpenDAL native package
        run: >-
          pnpm run smoke:opendal:native --
          --platform linux
          --arch "${{ inputs.arch }}"
          --resources-path "dist/${{ env.UNPACKED_DIRECTORY }}/resources"

      - name: Verify packaged Light OCR offline
        run: |
          sudo unshare --net --setuid "$(id -u)" --setgid "$(id -g)" -- \
            env HOME="$HOME" PATH="$PATH" pnpm run smoke:light-ocr -- \
            --platform linux \
            --arch "${TARGET_ARCH}" \
            --resources-path "dist/${UNPACKED_DIRECTORY}/resources" \
            --report-path "dist/light-ocr-smoke-linux-${TARGET_ARCH}.json" \
            --expect-supported \
            --require-execution \
            --require-peak-rss

      - name: Verify bundled CUA plugin
        if: inputs.arch == 'x64'
        run: >-
          pnpm run plugin:verify --
          --name cua
          --platform linux
          --arch "${{ inputs.arch }}"
          --plugin-root "dist/${{ env.UNPACKED_DIRECTORY }}/resources/app.asar.unpacked/plugins"

      - name: Verify bundled Feishu plugin
        run: >-
          pnpm run plugin:verify --
          --name feishu
          --platform linux
          --arch "${{ inputs.arch }}"
          --plugin-root "dist/${{ env.UNPACKED_DIRECTORY }}/resources/app.asar.unpacked/plugins"

      - name: Verify bundled Nowledge Mem plugin
        run: >-
          pnpm run plugin:verify --
          --name nowledge-mem
          --platform linux
          --arch "${{ inputs.arch }}"
          --plugin-root "dist/${{ env.UNPACKED_DIRECTORY }}/resources/app.asar.unpacked/plugins"

      - name: Verify bundled Memcode plugin
        run: >-
          pnpm run plugin:verify --
          --name memcode
          --platform linux
          --arch "${{ inputs.arch }}"
          --plugin-root "dist/${{ env.UNPACKED_DIRECTORY }}/resources/app.asar.unpacked/plugins"

      - name: Compare installer sizes
        if: inputs.enforce-installer-size
        run: |
          node scripts/ci/check-package-size.mjs compare \
            --target "linux-${TARGET_ARCH}" \
            --candidate-dir dist \
            --candidate-commit "${SOURCE_SHA}" \
            --report "dist/package-size-linux-${TARGET_ARCH}.json"

      - name: Create package manifest
        env:
          ENFORCE_INSTALLER_SIZE: ${{ inputs.enforce-installer-size }}
        run: |
          size_report=()
          if [[ "${ENFORCE_INSTALLER_SIZE}" == 'true' ]]; then
            size_report=(--installer-size-report "dist/package-size-linux-${TARGET_ARCH}.json")
          fi
          node scripts/ci/package-manifest.mjs \
            --platform linux \
            --arch "${TARGET_ARCH}" \
            --source-sha "${SOURCE_SHA}" \
            --purpose "${PACKAGE_PURPOSE}" \
            --report "dist/light-ocr-smoke-linux-${TARGET_ARCH}.json" \
            --workflow-run-id "${GITHUB_RUN_ID}" \
            --workflow-run-attempt "${GITHUB_RUN_ATTEMPT}" \
            "${size_report[@]}"

      - name: Upload distribution package
        if: ${{ success() && inputs.artifact-purpose == 'distribution' }}
        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
        with:
          name: deepchat-package-linux-${{ inputs.arch }}
          path: package-output/
          if-no-files-found: error
          compression-level: 0
          overwrite: true

      - name: Upload verification diagnostics
        if: ${{ always() && inputs.artifact-purpose == 'verification' }}
        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
        with:
          name: deepchat-package-diagnostics-linux-${{ inputs.arch }}
          path: |
            package-output/manifest.json
            package-output/reports/
            dist/light-ocr-smoke-linux-${{ inputs.arch }}.json
            dist/package-size-linux-${{ inputs.arch }}.json
          if-no-files-found: warn
          retention-days: 7
          overwrite: true