validate.yml

name: Validate Customizations

on:
  pull_request:
    branches:
      - main
    paths:
      - ".github/agents/**"
      - ".github/skills/**"
      - ".github/instructions/**"
      - ".github/hooks/**"
      - ".github/mcp.json"
      - ".mcp.json"
  push:
    branches:
      - main
    paths:
      - ".github/agents/**"
      - ".github/skills/**"
      - ".github/instructions/**"
      - ".github/hooks/**"
      - ".github/mcp.json"
      - ".mcp.json"
  workflow_dispatch:

permissions:
  contents: read
  pull-requests: write

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v6

      - name: Validate Agent Files
        id: validate_agents
        run: |
          echo "## 🤖 Agent Validation" >> $GITHUB_STEP_SUMMARY
          ERROR_COUNT=0

          if [ -d ".github/agents" ]; then
            AGENTS=$(find .github/agents -name "*.agent.md" | sort)

            if [ -z "$AGENTS" ]; then
              echo "✅ No agent files found" >> $GITHUB_STEP_SUMMARY
            else
              for file in $AGENTS; do
                echo "Checking: $file"

                if ! head -1 "$file" | grep -q "^---$"; then
                  echo "❌ Missing YAML frontmatter: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                else
                  echo "✅ Valid structure: $file" >> $GITHUB_STEP_SUMMARY
                fi

                if ! grep -q "^description:" "$file"; then
                  echo "⚠️  Missing 'description' field: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi
              done
            fi
          else
            echo "ℹ️  No agents directory found" >> $GITHUB_STEP_SUMMARY
          fi

          echo "error_count_agents=$ERROR_COUNT" >> $GITHUB_OUTPUT

      - name: Validate Skill Files
        id: validate_skills
        run: |
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "## 🎯 Skill Validation" >> $GITHUB_STEP_SUMMARY
          ERROR_COUNT=0

          if [ -d ".github/skills" ]; then
            SKILLS=$(find .github/skills -name "SKILL.md" | sort)

            if [ -z "$SKILLS" ]; then
              echo "✅ No skill files found" >> $GITHUB_STEP_SUMMARY
            else
              for file in $SKILLS; do
                echo "Checking: $file"

                if ! head -1 "$file" | grep -q "^---$"; then
                  echo "❌ Missing YAML frontmatter: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi

                if ! grep -q "^name:" "$file"; then
                  echo "⚠️  Missing 'name' field: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi

                if ! grep -q "^description:" "$file"; then
                  echo "⚠️  Missing 'description' field: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi

                if grep -q -i "usage\|how to use\|example\|when to use" "$file"; then
                  echo "✅ Valid structure: $file" >> $GITHUB_STEP_SUMMARY
                else
                  echo "⚠️  Missing usage/examples: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi
              done
            fi
          else
            echo "ℹ️  No skills directory found" >> $GITHUB_STEP_SUMMARY
          fi

          echo "error_count_skills=$ERROR_COUNT" >> $GITHUB_OUTPUT

      - name: Validate Instruction Files
        id: validate_instructions
        run: |
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "## 📋 Instructions Validation" >> $GITHUB_STEP_SUMMARY
          ERROR_COUNT=0

          if [ -d ".github/instructions" ]; then
            INSTRUCTIONS=$(find .github/instructions -name "*.instructions.md" | sort)

            if [ -z "$INSTRUCTIONS" ]; then
              echo "✅ No instruction files found" >> $GITHUB_STEP_SUMMARY
            else
              for file in $INSTRUCTIONS; do
                echo "Checking: $file"

                if ! head -1 "$file" | grep -q "^---$"; then
                  echo "❌ Missing YAML frontmatter: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi

                if ! grep -q "^applyTo:" "$file"; then
                  echo "⚠️  Missing 'applyTo' field: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                else
                  echo "✅ Valid structure: $file" >> $GITHUB_STEP_SUMMARY
                fi
              done
            fi
          else
            echo "ℹ️  No instructions directory found" >> $GITHUB_STEP_SUMMARY
          fi

          echo "error_count_instructions=$ERROR_COUNT" >> $GITHUB_OUTPUT

      - name: Validate Hook Files
        id: validate_hooks
        run: |
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "## 🪝 Hook Validation" >> $GITHUB_STEP_SUMMARY
          ERROR_COUNT=0

          if [ -d ".github/hooks" ]; then
            HOOKS=$(find .github/hooks -name "*.json" | sort)

            if [ -z "$HOOKS" ]; then
              echo "✅ No hook files found" >> $GITHUB_STEP_SUMMARY
            else
              for file in $HOOKS; do
                echo "Checking: $file"

                if ! jq empty "$file" >/dev/null 2>&1; then
                  echo "❌ Invalid JSON: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                  continue
                fi

                VERSION=$(jq -r '.version // empty' "$file")
                if [ "$VERSION" != "1" ]; then
                  echo "❌ Missing or invalid version: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                fi

                if ! jq -e '.hooks | type == "object"' "$file" >/dev/null 2>&1; then
                  echo "❌ Missing hooks object: $file" >> $GITHUB_STEP_SUMMARY
                  ERROR_COUNT=$((ERROR_COUNT + 1))
                else
                  echo "✅ Valid structure: $file" >> $GITHUB_STEP_SUMMARY
                fi
              done
            fi
          else
            echo "ℹ️  No hooks directory found" >> $GITHUB_STEP_SUMMARY
          fi

          echo "error_count_hooks=$ERROR_COUNT" >> $GITHUB_OUTPUT

      - name: Validate MCP Configuration
        id: validate_mcp
        run: |
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "## 🔌 MCP Validation" >> $GITHUB_STEP_SUMMARY
          ERROR_COUNT=0

          for file in .github/mcp.json .mcp.json; do
            if [ ! -f "$file" ]; then
              continue
            fi

            echo "Checking: $file"

            if ! jq empty "$file" >/dev/null 2>&1; then
              echo "❌ Invalid JSON: $file" >> $GITHUB_STEP_SUMMARY
              ERROR_COUNT=$((ERROR_COUNT + 1))
              continue
            fi

            if ! jq -e '.mcpServers | type == "object"' "$file" >/dev/null 2>&1; then
              echo "❌ Missing mcpServers object: $file" >> $GITHUB_STEP_SUMMARY
              ERROR_COUNT=$((ERROR_COUNT + 1))
            else
              echo "✅ Valid structure: $file" >> $GITHUB_STEP_SUMMARY
            fi
          done

          if [ ! -f ".github/mcp.json" ] && [ ! -f ".mcp.json" ]; then
            echo "ℹ️  No repository or workspace MCP config found" >> $GITHUB_STEP_SUMMARY
          fi

          echo "error_count_mcp=$ERROR_COUNT" >> $GITHUB_OUTPUT

      - name: Check for Broken Links
        run: |
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "## 🔗 Link Validation" >> $GITHUB_STEP_SUMMARY

          FILES=$(find .github/agents .github/skills .github/instructions -name "*.md" 2>/dev/null || true)

          if [ -z "$FILES" ]; then
            echo "ℹ️  No markdown files to check" >> $GITHUB_STEP_SUMMARY
          else
            BROKEN_LINKS=0
            for file in $FILES; do
              LINKS=$(grep -oP '\[.*?\]\(\K[^)]+(?=\))' "$file" 2>/dev/null | grep -v "^http" || true)

              for link in $LINKS; do
                LINK_PATH=$(echo "$link" | cut -d'#' -f1)
                if [ -z "$LINK_PATH" ]; then continue; fi

                DIR=$(dirname "$file")
                FULL_PATH="$DIR/$LINK_PATH"

                if [ ! -e "$FULL_PATH" ]; then
                  echo "❌ Broken link in $file: $link" >> $GITHUB_STEP_SUMMARY
                  BROKEN_LINKS=$((BROKEN_LINKS + 1))
                fi
              done
            done

            if [ $BROKEN_LINKS -eq 0 ]; then
              echo "✅ No broken links found" >> $GITHUB_STEP_SUMMARY
            fi
          fi

      - name: Summary
        run: |
          TOTAL_ERRORS=$((
            ${{ steps.validate_agents.outputs.error_count_agents }} +
            ${{ steps.validate_skills.outputs.error_count_skills }} +
            ${{ steps.validate_instructions.outputs.error_count_instructions }} +
            ${{ steps.validate_hooks.outputs.error_count_hooks }} +
            ${{ steps.validate_mcp.outputs.error_count_mcp }}
          ))

          echo "" >> $GITHUB_STEP_SUMMARY
          echo "---" >> $GITHUB_STEP_SUMMARY

          if [ $TOTAL_ERRORS -eq 0 ]; then
            echo "### ✅ All validations passed!" >> $GITHUB_STEP_SUMMARY
            exit 0
          else
            echo "### ⚠️  Found $TOTAL_ERRORS issue(s)" >> $GITHUB_STEP_SUMMARY
            exit 1
          fi