Add testing infrastructure for GitHub Action

- Add test project with sample PHP code and PHPArkitect rules
- Create test workflow to validate action functionality
- Update action.yml to use local Dockerfile and define inputs
- Add test matrix for different PHP versions and configurations

This ensures we can safely make improvements without breaking the action.

Author: claude

.github/workflows/test-action.yml

@@ -0,0 +1,74 @@
+name: Test Action
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - 'claude/**'
+
+jobs:
+  test-local-action:
+    name: Test PHPArkitect Action
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        test_case:
+          - name: "Basic check"
+            args: "check"
+            require_dev: "false"
+          - name: "Check with dev dependencies"
+            args: "check"
+            require_dev: "true"
+          - name: "Check with PHP 8.0"
+            args: "check"
+            require_dev: "false"
+            php_version: "8.0"
+          - name: "Check with PHP 8.2"
+            args: "check"
+            require_dev: "false"
+            php_version: "8.2"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Copy test project files to root
+        run: |
+          cp test-project/composer.json .
+          cp test-project/phparkitect.php .
+          cp -r test-project/src .
+
+      - name: Test PHPArkitect Action - ${{ matrix.test_case.name }}
+        uses: ./
+        env:
+          REQUIRE_DEV: ${{ matrix.test_case.require_dev }}
+          PHP_VERSION: ${{ matrix.test_case.php_version }}
+        with:
+          args: ${{ matrix.test_case.args }}
+
+  test-docker-build:
+    name: Test Docker Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: false
+          tags: phparkitect/arkitect-github-actions:test
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Test Docker image
+        run: |
+          docker run --rm phparkitect/arkitect-github-actions:test --version

action.yml

@@ -6,10 +6,18 @@ branding:
   icon: "check"
   color: "blue"
 
-description: "Use Arkitect via GithubAction."
+description: "Use PHPArkitect via GitHub Actions to enforce architectural rules in your PHP projects."
 
 name: "phparkitect-arkitect"
 
+inputs:
+  args:
+    description: 'Arguments to pass to PHPArkitect (e.g., check, list)'
+    required: false
+    default: 'check'
+
 runs:
   using: "docker"
-  image: "docker://phparkitect/arkitect-github-actions:0.7.0"
+  image: "Dockerfile"
+  args:
+    - ${{ inputs.args }}

test-project/.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+composer.lock

test-project/composer.json

@@ -0,0 +1,13 @@
+{
+    "name": "phparkitect/test-project",
+    "description": "Test project for PHPArkitect GitHub Action",
+    "type": "project",
+    "require": {
+        "php": ">=7.4"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "src/"
+        }
+    }
+}

test-project/phparkitect.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+use Arkitect\ClassSet;
+use Arkitect\CLI\Config;
+use Arkitect\Expression\ForClasses\HaveNameMatching;
+use Arkitect\Expression\ForClasses\NotHaveDependencyOutsideNamespace;
+use Arkitect\Expression\ForClasses\ResideInOneOfTheseNamespaces;
+use Arkitect\Rules\Rule;
+
+return static function (Config $config): void {
+    $classSet = ClassSet::fromDir(__DIR__ . '/src');
+
+    $rules = [];
+
+    // Domain layer should not depend on Infrastructure
+    $rules[] = Rule::allClasses()
+        ->that(new ResideInOneOfTheseNamespaces('App\Domain'))
+        ->should(new NotHaveDependencyOutsideNamespace('App\Domain'))
+        ->because('Domain layer should be independent');
+
+    // Repository classes should be in Infrastructure namespace
+    $rules[] = Rule::allClasses()
+        ->that(new HaveNameMatching('*Repository'))
+        ->should(new ResideInOneOfTheseNamespaces('App\Infrastructure'))
+        ->because('Repositories should be in Infrastructure layer');
+
+    $config
+        ->add($classSet, ...$rules);
+};

test-project/src/Domain/User.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Domain;
+
+class User
+{
+    private string $name;
+    private string $email;
+
+    public function __construct(string $name, string $email)
+    {
+        $this->name = $name;
+        $this->email = $email;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getEmail(): string
+    {
+        return $this->email;
+    }
+}

test-project/src/Infrastructure/UserRepository.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Infrastructure;
+
+use App\Domain\User;
+
+class UserRepository
+{
+    private array $users = [];
+
+    public function save(User $user): void
+    {
+        $this->users[] = $user;
+    }
+
+    public function findAll(): array
+    {
+        return $this->users;
+    }
+}