tracker-validation.yml

name: Tracker Validation

on:
  pull_request:
    branches: [main, development]

permissions:
  contents: read
  pull-requests: write
  issues: write

jobs:
  validate:
    name: Tracker Registry
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v6

      - uses: pnpm/action-setup@v5

      - uses: actions/setup-node@v6
        with:
          node-version: 20
          cache: pnpm

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Detect changed tracker files
        id: changed-trackers
        run: |
          FILES=$(gh api "repos/${{ github.repository }}/pulls/$PR_NUMBER/files" --paginate --jq '.[].filename' | grep '^src/data/trackers/.*\.ts$' | grep -v 'index\.ts$' || true)
          if [ -z "$FILES" ]; then
            echo "has_tracker_changes=false" >> "$GITHUB_OUTPUT"
            echo "No tracker files changed."
          else
            SLUGS=""
            for f in $FILES; do
              SLUG=$(basename "$f" .ts)
              SLUGS="$SLUGS $SLUG"
            done
            SLUGS=$(echo "$SLUGS" | xargs)
            echo "has_tracker_changes=true" >> "$GITHUB_OUTPUT"
            echo "slugs=$SLUGS" >> "$GITHUB_OUTPUT"
            echo "Changed trackers: $SLUGS"
          fi
        env:
          GH_TOKEN: ${{ github.token }}
          PR_NUMBER: ${{ github.event.pull_request.number }}

      - name: Validate changed trackers
        if: steps.changed-trackers.outputs.has_tracker_changes == 'true'
        id: tracker-validation
        continue-on-error: true
        run: |
          pnpm exec tsx scripts/validate-trackers.ts $SLUGS > /tmp/tracker-results.json
          echo "exit_code=$?" >> "$GITHUB_OUTPUT"
          cat /tmp/tracker-results.json
        env:
          SLUGS: ${{ steps.changed-trackers.outputs.slugs }}

      - name: Comment on PR with tracker validation results
        if: steps.changed-trackers.outputs.has_tracker_changes == 'true'
        uses: actions/github-script@v8
        env:
          VALIDATION_JSON: ${{ steps.changed-trackers.outputs.slugs }}
        with:
          script: |
            const fs = require('fs');
            let results;
            try {
              const raw = fs.readFileSync('/tmp/tracker-results.json', 'utf8');
              results = JSON.parse(raw).results;
            } catch {
              console.log('No validation results to comment on.');
              return;
            }

            const nonDraft = results.filter(r => !r.draft);
            const hasErrors = nonDraft.some(r => r.errors.length > 0);
            const hasWarnings = nonDraft.some(r => r.warnings.length > 0);

            const marker = '<!-- tracker-registry-validation -->';
            const prNumber = context.payload.pull_request?.number ?? context.issue.number;

            async function findPreviousComments() {
              const { data: comments } = await github.rest.issues.listComments({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: prNumber,
              });
              return comments.filter(c =>
                c.user?.login === 'github-actions[bot]' &&
                c.body?.includes(marker)
              );
            }

            async function deleteAllPreviousComments() {
              const existing = await findPreviousComments();
              for (const c of existing) {
                await github.rest.issues.deleteComment({
                  owner: context.repo.owner,
                  repo: context.repo.repo,
                  comment_id: c.id,
                });
              }
            }

            if (nonDraft.length === 0 || (!hasErrors && !hasWarnings)) {
              await deleteAllPreviousComments();
              return;
            }

            const icon = hasErrors ? '🚫' : '⚠️';
            const title = hasErrors
              ? `${icon} Tracker registry validation failed`
              : `${icon} Tracker registry warnings`;

            const lines = [`**${title}**`, ''];

            for (const r of nonDraft) {
              if (r.errors.length === 0 && r.warnings.length === 0) continue;

              if (r.errors.length > 0) {
                lines.push(`### ${r.name} (\`${r.slug}\`)`);
                lines.push('');
                lines.push('| Field | Status |');
                lines.push('|---|---|');
                for (const e of r.errors) {
                  lines.push(`| ${e} | ❌ Error |`);
                }
                lines.push('');
              }

              if (r.warnings.length > 0) {
                const heading = r.errors.length > 0
                  ? `Warnings for ${r.name}`
                  : `${r.name} (\`${r.slug}\`) — Warnings`;
                lines.push(`<details>`);
                lines.push(`<summary>${heading} (${r.warnings.length})</summary>`);
                lines.push('');
                lines.push('| Field | Status |');
                lines.push('|---|---|');
                for (const w of r.warnings) {
                  lines.push(`| ${w} | ⚠️ Warning |`);
                }
                lines.push('');
                lines.push('</details>');
                lines.push('');
              }
            }

            lines.push('---');
            lines.push('');
            lines.push('Allowed content categories: `Movies`, `TV`, `Music`, `Games`, `Apps`, `Sports`, `Books`, `Audiobooks`, `Comics`, `Manga`, `Anime`, `XXX`, `Documentaries`, `Education`, `Tutorials`, `Fanres`');
            lines.push('');
            lines.push('See `src/data/__tests__/tracker-registry.test.ts` for all validation rules.');

            const body = `${marker}\n${lines.join('\n')}`;

            const existing = await findPreviousComments();
            if (existing.length > 0) {
              await github.rest.issues.updateComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                comment_id: existing[0].id,
                body,
              });
              for (const c of existing.slice(1)) {
                await github.rest.issues.deleteComment({
                  owner: context.repo.owner,
                  repo: context.repo.repo,
                  comment_id: c.id,
                });
              }
            } else {
              await github.rest.issues.createComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: prNumber,
                body,
              });
            }

      - name: Fail if tracker validation has errors
        if: steps.changed-trackers.outputs.has_tracker_changes == 'true' && steps.tracker-validation.outcome == 'failure'
        run: exit 1