docs-review-receipt.yaml

# SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
# SPDX-License-Identifier: Apache-2.0

name: CI / Documentation Writer Review

on:
  pull_request:
    types: [opened, edited, synchronize, reopened]

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
  cancel-in-progress: true

jobs:
  docs-review-receipt:
    runs-on: ubuntu-latest
    timeout-minutes: 3
    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          fetch-depth: 0
          persist-credentials: false

      - name: Setup Node.js
        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
        with:
          node-version: "22"

      - name: Collect receipt inputs
        id: receipt-inputs
        env:
          BASE_SHA: ${{ github.event.pull_request.base.sha }}
          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
        shell: bash
        run: |
          set -euo pipefail
          changed_files="$RUNNER_TEMP/docs-review-changed-files.txt"
          git diff --name-only "$BASE_SHA" "$HEAD_SHA" > "$changed_files"
          agents_blob="$(git rev-parse "${HEAD_SHA}:AGENTS.md")"
          echo "changed_files=$changed_files" >> "$GITHUB_OUTPUT"
          echo "agents_blob=$agents_blob" >> "$GITHUB_OUTPUT"

      - name: Check documentation writer review receipt
        continue-on-error: true
        env:
          AGENTS_BLOB: ${{ steps.receipt-inputs.outputs.agents_blob }}
          CHANGED_FILES: ${{ steps.receipt-inputs.outputs.changed_files }}
        run: >-
          node --experimental-strip-types --no-warnings scripts/docs-review-receipt.mts check
          --event "$GITHUB_EVENT_PATH"
          --changed-files "$CHANGED_FILES"
          --agents-blob "$AGENTS_BLOB"
          --mode advisory