devsecops.yml

# CAST — DevSecOps Pipeline for Python
# https://github.com/castops/cast
#
# Includes:
#   1. Secrets Detection  — Gitleaks
#   2. SAST               — Semgrep
#   3. SCA                — pip-audit
#   4. Container Security — Trivy  (skipped if no Dockerfile)
#   5. Code Quality       — Ruff
#   6. Template Lint      — yamllint on templates/**/*.yml
#   7. ODS Validate       — open-delivery-spec/validate-action
#   8. Security Gate      — blocks merge on critical findings

name: CAST DevSecOps

on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]
  workflow_dispatch:

permissions:
  contents: read
  security-events: write  # required for SARIF upload to GitHub Security tab
  actions: read

jobs:

  # ── 1. Secrets Detection ───────────────────────────────────────────────────
  secrets:
    name: Secrets Detection
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # full history so Gitleaks can scan all commits
      - name: Install Gitleaks
        run: |
          curl -sSfL https://github.com/gitleaks/gitleaks/releases/download/v8.27.2/gitleaks_8.27.2_linux_x64.tar.gz \
            -o /tmp/gitleaks.tar.gz
          tar -xzf /tmp/gitleaks.tar.gz -C /tmp gitleaks
          sudo mv /tmp/gitleaks /usr/local/bin/gitleaks
          gitleaks version
      - name: Gitleaks scan
        run: gitleaks detect --source . --verbose --redact

  # ── 2. SAST ────────────────────────────────────────────────────────────────
  sast:
    name: SAST
    runs-on: ubuntu-latest
    container:
      image: semgrep/semgrep
    steps:
      - uses: actions/checkout@v4
      - name: Semgrep scan
        # SEMGREP_APP_TOKEN is optional — falls back to open-source rules
        run: semgrep ci --sarif --output=semgrep.sarif || true
        env:
          SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
      - name: Ensure SARIF exists
        if: always()
        run: |
          [ -f semgrep.sarif ] || echo '{"version":"2.1.0","$schema":"https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json","runs":[]}' > semgrep.sarif
      - name: Upload to GitHub Security tab
        uses: github/codeql-action/upload-sarif@v3
        if: always()
        continue-on-error: true  # requires GitHub Advanced Security; skip gracefully if not enabled
        with:
          sarif_file: semgrep.sarif

  # ── 3. SCA — Dependency Audit ──────────────────────────────────────────────
  sca:
    name: SCA
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.x"
          cache: pip
      - name: pip-audit
        run: |
          pip install pip-audit
          pip install -e ".[dev]"
          # CVE-2026-4539: ReDoS in pygments AdlLexer — no fix released yet
          # (https://github.com/advisories/GHSA-5239-wwwm-4pmq); re-enable once patched
          pip-audit --ignore-vuln CVE-2026-4539

  # ── 4. Container Security ──────────────────────────────────────────────────
  container:
    name: Container Security
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Check for Dockerfile
        id: check_dockerfile
        run: |
          if [ -f Dockerfile ]; then
            echo "found=true" >> $GITHUB_OUTPUT
          else
            echo "No Dockerfile found — skipping container scan"
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      - name: Build image
        if: steps.check_dockerfile.outputs.found == 'true'
        run: docker build -t cast-scan:${{ github.sha }} .
      - name: Trivy scan
        if: steps.check_dockerfile.outputs.found == 'true'
        uses: aquasecurity/trivy-action@v0.36.0
        with:
          image-ref: cast-scan:${{ github.sha }}
          format: sarif
          output: trivy.sarif
          severity: CRITICAL,HIGH
          exit-code: "0"  # gate handles blocking, not trivy directly
      - name: Upload to GitHub Security tab
        if: steps.check_dockerfile.outputs.found == 'true'
        uses: github/codeql-action/upload-sarif@v3
        continue-on-error: true  # requires GitHub Advanced Security; skip gracefully if not enabled
        with:
          sarif_file: trivy.sarif

  # ── 5. Code Quality ────────────────────────────────────────────────────────
  quality:
    name: Code Quality
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: astral-sh/ruff-action@v1

  # ── 6. Template Lint ───────────────────────────────────────────────────────
  template-lint:
    name: Template Lint
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install yamllint
        run: pip install yamllint
      - name: Lint workflow files
        # Templates embed shell heredocs whose content is intentionally at column 1
        # (required by bash heredoc syntax). GitHub Actions handles this correctly,
        # but yamllint's YAML parser reports false-positive syntax errors for such files.
        # Only lint pure workflow YAML files in .github/workflows/.
        run: yamllint -d relaxed .github/workflows/*.yml

  # ── 7. ODS Validate ────────────────────────────────────────────────────────
  ods:
    name: ODS Validate
    runs-on: ubuntu-latest
    steps:
      - uses: open-delivery-spec/validate-action@v1
        with:
          check: all
          branch_name: ${{ github.head_ref }}
          commit_message: ${{ github.event.head_commit.message }}
          pr_body: ${{ github.event.pull_request.body }}
          strict: "true"

  # ── 8. Security Gate ───────────────────────────────────────────────────────
  gate:
    name: Security Gate
    runs-on: ubuntu-latest
    needs: [secrets, sast, sca, quality, ods]
    if: always()
    steps:
      - name: Evaluate results
        run: |
          echo "secrets : ${{ needs.secrets.result }}"
          echo "sast    : ${{ needs.sast.result }}"
          echo "sca     : ${{ needs.sca.result }}"
          echo "quality : ${{ needs.quality.result }}"
          echo "ods     : ${{ needs.ods.result }}"

          if [[ "${{ needs.secrets.result }}" == "failure" ||
                "${{ needs.sast.result }}"    == "failure" ||
                "${{ needs.sca.result }}"     == "failure" ||
                "${{ needs.ods.result }}"     == "failure" ]]; then
            echo "❌ Security gate failed — merge blocked"
            exit 1
          fi

          echo "✅ All checks passed — safe to merge"