coverage-docs.yml

name: coverage-docs
on:
  pull_request:
    paths:
      - 'docs/coverage/**'
      - 'tools/coverage/**'
  push:
    branches: [main]
    paths:
      - 'docs/coverage/**'
      - 'tools/coverage/**'
jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.26'
      - name: Validate schema + cites
        run: go run ./tools/coverage validate
      - name: Guard against incomplete grouped records (#2971)
        run: go run ./tools/coverage backfill --check
      - name: Verify registry.json is canonical (guards against recompaction, #2907)
        run: |
          if ! go run ./tools/coverage fmt --check; then
            echo "::error::docs/coverage/registry.json is not canonical (likely whole-file re-serialized/compacted). Run 'go run ./tools/coverage fmt' locally and commit."
            exit 1
          fi
      - name: Regenerate docs
        run: go run ./tools/coverage gen
      - name: Verify docs are in sync with JSON
        run: |
          if ! git diff --exit-code docs/coverage/; then
            echo "::error::docs/coverage/*.md is stale. Run 'go run ./tools/coverage gen' locally and commit."
            exit 1
          fi