Merge pull request #11 from MacPaw/cursor/development-environment-setup-989b

Add AGENTS.md and fix deprecated GitHub Actions

Author: zakhar-huzenko

.github/workflows/ci.yaml

@@ -26,9 +26,9 @@ jobs:
     name: PHP ${{ matrix.php }} Symfony ${{ matrix.symfony-versions }} ${{ matrix.description }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
-      - uses: actions/cache@v2
+      - uses: actions/cache@v4
         with:
           path: ~/.composer/cache/files
           key: ${{ matrix.php }}-${{ matrix.symfony-versions }}
@@ -44,10 +44,10 @@ jobs:
 
       - name: Set composer cache directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
 
       - name: Cache composer
-        uses: actions/cache@v2.1.2
+        uses: actions/cache@v4
         with:
           path: ${{ steps.composer-cache.outputs.dir }}
           key: ${{ runner.os }}-${{ matrix.php }}-${{ matrix.symfony-versions }}-composer-${{ hashFiles('composer.json') }}

.github/workflows/security.yaml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

.github/workflows/static_analyse.yaml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -25,7 +25,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -41,7 +41,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
@@ -57,7 +57,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Setup PHP
         uses: shivammathur/setup-php@v2

AGENTS.md

@@ -0,0 +1,29 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+This is a **PHP Symfony Bundle library** (`macpaw/symfony-deprecated-routes`), not a standalone application. There is no server to start or database to connect to.
+
+### Prerequisites
+
+- PHP >= 8.1 (8.3 recommended) with extensions: mbstring, xml, curl, zip, intl, dom
+- Composer
+
+### Key commands
+
+| Task | Command |
+|---|---|
+| Install dependencies | `composer install` |
+| Run tests | `vendor/bin/phpunit` |
+| Lint (code style) | `vendor/bin/phpcs` |
+| Static analysis | `vendor/bin/phpstan analyse` |
+| Validate composer.json | `composer validate` |
+
+### Notes
+
+- No `composer.lock` is committed — `composer install` resolves latest compatible versions each time.
+- The `validate` script in `composer.json` shadows the `composer validate` command; Composer warns about this but it's harmless.
+- PHPStan runs at `level: max` — see `phpstan.neon` for excluded paths.
+- phpcs uses PSR-12 plus custom rules — see `phpcs.xml.dist`.
+- Tests include both unit (`tests/Unit/`) and functional (`tests/Functional/`) suites using a test kernel at `Macpaw\SymfonyDeprecatedRoutes\Tests\App`.
+- Docker (`docker-compose.yaml`) is only for multi-PHP-version testing; not needed for standard development.