name: Review labels

# Require explicit maintainer review when CI-sensitive files or the MCP
# catalog change. Previously this was split across two jobs in two
# workflows: ``ci-review`` in lint.yml (gated on ``ci_review``) and
# ``mcp-catalog-review`` in supply-chain-audit.yml (gated on
# ``mcp_catalog``). Both checked for their own label.
#
# Now consolidated: a single ``ci-reviewed`` label covers both. The
# comment sections tell the reviewer exactly what to verify per area,
# so one label is enough — the human reads the comment, not the label
# name.
#
# Outputs:
#   ci_reviewed    — "true" / "false" / "" (empty when neither lane ran)
#   review_status  — JSON array of status objects consumed by the review
#                    comment assembler. See scripts/ci/emit_review_status.py.

on:
  workflow_call:
    inputs:
      ci_review:
        description: Whether CI-sensitive files (eslint config, workflows, actions) changed.
        type: boolean
        default: false
      ci_review_files:
        description: JSON list of CI-sensitive files changed by the pull request.
        type: string
        default: '[]'
      mcp_catalog:
        description: Whether the MCP catalog / installer changed.
        type: boolean
        default: false
      supply_chain:
        description: Whether the critical supply-chain scan found a risk requiring review.
        type: boolean
        default: false
    outputs:
      ci_reviewed:
        description: Whether the ci-reviewed label is present. Empty when neither input was true.
        value: ${{ jobs.check.outputs.ci_reviewed }}
      review_status:
        description: JSON array of status objects for the review comment assembler.
        value: ${{ jobs.check.outputs.review_status }}

permissions:
  contents: read
  pull-requests: read # read PR labels

jobs:
  check:
    name: Review label gate
    if: inputs.ci_review || inputs.mcp_catalog || inputs.supply_chain
    runs-on: ubuntu-latest
    timeout-minutes: 2
    outputs:
      ci_reviewed: ${{ steps.label-check.outputs.ci_reviewed }}
      review_status: ${{ steps.build-status.outputs.review_status }}
    steps:
      - name: Checkout code
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Check ci-reviewed label
        id: label-check
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          REPO: ${{ github.repository }}
        run: |
          set -euo pipefail
          PR="${{ github.event.pull_request.number }}"
          LABELS=$(gh pr view "$PR" --repo "$REPO" --json labels --jq '.labels[].name' || true)

          if echo "$LABELS" | grep -Fxq 'ci-reviewed'; then
            echo "ci-reviewed label present."
            echo "ci_reviewed=true" >> "$GITHUB_OUTPUT"
          else
            echo "ci-reviewed label missing."
            echo "ci_reviewed=false" >> "$GITHUB_OUTPUT"
          fi

      - name: Build review_status JSON
        id: build-status
        env:
          CI_REVIEW: ${{ inputs.ci_review }}
          CI_REVIEW_FILES: ${{ inputs.ci_review_files }}
          MCP_CATALOG: ${{ inputs.mcp_catalog }}
          SUPPLY_CHAIN: ${{ inputs.supply_chain }}
          LABEL_PRESENT: ${{ steps.label-check.outputs.ci_reviewed }}
          REPO_URL: ${{ github.server_url }}/${{ github.repository }}
          BASE_SHA: ${{ github.event.pull_request.base.sha }}
          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
        run: |
          set -euo pipefail
          args=()
          if [ "$CI_REVIEW" = "true" ]; then args+=(--ci-review); fi
          args+=(--ci-review-files "$CI_REVIEW_FILES")
          if [ "$MCP_CATALOG" = "true" ]; then args+=(--mcp-catalog); fi
          if [ "$SUPPLY_CHAIN" = "true" ]; then args+=(--supply-chain); fi
          if [ "$LABEL_PRESENT" = "true" ]; then args+=(--label-present); fi

          # Write to both $GITHUB_OUTPUT and review-status.json for the
          # live comment poller to pick up as an artifact.
          python3 scripts/ci/emit_review_status.py "${args[@]}" \
            --repo-url "$REPO_URL" --base-sha "$BASE_SHA" --head-sha "$HEAD_SHA" \
            --output "$GITHUB_OUTPUT"
          grep '^review_status=' "$GITHUB_OUTPUT" > review-status.json

      - name: Upload review status artifact
        if: always() && steps.build-status.outcome != 'skipped'
        continue-on-error: true
        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
        with:
          name: review-status-review-labels
          path: review-status.json
          retention-days: 1
          overwrite: true
          if-no-files-found: ignore

      - name: Fail on missing label
        if: steps.label-check.outputs.ci_reviewed != 'true'
        run: |
          echo "::error::CI-sensitive changes require the ci-reviewed label. Add the label and re-run this check."
          exit 1