validate-plugins.yml

name: Validate Plugins

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  validate-structure:
    name: Validate plugin structure
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Validate marketplace.json
        run: |
          echo "Checking marketplace.json..."
          python3 -c "
          import json, sys
          data = json.load(open('.claude-plugin/marketplace.json'))
          assert 'name' in data, 'Missing name'
          assert 'plugins' in data, 'Missing plugins'
          for p in data['plugins']:
              assert 'name' in p, f'Plugin missing name: {p}'
              assert 'source' in p, f'Plugin missing source: {p}'
              print(f'  ✓ {p[\"name\"]}')
          print(f'All {len(data[\"plugins\"])} plugins valid')
          "

      - name: Validate plugin.json files
        run: |
          echo "Checking plugin.json files..."
          python3 -c "
          import json, glob, sys
          files = glob.glob('plugins/*/.claude-plugin/plugin.json')
          assert files, 'No plugin.json files found'
          for f in sorted(files):
              data = json.load(open(f))
              assert 'name' in data, f'{f}: missing name'
              assert 'version' in data, f'{f}: missing version'
              assert 'description' in data, f'{f}: missing description'
              print(f'  ✓ {data[\"name\"]} v{data[\"version\"]}')
          print(f'All {len(files)} plugin.json files valid')
          "

      - name: Validate skill frontmatter
        run: |
          echo "Checking SKILL.md frontmatter..."
          python3 -c "
          import glob, re, sys
          try:
              import yaml
          except ImportError:
              import pip._vendor.tomli  # fallback - just check regex
              yaml = None

          files = sorted(glob.glob('plugins/*/skills/*/SKILL.md'))
          assert files, 'No SKILL.md files found'
          errors = []
          warnings = []
          for f in files:
              content = open(f).read()
              match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
              if not match:
                  # Some skills are reference-only (no frontmatter) — warn, don't fail
                  warnings.append(f'{f}: no YAML frontmatter (reference skill?)')
                  continue
              if yaml:
                  fm = yaml.safe_load(match.group(1))
                  if not fm or 'description' not in fm:
                      errors.append(f'{f}: missing description in frontmatter')
                      continue
                  if len(fm['description']) < 50:
                      errors.append(f'{f}: description too short')
                      continue
              print(f'  ✓ {f}')
          for w in warnings:
              print(f'  ⚠ {w}')
          if errors:
              for e in errors:
                  print(f'  ✗ {e}', file=sys.stderr)
              sys.exit(1)
          print(f'All {len(files)} skills checked ({len(warnings)} warnings)')
          "

      - name: Validate agent frontmatter
        run: |
          echo "Checking agent frontmatter..."
          python3 -c "
          import glob, re, sys
          try:
              import yaml
          except ImportError:
              yaml = None

          files = sorted(glob.glob('plugins/*/agents/*.md'))
          assert files, 'No agent files found'
          errors = []
          warnings = []
          required = ['name', 'description']
          for f in files:
              content = open(f).read()
              match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
              if not match:
                  errors.append(f'{f}: missing YAML frontmatter')
                  continue
              if yaml:
                  try:
                      fm = yaml.safe_load(match.group(1))
                  except yaml.YAMLError as e:
                      # Some agents have inline colons in description that break YAML parsing
                      # Check with regex fallback: verify name: and description: lines exist
                      raw = match.group(1)
                      has_name = bool(re.search(r'^name:', raw, re.MULTILINE))
                      has_desc = bool(re.search(r'^description:', raw, re.MULTILINE))
                      if has_name and has_desc:
                          warnings.append(f'{f}: YAML parse warning (inline colons) — name and description present via regex')
                          print(f'  ⚠ {f}: YAML parse issue, regex fallback OK')
                          continue
                      else:
                          errors.append(f'{f}: YAML parse error and missing required fields')
                          continue
                  if not fm:
                      errors.append(f'{f}: empty frontmatter')
                      continue
                  for field in required:
                      if field not in fm:
                          errors.append(f'{f}: missing {field}')
              print(f'  ✓ {f}')
          if errors:
              for e in errors:
                  print(f'  ✗ {e}', file=sys.stderr)
              sys.exit(1)
          print(f'All {len(files)} agents checked ({len(warnings)} warnings)')
          "