fix(ci): harden publishing and validate examples

.github/workflows/preview-pdf.yml

@@ -6,49 +6,57 @@ on:
       - master
   workflow_dispatch:
 
-permissions:
-  contents: write
+permissions: {}
 
 concurrency:
   group: preview-pdf
   cancel-in-progress: true
 
 jobs:
-  update-preview-pdf:
-    name: Update preview release
+  build:
+    permissions:
+      contents: read
     runs-on: ubuntu-latest
-    env:
-      GH_TOKEN: ${{ github.token }}
     steps:
-      - uses: actions/checkout@v7
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
 
-      - name: Check project rules
-        run: python3 check_project_rules.py
+      - name: Install locked Node dependencies
+        env:
+          PUPPETEER_SKIP_DOWNLOAD: "true"
+        run: npm ci
 
-      - name: Check release metadata
-        run: npm test
+      - name: Check project rules and metadata
+        run: |
+          python3 check_project_rules.py
+          npm test
 
-      - name: Install Chromium and CJK fonts
-        uses: browser-actions/setup-chrome@v2
+      - name: Install Chromium
+        uses: browser-actions/setup-chrome@2e1d749697dd1612b833dba4a722266286fbefcd # v2.1.2
         with:
           chrome-version: stable
-      - name: Install CJK fonts
+
+      - name: Install CJK fonts and PDF inspection tools
         run: |
           sudo apt-get update
-          sudo apt-get install -y fonts-noto-cjk fonts-noto-cjk-extra
+          sudo apt-get install -y fonts-noto-cjk fonts-noto-cjk-extra poppler-utils
 
-      - name: Install mdpress 0.7.10
+      - name: Install mdPress 0.7.10
         env:
           MDPRESS_VERSION: "0.7.10"
           MDPRESS_SHA256: "17e53e455996940bbbce64c69c43b3fb543f1501e03b74cf0434074efebd2db4"
         run: |
-          archive="/tmp/mdpress_${MDPRESS_VERSION}_linux_amd64.tar.gz"
-          echo "Installing mdpress ${MDPRESS_VERSION}"
-          curl -fsSL "https://github.com/yeasy/mdPress/releases/download/v${MDPRESS_VERSION}/mdpress_${MDPRESS_VERSION}_linux_amd64.tar.gz" -o "$archive"
+          archive="$RUNNER_TEMP/mdpress_${MDPRESS_VERSION}_linux_amd64.tar.gz"
+          curl -fsSL --retry 3 \
+            "https://github.com/yeasy/mdPress/releases/download/v${MDPRESS_VERSION}/mdpress_${MDPRESS_VERSION}_linux_amd64.tar.gz" \
+            -o "$archive"
           echo "${MDPRESS_SHA256}  $archive" | sha256sum -c -
-          tar xzf "$archive" -C /tmp mdpress
-          sudo mv /tmp/mdpress /usr/local/bin/
-          mdpress --version
+          tar xzf "$archive" -C "$RUNNER_TEMP" mdpress
+          mkdir -p "$RUNNER_TEMP/bin"
+          install -m 0755 "$RUNNER_TEMP/mdpress" "$RUNNER_TEMP/bin/mdpress"
+          echo "$RUNNER_TEMP/bin" >> "$GITHUB_PATH"
 
       - name: Prepare PDF sources
         run: python3 tools/prepare_pdf_sources.py --book-dir . --out "$RUNNER_TEMP/docker_practice-pdf-src"
@@ -59,6 +67,39 @@ jobs:
           mkdir -p "$GITHUB_WORKSPACE/dist"
           mdpress build --format pdf --output "$GITHUB_WORKSPACE/dist/docker_practice.pdf"
 
+      - name: Verify preview PDF
+        run: |
+          title=$(python3 -c 'import json; print(json.load(open("book.json", encoding="utf-8"))["title"])')
+          python3 tools/verify_artifacts.py \
+            --title "$title" \
+            --pdf dist/docker_practice.pdf \
+            --checksums dist/SHA256SUMS
+          (cd dist && sha256sum -c SHA256SUMS)
+
+      - name: Upload verified preview bundle
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: docker-practice-preview
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    permissions:
+      contents: write
+    needs: build
+    runs-on: ubuntu-latest
+    env:
+      GH_TOKEN: ${{ github.token }}
+    steps:
+      - name: Download verified preview bundle
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: docker-practice-preview
+          path: dist
+
+      - name: Recheck preview checksum
+        run: (cd dist && sha256sum -c SHA256SUMS)
+
       - name: Write release notes
         run: |
           cat > dist/release-notes.md <<EOF
@@ -69,7 +110,7 @@ jobs:
           - Run: https://github.com/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}
           EOF
 
-      - name: Create preview release
+      - name: Create preview release when absent
         run: |
           gh release view preview-pdf >/dev/null 2>&1 || \
             gh release create preview-pdf \
@@ -87,8 +128,10 @@ jobs:
             --prerelease \
             --target "$GITHUB_SHA"
 
-      - name: Remove legacy preview asset
-        run: gh release delete-asset preview-pdf latest.pdf -y || true
-
-      - name: Upload preview PDF
-        run: gh release upload preview-pdf dist/docker_practice.pdf --clobber
+      - name: Replace preview assets
+        run: |
+          gh release delete-asset preview-pdf latest.pdf -y || true
+          gh release upload preview-pdf \
+            dist/docker_practice.pdf \
+            dist/SHA256SUMS \
+            --clobber