main.yml

name: Build, format MDX and Lint

on:
  pull_request:
    branches:
      - main

  workflow_dispatch:

jobs:
  complete:
    if: always()
    needs: [ mdx-format, build ]
    runs-on: ubuntu-latest
    steps:
      - if: contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled')
        run: exit 1

  mdx-format:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout App Repo
        uses: actions/checkout@v7.0.1
        with:
          # Full history so we can diff the PR against its base branch and only
          # flag links introduced by this PR, not pre-existing repo content.
          fetch-depth: 0

      - name: Install pnpm
        uses: pnpm/action-setup@v6

      - name: Setup Node
        uses: actions/setup-node@v7.0.0
        with:
          node-version: '24'
          cache: 'pnpm'
          cache-dependency-path: '**/pnpm-lock.yaml'

      - name: Enable Corepack
        run: corepack enable

      - name: Install App Dependencies
        run: pnpm install --prefer-offline --frozen-lockfile

      - name: Check MDX
        run:  git update-index -g && pnpm ci:mdx

      - name: Show Diff if Prettier Fails
        if: ${{ failure() }}
        run: pnpm diff:mdx && echo "::error::Prettier static analysis failed"

      - name: No new absolute internal /docs links
        # Canonical rule lives in scripts/check-relative-links.sh (shared with
        # the pre-commit hook). Only flags absolute /docs links introduced by
        # this PR's diff, not pre-existing content in untouched lines.
        run: |
          base="${{ github.base_ref }}"
          scripts/check-relative-links.sh --range "origin/${base:-main}...HEAD" \
            || { echo "::error::New absolute /docs link(s) found above."; exit 1; }



  build:
    uses: ./.github/workflows/build.yml