taskfile.yaml

version: '3'

vars:
  PROTO_DIR: protos/proto
  SDK_GEN_DIR: protos/gen
  DOCS_GEN_DIR: docs
  PHP: php
  COMPOSER: composer

tasks:
  install:
    desc: Install project dependencies
    cmd: "{{.COMPOSER}} install"
    sources:
      - composer.json
    generates:
      - vendor/autoload.php

  var:
    cmd: mkdir -p var
    status:
      - test -d var
    silent: true
    internal: true

  fixcs:
    desc: Fix code style issues
    deps: [ var, install ]
    cmds:
      - "{{.PHP}} vendor/bin/php-cs-fixer fix --verbose {{.CLI_ARGS}}"

  lint:
    desc: Check code style (dry-run)
    cmds:
      - task: fixcs
        vars:
          CLI_ARGS: "--dry-run {{.CLI_ARGS}}"

  verify:
    desc: Run the default verification gate (lint, phpstan, sql check, unit tests)
    deps: [ var, install ]
    cmds:
      - task: lint
      - task: phpstan
      - task: sql:check
      - task: test

  verify:integration:
    desc: Run integration verification against real PostgreSQL
    deps: [ var, install ]
    cmds:
      - task: sql:check:pg
      - task: test:integration

  verify:full:
    desc: Run all verification steps including integration tests
    cmds:
      - task: verify
      - task: tools:sql:check
      - task: verify:integration

  phpstan:
    desc: Run static analysis
    deps: [ var, install ]
    cmds:
      - "{{.PHP}} vendor/bin/phpstan analyse --memory-limit=256M {{.CLI_ARGS}}"

  cache:clear:
    desc: Clear application cache
    deps: [ var, install ]
    cmds:
      - "{{.PHP}} bin/cache-clear.php"

  test:
    desc: Run unit tests without external services
    cmds:
      - "{{.PHP}} vendor/bin/phpunit --colors=never -c phpunit.xml {{.CLI_ARGS}}"

  test:integration:
    desc: Run integration tests against real PostgreSQL
    deps: [ var, install ]
    cmds:
      - "{{.PHP}} vendor/bin/phpunit --colors=never -c phpunit.integration.xml {{.CLI_ARGS}}"

  test:full:
    desc: Run unit and integration tests
    deps: [ test, test:integration ]

  proto:gen:sdk:
    desc: Generate PHP SDK classes from core proto files
    cmds:
      - rm -rf {{.SDK_GEN_DIR}}/*
      - >
        protoc -I={{.PROTO_DIR}}
        --php_out={{.SDK_GEN_DIR}}
        --php_opt=aggregate_metadata
        {{.PROTO_DIR}}/app/v1/*.proto
        {{.PROTO_DIR}}/google/api/*.proto
        {{.PROTO_DIR}}/protoc-gen-openapiv2/options/*.proto

  proto:gen:docs:
    desc: Generate OpenAPI spec for the core template surface
    cmds:
      - rm -f {{.DOCS_GEN_DIR}}/api.swagger.json
      - >
        protoc -I={{.PROTO_DIR}}
        --openapiv2_out=logtostderr=true:{{.DOCS_GEN_DIR}}
        --openapiv2_opt=json_names_for_fields=true,allow_merge=true,merge_file_name=api
        {{.PROTO_DIR}}/app/v1/*.proto

  proto:gen:endpoints:
    desc: Generate server-side endpoints and operation manifests from core protobuf services
    deps: [ tools:proto:setup, install ]
    cmds:
      - rm -rf gen/Generated/Endpoint
      - rm -rf gen/Generated/OperationManifest
      - >
        protoc -I={{.PROTO_DIR}}
        --plugin=protoc-gen-php-endpoint=tools/protoc-php-gen/bin/protoc-php-gen.php
        --php-endpoint_out=namespace=App\\Generated\\Endpoint,output_dir=gen,source_root=src,bootstrap=codegen/protoc-php-gen-bootstrap.php,endpoint_profile_class=ProjectCodegen\\Protobuf\\BaseApiTemplateEndpointProfile,generate_endpoints=true,generate_endpoint_validation=true,generate_operation_manifest=true:.
        {{.PROTO_DIR}}/app/v1/*.proto

  proto:gen:all:
    desc: Generate the default protobuf-first runtime artifacts
    cmds:
      - task: proto:gen:sdk
      - task: proto:gen:docs
      - task: proto:gen:endpoints

  sql:gen:
    desc: Generate typed PHP query classes from SQL source files
    deps: [ tools:sql:runtime:setup ]
    cmds:
      - mkdir -p sql/queries
      - rm -rf gen/Generated/Sql
      - >
        php tools/sql-gen/bin/sql-gen.php
        --input-dir=sql/queries
        --output-dir=gen/Generated/Sql
        --namespace=App\\Generated\\Sql
        --schema=sql/schema.sql
        --bootstrap=codegen/sql-gen-bootstrap.php
        --profile-class=ProjectCodegen\\Sql\\BaseApiTemplateSqlGenerationProfile

  sql:check:
    desc: Validate SQL sources and ensure generated SQL artifacts are synchronized
    deps: [ tools:sql:runtime:setup ]
    cmds:
      - mkdir -p sql/queries
      - >
        php tools/sql-gen/bin/sql-check.php
        --input-dir=sql/queries
        --output-dir=gen/Generated/Sql
        --namespace=App\\Generated\\Sql
        --schema=sql/schema.sql
        --bootstrap=codegen/sql-gen-bootstrap.php
        --profile-class=ProjectCodegen\\Sql\\BaseApiTemplateSqlGenerationProfile

  sql:check:pg:
    desc: Validate SQL queries against a live PostgreSQL database
    deps: [ tools:sql:runtime:setup ]
    cmds:
      - mkdir -p sql/queries
      - >
        php tools/sql-gen/bin/sql-check-pg.php
        --input-dir=sql/queries
        --schema=sql/schema.sql
        --db-host={{default "localhost" .DB_HOST}}
        --db-port={{default "5432" .DB_PORT}}
        --db-name={{default "app" .DB_NAME}}
        --db-user={{default "app" .DB_USER}}
        --db-password={{default "password" .DB_PASSWORD}}

  tools:proto:setup:
    desc: Setup protoc-php-gen plugin
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} install
      - chmod +x tools/protoc-php-gen/bin/protoc-php-gen.php
      - echo "Proto code generator setup complete"

  tools:proto:lint:
    desc: Run PHP-CS-Fixer on the protoc-php-gen library
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} cs

  tools:proto:fixcs:
    desc: Fix code style issues in the protoc-php-gen library
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} cs-fix

  tools:proto:phpstan:
    desc: Run PHPStan on the protoc-php-gen library
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} phpstan

  tools:proto:test:
    desc: Run PHP-CS-Fixer on the protoc-php-gen library
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} test

  tools:proto:check:
    desc: Run all code quality checks on the protoc-php-gen library
    cmds:
      - cd tools/protoc-php-gen && {{.COMPOSER}} check

  tools:sql:runtime:setup:
    desc: Setup sql-gen runtime dependencies
    sources:
      - tools/sql-gen/composer.json
      - tools/sql-gen/composer.lock
    generates:
      - tools/sql-gen/vendor/autoload.php
    cmds:
      - cd tools/sql-gen && {{.COMPOSER}} install --no-progress
      - chmod +x tools/sql-gen/bin/sql-gen.php
      - chmod +x tools/sql-gen/bin/sql-check-pg.php
      - echo "SQL generator setup complete"

  tools:sql:setup:
    desc: Setup full sql-gen development environment
    sources:
      - tools/sql-gen/composer.json
      - tools/sql-gen/composer.lock
    generates:
      - tools/sql-gen/vendor/bin/phpunit
    cmds:
      - cd tools/sql-gen && {{.COMPOSER}} install --no-progress
      - chmod +x tools/sql-gen/bin/sql-gen.php
      - chmod +x tools/sql-gen/bin/sql-check-pg.php
      - echo "SQL generator development setup complete"

  tools:sql:check:
    desc: Run all code quality checks on the sql-gen library
    deps: [ tools:sql:setup ]
    cmds:
      - cd tools/sql-gen && {{.COMPOSER}} check

  # Performance tasks
  perf:test:
    desc: Run single performance test
    deps: [ var, install ]
    cmds:
      - k6 run load-tests/scenarios/{{.CLI_ARGS | default "home.js"}}

  perf:test:all:
    desc: Run all performance tests
    deps: [ var, install ]
    cmds:
      - for f in load-tests/scenarios/*.js; do k6 run "$f"; done

  services:start:
    desc: Start all application services
    cmds:
      - docker compose up -d
      - echo "Waiting for services to be ready..."
      - for i in $(seq 1 10); do
          if docker compose exec -T db-postgres pg_isready -U app >/dev/null 2>&1; then
            echo "Database is ready!";
            break;
          fi;
          echo "Services not ready yet, retrying in 1 second...";
          sleep 1;
        done
      - task: migrate
        
  migrate:
    desc: Run database migrations
    deps: [ var, install ]
    cmds:
      - "{{.PHP}} bin/migrate.php"

  services:stop:
    desc: Stop all application services
    cmds:
      - docker compose stop

  services:status:
    desc: Check the status of all application services
    cmds:
      - docker compose ps
      
  run:
    desc: Start all required services and run the application with RoadRunner
    deps: [ services:start ]
    cmds:
      - echo "Starting application with RoadRunner on http://localhost:8080..."
      - rr serve -c .rr.yaml