diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..a3b67200 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,60 @@ +# Agents Guide for Sons of PHP Monorepo + +This repository is a PHP monorepo containing many packages under `src/`. This guide provides consistent instructions for AI coding agents to work safely and effectively across the codebase. + +## Repo Layout + +- Root: build tooling (`Makefile`, composer), shared configs, CI inputs. +- Code: packages live under `src/SonsOfPHP/*`, typically with `src/` and `Tests/` subfolders. +- Docs: developer documentation in `docs/` with a GitBook-style `SUMMARY.md`. +- Tools: development tools vendored under `tools/` (phpunit, psalm, rector, php-cs-fixer, etc.). + +## Ground Rules + +- Prefer minimal, targeted changes; avoid refactors beyond the task scope. +- Never edit anything under any `vendor/` directory or generated artifacts like `dist/`. +- Maintain backward compatibility for public APIs unless explicitly instructed otherwise. +- Update relevant docs under `docs/` when behavior or public APIs change. +- Keep code style consistent; use provided tooling to format, lint, and check types. + +## Setup + +- Install dependencies once at the repo root: + - `make install` + +## Common Tasks + +- Run tests (entire repo): + - `make test` +- Run tests (limit to a package): + - `PHPUNIT_OPTIONS='path/to/package/Tests' make test` +- Code style (dry-run): + - `make php-cs-fixer` +- Static analysis (Psalm): + - `make psalm` +- Rector & style upgrades (may modify files): + - `make upgrade-code` +- Lint PHP syntax: + - `make lint` +- Coverage report: + - `make coverage` + +## When Editing a Package + +- Work inside that package directory (e.g. `src/SonsOfPHP/Component/Clock`). +- Put new source under that package’s `src/`; add tests under its `Tests/`. +- Use the package-focused test command above to tighten feedback cycles. + +## Documentation + +- Update `docs/` to reflect user-facing changes. +- Add or modify the most relevant page (e.g., `docs/components/*.md`, `docs/contracts/*.md`, or `docs/symfony-bundles/*.md`). +- If adding a new page, ensure it’s listed in `docs/SUMMARY.md`. + +## Pull Request Checklist + +- Build passes: `make test` (optionally with coverage). +- Code quality passes: `make php-cs-fixer`, `make psalm`, and (if applicable) `make upgrade-code`. +- Docs updated where needed. +- No changes to `vendor/` or generated artifacts. + diff --git a/docs/AGENTS.md b/docs/AGENTS.md new file mode 100644 index 00000000..35f0ab75 --- /dev/null +++ b/docs/AGENTS.md @@ -0,0 +1,35 @@ +# Agents Guide for Docs + +This project’s documentation lives in `docs/` and is organized for GitBook consumption with a table of contents in `SUMMARY.md`. + +## Principles + +- Keep docs accurate, concise, and task-oriented. +- Prefer small, incremental updates alongside code changes. +- Mirror package names and concepts used in code for easy navigation. + +## Where to Edit + +- Components: `docs/components/*.md` +- Contracts: `docs/contracts/*.md` +- Symfony bundles: `docs/symfony-bundles/*.md` +- Bard CLI: `docs/bard/*.md` +- General/Project: `docs/README.md`, `docs/getting-help.md`, etc. + +## Table of Contents + +- When adding new pages, update `docs/SUMMARY.md` to include them in the navigation. + +## Writing Style + +- Use clear headings and short sections. +- Include small code examples (PHP) when helpful. +- Document public APIs and noteworthy behavior changes. +- Link to related pages within `docs/` when context helps. + +## Quick Checks + +- Cross-check names, namespaces, and examples with the code. +- Keep examples runnable where possible. +- Avoid duplicating content that can be linked. + diff --git a/src/SonsOfPHP/Bard/AGENTS.md b/src/SonsOfPHP/Bard/AGENTS.md new file mode 100644 index 00000000..c37578a5 --- /dev/null +++ b/src/SonsOfPHP/Bard/AGENTS.md @@ -0,0 +1,20 @@ +# Agents Guide for Package: src/SonsOfPHP/Bard + +## Scope + +- Source: `src/SonsOfPHP/Bard/src` +- Tests: `src/SonsOfPHP/Bard/Tests` +- Do not edit: `src/SonsOfPHP/Bard/vendor/`, `src/SonsOfPHP/Bard/dist/` + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bard/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + +## Notes + +- Keep CLI outputs stable; update docs in `docs/bard/` if UX changes. +- Avoid committing built artifacts under `dist/`. + diff --git a/src/SonsOfPHP/Bridge/Aws/Filesystem/AGENTS.md b/src/SonsOfPHP/Bridge/Aws/Filesystem/AGENTS.md new file mode 100644 index 00000000..37186c91 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Aws/Filesystem/AGENTS.md @@ -0,0 +1,20 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Aws/Filesystem + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Aws/Filesystem/src` +- Tests: `src/SonsOfPHP/Bridge/Aws/Filesystem/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Aws/Filesystem/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + +## Notes + +- Ensure AWS-related integrations remain optional and well-typed. +- If user-facing behavior changes, update related docs under `docs/components/` or integration sections as applicable. + diff --git a/src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/AGENTS.md b/src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/AGENTS.md new file mode 100644 index 00000000..9db04880 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/AGENTS.md @@ -0,0 +1,19 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Doctrine/Collections/Pager + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/src` +- Tests: `src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Doctrine/Collections/Pager/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + +## Notes + +- Keep Doctrine-related integrations loosely coupled and optional. + diff --git a/src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/AGENTS.md b/src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/AGENTS.md new file mode 100644 index 00000000..cfc0676f --- /dev/null +++ b/src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/src` +- Tests: `src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Doctrine/DBAL/Pager/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/Doctrine/EventSourcing/AGENTS.md b/src/SonsOfPHP/Bridge/Doctrine/EventSourcing/AGENTS.md new file mode 100644 index 00000000..9d3352f6 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Doctrine/EventSourcing/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Doctrine/EventSourcing + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Doctrine/EventSourcing/src` +- Tests: `src/SonsOfPHP/Bridge/Doctrine/EventSourcing/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Doctrine/EventSourcing/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/AGENTS.md b/src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/AGENTS.md new file mode 100644 index 00000000..2cf0bbf5 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Doctrine/ORM/Pager + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/src` +- Tests: `src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Doctrine/ORM/Pager/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/LiipImagine/Filesystem/AGENTS.md b/src/SonsOfPHP/Bridge/LiipImagine/Filesystem/AGENTS.md new file mode 100644 index 00000000..582a8856 --- /dev/null +++ b/src/SonsOfPHP/Bridge/LiipImagine/Filesystem/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/LiipImagine/Filesystem + +## Scope + +- Source: `src/SonsOfPHP/Bridge/LiipImagine/Filesystem/src` +- Tests: `src/SonsOfPHP/Bridge/LiipImagine/Filesystem/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/LiipImagine/Filesystem/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/Symfony/Cqrs/AGENTS.md b/src/SonsOfPHP/Bridge/Symfony/Cqrs/AGENTS.md new file mode 100644 index 00000000..4c6b6e1b --- /dev/null +++ b/src/SonsOfPHP/Bridge/Symfony/Cqrs/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Symfony/Cqrs + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Symfony/Cqrs/src` +- Tests: `src/SonsOfPHP/Bridge/Symfony/Cqrs/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Symfony/Cqrs/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/Symfony/EventSourcing/AGENTS.md b/src/SonsOfPHP/Bridge/Symfony/EventSourcing/AGENTS.md new file mode 100644 index 00000000..80928608 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Symfony/EventSourcing/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Symfony/EventSourcing + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Symfony/EventSourcing/src` +- Tests: `src/SonsOfPHP/Bridge/Symfony/EventSourcing/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Symfony/EventSourcing/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bridge/Twig/Money/AGENTS.md b/src/SonsOfPHP/Bridge/Twig/Money/AGENTS.md new file mode 100644 index 00000000..ab0da319 --- /dev/null +++ b/src/SonsOfPHP/Bridge/Twig/Money/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bridge/Twig/Money + +## Scope + +- Source: `src/SonsOfPHP/Bridge/Twig/Money/src` +- Tests: `src/SonsOfPHP/Bridge/Twig/Money/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bridge/Twig/Money/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bundle/Cqrs/AGENTS.md b/src/SonsOfPHP/Bundle/Cqrs/AGENTS.md new file mode 100644 index 00000000..be6611fc --- /dev/null +++ b/src/SonsOfPHP/Bundle/Cqrs/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bundle/Cqrs + +## Scope + +- Source: `src/SonsOfPHP/Bundle/Cqrs/src` +- Tests: `src/SonsOfPHP/Bundle/Cqrs/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bundle/Cqrs/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Bundle/FeatureToggleBundle/AGENTS.md b/src/SonsOfPHP/Bundle/FeatureToggleBundle/AGENTS.md new file mode 100644 index 00000000..50fac420 --- /dev/null +++ b/src/SonsOfPHP/Bundle/FeatureToggleBundle/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Bundle/FeatureToggleBundle + +## Scope + +- Source: `src/SonsOfPHP/Bundle/FeatureToggleBundle/src` +- Tests: `src/SonsOfPHP/Bundle/FeatureToggleBundle/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Bundle/FeatureToggleBundle/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Assert/AGENTS.md b/src/SonsOfPHP/Component/Assert/AGENTS.md new file mode 100644 index 00000000..8b378577 --- /dev/null +++ b/src/SonsOfPHP/Component/Assert/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Assert + +## Scope + +- Source: `src/SonsOfPHP/Component/Assert/src` +- Tests: `src/SonsOfPHP/Component/Assert/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Assert/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Cache/AGENTS.md b/src/SonsOfPHP/Component/Cache/AGENTS.md new file mode 100644 index 00000000..d91c9e4f --- /dev/null +++ b/src/SonsOfPHP/Component/Cache/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Cache + +## Scope + +- Source: `src/SonsOfPHP/Component/Cache/src` +- Tests: `src/SonsOfPHP/Component/Cache/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Cache/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Clock/AGENTS.md b/src/SonsOfPHP/Component/Clock/AGENTS.md new file mode 100644 index 00000000..11768c79 --- /dev/null +++ b/src/SonsOfPHP/Component/Clock/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Clock + +## Scope + +- Source: `src/SonsOfPHP/Component/Clock/src` +- Tests: `src/SonsOfPHP/Component/Clock/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Clock/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Container/AGENTS.md b/src/SonsOfPHP/Component/Container/AGENTS.md new file mode 100644 index 00000000..eb5d6514 --- /dev/null +++ b/src/SonsOfPHP/Component/Container/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Container + +## Scope + +- Source: `src/SonsOfPHP/Component/Container/src` +- Tests: `src/SonsOfPHP/Component/Container/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Container/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Cookie/AGENTS.md b/src/SonsOfPHP/Component/Cookie/AGENTS.md new file mode 100644 index 00000000..f9650eee --- /dev/null +++ b/src/SonsOfPHP/Component/Cookie/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Cookie + +## Scope + +- Source: `src/SonsOfPHP/Component/Cookie/src` +- Tests: `src/SonsOfPHP/Component/Cookie/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Cookie/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Cqrs/AGENTS.md b/src/SonsOfPHP/Component/Cqrs/AGENTS.md new file mode 100644 index 00000000..459f7291 --- /dev/null +++ b/src/SonsOfPHP/Component/Cqrs/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Cqrs + +## Scope + +- Source: `src/SonsOfPHP/Component/Cqrs/src` +- Tests: `src/SonsOfPHP/Component/Cqrs/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Cqrs/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/EventDispatcher/AGENTS.md b/src/SonsOfPHP/Component/EventDispatcher/AGENTS.md new file mode 100644 index 00000000..3bca7790 --- /dev/null +++ b/src/SonsOfPHP/Component/EventDispatcher/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/EventDispatcher + +## Scope + +- Source: `src/SonsOfPHP/Component/EventDispatcher/src` +- Tests: `src/SonsOfPHP/Component/EventDispatcher/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/EventDispatcher/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/EventSourcing/AGENTS.md b/src/SonsOfPHP/Component/EventSourcing/AGENTS.md new file mode 100644 index 00000000..951554e9 --- /dev/null +++ b/src/SonsOfPHP/Component/EventSourcing/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/EventSourcing + +## Scope + +- Source: `src/SonsOfPHP/Component/EventSourcing/src` +- Tests: `src/SonsOfPHP/Component/EventSourcing/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/EventSourcing/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/FeatureToggle/AGENTS.md b/src/SonsOfPHP/Component/FeatureToggle/AGENTS.md new file mode 100644 index 00000000..1ebbd0fb --- /dev/null +++ b/src/SonsOfPHP/Component/FeatureToggle/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/FeatureToggle + +## Scope + +- Source: `src/SonsOfPHP/Component/FeatureToggle/src` +- Tests: `src/SonsOfPHP/Component/FeatureToggle/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/FeatureToggle/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Filesystem/AGENTS.md b/src/SonsOfPHP/Component/Filesystem/AGENTS.md new file mode 100644 index 00000000..0e6a9ae6 --- /dev/null +++ b/src/SonsOfPHP/Component/Filesystem/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Filesystem + +## Scope + +- Source: `src/SonsOfPHP/Component/Filesystem/src` +- Tests: `src/SonsOfPHP/Component/Filesystem/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Filesystem/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/HttpFactory/AGENTS.md b/src/SonsOfPHP/Component/HttpFactory/AGENTS.md new file mode 100644 index 00000000..38431e36 --- /dev/null +++ b/src/SonsOfPHP/Component/HttpFactory/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/HttpFactory + +## Scope + +- Source: `src/SonsOfPHP/Component/HttpFactory/src` +- Tests: `src/SonsOfPHP/Component/HttpFactory/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/HttpFactory/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/HttpHandler/AGENTS.md b/src/SonsOfPHP/Component/HttpHandler/AGENTS.md new file mode 100644 index 00000000..78b50d61 --- /dev/null +++ b/src/SonsOfPHP/Component/HttpHandler/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/HttpHandler + +## Scope + +- Source: `src/SonsOfPHP/Component/HttpHandler/src` +- Tests: `src/SonsOfPHP/Component/HttpHandler/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/HttpHandler/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/HttpMessage/AGENTS.md b/src/SonsOfPHP/Component/HttpMessage/AGENTS.md new file mode 100644 index 00000000..06ffc408 --- /dev/null +++ b/src/SonsOfPHP/Component/HttpMessage/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/HttpMessage + +## Scope + +- Source: `src/SonsOfPHP/Component/HttpMessage/src` +- Tests: `src/SonsOfPHP/Component/HttpMessage/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/HttpMessage/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Json/AGENTS.md b/src/SonsOfPHP/Component/Json/AGENTS.md new file mode 100644 index 00000000..1138f14c --- /dev/null +++ b/src/SonsOfPHP/Component/Json/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Json + +## Scope + +- Source: `src/SonsOfPHP/Component/Json/src` +- Tests: `src/SonsOfPHP/Component/Json/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Json/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Link/AGENTS.md b/src/SonsOfPHP/Component/Link/AGENTS.md new file mode 100644 index 00000000..e2cf21c7 --- /dev/null +++ b/src/SonsOfPHP/Component/Link/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Link + +## Scope + +- Source: `src/SonsOfPHP/Component/Link/src` +- Tests: `src/SonsOfPHP/Component/Link/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Link/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Logger/AGENTS.md b/src/SonsOfPHP/Component/Logger/AGENTS.md new file mode 100644 index 00000000..db62739a --- /dev/null +++ b/src/SonsOfPHP/Component/Logger/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Logger + +## Scope + +- Source: `src/SonsOfPHP/Component/Logger/src` +- Tests: `src/SonsOfPHP/Component/Logger/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Logger/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Mailer/AGENTS.md b/src/SonsOfPHP/Component/Mailer/AGENTS.md new file mode 100644 index 00000000..7f2c6472 --- /dev/null +++ b/src/SonsOfPHP/Component/Mailer/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Mailer + +## Scope + +- Source: `src/SonsOfPHP/Component/Mailer/src` +- Tests: `src/SonsOfPHP/Component/Mailer/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Mailer/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Money/AGENTS.md b/src/SonsOfPHP/Component/Money/AGENTS.md new file mode 100644 index 00000000..0f0ba623 --- /dev/null +++ b/src/SonsOfPHP/Component/Money/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Money + +## Scope + +- Source: `src/SonsOfPHP/Component/Money/src` +- Tests: `src/SonsOfPHP/Component/Money/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Money/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Pager/AGENTS.md b/src/SonsOfPHP/Component/Pager/AGENTS.md new file mode 100644 index 00000000..6c2eda7e --- /dev/null +++ b/src/SonsOfPHP/Component/Pager/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Pager + +## Scope + +- Source: `src/SonsOfPHP/Component/Pager/src` +- Tests: `src/SonsOfPHP/Component/Pager/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Pager/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Registry/AGENTS.md b/src/SonsOfPHP/Component/Registry/AGENTS.md new file mode 100644 index 00000000..1e58f91d --- /dev/null +++ b/src/SonsOfPHP/Component/Registry/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Registry + +## Scope + +- Source: `src/SonsOfPHP/Component/Registry/src` +- Tests: `src/SonsOfPHP/Component/Registry/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Registry/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/StateMachine/AGENTS.md b/src/SonsOfPHP/Component/StateMachine/AGENTS.md new file mode 100644 index 00000000..14465617 --- /dev/null +++ b/src/SonsOfPHP/Component/StateMachine/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/StateMachine + +## Scope + +- Source: `src/SonsOfPHP/Component/StateMachine/src` +- Tests: `src/SonsOfPHP/Component/StateMachine/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/StateMachine/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Component/Version/AGENTS.md b/src/SonsOfPHP/Component/Version/AGENTS.md new file mode 100644 index 00000000..8fe85970 --- /dev/null +++ b/src/SonsOfPHP/Component/Version/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Component/Version + +## Scope + +- Source: `src/SonsOfPHP/Component/Version/src` +- Tests: `src/SonsOfPHP/Component/Version/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Component/Version/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Common/AGENTS.md b/src/SonsOfPHP/Contract/Common/AGENTS.md new file mode 100644 index 00000000..6b2e30d4 --- /dev/null +++ b/src/SonsOfPHP/Contract/Common/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Common + +## Scope + +- Source: `src/SonsOfPHP/Contract/Common/src` +- Tests: `src/SonsOfPHP/Contract/Common/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Common/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Cookie/AGENTS.md b/src/SonsOfPHP/Contract/Cookie/AGENTS.md new file mode 100644 index 00000000..216ae3f8 --- /dev/null +++ b/src/SonsOfPHP/Contract/Cookie/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Cookie + +## Scope + +- Source: `src/SonsOfPHP/Contract/Cookie/src` +- Tests: `src/SonsOfPHP/Contract/Cookie/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Cookie/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Cqrs/AGENTS.md b/src/SonsOfPHP/Contract/Cqrs/AGENTS.md new file mode 100644 index 00000000..6bde9ece --- /dev/null +++ b/src/SonsOfPHP/Contract/Cqrs/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Cqrs + +## Scope + +- Source: `src/SonsOfPHP/Contract/Cqrs/src` +- Tests: `src/SonsOfPHP/Contract/Cqrs/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Cqrs/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/EventSourcing/AGENTS.md b/src/SonsOfPHP/Contract/EventSourcing/AGENTS.md new file mode 100644 index 00000000..f645dc76 --- /dev/null +++ b/src/SonsOfPHP/Contract/EventSourcing/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/EventSourcing + +## Scope + +- Source: `src/SonsOfPHP/Contract/EventSourcing/src` +- Tests: `src/SonsOfPHP/Contract/EventSourcing/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/EventSourcing/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/FeatureToggle/AGENTS.md b/src/SonsOfPHP/Contract/FeatureToggle/AGENTS.md new file mode 100644 index 00000000..e02300b2 --- /dev/null +++ b/src/SonsOfPHP/Contract/FeatureToggle/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/FeatureToggle + +## Scope + +- Source: `src/SonsOfPHP/Contract/FeatureToggle/src` +- Tests: `src/SonsOfPHP/Contract/FeatureToggle/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/FeatureToggle/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Filesystem/AGENTS.md b/src/SonsOfPHP/Contract/Filesystem/AGENTS.md new file mode 100644 index 00000000..373566fc --- /dev/null +++ b/src/SonsOfPHP/Contract/Filesystem/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Filesystem + +## Scope + +- Source: `src/SonsOfPHP/Contract/Filesystem/src` +- Tests: `src/SonsOfPHP/Contract/Filesystem/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Filesystem/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/HttpHandler/AGENTS.md b/src/SonsOfPHP/Contract/HttpHandler/AGENTS.md new file mode 100644 index 00000000..ca9b8370 --- /dev/null +++ b/src/SonsOfPHP/Contract/HttpHandler/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/HttpHandler + +## Scope + +- Source: `src/SonsOfPHP/Contract/HttpHandler/src` +- Tests: `src/SonsOfPHP/Contract/HttpHandler/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/HttpHandler/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Logger/AGENTS.md b/src/SonsOfPHP/Contract/Logger/AGENTS.md new file mode 100644 index 00000000..b45d4508 --- /dev/null +++ b/src/SonsOfPHP/Contract/Logger/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Logger + +## Scope + +- Source: `src/SonsOfPHP/Contract/Logger/src` +- Tests: `src/SonsOfPHP/Contract/Logger/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Logger/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Mailer/AGENTS.md b/src/SonsOfPHP/Contract/Mailer/AGENTS.md new file mode 100644 index 00000000..4d735425 --- /dev/null +++ b/src/SonsOfPHP/Contract/Mailer/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Mailer + +## Scope + +- Source: `src/SonsOfPHP/Contract/Mailer/src` +- Tests: `src/SonsOfPHP/Contract/Mailer/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Mailer/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Money/AGENTS.md b/src/SonsOfPHP/Contract/Money/AGENTS.md new file mode 100644 index 00000000..829d88ea --- /dev/null +++ b/src/SonsOfPHP/Contract/Money/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Money + +## Scope + +- Source: `src/SonsOfPHP/Contract/Money/src` +- Tests: `src/SonsOfPHP/Contract/Money/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Money/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Pager/AGENTS.md b/src/SonsOfPHP/Contract/Pager/AGENTS.md new file mode 100644 index 00000000..fb935248 --- /dev/null +++ b/src/SonsOfPHP/Contract/Pager/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Pager + +## Scope + +- Source: `src/SonsOfPHP/Contract/Pager/src` +- Tests: `src/SonsOfPHP/Contract/Pager/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Pager/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Registry/AGENTS.md b/src/SonsOfPHP/Contract/Registry/AGENTS.md new file mode 100644 index 00000000..5a4f9e0c --- /dev/null +++ b/src/SonsOfPHP/Contract/Registry/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Registry + +## Scope + +- Source: `src/SonsOfPHP/Contract/Registry/src` +- Tests: `src/SonsOfPHP/Contract/Registry/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Registry/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/StateMachine/AGENTS.md b/src/SonsOfPHP/Contract/StateMachine/AGENTS.md new file mode 100644 index 00000000..09273003 --- /dev/null +++ b/src/SonsOfPHP/Contract/StateMachine/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/StateMachine + +## Scope + +- Source: `src/SonsOfPHP/Contract/StateMachine/src` +- Tests: `src/SonsOfPHP/Contract/StateMachine/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/StateMachine/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Stdlib/AGENTS.md b/src/SonsOfPHP/Contract/Stdlib/AGENTS.md new file mode 100644 index 00000000..bdf24377 --- /dev/null +++ b/src/SonsOfPHP/Contract/Stdlib/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Stdlib + +## Scope + +- Source: `src/SonsOfPHP/Contract/Stdlib/src` +- Tests: `src/SonsOfPHP/Contract/Stdlib/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Stdlib/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` + diff --git a/src/SonsOfPHP/Contract/Version/AGENTS.md b/src/SonsOfPHP/Contract/Version/AGENTS.md new file mode 100644 index 00000000..f6ed9766 --- /dev/null +++ b/src/SonsOfPHP/Contract/Version/AGENTS.md @@ -0,0 +1,15 @@ +# Agents Guide for Package: src/SonsOfPHP/Contract/Version + +## Scope + +- Source: `src/SonsOfPHP/Contract/Version/src` +- Tests: `src/SonsOfPHP/Contract/Version/Tests` +- Do not edit: any `vendor/` directories + +## Workflows + +- Install once at repo root: `make install` +- Test this package only: `PHPUNIT_OPTIONS='src/SonsOfPHP/Contract/Version/Tests' make test` +- Style and static analysis: `make php-cs-fixer` and `make psalm` +- Upgrade code (may modify files): `make upgrade-code` +