Triggers

# .github/workflows/ci.yml
name: CI

# Multiple triggers — runs on ALL matching events
on:
    # 1) Push to specific branches + tags
    push:
        branches:
            - main
            - 'release/**'
        tags:
            - 'v*.*.*'
        paths-ignore:
            - '**.md'
            - 'docs/**'

    # 2) PRs targeted at main, when interesting files change
    pull_request:
        branches: [main]
        types: [opened, synchronize, reopened, ready_for_review]
        paths:
            - 'src/**'
            - 'package*.json'
            - '.github/workflows/**'

    # 3) Scheduled (cron — UTC, NEVER your local time)
    schedule:
        - cron: '0 6 * * 1-5'        # 06:00 UTC Mon-Fri

    # 4) Manual — appears as a 'Run workflow' button
    workflow_dispatch:
        inputs:
            environment:
                description: 'Target env'
                required: true
                default: 'staging'
                type:    choice
                options: ['staging', 'production']
            dry_run:
                type:    boolean
                default: true

    # 5) Repository event-only triggers
    issues:
        types: [opened]

jobs:
    test:
        # 'if' lets you filter per-job too
        if: github.event_name != 'schedule' || github.repository == 'me/app'
        runs-on: ubuntu-latest
        steps:
            - uses: actions/checkout@v4
            - run: echo "event=${{ github.event_name }} ref=${{ github.ref }}"
            - run: echo "env=${{ inputs.environment || 'unknown' }}"

# Tips
#   • paths-ignore: docs-only changes shouldn't run the full pipeline
#   • types: filter PR events so you don't re-run on every label change
#   • concurrency: cancel-in-progress avoids stacked CI on rapid pushes

# GitHub Actions
on:
    push:
        branches: [main]
    pull_request:
    schedule:
        - cron: '0 6 * * *'
    workflow_dispatch: