deepseek-harness/.github/workflows/release-publish.yml

# Publish the dsh release sequence to npm. This workflow is manual-only
# (workflow_dispatch) and intentionally does not listen to pull_request or push:
# publication is an explicit, reviewed act; dsh-v* tag validation is enabled by
# default and may be skipped through the dispatch input. It never appears as a PR check. It repacks the current tree before publishing
# so the bytes uploaded are exactly what this dispatch produced.
name: Release publish (dsh)

on:
  workflow_dispatch:
    inputs:
      cua_run_id:
        description: '已有 CUA 打包 run ID：留空重新打包；填写时复用同一源码和版本的已验证产物'
        type: string
        required: false
        default: ''
      cua_run_attempt:
        description: 'CUA 打包 attempt：仅与 run ID 一起使用；留空选择最新一次，不回退到更早的成功构建'
        type: string
        required: false
        default: ''
      skip-tag-check:
        description: Skip release tag validation for the selected ref; other publication checks still apply.
        type: boolean
        required: false
        default: false

permissions:
  contents: read

env:
  PRIMARY_NODE_VERSION: '24'
  DSH_TELEMETRY_DISABLED: '1'

jobs:
  cua-helper:
    if: (startsWith(github.ref, 'refs/tags/dsh-v') || inputs.skip-tag-check) && inputs.cua_run_id == '' && inputs.cua_run_attempt == ''
    uses: ./.github/workflows/cua-helper-package.yml
    with:
      source_ref: ${{ github.ref }}
      preset: production

  pack:
    name: Pack npm tarballs
    needs: cua-helper
    if: >-
      ${{ !cancelled() && (needs.cua-helper.result == 'success'
        || (needs.cua-helper.result == 'skipped' && (inputs.cua_run_id != '' || inputs.cua_run_attempt != ''))) }}
    runs-on: ubuntu-24.04
    permissions:
      contents: read
      actions: read
    steps:
      # Complete history: the release scripts read tags.
      - uses: actions/[email protected]
        with:
          fetch-depth: 0
          persist-credentials: false

      - uses: pnpm/[email protected]
        with:
          dest: ${{ runner.temp }}/setup-pnpm

      - uses: actions/[email protected]
        with:
          node-version: ${{ env.PRIMARY_NODE_VERSION }}

      - name: Configure pnpm store path
        id: pnpm-store
        run: |
          store_root="$HOME/.local/share/pnpm/store"
          echo "PNPM_CONFIG_STORE_DIR=$store_root" >> "$GITHUB_ENV"
          store_path=$(PNPM_CONFIG_STORE_DIR="$store_root" pnpm store path --silent)
          echo "path=$store_path" >> "$GITHUB_OUTPUT"

      - uses: actions/cache/[email protected]
        with:
          path: ${{ steps.pnpm-store.outputs.path }}
          key: ${{ runner.os }}-node-${{ env.PRIMARY_NODE_VERSION }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
          restore-keys: |
            ${{ runner.os }}-node-${{ env.PRIMARY_NODE_VERSION }}-pnpm-

      - name: Install (immutable)
        run: pnpm install --frozen-lockfile

      - name: Verify release version
        env:
          RELEASE_PUBLISH: 'true'
        run: pnpm run release:verify --family dsh ${{ inputs.skip-tag-check && '--skip-tag-check' || '' }}

      - name: Select retained CUA helper
        if: inputs.cua_run_id != '' || inputs.cua_run_attempt != ''
        id: retained-cua
        env:
          GH_TOKEN: ${{ github.token }}
        run: pnpm exec tsx scripts/cua-helper/select-artifact.ts

      - name: Download retained CUA helper
        if: inputs.cua_run_id != '' || inputs.cua_run_attempt != ''
        uses: actions/[email protected]
        with:
          artifact-ids: ${{ steps.retained-cua.outputs.artifact-id }}
          run-id: ${{ inputs.cua_run_id }}
          github-token: ${{ github.token }}
          path: dist/cua-helper

      - name: Build
        run: pnpm run build:official --serial

      - name: Download freshly built CUA helper
        if: inputs.cua_run_id == '' && inputs.cua_run_attempt == ''
        uses: actions/[email protected]
        with:
          name: ${{ needs.cua-helper.outputs.artifact }}
          path: dist/cua-helper

      - name: Stage verified native helper applications
        run: |
          mkdir dist/cua-helper/extracted
          tar -xzf dist/cua-helper/cua-helper.tgz -C dist/cua-helper/extracted
          pnpm exec tsx scripts/cua-helper/stage.ts --from dist/cua-helper/extracted

      - name: Record CUA source and publication retry instructions
        env:
          CUA_RUN_ID: ${{ inputs.cua_run_id || github.run_id }}
          CUA_RUN_ATTEMPT: ${{ steps.retained-cua.outputs.attempt || github.run_attempt }}
        run: |
          {
            printf 'CUA helper: run `%s`, attempt `%s`.\n\n' "$CUA_RUN_ID" "$CUA_RUN_ATTEMPT"
            printf '%s\n\n' 'npm 部分发布失败时，只重跑 Publish to npm job，复用原 dsh-npm-tarballs；不要重跑全部 job。'
            printf '若需新建发布运行，填写 `cua_run_id=%s`、`cua_run_attempt=%s`，并使用相同源码 commit 和版本。\n' "$CUA_RUN_ID" "$CUA_RUN_ATTEMPT"
          } >> "$GITHUB_STEP_SUMMARY"

      - name: Pack release tarballs
        run: pnpm run release:pack --family dsh --out dist/npm

      # The harness packages declare the vendored framework as a peer, and this
      # verification must not depend on the registry already carrying matching
      # versions — one pull request may bump both families before either
      # publishes — so it installs that family's pack output too. Only dist/npm
      # is published.
      - name: Pack the vendored framework for verification
        run: pnpm run release:pack --family vendor --out dist/npm-vendor

      # dsh-sandbox-local declares the Landlock entry as a runtime dependency, so
      # the verification needs its tarball. Its platform packages stay out: they
      # are optional, and building them needs a musl toolchain per architecture.
      - name: Pack the Landlock entry for verification
        run: |
          pnpm --dir native/system run build:ts
          pnpm --dir native/system/packages/entry pack --pack-destination "$PWD/dist/npm-landlock"

      - name: Verify packed install
        run: pnpm run release:verify-packed-install --family dsh --from dist/npm --from dist/npm-vendor --from dist/npm-landlock

      - uses: actions/[email protected]
        with:
          name: dsh-npm-tarballs
          path: dist/npm/*
          if-no-files-found: error
          retention-days: 7

  publish:
    name: Publish to npm
    needs: pack
    runs-on: ubuntu-24.04
    # Required reviewers and the allowed tags live on the environment; this is
    # the only job in the sequence that can write to the registry.
    environment: npm-publish
    concurrency:
      group: Release-publish
      cancel-in-progress: false
    permissions:
      contents: read
    steps:
      # Checkout and install carry the release scripts only. There is no build
      # step: publication uploads the bytes the pack job produced.
      - uses: actions/[email protected]
        with:
          persist-credentials: false

      - uses: pnpm/[email protected]
        with:
          dest: ${{ runner.temp }}/setup-pnpm

      - uses: actions/[email protected]
        with:
          node-version: ${{ env.PRIMARY_NODE_VERSION }}
          registry-url: https://registry.npmjs.org

      - name: Install (immutable, no package scripts)
        run: pnpm install --frozen-lockfile --ignore-scripts

      - uses: actions/[email protected]
        with:
          name: dsh-npm-tarballs
          path: dist/npm

      - name: Publish tarballs
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: pnpm run release:publish --family dsh --from dist/npm