Migrate CI/CD to .ci-tools structure with Castor orchestration

[Spomky]

Summary

This PR migrates the CI/CD infrastructure to match the otphp project structure, providing better consistency across Spomky-Labs repositories.

Changes

🏗️ Structure

• Created .ci-tools/ directory for all CI/CD configuration files
• Moved configuration files (preserving git history with git mv):
  • ecs.php → .ci-tools/ecs.php
  • rector.php → .ci-tools/rector.php
  • phpstan.neon → .ci-tools/phpstan.neon
  • phpstan-baseline.neon → .ci-tools/phpstan-baseline.neon
  • phpunit.xml.dist → .ci-tools/phpunit.xml.dist
  • infection.json → .ci-tools/infection.json.dist
  • deptrac.yaml → .ci-tools/deptrac.yaml
  • phpbench.json → .ci-tools/phpbench.json

🔧 Configuration Updates

• Updated all config files to use relative paths (__DIR__ . '/../' pattern)
• Modernized rector.php to use builder pattern (RectorConfig::configure())
• Updated phpstan.neon to use %currentWorkingDirectory% variables

🤖 Task Orchestration

• Created castor.php task orchestrator replacing Makefile
• Implemented all Makefile tasks as Castor commands
• Added Docker abstraction via phpqa() function
• Tasks reference configs with .ci-tools/ prefix

🔄 GitHub Workflows

• Completely rewrote .github/workflows/integrate.yml to match otphp structure
• All jobs now use ghcr.io/spomky-labs/phpqa containers
• Replaced Make commands with Castor commands
• Merged infection.yml into main integrate.yml workflow
• Added dependency caching and concurrency controls

📦 Package Distribution

• Simplified .gitattributes with single /.ci-tools export-ignore
• Added /castor.php export-ignore
• Removed individual config file ignores

🗑️ Removed Files

• Makefile (replaced by castor.php)
• .github/workflows/infection.yml (merged into integrate.yml)

Benefits

✅ Consistency - Matches otphp and other Spomky-Labs projects
✅ Organization - All CI/CD configs centralized in .ci-tools/
✅ Maintainability - Single source of truth (castor.php)
✅ Docker Integration - Automatic detection and fallback
✅ Clean Distribution - CI tools excluded from packages
✅ Cross-Platform - Castor works everywhere (PHP-based vs Make)

Available Castor Commands

# Code Quality
castor ecs              # Check coding standards
castor ecs-fix          # Fix coding standards
castor rector           # Check refactoring (dry-run)
castor rector-fix       # Apply refactoring
castor phpstan          # Static analysis
castor phpstan-baseline # Generate PHPStan baseline
castor deptrac          # Architecture validation
castor lint             # Syntax check

# Testing
castor phpunit          # Run all tests with coverage
castor unit-tests       # Unit tests only
castor integration-tests # Integration tests only
castor functional-tests # Functional tests only
castor coverage         # HTML coverage report
castor coverage-ci      # Text coverage for CI
castor infect           # Mutation testing (local)
castor infect-ci        # Mutation testing (CI)
castor js               # JavaScript tests

# Utilities
castor check-licenses   # License validation
castor prepare-pr       # Prepare code for PR
castor phpqa-update     # Update PHPQA Docker image

Testing

All Castor commands have been tested locally and work correctly.

Migration Notes

• Castor is installed globally (not in composer.json)
• CI uses ghcr.io/spomky-labs/phpqa Docker images
• All paths in config files adjusted for .ci-tools/ location
• Git history preserved for all moved files

🤖 Generated with Claude Code