Taskfile.yml

# yaml-language-server: $schema=https://taskfile.dev/schema.json
---
version: "3"

# https://taskfile.dev/usage/#env-files
dotenv: [".env.local", ".env"]

vars:
    # https://taskfile.dev/reference/templating/
    DOCKER_COMPOSE: '{{.TASK_DOCKER_COMPOSE | default "docker compose"}}'

tasks:
    site:update:
        desc: Update/install site
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: pull
            - task: compose
              vars:
                  COMPOSE_ARGS: up --detach --wait
            - task: composer
              vars:
                  COMPOSER_ARGS: install

    site:migrate:
        desc: Run database migrations
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: doctrine:migrations:migrate --no-interaction

    fixtures:load:
        desc: Load fixtures
        prompt: Really load all fixtures?
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: hautelook:fixtures:load --no-interaction

    tests:
        desc: Run tests
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: --env=test doctrine:database:drop --if-exists --force --quiet
            - task: console
              vars:
                  CONSOLE_ARGS: --env=test doctrine:database:create --no-interaction --if-not-exists --quiet
            - task: console
              vars:
                  CONSOLE_ARGS: --env=test doctrine:migrations:migrate --no-interaction --quiet
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/phpunit --stop-on-failure

    queues:
        desc: Consume async messenger queue
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: messenger:consume async --failure-limit=1 -vvv

    composer:
        desc: "Run `composer` command. Example: task composer -- normalize"
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm composer {{.COMPOSER_ARGS}}

    compose:
        desc: "Run `docker compose` command. Example: task compose -- ps"
        cmds:
            - "{{.DOCKER_COMPOSE}} {{.COMPOSE_ARGS}} {{.CLI_ARGS}}"

    console:
        desc: "Run Symfony console command. Example: task console -- cache:clear"
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm bin/console {{.CONSOLE_ARGS}}

    coding-standards:apply:
        aliases: [cs:apply]
        desc: Apply coding standards
        cmds:
            - task: coding-standards:markdown:apply
            - task: coding-standards:php:apply
            - task: coding-standards:twig:apply
            - task: coding-standards:yaml:apply
        silent: true

    coding-standards:check:
        aliases: [cs:check]
        desc: Check coding standards
        cmds:
            - task: coding-standards:markdown:check
            - task: coding-standards:php:check
            - task: coding-standards:twig:check
            - task: coding-standards:yaml:check
        silent: true

    coding-standards:markdown:apply:
        aliases: [cs:markdown:apply]
        desc: Apply coding standards for Markdown
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm markdownlint markdownlint '**/*.md' --fix

    coding-standards:markdown:check:
        aliases: [cs:markdown:check]
        desc: Check coding standards for Markdown
        cmds:
            - task: coding-standards:markdown:apply
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm markdownlint markdownlint '**/*.md'

    coding-standards:php:apply:
        aliases: [cs:php:apply]
        desc: Apply coding standards for PHP
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/php-cs-fixer fix
        silent: true

    coding-standards:php:check:
        aliases: [cs:php:check]
        desc: Check coding standards for PHP
        cmds:
            - task: coding-standards:php:apply
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/php-cs-fixer check
        silent: true

    coding-standards:twig:apply:
        aliases: [cs:twig:apply]
        desc: Apply coding standards for Twig
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/twig-cs-fixer lint --fix
        silent: true

    coding-standards:twig:check:
        aliases: [cs:twig:check]
        desc: Check coding standards for Twig
        cmds:
            - task: coding-standards:twig:apply
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/twig-cs-fixer lint
        silent: true

    coding-standards:yaml:apply:
        aliases: [cs:yaml:apply]
        desc: Apply coding standards for YAML
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm prettier '**/*.{yml,yaml}' --write --no-error-on-unmatched-pattern
        silent: true

    coding-standards:yaml:check:
        aliases: [cs:yaml:check]
        desc: Check coding standards for YAML
        cmds:
            - task: coding-standards:yaml:apply
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm prettier '**/*.{yml,yaml}' --check --no-error-on-unmatched-pattern
        silent: true

    # Composer checks (mirrors composer.yaml CI)

    composer:check:
        desc: Validate, normalize, and audit composer
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm composer validate --strict
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm composer normalize --dry-run
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm composer audit

    # Analysis

    analysis:php:
        aliases: [analyze:php]
        desc: Run PHPStan static analysis
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: exec phpfpm vendor/bin/phpstan
        silent: true

    # Test matrix (mirrors pr.yaml CI jobs)

    test:matrix:
        desc: Run full test matrix (tests, schema validation, fixtures, assets)
        cmds:
            - task: tests
            - task: test:doctrine-schema
            - task: test:fixtures
            - task: test:build-assets

    test:doctrine-schema:
        desc: Validate Doctrine schema against database
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: doctrine:schema:validate

    test:fixtures:
        desc: Verify fixtures load successfully
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: hautelook:fixtures:load --no-interaction

    test:build-assets:
        desc: Verify frontend assets compile
        cmds:
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm node yarn install
            - task: compose
              vars:
                  COMPOSE_ARGS: run --rm node yarn build

    # CI

    pr:actions:
        desc: Run all CI checks locally
        cmds:
            - task: composer:check
            - task: coding-standards:check
            - task: analyze:php
            - task: test:matrix

    api:spec:export:
        desc: Export API specification
        cmds:
            - task: console
              vars:
                  CONSOLE_ARGS: api:openapi:export --output=public/api-spec-v1.yaml --yaml --no-interaction
            - task: console
              vars:
                  CONSOLE_ARGS: api:openapi:export --output=public/api-spec-v1.json --no-interaction
        silent: true

    default:
        cmds:
            - task --list
        silent: true